@yjjeong/omg 0.1.0

package/dist/core/tools/tools.js

@@ -0,0 +1,328 @@
+// Tool registry + default tools. Mirror of legacy/omg/core/tools.py.
+import { existsSync, mkdirSync, readFileSync, statSync, readdirSync, writeFileSync, } from "node:fs";
+import { dirname, isAbsolute, relative, resolve as resolvePath, sep, } from "node:path";
+import { spawn } from "node:child_process";
+import { appendDecision, resolveProjectId } from "../continuum/index.js";
+export class ToolRegistry {
+    tools = new Map();
+    register(name, fn) {
+        if (typeof name !== "string" || name === "") {
+            throw new Error("tool name must be a non-empty string");
+        }
+        if (this.tools.has(name)) {
+            throw new Error(`tool '${name}' already registered`);
+        }
+        this.tools.set(name, fn);
+    }
+    has(name) {
+        return this.tools.has(name);
+    }
+    get names() {
+        return [...this.tools.keys()].sort();
+    }
+    async call(name, args, ctx) {
+        const fn = this.tools.get(name);
+        if (fn === undefined) {
+            return {
+                ok: false,
+                value: null,
+                error: `unknown tool '${name}'; known: [${this.names.map((n) => `'${n}'`).join(", ")}]`,
+            };
+        }
+        try {
+            const value = await fn(args, ctx);
+            return { ok: true, value, error: "" };
+        }
+        catch (e) {
+            // Prefer the explicit name (FileNotFoundError, NotADirectoryError set
+            // by makeError) over constructor.name, which would always be "Error".
+            const explicitName = e instanceof Error && e.name && e.name !== "Error" ? e.name : null;
+            const name = explicitName ?? (e instanceof Error ? e.constructor.name : "Error");
+            const msg = e instanceof Error ? e.message : String(e);
+            return { ok: false, value: null, error: `${name}: ${msg}` };
+        }
+    }
+}
+/** True when `target` is `root` itself or lives beneath it. Cross-platform:
+ *  compares via path.relative so it works with `\` on Windows and `/` on
+ *  POSIX, instead of a hardcoded `root + "/"` prefix (which never matched
+ *  Windows separators). */
+function isInsideCwd(rootResolved, target) {
+    if (target === rootResolved)
+        return true;
+    const r = relative(rootResolved, target);
+    return r !== "" && r !== ".." && !r.startsWith(".." + sep) && !isAbsolute(r);
+}
+function confineToCwd(root, rel, tool) {
+    if (typeof rel !== "string" || rel === "") {
+        throw new Error(`${tool}: 'path' must be a non-empty string`);
+    }
+    const target = resolvePath(root, rel);
+    const rootResolved = resolvePath(root);
+    if (!isInsideCwd(rootResolved, target)) {
+        throw new Error(`path escapes cwd: ${rel}`);
+    }
+    return target;
+}
+export function defaultRegistry(cwd = process.cwd()) {
+    const root = resolvePath(cwd);
+    const reg = new ToolRegistry();
+    reg.register("echo", async (args) => ({
+        echoed: typeof args.text === "string" ? args.text : "",
+    }));
+    reg.register("noop", async () => ({}));
+    // Phase 201c: model-callable decision capture. Writes directly to
+    // the project continuum identified by `root` (which is OMG_TAB_CWD
+    // when invoked from a wrapped CLI). No broker needed — the MCP
+    // server grandchild has filesystem access to ~/.omg already.
+    reg.register("record_decision", async (args) => {
+        const text = typeof args.text === "string" ? args.text.trim() : "";
+        if (!text) {
+            throw new Error("record_decision: 'text' must be a non-empty string");
+        }
+        const pid = resolveProjectId(root);
+        const m = appendDecision(pid.id, {
+            text,
+            ts: Date.now(),
+            source: "model",
+        });
+        return {
+            recorded: true,
+            projectId: pid.id,
+            totalDecisions: m.decisions.length,
+        };
+    });
+    reg.register("read_file", async (args) => {
+        const target = confineToCwd(root, args.path, "read_file");
+        if (!existsSync(target) || !statSync(target).isFile()) {
+            throw makeError("FileNotFoundError", target);
+        }
+        return { content: readFileSync(target, "utf-8") };
+    });
+    reg.register("list_dir", async (args) => {
+        const rel = args.path ?? ".";
+        if (typeof rel !== "string") {
+            throw new Error("list_dir: 'path' must be a string");
+        }
+        const target = resolvePath(root, rel);
+        const rootResolved = resolvePath(root);
+        if (!isInsideCwd(rootResolved, target)) {
+            throw new Error(`path escapes cwd: ${rel}`);
+        }
+        if (!existsSync(target) || !statSync(target).isDirectory()) {
+            throw makeError("NotADirectoryError", target);
+        }
+        const entries = readdirSync(target)
+            .sort()
+            .map((name) => {
+            const full = resolvePath(target, name);
+            return {
+                name,
+                type: statSync(full).isDirectory() ? "dir" : "file",
+            };
+        });
+        return { entries };
+    });
+    return reg;
+}
+export function defaultWritableRegistry(cwd = process.cwd()) {
+    const root = resolvePath(cwd);
+    const reg = defaultRegistry(root);
+    reg.register("write_file", async (args) => {
+        const target = confineToCwd(root, args.path, "write_file");
+        const content = args.content;
+        if (typeof content !== "string") {
+            throw new Error("write_file: 'content' must be a string");
+        }
+        mkdirSync(dirname(target), { recursive: true });
+        writeFileSync(target, content, "utf-8");
+        // Cross-platform relative path (handles `\` on Windows).
+        const rootResolved = resolvePath(root);
+        const r = relative(rootResolved, target);
+        const rel = r === "" || r.startsWith("..") || isAbsolute(r) ? target : r;
+        return {
+            bytes_written: Buffer.byteLength(content, "utf8"),
+            path: rel,
+        };
+    });
+    return reg;
+}
+function makeError(name, message) {
+    const err = new Error(message);
+    err.name = name;
+    return err;
+}
+// ---------- run_shell (Phase 15) ---------------------------------------
+//
+// Privileged: a shell command can `cd` anywhere and read/write outside
+// the registry root. The cwd setting is advisory. Pair `--shell-tools`
+// with `--ask` and treat the gate as the real boundary.
+//
+// Env is scrubbed to a minimal set so API keys and other secrets do not
+// leak into the child. Output is capped (default 256 KB stdout + stderr
+// combined); a timeout (default 10 min, 30-min ceiling — Phase 333/W3)
+// hard-kills the child.
+// Phase 333 (W3): raised from 30s to mirror claude-cli's Bash timeout
+// (Phase 331). codex's native shell is capped at ~30s upstream
+// (openai/codex#3287, "not planned"), so omg nudges codex to route long
+// builds through run_shell instead — but that only helps if run_shell
+// itself tolerates a multi-minute build. 10-min default, 30-min ceiling,
+// matching the claude path so a bounded build finishes in-turn either way.
+const DEFAULT_SHELL_TIMEOUT_MS = 600_000;
+const SHELL_TIMEOUT_CEILING_MS = 1_800_000;
+const DEFAULT_SHELL_OUTPUT_LIMIT = 256_000;
+const SCRUBBED_ENV_KEYS = ["PATH", "HOME", "LANG", "LC_ALL", "TZ"];
+function scrubbedEnv() {
+    const out = { TERM: "dumb" };
+    for (const k of SCRUBBED_ENV_KEYS) {
+        const v = process.env[k];
+        if (v !== undefined)
+            out[k] = v;
+    }
+    if (out.PATH === undefined) {
+        out.PATH =
+            process.platform === "win32"
+                ? `${process.env.SystemRoot ?? "C:\\Windows"}\\System32;${process.env.SystemRoot ?? "C:\\Windows"}`
+                : "/usr/local/bin:/usr/bin:/bin";
+    }
+    return out;
+}
+export function defaultShellRegistry(cwd = process.cwd()) {
+    const root = resolvePath(cwd);
+    const reg = defaultWritableRegistry(root);
+    reg.register("run_shell", async (args, ctx) => {
+        const command = args.command;
+        if (typeof command !== "string" || command === "") {
+            throw new Error("run_shell: 'command' must be a non-empty string");
+        }
+        const timeoutMs = typeof args.timeout_ms === "number" && args.timeout_ms > 0
+            ? Math.min(args.timeout_ms, SHELL_TIMEOUT_CEILING_MS) // 30-min ceiling
+            : DEFAULT_SHELL_TIMEOUT_MS;
+        const outputLimit = typeof args.max_output_bytes === "number" && args.max_output_bytes > 0
+            ? Math.min(args.max_output_bytes, 4 * 1024 * 1024) // 4 MB ceiling
+            : DEFAULT_SHELL_OUTPUT_LIMIT;
+        const started = Date.now();
+        const result = await runShellOnce(command, root, timeoutMs, outputLimit, ctx?.onProgress);
+        return {
+            ...result,
+            duration_ms: Date.now() - started,
+        };
+    });
+    return reg;
+}
+async function runShellOnce(command, cwd, timeoutMs, outputLimit, onProgress) {
+    return new Promise((resolve, reject) => {
+        // Platform shell: cmd.exe on Windows, /bin/sh on POSIX. The model is
+        // expected to emit commands in the host platform's shell syntax.
+        const [shellBin, shellArgs] = process.platform === "win32"
+            ? [process.env.ComSpec ?? "cmd.exe", ["/d", "/s", "/c", command]]
+            : ["/bin/sh", ["-c", command]];
+        const child = spawn(shellBin, shellArgs, {
+            cwd,
+            env: scrubbedEnv(),
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        let stdoutLen = 0;
+        let stderrLen = 0;
+        let truncated = false;
+        const reportProgress = (buf) => {
+            if (!onProgress)
+                return;
+            try {
+                onProgress(buf.toString("utf-8"));
+            }
+            catch {
+                /* progress reporting must never break the child */
+            }
+        };
+        const onStdout = (chunk) => {
+            stdoutLen += chunk.length;
+            if (stdoutLen + stderrLen > outputLimit) {
+                truncated = true;
+                try {
+                    child.kill("SIGTERM");
+                }
+                catch {
+                    /* ignore */
+                }
+                return;
+            }
+            stdoutChunks.push(chunk);
+            reportProgress(chunk);
+        };
+        const onStderr = (chunk) => {
+            stderrLen += chunk.length;
+            if (stdoutLen + stderrLen > outputLimit) {
+                truncated = true;
+                try {
+                    child.kill("SIGTERM");
+                }
+                catch {
+                    /* ignore */
+                }
+                return;
+            }
+            stderrChunks.push(chunk);
+            reportProgress(chunk);
+        };
+        child.stdout?.on("data", onStdout);
+        child.stderr?.on("data", onStderr);
+        const timer = setTimeout(() => {
+            truncated = true;
+            try {
+                child.kill("SIGKILL");
+            }
+            catch {
+                /* ignore */
+            }
+        }, timeoutMs);
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        child.on("close", (code, signal) => {
+            clearTimeout(timer);
+            resolve({
+                stdout: Buffer.concat(stdoutChunks).toString("utf-8"),
+                stderr: Buffer.concat(stderrChunks).toString("utf-8"),
+                exit_code: code,
+                signal: signal ?? null,
+                truncated,
+            });
+        });
+    });
+}
+export function registerDelegate(reg, opts) {
+    reg.register("delegate", async (args, ctx) => {
+        const role = typeof args.role === "string" ? args.role : "";
+        const prompt = typeof args.prompt === "string" ? args.prompt : "";
+        if (!role) {
+            throw new Error("delegate: 'role' must be a non-empty string");
+        }
+        if (!prompt) {
+            throw new Error("delegate: 'prompt' must be a non-empty string");
+        }
+        if (!opts.roles.includes(role)) {
+            throw new Error(`delegate: unknown role '${role}'; known: ${opts.roles
+                .map((r) => `'${r}'`)
+                .join(", ")}`);
+        }
+        const adapter = await opts.resolveAdapter(role);
+        const parts = [];
+        const stream = adapter.stream(prompt);
+        for await (const chunk of stream) {
+            if (chunk.type === "text" && typeof chunk.text === "string") {
+                parts.push(chunk.text);
+                ctx?.onProgress?.(chunk.text);
+                continue;
+            }
+            if (chunk.type === "stream_end")
+                break;
+        }
+        const text = parts.join("");
+        return { role, text };
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/core/tools/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/core/tools/tools.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,OAAO,EACL,UAAU,EACV,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,OAAO,EACP,UAAU,EACV,QAAQ,EACR,OAAO,IAAI,WAAW,EACtB,GAAG,GACJ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAqBzE,MAAM,OAAO,YAAY;IACN,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEnD,QAAQ,CAAC,IAAY,EAAE,EAAU;QAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,sBAAsB,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,IAAI,CACR,IAAY,EACZ,IAA6B,EAC7B,GAAqB;QAErB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,IAAI;gBACX,KAAK,EAAE,iBAAiB,IAAI,cAAc,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;aACxF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAClC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACxC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,sEAAsE;YACtE,sEAAsE;YACtE,MAAM,YAAY,GAChB,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YACrE,MAAM,IAAI,GACR,YAAY,IAAI,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACtE,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QAC9D,CAAC;IACH,CAAC;CACF;AAED;;;2BAG2B;AAC3B,SAAS,WAAW,CAAC,YAAoB,EAAE,MAAc;IACvD,IAAI,MAAM,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,GAAY,EAAE,IAAY;IAC5D,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,qCAAqC,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACzD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,IAAI,YAAY,EAAE,CAAC;IAE/B,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACpC,MAAM,EAAE,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;KACvD,CAAC,CAAC,CAAC;IAEJ,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEvC,kEAAkE;IAClE,mEAAmE;IACnE,+DAA+D;IAC/D,6DAA6D;IAC7D,GAAG,CAAC,QAAQ,CAAC,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC7C,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE;YAC/B,IAAI;YACJ,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,MAAM,EAAE,OAAO;SAChB,CAAC,CAAC;QACH,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,GAAG,CAAC,EAAE;YACjB,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM;SACnC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACvC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC1D,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACtD,MAAM,SAAS,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC;QAC7B,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACtC,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YAC3D,MAAM,SAAS,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC;aAChC,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACvC,OAAO;gBACL,IAAI;gBACJ,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM;aACpD,CAAC;QACJ,CAAC,CAAC,CAAC;QACL,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,MAAc,OAAO,CAAC,GAAG,EAAE;IAE3B,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAElC,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACxC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACxC,yDAAyD;QACzD,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,OAAO;YACL,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;YACjD,IAAI,EAAE,GAAG;SACV,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,OAAe;IAC9C,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,0EAA0E;AAC1E,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AACvE,wDAAwD;AACxD,EAAE;AACF,wEAAwE;AACxE,wEAAwE;AACxE,uEAAuE;AACvE,wBAAwB;AAExB,sEAAsE;AACtE,+DAA+D;AAC/D,wEAAwE;AACxE,sEAAsE;AACtE,yEAAyE;AACzE,2EAA2E;AAC3E,MAAM,wBAAwB,GAAG,OAAO,CAAC;AACzC,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAC3C,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAC3C,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAU,CAAC;AAW5E,SAAS,WAAW;IAClB,MAAM,GAAG,GAAsB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC3B,GAAG,CAAC,IAAI;YACN,OAAO,CAAC,QAAQ,KAAK,OAAO;gBAC1B,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,aAAa,cAAc,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,aAAa,EAAE;gBACnG,CAAC,CAAC,8BAA8B,CAAC;IACvC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAAc,OAAO,CAAC,GAAG,EAAE;IAE3B,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAE1C,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,SAAS,GACb,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC;YACxD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC,iBAAiB;YACvE,CAAC,CAAC,wBAAwB,CAAC;QAC/B,MAAM,WAAW,GACf,OAAO,IAAI,CAAC,gBAAgB,KAAK,QAAQ,IAAI,IAAI,CAAC,gBAAgB,GAAG,CAAC;YACpE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,eAAe;YAClE,CAAC,CAAC,0BAA0B,CAAC;QAEjC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,OAAO,EACP,IAAI,EACJ,SAAS,EACT,WAAW,EACX,GAAG,EAAE,UAAU,CAChB,CAAC;QACF,OAAO;YACL,GAAG,MAAM;YACT,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;SAClC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,OAAe,EACf,GAAW,EACX,SAAiB,EACjB,WAAmB,EACnB,UAAoC;IAEpC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,qEAAqE;QACrE,iEAAiE;QACjE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GACzB,OAAO,CAAC,QAAQ,KAAK,OAAO;YAC1B,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YACjE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE;YACvC,GAAG;YACH,GAAG,EAAE,WAAW,EAAE;YAClB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QAEH,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,cAAc,GAAG,CAAC,GAAW,EAAQ,EAAE;YAC3C,IAAI,CAAC,UAAU;gBAAE,OAAO;YACxB,IAAI,CAAC;gBACH,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,mDAAmD;YACrD,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAQ,EAAE;YACvC,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC;YAC1B,IAAI,SAAS,GAAG,SAAS,GAAG,WAAW,EAAE,CAAC;gBACxC,SAAS,GAAG,IAAI,CAAC;gBACjB,IAAI,CAAC;oBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;gBACD,OAAO;YACT,CAAC;YACD,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,cAAc,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC,CAAC;QACF,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAQ,EAAE;YACvC,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC;YAC1B,IAAI,SAAS,GAAG,SAAS,GAAG,WAAW,EAAE,CAAC;gBACxC,SAAS,GAAG,IAAI,CAAC;gBACjB,IAAI,CAAC;oBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;gBACD,OAAO;YACT,CAAC;YACD,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,cAAc,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC,CAAC;QAEF,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACnC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAEnC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,SAAS,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC;gBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YACjC,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC;gBACN,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACrD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACrD,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,MAAM,IAAI,IAAI;gBACtB,SAAS;aACV,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAoBD,MAAM,UAAU,gBAAgB,CAAC,GAAiB,EAAE,IAAkB;IACpE,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3C,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,aAAa,IAAI,CAAC,KAAK;iBACnD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;iBACpB,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAGxB,EAAE,CAAC;YACH,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC5D,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACvB,GAAG,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9B,SAAS;YACX,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;gBAAE,MAAM;QACzC,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/tools.d.ts

@@ -0,0 +1,34 @@
+import type { LLMAdapter } from "./adapter.js";
+export interface ToolResult {
+    readonly ok: boolean;
+    readonly value: unknown;
+    readonly error: string;
+}
+/** Phase 79: optional progress-reporting context. Tools that take a
+ *  while (run_shell, long file scans) call `ctx.onProgress(chunk)`
+ *  as output becomes available. Callers that don't care leave the
+ *  context off and the onProgress branch is a no-op. */
+export interface ToolCallContext {
+    onProgress?: (text: string) => void;
+}
+export type ToolFn = (args: Record<string, unknown>, ctx?: ToolCallContext) => Promise<unknown>;
+export declare class ToolRegistry {
+    private readonly tools;
+    register(name: string, fn: ToolFn): void;
+    has(name: string): boolean;
+    get names(): string[];
+    call(name: string, args: Record<string, unknown>, ctx?: ToolCallContext): Promise<ToolResult>;
+}
+export declare function defaultRegistry(cwd?: string): ToolRegistry;
+export declare function defaultWritableRegistry(cwd?: string): ToolRegistry;
+export declare function defaultShellRegistry(cwd?: string): ToolRegistry;
+export interface DelegateOpts {
+    /** Resolve a role name to a ready-to-stream adapter. Builds a fresh
+     *  adapter per call so sub-agents always run in isolated sessions. */
+    resolveAdapter: (role: string) => Promise<LLMAdapter>;
+    /** Known role names (from team.yaml). Used for validation + better
+     *  error messages on unknown roles. */
+    roles: readonly string[];
+}
+export declare function registerDelegate(reg: ToolRegistry, opts: DelegateOpts): void;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/core/tools.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;wDAGwD;AACxD,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,MAAM,MAAM,GAAG,CACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,CAAC,EAAE,eAAe,KAClB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IAEnD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAUxC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAEK,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,CAAC,EAAE,eAAe,GACpB,OAAO,CAAC,UAAU,CAAC;CAuBvB;AAcD,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAsB,GAAG,YAAY,CAkEzE;AAED,wBAAgB,uBAAuB,CACrC,GAAG,GAAE,MAAsB,GAC1B,YAAY,CAsBd;AAyCD,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,MAAsB,GAC1B,YAAY,CAiCd;AAiGD,MAAM,WAAW,YAAY;IAC3B;0EACsE;IACtE,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACtD;2CACuC;IACvC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAkC5E"}