@sumeru/adapter-codex 0.1.0

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 shazhou
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and 
+associated documentation files (the "Software"), to deal in the Software without restriction, including 
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the 
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial 
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT 
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO 
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER 
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE 
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/.build-fingerprint

@@ -0,0 +1 @@
+3d31558a2ce75d22c9b27b613d0d15d224876652c74e2b7bfd612eca9c41b451

package/dist/adapter.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Codex adapter — implements the `Adapter` contract from `@sumeru/core`
+ * by shelling out to `codex exec <prompt> --json
+ * --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check`
+ * for create/send and parsing the resulting JSONL stream into `Turn[]`.
+ *
+ * Codex supports session resume via `codex exec resume <id> <prompt>`.
+ * The adapter caches parsed turns in an in-memory `Map<string, Turn[]>`
+ * keyed by `nativeId` and is the sole authority on history for the
+ * lifetime of the adapter instance.
+ *
+ * The factory:
+ *   - createSession spawns `codex exec "ping" --json ...` and parses the
+ *     JSONL stream for the session id. Accepts `SessionConfig` with
+ *     `model` and `cwd` fields.
+ *   - send is an async generator that spawns `codex exec resume <id>
+ *     <prompt> --json ...`, parses the JSONL output, and yields each
+ *     delta turn as `{ type: "turn", turn }` followed by
+ *     `{ type: "done", durationMs, tokens }`. On error yields
+ *     `{ type: "error", error }` instead of throwing.
+ *   - close is a logical close — adds the nativeId to a per-instance Set;
+ *     no Codex-side notification, no cache eviction.
+ *   - getTurns returns a defensive copy of the in-memory cache.
+ */
+import type { Adapter } from "@sumeru/core";
+import type { CodexAdapterOptions } from "./types.js";
+export declare function createCodexAdapter(options?: Partial<CodexAdapterOptions>): Adapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EACX,OAAO,EAMP,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EACX,mBAAmB,EAOnB,MAAM,YAAY,CAAC;AAsBpB,wBAAgB,kBAAkB,CACjC,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACxC,OAAO,CA6ST"}

package/dist/adapter.js

@@ -0,0 +1,340 @@
+/**
+ * Codex adapter — implements the `Adapter` contract from `@sumeru/core`
+ * by shelling out to `codex exec <prompt> --json
+ * --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check`
+ * for create/send and parsing the resulting JSONL stream into `Turn[]`.
+ *
+ * Codex supports session resume via `codex exec resume <id> <prompt>`.
+ * The adapter caches parsed turns in an in-memory `Map<string, Turn[]>`
+ * keyed by `nativeId` and is the sole authority on history for the
+ * lifetime of the adapter instance.
+ *
+ * The factory:
+ *   - createSession spawns `codex exec "ping" --json ...` and parses the
+ *     JSONL stream for the session id. Accepts `SessionConfig` with
+ *     `model` and `cwd` fields.
+ *   - send is an async generator that spawns `codex exec resume <id>
+ *     <prompt> --json ...`, parses the JSONL output, and yields each
+ *     delta turn as `{ type: "turn", turn }` followed by
+ *     `{ type: "done", durationMs, tokens }`. On error yields
+ *     `{ type: "error", error }` instead of throwing.
+ *   - close is a logical close — adds the nativeId to a per-instance Set;
+ *     no Codex-side notification, no cache eviction.
+ *   - getTurns returns a defensive copy of the in-memory cache.
+ */
+import { defaultSpawn, defaultStreamingSpawn } from "./spawn.js";
+import { parseCodexJson, parseCodexJsonIncremental } from "./stream-parser.js";
+const DEFAULT_CODEX_BIN = "codex";
+const DEFAULT_CREATE_TIMEOUT_MS = 5 * 60_000;
+/**
+ * Default `send` timeout — 30 minutes.
+ *
+ * Consistent with adapter-claude-code. Operators may further override via
+ * the `gateways.<name>.config.sendTimeoutMs` field in `sumeru.yaml`.
+ */
+const DEFAULT_SEND_TIMEOUT_MS = 30 * 60_000;
+const STDERR_TRUNCATE_LIMIT = 500;
+const API_KEY_ERROR_MESSAGE = "codex API key error. Check your OPENAI_API_KEY configuration.";
+const API_KEY_PATTERNS = [
+    /invalid api key/i,
+    /OPENAI_API_KEY/i,
+    /authentication/i,
+    /unauthorized/i,
+    /api.?key/i,
+];
+export function createCodexAdapter(options = {}) {
+    const codexBin = options.codexBin ?? DEFAULT_CODEX_BIN;
+    const defaultModel = options.model ?? null;
+    const cwd = options.cwd ?? null;
+    const createSessionTimeoutMs = options.createSessionTimeoutMs ?? DEFAULT_CREATE_TIMEOUT_MS;
+    const sendTimeoutMs = options.sendTimeoutMs ?? DEFAULT_SEND_TIMEOUT_MS;
+    const spawnFn = options.spawnFn ?? defaultSpawn;
+    const streamingSpawnFn = options.streamingSpawnFn ?? defaultStreamingSpawn;
+    const dangerouslyBypassApprovals = options.dangerouslyBypassApprovals ?? true;
+    const skipGitRepoCheck = options.skipGitRepoCheck ?? true;
+    const turnsCache = new Map();
+    const closedRefs = new Set();
+    const sendLocks = new Map();
+    function resolveCwd() {
+        return cwd ?? process.cwd();
+    }
+    function buildArgs(prompt, resumeId, model, spawnCwd) {
+        const args = ["exec"];
+        // Resume mode: `codex exec resume <id> "<prompt>"`
+        if (resumeId !== null) {
+            args.push("resume", resumeId);
+        }
+        // Add the prompt
+        args.push(prompt);
+        // Add --json for JSONL output
+        args.push("--json");
+        // Add permission bypass flags if enabled
+        if (dangerouslyBypassApprovals) {
+            args.push("--dangerously-bypass-approvals-and-sandbox");
+        }
+        if (skipGitRepoCheck) {
+            args.push("--skip-git-repo-check");
+        }
+        // Add working directory
+        args.push("-C", spawnCwd);
+        // Add model if specified
+        if (model !== null) {
+            args.push("-m", model);
+        }
+        return args;
+    }
+    async function runCodex(prompt, resumeId, model, timeoutMs, spawnCwd) {
+        const args = buildArgs(prompt, resumeId, model, spawnCwd);
+        const result = await spawnFn({
+            command: codexBin,
+            args,
+            timeoutMs,
+            cwd: spawnCwd,
+        }).catch((err) => {
+            const detail = err instanceof Error ? err.message : String(err);
+            throw new Error(`codex adapter failed to spawn '${codexBin}': ${detail}`);
+        });
+        const parsed = parseCodexJson(result.stdout);
+        return { result, parsed };
+    }
+    async function createSession(config) {
+        const model = config.model ?? defaultModel;
+        const spawnCwd = config.cwd ?? resolveCwd();
+        const { result, parsed } = await runCodex("ping", null, model, createSessionTimeoutMs, spawnCwd);
+        if (result.timedOut) {
+            throw new Error(`createSession timed out after ${createSessionTimeoutMs}ms`);
+        }
+        if (parsed === null) {
+            throw makeUnparseableOrExitError(result, codexBin);
+        }
+        // Parsed but no session id — treat as unparseable.
+        if (parsed.sessionId === "") {
+            throw makeUnparseableOrExitError(result, codexBin);
+        }
+        // Adapter rewrites indices to be globally monotonic from 0.
+        const rewritten = rewriteIndices(parsed.turns, -1);
+        turnsCache.set(parsed.sessionId, rewritten);
+        const meta = {
+            cwd: spawnCwd,
+            model: parsed.model !== "" ? parsed.model : model,
+            createdAt: new Date().toISOString(),
+            subtype: parsed.subtype,
+        };
+        return { nativeId: parsed.sessionId, meta };
+    }
+    function send(ref, content) {
+        assertRef(ref, "send");
+        if (closedRefs.has(ref.nativeId)) {
+            throw new Error(`codex session ${ref.nativeId} is closed`);
+        }
+        if (typeof content !== "string" || content.length === 0) {
+            throw new Error("send: content must be a non-empty string");
+        }
+        const nativeId = ref.nativeId;
+        async function* generate() {
+            // Acquire the lock — it stays held until this generator finishes.
+            const prev = sendLocks.get(nativeId) ?? Promise.resolve();
+            let release = () => { };
+            const next = new Promise((resolve) => {
+                release = resolve;
+            });
+            const chain = prev.then(() => next);
+            sendLocks.set(nativeId, chain);
+            try {
+                await prev;
+                yield* streamSend(nativeId, ref, content);
+            }
+            finally {
+                release();
+                if (sendLocks.get(nativeId) === chain) {
+                    sendLocks.delete(nativeId);
+                }
+            }
+        }
+        return generate();
+    }
+    async function* streamSend(nativeId, ref, content) {
+        if (closedRefs.has(nativeId)) {
+            yield {
+                type: "error",
+                error: new Error(`codex session ${nativeId} is closed`),
+            };
+            return;
+        }
+        const before = turnsCache.get(nativeId) ?? [];
+        const highWater = before.length === 0
+            ? -1
+            : before.reduce((m, t) => (t.index > m ? t.index : m), -1);
+        let nextIndex = highWater + 1;
+        const refModel = typeof ref.meta.model === "string" && ref.meta.model.length > 0
+            ? ref.meta.model
+            : defaultModel;
+        const refCwd = typeof ref.meta.cwd === "string" && ref.meta.cwd.length > 0
+            ? ref.meta.cwd
+            : resolveCwd();
+        const args = buildArgs(content, nativeId, refModel, refCwd);
+        const startedAt = Date.now();
+        let streamResult;
+        try {
+            streamResult = streamingSpawnFn({
+                command: codexBin,
+                args,
+                timeoutMs: sendTimeoutMs,
+                cwd: refCwd,
+            });
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            yield {
+                type: "error",
+                error: new Error(`codex adapter failed to spawn '${codexBin}': ${detail}`),
+            };
+            return;
+        }
+        let resultLine = null;
+        try {
+            for await (const event of parseCodexJsonIncremental(streamResult.lines)) {
+                if (event.type === "turn") {
+                    const turn = event.turn;
+                    turn.index = nextIndex++;
+                    const existing = turnsCache.get(nativeId) ?? [];
+                    turnsCache.set(nativeId, [...existing, turn]);
+                    yield { type: "turn", turn };
+                }
+                else if (event.type === "result") {
+                    resultLine = event.resultLine;
+                }
+            }
+        }
+        catch (err) {
+            yield {
+                type: "error",
+                error: err instanceof Error
+                    ? err
+                    : new Error(`stream read error: ${String(err)}`),
+            };
+            return;
+        }
+        let exitInfo;
+        try {
+            exitInfo = await streamResult.waitForExit();
+        }
+        catch (err) {
+            yield {
+                type: "error",
+                error: err instanceof Error
+                    ? err
+                    : new Error(`process exit error: ${String(err)}`),
+            };
+            return;
+        }
+        if (exitInfo.timedOut) {
+            yield {
+                type: "error",
+                error: new Error(`send timed out after ${sendTimeoutMs}ms`),
+            };
+            return;
+        }
+        if (exitInfo.exitCode !== null && exitInfo.exitCode !== 0) {
+            const stderrTrimmed = exitInfo.stderr.trim();
+            const snippet = stderrTrimmed === ""
+                ? ""
+                : `: ${tail(stderrTrimmed, STDERR_TRUNCATE_LIMIT)}`;
+            yield {
+                type: "error",
+                error: new Error(`codex exited with code ${String(exitInfo.exitCode)}${snippet}`),
+            };
+            return;
+        }
+        const tokens = deriveTokensFromResultLine(resultLine);
+        yield {
+            type: "done",
+            durationMs: Date.now() - startedAt,
+            tokens,
+        };
+    }
+    async function close(ref) {
+        assertRef(ref, "close");
+        closedRefs.add(ref.nativeId);
+    }
+    async function getTurns(ref) {
+        assertRef(ref, "getTurns");
+        const cached = turnsCache.get(ref.nativeId);
+        if (cached === undefined)
+            return [];
+        return [...cached];
+    }
+    return {
+        name: "codex",
+        createSession,
+        send,
+        close,
+        getTurns,
+    };
+}
+function assertRef(ref, op) {
+    if (ref === null ||
+        ref === undefined ||
+        typeof ref !== "object" ||
+        typeof ref.nativeId !== "string" ||
+        ref.nativeId.length === 0) {
+        throw new Error(`${op}: invalid NativeSessionRef`);
+    }
+}
+function rewriteIndices(turns, highWater) {
+    let nextIndex = highWater + 1;
+    return turns.map((turn) => ({
+        ...turn,
+        index: nextIndex++,
+    }));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function safeNumber(v, fallback = 0) {
+    return typeof v === "number" && Number.isFinite(v) ? v : fallback;
+}
+function deriveTokensFromResultLine(resultLine) {
+    if (resultLine === null)
+        return null;
+    const usage = isRecord(resultLine.usage) ? resultLine.usage : resultLine;
+    const input = safeNumber(usage.input_tokens ?? usage.inputTokens ?? usage.prompt_tokens);
+    const output = safeNumber(usage.output_tokens ?? usage.outputTokens ?? usage.completion_tokens);
+    if (input === 0 && output === 0)
+        return null;
+    return { input, output };
+}
+function makeUnparseableOrExitError(result, codexBin, nativeId = null) {
+    const stderr = result.stderr ?? "";
+    const stdout = result.stdout ?? "";
+    const stderrTrimmed = stderr.trim();
+    // API key errors take precedence over generic exit errors.
+    for (const pattern of API_KEY_PATTERNS) {
+        if (pattern.test(stderrTrimmed)) {
+            const codeText = result.exitCode === null ? "null" : String(result.exitCode);
+            return new Error(`codex exited with code ${codeText}: ${API_KEY_ERROR_MESSAGE}`);
+        }
+    }
+    // Session-not-found heuristic for resume failures.
+    if (nativeId !== null && /not found|no such session/i.test(stderrTrimmed)) {
+        return new Error(`codex session ${nativeId} not found: ${tail(stderrTrimmed, STDERR_TRUNCATE_LIMIT)}`);
+    }
+    if (result.exitCode !== null && result.exitCode !== 0) {
+        const codeText = String(result.exitCode);
+        const snippet = stderrTrimmed === ""
+            ? ""
+            : `: ${tail(stderrTrimmed, STDERR_TRUNCATE_LIMIT)}`;
+        return new Error(`codex exited with code ${codeText}${snippet}`);
+    }
+    // Unparseable but exit was 0 (or null) — generic parse error referencing
+    // codexBin so callers can debug a misconfigured PATH.
+    const head = stdout.slice(0, 500);
+    const stderrTail = tail(stderrTrimmed, STDERR_TRUNCATE_LIMIT);
+    return new Error(`codex returned unparseable json output (bin=${codexBin}, first 500 chars: ${head}, stderr tail: ${stderrTail})`);
+}
+function tail(s, n) {
+    if (s.length <= n)
+        return s;
+    return s.slice(s.length - n);
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Public surface of `@sumeru/adapter-codex`.
+ *
+ * The factory `createCodexAdapter` returns an `Adapter` (from
+ * `@sumeru/core`) that drives the OpenAI Codex CLI via `codex exec --json
+ * --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check` mode.
+ * See `adapter.ts` for the implementation.
+ */
+export { createCodexAdapter } from "./adapter.js";
+export { parseCodexJson, parseCodexJsonIncremental, } from "./stream-parser.js";
+export type { CodexAdapterOptions, CodexParsedResult, CodexResultSubtype, SpawnArgs, SpawnExitInfo, SpawnFn, SpawnResult, SpawnStreamResult, StreamingSpawnFn, StreamParseEvent, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACN,cAAc,EACd,yBAAyB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACX,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,aAAa,EACb,OAAO,EACP,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * Public surface of `@sumeru/adapter-codex`.
+ *
+ * The factory `createCodexAdapter` returns an `Adapter` (from
+ * `@sumeru/core`) that drives the OpenAI Codex CLI via `codex exec --json
+ * --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check` mode.
+ * See `adapter.ts` for the implementation.
+ */
+export { createCodexAdapter } from "./adapter.js";
+export { parseCodexJson, parseCodexJsonIncremental, } from "./stream-parser.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACN,cAAc,EACd,yBAAyB,GACzB,MAAM,oBAAoB,CAAC"}

package/dist/spawn.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Default `SpawnFn` for the Codex adapter — wraps
+ * `node:child_process.spawn` with a timeout.
+ *
+ * Returns `{stdout, stderr, exitCode, signal, timedOut, durationMs}`. On
+ * timeout the child receives `SIGTERM`; if it is still alive after 5 s a
+ * `SIGKILL` follows. `timedOut` is set to `true`.
+ *
+ * Argv is passed as an explicit array — never via shell — so embedded
+ * quotes, backslashes, newlines, and emoji round-trip without corruption.
+ */
+import type { SpawnFn, StreamingSpawnFn } from "./types.js";
+export declare const defaultSpawn: SpawnFn;
+/**
+ * Streaming variant of `defaultSpawn` — returns synchronously with
+ * line-by-line stdout access via `lines` (an AsyncIterable<string>).
+ */
+export declare const defaultStreamingSpawn: StreamingSpawnFn;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../src/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAGX,OAAO,EAGP,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAIpB,eAAO,MAAM,YAAY,EAAE,OAyD1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,gBA4DnC,CAAC"}

package/dist/spawn.js

@@ -0,0 +1,117 @@
+/**
+ * Default `SpawnFn` for the Codex adapter — wraps
+ * `node:child_process.spawn` with a timeout.
+ *
+ * Returns `{stdout, stderr, exitCode, signal, timedOut, durationMs}`. On
+ * timeout the child receives `SIGTERM`; if it is still alive after 5 s a
+ * `SIGKILL` follows. `timedOut` is set to `true`.
+ *
+ * Argv is passed as an explicit array — never via shell — so embedded
+ * quotes, backslashes, newlines, and emoji round-trip without corruption.
+ */
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+const FORCE_KILL_GRACE_MS = 5_000;
+export const defaultSpawn = async ({ command, args, timeoutMs, cwd, }) => {
+    const startedAt = Date.now();
+    return new Promise((resolve, reject) => {
+        let child;
+        try {
+            child = spawn(command, args, {
+                stdio: ["ignore", "pipe", "pipe"],
+                windowsHide: true,
+                cwd,
+                env: process.env,
+                shell: false,
+            });
+        }
+        catch (err) {
+            reject(err instanceof Error ? err : new Error(String(err)));
+            return;
+        }
+        let timedOut = false;
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGTERM");
+            setTimeout(() => {
+                if (child.exitCode === null && child.signalCode === null) {
+                    child.kill("SIGKILL");
+                }
+            }, FORCE_KILL_GRACE_MS).unref();
+        }, timeoutMs);
+        timer.unref();
+        child.stdout?.on("data", (chunk) => stdoutChunks.push(chunk));
+        child.stderr?.on("data", (chunk) => stderrChunks.push(chunk));
+        child.once("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        child.once("close", (code, signal) => {
+            clearTimeout(timer);
+            resolve({
+                stdout: Buffer.concat(stdoutChunks).toString("utf-8"),
+                stderr: Buffer.concat(stderrChunks).toString("utf-8"),
+                exitCode: code,
+                signal: signal ?? null,
+                timedOut,
+                durationMs: Date.now() - startedAt,
+            });
+        });
+    });
+};
+/**
+ * Streaming variant of `defaultSpawn` — returns synchronously with
+ * line-by-line stdout access via `lines` (an AsyncIterable<string>).
+ */
+export const defaultStreamingSpawn = ({ command, args, timeoutMs, cwd, }) => {
+    const startedAt = Date.now();
+    const child = spawn(command, args, {
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: true,
+        cwd,
+        env: process.env,
+        shell: false,
+    });
+    let timedOut = false;
+    const stderrChunks = [];
+    const timer = setTimeout(() => {
+        timedOut = true;
+        child.kill("SIGTERM");
+        setTimeout(() => {
+            if (child.exitCode === null && child.signalCode === null) {
+                child.kill("SIGKILL");
+            }
+        }, FORCE_KILL_GRACE_MS).unref();
+    }, timeoutMs);
+    timer.unref();
+    // stdio: ["ignore", "pipe", "pipe"] guarantees child.stdout is non-null
+    const stdout = child.stdout;
+    if (stdout === null) {
+        throw new Error("child.stdout is null despite pipe stdio configuration");
+    }
+    child.stderr?.on("data", (chunk) => stderrChunks.push(chunk));
+    const rl = createInterface({ input: stdout, crlfDelay: Infinity });
+    const exitPromise = new Promise((resolve, reject) => {
+        child.once("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        child.once("close", (code, signal) => {
+            clearTimeout(timer);
+            resolve({
+                exitCode: code,
+                signal: signal ?? null,
+                timedOut,
+                durationMs: Date.now() - startedAt,
+                stderr: Buffer.concat(stderrChunks).toString("utf-8"),
+            });
+        });
+    });
+    return {
+        lines: rl,
+        waitForExit: () => exitPromise,
+    };
+};
+//# sourceMappingURL=spawn.js.map

package/dist/spawn.js.map

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

package/dist/stream-parser.d.ts

@@ -0,0 +1,45 @@
+/**
+ * JSONL parser for Codex CLI's `codex exec --json` output.
+ *
+ * Codex emits JSONL to stdout. Each line is a JSON object with a `type` field.
+ * Based on Codex CLI documentation and expected behavior:
+ *
+ *   - `"session.start"` — first line; carries `session_id` and initial config.
+ *   - `"message"` — user or assistant messages with content.
+ *   - `"function_call"` / `"tool_call"` — tool invocations.
+ *   - `"function_call_output"` / `"tool_call_output"` — tool results.
+ *   - `"session.end"` / `"done"` — final event with summary/usage.
+ *
+ * NOTE: This parser is based on expected Codex JSONL structure. The exact
+ * schema depends on the spike to capture real output. The parser is designed
+ * to be tolerant and handle variations.
+ *
+ * See `specs/adapter-codex-spike-jsonl-capture.md` for spike requirements.
+ */
+import type { CodexParsedResult, StreamParseEvent } from "./types.js";
+/**
+ * Parse Codex JSONL output into an ordered Turn[] plus a result summary.
+ *
+ * Behavior:
+ *   - Pure: same input → same output (modulo the per-call timestamp).
+ *   - Tolerant: malformed lines and lines without a recognized type are
+ *     silently skipped.
+ *   - Returns `null` when neither a session start/ID NOR a result line was
+ *     parsed — the adapter caller maps this to a hard error.
+ *
+ * @param stdout Raw JSONL text (the full captured stdout of `codex exec`).
+ */
+export declare function parseCodexJson(stdout: string): CodexParsedResult | null;
+/**
+ * Incremental async-generator parser for Codex JSONL output.
+ *
+ * Yields `StreamParseEvent` as each line is consumed:
+ *   - `{ type: "meta" }` after the first session-start event sets session + model.
+ *   - `{ type: "turn" }` for each new Turn added (assistant or user messages).
+ *   - `{ type: "result" }` when a session.end / done / result event is encountered.
+ *
+ * Tool output events fill in `ToolCall.output` on previously-yielded Turn
+ * objects via reference sharing — no new event for those.
+ */
+export declare function parseCodexJsonIncremental(lines: AsyncIterable<string>): AsyncGenerator<StreamParseEvent>;
+//# sourceMappingURL=stream-parser.d.ts.map

package/dist/stream-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-parser.d.ts","sourceRoot":"","sources":["../src/stream-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EACX,iBAAiB,EAEjB,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAiZpB;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAiBvE;AAED;;;;;;;;;;GAUG;AACH,wBAAuB,yBAAyB,CAC/C,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAC1B,cAAc,CAAC,gBAAgB,CAAC,CAuClC"}

package/dist/stream-parser.js

@@ -0,0 +1,416 @@
+/**
+ * JSONL parser for Codex CLI's `codex exec --json` output.
+ *
+ * Codex emits JSONL to stdout. Each line is a JSON object with a `type` field.
+ * Based on Codex CLI documentation and expected behavior:
+ *
+ *   - `"session.start"` — first line; carries `session_id` and initial config.
+ *   - `"message"` — user or assistant messages with content.
+ *   - `"function_call"` / `"tool_call"` — tool invocations.
+ *   - `"function_call_output"` / `"tool_call_output"` — tool results.
+ *   - `"session.end"` / `"done"` — final event with summary/usage.
+ *
+ * NOTE: This parser is based on expected Codex JSONL structure. The exact
+ * schema depends on the spike to capture real output. The parser is designed
+ * to be tolerant and handle variations.
+ *
+ * See `specs/adapter-codex-spike-jsonl-capture.md` for spike requirements.
+ */
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function safeNumber(v, fallback = 0) {
+    return typeof v === "number" && Number.isFinite(v) ? v : fallback;
+}
+function safeString(v, fallback = "") {
+    return typeof v === "string" ? v : fallback;
+}
+function extractTextContent(message) {
+    // Codex may use different content formats
+    const content = message.content;
+    if (typeof content === "string") {
+        return content;
+    }
+    if (Array.isArray(content)) {
+        const texts = [];
+        for (const item of content) {
+            if (isRecord(item) &&
+                item.type === "text" &&
+                typeof item.text === "string") {
+                texts.push(item.text);
+            }
+            else if (typeof item === "string") {
+                texts.push(item);
+            }
+        }
+        return texts.join("\n");
+    }
+    return "";
+}
+function extractToolCalls(message) {
+    const calls = [];
+    // Check for tool_calls array (OpenAI format)
+    const toolCalls = message.tool_calls;
+    if (Array.isArray(toolCalls)) {
+        for (const tc of toolCalls) {
+            if (!isRecord(tc))
+                continue;
+            const fn = isRecord(tc.function) ? tc.function : tc;
+            const name = safeString(fn.name ?? tc.name);
+            if (name === "")
+                continue;
+            let input;
+            const args = fn.arguments ?? fn.input ?? tc.arguments ?? tc.input;
+            if (typeof args === "string") {
+                try {
+                    const parsed = JSON.parse(args);
+                    input = isRecord(parsed) ? parsed : { raw: args };
+                }
+                catch {
+                    input = { raw: args };
+                }
+            }
+            else if (isRecord(args)) {
+                input = args;
+            }
+            else {
+                input = {};
+            }
+            calls.push({
+                tool: name,
+                input,
+                output: null,
+                durationMs: null,
+                exitCode: null,
+            });
+        }
+    }
+    // Also check for function_call (older format)
+    const functionCall = message.function_call;
+    if (isRecord(functionCall) && typeof functionCall.name === "string") {
+        let input;
+        const args = functionCall.arguments;
+        if (typeof args === "string") {
+            try {
+                const parsed = JSON.parse(args);
+                input = isRecord(parsed) ? parsed : { raw: args };
+            }
+            catch {
+                input = { raw: args };
+            }
+        }
+        else if (isRecord(args)) {
+            input = args;
+        }
+        else {
+            input = {};
+        }
+        calls.push({
+            tool: functionCall.name,
+            input,
+            output: null,
+            durationMs: null,
+            exitCode: null,
+        });
+    }
+    return calls;
+}
+function extractToolCallIds(message) {
+    const ids = [];
+    const toolCalls = message.tool_calls;
+    if (Array.isArray(toolCalls)) {
+        for (const tc of toolCalls) {
+            if (isRecord(tc) && typeof tc.id === "string") {
+                ids.push(tc.id);
+            }
+        }
+    }
+    return ids;
+}
+function processSessionStart(parsed, state) {
+    // Look for session_id in various places Codex might put it
+    const sessionId = safeString(parsed.session_id) ||
+        safeString(parsed.sessionId) ||
+        safeString(parsed.id);
+    if (sessionId !== "") {
+        state.sessionId = sessionId;
+    }
+    const model = safeString(parsed.model);
+    if (model !== "") {
+        state.model = model;
+    }
+}
+function processMessage(parsed, state) {
+    const role = safeString(parsed.role);
+    const message = isRecord(parsed.message)
+        ? parsed.message
+        : isRecord(parsed.content)
+            ? { content: parsed.content }
+            : parsed;
+    // Determine the actual role
+    let turnRole;
+    if (role === "user" || parsed.type === "user") {
+        turnRole = "user";
+    }
+    else if (role === "assistant" || parsed.type === "assistant") {
+        turnRole = "assistant";
+    }
+    else if (role === "system" || parsed.type === "system") {
+        turnRole = "system";
+    }
+    else {
+        // Default to assistant for messages without explicit role
+        turnRole = "assistant";
+    }
+    const textContent = extractTextContent(message);
+    const toolCalls = turnRole === "assistant" ? extractToolCalls(message) : [];
+    // Skip empty turns
+    if (textContent === "" && toolCalls.length === 0) {
+        return;
+    }
+    const turn = {
+        index: state.turnIndex++,
+        role: turnRole,
+        content: textContent,
+        timestamp: state.now,
+        toolCalls: toolCalls.length > 0 ? toolCalls : null,
+        tokens: null,
+        hash: null,
+    };
+    state.turns.push(turn);
+    // Register tool call IDs for later matching with outputs
+    if (turnRole === "assistant") {
+        const ids = extractToolCallIds(message);
+        for (let i = 0; i < ids.length; i++) {
+            const id = ids[i];
+            const call = toolCalls[i];
+            if (id !== undefined && call !== undefined) {
+                state.pendingToolCalls.set(id, call);
+            }
+        }
+    }
+}
+function processToolOutput(parsed, state) {
+    const toolCallId = safeString(parsed.tool_call_id ?? parsed.function_call_id ?? parsed.id);
+    const output = safeString(parsed.output ?? parsed.content ?? parsed.result);
+    if (toolCallId !== "") {
+        const target = state.pendingToolCalls.get(toolCallId);
+        if (target !== undefined) {
+            target.output = output;
+            state.pendingToolCalls.delete(toolCallId);
+        }
+    }
+}
+function processResult(parsed, state) {
+    state.resultLine = parsed;
+    // Extract session_id from result if not already set
+    const sessionId = safeString(parsed.session_id) || safeString(parsed.sessionId);
+    if (sessionId !== "" && state.sessionId === "") {
+        state.sessionId = sessionId;
+    }
+    // Extract model from result if not already set
+    const model = safeString(parsed.model);
+    if (model !== "" && state.model === "") {
+        state.model = model;
+    }
+}
+function processLine(line, state) {
+    const trimmed = line.trim();
+    if (trimmed === "")
+        return;
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return;
+    }
+    if (!isRecord(parsed))
+        return;
+    const type = safeString(parsed.type);
+    // Session start events
+    if (type === "session.start" ||
+        type === "session_start" ||
+        type === "init" ||
+        type === "system") {
+        processSessionStart(parsed, state);
+        return;
+    }
+    // Message events
+    if (type === "message" || type === "user" || type === "assistant") {
+        processMessage(parsed, state);
+        return;
+    }
+    // Tool call output events
+    if (type === "function_call_output" ||
+        type === "tool_call_output" ||
+        type === "tool_output" ||
+        type === "tool_result") {
+        processToolOutput(parsed, state);
+        return;
+    }
+    // Result/done events
+    if (type === "session.end" ||
+        type === "session_end" ||
+        type === "done" ||
+        type === "result" ||
+        type === "complete") {
+        processResult(parsed, state);
+        return;
+    }
+    // If it has a role field, treat as a message
+    if (parsed.role !== undefined) {
+        processMessage(parsed, state);
+    }
+}
+function extractLastAssistantContent(turns) {
+    for (let i = turns.length - 1; i >= 0; i--) {
+        const turn = turns[i];
+        if (turn !== undefined &&
+            turn.role === "assistant" &&
+            turn.content !== "") {
+            return turn.content;
+        }
+    }
+    return "";
+}
+function coerceSubtype(raw) {
+    if (raw === "success" || raw === "error" || raw === "incomplete") {
+        return raw;
+    }
+    // Map Codex-specific subtypes
+    if (raw === "completed" || raw === "done" || raw === "end_turn") {
+        return "success";
+    }
+    if (raw === "error_max_turns" ||
+        raw === "error_budget" ||
+        (typeof raw === "string" && raw.startsWith("error"))) {
+        return "error";
+    }
+    return "incomplete";
+}
+function assembleResult(state) {
+    // If we have no result line but have a session ID, return an incomplete result
+    if (state.resultLine === null) {
+        if (state.sessionId === "")
+            return null;
+        return {
+            type: "result",
+            subtype: "incomplete",
+            result: extractLastAssistantContent(state.turns),
+            sessionId: state.sessionId,
+            numTurns: state.turns.length,
+            durationMs: 0,
+            model: state.model,
+            stopReason: "incomplete_no_result_line",
+            usage: {
+                inputTokens: 0,
+                outputTokens: 0,
+            },
+            turns: state.turns,
+        };
+    }
+    const subtype = state.resultLine.subtype ?? state.resultLine.status;
+    const sessionIdFromResult = safeString(state.resultLine.session_id) ||
+        safeString(state.resultLine.sessionId) ||
+        state.sessionId;
+    // Extract usage - check various field names Codex might use
+    const usage = isRecord(state.resultLine.usage)
+        ? state.resultLine.usage
+        : state.resultLine;
+    const inputTokens = safeNumber(usage.input_tokens ?? usage.inputTokens ?? usage.prompt_tokens);
+    const outputTokens = safeNumber(usage.output_tokens ?? usage.outputTokens ?? usage.completion_tokens);
+    return {
+        type: safeString(state.resultLine.type, "result"),
+        subtype: coerceSubtype(subtype),
+        result: typeof state.resultLine.result === "string"
+            ? state.resultLine.result
+            : extractLastAssistantContent(state.turns),
+        sessionId: sessionIdFromResult,
+        numTurns: state.turns.length,
+        durationMs: safeNumber(state.resultLine.duration_ms ?? state.resultLine.durationMs),
+        model: state.model,
+        stopReason: safeString(state.resultLine.stop_reason ??
+            state.resultLine.stopReason ??
+            state.resultLine.finish_reason),
+        usage: {
+            inputTokens,
+            outputTokens,
+        },
+        turns: state.turns,
+    };
+}
+/**
+ * Parse Codex JSONL output into an ordered Turn[] plus a result summary.
+ *
+ * Behavior:
+ *   - Pure: same input → same output (modulo the per-call timestamp).
+ *   - Tolerant: malformed lines and lines without a recognized type are
+ *     silently skipped.
+ *   - Returns `null` when neither a session start/ID NOR a result line was
+ *     parsed — the adapter caller maps this to a hard error.
+ *
+ * @param stdout Raw JSONL text (the full captured stdout of `codex exec`).
+ */
+export function parseCodexJson(stdout) {
+    const lines = stdout.split("\n");
+    const state = {
+        turns: [],
+        pendingToolCalls: new Map(),
+        resultLine: null,
+        model: "",
+        sessionId: "",
+        turnIndex: 0,
+        now: new Date().toISOString(),
+    };
+    for (const line of lines) {
+        processLine(line, state);
+    }
+    return assembleResult(state);
+}
+/**
+ * Incremental async-generator parser for Codex JSONL output.
+ *
+ * Yields `StreamParseEvent` as each line is consumed:
+ *   - `{ type: "meta" }` after the first session-start event sets session + model.
+ *   - `{ type: "turn" }` for each new Turn added (assistant or user messages).
+ *   - `{ type: "result" }` when a session.end / done / result event is encountered.
+ *
+ * Tool output events fill in `ToolCall.output` on previously-yielded Turn
+ * objects via reference sharing — no new event for those.
+ */
+export async function* parseCodexJsonIncremental(lines) {
+    const state = {
+        turns: [],
+        pendingToolCalls: new Map(),
+        resultLine: null,
+        model: "",
+        sessionId: "",
+        turnIndex: 0,
+        now: new Date().toISOString(),
+    };
+    let metaYielded = false;
+    for await (const line of lines) {
+        const turnsBefore = state.turns.length;
+        const hadResult = state.resultLine !== null;
+        const hadSession = state.sessionId !== "";
+        processLine(line, state);
+        // Yield meta event once session info is available
+        if (!metaYielded && !hadSession && state.sessionId !== "") {
+            metaYielded = true;
+            yield { type: "meta", sessionId: state.sessionId, model: state.model };
+        }
+        // Yield new turns
+        for (let i = turnsBefore; i < state.turns.length; i++) {
+            const turn = state.turns[i];
+            if (turn !== undefined) {
+                yield { type: "turn", turn };
+            }
+        }
+        // Yield result event
+        if (!hadResult && state.resultLine !== null) {
+            yield { type: "result", resultLine: state.resultLine };
+        }
+    }
+}
+//# sourceMappingURL=stream-parser.js.map

package/dist/stream-parser.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Public types for `@sumeru/adapter-codex`.
+ *
+ * Most of the adapter contract lives in `@sumeru/core` (`Adapter`,
+ * `NativeSessionRef`, `SendEvent`, `SessionConfig`, `Turn`, `ToolCall`,
+ * `TokenUsage`). This module only declares package-local options, the
+ * parser's intermediate shape, and the `child_process.spawn` test seam.
+ */
+import type { Turn } from "@sumeru/core";
+/** Post-exit metadata from a streaming spawn. */
+export type SpawnExitInfo = {
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    timedOut: boolean;
+    durationMs: number;
+    stderr: string;
+};
+/** Return value of `StreamingSpawnFn` — lines + exit promise. */
+export type SpawnStreamResult = {
+    lines: AsyncIterable<string>;
+    waitForExit(): Promise<SpawnExitInfo>;
+};
+/** Streaming spawn test seam — returns synchronously with incremental stdout access. */
+export type StreamingSpawnFn = (args: SpawnArgs) => SpawnStreamResult;
+/** Events yielded by the incremental stream parser. */
+export type StreamParseEvent = {
+    type: "turn";
+    turn: Turn;
+} | {
+    type: "meta";
+    sessionId: string;
+    model: string;
+} | {
+    type: "result";
+    resultLine: Record<string, unknown>;
+};
+/**
+ * Optional configuration for `createCodexAdapter`. Every field accepts
+ * `null` (or absence) to fall through to the defaults — no optional `?:`
+ * properties on this surface.
+ */
+export type CodexAdapterOptions = {
+    /** Path to the `codex` executable. Defaults to `"codex"` (rely on $PATH). */
+    codexBin: string | null;
+    /**
+     * `-m, --model` value passed on every spawn. Defaults to `null`, which means
+     * the adapter does NOT pass `--model` and lets Codex use its default.
+     */
+    model: string | null;
+    /** Working directory for the spawned process (`-C, --cd <DIR>`). Defaults to `process.cwd()`. */
+    cwd: string | null;
+    /** Default 5-minute timeout for `createSession`. */
+    createSessionTimeoutMs: number | null;
+    /** Default 30-minute timeout for `send` (consistent with adapter-claude-code). */
+    sendTimeoutMs: number | null;
+    /**
+     * Test-only override for `child_process.spawn`. Production code never
+     * passes this — the integration tests inject a fake to avoid spawning a
+     * real `codex` binary.
+     */
+    spawnFn: SpawnFn | null;
+    /**
+     * Test-only override for the streaming spawn used in `send()`. Inject a
+     * mock to control line timing in tests without spawning a real process.
+     */
+    streamingSpawnFn: StreamingSpawnFn | null;
+    /**
+     * Whether to pass `--dangerously-bypass-approvals-and-sandbox` to Codex.
+     * Defaults to `true` for unattended Sumeru/uwf runs (parallel to
+     * `--dangerously-skip-permissions` in adapter-claude-code).
+     */
+    dangerouslyBypassApprovals: boolean | null;
+    /**
+     * Whether to pass `--skip-git-repo-check` to Codex. Defaults to `true`
+     * because Sumeru cwds may not always be git repos, and Codex refuses to
+     * run outside a git repo by default.
+     */
+    skipGitRepoCheck: boolean | null;
+};
+/** Argument shape mirroring `child_process.spawn` minus the irrelevant overloads. */
+export type SpawnArgs = {
+    command: string;
+    args: string[];
+    timeoutMs: number;
+    cwd: string;
+};
+/** Result of a spawned `codex` invocation. */
+export type SpawnResult = {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    timedOut: boolean;
+    durationMs: number;
+};
+/** Test seam for `child_process.spawn`. */
+export type SpawnFn = (args: SpawnArgs) => Promise<SpawnResult>;
+/**
+ * Subtype of a parsed Codex result — string-literal union, no widening to
+ * `string`. The `"incomplete"` variant is synthesized by the parser when no
+ * result line was emitted (Codex was killed or its stream truncated).
+ */
+export type CodexResultSubtype = "success" | "error" | "incomplete";
+/**
+ * Intermediate parsed result from Codex's `--json` JSONL output. Unlike the
+ * uwf reference, Sumeru does NOT persist this — the server layer handles ocas
+ * writes. The adapter consumes `turns`, `sessionId`, `subtype`, and `usage`.
+ */
+export type CodexParsedResult = {
+    type: string;
+    subtype: CodexResultSubtype;
+    result: string;
+    sessionId: string;
+    numTurns: number;
+    durationMs: number;
+    model: string;
+    stopReason: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    turns: Turn[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * Public types for `@sumeru/adapter-codex`.
+ *
+ * Most of the adapter contract lives in `@sumeru/core` (`Adapter`,
+ * `NativeSessionRef`, `SendEvent`, `SessionConfig`, `Turn`, `ToolCall`,
+ * `TokenUsage`). This module only declares package-local options, the
+ * parser's intermediate shape, and the `child_process.spawn` test seam.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@sumeru/adapter-codex",
+  "description": "Sumeru adapter for OpenAI Codex CLI",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@sumeru/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test:ci": "npx vitest run"
+  }
+}