1  # SAM community feature flags
  2  #
  3  # SCHEMA
  4  # ------
  5  # Each entry under `features` must include the following fields:
  6  #
  7  #   key             (string, required)
  8  #                   Unique identifier used in code. Must be stable across
  9  #                   releases — renaming a key is a breaking change. Convention
 10  #                   is snake_case; hyphens are normalised to underscores when
 11  #                   forming SAM_FEATURE_<KEY> environment variable names.
 12  #                   Example: background_tasks
 13  #
 14  #   name            (string, required)
 15  #                   Human-readable label, may be shown in the admin UI.
 16  #                   Example: Background Tasks
 17  #
 18  #   release_phase   (string, required)
 19  #                   Lifecycle stage of the feature. Aligned with Solace Cloud release stages
 20  #                   (https://docs.solace.com/Cloud/stages_concept.htm). One of:
 21  #                     experimental          - Limited availability; proof-of-concept only.
 22  #                     early_access          - Closed group of testers; may change incompatibly.
 23  #                     beta                  - Broadly available; complete but may have open issues.
 24  #                     controlled_availability - Fully functional; available on request.
 25  #                     general_availability  - Open to all; production-ready with full SLA coverage.
 26  #                     deprecated            - Scheduled for removal.
 27  #
 28  #   default         (boolean, required)
 29  #                   Baseline on/off state. In effect when no SAM_FEATURE_<KEY>
 30  #                   environment variable is set.
 31  #
 32  #   jira            (string, required)
 33  #                   Jira epic key that owns this feature (e.g. DATAGO-118673).
 34  #                   Required so that every flag can be traced back to its product work.
 35  #
 36  #   description     (string, optional)
 37  #                   Brief explanation of the feature, may be shown in the admin UI.
 38  #
 39  # EVALUATION PRIORITY (highest wins)
 40  # -----------------------------------
 41  #   1. SAM_FEATURE_<UPPER_KEY> environment variable  (e.g. SAM_FEATURE_BACKGROUND_TASKS=true)
 42  #   2. default
 43  #
 44  # ENTERPRISE EXTENSIONS
 45  # ----------------------
 46  # Enterprise flags are defined in the enterprise repository's features.yaml and merged
 47  # into this registry at startup. Later definitions win on key conflicts, so enterprise
 48  # can also override community defaults (e.g. enable a community flag by default in
 49  # enterprise deployments).
 50  
 51  features:
 52  
 53    - key: background_tasks
 54      name: Background Tasks
 55      release_phase: general_availability
 56      default: false
 57      jira: DATAGO-126647
 58      description: >
 59        Run long-running agent tasks in the background and receive results
 60        when they complete.
 61  
 62    - key: mentions
 63      name: Mentions
 64      release_phase: beta
 65      default: false
 66      jira: DATAGO-121076
 67      description: >
 68        Allow users to @mention other users in chat messages.
 69  
 70    - key: auto_title_generation
 71      name: Auto Title Generation
 72      release_phase: beta
 73      default: false
 74      jira: DATAGO-118394
 75      description: >
 76        Automatically generate a descriptive title for new chat sessions
 77        using LLM analysis of the first message exchange.
 78  
 79    - key: project_sharing
 80      name: Project Sharing
 81      release_phase: early_access
 82      default: false
 83      jira: DATAGO-115145
 84      description: >
 85        Allow users to share projects with other members of their
 86        organisation.
 87  
 88    - key: project_indexing
 89      name: Project Indexing
 90      release_phase: beta
 91      default: true
 92      jira: DATAGO-123919
 93      description: >
 94        Enable document indexing and BM25 search within projects for
 95        citation-backed responses.
 96  
 97    - key: model_config_ui
 98      name: Model Configuration UI
 99      release_phase: general_availability
100      default: true
101      jira: DATAGO-109787
102      description: >
103        Enable the Models tab in the Agent Mesh interface to view and manage
104        LLM model configurations. When disabled, the Models tab is hidden.
105  
106    - key: inline_activity_timeline
107      name: Inline Activity Timeline
108      release_phase: early_access
109      default: false
110      jira: DATAGO-130230
111      description: >
112        Show progress updates inline within AI response messages as a vertical
113        timeline. When disabled, the old ephemeral LoadingMessageRow is shown
114        above the chat input instead.
115  
116    - key: show_thinking_content
117      name: Show Thinking Content
118      release_phase: early_access
119      default: false
120      jira: DATAGO-130230
121      description: >
122        Display LLM thinking/reasoning tokens as expandable entries in the
123        inline activity timeline. When disabled, thinking entries are filtered
124        out and thinking content is not accumulated on messages.
125  
126    - key: offline_evals
127      name: Offline Enterprise Evaluations
128      release_phase: experimental
129      default: false
130      jira: DATAGO-104642
131      description: >
132        Enable the offline enterprise evaluation framework. Allows running
133        evaluations against deployed SAM agents with per-request model
134        overrides. When disabled, model override metadata is ignored and
135        the resolver is not initialized.