@a5c-ai/babysitter-sdk 0.0.181-staging.a4ae8ca8 → 0.0.181-staging.e06e9e2d

package/dist/cli/commands/mcpServe.d.ts

@@ -0,0 +1,9 @@
+/**
+ * mcp:serve command - Launch the babysitter MCP server on stdio transport.
+ *
+ * stdout is reserved for MCP protocol messages; all logging goes to stderr.
+ */
+export declare function handleMcpServe(args: {
+    json: boolean;
+}): Promise<number>;
+//# sourceMappingURL=mcpServe.d.ts.map

package/dist/cli/commands/mcpServe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpServe.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mcpServe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA0B7E"}

package/dist/cli/commands/mcpServe.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * mcp:serve command - Launch the babysitter MCP server on stdio transport.
+ *
+ * stdout is reserved for MCP protocol messages; all logging goes to stderr.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleMcpServe = handleMcpServe;
+const mcp_1 = require("../../mcp");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+async function handleMcpServe(args) {
+    const server = (0, mcp_1.createBabysitterMcpServer)();
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(args.json
+        ? JSON.stringify({ status: "running", transport: "stdio" }) + "\n"
+        : "Babysitter MCP server running on stdio\n");
+    // Graceful shutdown on SIGINT / SIGTERM
+    const shutdown = async () => {
+        process.stderr.write("Shutting down MCP server...\n");
+        await server.close();
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void shutdown());
+    process.on("SIGTERM", () => void shutdown());
+    // Keep the process alive — the transport manages its own I/O loop.
+    // Return a code that the CLI runner will never actually see (we exit via signal).
+    return await new Promise(() => {
+        // intentionally never resolves
+    });
+}

package/dist/cli/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,sBAAsB,IAAI,6BAA6B,EAAoB,MAAM,oBAAoB,CAAC;AAmiB/G;;;;;;;;;GASG;AACH,iBAAS,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CA8BlE;AAOD,2EAA2E;AAC3E,QAAA,MAAM,sBAAsB,sCAAgC,CAAC;AAy+C7D,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,sBAAsB,IAAI,uBAAuB,EAAE,CAAC;AAE9F,wBAAgB,mBAAmB;eAEf,MAAM,EAAE,GAA2B,OAAO,CAAC,MAAM,CAAC;kBA6QpD,MAAM;EAIvB"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,sBAAsB,IAAI,6BAA6B,EAAoB,MAAM,oBAAoB,CAAC;AAqiB/G;;;;;;;;;GASG;AACH,iBAAS,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CA8BlE;AAOD,2EAA2E;AAC3E,QAAA,MAAM,sBAAsB,sCAAgC,CAAC;AA0+C7D,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,sBAAsB,IAAI,uBAAuB,EAAE,CAAC;AAE9F,wBAAgB,mBAAmB;eAEf,MAAM,EAAE,GAA2B,OAAO,CAAC,MAAM,CAAC;kBAgRpD,MAAM;EAIvB"}

package/dist/cli/main.js

@@ -56,6 +56,7 @@ const health_1 = require("./commands/health");
 const configure_1 = require("./commands/configure");
 const session_1 = require("./commands/session");
 const skill_1 = require("./commands/skill");
+const mcpServe_1 = require("./commands/mcpServe");
 const hookLog_1 = require("./commands/hookLog");
 const hookRun_1 = require("./commands/hookRun");
 const profile_1 = require("./commands/profile");
@@ -101,6 +102,7 @@ const USAGE = `Usage:
   babysitter plugin:update-marketplace --marketplace-name <name> [--marketplace-branch <ref>] [--global|--project] [--json] [--verbose]
   babysitter plugin:update-registry [<pluginName>] [--plugin-name <name>] [--plugin-version <ver>] [--global|--project] [--json] [--verbose]
   babysitter plugin:remove-from-registry [<pluginName>] [--plugin-name <name>] [--global|--project] [--json] [--verbose]
+  babysitter mcp:serve [--json]
   babysitter health [--json] [--verbose]
   babysitter configure [show|validate|paths] [--json] [--defaults-only]
   babysitter version
@@ -1823,6 +1825,7 @@ const VALID_COMMANDS = [
     "plugin:update-marketplace",
     "plugin:update-registry",
     "plugin:remove-from-registry",
+    "mcp:serve",
     "health",
     "configure",
     "version",
@@ -2132,6 +2135,9 @@ function createBabysitterCli() {
                         return await (0, plugin_1.handlePluginRemoveFromRegistry)(pluginArgs);
                     }
                 }
+                if (parsed.command === "mcp:serve") {
+                    return await (0, mcpServe_1.handleMcpServe)({ json: parsed.json });
+                }
                 if (parsed.command === "health") {
                     return await (0, health_1.handleHealthCommand)({
                         json: parsed.json,

package/dist/cli/mcpServeEntry.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=mcpServeEntry.d.ts.map

package/dist/cli/mcpServeEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpServeEntry.d.ts","sourceRoot":"","sources":["../../src/cli/mcpServeEntry.ts"],"names":[],"mappings":""}

package/dist/cli/mcpServeEntry.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcpServe_1 = require("./commands/mcpServe");
+(0, mcpServe_1.handleMcpServe)({ json: false }).catch((err) => {
+    process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});

package/dist/mcp/index.d.ts

@@ -0,0 +1,7 @@
+export { createBabysitterMcpServer } from "./server";
+/**
+ * Start the MCP server on stdio transport.
+ * This is the main entry point for running the babysitter MCP server.
+ */
+export declare function startStdioServer(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAErD;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKtD"}

package/dist/mcp/index.js

@@ -0,0 +1,50 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBabysitterMcpServer = void 0;
+exports.startStdioServer = startStdioServer;
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+var server_1 = require("./server");
+Object.defineProperty(exports, "createBabysitterMcpServer", { enumerable: true, get: function () { return server_1.createBabysitterMcpServer; } });
+/**
+ * Start the MCP server on stdio transport.
+ * This is the main entry point for running the babysitter MCP server.
+ */
+async function startStdioServer() {
+    const { createBabysitterMcpServer } = await Promise.resolve().then(() => __importStar(require("./server")));
+    const server = createBabysitterMcpServer();
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}

package/dist/mcp/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createBabysitterMcpServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE,wBAAgB,yBAAyB,IAAI,SAAS,CAUrD"}

package/dist/mcp/server.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBabysitterMcpServer = createBabysitterMcpServer;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const runs_1 = require("./tools/runs");
+const tasks_1 = require("./tools/tasks");
+const sessions_1 = require("./tools/sessions");
+const discovery_1 = require("./tools/discovery");
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const pkg = require("../../package.json");
+function createBabysitterMcpServer() {
+    const server = new mcp_js_1.McpServer({
+        name: "babysitter",
+        version: pkg.version
+    });
+    (0, runs_1.registerRunTools)(server);
+    (0, tasks_1.registerTaskTools)(server);
+    (0, sessions_1.registerSessionTools)(server);
+    (0, discovery_1.registerDiscoveryTools)(server);
+    return server;
+}

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

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDiscoveryTools(server: McpServer): void;
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/discovery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwF9D"}

package/dist/mcp/tools/discovery.js

@@ -0,0 +1,113 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDiscoveryTools = registerDiscoveryTools;
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const health_1 = require("../../cli/commands/health");
+const configure_1 = require("../../cli/commands/configure");
+const skill_1 = require("../../cli/commands/skill");
+const errors_1 = require("../util/errors");
+function registerDiscoveryTools(server) {
+    // ── skill_discover ──────────────────────────────────────────────────
+    server.tool("skill_discover", "Discover available skills, agents, and process definitions", {
+        pluginRoot: zod_1.z
+            .string()
+            .describe("Plugin root directory to scan for skills"),
+        runId: zod_1.z
+            .string()
+            .optional()
+            .describe("Run ID for domain-scoped discovery"),
+        runsDir: zod_1.z.string().optional().describe("Override runs directory path"),
+        includeRemote: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Include remote skill sources"),
+        processPath: zod_1.z
+            .string()
+            .optional()
+            .describe("Process file path for specialization scoping"),
+    }, async (args) => {
+        try {
+            const pluginRoot = path.resolve(args.pluginRoot);
+            const result = await (0, skill_1.discoverSkillsInternal)({
+                pluginRoot,
+                runId: args.runId,
+                runsDir: args.runsDir,
+                includeRemote: args.includeRemote,
+                processPath: args.processPath,
+                includeProcesses: true,
+            });
+            return (0, errors_1.toolResult)({
+                skills: result.skills,
+                agents: result.agents,
+                processes: result.processes,
+                summary: result.summary,
+                cached: result.cached,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // ── health ──────────────────────────────────────────────────────────
+    server.tool("health", "Check the health and configuration status of the babysitter installation", {}, async () => {
+        try {
+            const result = await (0, health_1.runHealthCheck)({ json: true });
+            return (0, errors_1.toolResult)({
+                status: result.status,
+                summary: result.summary,
+                checks: result.checks,
+                nextSteps: result.nextSteps,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // ── configure_show ──────────────────────────────────────────────────
+    server.tool("configure_show", "Show current babysitter configuration and environment", {}, () => {
+        try {
+            const result = (0, configure_1.configureShow)({});
+            return (0, errors_1.toolResult)({
+                values: result.values,
+                timestamp: result.timestamp,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+}

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

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerRunTools(server: McpServer): void;
+//# sourceMappingURL=runs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/runs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuFpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiNxD"}

package/dist/mcp/tools/runs.js

@@ -0,0 +1,273 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRunTools = registerRunTools;
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const runtime_1 = require("../../runtime");
+const storage_1 = require("../../storage");
+const stateCache_1 = require("../../runtime/replay/stateCache");
+const errors_1 = require("../util/errors");
+const resolve_run_dir_1 = require("../util/resolve-run-dir");
+/**
+ * Parse an entrypoint specifier like "path/to/file.js#exportName" into its parts.
+ */
+function parseEntrypoint(entrypoint) {
+    const hashIndex = entrypoint.lastIndexOf("#");
+    if (hashIndex <= 0) {
+        return { importPath: entrypoint };
+    }
+    const importPath = entrypoint.slice(0, hashIndex);
+    const exportName = entrypoint.slice(hashIndex + 1) || undefined;
+    return { importPath, exportName };
+}
+const RUN_LIFECYCLE_TYPES = new Set(["RUN_CREATED", "RUN_COMPLETED", "RUN_FAILED"]);
+function findLastLifecycleEvent(events) {
+    for (let i = events.length - 1; i >= 0; i--) {
+        if (RUN_LIFECYCLE_TYPES.has(events[i].type)) {
+            return events[i];
+        }
+    }
+    return undefined;
+}
+function deriveRunState(lastLifecycleEventType, pendingCount) {
+    if (lastLifecycleEventType === "RUN_COMPLETED")
+        return "completed";
+    if (lastLifecycleEventType === "RUN_FAILED")
+        return "failed";
+    if (pendingCount > 0)
+        return "waiting";
+    return "created";
+}
+function countPendingEffects(events) {
+    const requested = new Map();
+    const resolved = new Set();
+    for (const event of events) {
+        if (event.type === "EFFECT_REQUESTED") {
+            const data = event.data;
+            if (data.effectId) {
+                requested.set(data.effectId, {
+                    effectId: data.effectId,
+                    kind: data.kind ?? "unknown",
+                    label: data.label,
+                });
+            }
+        }
+        else if (event.type === "EFFECT_RESOLVED") {
+            const data = event.data;
+            if (data.effectId) {
+                resolved.add(data.effectId);
+            }
+        }
+    }
+    const pendingEffects = [];
+    const pendingByKind = {};
+    for (const [effectId, info] of requested) {
+        if (!resolved.has(effectId)) {
+            pendingEffects.push(info);
+            pendingByKind[info.kind] = (pendingByKind[info.kind] ?? 0) + 1;
+        }
+    }
+    return { pendingEffects, pendingByKind };
+}
+function registerRunTools(server) {
+    // ── run_create ──────────────────────────────────────────────────────
+    server.tool("run_create", "Create a new babysitter run for a given process definition", {
+        processId: zod_1.z.string().describe("The process identifier to run"),
+        entrypoint: zod_1.z.string().describe("Path to the process JS entrypoint file (optionally path#exportName)"),
+        inputs: zod_1.z.string().optional().describe("JSON-encoded inputs for the process"),
+        runsDir: zod_1.z.string().optional().describe("Override runs directory path"),
+        prompt: zod_1.z.string().optional().describe("Prompt or description for the run"),
+    }, async (args) => {
+        try {
+            const { importPath, exportName } = parseEntrypoint(args.entrypoint);
+            const absoluteImportPath = path.resolve(importPath);
+            const runsDir = (0, resolve_run_dir_1.resolveRunDir)(args.runsDir);
+            let inputs;
+            if (args.inputs) {
+                try {
+                    inputs = JSON.parse(args.inputs);
+                }
+                catch {
+                    return (0, errors_1.toolError)("Invalid JSON in inputs parameter");
+                }
+            }
+            const result = await (0, runtime_1.createRun)({
+                runsDir,
+                process: {
+                    processId: args.processId,
+                    importPath: absoluteImportPath,
+                    exportName,
+                },
+                prompt: args.prompt,
+                inputs,
+            });
+            return (0, errors_1.toolResult)({
+                runId: result.runId,
+                runDir: result.runDir,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // ── run_status ──────────────────────────────────────────────────────
+    server.tool("run_status", "Get the current status and metadata of a run", {
+        runId: zod_1.z.string().describe("The run ID to query"),
+        runsDir: zod_1.z.string().optional().describe("Override runs directory path"),
+    }, async (args) => {
+        try {
+            const runsDir = (0, resolve_run_dir_1.resolveRunDir)(args.runsDir);
+            const runDir = path.join(runsDir, args.runId);
+            const metadata = await (0, storage_1.readRunMetadata)(runDir);
+            const journal = await (0, storage_1.loadJournal)(runDir);
+            const lastLifecycleEvent = findLastLifecycleEvent(journal);
+            const { pendingEffects, pendingByKind } = countPendingEffects(journal);
+            const state = deriveRunState(lastLifecycleEvent?.type, pendingEffects.length);
+            const completionProof = state === "completed" ? metadata.completionProof : undefined;
+            return (0, errors_1.toolResult)({
+                runId: metadata.runId,
+                processId: metadata.processId,
+                state,
+                pendingEffects,
+                pendingByKind,
+                completionProof: completionProof ?? null,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // ── run_iterate ─────────────────────────────────────────────────────
+    server.tool("run_iterate", "Execute one orchestration iteration for a run", {
+        runId: zod_1.z.string().describe("The run ID to iterate"),
+        runsDir: zod_1.z.string().optional().describe("Override runs directory path"),
+    }, async (args) => {
+        try {
+            const runsDir = (0, resolve_run_dir_1.resolveRunDir)(args.runsDir);
+            const runDir = path.join(runsDir, args.runId);
+            const result = await (0, runtime_1.orchestrateIteration)({ runDir });
+            if (result.status === "completed") {
+                const metadata = await (0, storage_1.readRunMetadata)(runDir);
+                const completionProof = metadata.completionProof ?? null;
+                return (0, errors_1.toolResult)({
+                    status: "completed",
+                    output: result.output,
+                    completionProof,
+                    metadata: result.metadata,
+                });
+            }
+            if (result.status === "failed") {
+                return (0, errors_1.toolResult)({
+                    status: "failed",
+                    error: result.error instanceof Error ? result.error.message : result.error,
+                    metadata: result.metadata,
+                });
+            }
+            // status === "waiting"
+            return (0, errors_1.toolResult)({
+                status: "waiting",
+                nextActions: result.nextActions.map((action) => ({
+                    effectId: action.effectId,
+                    kind: action.kind,
+                    label: action.label,
+                    labels: action.labels,
+                    taskId: action.taskId,
+                    stepId: action.stepId,
+                })),
+                metadata: result.metadata,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // ── run_events ──────────────────────────────────────────────────────
+    server.tool("run_events", "List journal events for a run", {
+        runId: zod_1.z.string().describe("The run ID to query"),
+        runsDir: zod_1.z.string().optional().describe("Override runs directory path"),
+        limit: zod_1.z.number().optional().describe("Maximum number of events to return"),
+        filterType: zod_1.z.string().optional().describe("Filter events by type (e.g. EFFECT_REQUESTED)"),
+        reverse: zod_1.z.boolean().optional().describe("Return events in reverse chronological order"),
+    }, async (args) => {
+        try {
+            const runsDir = (0, resolve_run_dir_1.resolveRunDir)(args.runsDir);
+            const runDir = path.join(runsDir, args.runId);
+            const journal = await (0, storage_1.loadJournal)(runDir);
+            // Apply type filter
+            const filterType = args.filterType?.toUpperCase();
+            const filtered = filterType
+                ? journal.filter((event) => event.type.toUpperCase() === filterType)
+                : journal;
+            // Apply ordering
+            const ordered = args.reverse ? filtered.slice().reverse() : filtered;
+            // Apply limit
+            const limited = args.limit !== undefined ? ordered.slice(0, args.limit) : ordered;
+            return (0, errors_1.toolResult)({
+                total: journal.length,
+                matching: filtered.length,
+                showing: limited.length,
+                events: limited.map((event) => ({
+                    seq: event.seq,
+                    type: event.type,
+                    recordedAt: event.recordedAt,
+                    data: event.data,
+                })),
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // ── run_rebuild_state ───────────────────────────────────────────────
+    server.tool("run_rebuild_state", "Rebuild the state cache for a run from its journal", {
+        runId: zod_1.z.string().describe("The run ID to rebuild state for"),
+        runsDir: zod_1.z.string().optional().describe("Override runs directory path"),
+    }, async (args) => {
+        try {
+            const runsDir = (0, resolve_run_dir_1.resolveRunDir)(args.runsDir);
+            const runDir = path.join(runsDir, args.runId);
+            const snapshot = await (0, stateCache_1.rebuildStateCache)(runDir);
+            return (0, errors_1.toolResult)({
+                success: true,
+                stateVersion: snapshot.stateVersion,
+                journalHead: snapshot.journalHead,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+}

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

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSessionTools(server: McpServer): void;
+//# sourceMappingURL=sessions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/sessions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAcpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4N5D"}

package/dist/mcp/tools/sessions.js

@@ -0,0 +1,219 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSessionTools = registerSessionTools;
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const session_1 = require("../../session");
+const storage_1 = require("../../storage");
+const errors_1 = require("../util/errors");
+const resolve_run_dir_1 = require("../util/resolve-run-dir");
+function registerSessionTools(server) {
+    // ── session_init ────────────────────────────────────────────────────
+    server.tool("session_init", "Initialize a new session state for orchestration", {
+        sessionId: zod_1.z.string().describe("The session ID to initialize"),
+        stateDir: zod_1.z.string().describe("Directory to store session state files"),
+        maxIterations: zod_1.z
+            .number()
+            .optional()
+            .describe("Maximum number of iterations (default 256)"),
+        runId: zod_1.z
+            .string()
+            .optional()
+            .describe("Optional run ID to associate immediately"),
+        prompt: zod_1.z
+            .string()
+            .optional()
+            .describe("Optional prompt text for the session"),
+    }, async (args) => {
+        try {
+            const stateDir = path.resolve(args.stateDir);
+            const maxIterations = args.maxIterations ?? 256;
+            const runId = args.runId ?? "";
+            const prompt = args.prompt ?? "";
+            const filePath = (0, session_1.getSessionFilePath)(stateDir, args.sessionId);
+            // Check for existing session
+            if (await (0, session_1.sessionFileExists)(filePath)) {
+                try {
+                    const existing = await (0, session_1.readSessionFile)(filePath);
+                    if (existing.state.runId) {
+                        return (0, errors_1.toolError)(`Session already associated with run: ${existing.state.runId}`);
+                    }
+                    return (0, errors_1.toolError)("A babysitter run is already active for this session");
+                }
+                catch {
+                    return (0, errors_1.toolError)("Session state file exists but could not be read");
+                }
+            }
+            const now = (0, session_1.getCurrentTimestamp)();
+            const state = {
+                active: true,
+                iteration: 1,
+                maxIterations,
+                runId,
+                startedAt: now,
+                lastIterationAt: now,
+                iterationTimes: [],
+            };
+            await (0, session_1.writeSessionFile)(filePath, state, prompt);
+            return (0, errors_1.toolResult)({
+                stateFile: filePath,
+                iteration: state.iteration,
+                maxIterations: state.maxIterations,
+                runId: state.runId,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // ── session_associate ───────────────────────────────────────────────
+    server.tool("session_associate", "Associate a session with a run ID", {
+        sessionId: zod_1.z.string().describe("The session ID to associate"),
+        stateDir: zod_1.z.string().describe("Directory containing session state files"),
+        runId: zod_1.z.string().describe("The run ID to associate with"),
+    }, async (args) => {
+        try {
+            const stateDir = path.resolve(args.stateDir);
+            const filePath = (0, session_1.getSessionFilePath)(stateDir, args.sessionId);
+            let existing;
+            try {
+                existing = await (0, session_1.readSessionFile)(filePath);
+            }
+            catch {
+                return (0, errors_1.toolError)(`No active session found. Expected state file: ${filePath}`);
+            }
+            if (existing.state.runId) {
+                return (0, errors_1.toolError)(`Session already associated with run: ${existing.state.runId}`);
+            }
+            const updatedState = {
+                ...existing.state,
+                runId: args.runId,
+            };
+            await (0, session_1.writeSessionFile)(filePath, updatedState, existing.prompt);
+            return (0, errors_1.toolResult)({
+                stateFile: filePath,
+                runId: args.runId,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // ── session_resume ──────────────────────────────────────────────────
+    server.tool("session_resume", "Resume an existing run in a new session", {
+        sessionId: zod_1.z.string().describe("The session ID for the new session"),
+        stateDir: zod_1.z.string().describe("Directory to store session state files"),
+        runId: zod_1.z.string().describe("The run ID to resume"),
+        maxIterations: zod_1.z
+            .number()
+            .optional()
+            .describe("Maximum number of iterations (default 256)"),
+        runsDir: zod_1.z.string().optional().describe("Override runs directory path"),
+    }, async (args) => {
+        try {
+            const stateDir = path.resolve(args.stateDir);
+            const runsDir = (0, resolve_run_dir_1.resolveRunDir)(args.runsDir);
+            const runDir = path.join(runsDir, args.runId);
+            const maxIterations = args.maxIterations ?? 256;
+            // Check run state from journal
+            let runState = "unknown";
+            try {
+                const journal = await (0, storage_1.loadJournal)(runDir);
+                const hasCompleted = journal.some((e) => e.type === "RUN_COMPLETED");
+                const hasFailed = journal.some((e) => e.type === "RUN_FAILED");
+                if (hasCompleted)
+                    runState = "completed";
+                else if (hasFailed)
+                    runState = "failed";
+                else
+                    runState = "waiting";
+            }
+            catch {
+                return (0, errors_1.toolError)(`Run not found: ${args.runId}`);
+            }
+            if (runState === "completed") {
+                return (0, errors_1.toolError)(`Run is already completed. Cannot resume a completed run.`);
+            }
+            const filePath = (0, session_1.getSessionFilePath)(stateDir, args.sessionId);
+            const prompt = `Resume Babysitter run: ${args.runId}\nCurrent state: ${runState}\nContinue orchestration using run:iterate, task:post, etc.`;
+            const now = (0, session_1.getCurrentTimestamp)();
+            const state = {
+                active: true,
+                iteration: 1,
+                maxIterations,
+                runId: args.runId,
+                startedAt: now,
+                lastIterationAt: now,
+                iterationTimes: [],
+            };
+            await (0, session_1.writeSessionFile)(filePath, state, prompt);
+            return (0, errors_1.toolResult)({
+                stateFile: filePath,
+                runId: args.runId,
+                runState,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // ── session_state ───────────────────────────────────────────────────
+    server.tool("session_state", "Get the current state of a session", {
+        sessionId: zod_1.z.string().describe("The session ID to query"),
+        stateDir: zod_1.z.string().describe("Directory containing session state files"),
+    }, async (args) => {
+        try {
+            const stateDir = path.resolve(args.stateDir);
+            const filePath = (0, session_1.getSessionFilePath)(stateDir, args.sessionId);
+            if (!(await (0, session_1.sessionFileExists)(filePath))) {
+                return (0, errors_1.toolResult)({
+                    found: false,
+                    stateFile: filePath,
+                });
+            }
+            const file = await (0, session_1.readSessionFile)(filePath);
+            return (0, errors_1.toolResult)({
+                found: true,
+                state: file.state,
+                prompt: file.prompt,
+                stateFile: filePath,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+}

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

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTaskTools(server: McpServer): void;
+//# sourceMappingURL=tasks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/tasks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqFpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0KzD"}

package/dist/mcp/tools/tasks.js

@@ -0,0 +1,230 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTaskTools = registerTaskTools;
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const commitEffectResult_1 = require("../../runtime/commitEffectResult");
+const storage_1 = require("../../storage");
+const tasks_1 = require("../../storage/tasks");
+const errors_1 = require("../util/errors");
+const resolve_run_dir_1 = require("../util/resolve-run-dir");
+/**
+ * Build a task list from journal events by tracking EFFECT_REQUESTED and
+ * EFFECT_RESOLVED events.
+ */
+function buildTaskList(events) {
+    const requested = new Map();
+    const resolved = new Map();
+    for (const event of events) {
+        if (event.type === "EFFECT_REQUESTED") {
+            const data = event.data;
+            if (data.effectId) {
+                requested.set(data.effectId, {
+                    effectId: data.effectId,
+                    kind: data.kind ?? "unknown",
+                    label: data.label,
+                    taskId: data.taskId,
+                    requestedAt: event.recordedAt,
+                });
+            }
+        }
+        else if (event.type === "EFFECT_RESOLVED") {
+            const data = event.data;
+            if (data.effectId) {
+                resolved.set(data.effectId, { resolvedAt: event.recordedAt });
+            }
+        }
+    }
+    const tasks = [];
+    for (const [effectId, info] of requested) {
+        const resolvedInfo = resolved.get(effectId);
+        tasks.push({
+            effectId,
+            kind: info.kind,
+            status: resolvedInfo ? "resolved" : "pending",
+            label: info.label,
+            taskId: info.taskId,
+            requestedAt: info.requestedAt,
+            resolvedAt: resolvedInfo?.resolvedAt,
+        });
+    }
+    return tasks.sort((a, b) => a.effectId.localeCompare(b.effectId));
+}
+function registerTaskTools(server) {
+    // ── task_post ───────────────────────────────────────────────────────
+    server.tool("task_post", "Post a result for a pending task effect", {
+        runId: zod_1.z.string().describe("The run ID the task belongs to"),
+        effectId: zod_1.z.string().describe("The effect ID of the task to resolve"),
+        status: zod_1.z
+            .enum(["ok", "error"])
+            .describe("Result status: ok for success, error for failure"),
+        value: zod_1.z
+            .string()
+            .optional()
+            .describe("JSON-encoded result value (when status=ok)"),
+        error: zod_1.z
+            .string()
+            .optional()
+            .describe("JSON-encoded error payload (when status=error)"),
+        runsDir: zod_1.z.string().optional().describe("Override runs directory path"),
+    }, async (args) => {
+        try {
+            const runsDir = (0, resolve_run_dir_1.resolveRunDir)(args.runsDir);
+            const runDir = path.join(runsDir, args.runId);
+            let value;
+            let errorPayload;
+            if (args.status === "ok" && args.value) {
+                try {
+                    value = JSON.parse(args.value);
+                }
+                catch {
+                    return (0, errors_1.toolError)("Invalid JSON in value parameter");
+                }
+            }
+            if (args.status === "error") {
+                if (args.error) {
+                    try {
+                        errorPayload = JSON.parse(args.error);
+                    }
+                    catch {
+                        return (0, errors_1.toolError)("Invalid JSON in error parameter");
+                    }
+                }
+                else {
+                    errorPayload = { name: "Error", message: "Task reported failure" };
+                }
+            }
+            const nowIso = new Date().toISOString();
+            const committed = await (0, commitEffectResult_1.commitEffectResult)({
+                runDir,
+                effectId: args.effectId,
+                result: args.status === "ok"
+                    ? {
+                        status: "ok",
+                        value,
+                        startedAt: nowIso,
+                        finishedAt: nowIso,
+                    }
+                    : {
+                        status: "error",
+                        error: errorPayload,
+                        startedAt: nowIso,
+                        finishedAt: nowIso,
+                    },
+            });
+            return (0, errors_1.toolResult)({
+                status: args.status,
+                effectId: args.effectId,
+                resultRef: committed.resultRef ?? null,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // ── task_list ───────────────────────────────────────────────────────
+    server.tool("task_list", "List all tasks for a run, optionally showing only pending tasks", {
+        runId: zod_1.z.string().describe("The run ID to list tasks for"),
+        pendingOnly: zod_1.z
+            .boolean()
+            .optional()
+            .describe("If true, only show pending (unresolved) tasks"),
+        runsDir: zod_1.z.string().optional().describe("Override runs directory path"),
+    }, async (args) => {
+        try {
+            const runsDir = (0, resolve_run_dir_1.resolveRunDir)(args.runsDir);
+            const runDir = path.join(runsDir, args.runId);
+            const journal = await (0, storage_1.loadJournal)(runDir);
+            const allTasks = buildTaskList(journal);
+            const tasks = args.pendingOnly
+                ? allTasks.filter((t) => t.status === "pending")
+                : allTasks;
+            return (0, errors_1.toolResult)({
+                total: allTasks.length,
+                showing: tasks.length,
+                pendingCount: allTasks.filter((t) => t.status === "pending").length,
+                tasks,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+    // ── task_show ───────────────────────────────────────────────────────
+    server.tool("task_show", "Show details of a specific task including its definition and result", {
+        runId: zod_1.z.string().describe("The run ID the task belongs to"),
+        effectId: zod_1.z.string().describe("The effect ID of the task"),
+        runsDir: zod_1.z.string().optional().describe("Override runs directory path"),
+    }, async (args) => {
+        try {
+            const runsDir = (0, resolve_run_dir_1.resolveRunDir)(args.runsDir);
+            const runDir = path.join(runsDir, args.runId);
+            // Get task status from journal
+            const journal = await (0, storage_1.loadJournal)(runDir);
+            const allTasks = buildTaskList(journal);
+            const taskEntry = allTasks.find((t) => t.effectId === args.effectId);
+            if (!taskEntry) {
+                return (0, errors_1.toolError)(`Effect ${args.effectId} not found in run ${args.runId}`);
+            }
+            // Read task definition
+            let taskDef = null;
+            try {
+                taskDef = await (0, tasks_1.readTaskDefinition)(runDir, args.effectId);
+            }
+            catch {
+                // Task definition might not exist yet
+            }
+            // Read task result if resolved
+            let taskResultData = null;
+            if (taskEntry.status === "resolved") {
+                try {
+                    taskResultData = await (0, tasks_1.readTaskResult)(runDir, args.effectId);
+                }
+                catch {
+                    // Result file might not be readable
+                }
+            }
+            return (0, errors_1.toolResult)({
+                effect: taskEntry,
+                task: taskDef,
+                result: taskResultData,
+            });
+        }
+        catch (err) {
+            return (0, errors_1.toolError)(err instanceof Error ? err.message : String(err));
+        }
+    });
+}

package/dist/mcp/util/errors.d.ts

@@ -0,0 +1,14 @@
+export declare function toolError(message: string): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+};
+export declare function toolResult(data: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/mcp/util/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/mcp/util/errors.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAE5G;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAE5F"}

package/dist/mcp/util/errors.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolError = toolError;
+exports.toolResult = toolResult;
+function toolError(message) {
+    return { content: [{ type: "text", text: JSON.stringify({ error: message }) }], isError: true };
+}
+function toolResult(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}

package/dist/mcp/util/resolve-run-dir.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Resolves the runs directory, defaulting to `.a5c/runs` under cwd.
+ * Accepts an optional override (e.g. from tool args or env).
+ */
+export declare function resolveRunDir(overridePath?: string): string;
+//# sourceMappingURL=resolve-run-dir.d.ts.map

package/dist/mcp/util/resolve-run-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-run-dir.d.ts","sourceRoot":"","sources":["../../../src/mcp/util/resolve-run-dir.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAK3D"}

package/dist/mcp/util/resolve-run-dir.js

@@ -0,0 +1,47 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRunDir = resolveRunDir;
+const path = __importStar(require("path"));
+/**
+ * Resolves the runs directory, defaulting to `.a5c/runs` under cwd.
+ * Accepts an optional override (e.g. from tool args or env).
+ */
+function resolveRunDir(overridePath) {
+    if (overridePath) {
+        return path.resolve(overridePath);
+    }
+    return path.resolve(process.env["BABYSITTER_RUNS_DIR"] ?? path.join(process.cwd(), ".a5c", "runs"));
+}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@a5c-ai/babysitter-sdk",
-  "version": "0.0.181-staging.a4ae8ca8",
+  "version": "0.0.181-staging.e06e9e2d",
   "description": "Storage and run-registry primitives for event-sourced babysitter workflows.",
   "license": "UNLICENSED",
   "type": "commonjs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "babysitter": "dist/cli/main.js"
+    "babysitter": "dist/cli/main.js",
+    "babysitter-mcp-server": "dist/cli/mcpServeEntry.js"
   },
   "files": [
     "dist",
@@ -22,6 +23,7 @@
     "smoke:cli": "node scripts/smoke-cli.js --runs-dir packages/sdk/test-fixtures/cli/runs/smoke"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
     "fs-extra": "^11.2.0",
     "ulid": "^2.3.0"
   },