/** * Agenticow MCP Tools — Copy-On-Write memory branching surface. * * Exposes `agenticow@~0.2.3` (a sibling RVF-based COW vector store by the same * author as ruflo) as MCP tools so agents can branch, checkpoint, rollback, * and promote memory state without copying GB-scale `.rvf` files. * * Motivation: * The v3.14.4 release uncovered a tarball-bloat regression where Darwin * loops' git-worktree-per-agent pattern accumulated 3.3 GB of disk. The * structural cause was full-copy snapshot semantics. Measured agenticow * branches are exactly 162 bytes regardless of base size (see * `docs/agenticow/findings.md` for the bench data). * * Architectural constraint (mirrors metaharness-tools.ts / testgen-tools.ts): * - `agenticow` lives in `optionalDependencies` — must NOT be a hard runtime dep * - When the package is missing, every tool returns * `{success: true, degraded: true, reason: 'agenticow-not-found'}` * so callers see one contract regardless of install state * * Measured performance vs published claims (agenticow@0.2.3): * ✅ 162-byte branches — confirmed exact * ✅ 3,000×–180,000× smaller than full-copy at N=1k–50k * ❌ 0.5 ms branch — measured ~10ms (fixed cost, not size-proportional) * ❌ 83× faster — only beats full-copy past N ≈ 30k crossover * * Use cases (per ADR / findings doc): * - Per-Darwin-iteration memory branching (eliminates worktree bloat) * - Per-user / per-session personalization (cheap fork, no full copy) * - Federation: branch → promote back as merge semantics * * @module @claude-flow/cli/mcp-tools/agenticow */ import type { MCPTool } from './types.js'; export declare const agenticowTools: MCPTool[]; //# sourceMappingURL=agenticow-tools.d.ts.map