@easynet/agent-tool-buildin 0.0.3 → 0.0.5

package/dist/core-tools-manifest.json

@@ -0,0 +1,4 @@
+{
+  "kind": "core",
+  "tools": []
+}

package/dist/exec/defaults.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Exec tool defaults (allowed commands, max output bytes, timeout).
+ * Used by runCommand.
+ */
+export declare const DEFAULT_ALLOWED_COMMANDS: string[];
+export declare const DEFAULT_MAX_COMMAND_OUTPUT_BYTES: number;
+export declare const DEFAULT_COMMAND_TIMEOUT_MS = 10000;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/exec/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../exec/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,wBAAwB,UAYpC,CAAC;AAEF,eAAO,MAAM,gCAAgC,QAAc,CAAC;AAC5D,eAAO,MAAM,0BAA0B,QAAS,CAAC"}

package/dist/exec/defaults.js

@@ -0,0 +1,20 @@
+/**
+ * Exec tool defaults (allowed commands, max output bytes, timeout).
+ * Used by runCommand.
+ */
+export const DEFAULT_ALLOWED_COMMANDS = [
+    "cat",
+    "echo",
+    "env",
+    "find",
+    "grep",
+    "head",
+    "ls",
+    "pwd",
+    "tail",
+    "wc",
+    "whoami",
+];
+export const DEFAULT_MAX_COMMAND_OUTPUT_BYTES = 1024 * 1024;
+export const DEFAULT_COMMAND_TIMEOUT_MS = 10_000;
+//# sourceMappingURL=defaults.js.map

package/dist/exec/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../exec/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,IAAI;IACJ,KAAK;IACL,MAAM;IACN,IAAI;IACJ,QAAQ;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC5D,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC"}

package/dist/exec/runCommand.d.ts

@@ -1,9 +1,9 @@
-import type { CoreToolHandler } from "../types.js";
+import type { ExtensionToolHandler } from "@easynet/agent-tool";
 /**
  * Run a Linux command in the sandbox with an allowlist and timeout.
  * Uses spawn (no shell) to avoid injection; command and args are separate.
  * @tool
  * @effect local_write
  */
-export declare const runCommandHandler: CoreToolHandler;
+export declare const runCommandHandler: ExtensionToolHandler;
 //# sourceMappingURL=runCommand.d.ts.map

package/dist/exec/runCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runCommand.d.ts","sourceRoot":"","sources":["../../exec/runCommand.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAKnD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EA2IxB,eAAe,CAAC"}
+{"version":3,"file":"runCommand.d.ts","sourceRoot":"","sources":["../../exec/runCommand.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAUhE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAqJxB,oBAAoB,CAAC"}

package/dist/exec/runCommand.js

@@ -0,0 +1,120 @@
+import { spawn } from "node:child_process";
+import { resolve as pathResolve } from "node:path";
+import { getBuiltinContext } from "../index.js";
+import { DEFAULT_ALLOWED_COMMANDS, DEFAULT_MAX_COMMAND_OUTPUT_BYTES, DEFAULT_COMMAND_TIMEOUT_MS, } from "./defaults.js";
+import { resolveSandboxedPath } from "@easynet/agent-tool";
+import { createTaggedError } from "@easynet/agent-tool";
+/**
+ * Run a Linux command in the sandbox with an allowlist and timeout.
+ * Uses spawn (no shell) to avoid injection; command and args are separate.
+ * @tool
+ * @effect local_write
+ */
+export const runCommandHandler = (async (args) => {
+    const ctx = getBuiltinContext();
+    const a = args;
+    const allowedCommands = (Array.isArray(a.allowedCommands) ? a.allowedCommands : undefined) ??
+        DEFAULT_ALLOWED_COMMANDS;
+    const maxCommandOutputBytes = (typeof a.maxCommandOutputBytes === "number" ? a.maxCommandOutputBytes : undefined) ??
+        DEFAULT_MAX_COMMAND_OUTPUT_BYTES;
+    const commandTimeoutMs = (typeof a.commandTimeoutMs === "number" ? a.commandTimeoutMs : undefined) ??
+        DEFAULT_COMMAND_TIMEOUT_MS;
+    if (!allowedCommands.length) {
+        throw createTaggedError("EXEC_DISABLED", "Exec is disabled: allowedCommands is empty", {});
+    }
+    const rawCommand = (args.command ?? args.cmd)?.trim();
+    if (!rawCommand) {
+        throw createTaggedError("EXEC_INVALID", "command is required (pass 'command' or 'cmd')", {});
+    }
+    // Only allow bare command name (no path, no shell metacharacters)
+    const baseName = rawCommand.replace(/^.*\//, "").trim();
+    if (baseName !== rawCommand || /[;&|$`\s]/.test(rawCommand)) {
+        throw createTaggedError("EXEC_INVALID", "command must be a single executable name (no path, no shell chars)", { command: rawCommand });
+    }
+    if (!allowedCommands.includes(baseName)) {
+        throw createTaggedError("EXEC_NOT_ALLOWED", `Command "${baseName}" is not in allowedCommands`, { command: baseName, allowed: allowedCommands });
+    }
+    const cmdArgs = Array.isArray(args.args)
+        ? args.args
+        : Array.isArray(args.arguments)
+            ? args.arguments
+            : [];
+    const timeoutMs = args.timeoutMs ?? commandTimeoutMs;
+    const sandboxRoot = ctx.config.sandboxRoot ?? "";
+    let cwd = pathResolve(sandboxRoot);
+    if (args.cwd != null && args.cwd !== "") {
+        cwd = await resolveSandboxedPath(args.cwd, sandboxRoot);
+    }
+    return new Promise((resolvePromise, rejectPromise) => {
+        const proc = spawn(baseName, cmdArgs, {
+            cwd,
+            shell: false,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: { ...process.env },
+        });
+        let stdout = "";
+        let stderr = "";
+        let totalBytes = 0;
+        const append = (chunk, dest) => {
+            const len = Buffer.byteLength(chunk, "utf-8");
+            if (totalBytes + len > maxCommandOutputBytes) {
+                proc.kill("SIGKILL");
+                rejectPromise(createTaggedError("EXEC_OUTPUT_TOO_LARGE", `Command output exceeded ${maxCommandOutputBytes} bytes`, { maxBytes: maxCommandOutputBytes }));
+                return;
+            }
+            totalBytes += len;
+            if (dest === "stdout")
+                stdout += chunk;
+            else
+                stderr += chunk;
+        };
+        proc.stdout?.setEncoding("utf-8");
+        proc.stderr?.setEncoding("utf-8");
+        proc.stdout?.on("data", (chunk) => append(chunk, "stdout"));
+        proc.stderr?.on("data", (chunk) => append(chunk, "stderr"));
+        const timeout = setTimeout(() => {
+            proc.kill("SIGKILL");
+            resolvePromise({
+                result: {
+                    stdout,
+                    stderr,
+                    exitCode: null,
+                    timedOut: true,
+                    signal: "SIGKILL",
+                },
+                evidence: [
+                    {
+                        type: "exec",
+                        summary: `Command "${baseName}" timed out after ${timeoutMs}ms`,
+                        createdAt: new Date().toISOString(),
+                    },
+                ],
+            });
+        }, timeoutMs);
+        proc.on("error", (err) => {
+            clearTimeout(timeout);
+            rejectPromise(createTaggedError("EXEC_SPAWN_ERROR", err.message, { command: baseName }));
+        });
+        proc.on("close", (code, signal) => {
+            clearTimeout(timeout);
+            resolvePromise({
+                result: {
+                    stdout,
+                    stderr,
+                    exitCode: code,
+                    timedOut: false,
+                    signal: signal ?? undefined,
+                },
+                evidence: [
+                    {
+                        type: "exec",
+                        ref: baseName,
+                        summary: `Ran ${baseName} (exit ${code ?? signal})`,
+                        createdAt: new Date().toISOString(),
+                    },
+                ],
+            });
+        });
+    });
+});
+//# sourceMappingURL=runCommand.js.map

package/dist/exec/runCommand.js.map

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

package/dist/fs/deletePath.d.ts

@@ -1,8 +1,8 @@
-import type { CoreToolHandler } from "../types.js";
+import type { ExtensionToolHandler } from "@easynet/agent-tool";
 /**
  * Delete a file or directory in the sandbox (dangerous, requires explicit confirmation).
  * @tool
  * @effect destructive
  */
-export declare const deletePathHandler: CoreToolHandler;
+export declare const deletePathHandler: ExtensionToolHandler;
 //# sourceMappingURL=deletePath.d.ts.map

package/dist/fs/deletePath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deletePath.d.ts","sourceRoot":"","sources":["../../fs/deletePath.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EA+DxB,eAAe,CAAC"}
+{"version":3,"file":"deletePath.d.ts","sourceRoot":"","sources":["../../fs/deletePath.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAIhE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAgExB,oBAAoB,CAAC"}

package/dist/fs/deletePath.js

@@ -0,0 +1,63 @@
+import { rm, unlink, rmdir, stat } from "node:fs/promises";
+import { getBuiltinContext } from "../index.js";
+import { resolveSandboxedPath } from "@easynet/agent-tool";
+/**
+ * Delete a file or directory in the sandbox (dangerous, requires explicit confirmation).
+ * @tool
+ * @effect destructive
+ */
+export const deletePathHandler = (async (args) => {
+    const ctx = getBuiltinContext();
+    const inputPath = (args.path ?? args.filePath)?.trim();
+    if (!inputPath) {
+        throw new Error("path is required (pass 'path' or 'filePath')");
+    }
+    const recursive = args.recursive ?? false;
+    const confirm = args.confirm;
+    if (!confirm) {
+        throw new Error("Deletion not confirmed. Set confirm=true to proceed with deletion.");
+    }
+    const sandboxRoot = ctx.config.sandboxRoot ?? "";
+    const resolvedPath = await resolveSandboxedPath(inputPath, sandboxRoot);
+    // Prevent deleting the sandbox root itself (compare resolved paths)
+    let realSandboxRoot;
+    try {
+        const { realpath: rp } = await import("node:fs/promises");
+        realSandboxRoot = await rp(sandboxRoot);
+    }
+    catch {
+        realSandboxRoot = sandboxRoot;
+    }
+    if (resolvedPath === realSandboxRoot) {
+        throw new Error("Cannot delete the sandbox root directory.");
+    }
+    const fileStat = await stat(resolvedPath);
+    const isDirectory = fileStat.isDirectory();
+    if (isDirectory) {
+        if (recursive) {
+            await rm(resolvedPath, { recursive: true, force: true });
+        }
+        else {
+            await rmdir(resolvedPath);
+        }
+    }
+    else {
+        await unlink(resolvedPath);
+    }
+    return {
+        result: {
+            path: resolvedPath,
+            deleted: true,
+            type: isDirectory ? "directory" : "file",
+        },
+        evidence: [
+            {
+                type: "file",
+                ref: resolvedPath,
+                summary: `Deleted ${isDirectory ? "directory" : "file"}: ${resolvedPath}${recursive ? " (recursive)" : ""}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+});
+//# sourceMappingURL=deletePath.js.map

package/dist/fs/deletePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deletePath.js","sourceRoot":"","sources":["../../fs/deletePath.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,IAMxC,EAAE,EAAE;IACH,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC;IACvD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAI,GAAG,CAAC,MAAmC,CAAC,WAAW,IAAI,EAAE,CAAC;IAC/E,MAAM,YAAY,GAAG,MAAM,oBAAoB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAExE,oEAAoE;IACpE,IAAI,eAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAC1D,eAAe,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,eAAe,GAAG,WAAW,CAAC;IAChC,CAAC;IACD,IAAI,YAAY,KAAK,eAAe,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAE3C,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,EAAE,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;SACzC;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,YAAY;gBACjB,OAAO,EAAE,WAAW,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,KAAK,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC3G,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC,CAAyB,CAAC"}

package/dist/fs/listDir.d.ts

@@ -1,8 +1,8 @@
-import type { CoreToolHandler } from "../types.js";
+import type { ExtensionToolHandler } from "@easynet/agent-tool";
 /**
  * List directory contents in the sandbox.
  * @tool
  * @effect none
  */
-export declare const listDirHandler: CoreToolHandler;
+export declare const listDirHandler: ExtensionToolHandler;
 //# sourceMappingURL=listDir.d.ts.map

package/dist/fs/listDir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listDir.d.ts","sourceRoot":"","sources":["../../fs/listDir.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAWnD;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAmDrB,eAAe,CAAC"}
+{"version":3,"file":"listDir.d.ts","sourceRoot":"","sources":["../../fs/listDir.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAWhE;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAmDrB,oBAAoB,CAAC"}

package/dist/fs/listDir.js

@@ -0,0 +1,105 @@
+import { readdir, stat } from "node:fs/promises";
+import { resolve, join } from "node:path";
+import { getBuiltinContext } from "../index.js";
+import { resolveSandboxedPath } from "@easynet/agent-tool";
+/**
+ * List directory contents in the sandbox.
+ * @tool
+ * @effect none
+ */
+export const listDirHandler = (async (args) => {
+    const ctx = getBuiltinContext();
+    const inputPath = (args.path ?? args.filePath ?? args.dir ?? args.directory)?.trim();
+    if (!inputPath) {
+        throw new Error("path is required (pass 'path', 'filePath', 'dir', or 'directory')");
+    }
+    const maxEntries = args.maxEntries ?? 2000;
+    const includeHidden = args.includeHidden ?? false;
+    const recursive = args.recursive ?? false;
+    const maxDepth = args.maxDepth ?? 5;
+    const resolvedPath = await resolveSandboxedPath(inputPath, ctx.config.sandboxRoot ?? "");
+    const entries = [];
+    let truncated = false;
+    await walkDir(resolvedPath, "", entries, {
+        maxEntries,
+        includeHidden,
+        recursive,
+        maxDepth,
+        currentDepth: 0,
+        onTruncate: () => { truncated = true; },
+    });
+    return {
+        result: {
+            path: resolvedPath,
+            entries,
+            totalEntries: entries.length,
+            truncated,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: `core/fs.listDir:${resolvedPath}`,
+                summary: `Listed ${entries.length} entries in ${resolvedPath}${truncated ? " (truncated)" : ""}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+});
+async function walkDir(basePath, relativePath, entries, options) {
+    if (entries.length >= options.maxEntries) {
+        options.onTruncate();
+        return;
+    }
+    const fullPath = relativePath ? resolve(basePath, relativePath) : basePath;
+    const dirEntries = await readdir(fullPath, { withFileTypes: true });
+    for (const dirent of dirEntries) {
+        if (entries.length >= options.maxEntries) {
+            options.onTruncate();
+            return;
+        }
+        if (!options.includeHidden && dirent.name.startsWith(".")) {
+            continue;
+        }
+        const entryPath = join(fullPath, dirent.name);
+        const entryRelative = relativePath ? join(relativePath, dirent.name) : dirent.name;
+        let entryType;
+        if (dirent.isSymbolicLink()) {
+            entryType = "symlink";
+        }
+        else if (dirent.isDirectory()) {
+            entryType = "directory";
+        }
+        else if (dirent.isFile()) {
+            entryType = "file";
+        }
+        else {
+            entryType = "other";
+        }
+        let size = 0;
+        let mtime = "";
+        try {
+            const entryStat = await stat(entryPath);
+            size = entryStat.size;
+            mtime = entryStat.mtime.toISOString();
+        }
+        catch {
+            // Best effort stat
+        }
+        entries.push({
+            name: entryRelative,
+            type: entryType,
+            size,
+            mtime,
+        });
+        // Recurse into directories
+        if (options.recursive &&
+            entryType === "directory" &&
+            options.currentDepth < options.maxDepth) {
+            await walkDir(basePath, entryRelative, entries, {
+                ...options,
+                currentDepth: options.currentDepth + 1,
+            });
+        }
+    }
+}
+//# sourceMappingURL=listDir.js.map

package/dist/fs/listDir.js.map

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

package/dist/fs/readText.d.ts

@@ -1,8 +1,8 @@
-import type { CoreToolHandler } from "../types.js";
+import type { ExtensionToolHandler } from "@easynet/agent-tool";
 /**
  * Read a UTF-8 text file from the sandbox.
  * @tool
  * @effect none
  */
-export declare const readTextHandler: CoreToolHandler;
+export declare const readTextHandler: ExtensionToolHandler;
 //# sourceMappingURL=readText.d.ts.map

package/dist/fs/readText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readText.d.ts","sourceRoot":"","sources":["../../fs/readText.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAKnD;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAyCtB,eAAe,CAAC"}
+{"version":3,"file":"readText.d.ts","sourceRoot":"","sources":["../../fs/readText.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAOhE;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAyCtB,oBAAoB,CAAC"}

package/dist/fs/readText.js

@@ -0,0 +1,40 @@
+import { readFile, stat } from "node:fs/promises";
+import { getBuiltinContext } from "../index.js";
+import { resolveSandboxedPath } from "@easynet/agent-tool";
+import { createTaggedError } from "@easynet/agent-tool";
+const DEFAULT_MAX_READ_BYTES = 5 * 1024 * 1024;
+/**
+ * Read a UTF-8 text file from the sandbox.
+ * @tool
+ * @effect none
+ */
+export const readTextHandler = (async (args) => {
+    const ctx = getBuiltinContext();
+    const inputPath = (args.path ?? args.filePath)?.trim();
+    if (!inputPath) {
+        throw createTaggedError("FS_INVALID", "path is required (pass 'path' or 'filePath')", {});
+    }
+    const maxBytes = args.maxBytes ?? DEFAULT_MAX_READ_BYTES;
+    const resolvedPath = await resolveSandboxedPath(inputPath, ctx.config.sandboxRoot ?? "");
+    const fileStat = await stat(resolvedPath);
+    if (fileStat.size > maxBytes) {
+        throw createTaggedError("FILE_TOO_LARGE", `File size ${fileStat.size} bytes exceeds limit of ${maxBytes} bytes`, { path: resolvedPath, size: fileStat.size, limit: maxBytes });
+    }
+    const text = await readFile(resolvedPath, "utf-8");
+    return {
+        result: {
+            path: resolvedPath,
+            text,
+            bytes: fileStat.size,
+        },
+        evidence: [
+            {
+                type: "file",
+                ref: resolvedPath,
+                summary: `Read ${fileStat.size} bytes from ${resolvedPath}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+});
+//# sourceMappingURL=readText.js.map

package/dist/fs/readText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readText.js","sourceRoot":"","sources":["../../fs/readText.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,sBAAsB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,IAKtC,EAAE,EAAE;IACH,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC;IACvD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,iBAAiB,CAAC,YAAY,EAAE,8CAA8C,EAAE,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,sBAAsB,CAAC;IAEzD,MAAM,YAAY,GAAG,MAAM,oBAAoB,CAAC,SAAS,EAAG,GAAG,CAAC,MAAmC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAEvH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1C,IAAI,QAAQ,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,iBAAiB,CACrB,gBAAgB,EAChB,aAAa,QAAQ,CAAC,IAAI,2BAA2B,QAAQ,QAAQ,EACrE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAC7D,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAEnD,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,YAAY;YAClB,IAAI;YACJ,KAAK,EAAE,QAAQ,CAAC,IAAI;SACrB;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,YAAY;gBACjB,OAAO,EAAE,QAAQ,QAAQ,CAAC,IAAI,eAAe,YAAY,EAAE;gBAC3D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC,CAAyB,CAAC"}

package/dist/fs/searchText.d.ts

@@ -1,8 +1,8 @@
-import type { CoreToolHandler } from "../types.js";
+import type { ExtensionToolHandler } from "@easynet/agent-tool";
 /**
  * Search for text patterns in files within the sandbox.
  * @tool
  * @effect none
  */
-export declare const searchTextHandler: CoreToolHandler;
+export declare const searchTextHandler: ExtensionToolHandler;
 //# sourceMappingURL=searchText.d.ts.map

package/dist/fs/searchText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"searchText.d.ts","sourceRoot":"","sources":["../../fs/searchText.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAUnD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAgFxB,eAAe,CAAC"}
+{"version":3,"file":"searchText.d.ts","sourceRoot":"","sources":["../../fs/searchText.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAUhE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAgFxB,oBAAoB,CAAC"}

package/dist/fs/searchText.js

@@ -0,0 +1,152 @@
+import { readdir, stat } from "node:fs/promises";
+import { createReadStream } from "node:fs";
+import { createInterface } from "node:readline";
+import { join, relative } from "node:path";
+import { getBuiltinContext } from "../index.js";
+import { resolveSandboxedPath } from "@easynet/agent-tool";
+/**
+ * Search for text patterns in files within the sandbox.
+ * @tool
+ * @effect none
+ */
+export const searchTextHandler = (async (args) => {
+    const ctx = getBuiltinContext();
+    const rootPath = (args.root ?? args.path ?? args.dir ?? args.directory)?.trim();
+    if (!rootPath) {
+        throw new Error("root is required (pass 'root', 'path', 'dir', or 'directory')");
+    }
+    const query = (args.query ?? args.q)?.trim();
+    if (!query) {
+        throw new Error("query is required (pass 'query' or 'q')");
+    }
+    const glob = args.glob ?? "**/*.{md,txt,log,json,ts,js,py,java,scala}";
+    const maxMatches = args.maxMatches ?? 100;
+    const maxFiles = args.maxFiles ?? 500;
+    const resolvedRoot = await resolveSandboxedPath(rootPath, ctx.config.sandboxRoot ?? "");
+    // Build regex from query
+    let regex;
+    try {
+        regex = new RegExp(query, "i");
+    }
+    catch {
+        // If not a valid regex, escape and use as literal
+        regex = new RegExp(escapeRegExp(query), "i");
+    }
+    // Collect matching file extensions from glob
+    const extensions = parseGlobExtensions(glob);
+    // Walk directory and collect files
+    const files = [];
+    await collectFiles(resolvedRoot, files, { maxFiles, extensions });
+    // Search through files
+    const matches = [];
+    let filesScanned = 0;
+    let truncated = false;
+    for (const filePath of files) {
+        if (matches.length >= maxMatches) {
+            truncated = true;
+            break;
+        }
+        filesScanned++;
+        await searchFile(filePath, resolvedRoot, regex, matches, maxMatches);
+    }
+    if (matches.length >= maxMatches) {
+        truncated = true;
+    }
+    return {
+        result: {
+            root: resolvedRoot,
+            query,
+            matches,
+            totalMatches: matches.length,
+            filesScanned,
+            truncated,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: `core/fs.searchText:${resolvedRoot}`,
+                summary: `Found ${matches.length} matches in ${filesScanned} files under ${resolvedRoot}${truncated ? " (truncated)" : ""}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+});
+async function collectFiles(dirPath, files, options) {
+    if (files.length >= options.maxFiles)
+        return;
+    let entries;
+    try {
+        entries = await readdir(dirPath, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (files.length >= options.maxFiles)
+            return;
+        const fullPath = join(dirPath, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name.startsWith(".") || entry.name === "node_modules")
+                continue;
+            await collectFiles(fullPath, files, options);
+        }
+        else if (entry.isFile()) {
+            if (options.extensions.size > 0) {
+                const ext = getExtension(entry.name);
+                if (!ext || !options.extensions.has(ext))
+                    continue;
+            }
+            files.push(fullPath);
+        }
+    }
+}
+async function searchFile(filePath, root, regex, matches, maxMatches) {
+    const fileStat = await stat(filePath).catch(() => null);
+    // Skip large files (>1MB)
+    if (!fileStat || fileStat.size > 1024 * 1024)
+        return;
+    const stream = createReadStream(filePath, { encoding: "utf-8" });
+    const rl = createInterface({ input: stream, crlfDelay: Infinity });
+    let lineNo = 0;
+    for await (const line of rl) {
+        lineNo++;
+        if (matches.length >= maxMatches) {
+            stream.destroy();
+            break;
+        }
+        if (regex.test(line)) {
+            matches.push({
+                file: relative(root, filePath),
+                lineNo,
+                excerpt: line.slice(0, 200),
+            });
+        }
+    }
+}
+function parseGlobExtensions(glob) {
+    const extensions = new Set();
+    // Match patterns like *.{ts,js,py} or *.ts
+    const braceMatch = glob.match(/\*\.\{([^}]+)\}/);
+    if (braceMatch) {
+        for (const ext of braceMatch[1].split(",")) {
+            extensions.add(ext.trim());
+        }
+    }
+    else {
+        const simpleMatch = glob.match(/\*\.(\w+)/);
+        if (simpleMatch) {
+            extensions.add(simpleMatch[1]);
+        }
+    }
+    return extensions;
+}
+function getExtension(filename) {
+    const dotIdx = filename.lastIndexOf(".");
+    if (dotIdx === -1 || dotIdx === 0)
+        return null;
+    return filename.slice(dotIdx + 1);
+}
+function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=searchText.js.map