aec-agent 1.0.0

package/dist/components/tool-hub/built-in-tools/web/web-extract-tool.js

@@ -0,0 +1,206 @@
+import { extractTitle, htmlToText, mainContent, truncate } from "./html-to-text.js";
+import { assertPublicHttpUrl, BlockedUrlError } from "./network-guard.js";
+const TEXT_CONTENT_TYPES = [
+    "text/html", "application/xhtml+xml", "text/plain", "text/markdown", "text/csv",
+    "application/json", "application/ld+json", "text/xml", "application/xml", "application/rss+xml",
+    "application/atom+xml",
+];
+/**
+ * web_extract — read-only. Fetches public web pages and returns their readable text.
+ * Every URL and every redirect hop passes the SSRF guard (http/https only, no private,
+ * loopback, link-local or metadata addresses); bodies are size-capped and time-boxed.
+ */
+export class WebExtractTool {
+    name = "tool:web-extract";
+    version = "1.0.0";
+    definition;
+    opts;
+    constructor(options = {}) {
+        const maxCharsLimit = Math.max(1_000, Math.floor(options.maxCharsLimit ?? 50_000));
+        this.opts = {
+            maxUrls: Math.max(1, Math.floor(options.maxUrls ?? 5)),
+            timeoutMs: options.timeoutMs ?? 15_000,
+            maxBytes: options.maxBytes ?? 2_000_000,
+            defaultMaxChars: Math.min(maxCharsLimit, options.defaultMaxChars ?? 20_000),
+            maxCharsLimit,
+            maxRedirects: options.maxRedirects ?? 5,
+            userAgent: options.userAgent ?? "AECAgent/1.0 (+web_extract)",
+            allowPrivateNetwork: options.allowPrivateNetwork ?? false,
+            fetch: options.fetch ?? fetch,
+            lookup: options.lookup,
+        };
+        this.definition = {
+            name: "web_extract",
+            description: "Fetch one or more public web pages (http/https) and return their readable text content. " +
+                "Use after web_search to read the most relevant results, or for a url the user gave you. " +
+                "Supports HTML, plain text, JSON and XML; not PDFs or binaries. Long pages are truncated.",
+            parameters: {
+                type: "object",
+                properties: {
+                    urls: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: `Absolute http(s) urls to read (1-${this.opts.maxUrls})`,
+                    },
+                    max_chars: {
+                        type: "number",
+                        description: `Max characters of text returned per page (default ${this.opts.defaultMaxChars}, max ${this.opts.maxCharsLimit})`,
+                    },
+                },
+                required: ["urls"],
+            },
+            risk: "read-only",
+        };
+    }
+    async execute(args, _context) {
+        const rawUrls = args["urls"];
+        const urls = Array.isArray(rawUrls)
+            ? [...new Set(rawUrls.filter((u) => typeof u === "string").map((u) => u.trim()).filter(Boolean))]
+            : [];
+        if (urls.length === 0) {
+            return { content: 'web_extract: "urls" must be a non-empty array of url strings', isError: true, retryable: false };
+        }
+        if (urls.length > this.opts.maxUrls) {
+            return {
+                content: `web_extract: at most ${this.opts.maxUrls} urls per call (got ${urls.length})`,
+                isError: true,
+                retryable: false,
+            };
+        }
+        const requested = typeof args["max_chars"] === "number" && Number.isFinite(args["max_chars"])
+            ? Math.floor(args["max_chars"])
+            : this.opts.defaultMaxChars;
+        const maxChars = Math.min(this.opts.maxCharsLimit, Math.max(100, requested));
+        const pages = await Promise.all(urls.map((url) => this.extractOne(url, maxChars)));
+        const sections = pages.map((p) => {
+            if (!p.ok)
+                return `## ${p.url}\nError: ${p.error}`;
+            const header = [`## ${p.finalUrl ?? p.url}`];
+            if (p.finalUrl && p.finalUrl !== p.url)
+                header.push(`(redirected from ${p.url})`);
+            if (p.title)
+                header.push(`Title: ${p.title}`);
+            return `${header.join("\n")}\n\n${p.text || "(no readable text)"}`;
+        });
+        const failed = pages.filter((p) => !p.ok);
+        const allFailed = failed.length === pages.length;
+        return {
+            content: sections.join("\n\n---\n\n"),
+            isError: allFailed || undefined,
+            // Blocked URLs fail the same way every time — retrying cannot help.
+            retryable: allFailed && failed.every((p) => p.blocked) ? false : undefined,
+            metadata: {
+                pages: pages.map(({ url, ok, finalUrl, title, truncated, error }) => ({
+                    url, ok, finalUrl, title, truncated, error,
+                })),
+            },
+        };
+    }
+    async extractOne(rawUrl, maxChars) {
+        const signal = AbortSignal.timeout(this.opts.timeoutMs);
+        try {
+            let current = rawUrl;
+            let response;
+            for (let hop = 0; hop <= this.opts.maxRedirects; hop++) {
+                const url = await assertPublicHttpUrl(current, {
+                    lookup: this.opts.lookup,
+                    allowPrivateNetwork: this.opts.allowPrivateNetwork,
+                });
+                response = await this.opts.fetch(url, {
+                    redirect: "manual",
+                    signal,
+                    headers: {
+                        "User-Agent": this.opts.userAgent,
+                        Accept: "text/html,application/xhtml+xml,text/plain,application/json;q=0.9,*/*;q=0.5",
+                    },
+                });
+                const location = response.headers.get("location");
+                if (response.status >= 300 && response.status < 400 && location) {
+                    await response.body?.cancel().catch(() => { });
+                    current = new URL(location, url).toString();
+                    response = undefined;
+                    continue;
+                }
+                current = url.toString();
+                break;
+            }
+            if (!response) {
+                return { url: rawUrl, ok: false, error: `too many redirects (max ${this.opts.maxRedirects})` };
+            }
+            if (!response.ok) {
+                await response.body?.cancel().catch(() => { });
+                return { url: rawUrl, ok: false, finalUrl: current, error: `HTTP ${response.status}` };
+            }
+            const contentType = (response.headers.get("content-type") ?? "").toLowerCase();
+            const mime = contentType.split(";")[0].trim();
+            if (mime && !TEXT_CONTENT_TYPES.includes(mime) && !mime.startsWith("text/")) {
+                await response.body?.cancel().catch(() => { });
+                return { url: rawUrl, ok: false, finalUrl: current, error: `unsupported content type "${mime}"` };
+            }
+            const body = await readCapped(response, this.opts.maxBytes, charsetOf(contentType));
+            const isHtml = mime === "text/html" || mime === "application/xhtml+xml" || (!mime && /<html[\s>]/i.test(body.slice(0, 2_000)));
+            const text = isHtml ? htmlToText(mainContent(body)) : body.trim();
+            const cut = truncate(text, maxChars);
+            return {
+                url: rawUrl,
+                ok: true,
+                finalUrl: current,
+                title: isHtml ? extractTitle(body) : undefined,
+                text: cut.text,
+                truncated: cut.truncated,
+            };
+        }
+        catch (error) {
+            if (error instanceof BlockedUrlError) {
+                return { url: rawUrl, ok: false, blocked: true, error: `blocked: ${error.message}` };
+            }
+            const message = error instanceof Error && (error.name === "TimeoutError" || error.name === "AbortError")
+                ? `timed out after ${this.opts.timeoutMs} ms`
+                : error instanceof Error
+                    ? error.message
+                    : String(error);
+            return { url: rawUrl, ok: false, error: message };
+        }
+    }
+}
+function charsetOf(contentType) {
+    const charset = /charset=["']?([\w-]+)/i.exec(contentType)?.[1]?.toLowerCase();
+    if (!charset)
+        return "utf-8";
+    try {
+        new TextDecoder(charset);
+        return charset;
+    }
+    catch {
+        return "utf-8";
+    }
+}
+/** Read at most `maxBytes` of the body, then stop the download. */
+async function readCapped(response, maxBytes, charset) {
+    const decoder = new TextDecoder(charset);
+    if (!response.body)
+        return "";
+    const reader = response.body.getReader();
+    let received = 0;
+    let out = "";
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            const remaining = maxBytes - received;
+            const chunk = value.byteLength > remaining ? value.subarray(0, remaining) : value;
+            received += chunk.byteLength;
+            out += decoder.decode(chunk, { stream: true });
+            if (received >= maxBytes) {
+                await reader.cancel().catch(() => { });
+                break;
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    return out + decoder.decode();
+}
+//# sourceMappingURL=web-extract-tool.js.map

package/dist/components/tool-hub/built-in-tools/web/web-extract-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-extract-tool.js","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/web/web-extract-tool.ts"],"names":[],"mappings":"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"}

package/dist/components/tool-hub/built-in-tools/web/web-search-tool.d.ts

@@ -0,0 +1,25 @@
+import type { ToolContext, ToolDefinition, ToolHandler, ToolOutput } from "../../types.js";
+import type { WebSearchProvider } from "./types.js";
+export interface WebSearchToolOptions {
+    /** Search backend. Defaults to DuckDuckGo (free, no API key). */
+    provider?: WebSearchProvider;
+    /** Result count when the model does not ask for one. Default 5. */
+    defaultMaxResults?: number;
+    /** Hard ceiling on results per call. Default 10. */
+    maxResultsLimit?: number;
+}
+/**
+ * web_search — read-only. Returns a shortlist (title, url, snippet) for fresh external
+ * facts and documentation; the agent then opens only the relevant links with web_extract.
+ */
+export declare class WebSearchTool implements ToolHandler {
+    readonly name = "tool:web-search";
+    readonly version = "1.0.0";
+    readonly definition: ToolDefinition;
+    private provider;
+    private defaultMaxResults;
+    private maxResultsLimit;
+    constructor(options?: WebSearchToolOptions);
+    execute(args: Record<string, unknown>, _context: ToolContext): Promise<ToolOutput>;
+}
+//# sourceMappingURL=web-search-tool.d.ts.map

package/dist/components/tool-hub/built-in-tools/web/web-search-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search-tool.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/web/web-search-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID;;;GAGG;AACH,qBAAa,aAAc,YAAW,WAAW;IAC/C,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IAEpC,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,eAAe,CAAS;IAEhC,YAAY,OAAO,GAAE,oBAAyB,EA8B7C;IAEK,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA4CvF;CACF"}

package/dist/components/tool-hub/built-in-tools/web/web-search-tool.js

@@ -0,0 +1,82 @@
+import { DuckDuckGoSearchProvider } from "./duckduckgo-search-provider.js";
+const MAX_QUERY_CHARS = 500;
+/**
+ * web_search — read-only. Returns a shortlist (title, url, snippet) for fresh external
+ * facts and documentation; the agent then opens only the relevant links with web_extract.
+ */
+export class WebSearchTool {
+    name = "tool:web-search";
+    version = "1.0.0";
+    definition;
+    provider;
+    defaultMaxResults;
+    maxResultsLimit;
+    constructor(options = {}) {
+        this.provider = options.provider ?? new DuckDuckGoSearchProvider();
+        this.maxResultsLimit = Math.max(1, Math.floor(options.maxResultsLimit ?? 10));
+        this.defaultMaxResults = Math.min(this.maxResultsLimit, Math.max(1, Math.floor(options.defaultMaxResults ?? 5)));
+        this.definition = {
+            name: "web_search",
+            description: "Search the public web for current information, news, standards or documentation. " +
+                "Returns a short list of results (title, url, snippet) — not full pages. " +
+                "Use web_extract on the most relevant urls to read them. Cite the urls you rely on.",
+            parameters: {
+                type: "object",
+                properties: {
+                    query: { type: "string", description: "Search query, as you would type it into a search engine" },
+                    max_results: {
+                        type: "number",
+                        description: `Number of results to return (1-${this.maxResultsLimit}, default ${this.defaultMaxResults})`,
+                    },
+                    region: {
+                        type: "string",
+                        description: 'Optional region code to localise results, e.g. "us-en", "uk-en", "vn-vi"',
+                    },
+                },
+                required: ["query"],
+            },
+            risk: "read-only",
+        };
+    }
+    async execute(args, _context) {
+        const query = typeof args["query"] === "string" ? args["query"].trim() : "";
+        if (!query) {
+            return { content: "web_search: \"query\" must be a non-empty string", isError: true, retryable: false };
+        }
+        if (query.length > MAX_QUERY_CHARS) {
+            return {
+                content: `web_search: query is too long (max ${MAX_QUERY_CHARS} characters)`,
+                isError: true,
+                retryable: false,
+            };
+        }
+        const requested = typeof args["max_results"] === "number" && Number.isFinite(args["max_results"])
+            ? Math.floor(args["max_results"])
+            : this.defaultMaxResults;
+        const maxResults = Math.min(this.maxResultsLimit, Math.max(1, requested));
+        const region = typeof args["region"] === "string" && args["region"].trim() ? args["region"].trim() : undefined;
+        let results;
+        try {
+            results = await this.provider.search({ query, maxResults, region });
+        }
+        catch (error) {
+            return {
+                content: `web_search failed (${this.provider.name}): ${error instanceof Error ? error.message : String(error)}`,
+                isError: true,
+            };
+        }
+        results = results.slice(0, maxResults);
+        if (results.length === 0) {
+            return {
+                content: `No results for "${query}". Try a broader or differently worded query.`,
+                metadata: { provider: this.provider.name, query, resultCount: 0 },
+            };
+        }
+        const lines = results.map((r, i) => `${i + 1}. ${r.title}\n   ${r.url}${r.snippet ? `\n   ${r.snippet}` : ""}`);
+        return {
+            content: `Search results for "${query}" (${this.provider.name}):\n\n${lines.join("\n\n")}`,
+            metadata: { provider: this.provider.name, query, resultCount: results.length, results },
+        };
+    }
+}
+//# sourceMappingURL=web-search-tool.js.map

package/dist/components/tool-hub/built-in-tools/web/web-search-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search-tool.js","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/web/web-search-tool.ts"],"names":[],"mappings":"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"}

package/dist/components/tool-hub/built-in-tools/workspace/create-workspace-tools.d.ts

@@ -0,0 +1,7 @@
+import type { ToolHandler } from "../../types.js";
+import type { WorkspaceToolOptions } from "./types.js";
+/** Tool names of the workspace tools, for agent allowlists. */
+export declare const WORKSPACE_TOOL_NAMES: readonly ["read_file", "write_file", "edit_file", "list_files", "search_files", "terminal", "run_code"];
+/** All workspace tools with the same options — register them with `core.useTool()`. */
+export declare function createWorkspaceTools(options?: WorkspaceToolOptions): ToolHandler[];
+//# sourceMappingURL=create-workspace-tools.d.ts.map

package/dist/components/tool-hub/built-in-tools/workspace/create-workspace-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-workspace-tools.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/workspace/create-workspace-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAOlD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGvD,+DAA+D;AAC/D,eAAO,MAAM,oBAAoB,YAC/B,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,CACpF,CAAC;AAEX,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,oBAAyB,GAAG,WAAW,EAAE,CAUtF"}

package/dist/components/tool-hub/built-in-tools/workspace/create-workspace-tools.js

@@ -0,0 +1,24 @@
+import { EditFileTool } from "./edit-file-tool.js";
+import { ListFilesTool } from "./list-files-tool.js";
+import { ReadFileTool } from "./read-file-tool.js";
+import { RunCodeTool } from "./run-code-tool.js";
+import { SearchFilesTool } from "./search-files-tool.js";
+import { TerminalTool } from "./terminal-tool.js";
+import { WriteFileTool } from "./write-file-tool.js";
+/** Tool names of the workspace tools, for agent allowlists. */
+export const WORKSPACE_TOOL_NAMES = [
+    "read_file", "write_file", "edit_file", "list_files", "search_files", "terminal", "run_code",
+];
+/** All workspace tools with the same options — register them with `core.useTool()`. */
+export function createWorkspaceTools(options = {}) {
+    return [
+        new ReadFileTool(options),
+        new WriteFileTool(options),
+        new EditFileTool(options),
+        new ListFilesTool(options),
+        new SearchFilesTool(options),
+        new TerminalTool(options),
+        new RunCodeTool(options),
+    ];
+}
+//# sourceMappingURL=create-workspace-tools.js.map

package/dist/components/tool-hub/built-in-tools/workspace/create-workspace-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-workspace-tools.js","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/workspace/create-workspace-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU;CACpF,CAAC;AAEX,uFAAuF;AACvF,MAAM,UAAU,oBAAoB,CAAC,OAAO,GAAyB,EAAE;IACrE,OAAO;QACL,IAAI,YAAY,CAAC,OAAO,CAAC;QACzB,IAAI,aAAa,CAAC,OAAO,CAAC;QAC1B,IAAI,YAAY,CAAC,OAAO,CAAC;QACzB,IAAI,aAAa,CAAC,OAAO,CAAC;QAC1B,IAAI,eAAe,CAAC,OAAO,CAAC;QAC5B,IAAI,YAAY,CAAC,OAAO,CAAC;QACzB,IAAI,WAAW,CAAC,OAAO,CAAC;KACzB,CAAC;AACJ,CAAC"}

package/dist/components/tool-hub/built-in-tools/workspace/edit-file-tool.d.ts

@@ -0,0 +1,15 @@
+import type { ToolContext, ToolDefinition, ToolHandler, ToolOutput } from "../../types.js";
+import type { WorkspaceToolOptions } from "./types.js";
+/**
+ * edit_file — exact-text patch. Replaces `old_text` with `new_text`; refuses ambiguous
+ * matches unless replace_all. The write is conditional on the file being unchanged since
+ * it was read (sha256), then verified by read-back.
+ */
+export declare class EditFileTool implements ToolHandler {
+    readonly name = "tool:edit-file";
+    readonly version = "1.0.0";
+    readonly definition: ToolDefinition;
+    constructor(_options?: WorkspaceToolOptions);
+    execute(args: Record<string, unknown>, context: ToolContext): Promise<ToolOutput>;
+}
+//# sourceMappingURL=edit-file-tool.d.ts.map

package/dist/components/tool-hub/built-in-tools/workspace/edit-file-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-file-tool.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/workspace/edit-file-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAOvD;;;;GAIG;AACH,qBAAa,YAAa,YAAW,WAAW;IAC9C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IAEpC,YAAY,QAAQ,GAAE,oBAAyB,EAoB9C;IAEK,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAmDtF;CACF"}

package/dist/components/tool-hub/built-in-tools/workspace/edit-file-tool.js

@@ -0,0 +1,103 @@
+import { argError, boolArg, formatBytes, stringArg, withSandbox } from "./workspace-helpers.js";
+import { verifyWrite } from "./write-file-tool.js";
+const CONTEXT_LINES = 3;
+const MAX_SNIPPET_LINES = 20;
+/**
+ * edit_file — exact-text patch. Replaces `old_text` with `new_text`; refuses ambiguous
+ * matches unless replace_all. The write is conditional on the file being unchanged since
+ * it was read (sha256), then verified by read-back.
+ */
+export class EditFileTool {
+    name = "tool:edit-file";
+    version = "1.0.0";
+    definition;
+    constructor(_options = {}) {
+        this.definition = {
+            name: "edit_file",
+            description: "Change part of a file in your workspace by replacing an exact piece of text. old_text must match the file " +
+                "exactly (including whitespace, without read_file's line-number prefix) and be unique — include enough " +
+                "surrounding lines, or set replace_all to change every occurrence. The edit is verified by reading the file back.",
+            parameters: {
+                type: "object",
+                properties: {
+                    path: { type: "string", description: "File to edit" },
+                    old_text: { type: "string", description: "Exact text currently in the file" },
+                    new_text: { type: "string", description: "Text to put in its place (may be empty to delete)" },
+                    replace_all: { type: "boolean", description: "Replace every occurrence instead of requiring a unique match (default false)" },
+                },
+                required: ["path", "old_text", "new_text"],
+            },
+            risk: "draft",
+            sandboxOperation: "fs.write",
+        };
+    }
+    async execute(args, context) {
+        const path = stringArg(args, "path")?.trim();
+        const oldText = stringArg(args, "old_text");
+        const newText = stringArg(args, "new_text");
+        const replaceAll = boolArg(args, "replace_all") === true;
+        if (!path)
+            return argError("edit_file", '"path" must be a non-empty string');
+        if (!oldText)
+            return argError("edit_file", '"old_text" must be a non-empty string (use write_file to create a file)');
+        if (newText === undefined)
+            return argError("edit_file", '"new_text" must be a string');
+        if (oldText === newText)
+            return argError("edit_file", "old_text and new_text are identical — nothing to change");
+        return withSandbox("edit_file", context, async (env) => {
+            const current = await env.readFile(path);
+            if (current.truncated) {
+                return argError("edit_file", `${current.path} is too large to edit safely (${formatBytes(current.size)}, limit ${formatBytes(env.limits.maxReadBytes)})`);
+            }
+            const text = current.content;
+            const positions = occurrences(text, oldText);
+            if (positions.length === 0) {
+                return argError("edit_file", `old_text was not found in ${current.path}. Read the file again and copy the text exactly ` +
+                    "(whitespace and indentation matter; leave out read_file's line-number prefix).");
+            }
+            if (positions.length > 1 && !replaceAll) {
+                const lines = positions.map((p) => lineAt(text, p)).join(", ");
+                return argError("edit_file", `old_text matches ${positions.length} places in ${current.path} (lines ${lines}). ` +
+                    "Include more surrounding text to make it unique, or set replace_all to change all of them.");
+            }
+            const updated = replaceAll ? text.split(oldText).join(newText) : text.replace(oldText, () => newText);
+            // Conditional write: fails with "conflict" if the file changed after we read it.
+            const written = await env.writeFile(current.path, updated, { expectedSha256: current.sha256 });
+            const failure = await verifyWrite(env, written);
+            if (failure)
+                return failure;
+            const firstLine = lineAt(text, positions[0]);
+            return {
+                content: `Edited ${written.path}: replaced ${positions.length} occurrence${positions.length === 1 ? "" : "s"} ` +
+                    `(line${positions.length === 1 ? "" : "s"} ${positions.map((p) => lineAt(text, p)).join(", ")}) — verified by read-back.\n` +
+                    snippet(updated, firstLine, newText),
+                metadata: { path: written.path, replacements: positions.length, sha256: written.sha256, verified: true },
+            };
+        });
+    }
+}
+function occurrences(text, needle) {
+    const found = [];
+    for (let i = text.indexOf(needle); i !== -1; i = text.indexOf(needle, i + needle.length))
+        found.push(i);
+    return found;
+}
+function lineAt(text, index) {
+    let line = 1;
+    for (let i = 0; i < index; i++)
+        if (text.charCodeAt(i) === 10)
+            line++;
+    return line;
+}
+/** The edited region with a little context, numbered like read_file. */
+function snippet(text, firstLine, newText) {
+    const lines = text.split("\n");
+    const start = Math.max(1, firstLine - CONTEXT_LINES);
+    const end = Math.min(lines.length, firstLine + newText.split("\n").length - 1 + CONTEXT_LINES, start + MAX_SNIPPET_LINES - 1);
+    const width = String(end).length;
+    return lines
+        .slice(start - 1, end)
+        .map((line, i) => `${String(start + i).padStart(width)}\t${line}`)
+        .join("\n");
+}
+//# sourceMappingURL=edit-file-tool.js.map

package/dist/components/tool-hub/built-in-tools/workspace/edit-file-tool.js.map

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

package/dist/components/tool-hub/built-in-tools/workspace/list-files-tool.d.ts

@@ -0,0 +1,12 @@
+import type { ToolContext, ToolDefinition, ToolHandler, ToolOutput } from "../../types.js";
+import type { WorkspaceToolOptions } from "./types.js";
+/** list_files — read-only directory listing (optionally recursive), bounded. */
+export declare class ListFilesTool implements ToolHandler {
+    readonly name = "tool:list-files";
+    readonly version = "1.0.0";
+    readonly definition: ToolDefinition;
+    private options;
+    constructor(options?: WorkspaceToolOptions);
+    execute(args: Record<string, unknown>, context: ToolContext): Promise<ToolOutput>;
+}
+//# sourceMappingURL=list-files-tool.d.ts.map

package/dist/components/tool-hub/built-in-tools/workspace/list-files-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-files-tool.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/workspace/list-files-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,KAAK,EAAgC,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGrF,gFAAgF;AAChF,qBAAa,aAAc,YAAW,WAAW;IAC/C,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,OAAO,CAAC,OAAO,CAA+B;IAE9C,YAAY,OAAO,GAAE,oBAAyB,EAmB7C;IAEK,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBtF;CACF"}

package/dist/components/tool-hub/built-in-tools/workspace/list-files-tool.js

@@ -0,0 +1,53 @@
+import { resolveLogicalPath } from "../../../sandbox-hub/logical-path.js";
+import { boolArg, formatBytes, numberArg, resolveOptions, stringArg, withSandbox } from "./workspace-helpers.js";
+/** list_files — read-only directory listing (optionally recursive), bounded. */
+export class ListFilesTool {
+    name = "tool:list-files";
+    version = "1.0.0";
+    definition;
+    options;
+    constructor(options = {}) {
+        this.options = resolveOptions(options);
+        this.definition = {
+            name: "list_files",
+            description: "List the files and folders in a folder of your workspace (default: your working directory). " +
+                'Use recursive to see a whole tree. "/workspace/shared" holds files shared with other agents.',
+            parameters: {
+                type: "object",
+                properties: {
+                    path: { type: "string", description: "Folder to list (default: your working directory)" },
+                    recursive: { type: "boolean", description: "Include sub-folders (default false)" },
+                    include_hidden: { type: "boolean", description: "Include dot-files (default false)" },
+                    max_entries: { type: "number", description: `Most entries to return (default and max ${this.options.maxListEntries})` },
+                },
+            },
+            risk: "read-only",
+            sandboxOperation: "fs.read",
+        };
+    }
+    async execute(args, context) {
+        const path = stringArg(args, "path")?.trim() || ".";
+        const recursive = boolArg(args, "recursive") === true;
+        const requested = numberArg(args, "max_entries");
+        const maxEntries = Math.min(this.options.maxListEntries, requested && requested > 0 ? Math.floor(requested) : this.options.maxListEntries);
+        return withSandbox("list_files", context, async (env) => {
+            const result = await env.list(path, { recursive, includeHidden: boolArg(args, "include_hidden") === true, maxEntries });
+            const base = resolveLogicalPath(path, env.workingDir, env.roots, env.id);
+            const lines = result.entries.map((entry) => {
+                const shown = entry.path.startsWith(`${base}/`) ? entry.path.slice(base.length + 1) : entry.path;
+                if (entry.type === "directory")
+                    return `${shown}/`;
+                if (entry.type === "file")
+                    return `${shown}  (${formatBytes(entry.size)})`;
+                return `${shown}  [${entry.type}]`;
+            });
+            const header = `${base}${recursive ? " (recursive)" : ""} — ${result.entries.length} entr${result.entries.length === 1 ? "y" : "ies"}`;
+            const footer = result.truncated ? `\n[truncated at ${maxEntries} entries — list a sub-folder or turn off recursive]` : "";
+            return {
+                content: `${header}\n${lines.join("\n") || "(empty folder)"}${footer}`,
+                metadata: { path: base, count: result.entries.length, truncated: result.truncated },
+            };
+        });
+    }
+}
+//# sourceMappingURL=list-files-tool.js.map

package/dist/components/tool-hub/built-in-tools/workspace/list-files-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-files-tool.js","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/workspace/list-files-tool.ts"],"names":[],"mappings":"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"}

package/dist/components/tool-hub/built-in-tools/workspace/read-file-tool.d.ts

@@ -0,0 +1,15 @@
+import type { ToolContext, ToolDefinition, ToolHandler, ToolOutput } from "../../types.js";
+import type { WorkspaceToolOptions } from "./types.js";
+/**
+ * read_file — read-only. Returns a text file from the agent's workspace with line numbers,
+ * bounded to maxReadBytes; large files are read in line ranges.
+ */
+export declare class ReadFileTool implements ToolHandler {
+    readonly name = "tool:read-file";
+    readonly version = "1.0.0";
+    readonly definition: ToolDefinition;
+    private options;
+    constructor(options?: WorkspaceToolOptions);
+    execute(args: Record<string, unknown>, context: ToolContext): Promise<ToolOutput>;
+}
+//# sourceMappingURL=read-file-tool.d.ts.map

package/dist/components/tool-hub/built-in-tools/workspace/read-file-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file-tool.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/workspace/read-file-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,KAAK,EAAgC,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGrF;;;GAGG;AACH,qBAAa,YAAa,YAAW,WAAW;IAC9C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,OAAO,CAAC,OAAO,CAA+B;IAE9C,YAAY,OAAO,GAAE,oBAAyB,EAoB7C;IAEK,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAwCtF;CACF"}