zelari-code 0.2.2 → 0.6.2

package/dist/cli/headless.js

@@ -0,0 +1,137 @@
+/**
+ * headless — non-interactive CLI mode for CI/CD and scripting.
+ *
+ * Bypasses Ink entirely. Reads `--task <prompt>`, runs the prompt
+ * through the same dispatch path the TUI uses, and serializes the
+ * resulting events as one JSON object per line (NDJSON) on stdout.
+ *
+ * Exit codes:
+ *   0  — task completed successfully (last `agent_end.reason === 'completed'`)
+ *   1  — user error (missing task, missing API key, invalid flag)
+ *   2  — runtime error (provider failure, council exception)
+ *   3  — task errored (the agent run itself emitted `agent_end.reason === 'error'`)
+ *
+ * @public
+ * @since 0.5.0
+ */
+import { PROVIDERS, resolveApiKeyWithMeta } from './keyStore.js';
+import { getActiveProvider, getModelForProvider } from './providerConfig.js';
+import { openaiCompatibleProvider } from './provider/openai-compatible.js';
+const HELP_TEXT = `zelari-code --headless --task <prompt> [--output json|plain] [--council] [--provider <id>] [--model <name>]
+
+Non-interactive mode. Streams BrainEvents as NDJSON to stdout (one JSON
+object per line) or as plain text (just the assistant message text).
+
+Exit codes:
+  0  completed
+  1  user error (bad flags, missing API key, ...)
+  2  runtime error (provider failure, council exception)
+  3  agent run errored
+`;
+/**
+ * Parse argv for --headless options. Returns null options when
+ * --headless is not present (caller should fall through to TUI mode).
+ */
+export function parseHeadlessFlags(argv) {
+    if (!argv.includes('--headless')) {
+        return { options: null };
+    }
+    let task;
+    let output = 'json';
+    let useCouncil = false;
+    let provider;
+    let model;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--headless')
+            continue;
+        if (arg === '--output') {
+            const next = argv[i + 1];
+            if (next === 'json' || next === 'plain') {
+                output = next;
+                i++;
+            }
+            else {
+                return {
+                    options: null,
+                    error: `--output requires 'json' or 'plain', got '${next ?? '(missing)'}'`,
+                };
+            }
+        }
+        else if (arg === '--task') {
+            task = argv[i + 1];
+            i++;
+        }
+        else if (arg === '--council') {
+            useCouncil = true;
+        }
+        else if (arg === '--provider') {
+            provider = argv[i + 1];
+            i++;
+        }
+        else if (arg === '--model') {
+            model = argv[i + 1];
+            i++;
+        }
+    }
+    if (!task || task.trim().length === 0) {
+        return { options: null, error: '--headless requires --task <prompt>' };
+    }
+    return {
+        options: { task, output, useCouncil, provider, model },
+    };
+}
+/**
+ * Print the headless help text to stdout (caller prints to stderr for errors).
+ */
+export function printHeadlessHelp() {
+    // eslint-disable-next-line no-console
+    console.log(HELP_TEXT);
+}
+/**
+ * Resolve the API key for a provider; returns null with a reason
+ * when the key is missing. Used to fail fast with a clear error
+ * instead of failing mid-stream.
+ */
+export async function resolveHeadlessKey(providerId) {
+    const spec = PROVIDERS.find((p) => p.id === providerId);
+    if (!spec) {
+        return { error: `unknown provider: '${providerId}'` };
+    }
+    const resolved = await resolveApiKeyWithMeta(providerId);
+    if (!resolved || !resolved.apiKey) {
+        return {
+            error: `no API key for provider '${providerId}'.\n` +
+                `Set the env var ${spec.envVar} or save a key via /login.`,
+        };
+    }
+    // baseUrl lives in providerConfig (customEndpoints) not on StoredKey.
+    // Imported lazily to avoid a circular dep at module load.
+    const { getCustomEndpoint } = await import('./providerConfig.js');
+    const customBase = getCustomEndpoint(providerId);
+    return {
+        apiKey: resolved.apiKey,
+        ...(customBase ? { baseUrl: customBase } : {}),
+    };
+}
+/**
+ * Determine the effective provider + model for a headless run.
+ * Prefers explicit --provider/--model flags, then the active
+ * provider from provider.json, then 'openai-compatible' as a
+ * last resort.
+ */
+export function resolveHeadlessProvider(opts) {
+    const provider = opts.provider ?? getActiveProvider().id;
+    const model = opts.model ?? getModelForProvider(provider);
+    return { provider, model };
+}
+/**
+ * Emit one NDJSON line to stdout. Use process.stdout.write directly
+ * to avoid the console.log trailing newline (NDJSON convention is
+ * one JSON object per line, no extra whitespace).
+ */
+export function emitEvent(event) {
+    process.stdout.write(JSON.stringify(event) + '\n');
+}
+export { openaiCompatibleProvider };
+//# sourceMappingURL=headless.js.map

package/dist/cli/headless.js.map

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

package/dist/cli/hooks/chatStats.js

@@ -0,0 +1,28 @@
+import { calculateCost } from '../modelPricing.js';
+/**
+ * Compute the next session-stats snapshot after a chat turn (Task G.4.5).
+ * Pure helper extracted from app.tsx so the "real usage vs ~4-char fallback"
+ * branch is testable without React/Ink.
+ *
+ * Behavior:
+ *  - When `realUsage` is present (provider honored `stream_options.include_usage`),
+ *    use those numbers exactly.
+ *  - When `realUsage` is null, fall back to the v3-B approximation:
+ *    `Math.ceil(text.length / 4)` for both prompt and completion tokens.
+ *
+ * Cost is computed via `calculateCost(model, prompt, completion)` from
+ * `modelPricing.ts`. The result is the new stats object; the caller is
+ * responsible for merging it into state via `setSessionStats(prev => ...)`.
+ */
+export function computeSessionStatsDelta(realUsage, userText, assistantContent, model, prev) {
+    const promptTokens = realUsage ? realUsage.promptTokens : Math.ceil(userText.length / 4);
+    const completionTokens = realUsage
+        ? realUsage.completionTokens
+        : Math.ceil(assistantContent.length / 4);
+    const turnCost = calculateCost(model, promptTokens, completionTokens);
+    return {
+        totalTokens: prev.totalTokens + promptTokens + completionTokens,
+        totalCostUsd: prev.totalCostUsd + turnCost,
+    };
+}
+//# sourceMappingURL=chatStats.js.map

package/dist/cli/hooks/chatStats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatStats.js","sourceRoot":"","sources":["../../../src/cli/hooks/chatStats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAyF,EACzF,QAAgB,EAChB,gBAAwB,EACxB,KAAa,EACb,IAAmD;IAEnD,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzF,MAAM,gBAAgB,GAAG,SAAS;QAChC,CAAC,CAAC,SAAS,CAAC,gBAAgB;QAC5B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAC;IACtE,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,WAAW,GAAG,YAAY,GAAG,gBAAgB;QAC/D,YAAY,EAAE,IAAI,CAAC,YAAY,GAAG,QAAQ;KAC3C,CAAC;AACJ,CAAC"}

package/dist/cli/hooks/eventsToMessages.js

@@ -0,0 +1,111 @@
+import { newSessionId } from '../sessionManager.js';
+/**
+ * eventsToMessages — pure helper: replay a BrainEvent log into ChatMessage[].
+ *
+ * Streaming message_delta events are coalesced into a single growing
+ * assistant message (keyed by assistantId) so the chat transcript doesn't
+ * show N messages per LLM response.
+ *
+ * Extracted from app.tsx (Task v0.4.2 audit split) so it can be unit-tested
+ * without booting React/Ink.
+ */
+export function eventsToMessages(events) {
+    const out = [];
+    let assistantBuffer = '';
+    let assistantId = '';
+    for (const e of events) {
+        if (e.type === 'message_delta') {
+            if (assistantId === '')
+                assistantId = `resumed-${newSessionId()}`;
+            assistantBuffer += e.delta;
+            const last = out[out.length - 1];
+            if (last && last.role === 'assistant' && last.id === assistantId) {
+                out[out.length - 1] = { ...last, content: assistantBuffer };
+            }
+            else {
+                out.push({ id: assistantId, role: 'assistant', content: assistantBuffer, ts: e.ts });
+            }
+        }
+        else if (e.type === 'message_end') {
+            // Message boundary: the next streamed message gets its own bubble,
+            // matching the live UI (which finalizes on message_end).
+            assistantBuffer = '';
+            assistantId = '';
+        }
+        else if (e.type === 'tool_execution_start') {
+            // v0.4.3 audit fix: the v3-W event schema renamed `tool_call` →
+            // `tool_execution_start` and added the `args` field. The old branches
+            // here silently dropped every tool invocation during session resume.
+            // v0.6.2: restored as a `role: 'tool'` message so the resumed
+            // transcript renders CollapsibleToolOutput, same as the live UI.
+            assistantBuffer = '';
+            assistantId = '';
+            const argsPreview = JSON.stringify(e.args)?.slice(0, 120) ?? '';
+            out.push({
+                id: crypto.randomUUID(),
+                role: 'tool',
+                content: argsPreview,
+                ts: e.ts,
+                toolName: e.toolName,
+                toolCallId: e.toolCallId,
+            });
+        }
+        else if (e.type === 'tool_execution_end') {
+            // v0.6.2: update the matching start message in place (the event does
+            // NOT carry toolName — the old code rendered "[tool_result] undefined").
+            const end = e;
+            let matched = false;
+            for (let i = out.length - 1; i >= 0; i--) {
+                const m = out[i];
+                if (m.role === 'tool' && m.toolCallId === end.toolCallId && m.toolDurationMs === undefined) {
+                    // v0.6.2 audit LOW-5: append `…` on truncation to match the
+                    // live path (messageHelpers.appendToolEnd behavior).
+                    const raw = typeof end.result === 'string' ? end.result : '';
+                    const truncated = raw.length > 600 ? `${raw.slice(0, 600)}…` : raw;
+                    out[i] = {
+                        ...m,
+                        toolOk: !end.isError,
+                        toolDurationMs: end.durationMs,
+                        ...(raw.length > 0 ? { toolResult: truncated } : {}),
+                    };
+                    matched = true;
+                    break;
+                }
+            }
+            if (!matched) {
+                out.push({
+                    id: crypto.randomUUID(),
+                    role: 'system',
+                    content: `[tool_result] ${end.toolCallId} → ${end.isError ? 'error' : 'ok'}`,
+                    ts: e.ts,
+                });
+            }
+        }
+        else if (e.type === 'agent_start') {
+            out.push({
+                id: crypto.randomUUID(),
+                role: 'system',
+                content: `[agent_start] model=${e.model} provider=${e.provider}`,
+                ts: e.ts,
+            });
+        }
+        else if (e.type === 'agent_end') {
+            out.push({
+                id: crypto.randomUUID(),
+                role: 'system',
+                content: `[agent_end] reason=${e.reason} duration=${e.durationMs}ms`,
+                ts: e.ts,
+            });
+        }
+        else if (e.type === 'error') {
+            out.push({
+                id: crypto.randomUUID(),
+                role: 'system',
+                content: `[error] ${e.message}`,
+                ts: e.ts,
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=eventsToMessages.js.map

package/dist/cli/hooks/eventsToMessages.js.map

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

package/dist/cli/hooks/messageHelpers.js

@@ -0,0 +1,125 @@
+/**
+ * Helpers for building ChatMessage instances in the most common shapes.
+ *
+ * Extracted from app.tsx (Task v0.4.2 audit split). The previous code
+ * constructed these inline 50+ times with the same shape:
+ *   setMessages((prev) => [
+ *     ...prev,
+ *     { id: crypto.randomUUID(), role: 'system', content: '...', ts: Date.now() },
+ *   ]);
+ *
+ * The `appendX(setMessages, content)` wrappers are kept functional so they
+ * play nicely with the React state setter signature.
+ */
+/** Append a system message at the end of the chat. */
+export function appendSystem(setMessages, content, ts = Date.now()) {
+    setMessages((prev) => [
+        ...prev,
+        { id: crypto.randomUUID(), role: 'system', content, ts },
+    ]);
+}
+/** Append a user message (the user's submitted prompt). */
+export function appendUser(setMessages, content, ts = Date.now()) {
+    setMessages((prev) => [
+        ...prev,
+        { id: crypto.randomUUID(), role: 'user', content, ts },
+    ]);
+}
+/**
+ * Append or extend the streaming assistant message. If the last message is
+ * already a streaming assistant message, append `delta` to its content;
+ * otherwise create a new one with a stable streaming id.
+ *
+ * When `memberName` is set (council-sourced messages), it's stamped on
+ * the message so the visible-reasoning UI can render `🜂 Caronte: …`
+ * headers above the streamed text.
+ */
+export function appendOrExtendStreamingAssistant(setMessages, fullContent, ts, memberContext) {
+    setMessages((prev) => {
+        const last = prev[prev.length - 1];
+        if (last && last.role === 'assistant' && last.id.startsWith('streaming-')) {
+            return [...prev.slice(0, -1), { ...last, content: fullContent }];
+        }
+        return [
+            ...prev,
+            {
+                id: `streaming-${crypto.randomUUID()}`,
+                role: 'assistant',
+                content: fullContent,
+                ts,
+                ...(memberContext?.memberId ? { memberId: memberContext.memberId } : {}),
+                ...(memberContext?.memberName ? { memberName: memberContext.memberName } : {}),
+            },
+        ];
+    });
+}
+/** Max chars of tool result kept for the expandable body. */
+export const TOOL_RESULT_PREVIEW_CHARS = 600;
+/** Max chars of the JSON args preview shown on the tool summary line. */
+export const TOOL_ARGS_PREVIEW_CHARS = 120;
+/**
+ * Append a tool invocation as a `role: 'tool'` message so ChatStream renders
+ * it via CollapsibleToolOutput (one status line per invocation, updated in
+ * place by {@link updateToolMessageEnd}) instead of loose system lines.
+ */
+export function appendToolStart(setMessages, toolName, toolCallId, args, ts) {
+    const argsPreview = JSON.stringify(args)?.slice(0, TOOL_ARGS_PREVIEW_CHARS) ?? '';
+    setMessages((prev) => [
+        ...prev,
+        {
+            id: crypto.randomUUID(),
+            role: 'tool',
+            content: argsPreview,
+            ts,
+            toolName,
+            toolCallId,
+            toolOk: undefined,
+            toolDurationMs: undefined,
+        },
+    ]);
+}
+/**
+ * Update the matching `tool_execution_start` message with its end status.
+ * The summary (args preview) is kept; the result is stored separately as the
+ * expandable body. Failed invocations auto-expand in ChatStream.
+ */
+export function updateToolMessageEnd(setMessages, toolCallId, isError, durationMs, result) {
+    setMessages((prev) => {
+        for (let i = prev.length - 1; i >= 0; i--) {
+            const m = prev[i];
+            if (m && m.role === 'tool' && m.toolCallId === toolCallId && m.toolDurationMs === undefined) {
+                const updated = [...prev];
+                updated[i] = {
+                    ...m,
+                    toolOk: !isError,
+                    toolDurationMs: durationMs,
+                    ...(result !== undefined
+                        ? {
+                            toolResult: result.length > TOOL_RESULT_PREVIEW_CHARS
+                                ? `${result.slice(0, TOOL_RESULT_PREVIEW_CHARS)}…`
+                                : result,
+                        }
+                        : {}),
+                };
+                return updated;
+            }
+        }
+        return prev;
+    });
+}
+/**
+ * Seal the trailing streaming assistant message (if any) by dropping its
+ * `streaming-` id prefix. Called on `message_end` so the NEXT assistant
+ * message in the same turn (e.g. after a tool call) starts a fresh bubble
+ * instead of being merged into — or duplicated over — the previous one.
+ */
+export function finalizeStreamingAssistant(setMessages) {
+    setMessages((prev) => {
+        const last = prev[prev.length - 1];
+        if (last && last.role === 'assistant' && last.id.startsWith('streaming-')) {
+            return [...prev.slice(0, -1), { ...last, id: last.id.slice('streaming-'.length) }];
+        }
+        return prev;
+    });
+}
+//# sourceMappingURL=messageHelpers.js.map

package/dist/cli/hooks/messageHelpers.js.map

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

package/dist/cli/hooks/skillCompare.js

@@ -0,0 +1,69 @@
+import { readSkillHistory, getSkillStats } from '../skillHistory.js';
+/**
+ * Format a side-by-side comparison of two skills' history stats (Task H.3).
+ * Pure helper extracted from app.tsx dispatch so it's testable without
+ * React/Ink render.
+ *
+ * Returns a multi-line string with:
+ *  - Two lines summarizing each skill (id, count, success, avg duration, total tokens)
+ *  - A "winner" line if there's a clear winner (higher successRate wins;
+ *    ties broken by lower avgDurationMs; ties beyond that → no winner)
+ *
+ * When a skill ID has no recorded invocations, the line shows
+ * "no invocations yet" so the user can still see the comparison.
+ */
+export function formatSkillCompare(id1, id2, records) {
+    const stats1 = getSkillStats(records, id1);
+    const stats2 = getSkillStats(records, id2);
+    const lines = ['[skill-compare]'];
+    lines.push(formatSkillCompareLine(id1, stats1));
+    lines.push(formatSkillCompareLine(id2, stats2));
+    if (stats1.count > 0 && stats2.count > 0) {
+        const winner = pickCompareWinner(stats1, stats2);
+        if (winner === null) {
+            lines.push('Winner: tie (same success rate + same avg duration)');
+        }
+        else if (winner === 'a') {
+            lines.push(`Winner: ${id1} (better success rate${stats1.successRate === stats2.successRate ? ' — tied, lower avg duration' : ''})`);
+        }
+        else {
+            lines.push(`Winner: ${id2} (better success rate${stats1.successRate === stats2.successRate ? ' — tied, lower avg duration' : ''})`);
+        }
+    }
+    else {
+        lines.push('Winner: (insufficient data — both skills need ≥1 invocation to compare)');
+    }
+    return lines.join('\n');
+}
+/** Format a single skill's stats line for the compare output. */
+export function formatSkillCompareLine(id, stats) {
+    if (stats.count === 0) {
+        return `  ${id} — no invocations recorded yet`;
+    }
+    return `  ${id} — ${stats.count} invocations, ${(stats.successRate * 100).toFixed(1)}% success, avg ${stats.avgDurationMs.toFixed(0)}ms, ${stats.totalTokens} tokens total`;
+}
+/**
+ * Pick the winner between two SkillStats. Returns 'a' / 'b' / null on tie.
+ * Order: successRate first (higher wins), then avgDurationMs (lower wins).
+ * On perfect tie (same successRate AND same avgDurationMs), returns null.
+ */
+export function pickCompareWinner(a, b) {
+    if (a.successRate > b.successRate)
+        return 'a';
+    if (b.successRate > a.successRate)
+        return 'b';
+    if (a.avgDurationMs < b.avgDurationMs)
+        return 'a';
+    if (b.avgDurationMs < a.avgDurationMs)
+        return 'b';
+    return null;
+}
+/**
+ * Convenience wrapper: read history from disk + format compare. Caller
+ * passes the file path so the test can inject a temp file.
+ */
+export async function compareSkillsFromFile(id1, id2, historyFile) {
+    const records = await readSkillHistory(historyFile);
+    return formatSkillCompare(id1, id2, records);
+}
+//# sourceMappingURL=skillCompare.js.map

package/dist/cli/hooks/skillCompare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillCompare.js","sourceRoot":"","sources":["../../../src/cli/hooks/skillCompare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAA4C,MAAM,oBAAoB,CAAC;AAE/G;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAW,EACX,GAAW,EACX,OAA6B;IAE7B,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAa,CAAC,iBAAiB,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QACpE,CAAC;aAAM,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,wBAAwB,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACtI,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,wBAAwB,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACtI,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,sBAAsB,CAAC,EAAU,EAAE,KAAiB;IAClE,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,EAAE,gCAAgC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,EAAE,MAAM,KAAK,CAAC,KAAK,iBAAiB,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,WAAW,eAAe,CAAC;AAC9K,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,CAAa,EACb,CAAa;IAEb,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;QAAE,OAAO,GAAG,CAAC;IAC9C,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;QAAE,OAAO,GAAG,CAAC;IAC9C,IAAI,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa;QAAE,OAAO,GAAG,CAAC;IAClD,IAAI,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa;QAAE,OAAO,GAAG,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAW,EACX,GAAW,EACX,WAAmB;IAEnB,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACpD,OAAO,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC"}

package/dist/cli/hooks/steer.js

@@ -0,0 +1,28 @@
+/**
+ * applySteerInterrupt — pure routing for the /steer --interrupt flow (Task C.3.2).
+ *
+ * Extracted from app.tsx so it can be unit-tested without React/Ink.
+ * Side effects are injected via the options:
+ *  - `harness`: the currently-running AgentHarness, or null if no run is active
+ *  - `appendMessage(content)`: append a system message to the chat
+ *  - `setQueueCount(n)`: update the sidebar queue counter
+ *  - `dispatchPrompt(text)`: dispatch a fresh prompt as if the user hit Enter
+ *
+ * Semantics:
+ *  - With active harness: enqueue(text) + cancel() → user does NOT need to press
+ *    Enter again (queue drain re-enters provider stream with the queued prompt).
+ *  - Without active harness: fallback to dispatchPrompt(text) as a fresh prompt.
+ */
+export async function applySteerInterrupt(options) {
+    const { text, harness, appendMessage, setQueueCount, dispatchPrompt } = options;
+    if (!harness) {
+        appendMessage('[steer --interrupt] no active run — dispatching as fresh prompt.');
+        await dispatchPrompt(text);
+        return;
+    }
+    harness.enqueue(text);
+    harness.cancel();
+    setQueueCount(harness.queueLength);
+    appendMessage(`[steer --interrupt] cancelled current run + enqueued: "${text}" (queue: ${harness.queueLength})`);
+}
+//# sourceMappingURL=steer.js.map

package/dist/cli/hooks/steer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steer.js","sourceRoot":"","sources":["../../../src/cli/hooks/steer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAMzC;IACC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IAChF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,aAAa,CAAC,kEAAkE,CAAC,CAAC;QAClF,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,CAAC,MAAM,EAAE,CAAC;IACjB,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACnC,aAAa,CAAC,0DAA0D,IAAI,aAAa,OAAO,CAAC,WAAW,GAAG,CAAC,CAAC;AACnH,CAAC"}

package/dist/cli/hooks/useBatchedMessages.js

@@ -0,0 +1,67 @@
+import { useCallback, useEffect, useRef } from 'react';
+export function useBatchedMessages(messages, setMessages, cadenceMs = 16) {
+    // Composed pending updater, or `null` when nothing is buffered.
+    const pendingRef = useRef(null);
+    // Active throttle-window timer handle, or `null` when not throttling.
+    const timerRef = useRef(null);
+    /**
+     * Apply the current pending updater to state, ignoring/clearing the timer.
+     * Used as the synchronous public drain (stream end) and internally.
+     */
+    const flush = useCallback(() => {
+        if (timerRef.current !== null) {
+            clearTimeout(timerRef.current);
+            timerRef.current = null;
+        }
+        const pending = pendingRef.current;
+        pendingRef.current = null;
+        if (pending !== null) {
+            setMessages(pending);
+        }
+    }, [setMessages]);
+    const commit = useCallback((update) => {
+        // Compose this update onto any pending one, preserving arrival order.
+        const head = pendingRef.current;
+        pendingRef.current =
+            head === null
+                ? update
+                : (state) => {
+                    const intermediate = typeof head === 'function' ? head(state) : head;
+                    return typeof update === 'function' ? update(intermediate) : update;
+                };
+        if (timerRef.current === null) {
+            // Leading edge: not currently throttling. Flush immediately so the
+            // first token renders with no latency, then open a throttle window.
+            const leading = pendingRef.current;
+            pendingRef.current = null;
+            if (leading !== null) {
+                setMessages(leading);
+            }
+            timerRef.current = setTimeout(() => {
+                timerRef.current = null;
+                // Trailing edge: flush anything that accumulated during the window
+                // as a single render. Do NOT re-arm — the next commit starts a new
+                // leading edge.
+                const tail = pendingRef.current;
+                pendingRef.current = null;
+                if (tail !== null) {
+                    setMessages(tail);
+                }
+            }, cadenceMs);
+        }
+        // else: inside a throttle window — the trailing handler above will
+        // catch the buffered update when the window closes.
+    }, [cadenceMs, setMessages]);
+    // On unmount: cancel any pending timer. Do NOT flush — teardown means the
+    // display is going away, and persisted state lives in the JSONL writer.
+    useEffect(() => {
+        return () => {
+            if (timerRef.current !== null) {
+                clearTimeout(timerRef.current);
+                timerRef.current = null;
+            }
+        };
+    }, []);
+    return { messages, commit, flush, setMessages };
+}
+//# sourceMappingURL=useBatchedMessages.js.map

package/dist/cli/hooks/useBatchedMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBatchedMessages.js","sourceRoot":"","sources":["../../../src/cli/hooks/useBatchedMessages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAkDvD,MAAM,UAAU,kBAAkB,CAChC,QAAuB,EACvB,WAAgE,EAChE,YAAoB,EAAE;IAEtB,gEAAgE;IAChE,MAAM,UAAU,GAAG,MAAM,CAA6C,IAAI,CAAC,CAAC;IAC5E,sEAAsE;IACtE,MAAM,QAAQ,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IAEpE;;;OAGG;IACH,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC9B,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC/B,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QACnC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,WAAW,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAElB,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,MAA2C,EAAE,EAAE;QAC9C,sEAAsE;QACtE,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC;QAChC,UAAU,CAAC,OAAO;YAChB,IAAI,KAAK,IAAI;gBACX,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,CAAC,KAAoB,EAAE,EAAE;oBACvB,MAAM,YAAY,GAAG,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;oBACrE,OAAO,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBACtE,CAAC,CAAC;QAER,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC9B,mEAAmE;YACnE,oEAAoE;YACpE,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;YACnC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;YAC1B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,WAAW,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;YACD,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBACjC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;gBACxB,mEAAmE;gBACnE,mEAAmE;gBACnE,gBAAgB;gBAChB,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC;gBAChC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;gBAC1B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;oBAClB,WAAW,CAAC,IAAI,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC;QACD,mEAAmE;QACnE,oDAAoD;IACtD,CAAC,EACD,CAAC,SAAS,EAAE,WAAW,CAAC,CACzB,CAAC;IAEF,0EAA0E;IAC1E,wEAAwE;IACxE,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC9B,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC/B,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAClD,CAAC"}