@substrate-ai/core 0.19.54

package/dist/adapters/adapter-registry.js

@@ -0,0 +1,101 @@
+/**
+ * AdapterRegistry — central registry for WorkerAdapter instances
+ *
+ * Discovers, health-checks, and stores all available CLI agent adapters.
+ * Unhealthy adapters are reported but do not block system startup.
+ */
+import { ClaudeCodeAdapter } from './claude-adapter.js';
+import { CodexCLIAdapter } from './codex-adapter.js';
+import { GeminiCLIAdapter } from './gemini-adapter.js';
+/**
+ * AdapterRegistry manages the lifecycle of WorkerAdapter instances.
+ *
+ * Usage:
+ * ```typescript
+ * const registry = new AdapterRegistry()
+ * const report = await registry.discoverAndRegister()
+ * const claude = registry.get('claude-code')
+ * ```
+ */
+export class AdapterRegistry {
+    _adapters = new Map();
+    /**
+     * Register an adapter by its id.
+     * Overwrites any existing adapter with the same id.
+     */
+    register(adapter) {
+        this._adapters.set(adapter.id, adapter);
+    }
+    /**
+     * Retrieve a registered adapter by id.
+     * @returns The adapter, or undefined if not registered
+     */
+    get(id) {
+        return this._adapters.get(id);
+    }
+    /**
+     * Return all registered adapters as an array.
+     */
+    getAll() {
+        return Array.from(this._adapters.values());
+    }
+    /**
+     * Return all registered adapters that support plan generation.
+     */
+    getPlanningCapable() {
+        return this.getAll().filter((adapter) => adapter.getCapabilities().supportsPlanGeneration);
+    }
+    /**
+     * Instantiate all built-in adapters, run health checks sequentially,
+     * and register those that pass.
+     *
+     * Failed adapters are included in the report but do NOT prevent startup.
+     *
+     * @returns Discovery report with per-adapter results
+     */
+    async discoverAndRegister() {
+        const builtInAdapters = [
+            new ClaudeCodeAdapter(),
+            new CodexCLIAdapter(),
+            new GeminiCLIAdapter(),
+        ];
+        const results = [];
+        let registeredCount = 0;
+        let failedCount = 0;
+        for (const adapter of builtInAdapters) {
+            let healthResult;
+            try {
+                healthResult = await adapter.healthCheck();
+            }
+            catch (err) {
+                // Catch unexpected errors during health check — adapter should not throw
+                const message = err instanceof Error ? err.message : String(err);
+                healthResult = {
+                    healthy: false,
+                    error: `Unexpected error during health check: ${message}`,
+                    supportsHeadless: false,
+                };
+            }
+            const registered = healthResult.healthy;
+            if (registered) {
+                this.register(adapter);
+                registeredCount++;
+            }
+            else {
+                failedCount++;
+            }
+            results.push({
+                adapterId: adapter.id,
+                displayName: adapter.displayName,
+                healthResult,
+                registered,
+            });
+        }
+        return {
+            registeredCount,
+            failedCount,
+            results,
+        };
+    }
+}
+//# sourceMappingURL=adapter-registry.js.map

package/dist/adapters/adapter-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-registry.js","sourceRoot":"","sources":["../../src/adapters/adapter-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEtD;;;;;;;;;GASG;AACH,MAAM,OAAO,eAAe;IACT,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAA;IAE9D;;;OAGG;IACH,QAAQ,CAAC,OAAsB;QAC7B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IACzC,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,EAAW;QACb,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5C,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CACzB,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,sBAAsB,CAC9D,CAAA;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,mBAAmB;QACvB,MAAM,eAAe,GAAoB;YACvC,IAAI,iBAAiB,EAAE;YACvB,IAAI,eAAe,EAAE;YACrB,IAAI,gBAAgB,EAAE;SACvB,CAAA;QAED,MAAM,OAAO,GAA6B,EAAE,CAAA;QAC5C,IAAI,eAAe,GAAG,CAAC,CAAA;QACvB,IAAI,WAAW,GAAG,CAAC,CAAA;QAEnB,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;YACtC,IAAI,YAAiC,CAAA;YAErC,IAAI,CAAC;gBACH,YAAY,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAA;YAC5C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,yEAAyE;gBACzE,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBAChE,YAAY,GAAG;oBACb,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,yCAAyC,OAAO,EAAE;oBACzD,gBAAgB,EAAE,KAAK;iBACxB,CAAA;YACH,CAAC;YAED,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAA;YACvC,IAAI,UAAU,EAAE,CAAC;gBACf,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;gBACtB,eAAe,EAAE,CAAA;YACnB,CAAC;iBAAM,CAAC;gBACN,WAAW,EAAE,CAAA;YACf,CAAC;YAED,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,YAAY;gBACZ,UAAU;aACX,CAAC,CAAA;QACJ,CAAC;QAED,OAAO;YACL,eAAe;YACf,WAAW;YACX,OAAO;SACR,CAAA;IACH,CAAC;CACF"}

package/dist/adapters/claude-adapter.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Claude Code adapter
+ *
+ * Implements WorkerAdapter for the Claude Code CLI agent.
+ * Binary: `claude`
+ * Output format: JSON via `--output-format json`
+ */
+import type { AgentId } from '../types.js';
+import type { WorkerAdapter } from './worker-adapter.js';
+import type { SpawnCommand, AdapterOptions, AdapterCapabilities, AdapterHealthResult, TaskResult, TokenEstimate, PlanRequest, PlanParseResult } from './types.js';
+import type { ILogger } from '../dispatch/types.js';
+/**
+ * Adapter for the Claude Code CLI agent.
+ *
+ * Capabilities: JSON output, streaming, both billing modes, plan generation.
+ * Health check: runs `claude --version` to verify install.
+ * Billing detection: detects subscription vs API via version output or env.
+ */
+export declare class ClaudeCodeAdapter implements WorkerAdapter {
+    readonly id: AgentId;
+    readonly displayName = "Claude Code";
+    readonly adapterVersion = "1.0.0";
+    private readonly _logger;
+    constructor(logger?: ILogger);
+    /**
+     * Verify the `claude` binary is installed and responsive.
+     * Detects subscription vs API billing mode.
+     */
+    healthCheck(): Promise<AdapterHealthResult>;
+    /**
+     * Build spawn command for a coding task.
+     * Uses: `claude -p --model <model> --dangerously-skip-permissions --system-prompt <minimal>`
+     * Prompt is delivered via stdin (not CLI arg) to avoid E2BIG on large prompts.
+     */
+    buildCommand(prompt: string, options: AdapterOptions): SpawnCommand;
+    /**
+     * Build spawn command for plan generation.
+     */
+    buildPlanningCommand(request: PlanRequest, options: AdapterOptions): SpawnCommand;
+    /**
+     * Parse Claude Code JSON output into a TaskResult.
+     */
+    parseOutput(stdout: string, stderr: string, exitCode: number): TaskResult;
+    /**
+     * Parse Claude plan generation output.
+     */
+    parsePlanOutput(stdout: string, stderr: string, exitCode: number): PlanParseResult;
+    /**
+     * Estimate token count using character-based heuristic.
+     */
+    estimateTokens(prompt: string): TokenEstimate;
+    /**
+     * Return Claude Code capabilities.
+     */
+    getCapabilities(): AdapterCapabilities;
+    private _detectBillingModes;
+    private _buildPlanningPrompt;
+}
+//# sourceMappingURL=claude-adapter.d.ts.map

package/dist/adapters/claude-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/claude-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,WAAW,EACX,eAAe,EAEhB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAkDnD;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAgB;IACpC,QAAQ,CAAC,WAAW,iBAAgB;IACpC,QAAQ,CAAC,cAAc,WAAU;IAEjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,CAAC,EAAE,OAAO;IAK5B;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAgCjD;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,YAAY;IA0FnE;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,GAAG,YAAY;IA8BjF;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU;IAuDzE;;OAEG;IACH,eAAe,CACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,eAAe;IAqDlB;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAU7C;;OAEG;IACH,eAAe,IAAI,mBAAmB;IA6BtC,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,oBAAoB;CAgB7B"}

package/dist/adapters/claude-adapter.js

@@ -0,0 +1,367 @@
+/**
+ * Claude Code adapter
+ *
+ * Implements WorkerAdapter for the Claude Code CLI agent.
+ * Binary: `claude`
+ * Output format: JSON via `--output-format json`
+ */
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+/** Default model used when none is specified */
+const DEFAULT_MODEL = 'claude-sonnet-4-6';
+/** Approximate characters per token for estimation */
+const CHARS_PER_TOKEN = 3;
+/** Estimated output token multiplier relative to input */
+const OUTPUT_RATIO = 0.5;
+/**
+ * Base system prompt for all Claude Code invocations.
+ * Replaces CLAUDE.md and auto-memory context so the subprocess does not
+ * re-read the orchestrator's own CLAUDE.md instructions.
+ */
+const BASE_SYSTEM_PROMPT = `You are an autonomous coding agent implementing software requirements. ` +
+    `Follow the task description precisely, write clean and maintainable code, ` +
+    `and ensure all tests pass. Work methodically through each task in order.`;
+/** Strip markdown code fences from LLM output (e.g. ```json ... ```) */
+function stripCodeFences(raw) {
+    return raw.trim().replace(/^```(?:json)?\s*/i, '').replace(/\s*```\s*$/, '').trim();
+}
+/**
+ * Adapter for the Claude Code CLI agent.
+ *
+ * Capabilities: JSON output, streaming, both billing modes, plan generation.
+ * Health check: runs `claude --version` to verify install.
+ * Billing detection: detects subscription vs API via version output or env.
+ */
+export class ClaudeCodeAdapter {
+    id = 'claude-code';
+    displayName = 'Claude Code';
+    adapterVersion = '1.0.0';
+    _logger;
+    constructor(logger) {
+        // Default to console if no logger is injected
+        this._logger = logger ?? console;
+    }
+    /**
+     * Verify the `claude` binary is installed and responsive.
+     * Detects subscription vs API billing mode.
+     */
+    async healthCheck() {
+        try {
+            const { stdout } = await execAsync('claude --version', { timeout: 10_000 });
+            const output = stdout.trim();
+            const detectedBillingModes = this._detectBillingModes(output);
+            let cliPath;
+            try {
+                const whichResult = await execAsync('which claude', { timeout: 5_000 });
+                cliPath = whichResult.stdout.trim();
+            }
+            catch {
+                // which is available on macOS and Linux (target platforms)
+            }
+            return {
+                healthy: true,
+                version: output,
+                ...(cliPath !== undefined ? { cliPath } : {}),
+                detectedBillingModes,
+                supportsHeadless: true,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                healthy: false,
+                error: `Claude CLI not available: ${message}`,
+                supportsHeadless: false,
+            };
+        }
+    }
+    /**
+     * Build spawn command for a coding task.
+     * Uses: `claude -p --model <model> --dangerously-skip-permissions --system-prompt <minimal>`
+     * Prompt is delivered via stdin (not CLI arg) to avoid E2BIG on large prompts.
+     */
+    buildCommand(prompt, options) {
+        const model = options.model ?? DEFAULT_MODEL;
+        // Do NOT use --output-format json: it wraps Claude's response in a JSON event
+        // envelope (type/result/usage), which prevents extractYamlBlock from finding
+        // the YAML result block in the raw stdout. Raw text output is required.
+        //
+        // --dangerously-skip-permissions: required for headless automated pipeline use.
+        // Without this, Claude in -p mode refuses to write files, asking for permission.
+        //
+        // --system-prompt: replaces CLAUDE.md and auto-memory context so the subprocess
+        // does not re-read the orchestrator's own CLAUDE.md instructions.
+        const args = [
+            '-p',
+            '--model',
+            model,
+            '--dangerously-skip-permissions',
+        ];
+        if (options.maxTurns !== undefined) {
+            args.push('--max-turns', String(options.maxTurns));
+        }
+        if (options.maxContextTokens !== undefined) {
+            args.push('--max-context-tokens', String(options.maxContextTokens));
+        }
+        if (options.additionalFlags && options.additionalFlags.length > 0) {
+            args.push(...options.additionalFlags);
+        }
+        // Build system prompt: base prompt + optional optimization directives
+        const systemPromptParts = [BASE_SYSTEM_PROMPT];
+        if (options.optimizationDirectives) {
+            systemPromptParts.push(`\n\n## Optimization Directives\n${options.optimizationDirectives}`);
+        }
+        args.push('--system-prompt', systemPromptParts.join(''));
+        // Build environment entries
+        const envEntries = {};
+        if (options.billingMode === 'api' && options.apiKey) {
+            envEntries.ANTHROPIC_API_KEY = options.apiKey;
+        }
+        if (options.otlpEndpoint) {
+            envEntries.CLAUDE_CODE_ENABLE_TELEMETRY = '1';
+            envEntries.OTEL_LOGS_EXPORTER = 'otlp';
+            envEntries.OTEL_METRICS_EXPORTER = 'otlp';
+            envEntries.OTEL_LOG_TOOL_DETAILS = '1';
+            envEntries.OTEL_METRIC_EXPORT_INTERVAL = '10000';
+            envEntries.OTEL_EXPORTER_OTLP_TIMEOUT = '5000';
+            envEntries.OTEL_EXPORTER_OTLP_ENDPOINT = options.otlpEndpoint;
+            envEntries.OTEL_EXPORTER_OTLP_PROTOCOL = 'http/json';
+        }
+        if (options.storyKey) {
+            const existing = envEntries.OTEL_RESOURCE_ATTRIBUTES ?? '';
+            const separator = existing.length > 0 ? ',' : '';
+            envEntries.OTEL_RESOURCE_ATTRIBUTES = `${existing}${separator}substrate.story_key=${options.storyKey}`;
+        }
+        if (options.taskType) {
+            const existing = envEntries.OTEL_RESOURCE_ATTRIBUTES ?? '';
+            const separator = existing.length > 0 ? ',' : '';
+            envEntries.OTEL_RESOURCE_ATTRIBUTES = `${existing}${separator}substrate.task_type=${options.taskType}`;
+        }
+        if (options.dispatchId) {
+            const existing = envEntries.OTEL_RESOURCE_ATTRIBUTES ?? '';
+            const separator = existing.length > 0 ? ',' : '';
+            envEntries.OTEL_RESOURCE_ATTRIBUTES = `${existing}${separator}substrate.dispatch_id=${options.dispatchId}`;
+        }
+        // Build unsetEnvKeys: always unset CLAUDECODE; also unset ANTHROPIC_API_KEY
+        // when not in API billing mode to prevent accidental credential leaks.
+        const unsetEnvKeys = ['CLAUDECODE'];
+        if (options.billingMode !== 'api') {
+            unsetEnvKeys.push('ANTHROPIC_API_KEY');
+        }
+        return {
+            binary: 'claude',
+            args,
+            env: envEntries,
+            unsetEnvKeys,
+            cwd: options.worktreePath,
+            stdin: prompt,
+        };
+    }
+    /**
+     * Build spawn command for plan generation.
+     */
+    buildPlanningCommand(request, options) {
+        const model = options.model ?? DEFAULT_MODEL;
+        const planningPrompt = this._buildPlanningPrompt(request);
+        // Prompt delivered via stdin (not CLI args) to avoid E2BIG on large prompts.
+        const args = [
+            '-p',
+            '--model',
+            model,
+            '--dangerously-skip-permissions',
+        ];
+        if (options.additionalFlags && options.additionalFlags.length > 0) {
+            args.push(...options.additionalFlags);
+        }
+        const envEntries = {};
+        if (options.billingMode === 'api' && options.apiKey) {
+            envEntries.ANTHROPIC_API_KEY = options.apiKey;
+        }
+        return {
+            binary: 'claude',
+            args,
+            env: envEntries,
+            cwd: options.worktreePath,
+            stdin: planningPrompt,
+        };
+    }
+    /**
+     * Parse Claude Code JSON output into a TaskResult.
+     */
+    parseOutput(stdout, stderr, exitCode) {
+        if (exitCode !== 0) {
+            return {
+                success: false,
+                output: stdout,
+                error: stderr || `Process exited with code ${String(exitCode)}`,
+                exitCode,
+            };
+        }
+        // Guard against empty stdout — treat as non-JSON fallback
+        if (stdout.trim() === '') {
+            return {
+                success: true,
+                output: '',
+                exitCode,
+            };
+        }
+        try {
+            const parsed = JSON.parse(stdout.trim());
+            const success = parsed.status === 'completed' ||
+                parsed.status === 'success' ||
+                (parsed.status === undefined && !parsed.error);
+            const inputTokens = parsed.metadata?.tokensUsed?.input ?? 0;
+            const outputTokens = parsed.metadata?.tokensUsed?.output ?? 0;
+            const hasTokens = inputTokens > 0 || outputTokens > 0;
+            const tokensUsed = hasTokens
+                ? { input: inputTokens, output: outputTokens, total: inputTokens + outputTokens }
+                : undefined;
+            const executionTime = parsed.metadata?.executionTime;
+            return {
+                success: success && !parsed.error,
+                output: parsed.output ?? stdout,
+                ...(parsed.error ? { error: parsed.error } : {}),
+                exitCode,
+                metadata: {
+                    ...(executionTime !== undefined ? { executionTime } : {}),
+                    ...(tokensUsed !== undefined ? { tokensUsed } : {}),
+                },
+            };
+        }
+        catch {
+            return {
+                success: true,
+                output: stdout,
+                exitCode,
+            };
+        }
+    }
+    /**
+     * Parse Claude plan generation output.
+     */
+    parsePlanOutput(stdout, stderr, exitCode) {
+        if (exitCode !== 0) {
+            return {
+                success: false,
+                tasks: [],
+                error: stderr || `Process exited with code ${String(exitCode)}`,
+                rawOutput: stdout,
+            };
+        }
+        if (stdout.trim() === '') {
+            return {
+                success: false,
+                tasks: [],
+                error: 'Empty output from plan generation',
+                rawOutput: stdout,
+            };
+        }
+        try {
+            const parsed = JSON.parse(stripCodeFences(stdout));
+            if (!Array.isArray(parsed.tasks)) {
+                return {
+                    success: false,
+                    tasks: [],
+                    error: 'Plan output missing tasks array',
+                    rawOutput: stdout,
+                };
+            }
+            const tasks = parsed.tasks.map((t) => ({
+                title: t.title ?? 'Untitled task',
+                description: t.description ?? '',
+                ...(t.complexity !== undefined ? { complexity: t.complexity } : {}),
+                ...(t.dependencies !== undefined ? { dependencies: t.dependencies } : {}),
+            }));
+            return {
+                success: true,
+                tasks,
+                rawOutput: stdout,
+            };
+        }
+        catch {
+            return {
+                success: false,
+                tasks: [],
+                error: 'Failed to parse Claude plan output as JSON',
+                rawOutput: stdout,
+            };
+        }
+    }
+    /**
+     * Estimate token count using character-based heuristic.
+     */
+    estimateTokens(prompt) {
+        const input = Math.ceil(prompt.length / CHARS_PER_TOKEN);
+        const output = Math.ceil(input * OUTPUT_RATIO);
+        return {
+            input,
+            output,
+            total: input + output,
+        };
+    }
+    /**
+     * Return Claude Code capabilities.
+     */
+    getCapabilities() {
+        return {
+            supportsJsonOutput: true,
+            supportsStreaming: true,
+            supportsSubscriptionBilling: true,
+            supportsApiBilling: true,
+            supportsPlanGeneration: true,
+            maxContextTokens: 200_000,
+            supportedTaskTypes: [
+                'code',
+                'refactor',
+                'test',
+                'review',
+                'debug',
+                'document',
+                'analyze',
+            ],
+            supportedLanguages: ['*'],
+            supportsSystemPrompt: true,
+            supportsOtlpExport: true,
+            requiresYamlSuffix: false,
+            defaultMaxReviewCycles: 2,
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    _detectBillingModes(versionOutput) {
+        // 1. If ADT_BILLING_MODE is explicitly set, respect it
+        const explicit = process.env.ADT_BILLING_MODE;
+        if (explicit === 'subscription' || explicit === 'api' || explicit === 'free') {
+            return [explicit];
+        }
+        // 2. Detect available billing modes
+        const modes = [];
+        if (process.env.ANTHROPIC_API_KEY) {
+            modes.push('api');
+        }
+        if (versionOutput.toLowerCase().includes('subscription')) {
+            modes.push('subscription');
+        }
+        // Claude supports both modes by default
+        if (modes.length === 0) {
+            return ['subscription', 'api'];
+        }
+        return modes;
+    }
+    _buildPlanningPrompt(request) {
+        const maxTasks = request.maxTasks ?? 10;
+        const contextSection = request.context
+            ? `\n\nAdditional context:\n${request.context}`
+            : '';
+        return (`Generate a detailed task plan for the following goal:\n${request.goal}${contextSection}\n\n` +
+            `Output a JSON object with a "tasks" array. Each task should have: ` +
+            `"title" (string), "description" (string), "complexity" (1-10 integer), ` +
+            `"dependencies" (array of task titles this depends on). ` +
+            `Produce at most ${String(maxTasks)} tasks. ` +
+            `Output ONLY raw valid JSON — no markdown, no code fences, no explanation. ` +
+            `Start your response with { and end with }.`);
+    }
+}
+//# sourceMappingURL=claude-adapter.js.map

package/dist/adapters/claude-adapter.js.map

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

package/dist/adapters/codex-adapter.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Codex CLI adapter
+ *
+ * Implements WorkerAdapter for the OpenAI Codex CLI agent.
+ * Binary: `codex`
+ * Execution: `codex exec --json` with task prompt on stdin
+ * Billing: Subscription (ChatGPT Plus/Pro via `codex login`) or API key
+ */
+import type { AgentId } from '../types.js';
+import type { WorkerAdapter } from './worker-adapter.js';
+import type { SpawnCommand, AdapterOptions, AdapterCapabilities, AdapterHealthResult, TaskResult, TokenEstimate, PlanRequest, PlanParseResult } from './types.js';
+import type { ILogger } from '../dispatch/types.js';
+/**
+ * Adapter for the OpenAI Codex CLI agent.
+ *
+ * Codex CLI uses stdin for the prompt and outputs JSON when --json flag is used.
+ * Codex supports subscription billing (via `codex login`) and API key billing.
+ */
+export declare class CodexCLIAdapter implements WorkerAdapter {
+    readonly id: AgentId;
+    readonly displayName = "Codex CLI";
+    readonly adapterVersion = "1.0.0";
+    private readonly _logger;
+    constructor(logger?: ILogger);
+    /**
+     * Verify the `codex` binary is installed and responsive.
+     */
+    healthCheck(): Promise<AdapterHealthResult>;
+    /**
+     * Build spawn command for a coding task.
+     * Uses: `codex exec` with prompt delivered via stdin.
+     *
+     * Do NOT use --json: it produces a JSONL event stream that prevents
+     * extractYamlBlock from finding the structured result block in stdout.
+     * Raw text output is required (same rationale as Claude adapter).
+     */
+    buildCommand(prompt: string, options: AdapterOptions): SpawnCommand;
+    /**
+     * Build spawn command for plan generation.
+     * Uses codex exec with a JSON plan generation prompt via stdin.
+     */
+    buildPlanningCommand(request: PlanRequest, options: AdapterOptions): SpawnCommand;
+    /**
+     * Parse Codex CLI output into a TaskResult.
+     *
+     * With raw text mode (no --json), stdout is the agent's direct output.
+     * YAML extraction happens in the dispatcher's extractYamlBlock, not here.
+     */
+    parseOutput(stdout: string, stderr: string, exitCode: number): TaskResult;
+    /**
+     * Parse Codex plan generation output.
+     */
+    parsePlanOutput(stdout: string, stderr: string, exitCode: number): PlanParseResult;
+    /**
+     * Estimate token count using character-based heuristic.
+     */
+    estimateTokens(prompt: string): TokenEstimate;
+    /**
+     * Return Codex CLI capabilities.
+     */
+    getCapabilities(): AdapterCapabilities;
+    private _buildPlanningPrompt;
+}
+//# sourceMappingURL=codex-adapter.d.ts.map

package/dist/adapters/codex-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/codex-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,WAAW,EACX,eAAe,EAEhB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAyCnD;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,aAAa;IACnD,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAU;IAC9B,QAAQ,CAAC,WAAW,eAAc;IAClC,QAAQ,CAAC,cAAc,WAAU;IAEjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,CAAC,EAAE,OAAO;IAK5B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IA8BjD;;;;;;;OAOG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,YAAY;IAuBnE;;;OAGG;IACH,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,GAAG,YAAY;IA2BjF;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU;IAiBzE;;OAEG;IACH,eAAe,CACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,eAAe;IAsElB;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAU7C;;OAEG;IACH,eAAe,IAAI,mBAAmB;IA4BtC,OAAO,CAAC,oBAAoB;CAgB7B"}