@genesislcap/ai-assistant 15.55.0 → 15.57.0

package/dist/ai-assistant.api.json

@@ -1845,7 +1845,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!AgentSession#activate:member(1)",
-              "docComment": "/**\n * Make `agent` active, firing the lifecycle hooks around the swap: outgoing `onDeactivate` first, then incoming `onActivate`. Both are awaited so heavy activation work (a machine restore, say) completes before the agent's first turn runs, and a throw from either is logged rather than propagated — an agent whose hook fails still activates.\n *\n * Re-activating the same agent by name is not a switch: no hooks fire, no lock moves, and no handoff is recorded. That guard matters because a per-turn re-resolve calls through here.\n */\n",
+              "docComment": "/**\n * Make `agent` active, firing the lifecycle hooks around the swap: outgoing `onDeactivate` first, then incoming `onActivate`. Both are awaited so heavy activation work (a machine restore, say) completes before the agent's first turn runs, and a throw from either is logged rather than propagated — an agent whose hook fails still activates.\n *\n * Re-activating the same agent by name is not a switch: no hooks fire, no lock moves, and no handoff is recorded. That guard matters because a per-turn re-resolve calls through here.\n *\n * Single-flight (GENC-1662): calls run one after another, never interleaved. `active` is only set once the hooks have finished, so two overlapping calls for the same agent would otherwise both see a switch and run `onActivate` twice — and a restored `init` would be overwritten by a fresh one that finished later. That overlap became possible when a restore started activating the flow owner outside a turn, where a send can land mid-activation.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -3174,6 +3174,96 @@
               ],
               "name": "canCompact"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#canRestoreFlowOwner:member(1)",
+              "docComment": "/**\n * Whether a restore can bring back the flow `agentName` owns (GENC-1662): the agent is configured here. Pure — no activation. A restore re-activates only an owner this answers `true` for.\n *\n * Optional: a driver without it never re-activates or resumes.\n *\n * @beta\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "canRestoreFlowOwner?(agentName: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "agentName",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "name": "canRestoreFlowOwner"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#canResumeRestoredFlow:member(1)",
+              "docComment": "/**\n * Whether a restored flow owned by `agentName` should also RESUME — run a turn on its own — when the reload interrupted one (GENC-1662): the agent is configured here and has not opted out with `resumeOnRestore: false`. Pure. Lets the restore pick its divider wording.\n *\n * @beta\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "canResumeRestoredFlow?(agentName: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "agentName",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "name": "canResumeRestoredFlow"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#compact:member(1)",
@@ -3252,6 +3342,15 @@
                   "kind": "Content",
                   "text": "[]"
                 },
+                {
+                  "kind": "Content",
+                  "text": ", options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ContinueFromHistoryOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!ContinueFromHistoryOptions:interface"
+                },
                 {
                   "kind": "Content",
                   "text": "): "
@@ -3281,8 +3380,8 @@
               ],
               "isOptional": false,
               "returnTypeTokenRange": {
-                "startIndex": 4,
-                "endIndex": 8
+                "startIndex": 6,
+                "endIndex": 10
               },
               "releaseTag": "Beta",
               "overloadIndex": 1,
@@ -3294,6 +3393,14 @@
                     "endIndex": 3
                   },
                   "isOptional": true
+                },
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 4,
+                    "endIndex": 5
+                  },
+                  "isOptional": true
                 }
               ],
               "name": "continueFromHistory"
@@ -4174,6 +4281,65 @@
               ],
               "name": "restoreCondensePolicies"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AiDriver#resumeRestoredFlow:member(1)",
+              "docComment": "/**\n * Bring a restored session's flow back to life (GENC-1662). Activates the flow owner — a stateful agent, the only kind that holds a flow — so its `init({ restored })` runs now rather than on the next message, then, when `resumeNote` is given and the agent has not opted out, runs one turn from the restored history with the note in the tail of its first model call.\n *\n * Returns the turn's result when one ran, `undefined` otherwise (no flow owner, the owner is not configured, or no note). Never throws for those cases.\n *\n * @beta\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "resumeRestoredFlow?(resumeNote?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatDriverResult",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatDriverResult:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 7
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "resumeNote",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "resumeRestoredFlow"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#sendMessage:member(1)",
@@ -5645,7 +5811,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#continueFromHistory:member(1)",
-              "docComment": "/**\n * Continue the tool loop from current history without appending a new user message. Used by OrchestratingDriver after an agent handoff.\n */\n",
+              "docComment": "/**\n * Continue the tool loop from current history without appending a new user message. Used by OrchestratingDriver after an agent handoff, and to resume a restored flow (GENC-1662).\n *\n * `options.tailNote` rides the framed tail of the FIRST model call only — after the history, where a note about the conversation belongs — and is dropped once the model has answered, so it cannot go stale over the rest of the loop. Contrast `transientPrimer`, which leads the request.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -5660,6 +5826,15 @@
                   "kind": "Content",
                   "text": "[]"
                 },
+                {
+                  "kind": "Content",
+                  "text": ", options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ContinueFromHistoryOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!ContinueFromHistoryOptions:interface"
+                },
                 {
                   "kind": "Content",
                   "text": "): "
@@ -5689,8 +5864,8 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 4,
-                "endIndex": 8
+                "startIndex": 6,
+                "endIndex": 10
               },
               "releaseTag": "Public",
               "isProtected": false,
@@ -5703,6 +5878,14 @@
                     "endIndex": 3
                   },
                   "isOptional": true
+                },
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 4,
+                    "endIndex": 5
+                  },
+                  "isOptional": true
                 }
               ],
               "isOptional": false,
@@ -8159,6 +8342,51 @@
             "endIndex": 3
           }
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!ContinueFromHistoryOptions:interface",
+          "docComment": "/**\n * Options for `continueFromHistory` (GENC-1662).\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface ContinueFromHistoryOptions "
+            }
+          ],
+          "fileUrlPath": "src/components/chat-driver/chat-driver.ts",
+          "releaseTag": "Beta",
+          "name": "ContinueFromHistoryOptions",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ContinueFromHistoryOptions#tailNote:member",
+              "docComment": "/**\n * A note for the model, placed in the framed tail of the first model call only — after the history it describes — and dropped once the model has answered.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "tailNote?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "tailNote",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@genesislcap/ai-assistant!CostSessionModelEntry:interface",
@@ -18324,6 +18552,102 @@
               "isAbstract": false,
               "name": "canCompact"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#canRestoreFlowOwner:member(1)",
+              "docComment": "/**\n * Whether a restore can bring back the flow `agentName` owns (GENC-1662): the agent is configured here. Pure — no activation. A restore re-activates only an owner this answers `true` for.\n *\n * Optional: a driver without it never re-activates or resumes.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "canRestoreFlowOwner(agentName: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "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": "canRestoreFlowOwner"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#canResumeRestoredFlow:member(1)",
+              "docComment": "/**\n * Whether a restored flow owned by `agentName` should also RESUME — run a turn on its own — when the reload interrupted one (GENC-1662): the agent is configured here and has not opted out with `resumeOnRestore: false`. Pure. Lets the restore pick its divider wording.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "canResumeRestoredFlow(agentName: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "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": "canResumeRestoredFlow"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#compact:member(1)",
@@ -18405,6 +18729,15 @@
                   "kind": "Content",
                   "text": "[]"
                 },
+                {
+                  "kind": "Content",
+                  "text": ", options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ContinueFromHistoryOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!ContinueFromHistoryOptions:interface"
+                },
                 {
                   "kind": "Content",
                   "text": "): "
@@ -18434,8 +18767,8 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 4,
-                "endIndex": 8
+                "startIndex": 6,
+                "endIndex": 10
               },
               "releaseTag": "Beta",
               "isProtected": false,
@@ -18448,6 +18781,14 @@
                     "endIndex": 3
                   },
                   "isOptional": true
+                },
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 4,
+                    "endIndex": 5
+                  },
+                  "isOptional": true
                 }
               ],
               "isOptional": false,
@@ -19383,6 +19724,68 @@
               "isAbstract": false,
               "name": "restoreCondensePolicies"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#resumeRestoredFlow:member(1)",
+              "docComment": "/**\n * Bring a restored session's flow back to life (GENC-1662). Activates the flow owner — a stateful agent, the only kind that holds a flow — so its `init({ restored })` runs now rather than on the next message, then, when `resumeNote` is given and the agent has not opted out, runs one turn from the restored history with the note in the tail of its first model call.\n *\n * Returns the turn's result when one ran, `undefined` otherwise (no flow owner, the owner is not configured, or no note). Never throws for those cases.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "resumeRestoredFlow(resumeNote?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatDriverResult",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatDriverResult:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 7
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "resumeNote",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "resumeRestoredFlow"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#sendMessage:member(1)",
@@ -22990,6 +23393,33 @@
                 "endIndex": 6
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!StatefulAgentInit#resumeOnRestore:member",
+              "docComment": "/**\n * Whether this agent's flow continues on its own when a page reload interrupted one of its turns — see `AgentConfig.resumeOnRestore`, which this is passed straight through to. Defaults to `true`. A stateful agent is the only kind this applies to, since only it owns a flow.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "resumeOnRestore?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "resumeOnRestore",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!StatefulAgentInit#serialize:member",