darwin-agents 0.4.5 → 0.4.7

package/dist/examples/mcp-memory-bridge.js

@@ -0,0 +1,542 @@
+/**
+ * Example: Generic MCP-Memory Bridge (Darwin → any MCP-compliant memory server)
+ *
+ * Wraps the `FeedbackStore` interface from closed-loop-feedback.ts with a
+ * thin JSON-RPC 2.0 client for MCP. Works with any MCP server that exposes
+ * a write tool (e.g. `memory_learn`) and a read tool (e.g. `memory_search`).
+ *
+ * Default wiring targets `@studiomeyer/local-memory-mcp` (zero-config, lives
+ * in a single SQLite file under the OS data dir, no cloud, no API keys).
+ * Drop in Mem0 / Zep / Letta / Cognee / your own self-hosted MCP server by
+ * overriding `writeTool` / `readTool` and providing schema mappers.
+ *
+ * Why raw JSON-RPC and not @modelcontextprotocol/sdk?
+ *  - Darwin keeps a "zero hard deps" policy (peerDependencies only).
+ *  - MCP wire protocol is three messages: initialize, tools/list, tools/call.
+ *  - Keeps the bridge testable without a mock SDK.
+ *
+ * Why a single bridge instead of per-provider clients?
+ *  - The wire is the same. Only tool names and arg/result shapes vary.
+ *  - One reconnect / lifecycle path, one place to harden timeouts.
+ *
+ * Run demo (requires `@studiomeyer/local-memory-mcp` installed):
+ *   npm install -g @studiomeyer/local-memory-mcp
+ *   npx tsx examples/mcp-memory-bridge.ts
+ */
+import { spawn } from 'node:child_process';
+import { setTimeout as delay } from 'node:timers/promises';
+// ─── Defaults ────────────────────────────────────────
+const DEFAULT_WRITE_TOOL = 'memory_learn';
+const DEFAULT_READ_TOOL = 'memory_search';
+const DEFAULT_REQUEST_TIMEOUT_MS = 10_000;
+const DEFAULT_MAX_RESPAWN = 1;
+const DEFAULT_HTTP_MAX_RETRIES = 2;
+const DEFAULT_PROTOCOL_VERSION = '2025-11-25';
+/** Default mapping for `memory_learn` shape (local-memory-mcp, mcp-nex). */
+export function defaultMapWriteArgs(rec) {
+    return {
+        category: rec.polarity === 'mistake' ? 'mistake' : 'pattern',
+        content: rec.content,
+        tags: rec.tags,
+        confidence: rec.confidence,
+        source: 'automated',
+        memoryType: 'semantic',
+    };
+}
+/**
+ * Default mapping for `memory_search` shape.
+ * Accepts both the raw MCP CallToolResult shape `{content:[{text:JSON}]}`
+ * and a pre-parsed object — that keeps the parser tolerant when a custom
+ * server returns structured content directly.
+ */
+export function defaultMapReadResult(raw) {
+    const parsed = extractStructured(raw);
+    if (!parsed || typeof parsed !== 'object')
+        return [];
+    // Common envelope shapes observed in the wild across MCP-Memory servers:
+    //   { success, data: { results: [{ body, ... }] } }
+    //   { success, data: { results: [{ content, tags }] } }
+    //   { results: [...] }
+    //   [...] (plain array)
+    const envelope = parsed;
+    const data = (envelope.data ?? envelope);
+    const results = (data.results ?? envelope.results ?? envelope);
+    if (!Array.isArray(results))
+        return [];
+    const out = [];
+    for (const item of results) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const row = item;
+        const content = typeof row.content === 'string'
+            ? row.content
+            : typeof row.body === 'string'
+                ? row.body
+                : typeof row.text === 'string'
+                    ? row.text
+                    : null;
+        if (!content)
+            continue;
+        const tags = Array.isArray(row.tags)
+            ? row.tags.filter((t) => typeof t === 'string')
+            : [];
+        const scoreRaw = row.score ?? row.rank ?? row.rrfScore;
+        const score = typeof scoreRaw === 'number' && Number.isFinite(scoreRaw) ? scoreRaw : undefined;
+        out.push({ content, tags, score });
+    }
+    return out;
+}
+/** Pull structured payload out of an MCP CallToolResult envelope. */
+function extractStructured(raw) {
+    if (raw == null || typeof raw !== 'object')
+        return raw;
+    const r = raw;
+    if (Array.isArray(r.content)) {
+        for (const block of r.content) {
+            if (block?.type === 'text' && typeof block.text === 'string') {
+                try {
+                    return JSON.parse(block.text);
+                }
+                catch {
+                    return block.text;
+                }
+            }
+        }
+    }
+    if ('structuredContent' in r && r.structuredContent != null)
+        return r.structuredContent;
+    return raw;
+}
+/**
+ * Generic MCP-Memory bridge.
+ *
+ * Lifecycle:
+ *   const m = openLocalMemory();         // or openRemoteMemory(...)
+ *   await m.save({...});                  // FeedbackStore.save
+ *   const lessons = await m.fetchRelevant({ query: 'topic', limit: 5 });
+ *   await m.close();
+ *
+ * Errors in save/fetch are swallowed at the FeedbackStore level (the
+ * closed-loop callsite logs them) — the bridge surfaces them as thrown
+ * Errors so the caller decides whether to fail-loud or fail-quiet.
+ */
+export class McpMemoryBridge {
+    config;
+    child = null;
+    nextId = 1;
+    pending = new Map();
+    stdoutBuffer = '';
+    respawnCount = 0;
+    initialized = false;
+    initInFlight = null;
+    closed = false;
+    constructor(config) {
+        this.config = {
+            transport: config.transport,
+            endpoint: config.endpoint,
+            authHeader: config.authHeader,
+            writeTool: config.writeTool ?? DEFAULT_WRITE_TOOL,
+            readTool: config.readTool ?? DEFAULT_READ_TOOL,
+            mapWriteArgs: config.mapWriteArgs ?? defaultMapWriteArgs,
+            mapReadResult: config.mapReadResult ?? defaultMapReadResult,
+            requestTimeoutMs: config.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
+            maxRespawn: config.maxRespawn ?? DEFAULT_MAX_RESPAWN,
+            httpMaxRetries: config.httpMaxRetries ?? DEFAULT_HTTP_MAX_RETRIES,
+            protocolVersion: config.protocolVersion ?? DEFAULT_PROTOCOL_VERSION,
+            logger: config.logger ?? {
+                warn: (msg) => console.warn(`[mcp-memory-bridge] ${msg}`),
+            },
+        };
+    }
+    // ── FeedbackStore.save ─────────────────────────────
+    async save(record) {
+        await this.callTool(this.config.writeTool, this.config.mapWriteArgs(record));
+    }
+    // ── RetrievableFeedbackStore.fetchRelevant ─────────
+    async fetchRelevant(queryOrOpts, legacyLimit) {
+        const opts = typeof queryOrOpts === 'string'
+            ? { query: queryOrOpts, limit: legacyLimit }
+            : queryOrOpts;
+        const args = { query: opts.query, limit: opts.limit ?? 5 };
+        if (opts.tags && opts.tags.length > 0)
+            args.tags = opts.tags;
+        const result = await this.callTool(this.config.readTool, args);
+        return this.config.mapReadResult(result);
+    }
+    // ── Lifecycle ──────────────────────────────────────
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.initInFlight = null; // F5: cleared so callers awaiting a stale promise hit closed-bridge guard
+        if (this.child) {
+            const c = this.child;
+            this.child = null;
+            try {
+                c.kill('SIGTERM');
+            }
+            catch {
+                // ignore — already dead
+            }
+        }
+        for (const [, p] of this.pending) {
+            clearTimeout(p.timer);
+            p.reject(new Error('bridge closed'));
+        }
+        this.pending.clear();
+    }
+    // ── Internals ──────────────────────────────────────
+    async ensureReady() {
+        if (this.closed)
+            throw new Error('bridge is closed');
+        if (this.initialized)
+            return;
+        if (!this.initInFlight) {
+            // F4: do NOT auto-clear initInFlight in .catch. Leave the rejected
+            // promise in place so concurrent awaiters all see the same failure;
+            // the next caller after the failure makes a fresh attempt.
+            this.initInFlight = this.initialize();
+        }
+        // Snapshot the promise reference so concurrent failed-init callers
+        // don't wipe a newer in-flight promise on cleanup (R2 narrow race).
+        const myPromise = this.initInFlight;
+        try {
+            await myPromise;
+        }
+        catch (err) {
+            // Reset only if no fresher attempt has replaced ours.
+            if (!this.initialized && this.initInFlight === myPromise) {
+                this.initInFlight = null;
+            }
+            throw err;
+        }
+    }
+    async initialize() {
+        if (this.config.transport === 'stdio') {
+            this.spawnStdio();
+        }
+        // initialize handshake (per MCP spec 2025-11-25)
+        await this.rpc('initialize', {
+            protocolVersion: this.config.protocolVersion,
+            capabilities: {},
+            clientInfo: { name: 'darwin-mcp-memory-bridge', version: '0.4.7' },
+        });
+        // best-effort notify; the server doesn't reply to notifications
+        if (this.config.transport === 'stdio' && this.child) {
+            this.sendStdio({
+                jsonrpc: '2.0',
+                method: 'notifications/initialized',
+                params: {},
+            });
+        }
+        this.initialized = true;
+        // F4: keep initInFlight set to the resolved promise; ensureReady's
+        // early-return path on `initialized=true` covers all subsequent calls.
+        // onChildExit nulls it on crash, close() nulls it on shutdown.
+    }
+    spawnStdio() {
+        const cmd = Array.isArray(this.config.endpoint)
+            ? this.config.endpoint
+            : [this.config.endpoint];
+        if (cmd.length === 0)
+            throw new Error('stdio endpoint must have at least one entry');
+        const [bin, ...args] = cmd;
+        const child = spawn(bin, args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            // local-memory-mcp logs to stderr; we forward it through the logger
+        });
+        child.stdout.setEncoding('utf8');
+        child.stdout.on('data', (chunk) => this.onStdoutData(chunk));
+        child.stderr.setEncoding('utf8');
+        child.stderr.on('data', (chunk) => {
+            this.config.logger.debug?.(`stderr: ${chunk.trimEnd()}`);
+        });
+        child.on('exit', (code, signal) => this.onChildExit(code, signal));
+        child.on('error', (err) => {
+            this.config.logger.warn(`spawn error: ${err.message}`);
+        });
+        // F3: stdin EPIPE on a dying child emits as a stream error event. Without
+        // a handler, Node treats it as an uncaught exception and crashes the
+        // host process. Catch and log; the next RPC will see child=null and
+        // ensureReady triggers a clean respawn.
+        child.stdin.on('error', (err) => {
+            this.config.logger.warn(`stdin error (likely race with child exit): ${err.message}`);
+        });
+        this.child = child;
+    }
+    onChildExit(code, signal) {
+        const wasInitialized = this.initialized;
+        this.initialized = false;
+        this.initInFlight = null;
+        this.child = null;
+        const reason = `child exited (code=${code}, signal=${signal})`;
+        for (const [, p] of this.pending) {
+            clearTimeout(p.timer);
+            p.reject(new Error(reason));
+        }
+        this.pending.clear();
+        if (this.closed)
+            return;
+        if (wasInitialized && this.respawnCount < this.config.maxRespawn) {
+            this.respawnCount += 1;
+            this.config.logger.warn(`${reason}; will respawn on next call`);
+        }
+        else if (wasInitialized) {
+            this.config.logger.warn(`${reason}; respawn budget exhausted`);
+        }
+    }
+    onStdoutData(chunk) {
+        this.stdoutBuffer += chunk;
+        // MCP stdio framing: one JSON-RPC message per newline-delimited line.
+        let idx;
+        while ((idx = this.stdoutBuffer.indexOf('\n')) >= 0) {
+            const line = this.stdoutBuffer.slice(0, idx).trim();
+            this.stdoutBuffer = this.stdoutBuffer.slice(idx + 1);
+            if (!line)
+                continue;
+            this.handleIncomingLine(line);
+        }
+    }
+    handleIncomingLine(line) {
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            this.config.logger.warn(`unparseable line: ${line.slice(0, 200)}`);
+            return;
+        }
+        if (typeof msg.id !== 'number') {
+            // notification or progress — ignore for now
+            return;
+        }
+        const pending = this.pending.get(msg.id);
+        if (!pending)
+            return;
+        this.pending.delete(msg.id);
+        clearTimeout(pending.timer);
+        if (msg.error) {
+            const err = msg.error;
+            pending.reject(new Error(`mcp error ${err.code ?? '?'}: ${err.message ?? 'unknown'}`));
+            return;
+        }
+        pending.resolve(msg.result);
+    }
+    sendStdio(payload) {
+        if (!this.child)
+            throw new Error('stdio child not running');
+        try {
+            this.child.stdin.write(`${JSON.stringify(payload)}\n`);
+        }
+        catch (err) {
+            // ERR_STREAM_DESTROYED / EPIPE on a child that's exiting. Caller's
+            // pending entry will be rejected via onChildExit; just surface here.
+            throw err;
+        }
+    }
+    /**
+     * Send one JSON-RPC request and await the matching response.
+     * Used for both initialize and tools/call.
+     * F1: no inline respawn — ensureReady/initialize is the only path that
+     * spawns. This avoids the double-spawn race where rpc() and ensureReady()
+     * both spawn children competing for `this.child`.
+     */
+    async rpc(method, params) {
+        if (this.config.transport === 'http') {
+            return this.rpcHttp(method, params);
+        }
+        return this.rpcStdio(method, params);
+    }
+    rpcStdio(method, params) {
+        return new Promise((resolve, reject) => {
+            const id = this.nextId++;
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`rpc ${method} timed out after ${this.config.requestTimeoutMs}ms`));
+            }, this.config.requestTimeoutMs);
+            this.pending.set(id, { resolve, reject, timer });
+            try {
+                this.sendStdio({ jsonrpc: '2.0', id, method, params });
+            }
+            catch (err) {
+                this.pending.delete(id);
+                clearTimeout(timer);
+                reject(err);
+            }
+        });
+    }
+    /**
+     * HTTP transport with bounded retries on 5xx + transient network errors.
+     * Per-attempt timeout via AbortController. Honors `httpMaxRetries`.
+     */
+    async rpcHttp(method, params) {
+        const url = typeof this.config.endpoint === 'string'
+            ? this.config.endpoint
+            : this.config.endpoint.join('');
+        const headers = {
+            'content-type': 'application/json',
+            accept: 'application/json, text/event-stream',
+        };
+        if (this.config.authHeader)
+            headers.authorization = this.config.authHeader;
+        const id = this.nextId++;
+        const payload = JSON.stringify({ jsonrpc: '2.0', id, method, params });
+        const maxAttempts = this.config.httpMaxRetries + 1;
+        let lastErr = null;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            if (attempt > 0) {
+                const backoffMs = 250 * Math.pow(2, attempt - 1);
+                await delay(backoffMs);
+            }
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), this.config.requestTimeoutMs);
+            try {
+                const res = await fetch(url, {
+                    method: 'POST',
+                    headers,
+                    body: payload,
+                    signal: controller.signal,
+                });
+                // 4xx is the server saying "your request is bad" — do not retry.
+                if (res.status >= 400 && res.status < 500) {
+                    const text = await res.text().catch(() => '');
+                    throw new Error(`http ${res.status} ${res.statusText}: ${text.slice(0, 200)}`);
+                }
+                // 5xx → retry
+                if (res.status >= 500) {
+                    lastErr = new Error(`http ${res.status} ${res.statusText}`);
+                    this.config.logger.warn(`${lastErr.message} (attempt ${attempt + 1}/${maxAttempts})`);
+                    continue;
+                }
+                const text = await res.text();
+                const body = parseHttpRpcBody(text);
+                // F7: validate JSON-RPC envelope; warn-not-throw for unexpected shapes
+                if (!isJsonRpcEnvelope(body)) {
+                    this.config.logger.warn(`non-JSON-RPC response from ${url}: ${text.slice(0, 160)}`);
+                    return undefined;
+                }
+                if (body.id !== undefined && body.id !== id) {
+                    this.config.logger.warn(`id mismatch — sent ${id}, got ${body.id}; accepting anyway`);
+                }
+                if (body.error) {
+                    const err = body.error;
+                    throw new Error(`mcp error ${err.code ?? '?'}: ${err.message ?? 'unknown'}`);
+                }
+                return body.result;
+            }
+            catch (err) {
+                const e = err;
+                // Abort due to timeout, network reset, or DNS failure → retry
+                const isTransient = e.name === 'AbortError' ||
+                    /ECONNRESET|ETIMEDOUT|ENOTFOUND|EAI_AGAIN|fetch failed/i.test(e.message ?? '');
+                if (isTransient && attempt < maxAttempts - 1) {
+                    lastErr = e;
+                    this.config.logger.warn(`transient http error: ${e.message} (attempt ${attempt + 1}/${maxAttempts})`);
+                    continue;
+                }
+                throw err;
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        }
+        throw lastErr ?? new Error('rpcHttp exhausted retries');
+    }
+    async callTool(name, args) {
+        await this.ensureReady();
+        return this.rpc('tools/call', { name, arguments: args });
+    }
+}
+/**
+ * Parse an HTTP body that may be either plain JSON or Server-Sent Events.
+ * F2: SSE framing is `data: …\n\n` per event with possible multi-line data
+ * payloads. We take the last well-formed event so a streamed in-progress
+ * frame doesn't override the final result.
+ */
+export function parseHttpRpcBody(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return {};
+    if (trimmed.startsWith('data:') || trimmed.includes('\n\ndata:')) {
+        const events = trimmed.split(/\n\n+/).filter(Boolean);
+        for (let i = events.length - 1; i >= 0; i--) {
+            const lines = events[i].split('\n').filter((l) => l.startsWith('data:'));
+            if (lines.length === 0)
+                continue;
+            // SSE multi-line data MUST be joined with \n per spec (not concat).
+            const payload = lines.map((l) => l.slice(5).trim()).join('\n');
+            try {
+                return JSON.parse(payload);
+            }
+            catch {
+                continue;
+            }
+        }
+        return {};
+    }
+    return JSON.parse(trimmed);
+}
+function isJsonRpcEnvelope(body) {
+    return (body != null &&
+        typeof body === 'object' &&
+        body.jsonrpc === '2.0' &&
+        ('result' in body || 'error' in body));
+}
+// ─── Convenience factories ───────────────────────────
+/**
+ * Default zero-config wiring: spawn `@studiomeyer/local-memory-mcp` via npx.
+ *
+ * Requires the package to be reachable (either installed globally or via
+ * `npx -y @studiomeyer/local-memory-mcp` which fetches on first run).
+ */
+export function localMemory(overrides = {}) {
+    return new McpMemoryBridge({
+        transport: 'stdio',
+        endpoint: ['npx', '-y', '@studiomeyer/local-memory-mcp'],
+        ...overrides,
+    });
+}
+/**
+ * Connect to a remote MCP server over HTTP.
+ *
+ * Example: connect to your hosted memory.studiomeyer.io endpoint
+ *   remoteMemory('https://memory.studiomeyer.io/mcp', { authHeader: `Bearer ${KEY}` })
+ *
+ * Example: Mem0 with tool-name + arg aliasing
+ *   remoteMemory('https://api.mem0.ai/mcp', {
+ *     authHeader: `Bearer ${process.env.MEM0_KEY}`,
+ *     writeTool: 'mem0_add',
+ *     readTool: 'mem0_search',
+ *     mapWriteArgs: (rec) => ({ content: rec.content, metadata: { tags: rec.tags } }),
+ *   })
+ */
+export function remoteMemory(url, overrides = {}) {
+    return new McpMemoryBridge({
+        transport: 'http',
+        endpoint: url,
+        ...overrides,
+    });
+}
+// ─── Demo ────────────────────────────────────────────
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const memory = localMemory();
+    try {
+        await memory.save({
+            polarity: 'pattern',
+            content: 'Darwin demo: bridge save round-trip works.',
+            tags: ['darwin-demo', 'bridge'],
+            confidence: 0.7,
+        });
+        // give SQLite a tick to settle
+        await delay(50);
+        const lessons = await memory.fetchRelevant({ query: 'Darwin demo bridge', limit: 3 });
+        console.log('[demo] fetched lessons:', lessons.length);
+        for (const l of lessons) {
+            console.log(`  - score=${l.score ?? '-'} tags=[${l.tags.join(',')}] :: ${l.content.slice(0, 80)}`);
+        }
+    }
+    finally {
+        await memory.close();
+    }
+}
+//# sourceMappingURL=mcp-memory-bridge.js.map

package/dist/examples/mcp-memory-bridge.js.map

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

package/dist/examples/memory-darwin-integration.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Example: End-to-End Memory + Darwin Integration
+ *
+ * Closed-loop in three lines:
+ *   1. Run an agent.
+ *   2. After multi-critic, persist findings via McpMemoryBridge.
+ *   3. Before the next run, fetch relevant lessons and inject them.
+ *
+ * Backend-agnostic: defaults to `@studiomeyer/local-memory-mcp` so it works
+ * out of the box with no API keys. Override `localMemory()` with
+ * `remoteMemory(url, …)` to point at any MCP-compliant memory server.
+ *
+ * Run demo (requires `@studiomeyer/local-memory-mcp` reachable via npx):
+ *   npx tsx examples/memory-darwin-integration.ts
+ *
+ * The demo deliberately uses a stub agent runner so it doesn't depend on
+ * a live LLM connection. Replace `simulateAgentRun()` with your real
+ * `runAgent()` call once you wire this into your codebase.
+ */
+import { type Lesson, type RetrievableFeedbackStore } from './mcp-memory-bridge.js';
+import type { MultiCriticResult } from '../src/evolution/multi-critic.js';
+/**
+ * Render a list of past lessons as a context block that you can prepend to
+ * the next agent's system prompt. Empty lessons → empty string (cheap to
+ * call unconditionally).
+ */
+export declare function renderLessonContext(lessons: Lesson[], maxChars?: number): string;
+export interface AgentRunInput {
+    agentName: string;
+    topic: string;
+    /** Optional context block (e.g. rendered past lessons). */
+    context?: string;
+}
+export interface AgentRunOutput {
+    text: string;
+    critic: MultiCriticResult;
+}
+/**
+ * The orchestration shape. Bring your own implementations for the two
+ * function fields when wiring this into a real codebase:
+ *   - runner: anything that takes (topic, context) → {text, critic}
+ *   - store:  the McpMemoryBridge (or any RetrievableFeedbackStore)
+ */
+export interface ClosedLoopOptions {
+    runner: (input: AgentRunInput) => Promise<AgentRunOutput>;
+    store: RetrievableFeedbackStore;
+    /** Cap how many lessons to inject. Default: 5. */
+    fetchLimit?: number;
+    /** Override persist thresholds (same shape as persistFeedback options). */
+    persistThresholds?: {
+        lowThreshold?: number;
+        highThreshold?: number;
+        minOutputChars?: number;
+    };
+}
+/** Run one closed-loop turn: fetch lessons → run → persist findings. */
+export declare function runClosedLoopTurn(input: AgentRunInput, options: ClosedLoopOptions): Promise<{
+    run: AgentRunOutput;
+    lessonsUsed: number;
+    persisted: boolean;
+    reason: string;
+}>;
+//# sourceMappingURL=memory-darwin-integration.d.ts.map

package/dist/examples/memory-darwin-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-darwin-integration.d.ts","sourceRoot":"","sources":["../../examples/memory-darwin-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAe,KAAK,MAAM,EAAE,KAAK,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAI1E;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,SAAO,GAAG,MAAM,CAoB9E;AAID,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1D,KAAK,EAAE,wBAAwB,CAAC;IAChC,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,wEAAwE;AACxE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAiC3F"}