@genesislcap/ai-assistant 15.84.3 → 15.85.0

package/dist/ai-assistant.api.json

@@ -2231,7 +2231,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@genesislcap/ai-assistant!AgentSession:class",
-          "docComment": "/**\n * The stateful-agent contract: which agent is active, whether a flow or a user pin holds routing, and the `onActivate` / `onDeactivate` lifecycle around a swap. Either driver can own one.\n *\n * Knows nothing about routing, tool surfaces or transcripts — whether an agent is terminal, the continuation tool, the handoff marker in history all stay with the orchestrator, which is the only thing with agents to route between.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * The stateful-agent contract: which agent is active, whether a flow or a user pin holds routing, and the `onActivate` / `onDeactivate` lifecycle around a swap. Either driver can own one.\n *\n * Knows nothing about routing, tool surfaces or transcripts — whether an agent is terminal, the hand-off stack, the divider in history all stay with the orchestrator, which is the only thing with agents to route between.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -2376,6 +2376,73 @@
               "isAbstract": false,
               "name": "dispose"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!AgentSession#dropFlowLock:member(1)",
+              "docComment": "/**\n * Drop the flow lock and leave the active agent active (GENC-1737): a plain agent holding it with no hand-off behind it is done once its turn ends.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "dropFlowLock(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "dropFlowLock"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!AgentSession#endSuspended:member(1)",
+              "docComment": "/**\n * Deactivate the callers left waiting by hand-offs that ended without a hand-back, newest first, when no teardown follows to do it (GENC-1737).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "endSuspended(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<void>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "endSuspended"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!AgentSession#getActive:member(1)",
@@ -2443,6 +2510,54 @@
               "isAbstract": false,
               "name": "getFlowOwner"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!AgentSession#getHandOffData:member(1)",
+              "docComment": "/**\n * The `data` of the hand-off that activated `agentName`, if one did and carried any.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getHandOffData(agentName: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "unknown"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "agentName",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getHandOffData"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!AgentSession#getLockedName:member(1)",
@@ -2522,6 +2637,125 @@
               "isAbstract": false,
               "name": "getPinned"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!AgentSession#getSuspended:member(1)",
+              "docComment": "/**\n * The callers waiting in a hand-off whose state is live, oldest first.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getSuspended(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "readonly "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AgentConfig",
+                  "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 4
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getSuspended"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!AgentSession#handOff:member(1)",
+              "docComment": "/**\n * Make `target` active for a hand-off (GENC-1737), holding the flow lock whatever kind of agent it is, since a waiting caller depends on it. With `suspendCaller` the active agent waits: it is not deactivated and keeps its state. Without it the active agent is deactivated as on any swap: a one-way hand-off from a target, whose waiting caller then waits for the new target. Queued with {@link AgentSession.activate}.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "handOff(target: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AgentConfig",
+                  "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", options: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "{\n        suspendCaller: boolean;\n    }"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AgentTransition",
+                  "canonicalReference": "@genesislcap/ai-assistant!AgentTransition:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 9
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "target",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "handOff"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!AgentSession#hasRestoredState:member(1)",
@@ -2668,6 +2902,85 @@
               "isAbstract": false,
               "name": "release"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!AgentSession#resume:member(1)",
+              "docComment": "/**\n * Make a waiting caller active again when its hand-off ends (GENC-1737). One whose state is live resumes without `onActivate`, since it was never deactivated; after a reload it is activated from its saved state like any other agent. `lock` keeps the flow lock on it: it held it before, or another caller is still waiting further down.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "resume(caller: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AgentConfig",
+                  "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", lock: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AgentTransition",
+                  "canonicalReference": "@genesislcap/ai-assistant!AgentTransition:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 9
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "caller",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "lock",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "resume"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!AgentSession#setFlowOwner:member(1)",
@@ -2716,6 +3029,70 @@
               "isAbstract": false,
               "name": "setFlowOwner"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!AgentSession#setHandOffData:member(1)",
+              "docComment": "/**\n * Record the `data` a hand-off activated `agentName` with, or restore it; `undefined` drops it.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "setHandOffData(agentName: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", data: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "unknown"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "agentName",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "data",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "setHandOffData"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!AgentSession#setPinned:member(1)",
@@ -3170,7 +3547,7 @@
             },
             {
               "kind": "Content",
-              "text": "{\n    readonly SessionCleared: \"session-cleared\";\n    readonly ChatHeaderMouseDown: \"chat-header-mousedown\";\n}"
+              "text": "{\n    readonly SessionCleared: \"session-cleared\";\n    readonly ChatHeaderMouseDown: \"chat-header-mousedown\";\n    readonly HandOffStarted: \"handoff-started\";\n    readonly HandOffReturned: \"handoff-returned\";\n    readonly HandOffUnwound: \"handoff-unwound\";\n}"
             }
           ],
           "fileUrlPath": "src/main/main.types.ts",
@@ -4343,6 +4720,72 @@
               "parameters": [],
               "name": "getFlowOwner"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#getHandOffData:member(1)",
+              "docComment": "/**\n * The `data` each hand-off target was activated with, by name, for the agents a reload resumes: the flow owner and the callers waiting in a hand-off. See the tool context's `handOffData`.\n *\n * @beta\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getHandOffData?(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, unknown>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "getHandOffData"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#getHandOffStack:member(1)",
+              "docComment": "/**\n * The hand-offs in progress, oldest first, to save with the session (GENC-1737). Copies: changing them changes nothing.\n *\n * @beta\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getHandOffStack?(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HandOffFrame",
+                  "canonicalReference": "@genesislcap/ai-assistant!HandOffFrame:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "getHandOffStack"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#getHistoryForPersistence:member(1)",
@@ -5173,6 +5616,149 @@
               ],
               "name": "restoreCondensePolicies"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#restoreHandOffData:member(1)",
+              "docComment": "/**\n * Restore what {@link AiDriver.getHandOffData} saved, before the hand-off stack. Nothing comes back from a frozen (`interrupted`) session, whose flow does not resume.\n *\n * @beta\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "restoreHandOffData?(saved: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "unknown"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", interrupted: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "saved",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "interrupted",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "name": "restoreHandOffData"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#restoreHandOffStack:member(1)",
+              "docComment": "/**\n * Restore saved hand-offs, before the condense policies, against the agents configured now and the saved agent states. A frame whose caller has gone, or whose stateful caller has no saved state (`interrupted` drops them all), is unwound with `handoff-unwound`. When the top frame's target had finished, or has gone, its caller is due to resume: `resume` names it and the note its resumed turn needs, and {@link AiDriver.resumeRestoredFlow} hands back. `droppedLocks` names plain targets of unwound hand-offs, whose saved lock was only that hand-off's.\n *\n * @beta\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "restoreHandOffStack?(saved: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "unknown"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", savedStates: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, unknown>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", interrupted: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "{\n        resume?: {\n            agent: string;\n            note: string;\n        };\n        droppedLocks?: string[];\n    }"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 8,
+                "endIndex": 9
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "saved",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "savedStates",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 5
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "interrupted",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 6,
+                    "endIndex": 7
+                  },
+                  "isOptional": false
+                }
+              ],
+              "name": "restoreHandOffStack"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#restoreInteractionCheckpoint:member(1)",
@@ -5450,6 +6036,39 @@
               ],
               "name": "sendMessage"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#serializeWaitingCallers:member(1)",
+              "docComment": "/**\n * The saved state of each caller waiting in a hand-off whose state is live, by name, from its `serialize`. Saved with the active agent's, so a reload can resume the caller.\n *\n * @beta\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "serializeWaitingCallers?(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, unknown>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "serializeWaitingCallers"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#setContextGuard:member(1)",
@@ -5585,6 +6204,70 @@
                 }
               ],
               "name": "setPinnedAgent"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#unwindHandOffs:member(1)",
+              "docComment": "/**\n * End every hand-off without a hand-back, newest first: the chat was cleared, or the agents changed. Each raises `handoff-unwound`; on Clear a waiting caller's `onHandOffReturn` is told.\n *\n * @beta\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "unwindHandOffs?(kind: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Extract",
+                  "canonicalReference": "!Extract:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HandOffOutcomeKind",
+                  "canonicalReference": "@genesislcap/ai-assistant!HandOffOutcomeKind:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", 'cleared' | 'state-lost'>"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<void>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 6,
+                "endIndex": 8
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "kind",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 5
+                  },
+                  "isOptional": false
+                }
+              ],
+              "name": "unwindHandOffs"
             }
           ],
           "extendsTokenRanges": [
@@ -5787,6 +6470,129 @@
                 "endIndex": 3
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriverEventMap#\"handoff-returned\":member",
+              "docComment": "/**\n * A hand-off ended and its caller is active again; `detail.outcome` says how.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "'handoff-returned': "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CustomEvent",
+                  "canonicalReference": "!CustomEvent:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HandOffFrame",
+                  "canonicalReference": "@genesislcap/ai-assistant!HandOffFrame:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "\"handoff-returned\"",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 5
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriverEventMap#\"handoff-started\":member",
+              "docComment": "/**\n * A hand-off started: its target is now active (GENC-1737).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "'handoff-started': "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CustomEvent",
+                  "canonicalReference": "!CustomEvent:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HandOffFrame",
+                  "canonicalReference": "@genesislcap/ai-assistant!HandOffFrame:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "\"handoff-started\"",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 5
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriverEventMap#\"handoff-unwound\":member",
+              "docComment": "/**\n * A hand-off ended with no hand-back: cleared, or found unresumable.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "'handoff-unwound': "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CustomEvent",
+                  "canonicalReference": "!CustomEvent:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HandOffFrame",
+                  "canonicalReference": "@genesislcap/ai-assistant!HandOffFrame:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "\"handoff-unwound\"",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 5
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriverEventMap#\"history-updated\":member",
@@ -11148,6 +11954,78 @@
               "isAbstract": false,
               "name": "getFlowOwner"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!BaseDriverDecorator#getHandOffData:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getHandOffData(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, unknown>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getHandOffData"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!BaseDriverDecorator#getHandOffStack:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getHandOffStack(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HandOffFrame",
+                  "canonicalReference": "@genesislcap/ai-assistant!HandOffFrame: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": "getHandOffStack"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!BaseDriverDecorator#getHistoryForPersistence:member(1)",
@@ -12104,6 +12982,155 @@
               "isAbstract": false,
               "name": "restoreCondensePolicies"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!BaseDriverDecorator#restoreHandOffData:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "restoreHandOffData(saved: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "unknown"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", interrupted: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "saved",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "interrupted",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "restoreHandOffData"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!BaseDriverDecorator#restoreHandOffStack:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "restoreHandOffStack(saved: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "unknown"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", savedStates: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, unknown>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", interrupted: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "{\n        resume?: {\n            agent: string;\n            note: string;\n        };\n        droppedLocks?: string[];\n    }"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 8,
+                "endIndex": 9
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "saved",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "savedStates",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 5
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "interrupted",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 6,
+                    "endIndex": 7
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "restoreHandOffStack"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!BaseDriverDecorator#restoreInteractionCheckpoint:member(1)",
@@ -12393,6 +13420,42 @@
               "isAbstract": false,
               "name": "sendMessage"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!BaseDriverDecorator#serializeWaitingCallers:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "serializeWaitingCallers(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, unknown>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "serializeWaitingCallers"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!BaseDriverDecorator#setContextGuard:member(1)",
@@ -12537,6 +13600,73 @@
               "isOptional": false,
               "isAbstract": false,
               "name": "setPinnedAgent"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!BaseDriverDecorator#unwindHandOffs:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "unwindHandOffs(kind: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Extract",
+                  "canonicalReference": "!Extract:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HandOffOutcomeKind",
+                  "canonicalReference": "@genesislcap/ai-assistant!HandOffOutcomeKind:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", 'cleared' | 'state-lost'>"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<void>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 6,
+                "endIndex": 8
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "kind",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 5
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "unwindHandOffs"
             }
           ],
           "extendsTokenRange": {
@@ -13093,6 +14223,37 @@
               "isAbstract": false,
               "name": "dispose"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#endSuspendedActivations:member(1)",
+              "docComment": "/**\n * End every suspension: the hand-offs were unwound, so their callers' activations are over.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "endSuspendedActivations(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "endSuspendedActivations"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getActiveAgent:member(1)",
@@ -13416,30 +14577,21 @@
             },
             {
               "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getHistory:member(1)",
-              "docComment": "",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getHandOffCompletion:member(1)",
+              "docComment": "/**\n * What `completeHandOff` handed back in the most recent call, if it was called.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "getHistory(): "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "ReadonlyArray",
-                  "canonicalReference": "!ReadonlyArray:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": "<"
+                  "text": "getHandOffCompletion(): "
                 },
                 {
                   "kind": "Reference",
-                  "text": "ChatMessage",
-                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                  "text": "HandOffCompletion",
+                  "canonicalReference": "@genesislcap/foundation-ai!HandOffCompletion:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": ">"
+                  "text": " | undefined"
                 },
                 {
                   "kind": "Content",
@@ -13449,7 +14601,7 @@
               "isStatic": false,
               "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 5
+                "endIndex": 3
               },
               "releaseTag": "Public",
               "isProtected": false,
@@ -13457,25 +14609,25 @@
               "parameters": [],
               "isOptional": false,
               "isAbstract": false,
-              "name": "getHistory"
+              "name": "getHandOffCompletion"
             },
             {
               "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getHistoryForPersistence:member(1)",
-              "docComment": "/**\n * The transcript as it should be **stored**: every tool payload the model has already stopped seeing replaced by the same stub it was sent (GENC-1566). Live history is untouched — this returns a copy.\n *\n * Condensation deliberately spares stored history, because the live transcript and the debug export both read it. A host writing that transcript to durable storage inherits the other half of that decision: it stores payloads the driver has already retired, on every autosave, for the life of the session. Measured on one small Create session — 58,187 chars, 7.4% of a 790 KB session object, across five payloads worth 14,434 tokens of context, written 86 times.\n *\n * Only already-collapsed payloads are touched, so this can never store a stub for something the model can still see, and it has no side effects (see `condenseForPersistence`, which is internal). A host that wants the unredacted transcript still calls {@link ChatDriver.getRawHistory}, and a diagnostics stream that keeps full payloads is unaffected — which is what makes the elision recoverable.\n */\n",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getHandOffRequest:member(1)",
+              "docComment": "/**\n * The `handOff` the most recent call accepted, if any (GENC-1737).\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "getHistoryForPersistence(): "
+                  "text": "getHandOffRequest(): "
                 },
                 {
                   "kind": "Reference",
-                  "text": "ChatMessage",
-                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                  "text": "HandOffRequest",
+                  "canonicalReference": "@genesislcap/foundation-ai!HandOffRequest:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": "[]"
+                  "text": " | undefined"
                 },
                 {
                   "kind": "Content",
@@ -13493,25 +14645,34 @@
               "parameters": [],
               "isOptional": false,
               "isAbstract": false,
-              "name": "getHistoryForPersistence"
+              "name": "getHandOffRequest"
             },
             {
               "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getInteractionCheckpoint:member(1)",
-              "docComment": "/**\n * One checkpoint to save: the long action in flight's, else the newest a reload cut.\n *\n * @deprecated\n *\n * Use `getInteractionCheckpoints`.\n */\n",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getHistory:member(1)",
+              "docComment": "",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "getInteractionCheckpoint(): "
+                  "text": "getHistory(): "
                 },
                 {
                   "kind": "Reference",
-                  "text": "PersistedInteractionCheckpoint",
-                  "canonicalReference": "@genesislcap/ai-assistant!PersistedInteractionCheckpoint:interface"
+                  "text": "ReadonlyArray",
+                  "canonicalReference": "!ReadonlyArray:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": " | undefined"
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatMessage",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
                 },
                 {
                   "kind": "Content",
@@ -13521,7 +14682,7 @@
               "isStatic": false,
               "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 3
+                "endIndex": 5
               },
               "releaseTag": "Public",
               "isProtected": false,
@@ -13529,25 +14690,21 @@
               "parameters": [],
               "isOptional": false,
               "isAbstract": false,
-              "name": "getInteractionCheckpoint"
+              "name": "getHistory"
             },
             {
               "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getInteractionCheckpoints:member(1)",
-              "docComment": "/**\n * Every checkpoint to save with the session (GENC-1660 §4.12): those a reload cut that nothing has taken over yet, oldest first, then the long action in flight's, if it has saved one.\n *\n * Optional, so a third-party driver need not implement it; every shipped driver does.\n */\n",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getHistoryForPersistence:member(1)",
+              "docComment": "/**\n * The transcript as it should be **stored**: every tool payload the model has already stopped seeing replaced by the same stub it was sent (GENC-1566). Live history is untouched — this returns a copy.\n *\n * Condensation deliberately spares stored history, because the live transcript and the debug export both read it. A host writing that transcript to durable storage inherits the other half of that decision: it stores payloads the driver has already retired, on every autosave, for the life of the session. Measured on one small Create session — 58,187 chars, 7.4% of a 790 KB session object, across five payloads worth 14,434 tokens of context, written 86 times.\n *\n * Only already-collapsed payloads are touched, so this can never store a stub for something the model can still see, and it has no side effects (see `condenseForPersistence`, which is internal). A host that wants the unredacted transcript still calls {@link ChatDriver.getRawHistory}, and a diagnostics stream that keeps full payloads is unaffected — which is what makes the elision recoverable.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "getInteractionCheckpoints(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "readonly "
+                  "text": "getHistoryForPersistence(): "
                 },
                 {
                   "kind": "Reference",
-                  "text": "PersistedInteractionCheckpoint",
-                  "canonicalReference": "@genesislcap/ai-assistant!PersistedInteractionCheckpoint:interface"
+                  "text": "ChatMessage",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
                 },
                 {
                   "kind": "Content",
@@ -13561,7 +14718,7 @@
               "isStatic": false,
               "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 4
+                "endIndex": 3
               },
               "releaseTag": "Public",
               "isProtected": false,
@@ -13569,29 +14726,21 @@
               "parameters": [],
               "isOptional": false,
               "isAbstract": false,
-              "name": "getInteractionCheckpoints"
+              "name": "getHistoryForPersistence"
             },
             {
               "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getInteractionContext:member(1)",
-              "docComment": "/**\n * The live {@link InteractionContext} for a pending interaction (GENC-1390), or `undefined` once resolved/evicted. Read by `AiChatInteractionWrapper` (via the host) to build the widget's pending `interaction` descriptor.\n */\n",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getInteractionCheckpoint:member(1)",
+              "docComment": "/**\n * One checkpoint to save: the long action in flight's, else the newest a reload cut.\n *\n * @deprecated\n *\n * Use `getInteractionCheckpoints`.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "getInteractionContext(interactionId: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": "): "
+                  "text": "getInteractionCheckpoint(): "
                 },
                 {
                   "kind": "Reference",
-                  "text": "InteractionContext",
-                  "canonicalReference": "@genesislcap/ai-assistant!InteractionContext:interface"
+                  "text": "PersistedInteractionCheckpoint",
+                  "canonicalReference": "@genesislcap/ai-assistant!PersistedInteractionCheckpoint:interface"
                 },
                 {
                   "kind": "Content",
@@ -13603,49 +14752,9 @@
                 }
               ],
               "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 5
-              },
-              "releaseTag": "Public",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "interactionId",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  },
-                  "isOptional": false
-                }
-              ],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "getInteractionContext"
-            },
-            {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getPreambleTokens:member(1)",
-              "docComment": "/**\n * Token cost of the last request's preamble — system prompt, tool definitions and framed tail (GENC-1582). `undefined` before the first call of a turn.\n *\n * A live getter rather than a field stamped on each message, deliberately: every consumer wants the CURRENT preamble, never its history, and a message field would mean a type change in `@genesislcap/foundation-ai` plus churn in every persisted session for a value nobody reads twice.\n *\n * It exists because the preamble cannot be derived reliably. Inferring it as \"first measured prompt minus the messages it covered\" is accurate once and then goes stale, since each agent brings its own prompt and tool surface — and every attempt to compensate downstream ended up comparing stored characters against wire tokens. The driver is the only place that knows what it just sent.\n *\n * Optional — only drivers that build requests implement it.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "getPreambleTokens(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "number | undefined"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
               "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 2
+                "endIndex": 3
               },
               "releaseTag": "Public",
               "isProtected": false,
@@ -13653,16 +14762,16 @@
               "parameters": [],
               "isOptional": false,
               "isAbstract": false,
-              "name": "getPreambleTokens"
+              "name": "getInteractionCheckpoint"
             },
             {
               "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getRawHistory:member(1)",
-              "docComment": "",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getInteractionCheckpoints:member(1)",
+              "docComment": "/**\n * Every checkpoint to save with the session (GENC-1660 §4.12): those a reload cut that nothing has taken over yet, oldest first, then the long action in flight's, if it has saved one.\n *\n * Optional, so a third-party driver need not implement it; every shipped driver does.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "getRawHistory(): "
+                  "text": "getInteractionCheckpoints(): "
                 },
                 {
                   "kind": "Content",
@@ -13670,8 +14779,132 @@
                 },
                 {
                   "kind": "Reference",
-                  "text": "ChatMessage",
-                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                  "text": "PersistedInteractionCheckpoint",
+                  "canonicalReference": "@genesislcap/ai-assistant!PersistedInteractionCheckpoint:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getInteractionCheckpoints"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getInteractionContext:member(1)",
+              "docComment": "/**\n * The live {@link InteractionContext} for a pending interaction (GENC-1390), or `undefined` once resolved/evicted. Read by `AiChatInteractionWrapper` (via the host) to build the widget's pending `interaction` descriptor.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getInteractionContext(interactionId: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "InteractionContext",
+                  "canonicalReference": "@genesislcap/ai-assistant!InteractionContext:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "interactionId",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getInteractionContext"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getPreambleTokens:member(1)",
+              "docComment": "/**\n * Token cost of the last request's preamble — system prompt, tool definitions and framed tail (GENC-1582). `undefined` before the first call of a turn.\n *\n * A live getter rather than a field stamped on each message, deliberately: every consumer wants the CURRENT preamble, never its history, and a message field would mean a type change in `@genesislcap/foundation-ai` plus churn in every persisted session for a value nobody reads twice.\n *\n * It exists because the preamble cannot be derived reliably. Inferring it as \"first measured prompt minus the messages it covered\" is accurate once and then goes stale, since each agent brings its own prompt and tool surface — and every attempt to compensate downstream ended up comparing stored characters against wire tokens. The driver is the only place that knows what it just sent.\n *\n * Optional — only drivers that build requests implement it.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getPreambleTokens(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getPreambleTokens"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getRawHistory:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getRawHistory(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "readonly "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatMessage",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
                 },
                 {
                   "kind": "Content",
@@ -15369,6 +16602,102 @@
               "isOptional": false,
               "isAbstract": false,
               "name": "setProviderHistoryTransform"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#suspendActivation:member(1)",
+              "docComment": "/**\n * Suspend the active agent's activation for a hand-off it made (GENC-1737): installing the target advances the `agentEnd` clock as any swap does, but this caller's payloads stay live.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "suspendActivation(agentName: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "agentName",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "suspendActivation"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#suspendRestoredActivations:member(1)",
+              "docComment": "/**\n * Suspend restored callers before their condense policies are restored, so entries still live at save time stay live instead of waiting for \"the next activation\", which is the target's.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "suspendRestoredActivations(agentNames: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "readonly string[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "agentNames",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "suspendRestoredActivations"
             }
           ],
           "extendsTokenRange": {
@@ -15532,7 +16861,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig#deferAgentRelease:member",
-              "docComment": "/**\n * Leave acting on `releaseAgent` to the owner of this driver.\n *\n * Set by `OrchestratingDriver` for its inner driver, which performs the release itself after the turn, because a release ends its handoff loop and it reads the flag to know. Both drivers share one `AgentSession`, and releasing here first would clear the flag before the orchestrator saw it. The host-facing `agent-released` / `agent-changed` / `flow-owner-changed` events fire from the session's transition either way (GENC-1485).\n *\n * Left unset, a driver releases its own agent, which is what a bare `ChatDriver` needs: nothing else is watching the flag.\n */\n",
+              "docComment": "/**\n * Leave acting on `releaseAgent` to the owner of this driver.\n *\n * Set by `OrchestratingDriver` for its inner driver, which performs the release itself after the call, because a release may hand back to a waiting caller and it reads the flag to know. Both drivers share one `AgentSession`, and releasing here first would clear the flag before the orchestrator saw it. The host-facing `agent-released` / `agent-changed` / `flow-owner-changed` events fire from the session's transition either way (GENC-1485).\n *\n * Left unset, a driver releases its own agent, which is what a bare `ChatDriver` needs: nothing else is watching the flag.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -18299,7 +19628,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant:class",
-          "docComment": "/**\n * Foundation AI Assistant component.\n *\n * @remarks\n *\n * Register one or more AI providers via `registerAIProviders` from `@genesislcap/foundation-ai`; this element resolves the `AIProviderRegistry` through the DI container. Pass agent configuration via the `agents` property — each agent can override which registered provider it uses via `provider:`. The component creates a `ChatDriver` (single agent) or `OrchestratingDriver` (multiple agents) to manage the conversation loop.\n *\n * Popout/collapse coordination uses `agenticActivityBus` topics `chat-popout` and `chat-popin` — not DOM `CustomEvent`s on this element.\n *\n * **Cost build history:** opt-in via `chatConfig.costHistory.enabled`. When enabled, each session's usage is kept as exactly ONE row per session key in `localStorage` (scoped by `costHistory.scope`, the element `id`, or `'default'`), upserted as spend accrues. So a row is a project's lifetime usage rather than a visit to it, and the Usage tab's total is the sum of the rows alone — the live session is never added on top, because the active project's own row already reflects it. Hosts may call {@link FoundationAiAssistant.finalizeCostSession} to flush early; it is idempotent.\n *\n * @fires\n *\n * chat-header-mousedown - Fired when the user presses the chat header in `popout-mode=\"expand\"` (for drag-to-popout hosts). Bubbles and composed. detail: `ChatHeaderMouseDownDetail`\n *\n * @fires\n *\n * session-cleared - Fired after the session is wiped (the lifecycle menu's Clear). The payload is captured before teardown so the host can clean up any external state the active agent was working on. Bubbles and composed. detail: `SessionClearedDetail`\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Foundation AI Assistant component.\n *\n * @remarks\n *\n * Register one or more AI providers via `registerAIProviders` from `@genesislcap/foundation-ai`; this element resolves the `AIProviderRegistry` through the DI container. Pass agent configuration via the `agents` property — each agent can override which registered provider it uses via `provider:`. The component creates a `ChatDriver` (single agent) or `OrchestratingDriver` (multiple agents) to manage the conversation loop.\n *\n * Popout/collapse coordination uses `agenticActivityBus` topics `chat-popout` and `chat-popin` — not DOM `CustomEvent`s on this element.\n *\n * **Cost build history:** opt-in via `chatConfig.costHistory.enabled`. When enabled, each session's usage is kept as exactly ONE row per session key in `localStorage` (scoped by `costHistory.scope`, the element `id`, or `'default'`), upserted as spend accrues. So a row is a project's lifetime usage rather than a visit to it, and the Usage tab's total is the sum of the rows alone — the live session is never added on top, because the active project's own row already reflects it. Hosts may call {@link FoundationAiAssistant.finalizeCostSession} to flush early; it is idempotent.\n *\n * @fires\n *\n * chat-header-mousedown - Fired when the user presses the chat header in `popout-mode=\"expand\"` (for drag-to-popout hosts). Bubbles and composed. detail: `ChatHeaderMouseDownDetail`\n *\n * @fires\n *\n * session-cleared - Fired after the session is wiped (the lifecycle menu's Clear). The payload is captured before teardown so the host can clean up any external state the active agent was working on. Bubbles and composed. detail: `SessionClearedDetail`\n *\n * @fires\n *\n * handoff-started - Fired when an agent's `handOff` takes effect and its target becomes active. Bubbles and composed. detail: `HandOffFrame`\n *\n * @fires\n *\n * handoff-returned - Fired when a hand-off ends and its caller is active again; `detail.outcome` says how it ended. Bubbles and composed. detail: `HandOffFrame`\n *\n * @fires\n *\n * handoff-unwound - Fired when a hand-off ends with no hand-back: the chat was cleared, the agents changed, or a restore found it could not resume. Bubbles and composed. detail: `HandOffFrame`\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -27682,6 +29011,367 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!HandOffFrame:interface",
+          "docComment": "/**\n * One hand-off on the stack, saved with the session: who waits, for whom, and why. `outcome` is set when the target finishes, until the caller has resumed, so a reload in between still hands back. Also the `detail` of the `handoff-started`, `handoff-returned` and `handoff-unwound` events.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface HandOffFrame "
+            }
+          ],
+          "fileUrlPath": "src/config/config.ts",
+          "releaseTag": "Beta",
+          "name": "HandOffFrame",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!HandOffFrame#caller:member",
+              "docComment": "/**\n * The agent waiting for the hand-back.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "caller: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "caller",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!HandOffFrame#data:member",
+              "docComment": "/**\n * JSON only.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "data?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "unknown"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "data",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!HandOffFrame#id:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "id: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "id",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!HandOffFrame#message:member",
+              "docComment": "/**\n * The brief.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "message: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "message",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!HandOffFrame#outcome:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "outcome?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HandOffOutcome",
+                  "canonicalReference": "@genesislcap/ai-assistant!HandOffOutcome:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "outcome",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!HandOffFrame#returnTo:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "returnTo: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "returnTo",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!HandOffFrame#startedAt:member",
+              "docComment": "/**\n * ISO time the hand-off started.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "startedAt: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "startedAt",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!HandOffFrame#target:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "target: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "target",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!HandOffOutcome:interface",
+          "docComment": "/**\n * What a hand-off's caller gets back. `message` is the target's `completeHandOff` summary, or for `released` its final reply since the brief; `data` is what `completeHandOff` passed.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface HandOffOutcome "
+            }
+          ],
+          "fileUrlPath": "src/config/config.ts",
+          "releaseTag": "Beta",
+          "name": "HandOffOutcome",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!HandOffOutcome#data:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "data?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "unknown"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "data",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!HandOffOutcome#kind:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "kind: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HandOffOutcomeKind",
+                  "canonicalReference": "@genesislcap/ai-assistant!HandOffOutcomeKind:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "kind",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!HandOffOutcome#message:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "message?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "message",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@genesislcap/ai-assistant!HandOffOutcomeKind:type",
+          "docComment": "/**\n * How a hand-off ended (GENC-1737): - `completed`: the target called `completeHandOff`; - `released`: the target called `releaseAgent`, or, a plain one, ended its turn; - `cleared`: the user cleared the chat; - `agent-removed`: the caller or the target is no longer in the agent list, found on restore; - `state-lost`: the caller's saved state is gone, so it cannot resume: a session saved while its flow could not be resumed, or a change to the agents, which disposes them.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type HandOffOutcomeKind = "
+            },
+            {
+              "kind": "Content",
+              "text": "'completed' | 'released' | 'cleared' | 'agent-removed' | 'state-lost'"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/config/config.ts",
+          "releaseTag": "Beta",
+          "name": "HandOffOutcomeKind",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/ai-assistant!InteractionCompletedEventDetail:type",
@@ -30375,7 +32065,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "{\n        sessionKey?: string;\n        maxHandoffs?: number;\n        classifierHistoryLength?: number;\n        classifierRetries?: number;\n        maxToolIterations?: number;\n        maxFoldOperations?: number;\n        maxTurnSnapshots?: number;\n        activityBus?: "
+                  "text": "{\n        sessionKey?: string;\n        maxHandoffs?: number;\n        maxHandOffDepth?: number;\n        classifierHistoryLength?: number;\n        classifierRetries?: number;\n        maxToolIterations?: number;\n        maxFoldOperations?: number;\n        maxTurnSnapshots?: number;\n        activityBus?: "
                 },
                 {
                   "kind": "Reference",
@@ -30486,7 +32176,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#cancel:member(1)",
-              "docComment": "/**\n * Stop the current turn (user \"stop\" button). Cancels the inner chat driver's in-flight request and breaks the handoff loop so no further agent turn or classify runs. The driver stays usable for the next message.\n */\n",
+              "docComment": "/**\n * Stop the current turn (user \"stop\" button). Cancels the inner chat driver's in-flight request, and no further agent runs this turn, not even a hand-off's target or a hand-back. The driver stays usable for the next message.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -30766,6 +32456,78 @@
               "isAbstract": false,
               "name": "getContextReserve"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#getHandOffData:member(1)",
+              "docComment": "/**\n * The `data` each hand-off target was activated with, by name, for the agents a reload resumes: the flow owner and the callers waiting in a hand-off. See the tool context's `handOffData`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getHandOffData(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, unknown>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getHandOffData"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#getHandOffStack:member(1)",
+              "docComment": "/**\n * The hand-offs in progress, oldest first, to save with the session (GENC-1737). Copies: changing them changes nothing.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getHandOffStack(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HandOffFrame",
+                  "canonicalReference": "@genesislcap/ai-assistant!HandOffFrame: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": "getHandOffStack"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#getSuggestions:member(1)",
@@ -30877,6 +32639,155 @@
               "isAbstract": false,
               "name": "getSuggestions"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#restoreHandOffData:member(1)",
+              "docComment": "/**\n * Restore what {@link AiDriver.getHandOffData} saved, before the hand-off stack. Nothing comes back from a frozen (`interrupted`) session, whose flow does not resume.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "restoreHandOffData(saved: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "unknown"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", interrupted: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "saved",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "interrupted",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "restoreHandOffData"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#restoreHandOffStack:member(1)",
+              "docComment": "/**\n * Restore saved hand-offs, before the condense policies, against the agents configured now and the saved agent states. A frame whose caller has gone, or whose stateful caller has no saved state (`interrupted` drops them all), is unwound with `handoff-unwound`. When the top frame's target had finished, or has gone, its caller is due to resume: `resume` names it and the note its resumed turn needs, and {@link AiDriver.resumeRestoredFlow} hands back. `droppedLocks` names plain targets of unwound hand-offs, whose saved lock was only that hand-off's.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "restoreHandOffStack(saved: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "unknown"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", savedStates: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, unknown>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", interrupted: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "{\n        resume?: {\n            agent: string;\n            note: string;\n        };\n        droppedLocks?: string[];\n    }"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 8,
+                "endIndex": 9
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "saved",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "savedStates",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 5
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "interrupted",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 6,
+                    "endIndex": 7
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "restoreHandOffStack"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#resumeRestoredFlow:member(1)",
@@ -31038,6 +32949,95 @@
               "isOptional": false,
               "isAbstract": false,
               "name": "sendMessage"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#serializeWaitingCallers:member(1)",
+              "docComment": "/**\n * The saved state of each caller waiting in a hand-off whose state is live, by name, from its `serialize`. Saved with the active agent's, so a reload can resume the caller.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "serializeWaitingCallers(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, unknown>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "serializeWaitingCallers"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#unwindHandOffs:member(1)",
+              "docComment": "/**\n * End every hand-off without a hand-back, newest first: the chat was cleared, or the agents changed. Each raises `handoff-unwound`; on Clear a waiting caller's `onHandOffReturn` is told.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "unwindHandOffs(kind: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "'cleared' | 'state-lost'"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<void>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 5
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "kind",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "unwindHandOffs"
             }
           ],
           "extendsTokenRange": {
@@ -31671,6 +33671,70 @@
                 "endIndex": 2
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!PersistedSession#handOffData:member",
+              "docComment": "/**\n * The `data` each hand-off target was activated with, by agent name (GENC-1737), for the agents a restore resumes: the flow owner and the waiting callers. Not written for a frozen session. Optional and additive, like `handoffStack`; omitted when there is none.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "handOffData?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, unknown>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "handOffData",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!PersistedSession#handoffStack:member",
+              "docComment": "/**\n * The hand-offs in progress, oldest first (GENC-1737): who waits for whom, and why. A frame with an `outcome` was finished by its target but its caller had not resumed yet, so a restore hands back. Each agent's own state is in `agentSnapshots`, the waiting callers' included. Optional and additive, like `condensePolicies`; omitted when there are none. The frame's shape, written out here as for `checkpoints`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "handoffStack?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Array",
+                  "canonicalReference": "!Array:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<{\n        id: string;\n        caller: string;\n        target: string;\n        returnTo: boolean;\n        message: string;\n        data?: unknown;\n        startedAt: string;\n        outcome?: {\n            kind: string;\n            message?: string;\n            data?: unknown;\n        };\n    }>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "handoffStack",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!PersistedSession#host:member",
@@ -32129,33 +34193,6 @@
           ],
           "name": "registerTieredAIProviders"
         },
-        {
-          "kind": "Variable",
-          "canonicalReference": "@genesislcap/ai-assistant!REQUEST_CONTINUATION_TOOL:var",
-          "docComment": "/**\n * Name reserved for the cross-agent handoff tool — injected by OrchestratingDriver.\n *\n * @beta\n */\n",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "REQUEST_CONTINUATION_TOOL = "
-            },
-            {
-              "kind": "Content",
-              "text": "\"request_continuation\""
-            }
-          ],
-          "fileUrlPath": "src/components/chat-driver/chat-driver.constants.ts",
-          "initializerTokenRange": {
-            "startIndex": 1,
-            "endIndex": 2
-          },
-          "isReadonly": true,
-          "releaseTag": "Beta",
-          "name": "REQUEST_CONTINUATION_TOOL",
-          "variableTypeTokenRange": {
-            "startIndex": 0,
-            "endIndex": 0
-          }
-        },
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/ai-assistant!requestAgentNotificationPermission:function(1)",
@@ -32429,7 +34466,7 @@
             },
             {
               "kind": "Content",
-              "text": "'classified'\n/** The classifier ran and answered -1: nothing listed covers the request. */\n | 'no-match'\n/**\n * Every classifier-eligible specialist had already handled part of this turn and handed on, so\n * the ballot was empty and no call was made. Distinct from `'no-match'`, which means a\n * classifier RAN and declined — conflating the two re-creates exactly the \"did anything actually\n * get asked?\" ambiguity this event exists to remove.\n */\n | 'ballot-exhausted'\n/** One viable specialist and no fallback — no point asking. */\n | 'single-candidate'\n/** Nothing classifier-eligible was configured. */\n | 'no-specialists'\n/** The registry default exposes no `chat()`, so no classification is possible. */\n | 'provider-unavailable'\n/** Every attempt threw. `detail.error` carries the last message. */\n | 'classifier-failed'\n/** A pin or an active flow owned the turn; the classifier was skipped. */\n | 'pinned'"
+              "text": "'classified'\n/** The classifier ran and answered -1: nothing listed covers the request. */\n | 'no-match'\n/** One viable specialist and no fallback — no point asking. */\n | 'single-candidate'\n/** Nothing classifier-eligible was configured. */\n | 'no-specialists'\n/** The registry default exposes no `chat()`, so no classification is possible. */\n | 'provider-unavailable'\n/** Every attempt threw. `detail.error` carries the last message. */\n | 'classifier-failed'\n/** A pin or an active flow owned the turn; the classifier was skipped. */\n | 'pinned'"
             },
             {
               "kind": "Content",
@@ -39040,7 +41077,7 @@
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/ai-assistant!UNROUTABLE_INSTRUCTION:var",
-          "docComment": "/**\n * The instruction a fallback agent needs and, left to itself, tends not to have.\n *\n * A fallback prompt written by a consumer reliably covers two cases — small talk, and a request that belongs to a specialist — because those are the ones you think of when you write it. The case it exists FOR is the third: a substantive request that no specialist covers, and no way to act on it, because a fallback holds no tools and is denied the continuation tool as a leaf.\n *\n * Create's fallback prompt is the worked example (GENC-1573). It covered chit-chat and \"out of scope, here are the specialists\", said nothing about a request nothing can serve, and nothing about a terse follow-up (\"fix it\", \"try again\") aimed at an answer already given. Asked to fix a Kotlin null pointer no agent could touch, it returned nine blank turns across three page loads — a model with no instruction covering its situation and no tool to reach for.\n *\n * So the framework supplies it. Appended to a string-form prompt (or substituted at {@link UNROUTABLE_PLACEHOLDER} if the consumer positions it), because a fallback with no answer for its own reason to exist is a defect in every host, not a matter of taste. It is additive and static: being fixed it cannot destabilise a cached prefix, and the fallback prompt already changes whenever the agents array does (`{{agents}}` interpolates the specialist list). The function form still passes through untouched — a consumer that wants full control has it there.\n *\n * DELIBERATELY CONFINED TO WHAT A TERSE PROMPT CAN ALSO OBEY, and it must stay that way. Since this is appended by default it lands on top of prompts written with their own tone rules, and an earlier draft asked the model to \"state what you can establish… and suggest what the user could do next\" — a direct contradiction of {@link strictFallbackAgent}, a preset THIS PACKAGE ships, whose whole instruction is \"a single short sentence… Do not elaborate\". What is left here is compatible with brevity: say so, don't promise work you cannot do, read a short follow-up in context, and never answer with nothing. Adding anything that presumes room to elaborate breaks a shipped preset — put it in the consumer's own prompt instead.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * The instruction a fallback agent needs and, left to itself, tends not to have.\n *\n * A fallback prompt written by a consumer reliably covers two cases — small talk, and a request that belongs to a specialist — because those are the ones you think of when you write it. The case it exists FOR is the third: a substantive request that no specialist covers, and no way to act on it, because a fallback holds no tools.\n *\n * Create's fallback prompt is the worked example (GENC-1573). It covered chit-chat and \"out of scope, here are the specialists\", said nothing about a request nothing can serve, and nothing about a terse follow-up (\"fix it\", \"try again\") aimed at an answer already given. Asked to fix a Kotlin null pointer no agent could touch, it returned nine blank turns across three page loads — a model with no instruction covering its situation and no tool to reach for.\n *\n * So the framework supplies it. Appended to a string-form prompt (or substituted at {@link UNROUTABLE_PLACEHOLDER} if the consumer positions it), because a fallback with no answer for its own reason to exist is a defect in every host, not a matter of taste. It is additive and static: being fixed it cannot destabilise a cached prefix, and the fallback prompt already changes whenever the agents array does (`{{agents}}` interpolates the specialist list). The function form still passes through untouched — a consumer that wants full control has it there.\n *\n * DELIBERATELY CONFINED TO WHAT A TERSE PROMPT CAN ALSO OBEY, and it must stay that way. Since this is appended by default it lands on top of prompts written with their own tone rules, and an earlier draft asked the model to \"state what you can establish… and suggest what the user could do next\" — a direct contradiction of {@link strictFallbackAgent}, a preset THIS PACKAGE ships, whose whole instruction is \"a single short sentence… Do not elaborate\". What is left here is compatible with brevity: say so, don't promise work you cannot do, read a short follow-up in context, and never answer with nothing. Adding anything that presumes room to elaborate breaks a shipped preset — put it in the consumer's own prompt instead.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",