@hearsay-tools/squawk 0.0.0-stage → 0.17.0-pr3058.5683

package/dist/core/cursor-print-capabilities.js

@@ -0,0 +1,169 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { buildChildEnv } from './agent-env.js';
+import { CORE_CURSOR_PRINT_TOOLS } from './cursor-print-tool-catalog.js';
+import { cursorArgs, noteCursorAutoUpdateFlagRejected, rejectsCursorAutoUpdateFlag, usesCursorAutoUpdateFlag } from './cursor-cli-flags.js';
+import { discoverCursorParameterizedModels, parseCursorModels } from './cursor-model-catalog.js';
+const execute = promisify(execFile);
+/** The first build print was qualified on (hearsay-tools/cezarion#923). Newer builds pass the
+ * same pre-inference checks instead of an exact match (hearsay-tools/cezarion#1257). */
+const QUALIFIED_BASELINE = '2026.10.01-e373342';
+const BUILD_VERSION = /^(\d{4})\.(\d{2})\.(\d{2})-[0-9a-z]+$/;
+const INVALID_TOOL = '__cezar_probe_invalid__';
+/** `YYYYMMDD` of a Cursor build version, or undefined for a format cezar does not know. */
+function buildDate(version) {
+    const match = BUILD_VERSION.exec(version);
+    return match ? Number(`${match[1]}${match[2]}${match[3]}`) : undefined;
+}
+async function inspectBuildVersion(bin, options) {
+    let version;
+    try {
+        version = (await execute(bin, cursorArgs(bin, ['--version']), options)).stdout.trim();
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error('Cursor CLI is not installed or is unavailable on PATH');
+        }
+        throw new Error('Cursor print capability preflight could not read CLI version');
+    }
+    const date = buildDate(version);
+    if (date === undefined || date < buildDate(QUALIFIED_BASELINE)) {
+        return { supported: false, reason: `Cursor print marketplace support needs a build from ${QUALIFIED_BASELINE} or newer; installed build is not qualified` };
+    }
+    return { supported: true };
+}
+async function inspectNativeTools(bin, options) {
+    const probe = async () => {
+        try {
+            // Match the trusted headless invocation. In a new task worktree Cursor
+            // checks workspace trust before it validates --allowed-tools otherwise.
+            await execute(bin, cursorArgs(bin, ['--print', '--force', '--trust', '--allowed-tools', INVALID_TOOL, 'capability validation only']), options);
+            throw new Error('Cursor print capability preflight did not reject an invalid native tool');
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.startsWith('Cursor print capability preflight'))
+                throw error;
+            const failure = error;
+            if (failure.code !== 1)
+                throw new Error('Cursor print capability preflight could not inspect native tools');
+            return `${failure.stderr ?? ''}\n${failure.stdout ?? ''}`;
+        }
+    };
+    let output = await probe();
+    if (rejectsCursorAutoUpdateFlag(output) && usesCursorAutoUpdateFlag(bin)) {
+        // This build has no way to stop its own updates; it still runs, without the flag.
+        noteCursorAutoUpdateFlagRejected(bin);
+        output = await probe();
+    }
+    const match = /Invalid --allowed-tools value\(s\): __cezar_probe_invalid__\. Expected one of: ([a-z_, ]+)/.exec(output);
+    if (!match)
+        throw new Error('Cursor print capability preflight returned an unknown native tool response');
+    const advertised = new Set(match[1].split(',').map(name => name.trim()).filter(Boolean));
+    const missing = CORE_CURSOR_PRINT_TOOLS.filter(name => !advertised.has(name));
+    if (missing.length) {
+        return { supported: false, reason: `Cursor native tool catalog lacks core print tools: ${missing.join(', ')}` };
+    }
+    return { supported: true };
+}
+/** Bounded, pre-inference checks that the installed build can run print sessions: a dated
+ * build no older than the baseline, the strict native tool validator, and the core tools. */
+export async function inspectCursorPrintCapabilities(bin, spec, signal) {
+    const options = {
+        cwd: spec.cwd,
+        env: buildChildEnv({ backend: 'cursor', extraEnv: spec.env }),
+        timeout: 5_000,
+        maxBuffer: 64 * 1024,
+        signal,
+    };
+    const version = await inspectBuildVersion(bin, options);
+    if (!version.supported)
+        return version;
+    const tools = await inspectNativeTools(bin, options);
+    if (!tools.supported)
+        return tools;
+    if (!spec.model && !spec.effort)
+        return { supported: true };
+    return resolveSelectedModel(bin, spec, options, signal);
+}
+async function resolveSelectedModel(bin, spec, options, signal) {
+    let models;
+    try {
+        models = parseCursorModels((await execute(bin, cursorArgs(bin, ['--list-models']), options)).stdout);
+    }
+    catch {
+        throw new Error('Cursor print capability preflight could not read selected-account models');
+    }
+    const model = spec.model ?? models.find(option => option.description === 'Default model')?.id;
+    if (!model)
+        throw new Error('Cursor print requested model is not advertised for the selected account');
+    if (!models.some(option => option.id === model)) {
+        // The picker uses canonical ACP IDs; --list-models lists legacy aliases.
+        // Query the same account, retaining native parameter keys and defaults.
+        let catalog;
+        try {
+            catalog = await discoverCursorParameterizedModels({ cwd: spec.cwd, bin, env: spec.env, signal });
+        }
+        catch {
+            throw new Error('Cursor print capability preflight could not read selected-account model parameters');
+        }
+        const selected = catalog.find(option => option.value === model);
+        if (!selected)
+            throw new Error('Cursor print requested model is not advertised for the selected account');
+        const resolvedModel = resolveParameterizedEffort(model, selected, spec.effort);
+        return { supported: true, model, resolvedModel };
+    }
+    verifyLegacyEffort(model, models, spec.effort);
+    return { supported: true, models, model };
+}
+function resolveParameterizedEffort(model, selected, requestedEffort) {
+    if (!requestedEffort)
+        return model;
+    const parameters = (selected.configOptions ?? []).filter(option => option.type === 'select');
+    const effort = parameters.find(option => ['effort', 'reasoning', 'reasoning_effort'].includes(option.id) &&
+        option.options?.some(value => value.value === requestedEffort));
+    if (!effort)
+        throw new Error('Cursor print requested effort is not advertised for the selected account');
+    const { selection, embedded } = parseModelSelection(model);
+    const values = resolveParameterValues(parameters, effort, requestedEffort, embedded);
+    // This qualified build accepts complete variant selections, not partial
+    // overrides. Preserve embedded selections, filling advertised defaults.
+    for (const option of values)
+        embedded.set(option.id, option.value);
+    return `${selection[1]}[${[...embedded].sort(([a], [b]) => a.localeCompare(b))
+        .map(([id, value]) => `${id}=${value}`).join(',')}]`;
+}
+function verifyLegacyEffort(model, models, requestedEffort) {
+    if (requestedEffort) {
+        const base = model.replace(/-(?:none|low|medium|high|xhigh|extra-high|max)$/, '');
+        const suffixes = requestedEffort === 'xhigh' ? ['xhigh', 'extra-high'] : [requestedEffort];
+        if (!suffixes.some(suffix => models.some(option => option.id === `${base}-${suffix}`))) {
+            throw new Error('Cursor print requested effort is not advertised for the selected account');
+        }
+    }
+}
+function parseModelSelection(model) {
+    const selection = /^([^[\]]+)(?:\[([^[\]]+)\])?$/.exec(model);
+    if (!selection)
+        throw new Error('Cursor print cannot verify the requested model parameters');
+    const embedded = new Map();
+    for (const entry of selection[2]?.split(',') ?? [])
+        addEmbeddedParameter(embedded, entry);
+    return { selection, embedded };
+}
+function addEmbeddedParameter(embedded, entry) {
+    const pair = /^([a-zA-Z0-9_]+)=([a-zA-Z0-9_.-]+)$/.exec(entry);
+    if (!pair || embedded.has(pair[1]))
+        throw new Error('Cursor print cannot verify the requested model parameters');
+    embedded.set(pair[1], pair[2]);
+}
+function resolveParameterValues(parameters, effort, requestedEffort, embedded) {
+    const values = parameters.map(option => ({ id: option.id,
+        value: option === effort ? requestedEffort : embedded.get(option.id) ?? option.currentValue }));
+    if (values.some((option, index) => !option.value || !/^[a-zA-Z0-9_.-]+$/.test(option.value) ||
+        !/^[a-zA-Z0-9_]+$/.test(option.id) ||
+        !parameters[index].options?.some(value => value.value === option.value))) {
+        throw new Error('Cursor print cannot verify the requested model parameters');
+    }
+    return values;
+}
+//# sourceMappingURL=cursor-print-capabilities.js.map

package/dist/core/cursor-print-capabilities.js.map

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

package/dist/core/cursor-print-process.d.ts

@@ -0,0 +1,31 @@
+export interface CursorPrintProcessOptions {
+    bin: string;
+    args: readonly string[];
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    /** Test overrides; production uses the shared runner deadlines. */
+    drainMs?: number;
+    termGraceMs?: number;
+    killGraceMs?: number;
+}
+export interface CursorPrintProcess {
+    readonly pid?: number | undefined;
+    write(content: string): Promise<void>;
+    closeInput(): void;
+    readonly exit: Promise<{
+        code: number | null;
+        signal: NodeJS.Signals | null;
+    }>;
+    readonly settled: Promise<void>;
+    stop(mode: 'graceful' | 'interrupt'): Promise<void>;
+}
+/**
+ * Own one Cursor print turn and its process group. `exit` means the leader
+ * exited; `settled` means inherited pipes were bounded and descendants were
+ * signalled. A subsequent turn must await `settled`, never just `exit`.
+ */
+export declare function startCursorPrintProcess(options: CursorPrintProcessOptions, callbacks: {
+    onStdout(chunk: string): void;
+    onStderr(chunk: string): void;
+    onOutputError?(error: Error): void;
+}): CursorPrintProcess;

package/dist/core/cursor-print-process.js

@@ -0,0 +1,117 @@
+import { finished } from 'node:stream/promises';
+import { afterExitDrain, CRASH_EXIT_DRAIN_MS, EOF_KILL_GRACE_MS, EOF_TERM_GRACE_MS, isCrashExit, } from './runner-runtime.js';
+import { signalExitedSession, signalSession, spawnSessionLeader } from './session-process.js';
+/**
+ * Own one Cursor print turn and its process group. `exit` means the leader
+ * exited; `settled` means inherited pipes were bounded and descendants were
+ * signalled. A subsequent turn must await `settled`, never just `exit`.
+ */
+export function startCursorPrintProcess(options, callbacks) {
+    const isNodeScript = /\.[cm]?js$/.test(options.bin);
+    const command = isNodeScript ? process.execPath : options.bin;
+    const args = isNodeScript ? [options.bin, ...options.args] : [...options.args];
+    // A registered session leader (hearsay-tools/cezarion#1286): cezar's own SIGINT/SIGTERM and the
+    // worker ledger reach its group, and every signal after its exit keeps the reuse guard.
+    const child = spawnSessionLeader(command, args, { cwd: options.cwd, env: options.env });
+    const pid = child.pid;
+    let closed = false;
+    let inputClosed = false;
+    let termTimer;
+    let killTimer;
+    let drainTimer;
+    child.stdout.setEncoding('utf8');
+    child.stderr.setEncoding('utf8');
+    child.stdout.on('data', (chunk) => { if (!closed)
+        callbacks.onStdout(chunk); });
+    child.stderr.on('data', (chunk) => { if (!closed)
+        callbacks.onStderr(chunk); });
+    child.stdout.on('error', error => { if (!closed)
+        callbacks.onOutputError?.(error); });
+    child.stderr.on('error', error => { if (!closed)
+        callbacks.onOutputError?.(error); });
+    // The input pipe can fail after an interrupted turn even if no writer is
+    // pending. Keep it observed so an EPIPE cannot crash the server.
+    child.stdin.on('error', () => { });
+    const exit = new Promise((resolve, reject) => {
+        child.once('exit', (code, exitSignal) => resolve({ code, signal: exitSignal }));
+        child.once('error', reject);
+    });
+    const settled = (async () => {
+        let failedExit = false;
+        let exitCode = null;
+        try {
+            exitCode = (await exit).code;
+            failedExit = exitCode !== 0;
+        }
+        catch {
+            failedExit = true;
+        }
+        if (termTimer)
+            clearTimeout(termTimer);
+        if (killTimer)
+            clearTimeout(killTimer);
+        // The leader can exit while a child retains stdout/stderr. End its owned
+        // process group, allow buffered final frames, then force pipe closure.
+        // On a crash, allow a short bounded drain for a descendant's final
+        // diagnostic before terminating the group (#499/S19). It is the shared
+        // crash budget, counted so a host stall cannot spend it, and ends early
+        // once both pipes have closed (hearsay-tools/cezarion#887).
+        if (failedExit) {
+            await new Promise(resolve => {
+                const cancel = afterExitDrain(resolve, isCrashExit(exitCode) ? CRASH_EXIT_DRAIN_MS : 200, true);
+                void Promise.all([child.stdout, child.stderr].map(stream => finished(stream, { cleanup: true }).catch(() => undefined)))
+                    .then(() => { cancel(); resolve(); });
+            });
+        }
+        // This ends Cursor's `worker-server` and its `typescript-language-server`: Cursor spawns
+        // them `detached: false`, so they stay in this group after the leader exits, and nothing
+        // else ends them before Cursor's own 300 s idle exit (hearsay-tools/cezarion#1285).
+        signalExitedSession(child, 'SIGTERM');
+        const drainMs = options.drainMs ?? 250;
+        await new Promise(resolve => { drainTimer = setTimeout(resolve, drainMs); });
+        signalExitedSession(child, 'SIGKILL');
+        child.stdout.destroy();
+        child.stderr.destroy();
+        if (drainTimer)
+            clearTimeout(drainTimer);
+        closed = true;
+    })();
+    const closeInput = () => {
+        if (inputClosed)
+            return;
+        inputClosed = true;
+        child.stdin.end();
+    };
+    const stop = async (mode) => {
+        if (closed)
+            return;
+        closeInput();
+        if (termTimer)
+            clearTimeout(termTimer);
+        if (killTimer)
+            clearTimeout(killTimer);
+        const termGrace = mode === 'interrupt' ? 0 : options.termGraceMs ?? EOF_TERM_GRACE_MS;
+        const killGrace = options.killGraceMs ?? EOF_KILL_GRACE_MS;
+        if (termGrace === 0)
+            signalSession(child, 'SIGTERM');
+        else
+            termTimer = setTimeout(() => signalSession(child, 'SIGTERM'), termGrace);
+        killTimer = setTimeout(() => signalSession(child, 'SIGKILL'), termGrace + killGrace);
+        await settled;
+    };
+    return {
+        pid,
+        exit,
+        settled,
+        closeInput,
+        stop,
+        write(content) {
+            if (inputClosed || closed)
+                return Promise.reject(new Error('Cursor print input is closed'));
+            return new Promise((resolve, reject) => {
+                child.stdin.write(content, error => error ? reject(error) : resolve());
+            });
+        },
+    };
+}
+//# sourceMappingURL=cursor-print-process.js.map

package/dist/core/cursor-print-process.js.map

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

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

@@ -0,0 +1,43 @@
+import type { AgentEvent, AgentRunResult, AgentRunner, AgentRunSpec, AgentRunSpecSupport, AgentSession, InputDelivery, SessionOptions } from './agent-runner.ts';
+import type { ModelOption } from './runner-model-catalog.ts';
+import { type CursorPrintProcessOptions } from './cursor-print-process.ts';
+/** Cursor print fields with live-qualified invocation mechanisms. */
+export declare const CURSOR_PRINT_SPEC_SUPPORT: AgentRunSpecSupport;
+export interface CursorPrintRunnerOptions {
+    bin?: string | undefined;
+    timeoutMs?: number;
+    /** The selected account's read-only model catalog, supplied by the facade. */
+    models?: readonly ModelOption[] | undefined;
+    /** Exact canonical selection validated by the selected-account preflight. */
+    resolvedModel?: string | undefined;
+    /** Test override; production retains the shared 30-minute no-progress cap. */
+    noProgressTimeoutMs?: number;
+    processOptions?: Pick<CursorPrintProcessOptions, 'drainMs' | 'termGraceMs' | 'killGraceMs'>;
+}
+export declare class CursorPrintRunner implements AgentRunner {
+    private readonly options;
+    readonly backend: 'cursor';
+    readonly specSupport: Readonly<Record<keyof AgentRunSpec, import("./agent-runner.ts").SpecFieldSupport>>;
+    readonly systemPromptOnResume: "in-thread";
+    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 inputDelivery: InputDelivery;
+    private lastSession?;
+    constructor(options?: CursorPrintRunnerOptions);
+    interrupt(): Promise<void>;
+    run(spec: AgentRunSpec, onEvent?: (event: AgentEvent) => void): Promise<AgentRunResult>;
+    startSession(spec: AgentRunSpec, onEvent?: (event: AgentEvent) => void, opts?: SessionOptions): AgentSession;
+}