@gaia-ai/addon-codex 0.6.1

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

@@ -0,0 +1,5 @@
+# @gaia-ai/addon-codex
+
+GAIA agent plugin for the Codex CLI.
+
+Part of the GAIA CLI. Install the meta package `@gaia-ai/gaia` to get the `gaia` CLI with all addons. Source: https://git.key-tec.de/keytec/gaia (gaia-cli/).

package/dist/src/footprint.d.ts

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

package/dist/src/footprint.js

@@ -0,0 +1,61 @@
+import { emptyAgentFootprint, } from '@gaia-ai/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 GAIA 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,17 @@
+import type { AgentFootprint, AgentPlugin, GaiaAgent } from '@gaia-ai/conductor/contract';
+export { parseCodexTranscript } from './footprint.js';
+export interface CodexAgentOptions {
+    model?: string;
+}
+export declare class CodexAgent implements GaiaAgent {
+    private readonly options;
+    private readonly home;
+    readonly id = "codex";
+    constructor(options: CodexAgentOptions, home?: string);
+    launchCommand(prompt: string): string;
+    getRunLog(worktreePath: string): 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,89 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { shellQuote } from '@gaia-ai/core';
+import { parseCodexTranscript } from './footprint.js';
+export { parseCodexTranscript } from './footprint.js';
+export class CodexAgent {
+    options;
+    home;
+    id = 'codex';
+    constructor(options, home = homedir()) {
+        this.options = options;
+        this.home = home;
+    }
+    launchCommand(prompt) {
+        const parts = [
+            'codex',
+            '--sandbox danger-full-access',
+            '--dangerously-bypass-approvals-and-sandbox',
+            '--dangerously-bypass-hook-trust',
+        ];
+        if (this.options.model) {
+            parts.push('--model', this.options.model);
+        }
+        if (prompt !== '') {
+            parts.push(shellQuote(prompt));
+        }
+        return parts.join(' ');
+    }
+    async getRunLog(worktreePath) {
+        const sessionsDir = join(this.home, '.codex', 'sessions');
+        let entries;
+        try {
+            entries = await readdir(sessionsDir, { recursive: true });
+        }
+        catch {
+            return '';
+        }
+        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'),
+                ]);
+                const matches = log.split('\n').some((raw) => {
+                    try {
+                        const entry = JSON.parse(raw);
+                        return (entry.type === 'session_meta' &&
+                            entry.payload?.cwd === worktreePath);
+                    }
+                    catch {
+                        return false;
+                    }
+                });
+                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,2 @@
+import type { Preset } from '@gaia-ai/conductor/contract';
+export declare const agents: Preset['agents'];

package/dist/src/preset.js

@@ -0,0 +1,5 @@
+import codexAgent from './index.js';
+export const agents = (acc, opts) => [
+    ...acc,
+    { agent: codexAgent(opts) },
+];

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@gaia-ai/addon-codex",
+  "version": "0.6.1",
+  "description": "GAIA 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/keytec/gaia.git",
+    "directory": "gaia-cli/addons/codex"
+  },
+  "peerDependencies": {
+    "@gaia-ai/conductor": "^0.6.1",
+    "@gaia-ai/core": "^0.6.1"
+  }
+}