@genesislcap/ai-assistant 15.85.1 → 15.86.1

package/dist/ai-assistant.api.json

@@ -3547,7 +3547,7 @@
             },
             {
               "kind": "Content",
-              "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}"
+              "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    readonly CloseRequested: \"close-requested\";\n}"
             }
           ],
           "fileUrlPath": "src/main/main.types.ts",
@@ -9733,7 +9733,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!AutopilotDriver#getPersistedMode:member(1)",
-              "docComment": "/**\n * The mode to save with the session, while it is set for the current flow.\n */\n",
+              "docComment": "/**\n * The mode to save with the session, while it is set for the current flow — or kept for a hand-off's caller while its target releases, saved for that target, as the stack saves it.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -19628,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 * @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",
+          "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 * close-requested - Fired when the user presses the header's Close button, which shows while `closable` is set (the chat bubble sets it while the assistant is in its dialog). Bubbles and composed.\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",
@@ -20806,6 +20806,36 @@
               "isAbstract": false,
               "name": "clearSession"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#closable:member",
+              "docComment": "/**\n * Shows a Close button in the header, which fires `close-requested` and leaves the closing to whatever holds the assistant. The chat bubble sets it while the assistant is in its dialog.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "closable: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "closable",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#closeSettingsModal:member(1)",
@@ -22568,6 +22598,37 @@
               "isAbstract": false,
               "name": "handleAutopilotResume"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#handleClose:member(1)",
+              "docComment": "/**\n * Called when the user clicks the header's Close button.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "handleClose(): "
+                },
+                {
+                  "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": "handleClose"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#handleFileSelect:member(1)",
@@ -33076,7 +33137,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@genesislcap/ai-assistant!PersistedAutopilotMode:interface",
-          "docComment": "/**\n * The autopilot's mode as saved with the session (GENC-1660 §4.8): which flow it was set for, and whether it was running. Cleared when that flow ends, so a saved mode never outlives its flow.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * The autopilot's mode as saved with the session (GENC-1660 §4.8): which flow it was set for, and whether it was running. Cleared when that flow ends, so a saved mode never outlives its flow. A hand-off does not end it: the mode goes with the task to the target, and back (GENC-1751).\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",

package/dist/ai-assistant.d.ts

@@ -799,6 +799,8 @@ export declare const AiAssistantEvent: {
     readonly HandOffReturned: "handoff-returned";
     /** A hand-off ended with no hand-back. `detail`: `HandOffFrame`, with `outcome`. */
     readonly HandOffUnwound: "handoff-unwound";
+    /** The header's Close button pressed, shown while `closable` is set. No `detail`. */
+    readonly CloseRequested: "close-requested";
 };
 
 /**
@@ -1965,6 +1967,16 @@ export declare class AutopilotDriver extends BaseDriverDecorator implements Auto
     private turnHandBack?;
     /** A mode restored with the session, waiting for its flow to become the owner again. */
     private restored?;
+    /**
+     * The mode of a hand-off's target that has released, kept for its caller, which has not taken the
+     * lock back yet (GENC-1751): the flow has no owner in between. See `carriedTo`.
+     */
+    private handingBack?;
+    /**
+     * The mode of the flow that just ended, should a one-way hand-off with nobody waiting turn out to
+     * have ended it: that switch announces itself only after the owner has changed (GENC-1751).
+     */
+    private switchedFrom?;
     /**
      * Bumped on every pause and resume, and when its sessions end. A written answer is sent only if
      * none came between asking for it and its landing: one started before a pause is stale after it,
@@ -2005,7 +2017,10 @@ export declare class AutopilotDriver extends BaseDriverDecorator implements Auto
     pause(): void;
     resume(): void;
     stop(): void;
-    /** The mode to save with the session, while it is set for the current flow. */
+    /**
+     * The mode to save with the session, while it is set for the current flow — or kept for a
+     * hand-off's caller while its target releases, saved for that target, as the stack saves it.
+     */
     getPersistedMode(): PersistedAutopilotMode | undefined;
     /**
      * Bring back a saved mode. It applies once its flow is the owner again — at once if it already
@@ -2157,6 +2172,36 @@ export declare class AutopilotDriver extends BaseDriverDecorator implements Auto
     /** A claimed interaction settled, whoever settled it. */
     private onSettled;
     private onFlowOwnerChanged;
+    /**
+     * A one-way hand-off with nobody waiting is a plain switch, the caller deactivated, so nothing on
+     * the stack says the owner it changed to took over the same task: its event, raised once the
+     * target is active, does (GENC-1751).
+     */
+    private onHandOffStarted;
+    /** The mode set for the current flow, or kept for the caller of a hand-back under way. */
+    private current;
+    /**
+     * The mode that carries to `owner` because the owner changed for a hand-off or its hand-back, as
+     * the hand-off stack shows it at that moment (GENC-1751):
+     * - a hand-off: `owner` is the top frame's target, which has not finished. Its frame is on the
+     *   stack before the target is activated, and so is a waiting caller's passed on by a one-way
+     *   hand-off from a target;
+     * - a hand-back: the top frame's target, which the mode is set for, has finished, and `owner` is
+     *   its caller, or no one while the target releases. Its frame leaves the stack only after the
+     *   caller is active again.
+     *
+     * Clear and an agents change empty the stack before the flow ends, so the mode ends with it, as
+     * it ends with any flow. A turn routed away from the target ends the hand-offs the same way.
+     */
+    private carriedTo;
+    /** Whether `owner` is the caller the top hand-off hands back to from `target`. */
+    private handsBack;
+    /**
+     * Set `carried`'s mode for `owner`, which took the task over in a hand-off or its hand-back. A
+     * pause the person chose carries with it; the autopilot's own hand-back of an interaction does
+     * not, since that interaction settled before the hand-off could start.
+     */
+    private carry;
     private capabilityFor;
     private flowOwner;
     private bindingFor;
@@ -4903,6 +4948,7 @@ export declare function formatBlockedReason(budget?: Partial<Extract<ChatDriverR
  * {@link FoundationAiAssistant.finalizeCostSession} to flush early; it is idempotent.
  *
  * @fires 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`
+ * @fires close-requested - Fired when the user presses the header's Close button, which shows while `closable` is set (the chat bubble sets it while the assistant is in its dialog). Bubbles and composed.
  * @fires 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`
  * @fires handoff-started - Fired when an agent's `handOff` takes effect and its target becomes active. Bubbles and composed. detail: `HandOffFrame`
  * @fires 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`
@@ -4987,6 +5033,11 @@ export declare class FoundationAiAssistant extends GenesisElement {
      * Absent — no button (default standalone behaviour, no breaking change).
      */
     popoutMode?: PopoutMode;
+    /**
+     * Shows a Close button in the header, which fires `close-requested` and leaves the closing to
+     * whatever holds the assistant. The chat bubble sets it while the assistant is in its dialog.
+     */
+    closable: boolean;
     /**
      * Agent configuration. Each user message is routed to the appropriate specialist
      * based on intent. With a single entry, orchestration is skipped.
@@ -6950,6 +7001,8 @@ export declare class FoundationAiAssistant extends GenesisElement {
      * run inside one of the parent's.
      */
     private reportTurnEnded;
+    /** Called when the user clicks the header's Close button. */
+    handleClose(): void;
     onChatHeaderMouseDown(e: MouseEvent): void;
     handleInteractionCompleted(e: Event): void;
     /**
@@ -8300,7 +8353,8 @@ export declare const PERSISTED_SESSION_VERSION = 1;
 
 /**
  * The autopilot's mode as saved with the session (GENC-1660 §4.8): which flow it was set for, and
- * whether it was running. Cleared when that flow ends, so a saved mode never outlives its flow.
+ * whether it was running. Cleared when that flow ends, so a saved mode never outlives its flow. A
+ * hand-off does not end it: the mode goes with the task to the target, and back (GENC-1751).
  *
  * @beta
  */

package/dist/chat-driver.cjs

@@ -4133,6 +4133,8 @@ var META_EVENT_IMPORTANCE = {
   "autopilot.handed-back": "normal",
   "autopilot.paused": "normal",
   "autopilot.resumed": "normal",
+  // The mode went with the task across a hand-off or its hand-back, rather than ending with the flow.
+  "autopilot.carried": "normal",
   // The wrapper itself failed: the journey stops being automatic without anyone choosing that.
   "autopilot.error": "high",
   // A written answer counted against the step's limit; reaching it withdraws `reply`.