darwin-agents 0.4.4

package/dist/evolution/multi-critic.js

@@ -0,0 +1,324 @@
+/**
+ * Darwin — Multi-Critic Evaluator
+ *
+ * Runs 3 specialized critics in parallel and takes the median score.
+ * More robust than a single critic — reduces bias and random variance.
+ *
+ * Agent-aware: Different agents get different evaluation criteria.
+ *
+ * Investigator Critics:
+ *   A: Facts & Sources — accuracy, citations, primary documents
+ *   B: Honesty & Courage — intellectual bravery, clear positions, uncomfortable truths
+ *   C: Completeness & Structure — full investigation, proper format, both sides covered
+ *
+ * Writer Critics:
+ *   A: Task Compliance & Accuracy — did the writer follow the brief? Correct claims?
+ *   B: Persuasion & Voice — tone, engagement, conviction, audience awareness
+ *   C: Substance & Originality — depth, concrete value, fresh angles
+ */
+// ─── Output Format (shared across all critics) ────────
+const CRITIC_OUTPUT_FORMAT = `OUTPUT FORMAT (EXACTLY THIS):
+===SCORE===
+{number 1-10}
+===ASSESSMENT===
+{2-3 sentences}
+===END===`;
+// ─── Investigator Critic Prompts ──────────────────────
+const INVESTIGATOR_CRITIC_A = `You evaluate investigative reports on FACTUAL ACCURACY and SOURCE QUALITY.
+
+Score 1-10 based on:
+- Are claims backed by verifiable sources with URLs?
+- Are primary documents cited (government reports, court filings, academic papers)?
+- Are sources from multiple countries/languages?
+- Are numbers, dates, and names specific and accurate?
+- Is the source mix diverse (not just Wikipedia + one news outlet)?
+
+LOW SCORE: Vague claims, no URLs, "experts say" without naming them, single-source narrative.
+HIGH SCORE: Specific citations, primary documents, cross-referenced claims, diverse source mix.
+
+${CRITIC_OUTPUT_FORMAT}`;
+const INVESTIGATOR_CRITIC_B = `You evaluate investigative reports on HONESTY and INTELLECTUAL COURAGE.
+
+Score 1-10 based on:
+- Does the report take a clear position or hide behind "both sides" diplomacy?
+- Does it state uncomfortable conclusions backed by evidence?
+- Does it challenge comfortable assumptions from BOTH mainstream and alternative sides?
+- Does it acknowledge what it genuinely doesn't know?
+- Does it resist the temptation to play it safe?
+
+LOW SCORE: Fence-sitting, diplomatic non-answers, "more research needed" cop-out, predetermined conclusions.
+HIGH SCORE: Clear honest position, challenges both sides, admits uncertainty where genuine, follows evidence over comfort.
+
+${CRITIC_OUTPUT_FORMAT}`;
+const INVESTIGATOR_CRITIC_C = `You evaluate investigative reports on COMPLETENESS and STRUCTURE.
+
+Score 1-10 based on:
+- Are all required sections present (Official Narrative, Counter-Narrative, Evidence, Follow The Money, Assessment)?
+- Are BOTH sides presented with their STRONGEST arguments (not strawmen)?
+- Is the evidence analysis systematic with clear ratings?
+- Is the output substantial enough for the topic complexity?
+- Does it cover what we DON'T know, not just what we do?
+
+LOW SCORE: Missing sections, one-sided presentation, no evidence table, too brief, strawman arguments.
+HIGH SCORE: All sections complete, steelman both sides, systematic evidence ratings, thorough coverage.
+
+${CRITIC_OUTPUT_FORMAT}`;
+// ─── Writer Critic Prompts ────────────────────────────
+const WRITER_CRITIC_A = `You evaluate written content on TASK COMPLIANCE and FACTUAL ACCURACY.
+
+This is the HARDEST critic. You enforce the contract between task and output.
+
+Score 1-10 based on:
+- Did the writer follow ALL constraints? (word count limits, format requirements, specific deliverables)
+- Are factual claims backed by evidence or clearly marked as estimates?
+- Are specific numbers, statistics, or percentages sourced or defensible?
+- Does the output match the EXACT deliverable requested (e.g., "5 ads" means 5, not 4)?
+- Is the content usable as-is for its stated purpose?
+
+CRITICAL DEDUCTIONS:
+- Exceeding word count by >20%: automatic cap at 5/10
+- Missing required deliverables: automatic cap at 4/10
+- Unsourced specific claims ("3-5x more leads", "50% faster"): -2 points
+- Wrong language (task in German, output in English or vice versa): -3 points
+
+LOW SCORE: Ignores constraints, invents statistics, misses deliverables, exceeds word limits, unusable output.
+HIGH SCORE: Exact constraint compliance, defensible claims, complete deliverables, production-ready output.
+
+${CRITIC_OUTPUT_FORMAT}`;
+const WRITER_CRITIC_B = `You evaluate written content on PERSUASION, VOICE, and AUDIENCE AWARENESS.
+
+Score 1-10 based on:
+- Does the writing have a distinct voice — not generic AI slop?
+- Is the tone matched to the audience (technical, business, casual)?
+- Does it make the reader CARE about the topic?
+- Are arguments backed by concrete examples, numbers, or analogies?
+- Does it include clear calls-to-action or next steps where appropriate?
+- Would a human editor publish this WITHOUT major revisions?
+
+CALIBRATION (be strict — most AI writing is 5-7, not 7-9):
+- 9-10: Would win an award. Unique voice, unforgettable opening, zero filler.
+- 7-8: Professional quality. Minor polish needed but publishable.
+- 5-6: Competent but generic. Reads like any other AI-written content.
+- 3-4: Template-level. Swappable headers, predictable structure, no soul.
+- 1-2: Incoherent or fundamentally wrong tone.
+
+LOW SCORE: Generic tone, reads like a template, no personality, vague claims, missing CTAs, audience mismatch.
+HIGH SCORE: Distinctive voice, audience-aware tone, compelling arguments, specific examples, clear next steps.
+
+${CRITIC_OUTPUT_FORMAT}`;
+const WRITER_CRITIC_C = `You evaluate written content on SUBSTANCE and ORIGINALITY.
+
+Score 1-10 based on:
+- Does it say something genuinely useful — not just restate the obvious?
+- Are there fresh angles, insights, or frameworks the reader hasn't seen?
+- Is the depth appropriate for the topic complexity?
+- Are trade-offs and nuances acknowledged, not just one-sided cheerleading?
+- Would an expert in this field find value, or is it surface-level?
+- Are claims that could be verified actually verifiable? (statistics, trends, best practices)
+
+CALIBRATION — the "Google Test":
+If the reader could find the same content in the first 3 Google results, it is NOT original (max 6/10).
+Originality means: non-obvious connections, counterintuitive insights, personal frameworks, or data the reader hasn't seen.
+
+LOW SCORE: Restates common knowledge, no original insight, too shallow, one-sided, an expert would learn nothing.
+HIGH SCORE: Genuine insights, fresh perspective, appropriate depth, honest about trade-offs, expert-level value.
+
+${CRITIC_OUTPUT_FORMAT}`;
+// ─── Marketing Critic Prompts ──────────────────────────
+const MARKETING_CRITIC_A = `You evaluate social media content on PLATFORM COMPLIANCE and BRAND CONSISTENCY.
+
+Score 1-10 based on:
+- Does the content match the requested platform format? (carousel slides, tweet length, LinkedIn structure)
+- Is the language correct? (English for Instagram/X, German for LinkedIn)
+- Does it follow brand voice? (professional but approachable, no corporate fluff)
+- Are all required elements present? (hook, content, CTA, hashtags)
+- Would a social media manager post this WITHOUT major edits?
+
+CRITICAL DEDUCTIONS:
+- Wrong platform format: automatic cap at 4/10
+- Wrong language for platform: -3 points
+- Missing CTA: -2 points
+- Generic opening ("In today's digital world..."): -2 points
+
+CALIBRATION: Most AI social content is 4-6. A 9 means a social media manager would post it immediately.
+
+${CRITIC_OUTPUT_FORMAT}`;
+const MARKETING_CRITIC_B = `You evaluate social media content on SCROLL-STOPPING POWER and ENGAGEMENT POTENTIAL.
+
+Score 1-10 based on:
+- Would this stop someone scrolling? Is the hook genuinely compelling?
+- Does it create an emotional response (curiosity, recognition, urgency)?
+- Is the value proposition clear within the first 2 seconds of reading?
+- Are the claims specific enough to be believable? ("3x more leads" vs "significantly more")
+- Would the target audience (SMB owners) engage (like, comment, share)?
+
+CALIBRATION: Most AI-generated social posts get 0 engagement. A 7+ means real engagement potential.
+- 9-10: Viral potential. Unique angle no one else is taking.
+- 7-8: Strong hook. Would generate comments and saves.
+- 5-6: Competent but forgettable. Scrolled past in 2 seconds.
+- 3-4: Generic template content. Actively hurts brand perception.
+
+${CRITIC_OUTPUT_FORMAT}`;
+const MARKETING_CRITIC_C = `You evaluate social media content on CONVERSION INTENT and BUSINESS VALUE.
+
+Score 1-10 based on:
+- Does this content serve a business goal? (awareness, trust, leads, traffic)
+- Is the CTA clear and compelling? Not just "visit our website" but WHY?
+- Does the content position the brand as an expert without being salesy?
+- Would this content attract the RIGHT audience (SMB decision-makers, not random followers)?
+- Is there a clear content-to-conversion path? (post → interest → click → contact)
+
+CALIBRATION: Content without conversion intent is 5/10 max, no matter how pretty.
+
+${CRITIC_OUTPUT_FORMAT}`;
+// ─── Blog Critic Prompts ──────────────────────────────
+const BLOG_CRITIC_A = `You evaluate blog posts on SEO STRUCTURE and TECHNICAL OPTIMIZATION.
+
+Score 1-10 based on:
+- Is the main keyword in: title, first paragraph, at least one H2, meta description?
+- Are H2 headers using keyword variations (not exact stuffing)?
+- Is the meta description compelling AND under 155 chars?
+- Are paragraphs short enough for web reading (max 3-4 sentences)?
+- Is there a FAQ section with structured-data-ready questions?
+- Are internal link suggestions included?
+
+CRITICAL DEDUCTIONS:
+- No keyword in title: -3 points
+- No meta description: automatic cap at 5/10
+- Wall-of-text paragraphs (>5 sentences): -2 points
+- No FAQ section: -1 point
+
+${CRITIC_OUTPUT_FORMAT}`;
+const BLOG_CRITIC_B = `You evaluate blog posts on READABILITY and AUDIENCE FIT.
+
+Score 1-10 based on:
+- Would a small business owner understand this without Googling terms?
+- Does it lead with the reader's problem, not the solution?
+- Are technical concepts explained with analogies or examples?
+- Is the tone expert but accessible (not academic, not dumbed-down)?
+- Does every section answer "why should I care?"
+- Would the reader finish the entire article?
+
+CALIBRATION: Most SEO blog content is 4-6 (keyword-stuffed, boring). A 8+ means genuinely useful.
+
+${CRITIC_OUTPUT_FORMAT}`;
+const BLOG_CRITIC_C = `You evaluate blog posts on CONVERSION POTENTIAL and ACTIONABILITY.
+
+Score 1-10 based on:
+- Does the reader know EXACTLY what to do next after reading?
+- Is there a clear CTA that feels natural (not forced)?
+- Does the content build trust and authority? (examples, data, experience)
+- Are objections addressed proactively ("But what about...")?
+- Would this post generate consultation requests or contact form submissions?
+
+CALIBRATION: A blog post that informs but doesn't convert is 6/10 max.
+
+${CRITIC_OUTPUT_FORMAT}`;
+// ─── Prompt Registry ──────────────────────────────────
+const INVESTIGATOR_PROMPTS = [
+    { name: 'facts-sources', prompt: INVESTIGATOR_CRITIC_A },
+    { name: 'honesty-courage', prompt: INVESTIGATOR_CRITIC_B },
+    { name: 'completeness-structure', prompt: INVESTIGATOR_CRITIC_C },
+];
+const WRITER_PROMPTS = [
+    { name: 'task-compliance', prompt: WRITER_CRITIC_A },
+    { name: 'persuasion-voice', prompt: WRITER_CRITIC_B },
+    { name: 'substance-originality', prompt: WRITER_CRITIC_C },
+];
+const MARKETING_PROMPTS = [
+    { name: 'platform-compliance', prompt: MARKETING_CRITIC_A },
+    { name: 'scroll-stopping', prompt: MARKETING_CRITIC_B },
+    { name: 'conversion-intent', prompt: MARKETING_CRITIC_C },
+];
+const BLOG_PROMPTS = [
+    { name: 'seo-structure', prompt: BLOG_CRITIC_A },
+    { name: 'readability', prompt: BLOG_CRITIC_B },
+    { name: 'conversion-potential', prompt: BLOG_CRITIC_C },
+];
+/** Agent name → critic prompt set. Falls back to a sensible default. */
+const AGENT_CRITIC_MAP = {
+    investigator: INVESTIGATOR_PROMPTS,
+    writer: WRITER_PROMPTS,
+    marketing: MARKETING_PROMPTS,
+    'blog-writer': BLOG_PROMPTS,
+};
+/**
+ * Get the right critic prompts for an agent.
+ * Falls back to investigator prompts for unknown agents (backward-compatible).
+ */
+export function getCriticPrompts(agentName) {
+    return AGENT_CRITIC_MAP[agentName] ?? INVESTIGATOR_PROMPTS;
+}
+/** @deprecated Use getCriticPrompts(agentName) instead. Kept for backward compatibility. */
+export const CRITIC_PROMPTS = INVESTIGATOR_PROMPTS;
+// ─── Multi-Critic Runner ───────────────────────────────
+/** Descriptive labels for evaluation task preamble, per agent type */
+const AGENT_OUTPUT_LABELS = {
+    investigator: 'investigative report',
+    writer: 'written content',
+    marketing: 'social media content',
+    'blog-writer': 'blog post',
+};
+/**
+ * Run multiple specialized critics and return the median score.
+ * Critics are selected based on the agent being evaluated.
+ *
+ * @param agentOutput - The agent's output to evaluate
+ * @param task - The original task description
+ * @param runCritic - Function to run a critic (injected, uses Claude CLI)
+ * @param agentName - Name of the agent being evaluated (determines which critic set to use)
+ */
+export async function runMultiCritic(agentOutput, task, runCritic, agentName) {
+    const outputLabel = AGENT_OUTPUT_LABELS[agentName ?? ''] ?? 'output';
+    const evaluationTask = `Evaluate the following ${outputLabel} for the task "${task}":\n\n${agentOutput}`;
+    const prompts = getCriticPrompts(agentName ?? '');
+    // Run all 3 critics in parallel
+    const promises = prompts.map(async ({ name, prompt }) => {
+        try {
+            const output = await runCritic(prompt, evaluationTask, name);
+            const score = parseScore(output);
+            return { critic: name, score, report: output };
+        }
+        catch {
+            // If a critic fails, return null score
+            return { critic: name, score: -1, report: 'Critic failed to produce output.' };
+        }
+    });
+    const results = await Promise.all(promises);
+    // Filter out failed critics
+    const validResults = results.filter((r) => r.score > 0);
+    if (validResults.length === 0) {
+        return {
+            medianScore: 0,
+            critics: results,
+            combinedReport: 'All critics failed to produce scores.',
+        };
+    }
+    // Calculate median
+    const scores = validResults.map((r) => r.score).sort((a, b) => a - b);
+    const medianScore = scores.length % 2 === 0
+        ? (scores[scores.length / 2 - 1] + scores[scores.length / 2]) / 2
+        : scores[Math.floor(scores.length / 2)];
+    // Build combined report
+    const reportLines = results.map((r) => `[${r.critic}] Score: ${r.score > 0 ? r.score : 'FAILED'}/10\n${r.report}`);
+    return {
+        medianScore: Math.round(medianScore * 10) / 10,
+        critics: results,
+        combinedReport: reportLines.join('\n\n---\n\n'),
+    };
+}
+// ─── Helpers ───────────────────────────────────────────
+/** Parse ===SCORE=== from critic output, with fallback to X/10 pattern */
+function parseScore(output) {
+    const scoreMatch = output.match(/===SCORE===\s*(\d+(?:\.\d+)?)/);
+    if (scoreMatch) {
+        return Math.max(1, Math.min(10, parseFloat(scoreMatch[1])));
+    }
+    // Fallback: X/10 pattern
+    const fallback = output.match(/\b(\d+(?:\.\d+)?)\s*\/\s*10\b/);
+    if (fallback) {
+        return Math.max(1, Math.min(10, parseFloat(fallback[1])));
+    }
+    return -1;
+}
+//# sourceMappingURL=multi-critic.js.map

package/dist/evolution/multi-critic.js.map

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

package/dist/evolution/notifications.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Darwin — Notification System
+ *
+ * Sends alerts when important evolution events happen.
+ * Currently supports Telegram. Non-blocking — failures are logged, not thrown.
+ *
+ * Env vars: TELEGRAM_BOT_TOKEN, TELEGRAM_ADMIN_CHAT_ID
+ */
+export interface NotificationConfig {
+    telegram?: {
+        botToken: string;
+        chatId: string;
+    };
+}
+/**
+ * Load notification config from environment variables.
+ * Returns config with telegram only if both vars are set.
+ */
+export declare function loadNotificationConfig(): NotificationConfig;
+/**
+ * Notify that an A/B test completed and a winner was activated.
+ */
+export declare function notifyABTestComplete(config: NotificationConfig, agentName: string, winner: string, loser: string, compositeWinner: number, compositeLoser: number): Promise<void>;
+/**
+ * Notify that a new prompt version was generated and A/B test started.
+ */
+export declare function notifyEvolutionStarted(config: NotificationConfig, agentName: string, oldVersion: string, newVersion: string, reason: string): Promise<void>;
+/**
+ * Notify that a rollback happened.
+ */
+export declare function notifyRollback(config: NotificationConfig, agentName: string, rolledBackTo: string, failures: number): Promise<void>;
+//# sourceMappingURL=notifications.d.ts.map

package/dist/evolution/notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/evolution/notifications.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,kBAAkB,CAS3D;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/evolution/notifications.js

@@ -0,0 +1,92 @@
+/**
+ * Darwin — Notification System
+ *
+ * Sends alerts when important evolution events happen.
+ * Currently supports Telegram. Non-blocking — failures are logged, not thrown.
+ *
+ * Env vars: TELEGRAM_BOT_TOKEN, TELEGRAM_ADMIN_CHAT_ID
+ */
+/**
+ * Load notification config from environment variables.
+ * Returns config with telegram only if both vars are set.
+ */
+export function loadNotificationConfig() {
+    const botToken = process.env.TELEGRAM_BOT_TOKEN;
+    const chatId = process.env.TELEGRAM_ADMIN_CHAT_ID;
+    if (botToken && chatId) {
+        return { telegram: { botToken, chatId } };
+    }
+    return {};
+}
+/**
+ * Notify that an A/B test completed and a winner was activated.
+ */
+export async function notifyABTestComplete(config, agentName, winner, loser, compositeWinner, compositeLoser) {
+    const delta = compositeWinner > 0 && compositeLoser > 0
+        ? `+${(((compositeWinner - compositeLoser) / compositeLoser) * 100).toFixed(1)}%`
+        : '';
+    const msg = [
+        `🧬 *Darwin A/B Test Complete*`,
+        ``,
+        `Agent: \`${agentName}\``,
+        `Winner: *${winner}* (${compositeWinner.toFixed(3)})`,
+        `Loser: ${loser} (${compositeLoser.toFixed(3)}) ${delta}`,
+        ``,
+        `${winner} is now the active prompt.`,
+    ].join('\n');
+    await sendTelegram(config, msg);
+}
+/**
+ * Notify that a new prompt version was generated and A/B test started.
+ */
+export async function notifyEvolutionStarted(config, agentName, oldVersion, newVersion, reason) {
+    const msg = [
+        `🔬 *Darwin Evolution Started*`,
+        ``,
+        `Agent: \`${agentName}\``,
+        `A/B Test: ${oldVersion} vs *${newVersion}*`,
+        `Reason: ${reason.slice(0, 200)}`,
+    ].join('\n');
+    await sendTelegram(config, msg);
+}
+/**
+ * Notify that a rollback happened.
+ */
+export async function notifyRollback(config, agentName, rolledBackTo, failures) {
+    const msg = [
+        `⚠️ *Darwin Rollback*`,
+        ``,
+        `Agent: \`${agentName}\``,
+        `Rolled back to: *${rolledBackTo}*`,
+        `After ${failures} consecutive failures`,
+    ].join('\n');
+    await sendTelegram(config, msg);
+}
+// ─── Telegram Helper ──────────────────────────────
+async function sendTelegram(config, text) {
+    if (!config.telegram)
+        return;
+    const { botToken, chatId } = config.telegram;
+    const url = `https://api.telegram.org/bot${botToken}/sendMessage`;
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                chat_id: chatId,
+                text,
+                parse_mode: 'Markdown',
+                disable_web_page_preview: true,
+            }),
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            console.warn(`[darwin] Telegram notification failed: ${response.status} ${body}`);
+        }
+    }
+    catch (err) {
+        console.warn(`[darwin] Telegram notification error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=notifications.js.map

package/dist/evolution/notifications.js.map

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

package/dist/evolution/optimizer.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Darwin — Prompt Optimizer
+ *
+ * Uses an LLM (via injected callback) to generate improved prompt variants
+ * based on performance data and detected patterns.
+ */
+import type { DarwinPattern, PromptVersionStats } from '../types.js';
+/** Function signature for LLM calls — injected by the parent, never imported. */
+export type RunPromptFn = (prompt: string) => Promise<string>;
+/** Agent tool context so the optimizer knows what tools are available */
+export interface AgentToolContext {
+    /** MCP server names the agent uses */
+    mcp?: string[];
+    /** Built-in tools the agent uses */
+    tools?: string[];
+}
+/** Stats broken down by task category */
+export interface CategoryStats {
+    taskType: string;
+    totalRuns: number;
+    avgQuality: number;
+    avgSourceCount: number;
+    successRate: number;
+}
+export declare class PromptOptimizer {
+    private runPrompt;
+    constructor(runPrompt: RunPromptFn);
+    /**
+     * Generate an improved variant of an agent prompt.
+     *
+     * Builds a meta-prompt that includes the current prompt text, detected
+     * patterns (strengths, weaknesses, trends, anomalies), aggregated
+     * stats, tool context, per-category breakdowns, and recent critic feedback.
+     */
+    generateVariant(currentPrompt: string, patterns: DarwinPattern[], stats: PromptVersionStats, toolContext?: AgentToolContext, categoryStats?: CategoryStats[], recentFeedback?: string[]): Promise<string>;
+    /**
+     * Assemble the meta-prompt that instructs the LLM how to improve
+     * the agent's system prompt.
+     */
+    private buildMetaPrompt;
+    /**
+     * Format patterns into a human-readable summary for the meta-prompt.
+     */
+    private formatPatterns;
+    /**
+     * Format stats into a readable summary.
+     */
+    private formatStats;
+    /**
+     * Remove markdown code fences if the LLM wraps the output.
+     */
+    private cleanOutput;
+    /**
+     * Pluralize a pattern type label correctly.
+     * Handles: weakness -> Weaknesses, strength -> Strengths, trend -> Trends, anomaly -> Anomalies
+     */
+    private pluralize;
+    /**
+     * Check that the mutated prompt preserves safety-related keywords from the original.
+     * Returns null if OK, or a rejection reason if safety keywords were removed.
+     */
+    checkAlignmentPreservation(original: string, mutated: string): string | null;
+}
+//# sourceMappingURL=optimizer.d.ts.map

package/dist/evolution/optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimizer.d.ts","sourceRoot":"","sources":["../../src/evolution/optimizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAErE,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE9D,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAc;gBAEnB,SAAS,EAAE,WAAW;IAIlC;;;;;;OAMG;IACG,eAAe,CACnB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,aAAa,EAAE,EACzB,KAAK,EAAE,kBAAkB,EACzB,WAAW,CAAC,EAAE,gBAAgB,EAC9B,aAAa,CAAC,EAAE,aAAa,EAAE,EAC/B,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,MAAM,CAAC;IA+BlB;;;OAGG;IACH,OAAO,CAAC,eAAe;IA2HvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAiCtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAYnB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAUjB;;;OAGG;IACH,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAwC7E"}