@genesislcap/foundation-ai 14.409.0-FUI-2495.2 → 14.409.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (11) hide show
  1. package/README.md +1 -7
  2. package/dist/dts/index.d.ts +1 -1
  3. package/dist/dts/index.d.ts.map +1 -1
  4. package/dist/dts/types/chat.types.d.ts +4 -50
  5. package/dist/dts/types/chat.types.d.ts.map +1 -1
  6. package/dist/dts/utils/feature-flags.d.ts +2 -2
  7. package/dist/dts/utils/feature-flags.d.ts.map +1 -1
  8. package/dist/esm/utils/feature-flags.js +3 -10
  9. package/dist/foundation-ai.api.json +123 -376
  10. package/dist/foundation-ai.d.ts +26 -75
  11. package/package.json +11 -11
package/README.md CHANGED
@@ -21,18 +21,12 @@ Each provider exposes capabilities such as `interpretCriteria` (natural language
21
21
 
22
22
  ## Feature flag
23
23
 
24
- AI features are **disabled by default**. Enable them via URL parameter or environment variable:
24
+ AI features are **disabled by default** and require the feature flag to be enabled. Add `?feature.ai` to the URL to activate:
25
25
 
26
- **URL parameter** — append `?feature.ai` to any URL (useful for testing without rebuilding):
27
26
  ```
28
27
  https://your-app.com/?feature.ai
29
28
  ```
30
29
 
31
- **Environment variable** — set `GENX_ENABLE_AI=true` in your app's `.env` file to enable permanently without a URL parameter:
32
- ```
33
- GENX_ENABLE_AI=true
34
- ```
35
-
36
30
  When the flag is off:
37
31
 
38
32
  - `createAIProvider()` and `getAIProvider()` return a no-op provider
package/dist/dts/index.d.ts CHANGED
@@ -3,7 +3,7 @@ export { GeminiProvider } from './providers/gemini-provider';
3
3
  export { GeminiTransport, MalformedFunctionCallError } from './transports/gemini-transport';
4
4
  export { AI_FEATURE_FLAG, isAIFeatureEnabled } from './utils/feature-flags';
5
5
  export type { AIConfig, AIStatus, AIProviderType, ChromeAIConfig, ChromeAvailability, GeminiAIConfig, ServerAIConfig, } from './types';
6
- export type { ChatAgentConfig, ChatAnimationsConfig, ChatAttachment, ChatConfig, ChatDriverResult, ChatMessage, ChatInteraction, ChatRequestOptions, ChatRole, ChatStreamChunk, ChatToolCall, ChatToolDefinition, ChatToolHandlers, ChatToolResult, ChatUiConfig, InteractionResult, } from './types/chat.types';
6
+ export type { ChatAnimationsConfig, ChatAttachment, ChatConfig, ChatMessage, ChatInteraction, ChatRequestOptions, ChatRole, ChatStreamChunk, ChatToolCall, ChatToolDefinition, ChatToolHandlers, ChatToolResult, InteractionResult, } from './types/chat.types';
7
7
  export type { ChatTransport } from './types/chat-transport.types';
8
8
  export type { ResolveAIConfigOptions } from './ai-provider';
9
9
  export type { CriteriaInterpretContext, FieldLike } from './interactions';
package/dist/dts/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}
package/dist/dts/types/chat.types.d.ts CHANGED
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * @beta
5
5
  */
6
- export type ChatRole = 'user' | 'assistant' | 'system' | 'tool' | 'system-event';
6
+ export type ChatRole = 'user' | 'assistant' | 'system' | 'tool';
7
7
  /**
8
8
  * A tool call requested by the assistant.
9
9
  *
@@ -68,8 +68,6 @@ export interface ChatMessage {
68
68
  attachments?: ChatAttachment[];
69
69
  interaction?: ChatInteraction;
70
70
  thinking?: boolean;
71
- /** Name of the agent that produced this message. Set by OrchestratingDriver. */
72
- agentName?: string;
73
71
  }
74
72
  /**
75
73
  * JSON Schema-based tool definition for function calling.
@@ -100,18 +98,6 @@ export interface ChatRequestOptions {
100
98
  attachments?: ChatAttachment[];
101
99
  signal?: AbortSignal;
102
100
  }
103
- /**
104
- * The result returned by a driver after processing a user turn.
105
- *
106
- * @beta
107
- */
108
- export type ChatDriverResult = {
109
- reason: 'done';
110
- } | {
111
- reason: 'agent-handoff';
112
- summary: string;
113
- remainingTask: string;
114
- };
115
101
  /**
116
102
  * A streaming chunk from a chat response.
117
103
  *
@@ -140,7 +126,7 @@ export interface ChatAnimationsConfig {
140
126
  enabled?: string[];
141
127
  }
142
128
  /**
143
- * UI display configuration for the chat assistant.
129
+ * Display and behaviour configuration for the chat assistant.
144
130
  *
145
131
  * For toggle flags (`showToolCalls`, `showThinkingSteps`):
146
132
  * - `true` — default on, user can toggle off
@@ -149,7 +135,7 @@ export interface ChatAnimationsConfig {
149
135
  *
150
136
  * @beta
151
137
  */
152
- export interface ChatUiConfig {
138
+ export interface ChatConfig {
153
139
  /** Show tool call details in the chat UI. */
154
140
  showToolCalls?: boolean | null;
155
141
  /** Show model thinking/reasoning steps. */
@@ -165,39 +151,7 @@ export interface ChatUiConfig {
165
151
  loadingDelay?: number;
166
152
  /** Animations feature configuration. */
167
153
  animations?: ChatAnimationsConfig;
168
- /**
169
- * Show an inline divider in the message list when the active specialist changes.
170
- * Also shown automatically when showToolCalls is true.
171
- * - `true` — default on, user can toggle off
172
- * - `false` — default off, user can toggle on
173
- * - `null` / `undefined` — completely disabled, no UI control shown
174
- */
175
- showAgentSwitchIndicator?: boolean | null;
176
- }
177
- /**
178
- * Agent engine configuration for the chat assistant.
179
- *
180
- * @beta
181
- */
182
- export interface ChatAgentConfig {
183
- /** Maximum number of tool call iterations within one agent's loop. Default: 50. */
154
+ /** Maximum number of tool call iterations per turn. Default: 50. */
184
155
  maxToolIterations?: number;
185
- /** Maximum number of agent-to-agent handoffs per user turn. Default: 3. */
186
- maxHandoffs?: number;
187
- /** Number of recent messages passed to the classifier for context. Default: 4. */
188
- classifierHistoryLength?: number;
189
- /** Number of retries on classifier failure before erroring. Default: 2. */
190
- classifierRetries?: number;
191
- }
192
- /**
193
- * Display and engine configuration for the chat assistant.
194
- *
195
- * @beta
196
- */
197
- export interface ChatConfig {
198
- /** UI display settings — toggles, file upload, animations, etc. */
199
- ui?: ChatUiConfig;
200
- /** Agent engine settings — iteration limits, handoff caps, classifier tuning. */
201
- agent?: ChatAgentConfig;
202
156
  }
203
157
  //# sourceMappingURL=chat.types.d.ts.map
package/dist/dts/types/chat.types.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../../../src/types/chat.types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../../../src/types/chat.types.ts"],"names":[],"mappings":"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"}
package/dist/dts/utils/feature-flags.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- /** Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL or GENX_ENABLE_AI env var. */
1
+ /** Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL. */
2
2
  export declare const AI_FEATURE_FLAG = "ai";
3
- /** Returns true when AI features (beta) are enabled via ?feature.ai URL param or GENX_ENABLE_AI=true env var. */
3
+ /** Returns true when AI features (beta) are enabled. Requires ?feature.ai in URL. */
4
4
  export declare const isAIFeatureEnabled: () => boolean;
5
5
  //# sourceMappingURL=feature-flags.d.ts.map
package/dist/dts/utils/feature-flags.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../src/utils/feature-flags.ts"],"names":[],"mappings":"AAEA,8GAA8G;AAC9G,eAAO,MAAM,eAAe,OAAO,CAAC;AAUpC,iHAAiH;AACjH,eAAO,MAAM,kBAAkB,QAAO,OAA6D,CAAC"}
1
+ {"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../src/utils/feature-flags.ts"],"names":[],"mappings":"AAEA,oFAAoF;AACpF,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,qFAAqF;AACrF,eAAO,MAAM,kBAAkB,QAAO,OAA8C,CAAC"}
package/dist/esm/utils/feature-flags.js CHANGED
@@ -1,12 +1,5 @@
1
1
  import { isFeatureActivated } from '@genesislcap/foundation-utils';
2
- /** Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL or GENX_ENABLE_AI env var. */
2
+ /** Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL. */
3
3
  export const AI_FEATURE_FLAG = 'ai';
4
- let _envEnabled = false;
5
- try {
6
- if (typeof GENX_ENABLE_AI !== 'undefined') {
7
- _envEnabled = GENX_ENABLE_AI === 'true';
8
- }
9
- }
10
- catch (_a) { }
11
- /** Returns true when AI features (beta) are enabled via ?feature.ai URL param or GENX_ENABLE_AI=true env var. */
12
- export const isAIFeatureEnabled = () => _envEnabled || isFeatureActivated(AI_FEATURE_FLAG);
4
+ /** Returns true when AI features (beta) are enabled. Requires ?feature.ai in URL. */
5
+ export const isAIFeatureEnabled = () => isFeatureActivated(AI_FEATURE_FLAG);
package/dist/foundation-ai.api.json CHANGED
@@ -175,7 +175,7 @@
175
175
  {
176
176
  "kind": "Variable",
177
177
  "canonicalReference": "@genesislcap/foundation-ai!AI_FEATURE_FLAG:var",
178
- "docComment": "/**\n * Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL or GENX_ENABLE_AI env var.\n */\n",
178
+ "docComment": "/**\n * Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL.\n */\n",
179
179
  "excerptTokens": [
180
180
  {
181
181
  "kind": "Content",
@@ -736,31 +736,31 @@
736
736
  },
737
737
  {
738
738
  "kind": "Interface",
739
- "canonicalReference": "@genesislcap/foundation-ai!ChatAgentConfig:interface",
740
- "docComment": "/**\n * Agent engine configuration for the chat assistant.\n *\n * @beta\n */\n",
739
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAnimationsConfig:interface",
740
+ "docComment": "/**\n * Configuration for the animations feature.\n *\n * @beta\n */\n",
741
741
  "excerptTokens": [
742
742
  {
743
743
  "kind": "Content",
744
- "text": "export interface ChatAgentConfig "
744
+ "text": "export interface ChatAnimationsConfig "
745
745
  }
746
746
  ],
747
747
  "fileUrlPath": "src/types/chat.types.ts",
748
748
  "releaseTag": "Beta",
749
- "name": "ChatAgentConfig",
749
+ "name": "ChatAnimationsConfig",
750
750
  "preserveMemberOrder": false,
751
751
  "members": [
752
752
  {
753
753
  "kind": "PropertySignature",
754
- "canonicalReference": "@genesislcap/foundation-ai!ChatAgentConfig#classifierHistoryLength:member",
755
- "docComment": "/**\n * Number of recent messages passed to the classifier for context. Default: 4.\n */\n",
754
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAnimationsConfig#enabled:member",
755
+ "docComment": "/**\n * Initially enabled animations. When omitted all animations are enabled by default.\n */\n",
756
756
  "excerptTokens": [
757
757
  {
758
758
  "kind": "Content",
759
- "text": "classifierHistoryLength?: "
759
+ "text": "enabled?: "
760
760
  },
761
761
  {
762
762
  "kind": "Content",
763
- "text": "number"
763
+ "text": "string[]"
764
764
  },
765
765
  {
766
766
  "kind": "Content",
@@ -770,7 +770,7 @@
770
770
  "isReadonly": false,
771
771
  "isOptional": true,
772
772
  "releaseTag": "Beta",
773
- "name": "classifierHistoryLength",
773
+ "name": "enabled",
774
774
  "propertyTypeTokenRange": {
775
775
  "startIndex": 1,
776
776
  "endIndex": 2
@@ -778,16 +778,16 @@
778
778
  },
779
779
  {
780
780
  "kind": "PropertySignature",
781
- "canonicalReference": "@genesislcap/foundation-ai!ChatAgentConfig#classifierRetries:member",
782
- "docComment": "/**\n * Number of retries on classifier failure before erroring. Default: 2.\n */\n",
781
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAnimationsConfig#userConfigurable:member",
782
+ "docComment": "/**\n * When true, a multiselect control is shown in the settings panel so the user can toggle individual animations on or off.\n */\n",
783
783
  "excerptTokens": [
784
784
  {
785
785
  "kind": "Content",
786
- "text": "classifierRetries?: "
786
+ "text": "userConfigurable: "
787
787
  },
788
788
  {
789
789
  "kind": "Content",
790
- "text": "number"
790
+ "text": "boolean"
791
791
  },
792
792
  {
793
793
  "kind": "Content",
@@ -795,9 +795,54 @@
795
795
  }
796
796
  ],
797
797
  "isReadonly": false,
798
- "isOptional": true,
798
+ "isOptional": false,
799
+ "releaseTag": "Beta",
800
+ "name": "userConfigurable",
801
+ "propertyTypeTokenRange": {
802
+ "startIndex": 1,
803
+ "endIndex": 2
804
+ }
805
+ }
806
+ ],
807
+ "extendsTokenRanges": []
808
+ },
809
+ {
810
+ "kind": "Interface",
811
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment:interface",
812
+ "docComment": "/**\n * A file attachment included with a user message.\n *\n * @beta\n */\n",
813
+ "excerptTokens": [
814
+ {
815
+ "kind": "Content",
816
+ "text": "export interface ChatAttachment "
817
+ }
818
+ ],
819
+ "fileUrlPath": "src/types/chat.types.ts",
820
+ "releaseTag": "Beta",
821
+ "name": "ChatAttachment",
822
+ "preserveMemberOrder": false,
823
+ "members": [
824
+ {
825
+ "kind": "PropertySignature",
826
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment#content:member",
827
+ "docComment": "",
828
+ "excerptTokens": [
829
+ {
830
+ "kind": "Content",
831
+ "text": "content: "
832
+ },
833
+ {
834
+ "kind": "Content",
835
+ "text": "string"
836
+ },
837
+ {
838
+ "kind": "Content",
839
+ "text": ";"
840
+ }
841
+ ],
842
+ "isReadonly": false,
843
+ "isOptional": false,
799
844
  "releaseTag": "Beta",
800
- "name": "classifierRetries",
845
+ "name": "content",
801
846
  "propertyTypeTokenRange": {
802
847
  "startIndex": 1,
803
848
  "endIndex": 2
@@ -805,16 +850,16 @@
805
850
  },
806
851
  {
807
852
  "kind": "PropertySignature",
808
- "canonicalReference": "@genesislcap/foundation-ai!ChatAgentConfig#maxHandoffs:member",
809
- "docComment": "/**\n * Maximum number of agent-to-agent handoffs per user turn. Default: 3.\n */\n",
853
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment#mimeType:member",
854
+ "docComment": "",
810
855
  "excerptTokens": [
811
856
  {
812
857
  "kind": "Content",
813
- "text": "maxHandoffs?: "
858
+ "text": "mimeType: "
814
859
  },
815
860
  {
816
861
  "kind": "Content",
817
- "text": "number"
862
+ "text": "string"
818
863
  },
819
864
  {
820
865
  "kind": "Content",
@@ -822,9 +867,9 @@
822
867
  }
823
868
  ],
824
869
  "isReadonly": false,
825
- "isOptional": true,
870
+ "isOptional": false,
826
871
  "releaseTag": "Beta",
827
- "name": "maxHandoffs",
872
+ "name": "mimeType",
828
873
  "propertyTypeTokenRange": {
829
874
  "startIndex": 1,
830
875
  "endIndex": 2
@@ -832,16 +877,16 @@
832
877
  },
833
878
  {
834
879
  "kind": "PropertySignature",
835
- "canonicalReference": "@genesislcap/foundation-ai!ChatAgentConfig#maxToolIterations:member",
836
- "docComment": "/**\n * Maximum number of tool call iterations within one agent's loop. Default: 50.\n */\n",
880
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment#name:member",
881
+ "docComment": "",
837
882
  "excerptTokens": [
838
883
  {
839
884
  "kind": "Content",
840
- "text": "maxToolIterations?: "
885
+ "text": "name: "
841
886
  },
842
887
  {
843
888
  "kind": "Content",
844
- "text": "number"
889
+ "text": "string"
845
890
  },
846
891
  {
847
892
  "kind": "Content",
@@ -849,9 +894,9 @@
849
894
  }
850
895
  ],
851
896
  "isReadonly": false,
852
- "isOptional": true,
897
+ "isOptional": false,
853
898
  "releaseTag": "Beta",
854
- "name": "maxToolIterations",
899
+ "name": "name",
855
900
  "propertyTypeTokenRange": {
856
901
  "startIndex": 1,
857
902
  "endIndex": 2
@@ -862,31 +907,31 @@
862
907
  },
863
908
  {
864
909
  "kind": "Interface",
865
- "canonicalReference": "@genesislcap/foundation-ai!ChatAnimationsConfig:interface",
866
- "docComment": "/**\n * Configuration for the animations feature.\n *\n * @beta\n */\n",
910
+ "canonicalReference": "@genesislcap/foundation-ai!ChatConfig:interface",
911
+ "docComment": "/**\n * Display and behaviour configuration for the chat assistant.\n *\n * For toggle flags (`showToolCalls`, `showThinkingSteps`): - `true` — default on, user can toggle off - `false` — default off, user can toggle on - `null` / `undefined` — completely disabled, no UI control shown\n *\n * @beta\n */\n",
867
912
  "excerptTokens": [
868
913
  {
869
914
  "kind": "Content",
870
- "text": "export interface ChatAnimationsConfig "
915
+ "text": "export interface ChatConfig "
871
916
  }
872
917
  ],
873
918
  "fileUrlPath": "src/types/chat.types.ts",
874
919
  "releaseTag": "Beta",
875
- "name": "ChatAnimationsConfig",
920
+ "name": "ChatConfig",
876
921
  "preserveMemberOrder": false,
877
922
  "members": [
878
923
  {
879
924
  "kind": "PropertySignature",
880
- "canonicalReference": "@genesislcap/foundation-ai!ChatAnimationsConfig#enabled:member",
881
- "docComment": "/**\n * Initially enabled animations. When omitted all animations are enabled by default.\n */\n",
925
+ "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#acceptedFiles:member",
926
+ "docComment": "/**\n * Comma-separated list of accepted file extensions for upload, e.g., \".txt,.md,.csv\". If undefined or empty, file uploads are disabled.\n */\n",
882
927
  "excerptTokens": [
883
928
  {
884
929
  "kind": "Content",
885
- "text": "enabled?: "
930
+ "text": "acceptedFiles?: "
886
931
  },
887
932
  {
888
933
  "kind": "Content",
889
- "text": "string[]"
934
+ "text": "string"
890
935
  },
891
936
  {
892
937
  "kind": "Content",
@@ -896,7 +941,7 @@
896
941
  "isReadonly": false,
897
942
  "isOptional": true,
898
943
  "releaseTag": "Beta",
899
- "name": "enabled",
944
+ "name": "acceptedFiles",
900
945
  "propertyTypeTokenRange": {
901
946
  "startIndex": 1,
902
947
  "endIndex": 2
@@ -904,12 +949,12 @@
904
949
  },
905
950
  {
906
951
  "kind": "PropertySignature",
907
- "canonicalReference": "@genesislcap/foundation-ai!ChatAnimationsConfig#userConfigurable:member",
908
- "docComment": "/**\n * When true, a multiselect control is shown in the settings panel so the user can toggle individual animations on or off.\n */\n",
952
+ "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#allowDebugDownload:member",
953
+ "docComment": "/**\n * Show a button to download the full chat history as JSON.\n */\n",
909
954
  "excerptTokens": [
910
955
  {
911
956
  "kind": "Content",
912
- "text": "userConfigurable: "
957
+ "text": "allowDebugDownload?: "
913
958
  },
914
959
  {
915
960
  "kind": "Content",
@@ -921,44 +966,27 @@
921
966
  }
922
967
  ],
923
968
  "isReadonly": false,
924
- "isOptional": false,
969
+ "isOptional": true,
925
970
  "releaseTag": "Beta",
926
- "name": "userConfigurable",
971
+ "name": "allowDebugDownload",
927
972
  "propertyTypeTokenRange": {
928
973
  "startIndex": 1,
929
974
  "endIndex": 2
930
975
  }
931
- }
932
- ],
933
- "extendsTokenRanges": []
934
- },
935
- {
936
- "kind": "Interface",
937
- "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment:interface",
938
- "docComment": "/**\n * A file attachment included with a user message.\n *\n * @beta\n */\n",
939
- "excerptTokens": [
940
- {
941
- "kind": "Content",
942
- "text": "export interface ChatAttachment "
943
- }
944
- ],
945
- "fileUrlPath": "src/types/chat.types.ts",
946
- "releaseTag": "Beta",
947
- "name": "ChatAttachment",
948
- "preserveMemberOrder": false,
949
- "members": [
976
+ },
950
977
  {
951
978
  "kind": "PropertySignature",
952
- "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment#content:member",
953
- "docComment": "",
979
+ "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#animations:member",
980
+ "docComment": "/**\n * Animations feature configuration.\n */\n",
954
981
  "excerptTokens": [
955
982
  {
956
983
  "kind": "Content",
957
- "text": "content: "
984
+ "text": "animations?: "
958
985
  },
959
986
  {
960
- "kind": "Content",
961
- "text": "string"
987
+ "kind": "Reference",
988
+ "text": "ChatAnimationsConfig",
989
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAnimationsConfig:interface"
962
990
  },
963
991
  {
964
992
  "kind": "Content",
@@ -966,9 +994,9 @@
966
994
  }
967
995
  ],
968
996
  "isReadonly": false,
969
- "isOptional": false,
997
+ "isOptional": true,
970
998
  "releaseTag": "Beta",
971
- "name": "content",
999
+ "name": "animations",
972
1000
  "propertyTypeTokenRange": {
973
1001
  "startIndex": 1,
974
1002
  "endIndex": 2
@@ -976,16 +1004,16 @@
976
1004
  },
977
1005
  {
978
1006
  "kind": "PropertySignature",
979
- "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment#mimeType:member",
980
- "docComment": "",
1007
+ "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#loadingDelay:member",
1008
+ "docComment": "/**\n * Seconds to wait before showing the loading spinner. Default: 5. Set to 0 to show the spinner immediately when a request is in flight.\n */\n",
981
1009
  "excerptTokens": [
982
1010
  {
983
1011
  "kind": "Content",
984
- "text": "mimeType: "
1012
+ "text": "loadingDelay?: "
985
1013
  },
986
1014
  {
987
1015
  "kind": "Content",
988
- "text": "string"
1016
+ "text": "number"
989
1017
  },
990
1018
  {
991
1019
  "kind": "Content",
@@ -993,9 +1021,9 @@
993
1021
  }
994
1022
  ],
995
1023
  "isReadonly": false,
996
- "isOptional": false,
1024
+ "isOptional": true,
997
1025
  "releaseTag": "Beta",
998
- "name": "mimeType",
1026
+ "name": "loadingDelay",
999
1027
  "propertyTypeTokenRange": {
1000
1028
  "startIndex": 1,
1001
1029
  "endIndex": 2
@@ -1003,16 +1031,16 @@
1003
1031
  },
1004
1032
  {
1005
1033
  "kind": "PropertySignature",
1006
- "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment#name:member",
1007
- "docComment": "",
1034
+ "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#maxToolIterations:member",
1035
+ "docComment": "/**\n * Maximum number of tool call iterations per turn. Default: 50.\n */\n",
1008
1036
  "excerptTokens": [
1009
1037
  {
1010
1038
  "kind": "Content",
1011
- "text": "name: "
1039
+ "text": "maxToolIterations?: "
1012
1040
  },
1013
1041
  {
1014
1042
  "kind": "Content",
1015
- "text": "string"
1043
+ "text": "number"
1016
1044
  },
1017
1045
  {
1018
1046
  "kind": "Content",
@@ -1020,45 +1048,26 @@
1020
1048
  }
1021
1049
  ],
1022
1050
  "isReadonly": false,
1023
- "isOptional": false,
1051
+ "isOptional": true,
1024
1052
  "releaseTag": "Beta",
1025
- "name": "name",
1053
+ "name": "maxToolIterations",
1026
1054
  "propertyTypeTokenRange": {
1027
1055
  "startIndex": 1,
1028
1056
  "endIndex": 2
1029
1057
  }
1030
- }
1031
- ],
1032
- "extendsTokenRanges": []
1033
- },
1034
- {
1035
- "kind": "Interface",
1036
- "canonicalReference": "@genesislcap/foundation-ai!ChatConfig:interface",
1037
- "docComment": "/**\n * Display and engine configuration for the chat assistant.\n *\n * @beta\n */\n",
1038
- "excerptTokens": [
1039
- {
1040
- "kind": "Content",
1041
- "text": "export interface ChatConfig "
1042
- }
1043
- ],
1044
- "fileUrlPath": "src/types/chat.types.ts",
1045
- "releaseTag": "Beta",
1046
- "name": "ChatConfig",
1047
- "preserveMemberOrder": false,
1048
- "members": [
1058
+ },
1049
1059
  {
1050
1060
  "kind": "PropertySignature",
1051
- "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#agent:member",
1052
- "docComment": "/**\n * Agent engine settings — iteration limits, handoff caps, classifier tuning.\n */\n",
1061
+ "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#showThinkingSteps:member",
1062
+ "docComment": "/**\n * Show model thinking/reasoning steps.\n */\n",
1053
1063
  "excerptTokens": [
1054
1064
  {
1055
1065
  "kind": "Content",
1056
- "text": "agent?: "
1066
+ "text": "showThinkingSteps?: "
1057
1067
  },
1058
1068
  {
1059
- "kind": "Reference",
1060
- "text": "ChatAgentConfig",
1061
- "canonicalReference": "@genesislcap/foundation-ai!ChatAgentConfig:interface"
1069
+ "kind": "Content",
1070
+ "text": "boolean | null"
1062
1071
  },
1063
1072
  {
1064
1073
  "kind": "Content",
@@ -1068,7 +1077,7 @@
1068
1077
  "isReadonly": false,
1069
1078
  "isOptional": true,
1070
1079
  "releaseTag": "Beta",
1071
- "name": "agent",
1080
+ "name": "showThinkingSteps",
1072
1081
  "propertyTypeTokenRange": {
1073
1082
  "startIndex": 1,
1074
1083
  "endIndex": 2
@@ -1076,17 +1085,16 @@
1076
1085
  },
1077
1086
  {
1078
1087
  "kind": "PropertySignature",
1079
- "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#ui:member",
1080
- "docComment": "/**\n * UI display settings — toggles, file upload, animations, etc.\n */\n",
1088
+ "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#showToolCalls:member",
1089
+ "docComment": "/**\n * Show tool call details in the chat UI.\n */\n",
1081
1090
  "excerptTokens": [
1082
1091
  {
1083
1092
  "kind": "Content",
1084
- "text": "ui?: "
1093
+ "text": "showToolCalls?: "
1085
1094
  },
1086
1095
  {
1087
- "kind": "Reference",
1088
- "text": "ChatUiConfig",
1089
- "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig:interface"
1096
+ "kind": "Content",
1097
+ "text": "boolean | null"
1090
1098
  },
1091
1099
  {
1092
1100
  "kind": "Content",
@@ -1096,7 +1104,7 @@
1096
1104
  "isReadonly": false,
1097
1105
  "isOptional": true,
1098
1106
  "releaseTag": "Beta",
1099
- "name": "ui",
1107
+ "name": "showToolCalls",
1100
1108
  "propertyTypeTokenRange": {
1101
1109
  "startIndex": 1,
1102
1110
  "endIndex": 2
@@ -1105,32 +1113,6 @@
1105
1113
  ],
1106
1114
  "extendsTokenRanges": []
1107
1115
  },
1108
- {
1109
- "kind": "TypeAlias",
1110
- "canonicalReference": "@genesislcap/foundation-ai!ChatDriverResult:type",
1111
- "docComment": "/**\n * The result returned by a driver after processing a user turn.\n *\n * @beta\n */\n",
1112
- "excerptTokens": [
1113
- {
1114
- "kind": "Content",
1115
- "text": "export type ChatDriverResult = "
1116
- },
1117
- {
1118
- "kind": "Content",
1119
- "text": "{\n reason: 'done';\n} | {\n reason: 'agent-handoff';\n summary: string;\n remainingTask: string;\n}"
1120
- },
1121
- {
1122
- "kind": "Content",
1123
- "text": ";"
1124
- }
1125
- ],
1126
- "fileUrlPath": "src/types/chat.types.ts",
1127
- "releaseTag": "Beta",
1128
- "name": "ChatDriverResult",
1129
- "typeTokenRange": {
1130
- "startIndex": 1,
1131
- "endIndex": 2
1132
- }
1133
- },
1134
1116
  {
1135
1117
  "kind": "Interface",
1136
1118
  "canonicalReference": "@genesislcap/foundation-ai!ChatInteraction:interface",
@@ -1272,33 +1254,6 @@
1272
1254
  "name": "ChatMessage",
1273
1255
  "preserveMemberOrder": false,
1274
1256
  "members": [
1275
- {
1276
- "kind": "PropertySignature",
1277
- "canonicalReference": "@genesislcap/foundation-ai!ChatMessage#agentName:member",
1278
- "docComment": "/**\n * Name of the agent that produced this message. Set by OrchestratingDriver.\n */\n",
1279
- "excerptTokens": [
1280
- {
1281
- "kind": "Content",
1282
- "text": "agentName?: "
1283
- },
1284
- {
1285
- "kind": "Content",
1286
- "text": "string"
1287
- },
1288
- {
1289
- "kind": "Content",
1290
- "text": ";"
1291
- }
1292
- ],
1293
- "isReadonly": false,
1294
- "isOptional": true,
1295
- "releaseTag": "Beta",
1296
- "name": "agentName",
1297
- "propertyTypeTokenRange": {
1298
- "startIndex": 1,
1299
- "endIndex": 2
1300
- }
1301
- },
1302
1257
  {
1303
1258
  "kind": "PropertySignature",
1304
1259
  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage#attachments:member",
@@ -1652,7 +1607,7 @@
1652
1607
  },
1653
1608
  {
1654
1609
  "kind": "Content",
1655
- "text": "'user' | 'assistant' | 'system' | 'tool' | 'system-event'"
1610
+ "text": "'user' | 'assistant' | 'system' | 'tool'"
1656
1611
  },
1657
1612
  {
1658
1613
  "kind": "Content",
@@ -2321,214 +2276,6 @@
2321
2276
  ],
2322
2277
  "extendsTokenRanges": []
2323
2278
  },
2324
- {
2325
- "kind": "Interface",
2326
- "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig:interface",
2327
- "docComment": "/**\n * UI display configuration for the chat assistant.\n *\n * For toggle flags (`showToolCalls`, `showThinkingSteps`): - `true` — default on, user can toggle off - `false` — default off, user can toggle on - `null` / `undefined` — completely disabled, no UI control shown\n *\n * @beta\n */\n",
2328
- "excerptTokens": [
2329
- {
2330
- "kind": "Content",
2331
- "text": "export interface ChatUiConfig "
2332
- }
2333
- ],
2334
- "fileUrlPath": "src/types/chat.types.ts",
2335
- "releaseTag": "Beta",
2336
- "name": "ChatUiConfig",
2337
- "preserveMemberOrder": false,
2338
- "members": [
2339
- {
2340
- "kind": "PropertySignature",
2341
- "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#acceptedFiles:member",
2342
- "docComment": "/**\n * Comma-separated list of accepted file extensions for upload, e.g., \".txt,.md,.csv\". If undefined or empty, file uploads are disabled.\n */\n",
2343
- "excerptTokens": [
2344
- {
2345
- "kind": "Content",
2346
- "text": "acceptedFiles?: "
2347
- },
2348
- {
2349
- "kind": "Content",
2350
- "text": "string"
2351
- },
2352
- {
2353
- "kind": "Content",
2354
- "text": ";"
2355
- }
2356
- ],
2357
- "isReadonly": false,
2358
- "isOptional": true,
2359
- "releaseTag": "Beta",
2360
- "name": "acceptedFiles",
2361
- "propertyTypeTokenRange": {
2362
- "startIndex": 1,
2363
- "endIndex": 2
2364
- }
2365
- },
2366
- {
2367
- "kind": "PropertySignature",
2368
- "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#allowDebugDownload:member",
2369
- "docComment": "/**\n * Show a button to download the full chat history as JSON.\n */\n",
2370
- "excerptTokens": [
2371
- {
2372
- "kind": "Content",
2373
- "text": "allowDebugDownload?: "
2374
- },
2375
- {
2376
- "kind": "Content",
2377
- "text": "boolean"
2378
- },
2379
- {
2380
- "kind": "Content",
2381
- "text": ";"
2382
- }
2383
- ],
2384
- "isReadonly": false,
2385
- "isOptional": true,
2386
- "releaseTag": "Beta",
2387
- "name": "allowDebugDownload",
2388
- "propertyTypeTokenRange": {
2389
- "startIndex": 1,
2390
- "endIndex": 2
2391
- }
2392
- },
2393
- {
2394
- "kind": "PropertySignature",
2395
- "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#animations:member",
2396
- "docComment": "/**\n * Animations feature configuration.\n */\n",
2397
- "excerptTokens": [
2398
- {
2399
- "kind": "Content",
2400
- "text": "animations?: "
2401
- },
2402
- {
2403
- "kind": "Reference",
2404
- "text": "ChatAnimationsConfig",
2405
- "canonicalReference": "@genesislcap/foundation-ai!ChatAnimationsConfig:interface"
2406
- },
2407
- {
2408
- "kind": "Content",
2409
- "text": ";"
2410
- }
2411
- ],
2412
- "isReadonly": false,
2413
- "isOptional": true,
2414
- "releaseTag": "Beta",
2415
- "name": "animations",
2416
- "propertyTypeTokenRange": {
2417
- "startIndex": 1,
2418
- "endIndex": 2
2419
- }
2420
- },
2421
- {
2422
- "kind": "PropertySignature",
2423
- "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#loadingDelay:member",
2424
- "docComment": "/**\n * Seconds to wait before showing the loading spinner. Default: 5. Set to 0 to show the spinner immediately when a request is in flight.\n */\n",
2425
- "excerptTokens": [
2426
- {
2427
- "kind": "Content",
2428
- "text": "loadingDelay?: "
2429
- },
2430
- {
2431
- "kind": "Content",
2432
- "text": "number"
2433
- },
2434
- {
2435
- "kind": "Content",
2436
- "text": ";"
2437
- }
2438
- ],
2439
- "isReadonly": false,
2440
- "isOptional": true,
2441
- "releaseTag": "Beta",
2442
- "name": "loadingDelay",
2443
- "propertyTypeTokenRange": {
2444
- "startIndex": 1,
2445
- "endIndex": 2
2446
- }
2447
- },
2448
- {
2449
- "kind": "PropertySignature",
2450
- "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#showAgentSwitchIndicator:member",
2451
- "docComment": "/**\n * Show an inline divider in the message list when the active specialist changes. Also shown automatically when showToolCalls is true. - `true` — default on, user can toggle off - `false` — default off, user can toggle on - `null` / `undefined` — completely disabled, no UI control shown\n */\n",
2452
- "excerptTokens": [
2453
- {
2454
- "kind": "Content",
2455
- "text": "showAgentSwitchIndicator?: "
2456
- },
2457
- {
2458
- "kind": "Content",
2459
- "text": "boolean | null"
2460
- },
2461
- {
2462
- "kind": "Content",
2463
- "text": ";"
2464
- }
2465
- ],
2466
- "isReadonly": false,
2467
- "isOptional": true,
2468
- "releaseTag": "Beta",
2469
- "name": "showAgentSwitchIndicator",
2470
- "propertyTypeTokenRange": {
2471
- "startIndex": 1,
2472
- "endIndex": 2
2473
- }
2474
- },
2475
- {
2476
- "kind": "PropertySignature",
2477
- "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#showThinkingSteps:member",
2478
- "docComment": "/**\n * Show model thinking/reasoning steps.\n */\n",
2479
- "excerptTokens": [
2480
- {
2481
- "kind": "Content",
2482
- "text": "showThinkingSteps?: "
2483
- },
2484
- {
2485
- "kind": "Content",
2486
- "text": "boolean | null"
2487
- },
2488
- {
2489
- "kind": "Content",
2490
- "text": ";"
2491
- }
2492
- ],
2493
- "isReadonly": false,
2494
- "isOptional": true,
2495
- "releaseTag": "Beta",
2496
- "name": "showThinkingSteps",
2497
- "propertyTypeTokenRange": {
2498
- "startIndex": 1,
2499
- "endIndex": 2
2500
- }
2501
- },
2502
- {
2503
- "kind": "PropertySignature",
2504
- "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#showToolCalls:member",
2505
- "docComment": "/**\n * Show tool call details in the chat UI.\n */\n",
2506
- "excerptTokens": [
2507
- {
2508
- "kind": "Content",
2509
- "text": "showToolCalls?: "
2510
- },
2511
- {
2512
- "kind": "Content",
2513
- "text": "boolean | null"
2514
- },
2515
- {
2516
- "kind": "Content",
2517
- "text": ";"
2518
- }
2519
- ],
2520
- "isReadonly": false,
2521
- "isOptional": true,
2522
- "releaseTag": "Beta",
2523
- "name": "showToolCalls",
2524
- "propertyTypeTokenRange": {
2525
- "startIndex": 1,
2526
- "endIndex": 2
2527
- }
2528
- }
2529
- ],
2530
- "extendsTokenRanges": []
2531
- },
2532
2279
  {
2533
2280
  "kind": "Interface",
2534
2281
  "canonicalReference": "@genesislcap/foundation-ai!ChromeAIConfig:interface",
@@ -3938,7 +3685,7 @@
3938
3685
  {
3939
3686
  "kind": "Function",
3940
3687
  "canonicalReference": "@genesislcap/foundation-ai!isAIFeatureEnabled:function(1)",
3941
- "docComment": "/**\n * Returns true when AI features (beta) are enabled via ?feature.ai URL param or GENX_ENABLE_AI=true env var.\n */\n",
3688
+ "docComment": "/**\n * Returns true when AI features (beta) are enabled. Requires ?feature.ai in URL.\n */\n",
3942
3689
  "excerptTokens": [
3943
3690
  {
3944
3691
  "kind": "Content",
package/dist/foundation-ai.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { InterfaceSymbol } from '@microsoft/fast-foundation';
2
2
 
3
- /** Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL or GENX_ENABLE_AI env var. */
3
+ /** Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL. */
4
4
  export declare const AI_FEATURE_FLAG = "ai";
5
5
 
6
6
  /**
@@ -101,22 +101,6 @@ declare interface AITransport {
101
101
  isAvailable?(): Promise<boolean>;
102
102
  }
103
103
 
104
- /**
105
- * Agent engine configuration for the chat assistant.
106
- *
107
- * @beta
108
- */
109
- export declare interface ChatAgentConfig {
110
- /** Maximum number of tool call iterations within one agent's loop. Default: 50. */
111
- maxToolIterations?: number;
112
- /** Maximum number of agent-to-agent handoffs per user turn. Default: 3. */
113
- maxHandoffs?: number;
114
- /** Number of recent messages passed to the classifier for context. Default: 4. */
115
- classifierHistoryLength?: number;
116
- /** Number of retries on classifier failure before erroring. Default: 2. */
117
- classifierRetries?: number;
118
- }
119
-
120
104
  /**
121
105
  * Configuration for the animations feature.
122
106
  *
@@ -147,30 +131,35 @@ export declare interface ChatAttachment {
147
131
  }
148
132
 
149
133
  /**
150
- * Display and engine configuration for the chat assistant.
134
+ * Display and behaviour configuration for the chat assistant.
135
+ *
136
+ * For toggle flags (`showToolCalls`, `showThinkingSteps`):
137
+ * - `true` — default on, user can toggle off
138
+ * - `false` — default off, user can toggle on
139
+ * - `null` / `undefined` — completely disabled, no UI control shown
151
140
  *
152
141
  * @beta
153
142
  */
154
143
  export declare interface ChatConfig {
155
- /** UI display settings — toggles, file upload, animations, etc. */
156
- ui?: ChatUiConfig;
157
- /** Agent engine settings — iteration limits, handoff caps, classifier tuning. */
158
- agent?: ChatAgentConfig;
144
+ /** Show tool call details in the chat UI. */
145
+ showToolCalls?: boolean | null;
146
+ /** Show model thinking/reasoning steps. */
147
+ showThinkingSteps?: boolean | null;
148
+ /** Show a button to download the full chat history as JSON. */
149
+ allowDebugDownload?: boolean;
150
+ /** Comma-separated list of accepted file extensions for upload, e.g., ".txt,.md,.csv". If undefined or empty, file uploads are disabled. */
151
+ acceptedFiles?: string;
152
+ /**
153
+ * Seconds to wait before showing the loading spinner. Default: 5.
154
+ * Set to 0 to show the spinner immediately when a request is in flight.
155
+ */
156
+ loadingDelay?: number;
157
+ /** Animations feature configuration. */
158
+ animations?: ChatAnimationsConfig;
159
+ /** Maximum number of tool call iterations per turn. Default: 50. */
160
+ maxToolIterations?: number;
159
161
  }
160
162
 
161
- /**
162
- * The result returned by a driver after processing a user turn.
163
- *
164
- * @beta
165
- */
166
- export declare type ChatDriverResult = {
167
- reason: 'done';
168
- } | {
169
- reason: 'agent-handoff';
170
- summary: string;
171
- remainingTask: string;
172
- };
173
-
174
163
  /**
175
164
  * A user interaction component request.
176
165
  *
@@ -197,8 +186,6 @@ export declare interface ChatMessage {
197
186
  attachments?: ChatAttachment[];
198
187
  interaction?: ChatInteraction;
199
188
  thinking?: boolean;
200
- /** Name of the agent that produced this message. Set by OrchestratingDriver. */
201
- agentName?: string;
202
189
  }
203
190
 
204
191
  /**
@@ -218,7 +205,7 @@ export declare interface ChatRequestOptions {
218
205
  *
219
206
  * @beta
220
207
  */
221
- export declare type ChatRole = 'user' | 'assistant' | 'system' | 'tool' | 'system-event';
208
+ export declare type ChatRole = 'user' | 'assistant' | 'system' | 'tool';
222
209
 
223
210
  /**
224
211
  * A streaming chunk from a chat response.
@@ -287,42 +274,6 @@ export declare interface ChatTransport {
287
274
  streamChatMessage?(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): AsyncIterable<ChatStreamChunk>;
288
275
  }
289
276
 
290
- /**
291
- * UI display configuration for the chat assistant.
292
- *
293
- * For toggle flags (`showToolCalls`, `showThinkingSteps`):
294
- * - `true` — default on, user can toggle off
295
- * - `false` — default off, user can toggle on
296
- * - `null` / `undefined` — completely disabled, no UI control shown
297
- *
298
- * @beta
299
- */
300
- export declare interface ChatUiConfig {
301
- /** Show tool call details in the chat UI. */
302
- showToolCalls?: boolean | null;
303
- /** Show model thinking/reasoning steps. */
304
- showThinkingSteps?: boolean | null;
305
- /** Show a button to download the full chat history as JSON. */
306
- allowDebugDownload?: boolean;
307
- /** Comma-separated list of accepted file extensions for upload, e.g., ".txt,.md,.csv". If undefined or empty, file uploads are disabled. */
308
- acceptedFiles?: string;
309
- /**
310
- * Seconds to wait before showing the loading spinner. Default: 5.
311
- * Set to 0 to show the spinner immediately when a request is in flight.
312
- */
313
- loadingDelay?: number;
314
- /** Animations feature configuration. */
315
- animations?: ChatAnimationsConfig;
316
- /**
317
- * Show an inline divider in the message list when the active specialist changes.
318
- * Also shown automatically when showToolCalls is true.
319
- * - `true` — default on, user can toggle off
320
- * - `false` — default off, user can toggle on
321
- * - `null` / `undefined` — completely disabled, no UI control shown
322
- */
323
- showAgentSwitchIndicator?: boolean | null;
324
- }
325
-
326
277
  /**
327
278
  * Chrome built-in AI (Prompt API / Gemini Nano) configuration.
328
279
  *
@@ -528,7 +479,7 @@ export declare type InteractionResult<T = unknown> = {
528
479
  message?: string;
529
480
  };
530
481
 
531
- /** Returns true when AI features (beta) are enabled via ?feature.ai URL param or GENX_ENABLE_AI=true env var. */
482
+ /** Returns true when AI features (beta) are enabled. Requires ?feature.ai in URL. */
532
483
  export declare const isAIFeatureEnabled: () => boolean;
533
484
 
534
485
  /**
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@genesislcap/foundation-ai",
3
3
  "description": "Genesis Foundation AI - Provider-agnostic AI configuration and shared utilities",
4
- "version": "14.409.0-FUI-2495.2",
4
+ "version": "14.409.1",
5
5
  "sideEffects": false,
6
6
  "license": "SEE LICENSE IN license.txt",
7
7
  "main": "dist/esm/index.js",
@@ -51,17 +51,17 @@
51
51
  }
52
52
  },
53
53
  "devDependencies": {
54
- "@genesislcap/foundation-testing": "14.409.0-FUI-2495.2",
55
- "@genesislcap/genx": "14.409.0-FUI-2495.2",
56
- "@genesislcap/rollup-builder": "14.409.0-FUI-2495.2",
57
- "@genesislcap/ts-builder": "14.409.0-FUI-2495.2",
58
- "@genesislcap/uvu-playwright-builder": "14.409.0-FUI-2495.2",
59
- "@genesislcap/vite-builder": "14.409.0-FUI-2495.2",
60
- "@genesislcap/webpack-builder": "14.409.0-FUI-2495.2"
54
+ "@genesislcap/foundation-testing": "14.409.1",
55
+ "@genesislcap/genx": "14.409.1",
56
+ "@genesislcap/rollup-builder": "14.409.1",
57
+ "@genesislcap/ts-builder": "14.409.1",
58
+ "@genesislcap/uvu-playwright-builder": "14.409.1",
59
+ "@genesislcap/vite-builder": "14.409.1",
60
+ "@genesislcap/webpack-builder": "14.409.1"
61
61
  },
62
62
  "dependencies": {
63
- "@genesislcap/foundation-logger": "14.409.0-FUI-2495.2",
64
- "@genesislcap/foundation-utils": "14.409.0-FUI-2495.2",
63
+ "@genesislcap/foundation-logger": "14.409.1",
64
+ "@genesislcap/foundation-utils": "14.409.1",
65
65
  "@microsoft/fast-foundation": "2.50.0"
66
66
  },
67
67
  "repository": {
@@ -72,5 +72,5 @@
72
72
  "publishConfig": {
73
73
  "access": "public"
74
74
  },
75
- "gitHead": "1fcaf08e9b7559024b25dc6ccc27e3bc62f1512b"
75
+ "gitHead": "a23531e1359a6381e7d4fd81e98bd8d2e9981560"
76
76
  }