@cdoing/core 0.1.0

package/dist/tools/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# 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/view-diff.d.ts

@@ -0,0 +1,11 @@
+/**
+ * View Diff Tool — show git diff (working changes, staged, between commits).
+ */
+import type { BaseTool, ToolDefinition, ToolResult } from "./types";
+export declare class ViewDiffTool implements BaseTool {
+    definition: ToolDefinition;
+    private workingDir;
+    constructor(workingDir: string);
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+}
+//# sourceMappingURL=view-diff.d.ts.map

package/dist/tools/view-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-diff.d.ts","sourceRoot":"","sources":["../../src/tools/view-diff.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpE,qBAAa,YAAa,YAAW,QAAQ;IAC3C,UAAU,EAAE,cAAc,CA8BxB;IAEF,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAIxB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAoDnE"}

package/dist/tools/view-diff.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * View Diff Tool — show git diff (working changes, staged, between commits).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewDiffTool = void 0;
+const child_process_1 = require("child_process");
+class ViewDiffTool {
+    definition = {
+        name: "view_diff",
+        description: `Show git diff of changes. Supports working changes, staged changes, and diff between commits/branches.
+
+Examples:
+- No args: shows unstaged working changes
+- staged=true: shows staged changes (what would be committed)
+- target="main": diff between current branch and main
+- target="HEAD~3": diff against 3 commits ago
+- file_path="src/app.ts": diff for a specific file only`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                staged: {
+                    type: "boolean",
+                    description: "Show staged changes instead of working changes. Default: false.",
+                },
+                target: {
+                    type: "string",
+                    description: "Compare against a branch, commit, or ref. E.g. 'main', 'HEAD~1', 'abc123'.",
+                },
+                file_path: {
+                    type: "string",
+                    description: "Limit diff to a specific file or directory.",
+                },
+            },
+            required: [],
+        },
+        requiresPermission: false,
+    };
+    workingDir;
+    constructor(workingDir) {
+        this.workingDir = workingDir;
+    }
+    async execute(input) {
+        const staged = input.staged || false;
+        const target = input.target || "";
+        const filePath = input.file_path || "";
+        // Build git diff command
+        const parts = ["git", "diff"];
+        if (staged && !target) {
+            parts.push("--cached");
+        }
+        else if (target) {
+            // Sanitize target — only allow safe git ref characters
+            if (!/^[a-zA-Z0-9_.\/~^@{}\-]+$/.test(target)) {
+                return { success: false, output: "", error: `Invalid git ref: "${target}"` };
+            }
+            parts.push(target);
+        }
+        parts.push("--stat", "--patch");
+        if (filePath) {
+            parts.push("--", filePath);
+        }
+        const command = parts.join(" ");
+        return new Promise((resolve) => {
+            (0, child_process_1.exec)(command, { cwd: this.workingDir, timeout: 30000, maxBuffer: 5 * 1024 * 1024 }, (error, stdout, stderr) => {
+                if (error && !stdout) {
+                    const msg = stderr?.trim() || error.message;
+                    resolve({ success: false, output: "", error: `git diff failed: ${msg}` });
+                    return;
+                }
+                const output = stdout.trim();
+                if (!output) {
+                    const context = staged ? "staged" : target ? `vs ${target}` : "working";
+                    resolve({ success: true, output: `No changes (${context})` });
+                    return;
+                }
+                // Truncate if too large
+                const maxLen = 50000;
+                const truncated = output.length > maxLen
+                    ? output.substring(0, maxLen) + `\n\n... [truncated at ${maxLen} characters]`
+                    : output;
+                resolve({ success: true, output: truncated });
+            });
+        });
+    }
+}
+exports.ViewDiffTool = ViewDiffTool;
+//# sourceMappingURL=view-diff.js.map

package/dist/tools/view-diff.js.map

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

package/dist/tools/view-repo-map.d.ts

@@ -0,0 +1,18 @@
+/**
+ * View Repo Map Tool — generate a structural overview of the repository.
+ *
+ * Shows the project layout: directories, key files, entry points,
+ * config files, and a summary of the codebase structure.
+ */
+import type { BaseTool, ToolDefinition, ToolResult } from "./types";
+export declare class ViewRepoMapTool implements BaseTool {
+    definition: ToolDefinition;
+    private workingDir;
+    constructor(workingDir: string);
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+    private buildTree;
+    private collectStats;
+    private formatStats;
+    private getGitInfo;
+}
+//# sourceMappingURL=view-repo-map.d.ts.map

package/dist/tools/view-repo-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-repo-map.d.ts","sourceRoot":"","sources":["../../src/tools/view-repo-map.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAsCpE,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,UAAU,EAAE,cAAc,CAsBxB;IAEF,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAIxB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IA6BlE,OAAO,CAAC,SAAS;IA0CjB,OAAO,CAAC,YAAY;IA6CpB,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,UAAU;CAyBnB"}

package/dist/tools/view-repo-map.js

@@ -0,0 +1,245 @@
+"use strict";
+/**
+ * View Repo Map Tool — generate a structural overview of the repository.
+ *
+ * Shows the project layout: directories, key files, entry points,
+ * config files, and a summary of the codebase structure.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewRepoMapTool = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const ALWAYS_IGNORE = new Set([
+    "node_modules", ".git", "dist", "build", "out", ".next", ".nuxt",
+    "__pycache__", ".cache", ".turbo", "coverage", "venv", ".venv",
+    "target", "vendor", ".idea", ".vscode", ".DS_Store", "*.pyc",
+]);
+const CONFIG_FILES = new Set([
+    "package.json", "tsconfig.json", "tsconfig.base.json",
+    ".eslintrc.js", ".eslintrc.json", ".prettierrc",
+    "jest.config.js", "jest.config.ts", "vitest.config.ts",
+    "webpack.config.js", "vite.config.ts", "vite.config.js",
+    "rollup.config.js", "esbuild.config.js",
+    "Dockerfile", "docker-compose.yml", "docker-compose.yaml",
+    "Makefile", "CMakeLists.txt",
+    ".env.example", ".gitignore", ".dockerignore",
+    "pyproject.toml", "setup.py", "setup.cfg", "requirements.txt",
+    "Cargo.toml", "go.mod", "Gemfile", "composer.json",
+    "turbo.json", "lerna.json", "nx.json",
+]);
+const ENTRY_PATTERNS = [
+    "index.ts", "index.js", "main.ts", "main.js", "app.ts", "app.js",
+    "server.ts", "server.js", "cli.ts", "cli.js",
+    "index.py", "main.py", "app.py", "__main__.py",
+    "main.go", "main.rs", "lib.rs",
+];
+class ViewRepoMapTool {
+    definition = {
+        name: "view_repo_map",
+        description: `Generate a structural overview of the repository. Shows:
+- Directory tree (top 2 levels)
+- Detected languages and file counts
+- Config files found
+- Likely entry points
+- Git branch and recent commits
+
+Use this to understand a new project before diving into code.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                directory: {
+                    type: "string",
+                    description: "Subdirectory to focus on. Defaults to project root.",
+                },
+            },
+            required: [],
+        },
+        requiresPermission: false,
+    };
+    workingDir;
+    constructor(workingDir) {
+        this.workingDir = workingDir;
+    }
+    async execute(input) {
+        const subdir = input.directory || "";
+        const rootDir = subdir ? path.resolve(this.workingDir, subdir) : this.workingDir;
+        if (!fs.existsSync(rootDir) || !fs.statSync(rootDir).isDirectory()) {
+            return { success: false, output: "", error: `Directory not found: ${rootDir}` };
+        }
+        const sections = [];
+        // 1. Header
+        sections.push(`# Repository Map: ${path.basename(rootDir)}`);
+        sections.push(`Path: ${rootDir}`);
+        // 2. Git info
+        const gitInfo = await this.getGitInfo(rootDir);
+        if (gitInfo)
+            sections.push(gitInfo);
+        // 3. Directory tree (2 levels)
+        const tree = this.buildTree(rootDir, 2);
+        sections.push("\n## Directory Structure\n```\n" + tree + "\n```");
+        // 4. Stats
+        const stats = this.collectStats(rootDir);
+        sections.push(this.formatStats(stats));
+        return { success: true, output: sections.join("\n") };
+    }
+    buildTree(dir, maxDepth, prefix = "", depth = 0) {
+        if (depth > maxDepth)
+            return "";
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return "";
+        }
+        entries = entries
+            .filter((e) => !ALWAYS_IGNORE.has(e.name) && !e.name.startsWith("."))
+            .sort((a, b) => {
+            if (a.isDirectory() && !b.isDirectory())
+                return -1;
+            if (!a.isDirectory() && b.isDirectory())
+                return 1;
+            return a.name.localeCompare(b.name);
+        });
+        const lines = [];
+        for (let i = 0; i < entries.length; i++) {
+            const entry = entries[i];
+            const isLast = i === entries.length - 1;
+            const connector = isLast ? "└── " : "├── ";
+            const childPrefix = isLast ? "    " : "│   ";
+            if (entry.isDirectory()) {
+                lines.push(`${prefix}${connector}${entry.name}/`);
+                const subtree = this.buildTree(path.join(dir, entry.name), maxDepth, prefix + childPrefix, depth + 1);
+                if (subtree)
+                    lines.push(subtree);
+            }
+            else {
+                lines.push(`${prefix}${connector}${entry.name}`);
+            }
+        }
+        return lines.join("\n");
+    }
+    collectStats(dir, stats, depth = 0) {
+        if (!stats) {
+            stats = { totalFiles: 0, totalDirs: 0, languages: new Map(), configFiles: [], entryPoints: [] };
+        }
+        if (depth > 10 || stats.totalFiles > 5000)
+            return stats;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return stats;
+        }
+        for (const entry of entries) {
+            if (ALWAYS_IGNORE.has(entry.name))
+                continue;
+            if (entry.isDirectory()) {
+                stats.totalDirs++;
+                this.collectStats(path.join(dir, entry.name), stats, depth + 1);
+            }
+            else {
+                stats.totalFiles++;
+                // Track language
+                const ext = path.extname(entry.name).toLowerCase();
+                if (ext) {
+                    stats.languages.set(ext, (stats.languages.get(ext) || 0) + 1);
+                }
+                // Config files
+                if (CONFIG_FILES.has(entry.name) && depth <= 2) {
+                    const rel = path.relative(this.workingDir, path.join(dir, entry.name));
+                    stats.configFiles.push(rel);
+                }
+                // Entry points
+                if (ENTRY_PATTERNS.includes(entry.name) && depth <= 3) {
+                    const rel = path.relative(this.workingDir, path.join(dir, entry.name));
+                    stats.entryPoints.push(rel);
+                }
+            }
+        }
+        return stats;
+    }
+    formatStats(stats) {
+        const lines = ["\n## Summary"];
+        lines.push(`- **${stats.totalFiles}** files in **${stats.totalDirs}** directories`);
+        // Languages (top 10)
+        if (stats.languages.size > 0) {
+            const sorted = [...stats.languages.entries()]
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 10);
+            const langStr = sorted.map(([ext, count]) => `${ext} (${count})`).join(", ");
+            lines.push(`- **Languages:** ${langStr}`);
+        }
+        // Config files
+        if (stats.configFiles.length > 0) {
+            lines.push(`\n### Config Files`);
+            for (const f of stats.configFiles.slice(0, 20))
+                lines.push(`- ${f}`);
+        }
+        // Entry points
+        if (stats.entryPoints.length > 0) {
+            lines.push(`\n### Entry Points`);
+            for (const f of stats.entryPoints.slice(0, 20))
+                lines.push(`- ${f}`);
+        }
+        return lines.join("\n");
+    }
+    getGitInfo(dir) {
+        return new Promise((resolve) => {
+            (0, child_process_1.exec)('git branch --show-current && echo "---" && git log --oneline -5 2>/dev/null', { cwd: dir, timeout: 5000 }, (error, stdout) => {
+                if (error || !stdout.trim()) {
+                    resolve(null);
+                    return;
+                }
+                const parts = stdout.split("---");
+                const branch = parts[0]?.trim();
+                const commits = parts[1]?.trim();
+                const lines = [`Branch: **${branch}**`];
+                if (commits) {
+                    lines.push("\nRecent commits:");
+                    for (const c of commits.split("\n").slice(0, 5)) {
+                        lines.push(`  ${c.trim()}`);
+                    }
+                }
+                resolve(lines.join("\n"));
+            });
+        });
+    }
+}
+exports.ViewRepoMapTool = ViewRepoMapTool;
+//# sourceMappingURL=view-repo-map.js.map

package/dist/tools/view-repo-map.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * Web Fetch Tool — fetch content from URLs.
+ * Supports HTML pages (extracts text), JSON APIs, and plain text.
+ */
+import type { BaseTool, ToolDefinition, ToolResult } from "./types";
+import type { SandboxManager } from "../sandbox";
+export declare class WebFetchTool implements BaseTool {
+    definition: ToolDefinition;
+    private sandboxManager?;
+    constructor(sandboxManager?: SandboxManager);
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+}
+//# 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;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,YAAa,YAAW,QAAQ;IAC3C,UAAU,EAAE,cAAc,CAoBxB;IAEF,OAAO,CAAC,cAAc,CAAC,CAAiB;gBAE5B,cAAc,CAAC,EAAE,cAAc;IAIrC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CA4DnE"}

package/dist/tools/web-fetch.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Web Fetch Tool — fetch content from URLs.
+ * Supports HTML pages (extracts text), JSON APIs, and plain text.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebFetchTool = void 0;
+class WebFetchTool {
+    definition = {
+        name: "web_fetch",
+        description: "Fetch content from a URL. Returns the text content of the page. Useful for reading documentation, APIs, or web pages. Requires user permission. Network access is controlled by sandbox domain rules — requests to non-allowed domains may be blocked.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                url: {
+                    type: "string",
+                    description: "The URL to fetch",
+                },
+                max_length: {
+                    type: "number",
+                    description: "Maximum characters to return. Default: 10000.",
+                },
+            },
+            required: ["url"],
+        },
+        requiresPermission: true,
+        permissionMessage: (input) => `Fetch URL: ${input.url}`,
+    };
+    sandboxManager;
+    constructor(sandboxManager) {
+        this.sandboxManager = sandboxManager;
+    }
+    async execute(input) {
+        const url = input.url;
+        const maxLength = input.max_length || 10000;
+        // Validate URL
+        try {
+            new URL(url);
+        }
+        catch {
+            return { success: false, output: "", error: `Invalid URL: ${url}` };
+        }
+        // Sandbox network check
+        if (this.sandboxManager) {
+            const check = await this.sandboxManager.checkNetworkAccess(url);
+            if (!check.allowed) {
+                return { success: false, output: "", error: check.reason || "Sandbox: network access denied" };
+            }
+        }
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 30000);
+            const response = await fetch(url, {
+                signal: controller.signal,
+                headers: {
+                    "User-Agent": "Cdoing-Agent/0.1.0",
+                    "Accept": "text/html,application/json,text/plain,*/*",
+                },
+            });
+            clearTimeout(timeout);
+            if (!response.ok) {
+                return {
+                    success: false,
+                    output: "",
+                    error: `HTTP ${response.status}: ${response.statusText}`,
+                };
+            }
+            const contentType = response.headers.get("content-type") || "";
+            let text = await response.text();
+            // If HTML, strip tags and extract text content
+            if (contentType.includes("text/html")) {
+                text = stripHtml(text);
+            }
+            // Truncate if too long
+            if (text.length > maxLength) {
+                text = text.substring(0, maxLength) + `\n\n... [truncated at ${maxLength} characters]`;
+            }
+            return { success: true, output: text || "(empty response)" };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { success: false, output: "", error: `Fetch failed: ${message}` };
+        }
+    }
+}
+exports.WebFetchTool = WebFetchTool;
+/** Simple HTML-to-text: remove tags, decode common entities, collapse whitespace */
+function stripHtml(html) {
+    return html
+        // Remove script and style blocks
+        .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "")
+        .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "")
+        // Remove HTML tags
+        .replace(/<[^>]+>/g, " ")
+        // Decode common entities
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&nbsp;/g, " ")
+        // Collapse whitespace
+        .replace(/\s+/g, " ")
+        .trim();
+}
+//# 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,10 @@
+/**
+ * Web Search Tool — search the web using DuckDuckGo's HTML page.
+ * No API key required — uses DDG's lite HTML interface.
+ */
+import type { BaseTool, ToolDefinition, ToolResult } from "./types";
+export declare class WebSearchTool implements BaseTool {
+    definition: ToolDefinition;
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+}
+//# 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;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpE,qBAAa,aAAc,YAAW,QAAQ;IAC5C,UAAU,EAAE,cAAc,CAoBxB;IAEI,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAiDnE"}

package/dist/tools/web-search.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Web Search Tool — search the web using DuckDuckGo's HTML page.
+ * No API key required — uses DDG's lite HTML interface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSearchTool = void 0;
+class WebSearchTool {
+    definition = {
+        name: "web_search",
+        description: "Search the web for information. Returns search results with titles, URLs, and snippets. Useful for finding documentation, solutions, or current information.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "The search query",
+                },
+                max_results: {
+                    type: "number",
+                    description: "Maximum number of results. Default: 5.",
+                },
+            },
+            required: ["query"],
+        },
+        requiresPermission: true,
+        permissionMessage: (input) => `Web search: ${input.query}`,
+    };
+    async execute(input) {
+        const query = input.query;
+        const maxResults = input.max_results || 5;
+        try {
+            const encodedQuery = encodeURIComponent(query);
+            const url = `https://lite.duckduckgo.com/lite/?q=${encodedQuery}`;
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 15000);
+            const response = await fetch(url, {
+                signal: controller.signal,
+                headers: {
+                    "User-Agent": "Cdoing-Agent/0.1.0",
+                    "Accept": "text/html",
+                },
+            });
+            clearTimeout(timeout);
+            if (!response.ok) {
+                return {
+                    success: false,
+                    output: "",
+                    error: `Search failed: HTTP ${response.status}`,
+                };
+            }
+            const html = await response.text();
+            const results = parseSearchResults(html, maxResults);
+            if (results.length === 0) {
+                return { success: true, output: "No results found." };
+            }
+            const formatted = results
+                .map((r, i) => `${i + 1}. **${r.title}**\n   ${r.url}\n   ${r.snippet}`)
+                .join("\n\n");
+            return {
+                success: true,
+                output: `Search results for "${query}":\n\n${formatted}`,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { success: false, output: "", error: `Search failed: ${message}` };
+        }
+    }
+}
+exports.WebSearchTool = WebSearchTool;
+/** Parse DDG lite HTML for search results */
+function parseSearchResults(html, maxResults) {
+    const results = [];
+    // DDG lite puts results in table rows with class "result-link" for titles
+    // and "result-snippet" for descriptions
+    const linkRegex = /<a[^>]+class="result-link"[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi;
+    const snippetRegex = /<td[^>]+class="result-snippet"[^>]*>([\s\S]*?)<\/td>/gi;
+    const links = [];
+    const snippets = [];
+    let match;
+    while ((match = linkRegex.exec(html)) !== null) {
+        links.push({
+            url: match[1].replace(/&amp;/g, "&"),
+            title: match[2].replace(/<[^>]+>/g, "").trim(),
+        });
+    }
+    while ((match = snippetRegex.exec(html)) !== null) {
+        snippets.push(match[1]
+            .replace(/<[^>]+>/g, "")
+            .replace(/&amp;/g, "&")
+            .replace(/&lt;/g, "<")
+            .replace(/&gt;/g, ">")
+            .replace(/&quot;/g, '"')
+            .trim());
+    }
+    for (let i = 0; i < Math.min(links.length, maxResults); i++) {
+        results.push({
+            title: links[i].title || "(untitled)",
+            url: links[i].url,
+            snippet: snippets[i] || "",
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=web-search.js.map