darwin-agents 0.4.6 → 0.4.8

package/CHANGELOG.md

@@ -0,0 +1,248 @@
+# Changelog
+
+## [0.4.8] — 2026-05-22
+
+Hotfix on top of v0.4.7. Path resolution in the `exports` map pointed at
+`./dist/*` but the v0.4.7 build emitted into `./dist/src/*` (because
+`tsconfig` `rootDir` was widened to `./` so examples could compile into
+`./dist/examples/`). The pre-existing entrypoints (`darwin-agents`,
+`darwin-agents/providers`, `darwin-agents/memory`, `darwin-agents/agents`)
+were therefore unreachable from v0.4.7 — only the new `./memory/bridge`
+and `./memory/closed-loop` subpaths resolved correctly.
+
+### Fixed
+
+- `main`, `types`, `bin`, and every `./dist/*` entry in `exports` now
+  point at `./dist/src/*` to match the actual build output layout.
+- `./memory/bridge` and `./memory/closed-loop` continue to resolve to
+  `./dist/examples/mcp-memory-bridge.js` / `memory-darwin-integration.js`
+  unchanged — those paths were already correct.
+
+### Recommendation
+
+Upgrade from v0.4.7 to v0.4.8 (`npm install darwin-agents@latest`).
+v0.4.7 is functional only via the two new `./memory/*` subpaths; the
+core API and CLI are unreachable in that release.
+
+## [0.4.7] — 2026-05-22
+
+Generic MCP-Memory bridge — Darwin's closed loop now plugs into any
+MCP-compliant memory server out of the box.
+
+### Added
+
+- **`examples/mcp-memory-bridge.ts`** — pluggable JSON-RPC 2.0 client for
+  MCP-Memory servers. Two transports (`stdio` + `http`), default targets
+  `@studiomeyer/local-memory-mcp` for zero-config local memory. Override
+  `writeTool` / `readTool` and provide `mapWriteArgs` / `mapReadResult`
+  for Mem0 / Zep / Letta / Cognee / your own server. Exposed as the
+  `darwin-agents/memory/bridge` subpath export for clean consumer imports.
+  Companion entry point `darwin-agents/memory/closed-loop` maps to
+  `memory-darwin-integration.ts`.
+
+  Why raw JSON-RPC instead of `@modelcontextprotocol/sdk`? Darwin's
+  zero-hard-deps policy. The MCP wire for our case is three messages
+  (`initialize` + `tools/list` + `tools/call`), and we keep it that
+  way — no SDK dependency, no peer-dep update, fully testable.
+
+  Implements the `FeedbackStore` interface from `closed-loop-feedback.ts`
+  and extends it with `fetchRelevant(query, limit)` + `close()` via the
+  new `RetrievableFeedbackStore` interface. Backward-compatible: existing
+  `FeedbackStore` consumers keep working.
+
+  Hardening: per-RPC timeout (default 10s), bounded stdio respawn on
+  EPIPE/exit (default 1 attempt), SSE-tolerant HTTP body parser, defensive
+  result extraction for `content[].text` JSON envelopes and
+  `structuredContent` shortcuts.
+
+  Convenience factories: `localMemory(overrides)` for the default zero-
+  config wiring, `remoteMemory(url, overrides)` for any HTTP endpoint.
+
+- **`examples/memory-darwin-integration.ts`** — closed-loop orchestration
+  in three lines: fetch lessons → render as context → run the agent →
+  persist critic findings. The next run sees the previous run's lessons.
+
+  Adds `runClosedLoopTurn()` (orchestration shape) and
+  `renderLessonContext()` (token-budgeted prompt rendering, default 1800
+  chars with elision fallback).
+
+### Hardening (Round-1 critic findings, fixed in-place before publish)
+
+- F1 — removed inline-respawn path from `rpc()` that bypassed `ensureReady()`
+  and could double-spawn the stdio child.
+- F2 — SSE parser now splits on event boundaries (`\n\n`) and joins multi-
+  line `data:` fields with `\n` per the EventSource spec §9.2.4. Returns
+  the most recent well-formed event so partial streams don't override the
+  final result.
+- F3 — added `child.stdin.on('error', …)` to swallow EPIPE/ERR_STREAM_DESTROYED
+  emitted on the dying stdin between exit-event delivery, so the host
+  process doesn't crash on transient races.
+- F4 — `initInFlight` is no longer auto-cleared in the catch handler.
+  Concurrent callers see the same failure once; the next call after the
+  failure starts a fresh attempt. Prevents the concurrent double-spawn
+  race on retry-after-init-failure.
+- F5 — `close()` now nulls `initInFlight` so a caller awaiting a stale
+  init promise after close gets routed back through the `bridge is closed`
+  guard rather than racing the dead transport.
+- F7 — HTTP responses without a `jsonrpc: "2.0"` envelope are logged via
+  the configured warn-logger and surface as `undefined` to the caller
+  (which then yields `[]` via the result mapper) rather than throwing
+  raw `SyntaxError` on malformed payloads.
+- F9 — added `tsconfig.test.json` for opt-in test type-checking via
+  `npm run typecheck:tests`. Main build (`npm run build`) remains
+  src+examples only so pre-existing test-file type drift doesn't break
+  publish.
+
+### Robustness additions
+
+- **HTTP retry policy** — `httpMaxRetries` config (default 2) with
+  exponential backoff for 5xx and transient network errors
+  (ECONNRESET/ETIMEDOUT/ENOTFOUND/EAI_AGAIN/AbortError). 4xx errors are
+  surfaced immediately. Matches the lesson from running an MCP server
+  behind Cloudflare/nginx where intermittent 502/503 are normal.
+- **`fetchRelevant()` accepts an options bag** — call shape is
+  `bridge.fetchRelevant({ query, limit, tags })`. Legacy
+  `bridge.fetchRelevant('query', 5)` still works for backward-compat.
+- **JSON-RPC id-mismatch** is logged but accepted (warn-not-throw) for
+  servers that re-key responses.
+
+### USP framing
+
+- README "Memory Integration" section now spells out the differentiation
+  vs. Mem0/Zep/Letta/MemPalace/agentmemory/brainctl: pluggable backends
+  exist, closed-loop self-evolution exists, but Darwin v0.4.7 is the
+  first MIT-licensed, TypeScript-native, MCP-native combination. The
+  symmetric polarity rule (mistake/pattern, mediocre band skipped) is
+  the production-ready closed-loop pattern aligned with reflective
+  self-improvement work like GEPA (ICLR 2026 Oral).
+
+- **+31 unit tests:**
+  - `tests/mcp-memory-bridge.test.ts` (24 tests) — default arg mappers,
+    structured-content extraction, http round-trip (initialize + tools/
+    call), tool-name + arg override (Mem0-style), Authorization header
+    propagation, JSON-RPC error surfacing, stdio round-trip against a
+    fake MCP child, child-crash-mid-session (F1/F3 regression), reject-
+    on-close-during-flight (F5 regression), 5xx retry + 4xx no-retry,
+    multi-event + multi-line SSE parsing (F2), non-JSON-RPC warn (F7),
+    single-flight initialize under concurrent calls (F4).
+  - `tests/memory-darwin-integration.test.ts` (7 tests) —
+    `renderLessonContext` boundary cases, three-turn closed-loop
+    behaviour (cold → warm → mediocre band), fetch-failure resilience,
+    custom `persistThresholds` honoured.
+
+### Notes
+
+- No production code changed. Only `examples/` and `tests/` files are
+  added — `src/` and the existing CLI are untouched. Safe to upgrade.
+- The bridge intentionally lives in `examples/` (not `src/`) so it stays
+  copy-paste-able and doesn't impose dependencies on the core package.
+
+## [0.4.6] — 2026-05-22
+
+Three dedicated critic sets + two production patterns from real fleet usage.
+
+### Added
+
+- **Three new built-in critic sets** in `src/evolution/multi-critic.ts`:
+  - `RESEARCH_PROMPTS` — for agents that synthesise external sources into
+    structured research reports. Scores source quality + multi-engine
+    coverage, analytical depth + synthesis, completeness + decision-value.
+    Use when your agent's output is a research brief, market analysis,
+    competitor scan, paper summary, or technology deep-dive.
+  - `CRITIC_AGENT_PROMPTS` — for agents whose job is critiquing other work
+    (devil's advocate, RFC-review, design-review). Scores fairness +
+    steelmanning, counter-argument depth + blind-spot detection, actionability
+    + clear verdict.
+  - `ANALYST_PROMPTS` — for agents that produce code/architecture analysis
+    (repository audits, refactoring proposals, tech-debt reports). Scores
+    technical accuracy with file:line references, pattern recognition,
+    recommendation quality with security + effort + risk estimates.
+
+  These three previously fell back to `INVESTIGATOR_PROMPTS` — which scored
+  them by the wrong criteria (e.g. code-analysis got dinged for "no URLs
+  cited" because it cited file paths instead). The anti-fallback regression
+  test in `tests/multi-critic.test.ts` locks the fix.
+
+- **`examples/closed-loop-feedback.ts`** — backend-agnostic pattern for
+  piping Darwin multi-critic findings into your own memory store so the
+  next agent run sees them as context. Symmetric (writes both successes
+  and failures), matches the Hermes Agent v0.8.0 (NousResearch, MIT)
+  self-evolution pattern.
+
+  Decision logic (`shouldPersist`):
+  - `medianScore < 5` → polarity `mistake` (failure mode to watch)
+  - `medianScore >= 8` → polarity `pattern` (success pattern to reproduce)
+  - middle band → not persisted (mediocre runs are noise)
+
+  Plus guards for NaN/Infinity scores, all-critics-failed, and short
+  outputs (likely CLI failures). 38 unit tests in
+  `tests/closed-loop-feedback.test.ts`.
+
+- **`examples/staleness-monitor.ts`** — detect agents that stopped firing
+  or were configured-but-never-fired. The latter is a silent failure mode
+  many production fleets hit: agent added to `AGENT_CRITIC_MAP`, wiring
+  missed on caller side, agent looks "configured" but produces zero data.
+
+  Four statuses: `active` / `stale` / `dead` / `never-tracked`. Pure
+  classifier + report builder + format helper, plus a `STALENESS_SQL`
+  constant ready for your `pg` Pool. 16 unit tests in
+  `tests/staleness-monitor.test.ts`.
+
+### Changed
+
+- `getCriticPrompts('research' | 'researcher' | 'critic' | 'analyst')` now
+  returns dedicated sets instead of falling back to investigator. Adds
+  `researcher` as an alias of `research` for backwards compatibility.
+- `AGENT_OUTPUT_LABELS` extended for the new agent types.
+- README: new "Closed-Loop & Observability" section pointing to the two
+  example files.
+- Examples README expanded with the two new pattern entries.
+
+### Tests
+
+- 12 new tests in `multi-critic.test.ts` — critic-set coverage + 3
+  anti-fallback regression assertions (analyst, research, critic must NOT
+  use investigator's set).
+- 38 new tests in `closed-loop-feedback.test.ts` — polarity logic, content
+  + tag + confidence builders, persist orchestration, store-failure
+  handling.
+- 16 new tests in `staleness-monitor.test.ts` — classifier boundaries,
+  observed-vs-expected merging, format output.
+
+Total: 66 new tests on top of the existing 140. All green, `tsc` clean.
+
+## [Unreleased] — Round-4 OSS-Sweep (2026-04-24)
+
+Triple-agent review on the v0.4.5 OSS tree surfaced two defects that had
+been documented-but-unshipped in earlier internal reviews.
+
+### Security
+
+- **`spawn('claude')` no longer leaks user Anthropic API credentials to
+  the subprocess.** `ANTHROPIC_API_KEY` and `ANTHROPIC_AUTH_TOKEN` are now
+  stripped from the cleaned env before the Claude CLI is invoked, matching
+  the behaviour that `agent-fleet` shipped in Session 837. Without this
+  strip, any Darwin user with an API key in their shell was being billed
+  at full API rates for every experiment run instead of consuming their
+  paid Claude Pro / Max subscription. Opt back in with
+  `DARWIN_USE_API_KEY=1` for CI or server-side usage where a billed key is
+  the intended credential.
+
+### Added
+
+- **Process-lifetime budget caps in `src/core/runner.ts`.** A runaway
+  A/B-critic-convergence loop could previously fire hundreds of paid
+  provider calls before anyone noticed. Two opt-out ceilings now short-
+  circuit the runner **before** the next LLM call:
+  - `DARWIN_MAX_RUNS_PER_PROCESS` (default `100`, `0` = disabled)
+  - `DARWIN_MAX_RUN_WALL_MS` (default `3_600_000` = 1 h, `0` = disabled)
+  Exceeding either throws a new `DarwinBudgetError` with the budget name.
+  Test helpers `setMaxRunsPerProcess` / `setMaxRunWallMs` /
+  `resetRunCounters` are exported from `src/core/runner` for wiring-tests.
+- **3 new regression tests** (`tests/budget-caps.test.ts`): runs-cap trip,
+  0 = disabled, wall-clock-cap trip. Total test count: 130 → 133 (all
+  green).
+
+## 1.0.0
+
+Initial public release.

package/README.md

@@ -131,9 +131,72 @@ Each agent ships with a dedicated **multi-critic set** that scores the output by
 
 Two production patterns Darwin users commonly need but had to build themselves:
 
-- [`examples/closed-loop-feedback.ts`](examples/closed-loop-feedback.ts) — pipe critic findings into your own memory store so the next run sees them. Symmetric (writes both successes and failures), backend-agnostic. Matches the Hermes Agent v0.8.0 self-evolution pattern.
+- [`examples/closed-loop-feedback.ts`](examples/closed-loop-feedback.ts) — pipe critic findings into your own memory store so the next run sees them. Symmetric (writes both successes and failures), backend-agnostic. Aligned with reflective self-improvement patterns like [GEPA (ICLR 2026 Oral)](https://arxiv.org/abs/2507.19457) and NousResearch's `hermes-agent-self-evolution` loop.
 - [`examples/staleness-monitor.ts`](examples/staleness-monitor.ts) — detect agents that stopped firing, or were configured but never fired. Pure classifier + format helpers + ready-made SQL. Wire to your own cron + alert webhook.
 
+## Memory Integration (v0.4.7 — works with any MCP-compliant memory server)
+
+Closes the loop in three lines. Defaults to zero-config local memory; one
+config switch points at Mem0 / Zep / Letta / Cognee / a self-hosted MCP
+server / your own.
+
+### Why this is different
+
+Existing self-evolving agent frameworks pick one memory backend and stay
+there. Existing MCP-memory servers (Mem0, Zep, Letta, MemPalace,
+agentmemory, brainctl) optimize for storage, not for closed-loop critic
+feedback. Darwin v0.4.7 is the first MIT-licensed, TypeScript-native,
+MCP-native combination of **pluggable memory** + **symmetric self-evolution**
+(score < 5 → `mistake`, score ≥ 8 → `pattern`, mediocre middle band → not
+persisted). No vendor lock-in, no cloud required by default, swap-able to
+Mem0/Zep/Letta with two config lines.
+
+```typescript
+import { localMemory, remoteMemory } from 'darwin-agents/memory/bridge';
+import { runClosedLoopTurn } from 'darwin-agents/memory/closed-loop';
+
+// Default: spawn @studiomeyer/local-memory-mcp via npx — zero cloud, zero keys
+const memory = localMemory();
+
+// Or any remote MCP-Memory server
+// const memory = remoteMemory('https://your-mcp.example.com/mcp', { authHeader: `Bearer ${KEY}` });
+
+// Or Mem0 with tool-name + arg aliasing
+// const memory = remoteMemory('https://api.mem0.ai/mcp', {
+//   authHeader: `Bearer ${process.env.MEM0_KEY}`,
+//   writeTool: 'mem0_add',
+//   readTool: 'mem0_search',
+//   mapWriteArgs: (rec) => ({ messages: [{ role: 'user', content: rec.content }], metadata: { tags: rec.tags } }),
+// });
+
+const result = await runClosedLoopTurn(
+  { agentName: 'analyst', topic: 'Audit module X' },
+  { runner: yourAgentRunner, store: memory },
+);
+// Run 1 sees zero lessons. Run 2 sees Run 1's findings as context.
+```
+
+### Provider matrix
+
+| Provider | `writeTool` | `readTool` | Notes |
+|---|---|---|---|
+| **`@studiomeyer/local-memory-mcp`** (default) | `memory_learn` | `memory_search` | zero-config, single SQLite file, no cloud |
+| Any self-hosted MCP-Memory server | `memory_learn` | `memory_search` | same wire, remote endpoint |
+| Mem0 MCP | `mem0_add` | `mem0_search` | needs `mapWriteArgs` for the `messages` shape |
+| Zep MCP | `zep_add` | `zep_search` | optional `mapWriteArgs` for `group_id` |
+| Letta MCP | `archival_insert` | `archival_search` | optional `mapReadResult` for their envelope |
+| Cognee MCP | `cognee_add` | `cognee_search` | optional mappers |
+
+Why an MCP-shaped bridge? Because the wire is the same — only tool names
+and arg shapes vary. One bridge, one reconnect path, one timeout policy.
+The pattern matches the [MCP Bridge proxy paper (arXiv 2504.08999)](https://arxiv.org/html/2504.08999v2)
+but stays inside the Darwin process — no extra service to deploy.
+
+See [`examples/memory-darwin-integration.ts`](examples/memory-darwin-integration.ts)
+for the full closed-loop pattern: fetch relevant lessons → render them as
+prompt context → run the agent → persist critic findings → next run sees
+last run's lessons.
+
 ## How Evolution Works
 
 <!-- REAL_METRICS_START -->

package/dist/examples/closed-loop-feedback.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Example: Closed-Loop Feedback Persistence (Darwin → External Memory)
+ *
+ * After Darwin's multi-critic evaluates an agent run, this example shows
+ * how to persist critic findings as external lessons that the NEXT agent
+ * run can consult. We call the polarity rule "symmetric self-evolution"
+ * because it writes BOTH success patterns and failure modes — not only
+ * one side. This is structurally aligned with reflective self-improvement
+ * approaches like GEPA (Genetic-Pareto, ICLR 2026 Oral, arXiv 2507.19457)
+ * and the closed-loop pattern used by NousResearch's hermes-agent-self-
+ * evolution repo.
+ *
+ * Why a separate persistence layer?
+ *  - darwin_db.darwin_experiments.feedback_report is great for analytics
+ *    but it never reaches the agent's prompt on the next run
+ *  - If your agents already read from a memory store (Mem0, Zep, Letta,
+ *    Cognee, a Postgres table, or even a markdown directory), pipe the
+ *    critic findings into THAT store so the next run sees them as context
+ *
+ * This example uses an in-memory store for demonstration. Replace with
+ * your real backend (database, vector store, file system, etc.).
+ *
+ * Run: npx tsx examples/closed-loop-feedback.ts
+ */
+import type { MultiCriticResult } from '../src/evolution/multi-critic.js';
+export type FeedbackPolarity = 'mistake' | 'pattern';
+export interface FeedbackInput {
+    /** Darwin agent name (matches AGENT_CRITIC_MAP key). */
+    agentName: string;
+    /** The original task / prompt the agent ran. */
+    topic: string;
+    /** Length of the agent's output in characters. */
+    outputLength: number;
+    /** Median critic score (0-10). */
+    medianScore: number;
+    /** Combined report text from all critics. */
+    combinedReport: string;
+    /** Per-critic scores (NEGATIVE score = critic failed). */
+    criticScores: Array<{
+        critic: string;
+        score: number;
+    }>;
+}
+export interface FeedbackRecord {
+    polarity: FeedbackPolarity;
+    content: string;
+    tags: string[];
+    /** 0-1, higher = more confident this is a real signal. */
+    confidence: number;
+}
+/** Pluggable storage backend. Implement against your real store. */
+export interface FeedbackStore {
+    save(record: FeedbackRecord): Promise<void>;
+}
+/** Below this score → persist as 'mistake'. */
+export declare const DEFAULT_LOW_THRESHOLD = 5;
+/** At/above this score → persist as 'pattern'. */
+export declare const DEFAULT_HIGH_THRESHOLD = 8;
+/** Skip persistence when output is below this length (likely CLI failure). */
+export declare const DEFAULT_MIN_OUTPUT_CHARS = 200;
+/**
+ * Decide whether to persist this run and which polarity.
+ * Mid-range scores (5..8) are intentionally NOT persisted — mediocre runs
+ * are noise. We want strong signal in both directions.
+ */
+export declare function shouldPersist(input: FeedbackInput, options?: {
+    lowThreshold?: number;
+    highThreshold?: number;
+    minOutputChars?: number;
+}): {
+    persist: boolean;
+    reason: string;
+    polarity?: FeedbackPolarity;
+};
+export declare function buildContent(input: FeedbackInput, polarity: FeedbackPolarity): string;
+export declare function buildTags(input: FeedbackInput, polarity: FeedbackPolarity): string[];
+export declare function computeConfidence(input: FeedbackInput, polarity: FeedbackPolarity): number;
+/**
+ * Persist a Darwin critic result to your external memory store.
+ * Non-blocking — store errors are caught and surfaced as { persisted: false }.
+ */
+export declare function persistFeedback(input: FeedbackInput, store: FeedbackStore, options?: {
+    lowThreshold?: number;
+    highThreshold?: number;
+    minOutputChars?: number;
+}): Promise<{
+    persisted: boolean;
+    reason: string;
+    polarity?: FeedbackPolarity;
+}>;
+/**
+ * Bridge a Darwin MultiCriticResult into FeedbackInput shape.
+ * Pure helper — no I/O.
+ */
+export declare function fromMultiCriticResult(result: MultiCriticResult, meta: {
+    agentName: string;
+    topic: string;
+    outputLength: number;
+}): FeedbackInput;
+//# sourceMappingURL=closed-loop-feedback.d.ts.map

package/dist/examples/closed-loop-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"closed-loop-feedback.d.ts","sourceRoot":"","sources":["../../examples/closed-loop-feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAI1E,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,YAAY,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAID,+CAA+C;AAC/C,eAAO,MAAM,qBAAqB,IAAM,CAAC;AACzC,kDAAkD;AAClD,eAAO,MAAM,sBAAsB,IAAM,CAAC;AAC1C,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAI5C;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,GACL;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAwBnE;AAID,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CA6BrF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAWpF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAO1F;AAID;;;GAGG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,GACL,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAkB9E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC/D,aAAa,CASf"}

package/dist/examples/closed-loop-feedback.js

@@ -0,0 +1,199 @@
+/**
+ * Example: Closed-Loop Feedback Persistence (Darwin → External Memory)
+ *
+ * After Darwin's multi-critic evaluates an agent run, this example shows
+ * how to persist critic findings as external lessons that the NEXT agent
+ * run can consult. We call the polarity rule "symmetric self-evolution"
+ * because it writes BOTH success patterns and failure modes — not only
+ * one side. This is structurally aligned with reflective self-improvement
+ * approaches like GEPA (Genetic-Pareto, ICLR 2026 Oral, arXiv 2507.19457)
+ * and the closed-loop pattern used by NousResearch's hermes-agent-self-
+ * evolution repo.
+ *
+ * Why a separate persistence layer?
+ *  - darwin_db.darwin_experiments.feedback_report is great for analytics
+ *    but it never reaches the agent's prompt on the next run
+ *  - If your agents already read from a memory store (Mem0, Zep, Letta,
+ *    Cognee, a Postgres table, or even a markdown directory), pipe the
+ *    critic findings into THAT store so the next run sees them as context
+ *
+ * This example uses an in-memory store for demonstration. Replace with
+ * your real backend (database, vector store, file system, etc.).
+ *
+ * Run: npx tsx examples/closed-loop-feedback.ts
+ */
+// ─── Default thresholds ──────────────────────────────
+/** Below this score → persist as 'mistake'. */
+export const DEFAULT_LOW_THRESHOLD = 5.0;
+/** At/above this score → persist as 'pattern'. */
+export const DEFAULT_HIGH_THRESHOLD = 8.0;
+/** Skip persistence when output is below this length (likely CLI failure). */
+export const DEFAULT_MIN_OUTPUT_CHARS = 200;
+// ─── Decision logic ───────────────────────────────────
+/**
+ * Decide whether to persist this run and which polarity.
+ * Mid-range scores (5..8) are intentionally NOT persisted — mediocre runs
+ * are noise. We want strong signal in both directions.
+ */
+export function shouldPersist(input, options = {}) {
+    const low = options.lowThreshold ?? DEFAULT_LOW_THRESHOLD;
+    const high = options.highThreshold ?? DEFAULT_HIGH_THRESHOLD;
+    const minOut = options.minOutputChars ?? DEFAULT_MIN_OUTPUT_CHARS;
+    if (!Number.isFinite(input.medianScore)) {
+        return { persist: false, reason: 'score-not-finite' };
+    }
+    if (input.medianScore <= 0) {
+        return { persist: false, reason: 'all-critics-failed' };
+    }
+    if (input.criticScores.filter((c) => c.score > 0).length === 0) {
+        return { persist: false, reason: 'no-valid-critic-scores' };
+    }
+    if (input.outputLength < minOut) {
+        return { persist: false, reason: 'output-too-short' };
+    }
+    if (input.medianScore < low) {
+        return { persist: true, reason: 'below-low-threshold', polarity: 'mistake' };
+    }
+    if (input.medianScore >= high) {
+        return { persist: true, reason: 'above-high-threshold', polarity: 'pattern' };
+    }
+    return { persist: false, reason: 'score-in-mediocre-band' };
+}
+// ─── Record builders ─────────────────────────────────
+export function buildContent(input, polarity) {
+    const scores = input.criticScores
+        .map((c) => `${c.critic}: ${c.score > 0 ? c.score.toFixed(1) : 'FAILED'}/10`)
+        .join(', ');
+    const reportExcerpt = input.combinedReport.length > 1200
+        ? input.combinedReport.slice(0, 1197) + '...'
+        : input.combinedReport;
+    const topic = input.topic.length > 200
+        ? input.topic.slice(0, 197) + '...'
+        : input.topic;
+    const isMistake = polarity === 'mistake';
+    const headline = isMistake
+        ? `Darwin multi-critic flagged ${input.agentName} as low quality (${input.medianScore.toFixed(1)}/10) on task "${topic}".`
+        : `Darwin multi-critic scored ${input.agentName} as high quality (${input.medianScore.toFixed(1)}/10) on task "${topic}".`;
+    const tail = isMistake
+        ? `Recurring failure mode to watch out for in future ${input.agentName} runs.`
+        : `Recurring success pattern to reproduce in future ${input.agentName} runs.`;
+    return [
+        headline,
+        `Critic breakdown: ${scores}.`,
+        `Output length: ${input.outputLength} chars.`,
+        '',
+        'Critic feedback excerpt:',
+        reportExcerpt,
+        '',
+        tail,
+    ].join('\n');
+}
+export function buildTags(input, polarity) {
+    const polarityTag = polarity === 'mistake' ? 'low-quality' : 'high-quality';
+    const tags = ['darwin-feedback', polarityTag, `agent:${input.agentName}`];
+    const valid = input.criticScores.filter((c) => c.score > 0);
+    if (valid.length > 0) {
+        const target = polarity === 'mistake'
+            ? valid.reduce((a, b) => (a.score <= b.score ? a : b))
+            : valid.reduce((a, b) => (a.score >= b.score ? a : b));
+        tags.push(`critic:${target.critic}`);
+    }
+    return tags;
+}
+export function computeConfidence(input, polarity) {
+    if (polarity === 'mistake') {
+        // Lower score → more confident this is a real issue. Clamp [0.5, 0.9].
+        return Math.max(0.5, Math.min(0.9, 1.0 - input.medianScore / 10));
+    }
+    // pattern: higher score → more confident this is reproducible. Clamp [0.5, 0.9].
+    return Math.max(0.5, Math.min(0.9, 0.5 + (input.medianScore - DEFAULT_HIGH_THRESHOLD) / 5));
+}
+// ─── Main entry point ─────────────────────────────────
+/**
+ * Persist a Darwin critic result to your external memory store.
+ * Non-blocking — store errors are caught and surfaced as { persisted: false }.
+ */
+export async function persistFeedback(input, store, options = {}) {
+    const decision = shouldPersist(input, options);
+    if (!decision.persist || !decision.polarity) {
+        return { persisted: false, reason: decision.reason };
+    }
+    try {
+        const record = {
+            polarity: decision.polarity,
+            content: buildContent(input, decision.polarity),
+            tags: buildTags(input, decision.polarity),
+            confidence: computeConfidence(input, decision.polarity),
+        };
+        await store.save(record);
+        return { persisted: true, reason: decision.reason, polarity: decision.polarity };
+    }
+    catch (err) {
+        console.warn(`[closed-loop] persist failed: ${err.message}`);
+        return { persisted: false, reason: 'store-error' };
+    }
+}
+/**
+ * Bridge a Darwin MultiCriticResult into FeedbackInput shape.
+ * Pure helper — no I/O.
+ */
+export function fromMultiCriticResult(result, meta) {
+    return {
+        agentName: meta.agentName,
+        topic: meta.topic,
+        outputLength: meta.outputLength,
+        medianScore: result.medianScore,
+        combinedReport: result.combinedReport,
+        criticScores: result.critics.map((c) => ({ critic: c.critic, score: c.score })),
+    };
+}
+// ─── Demo: in-memory store ────────────────────────────
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const inMemoryStore = {
+        async save(record) {
+            console.log('[in-memory-store] saved:', {
+                polarity: record.polarity,
+                tags: record.tags,
+                confidence: record.confidence,
+                contentPreview: record.content.slice(0, 100) + '...',
+            });
+        },
+    };
+    // Demo 1: low-score → mistake
+    await persistFeedback({
+        agentName: 'analyst',
+        topic: 'Audit module X for tech debt',
+        outputLength: 5000,
+        medianScore: 3.5,
+        combinedReport: 'Analyst missed two security issues. Recommendations vague.',
+        criticScores: [
+            { critic: 'technical-accuracy', score: 3 },
+            { critic: 'pattern-recognition', score: 4 },
+            { critic: 'recommendation-quality', score: 3 },
+        ],
+    }, inMemoryStore);
+    // Demo 2: high-score → pattern
+    await persistFeedback({
+        agentName: 'analyst',
+        topic: 'Audit module Y for tech debt',
+        outputLength: 6500,
+        medianScore: 9.0,
+        combinedReport: 'Analyst surfaced 4 concrete issues, all with file:line refs and effort estimates.',
+        criticScores: [
+            { critic: 'technical-accuracy', score: 9 },
+            { critic: 'pattern-recognition', score: 9 },
+            { critic: 'recommendation-quality', score: 9 },
+        ],
+    }, inMemoryStore);
+    // Demo 3: mediocre-band → NOT persisted
+    const result3 = await persistFeedback({
+        agentName: 'analyst',
+        topic: 'Audit module Z',
+        outputLength: 5000,
+        medianScore: 6.5,
+        combinedReport: 'OK but unremarkable.',
+        criticScores: [{ critic: 'a', score: 6 }, { critic: 'b', score: 7 }, { critic: 'c', score: 6 }],
+    }, inMemoryStore);
+    console.log('[demo 3] skipped:', result3.reason);
+}
+//# sourceMappingURL=closed-loop-feedback.js.map

package/dist/examples/closed-loop-feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"closed-loop-feedback.js","sourceRoot":"","sources":["../../examples/closed-loop-feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAoCH,wDAAwD;AAExD,+CAA+C;AAC/C,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,kDAAkD;AAClD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAC1C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C,yDAAyD;AAEzD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAoB,EACpB,UAII,EAAE;IAEN,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,IAAI,qBAAqB,CAAC;IAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,IAAI,sBAAsB,CAAC;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC;IAElE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACxD,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;IAC9D,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,GAAG,MAAM,EAAE,CAAC;QAChC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACxD,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC/E,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,sBAAsB,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAChF,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;AAC9D,CAAC;AAED,wDAAwD;AAExD,MAAM,UAAU,YAAY,CAAC,KAAoB,EAAE,QAA0B;IAC3E,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC;SAC5E,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,aAAa,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,IAAI;QACtD,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,KAAK;QAC7C,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;IACzB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG;QACpC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK;QACnC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IAEhB,MAAM,SAAS,GAAG,QAAQ,KAAK,SAAS,CAAC;IACzC,MAAM,QAAQ,GAAG,SAAS;QACxB,CAAC,CAAC,+BAA+B,KAAK,CAAC,SAAS,oBAAoB,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,KAAK,IAAI;QAC1H,CAAC,CAAC,8BAA8B,KAAK,CAAC,SAAS,qBAAqB,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,KAAK,IAAI,CAAC;IAC7H,MAAM,IAAI,GAAG,SAAS;QACpB,CAAC,CAAC,qDAAqD,KAAK,CAAC,SAAS,QAAQ;QAC9E,CAAC,CAAC,oDAAoD,KAAK,CAAC,SAAS,QAAQ,CAAC;IAEhF,OAAO;QACL,QAAQ;QACR,qBAAqB,MAAM,GAAG;QAC9B,kBAAkB,KAAK,CAAC,YAAY,SAAS;QAC7C,EAAE;QACF,0BAA0B;QAC1B,aAAa;QACb,EAAE;QACF,IAAI;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAoB,EAAE,QAA0B;IACxE,MAAM,WAAW,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC;IAC5E,MAAM,IAAI,GAAG,CAAC,iBAAiB,EAAE,WAAW,EAAE,SAAS,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,QAAQ,KAAK,SAAS;YACnC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAoB,EAAE,QAA0B;IAChF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,uEAAuE;QACvE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,KAAK,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,iFAAiF;IACjF,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED,yDAAyD;AAEzD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAoB,EACpB,KAAoB,EACpB,UAII,EAAE;IAEN,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC5C,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IACvD,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAmB;YAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,OAAO,EAAE,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC;YAC/C,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC;YACzC,UAAU,EAAE,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC;SACxD,CAAC;QACF,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;IACnF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,iCAAkC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACxE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACrD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAyB,EACzB,IAAgE;IAEhE,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;KAChF,CAAC;AACJ,CAAC;AAED,yDAAyD;AAEzD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,MAAM,aAAa,GAAkB;QACnC,KAAK,CAAC,IAAI,CAAC,MAAM;YACf,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE;gBACtC,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK;aACrD,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,8BAA8B;IAC9B,MAAM,eAAe,CAAC;QACpB,SAAS,EAAE,SAAS;QACpB,KAAK,EAAE,8BAA8B;QACrC,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,GAAG;QAChB,cAAc,EAAE,4DAA4D;QAC5E,YAAY,EAAE;YACZ,EAAE,MAAM,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,EAAE;YAC1C,EAAE,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,CAAC,EAAE;YAC3C,EAAE,MAAM,EAAE,wBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE;SAC/C;KACF,EAAE,aAAa,CAAC,CAAC;IAElB,+BAA+B;IAC/B,MAAM,eAAe,CAAC;QACpB,SAAS,EAAE,SAAS;QACpB,KAAK,EAAE,8BAA8B;QACrC,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,GAAG;QAChB,cAAc,EAAE,mFAAmF;QACnG,YAAY,EAAE;YACZ,EAAE,MAAM,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,EAAE;YAC1C,EAAE,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,CAAC,EAAE;YAC3C,EAAE,MAAM,EAAE,wBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE;SAC/C;KACF,EAAE,aAAa,CAAC,CAAC;IAElB,wCAAwC;IACxC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;QACpC,SAAS,EAAE,SAAS;QACpB,KAAK,EAAE,gBAAgB;QACvB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,GAAG;QAChB,cAAc,EAAE,sBAAsB;QACtC,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;KAChG,EAAE,aAAa,CAAC,CAAC;IAClB,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;AACnD,CAAC"}

package/dist/examples/custom-agent.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Example: Defining a Custom Darwin Agent
+ *
+ * This shows how to create a fully configured agent with evolution,
+ * custom metric weights, and MCP tool access.
+ *
+ * Run: npx tsx examples/custom-agent.ts
+ */
+export {};
+//# sourceMappingURL=custom-agent.d.ts.map

package/dist/examples/custom-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-agent.d.ts","sourceRoot":"","sources":["../../examples/custom-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}