orbitx 0.0.8 → 0.0.9

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

@@ -0,0 +1,35 @@
+import { type Browser, type Page } from "puppeteer-core";
+export interface ConsoleLogEntry {
+    type: string;
+    content: string;
+}
+export interface NetworkLogEntry {
+    type: string;
+    status: number;
+    requestHeaders: Record<string, string>;
+    request: string;
+    responseHeaders: Record<string, string>;
+    response: string;
+}
+/**
+ * Holds everything tied to one live browser session: the Puppeteer browser
+ * and page, plus the ref-id map used so the AI can refer to clickable /
+ * fillable elements by a stable short hex id instead of re-describing them.
+ */
+declare class BrowserSession {
+    id: string;
+    browser: Browser;
+    page: Page;
+    consoleLogs: ConsoleLogEntry[];
+    networkLogs: NetworkLogEntry[];
+    constructor(id: string, browser: Browser, page: Page);
+    pushConsoleLog(entry: ConsoleLogEntry): void;
+    pushNetworkLog(entry: NetworkLogEntry): void;
+}
+export declare function createSession(url: string, sessionId: string): Promise<BrowserSession>;
+export declare function getSession(sessionId: string): BrowserSession;
+export declare function getSessionIds(): string[];
+export declare function removeSession(sessionId: string): Promise<void>;
+export default BrowserSession;
+export { BrowserSession };
+//# sourceMappingURL=session-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/session-manager.ts"],"names":[],"mappings":"AACA,OAAkB,EAAE,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;CACpB;AAMD;;;;GAIG;AACH,cAAM,cAAc;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,eAAe,EAAE,CAAM;IACpC,WAAW,EAAE,eAAe,EAAE,CAAM;gBAExB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI;IAMpD,cAAc,CAAC,KAAK,EAAE,eAAe;IAOrC,cAAc,CAAC,KAAK,EAAE,eAAe;CAMxC;AAQD,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAgD3F;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAM5D;AAED,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpE;AAED,eAAe,cAAc,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,CAAC"}

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

@@ -0,0 +1,101 @@
+import os from "os";
+import puppeteer, {} from "puppeteer-core";
+const CONSOLE_LOG_CAP = 1000;
+const NETWORK_LOG_CAP = 1000;
+const MAX_LOG_ENTRIES = 500;
+/**
+ * Holds everything tied to one live browser session: the Puppeteer browser
+ * and page, plus the ref-id map used so the AI can refer to clickable /
+ * fillable elements by a stable short hex id instead of re-describing them.
+ */
+class BrowserSession {
+    id;
+    browser;
+    page;
+    consoleLogs = [];
+    networkLogs = [];
+    constructor(id, browser, page) {
+        this.id = id;
+        this.browser = browser;
+        this.page = page;
+    }
+    pushConsoleLog(entry) {
+        this.consoleLogs.push(entry);
+        if (this.consoleLogs.length > MAX_LOG_ENTRIES) {
+            this.consoleLogs.splice(0, this.consoleLogs.length - MAX_LOG_ENTRIES);
+        }
+    }
+    pushNetworkLog(entry) {
+        this.networkLogs.push(entry);
+        if (this.networkLogs.length > MAX_LOG_ENTRIES) {
+            this.networkLogs.splice(0, this.networkLogs.length - MAX_LOG_ENTRIES);
+        }
+    }
+}
+const sessions = new Map();
+function truncate(str, cap) {
+    return str.length > cap ? str.slice(0, cap) : str;
+}
+export async function createSession(url, sessionId) {
+    const browser = await puppeteer.launch({
+        executablePath: process.env.CHROME_PATH || (os.platform() == "win32" ?
+            "C:/Program Files/Google/Chrome/Application/chrome.exe" :
+            "/usr/bin/google-chrome-stable"),
+        headless: Boolean(process.env.HEADLESS_BROWSER_SESSIONS || true),
+        args: ["--no-sandbox"],
+    });
+    const page = await browser.newPage();
+    const session = new BrowserSession(sessionId, browser, page);
+    page.on("console", (msg) => {
+        session.pushConsoleLog({
+            type: msg.type(),
+            content: truncate(msg.text(), CONSOLE_LOG_CAP),
+        });
+    });
+    page.on("response", async (response) => {
+        try {
+            const request = response.request();
+            let responseBody = "";
+            try {
+                responseBody = await response.text();
+            }
+            catch {
+                responseBody = "";
+            }
+            session.pushNetworkLog({
+                type: request.resourceType(),
+                status: response.status(),
+                requestHeaders: request.headers(),
+                request: truncate(request.postData() || request.url(), NETWORK_LOG_CAP),
+                responseHeaders: response.headers(),
+                response: truncate(responseBody, NETWORK_LOG_CAP),
+            });
+        }
+        catch {
+            // best-effort logging only, never throw from an event handler
+        }
+    });
+    await page.goto(url, { waitUntil: "domcontentloaded" });
+    sessions.set(sessionId, session);
+    return session;
+}
+export function getSession(sessionId) {
+    const session = sessions.get(sessionId);
+    if (!session) {
+        throw new Error(`no browser session found with id "${sessionId}"`);
+    }
+    return session;
+}
+export function getSessionIds() {
+    return Array.from(sessions.keys());
+}
+export async function removeSession(sessionId) {
+    const session = sessions.get(sessionId);
+    if (!session)
+        return;
+    await session.browser.close().catch(() => { });
+    sessions.delete(sessionId);
+}
+export default BrowserSession;
+export { BrowserSession };
+//# sourceMappingURL=session-manager.js.map

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

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

package/dist/tools/browser/submit-form.d.ts

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

package/dist/tools/browser/submit-form.d.ts.map

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

package/dist/tools/browser/submit-form.js

@@ -0,0 +1,45 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BrowserInteraction } from "./interaction.js";
+import { getSession } from "./session-manager.js";
+import { submitForm } from "./read-page.js";
+export const BrowserSubmitFormTool = () => new MCPTool({
+    name: "browser-submit-form",
+    description: "submit a <form> on the page by its ref id (the [FORM] ref shown by browser-read). " +
+        "use this for forms that have no visible submit button — e.g. a search box where the only way to search is pressing Enter — since there is nothing to browser-click. " +
+        "this has the same effect as focusing a field inside the form and pressing Enter.",
+    inputs: [
+        {
+            name: "sessionId",
+            type: "string",
+            description: "session to act on",
+            required: true,
+        },
+        {
+            name: "formRef",
+            type: "string",
+            description: "ref id of the form to submit, e.g. 0x7",
+            required: true,
+        },
+    ],
+    customClass: new BrowserInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { sessionId, formRef } = inputs;
+        if (!sessionId || typeof sessionId !== "string") {
+            throw new Error("sessionId must be a non-empty string");
+        }
+        if (!formRef || typeof formRef !== "string") {
+            throw new Error("formRef must be a non-empty string");
+        }
+        customClass?.emitBrowserEvent({ type: "submitting-form", sessionId, formRef });
+        const session = getSession(sessionId);
+        const submitted = await submitForm(session.page, formRef);
+        if (!submitted) {
+            throw new Error(`formRef "${formRef}" was not found on the page (call browser-read again to get a fresh form ref)`);
+        }
+        return {
+            message: "success",
+        };
+    },
+});
+export default BrowserSubmitFormTool;
+//# sourceMappingURL=submit-form.js.map

package/dist/tools/browser/submit-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-form.js","sourceRoot":"","sources":["../../../src/tools/browser/submit-form.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,qBAAqB,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAqB;IACvE,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACP,oFAAoF;QACpF,sKAAsK;QACtK,kFAAkF;IACtF,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mBAAmB;YAChC,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wCAAwC;YACrD,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,OAAO,EAAE,GAAG,MAAM,CAAC;QAEtC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC1D,CAAC;QAED,WAAW,EAAE,gBAAgB,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QAE/E,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE1D,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,+EAA+E,CAAC,CAAC;QACxH,CAAC;QAED,OAAO;YACH,OAAO,EAAE,SAAS;SACrB,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,qBAAqB,CAAC"}

package/dist/tools/fs/create-dir.d.ts

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

package/dist/tools/fs/create-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-dir.d.ts","sourceRoot":"","sources":["../../../src/tools/fs/create-dir.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,eAAO,MAAM,eAAe,8BA8B1B,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/dist/tools/fs/create-dir.js

@@ -0,0 +1,28 @@
+import { mkdir } from "fs/promises";
+import { MCPTool } from "../../core/mcp.js";
+import { FsInteraction } from "./interaction.js";
+import { resolvePath } from "./utils.js";
+export const FsCreateDirTool = () => new MCPTool({
+    name: "fs-create-dir",
+    description: "create a directory, including any missing parent directories",
+    inputs: [
+        {
+            name: "path",
+            type: "string",
+            description: "absolute or cwd-relative path to the directory to create",
+            required: true,
+        },
+    ],
+    customClass: new FsInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { path } = inputs;
+        const fullPath = resolvePath(path);
+        customClass?.emitFsEvent({ type: "dir-created", path: fullPath });
+        await mkdir(fullPath, { recursive: true });
+        return {
+            message: "success",
+        };
+    },
+});
+export default FsCreateDirTool;
+//# sourceMappingURL=create-dir.js.map

package/dist/tools/fs/create-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-dir.js","sourceRoot":"","sources":["../../../src/tools/fs/create-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAgB;IAC5D,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,8DAA8D;IAC3E,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0DAA0D;YACvE,QAAQ,EAAE,IAAI;SACjB;KACJ;IACD,WAAW,EAAE,IAAI,aAAa,EAAE;IAChC,OAAO,EAAE,KAAK,EACV,MAAc,EACd,MAA2B,EAC3B,IAAU,EACV,WAA2B,EACf,EAAE;QACd,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAExB,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAEnC,WAAW,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAElE,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3C,OAAO;YACH,OAAO,EAAE,SAAS;SACrB,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/dist/tools/fs/delete.d.ts

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

package/dist/tools/fs/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/tools/fs/delete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,eAAO,MAAM,YAAY,8BA+CvB,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/dist/tools/fs/delete.js

@@ -0,0 +1,45 @@
+import { rm, stat } from "fs/promises";
+import { MCPTool } from "../../core/mcp.js";
+import { FsInteraction } from "./interaction.js";
+import { resolvePath } from "./utils.js";
+export const FsDeleteTool = () => new MCPTool({
+    name: "fs-delete",
+    description: "permanently delete a file or a directory (with all of its contents when recursive is true). USE WITH CAUTION: there is no undo.",
+    inputs: [
+        {
+            name: "path",
+            type: "string",
+            description: "absolute or cwd-relative path to delete",
+            required: true,
+        },
+        {
+            name: "recursive",
+            type: "boolean",
+            description: "if the path is a non-empty directory, delete it and everything inside it",
+            required: false,
+            default: false,
+        },
+    ],
+    customClass: new FsInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { path, recursive = false } = inputs;
+        const fullPath = resolvePath(path);
+        customClass?.emitFsEvent({ type: "deleting", path: fullPath });
+        let wasDirectory = false;
+        try {
+            wasDirectory = (await stat(fullPath)).isDirectory();
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                throw new Error(`no file or directory found at "${path}"`);
+            throw err;
+        }
+        await rm(fullPath, { recursive, force: false });
+        return {
+            message: "success",
+            type: wasDirectory ? "directory" : "file",
+        };
+    },
+});
+export default FsDeleteTool;
+//# sourceMappingURL=delete.js.map

package/dist/tools/fs/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/tools/fs/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAgB;IACzD,IAAI,EAAE,WAAW;IACjB,WAAW,EACP,iIAAiI;IACrI,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yCAAyC;YACtD,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,0EAA0E;YACvF,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,KAAK;SACjB;KACJ;IACD,WAAW,EAAE,IAAI,aAAa,EAAE;IAChC,OAAO,EAAE,KAAK,EACV,MAAc,EACd,MAA2B,EAC3B,IAAU,EACV,WAA2B,EACf,EAAE;QACd,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QAE3C,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAEnC,WAAW,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE/D,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC;YACD,YAAY,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,GAAG,CAAC,CAAC;YACtF,MAAM,GAAG,CAAC;QACd,CAAC;QAED,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAEhD,OAAO;YACH,OAAO,EAAE,SAAS;YAClB,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;SAC5C,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/dist/tools/fs/edit-file.d.ts

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

package/dist/tools/fs/edit-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-file.d.ts","sourceRoot":"","sources":["../../../src/tools/fs/edit-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,eAAO,MAAM,cAAc,8BAiFzB,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/dist/tools/fs/edit-file.js

@@ -0,0 +1,74 @@
+import { readFile, writeFile } from "fs/promises";
+import { MCPTool } from "../../core/mcp.js";
+import { FsInteraction } from "./interaction.js";
+import { resolvePath, toLines } from "./utils.js";
+export const FsEditFileTool = () => new MCPTool({
+    name: "fs-edit-file",
+    description: "replace a specific line range in an existing file without rewriting the whole file. lines are 0-indexed; the range [offsetLine, offsetLine+limitLine) is replaced entirely by `content` (use limitLine 0 to insert at offsetLine without deleting anything). read the file first (fs-read-file) to get accurate line numbers, since another edit may have shifted them.",
+    inputs: [
+        {
+            name: "path",
+            type: "string",
+            description: "absolute or cwd-relative path to the file",
+            required: true,
+        },
+        {
+            name: "offsetLine",
+            type: "number",
+            description: "0-indexed line to start replacing from",
+            required: true,
+        },
+        {
+            name: "limitLine",
+            type: "number",
+            description: "number of existing lines to remove starting at offsetLine",
+            required: true,
+        },
+        {
+            name: "content",
+            type: "string",
+            description: "text to insert in place of the removed lines (may itself contain newlines, or be empty to just delete)",
+            required: true,
+        },
+    ],
+    customClass: new FsInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { path, offsetLine, limitLine, content } = inputs;
+        if (typeof offsetLine !== "number" || offsetLine < 0) {
+            throw new Error("offsetLine must be a non-negative number");
+        }
+        if (typeof limitLine !== "number" || limitLine < 0) {
+            throw new Error("limitLine must be a non-negative number");
+        }
+        if (typeof content !== "string") {
+            throw new Error("content must be a string");
+        }
+        const fullPath = resolvePath(path);
+        customClass?.emitFsEvent({ type: "editing", path: fullPath });
+        let raw;
+        try {
+            raw = await readFile(fullPath, { encoding: "utf-8" });
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                throw new Error(`no file found at "${path}"`);
+            throw err;
+        }
+        const lines = toLines(raw);
+        if (offsetLine > lines.length) {
+            throw new Error(`offsetLine ${offsetLine} is past end of file (${lines.length} lines)`);
+        }
+        const removedCount = Math.min(limitLine, lines.length - offsetLine);
+        const insertedLines = content.length === 0 ? [] : content.split(/\r\n|\r|\n/);
+        lines.splice(offsetLine, removedCount, ...insertedLines);
+        await writeFile(fullPath, lines.join("\n"), { encoding: "utf-8" });
+        return {
+            message: "success",
+            removedLines: removedCount,
+            insertedLines: insertedLines.length,
+            totalLines: lines.length,
+        };
+    },
+});
+export default FsEditFileTool;
+//# sourceMappingURL=edit-file.js.map

package/dist/tools/fs/edit-file.js.map

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

package/dist/tools/fs/index.d.ts

@@ -1,3 +1,12 @@
-export { ReadFileTool } from "./read-file.js";
-export { WriteFileTool } from "./write-file.js";
+export { FsReadFileTool } from "./read-file.js";
+export { FsWriteFileTool } from "./write-file.js";
+export { FsEditFileTool } from "./edit-file.js";
+export { FsListDirTool } from "./list-dir.js";
+export { FsCreateDirTool } from "./create-dir.js";
+export { FsDeleteTool } from "./delete.js";
+export { FsMoveTool } from "./move.js";
+export { FsStatTool } from "./stat.js";
+export { FsInteraction } from "./interaction.js";
+export type { FsEvent } from "./interaction.js";
+export declare const FsTools: () => import("../../index.js").MCPTool<import("./interaction.js").FsInteraction>[];
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/fs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/fs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/fs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAahD,eAAO,MAAM,OAAO,oFASnB,CAAC"}

package/dist/tools/fs/index.js

@@ -1,3 +1,28 @@
-export { ReadFileTool } from "./read-file.js";
-export { WriteFileTool } from "./write-file.js";
+export { FsReadFileTool } from "./read-file.js";
+export { FsWriteFileTool } from "./write-file.js";
+export { FsEditFileTool } from "./edit-file.js";
+export { FsListDirTool } from "./list-dir.js";
+export { FsCreateDirTool } from "./create-dir.js";
+export { FsDeleteTool } from "./delete.js";
+export { FsMoveTool } from "./move.js";
+export { FsStatTool } from "./stat.js";
+export { FsInteraction } from "./interaction.js";
+import { FsReadFileTool } from "./read-file.js";
+import { FsWriteFileTool } from "./write-file.js";
+import { FsEditFileTool } from "./edit-file.js";
+import { FsListDirTool } from "./list-dir.js";
+import { FsCreateDirTool } from "./create-dir.js";
+import { FsDeleteTool } from "./delete.js";
+import { FsMoveTool } from "./move.js";
+import { FsStatTool } from "./stat.js";
+export const FsTools = () => [
+    FsReadFileTool(),
+    FsWriteFileTool(),
+    FsEditFileTool(),
+    FsListDirTool(),
+    FsCreateDirTool(),
+    FsDeleteTool(),
+    FsMoveTool(),
+    FsStatTool()
+];
 //# sourceMappingURL=index.js.map

package/dist/tools/fs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/fs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/fs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIjD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC;IACzB,cAAc,EAAE;IAChB,eAAe,EAAE;IACjB,cAAc,EAAE;IAChB,aAAa,EAAE;IACf,eAAe,EAAE;IACjB,YAAY,EAAE;IACd,UAAU,EAAE;IACZ,UAAU,EAAE;CACf,CAAC"}

package/dist/tools/fs/interaction.d.ts

@@ -0,0 +1,37 @@
+import { MCPCustomClass } from "../../core/mcp.js";
+export type FsEvent = {
+    type: "reading";
+    path: string;
+} | {
+    type: "writing";
+    path: string;
+} | {
+    type: "editing";
+    path: string;
+} | {
+    type: "deleting";
+    path: string;
+} | {
+    type: "moving";
+    from: string;
+    to: string;
+} | {
+    type: "listing";
+    path: string;
+} | {
+    type: "dir-created";
+    path: string;
+} | {
+    type: "stat";
+    path: string;
+};
+/**
+ * Shared custom interaction class for all filesystem tools. A frontend can
+ * listen on getEvents() to reflect live activity (e.g. "Reading file.ts...",
+ * "Writing config.json...") while the agent works on disk.
+ */
+export declare class FsInteraction extends MCPCustomClass {
+    emitFsEvent(event: FsEvent): void;
+}
+export default FsInteraction;
+//# sourceMappingURL=interaction.d.ts.map

package/dist/tools/fs/interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../../src/tools/fs/interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,MAAM,OAAO,GACb;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC7C,WAAW,CAAC,KAAK,EAAE,OAAO;CAG7B;AAED,eAAe,aAAa,CAAC"}

package/dist/tools/fs/interaction.js

@@ -0,0 +1,13 @@
+import { MCPCustomClass } from "../../core/mcp.js";
+/**
+ * Shared custom interaction class for all filesystem tools. A frontend can
+ * listen on getEvents() to reflect live activity (e.g. "Reading file.ts...",
+ * "Writing config.json...") while the agent works on disk.
+ */
+export class FsInteraction extends MCPCustomClass {
+    emitFsEvent(event) {
+        this.getEvents().emit("fs", event);
+    }
+}
+export default FsInteraction;
+//# sourceMappingURL=interaction.js.map

package/dist/tools/fs/interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.js","sourceRoot":"","sources":["../../../src/tools/fs/interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAYnD;;;;GAIG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC7C,WAAW,CAAC,KAAc;QACtB,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;CACJ;AAED,eAAe,aAAa,CAAC"}

package/dist/tools/fs/list-dir.d.ts

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

package/dist/tools/fs/list-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-dir.d.ts","sourceRoot":"","sources":["../../../src/tools/fs/list-dir.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,eAAO,MAAM,aAAa,8BAyFxB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/tools/fs/list-dir.js

@@ -0,0 +1,87 @@
+import { readdir, stat } from "fs/promises";
+import { join } from "path";
+import { MCPTool } from "../../core/mcp.js";
+import { FsInteraction } from "./interaction.js";
+import { resolvePath } from "./utils.js";
+export const FsListDirTool = () => new MCPTool({
+    name: "fs-list-dir",
+    description: "list the entries (files and directories) inside a directory, optionally paging through the results by entry index so very large directories (especially with recursive: true) never need to be returned in one shot",
+    inputs: [
+        {
+            name: "path",
+            type: "string",
+            description: "absolute or cwd-relative path to the directory",
+            required: true,
+        },
+        {
+            name: "recursive",
+            type: "boolean",
+            description: "recurse into subdirectories",
+            required: false,
+            default: false,
+        },
+        {
+            name: "offsetResult",
+            type: "number",
+            description: "entry offset to start listing from (for paging through large directories)",
+            required: false,
+            default: 0,
+        },
+        {
+            name: "limitResult",
+            type: "number",
+            description: "max number of entries to return",
+            required: false,
+            default: 500,
+        },
+    ],
+    customClass: new FsInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { path, recursive = false, offsetResult = 0, limitResult = 500 } = inputs;
+        const fullPath = resolvePath(path);
+        customClass?.emitFsEvent({ type: "listing", path: fullPath });
+        let dirents;
+        try {
+            dirents = await readdir(fullPath, { withFileTypes: true, recursive });
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                throw new Error(`no directory found at "${path}"`);
+            if (err.code === "ENOTDIR")
+                throw new Error(`"${path}" is a file, not a directory`);
+            throw err;
+        }
+        const entries = await Promise.all(dirents.map(async (d) => {
+            const entryPath = join(d.parentPath || d.path || fullPath, d.name);
+            let size;
+            if (d.isFile()) {
+                try {
+                    size = (await stat(entryPath)).size;
+                }
+                catch {
+                    size = undefined;
+                }
+            }
+            return {
+                name: d.name,
+                path: entryPath,
+                type: d.isDirectory() ? "directory" : d.isSymbolicLink() ? "symlink" : "file",
+                size,
+            };
+        }));
+        const totalResult = entries.length;
+        const start = Math.max(0, Math.min(offsetResult, totalResult));
+        const end = Math.max(start, Math.min(start + limitResult, totalResult));
+        const page = entries.slice(start, end);
+        return {
+            entries: page,
+            result: page,
+            total: totalResult,
+            totalResult,
+            offsetResult: start,
+            limitResult,
+        };
+    },
+});
+export default FsListDirTool;
+//# sourceMappingURL=list-dir.js.map

package/dist/tools/fs/list-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-dir.js","sourceRoot":"","sources":["../../../src/tools/fs/list-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAgB;IAC1D,IAAI,EAAE,aAAa;IACnB,WAAW,EACP,qNAAqN;IACzN,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gDAAgD;YAC7D,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,6BAA6B;YAC1C,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,KAAK;SACjB;QACD;YACI,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2EAA2E;YACxF,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,CAAC;SACb;QACD;YACI,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iCAAiC;YAC9C,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,GAAG;SACf;KACJ;IACD,WAAW,EAAE,IAAI,aAAa,EAAE;IAChC,OAAO,EAAE,KAAK,EACV,MAAc,EACd,MAA2B,EAC3B,IAAU,EACV,WAA2B,EACf,EAAE;QACd,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,KAAK,EAAE,YAAY,GAAG,CAAC,EAAE,WAAW,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC;QAEhF,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAEnC,WAAW,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE9D,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACD,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,GAAG,CAAC,CAAC;YAC9E,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,8BAA8B,CAAC,CAAC;YACpF,MAAM,GAAG,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YACpB,MAAM,SAAS,GAAG,IAAI,CAAE,CAAS,CAAC,UAAU,IAAK,CAAS,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YACrF,IAAI,IAAwB,CAAC;YAC7B,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBACb,IAAI,CAAC;oBACD,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;gBACxC,CAAC;gBAAC,MAAM,CAAC;oBACL,IAAI,GAAG,SAAS,CAAC;gBACrB,CAAC;YACL,CAAC;YACD,OAAO;gBACH,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;gBAC7E,IAAI;aACP,CAAC;QACN,CAAC,CAAC,CACL,CAAC;QAEF,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;QACxE,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAEvC,OAAO;YACH,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,WAAW;YAClB,WAAW;YACX,YAAY,EAAE,KAAK;YACnB,WAAW;SACd,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,aAAa,CAAC"}