@bakers-build/addon-codex 0.0.0-stage → 0.1.0-next.38

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 keytec GmbH
+
+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/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# @bakers-build/addon-codex
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+bakers.build agent plugin for the Codex CLI.
+
+Part of the bakers.build CLI. Install the meta package `@bakers-build/bakers` to get the `bakers` CLI with all addons. Source: https://git.key-tec.de/bakers-build/bakers-build (bakers-cli/).

package/dist/src/footprint.d.ts

@@ -0,0 +1,3 @@
+import { type AgentFootprint } from '@bakers-build/conductor/contract';
+/** Parse Codex CLI session JSONL into the agent-neutral bakers.build footprint. */
+export declare function parseCodexTranscript(jsonl: string): AgentFootprint;

package/dist/src/footprint.js

@@ -0,0 +1,61 @@
+import { emptyAgentFootprint, } from '@bakers-build/conductor/contract';
+function countWords(text) {
+    const trimmed = text.trim();
+    return trimmed === '' ? 0 : trimmed.split(/\s+/).length;
+}
+/** Parse Codex CLI session JSONL into the agent-neutral bakers.build footprint. */
+export function parseCodexTranscript(jsonl) {
+    const footprint = emptyAgentFootprint();
+    let minTs = Number.POSITIVE_INFINITY;
+    let maxTs = Number.NEGATIVE_INFINITY;
+    for (const raw of jsonl.split('\n')) {
+        const line = raw.trim();
+        if (line === '')
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (typeof entry.timestamp === 'string') {
+            const timestamp = Date.parse(entry.timestamp);
+            if (Number.isFinite(timestamp)) {
+                minTs = Math.min(minTs, timestamp);
+                maxTs = Math.max(maxTs, timestamp);
+            }
+        }
+        const payload = entry.payload;
+        if (!payload || typeof payload !== 'object')
+            continue;
+        if (entry.type === 'turn_context' && typeof payload.model === 'string') {
+            footprint.model = payload.model;
+        }
+        else if (entry.type === 'event_msg' && payload.type === 'token_count') {
+            const total = payload.info?.total_token_usage?.total_tokens;
+            if (typeof total === 'number' && Number.isFinite(total)) {
+                footprint.tokens = total;
+            }
+        }
+        else if (entry.type === 'event_msg' &&
+            payload.type === 'user_message' &&
+            typeof payload.message === 'string') {
+            footprint.user_prompts += 1;
+            footprint.user_prompt_words += countWords(payload.message);
+        }
+        else if (entry.type === 'response_item' &&
+            payload.type === 'message' &&
+            payload.role === 'assistant') {
+            footprint.agent_turns += 1;
+        }
+        else if (entry.type === 'response_item' &&
+            (payload.type === 'function_call' || payload.type === 'custom_tool_call')) {
+            footprint.tool_calls += 1;
+        }
+    }
+    if (Number.isFinite(minTs) && Number.isFinite(maxTs) && maxTs > minTs) {
+        footprint.duration_s = Math.floor((maxTs - minTs) / 1000);
+    }
+    return footprint;
+}

package/dist/src/index.d.ts

@@ -0,0 +1,22 @@
+import { type AgentFootprint, type AgentPlugin, type AgentRunIdentity, type BbAgent } from '@bakers-build/conductor/contract';
+export { parseCodexTranscript } from './footprint.js';
+export interface CodexAgentOptions {
+    model?: string;
+    effort?: string;
+    args?: string[];
+}
+export declare class CodexAgent implements BbAgent {
+    private readonly home;
+    readonly id = "codex";
+    private readonly args;
+    private readonly model;
+    private readonly effort;
+    private readonly overrides;
+    constructor(options?: CodexAgentOptions, home?: string);
+    launchCommand(prompt: string, _run?: AgentRunIdentity): string;
+    getRunLog(worktreePath: string, run?: AgentRunIdentity): Promise<string>;
+    parseFootprint(log: string): AgentFootprint;
+}
+/** Config-facing factory: `codexAgent({ model: 'gpt-5' })`. */
+export declare function codexAgent(options?: CodexAgentOptions): AgentPlugin;
+export default codexAgent;

package/dist/src/index.js

@@ -0,0 +1,137 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { resolveAgentCliOptions, } from '@bakers-build/conductor/contract';
+import { shellQuote } from '@bakers-build/core';
+import { parseCodexTranscript } from './footprint.js';
+export { parseCodexTranscript } from './footprint.js';
+const CODEX_RESERVED = [
+    '--sandbox',
+    '-s',
+    '--dangerously-bypass-approvals-and-sandbox',
+    '--dangerously-bypass-hook-trust',
+];
+const CODEX_KNOWN = [
+    { kind: 'model', flags: ['--model', '-m'], configKeys: ['model'] },
+    { kind: 'effort', flags: [], configKeys: ['model_reasoning_effort'] },
+];
+export class CodexAgent {
+    home;
+    id = 'codex';
+    args;
+    model;
+    effort;
+    overrides;
+    constructor(options = {}, home = homedir()) {
+        this.home = home;
+        const cli = resolveAgentCliOptions(options, CODEX_RESERVED, CODEX_KNOWN);
+        this.args = cli.args;
+        this.model = cli.model;
+        this.effort = cli.effort;
+        this.overrides = cli.overrides;
+    }
+    launchCommand(prompt, _run) {
+        const parts = [
+            'codex',
+            '--sandbox danger-full-access',
+            '--dangerously-bypass-approvals-and-sandbox',
+            '--dangerously-bypass-hook-trust',
+        ];
+        if (this.model !== undefined && !this.overrides.model) {
+            parts.push('--model', shellQuote(this.model));
+        }
+        if (this.effort !== undefined && !this.overrides.effort) {
+            parts.push('-c', shellQuote(`model_reasoning_effort=${JSON.stringify(this.effort)}`));
+        }
+        if (prompt !== '') {
+            parts.push(shellQuote(prompt));
+            parts.push(...this.args.map(shellQuote));
+        }
+        return parts.join(' ');
+    }
+    async getRunLog(worktreePath, run) {
+        const sessionsDir = join(this.home, '.codex', 'sessions');
+        let entries;
+        try {
+            entries = await readdir(sessionsDir, { recursive: true });
+        }
+        catch {
+            return '';
+        }
+        // Codex has no session-id pin (BB-473): the lower bound below is the
+        // only available defence, so a transcript from a PRIOR run left in the
+        // same (reused) worktree can never be selected for THIS run even when it
+        // is the only/newest cwd-matching transcript around.
+        const startedAtMs = run?.startedAt !== undefined ? new Date(run.startedAt).getTime() : null;
+        let latest = null;
+        for (const name of entries) {
+            if (!name.endsWith('.jsonl'))
+                continue;
+            const path = join(sessionsDir, name);
+            try {
+                const [metadata, log] = await Promise.all([
+                    stat(path),
+                    readFile(path, 'utf8'),
+                ]);
+                let matches = false;
+                // The session's own start, per the `session_meta` line's `timestamp`
+                // field — preferred over the file's mtime (BB-473 finding 3), since
+                // a still-open or appended-to session's mtime keeps advancing past
+                // its own start and would otherwise survive the lower-bound filter.
+                // Falls back to the file mtime when the line carries no timestamp.
+                let sessionStartMs = null;
+                for (const raw of log.split('\n')) {
+                    try {
+                        const entry = JSON.parse(raw);
+                        if (entry.type === 'session_meta') {
+                            matches = entry.payload?.cwd === worktreePath;
+                            if (typeof entry.timestamp === 'string') {
+                                const ts = Date.parse(entry.timestamp);
+                                if (Number.isFinite(ts)) {
+                                    sessionStartMs = ts;
+                                }
+                            }
+                            break;
+                        }
+                    }
+                    catch {
+                        // malformed line — skip.
+                    }
+                }
+                const comparisonMs = sessionStartMs ?? metadata.mtimeMs;
+                if (startedAtMs !== null &&
+                    Number.isFinite(startedAtMs) &&
+                    comparisonMs < startedAtMs) {
+                    continue;
+                }
+                if (matches && (!latest || metadata.mtimeMs > latest.mtimeMs)) {
+                    latest = { log, mtimeMs: metadata.mtimeMs };
+                }
+            }
+            catch {
+                // A session may disappear or be unreadable while Codex rotates logs.
+            }
+        }
+        return latest?.log ?? '';
+    }
+    parseFootprint(log) {
+        return parseCodexTranscript(log);
+    }
+}
+/** Config-facing factory: `codexAgent({ model: 'gpt-5' })`. */
+export function codexAgent(options = {}) {
+    const agent = new CodexAgent(options);
+    return {
+        kind: 'agent',
+        id: 'codex',
+        requiredModules: [],
+        async createAgent() {
+            return agent;
+        },
+    };
+}
+// Default export: this module also exports the `CodexAgent` class, so the
+// config resolver's auto-pick (no `export:`) sees 2 function exports and
+// would otherwise throw "specify export" — see conductor/src/config.ts
+// `loadNamedPlugin`. The default export makes the factory win.
+export default codexAgent;

package/dist/src/preset.d.ts

@@ -0,0 +1,4 @@
+import type { Preset } from '@bakers-build/conductor/contract';
+import { type CodexAgentOptions } from './index.js';
+export declare const agents: Preset<Partial<CodexAgentOptions> | undefined>['agents'];
+export declare const scopes: Preset['scopes'];

package/dist/src/preset.js

@@ -0,0 +1,45 @@
+import codexAgent from './index.js';
+export const agents = (acc, opts) => {
+    const model = opts?.model;
+    const candidates = [
+        ...acc,
+        {
+            alias: 'codex',
+            description: 'Implementation and debugging with the locally configured Codex model.',
+            ...(model !== undefined ? { model } : {}),
+            agent: codexAgent(opts),
+        },
+    ];
+    if (model !== undefined)
+        return candidates;
+    return [
+        ...candidates,
+        ...[
+            {
+                alias: 'astra',
+                model: 'gpt-6-astra',
+                description: 'Strong reasoning for complex design, difficult debugging and demanding implementation.',
+            },
+            {
+                alias: 'sol',
+                model: 'gpt-5.6-sol',
+                description: 'Reliable implementation and routine maintenance from a clear plan.',
+            },
+            {
+                alias: 'terra',
+                model: 'gpt-5.6-terra',
+                description: 'Balanced reasoning and implementation for everyday coding work.',
+            },
+            {
+                alias: 'luna',
+                model: 'gpt-5.6-luna',
+                description: 'Fast, economical implementation of small, well-specified changes.',
+            },
+        ].map((variant) => ({
+            ...variant,
+            agent: codexAgent({ ...opts, model: variant.model }),
+        })),
+    ];
+};
+// Agents are per machine: list this addon in ~/.bakers/machine.config.js addons[].
+export const scopes = ['machine'];

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "@bakers-build/addon-codex",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-next.38",
+  "description": "bakers.build agent plugin for the Codex CLI.",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    ".": "./dist/src/index.js",
+    "./preset": "./dist/src/preset.js"
+  },
+  "files": [
+    "dist/src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://git.key-tec.de/bakers-build/bakers-build.git",
+    "directory": "bakers-cli/addons/codex"
+  },
+  "peerDependencies": {
+    "@bakers-build/conductor": "^0.1.0-next.38",
+    "@bakers-build/core": "^0.1.0-next.38"
+  }
+}