@cleocode/adapters 2026.3.72 → 2026.3.74

package/dist/providers/codex/adapter.js

@@ -0,0 +1,134 @@
+/**
+ * Codex CLI Adapter
+ *
+ * Main CLEOProviderAdapter implementation for OpenAI Codex CLI.
+ * Provides hooks and install capabilities for CLEO integration.
+ *
+ * @task T162
+ * @epic T134
+ */
+import { exec } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+import { CodexHookProvider } from './hooks.js';
+import { CodexInstallProvider } from './install.js';
+const execAsync = promisify(exec);
+/**
+ * CLEO provider adapter for OpenAI Codex CLI.
+ *
+ * Bridges CLEO's adapter system with Codex CLI's native capabilities:
+ * - Hooks: Maps Codex events (SessionStart, PromptSubmit, ResponseComplete) to CAAMP events
+ * - Install: Registers MCP server in ~/.codex/config.json and ensures AGENTS.md references
+ *
+ * @task T162
+ * @epic T134
+ */
+export class CodexAdapter {
+    id = 'codex';
+    name = 'Codex';
+    version = '1.0.0';
+    capabilities = {
+        supportsHooks: true,
+        supportedHookEvents: ['SessionStart', 'UserPromptSubmit', 'Stop'],
+        supportsSpawn: false,
+        supportsInstall: true,
+        supportsMcp: true,
+        supportsInstructionFiles: false,
+        supportsContextMonitor: false,
+        supportsStatusline: false,
+        supportsProviderPaths: false,
+        supportsTransport: false,
+        supportsTaskSync: false,
+    };
+    hooks;
+    install;
+    projectDir = null;
+    initialized = false;
+    constructor() {
+        this.hooks = new CodexHookProvider();
+        this.install = new CodexInstallProvider();
+    }
+    /**
+     * Initialize the adapter for a given project directory.
+     *
+     * @param projectDir - Root directory of the project
+     * @task T162
+     */
+    async initialize(projectDir) {
+        this.projectDir = projectDir;
+        this.initialized = true;
+    }
+    /**
+     * Dispose the adapter and clean up resources.
+     *
+     * Unregisters hooks and releases any tracked state.
+     * @task T162
+     */
+    async dispose() {
+        if (this.hooks.isRegistered()) {
+            await this.hooks.unregisterNativeHooks();
+        }
+        this.initialized = false;
+        this.projectDir = null;
+    }
+    /**
+     * Run a health check to verify Codex CLI is accessible.
+     *
+     * Checks:
+     * 1. Adapter has been initialized
+     * 2. Codex CLI binary is available in PATH
+     * 3. ~/.codex/ configuration directory exists
+     *
+     * @returns Health status with details about each check
+     * @task T162
+     */
+    async healthCheck() {
+        const details = {};
+        if (!this.initialized) {
+            return {
+                healthy: false,
+                provider: this.id,
+                details: { error: 'Adapter not initialized' },
+            };
+        }
+        // Check Codex CLI availability
+        let cliAvailable = false;
+        try {
+            const { stdout } = await execAsync('which codex');
+            cliAvailable = stdout.trim().length > 0;
+            details.cliPath = stdout.trim();
+        }
+        catch {
+            details.cliAvailable = false;
+        }
+        // Check for Codex CLI config directory
+        const codexConfigDir = join(homedir(), '.codex');
+        const configExists = existsSync(codexConfigDir);
+        details.configDirExists = configExists;
+        // Healthy if CLI is available (primary requirement)
+        const healthy = cliAvailable;
+        details.cliAvailable = cliAvailable;
+        return {
+            healthy,
+            provider: this.id,
+            details,
+        };
+    }
+    /**
+     * Check whether the adapter has been initialized.
+     * @task T162
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Get the project directory this adapter was initialized with.
+     * @task T162
+     */
+    getProjectDir() {
+        return this.projectDir;
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/providers/codex/adapter.js.map

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

package/dist/providers/codex/hooks.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Codex CLI Hook Provider
+ *
+ * Maps Codex CLI's native hook events to CAAMP canonical hook events.
+ * Codex CLI supports 3 canonical events through its hook system.
+ *
+ * Codex CLI event mapping:
+ * - SessionStart      -> SessionStart
+ * - PromptSubmit      -> UserPromptSubmit
+ * - ResponseComplete  -> Stop
+ *
+ * @task T162
+ * @epic T134
+ */
+import type { AdapterHookProvider } from '@cleocode/contracts';
+/**
+ * Hook provider for Codex CLI.
+ *
+ * Codex CLI registers hooks via its configuration system at
+ * ~/.codex/. Hook handlers are shell commands or script paths that
+ * execute when the corresponding event fires.
+ *
+ * Since hooks are registered through the config system (managed by
+ * the install provider), registerNativeHooks and unregisterNativeHooks
+ * track registration state without performing filesystem operations.
+ *
+ * @task T162
+ * @epic T134
+ */
+export declare class CodexHookProvider implements AdapterHookProvider {
+    private registered;
+    /**
+     * Map a Codex CLI native event name to a CAAMP hook event name.
+     *
+     * @param providerEvent - Codex CLI event name (e.g. "SessionStart", "PromptSubmit")
+     * @returns CAAMP event name or null if unmapped
+     * @task T162
+     */
+    mapProviderEvent(providerEvent: string): string | null;
+    /**
+     * Register native hooks for a project.
+     *
+     * For Codex CLI, hooks are registered via the config system
+     * (~/.codex/), which is handled by the install provider.
+     * This method marks hooks as registered without performing
+     * filesystem operations.
+     *
+     * @param _projectDir - Project directory (unused; hooks are global)
+     * @task T162
+     */
+    registerNativeHooks(_projectDir: string): Promise<void>;
+    /**
+     * Unregister native hooks.
+     *
+     * For Codex CLI, this is a no-op since hooks are managed through
+     * the config system. Unregistration happens via the install
+     * provider's uninstall method.
+     * @task T162
+     */
+    unregisterNativeHooks(): Promise<void>;
+    /**
+     * Check whether hooks have been registered via registerNativeHooks.
+     * @task T162
+     */
+    isRegistered(): boolean;
+    /**
+     * Get the full event mapping for introspection/debugging.
+     * @task T162
+     */
+    getEventMap(): Readonly<Record<string, string>>;
+    /**
+     * Extract a plain-text transcript from Codex CLI session data.
+     *
+     * Reads the most recent session file under ~/.codex/ and extracts
+     * turn text into a flat string for brain observation extraction.
+     *
+     * Returns null when no session data is found or on any read error.
+     *
+     * @param _sessionId - CLEO session ID (unused; reads the most recent file)
+     * @param _projectDir - Project directory (unused; Codex CLI uses global paths)
+     * @task T162 @epic T134
+     */
+    getTranscript(_sessionId: string, _projectDir: string): Promise<string | null>;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/providers/codex/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAW/D;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;OAMG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;OAUG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;;OAGG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAmDrF"}

package/dist/providers/codex/hooks.js

@@ -0,0 +1,155 @@
+/**
+ * Codex CLI Hook Provider
+ *
+ * Maps Codex CLI's native hook events to CAAMP canonical hook events.
+ * Codex CLI supports 3 canonical events through its hook system.
+ *
+ * Codex CLI event mapping:
+ * - SessionStart      -> SessionStart
+ * - PromptSubmit      -> UserPromptSubmit
+ * - ResponseComplete  -> Stop
+ *
+ * @task T162
+ * @epic T134
+ */
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Mapping from Codex CLI native event names to CAAMP canonical event names.
+ */
+const CODEX_EVENT_MAP = {
+    SessionStart: 'SessionStart',
+    PromptSubmit: 'UserPromptSubmit',
+    ResponseComplete: 'Stop',
+};
+/**
+ * Hook provider for Codex CLI.
+ *
+ * Codex CLI registers hooks via its configuration system at
+ * ~/.codex/. Hook handlers are shell commands or script paths that
+ * execute when the corresponding event fires.
+ *
+ * Since hooks are registered through the config system (managed by
+ * the install provider), registerNativeHooks and unregisterNativeHooks
+ * track registration state without performing filesystem operations.
+ *
+ * @task T162
+ * @epic T134
+ */
+export class CodexHookProvider {
+    registered = false;
+    /**
+     * Map a Codex CLI native event name to a CAAMP hook event name.
+     *
+     * @param providerEvent - Codex CLI event name (e.g. "SessionStart", "PromptSubmit")
+     * @returns CAAMP event name or null if unmapped
+     * @task T162
+     */
+    mapProviderEvent(providerEvent) {
+        return CODEX_EVENT_MAP[providerEvent] ?? null;
+    }
+    /**
+     * Register native hooks for a project.
+     *
+     * For Codex CLI, hooks are registered via the config system
+     * (~/.codex/), which is handled by the install provider.
+     * This method marks hooks as registered without performing
+     * filesystem operations.
+     *
+     * @param _projectDir - Project directory (unused; hooks are global)
+     * @task T162
+     */
+    async registerNativeHooks(_projectDir) {
+        this.registered = true;
+    }
+    /**
+     * Unregister native hooks.
+     *
+     * For Codex CLI, this is a no-op since hooks are managed through
+     * the config system. Unregistration happens via the install
+     * provider's uninstall method.
+     * @task T162
+     */
+    async unregisterNativeHooks() {
+        this.registered = false;
+    }
+    /**
+     * Check whether hooks have been registered via registerNativeHooks.
+     * @task T162
+     */
+    isRegistered() {
+        return this.registered;
+    }
+    /**
+     * Get the full event mapping for introspection/debugging.
+     * @task T162
+     */
+    getEventMap() {
+        return { ...CODEX_EVENT_MAP };
+    }
+    /**
+     * Extract a plain-text transcript from Codex CLI session data.
+     *
+     * Reads the most recent session file under ~/.codex/ and extracts
+     * turn text into a flat string for brain observation extraction.
+     *
+     * Returns null when no session data is found or on any read error.
+     *
+     * @param _sessionId - CLEO session ID (unused; reads the most recent file)
+     * @param _projectDir - Project directory (unused; Codex CLI uses global paths)
+     * @task T162 @epic T134
+     */
+    async getTranscript(_sessionId, _projectDir) {
+        try {
+            const homeDir = process.env.HOME ?? process.env.USERPROFILE ?? '/root';
+            const codexDir = join(homeDir, '.codex');
+            let allFiles = [];
+            try {
+                const entries = await readdir(codexDir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (!entry.isFile())
+                        continue;
+                    const name = entry.name;
+                    if (name.endsWith('.json') || name.endsWith('.jsonl')) {
+                        allFiles.push(join(codexDir, name));
+                    }
+                }
+            }
+            catch {
+                return null;
+            }
+            if (allFiles.length === 0)
+                return null;
+            // Sort descending by filename (timestamps in filenames sort naturally)
+            allFiles = allFiles.sort((a, b) => b.localeCompare(a));
+            const mostRecent = allFiles[0];
+            if (!mostRecent)
+                return null;
+            const raw = await readFile(mostRecent, 'utf-8');
+            const turns = [];
+            // Support both JSONL (one JSON per line) and JSON array formats
+            const lines = raw.split('\n').filter((l) => l.trim());
+            for (const line of lines) {
+                try {
+                    const entry = JSON.parse(line);
+                    const role = entry.role;
+                    const content = entry.content;
+                    if (role === 'assistant' && typeof content === 'string') {
+                        turns.push(`assistant: ${content}`);
+                    }
+                    else if (role === 'user' && typeof content === 'string') {
+                        turns.push(`user: ${content}`);
+                    }
+                }
+                catch {
+                    // Skip malformed lines
+                }
+            }
+            return turns.length > 0 ? turns.join('\n') : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/providers/codex/hooks.js.map

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

package/dist/providers/codex/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Codex CLI provider adapter.
+ *
+ * CLEO provider adapter for OpenAI Codex CLI.
+ * Default export is the adapter class for dynamic loading by AdapterManager.
+ *
+ * @task T162
+ * @epic T134
+ */
+import { CodexAdapter } from './adapter.js';
+export { CodexAdapter } from './adapter.js';
+export { CodexHookProvider } from './hooks.js';
+export { CodexInstallProvider } from './install.js';
+export default CodexAdapter;
+/**
+ * Factory function for creating adapter instances.
+ * Used by AdapterManager's dynamic import fallback.
+ *
+ * @task T162
+ */
+export declare function createAdapter(): CodexAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/codex/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAe,YAAY,CAAC;AAE5B;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAE5C"}

package/dist/providers/codex/index.js

@@ -0,0 +1,24 @@
+/**
+ * Codex CLI provider adapter.
+ *
+ * CLEO provider adapter for OpenAI Codex CLI.
+ * Default export is the adapter class for dynamic loading by AdapterManager.
+ *
+ * @task T162
+ * @epic T134
+ */
+import { CodexAdapter } from './adapter.js';
+export { CodexAdapter } from './adapter.js';
+export { CodexHookProvider } from './hooks.js';
+export { CodexInstallProvider } from './install.js';
+export default CodexAdapter;
+/**
+ * Factory function for creating adapter instances.
+ * Used by AdapterManager's dynamic import fallback.
+ *
+ * @task T162
+ */
+export function createAdapter() {
+    return new CodexAdapter();
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/codex/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/codex/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAe,YAAY,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,YAAY,EAAE,CAAC;AAC5B,CAAC"}

package/dist/providers/codex/install.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Codex CLI Install Provider
+ *
+ * Handles CLEO installation into Codex CLI environments:
+ * - Registers CLEO MCP server in ~/.codex/config.json
+ * - Ensures AGENTS.md has CLEO @-references
+ *
+ * @task T162
+ * @epic T134
+ */
+import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+/**
+ * Install provider for Codex CLI.
+ *
+ * Manages CLEO's integration with Codex CLI by:
+ * 1. Registering the CLEO MCP server in ~/.codex/config.json
+ * 2. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ *
+ * @task T162
+ * @epic T134
+ */
+export declare class CodexInstallProvider implements AdapterInstallProvider {
+    /**
+     * Install CLEO into a Codex CLI environment.
+     *
+     * @param options - Installation options including project directory and MCP server path
+     * @returns Result describing what was installed
+     * @task T162
+     */
+    install(options: InstallOptions): Promise<InstallResult>;
+    /**
+     * Uninstall CLEO from the Codex CLI environment.
+     *
+     * Removes the MCP server registration from ~/.codex/config.json.
+     * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
+     * @task T162
+     */
+    uninstall(): Promise<void>;
+    /**
+     * Check whether CLEO is installed in the Codex CLI environment.
+     *
+     * Checks for MCP server registered in ~/.codex/config.json.
+     * Returns true if the CLEO MCP server entry is found.
+     * @task T162
+     */
+    isInstalled(): Promise<boolean>;
+    /**
+     * Ensure AGENTS.md contains @-references to CLEO instruction files.
+     *
+     * Creates AGENTS.md if it does not exist. Appends any missing references.
+     *
+     * @param projectDir - Project root directory
+     * @task T162
+     */
+    ensureInstructionReferences(projectDir: string): Promise<void>;
+    /**
+     * Register the CLEO MCP server in ~/.codex/config.json.
+     *
+     * Codex CLI stores its MCP server configuration in ~/.codex/config.json
+     * under the mcpServers key.
+     *
+     * @param mcpServerPath - Absolute path to the MCP server entry point
+     * @returns true if registration was performed or updated
+     */
+    private registerMcpServer;
+    /**
+     * Update AGENTS.md with CLEO @-references.
+     *
+     * @param projectDir - Project root directory
+     * @returns true if the file was created or modified
+     */
+    private updateInstructionFile;
+}
+//# sourceMappingURL=install.d.ts.map

package/dist/providers/codex/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQjG;;;;;;;;;GASG;AACH,qBAAa,oBAAqB,YAAW,sBAAsB;IACjE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA8B9D;;;;;;OAMG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBhC;;;;;;OAMG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CA4B9B"}