@genesislcap/ai-assistant 14.436.0 → 14.437.1

package/dist/ai-assistant.api.json

@@ -2430,8 +2430,8 @@
                 },
                 {
                   "kind": "Reference",
-                  "text": "ChatToolHandlers",
-                  "canonicalReference": "@genesislcap/foundation-ai!ChatToolHandlers:type"
+                  "text": "ToolHandlersInput",
+                  "canonicalReference": "@genesislcap/ai-assistant!ToolHandlersInput:type"
                 },
                 {
                   "kind": "Content",
@@ -3100,7 +3100,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#requestInteraction:member(1)",
-              "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 * If a host requester is wired (sub-agent case), the call delegates upward so the interaction lives on the parent — the main UI is only listening to the root driver. Only one interaction may be in flight at any time on a given root: concurrent calls (e.g. two parallel sub-agents both spawning a widget) throw. Parallel sub-agents are for parallel work, not for user interaction, which is inherently sequential.\n *\n * @param componentName - The custom element name to render.\n *\n * @param data - Data to pass to the component.\n */\n",
+              "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 * If a host requester is wired (sub-agent case), the call delegates upward so the interaction lives on the parent — the main UI is only listening to the root driver. Only one interaction may be in flight at any time on a given root: concurrent calls (e.g. two parallel sub-agents both spawning a widget) throw. Parallel sub-agents are for parallel work, not for user interaction, which is inherently sequential.\n *\n * @param componentName - The custom element name to render.\n *\n * @param data - Data to pass to the component.\n *\n * @param options - Optional per-call overrides, including `chatInputDuringExecution` to hide or disable the main chat input while the widget is awaiting user input. Reverts when the interaction resolves.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -3118,6 +3118,15 @@
                   "kind": "Content",
                   "text": "any"
                 },
+                {
+                  "kind": "Content",
+                  "text": ", options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "InteractionRequestOptions",
+                  "canonicalReference": "@genesislcap/foundation-ai!InteractionRequestOptions:interface"
+                },
                 {
                   "kind": "Content",
                   "text": "): "
@@ -3151,8 +3160,8 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 5,
-                "endIndex": 7
+                "startIndex": 7,
+                "endIndex": 9
               },
               "releaseTag": "Beta",
               "isProtected": false,
@@ -3173,6 +3182,14 @@
                     "endIndex": 4
                   },
                   "isOptional": false
+                },
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "isOptional": true
                 }
               ],
               "isOptional": false,
@@ -3337,7 +3354,16 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "<T>(componentName: string, data: any) => "
+                  "text": "<T>(componentName: string, data: any, options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "InteractionRequestOptions",
+                  "canonicalReference": "@genesislcap/foundation-ai!InteractionRequestOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ") => "
                 },
                 {
                   "kind": "Reference",
@@ -3363,8 +3389,8 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 5,
-                "endIndex": 6
+                "startIndex": 7,
+                "endIndex": 8
               },
               "releaseTag": "Beta",
               "isProtected": false,
@@ -3374,7 +3400,7 @@
                   "parameterName": "fn",
                   "parameterTypeTokenRange": {
                     "startIndex": 1,
-                    "endIndex": 4
+                    "endIndex": 6
                   },
                   "isOptional": false
                 }
@@ -4563,7 +4589,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#effectiveChatInputDuringExecution:member",
-              "docComment": "/**\n * Resolves the effective chat-input behaviour while the assistant is executing. Sub-agent overrides take precedence over the agent-level config; among overrides the most restrictive wins (`'hidden'` > `'disabled'`). Falls back to the active agent's config, then `'disabled'`.\n */\n",
+              "docComment": "/**\n * Resolves the effective chat-input behaviour while the assistant is executing. Per-call overrides take precedence over the agent-level config; among overrides the most restrictive wins (`'hidden'` > `'disabled'`). Falls back to the active agent's config, then `'disabled'`.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -4685,16 +4711,25 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "[];\n        meta: {\n            timestamp: string;\n            host: string;\n            agentSummary: ({\n                toolDefinitions: string | import(\"../utils/tool-fold\")."
+                  "text": "[];\n        meta: {\n            timestamp: string;\n            host: string;\n            agentSummary: ({\n                toolDefinitions: string | import(\"@genesislcap/foundation-ai\")."
                 },
                 {
                   "kind": "Reference",
-                  "text": "ToolTreeNode",
-                  "canonicalReference": "@genesislcap/ai-assistant!ToolTreeNode:interface"
+                  "text": "ChatToolDefinition",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatToolDefinition:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": "[];\n                toolHandlers: any;\n                onActivate: any;\n                onDeactivate: any;\n                getDebugSnapshot: any;\n                description: string;\n                fallback?: never;\n                excludeFromClassifier?: boolean;\n                name: string;\n                systemPrompt?: import(\"../config/config\")."
+                  "text": "[];\n                toolHandlers: any;\n                onActivate: any;\n                onDeactivate: any;\n                getDebugSnapshot: any;\n                description: string;\n                fallback?: never;\n                excludeFromClassifier?: boolean;\n                name: string;\n                displayName?: import(\"../config/config\")."
+                },
+                {
+                  "kind": "Reference",
+                  "text": "SystemPromptInput",
+                  "canonicalReference": "@genesislcap/ai-assistant!SystemPromptInput:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";\n                systemPrompt?: import(\"../config/config\")."
                 },
                 {
                   "kind": "Reference",
@@ -4739,16 +4774,25 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";\n            } | {\n                toolDefinitions: string | import(\"../utils/tool-fold\")."
+                  "text": ";\n            } | {\n                toolDefinitions: string | import(\"@genesislcap/foundation-ai\")."
                 },
                 {
                   "kind": "Reference",
-                  "text": "ToolTreeNode",
-                  "canonicalReference": "@genesislcap/ai-assistant!ToolTreeNode:interface"
+                  "text": "ChatToolDefinition",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatToolDefinition:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": "[];\n                toolHandlers: any;\n                onActivate: any;\n                onDeactivate: any;\n                getDebugSnapshot: any;\n                fallback: true;\n                description?: never;\n                name: string;\n                systemPrompt?: import(\"../config/config\")."
+                  "text": "[];\n                toolHandlers: any;\n                onActivate: any;\n                onDeactivate: any;\n                getDebugSnapshot: any;\n                fallback: true;\n                description?: never;\n                name: string;\n                displayName?: import(\"../config/config\")."
+                },
+                {
+                  "kind": "Reference",
+                  "text": "SystemPromptInput",
+                  "canonicalReference": "@genesislcap/ai-assistant!SystemPromptInput:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";\n                systemPrompt?: import(\"../config/config\")."
                 },
                 {
                   "kind": "Reference",
@@ -4821,7 +4865,7 @@
               "isStatic": false,
               "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 32
+                "endIndex": 36
               },
               "releaseTag": "Beta",
               "isProtected": false,
@@ -5129,6 +5173,45 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#inputOverrides:member",
+              "docComment": "/**\n * In-flight per-call chat-input overrides pushed by `requestSubAgent` or `requestInteraction` calls. Empty means no override is active.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get inputOverrides(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "import(\"../state/ai-assistant-slice\")."
+                },
+                {
+                  "kind": "Reference",
+                  "text": "InputOverride",
+                  "canonicalReference": "@genesislcap/ai-assistant!~InputOverride:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "inputOverrides",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 4
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#inputValue:member",
@@ -6125,45 +6208,6 @@
               "isProtected": false,
               "isAbstract": false
             },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#subAgentInputOverrides:member",
-              "docComment": "/**\n * In-flight per-call chat-input overrides pushed by `requestSubAgent` invocations. Empty means no override is active.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get subAgentInputOverrides(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "import(\"../state/ai-assistant-slice\")."
-                },
-                {
-                  "kind": "Reference",
-                  "text": "SubAgentInputOverride",
-                  "canonicalReference": "@genesislcap/ai-assistant!~SubAgentInputOverride:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": "[]"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "subAgentInputOverrides",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 4
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#suggestionsState:member",
@@ -7723,6 +7767,50 @@
             }
           ]
         },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@genesislcap/ai-assistant!StatefulAgentContext:type",
+          "docComment": "/**\n * Context passed to per-turn resolvers on a stateful agent — the standard {@link SystemPromptContext} plus the live `state` value. Used by `systemPrompt`, `displayName`, and the function form of `toolDefinitions`.\n *\n * Exported so consumers can lift resolvers into separate files without re-deriving the shape.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type StatefulAgentContext<S> = "
+            },
+            {
+              "kind": "Reference",
+              "text": "SystemPromptContext",
+              "canonicalReference": "@genesislcap/ai-assistant!SystemPromptContext:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " & {\n    state: S;\n}"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/config/define-stateful-agent.ts",
+          "releaseTag": "Beta",
+          "name": "StatefulAgentContext",
+          "typeParameters": [
+            {
+              "typeParameterName": "S",
+              "constraintTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              }
+            }
+          ],
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 3
+          }
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@genesislcap/ai-assistant!StatefulAgentInit:interface",
@@ -7806,6 +7894,51 @@
                 "endIndex": 2
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!StatefulAgentInit#displayName:member",
+              "docComment": "/**\n * Per-turn display label, e.g. \"Guided Booking (Counterparties)\". Resolved each tool-loop iteration and stamped onto outgoing messages and the debug-log timeline — display only. The agent's `name` stays as the canonical identity used for routing/history filtering.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "displayName?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(ctx: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "StatefulAgentContext",
+                  "canonicalReference": "@genesislcap/ai-assistant!StatefulAgentContext:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<S>) => string | "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "displayName",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 6
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!StatefulAgentInit#dispose:member",
@@ -8084,12 +8217,12 @@
                 },
                 {
                   "kind": "Reference",
-                  "text": "SystemPromptContext",
-                  "canonicalReference": "@genesislcap/ai-assistant!SystemPromptContext:interface"
+                  "text": "StatefulAgentContext",
+                  "canonicalReference": "@genesislcap/ai-assistant!StatefulAgentContext:type"
                 },
                 {
                   "kind": "Content",
-                  "text": " & {\n        state: S;\n    }) => string | "
+                  "text": "<S>) => string | "
                 },
                 {
                   "kind": "Reference",
@@ -8134,12 +8267,12 @@
                 },
                 {
                   "kind": "Reference",
-                  "text": "SystemPromptContext",
-                  "canonicalReference": "@genesislcap/ai-assistant!SystemPromptContext:interface"
+                  "text": "StatefulAgentContext",
+                  "canonicalReference": "@genesislcap/ai-assistant!StatefulAgentContext:type"
                 },
                 {
                   "kind": "Content",
-                  "text": " & {\n        state: S;\n    }) => "
+                  "text": "<S>) => "
                 },
                 {
                   "kind": "Reference",
@@ -8185,7 +8318,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!StatefulAgentInit#toolHandlers:member",
-              "docComment": "/**\n * Factory returning the tool handler map. Called with the live `state` at `onActivate` time; the handlers it returns are cached for the lifetime of this activation. Each handler closes over `state` and any other deps you captured.\n *\n * The handler set returned must be the **union** of every tool name your agent might advertise across all states — `toolDefinitions` filters which are visible to the LLM per turn, but every name still needs an entry here.\n */\n",
+              "docComment": "/**\n * Factory returning the handler map for the **current state**. Called each tool-loop iteration with the live `state` value, so the handler set the driver dispatches against matches what `toolDefinitions` exposes to the LLM that turn. Return only the handlers valid right now — no need to advertise every handler the agent might ever expose, and no defensive `if (!machine.matches(...))` guards inside each handler.\n *\n * Pair with the function form of `toolDefinitions` so the visible tools and the dispatchable handlers stay in lockstep.\n *\n * **Constraint:** resolved handlers must not include fold facades. Folds and state-machine-driven tool filtering both try to control the LLM's tool view — pick one. Helper samples once on activation (init state) and throws if a fold-tagged handler is detected; subsequent resolves also validate, so misuse on a non-init state surfaces when that state is reached.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -8200,6 +8333,28 @@
                   "text": "ChatToolHandlers",
                   "canonicalReference": "@genesislcap/foundation-ai!ChatToolHandlers:type"
                 },
+                {
+                  "kind": "Content",
+                  "text": " | "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatToolHandlers",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatToolHandlers:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
                 {
                   "kind": "Content",
                   "text": ";"
@@ -8211,7 +8366,7 @@
               "name": "toolHandlers",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 3
+                "endIndex": 8
               }
             }
           ],
@@ -8593,6 +8748,73 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@genesislcap/ai-assistant!ToolHandlersInput:type",
+          "docComment": "/**\n * Tool handlers for an agent. Either a static map (the conventional shape) or a function resolved each tool-loop iteration. The function form lets the agent narrow the dispatchable handler set per turn — pair it with the function form of `toolDefinitions` so the LLM-visible tools and the dispatchable handlers stay in lockstep, and handlers don't have to defend themselves against being dispatched in states where their tool isn't advertised.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type ToolHandlersInput = "
+            },
+            {
+              "kind": "Reference",
+              "text": "ChatToolHandlers",
+              "canonicalReference": "@genesislcap/foundation-ai!ChatToolHandlers:type"
+            },
+            {
+              "kind": "Content",
+              "text": " | ((ctx: "
+            },
+            {
+              "kind": "Reference",
+              "text": "SystemPromptContext",
+              "canonicalReference": "@genesislcap/ai-assistant!SystemPromptContext:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ") => "
+            },
+            {
+              "kind": "Reference",
+              "text": "ChatToolHandlers",
+              "canonicalReference": "@genesislcap/foundation-ai!ChatToolHandlers:type"
+            },
+            {
+              "kind": "Content",
+              "text": " | "
+            },
+            {
+              "kind": "Reference",
+              "text": "Promise",
+              "canonicalReference": "!Promise:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "ChatToolHandlers",
+              "canonicalReference": "@genesislcap/foundation-ai!ChatToolHandlers:type"
+            },
+            {
+              "kind": "Content",
+              "text": ">)"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/config/config.ts",
+          "releaseTag": "Beta",
+          "name": "ToolHandlersInput",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 11
+          }
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@genesislcap/ai-assistant!ToolTreeNode:interface",
@@ -8672,6 +8894,33 @@
           "name": "TurnSnapshot",
           "preserveMemberOrder": false,
           "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!TurnSnapshot#agentLabel:member",
+              "docComment": "/**\n * Per-turn display label resolved from the agent's `displayName`, e.g. \"Guided Booking (Counterparties)\". `agentName` stays as the canonical identity used for routing/filtering.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "agentLabel?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "agentLabel",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!TurnSnapshot#agentName:member",