@poncho-ai/harness 0.27.0 → 0.28.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/harness@0.27.0 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
+> @poncho-ai/harness@0.28.0 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
 > node scripts/embed-docs.js && tsup src/index.ts --format esm --dts
 
 [embed-docs] Generated poncho-docs.ts with 4 topics
@@ -8,8 +8,8 @@
 CLI tsup v8.5.1
 CLI Target: es2022
 ESM Build start
-ESM dist/index.js 278.61 KB
-ESM ⚡️ Build success in 148ms
+ESM dist/index.js 284.05 KB
+ESM ⚡️ Build success in 147ms
 DTS Build start
-DTS ⚡️ Build success in 7054ms
-DTS dist/index.d.ts 29.13 KB
+DTS ⚡️ Build success in 7926ms
+DTS dist/index.d.ts 29.26 KB

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @poncho-ai/harness
 
+## 0.28.0
+
+### Minor Changes
+
+- [`c0ca56b`](https://github.com/cesr/poncho-ai/commit/c0ca56b54bb877d96ba8088537d6f1c7461d2a55) Thanks [@cesr](https://github.com/cesr)! - Add built-in `web_search` and `web_fetch` tools so agents can search the web and fetch page content without a browser or API keys. Remove the scaffolded `fetch-page` skill (superseded by `web_fetch`). Fix `browser_open` crash when agent projects have an older `@poncho-ai/browser` installed.
+
 ## 0.27.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -351,6 +351,8 @@ type BuiltInToolToggles = {
     todo_add?: boolean;
     todo_update?: boolean;
     todo_remove?: boolean;
+    web_search?: boolean;
+    web_fetch?: boolean;
 };
 interface MessagingChannelConfig {
     platform: "slack" | "resend" | "telegram";
@@ -738,6 +740,8 @@ declare class LatitudeCapture {
  */
 declare function jsonSchemaToZod(schema: JsonSchema): z.ZodType;
 
+declare const createSearchTools: () => ToolDefinition[];
+
 /**
  * Resolve the full list of skill directories to scan.
  * Merges the defaults with any extra paths provided via config.
@@ -813,4 +817,4 @@ declare class TelemetryEmitter {
 
 declare const createSubagentTools: (manager: SubagentManager) => ToolDefinition[];
 
-export { type AgentFrontmatter, AgentHarness, type AgentIdentity, type AgentLimitsConfig, type AgentModelConfig, type BuiltInToolToggles, type CompactMessagesOptions, type CompactResult, type CompactionConfig, type Conversation, type ConversationState, type ConversationStore, type ConversationSummary, type CronJobConfig, type HarnessOptions, type HarnessRunOutput, InMemoryConversationStore, InMemoryStateStore, LatitudeCapture, type LatitudeCaptureConfig, LocalMcpBridge, LocalUploadStore, type MainMemory, type McpConfig, type MemoryConfig, type MemoryStore, type MessagingChannelConfig, type ModelProviderFactory, PONCHO_UPLOAD_SCHEME, type ParsedAgent, type PendingSubagentResult, type PonchoConfig, type ProviderConfig, type RemoteMcpServerConfig, type RuntimeRenderContext, S3UploadStore, STORAGE_SCHEMA_VERSION, type SkillContextEntry, type SkillMetadata, type StateConfig, type StateProviderName, type StateStore, type StorageConfig, type SubagentManager, type SubagentResult, type SubagentSpawnResult, type SubagentSummary, type TelemetryConfig, TelemetryEmitter, type ToolAccess, type ToolCall, ToolDispatcher, type ToolExecutionResult, type UploadStore, type UploadsConfig, VercelBlobUploadStore, buildAgentDirectoryName, buildSkillContextWindow, compactMessages, createConversationStore, createDefaultTools, createDeleteDirectoryTool, createDeleteTool, createEditTool, createMemoryStore, createMemoryTools, createModelProvider, createSkillTools, createStateStore, createSubagentTools, createUploadStore, createWriteTool, deriveUploadKey, ensureAgentIdentity, estimateTokens, estimateTotalTokens, findSafeSplitPoint, generateAgentId, getAgentStoreDirectory, getModelContextWindow, getPonchoStoreRoot, jsonSchemaToZod, loadPonchoConfig, loadSkillContext, loadSkillInstructions, loadSkillMetadata, normalizeScriptPolicyPath, parseAgentFile, parseAgentMarkdown, ponchoDocsTool, readSkillResource, renderAgentPrompt, resolveAgentIdentity, resolveCompactionConfig, resolveMemoryConfig, resolveSkillDirs, resolveStateConfig, slugifyStorageComponent };
+export { type AgentFrontmatter, AgentHarness, type AgentIdentity, type AgentLimitsConfig, type AgentModelConfig, type BuiltInToolToggles, type CompactMessagesOptions, type CompactResult, type CompactionConfig, type Conversation, type ConversationState, type ConversationStore, type ConversationSummary, type CronJobConfig, type HarnessOptions, type HarnessRunOutput, InMemoryConversationStore, InMemoryStateStore, LatitudeCapture, type LatitudeCaptureConfig, LocalMcpBridge, LocalUploadStore, type MainMemory, type McpConfig, type MemoryConfig, type MemoryStore, type MessagingChannelConfig, type ModelProviderFactory, PONCHO_UPLOAD_SCHEME, type ParsedAgent, type PendingSubagentResult, type PonchoConfig, type ProviderConfig, type RemoteMcpServerConfig, type RuntimeRenderContext, S3UploadStore, STORAGE_SCHEMA_VERSION, type SkillContextEntry, type SkillMetadata, type StateConfig, type StateProviderName, type StateStore, type StorageConfig, type SubagentManager, type SubagentResult, type SubagentSpawnResult, type SubagentSummary, type TelemetryConfig, TelemetryEmitter, type ToolAccess, type ToolCall, ToolDispatcher, type ToolExecutionResult, type UploadStore, type UploadsConfig, VercelBlobUploadStore, buildAgentDirectoryName, buildSkillContextWindow, compactMessages, createConversationStore, createDefaultTools, createDeleteDirectoryTool, createDeleteTool, createEditTool, createMemoryStore, createMemoryTools, createModelProvider, createSearchTools, createSkillTools, createStateStore, createSubagentTools, createUploadStore, createWriteTool, deriveUploadKey, ensureAgentIdentity, estimateTokens, estimateTotalTokens, findSafeSplitPoint, generateAgentId, getAgentStoreDirectory, getModelContextWindow, getPonchoStoreRoot, jsonSchemaToZod, loadPonchoConfig, loadSkillContext, loadSkillInstructions, loadSkillMetadata, normalizeScriptPolicyPath, parseAgentFile, parseAgentMarkdown, ponchoDocsTool, readSkillResource, renderAgentPrompt, resolveAgentIdentity, resolveCompactionConfig, resolveMemoryConfig, resolveSkillDirs, resolveStateConfig, slugifyStorageComponent };

package/dist/index.js

@@ -4258,10 +4258,146 @@ var extractRunnableFunction = (value) => {
   return void 0;
 };
 
-// src/subagent-tools.ts
+// src/search-tools.ts
+import { load as cheerioLoad } from "cheerio";
 import { defineTool as defineTool5 } from "@poncho-ai/sdk";
-var createSubagentTools = (manager) => [
+var SEARCH_UA = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36";
+var FETCH_TIMEOUT_MS = 15e3;
+async function braveSearch(query, maxResults) {
+  const url = `https://search.brave.com/search?q=${encodeURIComponent(query)}`;
+  const res = await fetch(url, {
+    headers: {
+      "User-Agent": SEARCH_UA,
+      Accept: "text/html,application/xhtml+xml",
+      "Accept-Language": "en-US,en;q=0.9"
+    },
+    signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
+  });
+  if (!res.ok) {
+    throw new Error(`Search request failed (${res.status} ${res.statusText})`);
+  }
+  const html = await res.text();
+  return parseBraveResults(html, maxResults);
+}
+function parseBraveResults(html, max) {
+  const $ = cheerioLoad(html);
+  const results = [];
+  $('div.snippet[data-type="web"]').each((_i, el) => {
+    if (results.length >= max) return false;
+    const $el = $(el);
+    const anchor = $el.find(".result-content a").first();
+    const href = anchor.attr("href") ?? "";
+    if (!href.startsWith("http")) return;
+    const title = $el.find(".title").first().text().trim();
+    const snippet = $el.find(".generic-snippet .content").first().text().trim();
+    if (title) {
+      results.push({ title, url: href, snippet });
+    }
+  });
+  return results;
+}
+var DEFAULT_MAX_LENGTH = 16e3;
+function extractReadableText($, maxLength) {
+  const title = $("title").first().text().trim();
+  $("script, style, noscript, nav, footer, header, aside, [role='navigation'], [role='banner'], [role='contentinfo']").remove();
+  $("svg, iframe, form, button, input, select, textarea").remove();
+  let root = $("article").first();
+  if (!root.length) root = $("main").first();
+  if (!root.length) root = $("[role='main']").first();
+  if (!root.length) root = $("body").first();
+  const text = root.text().replace(/[ \t]+/g, " ").replace(/\n{3,}/g, "\n\n").trim();
+  const content = text.length > maxLength ? text.slice(0, maxLength) + "\n\u2026(truncated)" : text;
+  return { title, content };
+}
+var createSearchTools = () => [
+  defineTool5({
+    name: "web_search",
+    description: "Search the web and return a list of results (title, URL, snippet). Use this instead of opening a browser when you need to find information online.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: {
+          type: "string",
+          description: "The search query"
+        },
+        max_results: {
+          type: "number",
+          description: "Maximum number of results to return (1-10, default 5)"
+        }
+      },
+      required: ["query"],
+      additionalProperties: false
+    },
+    handler: async (input) => {
+      const query = typeof input.query === "string" ? input.query.trim() : "";
+      if (!query) {
+        return { error: "A non-empty query string is required." };
+      }
+      const max = Math.min(Math.max(Number(input.max_results) || 5, 1), 10);
+      try {
+        const results = await braveSearch(query, max);
+        if (results.length === 0) {
+          return { query, results: [], note: "No results found. Try rephrasing your query." };
+        }
+        return { query, results };
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+          error: `Search failed: ${msg}`,
+          hint: "The search provider may be rate-limiting requests. Try again shortly, or use browser tools as a fallback."
+        };
+      }
+    }
+  }),
   defineTool5({
+    name: "web_fetch",
+    description: "Fetch a web page and return its text content (HTML tags stripped). Useful for reading articles, documentation, or any web page without opening a browser.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: {
+          type: "string",
+          description: "The URL to fetch"
+        },
+        max_length: {
+          type: "number",
+          description: `Maximum character length of returned content (default ${DEFAULT_MAX_LENGTH})`
+        }
+      },
+      required: ["url"],
+      additionalProperties: false
+    },
+    handler: async (input) => {
+      const url = typeof input.url === "string" ? input.url.trim() : "";
+      if (!url) {
+        return { error: 'A "url" string is required.' };
+      }
+      const maxLength = Math.max(Number(input.max_length) || DEFAULT_MAX_LENGTH, 1e3);
+      try {
+        const res = await fetch(url, {
+          headers: { "User-Agent": SEARCH_UA, Accept: "text/html,application/xhtml+xml" },
+          redirect: "follow",
+          signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
+        });
+        if (!res.ok) {
+          return { url, status: res.status, error: res.statusText };
+        }
+        const html = await res.text();
+        const $ = cheerioLoad(html);
+        const { title, content } = extractReadableText($, maxLength);
+        return { url, status: res.status, title, content };
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { url, error: `Fetch failed: ${msg}` };
+      }
+    }
+  })
+];
+
+// src/subagent-tools.ts
+import { defineTool as defineTool6 } from "@poncho-ai/sdk";
+var createSubagentTools = (manager) => [
+  defineTool6({
     name: "spawn_subagent",
     description: "Spawn a subagent to work on a task in the background. Returns immediately with a subagent ID. The subagent runs independently and its result will be delivered to you as a message in the conversation when it completes.\n\nGuidelines:\n- Spawn all needed subagents in a SINGLE response (they run concurrently), then end your turn with a brief message to the user.\n- Do NOT spawn more subagents in follow-up steps. Wait for results to be delivered before deciding if more work is needed.\n- Prefer doing work yourself for simple or quick tasks. Spawn subagents for substantial, self-contained work.\n- The subagent has no memory of your conversation -- write thorough, self-contained instructions in the task.",
     inputSchema: {
@@ -4293,7 +4429,7 @@ var createSubagentTools = (manager) => [
       return { subagentId, status: "running" };
     }
   }),
-  defineTool5({
+  defineTool6({
     name: "message_subagent",
     description: "Send a follow-up message to a completed or stopped subagent. The subagent restarts in the background and its result will be delivered to you as a message when it completes. Only works when the subagent is not currently running.",
     inputSchema: {
@@ -4321,7 +4457,7 @@ var createSubagentTools = (manager) => [
       return { subagentId: id, status: "running" };
     }
   }),
-  defineTool5({
+  defineTool6({
     name: "stop_subagent",
     description: "Stop a running subagent. The subagent's conversation is preserved but it will stop processing. Use this to cancel work that is no longer needed.",
     inputSchema: {
@@ -4344,7 +4480,7 @@ var createSubagentTools = (manager) => [
       return { message: `Subagent "${subagentId}" has been stopped.` };
     }
   }),
-  defineTool5({
+  defineTool6({
     name: "list_subagents",
     description: "List all subagents that have been spawned in this conversation. Returns each subagent's ID, original task, current status, and message count. Use this to look up subagent IDs before calling message_subagent or stop_subagent.",
     inputSchema: {
@@ -4970,6 +5106,11 @@ var AgentHarness = class _AgentHarness {
     if (this.isToolEnabled("delete_directory")) {
       this.registerIfMissing(createDeleteDirectoryTool(this.workingDir));
     }
+    for (const tool of createSearchTools()) {
+      if (this.isToolEnabled(tool.name)) {
+        this.registerIfMissing(tool);
+      }
+    }
     if (this.environment === "development" && this.isToolEnabled("poncho_docs")) {
       this.registerIfMissing(ponchoDocsTool);
     }
@@ -5455,7 +5596,11 @@ var AgentHarness = class _AgentHarness {
     const session = new browserMod.BrowserSession(sessionId, browserCfg);
     this._browserSession = session;
     const tools = browserMod.createBrowserTools(
-      () => session
+      () => session,
+      // Backward compat: older @poncho-ai/browser versions expect a second
+      // getConversationId callback.  Current versions read from ToolContext
+      // and ignore extra args.
+      () => "__default__"
     );
     for (const tool of tools) {
       if (this.isToolEnabled(tool.name)) {
@@ -7782,7 +7927,7 @@ var TelemetryEmitter = class {
 };
 
 // src/index.ts
-import { defineTool as defineTool6 } from "@poncho-ai/sdk";
+import { defineTool as defineTool7 } from "@poncho-ai/sdk";
 export {
   AgentHarness,
   InMemoryConversationStore,
@@ -7807,12 +7952,13 @@ export {
   createMemoryStore,
   createMemoryTools,
   createModelProvider,
+  createSearchTools,
   createSkillTools,
   createStateStore,
   createSubagentTools,
   createUploadStore,
   createWriteTool,
-  defineTool6 as defineTool,
+  defineTool7 as defineTool,
   deriveUploadKey,
   ensureAgentIdentity,
   estimateTokens,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poncho-ai/harness",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "Agent execution runtime - conversation loop, tool dispatch, streaming",
   "repository": {
     "type": "git",
@@ -26,6 +26,7 @@
     "@latitude-data/telemetry": "^2.0.4",
     "@opentelemetry/api": "1.9.0",
     "ai": "^6.0.86",
+    "cheerio": "^1.2.0",
     "jiti": "^2.6.1",
     "mustache": "^4.2.0",
     "redis": "^5.10.0",

package/src/config.ts

@@ -46,6 +46,8 @@ export type BuiltInToolToggles = {
   todo_add?: boolean;
   todo_update?: boolean;
   todo_remove?: boolean;
+  web_search?: boolean;
+  web_fetch?: boolean;
 };
 
 export interface MessagingChannelConfig {

package/src/harness.ts

@@ -32,6 +32,7 @@ import { addPromptCacheBreakpoints } from "./prompt-cache.js";
 import { jsonSchemaToZod } from "./schema-converter.js";
 import type { SkillMetadata } from "./skill-context.js";
 import { createSkillTools, normalizeScriptPolicyPath } from "./skill-tools.js";
+import { createSearchTools } from "./search-tools.js";
 import { createSubagentTools } from "./subagent-tools.js";
 import type { SubagentManager } from "./subagent-manager.js";
 import { LatitudeTelemetry } from "@latitude-data/telemetry";
@@ -562,7 +563,7 @@ export class AgentHarness {
   private insideTelemetryCapture = false;
   private _browserSession?: unknown;
   private _browserMod?: {
-    createBrowserTools: (getSession: () => unknown) => ToolDefinition[];
+    createBrowserTools: (getSession: () => unknown, getConversationId?: () => string) => ToolDefinition[];
     BrowserSession: new (sessionId: string, config: Record<string, unknown>) => unknown;
   };
 
@@ -644,6 +645,11 @@ export class AgentHarness {
     if (this.isToolEnabled("delete_directory")) {
       this.registerIfMissing(createDeleteDirectoryTool(this.workingDir));
     }
+    for (const tool of createSearchTools()) {
+      if (this.isToolEnabled(tool.name)) {
+        this.registerIfMissing(tool);
+      }
+    }
     if (this.environment === "development" && this.isToolEnabled("poncho_docs")) {
       this.registerIfMissing(ponchoDocsTool);
     }
@@ -1161,7 +1167,7 @@ export class AgentHarness {
   private async initBrowserTools(config: PonchoConfig): Promise<void> {
     const spec = ["@poncho-ai", "browser"].join("/");
     let browserMod: {
-      createBrowserTools: (getSession: () => unknown) => ToolDefinition[];
+      createBrowserTools: (getSession: () => unknown, getConversationId?: () => string) => ToolDefinition[];
       BrowserSession: new (sessionId: string, cfg?: Record<string, unknown>) => unknown;
     };
     try {
@@ -1205,6 +1211,10 @@ export class AgentHarness {
 
     const tools = browserMod.createBrowserTools(
       () => session,
+      // Backward compat: older @poncho-ai/browser versions expect a second
+      // getConversationId callback.  Current versions read from ToolContext
+      // and ignore extra args.
+      () => "__default__",
     );
     for (const tool of tools) {
       if (this.isToolEnabled(tool.name)) {

package/src/index.ts

@@ -9,6 +9,7 @@ export * from "./memory.js";
 export * from "./mcp.js";
 export * from "./model-factory.js";
 export * from "./schema-converter.js";
+export * from "./search-tools.js";
 export * from "./skill-context.js";
 export * from "./skill-tools.js";
 export * from "./state.js";

package/src/search-tools.ts

@@ -0,0 +1,181 @@
+import { load as cheerioLoad, type CheerioAPI } from "cheerio";
+import { defineTool, type ToolDefinition } from "@poncho-ai/sdk";
+
+const SEARCH_UA =
+  "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36";
+
+const FETCH_TIMEOUT_MS = 15_000;
+
+// ---------------------------------------------------------------------------
+// web_search — Brave Search HTML scraping (no API key)
+// ---------------------------------------------------------------------------
+
+interface SearchResult {
+  title: string;
+  url: string;
+  snippet: string;
+}
+
+async function braveSearch(query: string, maxResults: number): Promise<SearchResult[]> {
+  const url = `https://search.brave.com/search?q=${encodeURIComponent(query)}`;
+  const res = await fetch(url, {
+    headers: {
+      "User-Agent": SEARCH_UA,
+      Accept: "text/html,application/xhtml+xml",
+      "Accept-Language": "en-US,en;q=0.9",
+    },
+    signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+  });
+  if (!res.ok) {
+    throw new Error(`Search request failed (${res.status} ${res.statusText})`);
+  }
+  const html = await res.text();
+  return parseBraveResults(html, maxResults);
+}
+
+function parseBraveResults(html: string, max: number): SearchResult[] {
+  const $ = cheerioLoad(html);
+  const results: SearchResult[] = [];
+
+  $('div.snippet[data-type="web"]').each((_i, el) => {
+    if (results.length >= max) return false;
+
+    const $el = $(el);
+    const anchor = $el.find(".result-content a").first();
+    const href = anchor.attr("href") ?? "";
+    if (!href.startsWith("http")) return;
+
+    const title = $el.find(".title").first().text().trim();
+    const snippet = $el.find(".generic-snippet .content").first().text().trim();
+
+    if (title) {
+      results.push({ title, url: href, snippet });
+    }
+  });
+
+  return results;
+}
+
+// ---------------------------------------------------------------------------
+// web_fetch — fetch a URL and extract readable text via cheerio
+// ---------------------------------------------------------------------------
+
+const DEFAULT_MAX_LENGTH = 16_000;
+
+function extractReadableText($: CheerioAPI, maxLength: number): { title: string; content: string } {
+  const title = $("title").first().text().trim();
+
+  $("script, style, noscript, nav, footer, header, aside, [role='navigation'], [role='banner'], [role='contentinfo']").remove();
+  $("svg, iframe, form, button, input, select, textarea").remove();
+
+  let root = $("article").first();
+  if (!root.length) root = $("main").first();
+  if (!root.length) root = $("[role='main']").first();
+  if (!root.length) root = $("body").first();
+
+  const text = root
+    .text()
+    .replace(/[ \t]+/g, " ")
+    .replace(/\n{3,}/g, "\n\n")
+    .trim();
+
+  const content =
+    text.length > maxLength ? text.slice(0, maxLength) + "\n…(truncated)" : text;
+
+  return { title, content };
+}
+
+// ---------------------------------------------------------------------------
+// Tool definitions
+// ---------------------------------------------------------------------------
+
+export const createSearchTools = (): ToolDefinition[] => [
+  defineTool({
+    name: "web_search",
+    description:
+      "Search the web and return a list of results (title, URL, snippet). " +
+      "Use this instead of opening a browser when you need to find information online.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: {
+          type: "string",
+          description: "The search query",
+        },
+        max_results: {
+          type: "number",
+          description: "Maximum number of results to return (1-10, default 5)",
+        },
+      },
+      required: ["query"],
+      additionalProperties: false,
+    },
+    handler: async (input) => {
+      const query = typeof input.query === "string" ? input.query.trim() : "";
+      if (!query) {
+        return { error: "A non-empty query string is required." };
+      }
+      const max = Math.min(Math.max(Number(input.max_results) || 5, 1), 10);
+      try {
+        const results = await braveSearch(query, max);
+        if (results.length === 0) {
+          return { query, results: [], note: "No results found. Try rephrasing your query." };
+        }
+        return { query, results };
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+          error: `Search failed: ${msg}`,
+          hint: "The search provider may be rate-limiting requests. Try again shortly, or use browser tools as a fallback.",
+        };
+      }
+    },
+  }),
+
+  defineTool({
+    name: "web_fetch",
+    description:
+      "Fetch a web page and return its text content (HTML tags stripped). " +
+      "Useful for reading articles, documentation, or any web page without opening a browser.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: {
+          type: "string",
+          description: "The URL to fetch",
+        },
+        max_length: {
+          type: "number",
+          description: `Maximum character length of returned content (default ${DEFAULT_MAX_LENGTH})`,
+        },
+      },
+      required: ["url"],
+      additionalProperties: false,
+    },
+    handler: async (input) => {
+      const url = typeof input.url === "string" ? input.url.trim() : "";
+      if (!url) {
+        return { error: 'A "url" string is required.' };
+      }
+      const maxLength = Math.max(Number(input.max_length) || DEFAULT_MAX_LENGTH, 1_000);
+
+      try {
+        const res = await fetch(url, {
+          headers: { "User-Agent": SEARCH_UA, Accept: "text/html,application/xhtml+xml" },
+          redirect: "follow",
+          signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+        });
+        if (!res.ok) {
+          return { url, status: res.status, error: res.statusText };
+        }
+        const html = await res.text();
+        const $ = cheerioLoad(html);
+        const { title, content } = extractReadableText($, maxLength);
+        return { url, status: res.status, title, content };
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { url, error: `Fetch failed: ${msg}` };
+      }
+    },
+  }),
+];