orbitx 0.0.8 → 0.1.0

package/dist/tools/bash/process-manager.d.ts

@@ -0,0 +1,35 @@
+import { type ChildProcessWithoutNullStreams } from "child_process";
+export type BashProcessStatus = "running" | "exited" | "error" | "terminated";
+/**
+ * Tracks one spawned shell process: its live status, combined stdout/stderr
+ * log ring buffer, and exit info. Kept in memory for the lifetime of the
+ * host process so long-running / endless processes (dev servers, watchers)
+ * can be inspected and terminated later instead of blocking a tool call.
+ */
+declare class BashProcess {
+    #private;
+    id: string;
+    command: string;
+    cwd: string;
+    child: ChildProcessWithoutNullStreams;
+    status: BashProcessStatus;
+    exitCode: number | null;
+    signal: string | null;
+    startedAt: number;
+    endedAt: number | null;
+    constructor(id: string, command: string, cwd: string, child: ChildProcessWithoutNullStreams);
+    pushChunk(chunk: string): void;
+    getLastLines(count: number): string[];
+    getAllLines(): string[];
+    markFinished(exitCode: number | null, signal: string | null): void;
+    /** Resolves when the process exits, or after timeoutMs elapses (whichever first). */
+    waitFor(timeoutMs: number): Promise<void>;
+}
+export declare function spawnProcess(command: string, cwd?: string): BashProcess;
+export declare function getProcess(id: string): BashProcess;
+export declare function listProcesses(): BashProcess[];
+export declare function writeToProcess(id: string, text: string, appendNewline?: boolean): void;
+export declare function terminateProcess(id: string, signal?: NodeJS.Signals): void;
+export default BashProcess;
+export { BashProcess };
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/tools/bash/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../../src/tools/bash/process-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,8BAA8B,EAAE,MAAM,eAAe,CAAC;AAG3E,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;AAK9E;;;;;GAKG;AACH,cAAM,WAAW;;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,8BAA8B,CAAC;IACtC,MAAM,EAAE,iBAAiB,CAAa;IACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC7B,SAAS,EAAE,MAAM,CAAc;IAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAQ;gBAIlB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,8BAA8B;IAO3F,SAAS,CAAC,KAAK,EAAE,MAAM;IAyBvB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAKrC,WAAW,IAAI,MAAM,EAAE;IAIvB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAU3D,qFAAqF;IACrF,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAc5C;AAUD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CA4BvE;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAIlD;AAED,wBAAgB,aAAa,IAAI,WAAW,EAAE,CAE7C;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,UAAO,GAAG,IAAI,CAMnF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,IAAI,CAIrF;AAED,eAAe,WAAW,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/tools/bash/process-manager.js

@@ -0,0 +1,137 @@
+import { spawn } from "child_process";
+import os from "os";
+const LOG_CAP = 20000; // max characters of combined output kept per process
+const MAX_LINE_LOG = 5000; // hard cap on number of log lines retained
+/**
+ * Tracks one spawned shell process: its live status, combined stdout/stderr
+ * log ring buffer, and exit info. Kept in memory for the lifetime of the
+ * host process so long-running / endless processes (dev servers, watchers)
+ * can be inspected and terminated later instead of blocking a tool call.
+ */
+class BashProcess {
+    id;
+    command;
+    cwd;
+    child;
+    status = "running";
+    exitCode = null;
+    signal = null;
+    startedAt = Date.now();
+    endedAt = null;
+    #lines = [];
+    #waiters = [];
+    constructor(id, command, cwd, child) {
+        this.id = id;
+        this.command = command;
+        this.cwd = cwd;
+        this.child = child;
+    }
+    pushChunk(chunk) {
+        const parts = chunk.split(/\r\n|\r|\n/);
+        // merge the first part into the last existing line if the previous
+        // chunk didn't end on a newline boundary
+        if (this.#lines.length > 0 && !this.#endsWithNewlineFlag) {
+            this.#lines[this.#lines.length - 1] += parts.shift();
+        }
+        this.#lines.push(...parts);
+        this.#endsWithNewlineFlag = chunk.endsWith("\n") || chunk.endsWith("\r");
+        if (this.#lines.length > MAX_LINE_LOG) {
+            this.#lines.splice(0, this.#lines.length - MAX_LINE_LOG);
+        }
+        this.#capChars();
+    }
+    #endsWithNewlineFlag = true;
+    #capChars() {
+        let total = this.#lines.reduce((sum, l) => sum + l.length + 1, 0);
+        while (total > LOG_CAP && this.#lines.length > 1) {
+            total -= this.#lines[0].length + 1;
+            this.#lines.shift();
+        }
+    }
+    getLastLines(count) {
+        if (count <= 0)
+            return [];
+        return this.#lines.slice(Math.max(0, this.#lines.length - count));
+    }
+    getAllLines() {
+        return this.#lines;
+    }
+    markFinished(exitCode, signal) {
+        this.status = signal ? "terminated" : exitCode === 0 ? "exited" : "error";
+        this.exitCode = exitCode;
+        this.signal = signal;
+        this.endedAt = Date.now();
+        const waiters = this.#waiters;
+        this.#waiters = [];
+        waiters.forEach((w) => w());
+    }
+    /** Resolves when the process exits, or after timeoutMs elapses (whichever first). */
+    waitFor(timeoutMs) {
+        if (this.status !== "running")
+            return Promise.resolve();
+        return new Promise((res) => {
+            const timer = setTimeout(() => {
+                this.#waiters = this.#waiters.filter((w) => w !== onDone);
+                res();
+            }, timeoutMs);
+            const onDone = () => {
+                clearTimeout(timer);
+                res();
+            };
+            this.#waiters.push(onDone);
+        });
+    }
+}
+const processes = new Map();
+let counter = 0;
+function nextId() {
+    counter += 1;
+    return `p${counter}`;
+}
+export function spawnProcess(command, cwd) {
+    const id = nextId();
+    const resolvedCwd = cwd || process.cwd();
+    const shell = os.platform() === "win32" ? "cmd.exe" : "/bin/bash";
+    const shellArgs = os.platform() === "win32" ? ["/d", "/s", "/c", command] : ["-c", command];
+    const child = spawn(shell, shellArgs, {
+        cwd: resolvedCwd,
+        windowsVerbatimArguments: os.platform() === "win32",
+    });
+    const proc = new BashProcess(id, command, resolvedCwd, child);
+    child.stdout.on("data", (data) => proc.pushChunk(data.toString("utf-8")));
+    child.stderr.on("data", (data) => proc.pushChunk(data.toString("utf-8")));
+    child.on("error", (err) => {
+        proc.pushChunk(`[process error] ${err.message}`);
+        proc.markFinished(null, null);
+    });
+    child.on("close", (code, signal) => {
+        proc.markFinished(code, signal);
+    });
+    processes.set(id, proc);
+    return proc;
+}
+export function getProcess(id) {
+    const proc = processes.get(id);
+    if (!proc)
+        throw new Error(`no bash process found with id "${id}"`);
+    return proc;
+}
+export function listProcesses() {
+    return Array.from(processes.values());
+}
+export function writeToProcess(id, text, appendNewline = true) {
+    const proc = getProcess(id);
+    if (proc.status !== "running") {
+        throw new Error(`process "${id}" is not running (status: ${proc.status})`);
+    }
+    proc.child.stdin.write(appendNewline ? `${text}\n` : text);
+}
+export function terminateProcess(id, signal = "SIGTERM") {
+    const proc = getProcess(id);
+    if (proc.status !== "running")
+        return;
+    proc.child.kill(signal);
+}
+export default BashProcess;
+export { BashProcess };
+//# sourceMappingURL=process-manager.js.map

package/dist/tools/bash/process-manager.js.map

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

package/dist/tools/bash/run.d.ts

@@ -0,0 +1,5 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BashInteraction } from "./interaction.js";
+export declare const BashRunTool: () => MCPTool<BashInteraction>;
+export default BashRunTool;
+//# sourceMappingURL=run.d.ts.map

package/dist/tools/bash/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/tools/bash/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,eAAO,MAAM,WAAW,gCA8DtB,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/dist/tools/bash/run.js

@@ -0,0 +1,57 @@
+import { MCPTool } from "../../core/mcp.js";
+import { platform } from "os";
+import { BashInteraction } from "./interaction.js";
+import { spawnProcess } from "./process-manager.js";
+export const BashRunTool = () => new MCPTool({
+    name: "bash-run",
+    description: "launch a shell command as a background process, returns its processId immediately. waits up to waitMs for it to finish; if it's still running after that (e.g. an endless process like `npm run dev`) it returns early with status \"running\" and the process keeps going in the background — use bash-wait or bash-logs to check on it later, and bash-terminate to stop it. if the process needs interactive input (e.g. a CLI prompt like \"please enter your project name:\"), use bash-write-input." + " your bash platform on os-type=" + platform(),
+    inputs: [
+        {
+            name: "command",
+            type: "string",
+            description: "shell command to run",
+            required: true,
+        },
+        {
+            name: "cwd",
+            type: "string",
+            description: "working directory to run the command in (defaults to process cwd)",
+            required: false,
+        },
+        {
+            name: "waitMs",
+            type: "number",
+            description: "max milliseconds to wait for the process to finish before returning early",
+            required: false,
+            default: 15000,
+        },
+        {
+            name: "tailLines",
+            type: "number",
+            description: "number of most recent output lines to include in the response",
+            required: false,
+            default: 20,
+        },
+    ],
+    customClass: new BashInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { command, cwd, waitMs = 15000, tailLines = 20 } = inputs;
+        if (!command || typeof command !== "string") {
+            throw new Error("command must be a non-empty string");
+        }
+        const proc = spawnProcess(command, cwd);
+        customClass?.emitBashEvent({ type: "process-started", processId: proc.id, command });
+        await proc.waitFor(waitMs);
+        if (proc.status !== "running") {
+            customClass?.emitBashEvent({ type: "process-exited", processId: proc.id, exitCode: proc.exitCode });
+        }
+        return {
+            processId: proc.id,
+            status: proc.status,
+            exitCode: proc.exitCode,
+            logs: proc.getLastLines(tailLines).join("\n"),
+        };
+    },
+});
+export default BashRunTool;
+//# sourceMappingURL=run.js.map

package/dist/tools/bash/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/tools/bash/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAkB;IAC1D,IAAI,EAAE,UAAU;IAChB,WAAW,EACP,2eAA2e,GAAG,iCAAiC,GAAG,QAAQ,EAAE;IAChiB,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,sBAAsB;YACnC,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mEAAmE;YAChF,QAAQ,EAAE,KAAK;SAClB;QACD;YACI,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2EAA2E;YACxF,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,KAAK;SACjB;QACD;YACI,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+DAA+D;YAC5E,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,EAAE;SACd;KACJ;IACD,WAAW,EAAE,IAAI,eAAe,EAAE;IAClC,OAAO,EAAE,KAAK,EACV,MAAc,EACd,MAA2B,EAC3B,IAAU,EACV,WAA6B,EACjB,EAAE;QACd,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;QAEhE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAExC,WAAW,EAAE,aAAa,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAErF,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE3B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC5B,WAAW,EAAE,aAAa,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxG,CAAC;QAED,OAAO;YACH,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;SAChD,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/dist/tools/bash/terminate.d.ts

@@ -0,0 +1,5 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BashInteraction } from "./interaction.js";
+export declare const BashTerminateTool: () => MCPTool<BashInteraction>;
+export default BashTerminateTool;
+//# sourceMappingURL=terminate.d.ts.map

package/dist/tools/bash/terminate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminate.d.ts","sourceRoot":"","sources":["../../../src/tools/bash/terminate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,eAAO,MAAM,iBAAiB,gCA2C5B,CAAC;AAEH,eAAe,iBAAiB,CAAC"}

package/dist/tools/bash/terminate.js

@@ -0,0 +1,39 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BashInteraction } from "./interaction.js";
+import { terminateProcess, getProcess } from "./process-manager.js";
+export const BashTerminateTool = () => new MCPTool({
+    name: "bash-terminate",
+    description: "terminate a running process (e.g. stop an endless `npm run dev` once it's no longer needed)",
+    inputs: [
+        {
+            name: "processId",
+            type: "string",
+            description: "id of the process to terminate",
+            required: true,
+        },
+        {
+            name: "force",
+            type: "boolean",
+            description: "use SIGKILL instead of SIGTERM for an immediate, non-graceful stop",
+            required: false,
+            default: false,
+        },
+    ],
+    customClass: new BashInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { processId, force = false } = inputs;
+        if (!processId || typeof processId !== "string") {
+            throw new Error("processId must be a non-empty string");
+        }
+        terminateProcess(processId, force ? "SIGKILL" : "SIGTERM");
+        const proc = getProcess(processId);
+        await proc.waitFor(3000);
+        customClass?.emitBashEvent({ type: "terminated", processId });
+        return {
+            message: "success",
+            status: proc.status,
+        };
+    },
+});
+export default BashTerminateTool;
+//# sourceMappingURL=terminate.js.map

package/dist/tools/bash/terminate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminate.js","sourceRoot":"","sources":["../../../src/tools/bash/terminate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEpE,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAkB;IAChE,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,6FAA6F;IAC1G,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gCAAgC;YAC7C,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,oEAAoE;YACjF,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,KAAK;SACjB;KACJ;IACD,WAAW,EAAE,IAAI,eAAe,EAAE;IAClC,OAAO,EAAE,KAAK,EACV,MAAc,EACd,MAA2B,EAC3B,IAAU,EACV,WAA6B,EACjB,EAAE;QACd,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QAE5C,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;QAED,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAE3D,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEzB,WAAW,EAAE,aAAa,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QAE9D,OAAO;YACH,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,IAAI,CAAC,MAAM;SACtB,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,iBAAiB,CAAC"}

package/dist/tools/bash/wait.d.ts

@@ -0,0 +1,5 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BashInteraction } from "./interaction.js";
+export declare const BashWaitTool: () => MCPTool<BashInteraction>;
+export default BashWaitTool;
+//# sourceMappingURL=wait.d.ts.map

package/dist/tools/bash/wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../../src/tools/bash/wait.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,eAAO,MAAM,YAAY,gCAwDvB,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/dist/tools/bash/wait.js

@@ -0,0 +1,50 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BashInteraction } from "./interaction.js";
+import { getProcess } from "./process-manager.js";
+export const BashWaitTool = () => new MCPTool({
+    name: "bash-wait",
+    description: "wait up to waitMs for a previously started process to finish, then return its status and the last N lines of output (works the same as the initial wait in bash-run, useful for polling a long-running process again)",
+    inputs: [
+        {
+            name: "processId",
+            type: "string",
+            description: "id of the process to wait on",
+            required: true,
+        },
+        {
+            name: "waitMs",
+            type: "number",
+            description: "max milliseconds to wait for the process to finish",
+            required: false,
+            default: 15000,
+        },
+        {
+            name: "tailLines",
+            type: "number",
+            description: "number of most recent output lines to include in the response",
+            required: false,
+            default: 20,
+        },
+    ],
+    customClass: new BashInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { processId, waitMs = 15000, tailLines = 20 } = inputs;
+        if (!processId || typeof processId !== "string") {
+            throw new Error("processId must be a non-empty string");
+        }
+        const proc = getProcess(processId);
+        customClass?.emitBashEvent({ type: "waiting", processId });
+        await proc.waitFor(waitMs);
+        if (proc.status !== "running") {
+            customClass?.emitBashEvent({ type: "process-exited", processId, exitCode: proc.exitCode });
+        }
+        return {
+            processId: proc.id,
+            status: proc.status,
+            exitCode: proc.exitCode,
+            logs: proc.getLastLines(tailLines).join("\n"),
+        };
+    },
+});
+export default BashWaitTool;
+//# sourceMappingURL=wait.js.map

package/dist/tools/bash/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../../src/tools/bash/wait.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAkB;IAC3D,IAAI,EAAE,WAAW;IACjB,WAAW,EACP,uNAAuN;IAC3N,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8BAA8B;YAC3C,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,oDAAoD;YACjE,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,KAAK;SACjB;QACD;YACI,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+DAA+D;YAC5E,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,EAAE;SACd;KACJ;IACD,WAAW,EAAE,IAAI,eAAe,EAAE;IAClC,OAAO,EAAE,KAAK,EACV,MAAc,EACd,MAA2B,EAC3B,IAAU,EACV,WAA6B,EACjB,EAAE;QACd,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;QAE7D,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QAEnC,WAAW,EAAE,aAAa,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;QAE3D,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE3B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC5B,WAAW,EAAE,aAAa,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/F,CAAC;QAED,OAAO;YACH,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;SAChD,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/dist/tools/bash/write-input.d.ts

@@ -0,0 +1,5 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BashInteraction } from "./interaction.js";
+export declare const BashWriteInputTool: () => MCPTool<BashInteraction>;
+export default BashWriteInputTool;
+//# sourceMappingURL=write-input.d.ts.map

package/dist/tools/bash/write-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-input.d.ts","sourceRoot":"","sources":["../../../src/tools/bash/write-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,eAAO,MAAM,kBAAkB,gCAoD7B,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/dist/tools/bash/write-input.js

@@ -0,0 +1,47 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BashInteraction } from "./interaction.js";
+import { writeToProcess, getProcess } from "./process-manager.js";
+export const BashWriteInputTool = () => new MCPTool({
+    name: "bash-write-input",
+    description: "send text to a running process's stdin, e.g. to answer an interactive prompt like \"please enter your project name:\" or confirm a \"(y/n)\" question. a newline is appended by default so the process receives it as an ENTER keypress.",
+    inputs: [
+        {
+            name: "processId",
+            type: "string",
+            description: "id of the process to write to",
+            required: true,
+        },
+        {
+            name: "text",
+            type: "string",
+            description: "text to send to stdin (e.g. \"my-project\" or \"y\")",
+            required: true,
+        },
+        {
+            name: "appendNewline",
+            type: "boolean",
+            description: "append a newline after text, simulating pressing ENTER",
+            required: false,
+            default: true,
+        },
+    ],
+    customClass: new BashInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { processId, text, appendNewline = true } = inputs;
+        if (!processId || typeof processId !== "string") {
+            throw new Error("processId must be a non-empty string");
+        }
+        if (typeof text !== "string") {
+            throw new Error("text must be a string");
+        }
+        writeToProcess(processId, text, appendNewline);
+        customClass?.emitBashEvent({ type: "input-sent", processId });
+        const proc = getProcess(processId);
+        return {
+            message: "success",
+            status: proc.status,
+        };
+    },
+});
+export default BashWriteInputTool;
+//# sourceMappingURL=write-input.js.map

package/dist/tools/bash/write-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-input.js","sourceRoot":"","sources":["../../../src/tools/bash/write-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElE,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAkB;IACjE,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACP,0OAA0O;IAC9O,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+BAA+B;YAC5C,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,sDAAsD;YACnE,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,wDAAwD;YACrE,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,IAAI;SAChB;KACJ;IACD,WAAW,EAAE,IAAI,eAAe,EAAE;IAClC,OAAO,EAAE,KAAK,EACV,MAAc,EACd,MAA2B,EAC3B,IAAU,EACV,WAA6B,EACjB,EAAE;QACd,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAEzD,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC7C,CAAC;QAED,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;QAE/C,WAAW,EAAE,aAAa,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QAE9D,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QAEnC,OAAO;YACH,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,IAAI,CAAC,MAAM;SACtB,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/dist/tools/browser/click.d.ts

@@ -0,0 +1,5 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BrowserInteraction } from "./interaction.js";
+export declare const BrowserClickTool: () => MCPTool<BrowserInteraction>;
+export default BrowserClickTool;
+//# sourceMappingURL=click.d.ts.map

package/dist/tools/browser/click.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/click.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAItD,eAAO,MAAM,gBAAgB,mCAiD3B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/dist/tools/browser/click.js

@@ -0,0 +1,44 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BrowserInteraction } from "./interaction.js";
+import { getSession } from "./session-manager.js";
+import { resolveRef } from "./read-page.js";
+export const BrowserClickTool = () => new MCPTool({
+    name: "browser-click",
+    description: "click a clickable element on the page (a ref id previously returned by browser-read, marked [CLICKABLE])",
+    inputs: [
+        {
+            name: "sessionId",
+            type: "string",
+            description: "session to act on",
+            required: true,
+        },
+        {
+            name: "ref",
+            type: "string",
+            description: "ref id of the element to click, e.g. 0x4",
+            required: true,
+        },
+    ],
+    customClass: new BrowserInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { sessionId, ref } = inputs;
+        if (!sessionId || typeof sessionId !== "string") {
+            throw new Error("sessionId must be a non-empty string");
+        }
+        if (!ref || typeof ref !== "string") {
+            throw new Error("ref must be a non-empty string");
+        }
+        customClass?.emitBrowserEvent({ type: "clicking", sessionId, ref });
+        const session = getSession(sessionId);
+        const element = await resolveRef(session.page, ref);
+        if (!element) {
+            throw new Error(`ref "${ref}" was not found on the page (call browser-read again to get fresh refs)`);
+        }
+        await element.click();
+        return {
+            message: "success",
+        };
+    },
+});
+export default BrowserClickTool;
+//# sourceMappingURL=click.js.map

package/dist/tools/browser/click.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"click.js","sourceRoot":"","sources":["../../../src/tools/browser/click.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAqB;IAClE,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,0GAA0G;IACvH,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mBAAmB;YAChC,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0CAA0C;YACvD,QAAQ,EAAE,IAAI;SACjB;KACJ;IACD,WAAW,EAAE,IAAI,kBAAkB,EAAE;IACrC,OAAO,EAAE,KAAK,EACV,MAAc,EACd,MAA2B,EAC3B,IAAU,EACV,WAAgC,EACpB,EAAE;QACd,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;QAElC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACtD,CAAC;QAED,WAAW,EAAE,gBAAgB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAEpE,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAEpD,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,yEAAyE,CAAC,CAAC;QAC1G,CAAC;QAED,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QAEtB,OAAO;YACH,OAAO,EAAE,SAAS;SACrB,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/dist/tools/browser/console.d.ts

@@ -0,0 +1,4 @@
+import { MCPTool } from "../../core/mcp.js";
+export declare const BrowserConsoleTool: () => MCPTool<undefined>;
+export default BrowserConsoleTool;
+//# sourceMappingURL=console.d.ts.map

package/dist/tools/browser/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/console.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C,eAAO,MAAM,kBAAkB,0BAuC7B,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/dist/tools/browser/console.js

@@ -0,0 +1,41 @@
+import { MCPTool } from "../../core/mcp.js";
+import { getSession } from "./session-manager.js";
+export const BrowserConsoleTool = () => new MCPTool({
+    name: "browser-console",
+    description: "read console log messages captured from a browser session (each message capped at 1000 characters)",
+    inputs: [
+        {
+            name: "sessionId",
+            type: "string",
+            description: "session to read console logs from",
+            required: true,
+        },
+        {
+            name: "limit",
+            type: "number",
+            description: "max number of messages to return",
+            required: false,
+            default: 20,
+        },
+        {
+            name: "offset",
+            type: "number",
+            description: "offset into the log buffer",
+            required: false,
+            default: 0,
+        },
+    ],
+    execute: async (_envID, inputs) => {
+        const { sessionId, limit = 20, offset = 0 } = inputs;
+        if (!sessionId || typeof sessionId !== "string") {
+            throw new Error("sessionId must be a non-empty string");
+        }
+        const session = getSession(sessionId);
+        return {
+            messages: session.consoleLogs.slice(offset, offset + limit),
+            total: session.consoleLogs.length,
+        };
+    },
+});
+export default BrowserConsoleTool;
+//# sourceMappingURL=console.js.map

package/dist/tools/browser/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/tools/browser/console.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAC;IAChD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,oGAAoG;IACjH,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mCAAmC;YAChD,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,kCAAkC;YAC/C,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,EAAE;SACd;QACD;YACI,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,4BAA4B;YACzC,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,CAAC;SACb;KACJ;IACD,OAAO,EAAE,KAAK,EAAE,MAAc,EAAE,MAA2B,EAAgB,EAAE;QACzE,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,EAAE,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC;QAErD,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QAEtC,OAAO;YACH,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;YAC3D,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,MAAM;SACpC,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/dist/tools/browser/create-session.d.ts

@@ -0,0 +1,5 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BrowserInteraction } from "./interaction.js";
+export declare const BrowserCreateSessionTool: () => MCPTool<BrowserInteraction>;
+export default BrowserCreateSessionTool;
+//# sourceMappingURL=create-session.d.ts.map

package/dist/tools/browser/create-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-session.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/create-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA2B,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,eAAO,MAAM,wBAAwB,mCAkCnC,CAAC;AAEH,eAAe,wBAAwB,CAAC"}

package/dist/tools/browser/create-session.js

@@ -0,0 +1,30 @@
+import { MCPTool, generateRefId } from "../../core/mcp.js";
+import { BrowserInteraction } from "./interaction.js";
+import { createSession } from "./session-manager.js";
+export const BrowserCreateSessionTool = () => new MCPTool({
+    name: "browser-create-session",
+    description: "open a new headless browser session at a given url, returns its sessionId",
+    inputs: [
+        {
+            name: "url",
+            type: "string",
+            description: "url to open the session at",
+            required: true,
+        },
+    ],
+    customClass: new BrowserInteraction(),
+    execute: async (_envID, inputs, mcp, customClass) => {
+        const { url } = inputs;
+        if (!url || typeof url !== "string") {
+            throw new Error("url must be a non-empty string");
+        }
+        const sessionId = await generateRefId(mcp);
+        customClass?.emitBrowserEvent({ type: "session-created", sessionId, url });
+        await createSession(url, sessionId);
+        return {
+            sessionId,
+        };
+    },
+});
+export default BrowserCreateSessionTool;
+//# sourceMappingURL=create-session.js.map

package/dist/tools/browser/create-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-session.js","sourceRoot":"","sources":["../../../src/tools/browser/create-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAY,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAqB;IAC1E,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,2EAA2E;IACxF,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,4BAA4B;YACzC,QAAQ,EAAE,IAAI;SACjB;KACJ;IACD,WAAW,EAAE,IAAI,kBAAkB,EAAE;IACrC,OAAO,EAAE,KAAK,EACV,MAAc,EACd,MAA2B,EAC3B,GAAS,EACT,WAAgC,EACpB,EAAE;QACd,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;QAEvB,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;QAE3C,WAAW,EAAE,gBAAgB,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAE3E,MAAM,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAEpC,OAAO;YACH,SAAS;SACZ,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,wBAAwB,CAAC"}

package/dist/tools/browser/evaluate-safe.d.ts

@@ -0,0 +1,10 @@
+import type { Page } from "puppeteer-core";
+/**
+ * Drop-in replacement for `page.evaluate(fn, ...args)` that is safe to call
+ * from a project run under tsx/ts-node/esbuild as well as a plain `tsc`
+ * build. Always use this (instead of page.evaluate directly) for any
+ * callback that declares nested named `const`/`let` functions.
+ */
+export declare function evaluateSafe<T, A extends any[]>(page: Page, fn: (...args: A) => T | Promise<T>, ...args: A): Promise<T>;
+export default evaluateSafe;
+//# sourceMappingURL=evaluate-safe.d.ts.map

package/dist/tools/browser/evaluate-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-safe.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/evaluate-safe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAuD3C;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,GAAG,EAAE,EACjD,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAClC,GAAG,IAAI,EAAE,CAAC,GACX,OAAO,CAAC,CAAC,CAAC,CAaZ;AAED,eAAe,YAAY,CAAC"}