atom-lite 0.0.0-stage → 0.4.1

package/dist/tools/read.js

@@ -0,0 +1,138 @@
+import { readFileSync, statSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { createHash } from "node:crypto";
+import { isWithinWorkspace } from "../security/paths.js";
+import { z } from "zod";
+const ArgsSchema = z
+    .object({
+    path: z.string(),
+    offset: z.number().int().positive().optional(),
+    limit: z.number().int().positive().optional(),
+})
+    .strict();
+function sha256(buf) {
+    return createHash("sha256").update(buf).digest("hex");
+}
+/** Drop the CR from CRLF without scanning the whole file up front. */
+function stripCr(line) {
+    return line.endsWith("\r") ? line.slice(0, -1) : line;
+}
+/** Split on LF, stripping CRs only when the text actually contains any. */
+function splitLines(text) {
+    const lines = text.split("\n");
+    return text.includes("\r") ? lines.map(stripCr) : lines;
+}
+/**
+ * Return the requested line range without splitting the entire file. Partial
+ * reads (offset/limit) are common for large files, where slicing first keeps
+ * the cost proportional to the requested window instead of the file size.
+ */
+function sliceLines(text, offset, limit) {
+    let start = 0;
+    const startLine = (offset ?? 1) - 1;
+    for (let i = 0; i < startLine; i++) {
+        const nl = text.indexOf("\n", start);
+        if (nl === -1)
+            return [];
+        start = nl + 1;
+    }
+    if (limit === undefined) {
+        return splitLines(text.slice(start));
+    }
+    let cursor = start;
+    for (let i = 0; i < limit; i++) {
+        const nl = text.indexOf("\n", cursor);
+        if (nl === -1) {
+            // Fewer lines remain than requested: take the rest, including the
+            // trailing newline so the split matches a full-file slice.
+            return splitLines(text.slice(start));
+        }
+        cursor = nl + 1;
+    }
+    return splitLines(text.slice(start, cursor - 1));
+}
+export const readTool = {
+    definition: {
+        name: "read",
+        description: "Read a file or a selected range of lines.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: { type: "string" },
+                offset: { type: "integer", minimum: 1 },
+                limit: { type: "integer", minimum: 1 },
+            },
+            required: ["path"],
+            additionalProperties: false,
+        },
+    },
+    async execute(call, ctx) {
+        const parsed = ArgsSchema.safeParse(call.arguments);
+        if (!parsed.success) {
+            return {
+                toolCallId: call.id,
+                name: "read",
+                content: "TOOL_ARGUMENT_INVALID: " + parsed.error.message,
+                isError: true,
+            };
+        }
+        const { path, offset, limit } = parsed.data;
+        if (!isWithinWorkspace(ctx.workspace, path)) {
+            return {
+                toolCallId: call.id,
+                name: "read",
+                content: "PATH_OUTSIDE_WORKSPACE",
+                isError: true,
+            };
+        }
+        const full = resolve(ctx.workspace, path);
+        if (!existsSync(full)) {
+            return {
+                toolCallId: call.id,
+                name: "read",
+                content: "FILE_NOT_FOUND",
+                isError: true,
+            };
+        }
+        const stat = statSync(full);
+        if (stat.isDirectory()) {
+            return {
+                toolCallId: call.id,
+                name: "read",
+                content: "FILE_NOT_FOUND: path is a directory",
+                isError: true,
+            };
+        }
+        if (stat.size > 10 * 1024 * 1024) {
+            return {
+                toolCallId: call.id,
+                name: "read",
+                content: "FILE_TOO_LARGE",
+                isError: true,
+            };
+        }
+        const buf = readFileSync(full);
+        if (buf.includes(0)) {
+            return {
+                toolCallId: call.id,
+                name: "read",
+                content: `Binary file detected (${buf.length} bytes).`,
+                isError: false,
+            };
+        }
+        const text = buf.toString("utf8");
+        const start = (offset ?? 1) - 1;
+        const slice = sliceLines(text, offset, limit);
+        const numbered = slice.map((l, i) => `${start + i + 1}: ${l}`).join("\n");
+        const hash = sha256(buf);
+        const header = `File: ${path} (${buf.length} bytes, sha256:${hash})`;
+        const body = numbered.length > 0 ? numbered : "(empty)";
+        const cap = ctx.maxToolOutputBytes ?? 30000;
+        let content = `${header}\n${body}`;
+        if (content.length > cap) {
+            content = content.slice(0, cap) + "\nOUTPUT_TRUNCATED";
+        }
+        return { toolCallId: call.id, name: "read", content };
+    },
+};
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,7 @@
+import type { Tool, ToolRegistry, ToolDefinition } from "./types.js";
+export declare class InMemoryToolRegistry implements ToolRegistry {
+    private tools;
+    register(tool: Tool): void;
+    get(name: string): Tool | undefined;
+    definitions(): ToolDefinition[];
+}

package/dist/tools/registry.js

@@ -0,0 +1,13 @@
+export class InMemoryToolRegistry {
+    tools = new Map();
+    register(tool) {
+        this.tools.set(tool.definition.name, tool);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    definitions() {
+        return [...this.tools.values()].map((t) => t.definition);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,oBAAoB;IACvB,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAExC,QAAQ,CAAC,IAAU;QACjB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,WAAW;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/tools/types.d.ts

@@ -0,0 +1,27 @@
+import type { ToolDefinition, ToolCall } from "../types.js";
+export type { ToolDefinition, ToolCall };
+export interface ToolResult {
+    toolCallId: string;
+    name: string;
+    content: string;
+    isError?: boolean;
+    /** Pre-computed line diff for write/edit, so the UI never re-reads files. */
+    diff?: string[];
+}
+export interface Tool {
+    definition: ToolDefinition;
+    execute(call: ToolCall, ctx: ToolContext): Promise<ToolResult>;
+}
+export interface ToolContext {
+    workspace: string;
+    signal: AbortSignal;
+    maxBashTimeMs?: number;
+    maxToolOutputBytes?: number;
+    approvals?: import("../runtime/approvals.js").ApprovalContext;
+    /** Live output from a running command, forwarded to the UI. */
+    onToolOutput?: (call: ToolCall, stream: "stdout" | "stderr", text: string) => void;
+}
+export interface ToolRegistry {
+    definitions(): ToolDefinition[];
+    get(name: string): Tool | undefined;
+}

package/dist/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":""}

package/dist/tools/webfetch.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "./types.js";
+export declare const webfetchTool: Tool;

package/dist/tools/webfetch.js

@@ -0,0 +1,97 @@
+import { z } from "zod";
+const ArgsSchema = z
+    .object({
+    url: z.string(),
+    format: z.enum(["text", "markdown", "html"]).optional(),
+    timeout: z.number().int().positive().optional(),
+})
+    .strict();
+const MAX_BYTES = 5 * 1024 * 1024;
+const DEFAULT_TIMEOUT = 30000;
+const MAX_TIMEOUT = 120000;
+export const webfetchTool = {
+    definition: {
+        name: "webfetch",
+        description: "Fetch content from an HTTP or HTTPS URL and return it as text, markdown, or HTML.",
+        parameters: {
+            type: "object",
+            properties: {
+                url: { type: "string" },
+                format: { type: "string", enum: ["text", "markdown", "html"] },
+                timeout: { type: "integer", minimum: 1 },
+            },
+            required: ["url"],
+            additionalProperties: false,
+        },
+    },
+    async execute(call, ctx) {
+        const parsed = ArgsSchema.safeParse(call.arguments);
+        if (!parsed.success) {
+            return { toolCallId: call.id, name: "webfetch", content: "TOOL_ARGUMENT_INVALID: " + parsed.error.message, isError: true };
+        }
+        const { url, format = "markdown", timeout } = parsed.data;
+        if (!url.startsWith("http://") && !url.startsWith("https://")) {
+            return { toolCallId: call.id, name: "webfetch", content: "TOOL_ARGUMENT_INVALID: URL must start with http:// or https://", isError: true };
+        }
+        const timeoutMs = Math.min((timeout ?? 30) * 1000, MAX_TIMEOUT);
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        const headers = { "User-Agent": "atom-lite/0.1" };
+        let res;
+        try {
+            res = await fetch(url, { headers, signal: controller.signal });
+        }
+        catch (err) {
+            clearTimeout(timer);
+            return { toolCallId: call.id, name: "webfetch", content: `PROVIDER_CONNECTION_FAILED: ${err instanceof Error ? err.message : String(err)}`, isError: true };
+        }
+        // Cloudflare challenge retry
+        if (res.status === 403) {
+            try {
+                res = await fetch(url, { headers: { ...headers, "User-Agent": "atom-lite/0.1 (compatible)" }, signal: controller.signal });
+            }
+            catch {
+                // ignore
+            }
+        }
+        clearTimeout(timer);
+        if (!res.ok) {
+            return { toolCallId: call.id, name: "webfetch", content: `PROVIDER_INVALID_RESPONSE: ${res.status}`, isError: true };
+        }
+        const buf = await res.arrayBuffer();
+        if (buf.byteLength > MAX_BYTES) {
+            return { toolCallId: call.id, name: "webfetch", content: "OUTPUT_TRUNCATED: response too large", isError: true };
+        }
+        const contentType = res.headers.get("content-type") ?? "";
+        const raw = new TextDecoder().decode(buf);
+        let output = raw;
+        const isHtml = contentType.includes("text/html") || raw.trim().startsWith("<");
+        if (format === "markdown" && isHtml) {
+            try {
+                const TurndownService = (await import("turndown")).default;
+                const td = new TurndownService({ headingStyle: "atx", codeBlockStyle: "fenced" });
+                td.remove(["script", "style", "meta", "link", "noscript"]);
+                output = td.turndown(raw);
+            }
+            catch {
+                output = stripHtml(raw);
+            }
+        }
+        else if (format === "text" && isHtml) {
+            output = stripHtml(raw);
+        }
+        // cap output
+        if (output.length > 30000)
+            output = output.slice(0, 30000) + "\nOUTPUT_TRUNCATED";
+        return { toolCallId: call.id, name: "webfetch", content: output };
+    },
+};
+function stripHtml(html) {
+    return html
+        .replace(/<script[\s\S]*?<\/script>/gi, "")
+        .replace(/<style[\s\S]*?<\/style>/gi, "")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+//# sourceMappingURL=webfetch.js.map

package/dist/tools/webfetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webfetch.js","sourceRoot":"","sources":["../../src/tools/webfetch.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAChD,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAClC,MAAM,eAAe,GAAG,KAAK,CAAC;AAC9B,MAAM,WAAW,GAAG,MAAM,CAAC;AAE3B,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,UAAU,EAAE;QACV,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,mFAAmF;QAChG,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACvB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE;gBAC9D,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;aACzC;YACD,QAAQ,EAAE,CAAC,KAAK,CAAC;YACjB,oBAAoB,EAAE,KAAK;SAC5B;KACF;IACD,KAAK,CAAC,OAAO,CAAC,IAAc,EAAE,GAAgB;QAC5C,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,yBAAyB,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7H,CAAC;QACD,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;QAC1D,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9D,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,gEAAgE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7I,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;QAC9D,MAAM,OAAO,GAA2B,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;QAC1E,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,+BAA+B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC9J,CAAC;QACD,6BAA6B;QAC7B,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,4BAA4B,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7H,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QACD,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,8BAA8B,GAAG,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACvH,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,UAAU,GAAG,SAAS,EAAE,CAAC;YAC/B,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,sCAAsC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACnH,CAAC;QACD,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,MAAM,GAAG,GAAG,CAAC;QACjB,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC/E,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,MAAM,eAAe,GAAG,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC3D,MAAM,EAAE,GAAG,IAAI,eAAe,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAClF,EAAE,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;gBAC3D,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,EAAE,CAAC;YACvC,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QACD,aAAa;QACb,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK;YAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,oBAAoB,CAAC;QAClF,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACpE,CAAC;CACF,CAAC;AAEF,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI;SACR,OAAO,CAAC,6BAA6B,EAAE,EAAE,CAAC;SAC1C,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC;SACxC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/tools/websearch.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "./types.js";
+export declare const websearchTool: Tool;

package/dist/tools/websearch.js

@@ -0,0 +1,88 @@
+import { z } from "zod";
+const ArgsSchema = z
+    .object({
+    query: z.string(),
+    num_results: z.number().int().positive().optional(),
+})
+    .strict();
+export const websearchTool = {
+    definition: {
+        name: "websearch",
+        description: "Search the web for a query and return titles, URLs, and snippets.",
+        parameters: {
+            type: "object",
+            properties: {
+                query: { type: "string" },
+                num_results: { type: "integer", minimum: 1 },
+            },
+            required: ["query"],
+            additionalProperties: false,
+        },
+    },
+    async execute(call, ctx) {
+        const parsed = ArgsSchema.safeParse(call.arguments);
+        if (!parsed.success) {
+            return { toolCallId: call.id, name: "websearch", content: "TOOL_ARGUMENT_INVALID: " + parsed.error.message, isError: true };
+        }
+        const { query, num_results = 8 } = parsed.data;
+        const limit = Math.min(num_results, 20);
+        const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 30000);
+        let res;
+        try {
+            res = await fetch(url, {
+                headers: { "User-Agent": "atom-lite/0.1" },
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            clearTimeout(timer);
+            return { toolCallId: call.id, name: "websearch", content: `PROVIDER_CONNECTION_FAILED: ${err instanceof Error ? err.message : String(err)}`, isError: true };
+        }
+        clearTimeout(timer);
+        if (!res.ok) {
+            return { toolCallId: call.id, name: "websearch", content: `PROVIDER_INVALID_RESPONSE: ${res.status}`, isError: true };
+        }
+        const html = await res.text();
+        // Parse result blocks
+        const results = [];
+        const resultBlockRegex = /<a[^>]*class="result__a"[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi;
+        const snippetRegex = /<a[^>]*class="result__snippet"[^>]*>([\s\S]*?)<\/a>/gi;
+        const titles = [];
+        let m;
+        while ((m = resultBlockRegex.exec(html)) !== null) {
+            const rawUrl = m[1];
+            const title = stripTags(m[2]).trim();
+            // DuckDuckGo wraps URLs in a redirect; extract uddg param
+            let finalUrl = rawUrl;
+            const uddg = rawUrl.match(/uddg=([^&]+)/);
+            if (uddg)
+                finalUrl = decodeURIComponent(uddg[1]);
+            titles.push({ url: finalUrl, title });
+        }
+        const snippets = [];
+        while ((m = snippetRegex.exec(html)) !== null) {
+            snippets.push(stripTags(m[1]).trim());
+        }
+        for (let i = 0; i < Math.min(titles.length, limit); i++) {
+            results.push({
+                title: titles[i].title,
+                url: titles[i].url,
+                snippet: snippets[i] ?? "",
+            });
+        }
+        if (results.length === 0) {
+            return { toolCallId: call.id, name: "websearch", content: "No results found." };
+        }
+        const lines = results.map((r, i) => `${i + 1}. ${r.title}\n   ${r.url}\n   ${r.snippet}`);
+        let output = `Search: ${query}\n\n${lines.join("\n\n")}`;
+        if (output.length > 30000)
+            output = output.slice(0, 30000) + "\nOUTPUT_TRUNCATED";
+        return { toolCallId: call.id, name: "websearch", content: output };
+    },
+};
+function stripTags(s) {
+    return s.replace(/<[^>]+>/g, "").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/\s+/g, " ");
+}
+//# sourceMappingURL=websearch.js.map

package/dist/tools/websearch.js.map

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

package/dist/tools/write.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "./types.js";
+export declare const writeTool: Tool;

package/dist/tools/write.js

@@ -0,0 +1,91 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, renameSync, } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { createHash } from "node:crypto";
+import { isWithinWorkspace } from "../security/paths.js";
+import { renderAddedLines, renderDiff } from "./diff.js";
+import { z } from "zod";
+const ArgsSchema = z
+    .object({
+    path: z.string(),
+    content: z.string(),
+    expected_hash: z.string().optional(),
+})
+    .strict();
+function sha256(buf) {
+    return createHash("sha256").update(buf).digest("hex");
+}
+export const writeTool = {
+    definition: {
+        name: "write",
+        description: "Create a new file or replace the full contents of a file.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: { type: "string" },
+                content: { type: "string" },
+                expected_hash: { type: "string" },
+            },
+            required: ["path", "content"],
+            additionalProperties: false,
+        },
+    },
+    async execute(call, ctx) {
+        const parsed = ArgsSchema.safeParse(call.arguments);
+        if (!parsed.success) {
+            return {
+                toolCallId: call.id,
+                name: "write",
+                content: "TOOL_ARGUMENT_INVALID: " + parsed.error.message,
+                isError: true,
+            };
+        }
+        const { path, content, expected_hash } = parsed.data;
+        if (!isWithinWorkspace(ctx.workspace, path)) {
+            return {
+                toolCallId: call.id,
+                name: "write",
+                content: "PATH_OUTSIDE_WORKSPACE",
+                isError: true,
+            };
+        }
+        const full = resolve(ctx.workspace, path);
+        const existed = existsSync(full);
+        let oldText;
+        if (existed) {
+            const buf = readFileSync(full);
+            oldText = buf.toString("utf8");
+            const currentHash = sha256(buf);
+            if (expected_hash && expected_hash !== currentHash) {
+                return {
+                    toolCallId: call.id,
+                    name: "write",
+                    content: "FILE_CHANGED_SINCE_READ",
+                    isError: true,
+                };
+            }
+            if (!expected_hash) {
+                return {
+                    toolCallId: call.id,
+                    name: "write",
+                    content: "TOOL_ARGUMENT_INVALID: expected_hash required when replacing an existing file",
+                    isError: true,
+                };
+            }
+        }
+        // create parent dirs
+        mkdirSync(dirname(full), { recursive: true });
+        const buf = Buffer.from(content, "utf8");
+        // atomic write
+        const tmp = full + ".tmp-" + process.pid;
+        writeFileSync(tmp, buf);
+        renameSync(tmp, full);
+        const newHash = sha256(buf);
+        return {
+            toolCallId: call.id,
+            name: "write",
+            content: `Wrote ${buf.length} bytes to ${path} (sha256:${newHash}).`,
+            diff: oldText === undefined ? renderAddedLines(content) : renderDiff(oldText, content),
+        };
+    },
+};
+//# sourceMappingURL=write.js.map

package/dist/tools/write.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,84 @@
+export type ContentPart = {
+    type: "text";
+    text: string;
+};
+export type Message = {
+    role: "system";
+    content: string;
+} | {
+    role: "user";
+    content: ContentPart[];
+} | {
+    role: "assistant";
+    content?: ContentPart[];
+    toolCalls?: ToolCall[];
+    providerState?: unknown;
+} | {
+    role: "tool";
+    toolCallId: string;
+    name: string;
+    content: string;
+};
+export interface ToolCall {
+    id: string;
+    /** Built-in tool names are validated by each tool; MCP names are dynamic. */
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+export interface ModelInfo {
+    id: string;
+    contextWindow?: number;
+    supportsTools?: boolean;
+    supportsStreaming?: boolean;
+    supportsVision?: boolean;
+}
+export interface TokenUsage {
+    input?: number;
+    output?: number;
+    total?: number;
+}
+export type FinishReason = "stop" | "tool_calls" | "length" | "error" | "cancelled";
+export interface ModelRequest {
+    model: string;
+    messages: Message[];
+    tools?: ToolDefinition[];
+    options?: Record<string, unknown>;
+    signal?: AbortSignal;
+}
+export interface ModelResponse {
+    message: Message & {
+        role: "assistant";
+    };
+    toolCalls: ToolCall[];
+    finishReason: FinishReason;
+    usage?: TokenUsage;
+    providerState?: unknown;
+    metadata?: Record<string, unknown>;
+}
+export type ModelStreamEvent = {
+    type: "text";
+    text: string;
+} | {
+    type: "thinking";
+    text: string;
+} | {
+    type: "tool_call";
+    toolCall: ToolCall;
+} | {
+    type: "done";
+    response: ModelResponse;
+};
+export interface AgentLimits {
+    maxIterations: number;
+    maxToolCalls: number;
+    maxExecutionMs: number;
+    maxParallelToolCalls: number;
+    maxToolOutputBytes: number;
+    maxBashTimeMs: number;
+}
+export declare const DEFAULT_LIMITS: AgentLimits;

package/dist/types.js

@@ -0,0 +1,10 @@
+// Canonical types shared across the runtime. Provider- and transport-agnostic.
+export const DEFAULT_LIMITS = {
+    maxIterations: 40,
+    maxToolCalls: 100,
+    maxExecutionMs: 1_800_000,
+    maxParallelToolCalls: 4,
+    maxToolOutputBytes: 30_000,
+    maxBashTimeMs: 120_000,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAkF/E,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,aAAa,EAAE,EAAE;IACjB,YAAY,EAAE,GAAG;IACjB,cAAc,EAAE,SAAS;IACzB,oBAAoB,EAAE,CAAC;IACvB,kBAAkB,EAAE,MAAM;IAC1B,aAAa,EAAE,OAAO;CACvB,CAAC"}