@agent-deck/cli 1.11.9 → 2.1.0

package/dist/run-claude.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Claude adapter for `agent-deck run` (NOT-404).
+ *
+ * Moved verbatim out of run.ts (NOT-400): same SDK `query()` params, same
+ * message mapping, same missing-SDK remedy. No behavior change.
+ */
+import { type ClientAdapter } from './run-adapter';
+/** Minimal structural view of the SDK `query()` surface (the SDK loads lazily). */
+export type RunQueryMessage = {
+    type?: string;
+    subtype?: string;
+    session_id?: string;
+    result?: unknown;
+    message?: {
+        content?: Array<{
+            type?: string;
+            text?: string;
+            name?: string;
+        }>;
+    };
+};
+export type RunQueryOptions = {
+    cwd: string;
+    resume?: string;
+    settingSources: readonly string[];
+    permissionMode: string;
+    allowedTools: readonly string[];
+};
+export type RunQueryFn = (params: {
+    prompt: string;
+    options: RunQueryOptions;
+}) => AsyncIterable<RunQueryMessage>;
+export declare function loadClaudeSdkQuery(): RunQueryFn;
+export type ClaudeAdapterDeps = {
+    /** Injected in tests; production lazily requires the Claude Agent SDK. */
+    query?: RunQueryFn;
+    /** Override the SDK loader (tests use this to fail preflight deterministically). */
+    loadQuery?: () => RunQueryFn;
+};
+export declare function createClaudeAdapter(deps?: ClaudeAdapterDeps): ClientAdapter;
+//# sourceMappingURL=run-claude.d.ts.map

package/dist/run-claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-claude.d.ts","sourceRoot":"","sources":["../src/run-claude.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAKL,KAAK,aAAa,EAEnB,MAAM,eAAe,CAAC;AAGvB,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClE,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,eAAe,CAAC;CAC1B,KAAK,aAAa,CAAC,eAAe,CAAC,CAAC;AAErC,wBAAgB,kBAAkB,IAAI,UAAU,CAgB/C;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,0EAA0E;IAC1E,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,UAAU,CAAC;CAC9B,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,iBAAsB,GAAG,aAAa,CA+D/E"}

package/dist/run-claude.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadClaudeSdkQuery = loadClaudeSdkQuery;
+exports.createClaudeAdapter = createClaudeAdapter;
+/**
+ * Claude adapter for `agent-deck run` (NOT-404).
+ *
+ * Moved verbatim out of run.ts (NOT-400): same SDK `query()` params, same
+ * message mapping, same missing-SDK remedy. No behavior change.
+ */
+const run_adapter_1 = require("./run-adapter");
+const paths_1 = require("./paths");
+function loadClaudeSdkQuery() {
+    try {
+        const sdkPath = require.resolve('@anthropic-ai/claude-agent-sdk', {
+            paths: [(0, paths_1.getCliPackageRoot)()],
+        });
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const sdk = require(sdkPath);
+        if (typeof sdk.query !== 'function') {
+            throw new Error('unexpected SDK shape');
+        }
+        return sdk.query;
+    }
+    catch {
+        throw new Error('The Claude Agent SDK is not installed. Reinstall the CLI (`agent-deck upgrade` or `npm install -g @agent-deck/cli@latest`) so @anthropic-ai/claude-agent-sdk is present, then retry.');
+    }
+}
+function createClaudeAdapter(deps = {}) {
+    let cachedQuery = deps.query;
+    const loadQuery = deps.loadQuery ?? loadClaudeSdkQuery;
+    const getQuery = () => {
+        if (!cachedQuery) {
+            cachedQuery = loadQuery();
+        }
+        return cachedQuery;
+    };
+    return {
+        id: 'claude',
+        async preflight() {
+            try {
+                getQuery();
+                return { ok: true };
+            }
+            catch (error) {
+                return { ok: false, remedy: error instanceof Error ? error.message : String(error) };
+            }
+        },
+        planStart() {
+            return { ok: true, trustOverride: false };
+        },
+        async *start(args) {
+            const query = getQuery();
+            const stream = query({
+                prompt: args.prompt,
+                options: {
+                    cwd: args.cwd,
+                    ...(args.resumeId ? { resume: args.resumeId } : {}),
+                    settingSources: [...run_adapter_1.RUN_SETTING_SOURCES],
+                    permissionMode: run_adapter_1.RUN_PERMISSION_MODE,
+                    allowedTools: [...(0, run_adapter_1.allowedToolsForProfile)(args.tools)],
+                },
+            });
+            for await (const message of stream) {
+                const sessionId = typeof message.session_id === 'string' && message.session_id
+                    ? message.session_id
+                    : undefined;
+                const withSession = sessionId ? { sessionId } : {};
+                if (message.type === 'assistant') {
+                    for (const block of message.message?.content ?? []) {
+                        if (block.type === 'text' && typeof block.text === 'string') {
+                            yield { kind: 'text', text: block.text, ...withSession };
+                        }
+                        else if (block.type === 'tool_use' && typeof block.name === 'string') {
+                            yield { kind: 'tool', name: block.name, ...withSession };
+                        }
+                    }
+                }
+                else if (message.type === 'result') {
+                    yield {
+                        kind: 'result',
+                        subtype: message.subtype ?? '',
+                        result: message.result,
+                        ...withSession,
+                    };
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=run-claude.js.map

package/dist/run-claude.js.map

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

package/dist/run-codex.d.ts

@@ -0,0 +1,75 @@
+import { type ClientAdapter, type NormalizedEvent, type RunToolsProfile } from './run-adapter';
+/** Tool-profile mapping: readonly is `-s read-only`, edit is `-s workspace-write`. */
+export declare const CODEX_SANDBOX_FOR_PROFILE: Record<RunToolsProfile, 'read-only' | 'workspace-write'>;
+export declare const CODEX_JSONL_VERSION_NOTE = "codex-cli 0.157.1";
+export declare function resolveCodexBin(): string;
+export type CodexArgvArgs = {
+    prompt: string;
+    tools: RunToolsProfile;
+    resumeId?: string;
+    insideGitRepo: boolean;
+};
+/**
+ * Resume ids are codex thread ids (UUIDs); a leading `-` is never legitimate
+ * and would be parsed as a resume option (resume accepts
+ * `--dangerously-bypass-approvals-and-sandbox`, `-c`, ...), so it fails
+ * closed in planStart and throws here. Belt and suspenders with the `--`
+ * placement below: this builder never emits a dash-leading id at all.
+ */
+export declare function assertSafeResumeId(resumeId: string): void;
+/**
+ * Pure argv builder (everything after the `codex` binary). Start:
+ * `exec --json [--skip-git-repo-check] -s <mode> -- <prompt>`; resume:
+ * `exec resume --json [--skip-git-repo-check] -- <thread> <prompt>`
+ * (`codex exec resume [OPTIONS] [SESSION_ID] [PROMPT]` takes both positionals
+ * after `--`; verified `--help` after `--` is treated as a positional, not
+ * the help flag, on codex-cli 0.157.1).
+ * Resume takes no `-s`: the thread keeps its original sandbox.
+ * The `--` terminator keeps dash-leading prompts (markdown bullets, YAML
+ * frontmatter, or a literal `--dangerously-...` string) from being parsed
+ * as codex options.
+ */
+export declare function buildCodexArgv(args: CodexArgvArgs): string[];
+export declare function defaultIsGitRepo(cwd: string): boolean;
+export type CodexProbeResult = {
+    code: number;
+    stdout: string;
+    stderr: string;
+};
+export type CodexProbe = (bin: string, argv: string[]) => CodexProbeResult;
+export declare function defaultCodexProbe(bin: string, argv: string[]): CodexProbeResult;
+export type CodexChild = {
+    /** Stdout split into lines (without line terminators). */
+    stdout: AsyncIterable<string>;
+    wait: () => Promise<{
+        code: number | null;
+        stderrTail: string;
+    }>;
+};
+export type CodexSpawn = (bin: string, argv: string[], opts: {
+    cwd: string;
+}) => CodexChild;
+export declare function defaultCodexSpawn(bin: string, argv: string[], opts: {
+    cwd: string;
+}): CodexChild;
+export type CodexLineContext = {
+    threadId: string | null;
+};
+/**
+ * Map one `codex exec --json` stdout line onto normalized events:
+ * `thread.started.thread_id` becomes the session id (no log line);
+ * `agent_message` items become `text`; command/tool items become `tool`;
+ * `turn.completed` becomes `result` (subtype `success`); provider `error`
+ * events become `notice` (non-fatal). Unknown kinds are ignored so a newer
+ * CLI cannot break the log. Never throws: unparseable lines become `notice`.
+ */
+export declare function codexEventsFromLine(line: string, ctx: CodexLineContext): NormalizedEvent[];
+export declare function codexTrustOverride(cwd: string, isGitRepo: (cwd: string) => boolean): boolean;
+export type CodexAdapterDeps = {
+    bin?: string;
+    probe?: CodexProbe;
+    spawn?: CodexSpawn;
+    isGitRepo?: (cwd: string) => boolean;
+};
+export declare function createCodexAdapter(deps?: CodexAdapterDeps): ClientAdapter;
+//# sourceMappingURL=run-codex.d.ts.map

package/dist/run-codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-codex.d.ts","sourceRoot":"","sources":["../src/run-codex.ts"],"names":[],"mappings":"AAwBA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AAEvB,sFAAsF;AACtF,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,eAAe,EAAE,WAAW,GAAG,iBAAiB,CAG9F,CAAC;AAEF,eAAO,MAAM,wBAAwB,sBAAsB,CAAC;AAE5D,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOzD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,EAAE,CAoB5D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAUrD;AAED,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAChF,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,gBAAgB,CAAC;AAE3E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAO/E;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,0DAA0D;IAC1D,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,KAAK,UAAU,CAAC;AAE5F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CA6ChG;AAED,MAAM,MAAM,gBAAgB,GAAG;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAc3D;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,eAAe,EAAE,CAiE1F;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAM5F;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACtC,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,gBAAqB,GAAG,aAAa,CAsG7E"}

package/dist/run-codex.js

@@ -0,0 +1,337 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODEX_JSONL_VERSION_NOTE = exports.CODEX_SANDBOX_FOR_PROFILE = void 0;
+exports.resolveCodexBin = resolveCodexBin;
+exports.assertSafeResumeId = assertSafeResumeId;
+exports.buildCodexArgv = buildCodexArgv;
+exports.defaultIsGitRepo = defaultIsGitRepo;
+exports.defaultCodexProbe = defaultCodexProbe;
+exports.defaultCodexSpawn = defaultCodexSpawn;
+exports.codexEventsFromLine = codexEventsFromLine;
+exports.codexTrustOverride = codexTrustOverride;
+exports.createCodexAdapter = createCodexAdapter;
+/**
+ * Codex adapter for `agent-deck run` (NOT-404).
+ *
+ * Drives `codex exec --json` (start) and `codex exec resume` (resume) as a
+ * child process and maps the JSONL stream onto normalized events. Verified
+ * against codex-cli 0.157.1 (`codex exec --help`, `codex exec resume --help`,
+ * `codex login status`):
+ *
+ * - Start accepts `-s read-only|workspace-write`; resume accepts NO `-s`
+ *   flag (neither does `fork`), so a resumed `edit` run fails closed in
+ *   planStart instead of running with an unenforceable sandbox.
+ * - Signed-in preflight is `codex login status` (exit 0 + `Logged in ...`),
+ *   which makes no model call.
+ * - `--skip-git-repo-check` exists on both start and resume and is passed
+ *   only when --cwd is not inside a git work tree (recorded as
+ *   `trustOverride: true` in meta.json).
+ *
+ * `--dangerously-bypass-approvals-and-sandbox` must never be used: there is
+ * no flag, env var, or option that selects it, and tests assert no generated
+ * argv ever contains it.
+ */
+const node_child_process_1 = require("node:child_process");
+const node_readline_1 = __importDefault(require("node:readline"));
+/** Tool-profile mapping: readonly is `-s read-only`, edit is `-s workspace-write`. */
+exports.CODEX_SANDBOX_FOR_PROFILE = {
+    readonly: 'read-only',
+    edit: 'workspace-write',
+};
+exports.CODEX_JSONL_VERSION_NOTE = 'codex-cli 0.157.1';
+function resolveCodexBin() {
+    return process.env.CODEX_BIN?.trim() || 'codex';
+}
+/**
+ * Resume ids are codex thread ids (UUIDs); a leading `-` is never legitimate
+ * and would be parsed as a resume option (resume accepts
+ * `--dangerously-bypass-approvals-and-sandbox`, `-c`, ...), so it fails
+ * closed in planStart and throws here. Belt and suspenders with the `--`
+ * placement below: this builder never emits a dash-leading id at all.
+ */
+function assertSafeResumeId(resumeId) {
+    if (resumeId.startsWith('-')) {
+        throw new Error(`Invalid --resume id ${JSON.stringify(resumeId)}: session ids never start with '-'. ` +
+            'Pass the thread id printed as sessionId in a previous run log.');
+    }
+}
+/**
+ * Pure argv builder (everything after the `codex` binary). Start:
+ * `exec --json [--skip-git-repo-check] -s <mode> -- <prompt>`; resume:
+ * `exec resume --json [--skip-git-repo-check] -- <thread> <prompt>`
+ * (`codex exec resume [OPTIONS] [SESSION_ID] [PROMPT]` takes both positionals
+ * after `--`; verified `--help` after `--` is treated as a positional, not
+ * the help flag, on codex-cli 0.157.1).
+ * Resume takes no `-s`: the thread keeps its original sandbox.
+ * The `--` terminator keeps dash-leading prompts (markdown bullets, YAML
+ * frontmatter, or a literal `--dangerously-...` string) from being parsed
+ * as codex options.
+ */
+function buildCodexArgv(args) {
+    const argv = ['exec'];
+    const resuming = args.resumeId !== undefined;
+    if (resuming) {
+        assertSafeResumeId(args.resumeId);
+        argv.push('resume');
+    }
+    argv.push('--json');
+    if (!args.insideGitRepo) {
+        argv.push('--skip-git-repo-check');
+    }
+    if (!resuming) {
+        argv.push('-s', exports.CODEX_SANDBOX_FOR_PROFILE[args.tools]);
+    }
+    argv.push('--');
+    if (resuming) {
+        argv.push(args.resumeId);
+    }
+    argv.push(args.prompt);
+    return argv;
+}
+function defaultIsGitRepo(cwd) {
+    try {
+        const probed = (0, node_child_process_1.spawnSync)('git', ['-C', cwd, 'rev-parse', '--is-inside-work-tree'], {
+            encoding: 'utf8',
+            timeout: 5000,
+        });
+        return probed.status === 0 && (probed.stdout ?? '').trim() === 'true';
+    }
+    catch {
+        return false;
+    }
+}
+function defaultCodexProbe(bin, argv) {
+    try {
+        const probed = (0, node_child_process_1.spawnSync)(bin, argv, { encoding: 'utf8', timeout: 15000 });
+        return { code: probed.status ?? 1, stdout: probed.stdout ?? '', stderr: probed.stderr ?? '' };
+    }
+    catch {
+        return { code: 127, stdout: '', stderr: '' };
+    }
+}
+function defaultCodexSpawn(bin, argv, opts) {
+    const child = (0, node_child_process_1.spawn)(bin, argv, { cwd: opts.cwd, stdio: ['ignore', 'pipe', 'pipe'] });
+    let spawnError = null;
+    child.on('error', (error) => {
+        spawnError = error;
+        child.stdout?.destroy();
+    });
+    const stderrChunks = [];
+    child.stderr?.on('data', (chunk) => {
+        stderrChunks.push(Buffer.from(chunk));
+    });
+    async function* lines() {
+        const rl = node_readline_1.default.createInterface({ input: child.stdout });
+        try {
+            for await (const line of rl) {
+                yield line;
+            }
+        }
+        catch {
+            // The stdout stream is destroyed when the spawn itself fails; the
+            // spawn error below is the actionable failure.
+        }
+        if (spawnError) {
+            throw spawnError;
+        }
+    }
+    const wait = () => new Promise((resolve) => {
+        let settled = false;
+        const done = (code) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            resolve({
+                code,
+                stderrTail: Buffer.concat(stderrChunks).toString('utf8').slice(-2000),
+            });
+        };
+        child.on('close', done);
+        child.on('error', () => done(127));
+    });
+    return { stdout: lines(), wait };
+}
+function withSession(event, ctx) {
+    return ctx.threadId ? { ...event, sessionId: ctx.threadId } : event;
+}
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : null;
+}
+function nonEmptyString(value) {
+    return typeof value === 'string' && value ? value : null;
+}
+/**
+ * Map one `codex exec --json` stdout line onto normalized events:
+ * `thread.started.thread_id` becomes the session id (no log line);
+ * `agent_message` items become `text`; command/tool items become `tool`;
+ * `turn.completed` becomes `result` (subtype `success`); provider `error`
+ * events become `notice` (non-fatal). Unknown kinds are ignored so a newer
+ * CLI cannot break the log. Never throws: unparseable lines become `notice`.
+ */
+function codexEventsFromLine(line, ctx) {
+    const trimmed = line.trim();
+    if (!trimmed) {
+        return [];
+    }
+    let event;
+    try {
+        event = JSON.parse(trimmed);
+    }
+    catch {
+        return [
+            withSession({ kind: 'notice', message: `unparseable codex output: ${trimmed.slice(0, 300)}` }, ctx),
+        ];
+    }
+    const record = asRecord(event);
+    if (!record) {
+        return [];
+    }
+    switch (record.type) {
+        case 'thread.started': {
+            const threadId = nonEmptyString(record.thread_id);
+            if (threadId) {
+                ctx.threadId = threadId;
+            }
+            return [];
+        }
+        case 'item.completed': {
+            const item = asRecord(record.item);
+            if (!item) {
+                return [];
+            }
+            if (item.type === 'agent_message') {
+                const text = nonEmptyString(item.text) ?? nonEmptyString(item.content);
+                return text ? [withSession({ kind: 'text', text }, ctx)] : [];
+            }
+            if (item.type === 'reasoning') {
+                return [];
+            }
+            const name = nonEmptyString(item.name) ??
+                (nonEmptyString(item.command) ? `command:${item.command}`.slice(0, 200) : null) ??
+                nonEmptyString(item.type) ??
+                'item';
+            return [withSession({ kind: 'tool', name }, ctx)];
+        }
+        case 'turn.completed': {
+            const usage = record.usage === undefined ? null : { usage: record.usage };
+            return [withSession({ kind: 'result', subtype: 'success', result: usage }, ctx)];
+        }
+        case 'turn.failed': {
+            const detail = record.error ?? record.usage ?? null;
+            return [withSession({ kind: 'result', subtype: 'failed', result: detail }, ctx)];
+        }
+        case 'error': {
+            const message = nonEmptyString(record.message) ?? `codex error: ${trimmed.slice(0, 300)}`;
+            return [withSession({ kind: 'notice', message: message.slice(0, 500) }, ctx)];
+        }
+        default:
+            // turn.started and any future kinds carry nothing the log needs.
+            return [];
+    }
+}
+function codexTrustOverride(cwd, isGitRepo) {
+    try {
+        return !isGitRepo(cwd);
+    }
+    catch {
+        return true;
+    }
+}
+function createCodexAdapter(deps = {}) {
+    const bin = deps.bin ?? resolveCodexBin();
+    const probe = deps.probe ?? defaultCodexProbe;
+    const spawnFn = deps.spawn ?? defaultCodexSpawn;
+    const isGitRepo = deps.isGitRepo ?? defaultIsGitRepo;
+    return {
+        id: 'codex',
+        async preflight() {
+            const version = probe(bin, ['--version']);
+            if (version.code !== 0) {
+                return {
+                    ok: false,
+                    remedy: `codex CLI not found (tried "${bin}"): install codex-cli 0.157+ and ensure 'codex' is on PATH (or set CODEX_BIN=/path/to/codex), then retry.`,
+                };
+            }
+            const login = probe(bin, ['login', 'status']);
+            // `login status` reports on stderr ("Logged in using ChatGPT" on 0.157.1),
+            // so both streams count; the anchored match rejects "Not logged in".
+            const loginText = `${login.stdout}\n${login.stderr}`;
+            if (login.code !== 0 || !/^\s*logged in/im.test(loginText)) {
+                return {
+                    ok: false,
+                    remedy: 'codex is not signed in: run `codex login`, then retry.',
+                };
+            }
+            return { ok: true };
+        },
+        planStart(args) {
+            if (args.resumeId !== undefined && args.resumeId.startsWith('-')) {
+                return {
+                    ok: false,
+                    remedy: `Invalid --resume id ${JSON.stringify(args.resumeId)}: session ids never start with '-'. ` +
+                        'Pass the thread id printed as sessionId in a previous run log.',
+                };
+            }
+            if (args.resumeId !== undefined && args.tools === 'edit') {
+                return {
+                    ok: false,
+                    remedy: `Cannot resume codex thread ${args.resumeId} with --tools edit: 'codex exec resume' accepts no sandbox flag, ` +
+                        'so the edit sandbox cannot be enforced on resume. Start a new run without --resume, or resume with --tools readonly.',
+                };
+            }
+            return { ok: true, trustOverride: codexTrustOverride(args.cwd, isGitRepo) };
+        },
+        async *start(args) {
+            const insideGitRepo = !codexTrustOverride(args.cwd, isGitRepo);
+            const argv = buildCodexArgv({
+                prompt: args.prompt,
+                tools: args.tools,
+                ...(args.resumeId !== undefined ? { resumeId: args.resumeId } : {}),
+                insideGitRepo,
+            });
+            if (args.resumeId !== undefined) {
+                yield {
+                    kind: 'notice',
+                    message: `Resuming codex thread ${args.resumeId}: the thread keeps its original sandbox; ` +
+                        `--tools ${args.tools} is recorded but cannot be re-applied on resume.`,
+                    sessionId: args.resumeId,
+                };
+            }
+            const wrapSpawnError = (error) => new Error(`codex run failed: ${String(error instanceof Error ? error.message : error).slice(0, 300)}`);
+            let child;
+            try {
+                child = spawnFn(bin, argv, { cwd: args.cwd });
+            }
+            catch (error) {
+                throw wrapSpawnError(error);
+            }
+            const ctx = { threadId: args.resumeId ?? null };
+            try {
+                for await (const line of child.stdout) {
+                    for (const event of codexEventsFromLine(line, ctx)) {
+                        yield event;
+                    }
+                }
+            }
+            catch (error) {
+                throw wrapSpawnError(error);
+            }
+            let settled;
+            try {
+                settled = await child.wait();
+            }
+            catch (error) {
+                throw wrapSpawnError(error);
+            }
+            const { code, stderrTail } = settled;
+            if (code !== 0) {
+                throw new Error(`codex exited with code ${code}${stderrTail ? `: ${stderrTail.slice(0, 300)}` : ''}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=run-codex.js.map

package/dist/run-codex.js.map

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

package/dist/run-cursor.d.ts

@@ -0,0 +1,79 @@
+import { type ClientAdapter, type NormalizedEvent, type RunToolsProfile } from './run-adapter';
+export declare const CURSOR_JSON_VERSION_NOTE = "cursor-agent 2026.10.01";
+/** Single-shot result object; stream-json incremental shape is unverified. */
+export declare const CURSOR_OUTPUT_FORMAT = "json";
+export declare function resolveCursorBin(): string;
+export type CursorArgvArgs = {
+    prompt: string;
+    tools: RunToolsProfile;
+    resumeId?: string;
+};
+/**
+ * Resume ids are cursor chat ids (32-hex); a leading `-` is never legitimate
+ * and would be parsed as a cursor-agent option, so it fails closed in
+ * planStart and throws here. Belt and suspenders with the `--` placement
+ * below: this builder never emits a dash-leading id at all.
+ */
+export declare function assertSafeCursorResumeId(resumeId: string): void;
+/**
+ * Pure argv builder (everything after the `cursor-agent` binary):
+ * `-p --trust --output-format json [--force] [--resume <id>] -- <prompt>`.
+ * `--force` only for the edit profile; `--yolo` and `--approve-mcps` are
+ * never emitted. The `--` terminator keeps dash-leading prompts from being
+ * parsed as cursor-agent options.
+ */
+export declare function buildCursorArgv(args: CursorArgvArgs): string[];
+export type CursorProbeResult = {
+    code: number;
+    stdout: string;
+    stderr: string;
+};
+export type CursorProbe = (bin: string, argv: string[]) => CursorProbeResult;
+export declare function defaultCursorProbe(bin: string, argv: string[]): CursorProbeResult;
+export type CursorChild = {
+    /** Stdout split into lines (without line terminators). */
+    stdout: AsyncIterable<string>;
+    wait: () => Promise<{
+        code: number | null;
+        stderrTail: string;
+    }>;
+};
+export type CursorSpawn = (bin: string, argv: string[], opts: {
+    cwd: string;
+}) => CursorChild;
+export declare function defaultCursorSpawn(bin: string, argv: string[], opts: {
+    cwd: string;
+}): CursorChild;
+/**
+ * `cursor-agent status --format json` exits 0 even when signed out
+ * (`{"status":"unauthenticated","isAuthenticated":false,...}`), so the
+ * output decides. The `isAuthenticated` boolean wins; the `status` string
+ * and a text fallback cover older shapes. Unknown output fails closed.
+ */
+export declare function isCursorStatusAuthenticated(output: string): boolean;
+/**
+ * Map the single-shot `--output-format json` stdout onto normalized events:
+ * the result object's `session_id` becomes `sessionId`; the answer text
+ * becomes one `text` event; tool arrays become `tool` events; warning arrays
+ * become `notice` events; the full object becomes the `result` payload
+ * (subtype `success`, or `failed` when the object carries `error`,
+ * `is_error: true`, or a non-`success` subtype).
+ *
+ * Throws (so the shared run code marks the run `error`) on "Workspace Trust
+ * Required", on empty output at exit 0, on non-JSON output, on a result
+ * object with no answer text, tool call, or error content (a bare session
+ * id, including the resume-id fallback, is not content), and — on start
+ * only, not resume — on a success whose output lacks a `◆ ... ·` deck
+ * receipt line. Never returns an empty event list: success always ends with
+ * a `result` event.
+ */
+export declare function cursorEventsFromOutput(stdout: string, opts?: {
+    resumeId?: string;
+}): NormalizedEvent[];
+export type CursorAdapterDeps = {
+    bin?: string;
+    probe?: CursorProbe;
+    spawn?: CursorSpawn;
+};
+export declare function createCursorAdapter(deps?: CursorAdapterDeps): ClientAdapter;
+//# sourceMappingURL=run-cursor.d.ts.map

package/dist/run-cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-cursor.d.ts","sourceRoot":"","sources":["../src/run-cursor.ts"],"names":[],"mappings":"AA6CA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,wBAAwB,4BAA4B,CAAC;AAElE,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAE3C,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAO/D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CAW9D;AAED,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AACjF,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,iBAAiB,CAAC;AAE7E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAOjF;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,0DAA0D;IAC1D,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,KAAK,WAAW,CAAC;AAE9F,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CA6ClG;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CA4BnE;AAsDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,eAAe,EAAE,CAyJnB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,iBAAsB,GAAG,aAAa,CAoF/E"}