@agi-fans/dsh-tui 0.20.0 → 0.22.0

package/lib/runtime/terminal-notifications.d.ts

@@ -1,5 +1,5 @@
 /** Opt-in terminal notifications kept outside the transcript renderer. */
-export type TerminalNotificationPolicy = 'off' | 'long-running' | 'always';
+export type TerminalNotificationPolicy = 'off' | 'unfocused' | 'always';
 export interface TerminalNotificationOptions {
     readonly policy: TerminalNotificationPolicy;
     readonly thresholdMs: number;
@@ -20,15 +20,13 @@ export declare class TerminalNotificationController {
     event(event: NotificationEvent, now?: number): TerminalNotification | undefined;
     humanPrompt(label?: string): TerminalNotification | undefined;
 }
-export type NotificationFocus = 'always' | 'unfocused';
 /** Keep one notification per event burst, with input requests and failures first. */
 export declare class TerminalNotificationQueue {
     #private;
     offer(notification: TerminalNotification): void;
     clear(): void;
-    take(condition: NotificationFocus, focused: boolean | undefined): TerminalNotification | undefined;
+    /** Drain the coalesced event. Whether it should be delivered is the caller's policy. */
+    take(): TerminalNotification | undefined;
 }
 /** OSC 9 is supported by common terminal emulators and never enters screen text. */
 export declare function terminalNotificationSequence(notification: TerminalNotification): string;
-/** Windows Terminal-compatible native taskbar/tab progress sequences. */
-export declare function terminalProgressSequence(active: boolean): string;

package/lib/runtime/terminal-notifications.js

@@ -45,7 +45,7 @@ export class TerminalNotificationController {
         if (startedAt === undefined || this.#options.policy === 'off')
             return undefined;
         const elapsedMs = Math.max(0, endedAt - startedAt);
-        if (this.#options.policy === 'long-running' && elapsedMs < this.#options.thresholdMs)
+        if (this.#options.policy === 'unfocused' && elapsedMs < this.#options.thresholdMs)
             return undefined;
         return {
             title: event.reason && event.reason !== 'complete' && event.reason !== 'completed' ? 'omdsh needs attention' : 'omdsh finished',
@@ -67,11 +67,11 @@ export class TerminalNotificationQueue {
         this.#pending = notification;
     }
     clear() { this.#pending = undefined; }
-    take(condition, focused) {
+    /** Drain the coalesced event. Whether it should be delivered is the caller's policy. */
+    take() {
         const pending = this.#pending;
         this.clear();
-        // A terminal without focus reports retains the existing notification behavior.
-        return condition === 'unfocused' && focused === true ? undefined : pending;
+        return pending;
     }
 }
 function cleanNotificationText(value) {
@@ -82,8 +82,4 @@ export function terminalNotificationSequence(notification) {
     const message = cleanNotificationText(`${notification.title}: ${notification.body}`);
     return message ? `\x1b]9;${message}\x07` : '';
 }
-/** Windows Terminal-compatible native taskbar/tab progress sequences. */
-export function terminalProgressSequence(active) {
-    return active ? '\x1b]9;4;3\x07' : '\x1b]9;4;0;\x07';
-}
 //# sourceMappingURL=terminal-notifications.js.map

package/lib/runtime/terminal-notifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-notifications.js","sourceRoot":"","sources":["../../src/runtime/terminal-notifications.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"terminal-notifications.js","sourceRoot":"","sources":["../../src/runtime/terminal-notifications.ts"],"names":[],"mappings":"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"}

package/lib/runtime/terminal-probe.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Keyboard protocol negotiation: whether to speak the Kitty keyboard protocol,
+ * and the sequences that ask for it and give it back.
+ *
+ * The query only asks (`CSI ? u`) and never changes the terminal's state; the
+ * primary device-attributes request that follows is answered by every
+ * terminal, so it marks the end of the round trip. A terminal that reports
+ * Kitty flags gets exactly one push of the disambiguate flag; the session's
+ * mode registry pops it on hand-off and exit and pushes it again on resume. A
+ * terminal that answers only the device attributes keeps its legacy encoding.
+ * @module @agi-fans/dsh-tui/terminal-probe
+ */
+import type { KeyEvent } from '../input/keys.ts';
+/** Ask for the current Kitty flags. Changes nothing; the session's own sentinel follows it. */
+export declare const KEYBOARD_PROTOCOL_QUERY = "\u001B[?u";
+/** Push Kitty flag 1 (disambiguate escape codes) for this session. */
+export declare const KITTY_PROTOCOL_ON = "\u001B[>1u";
+/** Pop the one Kitty entry this session pushed. */
+export declare const KITTY_PROTOCOL_OFF = "\u001B[<u";
+/** The protocol a session settled on; absent while negotiating or when the terminal offers none. */
+export type KeyboardProtocol = 'kitty';
+/** One step of the negotiation. */
+export interface NegotiationStep {
+    protocol?: KeyboardProtocol;
+    /** The enable sequence the caller must write, at most once per session. */
+    output?: string;
+    /** True once the terminal has answered enough for the choice to be final. */
+    settled: boolean;
+}
+/**
+ * Advance the negotiation with one decoded event.
+ * @param protocol - what the session currently speaks, if anything.
+ * @param event - the decoded input event.
+ * @returns the next protocol, any sequence to write, and whether the choice is final.
+ */
+export declare function negotiateKeyboard(protocol: KeyboardProtocol | undefined, event: KeyEvent): NegotiationStep;

package/lib/runtime/terminal-probe.js

@@ -0,0 +1,37 @@
+/**
+ * Keyboard protocol negotiation: whether to speak the Kitty keyboard protocol,
+ * and the sequences that ask for it and give it back.
+ *
+ * The query only asks (`CSI ? u`) and never changes the terminal's state; the
+ * primary device-attributes request that follows is answered by every
+ * terminal, so it marks the end of the round trip. A terminal that reports
+ * Kitty flags gets exactly one push of the disambiguate flag; the session's
+ * mode registry pops it on hand-off and exit and pushes it again on resume. A
+ * terminal that answers only the device attributes keeps its legacy encoding.
+ * @module @agi-fans/dsh-tui/terminal-probe
+ */
+/** Ask for the current Kitty flags. Changes nothing; the session's own sentinel follows it. */
+export const KEYBOARD_PROTOCOL_QUERY = '\x1b[?u';
+/** Push Kitty flag 1 (disambiguate escape codes) for this session. */
+export const KITTY_PROTOCOL_ON = '\x1b[>1u';
+/** Pop the one Kitty entry this session pushed. */
+export const KITTY_PROTOCOL_OFF = '\x1b[<u';
+/**
+ * Advance the negotiation with one decoded event.
+ * @param protocol - what the session currently speaks, if anything.
+ * @param event - the decoded input event.
+ * @returns the next protocol, any sequence to write, and whether the choice is final.
+ */
+export function negotiateKeyboard(protocol, event) {
+    if (protocol !== undefined)
+        return { protocol, settled: true };
+    // Any flags report, zero included, proves the terminal implements the
+    // protocol; the reported value is only what is enabled right now.
+    if (event.type === 'kitty-flags')
+        return { protocol: 'kitty', output: KITTY_PROTOCOL_ON, settled: true };
+    // The sentinel arrived without a flags report: keep the legacy encoding.
+    if (event.type === 'device-attributes')
+        return { settled: true };
+    return { settled: false };
+}
+//# sourceMappingURL=terminal-probe.js.map

package/lib/runtime/terminal-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-probe.js","sourceRoot":"","sources":["../../src/runtime/terminal-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,+FAA+F;AAC/F,MAAM,CAAC,MAAM,uBAAuB,GAAG,SAAS,CAAA;AAChD,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAA;AAC3C,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAA;AAc3C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAsC,EAAE,KAAe;IACvF,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC9D,sEAAsE;IACtE,kEAAkE;IAClE,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACxG,yEAAyE;IACzE,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAChE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;AAC3B,CAAC"}

package/lib/runtime/terminal-session.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Owns the terminal's capability probe and the modes the session turns on.
+ *
+ * One query asks for the keyboard protocol, the reported colors and scheme,
+ * and DEC mode 2031 support; a trailing device-attributes request is the
+ * sentinel every terminal answers, so the probe settles on its reply instead
+ * of a timeout. Replies that arrive after settlement — late palette entries,
+ * color-scheme pushes — are adopted and coalesced into one `colorsChanged`
+ * call per burst.
+ * @module @agi-fans/dsh-tui/terminal-session
+ */
+import { type TerminalColors } from '../chrome/terminal-colors.ts';
+import type { KeyEvent } from '../input/keys.ts';
+import { type TerminalMode } from './terminal-modes.ts';
+import { type KeyboardProtocol } from './terminal-probe.ts';
+/**
+ * The one startup probe. The device-attributes request MUST stay last:
+ * terminals answer in order, so its reply marks the end of every reply the
+ * earlier queries produced.
+ */
+export declare const CAPABILITY_QUERY: string;
+export interface TerminalSessionHost {
+    write(bytes: string): void;
+    /** Renderer hooks for per-screen Kitty stacks. */
+    alternateActive(): boolean;
+    setAlternateScreenModes(modes: {
+        enter: string;
+        exit: string;
+    }): void;
+    deferUntilMainScreen(bytes: string): void;
+    /** Called (coalesced) when reported colors or scheme changed after settlement. */
+    colorsChanged(): void;
+    /** Called exactly once when the startup probe settles (DA1 reply or timeout). */
+    probeSettled(): void;
+}
+export declare class TerminalSession {
+    #private;
+    constructor(host: TerminalSessionHost, options?: {
+        probeTimeoutMs?: number;
+    });
+    get colors(): TerminalColors;
+    get keyboardProtocol(): KeyboardProtocol | undefined;
+    get settled(): boolean;
+    /** Write the one-time capability query and arm its deadline. */
+    start(): void;
+    setMode(name: string, mode: TerminalMode, on: boolean): void;
+    handOff(): void;
+    takeBack(): void;
+    release(): void;
+    /**
+     * Consume one decoded event. Returns true for capability replies — color,
+     * scheme, keyboard and mode reports — so the caller drops them rather than
+     * treating them as input.
+     */
+    handle(event: KeyEvent): boolean;
+    dispose(): void;
+}

package/lib/runtime/terminal-session.js

@@ -0,0 +1,164 @@
+/**
+ * Owns the terminal's capability probe and the modes the session turns on.
+ *
+ * One query asks for the keyboard protocol, the reported colors and scheme,
+ * and DEC mode 2031 support; a trailing device-attributes request is the
+ * sentinel every terminal answers, so the probe settles on its reply instead
+ * of a timeout. Replies that arrive after settlement — late palette entries,
+ * color-scheme pushes — are adopted and coalesced into one `colorsChanged`
+ * call per burst.
+ * @module @agi-fans/dsh-tui/terminal-session
+ */
+import { COLOR_QUERY, COLOR_SCHEME_QUERY, mergeColorReply } from "../chrome/terminal-colors.js";
+import { KITTY_KEYBOARD, TerminalModes } from "./terminal-modes.js";
+import { KEYBOARD_PROTOCOL_QUERY, negotiateKeyboard } from "./terminal-probe.js";
+/**
+ * The one startup probe. The device-attributes request MUST stay last:
+ * terminals answer in order, so its reply marks the end of every reply the
+ * earlier queries produced.
+ */
+export const CAPABILITY_QUERY = KEYBOARD_PROTOCOL_QUERY + COLOR_QUERY + COLOR_SCHEME_QUERY + '\x1b[?2031$p' + '\x1b[c';
+/** DEC mode 2031 enable/disable, armed only after DECRQM reports support. */
+const COLOR_SCHEME_NOTIFY = { enable: '\x1b[?2031h', disable: '\x1b[?2031l' };
+/** How long the startup probe may wait for the DA1 sentinel. */
+const DEFAULT_PROBE_TIMEOUT_MS = 200;
+/** Color replies are coalesced into one colorsChanged call per this window. */
+const COLORS_CHANGED_MS = 30;
+/** A scheme change re-queries the colors after this debounce. */
+const SCHEME_REQUERY_MS = 100;
+export class TerminalSession {
+    #host;
+    #probeTimeoutMs;
+    #modes;
+    #colors = {};
+    #keyboardProtocol;
+    #querySent = false;
+    #settled = false;
+    #settleNotified = false;
+    #probeTimer;
+    #colorTimer;
+    #schemeTimer;
+    #disposed = false;
+    constructor(host, options) {
+        this.#host = host;
+        this.#probeTimeoutMs = options?.probeTimeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS;
+        this.#modes = new TerminalModes(bytes => { host.write(bytes); });
+    }
+    get colors() { return this.#colors; }
+    get keyboardProtocol() { return this.#keyboardProtocol; }
+    get settled() { return this.#settled; }
+    /** Write the one-time capability query and arm its deadline. */
+    start() {
+        if (this.#querySent)
+            return;
+        this.#querySent = true;
+        this.#host.write(CAPABILITY_QUERY);
+        this.#probeTimer = setTimeout(() => {
+            this.#probeTimer = undefined;
+            this.#settle();
+        }, this.#probeTimeoutMs);
+    }
+    setMode(name, mode, on) {
+        if (on)
+            this.#modes.enable(name, mode);
+        else
+            this.#modes.disable(name);
+    }
+    handOff() { this.#modes.handOff(); }
+    takeBack() { this.#modes.takeBack(); }
+    release() { this.#modes.release(); }
+    /**
+     * Consume one decoded event. Returns true for capability replies — color,
+     * scheme, keyboard and mode reports — so the caller drops them rather than
+     * treating them as input.
+     */
+    handle(event) {
+        if (event.type === 'color-reply') {
+            this.#colors = mergeColorReply(this.#colors, event.reply);
+            this.#colorsDirty();
+            return true;
+        }
+        if (event.type === 'color-scheme') {
+            const previous = this.#colors.scheme;
+            this.#colors = { ...this.#colors, scheme: event.scheme };
+            this.#colorsDirty();
+            // A scheme flip after settlement re-queries the palette so quantized
+            // colors follow the new polarity; identical reports need nothing.
+            if (this.#settled && previous !== event.scheme && this.#schemeTimer === undefined) {
+                this.#schemeTimer = setTimeout(() => {
+                    this.#schemeTimer = undefined;
+                    if (!this.#disposed)
+                        this.#host.write(COLOR_QUERY);
+                }, SCHEME_REQUERY_MS);
+            }
+            return true;
+        }
+        if (event.type === 'kitty-flags' || event.type === 'device-attributes') {
+            const step = negotiateKeyboard(this.#keyboardProtocol, event);
+            if (step.output !== undefined && step.protocol === 'kitty') {
+                if (this.#host.alternateActive()) {
+                    // The overlay owns this Kitty stack; the main screen's push waits
+                    // for the exit so each buffer sees exactly one.
+                    this.#modes.adopt('keyboard', KITTY_KEYBOARD);
+                    this.#host.deferUntilMainScreen(KITTY_KEYBOARD.enable);
+                }
+                else {
+                    this.#modes.enable('keyboard', KITTY_KEYBOARD);
+                }
+                this.#host.setAlternateScreenModes({ enter: KITTY_KEYBOARD.enable, exit: KITTY_KEYBOARD.disable });
+            }
+            this.#keyboardProtocol = step.protocol ?? this.#keyboardProtocol;
+            if (event.type === 'device-attributes' && !this.#settled)
+                this.#settle();
+            return true;
+        }
+        if (event.type === 'mode-report') {
+            if (event.mode === 2031 && (event.state === 1 || event.state === 2)) {
+                this.#modes.enable('color-scheme-notify', COLOR_SCHEME_NOTIFY);
+            }
+            return true;
+        }
+        return false;
+    }
+    dispose() {
+        this.#disposed = true;
+        if (this.#probeTimer !== undefined)
+            clearTimeout(this.#probeTimer);
+        if (this.#colorTimer !== undefined)
+            clearTimeout(this.#colorTimer);
+        if (this.#schemeTimer !== undefined)
+            clearTimeout(this.#schemeTimer);
+        this.#probeTimer = this.#colorTimer = this.#schemeTimer = undefined;
+        this.#modes.release();
+    }
+    #settle() {
+        if (this.#settled)
+            return;
+        this.#settled = true;
+        if (this.#probeTimer !== undefined) {
+            clearTimeout(this.#probeTimer);
+            this.#probeTimer = undefined;
+        }
+        if (this.#settleNotified)
+            return;
+        this.#settleNotified = true;
+        // Replies buffered while probing are part of the settled frame, so only
+        // changes from here on notify.
+        if (this.#colorTimer !== undefined) {
+            clearTimeout(this.#colorTimer);
+            this.#colorTimer = undefined;
+        }
+        this.#host.probeSettled();
+    }
+    /** Mark accumulated colors dirty; changes notify only after settlement. */
+    #colorsDirty() {
+        if (!this.#settled || this.#colorTimer !== undefined)
+            return;
+        this.#colorTimer = setTimeout(() => {
+            this.#colorTimer = undefined;
+            if (!this.#disposed)
+                this.#host.colorsChanged();
+        }, COLORS_CHANGED_MS);
+    }
+}
+//# sourceMappingURL=terminal-session.js.map

package/lib/runtime/terminal-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-session.js","sourceRoot":"","sources":["../../src/runtime/terminal-session.ts"],"names":[],"mappings":"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"}

package/lib/runtime/terminal-state.d.ts

@@ -0,0 +1,29 @@
+export type AgentActivityState = 'idle' | 'working' | 'blocked';
+export interface AgentActivityStatus {
+    readonly state: AgentActivityState;
+    readonly message?: string;
+}
+export type TerminalProgramState = AgentActivityState | 'done' | 'error';
+export interface TerminalProgramStatus {
+    readonly state: TerminalProgramState;
+    readonly message?: string;
+}
+export declare const TERMINAL_TITLE_MODES: readonly ["status", "session", "workspace", "off"];
+export type TerminalTitleMode = typeof TERMINAL_TITLE_MODES[number];
+export declare const TERMINAL_STATE_MODES: readonly ["auto", "on", "off"];
+export type TerminalStateMode = typeof TERMINAL_STATE_MODES[number];
+export declare const PROGRAM_STATUS_QUERY = "\u001B]7501;?\u001B\\";
+/** Status protocol carries titles only, never prompts, tool input or error payloads. */
+export declare function programStatusSequence(status: TerminalProgramStatus | 'clear'): string;
+export declare function terminalTitle(mode: TerminalTitleMode, status: TerminalProgramStatus, session: string | undefined, cwd: string, branch?: string): string;
+export declare class AgentActivityController {
+    #private;
+    get current(): AgentActivityStatus;
+    get program(): TerminalProgramStatus;
+    start(): AgentActivityStatus;
+    setRunning(running: boolean): AgentActivityStatus | undefined;
+    settled(reason: string): void;
+    resetResult(): void;
+    prompt(message?: string): AgentActivityStatus | undefined;
+    promptResolved(): AgentActivityStatus | undefined;
+}

package/lib/runtime/terminal-state.js

@@ -0,0 +1,62 @@
+/** Root activity projected once for Herdr and the foreground terminal. */
+import { basename } from 'node:path';
+export const TERMINAL_TITLE_MODES = ['status', 'session', 'workspace', 'off'];
+export const TERMINAL_STATE_MODES = ['auto', 'on', 'off'];
+export const PROGRAM_STATUS_QUERY = '\x1b]7501;?\x1b\\';
+function clean(value, limit) {
+    if (value === undefined)
+        return undefined;
+    const text = [...value.replace(/[\u0000-\u001f\u007f-\u009f]/gu, ' ').replace(/\s+/gu, ' ').trim()].slice(0, limit).join('');
+    return text === '' ? undefined : text;
+}
+/** Status protocol carries titles only, never prompts, tool input or error payloads. */
+export function programStatusSequence(status) {
+    if (status === 'clear')
+        return '\x1b]7501;state=clear:app=omdsh\x1b\\';
+    const message = clean(status.message, 240);
+    return `\x1b]7501;state=${status.state}:app=omdsh${message === undefined ? '' : `:msg=${Buffer.from(message).toString('base64')}`}\x1b\\`;
+}
+const STATE_LABELS = { idle: 'Ready', working: 'Working', blocked: 'Needs input', done: 'Done', error: 'Failed' };
+export function terminalTitle(mode, status, session, cwd, branch) {
+    if (mode === 'off')
+        return '';
+    if (mode === 'session')
+        return clean(session, 120) ?? '';
+    const subject = mode === 'workspace' ? [basename(cwd), branch].filter(Boolean).join(' · ') : session ?? basename(cwd);
+    return clean([STATE_LABELS[status.state], subject, 'omdsh'].filter(Boolean).join(' · '), 120) ?? '';
+}
+export class AgentActivityController {
+    #running = false;
+    #prompts = [];
+    #last;
+    #result = 'idle';
+    get current() {
+        const message = this.#prompts.at(-1);
+        return this.#prompts.length > 0 ? { state: 'blocked', ...(message === undefined ? {} : { message }) } : { state: this.#running ? 'working' : 'idle' };
+    }
+    get program() {
+        const current = this.current;
+        return current.state === 'idle' ? { state: this.#result } : current;
+    }
+    start() { return this.#publish(true); }
+    setRunning(running) {
+        if (running && !this.#running)
+            this.#result = 'idle';
+        this.#running = running;
+        return this.#publish();
+    }
+    settled(reason) { this.#result = ['complete', 'completed'].includes(reason) ? 'done' : ['aborted', 'interrupted'].includes(reason) ? 'idle' : 'error'; }
+    resetResult() { this.#result = 'idle'; }
+    prompt(message) { this.#prompts.push(clean(message, 240)); return this.#publish(); }
+    promptResolved() { if (this.#prompts.length === 0)
+        return undefined; this.#prompts.pop(); return this.#publish(); }
+    #publish(force = false) {
+        const next = this.current;
+        const signature = `${next.state}\0${next.message ?? ''}`;
+        if (!force && signature === this.#last)
+            return undefined;
+        this.#last = signature;
+        return next;
+    }
+}
+//# sourceMappingURL=terminal-state.js.map

package/lib/runtime/terminal-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-state.js","sourceRoot":"","sources":["../../src/runtime/terminal-state.ts"],"names":[],"mappings":"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"}

package/lib/runtime/tool-presentation.js

@@ -12,6 +12,15 @@ function parsedArguments(raw) {
         return raw;
     }
 }
+function callKey(event) {
+    if (event.type === 'tool/call')
+        return event.data.callId;
+    if (event.type === 'tool/result')
+        return event.data.message.source.callId;
+    if (event.type === 'tool/ptc-dispatch-start' || event.type === 'tool/ptc-dispatch')
+        return event.data.subCallId;
+    return undefined;
+}
 class HarnessToolPresentation {
     #ctx;
     /**
@@ -24,16 +33,31 @@ class HarnessToolPresentation {
         this.#ctx = ctx;
     }
     event(agent, event) {
-        if (event.type === 'tool/call') {
+        if (event.type === 'tool/call' || event.type === 'tool/ptc-dispatch-start') {
             let calls = this.#liveCalls.get(agent.session);
             if (calls === undefined) {
                 calls = new Map();
                 this.#liveCalls.set(agent.session, calls);
             }
-            calls.set(event.data.callId, event);
+            calls.set(callKey(event), { event, cwd: this.#directory(agent) });
         }
         return this.#event(agent, event, undefined);
     }
+    #directory(agent, initial = false) {
+        const service = typeof this.#ctx.get === 'function' ? this.#ctx.get('workingDirectory') : undefined;
+        return initial ? agent.session.header?.cwd ?? service?.defaultDirectory : service?.get(agent.session) ?? agent.session.header?.cwd;
+    }
+    #records(agent, events, initial = this.#directory(agent, true)) {
+        const records = new Map();
+        let cwd = initial;
+        for (const event of events) {
+            if (event.type === 'working-directory/change')
+                cwd = event.data.cwd;
+            if (event.type === 'tool/call' || event.type === 'tool/ptc-dispatch-start')
+                records.set(callKey(event), { event, cwd });
+        }
+        return records;
+    }
     #presentCall(agent, name, args) {
         const definition = this.#ctx.tools.get(name, agent);
         if (definition?.presentCall === undefined)
@@ -67,38 +91,50 @@ class HarnessToolPresentation {
         };
     }
     #event(agent, event, callIndex) {
+        const key = callKey(event);
+        if (key === undefined)
+            return undefined;
+        const record = callIndex?.get(key) ?? this.#liveCalls.get(agent.session)?.get(key)
+            ?? this.#records(agent, agent.session.snapshotEvents()).get(key);
+        const cwd = record?.cwd;
+        const located = (presentation) => presentation === undefined
+            ? undefined : cwd === undefined ? presentation : { ...presentation, cwd };
         // A PTC sub-dispatch carries the tool name and its normalized arguments on
         // both halves of the pair, so it resolves a card without a call index — the
         // same cards a native call of the same tool would get.
         if (event.type === 'tool/ptc-dispatch-start') {
             const call = this.#presentCall(agent, event.data.name, event.data.arguments);
-            return call === undefined ? undefined : { call };
+            return located(call === undefined ? undefined : { call });
         }
         if (event.type === 'tool/ptc-dispatch') {
-            return this.#present(agent, event.data.name, event.data.arguments, event.data.content, event.data.isError, undefined);
+            return located(this.#present(agent, event.data.name, event.data.arguments, event.data.content, event.data.isError, undefined));
         }
         if (event.type === 'tool/call') {
             const call = this.#presentCall(agent, event.data.name, parsedArguments(event.data.arguments));
-            return call === undefined ? undefined : { call };
+            return located(call === undefined ? undefined : { call });
         }
         if (event.type !== 'tool/result')
             return undefined;
-        const callId = event.data.message.source.callId;
-        const callEvent = callIndex?.get(callId)
-            ?? this.#liveCalls.get(agent.session)?.get(callId)
-            ?? agent.session.snapshotEvents().findLast(candidate => candidate.type === 'tool/call' && candidate.data.callId === callId);
+        const callEvent = record?.event;
         if (callEvent?.type !== 'tool/call')
             return undefined;
-        return this.#present(agent, callEvent.data.name, callEvent.data.arguments, event.data.message.content, event.data.message.isError === true, event.data.meta);
+        return located(this.#present(agent, callEvent.data.name, callEvent.data.arguments, event.data.message.content, event.data.message.isError === true, event.data.meta));
     }
     session(agent, events) {
         // One pass builds a callId index instead of the per-result backwards
         // log scan, keeping replay linear in the event count.
-        const callIndex = new Map();
-        for (const event of events) {
-            if (event.type === 'tool/call')
-                callIndex.set(event.data.callId, event);
+        let initial = this.#directory(agent, true);
+        // An inspected child's own events may omit its inherited directory changes.
+        const first = events[0]?.seq;
+        if (first !== undefined && first > 1) {
+            for (const event of agent.session.snapshotEvents()) {
+                if (event.seq >= first)
+                    break;
+                if (event.type === 'working-directory/change')
+                    initial = event.data.cwd;
+            }
         }
+        const callIndex = this.#records(agent, events, initial);
         const presentations = new Map();
         for (const event of events) {
             const presentation = this.#event(agent, event, callIndex);

package/lib/runtime/tool-presentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-presentation.js","sourceRoot":"","sources":["../../src/runtime/tool-presentation.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAS7E,MAAM,CAAC,MAAM,IAAI,GAAG,yBAAyB,CAAA;AAC7C,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,CAAA;AAmB/B,uFAAuF;AACvF,SAAS,eAAe,CAAC,GAAY;IACnC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAA;IACvC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAA;IACZ,CAAC;AACH,CAAC;AAED,MAAM,uBAAuB;IAClB,IAAI,CAAS;IACtB;;;;OAIG;IACM,UAAU,GAAG,IAAI,OAAO,EAAsC,CAAA;IAEvE,YAAY,GAAY;QACtB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAA;IACjB,CAAC;IAED,KAAK,CAAC,KAAY,EAAE,KAAmB;QACrC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/B,IAAI,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YAC9C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,KAAK,GAAG,IAAI,GAAG,EAAE,CAAA;gBACjB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YAC3C,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACrC,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;IAC7C,CAAC;IAED,YAAY,CAAC,KAAY,EAAE,IAAY,EAAE,IAAa;QACpD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACnD,IAAI,UAAU,EAAE,WAAW,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QAC3D,IAAI,CAAC;YACH,OAAO,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC;IAED,oEAAoE;IACpE,QAAQ,CACN,KAAY,EACZ,IAAY,EACZ,OAAgB,EAChB,OAAgC,EAChC,OAAgB,EAChB,IAAmC;QAEnC,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;QACjD,IAAI,MAAM,CAAA;QACV,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC,IAAI,EAAE;gBAC/D,8EAA8E;gBAC9E,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;gBACrB,OAAO;gBACP,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;aACxC,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,GAAG,SAAS,CAAA;QACpB,CAAC;QACD,OAAO,IAAI,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YAC9D,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;YACvC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;SAC5C,CAAA;IACH,CAAC;IAED,MAAM,CACJ,KAAY,EACZ,KAAmB,EACnB,SAAwD;QAExD,2EAA2E;QAC3E,4EAA4E;QAC5E,uDAAuD;QACvD,IAAI,KAAK,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YAC5E,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAA;QAClD,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;QACvH,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;YAC7F,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAA;QAClD,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa;YAAE,OAAO,SAAS,CAAA;QAClD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAA;QAC/C,MAAM,SAAS,GAAG,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC;eACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC;eAC/C,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CACrD,SAAS,CAAC,IAAI,KAAK,WAAW,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAA;QACvE,IAAI,SAAS,EAAE,IAAI,KAAK,WAAW;YAAE,OAAO,SAAS,CAAA;QACrD,OAAO,IAAI,CAAC,QAAQ,CAClB,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,SAAS,EACpD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CACjF,CAAA;IACH,CAAC;IAED,OAAO,CAAC,KAAY,EAAE,MAA+B;QACnD,qEAAqE;QACrE,sDAAsD;QACtD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAA;QACjD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;gBAAE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACzE,CAAC;QACD,MAAM,aAAa,GAAG,IAAI,GAAG,EAA+B,CAAA;QAC5D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;YACzD,IAAI,YAAY,KAAK,SAAS;gBAAE,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;QAC5E,CAAC;QACD,OAAO,aAAa,CAAA;IACtB,CAAC;CACF;AAED,+DAA+D;AAC/D,MAAM,UAAU,4BAA4B,CAAC,GAAY;IACvD,OAAO,IAAI,uBAAuB,CAAC,GAAG,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,4BAA4B,CAAC,GAAG,CAAC,CAAC,CAAA;AACvE,CAAC"}
+{"version":3,"file":"tool-presentation.js","sourceRoot":"","sources":["../../src/runtime/tool-presentation.ts"],"names":[],"mappings":"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"}

package/lib/session/external-agents.d.ts

@@ -0,0 +1,5 @@
+/** Guidance and observable profile state for native one-shot Agent bundles. */
+import type { BundleInfo, PluginInfo } from '@deepseek-ai/dsh-plugin-manager';
+export declare function externalAgentGuide(bundle: string): string | undefined;
+/** Profile registration is observable; authentication and payload startup require a real delegation. */
+export declare function externalAgentDiagnostic(bundle: BundleInfo, plugins: readonly PluginInfo[]): string;