darwin-agents 0.4.9 → 0.5.0-alpha.2

package/dist/agents/marketing.js

@@ -0,0 +1,59 @@
+/**
+ * Marketing Agent — Social Media Copywriter
+ *
+ * Platform-specific social content: Instagram, LinkedIn, X.
+ * No MCP tools needed — pure text generation.
+ * Uses Writer-style critics (task compliance, persuasion, substance).
+ *
+ * Customize brand identity by providing brand context in the task prompt
+ * or by creating a custom agent with defineAgent().
+ */
+export const marketing = {
+    name: 'marketing',
+    role: 'Social Media Copywriter',
+    description: 'Writes social media content: carousels, posts, captions. Brand-aware, platform-specific.',
+    maxTurns: 8,
+    systemPrompt: `You are a senior social media copywriter for a premium digital agency.
+
+BRAND IDENTITY:
+- Adapt to the brand/company specified in the task. If none specified, write for a generic premium web agency.
+- Tone: Professional but approachable. Expert but not arrogant. Direct, no fluff.
+- Target: Small-to-medium business owners who need digital solutions that convert.
+- Languages: Adapt to the task language. Default: English.
+
+PLATFORM RULES:
+- Instagram: Visual hooks, emotional triggers, 6-slide carousel structure
+- LinkedIn: Business pain points, longer form, professional tone
+- X/Twitter: Short, punchy, tech-savvy, max 280 chars per tweet
+
+CONTENT PRINCIPLES:
+- Lead with a HOOK that stops the scroll (question, bold claim, counterintuitive insight)
+- Every slide/paragraph must deliver value — no filler
+- Use *asterisks* for ONE accent word per headline (for visual emphasis)
+- End with clear CTA (adapt to brand, or use a generic "learn more" CTA)
+- NEVER use generic phrases: "in today's digital landscape", "it's no secret that"
+- NEVER invent statistics without marking them as estimates
+- Adapt tone per platform — Instagram is NOT LinkedIn translated
+
+OUTPUT FORMAT:
+1. Platform indicator (Instagram/LinkedIn/X)
+2. Hook headline
+3. Full content (slides, post text, or tweet thread)
+4. Caption with 5 hashtags
+5. CTA
+
+CONSTRAINT COMPLIANCE IS PRIORITY #1: Follow the exact format requested. If the task says "carousel", produce carousel slides. If it says "caption only", produce only a caption.`,
+    evolution: {
+        enabled: true,
+        evaluator: 'multi-critic',
+        minOutputLength: 500,
+        metrics: {
+            quality: 0.60,
+            sourceCount: 0.0,
+            outputLength: 0.10,
+            duration: 0.05,
+            success: 0.25,
+        },
+    },
+};
+//# sourceMappingURL=marketing.js.map

package/dist/agents/marketing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketing.js","sourceRoot":"","sources":["../../src/agents/marketing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,CAAC,MAAM,SAAS,GAAoB;IACxC,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE,0FAA0F;IACvG,QAAQ,EAAE,CAAC;IACX,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kLA6BkK;IAEhL,SAAS,EAAE;QACT,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,cAAc;QACzB,eAAe,EAAE,GAAG;QACpB,OAAO,EAAE;YACP,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,GAAG;YAChB,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;SACd;KACF;CACF,CAAC"}

package/dist/agents/researcher.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Research Agent — Web Research with Darwin Evolution
+ *
+ * Searches the web, extracts content, writes research reports.
+ * This is the showcase agent for Darwin's self-evolution.
+ *
+ * Requires: Tavily API key (TAVILY_API_KEY) or SearXNG instance
+ */
+import type { AgentDefinition } from '../types.js';
+export declare const researcher: AgentDefinition;
+//# sourceMappingURL=researcher.d.ts.map

package/dist/agents/researcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"researcher.d.ts","sourceRoot":"","sources":["../../src/agents/researcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,UAAU,EAAE,eA2DxB,CAAC"}

package/dist/agents/researcher.js

@@ -0,0 +1,68 @@
+/**
+ * Research Agent — Web Research with Darwin Evolution
+ *
+ * Searches the web, extracts content, writes research reports.
+ * This is the showcase agent for Darwin's self-evolution.
+ *
+ * Requires: Tavily API key (TAVILY_API_KEY) or SearXNG instance
+ */
+export const researcher = {
+    name: 'researcher',
+    role: 'Web Researcher',
+    description: 'Searches the web and writes structured research reports. Evolves to find better sources over time.',
+    maxTurns: 15,
+    mcp: ['tavily'],
+    tools: ['WebSearch', 'WebFetch'],
+    systemPrompt: `You are a research agent for a technology team.
+
+YOUR MISSION:
+Deliver comprehensive, well-sourced research reports.
+
+RESEARCH PROCESS:
+1. Start with broad searches — multiple search terms, different angles
+2. Identify the 3-5 most relevant sources
+3. Extract and read the full content of key sources
+4. Cross-reference claims across multiple sources
+5. Write a structured report with clear findings
+
+RULES:
+- Search in BOTH English and the user's language for broader coverage
+- Cite ALL sources with URLs
+- Separate FACTS (with source) from OPINIONS (your analysis)
+- If sources conflict, present both sides explicitly
+- NEVER invent information — say "not found" rather than guess
+- Include publication dates when available
+- Quantify claims when possible (numbers, percentages, dates)
+
+OUTPUT FORMAT:
+# Research: {Topic}
+
+## Key Findings
+- Finding 1 (Source: URL)
+- Finding 2 (Source: URL)
+
+## Detailed Analysis
+{Structured analysis with headers per subtopic}
+
+## Sources
+1. {Title} — {URL} ({Date})
+2. ...
+
+## Confidence Assessment
+- High confidence: {claims well-supported}
+- Medium confidence: {claims with limited sources}
+- Low confidence: {claims needing verification}`,
+    evolution: {
+        enabled: true,
+        evaluator: 'critic',
+        metrics: {
+            quality: 0.40,
+            sourceCount: 0.15,
+            outputLength: 0.10,
+            duration: 0.10,
+            success: 0.25,
+        },
+        minRuns: 5,
+    },
+};
+//# sourceMappingURL=researcher.js.map

package/dist/agents/researcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"researcher.js","sourceRoot":"","sources":["../../src/agents/researcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,UAAU,GAAoB;IACzC,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,oGAAoG;IACjH,QAAQ,EAAE,EAAE;IACZ,GAAG,EAAE,CAAC,QAAQ,CAAC;IACf,KAAK,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;IAChC,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDAsCgC;IAE9C,SAAS,EAAE;QACT,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE;YACP,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,IAAI;YACjB,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;SACd;QACD,OAAO,EAAE,CAAC;KACX;CACF,CAAC"}

package/dist/agents/writer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Writer Agent — Zero-Config Hello World
+ *
+ * No MCP servers, no API keys, no setup.
+ * Just run: darwin run writer "Write about async/await"
+ */
+import type { AgentDefinition } from '../types.js';
+export declare const writer: AgentDefinition;
+//# sourceMappingURL=writer.d.ts.map

package/dist/agents/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/agents/writer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,MAAM,EAAE,eAwCpB,CAAC"}

package/dist/agents/writer.js

@@ -0,0 +1,47 @@
+/**
+ * Writer Agent — Zero-Config Hello World
+ *
+ * No MCP servers, no API keys, no setup.
+ * Just run: darwin run writer "Write about async/await"
+ */
+export const writer = {
+    name: 'writer',
+    role: 'Content Writer',
+    description: 'Writes structured content. No APIs needed — the perfect first agent.',
+    maxTurns: 8,
+    systemPrompt: `You are a professional content writer and marketing copywriter.
+
+RULES (NON-NEGOTIABLE):
+- CONSTRAINT COMPLIANCE IS PRIORITY #1: If the task says "Max 200 words", you MUST stay under 200 words. Count them. Exceeding limits makes your output unusable.
+- Write in the language the user uses (detect automatically)
+- Lead with the key insight, then elaborate
+- No filler phrases, no corporate speak ("in today's world", "it's important to note")
+- NEVER invent statistics. If you cite a number, it must be defensible. Use "approximately" or "typically" for estimates.
+- End with a clear takeaway or next step
+
+QUALITY STANDARDS:
+- Every sentence must earn its place — if it could be cut without loss, cut it
+- Use headers, bullet points, and short paragraphs for scannability
+- For marketing content: be concrete, use specific numbers, include CTAs
+- For technical content: be precise, use examples, explain trade-offs
+- Adapt tone to audience (technical, business, casual, marketing)
+- ALWAYS produce substantive output — never less than 100 words unless the task demands brevity
+
+OUTPUT FORMAT:
+1. A clear title
+2. A one-sentence summary (the thesis, not a meta-description)
+3. The main content with headers
+4. Key takeaways at the end`,
+    evolution: {
+        enabled: true,
+        evaluator: 'multi-critic',
+        metrics: {
+            quality: 0.55,
+            sourceCount: 0.0,
+            outputLength: 0.10,
+            duration: 0.10,
+            success: 0.25,
+        },
+    },
+};
+//# sourceMappingURL=writer.js.map

package/dist/agents/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/agents/writer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,CAAC,MAAM,MAAM,GAAoB;IACrC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,sEAAsE;IACnF,QAAQ,EAAE,CAAC;IACX,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;4BAsBY;IAE1B,SAAS,EAAE;QACT,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,cAAc;QACzB,OAAO,EAAE;YACP,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,GAAG;YAChB,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;SACd;KACF;CACF,CAAC"}

package/dist/cli/create.d.ts

@@ -0,0 +1,11 @@
+/**
+ * darwin create <name>
+ *
+ * Scaffolds a new agent definition file in agents/<name>.ts.
+ * Validates the name (lowercase, no spaces) and generates a template.
+ */
+/**
+ * Scaffold a new agent. Validates name and writes template to agents/<name>.ts.
+ */
+export declare function createCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=create.d.ts.map

package/dist/cli/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4DH;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDjE"}

package/dist/cli/create.js

@@ -0,0 +1,104 @@
+/**
+ * darwin create <name>
+ *
+ * Scaffolds a new agent definition file in agents/<name>.ts.
+ * Validates the name (lowercase, no spaces) and generates a template.
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+const AGENT_NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
+/**
+ * Generate the agent template file content for a given agent name.
+ */
+function agentTemplate(name) {
+    const roleName = name
+        .split('-')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+    return `/**
+ * ${roleName} Agent
+ *
+ * Created with: darwin create ${name}
+ * Run with:     darwin run ${name} "your task"
+ */
+
+import { defineAgent } from 'darwin-agents';
+
+export default defineAgent({
+  name: '${name}',
+  role: '${roleName}',
+  description: 'TODO: Describe what this agent does.',
+  systemPrompt: \`You are a ${roleName} agent.
+
+YOUR MISSION:
+TODO: Define the agent's core purpose.
+
+RULES:
+- Be precise and thorough
+- Cite sources when applicable
+- Structure output clearly with headers
+- Never invent information
+
+OUTPUT FORMAT:
+# Result
+
+## Summary
+{One-sentence overview}
+
+## Details
+{Main content with structured sections}
+
+## Next Steps
+{Actionable recommendations}\`,
+
+  evolution: {
+    enabled: true,
+    evaluator: 'critic',
+  },
+});
+`;
+}
+/**
+ * Scaffold a new agent. Validates name and writes template to agents/<name>.ts.
+ */
+export async function createCommand(args) {
+    const name = args[0];
+    if (!name) {
+        throw new Error('Usage: darwin create <name>\n  Example: darwin create summarizer');
+    }
+    // Validate agent name
+    if (!AGENT_NAME_PATTERN.test(name)) {
+        throw new Error(`Invalid agent name: "${name}". ` +
+            `Must be lowercase, start with a letter, and contain only letters, digits, and hyphens.`);
+    }
+    if (name.length > 64) {
+        throw new Error(`Agent name "${name}" exceeds 64 character limit`);
+    }
+    const cwd = process.cwd();
+    const agentsDir = join(cwd, 'agents');
+    const filePath = join(agentsDir, `${name}.ts`);
+    // Check if file already exists
+    if (existsSync(filePath)) {
+        throw new Error(`Agent already exists: agents/${name}.ts`);
+    }
+    // Create agents/ directory if needed
+    if (!existsSync(agentsDir)) {
+        mkdirSync(agentsDir, { recursive: true });
+        console.log('[darwin] Created agents/ directory');
+    }
+    // Write agent template
+    writeFileSync(filePath, agentTemplate(name), 'utf-8');
+    console.log(`
+[darwin] Created agent: agents/${name}.ts
+
+  Next steps:
+
+  1. Edit agents/${name}.ts — update role, description, and systemPrompt
+  2. Run it:
+     darwin run ${name} "your task here"
+
+  3. Check evolution after a few runs:
+     darwin status ${name}
+`);
+}
+//# sourceMappingURL=create.js.map

package/dist/cli/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAE/C;;GAEG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,QAAQ,GAAG,IAAI;SAClB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACzD,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,OAAO;KACJ,QAAQ;;iCAEoB,IAAI;8BACP,IAAI;;;;;;WAMvB,IAAI;WACJ,QAAQ;;8BAEW,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BrC,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAc;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAErB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IAED,sBAAsB;IACtB,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,KAAK;YACjC,wFAAwF,CACzF,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,8BAA8B,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;IAE/C,+BAA+B;IAC/B,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,KAAK,CAAC,CAAC;IAC7D,CAAC;IAED,qCAAqC;IACrC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IACpD,CAAC;IAED,uBAAuB;IACvB,aAAa,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IAEtD,OAAO,CAAC,GAAG,CAAC;iCACmB,IAAI;;;;mBAIlB,IAAI;;kBAEL,IAAI;;;qBAGD,IAAI;CACxB,CAAC,CAAC;AACH,CAAC"}

package/dist/cli/evolve.d.ts

@@ -0,0 +1,13 @@
+/**
+ * darwin evolve <agent>
+ *
+ * Manage evolution settings for an agent.
+ *
+ * Usage:
+ *   darwin evolve researcher --enable
+ *   darwin evolve researcher --disable
+ *   darwin evolve researcher --reset
+ *   darwin evolve researcher --force   (force optimization now)
+ */
+export declare function evolveCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=evolve.d.ts.map

package/dist/cli/evolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evolve.d.ts","sourceRoot":"","sources":["../../src/cli/evolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDjE"}

package/dist/cli/evolve.js

@@ -0,0 +1,69 @@
+/**
+ * darwin evolve <agent>
+ *
+ * Manage evolution settings for an agent.
+ *
+ * Usage:
+ *   darwin evolve researcher --enable
+ *   darwin evolve researcher --disable
+ *   darwin evolve researcher --reset
+ *   darwin evolve researcher --force   (force optimization now)
+ */
+import { createMemory } from '../memory/index.js';
+import { loadConfig } from '../core/agent.js';
+import { builtinAgents } from '../agents/index.js';
+export async function evolveCommand(args) {
+    const agentName = args[0];
+    if (!agentName) {
+        throw new Error('Usage: darwin evolve <agent> [--enable|--disable|--reset|--force]');
+    }
+    const agent = builtinAgents[agentName];
+    if (!agent) {
+        throw new Error(`Unknown agent: "${agentName}". Available: ${Object.keys(builtinAgents).join(', ')}`);
+    }
+    const flags = args.slice(1);
+    const config = await loadConfig();
+    const memory = createMemory(config);
+    await memory.init();
+    if (flags.includes('--enable')) {
+        if (agent.evolution) {
+            agent.evolution.enabled = true;
+        }
+        console.log(`[darwin] Evolution ENABLED for ${agentName}`);
+        console.log(`[darwin] The critic will evaluate runs and Darwin will optimize prompts automatically.`);
+    }
+    else if (flags.includes('--disable')) {
+        if (agent.evolution) {
+            agent.evolution.enabled = false;
+        }
+        console.log(`[darwin] Evolution DISABLED for ${agentName}`);
+    }
+    else if (flags.includes('--reset')) {
+        const state = await memory.getState();
+        state.activeVersions[agentName] = 'v1';
+        state.abTests[agentName] = null;
+        state.consecutiveFailures[agentName] = 0;
+        await memory.saveState(state);
+        console.log(`[darwin] Evolution RESET for ${agentName}. Back to v1.`);
+    }
+    else if (flags.includes('--force')) {
+        console.log(`[darwin] Force evolution is not yet available.`);
+        console.log(`[darwin] Run the agent normally — Darwin will evolve automatically after enough runs.`);
+    }
+    else {
+        // Show current status
+        const state = await memory.getState();
+        const version = state.activeVersions[agentName] ?? 'v1';
+        const runs = state.experimentCounts[agentName] ?? 0;
+        const abTest = state.abTests[agentName];
+        const enabled = agent.evolution?.enabled ?? false;
+        console.log(`\n[darwin] Evolution for ${agentName}:`);
+        console.log(`  Enabled:   ${enabled ? 'yes' : 'no'}`);
+        console.log(`  Version:   ${version}`);
+        console.log(`  Runs:      ${runs}`);
+        console.log(`  A/B Test:  ${abTest ? `${abTest.versionA} vs ${abTest.versionB}` : 'none'}`);
+        console.log(`  Min Runs:  ${agent.evolution?.minRuns ?? 5}`);
+    }
+    await memory.close();
+}
+//# sourceMappingURL=evolve.js.map

package/dist/cli/evolve.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Darwin CLI — AI agents that improve themselves.
+ *
+ * Usage:
+ *   darwin run <agent> "task description"
+ *   darwin evolve <agent> --enable
+ *   darwin status [agent]
+ *   darwin create <name>
+ *   darwin init
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/cli/index.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+/**
+ * Darwin CLI — AI agents that improve themselves.
+ *
+ * Usage:
+ *   darwin run <agent> "task description"
+ *   darwin evolve <agent> --enable
+ *   darwin status [agent]
+ *   darwin create <name>
+ *   darwin init
+ */
+import { runCommand } from './run.js';
+import { statusCommand } from './status.js';
+import { evolveCommand } from './evolve.js';
+import { initCommand } from './init.js';
+import { createCommand } from './create.js';
+const HELP = `
+  darwin — AI agents that improve themselves.
+
+  Usage:
+    darwin run <agent> "task"     Run an agent on a task
+    darwin status [agent]        Show evolution status & metrics
+    darwin evolve <agent>        Manage evolution settings
+    darwin create <name>         Scaffold a new agent
+    darwin init                  Initialize darwin in current project
+
+  Agents:
+    writer       Content writer (zero-config, no API keys)
+    researcher   Web research (needs TAVILY_API_KEY)
+    critic       Quality evaluator (used by Darwin internally)
+    analyst      Code analysis (filesystem access)
+
+  Examples:
+    darwin run writer "Explain the CAP theorem"
+    darwin run researcher "AI Agent frameworks 2026"
+    darwin run analyst --path ./src
+    darwin status researcher
+    darwin evolve researcher --enable
+
+  Options:
+    --task-type <type>    Categorize the task (tech, webdesign, market, general)
+    --no-evolve           Skip evolution check after run
+    --no-critic           Skip automatic critic evaluation
+    --model <model>       Override LLM model
+    --verbose             Show detailed output
+    --help                Show this help
+`;
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+        console.log(HELP);
+        process.exit(0);
+    }
+    const command = args[0];
+    try {
+        switch (command) {
+            case 'run':
+                await runCommand(args.slice(1));
+                break;
+            case 'status':
+                await statusCommand(args.slice(1));
+                break;
+            case 'evolve':
+                await evolveCommand(args.slice(1));
+                break;
+            case 'create':
+                await createCommand(args.slice(1));
+                break;
+            case 'init':
+                await initCommand();
+                break;
+            default:
+                console.error(`Unknown command: ${command}`);
+                console.log(HELP);
+                process.exit(1);
+        }
+    }
+    catch (err) {
+        console.error(`\n[darwin] Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BZ,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,CAAC;QACH,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,KAAK;gBACR,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChC,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnC,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnC,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnC,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,WAAW,EAAE,CAAC;gBACpB,MAAM;YACR;gBACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;gBAC7C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,qBAAsB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/cli/init.d.ts

@@ -0,0 +1,12 @@
+/**
+ * darwin init
+ *
+ * Initializes Darwin in the current project.
+ * Creates .darwin/ directory, darwin.config.ts template, and .gitignore.
+ */
+/**
+ * Initialize Darwin in the current working directory.
+ * Creates .darwin/ dir, darwin.config.ts, and .gitignore if they don't exist.
+ */
+export declare function initCommand(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAwCjD"}

package/dist/cli/init.js

@@ -0,0 +1,68 @@
+/**
+ * darwin init
+ *
+ * Initializes Darwin in the current project.
+ * Creates .darwin/ directory, darwin.config.ts template, and .gitignore.
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+const CONFIG_TEMPLATE = `import { defineConfig } from 'darwin-agents';
+
+export default defineConfig({
+  provider: 'claude-cli',
+  memory: 'sqlite',
+  evolution: {
+    enabled: true,
+    minRuns: 5,
+    safetyGate: true,
+  },
+});
+`;
+const GITIGNORE_TEMPLATE = `.darwin/
+node_modules/
+`;
+/**
+ * Initialize Darwin in the current working directory.
+ * Creates .darwin/ dir, darwin.config.ts, and .gitignore if they don't exist.
+ */
+export async function initCommand() {
+    const cwd = process.cwd();
+    const darwinDir = join(cwd, '.darwin');
+    const configPath = join(cwd, 'darwin.config.ts');
+    const gitignorePath = join(cwd, '.gitignore');
+    // Create .darwin/ directory
+    if (existsSync(darwinDir)) {
+        console.log('[darwin] .darwin/ directory already exists — skipping');
+    }
+    else {
+        mkdirSync(darwinDir, { recursive: true });
+        console.log('[darwin] Created .darwin/ directory');
+    }
+    // Create darwin.config.ts
+    if (existsSync(configPath)) {
+        console.log('[darwin] darwin.config.ts already exists — skipping');
+    }
+    else {
+        writeFileSync(configPath, CONFIG_TEMPLATE, 'utf-8');
+        console.log('[darwin] Created darwin.config.ts');
+    }
+    // Create .gitignore
+    if (existsSync(gitignorePath)) {
+        console.log('[darwin] .gitignore already exists — skipping');
+    }
+    else {
+        writeFileSync(gitignorePath, GITIGNORE_TEMPLATE, 'utf-8');
+        console.log('[darwin] Created .gitignore');
+    }
+    console.log(`
+[darwin] Initialized! Next steps:
+
+  1. Edit darwin.config.ts to configure your setup
+  2. Create your first agent:
+     darwin create my-agent
+
+  3. Run it:
+     darwin run my-agent "your task here"
+`);
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,eAAe,GAAG;;;;;;;;;;;CAWvB,CAAC;AAEF,MAAM,kBAAkB,GAAG;;CAE1B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IACjD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAE9C,4BAA4B;IAC5B,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;IACvE,CAAC;SAAM,CAAC;QACN,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IACrD,CAAC;IAED,0BAA0B;IAC1B,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACrE,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,UAAU,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IACnD,CAAC;IAED,oBAAoB;IACpB,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,aAAa,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,CAAC,GAAG,CAAC;;;;;;;;;CASb,CAAC,CAAC;AACH,CAAC"}

package/dist/cli/run.d.ts

@@ -0,0 +1,7 @@
+/**
+ * darwin run <agent> "task"
+ *
+ * Runs an agent, optionally evaluates with critic, triggers Darwin evolution.
+ */
+export declare function runCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuJH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB9D"}