@genesislcap/ai-assistant 14.409.0-FUI-2495.1 → 14.409.0-FUI-2495.2

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 (56) hide show
  1. package/dist/ai-assistant.api.json +1876 -650
  2. package/dist/ai-assistant.d.ts +193 -45
  3. package/dist/dts/channel/ai-activity-channel.d.ts +1 -0
  4. package/dist/dts/channel/ai-activity-channel.d.ts.map +1 -1
  5. package/dist/dts/components/ai-driver/ai-driver.d.ts +38 -0
  6. package/dist/dts/components/ai-driver/ai-driver.d.ts.map +1 -0
  7. package/dist/dts/components/ai-driver/index.d.ts +2 -0
  8. package/dist/dts/components/ai-driver/index.d.ts.map +1 -0
  9. package/dist/dts/components/chat-driver/chat-driver.d.ts +25 -7
  10. package/dist/dts/components/chat-driver/chat-driver.d.ts.map +1 -1
  11. package/dist/dts/components/halo-overlay.d.ts +13 -1
  12. package/dist/dts/components/halo-overlay.d.ts.map +1 -1
  13. package/dist/dts/components/orchestrating-driver/index.d.ts +2 -0
  14. package/dist/dts/components/orchestrating-driver/index.d.ts.map +1 -0
  15. package/dist/dts/components/orchestrating-driver/orchestrating-driver.d.ts +36 -0
  16. package/dist/dts/components/orchestrating-driver/orchestrating-driver.d.ts.map +1 -0
  17. package/dist/dts/config/config.d.ts +43 -15
  18. package/dist/dts/config/config.d.ts.map +1 -1
  19. package/dist/dts/config/fallback-agents.d.ts +20 -0
  20. package/dist/dts/config/fallback-agents.d.ts.map +1 -0
  21. package/dist/dts/config/index.d.ts +1 -0
  22. package/dist/dts/config/index.d.ts.map +1 -1
  23. package/dist/dts/index.d.ts +3 -0
  24. package/dist/dts/index.d.ts.map +1 -1
  25. package/dist/dts/main/main.d.ts +16 -7
  26. package/dist/dts/main/main.d.ts.map +1 -1
  27. package/dist/dts/main/main.styles.d.ts.map +1 -1
  28. package/dist/dts/main/main.template.d.ts.map +1 -1
  29. package/dist/esm/components/ai-driver/ai-driver.js +1 -0
  30. package/dist/esm/components/ai-driver/index.js +1 -0
  31. package/dist/esm/components/chat-driver/chat-driver.js +86 -31
  32. package/dist/esm/components/halo-overlay.js +53 -7
  33. package/dist/esm/components/orchestrating-driver/index.js +1 -0
  34. package/dist/esm/components/orchestrating-driver/orchestrating-driver.js +229 -0
  35. package/dist/esm/config/fallback-agents.js +26 -0
  36. package/dist/esm/config/index.js +1 -0
  37. package/dist/esm/index.js +3 -0
  38. package/dist/esm/main/main.js +103 -45
  39. package/dist/esm/main/main.styles.js +145 -4
  40. package/dist/esm/main/main.template.js +97 -61
  41. package/dist/tsconfig.tsbuildinfo +1 -1
  42. package/package.json +15 -15
  43. package/src/channel/ai-activity-channel.ts +1 -0
  44. package/src/components/ai-driver/ai-driver.ts +42 -0
  45. package/src/components/ai-driver/index.ts +1 -0
  46. package/src/components/chat-driver/chat-driver.ts +116 -35
  47. package/src/components/halo-overlay.ts +45 -7
  48. package/src/components/orchestrating-driver/index.ts +1 -0
  49. package/src/components/orchestrating-driver/orchestrating-driver.ts +300 -0
  50. package/src/config/config.ts +45 -15
  51. package/src/config/fallback-agents.ts +29 -0
  52. package/src/config/index.ts +1 -0
  53. package/src/index.ts +3 -0
  54. package/src/main/main.styles.ts +145 -4
  55. package/src/main/main.template.ts +116 -78
  56. package/src/main/main.ts +105 -50
package/dist/ai-assistant.api.json CHANGED
@@ -173,195 +173,40 @@
173
173
  "preserveMemberOrder": false,
174
174
  "members": [
175
175
  {
176
- "kind": "Interface",
177
- "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:interface",
178
- "docComment": "/**\n * Configuration for a single specialist agent.\n *\n * When multiple agents are provided to `FoundationAiAssistant`, an orchestrating layer will route each user message to the appropriate specialist based on intent. When only one agent is configured, routing is skipped.\n *\n * @beta\n */\n",
176
+ "kind": "TypeAlias",
177
+ "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type",
178
+ "docComment": "/**\n * Configuration for an agent passed to `FoundationAiAssistant`.\n *\n * Either a specialist (requires `description`) or a fallback (requires `fallback: true`). Passing both or neither is a compile error.\n *\n * @beta\n */\n",
179
179
  "excerptTokens": [
180
180
  {
181
181
  "kind": "Content",
182
- "text": "export interface AgentConfig "
183
- }
184
- ],
185
- "fileUrlPath": "src/config/config.ts",
186
- "releaseTag": "Beta",
187
- "name": "AgentConfig",
188
- "preserveMemberOrder": false,
189
- "members": [
190
- {
191
- "kind": "PropertySignature",
192
- "canonicalReference": "@genesislcap/ai-assistant!AgentConfig#description:member",
193
- "docComment": "/**\n * Plain-language description of what this agent handles. Used by the classifier to auto-generate its routing prompt.\n */\n",
194
- "excerptTokens": [
195
- {
196
- "kind": "Content",
197
- "text": "description: "
198
- },
199
- {
200
- "kind": "Content",
201
- "text": "string"
202
- },
203
- {
204
- "kind": "Content",
205
- "text": ";"
206
- }
207
- ],
208
- "isReadonly": false,
209
- "isOptional": false,
210
- "releaseTag": "Beta",
211
- "name": "description",
212
- "propertyTypeTokenRange": {
213
- "startIndex": 1,
214
- "endIndex": 2
215
- }
216
- },
217
- {
218
- "kind": "PropertySignature",
219
- "canonicalReference": "@genesislcap/ai-assistant!AgentConfig#name:member",
220
- "docComment": "/**\n * Display name shown in the chat header when this agent is active.\n */\n",
221
- "excerptTokens": [
222
- {
223
- "kind": "Content",
224
- "text": "name: "
225
- },
226
- {
227
- "kind": "Content",
228
- "text": "string"
229
- },
230
- {
231
- "kind": "Content",
232
- "text": ";"
233
- }
234
- ],
235
- "isReadonly": false,
236
- "isOptional": false,
237
- "releaseTag": "Beta",
238
- "name": "name",
239
- "propertyTypeTokenRange": {
240
- "startIndex": 1,
241
- "endIndex": 2
242
- }
182
+ "text": "export type AgentConfig = "
243
183
  },
244
184
  {
245
- "kind": "PropertySignature",
246
- "canonicalReference": "@genesislcap/ai-assistant!AgentConfig#primerHistory:member",
247
- "docComment": "/**\n * Optional primer history prepended to every call (not visible to the user). Used to establish agent identity and behavioural rules.\n */\n",
248
- "excerptTokens": [
249
- {
250
- "kind": "Content",
251
- "text": "primerHistory?: "
252
- },
253
- {
254
- "kind": "Reference",
255
- "text": "ChatMessage",
256
- "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
257
- },
258
- {
259
- "kind": "Content",
260
- "text": "[]"
261
- },
262
- {
263
- "kind": "Content",
264
- "text": ";"
265
- }
266
- ],
267
- "isReadonly": false,
268
- "isOptional": true,
269
- "releaseTag": "Beta",
270
- "name": "primerHistory",
271
- "propertyTypeTokenRange": {
272
- "startIndex": 1,
273
- "endIndex": 3
274
- }
185
+ "kind": "Reference",
186
+ "text": "SpecialistAgentConfig",
187
+ "canonicalReference": "@genesislcap/ai-assistant!SpecialistAgentConfig:interface"
275
188
  },
276
189
  {
277
- "kind": "PropertySignature",
278
- "canonicalReference": "@genesislcap/ai-assistant!AgentConfig#systemPrompt:member",
279
- "docComment": "/**\n * System prompt injected into every conversation turn for this agent.\n */\n",
280
- "excerptTokens": [
281
- {
282
- "kind": "Content",
283
- "text": "systemPrompt?: "
284
- },
285
- {
286
- "kind": "Content",
287
- "text": "string"
288
- },
289
- {
290
- "kind": "Content",
291
- "text": ";"
292
- }
293
- ],
294
- "isReadonly": false,
295
- "isOptional": true,
296
- "releaseTag": "Beta",
297
- "name": "systemPrompt",
298
- "propertyTypeTokenRange": {
299
- "startIndex": 1,
300
- "endIndex": 2
301
- }
190
+ "kind": "Content",
191
+ "text": " | "
302
192
  },
303
193
  {
304
- "kind": "PropertySignature",
305
- "canonicalReference": "@genesislcap/ai-assistant!AgentConfig#toolDefinitions:member",
306
- "docComment": "/**\n * Tool definitions (JSON Schema) passed to the AI provider for this agent.\n */\n",
307
- "excerptTokens": [
308
- {
309
- "kind": "Content",
310
- "text": "toolDefinitions?: "
311
- },
312
- {
313
- "kind": "Reference",
314
- "text": "ChatToolDefinition",
315
- "canonicalReference": "@genesislcap/foundation-ai!ChatToolDefinition:interface"
316
- },
317
- {
318
- "kind": "Content",
319
- "text": "[]"
320
- },
321
- {
322
- "kind": "Content",
323
- "text": ";"
324
- }
325
- ],
326
- "isReadonly": false,
327
- "isOptional": true,
328
- "releaseTag": "Beta",
329
- "name": "toolDefinitions",
330
- "propertyTypeTokenRange": {
331
- "startIndex": 1,
332
- "endIndex": 3
333
- }
194
+ "kind": "Reference",
195
+ "text": "FallbackAgentConfig",
196
+ "canonicalReference": "@genesislcap/ai-assistant!FallbackAgentConfig:interface"
334
197
  },
335
198
  {
336
- "kind": "PropertySignature",
337
- "canonicalReference": "@genesislcap/ai-assistant!AgentConfig#toolHandlers:member",
338
- "docComment": "/**\n * Tool handler implementations for this agent.\n */\n",
339
- "excerptTokens": [
340
- {
341
- "kind": "Content",
342
- "text": "toolHandlers?: "
343
- },
344
- {
345
- "kind": "Reference",
346
- "text": "ChatToolHandlers",
347
- "canonicalReference": "@genesislcap/foundation-ai!ChatToolHandlers:type"
348
- },
349
- {
350
- "kind": "Content",
351
- "text": ";"
352
- }
353
- ],
354
- "isReadonly": false,
355
- "isOptional": true,
356
- "releaseTag": "Beta",
357
- "name": "toolHandlers",
358
- "propertyTypeTokenRange": {
359
- "startIndex": 1,
360
- "endIndex": 2
361
- }
199
+ "kind": "Content",
200
+ "text": ";"
362
201
  }
363
202
  ],
364
- "extendsTokenRanges": []
203
+ "fileUrlPath": "src/config/config.ts",
204
+ "releaseTag": "Beta",
205
+ "name": "AgentConfig",
206
+ "typeTokenRange": {
207
+ "startIndex": 1,
208
+ "endIndex": 4
209
+ }
365
210
  },
366
211
  {
367
212
  "kind": "Class",
@@ -1124,6 +969,33 @@
1124
969
  "endIndex": 3
1125
970
  }
1126
971
  },
972
+ {
973
+ "kind": "PropertySignature",
974
+ "canonicalReference": "@genesislcap/ai-assistant!AiAssistantSerializedState#showAgentSwitchIndicator:member",
975
+ "docComment": "",
976
+ "excerptTokens": [
977
+ {
978
+ "kind": "Content",
979
+ "text": "showAgentSwitchIndicator: "
980
+ },
981
+ {
982
+ "kind": "Content",
983
+ "text": "boolean"
984
+ },
985
+ {
986
+ "kind": "Content",
987
+ "text": ";"
988
+ }
989
+ ],
990
+ "isReadonly": false,
991
+ "isOptional": false,
992
+ "releaseTag": "Beta",
993
+ "name": "showAgentSwitchIndicator",
994
+ "propertyTypeTokenRange": {
995
+ "startIndex": 1,
996
+ "endIndex": 2
997
+ }
998
+ },
1127
999
  {
1128
1000
  "kind": "PropertySignature",
1129
1001
  "canonicalReference": "@genesislcap/ai-assistant!AiAssistantSerializedState#showThinkingSteps:member",
@@ -1431,36 +1303,13 @@
1431
1303
  "extendsTokenRanges": []
1432
1304
  },
1433
1305
  {
1434
- "kind": "Variable",
1435
- "canonicalReference": "@genesislcap/ai-assistant!ANIMATION_DEFS:var",
1436
- "docComment": "/**\n * Registry of all available animations with their display metadata. Adding an entry here automatically extends the {@link AiAssistantAnimation} type.\n *\n * @beta\n */\n",
1437
- "excerptTokens": [
1438
- {
1439
- "kind": "Content",
1440
- "text": "ANIMATION_DEFS: "
1441
- },
1442
- {
1443
- "kind": "Content",
1444
- "text": "{\n loading: {\n label: string;\n tooltip: string;\n };\n halo: {\n label: string;\n tooltip: string;\n };\n}"
1445
- }
1446
- ],
1447
- "fileUrlPath": "src/main/main.types.ts",
1448
- "isReadonly": true,
1449
- "releaseTag": "Beta",
1450
- "name": "ANIMATION_DEFS",
1451
- "variableTypeTokenRange": {
1452
- "startIndex": 1,
1453
- "endIndex": 2
1454
- }
1455
- },
1456
- {
1457
- "kind": "Class",
1458
- "canonicalReference": "@genesislcap/ai-assistant!ChatDriver:class",
1459
- "docComment": "/**\n * Plain TS class that drives a multi-turn chat conversation, including the tool-call loop. Owned by `FoundationAiAssistant` — created in `connectedCallback`, torn down in `disconnectedCallback`.\n *\n * Dispatches `'history-updated'` events on itself so the owning element can observe changes.\n *\n * @beta\n */\n",
1306
+ "kind": "Interface",
1307
+ "canonicalReference": "@genesislcap/ai-assistant!AiDriver:interface",
1308
+ "docComment": "/**\n * Common interface implemented by both `ChatDriver` (single-agent) and `OrchestratingDriver` (multi-agent). `FoundationAiAssistant` depends only on this interface — the concrete class is chosen at startup based on how many agents are configured.\n *\n * Extends `EventTarget` so consumers can subscribe to `history-updated` events without knowing the concrete implementation.\n *\n * @beta\n */\n",
1460
1309
  "excerptTokens": [
1461
1310
  {
1462
1311
  "kind": "Content",
1463
- "text": "export declare class ChatDriver extends "
1312
+ "text": "export interface AiDriver extends "
1464
1313
  },
1465
1314
  {
1466
1315
  "kind": "Reference",
@@ -1472,153 +1321,87 @@
1472
1321
  "text": " "
1473
1322
  }
1474
1323
  ],
1475
- "fileUrlPath": "src/components/chat-driver/chat-driver.ts",
1324
+ "fileUrlPath": "src/components/ai-driver/ai-driver.ts",
1476
1325
  "releaseTag": "Beta",
1477
- "isAbstract": false,
1478
- "name": "ChatDriver",
1326
+ "name": "AiDriver",
1479
1327
  "preserveMemberOrder": false,
1480
1328
  "members": [
1481
1329
  {
1482
- "kind": "Constructor",
1483
- "canonicalReference": "@genesislcap/ai-assistant!ChatDriver:constructor(1)",
1484
- "docComment": "/**\n * Constructs a new instance of the `ChatDriver` class\n */\n",
1330
+ "kind": "MethodSignature",
1331
+ "canonicalReference": "@genesislcap/ai-assistant!AiDriver#continueFromHistory:member(1)",
1332
+ "docComment": "/**\n * Continue the tool loop from the current history without appending a new user message. Used by `OrchestratingDriver` on agent handoffs — the handoff context is already in history; `transientPrimer` is injected as an invisible one-shot message for this call only.\n */\n",
1485
1333
  "excerptTokens": [
1486
1334
  {
1487
1335
  "kind": "Content",
1488
- "text": "constructor(aiProvider: "
1336
+ "text": "continueFromHistory(transientPrimer?: "
1489
1337
  },
1490
1338
  {
1491
1339
  "kind": "Reference",
1492
- "text": "AIProvider",
1493
- "canonicalReference": "@genesislcap/foundation-ai!AIProvider:interface"
1340
+ "text": "ChatMessage",
1341
+ "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
1494
1342
  },
1495
1343
  {
1496
1344
  "kind": "Content",
1497
- "text": ", toolHandlers?: "
1498
- },
1499
- {
1500
- "kind": "Reference",
1501
- "text": "ChatToolHandlers",
1502
- "canonicalReference": "@genesislcap/foundation-ai!ChatToolHandlers:type"
1345
+ "text": "[]"
1503
1346
  },
1504
1347
  {
1505
1348
  "kind": "Content",
1506
- "text": ", toolDefinitions?: "
1349
+ "text": "): "
1507
1350
  },
1508
1351
  {
1509
1352
  "kind": "Reference",
1510
- "text": "ChatToolDefinition",
1511
- "canonicalReference": "@genesislcap/foundation-ai!ChatToolDefinition:interface"
1353
+ "text": "Promise",
1354
+ "canonicalReference": "!Promise:interface"
1512
1355
  },
1513
1356
  {
1514
1357
  "kind": "Content",
1515
- "text": "[]"
1358
+ "text": "<"
1516
1359
  },
1517
1360
  {
1518
- "kind": "Content",
1519
- "text": ", systemPrompt?: "
1361
+ "kind": "Reference",
1362
+ "text": "ChatDriverResult",
1363
+ "canonicalReference": "@genesislcap/foundation-ai!ChatDriverResult:type"
1520
1364
  },
1521
1365
  {
1522
1366
  "kind": "Content",
1523
- "text": "string"
1367
+ "text": ">"
1524
1368
  },
1525
1369
  {
1526
1370
  "kind": "Content",
1527
- "text": ", primerHistory?: "
1528
- },
1529
- {
1530
- "kind": "Reference",
1531
- "text": "ChatMessage",
1532
- "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
1533
- },
1534
- {
1535
- "kind": "Content",
1536
- "text": "[]"
1537
- },
1538
- {
1539
- "kind": "Content",
1540
- "text": ", maxToolIterations?: "
1541
- },
1542
- {
1543
- "kind": "Content",
1544
- "text": "number"
1545
- },
1546
- {
1547
- "kind": "Content",
1548
- "text": ");"
1371
+ "text": ";"
1549
1372
  }
1550
1373
  ],
1374
+ "isOptional": false,
1375
+ "returnTypeTokenRange": {
1376
+ "startIndex": 4,
1377
+ "endIndex": 8
1378
+ },
1551
1379
  "releaseTag": "Beta",
1552
- "isProtected": false,
1553
1380
  "overloadIndex": 1,
1554
1381
  "parameters": [
1555
1382
  {
1556
- "parameterName": "aiProvider",
1383
+ "parameterName": "transientPrimer",
1557
1384
  "parameterTypeTokenRange": {
1558
1385
  "startIndex": 1,
1559
- "endIndex": 2
1560
- },
1561
- "isOptional": false
1562
- },
1563
- {
1564
- "parameterName": "toolHandlers",
1565
- "parameterTypeTokenRange": {
1566
- "startIndex": 3,
1567
- "endIndex": 4
1568
- },
1569
- "isOptional": true
1570
- },
1571
- {
1572
- "parameterName": "toolDefinitions",
1573
- "parameterTypeTokenRange": {
1574
- "startIndex": 5,
1575
- "endIndex": 7
1576
- },
1577
- "isOptional": true
1578
- },
1579
- {
1580
- "parameterName": "systemPrompt",
1581
- "parameterTypeTokenRange": {
1582
- "startIndex": 8,
1583
- "endIndex": 9
1584
- },
1585
- "isOptional": true
1586
- },
1587
- {
1588
- "parameterName": "primerHistory",
1589
- "parameterTypeTokenRange": {
1590
- "startIndex": 10,
1591
- "endIndex": 12
1592
- },
1593
- "isOptional": true
1594
- },
1595
- {
1596
- "parameterName": "maxToolIterations",
1597
- "parameterTypeTokenRange": {
1598
- "startIndex": 13,
1599
- "endIndex": 14
1386
+ "endIndex": 3
1600
1387
  },
1601
1388
  "isOptional": true
1602
1389
  }
1603
- ]
1390
+ ],
1391
+ "name": "continueFromHistory"
1604
1392
  },
1605
1393
  {
1606
- "kind": "Method",
1607
- "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getHistory:member(1)",
1608
- "docComment": "",
1394
+ "kind": "MethodSignature",
1395
+ "canonicalReference": "@genesislcap/ai-assistant!AiDriver#getRawHistory:member(1)",
1396
+ "docComment": "/**\n * Return the full, unredacted conversation history.\n */\n",
1609
1397
  "excerptTokens": [
1610
1398
  {
1611
1399
  "kind": "Content",
1612
- "text": "getHistory(): "
1613
- },
1614
- {
1615
- "kind": "Reference",
1616
- "text": "ReadonlyArray",
1617
- "canonicalReference": "!ReadonlyArray:interface"
1400
+ "text": "getRawHistory?(): "
1618
1401
  },
1619
1402
  {
1620
1403
  "kind": "Content",
1621
- "text": "<"
1404
+ "text": "readonly "
1622
1405
  },
1623
1406
  {
1624
1407
  "kind": "Reference",
@@ -1627,61 +1410,27 @@
1627
1410
  },
1628
1411
  {
1629
1412
  "kind": "Content",
1630
- "text": ">"
1631
- },
1632
- {
1633
- "kind": "Content",
1634
- "text": ";"
1635
- }
1636
- ],
1637
- "isStatic": false,
1638
- "returnTypeTokenRange": {
1639
- "startIndex": 1,
1640
- "endIndex": 5
1641
- },
1642
- "releaseTag": "Beta",
1643
- "isProtected": false,
1644
- "overloadIndex": 1,
1645
- "parameters": [],
1646
- "isOptional": false,
1647
- "isAbstract": false,
1648
- "name": "getHistory"
1649
- },
1650
- {
1651
- "kind": "Method",
1652
- "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#isBusy:member(1)",
1653
- "docComment": "",
1654
- "excerptTokens": [
1655
- {
1656
- "kind": "Content",
1657
- "text": "isBusy(): "
1658
- },
1659
- {
1660
- "kind": "Content",
1661
- "text": "boolean"
1413
+ "text": "[]"
1662
1414
  },
1663
1415
  {
1664
1416
  "kind": "Content",
1665
1417
  "text": ";"
1666
1418
  }
1667
1419
  ],
1668
- "isStatic": false,
1420
+ "isOptional": true,
1669
1421
  "returnTypeTokenRange": {
1670
1422
  "startIndex": 1,
1671
- "endIndex": 2
1423
+ "endIndex": 4
1672
1424
  },
1673
1425
  "releaseTag": "Beta",
1674
- "isProtected": false,
1675
1426
  "overloadIndex": 1,
1676
1427
  "parameters": [],
1677
- "isOptional": false,
1678
- "isAbstract": false,
1679
- "name": "isBusy"
1428
+ "name": "getRawHistory"
1680
1429
  },
1681
1430
  {
1682
- "kind": "Method",
1683
- "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#loadHistory:member(1)",
1684
- "docComment": "/**\n * Seeds the driver with a prior conversation history so a new component instance can continue an existing conversation. Call this before the first user message.\n */\n",
1431
+ "kind": "MethodSignature",
1432
+ "canonicalReference": "@genesislcap/ai-assistant!AiDriver#loadHistory:member(1)",
1433
+ "docComment": "/**\n * Seed the driver's message history (called on state restore / pop-in).\n */\n",
1685
1434
  "excerptTokens": [
1686
1435
  {
1687
1436
  "kind": "Content",
@@ -1709,13 +1458,12 @@
1709
1458
  "text": ";"
1710
1459
  }
1711
1460
  ],
1712
- "isStatic": false,
1461
+ "isOptional": false,
1713
1462
  "returnTypeTokenRange": {
1714
1463
  "startIndex": 4,
1715
1464
  "endIndex": 5
1716
1465
  },
1717
1466
  "releaseTag": "Beta",
1718
- "isProtected": false,
1719
1467
  "overloadIndex": 1,
1720
1468
  "parameters": [
1721
1469
  {
@@ -1727,96 +1475,12 @@
1727
1475
  "isOptional": false
1728
1476
  }
1729
1477
  ],
1730
- "isOptional": false,
1731
- "isAbstract": false,
1732
1478
  "name": "loadHistory"
1733
1479
  },
1734
1480
  {
1735
- "kind": "Method",
1736
- "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#requestInteraction:member(1)",
1737
- "docComment": "/**\n * Request a custom UI interaction. Emits a new message with the interaction. Tool handlers can call this to pause execution until the user completes the UI interaction.\n *\n * @param componentName - The custom element name to render.\n *\n * @param data - Data to pass to the component.\n */\n",
1738
- "excerptTokens": [
1739
- {
1740
- "kind": "Content",
1741
- "text": "requestInteraction<T>(componentName: "
1742
- },
1743
- {
1744
- "kind": "Content",
1745
- "text": "string"
1746
- },
1747
- {
1748
- "kind": "Content",
1749
- "text": ", data: "
1750
- },
1751
- {
1752
- "kind": "Content",
1753
- "text": "any"
1754
- },
1755
- {
1756
- "kind": "Content",
1757
- "text": "): "
1758
- },
1759
- {
1760
- "kind": "Reference",
1761
- "text": "Promise",
1762
- "canonicalReference": "!Promise:interface"
1763
- },
1764
- {
1765
- "kind": "Content",
1766
- "text": "<T>"
1767
- },
1768
- {
1769
- "kind": "Content",
1770
- "text": ";"
1771
- }
1772
- ],
1773
- "typeParameters": [
1774
- {
1775
- "typeParameterName": "T",
1776
- "constraintTokenRange": {
1777
- "startIndex": 0,
1778
- "endIndex": 0
1779
- },
1780
- "defaultTypeTokenRange": {
1781
- "startIndex": 0,
1782
- "endIndex": 0
1783
- }
1784
- }
1785
- ],
1786
- "isStatic": false,
1787
- "returnTypeTokenRange": {
1788
- "startIndex": 5,
1789
- "endIndex": 7
1790
- },
1791
- "releaseTag": "Beta",
1792
- "isProtected": false,
1793
- "overloadIndex": 1,
1794
- "parameters": [
1795
- {
1796
- "parameterName": "componentName",
1797
- "parameterTypeTokenRange": {
1798
- "startIndex": 1,
1799
- "endIndex": 2
1800
- },
1801
- "isOptional": false
1802
- },
1803
- {
1804
- "parameterName": "data",
1805
- "parameterTypeTokenRange": {
1806
- "startIndex": 3,
1807
- "endIndex": 4
1808
- },
1809
- "isOptional": false
1810
- }
1811
- ],
1812
- "isOptional": false,
1813
- "isAbstract": false,
1814
- "name": "requestInteraction"
1815
- },
1816
- {
1817
- "kind": "Method",
1818
- "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#resolveInteraction:member(1)",
1819
- "docComment": "/**\n * Resolve a pending interaction. The wrapper component calls this on completion. Marks the interaction message as resolved so it renders read-only on re-render.\n */\n",
1481
+ "kind": "MethodSignature",
1482
+ "canonicalReference": "@genesislcap/ai-assistant!AiDriver#resolveInteraction:member(1)",
1483
+ "docComment": "/**\n * Resolve a pending blocking interaction with the given result.\n */\n",
1820
1484
  "excerptTokens": [
1821
1485
  {
1822
1486
  "kind": "Content",
@@ -1832,7 +1496,7 @@
1832
1496
  },
1833
1497
  {
1834
1498
  "kind": "Content",
1835
- "text": "any"
1499
+ "text": "unknown"
1836
1500
  },
1837
1501
  {
1838
1502
  "kind": "Content",
@@ -1847,13 +1511,12 @@
1847
1511
  "text": ";"
1848
1512
  }
1849
1513
  ],
1850
- "isStatic": false,
1514
+ "isOptional": false,
1851
1515
  "returnTypeTokenRange": {
1852
1516
  "startIndex": 5,
1853
1517
  "endIndex": 6
1854
1518
  },
1855
1519
  "releaseTag": "Beta",
1856
- "isProtected": false,
1857
1520
  "overloadIndex": 1,
1858
1521
  "parameters": [
1859
1522
  {
@@ -1873,18 +1536,16 @@
1873
1536
  "isOptional": false
1874
1537
  }
1875
1538
  ],
1876
- "isOptional": false,
1877
- "isAbstract": false,
1878
1539
  "name": "resolveInteraction"
1879
1540
  },
1880
1541
  {
1881
- "kind": "Method",
1882
- "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#sendMessage:member(1)",
1883
- "docComment": "",
1542
+ "kind": "MethodSignature",
1543
+ "canonicalReference": "@genesislcap/ai-assistant!AiDriver#sendMessage:member(1)",
1544
+ "docComment": "/**\n * Send a user message and run the tool loop to completion.\n */\n",
1884
1545
  "excerptTokens": [
1885
1546
  {
1886
1547
  "kind": "Content",
1887
- "text": "sendMessage(userInput: "
1548
+ "text": "sendMessage(input: "
1888
1549
  },
1889
1550
  {
1890
1551
  "kind": "Content",
@@ -1914,24 +1575,32 @@
1914
1575
  },
1915
1576
  {
1916
1577
  "kind": "Content",
1917
- "text": "<void>"
1578
+ "text": "<"
1579
+ },
1580
+ {
1581
+ "kind": "Reference",
1582
+ "text": "ChatDriverResult",
1583
+ "canonicalReference": "@genesislcap/foundation-ai!ChatDriverResult:type"
1584
+ },
1585
+ {
1586
+ "kind": "Content",
1587
+ "text": ">"
1918
1588
  },
1919
1589
  {
1920
1590
  "kind": "Content",
1921
1591
  "text": ";"
1922
1592
  }
1923
1593
  ],
1924
- "isStatic": false,
1594
+ "isOptional": false,
1925
1595
  "returnTypeTokenRange": {
1926
1596
  "startIndex": 6,
1927
- "endIndex": 8
1597
+ "endIndex": 10
1928
1598
  },
1929
1599
  "releaseTag": "Beta",
1930
- "isProtected": false,
1931
1600
  "overloadIndex": 1,
1932
1601
  "parameters": [
1933
1602
  {
1934
- "parameterName": "userInput",
1603
+ "parameterName": "input",
1935
1604
  "parameterTypeTokenRange": {
1936
1605
  "startIndex": 1,
1937
1606
  "endIndex": 2
@@ -1947,25 +1616,731 @@
1947
1616
  "isOptional": true
1948
1617
  }
1949
1618
  ],
1950
- "isOptional": false,
1951
- "isAbstract": false,
1952
1619
  "name": "sendMessage"
1953
1620
  }
1954
1621
  ],
1955
- "extendsTokenRange": {
1956
- "startIndex": 1,
1957
- "endIndex": 2
1958
- },
1959
- "implementsTokenRanges": []
1622
+ "extendsTokenRanges": [
1623
+ {
1624
+ "startIndex": 1,
1625
+ "endIndex": 2
1626
+ }
1627
+ ]
1960
1628
  },
1961
1629
  {
1962
- "kind": "TypeAlias",
1963
- "canonicalReference": "@genesislcap/ai-assistant!ChatHistoryUpdatedEvent:type",
1964
- "docComment": "/**\n * Event emitted when the chat history is updated (new message appended).\n *\n * @beta\n */\n",
1630
+ "kind": "Variable",
1631
+ "canonicalReference": "@genesislcap/ai-assistant!ANIMATION_DEFS:var",
1632
+ "docComment": "/**\n * Registry of all available animations with their display metadata. Adding an entry here automatically extends the {@link AiAssistantAnimation} type.\n *\n * @beta\n */\n",
1965
1633
  "excerptTokens": [
1966
1634
  {
1967
1635
  "kind": "Content",
1968
- "text": "export type ChatHistoryUpdatedEvent = "
1636
+ "text": "ANIMATION_DEFS: "
1637
+ },
1638
+ {
1639
+ "kind": "Content",
1640
+ "text": "{\n loading: {\n label: string;\n tooltip: string;\n };\n halo: {\n label: string;\n tooltip: string;\n };\n}"
1641
+ }
1642
+ ],
1643
+ "fileUrlPath": "src/main/main.types.ts",
1644
+ "isReadonly": true,
1645
+ "releaseTag": "Beta",
1646
+ "name": "ANIMATION_DEFS",
1647
+ "variableTypeTokenRange": {
1648
+ "startIndex": 1,
1649
+ "endIndex": 2
1650
+ }
1651
+ },
1652
+ {
1653
+ "kind": "Class",
1654
+ "canonicalReference": "@genesislcap/ai-assistant!ChatDriver:class",
1655
+ "docComment": "/**\n * Plain TS class that drives a multi-turn chat conversation, including the tool-call loop. Owned by `FoundationAiAssistant` — created in `connectedCallback`, torn down in `disconnectedCallback`.\n *\n * Dispatches `'history-updated'` events on itself so the owning element can observe changes.\n *\n * @beta\n */\n",
1656
+ "excerptTokens": [
1657
+ {
1658
+ "kind": "Content",
1659
+ "text": "export declare class ChatDriver extends "
1660
+ },
1661
+ {
1662
+ "kind": "Reference",
1663
+ "text": "EventTarget",
1664
+ "canonicalReference": "!EventTarget:interface"
1665
+ },
1666
+ {
1667
+ "kind": "Content",
1668
+ "text": " implements "
1669
+ },
1670
+ {
1671
+ "kind": "Reference",
1672
+ "text": "AiDriver",
1673
+ "canonicalReference": "@genesislcap/ai-assistant!AiDriver:interface"
1674
+ },
1675
+ {
1676
+ "kind": "Content",
1677
+ "text": " "
1678
+ }
1679
+ ],
1680
+ "fileUrlPath": "src/components/chat-driver/chat-driver.ts",
1681
+ "releaseTag": "Beta",
1682
+ "isAbstract": false,
1683
+ "name": "ChatDriver",
1684
+ "preserveMemberOrder": false,
1685
+ "members": [
1686
+ {
1687
+ "kind": "Constructor",
1688
+ "canonicalReference": "@genesislcap/ai-assistant!ChatDriver:constructor(1)",
1689
+ "docComment": "/**\n * Constructs a new instance of the `ChatDriver` class\n */\n",
1690
+ "excerptTokens": [
1691
+ {
1692
+ "kind": "Content",
1693
+ "text": "constructor(aiProvider: "
1694
+ },
1695
+ {
1696
+ "kind": "Reference",
1697
+ "text": "AIProvider",
1698
+ "canonicalReference": "@genesislcap/foundation-ai!AIProvider:interface"
1699
+ },
1700
+ {
1701
+ "kind": "Content",
1702
+ "text": ", toolHandlers?: "
1703
+ },
1704
+ {
1705
+ "kind": "Reference",
1706
+ "text": "ChatToolHandlers",
1707
+ "canonicalReference": "@genesislcap/foundation-ai!ChatToolHandlers:type"
1708
+ },
1709
+ {
1710
+ "kind": "Content",
1711
+ "text": ", toolDefinitions?: "
1712
+ },
1713
+ {
1714
+ "kind": "Reference",
1715
+ "text": "ChatToolDefinition",
1716
+ "canonicalReference": "@genesislcap/foundation-ai!ChatToolDefinition:interface"
1717
+ },
1718
+ {
1719
+ "kind": "Content",
1720
+ "text": "[]"
1721
+ },
1722
+ {
1723
+ "kind": "Content",
1724
+ "text": ", systemPrompt?: "
1725
+ },
1726
+ {
1727
+ "kind": "Content",
1728
+ "text": "string"
1729
+ },
1730
+ {
1731
+ "kind": "Content",
1732
+ "text": ", primerHistory?: "
1733
+ },
1734
+ {
1735
+ "kind": "Reference",
1736
+ "text": "ChatMessage",
1737
+ "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
1738
+ },
1739
+ {
1740
+ "kind": "Content",
1741
+ "text": "[]"
1742
+ },
1743
+ {
1744
+ "kind": "Content",
1745
+ "text": ", maxToolIterations?: "
1746
+ },
1747
+ {
1748
+ "kind": "Content",
1749
+ "text": "number"
1750
+ },
1751
+ {
1752
+ "kind": "Content",
1753
+ "text": ");"
1754
+ }
1755
+ ],
1756
+ "releaseTag": "Beta",
1757
+ "isProtected": false,
1758
+ "overloadIndex": 1,
1759
+ "parameters": [
1760
+ {
1761
+ "parameterName": "aiProvider",
1762
+ "parameterTypeTokenRange": {
1763
+ "startIndex": 1,
1764
+ "endIndex": 2
1765
+ },
1766
+ "isOptional": false
1767
+ },
1768
+ {
1769
+ "parameterName": "toolHandlers",
1770
+ "parameterTypeTokenRange": {
1771
+ "startIndex": 3,
1772
+ "endIndex": 4
1773
+ },
1774
+ "isOptional": true
1775
+ },
1776
+ {
1777
+ "parameterName": "toolDefinitions",
1778
+ "parameterTypeTokenRange": {
1779
+ "startIndex": 5,
1780
+ "endIndex": 7
1781
+ },
1782
+ "isOptional": true
1783
+ },
1784
+ {
1785
+ "parameterName": "systemPrompt",
1786
+ "parameterTypeTokenRange": {
1787
+ "startIndex": 8,
1788
+ "endIndex": 9
1789
+ },
1790
+ "isOptional": true
1791
+ },
1792
+ {
1793
+ "parameterName": "primerHistory",
1794
+ "parameterTypeTokenRange": {
1795
+ "startIndex": 10,
1796
+ "endIndex": 12
1797
+ },
1798
+ "isOptional": true
1799
+ },
1800
+ {
1801
+ "parameterName": "maxToolIterations",
1802
+ "parameterTypeTokenRange": {
1803
+ "startIndex": 13,
1804
+ "endIndex": 14
1805
+ },
1806
+ "isOptional": true
1807
+ }
1808
+ ]
1809
+ },
1810
+ {
1811
+ "kind": "Method",
1812
+ "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#applyAgent:member(1)",
1813
+ "docComment": "/**\n * Swap in a new agent's configuration. Called by OrchestratingDriver before each specialist turn so the shared driver runs with the right tools and prompt.\n */\n",
1814
+ "excerptTokens": [
1815
+ {
1816
+ "kind": "Content",
1817
+ "text": "applyAgent(config: "
1818
+ },
1819
+ {
1820
+ "kind": "Reference",
1821
+ "text": "AgentConfig",
1822
+ "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type"
1823
+ },
1824
+ {
1825
+ "kind": "Content",
1826
+ "text": "): "
1827
+ },
1828
+ {
1829
+ "kind": "Content",
1830
+ "text": "void"
1831
+ },
1832
+ {
1833
+ "kind": "Content",
1834
+ "text": ";"
1835
+ }
1836
+ ],
1837
+ "isStatic": false,
1838
+ "returnTypeTokenRange": {
1839
+ "startIndex": 3,
1840
+ "endIndex": 4
1841
+ },
1842
+ "releaseTag": "Beta",
1843
+ "isProtected": false,
1844
+ "overloadIndex": 1,
1845
+ "parameters": [
1846
+ {
1847
+ "parameterName": "config",
1848
+ "parameterTypeTokenRange": {
1849
+ "startIndex": 1,
1850
+ "endIndex": 2
1851
+ },
1852
+ "isOptional": false
1853
+ }
1854
+ ],
1855
+ "isOptional": false,
1856
+ "isAbstract": false,
1857
+ "name": "applyAgent"
1858
+ },
1859
+ {
1860
+ "kind": "Method",
1861
+ "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#continueFromHistory:member(1)",
1862
+ "docComment": "/**\n * Continue the tool loop from current history without appending a new user message. Used by OrchestratingDriver after an agent handoff — the handoff context is already in history; `transientPrimer` is injected as an invisible one-shot message for this call only.\n */\n",
1863
+ "excerptTokens": [
1864
+ {
1865
+ "kind": "Content",
1866
+ "text": "continueFromHistory(transientPrimer?: "
1867
+ },
1868
+ {
1869
+ "kind": "Reference",
1870
+ "text": "ChatMessage",
1871
+ "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
1872
+ },
1873
+ {
1874
+ "kind": "Content",
1875
+ "text": "[]"
1876
+ },
1877
+ {
1878
+ "kind": "Content",
1879
+ "text": "): "
1880
+ },
1881
+ {
1882
+ "kind": "Reference",
1883
+ "text": "Promise",
1884
+ "canonicalReference": "!Promise:interface"
1885
+ },
1886
+ {
1887
+ "kind": "Content",
1888
+ "text": "<"
1889
+ },
1890
+ {
1891
+ "kind": "Reference",
1892
+ "text": "ChatDriverResult",
1893
+ "canonicalReference": "@genesislcap/foundation-ai!ChatDriverResult:type"
1894
+ },
1895
+ {
1896
+ "kind": "Content",
1897
+ "text": ">"
1898
+ },
1899
+ {
1900
+ "kind": "Content",
1901
+ "text": ";"
1902
+ }
1903
+ ],
1904
+ "isStatic": false,
1905
+ "returnTypeTokenRange": {
1906
+ "startIndex": 4,
1907
+ "endIndex": 8
1908
+ },
1909
+ "releaseTag": "Beta",
1910
+ "isProtected": false,
1911
+ "overloadIndex": 1,
1912
+ "parameters": [
1913
+ {
1914
+ "parameterName": "transientPrimer",
1915
+ "parameterTypeTokenRange": {
1916
+ "startIndex": 1,
1917
+ "endIndex": 3
1918
+ },
1919
+ "isOptional": true
1920
+ }
1921
+ ],
1922
+ "isOptional": false,
1923
+ "isAbstract": false,
1924
+ "name": "continueFromHistory"
1925
+ },
1926
+ {
1927
+ "kind": "Method",
1928
+ "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getHistory:member(1)",
1929
+ "docComment": "",
1930
+ "excerptTokens": [
1931
+ {
1932
+ "kind": "Content",
1933
+ "text": "getHistory(): "
1934
+ },
1935
+ {
1936
+ "kind": "Reference",
1937
+ "text": "ReadonlyArray",
1938
+ "canonicalReference": "!ReadonlyArray:interface"
1939
+ },
1940
+ {
1941
+ "kind": "Content",
1942
+ "text": "<"
1943
+ },
1944
+ {
1945
+ "kind": "Reference",
1946
+ "text": "ChatMessage",
1947
+ "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
1948
+ },
1949
+ {
1950
+ "kind": "Content",
1951
+ "text": ">"
1952
+ },
1953
+ {
1954
+ "kind": "Content",
1955
+ "text": ";"
1956
+ }
1957
+ ],
1958
+ "isStatic": false,
1959
+ "returnTypeTokenRange": {
1960
+ "startIndex": 1,
1961
+ "endIndex": 5
1962
+ },
1963
+ "releaseTag": "Beta",
1964
+ "isProtected": false,
1965
+ "overloadIndex": 1,
1966
+ "parameters": [],
1967
+ "isOptional": false,
1968
+ "isAbstract": false,
1969
+ "name": "getHistory"
1970
+ },
1971
+ {
1972
+ "kind": "Method",
1973
+ "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getRawHistory:member(1)",
1974
+ "docComment": "",
1975
+ "excerptTokens": [
1976
+ {
1977
+ "kind": "Content",
1978
+ "text": "getRawHistory(): "
1979
+ },
1980
+ {
1981
+ "kind": "Content",
1982
+ "text": "readonly "
1983
+ },
1984
+ {
1985
+ "kind": "Reference",
1986
+ "text": "ChatMessage",
1987
+ "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
1988
+ },
1989
+ {
1990
+ "kind": "Content",
1991
+ "text": "[]"
1992
+ },
1993
+ {
1994
+ "kind": "Content",
1995
+ "text": ";"
1996
+ }
1997
+ ],
1998
+ "isStatic": false,
1999
+ "returnTypeTokenRange": {
2000
+ "startIndex": 1,
2001
+ "endIndex": 4
2002
+ },
2003
+ "releaseTag": "Beta",
2004
+ "isProtected": false,
2005
+ "overloadIndex": 1,
2006
+ "parameters": [],
2007
+ "isOptional": false,
2008
+ "isAbstract": false,
2009
+ "name": "getRawHistory"
2010
+ },
2011
+ {
2012
+ "kind": "Method",
2013
+ "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#isBusy:member(1)",
2014
+ "docComment": "",
2015
+ "excerptTokens": [
2016
+ {
2017
+ "kind": "Content",
2018
+ "text": "isBusy(): "
2019
+ },
2020
+ {
2021
+ "kind": "Content",
2022
+ "text": "boolean"
2023
+ },
2024
+ {
2025
+ "kind": "Content",
2026
+ "text": ";"
2027
+ }
2028
+ ],
2029
+ "isStatic": false,
2030
+ "returnTypeTokenRange": {
2031
+ "startIndex": 1,
2032
+ "endIndex": 2
2033
+ },
2034
+ "releaseTag": "Beta",
2035
+ "isProtected": false,
2036
+ "overloadIndex": 1,
2037
+ "parameters": [],
2038
+ "isOptional": false,
2039
+ "isAbstract": false,
2040
+ "name": "isBusy"
2041
+ },
2042
+ {
2043
+ "kind": "Method",
2044
+ "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#loadHistory:member(1)",
2045
+ "docComment": "/**\n * Seeds the driver with a prior conversation history so a new component instance can continue an existing conversation. Call this before the first user message.\n */\n",
2046
+ "excerptTokens": [
2047
+ {
2048
+ "kind": "Content",
2049
+ "text": "loadHistory(messages: "
2050
+ },
2051
+ {
2052
+ "kind": "Reference",
2053
+ "text": "ChatMessage",
2054
+ "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
2055
+ },
2056
+ {
2057
+ "kind": "Content",
2058
+ "text": "[]"
2059
+ },
2060
+ {
2061
+ "kind": "Content",
2062
+ "text": "): "
2063
+ },
2064
+ {
2065
+ "kind": "Content",
2066
+ "text": "void"
2067
+ },
2068
+ {
2069
+ "kind": "Content",
2070
+ "text": ";"
2071
+ }
2072
+ ],
2073
+ "isStatic": false,
2074
+ "returnTypeTokenRange": {
2075
+ "startIndex": 4,
2076
+ "endIndex": 5
2077
+ },
2078
+ "releaseTag": "Beta",
2079
+ "isProtected": false,
2080
+ "overloadIndex": 1,
2081
+ "parameters": [
2082
+ {
2083
+ "parameterName": "messages",
2084
+ "parameterTypeTokenRange": {
2085
+ "startIndex": 1,
2086
+ "endIndex": 3
2087
+ },
2088
+ "isOptional": false
2089
+ }
2090
+ ],
2091
+ "isOptional": false,
2092
+ "isAbstract": false,
2093
+ "name": "loadHistory"
2094
+ },
2095
+ {
2096
+ "kind": "Method",
2097
+ "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#requestInteraction:member(1)",
2098
+ "docComment": "/**\n * Request a custom UI interaction. Emits a new message with the interaction. Tool handlers can call this to pause execution until the user completes the UI interaction.\n *\n * @param componentName - The custom element name to render.\n *\n * @param data - Data to pass to the component.\n */\n",
2099
+ "excerptTokens": [
2100
+ {
2101
+ "kind": "Content",
2102
+ "text": "requestInteraction<T>(componentName: "
2103
+ },
2104
+ {
2105
+ "kind": "Content",
2106
+ "text": "string"
2107
+ },
2108
+ {
2109
+ "kind": "Content",
2110
+ "text": ", data: "
2111
+ },
2112
+ {
2113
+ "kind": "Content",
2114
+ "text": "any"
2115
+ },
2116
+ {
2117
+ "kind": "Content",
2118
+ "text": "): "
2119
+ },
2120
+ {
2121
+ "kind": "Reference",
2122
+ "text": "Promise",
2123
+ "canonicalReference": "!Promise:interface"
2124
+ },
2125
+ {
2126
+ "kind": "Content",
2127
+ "text": "<T>"
2128
+ },
2129
+ {
2130
+ "kind": "Content",
2131
+ "text": ";"
2132
+ }
2133
+ ],
2134
+ "typeParameters": [
2135
+ {
2136
+ "typeParameterName": "T",
2137
+ "constraintTokenRange": {
2138
+ "startIndex": 0,
2139
+ "endIndex": 0
2140
+ },
2141
+ "defaultTypeTokenRange": {
2142
+ "startIndex": 0,
2143
+ "endIndex": 0
2144
+ }
2145
+ }
2146
+ ],
2147
+ "isStatic": false,
2148
+ "returnTypeTokenRange": {
2149
+ "startIndex": 5,
2150
+ "endIndex": 7
2151
+ },
2152
+ "releaseTag": "Beta",
2153
+ "isProtected": false,
2154
+ "overloadIndex": 1,
2155
+ "parameters": [
2156
+ {
2157
+ "parameterName": "componentName",
2158
+ "parameterTypeTokenRange": {
2159
+ "startIndex": 1,
2160
+ "endIndex": 2
2161
+ },
2162
+ "isOptional": false
2163
+ },
2164
+ {
2165
+ "parameterName": "data",
2166
+ "parameterTypeTokenRange": {
2167
+ "startIndex": 3,
2168
+ "endIndex": 4
2169
+ },
2170
+ "isOptional": false
2171
+ }
2172
+ ],
2173
+ "isOptional": false,
2174
+ "isAbstract": false,
2175
+ "name": "requestInteraction"
2176
+ },
2177
+ {
2178
+ "kind": "Method",
2179
+ "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#resolveInteraction:member(1)",
2180
+ "docComment": "/**\n * Resolve a pending interaction. The wrapper component calls this on completion. Marks the interaction message as resolved so it renders read-only on re-render.\n */\n",
2181
+ "excerptTokens": [
2182
+ {
2183
+ "kind": "Content",
2184
+ "text": "resolveInteraction(interactionId: "
2185
+ },
2186
+ {
2187
+ "kind": "Content",
2188
+ "text": "string"
2189
+ },
2190
+ {
2191
+ "kind": "Content",
2192
+ "text": ", result: "
2193
+ },
2194
+ {
2195
+ "kind": "Content",
2196
+ "text": "any"
2197
+ },
2198
+ {
2199
+ "kind": "Content",
2200
+ "text": "): "
2201
+ },
2202
+ {
2203
+ "kind": "Content",
2204
+ "text": "void"
2205
+ },
2206
+ {
2207
+ "kind": "Content",
2208
+ "text": ";"
2209
+ }
2210
+ ],
2211
+ "isStatic": false,
2212
+ "returnTypeTokenRange": {
2213
+ "startIndex": 5,
2214
+ "endIndex": 6
2215
+ },
2216
+ "releaseTag": "Beta",
2217
+ "isProtected": false,
2218
+ "overloadIndex": 1,
2219
+ "parameters": [
2220
+ {
2221
+ "parameterName": "interactionId",
2222
+ "parameterTypeTokenRange": {
2223
+ "startIndex": 1,
2224
+ "endIndex": 2
2225
+ },
2226
+ "isOptional": false
2227
+ },
2228
+ {
2229
+ "parameterName": "result",
2230
+ "parameterTypeTokenRange": {
2231
+ "startIndex": 3,
2232
+ "endIndex": 4
2233
+ },
2234
+ "isOptional": false
2235
+ }
2236
+ ],
2237
+ "isOptional": false,
2238
+ "isAbstract": false,
2239
+ "name": "resolveInteraction"
2240
+ },
2241
+ {
2242
+ "kind": "Method",
2243
+ "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#sendMessage:member(1)",
2244
+ "docComment": "",
2245
+ "excerptTokens": [
2246
+ {
2247
+ "kind": "Content",
2248
+ "text": "sendMessage(userInput: "
2249
+ },
2250
+ {
2251
+ "kind": "Content",
2252
+ "text": "string"
2253
+ },
2254
+ {
2255
+ "kind": "Content",
2256
+ "text": ", attachments?: "
2257
+ },
2258
+ {
2259
+ "kind": "Reference",
2260
+ "text": "ChatAttachment",
2261
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment:interface"
2262
+ },
2263
+ {
2264
+ "kind": "Content",
2265
+ "text": "[]"
2266
+ },
2267
+ {
2268
+ "kind": "Content",
2269
+ "text": "): "
2270
+ },
2271
+ {
2272
+ "kind": "Reference",
2273
+ "text": "Promise",
2274
+ "canonicalReference": "!Promise:interface"
2275
+ },
2276
+ {
2277
+ "kind": "Content",
2278
+ "text": "<"
2279
+ },
2280
+ {
2281
+ "kind": "Reference",
2282
+ "text": "ChatDriverResult",
2283
+ "canonicalReference": "@genesislcap/foundation-ai!ChatDriverResult:type"
2284
+ },
2285
+ {
2286
+ "kind": "Content",
2287
+ "text": ">"
2288
+ },
2289
+ {
2290
+ "kind": "Content",
2291
+ "text": ";"
2292
+ }
2293
+ ],
2294
+ "isStatic": false,
2295
+ "returnTypeTokenRange": {
2296
+ "startIndex": 6,
2297
+ "endIndex": 10
2298
+ },
2299
+ "releaseTag": "Beta",
2300
+ "isProtected": false,
2301
+ "overloadIndex": 1,
2302
+ "parameters": [
2303
+ {
2304
+ "parameterName": "userInput",
2305
+ "parameterTypeTokenRange": {
2306
+ "startIndex": 1,
2307
+ "endIndex": 2
2308
+ },
2309
+ "isOptional": false
2310
+ },
2311
+ {
2312
+ "parameterName": "attachments",
2313
+ "parameterTypeTokenRange": {
2314
+ "startIndex": 3,
2315
+ "endIndex": 5
2316
+ },
2317
+ "isOptional": true
2318
+ }
2319
+ ],
2320
+ "isOptional": false,
2321
+ "isAbstract": false,
2322
+ "name": "sendMessage"
2323
+ }
2324
+ ],
2325
+ "extendsTokenRange": {
2326
+ "startIndex": 1,
2327
+ "endIndex": 2
2328
+ },
2329
+ "implementsTokenRanges": [
2330
+ {
2331
+ "startIndex": 3,
2332
+ "endIndex": 4
2333
+ }
2334
+ ]
2335
+ },
2336
+ {
2337
+ "kind": "TypeAlias",
2338
+ "canonicalReference": "@genesislcap/ai-assistant!ChatHistoryUpdatedEvent:type",
2339
+ "docComment": "/**\n * Event emitted when the chat history is updated (new message appended).\n *\n * @beta\n */\n",
2340
+ "excerptTokens": [
2341
+ {
2342
+ "kind": "Content",
2343
+ "text": "export type ChatHistoryUpdatedEvent = "
1969
2344
  },
1970
2345
  {
1971
2346
  "kind": "Reference",
@@ -2007,10 +2382,96 @@
2007
2382
  "endIndex": 7
2008
2383
  }
2009
2384
  },
2385
+ {
2386
+ "kind": "Interface",
2387
+ "canonicalReference": "@genesislcap/ai-assistant!FallbackAgentConfig:interface",
2388
+ "docComment": "/**\n * Configuration for a fallback agent.\n *\n * Invoked when the classifier returns no match. Excluded from the classifier prompt. Only one fallback is permitted per agents array.\n *\n * @beta\n */\n",
2389
+ "excerptTokens": [
2390
+ {
2391
+ "kind": "Content",
2392
+ "text": "export interface FallbackAgentConfig extends "
2393
+ },
2394
+ {
2395
+ "kind": "Reference",
2396
+ "text": "BaseAgentConfig",
2397
+ "canonicalReference": "@genesislcap/ai-assistant!~BaseAgentConfig:interface"
2398
+ },
2399
+ {
2400
+ "kind": "Content",
2401
+ "text": " "
2402
+ }
2403
+ ],
2404
+ "fileUrlPath": "src/config/config.ts",
2405
+ "releaseTag": "Beta",
2406
+ "name": "FallbackAgentConfig",
2407
+ "preserveMemberOrder": false,
2408
+ "members": [
2409
+ {
2410
+ "kind": "PropertySignature",
2411
+ "canonicalReference": "@genesislcap/ai-assistant!FallbackAgentConfig#description:member",
2412
+ "docComment": "",
2413
+ "excerptTokens": [
2414
+ {
2415
+ "kind": "Content",
2416
+ "text": "description?: "
2417
+ },
2418
+ {
2419
+ "kind": "Content",
2420
+ "text": "never"
2421
+ },
2422
+ {
2423
+ "kind": "Content",
2424
+ "text": ";"
2425
+ }
2426
+ ],
2427
+ "isReadonly": false,
2428
+ "isOptional": true,
2429
+ "releaseTag": "Beta",
2430
+ "name": "description",
2431
+ "propertyTypeTokenRange": {
2432
+ "startIndex": 1,
2433
+ "endIndex": 2
2434
+ }
2435
+ },
2436
+ {
2437
+ "kind": "PropertySignature",
2438
+ "canonicalReference": "@genesislcap/ai-assistant!FallbackAgentConfig#fallback:member",
2439
+ "docComment": "/**\n * Marks this agent as the fallback for unrecognised requests.\n */\n",
2440
+ "excerptTokens": [
2441
+ {
2442
+ "kind": "Content",
2443
+ "text": "fallback: "
2444
+ },
2445
+ {
2446
+ "kind": "Content",
2447
+ "text": "true"
2448
+ },
2449
+ {
2450
+ "kind": "Content",
2451
+ "text": ";"
2452
+ }
2453
+ ],
2454
+ "isReadonly": false,
2455
+ "isOptional": false,
2456
+ "releaseTag": "Beta",
2457
+ "name": "fallback",
2458
+ "propertyTypeTokenRange": {
2459
+ "startIndex": 1,
2460
+ "endIndex": 2
2461
+ }
2462
+ }
2463
+ ],
2464
+ "extendsTokenRanges": [
2465
+ {
2466
+ "startIndex": 1,
2467
+ "endIndex": 2
2468
+ }
2469
+ ]
2470
+ },
2010
2471
  {
2011
2472
  "kind": "Class",
2012
2473
  "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant:class",
2013
- "docComment": "/**\n * Foundation AI Assistant component.\n *\n * @remarks\n *\n * Inject an `AIProvider` through the DI container. Pass agent configuration via the `agents` property. The component creates a `ChatDriver` to manage the conversation loop.\n *\n * @beta\n */\n",
2474
+ "docComment": "/**\n * Foundation AI Assistant component.\n *\n * @remarks\n *\n * Inject an `AIProvider` through the DI container. Pass agent configuration via the `agents` property. The component creates a `ChatDriver` (single agent) or `OrchestratingDriver` (multiple agents) to manage the conversation loop.\n *\n * @beta\n */\n",
2014
2475
  "excerptTokens": [
2015
2476
  {
2016
2477
  "kind": "Content",
@@ -2032,6 +2493,37 @@
2032
2493
  "name": "FoundationAiAssistant",
2033
2494
  "preserveMemberOrder": false,
2034
2495
  "members": [
2496
+ {
2497
+ "kind": "Property",
2498
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#activeAgent:member",
2499
+ "docComment": "",
2500
+ "excerptTokens": [
2501
+ {
2502
+ "kind": "Content",
2503
+ "text": "activeAgent?: "
2504
+ },
2505
+ {
2506
+ "kind": "Reference",
2507
+ "text": "AgentConfig",
2508
+ "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type"
2509
+ },
2510
+ {
2511
+ "kind": "Content",
2512
+ "text": ";"
2513
+ }
2514
+ ],
2515
+ "isReadonly": false,
2516
+ "isOptional": true,
2517
+ "releaseTag": "Beta",
2518
+ "name": "activeAgent",
2519
+ "propertyTypeTokenRange": {
2520
+ "startIndex": 1,
2521
+ "endIndex": 2
2522
+ },
2523
+ "isStatic": false,
2524
+ "isProtected": false,
2525
+ "isAbstract": false
2526
+ },
2035
2527
  {
2036
2528
  "kind": "Property",
2037
2529
  "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#agents:member",
@@ -2044,7 +2536,7 @@
2044
2536
  {
2045
2537
  "kind": "Reference",
2046
2538
  "text": "AgentConfig",
2047
- "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:interface"
2539
+ "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type"
2048
2540
  },
2049
2541
  {
2050
2542
  "kind": "Content",
@@ -2367,12 +2859,12 @@
2367
2859
  },
2368
2860
  {
2369
2861
  "kind": "Method",
2370
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#downloadHistory:member(1)",
2862
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#downloadDebugLog:member(1)",
2371
2863
  "docComment": "",
2372
2864
  "excerptTokens": [
2373
2865
  {
2374
2866
  "kind": "Content",
2375
- "text": "downloadHistory(): "
2867
+ "text": "downloadDebugLog(): "
2376
2868
  },
2377
2869
  {
2378
2870
  "kind": "Content",
@@ -2394,7 +2886,7 @@
2394
2886
  "parameters": [],
2395
2887
  "isOptional": false,
2396
2888
  "isAbstract": false,
2397
- "name": "downloadHistory"
2889
+ "name": "downloadDebugLog"
2398
2890
  },
2399
2891
  {
2400
2892
  "kind": "Property",
@@ -2431,6 +2923,64 @@
2431
2923
  "isProtected": false,
2432
2924
  "isAbstract": false
2433
2925
  },
2926
+ {
2927
+ "kind": "Method",
2928
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#getDebugLog:member(1)",
2929
+ "docComment": "",
2930
+ "excerptTokens": [
2931
+ {
2932
+ "kind": "Content",
2933
+ "text": "getDebugLog(): "
2934
+ },
2935
+ {
2936
+ "kind": "Content",
2937
+ "text": "{\n messages: readonly "
2938
+ },
2939
+ {
2940
+ "kind": "Reference",
2941
+ "text": "ChatMessage",
2942
+ "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
2943
+ },
2944
+ {
2945
+ "kind": "Content",
2946
+ "text": "[];\n agentSummary: "
2947
+ },
2948
+ {
2949
+ "kind": "Reference",
2950
+ "text": "AgentConfig",
2951
+ "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type"
2952
+ },
2953
+ {
2954
+ "kind": "Content",
2955
+ "text": "[];\n host: string;\n activeSystemPrompt: string;\n activePrimerHistory: "
2956
+ },
2957
+ {
2958
+ "kind": "Reference",
2959
+ "text": "ChatMessage",
2960
+ "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
2961
+ },
2962
+ {
2963
+ "kind": "Content",
2964
+ "text": "[];\n debug: unknown;\n }"
2965
+ },
2966
+ {
2967
+ "kind": "Content",
2968
+ "text": ";"
2969
+ }
2970
+ ],
2971
+ "isStatic": false,
2972
+ "returnTypeTokenRange": {
2973
+ "startIndex": 1,
2974
+ "endIndex": 8
2975
+ },
2976
+ "releaseTag": "Beta",
2977
+ "isProtected": false,
2978
+ "overloadIndex": 1,
2979
+ "parameters": [],
2980
+ "isOptional": false,
2981
+ "isAbstract": false,
2982
+ "name": "getDebugLog"
2983
+ },
2434
2984
  {
2435
2985
  "kind": "Method",
2436
2986
  "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#handleFileSelect:member(1)",
@@ -3025,26 +3575,238 @@
3025
3575
  "overloadIndex": 1,
3026
3576
  "parameters": [
3027
3577
  {
3028
- "parameterName": "animations",
3029
- "parameterTypeTokenRange": {
3030
- "startIndex": 1,
3031
- "endIndex": 3
3032
- },
3033
- "isOptional": false
3578
+ "parameterName": "animations",
3579
+ "parameterTypeTokenRange": {
3580
+ "startIndex": 1,
3581
+ "endIndex": 3
3582
+ },
3583
+ "isOptional": false
3584
+ }
3585
+ ],
3586
+ "isOptional": false,
3587
+ "isAbstract": false,
3588
+ "name": "setEnabledAnimations"
3589
+ },
3590
+ {
3591
+ "kind": "Property",
3592
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#settingsOpen:member",
3593
+ "docComment": "/**\n * Whether the settings panel is open.\n */\n",
3594
+ "excerptTokens": [
3595
+ {
3596
+ "kind": "Content",
3597
+ "text": "settingsOpen: "
3598
+ },
3599
+ {
3600
+ "kind": "Content",
3601
+ "text": "boolean"
3602
+ },
3603
+ {
3604
+ "kind": "Content",
3605
+ "text": ";"
3606
+ }
3607
+ ],
3608
+ "isReadonly": false,
3609
+ "isOptional": false,
3610
+ "releaseTag": "Beta",
3611
+ "name": "settingsOpen",
3612
+ "propertyTypeTokenRange": {
3613
+ "startIndex": 1,
3614
+ "endIndex": 2
3615
+ },
3616
+ "isStatic": false,
3617
+ "isProtected": false,
3618
+ "isAbstract": false
3619
+ },
3620
+ {
3621
+ "kind": "Property",
3622
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showAgentSwitchIndicator:member",
3623
+ "docComment": "/**\n * Current user-facing toggle state for agent switch indicator visibility.\n */\n",
3624
+ "excerptTokens": [
3625
+ {
3626
+ "kind": "Content",
3627
+ "text": "showAgentSwitchIndicator: "
3628
+ },
3629
+ {
3630
+ "kind": "Content",
3631
+ "text": "boolean"
3632
+ },
3633
+ {
3634
+ "kind": "Content",
3635
+ "text": ";"
3636
+ }
3637
+ ],
3638
+ "isReadonly": false,
3639
+ "isOptional": false,
3640
+ "releaseTag": "Beta",
3641
+ "name": "showAgentSwitchIndicator",
3642
+ "propertyTypeTokenRange": {
3643
+ "startIndex": 1,
3644
+ "endIndex": 2
3645
+ },
3646
+ "isStatic": false,
3647
+ "isProtected": false,
3648
+ "isAbstract": false
3649
+ },
3650
+ {
3651
+ "kind": "Property",
3652
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showHalo:member",
3653
+ "docComment": "",
3654
+ "excerptTokens": [
3655
+ {
3656
+ "kind": "Content",
3657
+ "text": "showHalo: "
3658
+ },
3659
+ {
3660
+ "kind": "Content",
3661
+ "text": "'no' | 'orchestrating' | 'agent'"
3662
+ },
3663
+ {
3664
+ "kind": "Content",
3665
+ "text": ";"
3666
+ }
3667
+ ],
3668
+ "isReadonly": false,
3669
+ "isOptional": false,
3670
+ "releaseTag": "Beta",
3671
+ "name": "showHalo",
3672
+ "propertyTypeTokenRange": {
3673
+ "startIndex": 1,
3674
+ "endIndex": 2
3675
+ },
3676
+ "isStatic": false,
3677
+ "isProtected": false,
3678
+ "isAbstract": false
3679
+ },
3680
+ {
3681
+ "kind": "Method",
3682
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showHaloChanged:member(1)",
3683
+ "docComment": "",
3684
+ "excerptTokens": [
3685
+ {
3686
+ "kind": "Content",
3687
+ "text": "showHaloChanged(): "
3688
+ },
3689
+ {
3690
+ "kind": "Content",
3691
+ "text": "void"
3692
+ },
3693
+ {
3694
+ "kind": "Content",
3695
+ "text": ";"
3696
+ }
3697
+ ],
3698
+ "isStatic": false,
3699
+ "returnTypeTokenRange": {
3700
+ "startIndex": 1,
3701
+ "endIndex": 2
3702
+ },
3703
+ "releaseTag": "Beta",
3704
+ "isProtected": false,
3705
+ "overloadIndex": 1,
3706
+ "parameters": [],
3707
+ "isOptional": false,
3708
+ "isAbstract": false,
3709
+ "name": "showHaloChanged"
3710
+ },
3711
+ {
3712
+ "kind": "Property",
3713
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showLoadingIndicator:member",
3714
+ "docComment": "/**\n * Whether the loading spinner is currently visible. Controlled by the loading delay timer.\n */\n",
3715
+ "excerptTokens": [
3716
+ {
3717
+ "kind": "Content",
3718
+ "text": "showLoadingIndicator: "
3719
+ },
3720
+ {
3721
+ "kind": "Content",
3722
+ "text": "boolean"
3723
+ },
3724
+ {
3725
+ "kind": "Content",
3726
+ "text": ";"
3727
+ }
3728
+ ],
3729
+ "isReadonly": false,
3730
+ "isOptional": false,
3731
+ "releaseTag": "Beta",
3732
+ "name": "showLoadingIndicator",
3733
+ "propertyTypeTokenRange": {
3734
+ "startIndex": 1,
3735
+ "endIndex": 2
3736
+ },
3737
+ "isStatic": false,
3738
+ "isProtected": false,
3739
+ "isAbstract": false
3740
+ },
3741
+ {
3742
+ "kind": "Method",
3743
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showLoadingIndicatorChanged:member(1)",
3744
+ "docComment": "",
3745
+ "excerptTokens": [
3746
+ {
3747
+ "kind": "Content",
3748
+ "text": "showLoadingIndicatorChanged(): "
3749
+ },
3750
+ {
3751
+ "kind": "Content",
3752
+ "text": "void"
3753
+ },
3754
+ {
3755
+ "kind": "Content",
3756
+ "text": ";"
3757
+ }
3758
+ ],
3759
+ "isStatic": false,
3760
+ "returnTypeTokenRange": {
3761
+ "startIndex": 1,
3762
+ "endIndex": 2
3763
+ },
3764
+ "releaseTag": "Beta",
3765
+ "isProtected": false,
3766
+ "overloadIndex": 1,
3767
+ "parameters": [],
3768
+ "isOptional": false,
3769
+ "isAbstract": false,
3770
+ "name": "showLoadingIndicatorChanged"
3771
+ },
3772
+ {
3773
+ "kind": "Property",
3774
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showThinkingSteps:member",
3775
+ "docComment": "/**\n * Current user-facing toggle state for thinking step visibility.\n */\n",
3776
+ "excerptTokens": [
3777
+ {
3778
+ "kind": "Content",
3779
+ "text": "showThinkingSteps: "
3780
+ },
3781
+ {
3782
+ "kind": "Content",
3783
+ "text": "boolean"
3784
+ },
3785
+ {
3786
+ "kind": "Content",
3787
+ "text": ";"
3034
3788
  }
3035
3789
  ],
3790
+ "isReadonly": false,
3036
3791
  "isOptional": false,
3037
- "isAbstract": false,
3038
- "name": "setEnabledAnimations"
3792
+ "releaseTag": "Beta",
3793
+ "name": "showThinkingSteps",
3794
+ "propertyTypeTokenRange": {
3795
+ "startIndex": 1,
3796
+ "endIndex": 2
3797
+ },
3798
+ "isStatic": false,
3799
+ "isProtected": false,
3800
+ "isAbstract": false
3039
3801
  },
3040
3802
  {
3041
3803
  "kind": "Property",
3042
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#settingsOpen:member",
3043
- "docComment": "/**\n * Whether the settings panel is open.\n */\n",
3804
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showToolCalls:member",
3805
+ "docComment": "/**\n * Current user-facing toggle state for tool call visibility.\n */\n",
3044
3806
  "excerptTokens": [
3045
3807
  {
3046
3808
  "kind": "Content",
3047
- "text": "settingsOpen: "
3809
+ "text": "showToolCalls: "
3048
3810
  },
3049
3811
  {
3050
3812
  "kind": "Content",
@@ -3058,7 +3820,7 @@
3058
3820
  "isReadonly": false,
3059
3821
  "isOptional": false,
3060
3822
  "releaseTag": "Beta",
3061
- "name": "settingsOpen",
3823
+ "name": "showToolCalls",
3062
3824
  "propertyTypeTokenRange": {
3063
3825
  "startIndex": 1,
3064
3826
  "endIndex": 2
@@ -3069,16 +3831,17 @@
3069
3831
  },
3070
3832
  {
3071
3833
  "kind": "Property",
3072
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showHalo:member",
3073
- "docComment": "/**\n * Whether the halo animation should be shown. True when the AI is actively computing (loading state, no pending interaction).\n */\n",
3834
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#state:member",
3835
+ "docComment": "",
3074
3836
  "excerptTokens": [
3075
3837
  {
3076
3838
  "kind": "Content",
3077
- "text": "showHalo: "
3839
+ "text": "state: "
3078
3840
  },
3079
3841
  {
3080
- "kind": "Content",
3081
- "text": "boolean"
3842
+ "kind": "Reference",
3843
+ "text": "AiAssistantState",
3844
+ "canonicalReference": "@genesislcap/ai-assistant!AiAssistantState:type"
3082
3845
  },
3083
3846
  {
3084
3847
  "kind": "Content",
@@ -3088,7 +3851,7 @@
3088
3851
  "isReadonly": false,
3089
3852
  "isOptional": false,
3090
3853
  "releaseTag": "Beta",
3091
- "name": "showHalo",
3854
+ "name": "state",
3092
3855
  "propertyTypeTokenRange": {
3093
3856
  "startIndex": 1,
3094
3857
  "endIndex": 2
@@ -3099,12 +3862,12 @@
3099
3862
  },
3100
3863
  {
3101
3864
  "kind": "Method",
3102
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showHaloChanged:member(1)",
3865
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#stateChanged:member(1)",
3103
3866
  "docComment": "",
3104
3867
  "excerptTokens": [
3105
3868
  {
3106
3869
  "kind": "Content",
3107
- "text": "showHaloChanged(): "
3870
+ "text": "stateChanged(): "
3108
3871
  },
3109
3872
  {
3110
3873
  "kind": "Content",
@@ -3126,46 +3889,47 @@
3126
3889
  "parameters": [],
3127
3890
  "isOptional": false,
3128
3891
  "isAbstract": false,
3129
- "name": "showHaloChanged"
3892
+ "name": "stateChanged"
3130
3893
  },
3131
3894
  {
3132
- "kind": "Property",
3133
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showLoadingIndicator:member",
3134
- "docComment": "/**\n * Whether the loading spinner is currently visible. Controlled by the loading delay timer.\n */\n",
3895
+ "kind": "Method",
3896
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#toggleSettings:member(1)",
3897
+ "docComment": "",
3135
3898
  "excerptTokens": [
3136
3899
  {
3137
3900
  "kind": "Content",
3138
- "text": "showLoadingIndicator: "
3901
+ "text": "toggleSettings(): "
3139
3902
  },
3140
3903
  {
3141
3904
  "kind": "Content",
3142
- "text": "boolean"
3905
+ "text": "void"
3143
3906
  },
3144
3907
  {
3145
3908
  "kind": "Content",
3146
3909
  "text": ";"
3147
3910
  }
3148
3911
  ],
3149
- "isReadonly": false,
3150
- "isOptional": false,
3151
- "releaseTag": "Beta",
3152
- "name": "showLoadingIndicator",
3153
- "propertyTypeTokenRange": {
3912
+ "isStatic": false,
3913
+ "returnTypeTokenRange": {
3154
3914
  "startIndex": 1,
3155
3915
  "endIndex": 2
3156
3916
  },
3157
- "isStatic": false,
3917
+ "releaseTag": "Beta",
3158
3918
  "isProtected": false,
3159
- "isAbstract": false
3919
+ "overloadIndex": 1,
3920
+ "parameters": [],
3921
+ "isOptional": false,
3922
+ "isAbstract": false,
3923
+ "name": "toggleSettings"
3160
3924
  },
3161
3925
  {
3162
3926
  "kind": "Method",
3163
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showLoadingIndicatorChanged:member(1)",
3927
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#toggleShowAgentSwitchIndicator:member(1)",
3164
3928
  "docComment": "",
3165
3929
  "excerptTokens": [
3166
3930
  {
3167
3931
  "kind": "Content",
3168
- "text": "showLoadingIndicatorChanged(): "
3932
+ "text": "toggleShowAgentSwitchIndicator(): "
3169
3933
  },
3170
3934
  {
3171
3935
  "kind": "Content",
@@ -3187,81 +3951,180 @@
3187
3951
  "parameters": [],
3188
3952
  "isOptional": false,
3189
3953
  "isAbstract": false,
3190
- "name": "showLoadingIndicatorChanged"
3954
+ "name": "toggleShowAgentSwitchIndicator"
3191
3955
  },
3192
3956
  {
3193
- "kind": "Property",
3194
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showThinkingSteps:member",
3195
- "docComment": "/**\n * Current user-facing toggle state for thinking step visibility.\n */\n",
3957
+ "kind": "Method",
3958
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#toggleShowThinkingSteps:member(1)",
3959
+ "docComment": "",
3196
3960
  "excerptTokens": [
3197
3961
  {
3198
3962
  "kind": "Content",
3199
- "text": "showThinkingSteps: "
3963
+ "text": "toggleShowThinkingSteps(): "
3200
3964
  },
3201
3965
  {
3202
3966
  "kind": "Content",
3203
- "text": "boolean"
3967
+ "text": "void"
3204
3968
  },
3205
3969
  {
3206
3970
  "kind": "Content",
3207
3971
  "text": ";"
3208
3972
  }
3209
3973
  ],
3210
- "isReadonly": false,
3211
- "isOptional": false,
3974
+ "isStatic": false,
3975
+ "returnTypeTokenRange": {
3976
+ "startIndex": 1,
3977
+ "endIndex": 2
3978
+ },
3212
3979
  "releaseTag": "Beta",
3213
- "name": "showThinkingSteps",
3214
- "propertyTypeTokenRange": {
3980
+ "isProtected": false,
3981
+ "overloadIndex": 1,
3982
+ "parameters": [],
3983
+ "isOptional": false,
3984
+ "isAbstract": false,
3985
+ "name": "toggleShowThinkingSteps"
3986
+ },
3987
+ {
3988
+ "kind": "Method",
3989
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#toggleShowToolCalls:member(1)",
3990
+ "docComment": "",
3991
+ "excerptTokens": [
3992
+ {
3993
+ "kind": "Content",
3994
+ "text": "toggleShowToolCalls(): "
3995
+ },
3996
+ {
3997
+ "kind": "Content",
3998
+ "text": "void"
3999
+ },
4000
+ {
4001
+ "kind": "Content",
4002
+ "text": ";"
4003
+ }
4004
+ ],
4005
+ "isStatic": false,
4006
+ "returnTypeTokenRange": {
3215
4007
  "startIndex": 1,
3216
4008
  "endIndex": 2
3217
4009
  },
4010
+ "releaseTag": "Beta",
4011
+ "isProtected": false,
4012
+ "overloadIndex": 1,
4013
+ "parameters": [],
4014
+ "isOptional": false,
4015
+ "isAbstract": false,
4016
+ "name": "toggleShowToolCalls"
4017
+ },
4018
+ {
4019
+ "kind": "Method",
4020
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#triggerFileInput:member(1)",
4021
+ "docComment": "",
4022
+ "excerptTokens": [
4023
+ {
4024
+ "kind": "Content",
4025
+ "text": "triggerFileInput(): "
4026
+ },
4027
+ {
4028
+ "kind": "Content",
4029
+ "text": "void"
4030
+ },
4031
+ {
4032
+ "kind": "Content",
4033
+ "text": ";"
4034
+ }
4035
+ ],
3218
4036
  "isStatic": false,
4037
+ "returnTypeTokenRange": {
4038
+ "startIndex": 1,
4039
+ "endIndex": 2
4040
+ },
4041
+ "releaseTag": "Beta",
3219
4042
  "isProtected": false,
3220
- "isAbstract": false
4043
+ "overloadIndex": 1,
4044
+ "parameters": [],
4045
+ "isOptional": false,
4046
+ "isAbstract": false,
4047
+ "name": "triggerFileInput"
3221
4048
  },
3222
4049
  {
3223
4050
  "kind": "Property",
3224
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showToolCalls:member",
3225
- "docComment": "/**\n * Current user-facing toggle state for tool call visibility.\n */\n",
4051
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#visibleMessages:member",
4052
+ "docComment": "/**\n * Messages filtered by the current toggle state. Tool-related messages (those with toolCalls or toolResult) are hidden when `showToolCalls` is false.\n */\n",
3226
4053
  "excerptTokens": [
3227
4054
  {
3228
4055
  "kind": "Content",
3229
- "text": "showToolCalls: "
4056
+ "text": "get visibleMessages(): "
4057
+ },
4058
+ {
4059
+ "kind": "Reference",
4060
+ "text": "ChatMessage",
4061
+ "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
3230
4062
  },
3231
4063
  {
3232
4064
  "kind": "Content",
3233
- "text": "boolean"
4065
+ "text": "[]"
3234
4066
  },
3235
4067
  {
3236
4068
  "kind": "Content",
3237
4069
  "text": ";"
3238
4070
  }
3239
4071
  ],
3240
- "isReadonly": false,
4072
+ "isReadonly": true,
3241
4073
  "isOptional": false,
3242
4074
  "releaseTag": "Beta",
3243
- "name": "showToolCalls",
4075
+ "name": "visibleMessages",
3244
4076
  "propertyTypeTokenRange": {
3245
4077
  "startIndex": 1,
3246
- "endIndex": 2
4078
+ "endIndex": 3
3247
4079
  },
3248
4080
  "isStatic": false,
3249
4081
  "isProtected": false,
3250
4082
  "isAbstract": false
4083
+ }
4084
+ ],
4085
+ "extendsTokenRange": {
4086
+ "startIndex": 1,
4087
+ "endIndex": 2
4088
+ },
4089
+ "implementsTokenRanges": []
4090
+ },
4091
+ {
4092
+ "kind": "Class",
4093
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager:class",
4094
+ "docComment": "/**\n * App-shell component that owns the pop-out/pop-in lifecycle for the AI assistant bubble.\n *\n * @remarks\n *\n * Place this in the persistent app shell, wrapping a `foundation-ai-chat-bubble` that contains an AI assistant element in the `dialog-content` slot. The component will auto-create a matching collapse-mode element for docking into pages, and will control the expand button visibility based on whether a dock provider is registered.\n *\n * Pages that support docking call `aiPopoutManager.registerDockProvider()` on mount and `aiPopoutManager.deregisterDockProvider()` on unmount.\n *\n * @example\n * ```html\n * <foundation-ai-popout-manager>\n * <foundation-ai-chat-bubble title=\"My Assistant\">\n * <my-assistant slot=\"dialog-content\"></my-assistant>\n * </foundation-ai-chat-bubble>\n * </foundation-ai-popout-manager>\n * ```\n *\n * @beta\n */\n",
4095
+ "excerptTokens": [
4096
+ {
4097
+ "kind": "Content",
4098
+ "text": "export declare class FoundationAiPopoutManager extends "
4099
+ },
4100
+ {
4101
+ "kind": "Reference",
4102
+ "text": "GenesisElement",
4103
+ "canonicalReference": "@microsoft/fast-element!FASTElement:interface"
3251
4104
  },
4105
+ {
4106
+ "kind": "Content",
4107
+ "text": " "
4108
+ }
4109
+ ],
4110
+ "fileUrlPath": "src/components/popout-manager/popout-manager.ts",
4111
+ "releaseTag": "Beta",
4112
+ "isAbstract": false,
4113
+ "name": "FoundationAiPopoutManager",
4114
+ "preserveMemberOrder": false,
4115
+ "members": [
3252
4116
  {
3253
4117
  "kind": "Property",
3254
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#state:member",
3255
- "docComment": "",
4118
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager#canDock:member",
4119
+ "docComment": "/**\n * True when a dock provider is registered — controls expand button visibility.\n */\n",
3256
4120
  "excerptTokens": [
3257
4121
  {
3258
4122
  "kind": "Content",
3259
- "text": "state: "
4123
+ "text": "canDock: "
3260
4124
  },
3261
4125
  {
3262
- "kind": "Reference",
3263
- "text": "AiAssistantState",
3264
- "canonicalReference": "@genesislcap/ai-assistant!AiAssistantState:type"
4126
+ "kind": "Content",
4127
+ "text": "boolean"
3265
4128
  },
3266
4129
  {
3267
4130
  "kind": "Content",
@@ -3271,7 +4134,7 @@
3271
4134
  "isReadonly": false,
3272
4135
  "isOptional": false,
3273
4136
  "releaseTag": "Beta",
3274
- "name": "state",
4137
+ "name": "canDock",
3275
4138
  "propertyTypeTokenRange": {
3276
4139
  "startIndex": 1,
3277
4140
  "endIndex": 2
@@ -3282,12 +4145,12 @@
3282
4145
  },
3283
4146
  {
3284
4147
  "kind": "Method",
3285
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#stateChanged:member(1)",
4148
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager#canDockChanged:member(1)",
3286
4149
  "docComment": "",
3287
4150
  "excerptTokens": [
3288
4151
  {
3289
4152
  "kind": "Content",
3290
- "text": "stateChanged(): "
4153
+ "text": "canDockChanged(): "
3291
4154
  },
3292
4155
  {
3293
4156
  "kind": "Content",
@@ -3309,20 +4172,25 @@
3309
4172
  "parameters": [],
3310
4173
  "isOptional": false,
3311
4174
  "isAbstract": false,
3312
- "name": "stateChanged"
4175
+ "name": "canDockChanged"
3313
4176
  },
3314
4177
  {
3315
4178
  "kind": "Method",
3316
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#toggleSettings:member(1)",
3317
- "docComment": "",
4179
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager#collapseIfDocked:member(1)",
4180
+ "docComment": "/**\n * If the assistant is currently docked, collapses it back into the bubble. Await this in `onBeforeNavButtonClick` to ensure cleanup before navigation.\n */\n",
3318
4181
  "excerptTokens": [
3319
4182
  {
3320
4183
  "kind": "Content",
3321
- "text": "toggleSettings(): "
4184
+ "text": "collapseIfDocked(): "
4185
+ },
4186
+ {
4187
+ "kind": "Reference",
4188
+ "text": "Promise",
4189
+ "canonicalReference": "!Promise:interface"
3322
4190
  },
3323
4191
  {
3324
4192
  "kind": "Content",
3325
- "text": "void"
4193
+ "text": "<void>"
3326
4194
  },
3327
4195
  {
3328
4196
  "kind": "Content",
@@ -3332,7 +4200,7 @@
3332
4200
  "isStatic": false,
3333
4201
  "returnTypeTokenRange": {
3334
4202
  "startIndex": 1,
3335
- "endIndex": 2
4203
+ "endIndex": 3
3336
4204
  },
3337
4205
  "releaseTag": "Beta",
3338
4206
  "isProtected": false,
@@ -3340,16 +4208,16 @@
3340
4208
  "parameters": [],
3341
4209
  "isOptional": false,
3342
4210
  "isAbstract": false,
3343
- "name": "toggleSettings"
4211
+ "name": "collapseIfDocked"
3344
4212
  },
3345
4213
  {
3346
4214
  "kind": "Method",
3347
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#toggleShowThinkingSteps:member(1)",
4215
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager#connectedCallback:member(1)",
3348
4216
  "docComment": "",
3349
4217
  "excerptTokens": [
3350
4218
  {
3351
4219
  "kind": "Content",
3352
- "text": "toggleShowThinkingSteps(): "
4220
+ "text": "connectedCallback(): "
3353
4221
  },
3354
4222
  {
3355
4223
  "kind": "Content",
@@ -3371,16 +4239,16 @@
3371
4239
  "parameters": [],
3372
4240
  "isOptional": false,
3373
4241
  "isAbstract": false,
3374
- "name": "toggleShowThinkingSteps"
4242
+ "name": "connectedCallback"
3375
4243
  },
3376
4244
  {
3377
4245
  "kind": "Method",
3378
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#toggleShowToolCalls:member(1)",
4246
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager#deregisterDockProvider:member(1)",
3379
4247
  "docComment": "",
3380
4248
  "excerptTokens": [
3381
4249
  {
3382
4250
  "kind": "Content",
3383
- "text": "toggleShowToolCalls(): "
4251
+ "text": "deregisterDockProvider(): "
3384
4252
  },
3385
4253
  {
3386
4254
  "kind": "Content",
@@ -3402,16 +4270,16 @@
3402
4270
  "parameters": [],
3403
4271
  "isOptional": false,
3404
4272
  "isAbstract": false,
3405
- "name": "toggleShowToolCalls"
4273
+ "name": "deregisterDockProvider"
3406
4274
  },
3407
4275
  {
3408
4276
  "kind": "Method",
3409
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#triggerFileInput:member(1)",
4277
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager#disconnectedCallback:member(1)",
3410
4278
  "docComment": "",
3411
4279
  "excerptTokens": [
3412
4280
  {
3413
4281
  "kind": "Content",
3414
- "text": "triggerFileInput(): "
4282
+ "text": "disconnectedCallback(): "
3415
4283
  },
3416
4284
  {
3417
4285
  "kind": "Content",
@@ -3433,42 +4301,56 @@
3433
4301
  "parameters": [],
3434
4302
  "isOptional": false,
3435
4303
  "isAbstract": false,
3436
- "name": "triggerFileInput"
4304
+ "name": "disconnectedCallback"
3437
4305
  },
3438
4306
  {
3439
- "kind": "Property",
3440
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#visibleMessages:member",
3441
- "docComment": "/**\n * Messages filtered by the current toggle state. Tool-related messages (those with toolCalls or toolResult) are hidden when `showToolCalls` is false.\n */\n",
4307
+ "kind": "Method",
4308
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager#registerDockProvider:member(1)",
4309
+ "docComment": "",
3442
4310
  "excerptTokens": [
3443
4311
  {
3444
4312
  "kind": "Content",
3445
- "text": "get visibleMessages(): "
4313
+ "text": "registerDockProvider(provider: "
3446
4314
  },
3447
4315
  {
3448
4316
  "kind": "Reference",
3449
- "text": "ChatMessage",
3450
- "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
4317
+ "text": "AiDockProvider",
4318
+ "canonicalReference": "@genesislcap/ai-assistant!AiDockProvider:interface"
3451
4319
  },
3452
4320
  {
3453
4321
  "kind": "Content",
3454
- "text": "[]"
4322
+ "text": "): "
4323
+ },
4324
+ {
4325
+ "kind": "Content",
4326
+ "text": "void"
3455
4327
  },
3456
4328
  {
3457
4329
  "kind": "Content",
3458
4330
  "text": ";"
3459
4331
  }
3460
4332
  ],
3461
- "isReadonly": true,
3462
- "isOptional": false,
3463
- "releaseTag": "Beta",
3464
- "name": "visibleMessages",
3465
- "propertyTypeTokenRange": {
3466
- "startIndex": 1,
3467
- "endIndex": 3
3468
- },
3469
4333
  "isStatic": false,
4334
+ "returnTypeTokenRange": {
4335
+ "startIndex": 3,
4336
+ "endIndex": 4
4337
+ },
4338
+ "releaseTag": "Beta",
3470
4339
  "isProtected": false,
3471
- "isAbstract": false
4340
+ "overloadIndex": 1,
4341
+ "parameters": [
4342
+ {
4343
+ "parameterName": "provider",
4344
+ "parameterTypeTokenRange": {
4345
+ "startIndex": 1,
4346
+ "endIndex": 2
4347
+ },
4348
+ "isOptional": false
4349
+ }
4350
+ ],
4351
+ "isOptional": false,
4352
+ "isAbstract": false,
4353
+ "name": "registerDockProvider"
3472
4354
  }
3473
4355
  ],
3474
4356
  "extendsTokenRange": {
@@ -3477,100 +4359,219 @@
3477
4359
  },
3478
4360
  "implementsTokenRanges": []
3479
4361
  },
4362
+ {
4363
+ "kind": "Variable",
4364
+ "canonicalReference": "@genesislcap/ai-assistant!friendlyFallbackAgent:var",
4365
+ "docComment": "/**\n * A warm, conversational fallback agent. Acknowledges it can't help directly, explains what the available specialists can do, and invites the user to retry.\n *\n * The system prompt is generated at runtime by `OrchestratingDriver` from the specialist list — no manual authoring required.\n *\n * @beta\n */\n",
4366
+ "excerptTokens": [
4367
+ {
4368
+ "kind": "Content",
4369
+ "text": "friendlyFallbackAgent: "
4370
+ },
4371
+ {
4372
+ "kind": "Reference",
4373
+ "text": "FallbackAgentConfig",
4374
+ "canonicalReference": "@genesislcap/ai-assistant!FallbackAgentConfig:interface"
4375
+ }
4376
+ ],
4377
+ "fileUrlPath": "src/config/fallback-agents.ts",
4378
+ "isReadonly": true,
4379
+ "releaseTag": "Beta",
4380
+ "name": "friendlyFallbackAgent",
4381
+ "variableTypeTokenRange": {
4382
+ "startIndex": 1,
4383
+ "endIndex": 2
4384
+ }
4385
+ },
4386
+ {
4387
+ "kind": "Function",
4388
+ "canonicalReference": "@genesislcap/ai-assistant!getAiPopoutManager:function(1)",
4389
+ "docComment": "/**\n * Returns the active `FoundationAiPopoutManager` instance, or `undefined` if none is mounted. Import this in pages to call `registerDockProvider` / `deregisterDockProvider`.\n *\n * @beta\n */\n",
4390
+ "excerptTokens": [
4391
+ {
4392
+ "kind": "Content",
4393
+ "text": "export declare function getAiPopoutManager(): "
4394
+ },
4395
+ {
4396
+ "kind": "Reference",
4397
+ "text": "FoundationAiPopoutManager",
4398
+ "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager:class"
4399
+ },
4400
+ {
4401
+ "kind": "Content",
4402
+ "text": " | undefined"
4403
+ },
4404
+ {
4405
+ "kind": "Content",
4406
+ "text": ";"
4407
+ }
4408
+ ],
4409
+ "fileUrlPath": "src/components/popout-manager/popout-manager.ts",
4410
+ "returnTypeTokenRange": {
4411
+ "startIndex": 1,
4412
+ "endIndex": 3
4413
+ },
4414
+ "releaseTag": "Beta",
4415
+ "overloadIndex": 1,
4416
+ "parameters": [],
4417
+ "name": "getAiPopoutManager"
4418
+ },
3480
4419
  {
3481
4420
  "kind": "Class",
3482
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager:class",
3483
- "docComment": "/**\n * App-shell component that owns the pop-out/pop-in lifecycle for the AI assistant bubble.\n *\n * @remarks\n *\n * Place this in the persistent app shell, wrapping a `foundation-ai-chat-bubble` that contains an AI assistant element in the `dialog-content` slot. The component will auto-create a matching collapse-mode element for docking into pages, and will control the expand button visibility based on whether a dock provider is registered.\n *\n * Pages that support docking call `aiPopoutManager.registerDockProvider()` on mount and `aiPopoutManager.deregisterDockProvider()` on unmount.\n *\n * @example\n * ```html\n * <foundation-ai-popout-manager>\n * <foundation-ai-chat-bubble title=\"My Assistant\">\n * <my-assistant slot=\"dialog-content\"></my-assistant>\n * </foundation-ai-chat-bubble>\n * </foundation-ai-popout-manager>\n * ```\n *\n * @beta\n */\n",
4421
+ "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver:class",
4422
+ "docComment": "/**\n * Orchestrates multiple specialist agents. Sits between `FoundationAiAssistant` and `ChatDriver`, classifying each user message and routing it to the right specialist — each with its own focused system prompt, tools, and primer.\n *\n * @beta\n */\n",
3484
4423
  "excerptTokens": [
3485
4424
  {
3486
4425
  "kind": "Content",
3487
- "text": "export declare class FoundationAiPopoutManager extends "
4426
+ "text": "export declare class OrchestratingDriver extends "
3488
4427
  },
3489
4428
  {
3490
4429
  "kind": "Reference",
3491
- "text": "GenesisElement",
3492
- "canonicalReference": "@microsoft/fast-element!FASTElement:interface"
4430
+ "text": "EventTarget",
4431
+ "canonicalReference": "!EventTarget:interface"
4432
+ },
4433
+ {
4434
+ "kind": "Content",
4435
+ "text": " implements "
4436
+ },
4437
+ {
4438
+ "kind": "Reference",
4439
+ "text": "AiDriver",
4440
+ "canonicalReference": "@genesislcap/ai-assistant!AiDriver:interface"
3493
4441
  },
3494
4442
  {
3495
4443
  "kind": "Content",
3496
4444
  "text": " "
3497
4445
  }
3498
4446
  ],
3499
- "fileUrlPath": "src/components/popout-manager/popout-manager.ts",
4447
+ "fileUrlPath": "src/components/orchestrating-driver/orchestrating-driver.ts",
3500
4448
  "releaseTag": "Beta",
3501
4449
  "isAbstract": false,
3502
- "name": "FoundationAiPopoutManager",
4450
+ "name": "OrchestratingDriver",
3503
4451
  "preserveMemberOrder": false,
3504
4452
  "members": [
3505
4453
  {
3506
- "kind": "Property",
3507
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager#canDock:member",
3508
- "docComment": "/**\n * True when a dock provider is registered — controls expand button visibility.\n */\n",
4454
+ "kind": "Constructor",
4455
+ "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver:constructor(1)",
4456
+ "docComment": "/**\n * Constructs a new instance of the `OrchestratingDriver` class\n */\n",
3509
4457
  "excerptTokens": [
3510
4458
  {
3511
4459
  "kind": "Content",
3512
- "text": "canDock: "
4460
+ "text": "constructor(aiProvider: "
4461
+ },
4462
+ {
4463
+ "kind": "Reference",
4464
+ "text": "AIProvider",
4465
+ "canonicalReference": "@genesislcap/foundation-ai!AIProvider:interface"
3513
4466
  },
3514
4467
  {
3515
4468
  "kind": "Content",
3516
- "text": "boolean"
4469
+ "text": ", agents: "
4470
+ },
4471
+ {
4472
+ "kind": "Reference",
4473
+ "text": "AgentConfig",
4474
+ "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type"
3517
4475
  },
3518
4476
  {
3519
4477
  "kind": "Content",
3520
- "text": ";"
4478
+ "text": "[]"
4479
+ },
4480
+ {
4481
+ "kind": "Content",
4482
+ "text": ", options?: "
4483
+ },
4484
+ {
4485
+ "kind": "Content",
4486
+ "text": "{\n maxHandoffs?: number;\n classifierHistoryLength?: number;\n classifierRetries?: number;\n maxToolIterations?: number;\n }"
4487
+ },
4488
+ {
4489
+ "kind": "Content",
4490
+ "text": ");"
3521
4491
  }
3522
4492
  ],
3523
- "isReadonly": false,
3524
- "isOptional": false,
3525
4493
  "releaseTag": "Beta",
3526
- "name": "canDock",
3527
- "propertyTypeTokenRange": {
3528
- "startIndex": 1,
3529
- "endIndex": 2
3530
- },
3531
- "isStatic": false,
3532
4494
  "isProtected": false,
3533
- "isAbstract": false
4495
+ "overloadIndex": 1,
4496
+ "parameters": [
4497
+ {
4498
+ "parameterName": "aiProvider",
4499
+ "parameterTypeTokenRange": {
4500
+ "startIndex": 1,
4501
+ "endIndex": 2
4502
+ },
4503
+ "isOptional": false
4504
+ },
4505
+ {
4506
+ "parameterName": "agents",
4507
+ "parameterTypeTokenRange": {
4508
+ "startIndex": 3,
4509
+ "endIndex": 5
4510
+ },
4511
+ "isOptional": false
4512
+ },
4513
+ {
4514
+ "parameterName": "options",
4515
+ "parameterTypeTokenRange": {
4516
+ "startIndex": 6,
4517
+ "endIndex": 7
4518
+ },
4519
+ "isOptional": true
4520
+ }
4521
+ ]
3534
4522
  },
3535
4523
  {
3536
- "kind": "Method",
3537
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager#canDockChanged:member(1)",
4524
+ "kind": "Property",
4525
+ "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#activeAgent:member",
3538
4526
  "docComment": "",
3539
4527
  "excerptTokens": [
3540
4528
  {
3541
4529
  "kind": "Content",
3542
- "text": "canDockChanged(): "
4530
+ "text": "activeAgent?: "
3543
4531
  },
3544
4532
  {
3545
- "kind": "Content",
3546
- "text": "void"
4533
+ "kind": "Reference",
4534
+ "text": "AgentConfig",
4535
+ "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type"
3547
4536
  },
3548
4537
  {
3549
4538
  "kind": "Content",
3550
4539
  "text": ";"
3551
4540
  }
3552
4541
  ],
3553
- "isStatic": false,
3554
- "returnTypeTokenRange": {
4542
+ "isReadonly": false,
4543
+ "isOptional": true,
4544
+ "releaseTag": "Beta",
4545
+ "name": "activeAgent",
4546
+ "propertyTypeTokenRange": {
3555
4547
  "startIndex": 1,
3556
4548
  "endIndex": 2
3557
4549
  },
3558
- "releaseTag": "Beta",
4550
+ "isStatic": false,
3559
4551
  "isProtected": false,
3560
- "overloadIndex": 1,
3561
- "parameters": [],
3562
- "isOptional": false,
3563
- "isAbstract": false,
3564
- "name": "canDockChanged"
4552
+ "isAbstract": false
3565
4553
  },
3566
4554
  {
3567
4555
  "kind": "Method",
3568
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager#collapseIfDocked:member(1)",
3569
- "docComment": "/**\n * If the assistant is currently docked, collapses it back into the bubble. Await this in `onBeforeNavButtonClick` to ensure cleanup before navigation.\n */\n",
4556
+ "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#continueFromHistory:member(1)",
4557
+ "docComment": "",
3570
4558
  "excerptTokens": [
3571
4559
  {
3572
4560
  "kind": "Content",
3573
- "text": "collapseIfDocked(): "
4561
+ "text": "continueFromHistory(transientPrimer?: "
4562
+ },
4563
+ {
4564
+ "kind": "Reference",
4565
+ "text": "ChatMessage",
4566
+ "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
4567
+ },
4568
+ {
4569
+ "kind": "Content",
4570
+ "text": "[]"
4571
+ },
4572
+ {
4573
+ "kind": "Content",
4574
+ "text": "): "
3574
4575
  },
3575
4576
  {
3576
4577
  "kind": "Reference",
@@ -3579,7 +4580,16 @@
3579
4580
  },
3580
4581
  {
3581
4582
  "kind": "Content",
3582
- "text": "<void>"
4583
+ "text": "<"
4584
+ },
4585
+ {
4586
+ "kind": "Reference",
4587
+ "text": "ChatDriverResult",
4588
+ "canonicalReference": "@genesislcap/foundation-ai!ChatDriverResult:type"
4589
+ },
4590
+ {
4591
+ "kind": "Content",
4592
+ "text": ">"
3583
4593
  },
3584
4594
  {
3585
4595
  "kind": "Content",
@@ -3588,29 +4598,47 @@
3588
4598
  ],
3589
4599
  "isStatic": false,
3590
4600
  "returnTypeTokenRange": {
3591
- "startIndex": 1,
3592
- "endIndex": 3
4601
+ "startIndex": 4,
4602
+ "endIndex": 8
3593
4603
  },
3594
4604
  "releaseTag": "Beta",
3595
4605
  "isProtected": false,
3596
4606
  "overloadIndex": 1,
3597
- "parameters": [],
4607
+ "parameters": [
4608
+ {
4609
+ "parameterName": "transientPrimer",
4610
+ "parameterTypeTokenRange": {
4611
+ "startIndex": 1,
4612
+ "endIndex": 3
4613
+ },
4614
+ "isOptional": true
4615
+ }
4616
+ ],
3598
4617
  "isOptional": false,
3599
4618
  "isAbstract": false,
3600
- "name": "collapseIfDocked"
4619
+ "name": "continueFromHistory"
3601
4620
  },
3602
4621
  {
3603
4622
  "kind": "Method",
3604
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager#connectedCallback:member(1)",
4623
+ "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#getRawHistory:member(1)",
3605
4624
  "docComment": "",
3606
4625
  "excerptTokens": [
3607
4626
  {
3608
4627
  "kind": "Content",
3609
- "text": "connectedCallback(): "
4628
+ "text": "getRawHistory(): "
4629
+ },
4630
+ {
4631
+ "kind": "Content",
4632
+ "text": "readonly "
4633
+ },
4634
+ {
4635
+ "kind": "Reference",
4636
+ "text": "ChatMessage",
4637
+ "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
3610
4638
  },
3611
4639
  {
3612
4640
  "kind": "Content",
3613
- "text": "void"
4641
+ "text": "[]"
3614
4642
  },
3615
4643
  {
3616
4644
  "kind": "Content",
@@ -3620,7 +4648,7 @@
3620
4648
  "isStatic": false,
3621
4649
  "returnTypeTokenRange": {
3622
4650
  "startIndex": 1,
3623
- "endIndex": 2
4651
+ "endIndex": 4
3624
4652
  },
3625
4653
  "releaseTag": "Beta",
3626
4654
  "isProtected": false,
@@ -3628,16 +4656,29 @@
3628
4656
  "parameters": [],
3629
4657
  "isOptional": false,
3630
4658
  "isAbstract": false,
3631
- "name": "connectedCallback"
4659
+ "name": "getRawHistory"
3632
4660
  },
3633
4661
  {
3634
4662
  "kind": "Method",
3635
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager#deregisterDockProvider:member(1)",
4663
+ "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#loadHistory:member(1)",
3636
4664
  "docComment": "",
3637
4665
  "excerptTokens": [
3638
4666
  {
3639
4667
  "kind": "Content",
3640
- "text": "deregisterDockProvider(): "
4668
+ "text": "loadHistory(messages: "
4669
+ },
4670
+ {
4671
+ "kind": "Reference",
4672
+ "text": "ChatMessage",
4673
+ "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
4674
+ },
4675
+ {
4676
+ "kind": "Content",
4677
+ "text": "[]"
4678
+ },
4679
+ {
4680
+ "kind": "Content",
4681
+ "text": "): "
3641
4682
  },
3642
4683
  {
3643
4684
  "kind": "Content",
@@ -3650,25 +4691,50 @@
3650
4691
  ],
3651
4692
  "isStatic": false,
3652
4693
  "returnTypeTokenRange": {
3653
- "startIndex": 1,
3654
- "endIndex": 2
4694
+ "startIndex": 4,
4695
+ "endIndex": 5
3655
4696
  },
3656
4697
  "releaseTag": "Beta",
3657
4698
  "isProtected": false,
3658
4699
  "overloadIndex": 1,
3659
- "parameters": [],
4700
+ "parameters": [
4701
+ {
4702
+ "parameterName": "messages",
4703
+ "parameterTypeTokenRange": {
4704
+ "startIndex": 1,
4705
+ "endIndex": 3
4706
+ },
4707
+ "isOptional": false
4708
+ }
4709
+ ],
3660
4710
  "isOptional": false,
3661
4711
  "isAbstract": false,
3662
- "name": "deregisterDockProvider"
4712
+ "name": "loadHistory"
3663
4713
  },
3664
4714
  {
3665
4715
  "kind": "Method",
3666
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager#disconnectedCallback:member(1)",
4716
+ "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#resolveInteraction:member(1)",
3667
4717
  "docComment": "",
3668
4718
  "excerptTokens": [
3669
4719
  {
3670
4720
  "kind": "Content",
3671
- "text": "disconnectedCallback(): "
4721
+ "text": "resolveInteraction(interactionId: "
4722
+ },
4723
+ {
4724
+ "kind": "Content",
4725
+ "text": "string"
4726
+ },
4727
+ {
4728
+ "kind": "Content",
4729
+ "text": ", result: "
4730
+ },
4731
+ {
4732
+ "kind": "Content",
4733
+ "text": "unknown"
4734
+ },
4735
+ {
4736
+ "kind": "Content",
4737
+ "text": "): "
3672
4738
  },
3673
4739
  {
3674
4740
  "kind": "Content",
@@ -3681,38 +4747,81 @@
3681
4747
  ],
3682
4748
  "isStatic": false,
3683
4749
  "returnTypeTokenRange": {
3684
- "startIndex": 1,
3685
- "endIndex": 2
4750
+ "startIndex": 5,
4751
+ "endIndex": 6
3686
4752
  },
3687
4753
  "releaseTag": "Beta",
3688
4754
  "isProtected": false,
3689
4755
  "overloadIndex": 1,
3690
- "parameters": [],
4756
+ "parameters": [
4757
+ {
4758
+ "parameterName": "interactionId",
4759
+ "parameterTypeTokenRange": {
4760
+ "startIndex": 1,
4761
+ "endIndex": 2
4762
+ },
4763
+ "isOptional": false
4764
+ },
4765
+ {
4766
+ "parameterName": "result",
4767
+ "parameterTypeTokenRange": {
4768
+ "startIndex": 3,
4769
+ "endIndex": 4
4770
+ },
4771
+ "isOptional": false
4772
+ }
4773
+ ],
3691
4774
  "isOptional": false,
3692
4775
  "isAbstract": false,
3693
- "name": "disconnectedCallback"
4776
+ "name": "resolveInteraction"
3694
4777
  },
3695
4778
  {
3696
4779
  "kind": "Method",
3697
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager#registerDockProvider:member(1)",
4780
+ "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#sendMessage:member(1)",
3698
4781
  "docComment": "",
3699
4782
  "excerptTokens": [
3700
4783
  {
3701
4784
  "kind": "Content",
3702
- "text": "registerDockProvider(provider: "
4785
+ "text": "sendMessage(input: "
4786
+ },
4787
+ {
4788
+ "kind": "Content",
4789
+ "text": "string"
4790
+ },
4791
+ {
4792
+ "kind": "Content",
4793
+ "text": ", attachments?: "
3703
4794
  },
3704
4795
  {
3705
4796
  "kind": "Reference",
3706
- "text": "AiDockProvider",
3707
- "canonicalReference": "@genesislcap/ai-assistant!AiDockProvider:interface"
4797
+ "text": "ChatAttachment",
4798
+ "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment:interface"
4799
+ },
4800
+ {
4801
+ "kind": "Content",
4802
+ "text": "[]"
3708
4803
  },
3709
4804
  {
3710
4805
  "kind": "Content",
3711
4806
  "text": "): "
3712
4807
  },
4808
+ {
4809
+ "kind": "Reference",
4810
+ "text": "Promise",
4811
+ "canonicalReference": "!Promise:interface"
4812
+ },
3713
4813
  {
3714
4814
  "kind": "Content",
3715
- "text": "void"
4815
+ "text": "<"
4816
+ },
4817
+ {
4818
+ "kind": "Reference",
4819
+ "text": "ChatDriverResult",
4820
+ "canonicalReference": "@genesislcap/foundation-ai!ChatDriverResult:type"
4821
+ },
4822
+ {
4823
+ "kind": "Content",
4824
+ "text": ">"
3716
4825
  },
3717
4826
  {
3718
4827
  "kind": "Content",
@@ -3721,88 +4830,205 @@
3721
4830
  ],
3722
4831
  "isStatic": false,
3723
4832
  "returnTypeTokenRange": {
3724
- "startIndex": 3,
3725
- "endIndex": 4
4833
+ "startIndex": 6,
4834
+ "endIndex": 10
3726
4835
  },
3727
4836
  "releaseTag": "Beta",
3728
4837
  "isProtected": false,
3729
4838
  "overloadIndex": 1,
3730
4839
  "parameters": [
3731
4840
  {
3732
- "parameterName": "provider",
4841
+ "parameterName": "input",
3733
4842
  "parameterTypeTokenRange": {
3734
4843
  "startIndex": 1,
3735
4844
  "endIndex": 2
3736
4845
  },
3737
4846
  "isOptional": false
4847
+ },
4848
+ {
4849
+ "parameterName": "attachments",
4850
+ "parameterTypeTokenRange": {
4851
+ "startIndex": 3,
4852
+ "endIndex": 5
4853
+ },
4854
+ "isOptional": true
3738
4855
  }
3739
4856
  ],
3740
4857
  "isOptional": false,
3741
4858
  "isAbstract": false,
3742
- "name": "registerDockProvider"
4859
+ "name": "sendMessage"
3743
4860
  }
3744
4861
  ],
3745
4862
  "extendsTokenRange": {
3746
4863
  "startIndex": 1,
3747
4864
  "endIndex": 2
3748
4865
  },
3749
- "implementsTokenRanges": []
4866
+ "implementsTokenRanges": [
4867
+ {
4868
+ "startIndex": 3,
4869
+ "endIndex": 4
4870
+ }
4871
+ ]
3750
4872
  },
3751
4873
  {
3752
- "kind": "Function",
3753
- "canonicalReference": "@genesislcap/ai-assistant!getAiPopoutManager:function(1)",
3754
- "docComment": "/**\n * Returns the active `FoundationAiPopoutManager` instance, or `undefined` if none is mounted. Import this in pages to call `registerDockProvider` / `deregisterDockProvider`.\n *\n * @beta\n */\n",
4874
+ "kind": "TypeAlias",
4875
+ "canonicalReference": "@genesislcap/ai-assistant!PopoutMode:type",
4876
+ "docComment": "/**\n * Controls the pop-out button shown in the assistant header. - `\"expand\"` — assistant is embedded in the bubble dialog; button expands it to a layout panel. - `\"collapse\"` — assistant is in a layout panel; button collapses it back to the bubble.\n *\n * @beta\n */\n",
3755
4877
  "excerptTokens": [
3756
4878
  {
3757
4879
  "kind": "Content",
3758
- "text": "export declare function getAiPopoutManager(): "
4880
+ "text": "export type PopoutMode = "
3759
4881
  },
3760
4882
  {
3761
- "kind": "Reference",
3762
- "text": "FoundationAiPopoutManager",
3763
- "canonicalReference": "@genesislcap/ai-assistant!FoundationAiPopoutManager:class"
4883
+ "kind": "Content",
4884
+ "text": "'expand' | 'collapse'"
3764
4885
  },
3765
4886
  {
3766
4887
  "kind": "Content",
3767
- "text": " | undefined"
4888
+ "text": ";"
4889
+ }
4890
+ ],
4891
+ "fileUrlPath": "src/main/main.types.ts",
4892
+ "releaseTag": "Beta",
4893
+ "name": "PopoutMode",
4894
+ "typeTokenRange": {
4895
+ "startIndex": 1,
4896
+ "endIndex": 2
4897
+ }
4898
+ },
4899
+ {
4900
+ "kind": "Variable",
4901
+ "canonicalReference": "@genesislcap/ai-assistant!REQUEST_CONTINUATION_TOOL:var",
4902
+ "docComment": "/**\n * Name reserved for the cross-agent handoff tool — injected by OrchestratingDriver.\n */\n",
4903
+ "excerptTokens": [
4904
+ {
4905
+ "kind": "Content",
4906
+ "text": "REQUEST_CONTINUATION_TOOL = "
3768
4907
  },
3769
4908
  {
3770
4909
  "kind": "Content",
3771
- "text": ";"
4910
+ "text": "\"request_continuation\""
3772
4911
  }
3773
4912
  ],
3774
- "fileUrlPath": "src/components/popout-manager/popout-manager.ts",
3775
- "returnTypeTokenRange": {
4913
+ "fileUrlPath": "src/components/chat-driver/chat-driver.ts",
4914
+ "initializerTokenRange": {
3776
4915
  "startIndex": 1,
3777
- "endIndex": 3
4916
+ "endIndex": 2
3778
4917
  },
3779
- "releaseTag": "Beta",
3780
- "overloadIndex": 1,
3781
- "parameters": [],
3782
- "name": "getAiPopoutManager"
4918
+ "isReadonly": true,
4919
+ "releaseTag": "Public",
4920
+ "name": "REQUEST_CONTINUATION_TOOL",
4921
+ "variableTypeTokenRange": {
4922
+ "startIndex": 0,
4923
+ "endIndex": 0
4924
+ }
3783
4925
  },
3784
4926
  {
3785
- "kind": "TypeAlias",
3786
- "canonicalReference": "@genesislcap/ai-assistant!PopoutMode:type",
3787
- "docComment": "/**\n * Controls the pop-out button shown in the assistant header. - `\"expand\"` — assistant is embedded in the bubble dialog; button expands it to a layout panel. - `\"collapse\"` — assistant is in a layout panel; button collapses it back to the bubble.\n *\n * @beta\n */\n",
4927
+ "kind": "Interface",
4928
+ "canonicalReference": "@genesislcap/ai-assistant!SpecialistAgentConfig:interface",
4929
+ "docComment": "/**\n * Configuration for a specialist agent.\n *\n * Specialist agents are offered to the classifier for intent routing. The `description` is used to auto-generate the classifier prompt — no manual routing prompt authoring required.\n *\n * @beta\n */\n",
3788
4930
  "excerptTokens": [
3789
4931
  {
3790
4932
  "kind": "Content",
3791
- "text": "export type PopoutMode = "
4933
+ "text": "export interface SpecialistAgentConfig extends "
4934
+ },
4935
+ {
4936
+ "kind": "Reference",
4937
+ "text": "BaseAgentConfig",
4938
+ "canonicalReference": "@genesislcap/ai-assistant!~BaseAgentConfig:interface"
3792
4939
  },
3793
4940
  {
3794
4941
  "kind": "Content",
3795
- "text": "'expand' | 'collapse'"
4942
+ "text": " "
4943
+ }
4944
+ ],
4945
+ "fileUrlPath": "src/config/config.ts",
4946
+ "releaseTag": "Beta",
4947
+ "name": "SpecialistAgentConfig",
4948
+ "preserveMemberOrder": false,
4949
+ "members": [
4950
+ {
4951
+ "kind": "PropertySignature",
4952
+ "canonicalReference": "@genesislcap/ai-assistant!SpecialistAgentConfig#description:member",
4953
+ "docComment": "/**\n * Plain-language description of what this agent handles. Used by the classifier to auto-generate its routing prompt.\n */\n",
4954
+ "excerptTokens": [
4955
+ {
4956
+ "kind": "Content",
4957
+ "text": "description: "
4958
+ },
4959
+ {
4960
+ "kind": "Content",
4961
+ "text": "string"
4962
+ },
4963
+ {
4964
+ "kind": "Content",
4965
+ "text": ";"
4966
+ }
4967
+ ],
4968
+ "isReadonly": false,
4969
+ "isOptional": false,
4970
+ "releaseTag": "Beta",
4971
+ "name": "description",
4972
+ "propertyTypeTokenRange": {
4973
+ "startIndex": 1,
4974
+ "endIndex": 2
4975
+ }
3796
4976
  },
4977
+ {
4978
+ "kind": "PropertySignature",
4979
+ "canonicalReference": "@genesislcap/ai-assistant!SpecialistAgentConfig#fallback:member",
4980
+ "docComment": "",
4981
+ "excerptTokens": [
4982
+ {
4983
+ "kind": "Content",
4984
+ "text": "fallback?: "
4985
+ },
4986
+ {
4987
+ "kind": "Content",
4988
+ "text": "never"
4989
+ },
4990
+ {
4991
+ "kind": "Content",
4992
+ "text": ";"
4993
+ }
4994
+ ],
4995
+ "isReadonly": false,
4996
+ "isOptional": true,
4997
+ "releaseTag": "Beta",
4998
+ "name": "fallback",
4999
+ "propertyTypeTokenRange": {
5000
+ "startIndex": 1,
5001
+ "endIndex": 2
5002
+ }
5003
+ }
5004
+ ],
5005
+ "extendsTokenRanges": [
5006
+ {
5007
+ "startIndex": 1,
5008
+ "endIndex": 2
5009
+ }
5010
+ ]
5011
+ },
5012
+ {
5013
+ "kind": "Variable",
5014
+ "canonicalReference": "@genesislcap/ai-assistant!strictFallbackAgent:var",
5015
+ "docComment": "/**\n * A brief, professional fallback agent. States what is available without elaboration. The `{{agents}}` placeholder is replaced at runtime by `OrchestratingDriver` with the generated specialist list.\n *\n * @beta\n */\n",
5016
+ "excerptTokens": [
3797
5017
  {
3798
5018
  "kind": "Content",
3799
- "text": ";"
5019
+ "text": "strictFallbackAgent: "
5020
+ },
5021
+ {
5022
+ "kind": "Reference",
5023
+ "text": "FallbackAgentConfig",
5024
+ "canonicalReference": "@genesislcap/ai-assistant!FallbackAgentConfig:interface"
3800
5025
  }
3801
5026
  ],
3802
- "fileUrlPath": "src/main/main.types.ts",
5027
+ "fileUrlPath": "src/config/fallback-agents.ts",
5028
+ "isReadonly": true,
3803
5029
  "releaseTag": "Beta",
3804
- "name": "PopoutMode",
3805
- "typeTokenRange": {
5030
+ "name": "strictFallbackAgent",
5031
+ "variableTypeTokenRange": {
3806
5032
  "startIndex": 1,
3807
5033
  "endIndex": 2
3808
5034
  }