@antaif3ng/til-work 0.1.0

package/dist/tools/read.js

@@ -0,0 +1,65 @@
+import { constants } from "node:fs";
+import { access, readFile } from "node:fs/promises";
+import { resolveToCwd } from "../utils/path.js";
+import { MAX_BYTES, MAX_LINES, truncateHead } from "../utils/truncate.js";
+export function createReadTool(cwd) {
+    return {
+        name: "read",
+        label: "Read",
+        description: `Read contents of a file. Output is truncated to ${MAX_LINES} lines or ${MAX_BYTES / 1024}KB. Use offset/limit for large files.`,
+        parameters: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Path to the file to read (relative or absolute)" },
+                offset: { type: "number", description: "Line number to start reading from (1-indexed)" },
+                limit: { type: "number", description: "Maximum number of lines to read" },
+            },
+            required: ["path"],
+        },
+        execute: async (_toolCallId, params, signal) => {
+            const { path, offset, limit } = params;
+            const absolutePath = resolveToCwd(path, cwd);
+            if (signal?.aborted)
+                throw new Error("Operation aborted");
+            await access(absolutePath, constants.R_OK);
+            const buffer = await readFile(absolutePath);
+            const textContent = buffer.toString("utf-8");
+            const allLines = textContent.split("\n");
+            const totalFileLines = allLines.length;
+            const startLine = offset ? Math.max(0, offset - 1) : 0;
+            if (startLine >= allLines.length) {
+                throw new Error(`Offset ${offset} is beyond end of file (${allLines.length} lines total)`);
+            }
+            let selectedContent;
+            let userLimitedLines;
+            if (limit !== undefined) {
+                const endLine = Math.min(startLine + limit, allLines.length);
+                selectedContent = allLines.slice(startLine, endLine).join("\n");
+                userLimitedLines = endLine - startLine;
+            }
+            else {
+                selectedContent = allLines.slice(startLine).join("\n");
+            }
+            const truncation = truncateHead(selectedContent);
+            let outputText;
+            const startLineDisplay = startLine + 1;
+            if (truncation.truncated) {
+                const endLineDisplay = startLineDisplay + truncation.outputLines - 1;
+                const nextOffset = endLineDisplay + 1;
+                outputText = truncation.content;
+                outputText += `\n\n[Showing lines ${startLineDisplay}-${endLineDisplay} of ${totalFileLines}. Use offset=${nextOffset} to continue.]`;
+            }
+            else if (userLimitedLines !== undefined && startLine + userLimitedLines < allLines.length) {
+                const remaining = allLines.length - (startLine + userLimitedLines);
+                const nextOffset = startLine + userLimitedLines + 1;
+                outputText = truncation.content;
+                outputText += `\n\n[${remaining} more lines in file. Use offset=${nextOffset} to continue.]`;
+            }
+            else {
+                outputText = truncation.content;
+            }
+            return { content: [{ type: "text", text: outputText }] };
+        },
+    };
+}
+//# 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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE1E,MAAM,UAAU,cAAc,CAAC,GAAW;IACzC,OAAO;QACN,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,mDAAmD,SAAS,aAAa,SAAS,GAAG,IAAI,uCAAuC;QAC7I,UAAU,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACX,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;gBACxF,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;gBACxF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;aACzE;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SAClB;QACD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAC9C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAA2D,CAAC;YAC5F,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAE7C,IAAI,MAAM,EAAE,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAE1D,MAAM,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;YAE3C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;YAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC7C,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;YAEvC,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvD,IAAI,SAAS,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,2BAA2B,QAAQ,CAAC,MAAM,eAAe,CAAC,CAAC;YAC5F,CAAC;YAED,IAAI,eAAuB,CAAC;YAC5B,IAAI,gBAAoC,CAAC;YACzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC7D,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChE,gBAAgB,GAAG,OAAO,GAAG,SAAS,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACP,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxD,CAAC;YAED,MAAM,UAAU,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;YACjD,IAAI,UAAkB,CAAC;YACvB,MAAM,gBAAgB,GAAG,SAAS,GAAG,CAAC,CAAC;YAEvC,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;gBAC1B,MAAM,cAAc,GAAG,gBAAgB,GAAG,UAAU,CAAC,WAAW,GAAG,CAAC,CAAC;gBACrE,MAAM,UAAU,GAAG,cAAc,GAAG,CAAC,CAAC;gBACtC,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC;gBAChC,UAAU,IAAI,sBAAsB,gBAAgB,IAAI,cAAc,OAAO,cAAc,gBAAgB,UAAU,gBAAgB,CAAC;YACvI,CAAC;iBAAM,IAAI,gBAAgB,KAAK,SAAS,IAAI,SAAS,GAAG,gBAAgB,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAC7F,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,SAAS,GAAG,gBAAgB,CAAC,CAAC;gBACnE,MAAM,UAAU,GAAG,SAAS,GAAG,gBAAgB,GAAG,CAAC,CAAC;gBACpD,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC;gBAChC,UAAU,IAAI,QAAQ,SAAS,mCAAmC,UAAU,gBAAgB,CAAC;YAC9F,CAAC;iBAAM,CAAC;gBACP,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC;YACjC,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QAC1D,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/tools/system-info.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from "../core/types.js";
+export declare function createSystemInfoTool(): AgentTool;
+//# sourceMappingURL=system-info.d.ts.map

package/dist/tools/system-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-info.d.ts","sourceRoot":"","sources":["../../src/tools/system-info.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAoBlD,wBAAgB,oBAAoB,IAAI,SAAS,CAmFhD"}

package/dist/tools/system-info.js

@@ -0,0 +1,101 @@
+import * as os from "node:os";
+function formatBytes(bytes) {
+    const gb = bytes / (1024 * 1024 * 1024);
+    if (gb >= 1)
+        return `${gb.toFixed(1)} GB`;
+    const mb = bytes / (1024 * 1024);
+    return `${mb.toFixed(0)} MB`;
+}
+function formatUptime(seconds) {
+    const days = Math.floor(seconds / 86400);
+    const hours = Math.floor((seconds % 86400) / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+    const parts = [];
+    if (days > 0)
+        parts.push(`${days}d`);
+    if (hours > 0)
+        parts.push(`${hours}h`);
+    parts.push(`${minutes}m`);
+    return parts.join(" ");
+}
+export function createSystemInfoTool() {
+    return {
+        name: "system_info",
+        label: "System Info",
+        description: "Get system information: OS, CPU, memory, disk usage, network interfaces, environment variables, and running processes overview.",
+        parameters: {
+            type: "object",
+            properties: {
+                category: {
+                    type: "string",
+                    description: "Info category: 'all', 'os', 'cpu', 'memory', 'network', 'env'. Default: 'all'",
+                    enum: ["all", "os", "cpu", "memory", "network", "env"],
+                },
+            },
+        },
+        execute: async (_toolCallId, params) => {
+            const category = params.category || "all";
+            const sections = [];
+            if (category === "all" || category === "os") {
+                sections.push([
+                    "## OS Information",
+                    `Platform: ${os.platform()} (${os.arch()})`,
+                    `OS Release: ${os.release()}`,
+                    `Hostname: ${os.hostname()}`,
+                    `Uptime: ${formatUptime(os.uptime())}`,
+                    `Home Directory: ${os.homedir()}`,
+                    `Temp Directory: ${os.tmpdir()}`,
+                    `Shell: ${process.env.SHELL || "unknown"}`,
+                    `Node.js: ${process.version}`,
+                    `User: ${os.userInfo().username}`,
+                ].join("\n"));
+            }
+            if (category === "all" || category === "cpu") {
+                const cpus = os.cpus();
+                sections.push([
+                    "## CPU Information",
+                    `Model: ${cpus[0]?.model || "unknown"}`,
+                    `Cores: ${cpus.length}`,
+                    `Load Average (1m/5m/15m): ${os.loadavg().map((l) => l.toFixed(2)).join(" / ")}`,
+                ].join("\n"));
+            }
+            if (category === "all" || category === "memory") {
+                const totalMem = os.totalmem();
+                const freeMem = os.freemem();
+                const usedMem = totalMem - freeMem;
+                sections.push([
+                    "## Memory",
+                    `Total: ${formatBytes(totalMem)}`,
+                    `Used: ${formatBytes(usedMem)} (${((usedMem / totalMem) * 100).toFixed(1)}%)`,
+                    `Free: ${formatBytes(freeMem)}`,
+                ].join("\n"));
+            }
+            if (category === "all" || category === "network") {
+                const interfaces = os.networkInterfaces();
+                const netLines = ["## Network Interfaces"];
+                for (const [name, addrs] of Object.entries(interfaces)) {
+                    if (!addrs)
+                        continue;
+                    for (const addr of addrs) {
+                        if (addr.internal)
+                            continue;
+                        netLines.push(`${name}: ${addr.address} (${addr.family})`);
+                    }
+                }
+                sections.push(netLines.join("\n"));
+            }
+            if (category === "env") {
+                const envLines = ["## Environment Variables"];
+                const importantKeys = ["PATH", "HOME", "USER", "SHELL", "LANG", "TERM", "EDITOR", "NODE_ENV"];
+                for (const key of importantKeys) {
+                    if (process.env[key]) {
+                        envLines.push(`${key}: ${process.env[key]}`);
+                    }
+                }
+                sections.push(envLines.join("\n"));
+            }
+            return { content: [{ type: "text", text: sections.join("\n\n") }] };
+        },
+    };
+}
+//# sourceMappingURL=system-info.js.map

package/dist/tools/system-info.js.map

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

package/dist/tools/web-fetch.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from "../core/types.js";
+export declare function createWebFetchTool(): AgentTool;
+//# sourceMappingURL=web-fetch.d.ts.map

package/dist/tools/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../src/tools/web-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD,wBAAgB,kBAAkB,IAAI,SAAS,CAyE9C"}

package/dist/tools/web-fetch.js

@@ -0,0 +1,117 @@
+const MAX_CONTENT_LENGTH = 50000;
+export function createWebFetchTool() {
+    return {
+        name: "web_fetch",
+        label: "Web Fetch",
+        description: "Fetch the content of a web page and return it as readable text. Use this after web_search to read the full content of a specific URL.",
+        parameters: {
+            type: "object",
+            properties: {
+                url: { type: "string", description: "The URL to fetch" },
+                max_length: { type: "number", description: "Maximum character length of returned content (default: 50000)" },
+            },
+            required: ["url"],
+        },
+        execute: async (_toolCallId, params, signal) => {
+            const { url, max_length } = params;
+            const maxLen = Math.min(max_length || MAX_CONTENT_LENGTH, MAX_CONTENT_LENGTH);
+            if (signal?.aborted)
+                throw new Error("Operation aborted");
+            try {
+                new URL(url);
+            }
+            catch {
+                return { content: [{ type: "text", text: `Invalid URL: ${url}` }] };
+            }
+            try {
+                const response = await fetch(url, {
+                    headers: {
+                        "User-Agent": "Mozilla/5.0 (compatible; TIL-CLI/0.1; +https://github.com/til-cli)",
+                        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,text/plain;q=0.8,*/*;q=0.5",
+                    },
+                    signal,
+                    redirect: "follow",
+                });
+                if (!response.ok) {
+                    return {
+                        content: [{ type: "text", text: `HTTP error ${response.status}: ${response.statusText} for ${url}` }],
+                    };
+                }
+                const contentType = response.headers.get("content-type") || "";
+                if (contentType.includes("application/json")) {
+                    const json = await response.text();
+                    const truncated = json.slice(0, maxLen);
+                    return {
+                        content: [{
+                                type: "text",
+                                text: truncated + (json.length > maxLen ? "\n\n[Content truncated]" : ""),
+                            }],
+                    };
+                }
+                const html = await response.text();
+                const text = htmlToText(html);
+                const truncated = text.slice(0, maxLen);
+                return {
+                    content: [{
+                            type: "text",
+                            text: truncated + (text.length > maxLen ? "\n\n[Content truncated]" : ""),
+                        }],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Failed to fetch ${url}: ${err.message}`,
+                        }],
+                };
+            }
+        },
+    };
+}
+function htmlToText(html) {
+    let text = html;
+    // Remove script and style blocks
+    text = text.replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "");
+    text = text.replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "");
+    text = text.replace(/<noscript[^>]*>[\s\S]*?<\/noscript>/gi, "");
+    // Extract title
+    const titleMatch = text.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
+    const title = titleMatch ? titleMatch[1].replace(/<[^>]*>/g, "").trim() : "";
+    // Convert headers to markdown-style
+    text = text.replace(/<h1[^>]*>([\s\S]*?)<\/h1>/gi, "\n# $1\n");
+    text = text.replace(/<h2[^>]*>([\s\S]*?)<\/h2>/gi, "\n## $1\n");
+    text = text.replace(/<h3[^>]*>([\s\S]*?)<\/h3>/gi, "\n### $1\n");
+    text = text.replace(/<h[4-6][^>]*>([\s\S]*?)<\/h[4-6]>/gi, "\n#### $1\n");
+    // Convert links: keep href visible
+    text = text.replace(/<a[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi, "$2 ($1)");
+    // Convert lists
+    text = text.replace(/<li[^>]*>/gi, "\n- ");
+    text = text.replace(/<\/li>/gi, "");
+    // Convert paragraphs and line breaks
+    text = text.replace(/<br\s*\/?>/gi, "\n");
+    text = text.replace(/<\/p>/gi, "\n\n");
+    text = text.replace(/<\/div>/gi, "\n");
+    text = text.replace(/<\/tr>/gi, "\n");
+    text = text.replace(/<td[^>]*>/gi, "\t");
+    text = text.replace(/<th[^>]*>/gi, "\t");
+    // Remove remaining HTML tags
+    text = text.replace(/<[^>]*>/g, "");
+    // Decode common HTML entities
+    text = text.replace(/&amp;/g, "&");
+    text = text.replace(/&lt;/g, "<");
+    text = text.replace(/&gt;/g, ">");
+    text = text.replace(/&quot;/g, '"');
+    text = text.replace(/&#39;/g, "'");
+    text = text.replace(/&nbsp;/g, " ");
+    text = text.replace(/&#(\d+);/g, (_m, code) => String.fromCharCode(parseInt(code)));
+    // Collapse whitespace
+    text = text.replace(/[ \t]+/g, " ");
+    text = text.replace(/\n{3,}/g, "\n\n");
+    text = text.trim();
+    if (title) {
+        text = `# ${title}\n\n${text}`;
+    }
+    return text;
+}
+//# sourceMappingURL=web-fetch.js.map

package/dist/tools/web-fetch.js.map

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

package/dist/tools/web-search.d.ts

@@ -0,0 +1,9 @@
+import type { AgentTool } from "../core/types.js";
+/**
+ * Web search tool with multiple backend support:
+ *   1. Brave Search API (BRAVE_SEARCH_API_KEY) — recommended
+ *   2. Google Custom Search API (GOOGLE_SEARCH_API_KEY + GOOGLE_SEARCH_CX)
+ *   3. DuckDuckGo HTML scraping — zero-config fallback
+ */
+export declare function createWebSearchTool(): AgentTool;
+//# sourceMappingURL=web-search.d.ts.map

package/dist/tools/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,CAiC/C"}

package/dist/tools/web-search.js

@@ -0,0 +1,124 @@
+/**
+ * Web search tool with multiple backend support:
+ *   1. Brave Search API (BRAVE_SEARCH_API_KEY) — recommended
+ *   2. Google Custom Search API (GOOGLE_SEARCH_API_KEY + GOOGLE_SEARCH_CX)
+ *   3. DuckDuckGo HTML scraping — zero-config fallback
+ */
+export function createWebSearchTool() {
+    return {
+        name: "web_search",
+        label: "Web Search",
+        description: "Search the web for real-time information. Returns search results with titles, URLs, and snippets. Use this when you need up-to-date information or to verify facts.",
+        parameters: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Search query" },
+                num_results: { type: "number", description: "Number of results to return (default: 5, max: 10)" },
+            },
+            required: ["query"],
+        },
+        execute: async (_toolCallId, params, signal) => {
+            const { query, num_results } = params;
+            const count = Math.min(num_results || 5, 10);
+            if (signal?.aborted)
+                throw new Error("Operation aborted");
+            const braveApiKey = process.env.BRAVE_SEARCH_API_KEY;
+            if (braveApiKey) {
+                return await braveSearch(query, count, braveApiKey, signal);
+            }
+            const googleApiKey = process.env.GOOGLE_SEARCH_API_KEY;
+            const googleCx = process.env.GOOGLE_SEARCH_CX;
+            if (googleApiKey && googleCx) {
+                return await googleSearch(query, count, googleApiKey, googleCx, signal);
+            }
+            return await duckDuckGoSearch(query, count, signal);
+        },
+    };
+}
+async function braveSearch(query, count, apiKey, signal) {
+    const url = `https://api.search.brave.com/res/v1/web/search?q=${encodeURIComponent(query)}&count=${count}`;
+    const response = await fetch(url, {
+        headers: {
+            "Accept": "application/json",
+            "Accept-Encoding": "gzip",
+            "X-Subscription-Token": apiKey,
+        },
+        signal,
+    });
+    if (!response.ok) {
+        throw new Error(`Brave Search API error: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    const webResults = data.web?.results || [];
+    if (webResults.length === 0) {
+        return { content: [{ type: "text", text: `No results found for: ${query}` }] };
+    }
+    const formatted = webResults.map((r, i) => `${i + 1}. ${r.title}\n   ${r.url}\n   ${r.description || ""}`).join("\n\n");
+    return { content: [{ type: "text", text: formatted }] };
+}
+async function googleSearch(query, count, apiKey, cx, signal) {
+    const url = `https://www.googleapis.com/customsearch/v1?key=${apiKey}&cx=${cx}&q=${encodeURIComponent(query)}&num=${count}`;
+    const response = await fetch(url, { signal });
+    if (!response.ok) {
+        throw new Error(`Google Search API error: ${response.status}`);
+    }
+    const data = await response.json();
+    const items = data.items || [];
+    const results = items.map((item, i) => `${i + 1}. ${item.title}\n   ${item.link}\n   ${item.snippet || ""}`).join("\n\n");
+    return {
+        content: [{
+                type: "text",
+                text: results || `No results found for: ${query}`,
+            }],
+    };
+}
+async function duckDuckGoSearch(query, count, signal) {
+    const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}`;
+    try {
+        const response = await fetch(url, {
+            headers: {
+                "User-Agent": "Mozilla/5.0 (compatible; TIL-CLI/0.1)",
+            },
+            signal,
+        });
+        if (!response.ok) {
+            throw new Error(`DuckDuckGo search error: ${response.status}`);
+        }
+        const html = await response.text();
+        const results = parseDDGResults(html, count);
+        if (results.length === 0) {
+            return {
+                content: [{ type: "text", text: `No results found for: ${query}. Try using bash with curl for alternative search methods.` }],
+            };
+        }
+        const formatted = results.map((r, i) => `${i + 1}. ${r.title}\n   ${r.url}\n   ${r.snippet}`).join("\n\n");
+        return { content: [{ type: "text", text: formatted }] };
+    }
+    catch (err) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `Web search failed: ${err.message}. You can use bash with curl as an alternative.`,
+                }],
+        };
+    }
+}
+function parseDDGResults(html, maxResults) {
+    const results = [];
+    const resultPattern = /<a[^>]*class="result__a"[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi;
+    const snippetPattern = /<a[^>]*class="result__snippet"[^>]*>([\s\S]*?)<\/a>/gi;
+    const titles = [...html.matchAll(resultPattern)];
+    const snippets = [...html.matchAll(snippetPattern)];
+    for (let i = 0; i < Math.min(titles.length, maxResults); i++) {
+        const titleMatch = titles[i];
+        const snippetMatch = snippets[i];
+        const url = decodeURIComponent((titleMatch[1] || "").replace(/.*uddg=([^&]*).*/, "$1") || titleMatch[1] || "");
+        const title = (titleMatch[2] || "").replace(/<[^>]*>/g, "").trim();
+        const snippet = snippetMatch ? (snippetMatch[1] || "").replace(/<[^>]*>/g, "").trim() : "";
+        if (title && url) {
+            results.push({ title, url, snippet });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=web-search.js.map

package/dist/tools/web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.js","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IAClC,OAAO;QACN,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,qKAAqK;QAClL,UAAU,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACX,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;gBACtD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mDAAmD,EAAE;aACjG;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACnB;QACD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAC9C,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAiD,CAAC;YACjF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YAE7C,IAAI,MAAM,EAAE,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAE1D,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;YACrD,IAAI,WAAW,EAAE,CAAC;gBACjB,OAAO,MAAM,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;YAC7D,CAAC;YAED,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;YACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;YAC9C,IAAI,YAAY,IAAI,QAAQ,EAAE,CAAC;gBAC9B,OAAO,MAAM,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACzE,CAAC;YAED,OAAO,MAAM,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC;KACD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,KAAa,EAAE,KAAa,EAAE,MAAc,EAAE,MAAoB;IAC5F,MAAM,GAAG,GAAG,oDAAoD,kBAAkB,CAAC,KAAK,CAAC,UAAU,KAAK,EAAE,CAAC;IAC3G,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QACjC,OAAO,EAAE;YACR,QAAQ,EAAE,kBAAkB;YAC5B,iBAAiB,EAAE,MAAM;YACzB,sBAAsB,EAAE,MAAM;SAC9B;QACD,MAAM;KACN,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAS,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC;IAE3C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,yBAAyB,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,CAAS,EAAE,EAAE,CACtD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,WAAW,IAAI,EAAE,EAAE,CAC9D,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,KAAK,UAAU,YAAY,CAC1B,KAAa,EACb,KAAa,EACb,MAAc,EACd,EAAU,EACV,MAAoB;IAEpB,MAAM,GAAG,GAAG,kDAAkD,MAAM,OAAO,EAAE,MAAM,kBAAkB,CAAC,KAAK,CAAC,QAAQ,KAAK,EAAE,CAAC;IAC5H,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAE9C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAS,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAE/B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,CAAS,EAAE,EAAE,CAClD,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CACpE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEf,OAAO;QACN,OAAO,EAAE,CAAC;gBACT,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,OAAO,IAAI,yBAAyB,KAAK,EAAE;aACjD,CAAC;KACF,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,KAAa,EAAE,KAAa,EAAE,MAAoB;IACjF,MAAM,GAAG,GAAG,uCAAuC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;IAE/E,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YACjC,OAAO,EAAE;gBACR,YAAY,EAAE,uCAAuC;aACrD;YACD,MAAM;SACN,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAE7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,yBAAyB,KAAK,4DAA4D,EAAE,CAAC;aACtI,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACtC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,EAAE,CACpD,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAClE,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QACnB,OAAO;YACN,OAAO,EAAE,CAAC;oBACT,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,sBAAsB,GAAG,CAAC,OAAO,iDAAiD;iBACxF,CAAC;SACF,CAAC;IACH,CAAC;AACF,CAAC;AAQD,SAAS,eAAe,CAAC,IAAY,EAAE,UAAkB;IACxD,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,MAAM,aAAa,GAAG,oEAAoE,CAAC;IAC3F,MAAM,cAAc,GAAG,uDAAuD,CAAC;IAE/E,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;IAEpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9D,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAEjC,MAAM,GAAG,GAAG,kBAAkB,CAC7B,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAC9E,CAAC;QACF,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACnE,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE3F,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QACvC,CAAC;IACF,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC"}

package/dist/tools/write.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from "../core/types.js";
+export declare function createWriteTool(cwd: string): AgentTool;
+//# sourceMappingURL=write.d.ts.map

package/dist/tools/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,kBAAkB,CAAC;AAGnE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CA2BtD"}

package/dist/tools/write.js

@@ -0,0 +1,30 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { resolveToCwd } from "../utils/path.js";
+export function createWriteTool(cwd) {
+    return {
+        name: "write",
+        label: "Write",
+        description: "Write content to a file. Creates the file if it doesn't exist, overwrites if it does. Automatically creates parent directories.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Path to the file to write (relative or absolute)" },
+                content: { type: "string", description: "Content to write to the file" },
+            },
+            required: ["path", "content"],
+        },
+        execute: async (_toolCallId, params, signal) => {
+            const { path, content } = params;
+            const absolutePath = resolveToCwd(path, cwd);
+            if (signal?.aborted)
+                throw new Error("Operation aborted");
+            await mkdir(dirname(absolutePath), { recursive: true });
+            await writeFile(absolutePath, content, "utf-8");
+            return {
+                content: [{ type: "text", text: `Successfully wrote ${content.length} bytes to ${path}` }],
+            };
+        },
+    };
+}
+//# 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":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,UAAU,eAAe,CAAC,GAAW;IAC1C,OAAO;QACN,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,iIAAiI;QAC9I,UAAU,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACX,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kDAAkD,EAAE;gBACzF,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;aACxE;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;SAC7B;QACD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAC9C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAA2C,CAAC;YACtE,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAE7C,IAAI,MAAM,EAAE,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAE1D,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,MAAM,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAEhD,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,OAAO,CAAC,MAAM,aAAa,IAAI,EAAE,EAAE,CAAC;aAC1F,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/utils/autocomplete.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Path autocomplete for @ file references in the interactive REPL.
+ * Uses `fd` for fuzzy search when available, falls back to readdirSync.
+ * Cross-platform: supports both Unix (/) and Windows (\) path separators.
+ */
+export interface CompletionItem {
+    value: string;
+    display: string;
+    isDirectory: boolean;
+}
+/**
+ * Get file suggestions for an @ prefix.
+ * Supports relative paths, absolute paths (/...), and home paths (~/).
+ * @param prefix - The text after @, e.g. "src/co", "~/dev/", "/usr/local/"
+ * @param cwd - Working directory
+ */
+export declare function getFileSuggestions(prefix: string, cwd: string): CompletionItem[];
+/**
+ * Extract the @ prefix from a line for autocomplete purposes.
+ * Returns the text after @, or null if not in an @ context.
+ */
+export declare function extractAtPrefix(line: string): string | null;
+//# sourceMappingURL=autocomplete.d.ts.map

package/dist/utils/autocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.d.ts","sourceRoot":"","sources":["../../src/utils/autocomplete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsCH,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACrB;AAYD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CAahF;AAqHD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI3D"}