@genesislcap/ai-assistant 15.85.0 → 15.85.1

package/dist/custom-elements.json

@@ -1410,75 +1410,265 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/channel/ai-activity-bus.ts",
+      "path": "src/autopilot/autopilot-driver.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "NOOP_ACTIVITY_BUS",
+          "name": "AUTOPILOT_CLAIMANT",
           "type": {
-            "text": "ActivityBus"
+            "text": "string"
           },
-          "default": "{ publish: () => {} }",
-          "description": "No-op ActivityBus. The default when no bus is injected (Node, tests, headless\nserver use) — publishing goes nowhere and nothing is left open to tear down."
+          "default": "'autopilot'",
+          "description": "The holder id the autopilot claims interactions as."
         },
         {
           "kind": "class",
-          "description": "Typed in-process event bus for AI assistant activity events.\n\nDispatches events synchronously to all local subscribers in the same JS module instance\n(i.e. the same browser tab). Events listed in `crossTabEvents` are additionally forwarded\nvia a shared `BroadcastChannel` so that other tabs on the same origin receive them.",
-          "name": "AgenticActivityBus",
+          "description": "Autopilot (GENC-1660): a driver decorator that answers the questions a working agent asks the\nuser, on their behalf, grounded in the agent's autopilot config (for bootstrap, the brief).\n\nNeither side calls the other. The working agent asks as it always does; this driver claims the\ninteractions its policy allows, while it is running for that flow, and answers each in one short\nturn on the flow's `AutopilotSession`. It plugs in only through the generic extension points\n— an interaction interceptor, a handler capability and the flow lifecycle — so the core knows\nnothing about it, and it wraps any `AiDriver`.",
+          "name": "AutopilotDriver",
           "members": [
             {
               "kind": "field",
-              "name": "subscribers",
+              "name": "agents",
+              "type": {
+                "text": "readonly AgentConfig[]"
+              },
               "privacy": "private",
-              "readonly": true,
-              "default": "new Map<string, Set<AnyHandler>>()"
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "crossTabEvents",
+              "name": "providerRegistry",
               "type": {
-                "text": "Set<string>"
+                "text": "AIProviderRegistry"
               },
               "privacy": "private",
-              "readonly": true,
-              "default": "new Set(config?.crossTabEvents ?? [])"
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "channelNameFactory",
+              "name": "sessionKey",
               "type": {
-                "text": "() => string | undefined"
+                "text": "string"
               },
               "privacy": "private",
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "channel",
+              "name": "activityBus",
               "type": {
-                "text": "BroadcastChannel | undefined"
+                "text": "ActivityBus"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "listeners",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Set<() => void>()"
+            },
+            {
+              "kind": "field",
+              "name": "sessions",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Map<string, AutopilotSession>()"
+            },
+            {
+              "kind": "field",
+              "name": "onFor",
+              "type": {
+                "text": "string | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "The flow the mode applies to: set when it is first switched, cleared when that flow ends."
+            },
+            {
+              "kind": "field",
+              "name": "mode",
+              "type": {
+                "text": "'paused' | 'running'"
+              },
+              "privacy": "private",
+              "default": "'paused'"
+            },
+            {
+              "kind": "field",
+              "name": "pauseState",
+              "type": {
+                "text": "AutopilotHostState['pause'] | undefined"
               },
               "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "channelInitialised",
+              "name": "held",
+              "type": {
+                "text": "Held | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "InteractionOpened | undefined"
+              },
+              "privacy": "private",
+              "description": "The interaction open right now, whoever holds it: claimed or not, it was offered here first.\n`held` covers only what the autopilot claimed, so this is how the status knows that the working\nagent is parked on a question left with the person (see `waitingOnUser`)."
+            },
+            {
+              "kind": "field",
+              "name": "declinedWhilePaused",
+              "type": {
+                "text": "InteractionOpened | undefined"
+              },
+              "privacy": "private",
+              "description": "The open interaction, when the autopilot declined it only for being paused as it opened: a live\nResume may still take it (see `takeOpenOnResume`). Cleared when it is taken or settles."
+            },
+            {
+              "kind": "field",
+              "name": "refinements",
+              "type": {
+                "text": "{ key: string; count: number } | undefined"
+              },
+              "privacy": "private",
+              "description": "Refining actions taken on the current step (written answers among them), for the limit."
+            },
+            {
+              "kind": "field",
+              "name": "watchdog",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | undefined"
+              },
+              "privacy": "private",
+              "description": "The watchdog's next check, while a claimed interaction is pending."
+            },
+            {
+              "kind": "field",
+              "name": "endedDiagnostics",
+              "type": {
+                "text": "DiagnosticEntry[]"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "[]",
+              "description": "What sessions that have ended did, kept for the debug log."
+            },
+            {
+              "kind": "field",
+              "name": "consecutiveReplies",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "Written answers sent in a row; see `MAX_CONSECUTIVE_REPLIES`."
+            },
+            {
+              "kind": "field",
+              "name": "turnHandBack",
+              "type": {
+                "text": "{ why: string } | undefined"
+              },
+              "privacy": "private",
+              "description": "Set while the turn-level hand-back waits on the person."
+            },
+            {
+              "kind": "field",
+              "name": "restored",
+              "type": {
+                "text": "PersistedAutopilotMode | undefined"
+              },
+              "privacy": "private",
+              "description": "A mode restored with the session, waiting for its flow to become the owner again."
+            },
+            {
+              "kind": "field",
+              "name": "generation",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "Bumped on every pause and resume, and when its sessions end. A written answer is sent only if\nnone came between asking for it and its landing: one started before a pause is stale after it,\neven once resumed."
+            },
+            {
+              "kind": "field",
+              "name": "turnsInFlight",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "Working turns this driver has started that have not ended yet; see `working`."
+            },
+            {
+              "kind": "field",
+              "name": "answersInFlight",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "Written questions being answered right now; see `working`."
+            },
+            {
+              "kind": "field",
+              "name": "ranSinceStop",
               "type": {
                 "text": "boolean"
               },
               "privacy": "private",
-              "default": "false"
+              "default": "false",
+              "description": "Whether the autopilot has been running, and working, since it last stopped or was paused: so\ngoing idle now is a stop to report. Outlives its flow ending, so a turn still running then is\nwaited out. See `watchForStop`."
+            },
+            {
+              "kind": "field",
+              "name": "stopCheck",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | undefined"
+              },
+              "privacy": "private",
+              "description": "The check that confirms the autopilot stopped, once it looked like it had."
+            },
+            {
+              "kind": "field",
+              "name": "handBackWaits",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Set<() => void>()",
+              "description": "Stops each wait for a widget left with the person to ask them; see `reportHandBackWhenAsking`."
+            },
+            {
+              "kind": "field",
+              "name": "state",
+              "type": {
+                "text": "AutopilotHostState"
+              },
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "ensureChannel",
+              "name": "waitingOnUser",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "boolean"
                 }
               },
-              "description": "Lazily open the cross-tab `BroadcastChannel` on first use. Deferred (rather than\ncreated in the constructor) so that importing this module, or constructing the bus\noff-browser (Node, tests, headless server), never opens a live channel or reads\n`sessionStorage` — both would keep a Node event loop alive and hang the process.\nCross-tab forwarding is inherently browser-only, so channel creation is gated on a\nbrowser environment; elsewhere the bus stays purely in-process."
+              "description": "Whether the working agent is parked on a question the person holds, with the autopilot deciding\nnothing: one it never took — its policy keeps it for the person, it is `userOnly` (the turn-level\nhand-back among them), it has no controller, or it opened while paused and no Resume has taken\nit since (a restored mode takes nothing) — or one another interceptor took and then gave to the\nperson. One the autopilot handed back reads `selfPaused`, and one a pause handed over reads\n`paused`; `state` settles both before asking this.\n\nNever one that asks them nothing (see `asksThePerson`): the person holds it, but it is work\nrunning, which settles by itself, so \"waiting for your answer\" would be untrue. A hand-back is\nreported by the same rule (see `reportHandBackWhenAsking`)."
+            },
+            {
+              "kind": "field",
+              "name": "copy",
+              "type": {
+                "text": "AutopilotCopy"
+              },
+              "readonly": true
             },
             {
               "kind": "method",
@@ -1490,47 +1680,72 @@
               },
               "parameters": [
                 {
-                  "name": "type",
-                  "type": {
-                    "text": "K"
-                  }
-                },
-                {
-                  "name": "handler",
+                  "name": "listener",
                   "type": {
-                    "text": "(detail: AgenticActivityEvents[K]) => void"
+                    "text": "() => void"
                   }
                 }
-              ],
-              "description": "Subscribe to an event. Returns an unsubscribe function — call it in\n`disconnectedCallback` to avoid memory leaks."
+              ]
             },
             {
               "kind": "method",
-              "name": "publish",
+              "name": "pause",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              },
-              "parameters": [
-                {
-                  "name": "type",
-                  "type": {
-                    "text": "K"
-                  }
-                },
+              }
+            },
+            {
+              "kind": "method",
+              "name": "resume",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "stop",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getPersistedMode",
+              "return": {
+                "type": {
+                  "text": "PersistedAutopilotMode | undefined"
+                }
+              },
+              "description": "The mode to save with the session, while it is set for the current flow."
+            },
+            {
+              "kind": "method",
+              "name": "restorePersistedMode",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
                 {
-                  "name": "detail",
+                  "name": "saved",
                   "type": {
-                    "text": "AgenticActivityEvents[K]"
+                    "text": "PersistedAutopilotMode | undefined"
                   }
                 }
               ],
-              "description": "Publish an event to all local subscribers and, if configured, to other tabs\nvia BroadcastChannel."
+              "description": "Bring back a saved mode. It applies once its flow is the owner again — at once if it already\nis, otherwise when the restored flow re-activates. Restoring starts nothing: the autopilot acts\nonly on live events, such as the working agent's own resume asking a question (§4.10, S3)."
             },
             {
               "kind": "method",
-              "name": "addCrossTabEvent",
+              "name": "adoptRestored",
+              "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
@@ -1538,589 +1753,93 @@
               },
               "parameters": [
                 {
-                  "name": "type",
+                  "name": "owner",
                   "type": {
-                    "text": "keyof AgenticActivityEvents"
+                    "text": "string"
                   }
                 }
-              ],
-              "description": "Add an event type to the cross-tab forwarding set at runtime.\nMust be called before the first AgenticActivityBus.publish of that event type."
+              ]
             },
             {
               "kind": "method",
-              "name": "close",
+              "name": "keepPaused",
               "return": {
                 "type": {
                   "text": "void"
                 }
               },
-              "description": "Close the underlying BroadcastChannel. Call once on application teardown if needed."
+              "parameters": [
+                {
+                  "name": "interactionId",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "notifyLocal",
-              "privacy": "private",
+              "name": "sendMessage",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<ChatDriverResult>"
                 }
               },
               "parameters": [
                 {
-                  "name": "type",
+                  "name": "input",
                   "type": {
                     "text": "string"
                   }
                 },
                 {
-                  "name": "detail",
+                  "name": "attachments",
+                  "optional": true,
                   "type": {
-                    "text": "unknown"
+                    "text": "ChatAttachment[]"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "SendMessageOptions"
                   }
                 }
-              ]
-            }
-          ]
-        },
-        {
-          "kind": "variable",
-          "name": "agenticActivityBus",
-          "default": "new AgenticActivityBus({\n  crossTabEvents: ['halo-start', 'halo-stop', 'tool-loop-start', 'tool-loop-end'],\n  // Lazy: the tab-scoped name (and its `sessionStorage` read) is computed on first\n  // cross-tab use in a browser, not at module-eval — so importing this module is\n  // side-effect-free and Node/test-safe.\n  channelNameFactory: () => getTabScopedChannelName('foundation-ai-activity'),\n})",
-          "description": "Pre-instantiated singleton event bus for AI assistant activity.\n\n- `halo-start` / `halo-stop` are forwarded via a tab-scoped `BroadcastChannel` so that\n  popout windows opened from this tab show halo animations, while remaining isolated from\n  unrelated tabs on the same origin (tab-scoped channel name).\n- `tool-loop-start` / `tool-loop-end` are cross-tab for the same reason: they describe the\n  assistant's lifecycle (a turn beginning / ending), and the most common subscribers\n  (workspace transitions, post-turn deferred recomputation, UI gates tied to the assistant\n  being idle) need the event regardless of whether the user is interacting with the chat\n  in the main tab or a popout window. Tab-local-only telemetry can subscribe and filter.\n- `chat-popout` / `chat-popin` are in-memory only — they must only affect the tab where the\n  user clicked."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "NOOP_ACTIVITY_BUS",
-          "declaration": {
-            "name": "NOOP_ACTIVITY_BUS",
-            "module": "src/channel/ai-activity-bus.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AgenticActivityBus",
-          "declaration": {
-            "name": "AgenticActivityBus",
-            "module": "src/channel/ai-activity-bus.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "agenticActivityBus",
-          "declaration": {
-            "name": "agenticActivityBus",
-            "module": "src/channel/ai-activity-bus.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/channel/ai-activity-channel.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/channel/autopilot-needs-user.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "setAutopilotNeedsUser",
-          "return": {
-            "type": {
-              "text": "void"
-            }
-          },
-          "parameters": [
-            {
-              "name": "sessionKey",
-              "type": {
-                "text": "string"
+              ],
+              "inheritedFrom": {
+                "name": "BaseDriverDecorator",
+                "module": "src/components/ai-driver/base-driver-decorator.ts"
               }
             },
             {
-              "name": "needsUser",
-              "type": {
-                "text": "boolean"
-              }
-            }
-          ],
-          "description": "Set it for one session, announcing `autopilot-needs-user` when it changes."
-        },
-        {
-          "kind": "function",
-          "name": "autopilotNeedsUser",
-          "return": {
-            "type": {
-              "text": "boolean"
-            }
-          },
-          "parameters": [
-            {
-              "name": "sessionKey",
-              "optional": true,
-              "type": {
-                "text": "string"
-              }
-            }
-          ],
-          "description": "Whether a session has something waiting on the person — or, without a key (a bubble that cannot\ntell which assistant it holds), whether any session has."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "setAutopilotNeedsUser",
-          "declaration": {
-            "name": "setAutopilotNeedsUser",
-            "module": "src/channel/autopilot-needs-user.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "autopilotNeedsUser",
-          "declaration": {
-            "name": "autopilotNeedsUser",
-            "module": "src/channel/autopilot-needs-user.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/autopilot/autopilot-driver.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "AUTOPILOT_CLAIMANT",
-          "type": {
-            "text": "string"
-          },
-          "default": "'autopilot'",
-          "description": "The holder id the autopilot claims interactions as."
-        },
-        {
-          "kind": "class",
-          "description": "Autopilot (GENC-1660): a driver decorator that answers the questions a working agent asks the\nuser, on their behalf, grounded in the agent's autopilot config (for bootstrap, the brief).\n\nNeither side calls the other. The working agent asks as it always does; this driver claims the\ninteractions its policy allows, while it is running for that flow, and answers each in one short\nturn on the flow's `AutopilotSession`. It plugs in only through the generic extension points\n— an interaction interceptor, a handler capability and the flow lifecycle — so the core knows\nnothing about it, and it wraps any `AiDriver`.",
-          "name": "AutopilotDriver",
-          "members": [
-            {
-              "kind": "field",
-              "name": "agents",
-              "type": {
-                "text": "readonly AgentConfig[]"
+              "kind": "method",
+              "name": "continueFromHistory",
+              "return": {
+                "type": {
+                  "text": "Promise<ChatDriverResult>"
+                }
               },
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "providerRegistry",
-              "type": {
-                "text": "AIProviderRegistry"
-              },
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "sessionKey",
-              "type": {
-                "text": "string"
-              },
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "activityBus",
-              "type": {
-                "text": "ActivityBus"
-              },
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "listeners",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new Set<() => void>()"
-            },
-            {
-              "kind": "field",
-              "name": "sessions",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new Map<string, AutopilotSession>()"
-            },
-            {
-              "kind": "field",
-              "name": "onFor",
-              "type": {
-                "text": "string | null"
-              },
-              "privacy": "private",
-              "default": "null",
-              "description": "The flow the mode applies to: set when it is first switched, cleared when that flow ends."
-            },
-            {
-              "kind": "field",
-              "name": "mode",
-              "type": {
-                "text": "'paused' | 'running'"
-              },
-              "privacy": "private",
-              "default": "'paused'"
-            },
-            {
-              "kind": "field",
-              "name": "pauseState",
-              "type": {
-                "text": "AutopilotHostState['pause'] | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "held",
-              "type": {
-                "text": "Held | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "open",
-              "type": {
-                "text": "InteractionOpened | undefined"
-              },
-              "privacy": "private",
-              "description": "The interaction open right now, whoever holds it: claimed or not, it was offered here first.\n`held` covers only what the autopilot claimed, so this is how the status knows that the working\nagent is parked on a question left with the person (see `waitingOnUser`)."
-            },
-            {
-              "kind": "field",
-              "name": "declinedWhilePaused",
-              "type": {
-                "text": "InteractionOpened | undefined"
-              },
-              "privacy": "private",
-              "description": "The open interaction, when the autopilot declined it only for being paused as it opened: a live\nResume may still take it (see `takeOpenOnResume`). Cleared when it is taken or settles."
-            },
-            {
-              "kind": "field",
-              "name": "refinements",
-              "type": {
-                "text": "{ key: string; count: number } | undefined"
-              },
-              "privacy": "private",
-              "description": "Refining actions taken on the current step (written answers among them), for the limit."
-            },
-            {
-              "kind": "field",
-              "name": "watchdog",
-              "type": {
-                "text": "ReturnType<typeof setTimeout> | undefined"
-              },
-              "privacy": "private",
-              "description": "The watchdog's next check, while a claimed interaction is pending."
-            },
-            {
-              "kind": "field",
-              "name": "endedDiagnostics",
-              "type": {
-                "text": "DiagnosticEntry[]"
-              },
-              "privacy": "private",
-              "readonly": true,
-              "default": "[]",
-              "description": "What sessions that have ended did, kept for the debug log."
-            },
-            {
-              "kind": "field",
-              "name": "consecutiveReplies",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "0",
-              "description": "Written answers sent in a row; see `MAX_CONSECUTIVE_REPLIES`."
-            },
-            {
-              "kind": "field",
-              "name": "turnHandBack",
-              "type": {
-                "text": "{ why: string } | undefined"
-              },
-              "privacy": "private",
-              "description": "Set while the turn-level hand-back waits on the person."
-            },
-            {
-              "kind": "field",
-              "name": "restored",
-              "type": {
-                "text": "PersistedAutopilotMode | undefined"
-              },
-              "privacy": "private",
-              "description": "A mode restored with the session, waiting for its flow to become the owner again."
-            },
-            {
-              "kind": "field",
-              "name": "generation",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "0",
-              "description": "Bumped on every pause and resume, and when its sessions end. A written answer is sent only if\nnone came between asking for it and its landing: one started before a pause is stale after it,\neven once resumed."
-            },
-            {
-              "kind": "field",
-              "name": "turnsInFlight",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "0",
-              "description": "Working turns this driver has started that have not ended yet; see `working`."
-            },
-            {
-              "kind": "field",
-              "name": "answersInFlight",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "0",
-              "description": "Written questions being answered right now; see `working`."
-            },
-            {
-              "kind": "field",
-              "name": "ranSinceStop",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false",
-              "description": "Whether the autopilot has been running, and working, since it last stopped or was paused: so\ngoing idle now is a stop to report. Outlives its flow ending, so a turn still running then is\nwaited out. See `watchForStop`."
-            },
-            {
-              "kind": "field",
-              "name": "stopCheck",
-              "type": {
-                "text": "ReturnType<typeof setTimeout> | undefined"
-              },
-              "privacy": "private",
-              "description": "The check that confirms the autopilot stopped, once it looked like it had."
-            },
-            {
-              "kind": "field",
-              "name": "handBackWaits",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new Set<() => void>()",
-              "description": "Stops each wait for a widget left with the person to ask them; see `reportHandBackWhenAsking`."
-            },
-            {
-              "kind": "field",
-              "name": "state",
-              "type": {
-                "text": "AutopilotHostState"
-              },
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "waitingOnUser",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "description": "Whether the working agent is parked on a question the person holds, with the autopilot deciding\nnothing: one it never took — its policy keeps it for the person, it is `userOnly` (the turn-level\nhand-back among them), it has no controller, or it opened while paused and no Resume has taken\nit since (a restored mode takes nothing) — or one another interceptor took and then gave to the\nperson. One the autopilot handed back reads `selfPaused`, and one a pause handed over reads\n`paused`; `state` settles both before asking this.\n\nNever one that asks them nothing (see `asksThePerson`): the person holds it, but it is work\nrunning, which settles by itself, so \"waiting for your answer\" would be untrue. A hand-back is\nreported by the same rule (see `reportHandBackWhenAsking`)."
-            },
-            {
-              "kind": "field",
-              "name": "copy",
-              "type": {
-                "text": "AutopilotCopy"
-              },
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "subscribe",
-              "return": {
-                "type": {
-                  "text": "() => void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "listener",
-                  "type": {
-                    "text": "() => void"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "pause",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "resume",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "stop",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "getPersistedMode",
-              "return": {
-                "type": {
-                  "text": "PersistedAutopilotMode | undefined"
-                }
-              },
-              "description": "The mode to save with the session, while it is set for the current flow."
-            },
-            {
-              "kind": "method",
-              "name": "restorePersistedMode",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "saved",
-                  "type": {
-                    "text": "PersistedAutopilotMode | undefined"
-                  }
-                }
-              ],
-              "description": "Bring back a saved mode. It applies once its flow is the owner again — at once if it already\nis, otherwise when the restored flow re-activates. Restoring starts nothing: the autopilot acts\nonly on live events, such as the working agent's own resume asking a question (§4.10, S3)."
-            },
-            {
-              "kind": "method",
-              "name": "adoptRestored",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "owner",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "keepPaused",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "interactionId",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "sendMessage",
-              "return": {
-                "type": {
-                  "text": "Promise<ChatDriverResult>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "input",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "attachments",
-                  "optional": true,
-                  "type": {
-                    "text": "ChatAttachment[]"
-                  }
-                },
-                {
-                  "name": "options",
-                  "optional": true,
-                  "type": {
-                    "text": "SendMessageOptions"
-                  }
-                }
-              ],
-              "inheritedFrom": {
-                "name": "BaseDriverDecorator",
-                "module": "src/components/ai-driver/base-driver-decorator.ts"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "continueFromHistory",
-              "return": {
-                "type": {
-                  "text": "Promise<ChatDriverResult>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "transientPrimer",
-                  "optional": true,
-                  "type": {
-                    "text": "ChatMessage[]"
-                  }
-                },
-                {
-                  "name": "options",
-                  "optional": true,
-                  "type": {
-                    "text": "ContinueFromHistoryOptions"
-                  }
-                }
-              ],
-              "inheritedFrom": {
-                "name": "BaseDriverDecorator",
-                "module": "src/components/ai-driver/base-driver-decorator.ts"
-              }
+              "parameters": [
+                {
+                  "name": "transientPrimer",
+                  "optional": true,
+                  "type": {
+                    "text": "ChatMessage[]"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "ContinueFromHistoryOptions"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "BaseDriverDecorator",
+                "module": "src/components/ai-driver/base-driver-decorator.ts"
+              }
             },
             {
               "kind": "method",
@@ -4861,83 +4580,364 @@
           }
         },
         {
-          "kind": "js",
-          "name": "type",
-          "declaration": {
-            "name": "type",
-            "module": "./widget-tools"
-          }
+          "kind": "js",
+          "name": "type",
+          "declaration": {
+            "name": "type",
+            "module": "./widget-tools"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "WidgetTools",
+          "declaration": {
+            "name": "WidgetTools",
+            "module": "./widget-tools"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "type",
+          "declaration": {
+            "name": "type",
+            "module": "./widget-tools"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "WidgetToolSpec",
+          "declaration": {
+            "name": "WidgetToolSpec",
+            "module": "./widget-tools"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AutopilotHandBack",
+          "declaration": {
+            "name": "AutopilotHandBack",
+            "module": "./hand-back/hand-back"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/autopilot/widget-tools.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "widgetTools",
+          "return": {
+            "type": {
+              "text": "WidgetTools"
+            }
+          },
+          "parameters": [
+            {
+              "name": "componentName",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "tools",
+              "type": {
+                "text": "{ [K in keyof TArgs]: WidgetToolSpec<TController, TArgs[K]> }"
+              }
+            }
+          ],
+          "description": "Declare tools that read from one widget type (GENC-1660): parameterised reads that a view cannot\nexpress, such as one table's rows, or a page of them.\n\nPut them on the autopilot (`defineAutopilot({ widgetTools: [...] })`), never discovered from the\nregistration. Its tool list is fixed when its session starts, sorted by name, and identical for\nevery decision, so the cache never breaks. Each call is routed to the interaction of\n`componentName` the autopilot is deciding, and `run` gets its controller; with none open, it is\nrefused with a reason. While one is open, the autopilot's tail says which tools are usable now.\n\nReads only. Their results leave the autopilot's history at the end of the decision, as\n`widget_read`'s do."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "widgetTools",
+          "declaration": {
+            "name": "widgetTools",
+            "module": "src/autopilot/widget-tools.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/channel/ai-activity-bus.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "NOOP_ACTIVITY_BUS",
+          "type": {
+            "text": "ActivityBus"
+          },
+          "default": "{ publish: () => {} }",
+          "description": "No-op ActivityBus. The default when no bus is injected (Node, tests, headless\nserver use) — publishing goes nowhere and nothing is left open to tear down."
+        },
+        {
+          "kind": "class",
+          "description": "Typed in-process event bus for AI assistant activity events.\n\nDispatches events synchronously to all local subscribers in the same JS module instance\n(i.e. the same browser tab). Events listed in `crossTabEvents` are additionally forwarded\nvia a shared `BroadcastChannel` so that other tabs on the same origin receive them.",
+          "name": "AgenticActivityBus",
+          "members": [
+            {
+              "kind": "field",
+              "name": "subscribers",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Map<string, Set<AnyHandler>>()"
+            },
+            {
+              "kind": "field",
+              "name": "crossTabEvents",
+              "type": {
+                "text": "Set<string>"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Set(config?.crossTabEvents ?? [])"
+            },
+            {
+              "kind": "field",
+              "name": "channelNameFactory",
+              "type": {
+                "text": "() => string | undefined"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "channel",
+              "type": {
+                "text": "BroadcastChannel | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "channelInitialised",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "method",
+              "name": "ensureChannel",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Lazily open the cross-tab `BroadcastChannel` on first use. Deferred (rather than\ncreated in the constructor) so that importing this module, or constructing the bus\noff-browser (Node, tests, headless server), never opens a live channel or reads\n`sessionStorage` — both would keep a Node event loop alive and hang the process.\nCross-tab forwarding is inherently browser-only, so channel creation is gated on a\nbrowser environment; elsewhere the bus stays purely in-process."
+            },
+            {
+              "kind": "method",
+              "name": "subscribe",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "handler",
+                  "type": {
+                    "text": "(detail: AgenticActivityEvents[K]) => void"
+                  }
+                }
+              ],
+              "description": "Subscribe to an event. Returns an unsubscribe function — call it in\n`disconnectedCallback` to avoid memory leaks."
+            },
+            {
+              "kind": "method",
+              "name": "publish",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "detail",
+                  "type": {
+                    "text": "AgenticActivityEvents[K]"
+                  }
+                }
+              ],
+              "description": "Publish an event to all local subscribers and, if configured, to other tabs\nvia BroadcastChannel."
+            },
+            {
+              "kind": "method",
+              "name": "addCrossTabEvent",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "keyof AgenticActivityEvents"
+                  }
+                }
+              ],
+              "description": "Add an event type to the cross-tab forwarding set at runtime.\nMust be called before the first AgenticActivityBus.publish of that event type."
+            },
+            {
+              "kind": "method",
+              "name": "close",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Close the underlying BroadcastChannel. Call once on application teardown if needed."
+            },
+            {
+              "kind": "method",
+              "name": "notifyLocal",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "detail",
+                  "type": {
+                    "text": "unknown"
+                  }
+                }
+              ]
+            }
+          ]
         },
         {
-          "kind": "js",
-          "name": "WidgetTools",
-          "declaration": {
-            "name": "WidgetTools",
-            "module": "./widget-tools"
-          }
-        },
+          "kind": "variable",
+          "name": "agenticActivityBus",
+          "default": "new AgenticActivityBus({\n  crossTabEvents: ['halo-start', 'halo-stop', 'tool-loop-start', 'tool-loop-end'],\n  // Lazy: the tab-scoped name (and its `sessionStorage` read) is computed on first\n  // cross-tab use in a browser, not at module-eval — so importing this module is\n  // side-effect-free and Node/test-safe.\n  channelNameFactory: () => getTabScopedChannelName('foundation-ai-activity'),\n})",
+          "description": "Pre-instantiated singleton event bus for AI assistant activity.\n\n- `halo-start` / `halo-stop` are forwarded via a tab-scoped `BroadcastChannel` so that\n  popout windows opened from this tab show halo animations, while remaining isolated from\n  unrelated tabs on the same origin (tab-scoped channel name).\n- `tool-loop-start` / `tool-loop-end` are cross-tab for the same reason: they describe the\n  assistant's lifecycle (a turn beginning / ending), and the most common subscribers\n  (workspace transitions, post-turn deferred recomputation, UI gates tied to the assistant\n  being idle) need the event regardless of whether the user is interacting with the chat\n  in the main tab or a popout window. Tab-local-only telemetry can subscribe and filter.\n- `chat-popout` / `chat-popin` are in-memory only — they must only affect the tab where the\n  user clicked."
+        }
+      ],
+      "exports": [
         {
           "kind": "js",
-          "name": "type",
+          "name": "NOOP_ACTIVITY_BUS",
           "declaration": {
-            "name": "type",
-            "module": "./widget-tools"
+            "name": "NOOP_ACTIVITY_BUS",
+            "module": "src/channel/ai-activity-bus.ts"
           }
         },
         {
           "kind": "js",
-          "name": "WidgetToolSpec",
+          "name": "AgenticActivityBus",
           "declaration": {
-            "name": "WidgetToolSpec",
-            "module": "./widget-tools"
+            "name": "AgenticActivityBus",
+            "module": "src/channel/ai-activity-bus.ts"
           }
         },
         {
           "kind": "js",
-          "name": "AutopilotHandBack",
+          "name": "agenticActivityBus",
           "declaration": {
-            "name": "AutopilotHandBack",
-            "module": "./hand-back/hand-back"
+            "name": "agenticActivityBus",
+            "module": "src/channel/ai-activity-bus.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/autopilot/widget-tools.ts",
+      "path": "src/channel/ai-activity-channel.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/channel/autopilot-needs-user.ts",
       "declarations": [
         {
           "kind": "function",
-          "name": "widgetTools",
+          "name": "setAutopilotNeedsUser",
           "return": {
             "type": {
-              "text": "WidgetTools"
+              "text": "void"
             }
           },
           "parameters": [
             {
-              "name": "componentName",
+              "name": "sessionKey",
               "type": {
                 "text": "string"
               }
             },
             {
-              "name": "tools",
+              "name": "needsUser",
               "type": {
-                "text": "{ [K in keyof TArgs]: WidgetToolSpec<TController, TArgs[K]> }"
+                "text": "boolean"
               }
             }
           ],
-          "description": "Declare tools that read from one widget type (GENC-1660): parameterised reads that a view cannot\nexpress, such as one table's rows, or a page of them.\n\nPut them on the autopilot (`defineAutopilot({ widgetTools: [...] })`), never discovered from the\nregistration. Its tool list is fixed when its session starts, sorted by name, and identical for\nevery decision, so the cache never breaks. Each call is routed to the interaction of\n`componentName` the autopilot is deciding, and `run` gets its controller; with none open, it is\nrefused with a reason. While one is open, the autopilot's tail says which tools are usable now.\n\nReads only. Their results leave the autopilot's history at the end of the decision, as\n`widget_read`'s do."
+          "description": "Set it for one session, announcing `autopilot-needs-user` when it changes."
+        },
+        {
+          "kind": "function",
+          "name": "autopilotNeedsUser",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "sessionKey",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Whether a session has something waiting on the person — or, without a key (a bubble that cannot\ntell which assistant it holds), whether any session has."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "widgetTools",
+          "name": "setAutopilotNeedsUser",
           "declaration": {
-            "name": "widgetTools",
-            "module": "src/autopilot/widget-tools.ts"
+            "name": "setAutopilotNeedsUser",
+            "module": "src/channel/autopilot-needs-user.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "autopilotNeedsUser",
+          "declaration": {
+            "name": "autopilotNeedsUser",
+            "module": "src/channel/autopilot-needs-user.ts"
           }
         }
       ]
@@ -23196,7 +23196,7 @@
                   }
                 }
               ],
-              "description": "Act on what the agent call that just ended asked for, and run the next agent in the same user\nturn while there is one (GENC-1737): a `handOff` runs its target with the brief, and a target\nthat releases hands back to its caller. Returns the last call's result.\n\nA failed call ends the turn there, as a Stop does: what it asked for still happens, and the\nnext agent runs on the next message. Running it now would meet the same wall (a budget, a\nrefused account, a full context window), or build on a reply that never came."
+              "description": "Act on what the agent call that just ended asked for, and run the next agent in the same user\nturn while there is one (GENC-1737): a `handOff` runs its target with the brief, and a target\nthat releases hands back to its caller. Returns the last call's result.\n\nA failed call ends the turn there, as a Stop does: what it asked for still happens, and the\nnext agent runs on the next message. Running it now would meet the same wall (a budget, a\nrefused account, a full context window), or build on a reply that never came. The one thing a\nStop takes back is a hand-off that has not started (see `afterAgentCall`)."
             },
             {
               "kind": "method",
@@ -23207,7 +23207,7 @@
                   "text": "Promise<string | undefined>"
                 }
               },
-              "description": "After one agent call: start the hand-off it asked for, or release it and, when it was a\nhand-off's target, hand back. Returns the tail note for the agent to run next, or `undefined`\nwhen the turn ends here.\n\nA plain target hands back when its call ends, released or not, as a plain agent is done once\nit has answered. A stateful one holds the hand-off until it releases, as it holds its flow."
+              "description": "After one agent call: start the hand-off it asked for, or release it and, when it was a\nhand-off's target, hand back. Returns the tail note for the agent to run next, or `undefined`\nwhen the turn ends here.\n\nA plain target hands back when its call ends, released or not, as a plain agent is done once\nit has answered. A stateful one holds the hand-off until it releases, as it holds its flow.\n\nA Stop cancels a hand-off that has not started: the user stopped the turn the caller asked for\nit in, often during the caller's closing call, so the target is not activated, and the call\nends as if it had never asked (a plain caller's turn ends as usual below). A hand-back is not\ntaken back: the target finished the work it was given."
             },
             {
               "kind": "method",