@genesislcap/ai-assistant 14.409.0-FUI-2495.6 → 14.409.0-FUI-2495.7

package/dist/ai-assistant.api.json

@@ -937,6 +937,38 @@
                 "endIndex": 3
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiAssistantSerializedState#foldStack:member",
+              "docComment": "/**\n * Active fold stack at the time of serialization. Restored by the driver on `applyState` so the model has the correct tool set.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "foldStack?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "SerializedFoldFrame",
+                  "canonicalReference": "@genesislcap/ai-assistant!SerializedFoldFrame:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "foldStack",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiAssistantSerializedState#messages:member",
@@ -1950,6 +1982,14 @@
                   "kind": "Content",
                   "text": "number"
                 },
+                {
+                  "kind": "Content",
+                  "text": ", maxFoldOperations?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
                 {
                   "kind": "Content",
                   "text": ");"
@@ -2006,6 +2046,14 @@
                     "endIndex": 14
                   },
                   "isOptional": true
+                },
+                {
+                  "parameterName": "maxFoldOperations",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 15,
+                    "endIndex": 16
+                  },
+                  "isOptional": true
                 }
               ]
             },
@@ -2061,7 +2109,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#continueFromHistory:member(1)",
-              "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",
+              "docComment": "/**\n * Continue the tool loop from current history without appending a new user message. Used by OrchestratingDriver after an agent handoff.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -2125,6 +2173,42 @@
               "isAbstract": false,
               "name": "continueFromHistory"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getFoldStack:member(1)",
+              "docComment": "/**\n * Returns a serializable snapshot of the fold stack for pop-in/pop-out state transfer. Handler functions are omitted — they are re-resolved from agent config on restore.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getFoldStack(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "SerializedFoldFrame",
+                  "canonicalReference": "@genesislcap/ai-assistant!SerializedFoldFrame:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getFoldStack"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getHistory:member(1)",
@@ -2551,6 +2635,59 @@
               "isAbstract": false,
               "name": "resolveInteraction"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#restoreFoldStack:member(1)",
+              "docComment": "/**\n * Restores the fold stack from a serialized snapshot. Re-opens each fold in order so the driver has the correct tool set.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "restoreFoldStack(frames: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "SerializedFoldFrame",
+                  "canonicalReference": "@genesislcap/ai-assistant!SerializedFoldFrame:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 4,
+                "endIndex": 5
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "frames",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 3
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "restoreFoldStack"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#sendMessage:member(1)",
@@ -2761,6 +2898,142 @@
             "endIndex": 7
           }
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/ai-assistant!createToolFold:function(1)",
+          "docComment": "/**\n * Creates a tool fold — a facade that hides a group of related tools behind a single named entry, revealing them progressively when the model invokes the facade.\n *\n * The `tools` and `handlers` parameters accept the exact same types as `AgentConfig.toolDefinitions` and `AgentConfig.toolHandlers`, so existing tool creation functions can be passed in unchanged.\n *\n * @example\n * ```typescript\n * const tradingTools = createToolFold({\n *   name: 'trading_tools',\n *   tools: createTradesToolDefinitions(),\n *   handlers: createTradesToolHandlers(connect),\n * });\n *\n * const agent: AgentConfig = {\n *   name: 'Trades',\n *   systemPrompt: '...',\n *   toolDefinitions: [getCurrentDateDef, tradingTools.definition],\n *   toolHandlers: { get_current_date: handler, ...tradingTools.handler },\n * };\n * ```\n *\n * @example\n *\n * Nesting folds\n * ```typescript\n * const insertFold = createToolFold({\n *   name: 'trade_insertion',\n *   tools: [validateDef, insertDef],\n *   handlers: { validate_trade: vHandler, insert_trade: iHandler },\n * });\n *\n * const tradingFold = createToolFold({\n *   name: 'trading_tools',\n *   tools: [searchDef, insertFold.definition],\n *   handlers: { search_trades: sHandler, ...insertFold.handler },\n * });\n * ```\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function createToolFold(config: "
+            },
+            {
+              "kind": "Content",
+              "text": "{\n    name: string;\n    description?: string;\n    usageNotes?: string;\n    tools: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ChatToolDefinition",
+              "canonicalReference": "@genesislcap/foundation-ai!ChatToolDefinition:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "[];\n    handlers: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ChatToolHandlers",
+              "canonicalReference": "@genesislcap/foundation-ai!ChatToolHandlers:type"
+            },
+            {
+              "kind": "Content",
+              "text": ";\n    exclusive?: boolean;\n}"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "ToolFoldResult",
+              "canonicalReference": "@genesislcap/ai-assistant!ToolFoldResult:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/utils/tool-fold.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 7,
+            "endIndex": 8
+          },
+          "releaseTag": "Beta",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "config",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 6
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "createToolFold"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/ai-assistant!expandToolTree:function(1)",
+          "docComment": "/**\n * Expands a flat list of tool definitions into a nested tree by resolving fold metadata from the corresponding handlers. Use this for debug output so the full tool hierarchy is visible rather than just the top-level facade names.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function expandToolTree(definitions: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ChatToolDefinition",
+              "canonicalReference": "@genesislcap/foundation-ai!ChatToolDefinition:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "[]"
+            },
+            {
+              "kind": "Content",
+              "text": ", handlers: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ChatToolHandlers",
+              "canonicalReference": "@genesislcap/foundation-ai!ChatToolHandlers:type"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "ToolTreeNode",
+              "canonicalReference": "@genesislcap/ai-assistant!ToolTreeNode:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "[]"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/utils/tool-fold.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 6,
+            "endIndex": 8
+          },
+          "releaseTag": "Beta",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "definitions",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "handlers",
+              "parameterTypeTokenRange": {
+                "startIndex": 4,
+                "endIndex": 5
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "expandToolTree"
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@genesislcap/ai-assistant!FallbackAgentConfig:interface",
@@ -3176,6 +3449,66 @@
               "isAbstract": false,
               "name": "connectedCallback"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextLimit:member",
+              "docComment": "/**\n * Context window size for the active model, if known.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "contextLimit: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "contextLimit",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextTokens:member",
+              "docComment": "/**\n * Most recent prompt token count from the AI provider, if available.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "contextTokens: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "contextTokens",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugStateFactory:member",
@@ -3353,16 +3686,34 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "[];\n        agentSummary: "
+                  "text": "[];\n        meta: {\n            timestamp: string;\n            host: string;\n            agentSummary: ({\n                toolDefinitions: import(\"../utils/tool-fold\")."
                 },
                 {
                   "kind": "Reference",
-                  "text": "AgentConfig",
-                  "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type"
+                  "text": "ToolTreeNode",
+                  "canonicalReference": "@genesislcap/ai-assistant!ToolTreeNode:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[];\n                toolHandlers: any;\n                description: string;\n                fallback?: never;\n                name: string;\n                systemPrompt?: string;\n                primerHistory?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatMessage",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": "[];\n        host: string;\n        activeSystemPrompt: string;\n        activePrimerHistory: "
+                  "text": "[];\n            } | {\n                toolDefinitions: import(\"../utils/tool-fold\")."
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ToolTreeNode",
+                  "canonicalReference": "@genesislcap/ai-assistant!ToolTreeNode:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[];\n                toolHandlers: any;\n                fallback: true;\n                description?: never;\n                name: string;\n                systemPrompt?: string;\n                primerHistory?: "
                 },
                 {
                   "kind": "Reference",
@@ -3371,7 +3722,25 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "[];\n        debug: unknown;\n    }"
+                  "text": "[];\n            })[];\n            activeSystemPrompt: string;\n            activePrimerHistory: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatMessage",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[];\n            activeFoldStack: import(\"../channel/ai-activity-channel\")."
+                },
+                {
+                  "kind": "Reference",
+                  "text": "SerializedFoldFrame",
+                  "canonicalReference": "@genesislcap/ai-assistant!SerializedFoldFrame:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[];\n            debug: unknown;\n        };\n    }"
                 },
                 {
                   "kind": "Content",
@@ -3381,7 +3750,7 @@
               "isStatic": false,
               "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 8
+                "endIndex": 16
               },
               "releaseTag": "Beta",
               "isProtected": false,
@@ -5033,7 +5402,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "{\n        maxHandoffs?: number;\n        classifierHistoryLength?: number;\n        classifierRetries?: number;\n        maxToolIterations?: number;\n    }"
+                  "text": "{\n        maxHandoffs?: number;\n        classifierHistoryLength?: number;\n        classifierRetries?: number;\n        maxToolIterations?: number;\n        maxFoldOperations?: number;\n    }"
                 },
                 {
                   "kind": "Content",
@@ -5584,6 +5953,83 @@
             "endIndex": 0
           }
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!SerializedFoldFrame:interface",
+          "docComment": "/**\n * A single frame on the serialized fold stack. Handler functions are not serializable — they are re-resolved on restore by the driver walking the agent config's fold metadata.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface SerializedFoldFrame "
+            }
+          ],
+          "fileUrlPath": "src/channel/ai-activity-channel.ts",
+          "releaseTag": "Beta",
+          "name": "SerializedFoldFrame",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SerializedFoldFrame#foldName:member",
+              "docComment": "/**\n * Name of the fold that was opened at this level.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "foldName: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "foldName",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SerializedFoldFrame#previousDefinitions:member",
+              "docComment": "/**\n * Tool definitions that were active before this fold opened.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "previousDefinitions: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatToolDefinition",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatToolDefinition:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "previousDefinitions",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@genesislcap/ai-assistant!SpecialistAgentConfig:interface",
@@ -5719,6 +6165,144 @@
             "startIndex": 1,
             "endIndex": 2
           }
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!ToolFoldResult:interface",
+          "docComment": "/**\n * The value returned by `createToolFold`.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface ToolFoldResult "
+            }
+          ],
+          "fileUrlPath": "src/utils/tool-fold.ts",
+          "releaseTag": "Beta",
+          "name": "ToolFoldResult",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ToolFoldResult#definition:member",
+              "docComment": "/**\n * The facade tool definition. Add this to your agent's `toolDefinitions`. It is a regular `ChatToolDefinition` with an empty parameter schema.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "definition: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatToolDefinition",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatToolDefinition:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "definition",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ToolFoldResult#handler:member",
+              "docComment": "/**\n * The facade handler — a single-entry map keyed by the fold name. Spread this into your agent's `toolHandlers`. Inner tool handlers are NOT included here — they are encapsulated inside the fold metadata and installed by the driver only when the fold opens.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "handler: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatToolHandlers",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatToolHandlers:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "handler",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!ToolTreeNode:interface",
+          "docComment": "/**\n * A tool entry in the expanded debug tree. Folds are represented as nodes with a `tools` array; regular tools have none.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface ToolTreeNode extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "ChatToolDefinition",
+              "canonicalReference": "@genesislcap/foundation-ai!ChatToolDefinition:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " "
+            }
+          ],
+          "fileUrlPath": "src/utils/tool-fold.ts",
+          "releaseTag": "Beta",
+          "name": "ToolTreeNode",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ToolTreeNode#tools:member",
+              "docComment": "/**\n * Present when this tool is a fold — contains its inner tools recursively expanded.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "tools?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ToolTreeNode",
+                  "canonicalReference": "@genesislcap/ai-assistant!ToolTreeNode:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "tools",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            }
+          ],
+          "extendsTokenRanges": [
+            {
+              "startIndex": 1,
+              "endIndex": 2
+            }
+          ]
         }
       ]
     }