@cleocode/adapters 2026.4.11 → 2026.4.12

package/dist/providers/claude-code/transport.d.ts

@@ -1,25 +0,0 @@
-/**
- * Transport provider for the Claude Code adapter.
- *
- * Implements AdapterTransportProvider to supply Claude Code's
- * native inter-agent transport mechanism.
- *
- * @task T5240
- */
-import type { AdapterTransportProvider } from '@cleocode/contracts';
-/**
- * Transport provider for Claude Code inter-agent communication.
- *
- * @remarks
- * Currently returns null from {@link createTransport} because actual transport
- * creation is handled by the signaldock factory which checks for this adapter's
- * transport capability flag. Full wiring will be completed in Phase 5 of the
- * adapter system rollout.
- */
-export declare class ClaudeCodeTransportProvider implements AdapterTransportProvider {
-    /** Provider-specific transport name used for capability negotiation. */
-    readonly transportName = "claude-code";
-    /** Create a transport instance for inter-agent messaging. */
-    createTransport(): unknown;
-}
-//# sourceMappingURL=transport.d.ts.map

package/dist/providers/claude-code/transport.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE;;;;;;;;GAQG;AACH,qBAAa,2BAA4B,YAAW,wBAAwB;IAC1E,wEAAwE;IACxE,QAAQ,CAAC,aAAa,iBAAiB;IAEvC,6DAA6D;IAC7D,eAAe,IAAI,OAAO;CAM3B"}

package/dist/providers/claude-code/transport.js

@@ -1,29 +0,0 @@
-/**
- * Transport provider for the Claude Code adapter.
- *
- * Implements AdapterTransportProvider to supply Claude Code's
- * native inter-agent transport mechanism.
- *
- * @task T5240
- */
-/**
- * Transport provider for Claude Code inter-agent communication.
- *
- * @remarks
- * Currently returns null from {@link createTransport} because actual transport
- * creation is handled by the signaldock factory which checks for this adapter's
- * transport capability flag. Full wiring will be completed in Phase 5 of the
- * adapter system rollout.
- */
-export class ClaudeCodeTransportProvider {
-    /** Provider-specific transport name used for capability negotiation. */
-    transportName = 'claude-code';
-    /** Create a transport instance for inter-agent messaging. */
-    createTransport() {
-        // Returns null — actual transport creation is handled by the signaldock factory
-        // which checks for this adapter's transport capability.
-        // Full wiring will be completed in Phase 5.
-        return null;
-    }
-}
-//# sourceMappingURL=transport.js.map

package/dist/providers/claude-code/transport.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/providers/claude-code/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;GAQG;AACH,MAAM,OAAO,2BAA2B;IACtC,wEAAwE;IAC/D,aAAa,GAAG,aAAa,CAAC;IAEvC,6DAA6D;IAC7D,eAAe;QACb,gFAAgF;QAChF,wDAAwD;QACxD,4CAA4C;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

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

@@ -1,83 +0,0 @@
-/**
- * Codex CLI Adapter
- *
- * Main CLEOProviderAdapter implementation for OpenAI Codex CLI.
- * Provides hooks and install capabilities for CLEO integration.
- *
- * @task T162
- * @epic T134
- */
-import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
-import { CodexHookProvider } from './hooks.js';
-import { CodexInstallProvider } from './install.js';
-/**
- * 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: Ensures AGENTS.md references for CLEO instruction files
- *
- * @remarks
- * Codex CLI supports only 3 canonical events (SessionStart, PromptSubmit,
- * ResponseComplete) and has no spawn or transport capabilities. Integration
- * is primarily through instruction files (AGENTS.md).
- *
- * @task T162
- * @epic T134
- */
-export declare class CodexAdapter implements CLEOProviderAdapter {
-    /** Unique provider identifier. */
-    readonly id = "codex";
-    /** Human-readable provider name. */
-    readonly name = "Codex";
-    /** Adapter version string. */
-    readonly version = "1.0.0";
-    /** Declared capabilities for this provider. */
-    capabilities: AdapterCapabilities;
-    /** Hook provider for CAAMP event mapping. */
-    hooks: CodexHookProvider;
-    /** Install provider for managing instruction files. */
-    install: CodexInstallProvider;
-    /** Project directory this adapter was initialized with, or null. */
-    private projectDir;
-    /** Whether {@link initialize} has been called. */
-    private initialized;
-    constructor();
-    /**
-     * Initialize the adapter for a given project directory.
-     *
-     * @param projectDir - Root directory of the project
-     * @task T162
-     */
-    initialize(projectDir: string): Promise<void>;
-    /**
-     * Dispose the adapter and clean up resources.
-     *
-     * Unregisters hooks and releases any tracked state.
-     * @task T162
-     */
-    dispose(): Promise<void>;
-    /**
-     * 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
-     */
-    healthCheck(): Promise<AdapterHealthStatus>;
-    /**
-     * Check whether the adapter has been initialized.
-     * @task T162
-     */
-    isInitialized(): boolean;
-    /**
-     * Get the project directory this adapter was initialized with.
-     * @task T162
-     */
-    getProjectDir(): string | null;
-}
-//# sourceMappingURL=adapter.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIpD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAa,YAAW,mBAAmB;IACtD,kCAAkC;IAClC,QAAQ,CAAC,EAAE,WAAW;IACtB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,WAAW;IACxB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CAY/B;IAEF,6CAA6C;IAC7C,KAAK,EAAE,iBAAiB,CAAC;IACzB,uDAAuD;IACvD,OAAO,EAAE,oBAAoB,CAAC;IAE9B,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAAS;;IAO5B;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;;OAUG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAqCjD;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIxB;;;OAGG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

package/dist/providers/codex/adapter.js

@@ -1,147 +0,0 @@
-/**
- * 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: Ensures AGENTS.md references for CLEO instruction files
- *
- * @remarks
- * Codex CLI supports only 3 canonical events (SessionStart, PromptSubmit,
- * ResponseComplete) and has no spawn or transport capabilities. Integration
- * is primarily through instruction files (AGENTS.md).
- *
- * @task T162
- * @epic T134
- */
-export class CodexAdapter {
-    /** Unique provider identifier. */
-    id = 'codex';
-    /** Human-readable provider name. */
-    name = 'Codex';
-    /** Adapter version string. */
-    version = '1.0.0';
-    /** Declared capabilities for this provider. */
-    capabilities = {
-        supportsHooks: true,
-        supportedHookEvents: ['SessionStart', 'UserPromptSubmit', 'Stop'],
-        supportsSpawn: false,
-        supportsInstall: true,
-        supportsMcp: false,
-        supportsInstructionFiles: false,
-        supportsContextMonitor: false,
-        supportsStatusline: false,
-        supportsProviderPaths: false,
-        supportsTransport: false,
-        supportsTaskSync: false,
-    };
-    /** Hook provider for CAAMP event mapping. */
-    hooks;
-    /** Install provider for managing instruction files. */
-    install;
-    /** Project directory this adapter was initialized with, or null. */
-    projectDir = null;
-    /** Whether {@link initialize} has been called. */
-    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

@@ -1 +0,0 @@
-{"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

@@ -1,91 +0,0 @@
-/**
- * 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.
- *
- * @remarks
- * Codex CLI has a minimal hook surface with only 3 canonical events.
- * Registration state is tracked in-memory because Codex CLI manages
- * hooks through its own configuration system at `~/.codex/`.
- *
- * @task T162
- * @epic T134
- */
-export declare class CodexHookProvider implements AdapterHookProvider {
-    /** Whether hooks have been registered for the current session. */
-    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 JSON/JSONL session file under `~/.codex/`
-     * and returns its turns as 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

@@ -1 +0,0 @@
-{"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;AAY/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,kEAAkE;IAClE,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;CAGrF"}

package/dist/providers/codex/hooks.js

@@ -1,113 +0,0 @@
-/**
- * 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 { homedir } from 'node:os';
-import { join } from 'node:path';
-import { readLatestTranscript } from '../shared/transcript-reader.js';
-/**
- * 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.
- *
- * @remarks
- * Codex CLI has a minimal hook surface with only 3 canonical events.
- * Registration state is tracked in-memory because Codex CLI manages
- * hooks through its own configuration system at `~/.codex/`.
- *
- * @task T162
- * @epic T134
- */
-export class CodexHookProvider {
-    /** Whether hooks have been registered for the current session. */
-    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 JSON/JSONL session file under `~/.codex/`
-     * and returns its turns as 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) {
-        return readLatestTranscript(join(homedir(), '.codex'));
-    }
-}
-//# sourceMappingURL=hooks.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/codex/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;GAEG;AACH,MAAM,eAAe,GAA2B;IAC9C,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,kBAAkB;IAChC,gBAAgB,EAAE,MAAM;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,iBAAiB;IAC5B,kEAAkE;IAC1D,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;;OAMG;IACH,gBAAgB,CAAC,aAAqB;QACpC,OAAO,eAAe,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC;IAChD,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,OAAO,EAAE,GAAG,eAAe,EAAE,CAAC;IAChC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,aAAa,CAAC,UAAkB,EAAE,WAAmB;QACzD,OAAO,oBAAoB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzD,CAAC;CACF"}

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

@@ -1,37 +0,0 @@
-/**
- * @packageDocumentation
- *
- * 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.
- *
- * @remarks
- * This is the primary entry point for dynamic adapter loading.
- * AdapterManager calls this function when it resolves the codex
- * provider via its import-based discovery mechanism.
- *
- * @returns A new {@link CodexAdapter} instance ready for initialization
- *
- * @example
- * ```typescript
- * import { createAdapter } from '@cleocode/adapters/providers/codex';
- *
- * const adapter = createAdapter();
- * await adapter.initialize('/path/to/project');
- * ```
- *
- * @task T162
- */
-export declare function createAdapter(): CodexAdapter;
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAE5C"}

package/dist/providers/codex/index.js

@@ -1,39 +0,0 @@
-/**
- * @packageDocumentation
- *
- * 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.
- *
- * @remarks
- * This is the primary entry point for dynamic adapter loading.
- * AdapterManager calls this function when it resolves the codex
- * provider via its import-based discovery mechanism.
- *
- * @returns A new {@link CodexAdapter} instance ready for initialization
- *
- * @example
- * ```typescript
- * import { createAdapter } from '@cleocode/adapters/providers/codex';
- *
- * const adapter = createAdapter();
- * await adapter.initialize('/path/to/project');
- * ```
- *
- * @task T162
- */
-export function createAdapter() {
-    return new CodexAdapter();
-}
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,YAAY,EAAE,CAAC;AAC5B,CAAC"}

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

@@ -1,65 +0,0 @@
-/**
- * Codex CLI Install Provider
- *
- * Handles CLEO installation into Codex CLI environments:
- * - 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. Ensuring AGENTS.md contains @-references to CLEO instruction files
- *
- * @remarks
- * Installation is idempotent -- running install multiple times on the same
- * project produces the same result. Only AGENTS.md is managed; Codex CLI
- * does not have an MCP or plugin registration mechanism.
- *
- * @task T162
- * @epic T134
- */
-export declare class CodexInstallProvider implements AdapterInstallProvider {
-    /**
-     * Install CLEO into a Codex CLI environment.
-     *
-     * @param options - Installation options including project directory
-     * @returns Result describing what was installed
-     * @task T162
-     */
-    install(options: InstallOptions): Promise<InstallResult>;
-    /**
-     * Uninstall CLEO from the Codex CLI environment.
-     *
-     * 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 CLEO references in AGENTS.md.
-     * @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>;
-    /**
-     * 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

@@ -1 +0,0 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,YAAW,sBAAsB;IACjE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAqB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CA4B9B"}