@north-light/crouter 0.3.169 → 0.3.171

package/dist/core/command.js

@@ -14,6 +14,7 @@ import { readFileSync } from 'node:fs';
 import { spawnSync } from 'node:child_process';
 import { constants as osConstants } from 'node:os';
 import { isatty } from 'node:tty';
+import { resolve } from 'node:path';
 // ---------------------------------------------------------------------------
 // Factory functions
 // ---------------------------------------------------------------------------
@@ -268,6 +269,7 @@ function flagNameToKey(name) {
 export async function parseArgv(params, tokens, options) {
     const result = {};
     const provided = new Set(); // Track explicitly-provided parameter names
+    const contextFilePaths = new Map();
     // Index params by kind for quick lookup
     const positionalParam = params.find((p) => p.kind === 'positional');
     const stdinParam = params.find((p) => p.kind === 'stdin');
@@ -332,6 +334,7 @@ export async function parseArgv(params, tokens, options) {
                 }
                 const contextFileKey = flagNameToKey(contextFileParam.name);
                 result[contextFileKey] = parsed;
+                contextFilePaths.set(contextFileKey, resolve(pathVal));
                 provided.add(contextFileKey);
                 i++;
                 continue;
@@ -539,9 +542,12 @@ export async function parseArgv(params, tokens, options) {
     if (options?.onProvidedParams !== undefined) {
         options.onProvidedParams(provided);
     }
+    if (options?.onContextFilePaths !== undefined) {
+        options.onContextFilePaths(contextFilePaths);
+    }
     return result;
 }
-export async function runCli(root, argv, options) {
+export async function runCli(root, argv) {
     // argv is process.argv — strip node binary + script path. `--json` is a
     // global: pull it out anywhere it appears so the rest of argv parses against
     // the leaf schema unchanged, and switch stdout from rendered prose to raw
@@ -564,21 +570,6 @@ export async function runCli(root, argv, options) {
     }
     let { node, path, remaining } = walk(root, tokens);
     try {
-        // An unknown first token that misses at root is the only site absent
-        // HTTP-plugin stores may hydrate. A deeper unknown token under a known
-        // command never triggers it. Invoke the seam once; if it hydrated commands,
-        // re-walk the original argv against the rebuilt root. Keeping it inside the
-        // try sends any seam failure through the ordinary error handler.
-        if (options?.onUnknownFirstTokenMiss !== undefined &&
-            node.kind === 'root' &&
-            path.length === 0 &&
-            remaining.length > 0 &&
-            remaining[0] !== '-h' &&
-            remaining[0] !== '--help') {
-            const rebuilt = await options.onUnknownFirstTokenMiss();
-            if (rebuilt !== undefined)
-                ({ node, path, remaining } = walk(rebuilt, tokens));
-        }
         // Passthrough branches (e.g. `crtr capture`) opt out of the tree model
         // entirely: forward every token after the branch verbatim to an external
         // binary before any of the normal unknown-path / help / dispatch logic
@@ -618,13 +609,17 @@ export async function runCli(root, argv, options) {
         const leaf = node;
         const params = leaf.help.params !== undefined ? leaf.help.params : [];
         let providedParams = new Set();
+        let contextFilePaths = new Map();
         const input = await parseArgv(params, remaining, {
             leafPath: path,
             onProvidedParams: (provided) => {
                 providedParams = provided;
             },
+            onContextFilePaths: (paths) => {
+                contextFilePaths = paths;
+            },
         });
-        const context = { providedParams };
+        const context = { providedParams, contextFilePaths };
         const result = await operationIdContext.fresh(() => leaf.run(input, context));
         if (result !== undefined && result !== null) {
             if (isJsonOutput()) {

package/dist/core/config.js

@@ -441,6 +441,7 @@ function mergeConfig(partial) {
         ? partial.condensed_history
         : defaults.condensed_history;
     const fold_finished_tools = typeof partial.fold_finished_tools === 'boolean' ? partial.fold_finished_tools : defaults.fold_finished_tools;
+    const summarize_tool_calls = typeof partial.summarize_tool_calls === 'boolean' ? partial.summarize_tool_calls : defaults.summarize_tool_calls;
     const keybindings = normalizeKeybindings(partial.keybindings);
     const modelLadders = mergeModelLadders(partial.modelLadders);
     const modelRoutes = mergeModelRoutes(partial.modelRoutes);
@@ -448,7 +449,7 @@ function mergeConfig(partial) {
     const kinds = mergeKinds(partial.kinds);
     const remoteCanvas = mergeRemoteCanvas(partial.remoteCanvas);
     const spawnEnv = mergeSpawnEnv(partial.spawnEnv, defaults.spawnEnv?.allow);
-    return { schema_version, marketplaces, plugins, auto_update, max_panes_per_window, auto_open_child_viewers, brokerThresholds, completion_bell, live_cycles, condensed_history, fold_finished_tools, keybindings, modelLadders, ...(Object.keys(modelRoutes).length > 0 ? { modelRoutes } : {}), ...(modelRouting !== undefined ? { modelRouting } : {}), kinds, remoteCanvas, spawnEnv };
+    return { schema_version, marketplaces, plugins, auto_update, max_panes_per_window, auto_open_child_viewers, brokerThresholds, completion_bell, live_cycles, condensed_history, fold_finished_tools, summarize_tool_calls, keybindings, modelLadders, ...(Object.keys(modelRoutes).length > 0 ? { modelRoutes } : {}), ...(modelRouting !== undefined ? { modelRouting } : {}), kinds, remoteCanvas, spawnEnv };
 }
 /** Raw (un-defaulted) partial config for one scope, or null if the scope has
  *  no root or no config.json. Used by `readMergedLaunchConfig` to layer

package/dist/core/keybindings/__tests__/resolve.test.js

@@ -34,12 +34,16 @@ const REQUIRED_IDS = [
         ['clear-or-detach', 'crtr.attach.clear-or-detach'],
         ['mode-cycle', 'crtr.mode.cycle'],
         ['graph.toggle', 'crtr.attach.graph.toggle'],
+        ['help.toggle', 'crtr.attach.help.toggle'],
         ['model-ladder.next', 'crtr.attach.model-ladder.next'],
         ['model-ladder.previous', 'crtr.attach.model-ladder.previous'],
         ['command.inspect', 'crtr.attach.command.inspect'],
         ['file-review', 'crtr.attach.file-review'],
         ['profile-files', 'crtr.attach.profile-files'],
     ]),
+    ...ids('crtr.attach.scroll', ['up', 'down', 'page-up', 'page-down', 'live']),
+    'crtr.attach.mouse.toggle',
+    'crtr.attach.copy.message',
     ...ids('crtr.graph', ['down', 'up', 'first', 'last', 'collapse-or-manager', 'expand-or-child', 'focus', 'revive', 'focus-manager', 'close-subtree', 'dismiss']),
     ...ids('crtr.graph.confirm', ['accept', 'cancel']),
     ...ids('crtr.view.host', ['force-quit', 'editor.backspace']),

package/dist/core/keybindings/attach-control.d.ts

@@ -10,6 +10,9 @@ export declare const ATTACH_CONTROL_BINDINGS: readonly [{
 }, {
     readonly menuId: "crtr.tmux.menu.attach.graph.toggle";
     readonly actionId: "crtr.attach.graph.toggle";
+}, {
+    readonly menuId: "crtr.tmux.menu.attach.help.toggle";
+    readonly actionId: "crtr.attach.help.toggle";
 }, {
     readonly menuId: "crtr.tmux.menu.attach.model-ladder.next";
     readonly actionId: "crtr.attach.model-ladder.next";

package/dist/core/keybindings/attach-control.js

@@ -3,6 +3,7 @@ export const ATTACH_CONTROL_BINDINGS = [
     { menuId: 'crtr.tmux.menu.attach.clear-or-detach', actionId: 'crtr.attach.clear-or-detach' },
     { menuId: 'crtr.tmux.menu.attach.mode-cycle', actionId: 'crtr.mode.cycle' },
     { menuId: 'crtr.tmux.menu.attach.graph.toggle', actionId: 'crtr.attach.graph.toggle' },
+    { menuId: 'crtr.tmux.menu.attach.help.toggle', actionId: 'crtr.attach.help.toggle' },
     { menuId: 'crtr.tmux.menu.attach.model-ladder.next', actionId: 'crtr.attach.model-ladder.next' },
     { menuId: 'crtr.tmux.menu.attach.model-ladder.previous', actionId: 'crtr.attach.model-ladder.previous' },
     { menuId: 'crtr.tmux.menu.attach.command.inspect', actionId: 'crtr.attach.command.inspect' },

package/dist/core/keybindings/catalog.d.ts

@@ -10,8 +10,8 @@ type ProfileMenuAction = 'up' | 'down' | 'select' | 'accept-default' | 'abort' |
 type SetupAction = 'cancel' | 'tab-next' | 'tab-previous' | 'open' | 'list-down' | 'list-up' | 'toggle' | 'details' | 'advance' | 'cell-previous' | 'cell-next';
 type SetupKeybindingAction = 'edit' | 'commit-edit' | 'cancel-edit' | 'unbind' | 'reset-row' | 'reset-all' | 'save' | 'discard' | 'page-up' | 'page-down' | 'filter' | 'filter-delete' | 'filter-clear';
 type SetupModelsAction = 'open' | 'commit' | 'cancel' | 'scope-next';
-export type BindingId = `crtr.tmux.menu.${TmuxMenuAction}` | `crtr.tmux.menu.issue.${'idea' | 'bug'}` | AttachMenuBindingId | `crtr.tmux.menu-global.${TmuxMenuEntryAction}` | `crtr.tmux.node.${'next' | 'previous'}` | `crtr.tmux.view.${'next' | 'previous'}` | 'crtr.tmux.inbox.toggle' | AttachBindingId | `crtr.graph.${GraphAction}` | `crtr.graph.confirm.${'accept' | 'cancel'}` | `crtr.view.host.${'force-quit' | 'editor.backspace'}` | `crtr.view.canvas.${'down' | 'up' | 'refresh' | 'quit'}` | `crtr.view.chat.${'submit' | 'contextual-cancel' | 'reconnect' | 'quit'}` | `crtr.view.git-pr.${'down' | 'up' | 'refresh' | 'quit'}` | `crtr.view.inbox.${InboxAction}` | `crtr.view.linkedin.${LinkedinAction}` | `crtr.view.prompt-review.${'down' | 'up' | 'compare-previous' | 'compare-next' | 'toggle-mode' | 'expand' | 'export' | 'refresh' | 'quit'}` | `crtr.view.workspace-sidebar.${'down' | 'up' | 'open' | 'refresh' | 'quit'}` | `crtr.view.inspector.${'down' | 'up' | 'section-next' | 'section-prev' | 'page-down' | 'page-up' | 'toggle-detail' | 'cancel-item' | 'open-log' | 'confirm' | 'dismiss' | 'retarget' | 'refresh' | 'quit'}` | `crtr.view-picker.${'down' | 'up' | 'run' | 'quit'}` | `crtr.browse.${BrowseAction}` | `crtr.browse.search.${'cancel' | 'commit' | 'delete' | 'quit'}` | `crtr.profile.menu.${ProfileMenuAction}` | `crtr.profile.search.${'up' | 'down' | 'pick' | 'back' | 'delete' | 'abort'}` | `crtr.setup.${SetupAction}` | `crtr.setup.confirm.${'accept' | 'back'}` | `crtr.setup.keybindings.${SetupKeybindingAction}` | `crtr.setup.models.${SetupModelsAction}`;
-export declare const BINDING_CATALOG: readonly [BindingDefinition<"crtr.tmux.menu.open">, BindingDefinition<"crtr.tmux.menu.attach">, ...(BindingDefinition<BindingId> | BindingDefinition<"crtr.tmux.node.next"> | BindingDefinition<"crtr.tmux.node.previous"> | BindingDefinition<"crtr.tmux.inbox.toggle"> | BindingDefinition<"crtr.tmux.view.next"> | BindingDefinition<"crtr.tmux.view.previous"> | BindingDefinition<"crtr.graph.down"> | BindingDefinition<"crtr.graph.up"> | BindingDefinition<"crtr.graph.first"> | BindingDefinition<"crtr.graph.last"> | BindingDefinition<"crtr.graph.collapse-or-manager"> | BindingDefinition<"crtr.graph.expand-or-child"> | BindingDefinition<"crtr.graph.focus"> | BindingDefinition<"crtr.graph.revive"> | BindingDefinition<"crtr.graph.focus-manager"> | BindingDefinition<"crtr.graph.close-subtree"> | BindingDefinition<"crtr.graph.dismiss"> | BindingDefinition<"crtr.graph.confirm.accept"> | BindingDefinition<"crtr.graph.confirm.cancel"> | BindingDefinition<"crtr.view.host.force-quit"> | BindingDefinition<"crtr.view.host.editor.backspace"> | BindingDefinition<"crtr.view.chat.submit"> | BindingDefinition<"crtr.view.chat.contextual-cancel"> | BindingDefinition<"crtr.view.chat.reconnect"> | BindingDefinition<"crtr.view.chat.quit"> | BindingDefinition<"crtr.view.prompt-review.down"> | BindingDefinition<"crtr.view.prompt-review.up"> | BindingDefinition<"crtr.view.prompt-review.compare-previous"> | BindingDefinition<"crtr.view.prompt-review.compare-next"> | BindingDefinition<"crtr.view.prompt-review.toggle-mode"> | BindingDefinition<"crtr.view.prompt-review.expand"> | BindingDefinition<"crtr.view.prompt-review.export"> | BindingDefinition<"crtr.view.prompt-review.refresh"> | BindingDefinition<"crtr.view.prompt-review.quit"> | BindingDefinition<"crtr.view.workspace-sidebar.down"> | BindingDefinition<"crtr.view.workspace-sidebar.up"> | BindingDefinition<"crtr.view.workspace-sidebar.open"> | BindingDefinition<"crtr.view.workspace-sidebar.refresh"> | BindingDefinition<"crtr.view.workspace-sidebar.quit"> | BindingDefinition<"crtr.view.inspector.down"> | BindingDefinition<"crtr.view.inspector.up"> | BindingDefinition<"crtr.view.inspector.section-next"> | BindingDefinition<"crtr.view.inspector.section-prev"> | BindingDefinition<"crtr.view.inspector.page-down"> | BindingDefinition<"crtr.view.inspector.page-up"> | BindingDefinition<"crtr.view.inspector.toggle-detail"> | BindingDefinition<"crtr.view.inspector.cancel-item"> | BindingDefinition<"crtr.view.inspector.open-log"> | BindingDefinition<"crtr.view.inspector.confirm"> | BindingDefinition<"crtr.view.inspector.dismiss"> | BindingDefinition<"crtr.view.inspector.retarget"> | BindingDefinition<"crtr.view.inspector.refresh"> | BindingDefinition<"crtr.view.inspector.quit"> | BindingDefinition<"crtr.view-picker.down"> | BindingDefinition<"crtr.view-picker.up"> | BindingDefinition<"crtr.view-picker.run"> | BindingDefinition<"crtr.view-picker.quit"> | BindingDefinition<"crtr.browse.quit"> | BindingDefinition<"crtr.browse.down"> | BindingDefinition<"crtr.browse.up"> | BindingDefinition<"crtr.browse.first"> | BindingDefinition<"crtr.browse.last"> | BindingDefinition<"crtr.browse.expand-or-child"> | BindingDefinition<"crtr.browse.collapse-or-parent"> | BindingDefinition<"crtr.browse.toggle-fold"> | BindingDefinition<"crtr.browse.tab-next"> | BindingDefinition<"crtr.browse.tab-previous"> | BindingDefinition<"crtr.browse.tab.2" | "crtr.browse.tab.1" | "crtr.browse.tab.3" | "crtr.browse.tab.4" | "crtr.browse.tab.5"> | BindingDefinition<"crtr.browse.close-subtree"> | BindingDefinition<"crtr.browse.confirm-close"> | BindingDefinition<"crtr.browse.sort"> | BindingDefinition<"crtr.browse.scope"> | BindingDefinition<"crtr.browse.profile"> | BindingDefinition<"crtr.browse.residents"> | BindingDefinition<"crtr.browse.preview"> | BindingDefinition<"crtr.browse.search"> | BindingDefinition<"crtr.browse.revive-now"> | BindingDefinition<"crtr.browse.focus"> | BindingDefinition<"crtr.browse.focus-background"> | BindingDefinition<"crtr.browse.search.cancel"> | BindingDefinition<"crtr.browse.search.commit"> | BindingDefinition<"crtr.browse.search.delete"> | BindingDefinition<"crtr.browse.search.quit"> | BindingDefinition<"crtr.profile.menu.up"> | BindingDefinition<"crtr.profile.menu.down"> | BindingDefinition<"crtr.profile.menu.select"> | BindingDefinition<"crtr.profile.menu.accept-default"> | BindingDefinition<"crtr.profile.menu.abort"> | BindingDefinition<"crtr.profile.menu.slot.2" | "crtr.profile.menu.slot.1" | "crtr.profile.menu.slot.3" | "crtr.profile.menu.slot.4" | "crtr.profile.menu.slot.5" | "crtr.profile.menu.slot.9" | "crtr.profile.menu.slot.8" | "crtr.profile.menu.slot.6" | "crtr.profile.menu.slot.7">)[], BindingDefinition<"crtr.profile.menu.create">, BindingDefinition<"crtr.profile.menu.search-existing">, BindingDefinition<"crtr.profile.menu.use-root">, BindingDefinition<"crtr.profile.menu.set-default">, BindingDefinition<"crtr.profile.menu.add-directory">, BindingDefinition<"crtr.profile.menu.unpin">, BindingDefinition<"crtr.profile.search.up">, BindingDefinition<"crtr.profile.search.down">, BindingDefinition<"crtr.profile.search.pick">, BindingDefinition<"crtr.profile.search.back">, BindingDefinition<"crtr.profile.search.delete">, BindingDefinition<"crtr.profile.search.abort">, BindingDefinition<"crtr.setup.cancel">, BindingDefinition<"crtr.setup.tab-next">, BindingDefinition<"crtr.setup.tab-previous">, BindingDefinition<"crtr.setup.open">, BindingDefinition<"crtr.setup.list-down">, BindingDefinition<"crtr.setup.list-up">, BindingDefinition<"crtr.setup.toggle">, BindingDefinition<"crtr.setup.details">, BindingDefinition<"crtr.setup.advance">, BindingDefinition<"crtr.setup.confirm.accept">, BindingDefinition<"crtr.setup.confirm.back">, BindingDefinition<"crtr.setup.keybindings.edit">, BindingDefinition<"crtr.setup.keybindings.commit-edit">, BindingDefinition<"crtr.setup.keybindings.cancel-edit">, BindingDefinition<"crtr.setup.keybindings.unbind">, BindingDefinition<"crtr.setup.keybindings.reset-row">, BindingDefinition<"crtr.setup.keybindings.reset-all">, BindingDefinition<"crtr.setup.keybindings.save">, BindingDefinition<"crtr.setup.keybindings.discard">, BindingDefinition<"crtr.setup.keybindings.page-up">, BindingDefinition<"crtr.setup.keybindings.page-down">, BindingDefinition<"crtr.setup.keybindings.filter">, BindingDefinition<"crtr.setup.keybindings.filter-delete">, BindingDefinition<"crtr.setup.keybindings.filter-clear">, BindingDefinition<"crtr.setup.cell-previous">, BindingDefinition<"crtr.setup.cell-next">, BindingDefinition<"crtr.setup.models.open">, BindingDefinition<"crtr.setup.models.scope-next">, BindingDefinition<"crtr.setup.models.commit">, BindingDefinition<"crtr.setup.models.cancel">];
+export type BindingId = `crtr.tmux.menu.${TmuxMenuAction}` | `crtr.tmux.menu.issue.${'idea' | 'bug'}` | AttachMenuBindingId | `crtr.tmux.menu-global.${TmuxMenuEntryAction}` | `crtr.tmux.node.${'next' | 'previous'}` | `crtr.tmux.view.${'next' | 'previous'}` | 'crtr.tmux.inbox.toggle' | `crtr.attach.scroll.${'up' | 'down' | 'page-up' | 'page-down' | 'live'}` | 'crtr.attach.mouse.toggle' | 'crtr.attach.copy.message' | 'crtr.attach.help.toggle' | AttachBindingId | `crtr.graph.${GraphAction}` | `crtr.graph.confirm.${'accept' | 'cancel'}` | `crtr.view.host.${'force-quit' | 'editor.backspace'}` | `crtr.view.canvas.${'down' | 'up' | 'refresh' | 'quit'}` | `crtr.view.chat.${'submit' | 'contextual-cancel' | 'reconnect' | 'quit'}` | `crtr.view.git-pr.${'down' | 'up' | 'refresh' | 'quit'}` | `crtr.view.inbox.${InboxAction}` | `crtr.view.linkedin.${LinkedinAction}` | `crtr.view.prompt-review.${'down' | 'up' | 'compare-previous' | 'compare-next' | 'toggle-mode' | 'expand' | 'export' | 'refresh' | 'quit'}` | `crtr.view.workspace-sidebar.${'down' | 'up' | 'open' | 'refresh' | 'quit'}` | `crtr.view.inspector.${'down' | 'up' | 'section-next' | 'section-prev' | 'page-down' | 'page-up' | 'toggle-detail' | 'cancel-item' | 'open-log' | 'confirm' | 'dismiss' | 'retarget' | 'refresh' | 'quit'}` | `crtr.view-picker.${'down' | 'up' | 'run' | 'quit'}` | `crtr.browse.${BrowseAction}` | `crtr.browse.search.${'cancel' | 'commit' | 'delete' | 'quit'}` | `crtr.profile.menu.${ProfileMenuAction}` | `crtr.profile.search.${'up' | 'down' | 'pick' | 'back' | 'delete' | 'abort'}` | `crtr.setup.${SetupAction}` | `crtr.setup.confirm.${'accept' | 'back'}` | `crtr.setup.keybindings.${SetupKeybindingAction}` | `crtr.setup.models.${SetupModelsAction}`;
+export declare const BINDING_CATALOG: readonly [BindingDefinition<"crtr.tmux.menu.open">, BindingDefinition<"crtr.tmux.menu.attach">, ...(BindingDefinition<BindingId> | BindingDefinition<"crtr.tmux.node.next"> | BindingDefinition<"crtr.tmux.node.previous"> | BindingDefinition<"crtr.tmux.inbox.toggle"> | BindingDefinition<"crtr.tmux.view.next"> | BindingDefinition<"crtr.tmux.view.previous"> | BindingDefinition<"crtr.attach.scroll.up"> | BindingDefinition<"crtr.attach.scroll.down"> | BindingDefinition<"crtr.attach.scroll.page-up"> | BindingDefinition<"crtr.attach.scroll.page-down"> | BindingDefinition<"crtr.attach.scroll.live"> | BindingDefinition<"crtr.attach.mouse.toggle"> | BindingDefinition<"crtr.attach.copy.message"> | BindingDefinition<"crtr.graph.down"> | BindingDefinition<"crtr.graph.up"> | BindingDefinition<"crtr.graph.first"> | BindingDefinition<"crtr.graph.last"> | BindingDefinition<"crtr.graph.collapse-or-manager"> | BindingDefinition<"crtr.graph.expand-or-child"> | BindingDefinition<"crtr.graph.focus"> | BindingDefinition<"crtr.graph.revive"> | BindingDefinition<"crtr.graph.focus-manager"> | BindingDefinition<"crtr.graph.close-subtree"> | BindingDefinition<"crtr.graph.dismiss"> | BindingDefinition<"crtr.graph.confirm.accept"> | BindingDefinition<"crtr.graph.confirm.cancel"> | BindingDefinition<"crtr.view.host.force-quit"> | BindingDefinition<"crtr.view.host.editor.backspace"> | BindingDefinition<"crtr.view.chat.submit"> | BindingDefinition<"crtr.view.chat.contextual-cancel"> | BindingDefinition<"crtr.view.chat.reconnect"> | BindingDefinition<"crtr.view.chat.quit"> | BindingDefinition<"crtr.view.prompt-review.down"> | BindingDefinition<"crtr.view.prompt-review.up"> | BindingDefinition<"crtr.view.prompt-review.compare-previous"> | BindingDefinition<"crtr.view.prompt-review.compare-next"> | BindingDefinition<"crtr.view.prompt-review.toggle-mode"> | BindingDefinition<"crtr.view.prompt-review.expand"> | BindingDefinition<"crtr.view.prompt-review.export"> | BindingDefinition<"crtr.view.prompt-review.refresh"> | BindingDefinition<"crtr.view.prompt-review.quit"> | BindingDefinition<"crtr.view.workspace-sidebar.down"> | BindingDefinition<"crtr.view.workspace-sidebar.up"> | BindingDefinition<"crtr.view.workspace-sidebar.open"> | BindingDefinition<"crtr.view.workspace-sidebar.refresh"> | BindingDefinition<"crtr.view.workspace-sidebar.quit"> | BindingDefinition<"crtr.view.inspector.down"> | BindingDefinition<"crtr.view.inspector.up"> | BindingDefinition<"crtr.view.inspector.section-next"> | BindingDefinition<"crtr.view.inspector.section-prev"> | BindingDefinition<"crtr.view.inspector.page-down"> | BindingDefinition<"crtr.view.inspector.page-up"> | BindingDefinition<"crtr.view.inspector.toggle-detail"> | BindingDefinition<"crtr.view.inspector.cancel-item"> | BindingDefinition<"crtr.view.inspector.open-log"> | BindingDefinition<"crtr.view.inspector.confirm"> | BindingDefinition<"crtr.view.inspector.dismiss"> | BindingDefinition<"crtr.view.inspector.retarget"> | BindingDefinition<"crtr.view.inspector.refresh"> | BindingDefinition<"crtr.view.inspector.quit"> | BindingDefinition<"crtr.view-picker.down"> | BindingDefinition<"crtr.view-picker.up"> | BindingDefinition<"crtr.view-picker.run"> | BindingDefinition<"crtr.view-picker.quit"> | BindingDefinition<"crtr.browse.quit"> | BindingDefinition<"crtr.browse.down"> | BindingDefinition<"crtr.browse.up"> | BindingDefinition<"crtr.browse.first"> | BindingDefinition<"crtr.browse.last"> | BindingDefinition<"crtr.browse.expand-or-child"> | BindingDefinition<"crtr.browse.collapse-or-parent"> | BindingDefinition<"crtr.browse.toggle-fold"> | BindingDefinition<"crtr.browse.tab-next"> | BindingDefinition<"crtr.browse.tab-previous"> | BindingDefinition<"crtr.browse.tab.2" | "crtr.browse.tab.1" | "crtr.browse.tab.3" | "crtr.browse.tab.4" | "crtr.browse.tab.5"> | BindingDefinition<"crtr.browse.close-subtree"> | BindingDefinition<"crtr.browse.confirm-close"> | BindingDefinition<"crtr.browse.sort"> | BindingDefinition<"crtr.browse.scope"> | BindingDefinition<"crtr.browse.profile"> | BindingDefinition<"crtr.browse.residents"> | BindingDefinition<"crtr.browse.preview"> | BindingDefinition<"crtr.browse.search"> | BindingDefinition<"crtr.browse.revive-now"> | BindingDefinition<"crtr.browse.focus"> | BindingDefinition<"crtr.browse.focus-background"> | BindingDefinition<"crtr.browse.search.cancel"> | BindingDefinition<"crtr.browse.search.commit"> | BindingDefinition<"crtr.browse.search.delete"> | BindingDefinition<"crtr.browse.search.quit"> | BindingDefinition<"crtr.profile.menu.up"> | BindingDefinition<"crtr.profile.menu.down"> | BindingDefinition<"crtr.profile.menu.select"> | BindingDefinition<"crtr.profile.menu.accept-default"> | BindingDefinition<"crtr.profile.menu.abort"> | BindingDefinition<"crtr.profile.menu.slot.2" | "crtr.profile.menu.slot.1" | "crtr.profile.menu.slot.3" | "crtr.profile.menu.slot.4" | "crtr.profile.menu.slot.5" | "crtr.profile.menu.slot.9" | "crtr.profile.menu.slot.8" | "crtr.profile.menu.slot.6" | "crtr.profile.menu.slot.7">)[], BindingDefinition<"crtr.profile.menu.create">, BindingDefinition<"crtr.profile.menu.search-existing">, BindingDefinition<"crtr.profile.menu.use-root">, BindingDefinition<"crtr.profile.menu.set-default">, BindingDefinition<"crtr.profile.menu.add-directory">, BindingDefinition<"crtr.profile.menu.unpin">, BindingDefinition<"crtr.profile.search.up">, BindingDefinition<"crtr.profile.search.down">, BindingDefinition<"crtr.profile.search.pick">, BindingDefinition<"crtr.profile.search.back">, BindingDefinition<"crtr.profile.search.delete">, BindingDefinition<"crtr.profile.search.abort">, BindingDefinition<"crtr.setup.cancel">, BindingDefinition<"crtr.setup.tab-next">, BindingDefinition<"crtr.setup.tab-previous">, BindingDefinition<"crtr.setup.open">, BindingDefinition<"crtr.setup.list-down">, BindingDefinition<"crtr.setup.list-up">, BindingDefinition<"crtr.setup.toggle">, BindingDefinition<"crtr.setup.details">, BindingDefinition<"crtr.setup.advance">, BindingDefinition<"crtr.setup.confirm.accept">, BindingDefinition<"crtr.setup.confirm.back">, BindingDefinition<"crtr.setup.keybindings.edit">, BindingDefinition<"crtr.setup.keybindings.commit-edit">, BindingDefinition<"crtr.setup.keybindings.cancel-edit">, BindingDefinition<"crtr.setup.keybindings.unbind">, BindingDefinition<"crtr.setup.keybindings.reset-row">, BindingDefinition<"crtr.setup.keybindings.reset-all">, BindingDefinition<"crtr.setup.keybindings.save">, BindingDefinition<"crtr.setup.keybindings.discard">, BindingDefinition<"crtr.setup.keybindings.page-up">, BindingDefinition<"crtr.setup.keybindings.page-down">, BindingDefinition<"crtr.setup.keybindings.filter">, BindingDefinition<"crtr.setup.keybindings.filter-delete">, BindingDefinition<"crtr.setup.keybindings.filter-clear">, BindingDefinition<"crtr.setup.cell-previous">, BindingDefinition<"crtr.setup.cell-next">, BindingDefinition<"crtr.setup.models.open">, BindingDefinition<"crtr.setup.models.scope-next">, BindingDefinition<"crtr.setup.models.commit">, BindingDefinition<"crtr.setup.models.cancel">];
 export declare const BINDING_IDS: ReadonlySet<string>;
 export declare const SAFETY_REQUIREMENTS: readonly SafetyRequirement[];
 export {};

package/dist/core/keybindings/catalog.js

@@ -74,11 +74,19 @@ export const BINDING_CATALOG = Object.freeze([
     ...attachEntry('crtr.tmux.menu.attach.clear-or-detach', 'crtr.attach.clear-or-detach', 'Clear or detach', 'Clear input or detach when input is empty.', 'c', ['ctrl+c']),
     ...attachEntry('crtr.tmux.menu.attach.mode-cycle', 'crtr.mode.cycle', 'Cycle mode', 'Cycle the active agent mode.', 'p', ['alt+shift+p']),
     ...attachEntry('crtr.tmux.menu.attach.graph.toggle', 'crtr.attach.graph.toggle', 'Toggle graph', 'Open or close the graph overlay.', 'g', ['alt+g']),
+    ...attachEntry('crtr.tmux.menu.attach.help.toggle', 'crtr.attach.help.toggle', 'Help', 'Open the attach help overlay.', 'k', ['alt+shift+k']),
     ...attachEntry('crtr.tmux.menu.attach.model-ladder.next', 'crtr.attach.model-ladder.next', 'Next model ladder', 'Move to the next model ladder rung.', ']', ['alt+m']),
     ...attachEntry('crtr.tmux.menu.attach.model-ladder.previous', 'crtr.attach.model-ladder.previous', 'Previous model ladder', 'Move to the previous model ladder rung.', '[', ['alt+shift+m']),
     ...attachEntry('crtr.tmux.menu.attach.command.inspect', 'crtr.attach.command.inspect', 'Inspect loaded command', 'Open the loaded slash command’s expanded prompt.', 'h', ['alt+shift+h']),
     ...attachEntry('crtr.tmux.menu.attach.file-review', 'crtr.attach.file-review', 'Review a file', 'Open a line-anchored review of a file named in the transcript.', 'r', ['alt+shift+r']),
     ...attachEntry('crtr.tmux.menu.attach.profile-files', 'crtr.attach.profile-files', 'Search profile files', 'Search files across the node’s profile projects, cwd, and ancestor crouter memory stores.', 'f', []),
+    b('crtr.attach.scroll.up', 'Attach', 'Scroll up', 'Scroll the transcript one line up.', ['shift+up'], 'terminal', ATTACH_CONTEXTS),
+    b('crtr.attach.scroll.down', 'Attach', 'Scroll down', 'Scroll the transcript one line down.', ['shift+down'], 'terminal', ATTACH_CONTEXTS),
+    b('crtr.attach.scroll.page-up', 'Attach', 'Scroll page up', 'Scroll the transcript one page up.', ['pageup'], 'terminal', ATTACH_CONTEXTS),
+    b('crtr.attach.scroll.page-down', 'Attach', 'Scroll page down', 'Scroll the transcript one page down.', ['pagedown'], 'terminal', ATTACH_CONTEXTS),
+    b('crtr.attach.scroll.live', 'Attach', 'Return to live', 'Return the transcript to the live bottom.', ['shift+end'], 'terminal', ATTACH_CONTEXTS),
+    b('crtr.attach.mouse.toggle', 'Attach', 'Toggle mouse wheel scrolling', 'Toggle mouse wheel scrolling on or off.', ['alt+shift+o'], 'terminal', ATTACH_CONTEXTS),
+    b('crtr.attach.copy.message', 'Attach', 'Copy visible message', 'Copy the newest message visible in the transcript viewport.', ['alt+shift+y'], 'terminal', ATTACH_CONTEXTS),
     b('crtr.graph.down', 'GRAPH', 'Move down', 'Move to the next graph row.', ['j'], 'terminal', ['graph']),
     b('crtr.graph.up', 'GRAPH', 'Move up', 'Move to the previous graph row.', ['k'], 'terminal', ['graph']),
     b('crtr.graph.first', 'GRAPH', 'First row', 'Move to the first graph row.', ['g'], 'terminal', ['graph']),

package/dist/core/runtime/broker-protocol.d.ts

@@ -1,6 +1,7 @@
 import type { AgentSession, AgentSessionEvent, RpcExtensionUIRequest, RpcExtensionUIResponse, RpcSessionState, SessionEntry, SessionInfo, SettingsConfig, SessionStats } from '@earendil-works/pi-coding-agent';
 import type { Api, ImageContent, Model } from '@earendil-works/pi-ai';
 import type { BrokerErrorFrame } from '../../api/dto/broker.js';
+import type { ToolGroupSummary } from '../../shared/tool-groups.js';
 /** pi's own RPC types, re-exported unchanged. `broker-protocol` stays the one
  *  import site for the wire union; the shapes themselves are pi's, versioned by
  *  pi, so a pi change is a compile error here instead of silent drift. */
@@ -45,6 +46,10 @@ export interface BrokerSnapshot {
         }>;
         title: string | undefined;
     };
+    /** Broker-owned summaries keyed by the first tool-call id in each group.
+     * Structured objects with bullets, nodesSpawned, and filesEdited.
+     * Optional so snapshots from an older live runtime remain readable. */
+    toolGroupSummaries?: Record<string, ToolGroupSummary>;
 }
 /** Opens the connection and FIXES this client's role for its lifetime. A repeated
  *  `hello` on an already-helloed socket never changes the established role. */
@@ -563,10 +568,17 @@ export interface ExtensionUIDismissFrame {
     type: 'extension_ui_dismiss';
     id: string;
 }
+/** A completed broker-side tool-group summary. The viewer owns presentation;
+ * this frame carries the durable group key and structured summary object. */
+export interface ToolGroupSummaryFrame {
+    type: 'tool_group_summary';
+    key: string;
+    summary: ToolGroupSummary;
+}
 /** Everything the broker can send. Live `AgentSessionEvent`s are relayed
  *  verbatim (the broker adds nothing); the broker's own control frames carry
  *  non-colliding `type` discriminants. */
-export type BrokerToClient = WelcomeFrame | ModelChangedFrame | ErrorFrame | AckFrame | BrokerDataFrame | BashStartFrame | BashOutputFrame | BashEndFrame | ExtensionUIRequestFrame | ExtensionUIDismissFrame | AgentSessionEvent;
+export type BrokerToClient = WelcomeFrame | ModelChangedFrame | ErrorFrame | AckFrame | BrokerDataFrame | BashStartFrame | BashOutputFrame | BashEndFrame | ExtensionUIRequestFrame | ExtensionUIDismissFrame | ToolGroupSummaryFrame | AgentSessionEvent;
 /** Encode one frame as a single newline-terminated JSON line. */
 export declare function encodeFrame(frame: ClientToBroker | BrokerToClient): string;
 /** Byte bounds for a {@link FrameDecoder} (C5). */

package/dist/core/runtime/broker.js

@@ -32,6 +32,8 @@ import { operationIdContext } from '../events/operation-id.js';
 import { findMissingPackagePaths } from './package-health.js';
 import { SessionListCache } from './session-list-cache.js';
 import { getNode, updateNode } from '../canvas/index.js';
+import { readConfig } from '../config.js';
+import { atomicWriteJson, readJsonIfExists } from '../fs-utils.js';
 import { buildRefInventory } from '../memory/inline-ref-inventory.js';
 import { buildGuidance } from '../memory/inline-ref-guidance.js';
 import { clearSessionCache } from '../substrate/session-cache.js';
@@ -44,7 +46,9 @@ import { PoolCredentialStore } from '../pool-credential-store.js';
 import { clearFault, isModelNotFoundError, isProviderUnconfiguredError, readFault, recordFault, recordFaultForCurrentNode } from './fault.js';
 import { clearCleanAbort, markBusy, markCleanAbort } from './busy.js';
 import { extractCoolingDeadline } from './managed-provider-cooling.js';
-import { AUTH_FAULT_RECOVERY_BODY, CONNECTION_FAULT_RECOVERY_BODY, PROVIDER_FAULT_RECOVERY_BODY } from './fault-recovery-nudge.js';
+import { AUTH_FAULT_RECOVERY_BODY, CONNECTION_FAULT_RECOVERY_BODY, PROVIDER_FAULT_RECOVERY_BODY, formatModelFallbackRecovery, generatedContextText, } from '../../shared/generated-context.js';
+import { assistantVisibleText, isTrueUserMessage, normalizeToolGroupSummaryRecord, } from '../../shared/tool-groups.js';
+import { headlessToolGroupSummary, serializeToolGroup } from './tool-group-summary.js';
 import { markFatalOnExhaust, nextFaultRetry, policyFor } from './fault-recovery.js';
 import { probeOnline as probeOnlineReal } from './connectivity.js';
 import { CRTR_CYCLE_CUSTOM_TYPE, cycleAwareMessages } from './session-cycles.js';
@@ -588,7 +592,26 @@ export async function runBroker(nodeId, startupAt = process.hrtime.bigint(), sta
     const displayStatuses = new Map();
     const displayWidgets = new Map();
     let displayTitle;
+    const toolSummariesPath = join(jobDir(nodeId), 'tool-summaries.json');
+    const toolGroupSummaries = new Map();
+    try {
+        const persisted = readJsonIfExists(toolSummariesPath);
+        for (const [key, summary] of Object.entries(normalizeToolGroupSummaryRecord(persisted))) {
+            toolGroupSummaries.set(key, summary);
+        }
+    }
+    catch {
+        // A malformed sidecar merely withholds summaries; transcript tools remain visible.
+    }
+    const summaryAttempted = new Set(toolGroupSummaries.keys());
+    const generatingToolGroups = new Set();
+    const toolGroupsByCallId = new Map();
+    const summaryTasks = new Set();
+    let openToolGroup;
+    let lastToolGroupBoundaryProse = '';
+    let sawAssistantProse = false;
     let disposed = false;
+    let disposePending = false;
     let agentRunActive = false;
     let shutdownRequested = false;
     let server;
@@ -729,6 +752,168 @@ export async function runBroker(nodeId, startupAt = process.hrtime.bigint(), sta
         }
         broadcast(frame);
     };
+    /** Record and asynchronously summarize the maximal non-boundary region between
+     * visible prose messages. A boundary can land while a tool is still running,
+     * so closed groups retain their call ids until every result has joined the
+     * same serialized segment; only then may they become collapsible. */
+    const ensureOpenToolGroup = () => {
+        if (openToolGroup === undefined) {
+            openToolGroup = {
+                toolCount: 0,
+                pieces: [],
+                boundaryProse: lastToolGroupBoundaryProse,
+                pendingToolIds: new Set(),
+                closed: false,
+                summarizeWhenSettled: false,
+            };
+        }
+        return openToolGroup;
+    };
+    const generateSettledToolGroup = (group) => {
+        if (!group.closed || group.pendingToolIds.size > 0 || group.key === undefined || !group.summarizeWhenSettled)
+            return;
+        const key = group.key;
+        if (summaryAttempted.has(key) || generatingToolGroups.has(key))
+            return;
+        summaryAttempted.add(key);
+        generatingToolGroups.add(key);
+        let task;
+        task = headlessToolGroupSummary(serializeToolGroup(group.boundaryProse, group.pieces))
+            .then((summary) => {
+            if (summary === null)
+                return;
+            toolGroupSummaries.set(key, summary);
+            try {
+                atomicWriteJson(toolSummariesPath, Object.fromEntries(toolGroupSummaries));
+            }
+            catch {
+                // A delivery without durable state would disappear on reattach, so do
+                // not advertise it. The calls remain folded normally instead.
+                toolGroupSummaries.delete(key);
+                return;
+            }
+            broadcast({ type: 'tool_group_summary', key, summary });
+        })
+            .catch(() => undefined)
+            .finally(() => {
+            generatingToolGroups.delete(key);
+            summaryTasks.delete(task);
+        });
+        summaryTasks.add(task);
+    };
+    const finishOpenToolGroup = () => {
+        const group = openToolGroup;
+        openToolGroup = undefined;
+        if (group === undefined)
+            return;
+        group.closed = true;
+        // Configuration is read at the boundary, not when a slow tool later settles.
+        group.summarizeWhenSettled = readConfig('user').summarize_tool_calls;
+        generateSettledToolGroup(group);
+    };
+    const visibleBoundary = (prose) => {
+        finishOpenToolGroup();
+        lastToolGroupBoundaryProse = prose;
+    };
+    const observeToolGroupEvent = (event) => {
+        // The viewer turns every compaction_end into a summary, cancellation, or
+        // error line, each of which is a hard transcript seam.
+        if (event.type === 'compaction_end') {
+            finishOpenToolGroup();
+            return;
+        }
+        // A failed automatic retry is rendered as ChatView's visible error line.
+        // Successful retries only clear activity and remain within the same group.
+        if (event.type === 'auto_retry_end' && event.success !== true) {
+            finishOpenToolGroup();
+            return;
+        }
+        // The attach viewer renders aborted and errored assistant endings as visible
+        // transcript seams. Close their completed tool run here too; any tool that
+        // never emitted its execution_end keeps the group unsettled and visible.
+        if (event.type === 'message_end') {
+            const message = event.message;
+            if (message !== null && typeof message === 'object') {
+                const item = message;
+                if (item.role === 'assistant' && (item.stopReason === 'aborted' || item.stopReason === 'error')) {
+                    finishOpenToolGroup();
+                }
+            }
+            return;
+        }
+        if (event.type === 'tool_execution_start') {
+            const group = ensureOpenToolGroup();
+            const id = typeof event.toolCallId === 'string' ? event.toolCallId : '';
+            if (group.key === undefined && id !== '')
+                group.key = id;
+            if (id !== '') {
+                group.pendingToolIds.add(id);
+                toolGroupsByCallId.set(id, group);
+            }
+            group.toolCount += 1;
+            group.pieces.push({ type: 'tool', name: typeof event.toolName === 'string' ? event.toolName : 'tool', args: event.args });
+            return;
+        }
+        if (event.type === 'tool_execution_end') {
+            const id = typeof event.toolCallId === 'string' ? event.toolCallId : '';
+            const group = id === '' ? openToolGroup : toolGroupsByCallId.get(id);
+            if (group !== undefined) {
+                group.pieces.push({
+                    type: 'result',
+                    name: typeof event.toolName === 'string' ? event.toolName : 'tool',
+                    result: event.result,
+                    isError: event.isError === true,
+                });
+                if (id !== '') {
+                    group.pendingToolIds.delete(id);
+                    toolGroupsByCallId.delete(id);
+                }
+                generateSettledToolGroup(group);
+            }
+            return;
+        }
+        if (event.type !== 'message_start' && event.type !== 'message_update')
+            return;
+        const message = event.message;
+        if (message === null || typeof message !== 'object')
+            return;
+        const item = message;
+        const role = item.role;
+        if (role === 'assistant') {
+            if (event.type === 'message_start')
+                sawAssistantProse = false;
+            const prose = assistantVisibleText(item);
+            if (!sawAssistantProse && prose.trim() !== '') {
+                sawAssistantProse = true;
+                visibleBoundary(prose);
+            }
+            return;
+        }
+        if (event.type !== 'message_start')
+            return;
+        if (role === 'compactionSummary' || role === 'branchSummary' || role === 'bashExecution' || role === 'status' || role === 'error' || item.customType === 'crtr-cycle-divider') {
+            finishOpenToolGroup();
+            return;
+        }
+        if (isTrueUserMessage(item)) {
+            visibleBoundary(generatedContextText(item));
+            return;
+        }
+        if (item.display === false)
+            return;
+        const text = generatedContextText(item);
+        const isBearingsOrRevive = item.customType === 'crtr-context' || (role === 'user' && text.startsWith('You have been revived fresh after a context refresh'));
+        if (isBearingsOrRevive) {
+            if (openToolGroup !== undefined && text !== '')
+                openToolGroup.pieces.push({ type: 'text', text });
+            return;
+        }
+        // Generated inbox/situational/nudge and visible custom output are part of
+        // the between-message activity and may begin a group before its first tool.
+        const group = ensureOpenToolGroup();
+        if (text !== '')
+            group.pieces.push({ type: 'text', text });
+    };
     // ---------------------------------------------------------------------------
     // F2: message_update coalescing. `relayEvent` is the single entry point for
     // engine events headed to viewers: a message_update is held (latest wins) and
@@ -951,9 +1136,7 @@ export async function runBroker(nodeId, startupAt = process.hrtime.bigint(), sta
             // node from reviving straight back into fault-recovery chrome.
             if (unconfigured)
                 clearFault(nodeId, { link: 'pi→provider' });
-            await operationIdContext.fresh(() => session.prompt(unconfigured
-                ? `The previous model (${currentSpec}) had no usable provider credential, so you were automatically switched to ${resolved}. Continue the task from where the failed turn left off.`
-                : `The previous model (${currentSpec}) was unavailable (provider 404 not_found), so you were automatically switched to ${resolved}. Continue the task from where the failed turn left off.`));
+            await operationIdContext.fresh(() => session.prompt(formatModelFallbackRecovery(currentSpec, resolved, unconfigured ? 'credential' : 'not-found')));
         })()
             .catch((err) => {
             emitEvent({
@@ -1295,6 +1478,7 @@ export async function runBroker(nodeId, startupAt = process.hrtime.bigint(), sta
             widgets: Object.fromEntries([...displayWidgets].map(([k, w]) => [k, { lines: [...w.lines], placement: w.placement }])),
             title: displayTitle,
         },
+        toolGroupSummaries: Object.fromEntries(toolGroupSummaries),
     });
     // Send a client its catch-up snapshot. welcome.pending_dialog carries a single
     // still-in-flight dialog to a WRITABLE client attaching mid-dialog; an observer
@@ -1337,7 +1521,7 @@ export async function runBroker(nodeId, startupAt = process.hrtime.bigint(), sta
     // The single exit helper (plan §0): dispose the engine, close + unlink the
     // socket, exit 0. Idempotent — every trigger converges here.
     // -------------------------------------------------------------------------
-    const disposeAndExit = (_reason, status = 0) => {
+    const completeExit = (status) => {
         if (disposed)
             return;
         disposed = true;
@@ -1381,6 +1565,23 @@ export async function runBroker(nodeId, startupAt = process.hrtime.bigint(), sta
         }
         process.exit(status);
     };
+    const disposeAndExit = (reason, status = 0) => {
+        if (disposed)
+            return;
+        // A normal terminal shutdown follows a visible boundary that may have just
+        // launched a capped (45s) headless summary. Keep the broker and its child
+        // alive until those already-started tasks persist/broadcast, rather than
+        // process.exit() orphaning pi and losing the sidecar. Abrupt failures and
+        // signals retain their existing immediate teardown behavior.
+        if ((reason === 'shutdown-hook' || reason === 'shutdown-after-settle') && summaryTasks.size > 0) {
+            if (disposePending)
+                return;
+            disposePending = true;
+            void Promise.allSettled([...summaryTasks]).finally(() => completeExit(status));
+            return;
+        }
+        completeExit(status);
+    };
     // A stophook can request shutdown while pi is still unwinding a completed
     // turn. Let that turn reach agent_settled first: inbox delivery commits its
     // durable cursor there, and only there. Explicit operator shutdown and OS
@@ -1491,6 +1692,7 @@ export async function runBroker(nodeId, startupAt = process.hrtime.bigint(), sta
                     return;
                 }
             }
+            observeToolGroupEvent(event);
             relayEvent(event, generation);
             if (event.type === 'agent_settled')
                 scheduleFaultRetry();
@@ -1526,6 +1728,9 @@ export async function runBroker(nodeId, startupAt = process.hrtime.bigint(), sta
             providerFallbackInFlight = null;
             notFoundFallbackInFlight = null;
             reloadAuthInFlight = null;
+            openToolGroup = undefined;
+            toolGroupsByCallId.clear();
+            sawAssistantProse = false;
             await candidateSession.bindExtensions({
                 uiContext,
                 // 'rpc' — NOT 'print'. Per pi docs/rpc.md:1078 this is exactly our shape:
@@ -1810,6 +2015,9 @@ export async function runBroker(nodeId, startupAt = process.hrtime.bigint(), sta
                 // Order before any held assistant message_update, so a `!` run mid-stream
                 // never renders ahead of the update it follows.
                 flushPendingUpdate();
+                // The live bash component is a visible transcript boundary, even though
+                // its persisted bashExecution message arrives later via the session.
+                finishOpenToolGroup();
                 broadcast({ type: 'bash_start', command, excludeFromContext: exclude });
                 void session
                     .executeBash(command, (chunk) => broadcast({ type: 'bash_output', chunk }), {

package/dist/core/runtime/canvas-extensions.d.ts

@@ -12,6 +12,9 @@ export declare const CANVAS_BASH_VALVE_PATH: string;
  *  (`runtime/naming.ts`) to give it a constrained-schema `name_session` tool.
  *  Deliberately absent from CANVAS_EXTENSIONS: a node must never carry it. */
 export declare const NAMING_TOOL_PATH: string;
+/** NOT a canvas extension — loaded only by the broker's headless tool-group
+ * summarizer, which is the sole owner of summary generation and persistence. */
+export declare const SUMMARY_TOOL_PATH: string;
 /** The canvas extensions every node loads, in order. The inbox watcher commits
  *  its cursor at agent_settled before the stophook checks it for idle release. */
 export declare const CANVAS_EXTENSIONS: string[];

package/dist/core/runtime/canvas-extensions.js

@@ -24,6 +24,9 @@ export const CANVAS_BASH_VALVE_PATH = resolveExtension('canvas-bash-valve');
  *  (`runtime/naming.ts`) to give it a constrained-schema `name_session` tool.
  *  Deliberately absent from CANVAS_EXTENSIONS: a node must never carry it. */
 export const NAMING_TOOL_PATH = resolveExtension('naming-tool');
+/** NOT a canvas extension — loaded only by the broker's headless tool-group
+ * summarizer, which is the sole owner of summary generation and persistence. */
+export const SUMMARY_TOOL_PATH = resolveExtension('summary-tool');
 /** The canvas extensions every node loads, in order. The inbox watcher commits
  *  its cursor at agent_settled before the stophook checks it for idle release. */
 export const CANVAS_EXTENSIONS = [

package/dist/core/runtime/front-door.js

@@ -151,7 +151,7 @@ export async function maybeBootRoot(argv) {
     // Unambiguous front-door launch → boot a resident root inline (exec pi in
     // this terminal). Does not return. Load the heavy boot-path deps lazily now
     // that we've committed to booting (see the import note at the top of file).
-    const [{ bootRoot }, { resumeRoot }, { globalHumanloopWarning, missingPackageWarning, piAgentDir }] = await Promise.all([
+    const [{ bootRoot }, { resumeRoot }, { rendererWarning, missingPackageWarning, piAgentDir }] = await Promise.all([
         import('./boot-root.js'),
         import('./resume-root.js'),
         import('./package-health.js'),
@@ -164,9 +164,9 @@ export async function maybeBootRoot(argv) {
         const warn = missingPackageWarning(piAgentDir());
         if (warn !== null)
             process.stderr.write(`\n${warn}\n\n`);
-        const humanloopWarn = globalHumanloopWarning();
-        if (humanloopWarn !== null)
-            process.stderr.write(`\n${humanloopWarn}\n\n`);
+        const rendererWarn = rendererWarning();
+        if (rendererWarn !== null)
+            process.stderr.write(`\n${rendererWarn}\n\n`);
     }
     catch {
         /* best-effort diagnostic — never block a boot */

package/dist/core/runtime/kickoff.d.ts

@@ -1,6 +1,6 @@
 import { type NodeMeta } from '../canvas/index.js';
 import { type WakeOrigin } from './bearings.js';
-export { REVIVE_KICKOFF_SENTINEL } from '../../shared/generated-context.js';
+export { REVIVE_KICKOFF_SENTINEL, RUNTIME_RESTART_CONTINUATION, } from '../../shared/generated-context.js';
 /** The goal file — the prompt/task a node was spawned with, persisted at birth
  *  so a fresh revive can re-read its mandate. */
 export declare function goalPath(nodeId: string): string;
@@ -16,10 +16,6 @@ export declare function captureGoalIfAbsent(nodeId: string, text: string): boole
 /** Sentinel opening the fresh-revive kickoff message (see buildReviveKickoff).
  *  The goal-capture extension and attached renderers share its pure definition,
  *  so the same exact contract controls both prompt exclusion and display. */
-/** Injected only when a broker cleanly persisted an aborted in-flight turn
- * before a daemon restart. The transcript already carries the full picture, so
- * this is a bare nudge — a longer explanation only destabilizes the resume. */
-export declare const RUNTIME_RESTART_CONTINUATION = "continue";
 /** The yield-message file — a short note `crtr node yield` records for the next
  *  fresh/cycling revive ("on wake, do X"). It remains durable through failed
  *  launch attempts and is cleared only when session_start confirms a boot. */

package/dist/core/runtime/kickoff.js

@@ -25,7 +25,7 @@ import { buildWakeBearings } from './bearings.js';
 import { personaDrift, commitPersonaAck } from './persona.js';
 import { readInboxSince, readCursor, writeCursor, coalesce, } from '../feed/inbox.js';
 import { REVIVE_KICKOFF_SENTINEL } from '../../shared/generated-context.js';
-export { REVIVE_KICKOFF_SENTINEL } from '../../shared/generated-context.js';
+export { REVIVE_KICKOFF_SENTINEL, RUNTIME_RESTART_CONTINUATION, } from '../../shared/generated-context.js';
 // ---------------------------------------------------------------------------
 // Companion context files: the goal (the spawning mandate) and the one-shot
 // yield message (a note from the prior self to the revived self).
@@ -65,10 +65,6 @@ export function captureGoalIfAbsent(nodeId, text) {
 /** Sentinel opening the fresh-revive kickoff message (see buildReviveKickoff).
  *  The goal-capture extension and attached renderers share its pure definition,
  *  so the same exact contract controls both prompt exclusion and display. */
-/** Injected only when a broker cleanly persisted an aborted in-flight turn
- * before a daemon restart. The transcript already carries the full picture, so
- * this is a bare nudge — a longer explanation only destabilizes the resume. */
-export const RUNTIME_RESTART_CONTINUATION = 'continue';
 /** The yield-message file — a short note `crtr node yield` records for the next
  *  fresh/cycling revive ("on wake, do X"). It remains durable through failed
  *  launch attempts and is cleared only when session_start confirms a boot. */