@duetso/agent 0.1.80 → 0.1.82

package/dist/src/tui/transcript-writer.js

@@ -0,0 +1,130 @@
+import { TextRenderable, } from "@opentui/core";
+import { COLORS } from "./theme.js";
+/**
+ * Owns every write to the transcript ScrollBox plus the `/diag` key+selection
+ * event log. Centralizing here keeps the post-teardown try/catch that swallows
+ * "TextBuffer is destroyed" in exactly one place (v0.1.68 fix), and gives the
+ * status/hint controllers a single `isDestroyed()` source of truth.
+ */
+export class TranscriptWriter {
+    renderer;
+    transcript;
+    options;
+    destroyed = false;
+    hasRenderedAnyBlock = false;
+    keyDiagnostics = false;
+    log = [];
+    constructor(renderer, transcript, options) {
+        this.renderer = renderer;
+        this.transcript = transcript;
+        this.options = options;
+    }
+    // ---- transcript writes ---------------------------------------------------
+    /** Append a single line. Empty content is ignored so callers can guard with
+     *  raw input without producing blank rows; use `addLine` instead when a
+     *  spacer is wanted and a renderable handle is needed. */
+    appendLine(content, fg) {
+        if (!content)
+            return;
+        if (this.destroyed)
+            return;
+        try {
+            const line = new TextRenderable(this.renderer, { content, fg });
+            this.transcript.add(line);
+        }
+        catch (error) {
+            if (isTextBufferDestroyedError(error)) {
+                this.handleBufferDestroyed();
+                return;
+            }
+            throw error;
+        }
+    }
+    /** Append a labelled block. `beginBlock()` inserts a blank separator before
+     *  every block except the first so distinct steps stay visually distinct. */
+    appendBlock(label, body, fg) {
+        this.beginBlock();
+        const text = label ? `${label}\n${body}` : body;
+        for (const line of text.split("\n"))
+            this.appendLine(line, fg);
+    }
+    beginBlock() {
+        if (this.hasRenderedAnyBlock)
+            this.appendLine(" ", COLORS.hint);
+        this.hasRenderedAnyBlock = true;
+    }
+    /** Append a line and return the renderable handle. Used by the starter
+     *  block (which destroys its own refs on dismiss) and substitutes a single
+     *  space for empty content so the renderable still occupies a row. */
+    addLine(content, fg) {
+        const line = new TextRenderable(this.renderer, { content: content || " ", fg });
+        this.transcript.add(line);
+        return line;
+    }
+    // ---- transcript log ------------------------------------------------------
+    /** Records a user/agent message body in the parallel log read by `/copy`
+     *  and the copy keystroke. Trims and drops empty payloads so noisy
+     *  presentation-only writes (spacers, etc.) do not pollute the log. */
+    recordEntry(kind, text) {
+        const trimmed = text.trim();
+        if (!trimmed)
+            return;
+        this.log.push({ kind, text: trimmed });
+    }
+    entries() {
+        return this.log;
+    }
+    // ---- teardown ------------------------------------------------------------
+    /** Flipped from the renderer `destroy` handler. Subsequent transcript
+     *  writes short-circuit instead of throwing from a destroyed buffer. */
+    markDestroyed() {
+        this.destroyed = true;
+    }
+    isDestroyed() {
+        return this.destroyed;
+    }
+    // ---- /diag key + selection logging ---------------------------------------
+    setKeyDiagnosticsEnabled(enabled) {
+        this.keyDiagnostics = enabled;
+    }
+    isKeyDiagnosticsEnabled() {
+        return this.keyDiagnostics;
+    }
+    logKey(label, key) {
+        if (!this.keyDiagnostics)
+            return;
+        const flags = [];
+        if (key.ctrl)
+            flags.push("ctrl");
+        if (key.shift)
+            flags.push("shift");
+        if (key.meta)
+            flags.push("meta");
+        if (key.super)
+            flags.push("super");
+        if (key.option)
+            flags.push("option");
+        const selection = this.options.getLastSelectionText();
+        this.appendBlock("[diag]", `${label} name=${JSON.stringify(key.name)} flags=[${flags.join(",")}] sequence=${JSON.stringify(key.sequence)} source=${key.source} | lastSelection=${selection.length}c rendererSel=${this.renderer.hasSelection ? "yes" : "no"}`, COLORS.hint);
+    }
+    logSelection(text) {
+        if (!this.keyDiagnostics)
+            return;
+        this.appendBlock("[diag]", `selection event: ${text.length} chars — ${JSON.stringify(text.slice(0, 80))}`, COLORS.hint);
+    }
+    handleBufferDestroyed() {
+        this.destroyed = true;
+        this.options.onBufferDestroyed?.();
+    }
+}
+/**
+ * OpenTUI's TextBuffer throws a plain Error with this exact message from its
+ * `guard()` method when any setter is touched after destroy. We sniff the
+ * message to distinguish post-teardown races (swallow) from real bugs
+ * (rethrow). Exported so the status/hint controllers can share the same
+ * sniff without re-importing OpenTUI internals.
+ */
+export function isTextBufferDestroyedError(error) {
+    return error instanceof Error && error.message === "TextBuffer is destroyed";
+}
+//# sourceMappingURL=transcript-writer.js.map

package/dist/src/tui/transcript-writer.js.map

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

package/dist/src/turn-runner/turn-runner.d.ts

@@ -6,6 +6,7 @@ import { MemoryContextCache } from "../memory/store.js";
 import type { TurnRunnerConfig } from "../types/config.js";
 import type { TurnAgentFile, TurnAnswerCommand, TurnContextWindowUsage, TurnEditFollowUpQueueCommand, TurnEvent, TurnInterruptCommand, TurnMode, TurnPromptCommand, TurnState, TurnTokenUsage, TurnStartCommand, TurnTerminalEvent, TurnCommand, TurnOptions } from "../types/protocol.js";
 import type { StateMachineAgentState } from "../types/state-machine.js";
+import { type WireGuardHorizon } from "./wire-shaping.js";
 import { type TurnRunnerControlResult } from "./tools.js";
 import { SkillContext } from "./skill-context.js";
 import { type StateAgentHandle } from "./state-machine-controller.js";
@@ -76,6 +77,21 @@ export declare class TurnRunner {
     private started;
     /** Aggregates model usage across parent agents, state agents, and memory work for one turn chain. */
     private turnUsage?;
+    /**
+     * Snapshot of the latest parent assistant `message_end`'s bar fields.
+     * State-agent and terminal emissions reuse these so the bar/breakdown
+     * does not jitter mid-turn when only a state agent advanced cost.
+     *
+     * Always set by the time a state agent runs in production: the parent
+     * worker selects a state via a real LLM call, which emits `message_end`
+     * and populates this. Exposed as `protected` for test harnesses that
+     * stub `runAgentWorker` past the real parent path and need to seed the
+     * snapshot before driving a state-agent emission.
+     */
+    protected lastParentUsageSnapshot?: {
+        effectiveContextWindow: number;
+        contextWindowUsage: TurnContextWindowUsage;
+    };
     /** Ensures persisted memory hydrates once before the first turn that needs it. */
     private memoryLoaded;
     /** MCP servers connected during start(). Disposed on runner.dispose(). */
@@ -162,7 +178,56 @@ export declare class TurnRunner {
     protected runAgentMode(state: TurnState, prompt: string, images?: ImageContent[]): Promise<TurnTerminalEvent>;
     protected runAgentWorker(input: AgentWorkerInput): Promise<AgentWorkerResult>;
     private setParentAgentRunning;
+    /**
+     * Records the parent worker's per-call usage into the running turn
+     * aggregate and emits a `usage` event so consumers see cost tick after
+     * each parent agent boundary. Recording at the worker boundary (instead
+     * of per `message_end`) keeps the same behavior when test harnesses
+     * stub `runAgentWorker` and supply `terminal.usage` directly without
+     * running a real pi `Agent`.
+     */
     private runAgentWorkerWithUsage;
+    /**
+     * Inspect the most recent assistant message after a parent prompt and,
+     * when it carries a provider context-overflow error, mutate the agent
+     * state and the sticky `wireGuardHorizon` so that a subsequent re-prompt
+     * sends roughly the newer half of observable history.
+     *
+     * Returns `true` only when recovery actually happened — meaning the
+     * horizon advanced past at least one observable message. Callers use
+     * the return value as a single-shot gate: invoke once after the first
+     * `agent.prompt(...)` and, on `true`, resume the turn via
+     * `agent.continue()` exactly once. The helper never inspects the
+     * failing message again, so a second overflow on the retry falls
+     * through naturally as a `failed` turn.
+     *
+     * Mutations on success:
+     * - pops the failure assistant message that pi-agent pushed for the
+     *   overflow (an empty-text marker with `stopReason: "error"` and
+     *   `errorMessage`) so the retry's transcript does not carry it.
+     *   `agent.continue()`'s own run lifecycle resets `errorMessage`
+     *   before the retry, so we do not clear it here;
+     * - advances `this.wireGuardHorizon.evictionHorizon` to the smallest
+     *   value at which `findEvictionHorizon` reports the dispatched list
+     *   shrinks to at most `floor(n / 2)` observable messages, where `n`
+     *   excludes the failure message itself.
+     *
+     * Emits one informational `system` event describing the compaction so
+     * surfaces can show a notice. The message reports the *actual*
+     * post-eviction drop count (after `MIN_HISTORY_TAIL` clamping and
+     * orphan-head skipping), not the half-of-n target.
+     *
+     * Returns `false` when:
+     * - the parent agent did not fail (`errorMessage` is unset);
+     * - the failure is not a context overflow (rate limit, transport
+     *   error, etc. — left as-is for the caller to surface);
+     * - no horizon advance is possible (e.g. the existing horizon already
+     *   covers every evictable message, or the history is too short to
+     *   satisfy `MIN_HISTORY_TAIL`). In those cases retrying with the
+     *   same context would still overflow, so we accept the failure
+     *   instead of paying a second pointless request.
+     */
+    protected tryRecoverFromContextOverflow(agent: Agent): boolean;
     protected updateMemoryAfterAgentRun(messages: AgentMessage[], options: TurnOptions | undefined): Promise<void>;
     private refreshMemoryContextPack;
     /**
@@ -173,7 +238,7 @@ export declare class TurnRunner {
     resolveMemoryActorModel(options: TurnOptions | undefined): string;
     protected createAgent(input: AgentConfigInput, onControlResult?: (result: TurnRunnerControlResult) => void): Agent;
     protected createMemoryTransform(): (messages: AgentMessage[]) => Promise<AgentMessage[]>;
-    private readonly wireGuardHorizon;
+    protected readonly wireGuardHorizon: WireGuardHorizon;
     getSkills(): Promise<readonly Skill[]>;
     /** System-prompt files (AGENTS.md by default) that resolved on disk for this session. */
     getResolvedAgentFiles(): Promise<readonly TurnAgentFile[]>;
@@ -201,6 +266,17 @@ export declare class TurnRunner {
     protected recordUsage(usage?: TurnTokenUsage | Usage): void;
     protected emitAgentEvent(event: AgentEvent): void;
     protected emitParentAgentEvent(event: AgentEvent): void;
+    /**
+     * Emit a `usage` event reflecting the latest `this.turnUsage`. Reuses the
+     * most recent parent context-window snapshot for the bar/breakdown so
+     * mid-turn ticks (parent worker finish, state-agent finish) surface cost
+     * without jittering the parent context fields. No-ops when no usage has
+     * been recorded yet or before the first parent emission — both are only
+     * possible during construction/teardown or in test harnesses; a real
+     * parent worker always sets the snapshot before its terminal usage is
+     * recorded.
+     */
+    protected emitTurnUsage(): void;
     /**
      * Estimate the per-segment occupancy of the parent agent's input before
      * reconciliation with provider `totalTokens`. System prompt and memory

package/dist/src/turn-runner/turn-runner.d.ts.map

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

package/dist/src/turn-runner/turn-runner.js

@@ -1,9 +1,9 @@
 import { Agent, } from "@earendil-works/pi-agent-core";
-import { getEnvApiKey } from "@earendil-works/pi-ai";
+import { getEnvApiKey, isContextOverflow, } from "@earendil-works/pi-ai";
 import dedent from "dedent";
 import { assistantText } from "../core/serializer.js";
 import { toXML } from "../lib/xml.js";
-import { createObservationalContextTransform, DEFAULT_EFFECTIVE_CONTEXT, estimateTokens, resolveObservationalMemorySettings, updateObservationalMemory, } from "../memory/observational.js";
+import { createObservationalContextTransform, DEFAULT_EFFECTIVE_CONTEXT, estimateTokens, resolveObservationalMemorySettings, stripObservationalContextMessages, updateObservationalMemory, } from "../memory/observational.js";
 import { rebuildMemoryContextPack } from "../memory/context-pack.js";
 import { createEmbeddingClient } from "../memory/embedding.js";
 import { loadStoredMemory } from "../memory/storage.js";
@@ -11,7 +11,7 @@ import { MemoryContextCache } from "../memory/store.js";
 import { DEFAULT_CLI_MEMORY_MODEL, DEFAULT_CLI_MODEL, resolveModelName, } from "../model-resolution/resolver.js";
 import { agentEventToTurnEvents, agentMessageText } from "./agent-events.js";
 import { createStateMachineSystemPromptLayer } from "./prompts.js";
-import { calculateWireBytes, createInitialHorizon } from "./wire-shaping.js";
+import { applyEvictionHorizon, calculateWireBytes, createInitialHorizon, findEvictionHorizon, } from "./wire-shaping.js";
 import { createDefaultTurnRunnerTools, createTurnRunnerTools, formatCarriedTodosReminder, isTurnRunnerControlResult, } from "./tools.js";
 import { connectMcpServers } from "./mcp.js";
 import { SkillContext } from "./skill-context.js";
@@ -125,6 +125,18 @@ export class TurnRunner {
     started = false;
     /** Aggregates model usage across parent agents, state agents, and memory work for one turn chain. */
     turnUsage;
+    /**
+     * Snapshot of the latest parent assistant `message_end`'s bar fields.
+     * State-agent and terminal emissions reuse these so the bar/breakdown
+     * does not jitter mid-turn when only a state agent advanced cost.
+     *
+     * Always set by the time a state agent runs in production: the parent
+     * worker selects a state via a real LLM call, which emits `message_end`
+     * and populates this. Exposed as `protected` for test harnesses that
+     * stub `runAgentWorker` past the real parent path and need to seed the
+     * snapshot before driving a state-agent emission.
+     */
+    lastParentUsageSnapshot;
     /** Ensures persisted memory hydrates once before the first turn that needs it. */
     memoryLoaded = false;
     /** MCP servers connected during start(). Disposed on runner.dispose(). */
@@ -215,7 +227,16 @@ export class TurnRunner {
             terminal = await this.drainQueuedTurnCommands(terminal);
             terminal = { ...terminal, state: this.snapshotState(terminal.state) };
             if (this.turnUsage) {
-                terminal = { ...terminal, usage: this.turnUsage };
+                terminal = {
+                    ...terminal,
+                    usage: this.turnUsage,
+                    ...(this.lastParentUsageSnapshot
+                        ? {
+                            effectiveContextWindow: this.lastParentUsageSnapshot.effectiveContextWindow,
+                            contextWindowUsage: this.lastParentUsageSnapshot.contextWindowUsage,
+                        }
+                        : {}),
+                };
             }
             this.setState(terminal.state);
             this.emit(terminal);
@@ -616,8 +637,6 @@ export class TurnRunner {
         });
         let unsubscribe;
         const finish = () => {
-            const usage = usageFromMessages(agent.state.messages);
-            this.recordUsage(usage);
             if (control.type === "ask_user_question") {
                 return { type: "ask", questions: control.questions };
             }
@@ -641,6 +660,11 @@ export class TurnRunner {
                     return { type: "failed", error: String(error) };
                 }
                 finally {
+                    // Record state-agent usage on every exit path — success, error, or
+                    // interrupt — so partial work still flows into the turn aggregate
+                    // and ticks the sidebar cost via the emitted `usage` event.
+                    this.recordUsage(usageFromMessages(agent.state.messages));
+                    this.emitTurnUsage();
                     unsubscribe?.();
                 }
             },
@@ -876,6 +900,17 @@ export class TurnRunner {
         let interruptedDuringPrompt;
         try {
             await agent.prompt(input.prompt, input.images);
+            // Single-shot recovery: if the provider rejected the first attempt
+            // with a context-overflow error, advance the sticky wire-shaping
+            // horizon so the next send carries roughly the newer half of
+            // history, then resume the same turn via `agent.continue()`.
+            // Continuing (rather than re-prompting) keeps the existing user
+            // message at the tail instead of appending a duplicate. A
+            // still-too-big second attempt falls through as `failed` — no
+            // further retries.
+            if (this.tryRecoverFromContextOverflow(agent)) {
+                await agent.continue();
+            }
         }
         catch (error) {
             interruptedDuringPrompt = this.consumeInterruptedTerminal();
@@ -926,11 +961,89 @@ export class TurnRunner {
         this.parentAgentRunning = running;
         this.snapshotActiveAgentState();
     }
+    /**
+     * Records the parent worker's per-call usage into the running turn
+     * aggregate and emits a `usage` event so consumers see cost tick after
+     * each parent agent boundary. Recording at the worker boundary (instead
+     * of per `message_end`) keeps the same behavior when test harnesses
+     * stub `runAgentWorker` and supply `terminal.usage` directly without
+     * running a real pi `Agent`.
+     */
     async runAgentWorkerWithUsage(input) {
         const result = await this.runAgentWorker(input);
         this.recordUsage(result.terminal.usage);
+        this.emitTurnUsage();
         return result;
     }
+    /**
+     * Inspect the most recent assistant message after a parent prompt and,
+     * when it carries a provider context-overflow error, mutate the agent
+     * state and the sticky `wireGuardHorizon` so that a subsequent re-prompt
+     * sends roughly the newer half of observable history.
+     *
+     * Returns `true` only when recovery actually happened — meaning the
+     * horizon advanced past at least one observable message. Callers use
+     * the return value as a single-shot gate: invoke once after the first
+     * `agent.prompt(...)` and, on `true`, resume the turn via
+     * `agent.continue()` exactly once. The helper never inspects the
+     * failing message again, so a second overflow on the retry falls
+     * through naturally as a `failed` turn.
+     *
+     * Mutations on success:
+     * - pops the failure assistant message that pi-agent pushed for the
+     *   overflow (an empty-text marker with `stopReason: "error"` and
+     *   `errorMessage`) so the retry's transcript does not carry it.
+     *   `agent.continue()`'s own run lifecycle resets `errorMessage`
+     *   before the retry, so we do not clear it here;
+     * - advances `this.wireGuardHorizon.evictionHorizon` to the smallest
+     *   value at which `findEvictionHorizon` reports the dispatched list
+     *   shrinks to at most `floor(n / 2)` observable messages, where `n`
+     *   excludes the failure message itself.
+     *
+     * Emits one informational `system` event describing the compaction so
+     * surfaces can show a notice. The message reports the *actual*
+     * post-eviction drop count (after `MIN_HISTORY_TAIL` clamping and
+     * orphan-head skipping), not the half-of-n target.
+     *
+     * Returns `false` when:
+     * - the parent agent did not fail (`errorMessage` is unset);
+     * - the failure is not a context overflow (rate limit, transport
+     *   error, etc. — left as-is for the caller to surface);
+     * - no horizon advance is possible (e.g. the existing horizon already
+     *   covers every evictable message, or the history is too short to
+     *   satisfy `MIN_HISTORY_TAIL`). In those cases retrying with the
+     *   same context would still overflow, so we accept the failure
+     *   instead of paying a second pointless request.
+     */
+    tryRecoverFromContextOverflow(agent) {
+        if (!agent.state.errorMessage)
+            return false;
+        const messages = agent.state.messages;
+        const lastMessage = messages[messages.length - 1];
+        if (!lastMessage || lastMessage.role !== "assistant")
+            return false;
+        if (!isContextOverflow(lastMessage, agent.state.model.contextWindow))
+            return false;
+        // Exclude the failure assistant message from the half-history
+        // calculation; only "real" prior turns should count toward the
+        // observable population the cut targets.
+        const observable = stripObservationalContextMessages(messages.slice(0, -1));
+        const target = Math.floor(observable.length / 2);
+        const previousHorizon = this.wireGuardHorizon.evictionHorizon;
+        const newHorizon = findEvictionHorizon(observable, previousHorizon, (candidate) => candidate.length <= target);
+        if (newHorizon === previousHorizon)
+            return false;
+        messages.pop();
+        this.wireGuardHorizon.evictionHorizon = newHorizon;
+        const remaining = applyEvictionHorizon(observable, newHorizon).length;
+        const dropped = observable.length - remaining;
+        this.emit({
+            type: "system",
+            level: "info",
+            message: `Context overflow: dropped ${dropped} older message${dropped === 1 ? "" : "s"} and retrying.`,
+        });
+        return true;
+    }
     async updateMemoryAfterAgentRun(messages, options) {
         if (this.config.memoryDbPath === undefined) {
             return;
@@ -1033,7 +1146,9 @@ export class TurnRunner {
     }
     // Sticky across all turns within this runner instance. Resets on
     // session resume (new runner). Mutated in place by the memory transform
-    // when either the token or byte budget triggers eviction.
+    // when either the token or byte budget triggers eviction, and by
+    // `runAgentWorker` on a provider context-overflow error so the retry
+    // sends the newer half of history.
     wireGuardHorizon = createInitialHorizon();
     async getSkills() {
         await this.ensureSkillsLoaded();
@@ -1127,12 +1242,35 @@ export class TurnRunner {
         this.emitAgentEvent(event);
         if (event.type !== "message_end" || event.message.role !== "assistant")
             return;
-        const estimated = this.estimateContextWindowUsage();
-        this.emit({
-            type: "context_usage",
-            usage: event.message.usage,
+        // Cache the parent's latest bar/breakdown so subsequent state-agent and
+        // terminal emissions can reuse it without rescaling against a stale base.
+        // Usage *recording* and `usage` event emission happen at worker / state-agent
+        // boundaries (see `runAgentWorkerWithUsage` and `createStateAgentHandle`)
+        // instead of per message, so test harnesses that stub `runAgentWorker`
+        // — without ever firing `message_end` — still get correct accounting.
+        this.lastParentUsageSnapshot = {
             effectiveContextWindow: this.effectiveContextWindow(),
-            contextWindowUsage: scaleContextWindowUsageToTotalTokens(estimated, event.message.usage.totalTokens),
+            contextWindowUsage: scaleContextWindowUsageToTotalTokens(this.estimateContextWindowUsage(), event.message.usage.totalTokens),
+        };
+    }
+    /**
+     * Emit a `usage` event reflecting the latest `this.turnUsage`. Reuses the
+     * most recent parent context-window snapshot for the bar/breakdown so
+     * mid-turn ticks (parent worker finish, state-agent finish) surface cost
+     * without jittering the parent context fields. No-ops when no usage has
+     * been recorded yet or before the first parent emission — both are only
+     * possible during construction/teardown or in test harnesses; a real
+     * parent worker always sets the snapshot before its terminal usage is
+     * recorded.
+     */
+    emitTurnUsage() {
+        if (!this.turnUsage || !this.lastParentUsageSnapshot)
+            return;
+        this.emit({
+            type: "usage",
+            usage: this.turnUsage,
+            effectiveContextWindow: this.lastParentUsageSnapshot.effectiveContextWindow,
+            contextWindowUsage: this.lastParentUsageSnapshot.contextWindowUsage,
         });
     }
     /**