orbitx 0.0.7 → 0.0.9

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

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

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

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

package/dist/tools/fs/move.js

@@ -0,0 +1,44 @@
+import { rename, mkdir } from "fs/promises";
+import { dirname } from "path";
+import { MCPTool } from "../../core/mcp.js";
+import { FsInteraction } from "./interaction.js";
+import { resolvePath } from "./utils.js";
+export const FsMoveTool = () => new MCPTool({
+    name: "fs-move",
+    description: "move or rename a file or directory",
+    inputs: [
+        {
+            name: "from",
+            type: "string",
+            description: "absolute or cwd-relative source path",
+            required: true,
+        },
+        {
+            name: "to",
+            type: "string",
+            description: "absolute or cwd-relative destination path",
+            required: true,
+        },
+    ],
+    customClass: new FsInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { from, to } = inputs;
+        const fullFrom = resolvePath(from);
+        const fullTo = resolvePath(to);
+        customClass?.emitFsEvent({ type: "moving", from: fullFrom, to: fullTo });
+        await mkdir(dirname(fullTo), { recursive: true });
+        try {
+            await rename(fullFrom, fullTo);
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                throw new Error(`no file or directory found at "${from}"`);
+            throw err;
+        }
+        return {
+            message: "success",
+        };
+    },
+});
+export default FsMoveTool;
+//# sourceMappingURL=move.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"move.js","sourceRoot":"","sources":["../../../src/tools/fs/move.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,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,UAAU,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAgB;IACvD,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,oCAAoC;IACjD,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,sCAAsC;YACnD,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2CAA2C;YACxD,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,EAAE,EAAE,GAAG,MAAM,CAAC;QAE5B,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;QAE/B,WAAW,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEzE,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAElD,IAAI,CAAC;YACD,MAAM,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnC,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,OAAO;YACH,OAAO,EAAE,SAAS;SACrB,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,UAAU,CAAC"}

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

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

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

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

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

@@ -1,49 +1,57 @@
-import MCPTool from "../../core/mcp.js";
-import fs from "fs/promises";
-import path from "path";
-export const ReadFileTool = new MCPTool({
-    name: "read-file",
-    description: "Reads text content from a file at the specified path.",
-    inputs: [{
-            name: "filePath",
+import { readFile } from "fs/promises";
+import { MCPTool } from "../../core/mcp.js";
+import { FsInteraction } from "./interaction.js";
+import { resolvePath, toLines, paginateLines } from "./utils.js";
+export const FsReadFileTool = () => new MCPTool({
+    name: "fs-read-file",
+    description: "read a text file from disk, optionally paging through it by line so large files never need to be read in one shot",
+    inputs: [
+        {
+            name: "path",
             type: "string",
-            description: `Absolute or relative path to the file (e.g., "/home/user/doc.txt" or "./file.txt")`,
+            description: "absolute or cwd-relative path to the file",
             required: true,
-        }],
-    execute: async (_, inputs) => {
+        },
+        {
+            name: "offsetLine",
+            type: "number",
+            description: "line offset to start reading from",
+            required: false,
+            default: 0,
+        },
+        {
+            name: "limitLine",
+            type: "number",
+            description: "max number of lines to return",
+            required: false,
+            default: 2000,
+        },
+    ],
+    customClass: new FsInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { path, offsetLine = 0, limitLine = 2000 } = inputs;
+        const fullPath = resolvePath(path);
+        customClass?.emitFsEvent({ type: "reading", path: fullPath });
+        let raw;
         try {
-            const { filePath } = inputs;
-            if (!filePath || typeof filePath !== "string") {
-                throw new Error("filePath must be a non-empty string");
-            }
-            const normalizedPath = path.normalize(filePath);
-            const data = await fs.readFile(normalizedPath, "utf-8");
-            return {
-                message: `File read successfully: ${normalizedPath}`,
-                path: normalizedPath,
-                content: data,
-                size: data.length
-            };
+            raw = await readFile(fullPath, { encoding: "utf-8" });
         }
-        catch (error) {
-            let errorMessage = error instanceof Error ? error.message : String(error);
-            if (error instanceof Error && "code" in error) {
-                const err = error;
-                if (err.code === "ENOENT") {
-                    errorMessage = `File not found: ${inputs.filePath}`;
-                }
-                else if (err.code === "EACCES") {
-                    errorMessage = `Permission denied: ${inputs.filePath}`;
-                }
-                else if (err.code === "EISDIR") {
-                    errorMessage = `Path is a directory, not a file: ${inputs.filePath}`;
-                }
-            }
-            return {
-                error: errorMessage
-            };
+        catch (err) {
+            if (err.code === "ENOENT")
+                throw new Error(`no file found at "${path}"`);
+            if (err.code === "EISDIR")
+                throw new Error(`"${path}" is a directory, not a file`);
+            throw err;
         }
-    }
+        const lines = toLines(raw);
+        const { content, totalLines, startLine, endLine } = paginateLines(lines, offsetLine, limitLine);
+        return {
+            content,
+            totalLines,
+            startLine,
+            endLine,
+        };
+    },
 });
-export default ReadFileTool;
+export default FsReadFileTool;
 //# sourceMappingURL=read-file.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../../src/tools/fs/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC;IACpC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,uDAAuD;IACpE,MAAM,EAAE,CAAC;YACL,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,oFAAoF;YACjG,QAAQ,EAAE,IAAI;SACjB,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,CAAS,EAAE,MAA2B,EAAgB,EAAE;QACpE,IAAI,CAAC;YACD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;YAE5B,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC5C,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;YAC3D,CAAC;YAED,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAEhD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YAExD,OAAO;gBACH,OAAO,EAAE,2BAA2B,cAAc,EAAE;gBACpD,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC;QAEN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAE1E,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;gBAC5C,MAAM,GAAG,GAAG,KAA8B,CAAC;gBAC3C,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACxB,YAAY,GAAG,mBAAmB,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACxD,CAAC;qBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC/B,YAAY,GAAG,sBAAsB,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC3D,CAAC;qBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC/B,YAAY,GAAG,oCAAoC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACzE,CAAC;YACL,CAAC;YAED,OAAO;gBACH,KAAK,EAAE,YAAY;aACtB,CAAC;QACN,CAAC;IACL,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,YAAY,CAAC"}
+{"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../../src/tools/fs/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,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,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAgB;IAC3D,IAAI,EAAE,cAAc;IACpB,WAAW,EACP,mHAAmH;IACvH,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2CAA2C;YACxD,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mCAAmC;YAChD,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,CAAC;SACb;QACD;YACI,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+BAA+B;YAC5C,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,IAAI;SAChB;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,UAAU,GAAG,CAAC,EAAE,SAAS,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAE1D,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,GAAW,CAAC;QAChB,IAAI,CAAC;YACD,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,GAAG,CAAC,CAAC;YACzE,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,8BAA8B,CAAC,CAAC;YACnF,MAAM,GAAG,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QAEhG,OAAO;YACH,OAAO;YACP,UAAU;YACV,SAAS;YACT,OAAO;SACV,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,cAAc,CAAC"}

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

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

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

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

package/dist/tools/fs/stat.js

@@ -0,0 +1,40 @@
+import { stat } from "fs/promises";
+import { MCPTool } from "../../core/mcp.js";
+import { FsInteraction } from "./interaction.js";
+import { resolvePath } from "./utils.js";
+export const FsStatTool = () => new MCPTool({
+    name: "fs-stat",
+    description: "check whether a path exists and get its metadata (type, size, modified time)",
+    inputs: [
+        {
+            name: "path",
+            type: "string",
+            description: "absolute or cwd-relative path to inspect",
+            required: true,
+        },
+    ],
+    customClass: new FsInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { path } = inputs;
+        const fullPath = resolvePath(path);
+        customClass?.emitFsEvent({ type: "stat", path: fullPath });
+        try {
+            const s = await stat(fullPath);
+            return {
+                exists: true,
+                type: s.isDirectory() ? "directory" : s.isSymbolicLink() ? "symlink" : "file",
+                size: s.size,
+                modifiedAt: s.mtime.toISOString(),
+                createdAt: s.birthtime.toISOString(),
+            };
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                return { exists: false };
+            }
+            throw err;
+        }
+    },
+});
+export default FsStatTool;
+//# sourceMappingURL=stat.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stat.js","sourceRoot":"","sources":["../../../src/tools/fs/stat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,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,UAAU,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAgB;IACvD,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,8EAA8E;IAC3F,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0CAA0C;YACvD,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,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE3D,IAAI,CAAC;YACD,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/B,OAAO;gBACH,MAAM,EAAE,IAAI;gBACZ,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,EAAE,CAAC,CAAC,IAAI;gBACZ,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE;gBACjC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE;aACvC,CAAC;QACN,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YAC7B,CAAC;YACD,MAAM,GAAG,CAAC;QACd,CAAC;IACL,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * Normalizes a user/agent supplied path to an absolute path. Relative paths
+ * are resolved against process.cwd() so agent-provided paths behave the same
+ * regardless of where the host process was started from.
+ */
+export declare function resolvePath(path: string): string;
+/** Splits text into lines the same way across every fs tool (handles \r\n). */
+export declare function toLines(content: string): string[];
+/**
+ * Slices an array of lines by offset/limit, clamping to bounds, and returns
+ * both the slice and the total line count so callers can page through large
+ * files without ever loading the whole thing into a response.
+ */
+export declare function paginateLines(lines: string[], offsetLine: number, limitLine: number): {
+    content: string;
+    totalLines: number;
+    startLine: number;
+    endLine: number;
+};
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/tools/fs/utils.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED,+EAA+E;AAC/E,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;;;;;EAUnF"}

package/dist/tools/fs/utils.js

@@ -0,0 +1,33 @@
+import { resolve } from "path";
+/**
+ * Normalizes a user/agent supplied path to an absolute path. Relative paths
+ * are resolved against process.cwd() so agent-provided paths behave the same
+ * regardless of where the host process was started from.
+ */
+export function resolvePath(path) {
+    if (!path || typeof path !== "string") {
+        throw new Error("path must be a non-empty string");
+    }
+    return resolve(process.cwd(), path);
+}
+/** Splits text into lines the same way across every fs tool (handles \r\n). */
+export function toLines(content) {
+    return content.split(/\r\n|\r|\n/);
+}
+/**
+ * Slices an array of lines by offset/limit, clamping to bounds, and returns
+ * both the slice and the total line count so callers can page through large
+ * files without ever loading the whole thing into a response.
+ */
+export function paginateLines(lines, offsetLine, limitLine) {
+    const totalLines = lines.length;
+    const start = Math.max(0, Math.min(offsetLine, totalLines));
+    const end = Math.max(start, Math.min(start + limitLine, totalLines));
+    return {
+        content: lines.slice(start, end).join("\n"),
+        totalLines,
+        startLine: start,
+        endLine: end,
+    };
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/tools/fs/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,OAAO,CAAC,OAAe;IACnC,OAAO,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAe,EAAE,UAAkB,EAAE,SAAiB;IAChF,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;IACrE,OAAO;QACH,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3C,UAAU;QACV,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,GAAG;KACf,CAAC;AACN,CAAC"}

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

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

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

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

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

@@ -1,68 +1,49 @@
-import MCPTool from "../../core/mcp.js";
-import fs from "fs/promises";
-import path from "path";
-export const WriteFileTool = new MCPTool({
-    name: "write-file",
-    description: "Writes text content to a file at the specified path. Creates new file or overwrites existing.",
-    inputs: [{
-            name: "filePath",
+import { writeFile, mkdir } from "fs/promises";
+import { dirname } from "path";
+import { MCPTool } from "../../core/mcp.js";
+import { FsInteraction } from "./interaction.js";
+import { resolvePath } from "./utils.js";
+export const FsWriteFileTool = () => new MCPTool({
+    name: "fs-write-file",
+    description: "write text content to a file, overwriting it if it already exists (or creating it, along with any missing parent directories, if it doesn't). USE WITH CAUTION: this permanently overwrites existing file content with no undo.",
+    inputs: [
+        {
+            name: "path",
             type: "string",
-            description: `Absolute or relative path to the file (e.g., "/home/user/doc.txt" or "./file.txt")`,
+            description: "absolute or cwd-relative path to the file",
             required: true,
         },
         {
-            name: "data",
+            name: "content",
             type: "string",
-            description: "Text content to write (supports multi-line)",
+            description: "full text content to write",
             required: true,
-        }],
-    execute: async (_, inputs) => {
-        try {
-            const { filePath, data } = inputs;
-            if (!filePath || typeof filePath !== "string") {
-                throw new Error("filePath must be a non-empty string");
-            }
-            if (typeof data !== "string") {
-                throw new Error("data must be a string");
-            }
-            const normalizedPath = path.normalize(filePath);
-            const dir = path.dirname(normalizedPath);
-            await fs.mkdir(dir, { recursive: true });
-            await fs.writeFile(normalizedPath, data, "utf-8");
-            return {
-                message: `File written: ${normalizedPath}`,
-                path: normalizedPath,
-                size: data.length
-            };
+        },
+        {
+            name: "createDirs",
+            type: "boolean",
+            description: "create missing parent directories if needed",
+            required: false,
+            default: true,
+        },
+    ],
+    customClass: new FsInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { path, content, createDirs = true } = inputs;
+        if (typeof content !== "string") {
+            throw new Error("content must be a string");
         }
-        catch (error) {
-            let errorMessage = error instanceof Error ? error.message : String(error);
-            if (error instanceof Error && "code" in error) {
-                const err = error;
-                if (err.code === "EACCES") {
-                    errorMessage = `Permission denied: Cannot write to ${inputs.filePath}`;
-                }
-                else if (err.code === "ENOENT") {
-                    errorMessage = `Directory does not exist or cannot be created: ${path.dirname(inputs.filePath)}`;
-                }
-                else if (err.code === "EISDIR") {
-                    errorMessage = `Path is a directory, cannot write file: ${inputs.filePath}`;
-                }
-                else if (err.code === "ENOSPC") {
-                    errorMessage = `No space left on device: Cannot write to ${inputs.filePath}`;
-                }
-                else if (err.code === "EROFS") {
-                    errorMessage = `Read-only file system: Cannot write to ${inputs.filePath}`;
-                }
-                else if (err.code === "ENAMETOOLONG") {
-                    errorMessage = `File path is too long: ${inputs.filePath}`;
-                }
-            }
-            return {
-                error: errorMessage
-            };
+        const fullPath = resolvePath(path);
+        customClass?.emitFsEvent({ type: "writing", path: fullPath });
+        if (createDirs) {
+            await mkdir(dirname(fullPath), { recursive: true });
         }
-    }
+        await writeFile(fullPath, content, { encoding: "utf-8" });
+        return {
+            message: "success",
+            bytesWritten: Buffer.byteLength(content, "utf-8"),
+        };
+    },
 });
-export default WriteFileTool;
+export default FsWriteFileTool;
 //# sourceMappingURL=write-file.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../../src/tools/fs/write-file.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../../src/tools/fs/write-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,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,EACP,iOAAiO;IACrO,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2CAA2C;YACxD,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,4BAA4B;YACzC,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,6CAA6C;YAC1D,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,IAAI;SAChB;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,OAAO,EAAE,UAAU,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAEpD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAChD,CAAC;QAED,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,UAAU,EAAE,CAAC;YACb,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAE1D,OAAO;YACH,OAAO,EAAE,SAAS;YAClB,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;SACpD,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/dist/tools/present/add.d.ts

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

package/dist/tools/present/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/tools/present/add.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,eAAO,MAAM,cAAc,mCA6DzB,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/dist/tools/present/add.js

@@ -0,0 +1,54 @@
+import { copyFile, stat } from "fs/promises";
+import { basename, join, resolve } from "path";
+import { MCPTool } from "../../core/mcp.js";
+import { PresentInteraction } from "./interaction.js";
+import { ensurePresentFolder, listPresentFiles } from "./utils.js";
+export const PresentAddTool = () => new MCPTool({
+    name: "present-add",
+    description: "present a file to the user by copying it into the present folder so the host application can surface it (e.g. as a download link or preview). " +
+        "the path MUST point to a single file, never a directory/folder — if you want to present a whole folder, zip it first (e.g. with the bash/shell tool) and pass the path to the resulting .zip file instead. " +
+        "call this once per file you want to present; presenting multiple files just means calling present-add multiple times.",
+    inputs: [
+        {
+            name: "path",
+            type: "string",
+            description: "absolute or cwd-relative path to the FILE to present (not a directory)",
+            required: true,
+        },
+    ],
+    customClass: new PresentInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { path } = inputs;
+        if (!path || typeof path !== "string") {
+            throw new Error("path must be a non-empty string");
+        }
+        const sourcePath = resolve(process.cwd(), path);
+        let sourceStat;
+        try {
+            sourceStat = await stat(sourcePath);
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                throw new Error(`no file found at "${path}"`);
+            throw err;
+        }
+        if (sourceStat.isDirectory()) {
+            throw new Error(`"${path}" is a directory — presents must be files. zip the folder first and present the .zip file instead.`);
+        }
+        const presentFolder = await ensurePresentFolder();
+        const destPath = join(presentFolder, basename(sourcePath));
+        // Copy via Node's fs API only — never shell out for this, so the
+        // present folder's contents are always exactly what was requested.
+        await copyFile(sourcePath, destPath);
+        const paths = await listPresentFiles();
+        // Emitted AFTER the copy completes, so anything listening always
+        // sees an up-to-date present folder the moment it's notified.
+        customClass?.emitPresentEvent({ type: "presents-updated", paths });
+        return {
+            message: "success",
+            path: destPath,
+        };
+    },
+});
+export default PresentAddTool;
+//# sourceMappingURL=add.js.map

package/dist/tools/present/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../src/tools/present/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAqB;IAChE,IAAI,EAAE,aAAa;IACnB,WAAW,EACP,gJAAgJ;QAChJ,6MAA6M;QAC7M,uHAAuH;IAC3H,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wEAAwE;YACrF,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,IAAI,EAAE,GAAG,MAAM,CAAC;QAExB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;QAEhD,IAAI,UAAU,CAAC;QACf,IAAI,CAAC;YACD,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,GAAG,CAAC,CAAC;YACzE,MAAM,GAAG,CAAC;QACd,CAAC;QAED,IAAI,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACX,IAAI,IAAI,oGAAoG,CAC/G,CAAC;QACN,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,mBAAmB,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QAE3D,iEAAiE;QACjE,mEAAmE;QACnE,MAAM,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAErC,MAAM,KAAK,GAAG,MAAM,gBAAgB,EAAE,CAAC;QAEvC,iEAAiE;QACjE,8DAA8D;QAC9D,WAAW,EAAE,gBAAgB,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,CAAC;QAEnE,OAAO;YACH,OAAO,EAAE,SAAS;YAClB,IAAI,EAAE,QAAQ;SACjB,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/dist/tools/present/clear.d.ts

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

package/dist/tools/present/clear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../../src/tools/present/clear.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,eAAO,MAAM,gBAAgB,mCAwB3B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/dist/tools/present/clear.js

@@ -0,0 +1,23 @@
+import { rm } from "fs/promises";
+import { MCPTool } from "../../core/mcp.js";
+import { PresentInteraction } from "./interaction.js";
+import { listPresentFiles } from "./utils.js";
+export const PresentClearTool = () => new MCPTool({
+    name: "present-clear",
+    description: "remove every file currently presented to the user, emptying the present folder. use this to clear out stale presents before presenting a fresh set.",
+    inputs: [],
+    customClass: new PresentInteraction(),
+    execute: async (_envID, _inputs, _mcp, customClass) => {
+        const existing = await listPresentFiles();
+        await Promise.all(existing.map((path) => rm(path, { force: true })));
+        // Present folder is now empty; still emit so listeners can
+        // immediately reflect that nothing is presented anymore.
+        customClass?.emitPresentEvent({ type: "presents-updated", paths: [] });
+        return {
+            message: "success",
+            removed: existing.length,
+        };
+    },
+});
+export default PresentClearTool;
+//# sourceMappingURL=clear.js.map

package/dist/tools/present/clear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear.js","sourceRoot":"","sources":["../../../src/tools/present/clear.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAqB;IAClE,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,qJAAqJ;IAClK,MAAM,EAAE,EAAE;IACV,WAAW,EAAE,IAAI,kBAAkB,EAAE;IACrC,OAAO,EAAE,KAAK,EACV,MAAc,EACd,OAA4B,EAC5B,IAAU,EACV,WAAgC,EACpB,EAAE;QACd,MAAM,QAAQ,GAAG,MAAM,gBAAgB,EAAE,CAAC;QAE1C,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAErE,2DAA2D;QAC3D,yDAAyD;QACzD,WAAW,EAAE,gBAAgB,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAEvE,OAAO;YACH,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,QAAQ,CAAC,MAAM;SAC3B,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/dist/tools/present/get-list.d.ts

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

package/dist/tools/present/get-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-list.d.ts","sourceRoot":"","sources":["../../../src/tools/present/get-list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,eAAO,MAAM,kBAAkB,mCAqB7B,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/dist/tools/present/get-list.js

@@ -0,0 +1,24 @@
+import { basename } from "path";
+import { MCPTool } from "../../core/mcp.js";
+import { PresentInteraction } from "./interaction.js";
+import { listPresentFiles, fileSize } from "./utils.js";
+export const PresentGetListTool = () => new MCPTool({
+    name: "present-get-list",
+    description: "get the list of files currently presented to the user (their paths inside the present folder)",
+    inputs: [],
+    customClass: new PresentInteraction(),
+    execute: async () => {
+        const paths = await listPresentFiles();
+        const files = await Promise.all(paths.map(async (path) => ({
+            name: basename(path),
+            path,
+            size: await fileSize(path),
+        })));
+        return {
+            files,
+            total: files.length,
+        };
+    },
+});
+export default PresentGetListTool;
+//# sourceMappingURL=get-list.js.map

package/dist/tools/present/get-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-list.js","sourceRoot":"","sources":["../../../src/tools/present/get-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAqB;IACpE,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,+FAA+F;IAC5G,MAAM,EAAE,EAAE;IACV,WAAW,EAAE,IAAI,kBAAkB,EAAE;IACrC,OAAO,EAAE,KAAK,IAAkB,EAAE;QAC9B,MAAM,KAAK,GAAG,MAAM,gBAAgB,EAAE,CAAC;QAEvC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC3B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;YACvB,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;YACpB,IAAI;YACJ,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC;SAC7B,CAAC,CAAC,CACN,CAAC;QAEF,OAAO;YACH,KAAK;YACL,KAAK,EAAE,KAAK,CAAC,MAAM;SACtB,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

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

@@ -0,0 +1,8 @@
+export { PresentAddTool } from "./add.js";
+export { PresentClearTool } from "./clear.js";
+export { PresentGetListTool } from "./get-list.js";
+export { PresentInteraction } from "./interaction.js";
+export type { PresentEvent } from "./interaction.js";
+export { getPresentFolder } from "./utils.js";
+export declare const PresentTools: () => import("../../index.js").MCPTool<import("./interaction.js").PresentInteraction>[];
+//# sourceMappingURL=index.d.ts.map