@dmmulroy/overseer 0.1.0

package/bin/os

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+/**
+ * Unified CLI entry point
+ * - `os mcp` → starts MCP server (Node, codemode)
+ * - `os <cmd>` → forwards to native binary
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { execSync, spawn } from "node:child_process";
+import { platform, arch } from "node:process";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const require = createRequire(import.meta.url);
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+const PLATFORMS = {
+  "darwin-arm64": "@dmmulroy/overseer-darwin-arm64",
+  "darwin-x64": "@dmmulroy/overseer-darwin-x64",
+  "linux-arm64": "@dmmulroy/overseer-linux-arm64",
+  "linux-x64": "@dmmulroy/overseer-linux-x64",
+  "linux-arm64-musl": "@dmmulroy/overseer-linux-arm64-musl",
+  "linux-x64-musl": "@dmmulroy/overseer-linux-x64-musl",
+};
+
+function isMusl() {
+  if (platform !== "linux") return false;
+  if (existsSync("/etc/alpine-release")) return true;
+  try {
+    const maps = readFileSync("/proc/self/maps", "utf8");
+    if (maps.includes("musl")) return true;
+  } catch {}
+  try {
+    const output = execSync("ldd --version 2>&1", { encoding: "utf8" });
+    return output.toLowerCase().includes("musl");
+  } catch (err) {
+    const stderr = err.stderr?.toString() || err.message || "";
+    return stderr.toLowerCase().includes("musl");
+  }
+}
+
+function getBinaryPath() {
+  if (process.env.OVERSEER_CLI_PATH) {
+    return process.env.OVERSEER_CLI_PATH;
+  }
+
+  const cpuArch = arch === "arm64" ? "arm64" : "x64";
+  const libc = isMusl() ? "-musl" : "";
+  const key = `${platform}-${cpuArch}${libc}`;
+  const pkg = PLATFORMS[key];
+
+  if (!pkg) {
+    console.error(`Unsupported platform: ${key}`);
+    console.error("Install via cargo: cargo install overseer");
+    process.exit(1);
+  }
+
+  try {
+    const pkgPath = require.resolve(`${pkg}/package.json`);
+    return join(dirname(pkgPath), "os");
+  } catch {
+    console.error(`Platform package not installed: ${pkg}`);
+    console.error("Try: npm install -g @dmmulroy/overseer");
+    process.exit(1);
+  }
+}
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+// Handle `os mcp` - start MCP server
+if (command === "mcp") {
+  const binaryPath = getBinaryPath();
+  process.env.OVERSEER_CLI_PATH = binaryPath;
+
+  const serverPath = join(__dirname, "..", "dist", "index.js");
+  import(serverPath).catch((err) => {
+    console.error("Failed to start MCP server:", err.message);
+    process.exit(1);
+  });
+} else {
+  // All other commands - passthrough to native binary
+  const child = spawn(getBinaryPath(), args, {
+    stdio: "inherit",
+  });
+
+  child.on("error", (err) => {
+    console.error(`Failed to run os: ${err.message}`);
+    process.exit(1);
+  });
+
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+    } else {
+      process.exit(code ?? 0);
+    }
+  });
+}

package/dist/api/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * API exports
+ */
+export { tasks } from "./tasks.js";
+export { learnings } from "./learnings.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,6 @@
+/**
+ * API exports
+ */
+export { tasks } from "./tasks.js";
+export { learnings } from "./learnings.js";
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/api/learnings.d.ts

@@ -0,0 +1,19 @@
+import type { Learning } from "../types.js";
+/**
+ * Learnings API exposed to VM sandbox
+ */
+export declare const learnings: {
+    /**
+     * Add learning to a task
+     */
+    add(taskId: string, content: string, sourceTaskId?: string): Promise<Learning>;
+    /**
+     * List all learnings for a task
+     */
+    list(taskId: string): Promise<Learning[]>;
+    /**
+     * Delete a learning
+     */
+    delete(id: string): Promise<void>;
+};
+//# sourceMappingURL=learnings.d.ts.map

package/dist/api/learnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learnings.d.ts","sourceRoot":"","sources":["../../src/api/learnings.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB;;OAEG;gBAEO,MAAM,WACL,MAAM,iBACA,MAAM,GACpB,OAAO,CAAC,QAAQ,CAAC;IAMpB;;OAEG;iBACgB,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI/C;;OAEG;eACc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxC,CAAC"}

package/dist/api/learnings.js

@@ -0,0 +1,31 @@
+/**
+ * Learnings API - typed wrapper around os learning commands
+ */
+import { callCli } from "../cli.js";
+/**
+ * Learnings API exposed to VM sandbox
+ */
+export const learnings = {
+    /**
+     * Add learning to a task
+     */
+    async add(taskId, content, sourceTaskId) {
+        const args = ["learning", "add", taskId, content];
+        if (sourceTaskId)
+            args.push("--source", sourceTaskId);
+        return (await callCli(args));
+    },
+    /**
+     * List all learnings for a task
+     */
+    async list(taskId) {
+        return (await callCli(["learning", "list", taskId]));
+    },
+    /**
+     * Delete a learning
+     */
+    async delete(id) {
+        await callCli(["learning", "delete", id]);
+    },
+};
+//# sourceMappingURL=learnings.js.map

package/dist/api/learnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learnings.js","sourceRoot":"","sources":["../../src/api/learnings.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB;;OAEG;IACH,KAAK,CAAC,GAAG,CACP,MAAc,EACd,OAAe,EACf,YAAqB;QAErB,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,YAAY;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACtD,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAa,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,OAAO,CAAC,MAAM,OAAO,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAe,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,OAAO,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;CACF,CAAC"}

package/dist/api/tasks.d.ts

@@ -0,0 +1,69 @@
+import type { Task } from "../types.js";
+export interface TaskFilter {
+    parentId?: string;
+    ready?: boolean;
+    completed?: boolean;
+}
+export interface CreateTaskInput {
+    description: string;
+    context?: string;
+    parentId?: string;
+    priority?: 1 | 2 | 3 | 4 | 5;
+    blockedBy?: string[];
+}
+export interface UpdateTaskInput {
+    description?: string;
+    context?: string;
+    priority?: 1 | 2 | 3 | 4 | 5;
+    parentId?: string;
+}
+/**
+ * Tasks API exposed to VM sandbox
+ */
+export declare const tasks: {
+    /**
+     * List tasks with optional filters
+     */
+    list(filter?: TaskFilter): Promise<Task[]>;
+    /**
+     * Get single task with full context and learnings
+     */
+    get(id: string): Promise<Task>;
+    /**
+     * Create new task
+     */
+    create(input: CreateTaskInput): Promise<Task>;
+    /**
+     * Update existing task
+     */
+    update(id: string, input: UpdateTaskInput): Promise<Task>;
+    /**
+     * Mark task as started
+     */
+    start(id: string): Promise<Task>;
+    /**
+     * Complete task with optional result
+     */
+    complete(id: string, result?: string): Promise<Task>;
+    /**
+     * Reopen completed task
+     */
+    reopen(id: string): Promise<Task>;
+    /**
+     * Delete task (cascades to children)
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Add blocker relationship
+     */
+    block(taskId: string, blockerId: string): Promise<void>;
+    /**
+     * Remove blocker relationship
+     */
+    unblock(taskId: string, blockerId: string): Promise<void>;
+    /**
+     * Get next ready task
+     */
+    nextReady(milestoneId?: string): Promise<Task | null>;
+};
+//# sourceMappingURL=tasks.d.ts.map

package/dist/api/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/api/tasks.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IAChB;;OAEG;kBACiB,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAQhD;;OAEG;YACW,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC;;OAEG;kBACiB,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnD;;OAEG;eACc,MAAM,SAAS,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/D;;OAEG;cACa,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC;;OAEG;iBACgB,MAAM,WAAW,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D;;OAEG;eACc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;OAEG;eACc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;OAEG;kBACiB,MAAM,aAAa,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;OAEG;oBACmB,MAAM,aAAa,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D;;OAEG;4BAC2B,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;CAK5D,CAAC"}

package/dist/api/tasks.js

@@ -0,0 +1,108 @@
+/**
+ * Tasks API - typed wrapper around os task commands
+ */
+import { callCli } from "../cli.js";
+/**
+ * Tasks API exposed to VM sandbox
+ */
+export const tasks = {
+    /**
+     * List tasks with optional filters
+     */
+    async list(filter) {
+        const args = ["task", "list"];
+        if (filter?.parentId)
+            args.push("--parent", filter.parentId);
+        if (filter?.ready)
+            args.push("--ready");
+        if (filter?.completed)
+            args.push("--completed");
+        return (await callCli(args));
+    },
+    /**
+     * Get single task with full context and learnings
+     */
+    async get(id) {
+        return (await callCli(["task", "get", id]));
+    },
+    /**
+     * Create new task
+     */
+    async create(input) {
+        const args = ["task", "create", "-d", input.description];
+        if (input.context)
+            args.push("--context", input.context);
+        if (input.parentId)
+            args.push("--parent", input.parentId);
+        if (input.priority)
+            args.push("--priority", String(input.priority));
+        if (input.blockedBy && input.blockedBy.length > 0) {
+            args.push("--blocked-by", input.blockedBy.join(","));
+        }
+        return (await callCli(args));
+    },
+    /**
+     * Update existing task
+     */
+    async update(id, input) {
+        const args = ["task", "update", id];
+        if (input.description)
+            args.push("-d", input.description);
+        if (input.context)
+            args.push("--context", input.context);
+        if (input.priority)
+            args.push("--priority", String(input.priority));
+        if (input.parentId)
+            args.push("--parent", input.parentId);
+        return (await callCli(args));
+    },
+    /**
+     * Mark task as started
+     */
+    async start(id) {
+        return (await callCli(["task", "start", id]));
+    },
+    /**
+     * Complete task with optional result
+     */
+    async complete(id, result) {
+        const args = ["task", "complete", id];
+        if (result)
+            args.push("--result", result);
+        return (await callCli(args));
+    },
+    /**
+     * Reopen completed task
+     */
+    async reopen(id) {
+        return (await callCli(["task", "reopen", id]));
+    },
+    /**
+     * Delete task (cascades to children)
+     */
+    async delete(id) {
+        await callCli(["task", "delete", id]);
+    },
+    /**
+     * Add blocker relationship
+     */
+    async block(taskId, blockerId) {
+        await callCli(["task", "block", taskId, "--by", blockerId]);
+    },
+    /**
+     * Remove blocker relationship
+     */
+    async unblock(taskId, blockerId) {
+        await callCli(["task", "unblock", taskId, "--by", blockerId]);
+    },
+    /**
+     * Get next ready task
+     */
+    async nextReady(milestoneId) {
+        const args = ["task", "next-ready"];
+        if (milestoneId)
+            args.push("--milestone", milestoneId);
+        return (await callCli(args));
+    },
+};
+//# sourceMappingURL=tasks.js.map

package/dist/api/tasks.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Execute os CLI command with --json flag
+ */
+export declare function callCli(args: string[]): Promise<unknown>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAmD9D"}

package/dist/cli.js

@@ -0,0 +1,52 @@
+/**
+ * CLI bridge - spawns `os` binary and parses JSON output
+ */
+import { spawn } from "node:child_process";
+import { CliError, CliTimeoutError } from "./types.js";
+const CLI_TIMEOUT_MS = 30_000;
+// Allow override via env var (useful for tests)
+const CLI_PATH = process.env.OVERSEER_CLI_PATH || "os";
+const CLI_CWD = process.env.OVERSEER_CLI_CWD || process.cwd();
+/**
+ * Execute os CLI command with --json flag
+ */
+export async function callCli(args) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn(CLI_PATH, [...args, "--json"], {
+            cwd: CLI_CWD,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const timeout = setTimeout(() => {
+            proc.kill("SIGTERM");
+            reject(new CliTimeoutError());
+        }, CLI_TIMEOUT_MS);
+        let stdout = "";
+        let stderr = "";
+        proc.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        proc.stderr.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        proc.on("error", (err) => {
+            clearTimeout(timeout);
+            reject(new CliError(`Failed to spawn os: ${err.message}`, -1, ""));
+        });
+        proc.on("close", (code) => {
+            clearTimeout(timeout);
+            if (code !== 0) {
+                const message = stderr.trim() || `os exited with code ${code}`;
+                reject(new CliError(message, code ?? -1, stderr));
+                return;
+            }
+            try {
+                const result = JSON.parse(stdout);
+                resolve(result);
+            }
+            catch (err) {
+                reject(new CliError(`Invalid JSON from os: ${err instanceof Error ? err.message : String(err)}`, 0, stdout));
+            }
+        });
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,cAAc,GAAG,MAAM,CAAC;AAE9B,gDAAgD;AAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC;AACvD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc;IAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,EAAE;YAChD,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrB,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;QAChC,CAAC,EAAE,cAAc,CAAC,CAAC;QAEnB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAC/B,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAC/B,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACvB,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,CAAC,IAAI,QAAQ,CAAC,uBAAuB,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,YAAY,CAAC,OAAO,CAAC,CAAC;YAEtB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,uBAAuB,IAAI,EAAE,CAAC;gBAC/D,MAAM,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;gBAClD,OAAO;YACT,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAClC,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CACJ,IAAI,QAAQ,CACV,yBAAyB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC3E,CAAC,EACD,MAAM,CACP,CACF,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/executor.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Execute agent-provided code in VM sandbox
+ */
+export declare function execute(code: string): Promise<unknown>;
+/**
+ * Execution error wrapper
+ */
+export declare class ExecutionError extends Error {
+    readonly stackTrace?: string | undefined;
+    constructor(message: string, stackTrace?: string | undefined);
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA6E5D;AAmBD;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;aAGrB,UAAU,CAAC,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA;CAKtC"}

package/dist/executor.js

@@ -0,0 +1,112 @@
+/**
+ * VM sandbox executor - runs agent code with exposed APIs
+ */
+import vm from "node:vm";
+import { tasks } from "./api/tasks.js";
+import { learnings } from "./api/learnings.js";
+const MAX_OUTPUT_SIZE = 50_000; // chars
+/**
+ * Execute agent-provided code in VM sandbox
+ */
+export async function execute(code) {
+    // Track timers to prevent resource leaks
+    const timers = new Set();
+    const MAX_TIMERS = 100;
+    // Create sandbox context with exposed APIs
+    // Note: VCS operations are now integrated into task start/complete, not exposed directly
+    const sandbox = {
+        tasks,
+        learnings,
+        console: {
+            log: (...args) => console.log("[sandbox]", ...args),
+            error: (...args) => console.error("[sandbox]", ...args),
+        },
+        // Wrap setTimeout to track and limit timers
+        setTimeout: (handler, timeout) => {
+            if (timers.size >= MAX_TIMERS) {
+                throw new Error(`Timer limit exceeded (max ${MAX_TIMERS})`);
+            }
+            const id = setTimeout(() => {
+                timers.delete(id);
+                handler();
+            }, timeout);
+            timers.add(id);
+            return id;
+        },
+        // Wrap setInterval to track and limit timers
+        setInterval: (handler, timeout) => {
+            if (timers.size >= MAX_TIMERS) {
+                throw new Error(`Timer limit exceeded (max ${MAX_TIMERS})`);
+            }
+            const id = setInterval(handler, timeout);
+            timers.add(id);
+            return id;
+        },
+        clearTimeout: (id) => {
+            timers.delete(id);
+            clearTimeout(id);
+        },
+        clearInterval: (id) => {
+            timers.delete(id);
+            clearInterval(id);
+        },
+        Promise,
+    };
+    // Wrap code in async IIFE to handle await
+    const wrappedCode = `
+    (async () => {
+      ${code}
+    })()
+  `;
+    try {
+        const script = new vm.Script(wrappedCode, {
+            filename: "agent-code.js",
+        });
+        const context = vm.createContext(sandbox);
+        const result = await script.runInContext(context, {
+            timeout: 30_000, // 30s max execution
+        });
+        return truncateOutput(result);
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            throw new ExecutionError(err.message, err.stack);
+        }
+        throw new ExecutionError(String(err));
+    }
+    finally {
+        // Clean up any remaining timers to prevent resource leaks
+        timers.forEach((id) => {
+            clearTimeout(id);
+            clearInterval(id);
+        });
+        timers.clear();
+    }
+}
+/**
+ * Truncate large outputs to prevent response overflow
+ */
+function truncateOutput(result) {
+    const json = JSON.stringify(result, null, 2);
+    if (json.length <= MAX_OUTPUT_SIZE) {
+        return result;
+    }
+    return {
+        _truncated: true,
+        size: json.length,
+        preview: json.slice(0, MAX_OUTPUT_SIZE),
+        message: `Output truncated (${json.length} chars, showing first ${MAX_OUTPUT_SIZE})`,
+    };
+}
+/**
+ * Execution error wrapper
+ */
+export class ExecutionError extends Error {
+    stackTrace;
+    constructor(message, stackTrace) {
+        super(message);
+        this.stackTrace = stackTrace;
+        this.name = "ExecutionError";
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Overseer MCP Server entry point
+ */
+import { startServer } from "./server.js";
+startServer().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC1B,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MCP Server - registers execute tool with type definitions
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+/**
+ * Create and configure MCP server
+ */
+export declare function createServer(): Server;
+/**
+ * Start MCP server with stdio transport
+ */
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAwGnE;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAiFrC;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAKjD"}