@cleocode/adapters 2026.5.3 → 2026.5.5

package/dist/providers/claude-sdk/spawn.js

@@ -1,251 +0,0 @@
-/**
- * Claude SDK Spawn Provider — Vercel AI SDK edition.
- *
- * Implements {@link AdapterSpawnProvider} using the Vercel AI SDK
- * (`ai` v6 + `@ai-sdk/anthropic`) instead of the legacy
- * `@anthropic-ai/claude-agent-sdk`. CLEO retains its own orchestration
- * primitives (`composeSpawnPayload`, playbook runtime, agent registry);
- * the SDK is strictly the LLM bridge.
- *
- * Differences from `ClaudeCodeSpawnProvider`:
- * - Uses `generateText()` via Vercel AI SDK instead of a detached child process
- * - Awaits full completion before returning (synchronous output capture)
- * - Session IDs are generated by CLEO and tracked in `SessionStore`
- * - No temp files, no OS PIDs — tracking is purely in-memory session IDs
- * - `canSpawn()` uses 3-tier key resolution (env var → stored key → Claude Code OAuth)
- *
- * CANT enrichment is identical to the CLI provider: `buildCantEnrichedPrompt()`
- * is called before `generateText()` and the result is passed as the user prompt.
- *
- * @task T581 (original)
- * @task T933 (SDK consolidation — Vercel AI SDK migration)
- * @see T752 — canSpawn() OAuth fix
- * @see ADR-052 — SDK consolidation decision
- */
-import { existsSync, readFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { getErrorMessage } from '@cleocode/contracts';
-import { SessionStore } from './session-store.js';
-import { resolveTools } from './tool-bridge.js';
-// ---------------------------------------------------------------------------
-// Inline 3-tier Anthropic key resolver
-// NOTE: Cannot import from @cleocode/core — circular dependency
-//       (@cleocode/core depends on @cleocode/adapters). This is a deliberate
-//       inline copy of the resolution logic from anthropic-key-resolver.ts.
-//       Keep in sync with packages/core/src/memory/anthropic-key-resolver.ts.
-//       T752 — OAuth fix for canSpawn()
-// ---------------------------------------------------------------------------
-/**
- * Resolve the Anthropic API key using a 3-tier priority chain:
- * 1. `ANTHROPIC_API_KEY` environment variable
- * 2. `~/.local/share/cleo/anthropic-key` (user-stored via cleo config)
- * 3. `~/.claude/.credentials.json` → claudeAiOauth.accessToken (Claude Code OAuth)
- *
- * @returns The key/token string, or null if unavailable.
- */
-function resolveAnthropicApiKey() {
-    // 1. Explicit env var
-    const envKey = process.env.ANTHROPIC_API_KEY;
-    if (envKey?.trim())
-        return envKey;
-    // 2. CLEO global stored key
-    try {
-        const xdg = process.env.XDG_DATA_HOME || join(homedir(), '.local', 'share');
-        const keyFile = join(xdg, 'cleo', 'anthropic-key');
-        if (existsSync(keyFile)) {
-            const stored = readFileSync(keyFile, 'utf-8').trim();
-            if (stored)
-                return stored;
-        }
-    }
-    catch {
-        // Not available — continue
-    }
-    // 3. Claude Code OAuth token (free for Claude Code users)
-    try {
-        const credPath = join(homedir(), '.claude', '.credentials.json');
-        if (!existsSync(credPath))
-            return null;
-        const raw = readFileSync(credPath, 'utf-8');
-        const creds = JSON.parse(raw);
-        const token = creds.claudeAiOauth?.accessToken;
-        if (token?.trim()) {
-            const expiresAt = creds.claudeAiOauth?.expiresAt;
-            if (expiresAt && Date.now() > expiresAt)
-                return null;
-            return token;
-        }
-    }
-    catch {
-        // Credentials file missing or unreadable — not an error
-    }
-    return null;
-}
-/** Model used when no model is specified in spawn options. */
-const DEFAULT_MODEL = 'claude-sonnet-4-5';
-/**
- * Spawn provider that uses the Vercel AI SDK (`ai` v6 + `@ai-sdk/anthropic`)
- * for programmatic subagent execution.
- *
- * Each call to `spawn()` runs a single `generateText()` call to completion and
- * captures the output. Sessions are tracked in `SessionStore` so callers can
- * inspect active sessions via `listRunning()` and remove them via `terminate()`.
- *
- * @remarks
- * Unlike the legacy `@anthropic-ai/claude-agent-sdk`, the Vercel AI SDK is
- * strictly an LLM bridge — it does not manage a Claude Code subprocess or
- * provide built-in MCP server wiring. Tool use is available through the SDK's
- * tool system, but CLEO orchestration (composeSpawnPayload, playbooks, the
- * agent registry) remains the source of truth for scaffolding.
- */
-export class ClaudeSDKSpawnProvider {
-    /** In-memory session registry. */
-    sessions = new SessionStore();
-    /**
-     * Check whether the SDK can be used in the current environment.
-     *
-     * Uses 3-tier key resolution so the provider works with:
-     * - `ANTHROPIC_API_KEY` environment variable (explicit)
-     * - `~/.local/share/cleo/anthropic-key` (user-stored via cleo config)
-     * - Claude Code OAuth token (zero-config for Claude Code users)
-     *
-     * @returns `true` when any Anthropic credential is available
-     */
-    async canSpawn() {
-        return !!resolveAnthropicApiKey();
-    }
-    /**
-     * Spawn a subagent using the Vercel AI SDK.
-     *
-     * Enriches the prompt via CANT context, runs `generateText()` to completion,
-     * and returns a `SpawnResult` with the final output and exit code.
-     *
-     * @param context - Spawn context with taskId, prompt, options
-     * @returns Resolved spawn result (status: 'completed' or 'failed')
-     */
-    async spawn(context) {
-        const instanceId = `sdk-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
-        const sessionId = `cleo-${instanceId}`;
-        const startTime = new Date().toISOString();
-        // Register in session store immediately so listRunning() reflects it
-        // before the async generation starts.
-        this.sessions.add({
-            instanceId,
-            sessionId,
-            taskId: context.taskId,
-            startTime,
-        });
-        try {
-            // CANT enrichment — best-effort, identical to ClaudeCodeSpawnProvider.
-            let enrichedPrompt = context.prompt;
-            try {
-                const { buildCantEnrichedPrompt } = await import('../../cant-context.js');
-                enrichedPrompt = await buildCantEnrichedPrompt({
-                    projectDir: context.workingDirectory ?? process.cwd(),
-                    basePrompt: context.prompt,
-                    agentName: context.options?.agentName ?? undefined,
-                });
-            }
-            catch {
-                // CANT enrichment unavailable — use raw prompt
-            }
-            // Lazy-import the SDK to avoid hard failures when credentials are absent
-            // (canSpawn() guards the normal path, but tests may import this module
-            // without a key).
-            const { createAnthropic } = await import('@ai-sdk/anthropic');
-            const { generateText } = await import('ai');
-            const apiKey = resolveAnthropicApiKey();
-            if (!apiKey) {
-                this.sessions.remove(instanceId);
-                return {
-                    instanceId,
-                    taskId: context.taskId,
-                    providerId: 'claude-sdk',
-                    status: 'failed',
-                    startTime,
-                    endTime: new Date().toISOString(),
-                    exitCode: 1,
-                    error: 'No Anthropic credentials available (env, stored key, or Claude Code OAuth)',
-                };
-            }
-            // Build the Anthropic provider with the resolved key.
-            const anthropicProvider = createAnthropic({ apiKey });
-            // Record the tool allowlist in metadata even though the AI SDK lacks
-            // built-in tool execution for arbitrary Claude Code tools. Downstream
-            // orchestration (composeSpawnPayload) applies allowlists before prompt
-            // composition; this array is surfaced so telemetry remains complete.
-            const toolAllowlist = context.options?.toolAllowlist;
-            const allowedTools = resolveTools(toolAllowlist);
-            const modelId = context.options?.model ?? DEFAULT_MODEL;
-            const result = await generateText({
-                model: anthropicProvider(modelId),
-                prompt: enrichedPrompt,
-                providerOptions: {
-                    anthropic: {
-                        // Preserve allowlist metadata for trace visibility.
-                        cleoAllowedTools: allowedTools,
-                    },
-                },
-            });
-            const endTime = new Date().toISOString();
-            this.sessions.remove(instanceId);
-            const output = (result.text ?? '').trim();
-            return {
-                instanceId,
-                taskId: context.taskId,
-                providerId: 'claude-sdk',
-                status: 'completed',
-                output,
-                exitCode: 0,
-                startTime,
-                endTime,
-            };
-        }
-        catch (error) {
-            const endTime = new Date().toISOString();
-            this.sessions.remove(instanceId);
-            return {
-                instanceId,
-                taskId: context.taskId,
-                providerId: 'claude-sdk',
-                status: 'failed',
-                startTime,
-                endTime,
-                exitCode: 1,
-                error: getErrorMessage(error),
-            };
-        }
-    }
-    /**
-     * List sessions currently tracked as active (spawned but not yet completed).
-     *
-     * Because SDK sessions run to completion inside `spawn()`, this list is
-     * typically empty unless concurrent spawns are in flight.
-     *
-     * @returns Array of in-flight spawn results
-     */
-    async listRunning() {
-        return this.sessions.listActive().map((entry) => ({
-            instanceId: entry.instanceId,
-            taskId: entry.taskId,
-            providerId: 'claude-sdk',
-            status: 'running',
-            startTime: entry.startTime,
-        }));
-    }
-    /**
-     * Remove a session from tracking.
-     *
-     * The underlying `generateText()` call runs inside `spawn()` and cannot be
-     * cancelled externally once the HTTP request is in flight. Removing the
-     * entry from the store prevents it from appearing in `listRunning()` but
-     * does not interrupt the in-progress request.
-     *
-     * @param instanceId - ID of the spawn instance to terminate
-     */
-    async terminate(instanceId) {
-        this.sessions.remove(instanceId);
-    }
-}
-//# sourceMappingURL=spawn.js.map

package/dist/providers/claude-sdk/spawn.js.map

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

package/dist/providers/claude-sdk/tool-bridge.js

@@ -1,50 +0,0 @@
-/**
- * Tool Bridge for Claude SDK Spawn Provider
- *
- * Maps CLEO's tool allowlist (string names) to the SDK's `allowedTools`
- * option format. The SDK accepts plain tool name strings such as
- * `"Read"`, `"Bash"`, `"Edit"` for built-in Claude Code tools and
- * `"mcp__<server>__<tool>"` for MCP-backed tools.
- *
- * @task T581
- */
-/**
- * Default CLEO tool set passed to the SDK when no explicit allowlist
- * is provided in `SpawnContext.options.toolAllowlist`.
- *
- * Mirrors the standard agent tool surface used by the Claude Code CLI
- * `--dangerously-skip-permissions` mode.
- */
-export const DEFAULT_TOOLS = [
-    'Read',
-    'Write',
-    'Edit',
-    'Bash',
-    'Glob',
-    'Grep',
-];
-/**
- * Resolves a CLEO tool allowlist to the SDK `allowedTools` array.
- *
- * When `allowlist` is undefined or empty, the default CLEO tool set is
- * returned. When an explicit list is provided, it is returned as-is so
- * callers can pass MCP tool strings (`mcp__server__tool`) alongside
- * built-in names without transformation.
- *
- * @param allowlist - Optional array of tool names from `SpawnContext.options`
- * @returns Array of SDK-compatible tool name strings
- *
- * @example
- * ```typescript
- * resolveTools(); // ['Read', 'Write', 'Edit', 'Bash', 'Glob', 'Grep']
- * resolveTools(['Read', 'Bash']); // ['Read', 'Bash']
- * resolveTools(['mcp__brain__search']); // ['mcp__brain__search']
- * ```
- */
-export function resolveTools(allowlist) {
-    if (!allowlist || allowlist.length === 0) {
-        return [...DEFAULT_TOOLS];
-    }
-    return [...allowlist];
-}
-//# sourceMappingURL=tool-bridge.js.map

package/dist/providers/claude-sdk/tool-bridge.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-bridge.js","sourceRoot":"","sources":["../../../src/providers/claude-sdk/tool-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC9C,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;CACE,CAAC;AAEX;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY,CAAC,SAAoB;IAC/C,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;AACxB,CAAC"}

package/dist/providers/codex/adapter.js

@@ -1,146 +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,
-        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.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.js

@@ -1,40 +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 { CodexSpawnProvider } from './spawn.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;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,eAAe,YAAY,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,YAAY,EAAE,CAAC;AAC5B,CAAC"}