@fixy/codex-adapter 0.0.2 → 0.0.3

package/.omc/state/last-tool-error.json

@@ -0,0 +1,7 @@
+{
+  "tool_name": "Bash",
+  "tool_input_preview": "{\"command\":\"pnpm tsc --noEmit 2>&1\",\"description\":\"Typecheck codex-adapter directly\"}",
+  "error": "Exit code 2\nsrc/index.ts(51,14): error TS2591: Cannot find name 'process'. Do you need to install type definitions for node? Try `npm i --save-dev @types/node` and then add 'node' to the types field in your tsconfig.\n[rerun: b14]",
+  "timestamp": "2026-04-12T11:48:20.179Z",
+  "retry_count": 1
+}

package/dist/index.d.ts

@@ -1,2 +1,4 @@
-export {};
+import type { FixyAdapter } from '@fixy/core';
+export declare function createCodexAdapter(): FixyAdapter;
+export { parseCodexStreamJson } from './parse.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,YAAY,CAAC;AA6LpB,wBAAgB,kBAAkB,IAAI,WAAW,CAEhD;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,172 @@
-export {};
+// packages/codex-adapter/src/index.ts
+import { buildInheritedEnv, redactEnvForLogs, resolveCommand, runChildProcess, } from '@fixy/adapter-utils';
+import { parseCodexStreamJson } from './parse.js';
+// Codex CLI writes skill-loader errors to stderr on startup — suppress them.
+const CODEX_NOISE_RE = /^[0-9TZ:.+-]+ (ERROR|WARN) codex_/;
+function filterCodexNoise(stderr) {
+    return stderr
+        .split('\n')
+        .filter((line) => !CODEX_NOISE_RE.test(line))
+        .join('\n')
+        .trim();
+}
+class CodexAdapter {
+    id = 'codex';
+    name = 'Codex CLI';
+    async probe() {
+        let resolvedCommand;
+        try {
+            resolvedCommand = await resolveCommand('codex');
+        }
+        catch {
+            return {
+                available: false,
+                version: null,
+                authStatus: 'unknown',
+                detail: 'codex CLI not found in PATH',
+            };
+        }
+        try {
+            const result = await runChildProcess({
+                command: resolvedCommand,
+                args: ['--version'],
+                cwd: process.cwd(),
+                env: buildInheritedEnv(),
+                timeoutMs: 10_000,
+            });
+            const version = result.stdout.trim() || null;
+            return {
+                available: true,
+                version,
+                authStatus: 'unknown',
+                detail: null,
+            };
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            return {
+                available: false,
+                version: null,
+                authStatus: 'unknown',
+                detail,
+            };
+        }
+    }
+    async execute(ctx) {
+        const resolvedCommand = await resolveCommand('codex');
+        const env = buildInheritedEnv({});
+        let args;
+        if (ctx.session) {
+            // Resume existing session: codex exec resume <thread_id> --json ...
+            args = [
+                'exec',
+                'resume',
+                ctx.session.sessionId,
+                '--json',
+                '--skip-git-repo-check',
+                '--full-auto',
+                ctx.prompt,
+            ];
+        }
+        else {
+            // New session: codex exec --json --skip-git-repo-check --full-auto <prompt>
+            args = [
+                'exec',
+                '--json',
+                '--skip-git-repo-check',
+                '--full-auto',
+                ctx.prompt,
+            ];
+        }
+        ctx.onMeta({
+            resolvedCommand,
+            args,
+            cwd: ctx.threadContext.worktreePath,
+            env: redactEnvForLogs(env),
+        });
+        // Buffer partial stdout lines so we can parse JSONL events and forward
+        // only the agent text instead of raw JSON to the terminal.
+        let stdoutLineBuffer = '';
+        const forwardJsonLine = (line) => {
+            try {
+                const obj = JSON.parse(line);
+                if (typeof obj === 'object' &&
+                    obj !== null &&
+                    obj['type'] === 'item.completed') {
+                    const item = obj['item'];
+                    if (typeof item === 'object' &&
+                        item !== null &&
+                        item['type'] === 'agent_message') {
+                        const text = item['text'];
+                        if (typeof text === 'string' && text.length > 0) {
+                            ctx.onLog('stdout', text + '\n');
+                        }
+                    }
+                }
+            }
+            catch {
+                // Not JSON — forward as-is (shouldn't happen with --json flag)
+                if (line.length > 0)
+                    ctx.onLog('stdout', line + '\n');
+            }
+        };
+        const result = await runChildProcess({
+            command: resolvedCommand,
+            args,
+            cwd: ctx.threadContext.worktreePath,
+            env,
+            signal: ctx.signal,
+            onLog: (stream, chunk) => {
+                if (stream === 'stderr') {
+                    const filtered = filterCodexNoise(chunk);
+                    if (filtered.length > 0)
+                        ctx.onLog('stderr', filtered);
+                    return;
+                }
+                // stdout: buffer and parse JSONL line-by-line
+                stdoutLineBuffer += chunk;
+                const lines = stdoutLineBuffer.split('\n');
+                stdoutLineBuffer = lines.pop() ?? '';
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (trimmed.length > 0)
+                        forwardJsonLine(trimmed);
+                }
+            },
+            onSpawn: ctx.onSpawn,
+        });
+        // Flush any remaining buffered line
+        if (stdoutLineBuffer.trim().length > 0) {
+            forwardJsonLine(stdoutLineBuffer.trim());
+        }
+        const parsed = parseCodexStreamJson(result.stdout);
+        const warnings = [];
+        const filteredStderr = filterCodexNoise(result.stderr ?? '');
+        if (filteredStderr.length > 0) {
+            warnings.push(filteredStderr);
+        }
+        let errorMessage = null;
+        if (result.exitCode !== 0 && !result.timedOut) {
+            const stderrMsg = filteredStderr;
+            errorMessage =
+                stderrMsg.length > 0
+                    ? `codex exited with code ${result.exitCode}: ${stderrMsg}`
+                    : `codex exited with code ${result.exitCode}`;
+        }
+        return {
+            exitCode: result.exitCode,
+            signal: result.signal,
+            timedOut: result.timedOut,
+            summary: parsed.summary,
+            session: parsed.sessionId ? { sessionId: parsed.sessionId, params: {} } : null,
+            patches: [],
+            warnings,
+            errorMessage,
+        };
+    }
+}
+export function createCodexAdapter() {
+    return new CodexAdapter();
+}
+export { parseCodexStreamJson } from './parse.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/parse.d.ts

@@ -0,0 +1,6 @@
+export interface CodexStreamResult {
+    sessionId: string | null;
+    summary: string;
+}
+export declare function parseCodexStreamJson(stdout: string): CodexStreamResult;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAkBD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CA2CtE"}

package/dist/parse.js

@@ -0,0 +1,56 @@
+function tryParseJson(line) {
+    try {
+        const parsed = JSON.parse(line);
+        if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function asString(value, fallback) {
+    return typeof value === 'string' && value.length > 0 ? value : fallback;
+}
+export function parseCodexStreamJson(stdout) {
+    if (stdout.length === 0) {
+        return { sessionId: null, summary: '' };
+    }
+    let sessionId = null;
+    const agentTexts = [];
+    const lines = stdout.split('\n');
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (line.length === 0)
+            continue;
+        const obj = tryParseJson(line);
+        if (obj === null)
+            continue;
+        const type = obj['type'];
+        if (type === 'thread.started') {
+            // {"type":"thread.started","thread_id":"<uuid>"}
+            const tid = asString(obj['thread_id'], '');
+            if (tid !== '')
+                sessionId = tid;
+        }
+        else if (type === 'item.completed') {
+            // {"type":"item.completed","item":{"id":"...","type":"agent_message","text":"..."}}
+            const item = obj['item'];
+            if (typeof item === 'object' && item !== null && !Array.isArray(item)) {
+                const it = item;
+                if (it['type'] === 'agent_message') {
+                    const text = asString(it['text'], '');
+                    if (text !== '')
+                        agentTexts.push(text);
+                }
+            }
+        }
+    }
+    const summary = agentTexts.join('\n\n').trim();
+    if (summary === '' && sessionId === null) {
+        return { sessionId: null, summary: stdout };
+    }
+    return { sessionId, summary };
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAKA,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5E,OAAO,MAAiC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,QAAgB;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC1C,CAAC;IAED,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEjC,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEhC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,GAAG,KAAK,IAAI;YAAE,SAAS;QAE3B,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;QAEzB,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;YAC9B,iDAAiD;YACjD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3C,IAAI,GAAG,KAAK,EAAE;gBAAE,SAAS,GAAG,GAAG,CAAC;QAClC,CAAC;aAAM,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACrC,oFAAoF;YACpF,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;YACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtE,MAAM,EAAE,GAAG,IAA+B,CAAC;gBAC3C,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,eAAe,EAAE,CAAC;oBACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;oBACtC,IAAI,IAAI,KAAK,EAAE;wBAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAE/C,IAAI,OAAO,KAAK,EAAE,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACzC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fixy/codex-adapter",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,7 +11,11 @@
     }
   },
   "dependencies": {
-    "@fixy/adapter-utils": "0.0.2"
+    "@fixy/core": "0.0.3",
+    "@fixy/adapter-utils": "0.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0"
   },
   "license": "MIT",
   "scripts": {

package/src/index.ts

@@ -1 +1,201 @@
-export {};
+// packages/codex-adapter/src/index.ts
+
+import type {
+  FixyAdapter,
+  FixyProbeResult,
+  FixyExecutionContext,
+  FixyExecutionResult,
+} from '@fixy/core';
+
+import {
+  buildInheritedEnv,
+  redactEnvForLogs,
+  resolveCommand,
+  runChildProcess,
+} from '@fixy/adapter-utils';
+
+import { parseCodexStreamJson } from './parse.js';
+
+// Codex CLI writes skill-loader errors to stderr on startup — suppress them.
+const CODEX_NOISE_RE = /^[0-9TZ:.+-]+ (ERROR|WARN) codex_/;
+
+function filterCodexNoise(stderr: string): string {
+  return stderr
+    .split('\n')
+    .filter((line) => !CODEX_NOISE_RE.test(line))
+    .join('\n')
+    .trim();
+}
+
+class CodexAdapter implements FixyAdapter {
+  readonly id = 'codex';
+  readonly name = 'Codex CLI';
+
+  async probe(): Promise<FixyProbeResult> {
+    let resolvedCommand: string;
+    try {
+      resolvedCommand = await resolveCommand('codex');
+    } catch {
+      return {
+        available: false,
+        version: null,
+        authStatus: 'unknown',
+        detail: 'codex CLI not found in PATH',
+      };
+    }
+
+    try {
+      const result = await runChildProcess({
+        command: resolvedCommand,
+        args: ['--version'],
+        cwd: process.cwd(),
+        env: buildInheritedEnv(),
+        timeoutMs: 10_000,
+      });
+      const version = result.stdout.trim() || null;
+      return {
+        available: true,
+        version,
+        authStatus: 'unknown',
+        detail: null,
+      };
+    } catch (err) {
+      const detail = err instanceof Error ? err.message : String(err);
+      return {
+        available: false,
+        version: null,
+        authStatus: 'unknown',
+        detail,
+      };
+    }
+  }
+
+  async execute(ctx: FixyExecutionContext): Promise<FixyExecutionResult> {
+    const resolvedCommand = await resolveCommand('codex');
+    const env = buildInheritedEnv({});
+
+    let args: string[];
+
+    if (ctx.session) {
+      // Resume existing session: codex exec resume <thread_id> --json ...
+      args = [
+        'exec',
+        'resume',
+        ctx.session.sessionId,
+        '--json',
+        '--skip-git-repo-check',
+        '--full-auto',
+        ctx.prompt,
+      ];
+    } else {
+      // New session: codex exec --json --skip-git-repo-check --full-auto <prompt>
+      args = [
+        'exec',
+        '--json',
+        '--skip-git-repo-check',
+        '--full-auto',
+        ctx.prompt,
+      ];
+    }
+
+    ctx.onMeta({
+      resolvedCommand,
+      args,
+      cwd: ctx.threadContext.worktreePath,
+      env: redactEnvForLogs(env),
+    });
+
+    // Buffer partial stdout lines so we can parse JSONL events and forward
+    // only the agent text instead of raw JSON to the terminal.
+    let stdoutLineBuffer = '';
+
+    const forwardJsonLine = (line: string): void => {
+      try {
+        const obj = JSON.parse(line);
+        if (
+          typeof obj === 'object' &&
+          obj !== null &&
+          obj['type'] === 'item.completed'
+        ) {
+          const item = obj['item'];
+          if (
+            typeof item === 'object' &&
+            item !== null &&
+            item['type'] === 'agent_message'
+          ) {
+            const text = item['text'];
+            if (typeof text === 'string' && text.length > 0) {
+              ctx.onLog('stdout', text + '\n');
+            }
+          }
+        }
+      } catch {
+        // Not JSON — forward as-is (shouldn't happen with --json flag)
+        if (line.length > 0) ctx.onLog('stdout', line + '\n');
+      }
+    };
+
+    const result = await runChildProcess({
+      command: resolvedCommand,
+      args,
+      cwd: ctx.threadContext.worktreePath,
+      env,
+      signal: ctx.signal,
+      onLog: (stream, chunk) => {
+        if (stream === 'stderr') {
+          const filtered = filterCodexNoise(chunk);
+          if (filtered.length > 0) ctx.onLog('stderr', filtered);
+          return;
+        }
+        // stdout: buffer and parse JSONL line-by-line
+        stdoutLineBuffer += chunk;
+        const lines = stdoutLineBuffer.split('\n');
+        stdoutLineBuffer = lines.pop() ?? '';
+        for (const line of lines) {
+          const trimmed = line.trim();
+          if (trimmed.length > 0) forwardJsonLine(trimmed);
+        }
+      },
+      onSpawn: ctx.onSpawn,
+    });
+
+    // Flush any remaining buffered line
+    if (stdoutLineBuffer.trim().length > 0) {
+      forwardJsonLine(stdoutLineBuffer.trim());
+    }
+
+    const parsed = parseCodexStreamJson(result.stdout);
+
+    const warnings: string[] = [];
+    const filteredStderr = filterCodexNoise(result.stderr ?? '');
+    if (filteredStderr.length > 0) {
+      warnings.push(filteredStderr);
+    }
+
+    let errorMessage: string | null = null;
+    if (result.exitCode !== 0 && !result.timedOut) {
+      const stderrMsg = filteredStderr;
+      errorMessage =
+        stderrMsg.length > 0
+          ? `codex exited with code ${result.exitCode}: ${stderrMsg}`
+          : `codex exited with code ${result.exitCode}`;
+    }
+
+    return {
+      exitCode: result.exitCode,
+      signal: result.signal,
+      timedOut: result.timedOut,
+      summary: parsed.summary,
+      session: parsed.sessionId ? { sessionId: parsed.sessionId, params: {} } : null,
+      patches: [],
+      warnings,
+      errorMessage,
+    };
+  }
+}
+
+export function createCodexAdapter(): FixyAdapter {
+  return new CodexAdapter();
+}
+
+export { parseCodexStreamJson } from './parse.js';

package/src/parse.ts

@@ -0,0 +1,65 @@
+export interface CodexStreamResult {
+  sessionId: string | null;
+  summary: string;
+}
+
+function tryParseJson(line: string): Record<string, unknown> | null {
+  try {
+    const parsed = JSON.parse(line);
+    if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+      return parsed as Record<string, unknown>;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+function asString(value: unknown, fallback: string): string {
+  return typeof value === 'string' && value.length > 0 ? value : fallback;
+}
+
+export function parseCodexStreamJson(stdout: string): CodexStreamResult {
+  if (stdout.length === 0) {
+    return { sessionId: null, summary: '' };
+  }
+
+  let sessionId: string | null = null;
+  const agentTexts: string[] = [];
+
+  const lines = stdout.split('\n');
+
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+    if (line.length === 0) continue;
+
+    const obj = tryParseJson(line);
+    if (obj === null) continue;
+
+    const type = obj['type'];
+
+    if (type === 'thread.started') {
+      // {"type":"thread.started","thread_id":"<uuid>"}
+      const tid = asString(obj['thread_id'], '');
+      if (tid !== '') sessionId = tid;
+    } else if (type === 'item.completed') {
+      // {"type":"item.completed","item":{"id":"...","type":"agent_message","text":"..."}}
+      const item = obj['item'];
+      if (typeof item === 'object' && item !== null && !Array.isArray(item)) {
+        const it = item as Record<string, unknown>;
+        if (it['type'] === 'agent_message') {
+          const text = asString(it['text'], '');
+          if (text !== '') agentTexts.push(text);
+        }
+      }
+    }
+  }
+
+  const summary = agentTexts.join('\n\n').trim();
+
+  if (summary === '' && sessionId === null) {
+    return { sessionId: null, summary: stdout };
+  }
+
+  return { sessionId, summary };
+}

package/tsconfig.json

@@ -2,7 +2,8 @@
   "extends": "../../tsconfig.base.json",
   "compilerOptions": {
     "outDir": "dist",
-    "rootDir": "src"
+    "rootDir": "src",
+    "types": ["node"]
   },
   "include": ["src"]
 }