@hearsay-tools/squawk 0.0.0-stage → 0.17.0-dev.5685

package/dist/core/cursor-provider-error.js

@@ -0,0 +1,15 @@
+/**
+ * Cursor provider error text (#443). Cursor wraps a provider failure in a literal `\n\nError: `
+ * prefix. Print sessions embed the text in a run error and transcript, so it is reduced to one
+ * line and capped.
+ */
+/** Preserved provider text is diagnosis, not transcript bulk — cap it. */
+export const CURSOR_PROVIDER_ERROR_MAX_CHARS = 500;
+const ENVELOPE_PREFIX_RE = /^\n\nError: /u;
+const CONTROL_RE = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/gu;
+/** Strip the envelope prefix, control characters and runs of whitespace, then cap for display. */
+export function sanitizeCursorProviderError(text) {
+    return text.replace(ENVELOPE_PREFIX_RE, '').replace(CONTROL_RE, ' ').replace(/\s+/g, ' ').trim()
+        .slice(0, CURSOR_PROVIDER_ERROR_MAX_CHARS);
+}
+//# sourceMappingURL=cursor-provider-error.js.map

package/dist/core/cursor-provider-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-provider-error.js","sourceRoot":"","sources":["../../src/core/cursor-provider-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAEnD,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAC3C,MAAM,UAAU,GAAG,kDAAkD,CAAC;AAEtE,kGAAkG;AAClG,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE;SAC7F,KAAK,CAAC,CAAC,EAAE,+BAA+B,CAAC,CAAC;AAC/C,CAAC"}

package/dist/core/cursor-runner.d.ts

@@ -0,0 +1,46 @@
+import type { SessionTransport } from '../contract/index.js';
+import type { AgentEvent, AgentRunResult, AgentRunner, AgentRunSpec, AgentSession, InputDelivery, SessionOptions } from './agent-runner.ts';
+import type { CursorPrintCapabilityResult } from './cursor-print-capabilities.ts';
+import type { ModelOption } from './runner-model-catalog.ts';
+export interface CursorRunnerOptions {
+    sessionTransport?: SessionTransport;
+    bin?: string;
+    inspect?: (bin: string, spec: AgentRunSpec, signal?: AbortSignal) => Promise<CursorPrintCapabilityResult>;
+    makePrint?: (models?: readonly ModelOption[], resolvedModel?: string) => AgentRunner;
+}
+/** A Continue of a session that ran on the removed ACP transport (hearsay-tools/cezarion#1267). */
+export declare const CURSOR_ACP_RESUME_REFUSED: string;
+/** The step error for a Cursor build that fails print qualification (hearsay-tools/cezarion#1267). */
+export declare function cursorPrintUnsupportedMessage(reason: string): string;
+/**
+ * Runs every Cursor session on print, after a pre-inference qualification check. ACP sessions
+ * were removed in hearsay-tools/cezarion#1267: a resume recorded on ACP, or an untagged resume
+ * from before print existed, fails before any session starts, and so does an unqualified build.
+ */
+export declare class CursorRunner implements AgentRunner {
+    private readonly options;
+    readonly backend: 'cursor';
+    readonly specSupport: Readonly<Record<keyof AgentRunSpec, import("./agent-runner.ts").SpecFieldSupport>>;
+    readonly facts: {
+        readonly inputDelivery: {
+            readonly mode: 'boundary';
+            readonly consumption: 'unobservable';
+            readonly acknowledgement: 'model-work';
+            readonly humanInputAtTurnEnd: 'always-held';
+            readonly via: 'next exact-resume print process';
+        };
+        readonly systemPromptOnResume: 'in-thread';
+        readonly nativeAsk: 'auto-skipped';
+        readonly nativeSubagents: 'unreported';
+        readonly nativeTimerTool: null;
+        readonly costReport: 'per-turn';
+        readonly sessionIdSource: 'native';
+    };
+    readonly systemPromptOnResume: "in-thread";
+    readonly inputDelivery: InputDelivery;
+    private lastSession?;
+    constructor(options?: CursorRunnerOptions);
+    startSession(spec: AgentRunSpec, onEvent?: (event: AgentEvent) => void, opts?: SessionOptions): AgentSession;
+    interrupt(): Promise<void>;
+    run(spec: AgentRunSpec, onEvent?: (event: AgentEvent) => void): Promise<AgentRunResult>;
+}

package/dist/core/cursor-runner.js

@@ -0,0 +1,144 @@
+import { productEnv } from './product-env.js';
+import { fileURLToPath } from 'node:url';
+import { RUNNER_FACTS } from './runner-facts.js';
+import { CursorPrintRunner, CURSOR_PRINT_SPEC_SUPPORT } from './cursor-print-runner.js';
+import { inspectCursorPrintCapabilities } from './cursor-print-capabilities.js';
+/** A Continue of a session that ran on the removed ACP transport (hearsay-tools/cezarion#1267). */
+export const CURSOR_ACP_RESUME_REFUSED = 'This Cursor session was started on the ACP transport, which Cezarion no longer '
+    + 'supports, so it cannot resume. Start a new task to continue this work.';
+/** The step error for a Cursor build that fails print qualification (hearsay-tools/cezarion#1267). */
+export function cursorPrintUnsupportedMessage(reason) {
+    return `Cursor CLI cannot run this task: ${reason}. Run "agent update" to install a supported Cursor CLI, `
+        + 'or update Cezarion if your build is newer than this version supports.';
+}
+/**
+ * Runs every Cursor session on print, after a pre-inference qualification check. ACP sessions
+ * were removed in hearsay-tools/cezarion#1267: a resume recorded on ACP, or an untagged resume
+ * from before print existed, fails before any session starts, and so does an unqualified build.
+ */
+export class CursorRunner {
+    options;
+    backend = 'cursor';
+    specSupport = CURSOR_PRINT_SPEC_SUPPORT;
+    facts = RUNNER_FACTS.cursor;
+    systemPromptOnResume = this.facts.systemPromptOnResume;
+    inputDelivery = this.facts.inputDelivery;
+    lastSession;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    startSession(spec, onEvent, opts = {}) {
+        const bundledPrintMock = fileURLToPath(new URL('../../scripts/mock-cursor-print.mjs', import.meta.url));
+        const bin = this.options.bin ?? productEnv('CURSOR_BIN') ?? (productEnv('DRY_RUN') === '1'
+            ? bundledPrintMock : 'agent');
+        const isBundledMock = bin === bundledPrintMock;
+        const mockModels = [
+            { id: 'mock-default-model', label: 'Mock default', description: 'Default model' },
+            { id: 'mock-default-model-xhigh', label: 'Mock high effort', description: 'Mock high effort' },
+        ];
+        const select = async (signal) => {
+            // An untagged resume predates print sessions, so its native ID belongs to ACP.
+            if (spec.resume && this.options.sessionTransport !== 'cursor-print')
+                throw new Error(CURSOR_ACP_RESUME_REFUSED);
+            if (isBundledMock) {
+                return { models: spec.effort ? mockModels : undefined,
+                    model: spec.effort && !spec.model ? 'mock-default-model' : undefined };
+            }
+            const capability = await (this.options.inspect ?? inspectCursorPrintCapabilities)(bin, spec, signal);
+            if (!capability.supported)
+                throw new Error(cursorPrintUnsupportedMessage(capability.reason));
+            return { models: capability.models, model: capability.model, resolvedModel: capability.resolvedModel };
+        };
+        const makeRunner = (models, resolvedModel) => this.options.makePrint?.(models, resolvedModel)
+            ?? new CursorPrintRunner({ bin: this.options.bin, models, resolvedModel });
+        return this.lastSession = new SelectingCursorSession(select, makeRunner, spec, onEvent, opts);
+    }
+    async interrupt() { this.lastSession?.interrupt(); }
+    run(spec, onEvent) {
+        return this.startSession(spec, onEvent, { autoEndAfterFirstTurn: true }).result;
+    }
+}
+class SelectingCursorSession {
+    result;
+    resolveResult;
+    inner;
+    controller = new AbortController();
+    pendingHuman = [];
+    active = true;
+    settled = false;
+    constructor(select, makeRunner, spec, onEvent, opts = {}) {
+        this.result = new Promise(resolve => { this.resolveResult = resolve; });
+        void (async () => {
+            try {
+                const { models, model, resolvedModel } = await select(this.controller.signal);
+                if (!this.active)
+                    return;
+                const runner = makeRunner(models, resolvedModel);
+                const selectedSpec = model && !spec.model ? { ...spec, model } : spec;
+                const inner = runner.startSession(selectedSpec, event => onEvent?.(event.type === 'session'
+                    ? { ...event, sessionTransport: 'cursor-print' } : event), opts);
+                this.inner = inner;
+                if (inner.pid !== undefined)
+                    opts.onPidChange?.(inner.pid);
+                for (const message of this.pendingHuman.splice(0))
+                    inner.sendMessage(message);
+                const result = await inner.result;
+                this.settle(result);
+            }
+            catch (error) {
+                if (!this.active)
+                    return;
+                const message = error instanceof Error ? error.message : 'Cursor print qualification failed';
+                onEvent?.({ type: 'error', message });
+                opts.onUiEvent?.({ type: 'session.error', message, fatal: true });
+                this.settle({ text: '', toolCalls: [], tokensUsed: 0 });
+            }
+        })();
+    }
+    settle(result) {
+        if (this.settled)
+            return;
+        this.settled = true;
+        this.active = false;
+        this.resolveResult(result);
+    }
+    get pid() { return this.inner?.pid; }
+    get open() { return this.active && (this.inner?.open ?? true); }
+    sendMessage(content) {
+        if (!this.open)
+            return false;
+        if (this.inner)
+            return this.inner.sendMessage(content);
+        this.pendingHuman.push(content);
+        return true;
+    }
+    sendAgentMessage(content, ids) {
+        return this.inner?.sendAgentMessage(content, ids) ?? false;
+    }
+    discardQueuedMessages() { this.pendingHuman = []; this.inner?.discardQueuedMessages(); }
+    holdsHumanInput() { return this.inner?.holdsHumanInput() ?? this.pendingHuman.length > 0; }
+    heldHumanInputCount() { return this.inner?.heldHumanInputCount?.() ?? this.pendingHuman.length; }
+    end() {
+        if (!this.active)
+            return;
+        if (this.inner)
+            this.inner.end();
+        else {
+            this.active = false;
+            this.controller.abort();
+            this.settle({ text: '', toolCalls: [], tokensUsed: 0 });
+        }
+    }
+    interrupt() {
+        if (!this.active)
+            return;
+        if (this.inner)
+            this.inner.interrupt();
+        else {
+            this.active = false;
+            this.controller.abort();
+            this.settle({ text: '', toolCalls: [], tokensUsed: 0 });
+        }
+    }
+}
+//# sourceMappingURL=cursor-runner.js.map

package/dist/core/cursor-runner.js.map

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

package/dist/core/defined.d.ts

@@ -0,0 +1 @@
+export { defined, type Defined } from '../contract/index.js';

package/dist/core/defined.js

@@ -0,0 +1,2 @@
+export { defined } from '../contract/index.js';
+//# sourceMappingURL=defined.js.map

package/dist/core/defined.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defined.js","sourceRoot":"","sources":["../../src/core/defined.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAgB,MAAM,sCAAsC,CAAC"}

package/dist/core/disclaim-spawn.d.ts

@@ -0,0 +1,11 @@
+export declare const DISCLAIM_EXEC_FLAG = "--cez-disclaim-exec";
+export interface DisclaimOptions {
+    /** Defaults to `process.platform`. */
+    platform?: NodeJS.Platform;
+    /** Where `CEZ_DISCLAIM_EXEC` is read from; defaults to `process.env`. */
+    hostEnv?: NodeJS.ProcessEnv;
+}
+/** `[file, args]` to spawn so `program` runs as its own responsible process when it can. */
+export declare function disclaimedCommand(program: string, args: readonly string[], childEnv: NodeJS.ProcessEnv | undefined, opts?: DisclaimOptions): [string, string[]];
+/** One process seam for every backend, including respawns and discovery. */
+export declare function spawnAgent(program: string, args: readonly string[], options: import('node:child_process').SpawnOptionsWithoutStdio): import('node:child_process').ChildProcessWithoutNullStreams;

package/dist/core/disclaim-spawn.js

@@ -0,0 +1,60 @@
+import { shellProductEnv } from './product-env.js';
+import { spawn } from 'node:child_process';
+/**
+ * macOS privacy prompts name the RESPONSIBLE process, and every process the desktop app starts
+ * inherits the app as its responsible process. Left alone, an agent that lists `~/Documents`
+ * raises "Cezar would like to access files in your Documents folder" — and an Allow there hands
+ * every agent, forever, what one of them asked for.
+ *
+ * The desktop shell exports `CEZ_DISCLAIM_EXEC`: its own executable, which, run as
+ * `<exe> --cez-disclaim-exec <program> <args…>`, replaces itself (same pid, same stdio) with
+ * `program` as its own responsible process. Agent backends are started through it, so the prompt
+ * names the agent (`claude`, `codex`, …) and a grant covers that agent only. The cockpit server
+ * itself stays the app's — the folder picker's prompts are still Cezar's, which they should be.
+ *
+ * Anywhere else — no desktop shell, not macOS, a program that does not resolve — the command is
+ * returned untouched, so a missing binary still fails the spawn with the usual ENOENT and hint.
+ */
+import { accessSync, constants, statSync } from 'node:fs';
+import { delimiter, isAbsolute, join } from 'node:path';
+export const DISCLAIM_EXEC_FLAG = '--cez-disclaim-exec';
+/** `[file, args]` to spawn so `program` runs as its own responsible process when it can. */
+export function disclaimedCommand(program, args, childEnv, opts = {}) {
+    const platform = opts.platform ?? process.platform;
+    const trampoline = shellProductEnv('DISCLAIM_EXEC', (opts.hostEnv ?? process.env));
+    if (platform !== 'darwin' || !trampoline || !isExecutable(trampoline))
+        return [program, [...args]];
+    const resolved = resolveProgram(program, childEnv?.PATH ?? process.env.PATH);
+    if (!resolved)
+        return [program, [...args]];
+    return [trampoline, [DISCLAIM_EXEC_FLAG, resolved, ...args]];
+}
+function resolveProgram(program, path) {
+    if (program.includes('/'))
+        return isAbsolute(program) && isExecutable(program) ? program : null;
+    for (const dir of (path ?? '').split(delimiter)) {
+        if (!dir)
+            continue;
+        const candidate = join(dir, program);
+        if (isExecutable(candidate))
+            return candidate;
+    }
+    return null;
+}
+function isExecutable(path) {
+    try {
+        if (!statSync(path).isFile())
+            return false;
+        accessSync(path, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** One process seam for every backend, including respawns and discovery. */
+export function spawnAgent(program, args, options) {
+    const [file, argv] = disclaimedCommand(program, args, options.env);
+    return spawn(file, argv, options);
+}
+//# sourceMappingURL=disclaim-spawn.js.map

package/dist/core/disclaim-spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disclaim-spawn.js","sourceRoot":"","sources":["../../src/core/disclaim-spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAExD,MAAM,CAAC,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AASxD,4FAA4F;AAC5F,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,IAAuB,EACvB,QAAuC,EACvC,IAAI,GAAoB,EAAE;IAE1B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACnD,MAAM,UAAU,GAAG,eAAe,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,IAAI,QAAQ,KAAK,QAAQ,IAAI,CAAC,UAAU,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACnG,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7E,IAAI,CAAC,QAAQ;QAAE,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,EAAE,CAAC,kBAAkB,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,IAAwB;IAC/D,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAChG,KAAK,MAAM,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACrC,IAAI,YAAY,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE;YAAE,OAAO,KAAK,CAAC;QAC3C,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,IAAuB,EAAE,OAA8D;IACjI,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACnE,OAAO,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/core/edit-write-key.d.ts

@@ -0,0 +1,2 @@
+/** The lowercased key of an `edit`/`write` tool call, or null for any other tool. */
+export declare function editWriteKey(name: string): 'edit' | 'write' | null;

package/dist/core/edit-write-key.js

@@ -0,0 +1,6 @@
+/** The lowercased key of an `edit`/`write` tool call, or null for any other tool. */
+export function editWriteKey(name) {
+    const key = name.toLowerCase();
+    return key === 'edit' || key === 'write' ? key : null;
+}
+//# sourceMappingURL=edit-write-key.js.map

package/dist/core/edit-write-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-write-key.js","sourceRoot":"","sources":["../../src/core/edit-write-key.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC/B,OAAO,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC"}

package/dist/core/hook-items.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared rules for native hook runs (#961), used by every mapper whose wire
+ * reports hooks (claude `hook_response`, codex `hook/completed`).
+ * Spec: `docs/superpowers/specs/2026-10-15-hook-transcript-entries-design.md`.
+ */
+import type { UiHookItem } from './ui-events.ts';
+/** Native event name, PascalCase: codex sends `sessionStart`, claude `SessionStart`. */
+export declare function hookEventName(native: string): string;
+/**
+ * A hook run earns a transcript entry only when it told the agent something or
+ * did not simply succeed. Raw stdout alone never counts: control JSON such as
+ * `{"continue":true}` on every PreToolUse would put a card on every tool call.
+ */
+export declare function isVisibleHookItem(item: UiHookItem): boolean;

package/dist/core/hook-items.js

@@ -0,0 +1,13 @@
+/** Native event name, PascalCase: codex sends `sessionStart`, claude `SessionStart`. */
+export function hookEventName(native) {
+    return native.charAt(0).toUpperCase() + native.slice(1);
+}
+/**
+ * A hook run earns a transcript entry only when it told the agent something or
+ * did not simply succeed. Raw stdout alone never counts: control JSON such as
+ * `{"continue":true}` on every PreToolUse would put a card on every tool call.
+ */
+export function isVisibleHookItem(item) {
+    return item.status !== 'completed' || item.entries.length > 0;
+}
+//# sourceMappingURL=hook-items.js.map

package/dist/core/hook-items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-items.js","sourceRoot":"","sources":["../../src/core/hook-items.ts"],"names":[],"mappings":"AAOA,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IAChD,OAAO,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;AAChE,CAAC"}

package/dist/core/host-model-catalog.d.ts

@@ -0,0 +1,7 @@
+import type { ModelDiscoveryRunner } from '../contract/index.js';
+import type { RunnerModelCatalogAdapter } from './runner-model-catalog.ts';
+/**
+ * Host model-discovery adapters, exhaustive over modelDiscoveryRunnerSchema. Keep the map and
+ * RUNNER_IDS guard aligned so a missing adapter fails validation.
+ */
+export declare function hostModelCatalogAdapters(cwd: string): Record<ModelDiscoveryRunner, RunnerModelCatalogAdapter>;

package/dist/core/host-model-catalog.js

@@ -0,0 +1,21 @@
+import { discoverClaudeModels } from './claude-model-catalog.js';
+import { discoverCodexModels } from './codex-model-catalog.js';
+import { discoverOpencodeModels } from './opencode-model-catalog.js';
+import { discoverCursorModels } from './cursor-model-catalog.js';
+import { discoverPiModels } from './pi-model-catalog.js';
+import { discoverOmpModels } from './omp-model-catalog.js';
+/**
+ * Host model-discovery adapters, exhaustive over modelDiscoveryRunnerSchema. Keep the map and
+ * RUNNER_IDS guard aligned so a missing adapter fails validation.
+ */
+export function hostModelCatalogAdapters(cwd) {
+    return {
+        claude: { discover: () => discoverClaudeModels({ cwd }) },
+        codex: { discover: () => discoverCodexModels({ cwd }) },
+        opencode: { discover: () => discoverOpencodeModels({ cwd }) },
+        cursor: { discover: () => discoverCursorModels({ cwd }) },
+        pi: { discover: () => discoverPiModels({ cwd }) },
+        omp: { discover: () => discoverOmpModels({ cwd }) },
+    };
+}
+//# sourceMappingURL=host-model-catalog.js.map

package/dist/core/host-model-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-model-catalog.js","sourceRoot":"","sources":["../../src/core/host-model-catalog.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,OAAO;QACL,MAAM,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;QACzD,KAAK,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;QACvD,QAAQ,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,sBAAsB,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;QAC7D,MAAM,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;QACzD,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;QACjD,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;KACpD,CAAC;AACJ,CAAC"}

package/dist/core/input-submissions.d.ts

@@ -0,0 +1,14 @@
+/** Accepted agent input whose model consumption has not been observed yet (#505).
+ * One instance per session; FIFO so text matching takes the oldest first. */
+export declare class InputSubmissions {
+    private readonly entries;
+    get pending(): number;
+    has(submissionId: string): boolean;
+    pendingIds(): string[];
+    /** The oldest pending submission with this exact text, without consuming it. */
+    findByText(text: string): string | undefined;
+    accept(submissionId: string, inputIds: readonly string[], text: string): void;
+    consume(submissionId: string): readonly string[];
+    consumeOldestByText(text: string): readonly string[];
+    takeUnconsumed(): readonly string[];
+}

package/dist/core/input-submissions.js

@@ -0,0 +1,26 @@
+/** Accepted agent input whose model consumption has not been observed yet (#505).
+ * One instance per session; FIFO so text matching takes the oldest first. */
+export class InputSubmissions {
+    entries = [];
+    get pending() { return this.entries.length; }
+    has(submissionId) { return this.entries.some(entry => entry.id === submissionId); }
+    pendingIds() { return this.entries.map(entry => entry.id); }
+    /** The oldest pending submission with this exact text, without consuming it. */
+    findByText(text) { return this.entries.find(entry => entry.text === text)?.id; }
+    accept(submissionId, inputIds, text) {
+        if (inputIds.length)
+            this.entries.push({ id: submissionId, inputIds: [...inputIds], text });
+    }
+    consume(submissionId) {
+        const at = this.entries.findIndex(entry => entry.id === submissionId);
+        return at < 0 ? [] : this.entries.splice(at, 1)[0].inputIds;
+    }
+    consumeOldestByText(text) {
+        const at = this.entries.findIndex(entry => entry.text === text);
+        return at < 0 ? [] : this.entries.splice(at, 1)[0].inputIds;
+    }
+    takeUnconsumed() {
+        return this.entries.splice(0).flatMap(entry => entry.inputIds);
+    }
+}
+//# sourceMappingURL=input-submissions.js.map

package/dist/core/input-submissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-submissions.js","sourceRoot":"","sources":["../../src/core/input-submissions.ts"],"names":[],"mappings":"AAAA;6EAC6E;AAC7E,MAAM,OAAO,gBAAgB;IACV,OAAO,GAAgE,EAAE,CAAC;IAC3F,IAAI,OAAO,KAAa,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,GAAG,CAAC,YAAoB,IAAa,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC;IACpG,UAAU,KAAe,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,gFAAgF;IAChF,UAAU,CAAC,IAAY,IAAwB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5G,MAAM,CAAC,YAAoB,EAAE,QAA2B,EAAE,IAAY;QACpE,IAAI,QAAQ,CAAC,MAAM;YAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,CAAC,YAAoB;QAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,YAAY,CAAC,CAAC;QACtE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC;IAC/D,CAAC;IACD,mBAAmB,CAAC,IAAY;QAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAChE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC;IAC/D,CAAC;IACD,cAAc;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/core/managed-session.d.ts

@@ -0,0 +1,6 @@
+import type { AgentEvent, AgentRunner, AgentRunSpec, AgentSession, SessionOptions } from './agent-runner.ts';
+/** Wall-clock limits and open-turn liveness are independent. Native stream
+ * activity refreshes this guard even when a mapper/coalescer emits no UI event.
+ * Turn boundaries and human questions park it; starting/answering a turn rearms it.
+ * Standalone runner users retain their existing deadline policy. */
+export declare function startManagedSession(runner: Pick<AgentRunner, 'startSession'>, spec: AgentRunSpec, onEvent: (event: AgentEvent) => void, opts: SessionOptions): AgentSession;

package/dist/core/managed-session.js

@@ -0,0 +1,116 @@
+import { DEFAULT_NO_PROGRESS_TIMEOUT_MS } from './runner-runtime.js';
+/** Wall-clock limits and open-turn liveness are independent. Native stream
+ * activity refreshes this guard even when a mapper/coalescer emits no UI event.
+ * Turn boundaries and human questions park it; starting/answering a turn rearms it.
+ * Standalone runner users retain their existing deadline policy. */
+export function startManagedSession(runner, spec, onEvent, opts) {
+    let session;
+    let timer;
+    let turnOpen = true;
+    let stopped = false;
+    let phase = 0;
+    const pendingPermissions = new Set();
+    const pause = () => {
+        phase += 1;
+        turnOpen = false;
+        clearTimeout(timer);
+        timer = undefined;
+    };
+    const stop = () => { stopped = true; pause(); };
+    const activity = () => {
+        if (stopped || !turnOpen)
+            return;
+        clearTimeout(timer);
+        timer = setTimeout(() => {
+            stop();
+            onEvent({ type: 'error', message: `Agent made no progress for ${DEFAULT_NO_PROGRESS_TIMEOUT_MS / 60_000} minutes during an open turn and was terminated` });
+            session?.interrupt();
+        }, DEFAULT_NO_PROGRESS_TIMEOUT_MS);
+        timer.unref?.();
+    };
+    const begin = () => { if (!stopped && !pendingPermissions.size) {
+        phase += 1;
+        turnOpen = true;
+        activity();
+    } };
+    // Includes a backend that accepts the opening prompt but never announces a turn.
+    begin();
+    try {
+        session = runner.startSession(spec, event => {
+            if (event.type === 'turn-end')
+                pause();
+            if (event.type === 'error' || event.type === 'done')
+                stop();
+            onEvent(event);
+        }, {
+            ...opts,
+            onActivity: () => { activity(); opts.onActivity?.(); },
+            onUiEvent: event => {
+                if (event.type === 'turn.started')
+                    begin();
+                if (event.type === 'ask.requested')
+                    pause();
+                if (event.type === 'permission.requested') {
+                    pendingPermissions.add(event.requestId);
+                    pause();
+                }
+                if (event.type === 'permission.resolved' && pendingPermissions.delete(event.requestId) && !pendingPermissions.size)
+                    begin();
+                opts.onUiEvent?.(event);
+            },
+        });
+    }
+    catch (error) {
+        stop();
+        throw error;
+    }
+    const live = session;
+    const result = live.result.then(value => { stop(); return value; }, error => { stop(); throw error; });
+    return {
+        result,
+        get pid() { return live.pid; },
+        get open() { return live.open; },
+        sendMessage(content) {
+            if (pendingPermissions.size)
+                return false;
+            const wasOpen = turnOpen;
+            if (!wasOpen)
+                begin(); // Native question answers resume the same turn ID.
+            const accepted = live.sendMessage(content);
+            if (!accepted && !wasOpen)
+                pause();
+            return accepted;
+        },
+        sendAgentMessage(content, ids) {
+            if (pendingPermissions.size)
+                return false;
+            const wasOpen = turnOpen;
+            if (!wasOpen)
+                begin();
+            const admissionPhase = phase;
+            const rollback = () => { if (!wasOpen && phase === admissionPhase)
+                pause(); };
+            try {
+                const accepted = live.sendAgentMessage(content, ids);
+                if (accepted === false) {
+                    rollback();
+                    return false;
+                }
+                // Do not rearm after an ACK: a synchronous turn-end or ask may already
+                // have parked the session. Only a refused reservation rolls back.
+                return accepted.catch(error => { rollback(); throw error; });
+            }
+            catch (error) {
+                rollback();
+                throw error;
+            }
+        },
+        ...(live.respondPermission ? { respondPermission: (requestId, optionId) => live.respondPermission(requestId, optionId) } : {}),
+        discardQueuedMessages: () => live.discardQueuedMessages(),
+        holdsHumanInput: () => live.holdsHumanInput(),
+        ...(live.heldHumanInputCount ? { heldHumanInputCount: () => live.heldHumanInputCount() } : {}),
+        end: () => { stop(); live.end(); },
+        interrupt: () => { stop(); live.interrupt(); },
+    };
+}
+//# sourceMappingURL=managed-session.js.map

package/dist/core/managed-session.js.map

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

package/dist/core/model-discovery-options.d.ts

@@ -0,0 +1,8 @@
+import type { ChildProcessWithoutNullStreams } from 'node:child_process';
+/** Common host model-probe inputs; each backend keeps its own public type name. */
+export interface ModelDiscoveryOptions {
+    cwd: string;
+    bin?: string;
+    timeoutMs?: number;
+    spawn?: (bin: string, args: readonly string[], cwd: string) => ChildProcessWithoutNullStreams;
+}

package/dist/core/model-discovery-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model-discovery-options.js.map

package/dist/core/model-discovery-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-discovery-options.js","sourceRoot":"","sources":["../../src/core/model-discovery-options.ts"],"names":[],"mappings":""}