@genesislcap/foundation-ai 14.420.0 → 14.421.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 (25) hide show
  1. package/README.md +7 -1
  2. package/dist/dts/ai-provider.d.ts +10 -2
  3. package/dist/dts/ai-provider.d.ts.map +1 -1
  4. package/dist/dts/index.d.ts +4 -2
  5. package/dist/dts/index.d.ts.map +1 -1
  6. package/dist/dts/providers/gemini-provider.d.ts +1 -0
  7. package/dist/dts/providers/gemini-provider.d.ts.map +1 -1
  8. package/dist/dts/transports/gemini-transport.d.ts +6 -5
  9. package/dist/dts/transports/gemini-transport.d.ts.map +1 -1
  10. package/dist/dts/types/chat.types.d.ts +145 -8
  11. package/dist/dts/types/chat.types.d.ts.map +1 -1
  12. package/dist/dts/types/config.types.d.ts +10 -1
  13. package/dist/dts/types/config.types.d.ts.map +1 -1
  14. package/dist/dts/utils/feature-flags.d.ts +2 -2
  15. package/dist/dts/utils/feature-flags.d.ts.map +1 -1
  16. package/dist/esm/ai-provider.js +8 -3
  17. package/dist/esm/index.js +2 -0
  18. package/dist/esm/providers/gemini-provider.js +6 -0
  19. package/dist/esm/transports/gemini-transport.js +40 -12
  20. package/dist/esm/types/chat.types.js +8 -1
  21. package/dist/esm/types/config.types.js +5 -1
  22. package/dist/esm/utils/feature-flags.js +10 -3
  23. package/dist/foundation-ai.api.json +890 -246
  24. package/dist/foundation-ai.d.ts +200 -36
  25. package/package.json +11 -11
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.\n */\n",
178
+ "docComment": "/**\n * Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL or GENX_ENABLE_AI env var.\n */\n",
179
179
  "excerptTokens": [
180
180
  {
181
181
  "kind": "Content",
@@ -474,6 +474,73 @@
474
474
  ],
475
475
  "name": "interpretCriteria"
476
476
  },
477
+ {
478
+ "kind": "MethodSignature",
479
+ "canonicalReference": "@genesislcap/foundation-ai!AIProvider#prompt:member(1)",
480
+ "docComment": "/**\n * Stateless one-off prompt. No conversation history is maintained. Returns the plain text response. Use this for side-calls (suggestions, summarisation, classification) that should not interact with any ongoing conversation context. Providers that support chat implement this.\n */\n",
481
+ "excerptTokens": [
482
+ {
483
+ "kind": "Content",
484
+ "text": "prompt?(message: "
485
+ },
486
+ {
487
+ "kind": "Content",
488
+ "text": "string"
489
+ },
490
+ {
491
+ "kind": "Content",
492
+ "text": ", options?: "
493
+ },
494
+ {
495
+ "kind": "Reference",
496
+ "text": "ChatRequestOptions",
497
+ "canonicalReference": "@genesislcap/foundation-ai!ChatRequestOptions:interface"
498
+ },
499
+ {
500
+ "kind": "Content",
501
+ "text": "): "
502
+ },
503
+ {
504
+ "kind": "Reference",
505
+ "text": "Promise",
506
+ "canonicalReference": "!Promise:interface"
507
+ },
508
+ {
509
+ "kind": "Content",
510
+ "text": "<string>"
511
+ },
512
+ {
513
+ "kind": "Content",
514
+ "text": ";"
515
+ }
516
+ ],
517
+ "isOptional": true,
518
+ "returnTypeTokenRange": {
519
+ "startIndex": 5,
520
+ "endIndex": 7
521
+ },
522
+ "releaseTag": "Beta",
523
+ "overloadIndex": 1,
524
+ "parameters": [
525
+ {
526
+ "parameterName": "message",
527
+ "parameterTypeTokenRange": {
528
+ "startIndex": 1,
529
+ "endIndex": 2
530
+ },
531
+ "isOptional": false
532
+ },
533
+ {
534
+ "parameterName": "options",
535
+ "parameterTypeTokenRange": {
536
+ "startIndex": 3,
537
+ "endIndex": 4
538
+ },
539
+ "isOptional": true
540
+ }
541
+ ],
542
+ "name": "prompt"
543
+ },
477
544
  {
478
545
  "kind": "MethodSignature",
479
546
  "canonicalReference": "@genesislcap/foundation-ai!AIProvider#streamChat:member(1)",
@@ -736,31 +803,31 @@
736
803
  },
737
804
  {
738
805
  "kind": "Interface",
739
- "canonicalReference": "@genesislcap/foundation-ai!ChatAnimationsConfig:interface",
740
- "docComment": "/**\n * Configuration for the animations feature.\n *\n * @beta\n */\n",
806
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAgentConfig:interface",
807
+ "docComment": "/**\n * Agent engine configuration for the chat assistant.\n *\n * @beta\n */\n",
741
808
  "excerptTokens": [
742
809
  {
743
810
  "kind": "Content",
744
- "text": "export interface ChatAnimationsConfig "
811
+ "text": "export interface ChatAgentConfig "
745
812
  }
746
813
  ],
747
814
  "fileUrlPath": "src/types/chat.types.ts",
748
815
  "releaseTag": "Beta",
749
- "name": "ChatAnimationsConfig",
816
+ "name": "ChatAgentConfig",
750
817
  "preserveMemberOrder": false,
751
818
  "members": [
752
819
  {
753
820
  "kind": "PropertySignature",
754
- "canonicalReference": "@genesislcap/foundation-ai!ChatAnimationsConfig#enabled:member",
755
- "docComment": "/**\n * Initially enabled animations. When omitted all animations are enabled by default.\n */\n",
821
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAgentConfig#classifierHistoryLength:member",
822
+ "docComment": "/**\n * Number of recent messages passed to the classifier for context. Default: 4.\n */\n",
756
823
  "excerptTokens": [
757
824
  {
758
825
  "kind": "Content",
759
- "text": "enabled?: "
826
+ "text": "classifierHistoryLength?: "
760
827
  },
761
828
  {
762
829
  "kind": "Content",
763
- "text": "string[]"
830
+ "text": "number"
764
831
  },
765
832
  {
766
833
  "kind": "Content",
@@ -770,7 +837,7 @@
770
837
  "isReadonly": false,
771
838
  "isOptional": true,
772
839
  "releaseTag": "Beta",
773
- "name": "enabled",
840
+ "name": "classifierHistoryLength",
774
841
  "propertyTypeTokenRange": {
775
842
  "startIndex": 1,
776
843
  "endIndex": 2
@@ -778,16 +845,16 @@
778
845
  },
779
846
  {
780
847
  "kind": "PropertySignature",
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",
848
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAgentConfig#classifierRetries:member",
849
+ "docComment": "/**\n * Number of retries on classifier failure before erroring. Default: 2.\n */\n",
783
850
  "excerptTokens": [
784
851
  {
785
852
  "kind": "Content",
786
- "text": "userConfigurable: "
853
+ "text": "classifierRetries?: "
787
854
  },
788
855
  {
789
856
  "kind": "Content",
790
- "text": "boolean"
857
+ "text": "number"
791
858
  },
792
859
  {
793
860
  "kind": "Content",
@@ -795,44 +862,26 @@
795
862
  }
796
863
  ],
797
864
  "isReadonly": false,
798
- "isOptional": false,
865
+ "isOptional": true,
799
866
  "releaseTag": "Beta",
800
- "name": "userConfigurable",
867
+ "name": "classifierRetries",
801
868
  "propertyTypeTokenRange": {
802
869
  "startIndex": 1,
803
870
  "endIndex": 2
804
871
  }
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": [
872
+ },
824
873
  {
825
874
  "kind": "PropertySignature",
826
- "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment#content:member",
827
- "docComment": "",
875
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAgentConfig#maxFoldOperations:member",
876
+ "docComment": "/**\n * Maximum number of consecutive fold open/close operations without a real tool call before the driver injects a guidance message. Default: 5.\n */\n",
828
877
  "excerptTokens": [
829
878
  {
830
879
  "kind": "Content",
831
- "text": "content: "
880
+ "text": "maxFoldOperations?: "
832
881
  },
833
882
  {
834
883
  "kind": "Content",
835
- "text": "string"
884
+ "text": "number"
836
885
  },
837
886
  {
838
887
  "kind": "Content",
@@ -840,9 +889,9 @@
840
889
  }
841
890
  ],
842
891
  "isReadonly": false,
843
- "isOptional": false,
892
+ "isOptional": true,
844
893
  "releaseTag": "Beta",
845
- "name": "content",
894
+ "name": "maxFoldOperations",
846
895
  "propertyTypeTokenRange": {
847
896
  "startIndex": 1,
848
897
  "endIndex": 2
@@ -850,16 +899,16 @@
850
899
  },
851
900
  {
852
901
  "kind": "PropertySignature",
853
- "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment#mimeType:member",
854
- "docComment": "",
902
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAgentConfig#maxHandoffs:member",
903
+ "docComment": "/**\n * Maximum number of agent-to-agent handoffs per user turn. Default: 3.\n */\n",
855
904
  "excerptTokens": [
856
905
  {
857
906
  "kind": "Content",
858
- "text": "mimeType: "
907
+ "text": "maxHandoffs?: "
859
908
  },
860
909
  {
861
910
  "kind": "Content",
862
- "text": "string"
911
+ "text": "number"
863
912
  },
864
913
  {
865
914
  "kind": "Content",
@@ -867,9 +916,9 @@
867
916
  }
868
917
  ],
869
918
  "isReadonly": false,
870
- "isOptional": false,
919
+ "isOptional": true,
871
920
  "releaseTag": "Beta",
872
- "name": "mimeType",
921
+ "name": "maxHandoffs",
873
922
  "propertyTypeTokenRange": {
874
923
  "startIndex": 1,
875
924
  "endIndex": 2
@@ -877,16 +926,16 @@
877
926
  },
878
927
  {
879
928
  "kind": "PropertySignature",
880
- "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment#name:member",
881
- "docComment": "",
929
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAgentConfig#maxToolIterations:member",
930
+ "docComment": "/**\n * Maximum number of tool call iterations within one agent's loop. Default: 50.\n */\n",
882
931
  "excerptTokens": [
883
932
  {
884
933
  "kind": "Content",
885
- "text": "name: "
934
+ "text": "maxToolIterations?: "
886
935
  },
887
936
  {
888
937
  "kind": "Content",
889
- "text": "string"
938
+ "text": "number"
890
939
  },
891
940
  {
892
941
  "kind": "Content",
@@ -894,9 +943,9 @@
894
943
  }
895
944
  ],
896
945
  "isReadonly": false,
897
- "isOptional": false,
946
+ "isOptional": true,
898
947
  "releaseTag": "Beta",
899
- "name": "name",
948
+ "name": "maxToolIterations",
900
949
  "propertyTypeTokenRange": {
901
950
  "startIndex": 1,
902
951
  "endIndex": 2
@@ -907,31 +956,31 @@
907
956
  },
908
957
  {
909
958
  "kind": "Interface",
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",
959
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAnimationsConfig:interface",
960
+ "docComment": "/**\n * Configuration for the animations feature.\n *\n * @beta\n */\n",
912
961
  "excerptTokens": [
913
962
  {
914
963
  "kind": "Content",
915
- "text": "export interface ChatConfig "
964
+ "text": "export interface ChatAnimationsConfig "
916
965
  }
917
966
  ],
918
967
  "fileUrlPath": "src/types/chat.types.ts",
919
968
  "releaseTag": "Beta",
920
- "name": "ChatConfig",
969
+ "name": "ChatAnimationsConfig",
921
970
  "preserveMemberOrder": false,
922
971
  "members": [
923
972
  {
924
973
  "kind": "PropertySignature",
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",
974
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAnimationsConfig#enabled:member",
975
+ "docComment": "/**\n * Initially enabled animations. When omitted all animations are enabled by default.\n */\n",
927
976
  "excerptTokens": [
928
977
  {
929
978
  "kind": "Content",
930
- "text": "acceptedFiles?: "
979
+ "text": "enabled?: "
931
980
  },
932
981
  {
933
982
  "kind": "Content",
934
- "text": "string"
983
+ "text": "string[]"
935
984
  },
936
985
  {
937
986
  "kind": "Content",
@@ -941,7 +990,7 @@
941
990
  "isReadonly": false,
942
991
  "isOptional": true,
943
992
  "releaseTag": "Beta",
944
- "name": "acceptedFiles",
993
+ "name": "enabled",
945
994
  "propertyTypeTokenRange": {
946
995
  "startIndex": 1,
947
996
  "endIndex": 2
@@ -949,12 +998,12 @@
949
998
  },
950
999
  {
951
1000
  "kind": "PropertySignature",
952
- "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#allowDebugDownload:member",
953
- "docComment": "/**\n * Show a button to download the full chat history as JSON.\n */\n",
1001
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAnimationsConfig#userConfigurable:member",
1002
+ "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",
954
1003
  "excerptTokens": [
955
1004
  {
956
1005
  "kind": "Content",
957
- "text": "allowDebugDownload?: "
1006
+ "text": "userConfigurable: "
958
1007
  },
959
1008
  {
960
1009
  "kind": "Content",
@@ -966,27 +1015,44 @@
966
1015
  }
967
1016
  ],
968
1017
  "isReadonly": false,
969
- "isOptional": true,
1018
+ "isOptional": false,
970
1019
  "releaseTag": "Beta",
971
- "name": "allowDebugDownload",
1020
+ "name": "userConfigurable",
972
1021
  "propertyTypeTokenRange": {
973
1022
  "startIndex": 1,
974
1023
  "endIndex": 2
975
1024
  }
976
- },
1025
+ }
1026
+ ],
1027
+ "extendsTokenRanges": []
1028
+ },
1029
+ {
1030
+ "kind": "Interface",
1031
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment:interface",
1032
+ "docComment": "/**\n * A file attachment included with a user message.\n *\n * @beta\n */\n",
1033
+ "excerptTokens": [
1034
+ {
1035
+ "kind": "Content",
1036
+ "text": "export interface ChatAttachment "
1037
+ }
1038
+ ],
1039
+ "fileUrlPath": "src/types/chat.types.ts",
1040
+ "releaseTag": "Beta",
1041
+ "name": "ChatAttachment",
1042
+ "preserveMemberOrder": false,
1043
+ "members": [
977
1044
  {
978
1045
  "kind": "PropertySignature",
979
- "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#animations:member",
980
- "docComment": "/**\n * Animations feature configuration.\n */\n",
1046
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment#content:member",
1047
+ "docComment": "",
981
1048
  "excerptTokens": [
982
1049
  {
983
1050
  "kind": "Content",
984
- "text": "animations?: "
1051
+ "text": "content: "
985
1052
  },
986
1053
  {
987
- "kind": "Reference",
988
- "text": "ChatAnimationsConfig",
989
- "canonicalReference": "@genesislcap/foundation-ai!ChatAnimationsConfig:interface"
1054
+ "kind": "Content",
1055
+ "text": "string"
990
1056
  },
991
1057
  {
992
1058
  "kind": "Content",
@@ -994,9 +1060,9 @@
994
1060
  }
995
1061
  ],
996
1062
  "isReadonly": false,
997
- "isOptional": true,
1063
+ "isOptional": false,
998
1064
  "releaseTag": "Beta",
999
- "name": "animations",
1065
+ "name": "content",
1000
1066
  "propertyTypeTokenRange": {
1001
1067
  "startIndex": 1,
1002
1068
  "endIndex": 2
@@ -1004,16 +1070,16 @@
1004
1070
  },
1005
1071
  {
1006
1072
  "kind": "PropertySignature",
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",
1073
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment#mimeType:member",
1074
+ "docComment": "",
1009
1075
  "excerptTokens": [
1010
1076
  {
1011
1077
  "kind": "Content",
1012
- "text": "loadingDelay?: "
1078
+ "text": "mimeType: "
1013
1079
  },
1014
1080
  {
1015
1081
  "kind": "Content",
1016
- "text": "number"
1082
+ "text": "string"
1017
1083
  },
1018
1084
  {
1019
1085
  "kind": "Content",
@@ -1021,9 +1087,9 @@
1021
1087
  }
1022
1088
  ],
1023
1089
  "isReadonly": false,
1024
- "isOptional": true,
1090
+ "isOptional": false,
1025
1091
  "releaseTag": "Beta",
1026
- "name": "loadingDelay",
1092
+ "name": "mimeType",
1027
1093
  "propertyTypeTokenRange": {
1028
1094
  "startIndex": 1,
1029
1095
  "endIndex": 2
@@ -1031,16 +1097,62 @@
1031
1097
  },
1032
1098
  {
1033
1099
  "kind": "PropertySignature",
1034
- "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#maxToolIterations:member",
1035
- "docComment": "/**\n * Maximum number of tool call iterations per turn. Default: 50.\n */\n",
1100
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment#name:member",
1101
+ "docComment": "",
1036
1102
  "excerptTokens": [
1037
1103
  {
1038
1104
  "kind": "Content",
1039
- "text": "maxToolIterations?: "
1105
+ "text": "name: "
1040
1106
  },
1041
1107
  {
1042
1108
  "kind": "Content",
1043
- "text": "number"
1109
+ "text": "string"
1110
+ },
1111
+ {
1112
+ "kind": "Content",
1113
+ "text": ";"
1114
+ }
1115
+ ],
1116
+ "isReadonly": false,
1117
+ "isOptional": false,
1118
+ "releaseTag": "Beta",
1119
+ "name": "name",
1120
+ "propertyTypeTokenRange": {
1121
+ "startIndex": 1,
1122
+ "endIndex": 2
1123
+ }
1124
+ }
1125
+ ],
1126
+ "extendsTokenRanges": []
1127
+ },
1128
+ {
1129
+ "kind": "Interface",
1130
+ "canonicalReference": "@genesislcap/foundation-ai!ChatConfig:interface",
1131
+ "docComment": "/**\n * Display and engine configuration for the chat assistant.\n *\n * @beta\n */\n",
1132
+ "excerptTokens": [
1133
+ {
1134
+ "kind": "Content",
1135
+ "text": "export interface ChatConfig "
1136
+ }
1137
+ ],
1138
+ "fileUrlPath": "src/types/chat.types.ts",
1139
+ "releaseTag": "Beta",
1140
+ "name": "ChatConfig",
1141
+ "preserveMemberOrder": false,
1142
+ "members": [
1143
+ {
1144
+ "kind": "PropertySignature",
1145
+ "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#agent:member",
1146
+ "docComment": "/**\n * Agent engine settings — iteration limits, handoff caps, classifier tuning.\n */\n",
1147
+ "excerptTokens": [
1148
+ {
1149
+ "kind": "Content",
1150
+ "text": "agent?: "
1151
+ },
1152
+ {
1153
+ "kind": "Reference",
1154
+ "text": "ChatAgentConfig",
1155
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAgentConfig:interface"
1044
1156
  },
1045
1157
  {
1046
1158
  "kind": "Content",
@@ -1050,7 +1162,7 @@
1050
1162
  "isReadonly": false,
1051
1163
  "isOptional": true,
1052
1164
  "releaseTag": "Beta",
1053
- "name": "maxToolIterations",
1165
+ "name": "agent",
1054
1166
  "propertyTypeTokenRange": {
1055
1167
  "startIndex": 1,
1056
1168
  "endIndex": 2
@@ -1058,16 +1170,17 @@
1058
1170
  },
1059
1171
  {
1060
1172
  "kind": "PropertySignature",
1061
- "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#showThinkingSteps:member",
1062
- "docComment": "/**\n * Show model thinking/reasoning steps.\n */\n",
1173
+ "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#suggestions:member",
1174
+ "docComment": "/**\n * Query suggestions feature configuration.\n */\n",
1063
1175
  "excerptTokens": [
1064
1176
  {
1065
1177
  "kind": "Content",
1066
- "text": "showThinkingSteps?: "
1178
+ "text": "suggestions?: "
1067
1179
  },
1068
1180
  {
1069
- "kind": "Content",
1070
- "text": "boolean | null"
1181
+ "kind": "Reference",
1182
+ "text": "ChatSuggestionsConfig",
1183
+ "canonicalReference": "@genesislcap/foundation-ai!ChatSuggestionsConfig:type"
1071
1184
  },
1072
1185
  {
1073
1186
  "kind": "Content",
@@ -1077,7 +1190,7 @@
1077
1190
  "isReadonly": false,
1078
1191
  "isOptional": true,
1079
1192
  "releaseTag": "Beta",
1080
- "name": "showThinkingSteps",
1193
+ "name": "suggestions",
1081
1194
  "propertyTypeTokenRange": {
1082
1195
  "startIndex": 1,
1083
1196
  "endIndex": 2
@@ -1085,16 +1198,17 @@
1085
1198
  },
1086
1199
  {
1087
1200
  "kind": "PropertySignature",
1088
- "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#showToolCalls:member",
1089
- "docComment": "/**\n * Show tool call details in the chat UI.\n */\n",
1201
+ "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#ui:member",
1202
+ "docComment": "/**\n * UI display settings — toggles, file upload, animations, etc.\n */\n",
1090
1203
  "excerptTokens": [
1091
1204
  {
1092
1205
  "kind": "Content",
1093
- "text": "showToolCalls?: "
1206
+ "text": "ui?: "
1094
1207
  },
1095
1208
  {
1096
- "kind": "Content",
1097
- "text": "boolean | null"
1209
+ "kind": "Reference",
1210
+ "text": "ChatUiConfig",
1211
+ "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig:interface"
1098
1212
  },
1099
1213
  {
1100
1214
  "kind": "Content",
@@ -1104,7 +1218,7 @@
1104
1218
  "isReadonly": false,
1105
1219
  "isOptional": true,
1106
1220
  "releaseTag": "Beta",
1107
- "name": "showToolCalls",
1221
+ "name": "ui",
1108
1222
  "propertyTypeTokenRange": {
1109
1223
  "startIndex": 1,
1110
1224
  "endIndex": 2
@@ -1114,8 +1228,34 @@
1114
1228
  "extendsTokenRanges": []
1115
1229
  },
1116
1230
  {
1117
- "kind": "Interface",
1118
- "canonicalReference": "@genesislcap/foundation-ai!ChatInteraction:interface",
1231
+ "kind": "TypeAlias",
1232
+ "canonicalReference": "@genesislcap/foundation-ai!ChatDriverResult:type",
1233
+ "docComment": "/**\n * The result returned by a driver after processing a user turn.\n *\n * @beta\n */\n",
1234
+ "excerptTokens": [
1235
+ {
1236
+ "kind": "Content",
1237
+ "text": "export type ChatDriverResult = "
1238
+ },
1239
+ {
1240
+ "kind": "Content",
1241
+ "text": "{\n reason: 'done';\n} | {\n reason: 'agent-handoff';\n summary: string;\n remainingTask: string;\n}"
1242
+ },
1243
+ {
1244
+ "kind": "Content",
1245
+ "text": ";"
1246
+ }
1247
+ ],
1248
+ "fileUrlPath": "src/types/chat.types.ts",
1249
+ "releaseTag": "Beta",
1250
+ "name": "ChatDriverResult",
1251
+ "typeTokenRange": {
1252
+ "startIndex": 1,
1253
+ "endIndex": 2
1254
+ }
1255
+ },
1256
+ {
1257
+ "kind": "Interface",
1258
+ "canonicalReference": "@genesislcap/foundation-ai!ChatInteraction:interface",
1119
1259
  "docComment": "/**\n * A user interaction component request.\n *\n * @beta\n */\n",
1120
1260
  "excerptTokens": [
1121
1261
  {
@@ -1212,15 +1352,20 @@
1212
1352
  {
1213
1353
  "kind": "PropertySignature",
1214
1354
  "canonicalReference": "@genesislcap/foundation-ai!ChatInteraction#resolved:member",
1215
- "docComment": "/**\n * Set to true once the interaction has been resolved. Used to render a read-only state on re-render.\n */\n",
1355
+ "docComment": "/**\n * The result when the interaction has been resolved. Truthy check indicates resolved state; value is available for widgets to display.\n */\n",
1216
1356
  "excerptTokens": [
1217
1357
  {
1218
1358
  "kind": "Content",
1219
1359
  "text": "resolved?: "
1220
1360
  },
1361
+ {
1362
+ "kind": "Reference",
1363
+ "text": "InteractionResult",
1364
+ "canonicalReference": "@genesislcap/foundation-ai!InteractionResult:type"
1365
+ },
1221
1366
  {
1222
1367
  "kind": "Content",
1223
- "text": "boolean"
1368
+ "text": "<unknown>"
1224
1369
  },
1225
1370
  {
1226
1371
  "kind": "Content",
@@ -1233,7 +1378,7 @@
1233
1378
  "name": "resolved",
1234
1379
  "propertyTypeTokenRange": {
1235
1380
  "startIndex": 1,
1236
- "endIndex": 2
1381
+ "endIndex": 3
1237
1382
  }
1238
1383
  }
1239
1384
  ],
@@ -1254,6 +1399,33 @@
1254
1399
  "name": "ChatMessage",
1255
1400
  "preserveMemberOrder": false,
1256
1401
  "members": [
1402
+ {
1403
+ "kind": "PropertySignature",
1404
+ "canonicalReference": "@genesislcap/foundation-ai!ChatMessage#agentName:member",
1405
+ "docComment": "/**\n * Name of the agent that produced this message. Set by OrchestratingDriver.\n */\n",
1406
+ "excerptTokens": [
1407
+ {
1408
+ "kind": "Content",
1409
+ "text": "agentName?: "
1410
+ },
1411
+ {
1412
+ "kind": "Content",
1413
+ "text": "string"
1414
+ },
1415
+ {
1416
+ "kind": "Content",
1417
+ "text": ";"
1418
+ }
1419
+ ],
1420
+ "isReadonly": false,
1421
+ "isOptional": true,
1422
+ "releaseTag": "Beta",
1423
+ "name": "agentName",
1424
+ "propertyTypeTokenRange": {
1425
+ "startIndex": 1,
1426
+ "endIndex": 2
1427
+ }
1428
+ },
1257
1429
  {
1258
1430
  "kind": "PropertySignature",
1259
1431
  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage#attachments:member",
@@ -1313,6 +1485,33 @@
1313
1485
  "endIndex": 2
1314
1486
  }
1315
1487
  },
1488
+ {
1489
+ "kind": "PropertySignature",
1490
+ "canonicalReference": "@genesislcap/foundation-ai!ChatMessage#inputTokens:member",
1491
+ "docComment": "/**\n * Total prompt tokens consumed for the request that produced this message. Set by transports that return usage metadata (e.g. Gemini). Used to display context window utilisation in the UI.\n */\n",
1492
+ "excerptTokens": [
1493
+ {
1494
+ "kind": "Content",
1495
+ "text": "inputTokens?: "
1496
+ },
1497
+ {
1498
+ "kind": "Content",
1499
+ "text": "number"
1500
+ },
1501
+ {
1502
+ "kind": "Content",
1503
+ "text": ";"
1504
+ }
1505
+ ],
1506
+ "isReadonly": false,
1507
+ "isOptional": true,
1508
+ "releaseTag": "Beta",
1509
+ "name": "inputTokens",
1510
+ "propertyTypeTokenRange": {
1511
+ "startIndex": 1,
1512
+ "endIndex": 2
1513
+ }
1514
+ },
1316
1515
  {
1317
1516
  "kind": "PropertySignature",
1318
1517
  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage#interaction:member",
@@ -1408,7 +1607,7 @@
1408
1607
  {
1409
1608
  "kind": "Reference",
1410
1609
  "text": "ChatToolCall",
1411
- "canonicalReference": "@genesislcap/foundation-ai!ChatToolCall:interface"
1610
+ "canonicalReference": "@genesislcap/foundation-ai!ChatToolCall:type"
1412
1611
  },
1413
1612
  {
1414
1613
  "kind": "Content",
@@ -1607,7 +1806,7 @@
1607
1806
  },
1608
1807
  {
1609
1808
  "kind": "Content",
1610
- "text": "'user' | 'assistant' | 'system' | 'tool'"
1809
+ "text": "'user' | 'assistant' | 'system' | 'tool' | 'system-event'"
1611
1810
  },
1612
1811
  {
1613
1812
  "kind": "Content",
@@ -1703,7 +1902,7 @@
1703
1902
  {
1704
1903
  "kind": "Reference",
1705
1904
  "text": "ChatToolCall",
1706
- "canonicalReference": "@genesislcap/foundation-ai!ChatToolCall:interface"
1905
+ "canonicalReference": "@genesislcap/foundation-ai!ChatToolCall:type"
1707
1906
  },
1708
1907
  {
1709
1908
  "kind": "Content",
@@ -1727,108 +1926,97 @@
1727
1926
  "extendsTokenRanges": []
1728
1927
  },
1729
1928
  {
1730
- "kind": "Interface",
1731
- "canonicalReference": "@genesislcap/foundation-ai!ChatToolCall:interface",
1929
+ "kind": "TypeAlias",
1930
+ "canonicalReference": "@genesislcap/foundation-ai!ChatSuggestionsConfig:type",
1931
+ "docComment": "/**\n * Configuration for the chat suggestions feature.\n *\n * @beta\n */\n",
1932
+ "excerptTokens": [
1933
+ {
1934
+ "kind": "Content",
1935
+ "text": "export type ChatSuggestionsConfig = "
1936
+ },
1937
+ {
1938
+ "kind": "Content",
1939
+ "text": "{\n behavior: 'never';\n count?: never;\n prompt?: never;\n} | {\n behavior: 'initial' | 'always';\n count?: number;\n prompt?: string;\n}"
1940
+ },
1941
+ {
1942
+ "kind": "Content",
1943
+ "text": ";"
1944
+ }
1945
+ ],
1946
+ "fileUrlPath": "src/types/chat.types.ts",
1947
+ "releaseTag": "Beta",
1948
+ "name": "ChatSuggestionsConfig",
1949
+ "typeTokenRange": {
1950
+ "startIndex": 1,
1951
+ "endIndex": 2
1952
+ }
1953
+ },
1954
+ {
1955
+ "kind": "TypeAlias",
1956
+ "canonicalReference": "@genesislcap/foundation-ai!ChatToolCall:type",
1732
1957
  "docComment": "/**\n * A tool call requested by the assistant.\n *\n * @beta\n */\n",
1733
1958
  "excerptTokens": [
1734
1959
  {
1735
1960
  "kind": "Content",
1736
- "text": "export interface ChatToolCall "
1961
+ "text": "export type ChatToolCall = "
1962
+ },
1963
+ {
1964
+ "kind": "Reference",
1965
+ "text": "ChatToolCallBase",
1966
+ "canonicalReference": "@genesislcap/foundation-ai!~ChatToolCallBase:type"
1967
+ },
1968
+ {
1969
+ "kind": "Content",
1970
+ "text": " | "
1971
+ },
1972
+ {
1973
+ "kind": "Reference",
1974
+ "text": "ChatToolCallUnknown",
1975
+ "canonicalReference": "@genesislcap/foundation-ai!ChatToolCallUnknown:type"
1976
+ },
1977
+ {
1978
+ "kind": "Content",
1979
+ "text": ";"
1737
1980
  }
1738
1981
  ],
1739
1982
  "fileUrlPath": "src/types/chat.types.ts",
1740
1983
  "releaseTag": "Beta",
1741
1984
  "name": "ChatToolCall",
1742
- "preserveMemberOrder": false,
1743
- "members": [
1985
+ "typeTokenRange": {
1986
+ "startIndex": 1,
1987
+ "endIndex": 4
1988
+ }
1989
+ },
1990
+ {
1991
+ "kind": "TypeAlias",
1992
+ "canonicalReference": "@genesislcap/foundation-ai!ChatToolCallUnknown:type",
1993
+ "docComment": "/**\n * A tool call for a tool name the driver could not resolve to any handler. `availableTools` lists every tool name registered at the time of the call. Not sent to the AI provider.\n *\n * @beta\n */\n",
1994
+ "excerptTokens": [
1744
1995
  {
1745
- "kind": "PropertySignature",
1746
- "canonicalReference": "@genesislcap/foundation-ai!ChatToolCall#args:member",
1747
- "docComment": "",
1748
- "excerptTokens": [
1749
- {
1750
- "kind": "Content",
1751
- "text": "args: "
1752
- },
1753
- {
1754
- "kind": "Reference",
1755
- "text": "Record",
1756
- "canonicalReference": "!Record:type"
1757
- },
1758
- {
1759
- "kind": "Content",
1760
- "text": "<string, unknown>"
1761
- },
1762
- {
1763
- "kind": "Content",
1764
- "text": ";"
1765
- }
1766
- ],
1767
- "isReadonly": false,
1768
- "isOptional": false,
1769
- "releaseTag": "Beta",
1770
- "name": "args",
1771
- "propertyTypeTokenRange": {
1772
- "startIndex": 1,
1773
- "endIndex": 3
1774
- }
1996
+ "kind": "Content",
1997
+ "text": "export type ChatToolCallUnknown = "
1775
1998
  },
1776
1999
  {
1777
- "kind": "PropertySignature",
1778
- "canonicalReference": "@genesislcap/foundation-ai!ChatToolCall#id:member",
1779
- "docComment": "",
1780
- "excerptTokens": [
1781
- {
1782
- "kind": "Content",
1783
- "text": "id: "
1784
- },
1785
- {
1786
- "kind": "Content",
1787
- "text": "string"
1788
- },
1789
- {
1790
- "kind": "Content",
1791
- "text": ";"
1792
- }
1793
- ],
1794
- "isReadonly": false,
1795
- "isOptional": false,
1796
- "releaseTag": "Beta",
1797
- "name": "id",
1798
- "propertyTypeTokenRange": {
1799
- "startIndex": 1,
1800
- "endIndex": 2
1801
- }
2000
+ "kind": "Reference",
2001
+ "text": "ChatToolCallBase",
2002
+ "canonicalReference": "@genesislcap/foundation-ai!~ChatToolCallBase:type"
1802
2003
  },
1803
2004
  {
1804
- "kind": "PropertySignature",
1805
- "canonicalReference": "@genesislcap/foundation-ai!ChatToolCall#name:member",
1806
- "docComment": "",
1807
- "excerptTokens": [
1808
- {
1809
- "kind": "Content",
1810
- "text": "name: "
1811
- },
1812
- {
1813
- "kind": "Content",
1814
- "text": "string"
1815
- },
1816
- {
1817
- "kind": "Content",
1818
- "text": ";"
1819
- }
1820
- ],
1821
- "isReadonly": false,
1822
- "isOptional": false,
1823
- "releaseTag": "Beta",
1824
- "name": "name",
1825
- "propertyTypeTokenRange": {
1826
- "startIndex": 1,
1827
- "endIndex": 2
1828
- }
2005
+ "kind": "Content",
2006
+ "text": " & {\n unknown: true;\n availableTools: string[];\n}"
2007
+ },
2008
+ {
2009
+ "kind": "Content",
2010
+ "text": ";"
1829
2011
  }
1830
2012
  ],
1831
- "extendsTokenRanges": []
2013
+ "fileUrlPath": "src/types/chat.types.ts",
2014
+ "releaseTag": "Beta",
2015
+ "name": "ChatToolCallUnknown",
2016
+ "typeTokenRange": {
2017
+ "startIndex": 1,
2018
+ "endIndex": 3
2019
+ }
1832
2020
  },
1833
2021
  {
1834
2022
  "kind": "Interface",
@@ -2200,78 +2388,340 @@
2200
2388
  },
2201
2389
  {
2202
2390
  "kind": "Content",
2203
- "text": "string"
2391
+ "text": "string"
2392
+ },
2393
+ {
2394
+ "kind": "Content",
2395
+ "text": ", options?: "
2396
+ },
2397
+ {
2398
+ "kind": "Reference",
2399
+ "text": "ChatRequestOptions",
2400
+ "canonicalReference": "@genesislcap/foundation-ai!ChatRequestOptions:interface"
2401
+ },
2402
+ {
2403
+ "kind": "Content",
2404
+ "text": "): "
2405
+ },
2406
+ {
2407
+ "kind": "Reference",
2408
+ "text": "AsyncIterable",
2409
+ "canonicalReference": "!AsyncIterable:interface"
2410
+ },
2411
+ {
2412
+ "kind": "Content",
2413
+ "text": "<"
2414
+ },
2415
+ {
2416
+ "kind": "Reference",
2417
+ "text": "ChatStreamChunk",
2418
+ "canonicalReference": "@genesislcap/foundation-ai!ChatStreamChunk:interface"
2419
+ },
2420
+ {
2421
+ "kind": "Content",
2422
+ "text": ">"
2423
+ },
2424
+ {
2425
+ "kind": "Content",
2426
+ "text": ";"
2427
+ }
2428
+ ],
2429
+ "isOptional": true,
2430
+ "returnTypeTokenRange": {
2431
+ "startIndex": 8,
2432
+ "endIndex": 12
2433
+ },
2434
+ "releaseTag": "Beta",
2435
+ "overloadIndex": 1,
2436
+ "parameters": [
2437
+ {
2438
+ "parameterName": "history",
2439
+ "parameterTypeTokenRange": {
2440
+ "startIndex": 1,
2441
+ "endIndex": 3
2442
+ },
2443
+ "isOptional": false
2444
+ },
2445
+ {
2446
+ "parameterName": "userMessage",
2447
+ "parameterTypeTokenRange": {
2448
+ "startIndex": 4,
2449
+ "endIndex": 5
2450
+ },
2451
+ "isOptional": false
2452
+ },
2453
+ {
2454
+ "parameterName": "options",
2455
+ "parameterTypeTokenRange": {
2456
+ "startIndex": 6,
2457
+ "endIndex": 7
2458
+ },
2459
+ "isOptional": true
2460
+ }
2461
+ ],
2462
+ "name": "streamChatMessage"
2463
+ }
2464
+ ],
2465
+ "extendsTokenRanges": []
2466
+ },
2467
+ {
2468
+ "kind": "Interface",
2469
+ "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig:interface",
2470
+ "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",
2471
+ "excerptTokens": [
2472
+ {
2473
+ "kind": "Content",
2474
+ "text": "export interface ChatUiConfig "
2475
+ }
2476
+ ],
2477
+ "fileUrlPath": "src/types/chat.types.ts",
2478
+ "releaseTag": "Beta",
2479
+ "name": "ChatUiConfig",
2480
+ "preserveMemberOrder": false,
2481
+ "members": [
2482
+ {
2483
+ "kind": "PropertySignature",
2484
+ "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#acceptedFiles:member",
2485
+ "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",
2486
+ "excerptTokens": [
2487
+ {
2488
+ "kind": "Content",
2489
+ "text": "acceptedFiles?: "
2490
+ },
2491
+ {
2492
+ "kind": "Content",
2493
+ "text": "string"
2494
+ },
2495
+ {
2496
+ "kind": "Content",
2497
+ "text": ";"
2498
+ }
2499
+ ],
2500
+ "isReadonly": false,
2501
+ "isOptional": true,
2502
+ "releaseTag": "Beta",
2503
+ "name": "acceptedFiles",
2504
+ "propertyTypeTokenRange": {
2505
+ "startIndex": 1,
2506
+ "endIndex": 2
2507
+ }
2508
+ },
2509
+ {
2510
+ "kind": "PropertySignature",
2511
+ "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#allowDebugDownload:member",
2512
+ "docComment": "/**\n * Show a button to download the full chat history as JSON.\n */\n",
2513
+ "excerptTokens": [
2514
+ {
2515
+ "kind": "Content",
2516
+ "text": "allowDebugDownload?: "
2517
+ },
2518
+ {
2519
+ "kind": "Content",
2520
+ "text": "boolean"
2521
+ },
2522
+ {
2523
+ "kind": "Content",
2524
+ "text": ";"
2525
+ }
2526
+ ],
2527
+ "isReadonly": false,
2528
+ "isOptional": true,
2529
+ "releaseTag": "Beta",
2530
+ "name": "allowDebugDownload",
2531
+ "propertyTypeTokenRange": {
2532
+ "startIndex": 1,
2533
+ "endIndex": 2
2534
+ }
2535
+ },
2536
+ {
2537
+ "kind": "PropertySignature",
2538
+ "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#animations:member",
2539
+ "docComment": "/**\n * Animations feature configuration.\n */\n",
2540
+ "excerptTokens": [
2541
+ {
2542
+ "kind": "Content",
2543
+ "text": "animations?: "
2544
+ },
2545
+ {
2546
+ "kind": "Reference",
2547
+ "text": "ChatAnimationsConfig",
2548
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAnimationsConfig:interface"
2549
+ },
2550
+ {
2551
+ "kind": "Content",
2552
+ "text": ";"
2553
+ }
2554
+ ],
2555
+ "isReadonly": false,
2556
+ "isOptional": true,
2557
+ "releaseTag": "Beta",
2558
+ "name": "animations",
2559
+ "propertyTypeTokenRange": {
2560
+ "startIndex": 1,
2561
+ "endIndex": 2
2562
+ }
2563
+ },
2564
+ {
2565
+ "kind": "PropertySignature",
2566
+ "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#loadingDelay:member",
2567
+ "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",
2568
+ "excerptTokens": [
2569
+ {
2570
+ "kind": "Content",
2571
+ "text": "loadingDelay?: "
2572
+ },
2573
+ {
2574
+ "kind": "Content",
2575
+ "text": "number"
2576
+ },
2577
+ {
2578
+ "kind": "Content",
2579
+ "text": ";"
2580
+ }
2581
+ ],
2582
+ "isReadonly": false,
2583
+ "isOptional": true,
2584
+ "releaseTag": "Beta",
2585
+ "name": "loadingDelay",
2586
+ "propertyTypeTokenRange": {
2587
+ "startIndex": 1,
2588
+ "endIndex": 2
2589
+ }
2590
+ },
2591
+ {
2592
+ "kind": "PropertySignature",
2593
+ "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#showAgentSwitchIndicator:member",
2594
+ "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",
2595
+ "excerptTokens": [
2596
+ {
2597
+ "kind": "Content",
2598
+ "text": "showAgentSwitchIndicator?: "
2599
+ },
2600
+ {
2601
+ "kind": "Content",
2602
+ "text": "boolean | null"
2603
+ },
2604
+ {
2605
+ "kind": "Content",
2606
+ "text": ";"
2607
+ }
2608
+ ],
2609
+ "isReadonly": false,
2610
+ "isOptional": true,
2611
+ "releaseTag": "Beta",
2612
+ "name": "showAgentSwitchIndicator",
2613
+ "propertyTypeTokenRange": {
2614
+ "startIndex": 1,
2615
+ "endIndex": 2
2616
+ }
2617
+ },
2618
+ {
2619
+ "kind": "PropertySignature",
2620
+ "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#showContextUsage:member",
2621
+ "docComment": "/**\n * Show a context window usage indicator in the settings panel. Visible when the settings panel is open and token usage data is available. - `true` or `undefined` (default) — shown when data is available - `false` — hidden\n */\n",
2622
+ "excerptTokens": [
2623
+ {
2624
+ "kind": "Content",
2625
+ "text": "showContextUsage?: "
2626
+ },
2627
+ {
2628
+ "kind": "Content",
2629
+ "text": "boolean"
2630
+ },
2631
+ {
2632
+ "kind": "Content",
2633
+ "text": ";"
2634
+ }
2635
+ ],
2636
+ "isReadonly": false,
2637
+ "isOptional": true,
2638
+ "releaseTag": "Beta",
2639
+ "name": "showContextUsage",
2640
+ "propertyTypeTokenRange": {
2641
+ "startIndex": 1,
2642
+ "endIndex": 2
2643
+ }
2644
+ },
2645
+ {
2646
+ "kind": "PropertySignature",
2647
+ "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#showSplash:member",
2648
+ "docComment": "/**\n * When `true`, shows the `slot=\"splash\"` content when there are no messages. The host element reflects a `showing-splash` boolean attribute that consumers can use as a CSS hook to animate the splash in and out. Default: `false`.\n */\n",
2649
+ "excerptTokens": [
2650
+ {
2651
+ "kind": "Content",
2652
+ "text": "showSplash?: "
2204
2653
  },
2205
2654
  {
2206
2655
  "kind": "Content",
2207
- "text": ", options?: "
2208
- },
2209
- {
2210
- "kind": "Reference",
2211
- "text": "ChatRequestOptions",
2212
- "canonicalReference": "@genesislcap/foundation-ai!ChatRequestOptions:interface"
2656
+ "text": "boolean"
2213
2657
  },
2214
2658
  {
2215
2659
  "kind": "Content",
2216
- "text": "): "
2217
- },
2218
- {
2219
- "kind": "Reference",
2220
- "text": "AsyncIterable",
2221
- "canonicalReference": "!AsyncIterable:interface"
2222
- },
2660
+ "text": ";"
2661
+ }
2662
+ ],
2663
+ "isReadonly": false,
2664
+ "isOptional": true,
2665
+ "releaseTag": "Beta",
2666
+ "name": "showSplash",
2667
+ "propertyTypeTokenRange": {
2668
+ "startIndex": 1,
2669
+ "endIndex": 2
2670
+ }
2671
+ },
2672
+ {
2673
+ "kind": "PropertySignature",
2674
+ "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#showThinkingSteps:member",
2675
+ "docComment": "/**\n * Show model thinking/reasoning steps.\n */\n",
2676
+ "excerptTokens": [
2223
2677
  {
2224
2678
  "kind": "Content",
2225
- "text": "<"
2226
- },
2227
- {
2228
- "kind": "Reference",
2229
- "text": "ChatStreamChunk",
2230
- "canonicalReference": "@genesislcap/foundation-ai!ChatStreamChunk:interface"
2679
+ "text": "showThinkingSteps?: "
2231
2680
  },
2232
2681
  {
2233
2682
  "kind": "Content",
2234
- "text": ">"
2683
+ "text": "boolean | null"
2235
2684
  },
2236
2685
  {
2237
2686
  "kind": "Content",
2238
2687
  "text": ";"
2239
2688
  }
2240
2689
  ],
2690
+ "isReadonly": false,
2241
2691
  "isOptional": true,
2242
- "returnTypeTokenRange": {
2243
- "startIndex": 8,
2244
- "endIndex": 12
2245
- },
2246
2692
  "releaseTag": "Beta",
2247
- "overloadIndex": 1,
2248
- "parameters": [
2693
+ "name": "showThinkingSteps",
2694
+ "propertyTypeTokenRange": {
2695
+ "startIndex": 1,
2696
+ "endIndex": 2
2697
+ }
2698
+ },
2699
+ {
2700
+ "kind": "PropertySignature",
2701
+ "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#showToolCalls:member",
2702
+ "docComment": "/**\n * Show tool call details in the chat UI.\n */\n",
2703
+ "excerptTokens": [
2249
2704
  {
2250
- "parameterName": "history",
2251
- "parameterTypeTokenRange": {
2252
- "startIndex": 1,
2253
- "endIndex": 3
2254
- },
2255
- "isOptional": false
2705
+ "kind": "Content",
2706
+ "text": "showToolCalls?: "
2256
2707
  },
2257
2708
  {
2258
- "parameterName": "userMessage",
2259
- "parameterTypeTokenRange": {
2260
- "startIndex": 4,
2261
- "endIndex": 5
2262
- },
2263
- "isOptional": false
2709
+ "kind": "Content",
2710
+ "text": "boolean | null"
2264
2711
  },
2265
2712
  {
2266
- "parameterName": "options",
2267
- "parameterTypeTokenRange": {
2268
- "startIndex": 6,
2269
- "endIndex": 7
2270
- },
2271
- "isOptional": true
2713
+ "kind": "Content",
2714
+ "text": ";"
2272
2715
  }
2273
2716
  ],
2274
- "name": "streamChatMessage"
2717
+ "isReadonly": false,
2718
+ "isOptional": true,
2719
+ "releaseTag": "Beta",
2720
+ "name": "showToolCalls",
2721
+ "propertyTypeTokenRange": {
2722
+ "startIndex": 1,
2723
+ "endIndex": 2
2724
+ }
2275
2725
  }
2276
2726
  ],
2277
2727
  "extendsTokenRanges": []
@@ -2849,15 +3299,16 @@
2849
3299
  {
2850
3300
  "kind": "PropertySignature",
2851
3301
  "canonicalReference": "@genesislcap/foundation-ai!GeminiAIConfig#model:member",
2852
- "docComment": "",
3302
+ "docComment": "/**\n * Defaults to `gemini-2.5-flash-lite`. Only {@link SUPPORTED_GEMINI_MODEL_IDS} are accepted at runtime.\n */\n",
2853
3303
  "excerptTokens": [
2854
3304
  {
2855
3305
  "kind": "Content",
2856
3306
  "text": "model?: "
2857
3307
  },
2858
3308
  {
2859
- "kind": "Content",
2860
- "text": "string"
3309
+ "kind": "Reference",
3310
+ "text": "GeminiModelId",
3311
+ "canonicalReference": "@genesislcap/foundation-ai!GeminiModelId:type"
2861
3312
  },
2862
3313
  {
2863
3314
  "kind": "Content",
@@ -2935,6 +3386,32 @@
2935
3386
  }
2936
3387
  ]
2937
3388
  },
3389
+ {
3390
+ "kind": "TypeAlias",
3391
+ "canonicalReference": "@genesislcap/foundation-ai!GeminiModelId:type",
3392
+ "docComment": "/**\n * Gemini REST model ids supported by {@link GeminiTransport}.\n *\n * @beta\n */\n",
3393
+ "excerptTokens": [
3394
+ {
3395
+ "kind": "Content",
3396
+ "text": "export type GeminiModelId = "
3397
+ },
3398
+ {
3399
+ "kind": "Content",
3400
+ "text": "'gemini-2.5-flash' | 'gemini-2.5-flash-lite'"
3401
+ },
3402
+ {
3403
+ "kind": "Content",
3404
+ "text": ";"
3405
+ }
3406
+ ],
3407
+ "fileUrlPath": "src/types/config.types.ts",
3408
+ "releaseTag": "Beta",
3409
+ "name": "GeminiModelId",
3410
+ "typeTokenRange": {
3411
+ "startIndex": 1,
3412
+ "endIndex": 2
3413
+ }
3414
+ },
2938
3415
  {
2939
3416
  "kind": "Class",
2940
3417
  "canonicalReference": "@genesislcap/foundation-ai!GeminiProvider:class",
@@ -3234,6 +3711,76 @@
3234
3711
  "isAbstract": false,
3235
3712
  "name": "interpretCriteria"
3236
3713
  },
3714
+ {
3715
+ "kind": "Method",
3716
+ "canonicalReference": "@genesislcap/foundation-ai!GeminiProvider#prompt:member(1)",
3717
+ "docComment": "",
3718
+ "excerptTokens": [
3719
+ {
3720
+ "kind": "Content",
3721
+ "text": "prompt(message: "
3722
+ },
3723
+ {
3724
+ "kind": "Content",
3725
+ "text": "string"
3726
+ },
3727
+ {
3728
+ "kind": "Content",
3729
+ "text": ", options?: "
3730
+ },
3731
+ {
3732
+ "kind": "Reference",
3733
+ "text": "ChatRequestOptions",
3734
+ "canonicalReference": "@genesislcap/foundation-ai!ChatRequestOptions:interface"
3735
+ },
3736
+ {
3737
+ "kind": "Content",
3738
+ "text": "): "
3739
+ },
3740
+ {
3741
+ "kind": "Reference",
3742
+ "text": "Promise",
3743
+ "canonicalReference": "!Promise:interface"
3744
+ },
3745
+ {
3746
+ "kind": "Content",
3747
+ "text": "<string>"
3748
+ },
3749
+ {
3750
+ "kind": "Content",
3751
+ "text": ";"
3752
+ }
3753
+ ],
3754
+ "isStatic": false,
3755
+ "returnTypeTokenRange": {
3756
+ "startIndex": 5,
3757
+ "endIndex": 7
3758
+ },
3759
+ "releaseTag": "Beta",
3760
+ "isProtected": false,
3761
+ "overloadIndex": 1,
3762
+ "parameters": [
3763
+ {
3764
+ "parameterName": "message",
3765
+ "parameterTypeTokenRange": {
3766
+ "startIndex": 1,
3767
+ "endIndex": 2
3768
+ },
3769
+ "isOptional": false
3770
+ },
3771
+ {
3772
+ "parameterName": "options",
3773
+ "parameterTypeTokenRange": {
3774
+ "startIndex": 3,
3775
+ "endIndex": 4
3776
+ },
3777
+ "isOptional": true
3778
+ }
3779
+ ],
3780
+ "isOptional": false,
3781
+ "isAbstract": false,
3782
+ "name": "prompt"
3783
+ },
3237
3784
  {
3238
3785
  "kind": "Method",
3239
3786
  "canonicalReference": "@genesislcap/foundation-ai!GeminiProvider#streamChat:member(1)",
@@ -3420,7 +3967,16 @@
3420
3967
  },
3421
3968
  {
3422
3969
  "kind": "Content",
3423
- "text": "{\n provider: 'gemini';\n model: string;\n }"
3970
+ "text": "{\n provider: 'gemini';\n model: "
3971
+ },
3972
+ {
3973
+ "kind": "Reference",
3974
+ "text": "GeminiModelId",
3975
+ "canonicalReference": "@genesislcap/foundation-ai!GeminiModelId:type"
3976
+ },
3977
+ {
3978
+ "kind": "Content",
3979
+ "text": ";\n }"
3424
3980
  },
3425
3981
  {
3426
3982
  "kind": "Content",
@@ -3430,7 +3986,7 @@
3430
3986
  "isStatic": false,
3431
3987
  "returnTypeTokenRange": {
3432
3988
  "startIndex": 1,
3433
- "endIndex": 2
3989
+ "endIndex": 4
3434
3990
  },
3435
3991
  "releaseTag": "Beta",
3436
3992
  "isProtected": false,
@@ -3685,7 +4241,7 @@
3685
4241
  {
3686
4242
  "kind": "Function",
3687
4243
  "canonicalReference": "@genesislcap/foundation-ai!isAIFeatureEnabled:function(1)",
3688
- "docComment": "/**\n * Returns true when AI features (beta) are enabled. Requires ?feature.ai in URL.\n */\n",
4244
+ "docComment": "/**\n * Returns true when AI features (beta) are enabled via ?feature.ai URL param or GENX_ENABLE_AI=true env var.\n */\n",
3689
4245
  "excerptTokens": [
3690
4246
  {
3691
4247
  "kind": "Content",
@@ -3706,6 +4262,62 @@
3706
4262
  "parameters": [],
3707
4263
  "name": "isAIFeatureEnabled"
3708
4264
  },
4265
+ {
4266
+ "kind": "Function",
4267
+ "canonicalReference": "@genesislcap/foundation-ai!isChatToolCallUnknown:function(1)",
4268
+ "docComment": "/**\n * Type guard that narrows a `ChatToolCall` to `ChatToolCallUnknown`.\n *\n * @beta\n */\n",
4269
+ "excerptTokens": [
4270
+ {
4271
+ "kind": "Content",
4272
+ "text": "export declare function isChatToolCallUnknown(tc: "
4273
+ },
4274
+ {
4275
+ "kind": "Reference",
4276
+ "text": "ChatToolCall",
4277
+ "canonicalReference": "@genesislcap/foundation-ai!ChatToolCall:type"
4278
+ },
4279
+ {
4280
+ "kind": "Content",
4281
+ "text": "): "
4282
+ },
4283
+ {
4284
+ "kind": "Reference",
4285
+ "text": "tc",
4286
+ "canonicalReference": "@genesislcap/foundation-ai!~tc"
4287
+ },
4288
+ {
4289
+ "kind": "Content",
4290
+ "text": " is "
4291
+ },
4292
+ {
4293
+ "kind": "Reference",
4294
+ "text": "ChatToolCallUnknown",
4295
+ "canonicalReference": "@genesislcap/foundation-ai!ChatToolCallUnknown:type"
4296
+ },
4297
+ {
4298
+ "kind": "Content",
4299
+ "text": ";"
4300
+ }
4301
+ ],
4302
+ "fileUrlPath": "src/types/chat.types.ts",
4303
+ "returnTypeTokenRange": {
4304
+ "startIndex": 3,
4305
+ "endIndex": 6
4306
+ },
4307
+ "releaseTag": "Beta",
4308
+ "overloadIndex": 1,
4309
+ "parameters": [
4310
+ {
4311
+ "parameterName": "tc",
4312
+ "parameterTypeTokenRange": {
4313
+ "startIndex": 1,
4314
+ "endIndex": 2
4315
+ },
4316
+ "isOptional": false
4317
+ }
4318
+ ],
4319
+ "name": "isChatToolCallUnknown"
4320
+ },
3709
4321
  {
3710
4322
  "kind": "Function",
3711
4323
  "canonicalReference": "@genesislcap/foundation-ai!isSpeechRecognitionAvailable:function(1)",
@@ -3906,7 +4518,7 @@
3906
4518
  {
3907
4519
  "kind": "PropertySignature",
3908
4520
  "canonicalReference": "@genesislcap/foundation-ai!ResolveAIConfigOptions#model:member",
3909
- "docComment": "/**\n * Model name (e.g. gpt-4o-mini). Default: gpt-4o-mini\n */\n",
4521
+ "docComment": "/**\n * Model name. OpenAI default: gpt-4o-mini. Gemini: only {@link SUPPORTED_GEMINI_MODEL_IDS} (default flash-lite).\n */\n",
3910
4522
  "excerptTokens": [
3911
4523
  {
3912
4524
  "kind": "Content",
@@ -4109,6 +4721,38 @@
4109
4721
  }
4110
4722
  ],
4111
4723
  "name": "startSpeechRecognition"
4724
+ },
4725
+ {
4726
+ "kind": "Variable",
4727
+ "canonicalReference": "@genesislcap/foundation-ai!SUPPORTED_GEMINI_MODEL_IDS:var",
4728
+ "docComment": "/**\n * @beta\n */\n",
4729
+ "excerptTokens": [
4730
+ {
4731
+ "kind": "Content",
4732
+ "text": "SUPPORTED_GEMINI_MODEL_IDS: "
4733
+ },
4734
+ {
4735
+ "kind": "Content",
4736
+ "text": "readonly "
4737
+ },
4738
+ {
4739
+ "kind": "Reference",
4740
+ "text": "GeminiModelId",
4741
+ "canonicalReference": "@genesislcap/foundation-ai!GeminiModelId:type"
4742
+ },
4743
+ {
4744
+ "kind": "Content",
4745
+ "text": "[]"
4746
+ }
4747
+ ],
4748
+ "fileUrlPath": "src/types/config.types.ts",
4749
+ "isReadonly": true,
4750
+ "releaseTag": "Beta",
4751
+ "name": "SUPPORTED_GEMINI_MODEL_IDS",
4752
+ "variableTypeTokenRange": {
4753
+ "startIndex": 1,
4754
+ "endIndex": 4
4755
+ }
4112
4756
  }
4113
4757
  ]
4114
4758
  }