openhorse 0.1.5

package/dist/tools/plan.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * openhorse - Plan Mode Tools
+ *
+ * enter_plan_mode: Enter planning mode for complex tasks
+ * exit_plan_mode: Exit planning mode with a plan
+ *
+ * State is held in the shared tool-state module so the CLI can mirror it
+ * into the main Store.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLAN_TOOLS = exports.exitPlanModeTool = exports.enterPlanModeTool = void 0;
+exports.isInPlanMode = isInPlanMode;
+exports.getCurrentPlan = getCurrentPlan;
+const tool_1 = require("../framework/tool");
+const tool_state_1 = require("../framework/tool-state");
+exports.enterPlanModeTool = (0, tool_1.buildTool)({
+    name: 'enter_plan_mode',
+    description: `Enter plan mode for complex tasks requiring exploration and planning.
+In plan mode, you should explore the project structure, understand the problem,
+and create a detailed implementation plan WITHOUT executing any code changes.
+Use this when the task is complex, ambiguous, or requires careful consideration.`,
+    parameters: {
+        type: 'object',
+        properties: {},
+    },
+    execute: async () => {
+        (0, tool_state_1.setToolState)({ planMode: true, currentPlan: null });
+        return {
+            success: true,
+            output: 'Entered plan mode. Explore the project, understand the problem, and create a plan. Use exit_plan_mode when ready with your plan.',
+        };
+    },
+    isReadOnly: () => true,
+    isConcurrencySafe: () => true,
+    checkPermissions: () => ({ behavior: 'allow', reason: 'Safe mode change' }),
+    userFacingName: () => 'Enter plan mode',
+});
+exports.exitPlanModeTool = (0, tool_1.buildTool)({
+    name: 'exit_plan_mode',
+    description: `Exit plan mode and save the implementation plan.
+This tool finalizes the plan and returns to execution mode.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            plan: {
+                type: 'string',
+                description: 'The detailed implementation plan',
+            },
+        },
+        required: ['plan'],
+    },
+    execute: async (args) => {
+        const plan = args.plan;
+        (0, tool_state_1.setToolState)({ planMode: false, currentPlan: plan });
+        return {
+            success: true,
+            output: `Exited plan mode. Plan saved:\n\n${plan}`,
+        };
+    },
+    isReadOnly: () => false,
+    isConcurrencySafe: () => true,
+    checkPermissions: () => ({ behavior: 'allow', reason: 'Safe mode change' }),
+    userFacingName: () => 'Exit plan mode',
+});
+/** Check if currently in plan mode */
+function isInPlanMode() {
+    return (0, tool_state_1.getToolState)().planMode;
+}
+/** Get current plan */
+function getCurrentPlan() {
+    return (0, tool_state_1.getToolState)().currentPlan ?? '';
+}
+exports.PLAN_TOOLS = [exports.enterPlanModeTool, exports.exitPlanModeTool];
+//# sourceMappingURL=plan.js.map

package/dist/tools/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/tools/plan.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAyDH,oCAEC;AAGD,wCAEC;AA9DD,4CAAkE;AAClE,wDAAqE;AAExD,QAAA,iBAAiB,GAAkB,IAAA,gBAAS,EAAC;IACxD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;iFAGkE;IAC/E,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;IACD,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,IAAA,yBAAY,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,kIAAkI;SAC3I,CAAC;IACJ,CAAC;IACD,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI;IACtB,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;IAC7B,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC3E,cAAc,EAAE,GAAG,EAAE,CAAC,iBAAiB;CACxC,CAAC,CAAC;AAEU,QAAA,gBAAgB,GAAkB,IAAA,gBAAS,EAAC;IACvD,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE;4DAC6C;IAC1D,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;QACjC,IAAA,yBAAY,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,oCAAoC,IAAI,EAAE;SACnD,CAAC;IACJ,CAAC;IACD,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK;IACvB,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;IAC7B,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC3E,cAAc,EAAE,GAAG,EAAE,CAAC,gBAAgB;CACvC,CAAC,CAAC;AAEH,sCAAsC;AACtC,SAAgB,YAAY;IAC1B,OAAO,IAAA,yBAAY,GAAE,CAAC,QAAQ,CAAC;AACjC,CAAC;AAED,uBAAuB;AACvB,SAAgB,cAAc;IAC5B,OAAO,IAAA,yBAAY,GAAE,CAAC,WAAW,IAAI,EAAE,CAAC;AAC1C,CAAC;AAEY,QAAA,UAAU,GAAoB,CAAC,yBAAiB,EAAE,wBAAgB,CAAC,CAAC"}

package/dist/tools/todo.d.ts

@@ -0,0 +1,18 @@
+/**
+ * openhorse - TodoWrite Tool
+ *
+ * Manage task progress during coding sessions.
+ *
+ * State is held in the shared tool-state module so the CLI can mirror it
+ * into the main Store and render it in the UI.
+ */
+import { type OpenHorseTool } from '../framework/tool';
+import { type TodoItem } from '../framework/tool-state';
+export declare const todoWriteTool: OpenHorseTool;
+/** Get current todos (for UI display) */
+export declare function getCurrentTodos(): TodoItem[];
+/** Format todos for display */
+export declare function formatTodosForDisplay(todos: TodoItem[]): string;
+export type { TodoItem };
+export declare const TODO_TOOLS: OpenHorseTool[];
+//# sourceMappingURL=todo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../../src/tools/todo.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAA8B,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AA4CpF,eAAO,MAAM,aAAa,EAAE,aAmF1B,CAAC;AAEH,yCAAyC;AACzC,wBAAgB,eAAe,IAAI,QAAQ,EAAE,CAE5C;AAED,+BAA+B;AAC/B,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAc/D;AAED,YAAY,EAAE,QAAQ,EAAE,CAAC;AACzB,eAAO,MAAM,UAAU,EAAE,aAAa,EAAoB,CAAC"}

package/dist/tools/todo.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * openhorse - TodoWrite Tool
+ *
+ * Manage task progress during coding sessions.
+ *
+ * State is held in the shared tool-state module so the CLI can mirror it
+ * into the main Store and render it in the UI.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TODO_TOOLS = exports.todoWriteTool = void 0;
+exports.getCurrentTodos = getCurrentTodos;
+exports.formatTodosForDisplay = formatTodosForDisplay;
+const tool_1 = require("../framework/tool");
+const tool_state_1 = require("../framework/tool-state");
+// ============================================================================
+// TodoWrite Tool
+// ============================================================================
+const TODO_PROMPT = `Use this tool to create and manage a structured task list for your current coding session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user.
+
+## When to Use This Tool
+
+1. Complex multi-step tasks - When a task requires 3 or more distinct steps
+2. Non-trivial tasks - Tasks that require careful planning or multiple operations
+3. User explicitly requests todo list
+4. User provides multiple tasks (numbered or comma-separated)
+5. After receiving new instructions - Immediately capture user requirements
+6. When you start working on a task - Mark it as in_progress BEFORE beginning
+7. After completing a task - Mark it completed immediately
+
+## When NOT to Use
+
+1. Single, straightforward task
+2. Trivial task with no organizational benefit
+3. Purely conversational or informational
+
+## Task States
+
+- pending: Task not yet started
+- in_progress: Currently working on (limit to ONE task at a time)
+- completed: Task finished successfully
+
+## Task Format
+
+Each todo must have:
+- content: Imperative form ("Run tests")
+- activeForm: Present continuous form ("Running tests")
+- status: pending | in_progress | completed
+
+## Rules
+
+- Exactly ONE task should be in_progress at any time
+- Mark tasks complete IMMEDIATELY after finishing
+- Remove tasks that are no longer relevant
+- Only mark completed when FULLY accomplished`;
+exports.todoWriteTool = (0, tool_1.buildTool)({
+    name: 'todo_write',
+    description: `Update the todo list for the current session.
+
+${TODO_PROMPT}`,
+    parameters: {
+        type: 'object',
+        properties: {
+            todos: {
+                type: 'string',
+                description: 'JSON array of todos: [{"content":"Task","status":"pending|in_progress|completed","activeForm":"Doing task"}]',
+            },
+        },
+        required: ['todos'],
+    },
+    execute: async (args) => {
+        let todos;
+        try {
+            todos = JSON.parse(args.todos);
+        }
+        catch {
+            return { success: false, output: '', error: 'todos must be valid JSON array' };
+        }
+        if (!Array.isArray(todos)) {
+            return { success: false, output: '', error: 'todos must be an array' };
+        }
+        for (const todo of todos) {
+            if (!todo.content || typeof todo.content !== 'string') {
+                return { success: false, output: '', error: 'Each todo must have a content string' };
+            }
+            if (!todo.activeForm || typeof todo.activeForm !== 'string') {
+                return { success: false, output: '', error: 'Each todo must have an activeForm string' };
+            }
+            if (!['pending', 'in_progress', 'completed'].includes(todo.status)) {
+                return { success: false, output: '', error: `Invalid status: ${todo.status}` };
+            }
+        }
+        const inProgressCount = todos.filter(t => t.status === 'in_progress').length;
+        if (inProgressCount > 1) {
+            return {
+                success: false,
+                output: '',
+                error: 'Only one task can be in_progress at a time',
+            };
+        }
+        (0, tool_state_1.setToolState)({ todos });
+        const lines = [];
+        lines.push('Todo list updated:');
+        lines.push('');
+        for (let i = 0; i < todos.length; i++) {
+            const todo = todos[i];
+            const icon = todo.status === 'completed' ? '✅' : todo.status === 'in_progress' ? '⏳' : '⬚';
+            lines.push(`${i + 1}. [${icon}] ${todo.content}`);
+            if (todo.status === 'in_progress') {
+                lines.push(`   → ${todo.activeForm}`);
+            }
+        }
+        lines.push('');
+        lines.push(`Summary: ${todos.length} tasks, ${todos.filter(t => t.status === 'completed').length} completed, ${inProgressCount} in progress`);
+        return {
+            success: true,
+            output: lines.join('\n'),
+        };
+    },
+    isReadOnly: () => false,
+    checkPermissions: () => {
+        return { behavior: 'allow', reason: 'Todo operations are safe' };
+    },
+    userFacingName: (args) => {
+        try {
+            const todos = JSON.parse(args.todos);
+            return `Update ${todos.length} todos`;
+        }
+        catch {
+            return 'Update todos';
+        }
+    },
+});
+/** Get current todos (for UI display) */
+function getCurrentTodos() {
+    return (0, tool_state_1.getToolState)().todos;
+}
+/** Format todos for display */
+function formatTodosForDisplay(todos) {
+    if (todos.length === 0)
+        return 'No active tasks';
+    const lines = [];
+    lines.push('Tasks:');
+    lines.push('');
+    for (let i = 0; i < todos.length; i++) {
+        const todo = todos[i];
+        const icon = todo.status === 'completed' ? '✅' : todo.status === 'in_progress' ? '⏳' : '⬚';
+        lines.push(`${i + 1}. [${icon}] ${todo.status === 'in_progress' ? todo.activeForm : todo.content}`);
+    }
+    return lines.join('\n');
+}
+exports.TODO_TOOLS = [exports.todoWriteTool];
+//# sourceMappingURL=todo.js.map

package/dist/tools/todo.js.map

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

package/dist/tools/web.d.ts

@@ -0,0 +1,13 @@
+/**
+ * openhorse - Web Tools
+ *
+ * WebFetch: Fetch URL content and process with prompt
+ * WebSearch: Search the web for information
+ */
+import { type OpenHorseTool } from '../framework/tool';
+/** Clear the fetch cache (test helper / debugging) */
+export declare function clearWebFetchCache(): void;
+export declare const webFetchTool: OpenHorseTool;
+export declare const webSearchTool: OpenHorseTool;
+export declare const WEB_TOOLS: OpenHorseTool[];
+//# sourceMappingURL=web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/tools/web.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAiLlE,sDAAsD;AACtD,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AA0BD,eAAO,MAAM,YAAY,EAAE,aA4EzB,CAAC;AAiFH,eAAO,MAAM,aAAa,EAAE,aAqD1B,CAAC;AAMH,eAAO,MAAM,SAAS,EAAE,aAAa,EAAkC,CAAC"}

package/dist/tools/web.js

@@ -0,0 +1,377 @@
+"use strict";
+/**
+ * openhorse - Web Tools
+ *
+ * WebFetch: Fetch URL content and process with prompt
+ * WebSearch: Search the web for information
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WEB_TOOLS = exports.webSearchTool = exports.webFetchTool = void 0;
+exports.clearWebFetchCache = clearWebFetchCache;
+const tool_1 = require("../framework/tool");
+// ============================================================================
+// WebFetch Tool
+// ============================================================================
+/** Preapproved hosts that don't need permission */
+const PREAPPROVED_HOSTS = [
+    'github.com',
+    'docs.google.com',
+    'stackoverflow.com',
+    'npmjs.com',
+    'nodejs.org',
+    'typescriptlang.org',
+    'reactjs.org',
+    'vuejs.org',
+    'python.org',
+    'golang.org',
+    'rust-lang.org',
+    'mdn.mozilla.org',
+    'developer.mozilla.org',
+    'wikipedia.org',
+    'arxiv.org',
+];
+const MAX_MARKDOWN_LENGTH = 100000;
+const FETCH_CACHE_TTL_MS = 15 * 60 * 1000;
+const FETCH_CACHE_MAX_ENTRIES = 50;
+const fetchCache = new Map();
+function cacheGet(url) {
+    const entry = fetchCache.get(url);
+    if (!entry)
+        return null;
+    if (Date.now() - entry.ts > FETCH_CACHE_TTL_MS) {
+        fetchCache.delete(url);
+        return null;
+    }
+    return entry.data;
+}
+function cacheSet(url, data) {
+    // Cap size — drop oldest entry when full
+    if (fetchCache.size >= FETCH_CACHE_MAX_ENTRIES) {
+        const oldest = fetchCache.keys().next().value;
+        if (oldest)
+            fetchCache.delete(oldest);
+    }
+    fetchCache.set(url, { ts: Date.now(), data });
+}
+function isPreapprovedHost(hostname, pathname) {
+    return PREAPPROVED_HOSTS.some(host => hostname === host || hostname.endsWith('.' + host));
+}
+/** Simple HTML to Markdown converter */
+function htmlToMarkdown(html) {
+    let md = html;
+    // Remove script, style, nav, header, footer tags
+    md = md.replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '');
+    md = md.replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '');
+    md = md.replace(/<nav[^>]*>[\s\S]*?<\/nav>/gi, '');
+    md = md.replace(/<header[^>]*>[\s\S]*?<\/header>/gi, '');
+    md = md.replace(/<footer[^>]*>[\s\S]*?<\/footer>/gi, '');
+    // Convert headings
+    md = md.replace(/<h1[^>]*>([\s\S]*?)<\/h1>/gi, '# $1\n\n');
+    md = md.replace(/<h2[^>]*>([\s\S]*?)<\/h2>/gi, '## $1\n\n');
+    md = md.replace(/<h3[^>]*>([\s\S]*?)<\/h3>/gi, '### $1\n\n');
+    md = md.replace(/<h4[^>]*>([\s\S]*?)<\/h4>/gi, '#### $1\n\n');
+    md = md.replace(/<h5[^>]*>([\s\S]*?)<\/h5>/gi, '##### $1\n\n');
+    md = md.replace(/<h6[^>]*>([\s\S]*?)<\/h6>/gi, '###### $1\n\n');
+    // Bold and italic
+    md = md.replace(/<strong[^>]*>([\s\S]*?)<\/strong>/gi, '**$1**');
+    md = md.replace(/<b[^>]*>([\s\S]*?)<\/b>/gi, '**$1**');
+    md = md.replace(/<em[^>]*>([\s\S]*?)<\/em>/gi, '*$1*');
+    md = md.replace(/<i[^>]*>([\s\S]*?)<\/i>/gi, '*$1*');
+    // Links
+    md = md.replace(/<a[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi, '[$2]($1)');
+    // Code blocks
+    md = md.replace(/<pre[^>]*><code[^>]*>([\s\S]*?)<\/code><\/pre>/gi, '\n```\n$1\n```\n');
+    md = md.replace(/<code[^>]*>([\s\S]*?)<\/code>/gi, '`$1`');
+    // Lists
+    md = md.replace(/<li[^>]*>([\s\S]*?)<\/li>/gi, '- $1\n');
+    md = md.replace(/<ul[^>]*>([\s\S]*?)<\/ul>/gi, '$1');
+    md = md.replace(/<ol[^>]*>([\s\S]*?)<\/ol>/gi, '$1');
+    // Paragraphs and divs
+    md = md.replace(/<p[^>]*>([\s\S]*?)<\/p>/gi, '$1\n\n');
+    md = md.replace(/<div[^>]*>([\s\S]*?)<\/div>/gi, '$1\n');
+    md = md.replace(/<br\s*\/?>/gi, '\n');
+    // Remove remaining tags
+    md = md.replace(/<[^>]+>/g, '');
+    // Clean up whitespace
+    md = md.replace(/\n{3,}/g, '\n\n');
+    md = md.trim();
+    return md;
+}
+async function fetchUrl(url) {
+    const cached = cacheGet(url);
+    if (cached)
+        return cached;
+    try {
+        const response = await fetch(url, {
+            headers: {
+                'User-Agent': 'OpenHorse/0.1.4',
+                'Accept': 'text/html,application/xhtml+xml,text/markdown,text/plain,*/*',
+            },
+        });
+        const contentType = response.headers.get('content-type') || 'text/plain';
+        if (!response.ok) {
+            return {
+                content: `HTTP Error ${response.status}: ${response.statusText}`,
+                code: response.status,
+                contentType,
+            };
+        }
+        // Check for redirect to different host
+        if (response.redirected) {
+            const redirectUrl = response.url;
+            const originalHost = new URL(url).hostname;
+            const redirectHost = new URL(redirectUrl).hostname;
+            if (originalHost !== redirectHost) {
+                return {
+                    content: `REDIRECT DETECTED: URL redirects to a different host.\nOriginal: ${url}\nRedirect: ${redirectUrl}\nPlease fetch the redirect URL instead.`,
+                    code: 302,
+                    contentType: 'text/plain',
+                };
+            }
+        }
+        const text = await response.text();
+        // Convert to markdown if HTML
+        let content = text;
+        if (contentType.includes('text/html')) {
+            content = htmlToMarkdown(text);
+        }
+        // Truncate if too large
+        if (content.length > MAX_MARKDOWN_LENGTH) {
+            content = content.slice(0, MAX_MARKDOWN_LENGTH) + '\n\n[... content truncated]';
+        }
+        const result = {
+            content,
+            code: response.status,
+            contentType,
+        };
+        if (response.ok)
+            cacheSet(url, result);
+        return result;
+    }
+    catch (err) {
+        return {
+            content: `Fetch error: ${err.message}`,
+            code: 0,
+            contentType: 'text/plain',
+        };
+    }
+}
+/** Clear the fetch cache (test helper / debugging) */
+function clearWebFetchCache() {
+    fetchCache.clear();
+}
+/** Apply prompt to content using simple extraction */
+function applyPromptToContent(content, prompt) {
+    // For simple prompts, return the content directly
+    const lowerPrompt = prompt.toLowerCase();
+    if (lowerPrompt.includes('title') || lowerPrompt.includes('name')) {
+        // Try to extract title
+        const titleMatch = content.match(/^#\s+(.+)$/m);
+        if (titleMatch) {
+            return `Title: ${titleMatch[1]}\n\n${content}`;
+        }
+    }
+    if (lowerPrompt.includes('summary') || lowerPrompt.includes('summarize')) {
+        // Return first few paragraphs as summary
+        const paragraphs = content.split('\n\n').filter(p => p.length > 50);
+        const summary = paragraphs.slice(0, 3).join('\n\n');
+        return `Summary:\n${summary}\n\n---\n\nFull content:\n${content}`;
+    }
+    // Default: return content with prompt context
+    return `Prompt: "${prompt}"\n\nContent:\n${content}`;
+}
+exports.webFetchTool = (0, tool_1.buildTool)({
+    name: 'web_fetch',
+    description: `Fetch content from a URL and process with a prompt.
+IMPORTANT: WebFetch WILL FAIL for authenticated or private URLs.
+Before using this tool, check if the URL points to an authenticated service (e.g. Google Docs, Confluence, Jira, GitHub).`,
+    parameters: {
+        type: 'object',
+        properties: {
+            url: {
+                type: 'string',
+                description: 'The URL to fetch content from (must be a valid URL)',
+            },
+            prompt: {
+                type: 'string',
+                description: 'The prompt to run on the fetched content (e.g. "extract the title", "summarize the content")',
+            },
+        },
+        required: ['url', 'prompt'],
+    },
+    execute: async (args) => {
+        const url = args.url;
+        const prompt = args.prompt;
+        if (!url || typeof url !== 'string') {
+            return { success: false, output: '', error: 'web_fetch requires a url parameter' };
+        }
+        if (!prompt || typeof prompt !== 'string') {
+            return { success: false, output: '', error: 'web_fetch requires a prompt parameter' };
+        }
+        // Validate URL
+        try {
+            const parsed = new URL(url);
+            if (!parsed.protocol.startsWith('http')) {
+                return { success: false, output: '', error: 'URL must use http or https protocol' };
+            }
+        }
+        catch {
+            return { success: false, output: '', error: `Invalid URL: ${url}` };
+        }
+        const { content, code, contentType } = await fetchUrl(url);
+        if (code !== 200) {
+            return { success: false, output: content, error: `HTTP ${code}` };
+        }
+        const result = applyPromptToContent(content, prompt);
+        return {
+            success: true,
+            output: result,
+        };
+    },
+    isReadOnly: () => true,
+    isConcurrencySafe: () => true,
+    checkPermissions: (args) => {
+        const url = args.url;
+        try {
+            const parsed = new URL(url);
+            if (isPreapprovedHost(parsed.hostname, parsed.pathname)) {
+                return { behavior: 'allow', reason: 'Preapproved host' };
+            }
+        }
+        catch {
+            // Invalid URL - will fail in execute
+        }
+        return { behavior: 'ask', reason: 'Fetching external URL' };
+    },
+    userFacingName: (args) => {
+        try {
+            const url = new URL(args.url);
+            return `Fetch ${url.hostname}`;
+        }
+        catch {
+            return `Fetch ${args.url}`;
+        }
+    },
+});
+// ============================================================================
+// WebSearch Tool
+// ============================================================================
+/** DuckDuckGo search (free, no API key required) */
+async function duckDuckGoSearch(query, limit) {
+    try {
+        const searchUrl = `https://duckduckgo.com/html/?q=${encodeURIComponent(query)}`;
+        const response = await fetch(searchUrl, {
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (compatible; OpenHorse/0.1.4)',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Search failed: HTTP ${response.status}`);
+        }
+        const html = await response.text();
+        const results = [];
+        // Parse search results from HTML
+        const resultRegex = /<a[^>]*class="result__a"[^>]*href="([^"]*)"[^>]*>([^<]*)<\/a>/g;
+        let match;
+        let count = 0;
+        while ((match = resultRegex.exec(html)) !== null && count < limit) {
+            const url = match[1];
+            const title = match[2].trim();
+            // DuckDuckGo redirects through their URL - extract actual URL
+            let actualUrl = url;
+            const uddgMatch = url.match(/uddg=([^&]+)/);
+            if (uddgMatch) {
+                actualUrl = decodeURIComponent(uddgMatch[1]);
+            }
+            results.push({
+                title,
+                url: actualUrl,
+                description: '',
+            });
+            count++;
+        }
+        return results;
+    }
+    catch (err) {
+        throw new Error(`DuckDuckGo search error: ${err.message}`);
+    }
+}
+/** Format search results */
+function formatSearchResults(results, query) {
+    if (results.length === 0) {
+        return `No results found for query: "${query}"`;
+    }
+    const lines = [];
+    lines.push(`Search results for "${query}":`);
+    lines.push('');
+    for (let i = 0; i < results.length; i++) {
+        const r = results[i];
+        lines.push(`${i + 1}. **${r.title}**`);
+        lines.push(`   URL: ${r.url}`);
+        if (r.description) {
+            lines.push(`   ${r.description}`);
+        }
+        lines.push('');
+    }
+    lines.push('Sources:');
+    for (const r of results) {
+        lines.push(`- [${r.title}](${r.url})`);
+    }
+    return lines.join('\n');
+}
+exports.webSearchTool = (0, tool_1.buildTool)({
+    name: 'web_search',
+    description: `Search the web for information using DuckDuckGo.
+Returns search results with titles, URLs, and descriptions.
+You MUST include the Sources section with markdown hyperlinks in your response.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'The search query (minimum 2 characters)',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of results (optional, default 5)',
+            },
+        },
+        required: ['query'],
+    },
+    execute: async (args) => {
+        const query = args.query;
+        const limit = args.limit || 5;
+        if (!query || typeof query !== 'string') {
+            return { success: false, output: '', error: 'web_search requires a query parameter' };
+        }
+        if (query.length < 2) {
+            return { success: false, output: '', error: 'Query must be at least 2 characters' };
+        }
+        try {
+            const results = await duckDuckGoSearch(query, limit);
+            const output = formatSearchResults(results, query);
+            return {
+                success: true,
+                output,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: '',
+                error: err.message,
+            };
+        }
+    },
+    isReadOnly: () => true,
+    isConcurrencySafe: () => true,
+    checkPermissions: () => {
+        return { behavior: 'ask', reason: 'Web search may query external services' };
+    },
+    userFacingName: (args) => `Search "${args.query?.slice(0, 30)}"`,
+});
+// ============================================================================
+// Export
+// ============================================================================
+exports.WEB_TOOLS = [exports.webFetchTool, exports.webSearchTool];
+//# sourceMappingURL=web.js.map