@genesislcap/ai-assistant 14.437.6 → 14.438.0

package/dist/ai-assistant.api.json

@@ -568,7 +568,7 @@
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/ai-assistant!agenticActivityBus:var",
-          "docComment": "/**\n * Pre-instantiated singleton event bus for AI assistant activity.\n *\n * - `halo-start` / `halo-stop` are forwarded via a tab-scoped `BroadcastChannel` so that popout windows opened from this tab show halo animations, while remaining isolated from unrelated tabs on the same origin (tab-scoped channel name). - `chat-popout` / `chat-popin` are in-memory only — they must only affect the tab where the user clicked.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Pre-instantiated singleton event bus for AI assistant activity.\n *\n * - `halo-start` / `halo-stop` are forwarded via a tab-scoped `BroadcastChannel` so that popout windows opened from this tab show halo animations, while remaining isolated from unrelated tabs on the same origin (tab-scoped channel name). - `tool-loop-start` / `tool-loop-end` are cross-tab for the same reason: they describe the assistant's lifecycle (a turn beginning / ending), and the most common subscribers (workspace transitions, post-turn deferred recomputation, UI gates tied to the assistant being idle) need the event regardless of whether the user is interacting with the chat in the main tab or a popout window. Tab-local-only telemetry can subscribe and filter. - `chat-popout` / `chat-popin` are in-memory only — they must only affect the tab where the user clicked.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -792,6 +792,60 @@
                 "startIndex": 1,
                 "endIndex": 2
               }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AgenticActivityEvents#\"tool-loop-end\":member",
+              "docComment": "/**\n * Fired when the tool loop completes for the current turn and control returns to the user on the **main chat prompt** (i.e. the next free-form user message can now be accepted).\n *\n * Boundary: this is the moment the user regains control of the main chat input. It is **not** fired when a tool handler hands a widget to the user mid-loop (e.g. while a planning widget is awaiting a click) — widget pauses are still inside the loop, the assistant still owns the turn, and the main chat input may be hidden during them. Wait for this event when you need to know that the assistant is fully idle and the user can type freely again.\n *\n * Emitted from the finally block of each `ChatDriver`'s `sendMessage` and `continueFromHistory`, so a multi-agent handoff fires this event once per agent.\n *\n * Distinct from {@link AgenticActivityEvents.'halo-stop'} — the halo event tracks the spinner animation lifecycle (which can flap mid-turn as tool calls resolve), whereas this event is a one-shot per turn boundary. Use this for hooks tied to a turn ending (telemetry flushes, post-turn workspace transitions, deferred state recomputation).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "'tool-loop-end': "
+                },
+                {
+                  "kind": "Content",
+                  "text": "undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "\"tool-loop-end\"",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AgenticActivityEvents#\"tool-loop-start\":member",
+              "docComment": "/**\n * Fired immediately before the tool loop begins running for the current turn — after the busy flag is set and the user message (if any) has been appended, but before the first provider call. Pairs with {@link AgenticActivityEvents.'tool-loop-end'}.\n *\n * Boundary: this is the moment the assistant takes control from the user on the **main chat prompt** to begin a turn. It is **not** fired when a tool handler temporarily hands a widget to the user mid-loop (e.g. `requestInteraction` pausing a handler while a planning widget is rendered) — those widget pauses happen inside the loop and the assistant is still considered to own the turn.\n *\n * Fires from each `ChatDriver`'s `sendMessage` and `continueFromHistory`, so during a multi-agent handoff orchestrated by `OrchestratingDriver` it fires once per agent the orchestrator hands off to.\n *\n * Distinct from {@link AgenticActivityEvents.'halo-start'} — the halo event is keyed to tool-call messages arriving in the stream (UI animation concern), not to the loop boundary itself. Use this event for hooks tied to a turn beginning (telemetry, transient UI gates).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "'tool-loop-start': "
+                },
+                {
+                  "kind": "Content",
+                  "text": "undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "\"tool-loop-start\"",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
             }
           ],
           "extendsTokenRanges": []

package/dist/ai-assistant.d.ts

@@ -84,6 +84,11 @@ export declare class AgenticActivityBus {
  * - `halo-start` / `halo-stop` are forwarded via a tab-scoped `BroadcastChannel` so that
  *   popout windows opened from this tab show halo animations, while remaining isolated from
  *   unrelated tabs on the same origin (tab-scoped channel name).
+ * - `tool-loop-start` / `tool-loop-end` are cross-tab for the same reason: they describe the
+ *   assistant's lifecycle (a turn beginning / ending), and the most common subscribers
+ *   (workspace transitions, post-turn deferred recomputation, UI gates tied to the assistant
+ *   being idle) need the event regardless of whether the user is interacting with the chat
+ *   in the main tab or a popout window. Tab-local-only telemetry can subscribe and filter.
  * - `chat-popout` / `chat-popin` are in-memory only — they must only affect the tab where the
  *   user clicked.
  *
@@ -128,6 +133,46 @@ export declare interface AgenticActivityEvents {
     'chat-popout': undefined;
     /** Fired when the user clicks the collapse button — moves assistant from layout back to bubble. State lives in the session store, not in this event. */
     'chat-popin': undefined;
+    /**
+     * Fired immediately before the tool loop begins running for the current turn — after the busy
+     * flag is set and the user message (if any) has been appended, but before the first
+     * provider call. Pairs with {@link AgenticActivityEvents.'tool-loop-end'}.
+     *
+     * Boundary: this is the moment the assistant takes control from the user on the **main chat
+     * prompt** to begin a turn. It is **not** fired when a tool handler temporarily hands a
+     * widget to the user mid-loop (e.g. `requestInteraction` pausing a handler while a planning
+     * widget is rendered) — those widget pauses happen inside the loop and the assistant is
+     * still considered to own the turn.
+     *
+     * Fires from each `ChatDriver`'s `sendMessage` and `continueFromHistory`, so during a
+     * multi-agent handoff orchestrated by `OrchestratingDriver` it fires once per agent
+     * the orchestrator hands off to.
+     *
+     * Distinct from {@link AgenticActivityEvents.'halo-start'} — the halo event is keyed to
+     * tool-call messages arriving in the stream (UI animation concern), not to the loop boundary
+     * itself. Use this event for hooks tied to a turn beginning (telemetry, transient UI gates).
+     */
+    'tool-loop-start': undefined;
+    /**
+     * Fired when the tool loop completes for the current turn and control returns to the user
+     * on the **main chat prompt** (i.e. the next free-form user message can now be accepted).
+     *
+     * Boundary: this is the moment the user regains control of the main chat input. It is
+     * **not** fired when a tool handler hands a widget to the user mid-loop (e.g. while a
+     * planning widget is awaiting a click) — widget pauses are still inside the loop, the
+     * assistant still owns the turn, and the main chat input may be hidden during them. Wait
+     * for this event when you need to know that the assistant is fully idle and the user can
+     * type freely again.
+     *
+     * Emitted from the finally block of each `ChatDriver`'s `sendMessage` and
+     * `continueFromHistory`, so a multi-agent handoff fires this event once per agent.
+     *
+     * Distinct from {@link AgenticActivityEvents.'halo-stop'} — the halo event tracks the
+     * spinner animation lifecycle (which can flap mid-turn as tool calls resolve), whereas
+     * this event is a one-shot per turn boundary. Use this for hooks tied to a turn ending
+     * (telemetry flushes, post-turn workspace transitions, deferred state recomputation).
+     */
+    'tool-loop-end': undefined;
 }
 
 /**

package/dist/dts/channel/ai-activity-bus.d.ts

@@ -68,6 +68,11 @@ export declare class AgenticActivityBus {
  * - `halo-start` / `halo-stop` are forwarded via a tab-scoped `BroadcastChannel` so that
  *   popout windows opened from this tab show halo animations, while remaining isolated from
  *   unrelated tabs on the same origin (tab-scoped channel name).
+ * - `tool-loop-start` / `tool-loop-end` are cross-tab for the same reason: they describe the
+ *   assistant's lifecycle (a turn beginning / ending), and the most common subscribers
+ *   (workspace transitions, post-turn deferred recomputation, UI gates tied to the assistant
+ *   being idle) need the event regardless of whether the user is interacting with the chat
+ *   in the main tab or a popout window. Tab-local-only telemetry can subscribe and filter.
  * - `chat-popout` / `chat-popin` are in-memory only — they must only affect the tab where the
  *   user clicked.
  *

package/dist/dts/channel/ai-activity-bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-activity-bus.d.ts","sourceRoot":"","sources":["../../../src/channel/ai-activity-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,+EAA+E;IAC/E,cAAc,CAAC,EAAE,CAAC,MAAM,qBAAqB,CAAC,EAAE,CAAC;IACjD,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAClE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAc;IAC7C,OAAO,CAAC,OAAO,CAAC,CAAmB;IAEnC;;;OAGG;gBACS,MAAM,CAAC,EAAE,wBAAwB;IAW7C;;;;;OAKG;IACH,SAAS,CAAC,CAAC,SAAS,MAAM,qBAAqB,EAC7C,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,GAClD,MAAM,IAAI;IAWb;;;;;OAKG;IACH,OAAO,CAAC,CAAC,SAAS,MAAM,qBAAqB,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI;IAO/F;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,qBAAqB,GAAG,IAAI;IAIzD;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,WAAW;CAGpB;AA6BD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,oBAG7B,CAAC"}
+{"version":3,"file":"ai-activity-bus.d.ts","sourceRoot":"","sources":["../../../src/channel/ai-activity-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,+EAA+E;IAC/E,cAAc,CAAC,EAAE,CAAC,MAAM,qBAAqB,CAAC,EAAE,CAAC;IACjD,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAClE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAc;IAC7C,OAAO,CAAC,OAAO,CAAC,CAAmB;IAEnC;;;OAGG;gBACS,MAAM,CAAC,EAAE,wBAAwB;IAW7C;;;;;OAKG;IACH,SAAS,CAAC,CAAC,SAAS,MAAM,qBAAqB,EAC7C,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,GAClD,MAAM,IAAI;IAWb;;;;;OAKG;IACH,OAAO,CAAC,CAAC,SAAS,MAAM,qBAAqB,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI;IAO/F;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,qBAAqB,GAAG,IAAI;IAIzD;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,WAAW;CAGpB;AA6BD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,kBAAkB,oBAG7B,CAAC"}

package/dist/dts/channel/ai-activity-channel.d.ts

@@ -23,5 +23,45 @@ export interface AgenticActivityEvents {
     'chat-popout': undefined;
     /** Fired when the user clicks the collapse button — moves assistant from layout back to bubble. State lives in the session store, not in this event. */
     'chat-popin': undefined;
+    /**
+     * Fired immediately before the tool loop begins running for the current turn — after the busy
+     * flag is set and the user message (if any) has been appended, but before the first
+     * provider call. Pairs with {@link AgenticActivityEvents.'tool-loop-end'}.
+     *
+     * Boundary: this is the moment the assistant takes control from the user on the **main chat
+     * prompt** to begin a turn. It is **not** fired when a tool handler temporarily hands a
+     * widget to the user mid-loop (e.g. `requestInteraction` pausing a handler while a planning
+     * widget is rendered) — those widget pauses happen inside the loop and the assistant is
+     * still considered to own the turn.
+     *
+     * Fires from each `ChatDriver`'s `sendMessage` and `continueFromHistory`, so during a
+     * multi-agent handoff orchestrated by `OrchestratingDriver` it fires once per agent
+     * the orchestrator hands off to.
+     *
+     * Distinct from {@link AgenticActivityEvents.'halo-start'} — the halo event is keyed to
+     * tool-call messages arriving in the stream (UI animation concern), not to the loop boundary
+     * itself. Use this event for hooks tied to a turn beginning (telemetry, transient UI gates).
+     */
+    'tool-loop-start': undefined;
+    /**
+     * Fired when the tool loop completes for the current turn and control returns to the user
+     * on the **main chat prompt** (i.e. the next free-form user message can now be accepted).
+     *
+     * Boundary: this is the moment the user regains control of the main chat input. It is
+     * **not** fired when a tool handler hands a widget to the user mid-loop (e.g. while a
+     * planning widget is awaiting a click) — widget pauses are still inside the loop, the
+     * assistant still owns the turn, and the main chat input may be hidden during them. Wait
+     * for this event when you need to know that the assistant is fully idle and the user can
+     * type freely again.
+     *
+     * Emitted from the finally block of each `ChatDriver`'s `sendMessage` and
+     * `continueFromHistory`, so a multi-agent handoff fires this event once per agent.
+     *
+     * Distinct from {@link AgenticActivityEvents.'halo-stop'} — the halo event tracks the
+     * spinner animation lifecycle (which can flap mid-turn as tool calls resolve), whereas
+     * this event is a one-shot per turn boundary. Use this for hooks tied to a turn ending
+     * (telemetry flushes, post-turn workspace transitions, deferred state recomputation).
+     */
+    'tool-loop-end': undefined;
 }
 //# sourceMappingURL=ai-activity-channel.d.ts.map

package/dist/dts/channel/ai-activity-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-activity-channel.d.ts","sourceRoot":"","sources":["../../../src/channel/ai-activity-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,qBAAqB;IACpC,2FAA2F;IAC3F,YAAY,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACtC,iFAAiF;IACjF,WAAW,EAAE,SAAS,CAAC;IACvB,mJAAmJ;IACnJ,aAAa,EAAE,SAAS,CAAC;IACzB,wJAAwJ;IACxJ,YAAY,EAAE,SAAS,CAAC;CACzB"}
+{"version":3,"file":"ai-activity-channel.d.ts","sourceRoot":"","sources":["../../../src/channel/ai-activity-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,qBAAqB;IACpC,2FAA2F;IAC3F,YAAY,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACtC,iFAAiF;IACjF,WAAW,EAAE,SAAS,CAAC;IACvB,mJAAmJ;IACnJ,aAAa,EAAE,SAAS,CAAC;IACzB,wJAAwJ;IACxJ,YAAY,EAAE,SAAS,CAAC;IACxB;;;;;;;;;;;;;;;;;;OAkBG;IACH,iBAAiB,EAAE,SAAS,CAAC;IAC7B;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,EAAE,SAAS,CAAC;CAC5B"}

package/dist/dts/components/chat-driver/chat-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/chat-driver/chat-driver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chat-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/chat-driver/chat-driver.ts"],"names":[],"mappings":"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"}

package/dist/esm/channel/ai-activity-bus.js

@@ -115,12 +115,17 @@ function getTabScopedChannelName(base) {
  * - `halo-start` / `halo-stop` are forwarded via a tab-scoped `BroadcastChannel` so that
  *   popout windows opened from this tab show halo animations, while remaining isolated from
  *   unrelated tabs on the same origin (tab-scoped channel name).
+ * - `tool-loop-start` / `tool-loop-end` are cross-tab for the same reason: they describe the
+ *   assistant's lifecycle (a turn beginning / ending), and the most common subscribers
+ *   (workspace transitions, post-turn deferred recomputation, UI gates tied to the assistant
+ *   being idle) need the event regardless of whether the user is interacting with the chat
+ *   in the main tab or a popout window. Tab-local-only telemetry can subscribe and filter.
  * - `chat-popout` / `chat-popin` are in-memory only — they must only affect the tab where the
  *   user clicked.
  *
  * @beta
  */
 export const agenticActivityBus = new AgenticActivityBus({
-    crossTabEvents: ['halo-start', 'halo-stop'],
+    crossTabEvents: ['halo-start', 'halo-stop', 'tool-loop-start', 'tool-loop-end'],
     channelName: getTabScopedChannelName('foundation-ai-activity'),
 });

package/dist/esm/components/chat-driver/chat-driver.js

@@ -1,5 +1,6 @@
 import { __awaiter } from "tslib";
 import { MalformedFunctionCallError } from '@genesislcap/foundation-ai';
+import { agenticActivityBus } from '../../channel/ai-activity-bus';
 import { applyHistoryCap } from '../../utils/history-transform';
 import { logger } from '../../utils/logger';
 import { TOOL_FOLD_SYMBOL } from '../../utils/tool-fold';
@@ -376,6 +377,7 @@ export class ChatDriver extends EventTarget {
             this.subAgentCompletion = undefined;
             this.agentReleaseRequested = false;
             this.appendToHistory({ role: 'user', content: userInput, attachments });
+            agenticActivityBus.publish('tool-loop-start', undefined);
             try {
                 return yield this.runToolLoop(userInput, attachments);
             }
@@ -386,6 +388,7 @@ export class ChatDriver extends EventTarget {
             }
             finally {
                 this.busy = false;
+                agenticActivityBus.publish('tool-loop-end', undefined);
             }
         });
     }
@@ -503,6 +506,7 @@ export class ChatDriver extends EventTarget {
             }
             this.busy = true;
             this.subAgentCompletion = undefined;
+            agenticActivityBus.publish('tool-loop-start', undefined);
             try {
                 return yield this.runToolLoop('', undefined, transientPrimer);
             }
@@ -513,6 +517,7 @@ export class ChatDriver extends EventTarget {
             }
             finally {
                 this.busy = false;
+                agenticActivityBus.publish('tool-loop-end', undefined);
             }
         });
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/ai-assistant",
   "description": "Genesis AI Assistant micro-frontend",
-  "version": "14.437.6",
+  "version": "14.438.0",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/ai-assistant.d.ts",
@@ -64,24 +64,24 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.437.6",
-    "@genesislcap/genx": "14.437.6",
-    "@genesislcap/rollup-builder": "14.437.6",
-    "@genesislcap/ts-builder": "14.437.6",
-    "@genesislcap/uvu-playwright-builder": "14.437.6",
-    "@genesislcap/vite-builder": "14.437.6",
-    "@genesislcap/webpack-builder": "14.437.6",
+    "@genesislcap/foundation-testing": "14.438.0",
+    "@genesislcap/genx": "14.438.0",
+    "@genesislcap/rollup-builder": "14.438.0",
+    "@genesislcap/ts-builder": "14.438.0",
+    "@genesislcap/uvu-playwright-builder": "14.438.0",
+    "@genesislcap/vite-builder": "14.438.0",
+    "@genesislcap/webpack-builder": "14.438.0",
     "@types/dompurify": "^3.0.5",
     "@types/marked": "^5.0.2"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "14.437.6",
-    "@genesislcap/foundation-logger": "14.437.6",
-    "@genesislcap/foundation-redux": "14.437.6",
-    "@genesislcap/foundation-ui": "14.437.6",
-    "@genesislcap/foundation-utils": "14.437.6",
-    "@genesislcap/rapid-design-system": "14.437.6",
-    "@genesislcap/web-core": "14.437.6",
+    "@genesislcap/foundation-ai": "14.438.0",
+    "@genesislcap/foundation-logger": "14.438.0",
+    "@genesislcap/foundation-redux": "14.438.0",
+    "@genesislcap/foundation-ui": "14.438.0",
+    "@genesislcap/foundation-utils": "14.438.0",
+    "@genesislcap/rapid-design-system": "14.438.0",
+    "@genesislcap/web-core": "14.438.0",
     "dompurify": "^3.3.1",
     "marked": "^17.0.3"
   },
@@ -93,5 +93,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "8e8032f3226d1e6fa13ade21262a4ef7768caa9d"
+  "gitHead": "2aadae08b54d594c850d65c00a18e3ce5064069c"
 }

package/src/channel/ai-activity-bus.ts

@@ -139,12 +139,17 @@ function getTabScopedChannelName(base: string): string {
  * - `halo-start` / `halo-stop` are forwarded via a tab-scoped `BroadcastChannel` so that
  *   popout windows opened from this tab show halo animations, while remaining isolated from
  *   unrelated tabs on the same origin (tab-scoped channel name).
+ * - `tool-loop-start` / `tool-loop-end` are cross-tab for the same reason: they describe the
+ *   assistant's lifecycle (a turn beginning / ending), and the most common subscribers
+ *   (workspace transitions, post-turn deferred recomputation, UI gates tied to the assistant
+ *   being idle) need the event regardless of whether the user is interacting with the chat
+ *   in the main tab or a popout window. Tab-local-only telemetry can subscribe and filter.
  * - `chat-popout` / `chat-popin` are in-memory only — they must only affect the tab where the
  *   user clicked.
  *
  * @beta
  */
 export const agenticActivityBus = new AgenticActivityBus({
-  crossTabEvents: ['halo-start', 'halo-stop'],
+  crossTabEvents: ['halo-start', 'halo-stop', 'tool-loop-start', 'tool-loop-end'],
   channelName: getTabScopedChannelName('foundation-ai-activity'),
 });

package/src/channel/ai-activity-channel.ts

@@ -21,4 +21,44 @@ export interface AgenticActivityEvents {
   'chat-popout': undefined;
   /** Fired when the user clicks the collapse button — moves assistant from layout back to bubble. State lives in the session store, not in this event. */
   'chat-popin': undefined;
+  /**
+   * Fired immediately before the tool loop begins running for the current turn — after the busy
+   * flag is set and the user message (if any) has been appended, but before the first
+   * provider call. Pairs with {@link AgenticActivityEvents.'tool-loop-end'}.
+   *
+   * Boundary: this is the moment the assistant takes control from the user on the **main chat
+   * prompt** to begin a turn. It is **not** fired when a tool handler temporarily hands a
+   * widget to the user mid-loop (e.g. `requestInteraction` pausing a handler while a planning
+   * widget is rendered) — those widget pauses happen inside the loop and the assistant is
+   * still considered to own the turn.
+   *
+   * Fires from each `ChatDriver`'s `sendMessage` and `continueFromHistory`, so during a
+   * multi-agent handoff orchestrated by `OrchestratingDriver` it fires once per agent
+   * the orchestrator hands off to.
+   *
+   * Distinct from {@link AgenticActivityEvents.'halo-start'} — the halo event is keyed to
+   * tool-call messages arriving in the stream (UI animation concern), not to the loop boundary
+   * itself. Use this event for hooks tied to a turn beginning (telemetry, transient UI gates).
+   */
+  'tool-loop-start': undefined;
+  /**
+   * Fired when the tool loop completes for the current turn and control returns to the user
+   * on the **main chat prompt** (i.e. the next free-form user message can now be accepted).
+   *
+   * Boundary: this is the moment the user regains control of the main chat input. It is
+   * **not** fired when a tool handler hands a widget to the user mid-loop (e.g. while a
+   * planning widget is awaiting a click) — widget pauses are still inside the loop, the
+   * assistant still owns the turn, and the main chat input may be hidden during them. Wait
+   * for this event when you need to know that the assistant is fully idle and the user can
+   * type freely again.
+   *
+   * Emitted from the finally block of each `ChatDriver`'s `sendMessage` and
+   * `continueFromHistory`, so a multi-agent handoff fires this event once per agent.
+   *
+   * Distinct from {@link AgenticActivityEvents.'halo-stop'} — the halo event tracks the
+   * spinner animation lifecycle (which can flap mid-turn as tool calls resolve), whereas
+   * this event is a one-shot per turn boundary. Use this for hooks tied to a turn ending
+   * (telemetry flushes, post-turn workspace transitions, deferred state recomputation).
+   */
+  'tool-loop-end': undefined;
 }

package/src/components/chat-driver/chat-driver.ts

@@ -11,6 +11,7 @@ import type {
   SubAgentRequestOptions,
 } from '@genesislcap/foundation-ai';
 import { MalformedFunctionCallError } from '@genesislcap/foundation-ai';
+import { agenticActivityBus } from '../../channel/ai-activity-bus';
 import type {
   AgentConfig,
   SystemPromptContext,
@@ -560,6 +561,7 @@ export class ChatDriver extends EventTarget implements AiDriver {
     this.subAgentCompletion = undefined;
     this.agentReleaseRequested = false;
     this.appendToHistory({ role: 'user', content: userInput, attachments });
+    agenticActivityBus.publish('tool-loop-start', undefined);
 
     try {
       return await this.runToolLoop(userInput, attachments);
@@ -569,6 +571,7 @@ export class ChatDriver extends EventTarget implements AiDriver {
       return { reason: 'done' };
     } finally {
       this.busy = false;
+      agenticActivityBus.publish('tool-loop-end', undefined);
     }
   }
 
@@ -721,6 +724,7 @@ export class ChatDriver extends EventTarget implements AiDriver {
 
     this.busy = true;
     this.subAgentCompletion = undefined;
+    agenticActivityBus.publish('tool-loop-start', undefined);
     try {
       return await this.runToolLoop('', undefined, transientPrimer);
     } catch (e) {
@@ -729,6 +733,7 @@ export class ChatDriver extends EventTarget implements AiDriver {
       return { reason: 'done' };
     } finally {
       this.busy = false;
+      agenticActivityBus.publish('tool-loop-end', undefined);
     }
   }