@botbotgo/kit-builtin 0.0.92

package/dist/src/exec/runCommand.js.map

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

package/dist/src/fs/defaults.d.ts

@@ -0,0 +1,16 @@
+/**
+ * FS tool defaults (sandbox root, read/write limits).
+ * Config: these constants or user's tool config at invoke time.
+ */
+export declare const DEFAULT_SANDBOX_ROOT = "";
+/** Max bytes for readText (default 5MB). */
+export declare const DEFAULT_MAX_READ_BYTES: number;
+/** Max entries for listDir (default 2000). */
+export declare const DEFAULT_MAX_LIST_ENTRIES = 2000;
+/** Max depth for listDir recursive (default 5). */
+export declare const DEFAULT_MAX_LIST_DEPTH = 5;
+/** Max matches for searchText (default 100). */
+export declare const DEFAULT_MAX_SEARCH_MATCHES = 100;
+/** Max files to scan for searchText (default 500). */
+export declare const DEFAULT_MAX_SEARCH_FILES = 500;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/src/fs/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/fs/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,4CAA4C;AAC5C,eAAO,MAAM,sBAAsB,QAAkB,CAAC;AAEtD,8CAA8C;AAC9C,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,mDAAmD;AACnD,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,gDAAgD;AAChD,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,sDAAsD;AACtD,eAAO,MAAM,wBAAwB,MAAM,CAAC"}

package/dist/src/fs/defaults.js

@@ -0,0 +1,16 @@
+/**
+ * FS tool defaults (sandbox root, read/write limits).
+ * Config: these constants or user's tool config at invoke time.
+ */
+export const DEFAULT_SANDBOX_ROOT = "";
+/** Max bytes for readText (default 5MB). */
+export const DEFAULT_MAX_READ_BYTES = 5 * 1024 * 1024;
+/** Max entries for listDir (default 2000). */
+export const DEFAULT_MAX_LIST_ENTRIES = 2000;
+/** Max depth for listDir recursive (default 5). */
+export const DEFAULT_MAX_LIST_DEPTH = 5;
+/** Max matches for searchText (default 100). */
+export const DEFAULT_MAX_SEARCH_MATCHES = 100;
+/** Max files to scan for searchText (default 500). */
+export const DEFAULT_MAX_SEARCH_FILES = 500;
+//# sourceMappingURL=defaults.js.map

package/dist/src/fs/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../../src/fs/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,mDAAmD;AACnD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC,gDAAgD;AAChD,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAE9C,sDAAsD;AACtD,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Delete a file or directory in the sandbox. Requires confirm=true to proceed.
+ * @tool
+ * @effect destructive
+ */
+export declare function deletePath(args: {
+    path: string;
+    recursive?: boolean;
+    confirm: boolean;
+}): Promise<{
+    result: {
+        path: string;
+        deleted: boolean;
+        type: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=deletePath.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deletePath.d.ts","sourceRoot":"","sources":["../../../src/fs/deletePath.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;;;;;;;;;;;;GA+DA"}

package/dist/src/fs/deletePath.js

@@ -0,0 +1,70 @@
+import { rm, unlink, rmdir, stat } from "node:fs/promises";
+import { getExtensionContext } from "../../index.js";
+import { resolveSandboxedPath } from "../platform/securityCompat.js";
+import { DEFAULT_SANDBOX_ROOT } from "./defaults.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+/**
+ * Delete a file or directory in the sandbox. Requires confirm=true to proceed.
+ * @tool
+ * @effect destructive
+ */
+export async function deletePath(args) {
+    // Step 1: Get context and validate path and confirm flag.
+    const ctx = getExtensionContext();
+    const inputPath = args.path?.trim();
+    if (!inputPath) {
+        throw new Error("path is required");
+    }
+    const recursive = args.recursive ?? false;
+    const confirm = args.confirm;
+    if (!confirm) {
+        throw new Error("Deletion not confirmed. Set confirm=true to proceed with deletion.");
+    }
+    // Step 2: Resolve path and ensure we do not delete sandbox root.
+    const defaults = { sandboxRoot: DEFAULT_SANDBOX_ROOT, enableSandboxValidation: false };
+    const cfg = overrideWithConfig(defaults, ctx.config);
+    const sandboxRoot = cfg.sandboxRoot ?? "";
+    const resolvedPath = await resolveSandboxedPath(inputPath, sandboxRoot);
+    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.");
+    }
+    // Step 3: Remove file or directory (recursive if requested).
+    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);
+    }
+    // Step 4: Return result and evidence.
+    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/src/fs/deletePath.js.map

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

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

@@ -0,0 +1,35 @@
+interface DirEntry {
+    name: string;
+    /** Entry kind (avoids property name "type" which can conflict with JSON Schema keyword). */
+    kind: "file" | "directory" | "symlink" | "other";
+    size: number;
+    mtime: string;
+}
+/**
+ * List files and subdirectories in a sandbox directory, optionally recursive with depth limit.
+ * @tool
+ * @effect none
+ */
+export declare function listDir(args: {
+    /** Directory path to list; defaults to "." when missing or empty. */
+    path?: string;
+    maxEntries?: number;
+    includeHidden?: boolean;
+    recursive?: boolean;
+    maxDepth?: number;
+}): Promise<{
+    result: {
+        path: string;
+        entries: DirEntry[];
+        totalEntries: number;
+        truncated: boolean;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+export {};
+//# sourceMappingURL=listDir.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listDir.d.ts","sourceRoot":"","sources":["../../../src/fs/listDir.ts"],"names":[],"mappings":"AAWA,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;;;;;;;;;;;;;GAiDA"}

package/dist/src/fs/listDir.js

@@ -0,0 +1,115 @@
+import { readdir, stat } from "node:fs/promises";
+import { resolve, join } from "node:path";
+import { getExtensionContext } from "../../index.js";
+import { resolveSandboxedPath } from "../platform/securityCompat.js";
+import { DEFAULT_SANDBOX_ROOT, DEFAULT_MAX_LIST_ENTRIES, DEFAULT_MAX_LIST_DEPTH, } from "./defaults.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+/**
+ * List files and subdirectories in a sandbox directory, optionally recursive with depth limit.
+ * @tool
+ * @effect none
+ */
+export async function listDir(args) {
+    // Step 1: Defaults, then override with extension config; validate path input.
+    const defaults = {
+        sandboxRoot: DEFAULT_SANDBOX_ROOT,
+        maxEntries: DEFAULT_MAX_LIST_ENTRIES,
+        maxDepth: DEFAULT_MAX_LIST_DEPTH,
+        enableSandboxValidation: false,
+    };
+    const ctx = getExtensionContext();
+    const cfg = overrideWithConfig(defaults, ctx.config);
+    const inputPath = args.path?.trim() || ".";
+    const sandboxRoot = cfg.sandboxRoot ?? "";
+    const maxEntries = args.maxEntries ?? cfg.maxEntries ?? defaults.maxEntries;
+    const includeHidden = args.includeHidden ?? false;
+    const recursive = args.recursive ?? false;
+    const maxDepth = args.maxDepth ?? cfg.maxDepth ?? defaults.maxDepth;
+    // Step 2: Resolve path within sandbox and walk directory.
+    const resolvedPath = await resolveSandboxedPath(inputPath, sandboxRoot);
+    const entries = [];
+    let truncated = false;
+    await walkDir(resolvedPath, "", entries, {
+        maxEntries,
+        includeHidden,
+        recursive,
+        maxDepth,
+        currentDepth: 0,
+        onTruncate: () => { truncated = true; },
+    });
+    // Step 3: Return entries and evidence.
+    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 kind;
+        if (dirent.isSymbolicLink()) {
+            kind = "symlink";
+        }
+        else if (dirent.isDirectory()) {
+            kind = "directory";
+        }
+        else if (dirent.isFile()) {
+            kind = "file";
+        }
+        else {
+            kind = "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,
+            kind,
+            size,
+            mtime,
+        });
+        // Recurse into directories
+        if (options.recursive &&
+            kind === "directory" &&
+            options.currentDepth < options.maxDepth) {
+            await walkDir(basePath, entryRelative, entries, {
+                ...options,
+                currentDepth: options.currentDepth + 1,
+            });
+        }
+    }
+}
+//# sourceMappingURL=listDir.js.map

package/dist/src/fs/listDir.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * Read a UTF-8 text file from the sandbox.
+ * @tool
+ * @effect none
+ */
+export declare function readText(args: {
+    path: string;
+    maxBytes?: number;
+}): Promise<{
+    result: {
+        path: string;
+        text: string;
+        bytes: number;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=readText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readText.d.ts","sourceRoot":"","sources":["../../../src/fs/readText.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;;;;;;;;;;;;GA0CA"}

package/dist/src/fs/readText.js

@@ -0,0 +1,47 @@
+import { readFile, stat } from "node:fs/promises";
+import { getExtensionContext } from "../../index.js";
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { resolveSandboxedPath } from "../platform/securityCompat.js";
+import { DEFAULT_SANDBOX_ROOT, DEFAULT_MAX_READ_BYTES } from "./defaults.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+/**
+ * Read a UTF-8 text file from the sandbox.
+ * @tool
+ * @effect none
+ */
+export async function readText(args) {
+    // Step 1: Defaults, then override with extension config; validate path input.
+    const defaults = { sandboxRoot: DEFAULT_SANDBOX_ROOT, maxBytes: DEFAULT_MAX_READ_BYTES, enableSandboxValidation: false };
+    const ctx = getExtensionContext();
+    const cfg = overrideWithConfig(defaults, ctx.config);
+    const sandboxRoot = cfg.sandboxRoot ?? "";
+    const inputPath = args.path?.trim();
+    if (!inputPath) {
+        throw createTaggedError("FS_INVALID", "path is required", {});
+    }
+    const maxBytes = args.maxBytes ?? cfg.maxBytes ?? defaults.maxBytes;
+    // Step 2: Resolve path, check size limit, then read file.
+    const resolvedPath = await resolveSandboxedPath(inputPath, 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");
+    // Step 3: Return content and evidence.
+    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/src/fs/readText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readText.js","sourceRoot":"","sources":["../../../src/fs/readText.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAG9B;IACC,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,EAAE,WAAW,EAAE,oBAAoB,EAAE,QAAQ,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,KAAK,EAAE,CAAC;IACzH,MAAM,GAAG,GAAG,mBAAmB,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,iBAAiB,CAAC,YAAY,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC;IAEpE,0DAA0D;IAC1D,MAAM,YAAY,GAAG,MAAM,oBAAoB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAExE,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,uCAAuC;IACvC,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"}

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

@@ -0,0 +1,40 @@
+interface SearchMatch {
+    file: string;
+    lineNo: number;
+    excerpt: string;
+}
+/**
+ * Search files in the sandbox by regex pattern, with glob filtering and match limits.
+ * @tool
+ * @effect none
+ */
+export declare function searchText(args: {
+    root: string;
+    /** Aliases for root (path, dir, directory). */
+    path?: string;
+    dir?: string;
+    directory?: string;
+    query: string;
+    /** Alias for query (accepted when agents send "q" instead of "query"). */
+    q?: string;
+    glob?: string;
+    maxMatches?: number;
+    maxFiles?: number;
+}): Promise<{
+    result: {
+        root: string;
+        query: string;
+        matches: SearchMatch[];
+        totalMatches: number;
+        filesScanned: number;
+        truncated: boolean;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+export {};
+//# sourceMappingURL=searchText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"searchText.d.ts","sourceRoot":"","sources":["../../../src/fs/searchText.ts"],"names":[],"mappings":"AAaA,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;;;;;;;;;;;;;;;GA4EA"}

package/dist/src/fs/searchText.js

@@ -0,0 +1,162 @@
+import { readdir, stat } from "node:fs/promises";
+import { createReadStream } from "node:fs";
+import { createInterface } from "node:readline";
+import { join, relative } from "node:path";
+import { getExtensionContext } from "../../index.js";
+import { resolveSandboxedPath } from "../platform/securityCompat.js";
+import { DEFAULT_SANDBOX_ROOT, DEFAULT_MAX_SEARCH_MATCHES, DEFAULT_MAX_SEARCH_FILES, } from "./defaults.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+/**
+ * Search files in the sandbox by regex pattern, with glob filtering and match limits.
+ * @tool
+ * @effect none
+ */
+export async function searchText(args) {
+    // Step 1: Defaults, then override with extension config; validate root/query input.
+    const defaults = {
+        sandboxRoot: DEFAULT_SANDBOX_ROOT,
+        maxMatches: DEFAULT_MAX_SEARCH_MATCHES,
+        maxFiles: DEFAULT_MAX_SEARCH_FILES,
+        enableSandboxValidation: false,
+    };
+    const ctx = getExtensionContext();
+    const cfg = overrideWithConfig(defaults, ctx.config);
+    const sandboxRoot = cfg.sandboxRoot ?? "";
+    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 ?? cfg.maxMatches ?? defaults.maxMatches;
+    const maxFiles = args.maxFiles ?? cfg.maxFiles ?? defaults.maxFiles;
+    // Step 2: Resolve root path and build regex from query.
+    const resolvedRoot = await resolveSandboxedPath(rootPath, sandboxRoot);
+    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");
+    }
+    const extensions = parseGlobExtensions(glob);
+    // Step 3: Collect files and search for matches.
+    const files = [];
+    await collectFiles(resolvedRoot, files, { maxFiles, extensions });
+    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;
+    }
+    // Step 4: Return matches and evidence.
+    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

package/dist/src/fs/searchText.js.map

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

package/dist/src/fs/sha256.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Compute SHA-256 hash of a file in the sandbox.
+ * @tool
+ * @effect none
+ */
+export declare function sha256(args: {
+    path: string;
+}): Promise<{
+    result: {
+        sha256: string;
+        path: string;
+        bytes: number;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=sha256.d.ts.map

package/dist/src/fs/sha256.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.d.ts","sourceRoot":"","sources":["../../../src/fs/sha256.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;;;;;;;;;;;;GAuCA"}