darwin-agents 0.4.9 → 0.5.0-alpha.2

package/dist/providers/claude-cli.js

@@ -0,0 +1,153 @@
+/**
+ * Darwin — Claude CLI Provider
+ *
+ * Spawns `claude` CLI as a child process.
+ * The only provider that supports MCP tool use (via --mcp-config).
+ * Slower than direct API but enables full tool-augmented agents.
+ */
+import { spawn } from 'node:child_process';
+const DEFAULT_MODEL = 'claude-sonnet-4-20250514';
+export class ClaudeCliProvider {
+    name = 'claude-cli';
+    supportsMcp = true;
+    defaultModel;
+    /** Stashed CLI-specific options — set before run() via setRunOptions() */
+    runOptions = {};
+    constructor(config) {
+        this.defaultModel = config.defaultModel ?? DEFAULT_MODEL;
+    }
+    /** Set CLI-specific options for the next run (MCP, tools, etc.) */
+    setRunOptions(opts) {
+        this.runOptions = opts;
+    }
+    async run(options) {
+        const MAX_RETRIES = 2;
+        const MIN_VALID_CHARS = 50;
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+            const result = await this.executeOnce(options);
+            if (result.output.trim().length >= MIN_VALID_CHARS) {
+                return result;
+            }
+            if (attempt < MAX_RETRIES) {
+                const delay = 1000 * (attempt + 1);
+                console.warn(`[claude-cli] Attempt ${attempt + 1} produced ${result.output.length} chars. Retrying in ${delay}ms...`);
+                await new Promise((r) => setTimeout(r, delay));
+            }
+            else {
+                return result; // All retries exhausted
+            }
+        }
+        // TypeScript: unreachable but needed for return type
+        throw new Error('Unreachable');
+    }
+    async executeOnce(options) {
+        const model = options.model ?? this.defaultModel;
+        const timeout = options.timeout ?? 600_000;
+        const opts = this.runOptions;
+        // Build CLI args
+        const args = [
+            '-p',
+            '--output-format', 'text',
+            '--model', model,
+            '--max-turns', String(opts.maxTurns ?? 10),
+        ];
+        // MCP config
+        if (opts.agent && opts.darwinConfig) {
+            const mcpConfig = buildMcpConfig(opts.agent, opts.darwinConfig);
+            if (mcpConfig) {
+                args.push('--mcp-config', mcpConfig);
+            }
+            const allowedTools = buildAllowedTools(opts.agent, opts.darwinConfig);
+            if (allowedTools) {
+                args.push('--allowedTools', allowedTools);
+            }
+        }
+        if (opts.autonomous) {
+            args.push('--permission-mode', 'bypassPermissions');
+        }
+        // Combine system prompt + task as stdin
+        const stdin = `${options.systemPrompt}\n\n---\n\nTask: ${options.userMessage}`;
+        const startTime = Date.now();
+        // Spawn claude CLI
+        const output = await new Promise((resolve, reject) => {
+            const cleanEnv = { ...process.env };
+            delete cleanEnv.CLAUDECODE;
+            // CRITICAL: By default, strip Anthropic API credentials so the spawned
+            // Claude CLI uses the user's paid subscription (Claude Pro / Max)
+            // instead of billing against the API key environment variables.
+            // Without this, users with ANTHROPIC_API_KEY in their shell get
+            // surprise-billed for every single Darwin run at full API rates.
+            // Opt back in for CI / server-side usage with DARWIN_USE_API_KEY=1.
+            if (process.env.DARWIN_USE_API_KEY !== '1') {
+                delete cleanEnv.ANTHROPIC_API_KEY;
+                delete cleanEnv.ANTHROPIC_AUTH_TOKEN;
+            }
+            const child = spawn('claude', args, {
+                cwd: opts.cwd ?? process.cwd(),
+                stdio: ['pipe', 'pipe', 'inherit'],
+                timeout,
+                env: cleanEnv,
+            });
+            const chunks = [];
+            child.stdout.on('data', (chunk) => {
+                chunks.push(chunk);
+            });
+            child.stdin.write(stdin);
+            child.stdin.end();
+            child.on('close', (code) => {
+                const result = Buffer.concat(chunks).toString('utf-8');
+                if (code === 0) {
+                    resolve(result);
+                }
+                else {
+                    reject(new Error(`Claude CLI exited with code ${String(code)}: ${result.slice(0, 500)}`));
+                }
+            });
+            child.on('error', (err) => {
+                reject(new Error(`Failed to spawn Claude CLI: ${err.message}`));
+            });
+        });
+        const durationMs = Date.now() - startTime;
+        return {
+            output,
+            durationMs,
+            model,
+        };
+    }
+}
+// ─── Helpers (extracted from runner.ts) ───────────
+function buildMcpConfig(agent, config) {
+    if (!agent.mcp || agent.mcp.length === 0 || !config.mcp) {
+        return null;
+    }
+    const mcpServers = {};
+    let hasServers = false;
+    for (const serverName of agent.mcp) {
+        const serverConfig = config.mcp[serverName];
+        if (serverConfig) {
+            mcpServers[serverName] = {
+                type: 'stdio',
+                command: serverConfig.command,
+                args: serverConfig.args,
+                ...(serverConfig.env ? { env: serverConfig.env } : {}),
+            };
+            hasServers = true;
+        }
+    }
+    return hasServers ? JSON.stringify({ mcpServers }) : null;
+}
+function buildAllowedTools(agent, config) {
+    const patterns = [];
+    if (agent.mcp && agent.mcp.length > 0 && config.mcp) {
+        for (const serverName of agent.mcp) {
+            if (config.mcp[serverName]) {
+                patterns.push(`mcp__${serverName}__*`);
+            }
+        }
+    }
+    if (agent.tools && agent.tools.length > 0) {
+        patterns.push(...agent.tools);
+    }
+    return patterns.length > 0 ? patterns.join(',') : null;
+}
+//# sourceMappingURL=claude-cli.js.map

package/dist/providers/claude-cli.js.map

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

package/dist/providers/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Darwin — Provider Factory
+ *
+ * Creates the appropriate LLM provider based on configuration.
+ * Supports: claude-cli, anthropic-api, openai, ollama.
+ */
+export type { LLMProvider, LLMCallOptions, LLMCallResult, ProviderConfig } from './types.js';
+export { ClaudeCliProvider } from './claude-cli.js';
+export type { ClaudeCliRunOptions } from './claude-cli.js';
+export { AnthropicProvider } from './anthropic.js';
+export { OpenAIProvider } from './openai.js';
+export { OllamaProvider } from './ollama.js';
+import type { LLMProvider, ProviderConfig } from './types.js';
+/**
+ * Create an LLM provider from configuration.
+ *
+ * @example
+ * ```ts
+ * // Anthropic API (fastest for non-MCP agents)
+ * const provider = createProvider({ type: 'anthropic-api' });
+ *
+ * // OpenAI-compatible (GPT-4o, Together AI, Groq, etc.)
+ * const provider = createProvider({
+ *   type: 'openai',
+ *   baseUrl: 'https://api.together.xyz/v1',
+ *   defaultModel: 'meta-llama/Llama-3.1-70B-Instruct-Turbo',
+ * });
+ *
+ * // Ollama (local, free, offline)
+ * const provider = createProvider({ type: 'ollama', defaultModel: 'llama3.1' });
+ *
+ * // Claude CLI (only option for MCP-enabled agents)
+ * const provider = createProvider({ type: 'claude-cli' });
+ * ```
+ */
+export declare function createProvider(config: ProviderConfig): LLMProvider;
+/** Default model names per provider */
+export declare const DEFAULT_MODELS: Record<ProviderConfig['type'], string>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAM9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,WAAW,CAalE;AAED,uCAAuC;AACvC,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,CAKjE,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,58 @@
+/**
+ * Darwin — Provider Factory
+ *
+ * Creates the appropriate LLM provider based on configuration.
+ * Supports: claude-cli, anthropic-api, openai, ollama.
+ */
+export { ClaudeCliProvider } from './claude-cli.js';
+export { AnthropicProvider } from './anthropic.js';
+export { OpenAIProvider } from './openai.js';
+export { OllamaProvider } from './ollama.js';
+import { ClaudeCliProvider } from './claude-cli.js';
+import { AnthropicProvider } from './anthropic.js';
+import { OpenAIProvider } from './openai.js';
+import { OllamaProvider } from './ollama.js';
+/**
+ * Create an LLM provider from configuration.
+ *
+ * @example
+ * ```ts
+ * // Anthropic API (fastest for non-MCP agents)
+ * const provider = createProvider({ type: 'anthropic-api' });
+ *
+ * // OpenAI-compatible (GPT-4o, Together AI, Groq, etc.)
+ * const provider = createProvider({
+ *   type: 'openai',
+ *   baseUrl: 'https://api.together.xyz/v1',
+ *   defaultModel: 'meta-llama/Llama-3.1-70B-Instruct-Turbo',
+ * });
+ *
+ * // Ollama (local, free, offline)
+ * const provider = createProvider({ type: 'ollama', defaultModel: 'llama3.1' });
+ *
+ * // Claude CLI (only option for MCP-enabled agents)
+ * const provider = createProvider({ type: 'claude-cli' });
+ * ```
+ */
+export function createProvider(config) {
+    switch (config.type) {
+        case 'claude-cli':
+            return new ClaudeCliProvider(config);
+        case 'anthropic-api':
+            return new AnthropicProvider(config);
+        case 'openai':
+            return new OpenAIProvider(config);
+        case 'ollama':
+            return new OllamaProvider(config);
+        default:
+            throw new Error(`Unknown provider type: ${String(config.type)}`);
+    }
+}
+/** Default model names per provider */
+export const DEFAULT_MODELS = {
+    'claude-cli': 'claude-sonnet-4-20250514',
+    'anthropic-api': 'claude-sonnet-4-20250514',
+    'openai': 'gpt-5.4',
+    'ollama': 'llama3.1',
+};
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,YAAY;YACf,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACvC,KAAK,eAAe;YAClB,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACvC,KAAK,QAAQ;YACX,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,QAAQ;YACX,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QACpC;YACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,CAAE,MAAyB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED,uCAAuC;AACvC,MAAM,CAAC,MAAM,cAAc,GAA2C;IACpE,YAAY,EAAE,0BAA0B;IACxC,eAAe,EAAE,0BAA0B;IAC3C,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,UAAU;CACrB,CAAC"}

package/dist/providers/ollama.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Darwin — Ollama Provider
+ *
+ * Local LLM inference via Ollama's API.
+ * Perfect for development, testing, and cost-free experimentation.
+ * No API key needed — runs locally.
+ */
+import type { LLMCallOptions, LLMCallResult, LLMProvider, ProviderConfig } from './types.js';
+export declare class OllamaProvider implements LLMProvider {
+    readonly name = "ollama";
+    readonly supportsMcp = false;
+    private baseUrl;
+    private defaultModel;
+    constructor(config: ProviderConfig);
+    run(options: LLMCallOptions): Promise<LLMCallResult>;
+}
+//# sourceMappingURL=ollama.d.ts.map

package/dist/providers/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../src/providers/ollama.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAmB7F,qBAAa,cAAe,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,SAAS;IAE7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,cAAc;IAK5B,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAmD3D"}

package/dist/providers/ollama.js

@@ -0,0 +1,64 @@
+/**
+ * Darwin — Ollama Provider
+ *
+ * Local LLM inference via Ollama's API.
+ * Perfect for development, testing, and cost-free experimentation.
+ * No API key needed — runs locally.
+ */
+const DEFAULT_BASE_URL = 'http://localhost:11434';
+const DEFAULT_MODEL = 'llama3.1';
+export class OllamaProvider {
+    name = 'ollama';
+    supportsMcp = false;
+    baseUrl;
+    defaultModel;
+    constructor(config) {
+        this.baseUrl = (config.baseUrl ?? process.env.OLLAMA_BASE_URL ?? DEFAULT_BASE_URL).replace(/\/$/, '');
+        this.defaultModel = config.defaultModel ?? DEFAULT_MODEL;
+    }
+    async run(options) {
+        const model = options.model ?? this.defaultModel;
+        const timeout = options.timeout ?? 600_000; // 10 min for local models (slower)
+        const messages = [
+            { role: 'system', content: options.systemPrompt },
+            { role: 'user', content: options.userMessage },
+        ];
+        const body = {
+            model,
+            messages,
+            stream: false,
+            ...(options.temperature !== undefined ? { options: { temperature: options.temperature } } : {}),
+        };
+        const startTime = Date.now();
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(`${this.baseUrl}/api/chat`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Ollama API error ${String(response.status)}: ${errorText}`);
+            }
+            const data = (await response.json());
+            const durationMs = Date.now() - startTime;
+            return {
+                output: data.message?.content ?? '',
+                durationMs,
+                inputTokens: data.prompt_eval_count,
+                outputTokens: data.eval_count,
+                model: data.model,
+                meta: data.total_duration ? { totalDurationNs: data.total_duration } : undefined,
+            };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=ollama.js.map

package/dist/providers/ollama.js.map

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

package/dist/providers/openai.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Darwin — OpenAI-Compatible Provider
+ *
+ * Works with OpenAI, Azure OpenAI, Together AI, Groq,
+ * and any other OpenAI-compatible API endpoint.
+ * No SDK dependency — uses native fetch (Node 20+).
+ */
+import type { LLMCallOptions, LLMCallResult, LLMProvider, ProviderConfig } from './types.js';
+export declare class OpenAIProvider implements LLMProvider {
+    readonly name = "openai";
+    readonly supportsMcp = false;
+    private apiKey;
+    private baseUrl;
+    private defaultModel;
+    private defaultMaxTokens;
+    constructor(config: ProviderConfig);
+    run(options: LLMCallOptions): Promise<LLMCallResult>;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA2B7F,qBAAa,cAAe,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,SAAS;IAE7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,EAAE,cAAc;IAW5B,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAsD3D"}

package/dist/providers/openai.js

@@ -0,0 +1,75 @@
+/**
+ * Darwin — OpenAI-Compatible Provider
+ *
+ * Works with OpenAI, Azure OpenAI, Together AI, Groq,
+ * and any other OpenAI-compatible API endpoint.
+ * No SDK dependency — uses native fetch (Node 20+).
+ */
+const DEFAULT_BASE_URL = 'https://api.openai.com/v1';
+const DEFAULT_MODEL = 'gpt-5.4';
+const DEFAULT_MAX_TOKENS = 8192;
+export class OpenAIProvider {
+    name = 'openai';
+    supportsMcp = false;
+    apiKey;
+    baseUrl;
+    defaultModel;
+    defaultMaxTokens;
+    constructor(config) {
+        const key = config.apiKey ?? process.env.OPENAI_API_KEY;
+        if (!key) {
+            throw new Error('OpenAI API key required. Set OPENAI_API_KEY or pass apiKey in config.');
+        }
+        this.apiKey = key;
+        this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, '');
+        this.defaultModel = config.defaultModel ?? DEFAULT_MODEL;
+        this.defaultMaxTokens = config.defaultMaxTokens ?? DEFAULT_MAX_TOKENS;
+    }
+    async run(options) {
+        const model = options.model ?? this.defaultModel;
+        const maxTokens = options.maxTokens ?? this.defaultMaxTokens;
+        const timeout = options.timeout ?? 300_000;
+        const messages = [
+            { role: 'system', content: options.systemPrompt },
+            { role: 'user', content: options.userMessage },
+        ];
+        const body = {
+            model,
+            max_tokens: maxTokens,
+            messages,
+            ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),
+        };
+        const startTime = Date.now();
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(`${this.baseUrl}/chat/completions`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`OpenAI API error ${String(response.status)}: ${errorText}`);
+            }
+            const data = (await response.json());
+            const durationMs = Date.now() - startTime;
+            const output = data.choices[0]?.message?.content ?? '';
+            return {
+                output,
+                durationMs,
+                inputTokens: data.usage?.prompt_tokens,
+                outputTokens: data.usage?.completion_tokens,
+                model: data.model,
+            };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

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

package/dist/providers/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Darwin — LLM Provider Interface
+ *
+ * Abstraction over different LLM backends.
+ * All providers implement the same interface so Darwin can
+ * swap models/providers without changing agent or evolution code.
+ */
+/** Options for a single LLM call */
+export interface LLMCallOptions {
+    /** Model identifier (provider-specific, e.g. "claude-sonnet-4-20250514") */
+    model: string;
+    /** System prompt (role/behavior instructions) */
+    systemPrompt: string;
+    /** User message (the task) */
+    userMessage: string;
+    /** Max output tokens (default: provider-dependent) */
+    maxTokens?: number;
+    /** Temperature (0-1, default: provider-dependent) */
+    temperature?: number;
+    /** Timeout in milliseconds */
+    timeout?: number;
+}
+/** Result from an LLM call */
+export interface LLMCallResult {
+    /** The generated text output */
+    output: string;
+    /** Duration of the API call in milliseconds */
+    durationMs: number;
+    /** Input tokens used (if reported by provider) */
+    inputTokens?: number;
+    /** Output tokens used (if reported by provider) */
+    outputTokens?: number;
+    /** Model actually used (may differ from requested) */
+    model?: string;
+    /** Provider-specific metadata */
+    meta?: Record<string, unknown>;
+}
+/** LLM Provider — implemented by each backend */
+export interface LLMProvider {
+    /** Provider name for logging */
+    readonly name: string;
+    /** Whether this provider supports MCP tool use */
+    readonly supportsMcp: boolean;
+    /** Run a single LLM call */
+    run(options: LLMCallOptions): Promise<LLMCallResult>;
+}
+/** Provider configuration */
+export interface ProviderConfig {
+    /** Provider type */
+    type: 'claude-cli' | 'anthropic-api' | 'openai' | 'ollama';
+    /** API key (for anthropic, openai) */
+    apiKey?: string;
+    /** Base URL override (for openai-compatible, ollama) */
+    baseUrl?: string;
+    /** Default model for this provider */
+    defaultModel?: string;
+    /** Default max tokens */
+    defaultMaxTokens?: number;
+    /** Default temperature */
+    defaultTemperature?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,4BAA4B;IAC5B,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACtD;AAED,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,IAAI,EAAE,YAAY,GAAG,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3D,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0BAA0B;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/providers/types.js

@@ -0,0 +1,9 @@
+/**
+ * Darwin — LLM Provider Interface
+ *
+ * Abstraction over different LLM backends.
+ * All providers implement the same interface so Darwin can
+ * swap models/providers without changing agent or evolution code.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/src/core/trace-capture.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Darwin — Execution Trace Capture (v0.5 / A1)
+ *
+ * Pure, transport-agnostic capturer. Knows nothing about Anthropic SDK,
+ * Claude CLI, OpenAI, or any specific runtime — the runtime feeds events,
+ * the capturer aggregates into an ExecutionTrace.
+ *
+ * Three event types map to the three industry-standard span types
+ * (Braintrust + Langfuse + Strands SDK + OTEL GenAI 2026):
+ *   - recordToolUse / recordToolResult  → Tool spans
+ *   - recordTextBlock                    → assistant prose counter (NOT thinking-block)
+ *   - recordError                        → Turn-level errors
+ *   - addTokens                          → aggregated LLM token usage
+ *
+ * Pairing rule: each `recordToolUse(id, ...)` MUST be paired with a later
+ * `recordToolResult(id, ...)` to compute durationMs. Unpaired uses get
+ * `durationMs > 0` (start-to-finalize) and `outcome = 'error'` at
+ * finalize-time with errorClass = 'unpaired_call' so we never silently
+ * drop hanging tools.
+ *
+ * Privacy + size: args are passed through as-is — caller's responsibility
+ * to truncate sensitive values. resultSummary is truncated to 2000 chars
+ * at recordToolResult-time. OTEL note: `gen_ai.tool.call.arguments` is
+ * Opt-In in the GenAI spec; Darwin's "always-capture args" stance is
+ * acceptable for internal use but MUST be documented when traces touch
+ * customer data (V2 will add a Redaction-Layer).
+ *
+ * Backwards-compat: capturer is opt-in. Existing code paths that don't
+ * instantiate it produce DarwinExperiment.trajectory === undefined and
+ * the rest of the system behaves identically to pre-A1.
+ */
+import type { ExecutionTrace, TraceTokenUsage } from '../types.js';
+export interface TraceCapture {
+    /**
+     * Record the start of a tool call. `id` is the SDK's correlation id
+     * (Anthropic SDK `tool_use.id`, OpenAI `tool_call.id`, etc.) — used to
+     * pair the matching recordToolResult AND persisted on the captured
+     * TraceToolCall as `id` for OTEL `gen_ai.tool.call.id` mapping.
+     */
+    recordToolUse(id: string, tool: string, args?: Record<string, unknown>): void;
+    /**
+     * Record the result of a previously-started tool call. If `id` was never
+     * passed to recordToolUse, the result is silently dropped (defensive —
+     * some SDKs emit tool_result for system tools without tool_use).
+     */
+    recordToolResult(id: string, outcome: 'success' | 'error', opts?: {
+        resultSummary?: string;
+        errorClass?: string;
+        errorMessage?: string;
+        retryCount?: number;
+    }): void;
+    /** Mark the start of a new agent turn (1-indexed). Default starts at turn 1. */
+    startTurn(): void;
+    /**
+     * Increment the text-block counter — one per substantial assistant
+     * text emission (>50 chars typically, but the caller decides the
+     * threshold). Renamed from `recordReasoning` after R1 review for
+     * accuracy: this counts ANY assistant prose, NOT only pre-action
+     * "thinking" blocks. Use `addTokens` for cost-of-reasoning attribution.
+     */
+    recordTextBlock(): void;
+    /** Record a turn-level error (e.g. spawn failure, parse error, child crash). */
+    recordError(class_: string, message: string): void;
+    /**
+     * Accumulate LLM token usage into the trajectory aggregate. Call once
+     * per LLM round-trip with the usage object the SDK returned. Missing
+     * fields are treated as zero for summation. Existing aggregate fields
+     * are preserved (additive merge).
+     */
+    addTokens(usage: TraceTokenUsage): void;
+    /**
+     * Build the final ExecutionTrace.
+     * Unpaired tool calls (recordToolUse without recordToolResult) get
+     * marked as outcome='error', errorClass='unpaired_call' so silent
+     * SDK hangs remain visible.
+     */
+    finalize(): ExecutionTrace;
+}
+export interface TraceCaptureOptions {
+    /**
+     * Wallclock provider. Defaults to `Date.now`. Override for tests so
+     * durations are deterministic.
+     */
+    now?: () => number;
+    /**
+     * Predicate that classifies a tool name as an MCP-server call (vs a
+     * built-in like Read/Bash). Default heuristic: starts with 'mcp__'.
+     * Used to populate `mcpInvocations` aggregate.
+     */
+    isMcpTool?: (toolName: string) => boolean;
+}
+/**
+ * Create a fresh trace capturer.
+ *
+ * Usage:
+ * ```ts
+ * const trace = createTraceCapture();
+ * trace.startTurn();
+ * trace.recordToolUse('call_1', 'mcp__nex__search', { query: 'foo' });
+ * trace.recordToolResult('call_1', 'success', { resultSummary: '3 hits' });
+ * trace.recordTextBlock();
+ * trace.addTokens({ inputTokens: 1200, outputTokens: 340 });
+ * const trajectory = trace.finalize();
+ * ```
+ */
+export declare function createTraceCapture(opts?: TraceCaptureOptions): TraceCapture;
+//# sourceMappingURL=trace-capture.d.ts.map