@north-light/crouter 0.3.173 → 0.3.175

package/dist/clients/attach/__tests__/crtr-output-coverage.test.js

@@ -1,57 +0,0 @@
-import assert from 'node:assert/strict';
-import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import test from 'node:test';
-import { fileURLToPath } from 'node:url';
-const HERE = dirname(fileURLToPath(import.meta.url));
-const ROOT = join(HERE, '..', '..', '..');
-const EXTENSIONS = join(ROOT, 'builtin-pi-packages', 'pi-crtr-extensions', 'extensions');
-function read(path) {
-    return readFileSync(path, 'utf8');
-}
-function tsFiles(dir) {
-    return readdirSync(dir)
-        .flatMap((entry) => {
-        const path = join(dir, entry);
-        const stat = statSync(path);
-        if (stat.isDirectory())
-            return entry === 'node_modules' ? [] : tsFiles(path);
-        return path.endsWith('.ts') ? [path] : [];
-    });
-}
-test('crtr slash-command output is stamped with the rendered crtr-output message type', () => {
-    const source = read(join(EXTENSIONS, 'crtr-commands', 'index.ts'));
-    assert.match(source, /pi\.sendMessage\(\s*\{[\s\S]*customType:\s*["']crtr-output["'][\s\S]*content:\s*`\$ crtr/);
-});
-test('every extension message that displays `$ crtr ...` output uses crtr-output', () => {
-    const offenders = [];
-    for (const file of tsFiles(EXTENSIONS)) {
-        const source = read(file);
-        const crtrOutputBlocks = [...source.matchAll(/pi\.sendMessage\(\s*\{[\s\S]*?\}\s*,/g)];
-        for (const match of crtrOutputBlocks) {
-            const block = match[0];
-            if (!block.includes('$ crtr'))
-                continue;
-            if (!/customType:\s*["']crtr-output["']/.test(block))
-                offenders.push(file);
-        }
-    }
-    assert.deepEqual(offenders, []);
-});
-test('the broker bundle does not re-duplicate the attach viewer\'s crtr renderer', () => {
-    // The broker only ever runs pi in mode:'rpc' (broker.ts), and non-TUI modes
-    // never call renderCall/renderResult/registerMessageRenderer hooks (only
-    // interactive TUI mode does). crtr output rendering lives solely in the
-    // attach viewer's render/crtr-output.ts — this file must not exist in the
-    // broker's extension set.
-    assert.equal(existsSync(join(EXTENSIONS, 'crtr-bash-renderer.ts')), false);
-});
-test('the attach viewer covers crtr bash tool calls and crtr-output messages natively', () => {
-    const chatView = read(join(ROOT, 'clients', 'attach', 'render/chat-view.ts'));
-    assert.match(chatView, /CRTR_OUTPUT_CUSTOM_TYPE/);
-    assert.match(chatView, /new CrtrOutputMessageComponent\(/);
-    assert.match(chatView, /createCrtrBashToolDefinition\(args,\s*fold\)/);
-    // MinimizableToolComponent is the viewer's ToolExecutionComponent subclass (it
-    // adds the Ctrl+O minimized state); the crtr tool definition still threads through it.
-    assert.match(chatView, /new MinimizableToolComponent\([\s\S]*toolDefinition as never/);
-});

package/dist/clients/attach/__tests__/editor-frame-title.test.js

@@ -1,19 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { editorLabel } from '../../../core/canvas/labels.js';
-import { displayEditorTitle } from '../session/editor-frame.js';
-test('a reloaded renamed session still shows its generated icon', () => {
-    const identity = { kind: 'general', mode: 'base', icon: '\uf188' };
-    assert.equal(displayEditorTitle('test', identity), '\uf188 test');
-    assert.equal(displayEditorTitle('\uf188 test', identity), '\uf188 test');
-});
-test('a node restart restores the explicit editor name instead of the generated description', () => {
-    const meta = {
-        name: 'test',
-        kind: 'general',
-        mode: 'base',
-        description: 'preserve-icon-on-rename',
-        icon: '\uf188',
-    };
-    assert.equal(editorLabel(meta), '\uf188 test');
-});

package/dist/clients/attach/__tests__/input-controller-extension-command.test.js

@@ -1,32 +0,0 @@
-import assert from 'node:assert/strict';
-import test from 'node:test';
-import { InputController } from '../input/controller.js';
-function controller(sent) {
-    const editor = {
-        onSubmit: undefined,
-        onEscape: undefined,
-        onPasteImage: undefined,
-        onPasteImagePath: undefined,
-        onAction: () => { },
-        addToHistory: () => { },
-        setText: () => { },
-        getText: () => '',
-        insertTextAtCursor: () => { },
-    };
-    const input = new InputController({}, editor, { matches: () => false }, { onCommand: (frame) => sent.push(frame), onDialogResponse: () => { } });
-    return {
-        submit: (text) => editor.onSubmit(text),
-        setStreaming: (streaming) => input.setState({ isStreaming: streaming }),
-    };
-}
-test('an unrecognized slash command reaches the broker for extension dispatch', () => {
-    const sent = [];
-    const input = controller(sent);
-    input.submit('/recap');
-    input.setStreaming(true);
-    input.submit('/recap refresh');
-    assert.deepEqual(sent, [
-        { type: 'prompt', text: '/recap' },
-        { type: 'steer', text: '/recap refresh' },
-    ]);
-});

package/dist/clients/attach/__tests__/markdown-headings.test.js

@@ -1,35 +0,0 @@
-import assert from 'node:assert/strict';
-import test from 'node:test';
-import { initTheme } from '@earendil-works/pi-coding-agent';
-import { styleAttachMarkdownHeadings, styleAttachMessageMarkdown } from '../render/markdown-headings.js';
-initTheme('default');
-test('keeps primary headings with pi-tui and decorates lower terminal headings without markers', () => {
-    const source = '# Title\n\n## Section\n\n### Detail\n\n#### Label';
-    const rendered = styleAttachMarkdownHeadings(source);
-    assert.match(rendered, /## Section/, 'H2 retains pi-tui’s accent treatment');
-    assert.match(rendered, /\x1b\[[^m]+mDetail/, 'H3 receives its cool terminal color');
-    assert.match(rendered, /\x1b\[[^m]+mLabel/, 'H4 receives its muted terminal color');
-    assert.doesNotMatch(rendered, /###|####/, 'decorated heading markers are omitted');
-});
-test('does not decorate Markdown examples inside fenced code', () => {
-    const source = '### Detail\n\n```md\n### Example\n#### Label\n```';
-    const rendered = styleAttachMarkdownHeadings(source);
-    assert.match(rendered, /^\x1b\[[^m]+mDetail/, 'real heading is decorated without its marker');
-    assert.match(rendered, /```md\n### Example\n#### Label\n```$/, 'fenced source remains literal');
-});
-test('copies message blocks for terminal-only decoration', () => {
-    const source = { content: [{ type: 'text', text: '### Detail' }, { type: 'toolCall', id: 't1' }] };
-    const rendered = styleAttachMessageMarkdown(source);
-    assert.notEqual(rendered, source);
-    assert.equal(source.content[0].text, '### Detail', 'broker message remains unmodified');
-    assert.match(rendered.content[0].text, /^\x1b\[[^m]+mDetail/);
-    assert.equal(rendered.content[1], source.content[1], 'non-Markdown blocks preserve identity');
-});
-test('expands private-use codepoint references to glyphs, and only those', () => {
-    const source = { content: [{ type: 'text', text: 'icons: U+F188 U+F0001 — not U+0041 or U+241C, nor MU+FFFF' }] };
-    const rendered = styleAttachMessageMarkdown(source);
-    const text = rendered.content[0].text;
-    assert.match(text, new RegExp(`icons: ${String.fromCodePoint(0xf188)} ${String.fromCodePoint(0xf0001)}`), 'PUA references become their glyphs');
-    assert.match(text, /not U\+0041 or U\+241C/, 'ordinary codepoint references stay as text');
-    assert.match(text, /MU\+FFFF/, 'a reference glued to a word is not a reference');
-});

package/dist/clients/attach/__tests__/session-identity-refresh.test.js

@@ -1,32 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { createFrameHandler } from '../session/frames.js';
-test('a regenerated session title refreshes the cached canvas icon', () => {
-    let identityRefreshes = 0;
-    const noop = () => { };
-    const effects = {
-        foldState: noop,
-        chat: {
-            applySnapshot: noop,
-            handleEvent: noop,
-            setWorkingActivity: noop,
-            bashStart: noop,
-            bashOutput: noop,
-            bashEnd: noop,
-            applyToolGroupSummary: noop,
-        },
-        setNotice: noop,
-        renderFooter: noop,
-        setEditorText: noop,
-        attachDialog: noop,
-        dismissDialog: noop,
-        setCommands: noop,
-        resetMemoryRefs: noop,
-        refreshNodeIdentity: () => { identityRefreshes += 1; },
-        reloadBindings: noop,
-        modelThinkingLabel: () => undefined,
-    };
-    const handler = createFrameHandler({ socket: { send: noop } }, effects);
-    handler({ type: 'session_info_changed', name: '\uf14e compass-recap' });
-    assert.equal(identityRefreshes, 1);
-});

package/dist/clients/conversation/conversation.d.ts

@@ -1,65 +0,0 @@
-import { type TUI } from '@earendil-works/pi-tui';
-import type { CanvasSource } from '../../core/canvas/source.js';
-import { type SessionState } from '../../core/session-model/session-state.js';
-import { ChatView } from '../attach/render/chat-view.js';
-import { type TranscriptViewport } from '../attach/render/viewport.js';
-export type ConnectionState = 'connecting' | 'connected' | 'reconnecting' | 'dormant' | 'finished' | 'gone';
-export interface SurfaceConversationOptions {
-    nodeId: string;
-    /** Required by ChatView; this unit never drives the TUI directly. */
-    tui: TUI;
-    /** The reconnect supervisor's give-up read. */
-    canvasSource: CanvasSource;
-    /** The owning region's only repaint channel. */
-    onDirty(): void;
-    onConnection(state: ConnectionState): void;
-    /** One new transcript message, so an unread tally counts arrivals rather than
-     *  repaints (a streaming spinner invalidates continuously). */
-    onMessage(): void;
-    /** Request the review owner's canonical reopen operation when the attached broker is dormant. */
-    reopenDormantCompanion(): Promise<void>;
-    /** Region-scoped feedback, never a viewer-host notice. */
-    notice(text: string): void;
-}
-/**
- * A reusable local controller connection for a companion node. It deliberately
- * attaches to the companion broker. Its owner supplies the canonical review
- * reopen operation for dormant input; this unit never revives a node itself.
- */
-export declare class SurfaceConversation {
-    readonly chatView: ChatView;
-    readonly viewport: TranscriptViewport;
-    private readonly nodeId;
-    private readonly canvasSource;
-    private readonly onDirty;
-    private readonly onConnection;
-    private readonly onMessage;
-    private readonly notice;
-    private readonly reopenDormantCompanion;
-    private readonly socket;
-    private readonly role;
-    private session;
-    private state;
-    private tornDown;
-    private opened;
-    private reconnect;
-    private readonly queuedInputs;
-    private reopeningDormantCompanion;
-    constructor(opts: SurfaceConversationOptions);
-    connection(): ConnectionState;
-    sessionState(): SessionState;
-    /** Connect only to the already-running companion broker. */
-    open(): Promise<void>;
-    /** Submit through the one shared classifier; this unit has no slash chrome. */
-    submit(text: string): void;
-    abort(): void;
-    /** Stop redial first, then detach this client without changing node lifecycle. */
-    close(): void;
-    private installReconnect;
-    private send;
-    private reopenDormant;
-    private liveInputFrame;
-    private flushQueuedInputs;
-    private setConnection;
-    private dirty;
-}

package/dist/clients/conversation/conversation.js

@@ -1,318 +0,0 @@
-// conversation/conversation.ts — a headless broker-backed companion conversation.
-//
-// The review daemon owns companion liveness. This unit only connects to the
-// existing view.sock and projects its broker frames into reusable chat state.
-import { randomUUID } from 'node:crypto';
-import { Container } from '@earendil-works/pi-tui';
-import { BrokerClient } from '../../core/broker-client/index.js';
-import { initialSessionState, reduce } from '../../core/session-model/session-state.js';
-import { ChatView } from '../attach/render/chat-view.js';
-import { createTranscriptViewport } from '../attach/render/viewport.js';
-import { resolveHelloRole } from '../attach/session/connection.js';
-import { createReconnect } from '../attach/session/reconnect.js';
-import { classifySubmit } from './submit.js';
-import { createCompanionFrameHandler } from './frames.js';
-/**
- * A reusable local controller connection for a companion node. It deliberately
- * attaches to the companion broker. Its owner supplies the canonical review
- * reopen operation for dormant input; this unit never revives a node itself.
- */
-export class SurfaceConversation {
-    chatView;
-    viewport;
-    nodeId;
-    canvasSource;
-    onDirty;
-    onConnection;
-    onMessage;
-    notice;
-    reopenDormantCompanion;
-    socket;
-    role = resolveHelloRole(false, false);
-    session = initialSessionState(this.role);
-    state = 'connecting';
-    tornDown = false;
-    opened = false;
-    reconnect;
-    queuedInputs = [];
-    reopeningDormantCompanion = false;
-    constructor(opts) {
-        this.nodeId = opts.nodeId;
-        this.canvasSource = opts.canvasSource;
-        this.onDirty = opts.onDirty;
-        this.onConnection = opts.onConnection;
-        this.onMessage = opts.onMessage;
-        this.notice = opts.notice;
-        this.reopenDormantCompanion = opts.reopenDormantCompanion;
-        this.socket = new BrokerClient(opts.nodeId);
-        const chatContainer = new Container();
-        // ChatView and its self-updating children only receive an invalidation
-        // facade. Their requestRender calls return through the owning region rather
-        // than bypassing it to repaint the outer attach TUI directly.
-        const chatTui = {
-            requestRender: () => this.dirty(),
-            terminal: opts.tui.terminal,
-        };
-        this.chatView = new ChatView(chatTui, chatContainer, {
-            onActivityChange: () => this.dirty(),
-        });
-        this.viewport = createTranscriptViewport(this.chatView.transcriptSource());
-    }
-    connection() {
-        return this.state;
-    }
-    sessionState() {
-        return this.session;
-    }
-    /** Connect only to the already-running companion broker. */
-    open() {
-        if (this.opened)
-            return Promise.resolve();
-        if (this.tornDown)
-            return Promise.reject(new Error('surface conversation is closed'));
-        this.opened = true;
-        this.setConnection('connecting');
-        return new Promise((resolve, reject) => {
-            const onConnect = () => {
-                cleanup();
-                this.installReconnect();
-                this.reconnect?.sendHello();
-                resolve();
-            };
-            const onError = (error) => {
-                cleanup();
-                this.opened = false;
-                this.notice(`couldn't connect to companion: ${error.message}`);
-                this.dirty();
-                reject(error);
-            };
-            const cleanup = () => {
-                this.socket.off('connect', onConnect);
-                this.socket.off('error', onError);
-            };
-            this.socket.once('connect', onConnect);
-            this.socket.once('error', onError);
-            this.socket.connect();
-        });
-    }
-    /** Submit through the one shared classifier; this unit has no slash chrome. */
-    submit(text) {
-        if (this.tornDown || this.state === 'finished' || this.state === 'gone') {
-            this.notice('companion is no longer available');
-            this.dirty();
-            return;
-        }
-        if (this.state === 'connecting' || this.state === 'reconnecting') {
-            const frame = this.liveInputFrame(text);
-            if (frame === undefined)
-                return;
-            this.queuedInputs.push(frame);
-            this.notice('companion is reconnecting — input queued');
-            this.dirty();
-            return;
-        }
-        const classification = classifySubmit(text, {
-            isDormant: this.reconnect?.isDormant() === true,
-            canWakeDormant: true,
-            isStreaming: this.session.engine?.isStreaming === true,
-        });
-        switch (classification.kind) {
-            case 'empty':
-                return;
-            case 'dormant':
-                void this.reopenDormant({ type: 'prompt', text: classification.text });
-                return;
-            case 'bash':
-                this.send({ type: 'bash', command: classification.command, excludeFromContext: classification.excludeFromContext });
-                return;
-            case 'steer':
-                this.send({ type: 'steer', text: classification.text });
-                return;
-            case 'slash':
-                // This column has no slash dispatcher. A slash is ordinary companion
-                // input, so a dormant broker still needs the review-owned reopen path.
-                if (this.reconnect?.isDormant() === true) {
-                    void this.reopenDormant({ type: 'prompt', text });
-                    return;
-                }
-                this.send({ type: 'prompt', text });
-                return;
-            case 'prompt':
-                this.send({ type: 'prompt', text });
-                return;
-        }
-    }
-    abort() {
-        this.send({ type: 'abort' });
-    }
-    /** Stop redial first, then detach this client without changing node lifecycle. */
-    close() {
-        if (this.tornDown)
-            return;
-        this.tornDown = true;
-        this.reconnect?.stop();
-        try {
-            this.socket.send({ type: 'bye' });
-        }
-        catch {
-            // BrokerClient send is best-effort; a close race is ordinary teardown.
-        }
-        this.socket.close();
-        try {
-            this.chatView.dispose();
-        }
-        catch {
-            // A stale pi component must not block host cleanup.
-        }
-    }
-    installReconnect() {
-        if (this.reconnect !== undefined)
-            return;
-        const nodeDone = () => this.setConnection('finished');
-        const handleFrame = createCompanionFrameHandler({
-            foldState: (frame) => {
-                this.session = reduce(this.session, frame);
-                this.dirty();
-            },
-            chat: {
-                applySnapshot: (snapshot) => {
-                    const applied = this.chatView.applySnapshot(snapshot);
-                    this.dirty();
-                    return applied;
-                },
-                handleEvent: (event) => {
-                    this.chatView.handleEvent(event);
-                    if (event.type === 'message_start')
-                        this.onMessage();
-                    this.dirty();
-                },
-                bashStart: (command, excludeFromContext) => {
-                    this.chatView.bashStart(command, excludeFromContext);
-                    this.dirty();
-                },
-                bashOutput: (chunk) => {
-                    this.chatView.bashOutput(chunk);
-                    this.dirty();
-                },
-                bashEnd: (frame) => {
-                    this.chatView.bashEnd(frame);
-                    this.dirty();
-                },
-                applyToolGroupSummary: (key, summary) => {
-                    this.chatView.applyToolGroupSummary(key, summary);
-                    this.dirty();
-                },
-            },
-            setConnection: () => {
-                this.setConnection('connected');
-                this.flushQueuedInputs();
-            },
-            notice: (text) => {
-                this.notice(text);
-                this.dirty();
-            },
-            declineDialog: (request) => this.socket.send({ type: 'extension_ui_response', id: request.id, cancelled: true }),
-            onNodeDone: nodeDone,
-        });
-        this.reconnect = createReconnect({ nodeId: this.nodeId, socket: this.socket, canvasSource: this.canvasSource }, {
-            role: this.role,
-            clientId: randomUUID(),
-            onFrame: handleFrame,
-            setNotice: (text) => {
-                if (text)
-                    this.setConnection('reconnecting');
-                this.notice(text);
-                this.dirty();
-            },
-            isTornDown: () => this.tornDown,
-            teardown: (reason) => {
-                if (reason === 'node-done')
-                    nodeDone();
-                else
-                    this.setConnection('gone');
-            },
-            onEnterDormancy: () => {
-                this.chatView.settleRun();
-                this.session = this.session.engine === undefined
-                    ? this.session
-                    : { ...this.session, engine: { ...this.session.engine, isStreaming: false } };
-                this.setConnection('dormant');
-            },
-        });
-        this.reconnect.install();
-    }
-    send(frame) {
-        if (this.tornDown || this.state === 'finished' || this.state === 'gone') {
-            this.notice('companion is no longer available');
-            this.dirty();
-            return;
-        }
-        if (this.state === 'connecting' || this.state === 'reconnecting') {
-            this.notice('companion is reconnecting — input was not sent');
-            this.dirty();
-            return;
-        }
-        this.socket.send(frame);
-    }
-    async reopenDormant(frame) {
-        this.queuedInputs.push(frame);
-        if (this.reopeningDormantCompanion) {
-            this.notice('↻ waking companion — input queued');
-            this.dirty();
-            return;
-        }
-        this.reopeningDormantCompanion = true;
-        this.setConnection('reconnecting');
-        try {
-            await this.reopenDormantCompanion();
-            this.notice('↻ waking companion…');
-        }
-        catch (error) {
-            this.setConnection('dormant');
-            this.notice(`couldn't reopen companion; input is queued: ${error instanceof Error ? error.message : String(error)}`);
-        }
-        finally {
-            this.reopeningDormantCompanion = false;
-            this.flushQueuedInputs();
-            this.dirty();
-        }
-    }
-    liveInputFrame(text) {
-        const classification = classifySubmit(text, {
-            isDormant: false,
-            canWakeDormant: false,
-            isStreaming: this.session.engine?.isStreaming === true,
-        });
-        switch (classification.kind) {
-            case 'empty':
-                return undefined;
-            case 'bash':
-                return { type: 'bash', command: classification.command, excludeFromContext: classification.excludeFromContext };
-            case 'steer':
-                return { type: 'steer', text: classification.text };
-            case 'slash':
-            case 'prompt':
-                return { type: 'prompt', text };
-            case 'dormant':
-                throw new Error('live companion input cannot be dormant');
-        }
-    }
-    flushQueuedInputs() {
-        if (this.tornDown || this.reopeningDormantCompanion || this.state !== 'connected')
-            return;
-        for (const frame of this.queuedInputs.splice(0)) {
-            this.socket.send(frame);
-        }
-    }
-    setConnection(state) {
-        if (this.state === state)
-            return;
-        this.state = state;
-        this.onConnection(state);
-        this.dirty();
-    }
-    dirty() {
-        if (!this.tornDown)
-            this.onDirty();
-    }
-}

package/dist/clients/conversation/frames.d.ts

@@ -1,30 +0,0 @@
-import type { AgentSessionEvent } from '@earendil-works/pi-coding-agent';
-import type { BrokerToClient, RpcExtensionUIRequest } from '../../core/runtime/broker-protocol.js';
-import type { ToolGroupSummary } from '../../shared/tool-groups.js';
-export interface CompanionFrameEffects {
-    /** Fold every broker fact through the shared session reducer before local effects. */
-    foldState: (frame: BrokerToClient) => void;
-    /** The only transcript writes a companion conversation performs. */
-    chat: {
-        applySnapshot: (snapshot: Extract<BrokerToClient, {
-            type: 'welcome';
-        }>['snapshot']) => Promise<void> | void;
-        handleEvent: (event: AgentSessionEvent) => void;
-        bashStart: (command: string, excludeFromContext?: boolean) => void;
-        bashOutput: (chunk: string) => void;
-        bashEnd: (frame: Extract<BrokerToClient, {
-            type: 'bash_end';
-        }>) => void;
-        applyToolGroupSummary: (key: string, summary: ToolGroupSummary) => void;
-    };
-    /** The welcome handshake established a live broker connection. */
-    setConnection: () => void;
-    /** A region-scoped transient. */
-    notice: (text: string) => void;
-    /** Decline a blocking extension dialog rather than mounting another overlay host. */
-    declineDialog: (request: RpcExtensionUIRequest) => void;
-    /** The reconnect supervisor establishes terminal node completion. */
-    onNodeDone: () => void;
-}
-/** Build the companion's deliberately small broker-frame handler. */
-export declare function createCompanionFrameHandler(fx: CompanionFrameEffects): (frame: BrokerToClient) => void;

package/dist/clients/conversation/frames.js

@@ -1,52 +0,0 @@
-// conversation/frames.ts — broker-frame effects for a companion conversation.
-//
-// This is intentionally narrower than attach/session/frames.ts. A companion
-// column owns transcript state and connection presentation, not viewer chrome.
-function isBlockingDialog(request) {
-    return request.method === 'select' || request.method === 'confirm' || request.method === 'input' || request.method === 'editor';
-}
-/** Build the companion's deliberately small broker-frame handler. */
-export function createCompanionFrameHandler(fx) {
-    return (frame) => {
-        fx.foldState(frame);
-        switch (frame.type) {
-            case 'welcome':
-                void fx.chat.applySnapshot(frame.snapshot);
-                fx.setConnection();
-                if (frame.pending_dialog !== null && frame.pending_dialog !== undefined && isBlockingDialog(frame.pending_dialog)) {
-                    fx.declineDialog(frame.pending_dialog);
-                    fx.notice('companion asked for a dialog — open its own attach view');
-                }
-                return;
-            case 'tool_group_summary':
-                fx.chat.applyToolGroupSummary(frame.key, frame.summary);
-                return;
-            case 'error':
-                fx.notice(frame.code === 'read_only' ? 'read-only' : `error: ${frame.message}`);
-                return;
-            case 'ack':
-                if (!frame.ok)
-                    fx.notice(`command failed: ${frame.for}${frame.detail ? ` — ${frame.detail}` : ''}`);
-                return;
-            case 'extension_ui_request':
-                if (isBlockingDialog(frame)) {
-                    fx.declineDialog(frame);
-                    fx.notice('companion asked for a dialog — open its own attach view');
-                }
-                return;
-            case 'extension_ui_dismiss':
-                return;
-            case 'bash_start':
-                fx.chat.bashStart(frame.command, frame.excludeFromContext);
-                return;
-            case 'bash_output':
-                fx.chat.bashOutput(frame.chunk);
-                return;
-            case 'bash_end':
-                fx.chat.bashEnd(frame);
-                return;
-            default:
-                fx.chat.handleEvent(frame);
-        }
-    };
-}