loopforge 1.1.1 → 1.3.1

package/dist/mcp/server.js

@@ -0,0 +1,93 @@
+/** LoopForge MCP — JSON-RPC transport over stdio.
+ *
+ * Implements the MCP protocol: initialize → tools/list → tools/call.
+ * Uses node:readline for stdin, writes JSON-RPC responses to stdout.
+ * All logging goes to stderr to keep stdout clean.
+ */
+import { createInterface } from "node:readline";
+import { SessionManager } from "./session.js";
+import { TOOL_SCHEMAS, TOOL_HANDLERS } from "./tools.js";
+const SERVER_INFO = {
+    name: "loopforge-mcp",
+    version: "1.3.0",
+};
+function errorResponse(id, code, message) {
+    return JSON.stringify({
+        jsonrpc: "2.0",
+        id: id ?? null,
+        error: { code, message },
+    });
+}
+function okResponse(id, result) {
+    if (id === undefined)
+        return ""; // notification — no response
+    return JSON.stringify({ jsonrpc: "2.0", id, result });
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Server
+// ═══════════════════════════════════════════════════════════════════════════
+export class McpServer {
+    mgr;
+    constructor(backend) {
+        this.mgr = new SessionManager(backend);
+    }
+    start() {
+        const rl = createInterface({ input: process.stdin });
+        rl.on("line", (line) => {
+            let req;
+            try {
+                req = JSON.parse(line);
+            }
+            catch {
+                process.stderr.write(`[loopforge-mcp] bad JSON: ${line.slice(0, 80)}\n`);
+                process.stdout.write(errorResponse(undefined, -32700, "Parse error") + "\n");
+                return;
+            }
+            // Notifications (no id) — ignore
+            if (req.id === undefined) {
+                process.stderr.write(`[loopforge-mcp] notification: ${req.method}\n`);
+                return;
+            }
+            try {
+                const result = this.dispatch(req);
+                if (result !== null) {
+                    process.stdout.write(okResponse(req.id, result) + "\n");
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                process.stderr.write(`[loopforge-mcp] dispatch error: ${msg}\n`);
+                process.stdout.write(errorResponse(req.id, -32603, msg) + "\n");
+            }
+        });
+        process.stderr.write(`[loopforge-mcp] v${SERVER_INFO.version} started\n`);
+    }
+    dispatch(req) {
+        switch (req.method) {
+            case "initialize":
+                return {
+                    protocolVersion: "2024-11-05",
+                    capabilities: { tools: {} },
+                    serverInfo: SERVER_INFO,
+                };
+            case "tools/list":
+                return { tools: TOOL_SCHEMAS };
+            case "tools/call": {
+                const params = req.params ?? {};
+                const name = String(params.name ?? "");
+                const args = params.arguments ?? {};
+                const handler = TOOL_HANDLERS[name];
+                if (!handler) {
+                    throw new Error(`Unknown tool: ${name}`);
+                }
+                const output = handler(this.mgr, args);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(output) }],
+                };
+            }
+            default:
+                throw new Error(`Unknown method: ${req.method}`);
+        }
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/session.d.ts

@@ -0,0 +1,68 @@
+/** LoopForge MCP — Session manager.
+ *
+ * Each McpSession = one complete multi-round loop.
+ * SessionManager holds Map<sessionId, McpSession> and drives
+ * the advance() cycle: extract → feedback → check stop → compile next.
+ */
+import { LoopForgeEngine } from "../engine.js";
+import type { VaultBackend } from "../backends/interface.js";
+export interface McpSession {
+    sessionId: string;
+    loopId: string;
+    task: string;
+    engine: LoopForgeEngine;
+    currentRound: number;
+    maxRounds: number;
+    qualityTrajectory: number[];
+    status: "running" | "stopped" | "stalled";
+    createdAt: number;
+}
+export interface McpSessionSummary {
+    sessionId: string;
+    loopId: string;
+    round: number;
+    status: "running" | "stopped" | "stalled";
+}
+export interface StartInput {
+    task: string;
+    loopId?: string;
+    maxRounds?: number;
+    domain?: string;
+    planSource?: string;
+    constraints?: string[];
+}
+export interface AdvanceResult {
+    sessionId: string;
+    round: number;
+    prompt: string | null;
+    stopReason?: string;
+    technique?: string;
+    level?: string;
+    quality?: number;
+    warnings?: string[];
+}
+export declare class SessionManager {
+    private sessions;
+    private backend;
+    constructor(backend?: VaultBackend);
+    create(input: StartInput): AdvanceResult;
+    get(sessionId: string): McpSession | undefined;
+    delete(sessionId: string): boolean;
+    /** Persist session state to vault for cross-process recovery.
+     *  Uses upsert: removes any previous session_state entry for this loop,
+     *  then appends a new one with current state. */
+    save(session: McpSession): void;
+    /** Resume a loop from vault state.
+     *  Reconstructs the session and compiles the prompt for the next round.
+     *  Returns null if no session_state entry exists for this loopId. */
+    resume(loopId: string): AdvanceResult | null;
+    list(): McpSessionSummary[];
+    /** Get loop health for a loop (in-memory or vault).
+     *  Computes goal alignment, constraint integrity, drift, strategy stability. */
+    getHealth(loopId: string): Record<string, unknown> | null;
+    /** Core cycle: extract self-eval → record feedback → check stop → compile next. */
+    advance(sessionId: string, output: string): AdvanceResult;
+    /** Replay timeline for a session — creates ReplayBackend from the stored backend. */
+    replayTimeline(sessionId: string): Record<string, unknown>[] | null;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/mcp/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/mcp/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAkD,MAAM,cAAc,CAAC;AAM/F,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,0BAA0B,CAAC;AAKzE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAoDD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,OAAO,CAA2B;gBAE9B,OAAO,CAAC,EAAE,YAAY;IAIlC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa;IAsCxC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI9C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAQlC;;qDAEiD;IACjD,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IA8B/B;;yEAEqE;IACrE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAkE5C,IAAI,IAAI,iBAAiB,EAAE;IAqC3B;oFACgF;IAChF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAqDzD,mFAAmF;IACnF,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa;IAiEzD,qFAAqF;IACrF,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI;CAQpE"}

package/dist/mcp/session.js

@@ -0,0 +1,343 @@
+/** LoopForge MCP — Session manager.
+ *
+ * Each McpSession = one complete multi-round loop.
+ * SessionManager holds Map<sessionId, McpSession> and drives
+ * the advance() cycle: extract → feedback → check stop → compile next.
+ */
+import { randomUUID } from "node:crypto";
+import { LoopForgeEngine, extractSelfEvaluation, heuristicSelfEvaluation } from "../engine.js";
+import { checkLoopHealth } from "../loop-compiler.js";
+import { getPolicy } from "../policy.js";
+import { Mode, makeLoopCompileRequest, makeVaultConfig } from "../protocol.js";
+import { ReplayBackend } from "../replay.js";
+import { FSBackend } from "../backends/fs.js";
+// ── Helpers ────────────────────────────────────────────────────────────────
+function buildLoopRequest(session, lastEval, lastQuality) {
+    const req = {
+        task: session.task,
+        mode: Mode.LOOP_COMPILE,
+        vault_config: makeVaultConfig(),
+        feedback: null,
+        skill_name: null,
+        task_id: null,
+        loop_id: session.loopId,
+        round: session.currentRound,
+    };
+    if (lastEval && lastQuality !== undefined) {
+        req.last_round_result = {
+            round: session.currentRound - 1,
+            success: lastEval.success,
+            output_summary: lastEval.output_summary,
+            constraint_violations: lastEval.constraint_violations,
+            manual_fixes_needed: "",
+            quality_score: lastQuality,
+        };
+    }
+    return req;
+}
+function parseLevel(rationale) {
+    if (!rationale)
+        return "l2";
+    if (rationale.includes("l0"))
+        return "l0";
+    if (rationale.includes("l1"))
+        return "l1";
+    return "l2";
+}
+function parseWarnings(prompt) {
+    if (!prompt)
+        return [];
+    const warnings = [];
+    const warnSection = prompt.match(/### Warnings\n([\s\S]*?)(?=\n###|\n\*\*|$)/);
+    if (warnSection) {
+        for (const line of warnSection[1].split("\n")) {
+            const m = line.match(/- ⚠️\s*(.+)/);
+            if (m)
+                warnings.push(m[1]);
+        }
+    }
+    return warnings;
+}
+// ── SessionManager ─────────────────────────────────────────────────────────
+export class SessionManager {
+    sessions = new Map();
+    backend;
+    constructor(backend) {
+        this.backend = backend;
+    }
+    create(input) {
+        const sessionId = randomUUID();
+        const loopId = input.loopId ?? randomUUID();
+        const engine = new LoopForgeEngine("skills", this.backend);
+        const maxRounds = input.maxRounds ?? getPolicy().runtime.max_rounds;
+        // Populate extra fields for the first round
+        const request = buildLoopRequest({
+            sessionId, loopId, task: input.task, engine, currentRound: 1,
+            maxRounds, qualityTrajectory: [], status: "running", createdAt: Date.now(),
+        });
+        request.domain = input.domain ?? "";
+        request.plan_source = input.planSource ?? null;
+        request.constraints_from_plan = input.constraints ?? [];
+        const result = engine.invokeLoopCompile(request);
+        const session = {
+            sessionId, loopId, task: input.task, engine,
+            currentRound: 1, maxRounds, qualityTrajectory: [],
+            status: "running", createdAt: Date.now(),
+        };
+        this.sessions.set(sessionId, session);
+        // Persist to vault for cross-process recovery
+        this.save(session);
+        return {
+            sessionId,
+            round: 1,
+            prompt: result.response?.prompt ?? null,
+            technique: result.response?.analysis?.technique ?? "zero-shot",
+            level: parseLevel(result.response?.analysis?.rationale),
+            quality: 0,
+            warnings: parseWarnings(result.response?.prompt ?? null),
+        };
+    }
+    get(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    delete(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return false;
+        session.status = "stopped";
+        this.sessions.delete(sessionId);
+        return true;
+    }
+    /** Persist session state to vault for cross-process recovery.
+     *  Uses upsert: removes any previous session_state entry for this loop,
+     *  then appends a new one with current state. */
+    save(session) {
+        if (!this.backend)
+            return;
+        // Upsert: remove old session_state entries for this loop
+        const vault = this.backend.readVault();
+        const entries = vault.entries || [];
+        vault.entries = entries.filter((e) => !(e.task_type === "session_state" && e.loop_id === session.loopId));
+        this.backend.writeVault(vault);
+        // Append fresh session state
+        this.backend.appendEntry({
+            task_id: `loop:${session.loopId}:session`,
+            task_type: "session_state",
+            timestamp: new Date().toISOString(),
+            loop_id: session.loopId,
+            task: session.task,
+            loop_lineage: {
+                session_id: session.sessionId,
+                current_round: session.currentRound,
+                max_rounds: session.maxRounds,
+                quality_trajectory: session.qualityTrajectory,
+                status: session.status,
+                created_at: session.createdAt,
+            },
+        });
+    }
+    /** Resume a loop from vault state.
+     *  Reconstructs the session and compiles the prompt for the next round.
+     *  Returns null if no session_state entry exists for this loopId. */
+    resume(loopId) {
+        if (!this.backend)
+            return null;
+        const entries = this.backend.queryEntries({
+            prefix: `loop:${loopId}:session`,
+        });
+        const sessionEntry = entries.find((e) => e.task_type === "session_state");
+        if (!sessionEntry)
+            return null;
+        const lineage = (sessionEntry.loop_lineage ?? {});
+        const status = lineage.status ?? "running";
+        const currentRound = lineage.current_round ?? 1;
+        const qualityTrajectory = lineage.quality_trajectory ?? [];
+        const task = sessionEntry.task ?? "";
+        const maxRounds = lineage.max_rounds ?? getPolicy().runtime.max_rounds;
+        // If the loop was already stopped or stalled, return immediately
+        if (status !== "running") {
+            return {
+                sessionId: "",
+                round: currentRound,
+                prompt: null,
+                stopReason: status,
+            };
+        }
+        // Reconstruct session with a fresh engine
+        const engine = new LoopForgeEngine("skills", this.backend);
+        const sessionId = randomUUID();
+        const session = {
+            sessionId,
+            loopId,
+            task,
+            engine,
+            currentRound,
+            maxRounds,
+            qualityTrajectory,
+            status: "running",
+            createdAt: lineage.created_at ?? Date.now(),
+        };
+        this.sessions.set(sessionId, session);
+        // Compile the next round's prompt from vault lineage
+        const request = buildLoopRequest(session);
+        const result = engine.invokeLoopCompile(request);
+        return {
+            sessionId,
+            round: currentRound,
+            prompt: result.response?.prompt ?? null,
+            technique: result.response?.analysis?.technique ?? "zero-shot",
+            level: parseLevel(result.response?.analysis?.rationale),
+            quality: 0,
+            warnings: parseWarnings(result.response?.prompt ?? null),
+        };
+    }
+    list() {
+        const seen = new Set();
+        const result = [];
+        // In-memory sessions first (take priority)
+        for (const s of this.sessions.values()) {
+            seen.add(s.loopId);
+            result.push({
+                sessionId: s.sessionId,
+                loopId: s.loopId,
+                round: s.currentRound,
+                status: s.status,
+            });
+        }
+        // Merge vault-persisted sessions not already in memory
+        if (this.backend) {
+            const vault = this.backend.readVault();
+            const entries = vault.entries ?? [];
+            for (const e of entries) {
+                if (e.task_type !== "session_state")
+                    continue;
+                const lid = e.loop_id ?? "";
+                if (!lid || seen.has(lid))
+                    continue;
+                seen.add(lid);
+                const lineage = (e.loop_lineage ?? {});
+                result.push({
+                    sessionId: "",
+                    loopId: lid,
+                    round: lineage.current_round ?? 1,
+                    status: (lineage.status || "running"),
+                });
+            }
+        }
+        return result;
+    }
+    /** Get loop health for a loop (in-memory or vault).
+     *  Computes goal alignment, constraint integrity, drift, strategy stability. */
+    getHealth(loopId) {
+        // Find the task — check in-memory sessions first, then vault
+        let task = "";
+        let goalId = loopId;
+        for (const s of this.sessions.values()) {
+            if (s.loopId === loopId) {
+                task = s.task;
+                if (s.engine.state?.task_id) {
+                    goalId = s.engine.state.task_id;
+                }
+                break;
+            }
+        }
+        // Fall back to vault for task
+        if (!task && this.backend) {
+            const entries = this.backend.queryEntries({
+                prefix: `loop:${loopId}:session`,
+            });
+            const sessionEntry = entries.find((e) => e.task_type === "session_state");
+            if (sessionEntry) {
+                task = sessionEntry.task ?? "";
+            }
+        }
+        if (!task)
+            return null;
+        // Hydrate vault context
+        const engine = new LoopForgeEngine("skills", this.backend);
+        const vaultContext = engine.hydrateLoopContext(loopId);
+        // Build a minimal request for health check
+        const request = makeLoopCompileRequest({
+            task,
+            loop_id: loopId,
+            goal_id: goalId,
+            round: 1, // round doesn't matter for health check
+        });
+        const health = checkLoopHealth(loopId, request, vaultContext);
+        return {
+            loopId,
+            goal_alignment: health.goal_alignment,
+            constraint_integrity: health.constraint_integrity,
+            drift_detected: health.drift_detected,
+            strategy_stability: health.strategy_stability,
+            task_continuity: health.task_continuity,
+        };
+    }
+    /** Core cycle: extract self-eval → record feedback → check stop → compile next. */
+    advance(sessionId, output) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return { sessionId, round: 0, prompt: null, stopReason: "session_not_found" };
+        if (session.status !== "running") {
+            return { sessionId, round: session.currentRound, prompt: null, stopReason: session.status };
+        }
+        // 1. Extract self-evaluation
+        const structured = extractSelfEvaluation(output);
+        const extractionFailed = structured === null;
+        const selfEval = structured ?? heuristicSelfEvaluation(output);
+        // Guard: if both extraction methods returned null, stop
+        if (!selfEval) {
+            session.status = "stalled";
+            this.save(session);
+            return { sessionId, round: session.currentRound, prompt: null, stopReason: "stalled", quality: 0 };
+        }
+        // 2. Record feedback (flushes immediately so next compile sees scores)
+        const quality = session.engine.autoFeedback(selfEval, session.loopId, session.currentRound, session.task);
+        session.qualityTrajectory.push(quality);
+        // 3. Stop conditions (extraction-first order — see memory)
+        if (extractionFailed) {
+            session.status = "stalled";
+            this.save(session);
+            return { sessionId, round: session.currentRound, prompt: null, stopReason: "stalled", quality };
+        }
+        if (!selfEval.should_continue) {
+            session.status = "stopped";
+            this.save(session);
+            return { sessionId, round: session.currentRound, prompt: null, stopReason: "task_complete", quality };
+        }
+        if (session.engine.shouldBreak()) {
+            session.status = "stopped";
+            this.save(session);
+            return { sessionId, round: session.currentRound, prompt: null, stopReason: "circuit_breaker", quality };
+        }
+        if (session.currentRound >= session.maxRounds) {
+            session.status = "stopped";
+            this.save(session);
+            return { sessionId, round: session.currentRound, prompt: null, stopReason: "max_rounds", quality };
+        }
+        // 4. Compile next round
+        session.currentRound++;
+        const request = buildLoopRequest(session, selfEval, quality);
+        const result = session.engine.invokeLoopCompile(request);
+        this.save(session);
+        return {
+            sessionId,
+            round: session.currentRound,
+            prompt: result.response?.prompt ?? null,
+            technique: result.response?.analysis?.technique ?? "zero-shot",
+            level: parseLevel(result.response?.analysis?.rationale),
+            quality,
+            warnings: parseWarnings(result.response?.prompt ?? null),
+        };
+    }
+    /** Replay timeline for a session — creates ReplayBackend from the stored backend. */
+    replayTimeline(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return null;
+        const vaultBackend = this.backend ?? new FSBackend();
+        const replay = new ReplayBackend(vaultBackend);
+        return replay.timeline(session.loopId);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/mcp/session.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,128 @@
+/** LoopForge MCP — Tool definitions and handlers.
+ *
+ * 6 tools: start, next, status, stop, list, replay.
+ * Each handler receives SessionManager + parsed input, returns the output object.
+ */
+import type { SessionManager } from "./session.js";
+export declare const TOOL_SCHEMAS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            task: {
+                type: "string";
+                description: string;
+            };
+            loopId: {
+                type: "string";
+                description: string;
+            };
+            maxRounds: {
+                type: "number";
+                description: string;
+            };
+            domain: {
+                type: "string";
+                description: string;
+            };
+            planSource: {
+                type: "string";
+                description: string;
+            };
+            constraints: {
+                type: "array";
+                items: {
+                    type: "string";
+                };
+                description: string;
+            };
+            sessionId?: undefined;
+            output?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            sessionId: {
+                type: "string";
+                description: string;
+            };
+            output: {
+                type: "string";
+                description: string;
+            };
+            task?: undefined;
+            loopId?: undefined;
+            maxRounds?: undefined;
+            domain?: undefined;
+            planSource?: undefined;
+            constraints?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            sessionId: {
+                type: "string";
+                description: string;
+            };
+            task?: undefined;
+            loopId?: undefined;
+            maxRounds?: undefined;
+            domain?: undefined;
+            planSource?: undefined;
+            constraints?: undefined;
+            output?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            task?: undefined;
+            loopId?: undefined;
+            maxRounds?: undefined;
+            domain?: undefined;
+            planSource?: undefined;
+            constraints?: undefined;
+            sessionId?: undefined;
+            output?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            loopId: {
+                type: "string";
+                description: string;
+            };
+            task?: undefined;
+            maxRounds?: undefined;
+            domain?: undefined;
+            planSource?: undefined;
+            constraints?: undefined;
+            sessionId?: undefined;
+            output?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export type ToolHandler = (mgr: SessionManager, input: Record<string, unknown>) => Record<string, unknown>;
+export declare const TOOL_HANDLERS: Record<string, ToolHandler>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,cAAc,CAAC;AAM/D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6IxB,CAAC;AAMF,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3G,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAyGrD,CAAC"}