@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/core/tools/truncate.js

@@ -0,0 +1,215 @@
+/**
+ * Shared truncation utilities for tool outputs.
+ *
+ * Truncation is based on two independent limits - whichever is hit first wins:
+ * - Line limit (default: 2000 lines)
+ * - Byte limit (default: 50KB)
+ *
+ * Never returns partial lines (except bash tail truncation edge case).
+ */
+export const DEFAULT_MAX_LINES = 2000;
+export const DEFAULT_MAX_BYTES = 50 * 1024; // 50KB
+export const GREP_MAX_LINE_LENGTH = 500; // Max chars per grep match line
+function splitLinesForCounting(content) {
+    if (content.length === 0) {
+        return [];
+    }
+    const lines = content.split("\n");
+    if (content.endsWith("\n")) {
+        lines.pop();
+    }
+    return lines;
+}
+/**
+ * Format bytes as human-readable size.
+ */
+export function formatSize(bytes) {
+    if (bytes < 1024) {
+        return `${bytes}B`;
+    }
+    else if (bytes < 1024 * 1024) {
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    }
+    else {
+        return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+    }
+}
+/**
+ * Truncate content from the head (keep first N lines/bytes).
+ * Suitable for file reads where you want to see the beginning.
+ *
+ * Never returns partial lines. If first line exceeds byte limit,
+ * returns empty content with firstLineExceedsLimit=true.
+ */
+export function truncateHead(content, options = {}) {
+    const maxLines = options.maxLines ?? DEFAULT_MAX_LINES;
+    const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+    const totalBytes = Buffer.byteLength(content, "utf-8");
+    const lines = splitLinesForCounting(content);
+    const totalLines = lines.length;
+    // Check if no truncation needed
+    if (totalLines <= maxLines && totalBytes <= maxBytes) {
+        return {
+            content,
+            truncated: false,
+            truncatedBy: null,
+            totalLines,
+            totalBytes,
+            outputLines: totalLines,
+            outputBytes: totalBytes,
+            lastLinePartial: false,
+            firstLineExceedsLimit: false,
+            maxLines,
+            maxBytes,
+        };
+    }
+    // Check if first line alone exceeds byte limit
+    const firstLineBytes = Buffer.byteLength(lines[0], "utf-8");
+    if (firstLineBytes > maxBytes) {
+        return {
+            content: "",
+            truncated: true,
+            truncatedBy: "bytes",
+            totalLines,
+            totalBytes,
+            outputLines: 0,
+            outputBytes: 0,
+            lastLinePartial: false,
+            firstLineExceedsLimit: true,
+            maxLines,
+            maxBytes,
+        };
+    }
+    // Collect complete lines that fit
+    const outputLinesArr = [];
+    let outputBytesCount = 0;
+    let truncatedBy = "lines";
+    for (let i = 0; i < lines.length && i < maxLines; i++) {
+        const line = lines[i];
+        const lineBytes = Buffer.byteLength(line, "utf-8") + (i > 0 ? 1 : 0); // +1 for newline
+        if (outputBytesCount + lineBytes > maxBytes) {
+            truncatedBy = "bytes";
+            break;
+        }
+        outputLinesArr.push(line);
+        outputBytesCount += lineBytes;
+    }
+    // If we exited due to line limit
+    if (outputLinesArr.length >= maxLines && outputBytesCount <= maxBytes) {
+        truncatedBy = "lines";
+    }
+    const outputContent = outputLinesArr.join("\n");
+    const finalOutputBytes = Buffer.byteLength(outputContent, "utf-8");
+    return {
+        content: outputContent,
+        truncated: true,
+        truncatedBy,
+        totalLines,
+        totalBytes,
+        outputLines: outputLinesArr.length,
+        outputBytes: finalOutputBytes,
+        lastLinePartial: false,
+        firstLineExceedsLimit: false,
+        maxLines,
+        maxBytes,
+    };
+}
+/**
+ * Truncate content from the tail (keep last N lines/bytes).
+ * Suitable for bash output where you want to see the end (errors, final results).
+ *
+ * May return partial first line if the last line of original content exceeds byte limit.
+ */
+export function truncateTail(content, options = {}) {
+    const maxLines = options.maxLines ?? DEFAULT_MAX_LINES;
+    const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+    const totalBytes = Buffer.byteLength(content, "utf-8");
+    const lines = splitLinesForCounting(content);
+    const totalLines = lines.length;
+    // Check if no truncation needed
+    if (totalLines <= maxLines && totalBytes <= maxBytes) {
+        return {
+            content,
+            truncated: false,
+            truncatedBy: null,
+            totalLines,
+            totalBytes,
+            outputLines: totalLines,
+            outputBytes: totalBytes,
+            lastLinePartial: false,
+            firstLineExceedsLimit: false,
+            maxLines,
+            maxBytes,
+        };
+    }
+    // Work backwards from the end
+    const outputLinesArr = [];
+    let outputBytesCount = 0;
+    let truncatedBy = "lines";
+    let lastLinePartial = false;
+    for (let i = lines.length - 1; i >= 0 && outputLinesArr.length < maxLines; i--) {
+        const line = lines[i];
+        const lineBytes = Buffer.byteLength(line, "utf-8") + (outputLinesArr.length > 0 ? 1 : 0); // +1 for newline
+        if (outputBytesCount + lineBytes > maxBytes) {
+            truncatedBy = "bytes";
+            // Edge case: if we haven't added ANY lines yet and this line exceeds maxBytes,
+            // take the end of the line (partial)
+            if (outputLinesArr.length === 0) {
+                const truncatedLine = truncateStringToBytesFromEnd(line, maxBytes);
+                outputLinesArr.unshift(truncatedLine);
+                outputBytesCount = Buffer.byteLength(truncatedLine, "utf-8");
+                lastLinePartial = true;
+            }
+            break;
+        }
+        outputLinesArr.unshift(line);
+        outputBytesCount += lineBytes;
+    }
+    // If we exited due to line limit
+    if (outputLinesArr.length >= maxLines && outputBytesCount <= maxBytes) {
+        truncatedBy = "lines";
+    }
+    const outputContent = outputLinesArr.join("\n");
+    const finalOutputBytes = Buffer.byteLength(outputContent, "utf-8");
+    return {
+        content: outputContent,
+        truncated: true,
+        truncatedBy,
+        totalLines,
+        totalBytes,
+        outputLines: outputLinesArr.length,
+        outputBytes: finalOutputBytes,
+        lastLinePartial,
+        firstLineExceedsLimit: false,
+        maxLines,
+        maxBytes,
+    };
+}
+/**
+ * Truncate a string to fit within a byte limit (from the end).
+ * Handles multi-byte UTF-8 characters correctly.
+ */
+function truncateStringToBytesFromEnd(str, maxBytes) {
+    const buf = Buffer.from(str, "utf-8");
+    if (buf.length <= maxBytes) {
+        return str;
+    }
+    // Start from the end, skip maxBytes back
+    let start = buf.length - maxBytes;
+    // Find a valid UTF-8 boundary (start of a character)
+    while (start < buf.length && (buf[start] & 0xc0) === 0x80) {
+        start++;
+    }
+    return buf.slice(start).toString("utf-8");
+}
+/**
+ * Truncate a single line to max characters, adding [truncated] suffix.
+ * Used for grep match lines.
+ */
+export function truncateLine(line, maxChars = GREP_MAX_LINE_LENGTH) {
+    if (line.length <= maxChars) {
+        return { text: line, wasTruncated: false };
+    }
+    return { text: `${line.slice(0, maxChars)}... [truncated]`, wasTruncated: true };
+}
+//# sourceMappingURL=truncate.js.map

package/dist/core/tools/truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../../src/core/tools/truncate.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared truncation utilities for tool outputs.\n *\n * Truncation is based on two independent limits - whichever is hit first wins:\n * - Line limit (default: 2000 lines)\n * - Byte limit (default: 50KB)\n *\n * Never returns partial lines (except bash tail truncation edge case).\n */\n\nexport const DEFAULT_MAX_LINES = 2000;\nexport const DEFAULT_MAX_BYTES = 50 * 1024; // 50KB\nexport const GREP_MAX_LINE_LENGTH = 500; // Max chars per grep match line\n\nexport interface TruncationResult {\n\t/** The truncated content */\n\tcontent: string;\n\t/** Whether truncation occurred */\n\ttruncated: boolean;\n\t/** Which limit was hit: \"lines\", \"bytes\", or null if not truncated */\n\ttruncatedBy: \"lines\" | \"bytes\" | null;\n\t/** Total number of lines in the original content */\n\ttotalLines: number;\n\t/** Total number of bytes in the original content */\n\ttotalBytes: number;\n\t/** Number of complete lines in the truncated output */\n\toutputLines: number;\n\t/** Number of bytes in the truncated output */\n\toutputBytes: number;\n\t/** Whether the last line was partially truncated (only for tail truncation edge case) */\n\tlastLinePartial: boolean;\n\t/** Whether the first line exceeded the byte limit (for head truncation) */\n\tfirstLineExceedsLimit: boolean;\n\t/** The max lines limit that was applied */\n\tmaxLines: number;\n\t/** The max bytes limit that was applied */\n\tmaxBytes: number;\n}\n\nexport interface TruncationOptions {\n\t/** Maximum number of lines (default: 2000) */\n\tmaxLines?: number;\n\t/** Maximum number of bytes (default: 50KB) */\n\tmaxBytes?: number;\n}\n\nfunction splitLinesForCounting(content: string): string[] {\n\tif (content.length === 0) {\n\t\treturn [];\n\t}\n\tconst lines = content.split(\"\\n\");\n\tif (content.endsWith(\"\\n\")) {\n\t\tlines.pop();\n\t}\n\treturn lines;\n}\n\n/**\n * Format bytes as human-readable size.\n */\nexport function formatSize(bytes: number): string {\n\tif (bytes < 1024) {\n\t\treturn `${bytes}B`;\n\t} else if (bytes < 1024 * 1024) {\n\t\treturn `${(bytes / 1024).toFixed(1)}KB`;\n\t} else {\n\t\treturn `${(bytes / (1024 * 1024)).toFixed(1)}MB`;\n\t}\n}\n\n/**\n * Truncate content from the head (keep first N lines/bytes).\n * Suitable for file reads where you want to see the beginning.\n *\n * Never returns partial lines. If first line exceeds byte limit,\n * returns empty content with firstLineExceedsLimit=true.\n */\nexport function truncateHead(content: string, options: TruncationOptions = {}): TruncationResult {\n\tconst maxLines = options.maxLines ?? DEFAULT_MAX_LINES;\n\tconst maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;\n\n\tconst totalBytes = Buffer.byteLength(content, \"utf-8\");\n\tconst lines = splitLinesForCounting(content);\n\tconst totalLines = lines.length;\n\n\t// Check if no truncation needed\n\tif (totalLines <= maxLines && totalBytes <= maxBytes) {\n\t\treturn {\n\t\t\tcontent,\n\t\t\ttruncated: false,\n\t\t\ttruncatedBy: null,\n\t\t\ttotalLines,\n\t\t\ttotalBytes,\n\t\t\toutputLines: totalLines,\n\t\t\toutputBytes: totalBytes,\n\t\t\tlastLinePartial: false,\n\t\t\tfirstLineExceedsLimit: false,\n\t\t\tmaxLines,\n\t\t\tmaxBytes,\n\t\t};\n\t}\n\n\t// Check if first line alone exceeds byte limit\n\tconst firstLineBytes = Buffer.byteLength(lines[0], \"utf-8\");\n\tif (firstLineBytes > maxBytes) {\n\t\treturn {\n\t\t\tcontent: \"\",\n\t\t\ttruncated: true,\n\t\t\ttruncatedBy: \"bytes\",\n\t\t\ttotalLines,\n\t\t\ttotalBytes,\n\t\t\toutputLines: 0,\n\t\t\toutputBytes: 0,\n\t\t\tlastLinePartial: false,\n\t\t\tfirstLineExceedsLimit: true,\n\t\t\tmaxLines,\n\t\t\tmaxBytes,\n\t\t};\n\t}\n\n\t// Collect complete lines that fit\n\tconst outputLinesArr: string[] = [];\n\tlet outputBytesCount = 0;\n\tlet truncatedBy: \"lines\" | \"bytes\" = \"lines\";\n\n\tfor (let i = 0; i < lines.length && i < maxLines; i++) {\n\t\tconst line = lines[i];\n\t\tconst lineBytes = Buffer.byteLength(line, \"utf-8\") + (i > 0 ? 1 : 0); // +1 for newline\n\n\t\tif (outputBytesCount + lineBytes > maxBytes) {\n\t\t\ttruncatedBy = \"bytes\";\n\t\t\tbreak;\n\t\t}\n\n\t\toutputLinesArr.push(line);\n\t\toutputBytesCount += lineBytes;\n\t}\n\n\t// If we exited due to line limit\n\tif (outputLinesArr.length >= maxLines && outputBytesCount <= maxBytes) {\n\t\ttruncatedBy = \"lines\";\n\t}\n\n\tconst outputContent = outputLinesArr.join(\"\\n\");\n\tconst finalOutputBytes = Buffer.byteLength(outputContent, \"utf-8\");\n\n\treturn {\n\t\tcontent: outputContent,\n\t\ttruncated: true,\n\t\ttruncatedBy,\n\t\ttotalLines,\n\t\ttotalBytes,\n\t\toutputLines: outputLinesArr.length,\n\t\toutputBytes: finalOutputBytes,\n\t\tlastLinePartial: false,\n\t\tfirstLineExceedsLimit: false,\n\t\tmaxLines,\n\t\tmaxBytes,\n\t};\n}\n\n/**\n * Truncate content from the tail (keep last N lines/bytes).\n * Suitable for bash output where you want to see the end (errors, final results).\n *\n * May return partial first line if the last line of original content exceeds byte limit.\n */\nexport function truncateTail(content: string, options: TruncationOptions = {}): TruncationResult {\n\tconst maxLines = options.maxLines ?? DEFAULT_MAX_LINES;\n\tconst maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;\n\n\tconst totalBytes = Buffer.byteLength(content, \"utf-8\");\n\tconst lines = splitLinesForCounting(content);\n\tconst totalLines = lines.length;\n\n\t// Check if no truncation needed\n\tif (totalLines <= maxLines && totalBytes <= maxBytes) {\n\t\treturn {\n\t\t\tcontent,\n\t\t\ttruncated: false,\n\t\t\ttruncatedBy: null,\n\t\t\ttotalLines,\n\t\t\ttotalBytes,\n\t\t\toutputLines: totalLines,\n\t\t\toutputBytes: totalBytes,\n\t\t\tlastLinePartial: false,\n\t\t\tfirstLineExceedsLimit: false,\n\t\t\tmaxLines,\n\t\t\tmaxBytes,\n\t\t};\n\t}\n\n\t// Work backwards from the end\n\tconst outputLinesArr: string[] = [];\n\tlet outputBytesCount = 0;\n\tlet truncatedBy: \"lines\" | \"bytes\" = \"lines\";\n\tlet lastLinePartial = false;\n\n\tfor (let i = lines.length - 1; i >= 0 && outputLinesArr.length < maxLines; i--) {\n\t\tconst line = lines[i];\n\t\tconst lineBytes = Buffer.byteLength(line, \"utf-8\") + (outputLinesArr.length > 0 ? 1 : 0); // +1 for newline\n\n\t\tif (outputBytesCount + lineBytes > maxBytes) {\n\t\t\ttruncatedBy = \"bytes\";\n\t\t\t// Edge case: if we haven't added ANY lines yet and this line exceeds maxBytes,\n\t\t\t// take the end of the line (partial)\n\t\t\tif (outputLinesArr.length === 0) {\n\t\t\t\tconst truncatedLine = truncateStringToBytesFromEnd(line, maxBytes);\n\t\t\t\toutputLinesArr.unshift(truncatedLine);\n\t\t\t\toutputBytesCount = Buffer.byteLength(truncatedLine, \"utf-8\");\n\t\t\t\tlastLinePartial = true;\n\t\t\t}\n\t\t\tbreak;\n\t\t}\n\n\t\toutputLinesArr.unshift(line);\n\t\toutputBytesCount += lineBytes;\n\t}\n\n\t// If we exited due to line limit\n\tif (outputLinesArr.length >= maxLines && outputBytesCount <= maxBytes) {\n\t\ttruncatedBy = \"lines\";\n\t}\n\n\tconst outputContent = outputLinesArr.join(\"\\n\");\n\tconst finalOutputBytes = Buffer.byteLength(outputContent, \"utf-8\");\n\n\treturn {\n\t\tcontent: outputContent,\n\t\ttruncated: true,\n\t\ttruncatedBy,\n\t\ttotalLines,\n\t\ttotalBytes,\n\t\toutputLines: outputLinesArr.length,\n\t\toutputBytes: finalOutputBytes,\n\t\tlastLinePartial,\n\t\tfirstLineExceedsLimit: false,\n\t\tmaxLines,\n\t\tmaxBytes,\n\t};\n}\n\n/**\n * Truncate a string to fit within a byte limit (from the end).\n * Handles multi-byte UTF-8 characters correctly.\n */\nfunction truncateStringToBytesFromEnd(str: string, maxBytes: number): string {\n\tconst buf = Buffer.from(str, \"utf-8\");\n\tif (buf.length <= maxBytes) {\n\t\treturn str;\n\t}\n\n\t// Start from the end, skip maxBytes back\n\tlet start = buf.length - maxBytes;\n\n\t// Find a valid UTF-8 boundary (start of a character)\n\twhile (start < buf.length && (buf[start] & 0xc0) === 0x80) {\n\t\tstart++;\n\t}\n\n\treturn buf.slice(start).toString(\"utf-8\");\n}\n\n/**\n * Truncate a single line to max characters, adding [truncated] suffix.\n * Used for grep match lines.\n */\nexport function truncateLine(\n\tline: string,\n\tmaxChars: number = GREP_MAX_LINE_LENGTH,\n): { text: string; wasTruncated: boolean } {\n\tif (line.length <= maxChars) {\n\t\treturn { text: line, wasTruncated: false };\n\t}\n\treturn { text: `${line.slice(0, maxChars)}... [truncated]`, wasTruncated: true };\n}\n"]}

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

@@ -0,0 +1,69 @@
+import type { AgentTool } from "@hansjm10/volt-agent-core";
+import type { Api, Model } from "@hansjm10/volt-ai";
+import { type Static, Type } from "typebox";
+import type { ToolDefinition } from "../extensions/types.ts";
+import { type TruncationResult } from "./truncate.ts";
+/** auth.json provider slot for a stored Brave Search API key. */
+export declare const BRAVE_SEARCH_AUTH_PROVIDER = "brave-search";
+declare const webSearchSchema: Type.TObject<{
+    query: Type.TString;
+    limit: Type.TOptional<Type.TNumber>;
+    domains: Type.TOptional<Type.TArray<Type.TString>>;
+    recencyDays: Type.TOptional<Type.TNumber>;
+}>;
+export type WebSearchToolInput = Static<typeof webSearchSchema>;
+export interface WebSearchRequest {
+    query: string;
+    limit: number;
+    domains?: string[];
+    recencyDays?: number;
+}
+export interface WebSearchResult {
+    title: string;
+    url: string;
+    snippet?: string;
+    source?: string;
+    publishedAt?: string;
+}
+export interface WebSearchResponse {
+    provider: string;
+    query?: string;
+    results: WebSearchResult[];
+    content?: string;
+}
+export interface WebSearchToolDetails {
+    query: string;
+    submittedQuery?: string;
+    provider: string;
+    results: WebSearchResult[];
+    resultLimitReached?: number;
+    truncation?: TruncationResult;
+}
+export interface WebSearchOperations {
+    search: (request: WebSearchRequest, signal?: AbortSignal) => Promise<WebSearchResponse> | WebSearchResponse;
+}
+export type WebSearchFetcher = (input: string, init: RequestInit) => Promise<Response>;
+export interface WebSearchModelContext {
+    model: Model<Api>;
+    apiKey?: string;
+    headers?: Record<string, string>;
+    sessionId?: string;
+}
+export type WebSearchModelContextProvider = () => Promise<WebSearchModelContext | undefined> | WebSearchModelContext | undefined;
+export interface DefaultWebSearchOperationsOptions {
+    env?: Record<string, string | undefined>;
+    fetcher?: WebSearchFetcher;
+    modelContext?: WebSearchModelContextProvider;
+    timeoutMs?: number;
+    now?: () => Date;
+    /** Stored Brave key fallback used when BRAVE_SEARCH_API_KEY is not set. */
+    fallbackBraveApiKey?: () => Promise<string | undefined> | string | undefined;
+}
+export interface WebSearchToolOptions {
+    operations?: WebSearchOperations;
+}
+export declare function createDefaultWebSearchOperations(options?: DefaultWebSearchOperationsOptions): WebSearchOperations;
+export declare function createWebSearchToolDefinition(_cwd: string, options?: WebSearchToolOptions): ToolDefinition<typeof webSearchSchema, WebSearchToolDetails>;
+export declare function createWebSearchTool(cwd: string, options?: WebSearchToolOptions): AgentTool<typeof webSearchSchema>;
+export {};
+//# sourceMappingURL=web-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../../src/core/tools/web-search.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@hansjm10/volt-agent-core\";\nimport type { Api, Model } from \"@hansjm10/volt-ai\";\nimport { Text } from \"@hansjm10/volt-tui\";\nimport { type Static, Type } from \"typebox\";\nimport { VERSION } from \"../../config.ts\";\nimport { keyHint } from \"../../modes/interactive/components/keybinding-hints.ts\";\nimport { getVoltUserAgent } from \"../../utils/volt-user-agent.ts\";\nimport type { ToolDefinition, ToolRenderResultOptions } from \"../extensions/types.ts\";\nimport type { Theme } from \"../theme/runtime.ts\";\nimport { getTextOutput, invalidArgText, str } from \"./render-utils.ts\";\nimport { wrapToolDefinition } from \"./tool-definition-wrapper.ts\";\nimport { DEFAULT_MAX_BYTES, formatSize, type TruncationResult, truncateHead } from \"./truncate.ts\";\n\nconst DEFAULT_LIMIT = 5;\nconst MAX_LIMIT = 10;\nconst DEFAULT_TIMEOUT_MS = 20_000;\nconst MAX_DOMAINS = 10;\nconst DEFAULT_CODEX_BASE_URL = \"https://chatgpt.com/backend-api\";\n\n/** auth.json provider slot for a stored Brave Search API key. */\nexport const BRAVE_SEARCH_AUTH_PROVIDER = \"brave-search\";\nconst JWT_CLAIM_PATH = \"https://api.openai.com/auth\";\n\nconst webSearchSchema = Type.Object({\n\tquery: Type.String({\n\t\tdescription: \"Web search query. Use a concise natural-language query or exact phrase.\",\n\t\tminLength: 1,\n\t\tmaxLength: 400,\n\t}),\n\tlimit: Type.Optional(\n\t\tType.Number({\n\t\t\tdescription: `Maximum number of results to return (default: ${DEFAULT_LIMIT}, max: ${MAX_LIMIT})`,\n\t\t}),\n\t),\n\tdomains: Type.Optional(\n\t\tType.Array(Type.String({ minLength: 1 }), {\n\t\t\tdescription: \"Optional domains to restrict results to, e.g. ['docs.rs', 'github.com'].\",\n\t\t\tmaxItems: MAX_DOMAINS,\n\t\t}),\n\t),\n\trecencyDays: Type.Optional(\n\t\tType.Number({ description: \"Only return results from the last N days when the backend supports freshness.\" }),\n\t),\n});\n\nexport type WebSearchToolInput = Static<typeof webSearchSchema>;\n\nexport interface WebSearchRequest {\n\tquery: string;\n\tlimit: number;\n\tdomains?: string[];\n\trecencyDays?: number;\n}\n\nexport interface WebSearchResult {\n\ttitle: string;\n\turl: string;\n\tsnippet?: string;\n\tsource?: string;\n\tpublishedAt?: string;\n}\n\nexport interface WebSearchResponse {\n\tprovider: string;\n\tquery?: string;\n\tresults: WebSearchResult[];\n\tcontent?: string;\n}\n\nexport interface WebSearchToolDetails {\n\tquery: string;\n\tsubmittedQuery?: string;\n\tprovider: string;\n\tresults: WebSearchResult[];\n\tresultLimitReached?: number;\n\ttruncation?: TruncationResult;\n}\n\nexport interface WebSearchOperations {\n\tsearch: (request: WebSearchRequest, signal?: AbortSignal) => Promise<WebSearchResponse> | WebSearchResponse;\n}\n\nexport type WebSearchFetcher = (input: string, init: RequestInit) => Promise<Response>;\n\nexport interface WebSearchModelContext {\n\tmodel: Model<Api>;\n\tapiKey?: string;\n\theaders?: Record<string, string>;\n\tsessionId?: string;\n}\n\nexport type WebSearchModelContextProvider = () =>\n\t| Promise<WebSearchModelContext | undefined>\n\t| WebSearchModelContext\n\t| undefined;\n\nexport interface DefaultWebSearchOperationsOptions {\n\tenv?: Record<string, string | undefined>;\n\tfetcher?: WebSearchFetcher;\n\tmodelContext?: WebSearchModelContextProvider;\n\ttimeoutMs?: number;\n\tnow?: () => Date;\n\t/** Stored Brave key fallback used when BRAVE_SEARCH_API_KEY is not set. */\n\tfallbackBraveApiKey?: () => Promise<string | undefined> | string | undefined;\n}\n\nexport interface WebSearchToolOptions {\n\toperations?: WebSearchOperations;\n}\n\ninterface JsonFetchOptions {\n\tinput: string;\n\tinit: RequestInit;\n\tfetcher: WebSearchFetcher;\n\tprovider: string;\n\tsignal?: AbortSignal;\n\ttimeoutMs: number;\n}\n\ntype RenderableWebSearchResult = {\n\tcontent: Array<{ type: string; text?: string; data?: string; mimeType?: string }>;\n\tdetails?: WebSearchToolDetails;\n};\n\nfunction isTruthyEnvFlag(value: string | undefined): boolean {\n\tif (!value) return false;\n\tconst normalized = value.trim().toLowerCase();\n\treturn normalized === \"1\" || normalized === \"true\" || normalized === \"yes\";\n}\n\nfunction normalizeLimit(limit: number | undefined): number {\n\tif (limit === undefined || !Number.isFinite(limit)) {\n\t\treturn DEFAULT_LIMIT;\n\t}\n\treturn Math.min(MAX_LIMIT, Math.max(1, Math.floor(limit)));\n}\n\nfunction normalizeRecencyDays(recencyDays: number | undefined): number | undefined {\n\tif (recencyDays === undefined || !Number.isFinite(recencyDays) || recencyDays <= 0) {\n\t\treturn undefined;\n\t}\n\treturn Math.max(1, Math.floor(recencyDays));\n}\n\nfunction normalizeDomain(value: string): string | undefined {\n\tconst trimmed = value.trim().toLowerCase();\n\tif (!trimmed) return undefined;\n\tconst withoutProtocol = trimmed.replace(/^https?:\\/\\//, \"\");\n\tconst host = withoutProtocol.split(/[/?#]/, 1)[0]?.replace(/^\\*\\./, \"\");\n\tif (!host || host.length > 253 || !host.includes(\".\")) return undefined;\n\tif (!/^[a-z0-9.-]+$/.test(host)) return undefined;\n\treturn host;\n}\n\nfunction normalizeDomains(domains: string[] | undefined): string[] | undefined {\n\tif (!domains || domains.length === 0) {\n\t\treturn undefined;\n\t}\n\tconst unique = new Set<string>();\n\tfor (const domain of domains) {\n\t\tconst normalized = normalizeDomain(domain);\n\t\tif (normalized) {\n\t\t\tunique.add(normalized);\n\t\t}\n\t\tif (unique.size >= MAX_DOMAINS) {\n\t\t\tbreak;\n\t\t}\n\t}\n\treturn unique.size > 0 ? [...unique] : undefined;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction getString(record: Record<string, unknown>, key: string): string | undefined {\n\tconst value = record[key];\n\treturn typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\nfunction decodeHtmlEntities(value: string): string {\n\treturn value\n\t\t.replace(/&quot;/g, '\"')\n\t\t.replace(/&#39;/g, \"'\")\n\t\t.replace(/&apos;/g, \"'\")\n\t\t.replace(/&lt;/g, \"<\")\n\t\t.replace(/&gt;/g, \">\")\n\t\t.replace(/&amp;/g, \"&\")\n\t\t.replace(/&#(\\d+);/g, (match, code: string) => {\n\t\t\tconst point = Number.parseInt(code, 10);\n\t\t\tif (!Number.isFinite(point)) {\n\t\t\t\treturn match;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\treturn String.fromCodePoint(point);\n\t\t\t} catch {\n\t\t\t\treturn match;\n\t\t\t}\n\t\t});\n}\n\nfunction cleanText(value: string | undefined): string | undefined {\n\tif (!value) return undefined;\n\tconst cleaned = decodeHtmlEntities(value.replace(/<[^>]*>/g, \"\"))\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n\treturn cleaned.length > 0 ? cleaned : undefined;\n}\n\nfunction hostnameFromUrl(url: string): string | undefined {\n\ttry {\n\t\treturn new URL(url).hostname.replace(/^www\\./, \"\");\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction parseSearchResult(value: unknown): WebSearchResult | undefined {\n\tif (!isRecord(value)) {\n\t\treturn undefined;\n\t}\n\tconst title = cleanText(getString(value, \"title\") ?? getString(value, \"name\"));\n\tconst url = getString(value, \"url\") ?? getString(value, \"link\");\n\tif (!title || !url) {\n\t\treturn undefined;\n\t}\n\tconst snippet = cleanText(\n\t\tgetString(value, \"snippet\") ??\n\t\t\tgetString(value, \"description\") ??\n\t\t\tgetString(value, \"content\") ??\n\t\t\tgetString(value, \"text\"),\n\t);\n\tconst publishedAt =\n\t\tgetString(value, \"publishedAt\") ??\n\t\tgetString(value, \"published_at\") ??\n\t\tgetString(value, \"page_age\") ??\n\t\tgetString(value, \"age\");\n\tconst source = cleanText(getString(value, \"source\")) ?? hostnameFromUrl(url);\n\treturn {\n\t\ttitle,\n\t\turl,\n\t\t...(snippet ? { snippet } : {}),\n\t\t...(source ? { source } : {}),\n\t\t...(publishedAt ? { publishedAt } : {}),\n\t};\n}\n\nfunction parseSearchResults(value: unknown): WebSearchResult[] {\n\tif (!Array.isArray(value)) {\n\t\treturn [];\n\t}\n\tconst results: WebSearchResult[] = [];\n\tfor (const item of value) {\n\t\tconst result = parseSearchResult(item);\n\t\tif (result) {\n\t\t\tresults.push(result);\n\t\t}\n\t}\n\treturn results;\n}\n\nfunction normalizeSearchResponse(value: unknown, provider: string, query?: string): WebSearchResponse {\n\tif (!isRecord(value)) {\n\t\tthrow new Error(`${provider} returned an invalid JSON response`);\n\t}\n\tconst web = isRecord(value.web) ? value.web : undefined;\n\tconst rawResults = Array.isArray(value.results) ? value.results : web?.results;\n\tconst content = getString(value, \"content\") ?? getString(value, \"output\");\n\treturn {\n\t\tprovider: getString(value, \"provider\") ?? provider,\n\t\tquery: getString(value, \"query\") ?? query,\n\t\tresults: parseSearchResults(rawResults),\n\t\t...(content ? { content } : {}),\n\t};\n}\n\nasync function readResponseBody(response: Response): Promise<unknown> {\n\tconst text = await response.text();\n\tif (!text.trim()) {\n\t\treturn undefined;\n\t}\n\ttry {\n\t\treturn JSON.parse(text) as unknown;\n\t} catch {\n\t\treturn text;\n\t}\n}\n\nfunction extractErrorMessage(body: unknown): string | undefined {\n\tif (typeof body === \"string\") {\n\t\treturn body.trim().slice(0, 500) || undefined;\n\t}\n\tif (!isRecord(body)) {\n\t\treturn undefined;\n\t}\n\tconst direct = getString(body, \"message\") ?? getString(body, \"error\") ?? getString(body, \"detail\");\n\tif (direct) {\n\t\treturn direct.slice(0, 500);\n\t}\n\tconst error = body.error;\n\tif (isRecord(error)) {\n\t\tconst nested = getString(error, \"message\") ?? getString(error, \"detail\");\n\t\tif (nested) {\n\t\t\treturn nested.slice(0, 500);\n\t\t}\n\t}\n\treturn undefined;\n}\n\nasync function fetchJson({ input, init, fetcher, provider, signal, timeoutMs }: JsonFetchOptions): Promise<unknown> {\n\tlet response: Response;\n\ttry {\n\t\tconst timeoutSignal = AbortSignal.timeout(timeoutMs);\n\t\tconst requestSignal = signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;\n\t\tresponse = await fetcher(input, { ...init, signal: requestSignal });\n\t} catch (error) {\n\t\tif (signal?.aborted) {\n\t\t\tthrow new Error(\"Operation aborted\");\n\t\t}\n\t\tif (error instanceof DOMException && error.name === \"TimeoutError\") {\n\t\t\tthrow new Error(`${provider} request timed out`);\n\t\t}\n\t\tif (error instanceof Error && error.name === \"AbortError\") {\n\t\t\tthrow new Error(`${provider} request timed out`);\n\t\t}\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthrow new Error(`${provider} request failed: ${message}`);\n\t}\n\n\tconst body = await readResponseBody(response);\n\tif (!response.ok) {\n\t\tconst message = extractErrorMessage(body);\n\t\tthrow new Error(`${provider} returned HTTP ${response.status}${message ? `: ${message}` : \"\"}`);\n\t}\n\tif (typeof body === \"string\") {\n\t\tthrow new Error(`${provider} returned a non-JSON response`);\n\t}\n\treturn body;\n}\n\nfunction buildDomainScopedQuery(query: string, domains: string[] | undefined): string {\n\tif (!domains || domains.length === 0) {\n\t\treturn query;\n\t}\n\tconst domainQuery = domains.map((domain) => `site:${domain}`).join(\" OR \");\n\treturn `${query} (${domainQuery})`;\n}\n\nfunction formatDateForBrave(date: Date): string {\n\tconst year = date.getUTCFullYear();\n\tconst month = String(date.getUTCMonth() + 1).padStart(2, \"0\");\n\tconst day = String(date.getUTCDate()).padStart(2, \"0\");\n\treturn `${year}-${month}-${day}`;\n}\n\nfunction getBraveFreshness(recencyDays: number | undefined, now: () => Date): string | undefined {\n\tif (!recencyDays) {\n\t\treturn undefined;\n\t}\n\tconst end = now();\n\tconst start = new Date(end.getTime() - recencyDays * 24 * 60 * 60 * 1000);\n\treturn `${formatDateForBrave(start)}to${formatDateForBrave(end)}`;\n}\n\nfunction makeHeaders(extra: Record<string, string> = {}): Record<string, string> {\n\treturn {\n\t\t\"User-Agent\": getVoltUserAgent(VERSION),\n\t\taccept: \"application/json\",\n\t\t...extra,\n\t};\n}\n\nfunction setHeaders(headers: Headers, values: Record<string, string> | undefined): void {\n\tfor (const [key, value] of Object.entries(values ?? {})) {\n\t\theaders.set(key, value);\n\t}\n}\n\nfunction resolveOpenAISearchUrl(baseUrl: string): string {\n\treturn `${baseUrl.replace(/\\/+$/, \"\")}/alpha/search`;\n}\n\nfunction resolveCodexSearchUrl(baseUrl: string | undefined): string {\n\tconst raw = baseUrl && baseUrl.trim().length > 0 ? baseUrl : DEFAULT_CODEX_BASE_URL;\n\tconst normalized = raw.replace(/\\/+$/, \"\");\n\tif (normalized.endsWith(\"/alpha/search\")) return normalized;\n\tif (normalized.endsWith(\"/codex/responses\")) return `${normalized.slice(0, -\"/responses\".length)}/alpha/search`;\n\tif (normalized.endsWith(\"/codex\")) return `${normalized}/alpha/search`;\n\treturn `${normalized}/codex/alpha/search`;\n}\n\nfunction isOfficialOpenAIBaseUrl(baseUrl: string): boolean {\n\ttry {\n\t\tconst url = new URL(baseUrl);\n\t\treturn url.protocol === \"https:\" && url.hostname === \"api.openai.com\";\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction isOfficialChatGptBackendBaseUrl(baseUrl: string | undefined): boolean {\n\tconst raw = baseUrl && baseUrl.trim().length > 0 ? baseUrl : DEFAULT_CODEX_BASE_URL;\n\ttry {\n\t\tconst url = new URL(raw);\n\t\treturn url.protocol === \"https:\" && url.hostname === \"chatgpt.com\" && url.pathname.startsWith(\"/backend-api\");\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction supportsOpenAISearchBackend(model: Model<Api>): boolean {\n\tif (model.provider === \"openai-codex\") {\n\t\treturn isOfficialChatGptBackendBaseUrl(model.baseUrl);\n\t}\n\treturn model.provider === \"openai\" && isOfficialOpenAIBaseUrl(model.baseUrl);\n}\n\nfunction decodeBase64UrlJson(value: string): Record<string, unknown> | undefined {\n\ttry {\n\t\tconst normalized = value.replace(/-/g, \"+\").replace(/_/g, \"/\");\n\t\tconst padded = normalized.padEnd(Math.ceil(normalized.length / 4) * 4, \"=\");\n\t\treturn JSON.parse(atob(padded)) as Record<string, unknown>;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction extractChatGptAccountId(token: string): string {\n\tconst payload = decodeBase64UrlJson(token.split(\".\")[1] ?? \"\");\n\tconst auth = isRecord(payload?.[JWT_CLAIM_PATH]) ? payload[JWT_CLAIM_PATH] : undefined;\n\tconst accountId = isRecord(auth) ? getString(auth, \"chatgpt_account_id\") : undefined;\n\tif (!accountId) {\n\t\tthrow new Error(\"Failed to extract ChatGPT account id from OpenAI Codex token\");\n\t}\n\treturn accountId;\n}\n\nfunction codexResponseLength(limit: number): \"short\" | \"medium\" | \"long\" {\n\tif (limit <= 3) return \"short\";\n\tif (limit <= 7) return \"medium\";\n\treturn \"long\";\n}\n\nfunction codexExternalWebAccess(env: Record<string, string | undefined>): boolean {\n\treturn env.VOLT_WEB_SEARCH_MODE?.trim().toLowerCase() === \"live\";\n}\n\nfunction buildCodexSearchBody(\n\tcontext: WebSearchModelContext,\n\trequest: WebSearchRequest,\n\tenv: Record<string, string | undefined>,\n): Record<string, unknown> {\n\tconst searchQuery: Record<string, unknown> = { q: request.query };\n\tif (request.recencyDays) {\n\t\tsearchQuery.recency = request.recencyDays;\n\t}\n\tif (request.domains && request.domains.length > 0) {\n\t\tsearchQuery.domains = request.domains;\n\t}\n\treturn {\n\t\tid: context.sessionId ?? \"volt-web-search\",\n\t\tmodel: context.model.id,\n\t\tcommands: {\n\t\t\tsearch_query: [searchQuery],\n\t\t\tresponse_length: codexResponseLength(request.limit),\n\t\t},\n\t\tsettings: {\n\t\t\tallowed_callers: [\"direct\"],\n\t\t\texternal_web_access: codexExternalWebAccess(env),\n\t\t},\n\t};\n}\n\nasync function searchOpenAIBackend(\n\tcontext: WebSearchModelContext,\n\trequest: WebSearchRequest,\n\tenv: Record<string, string | undefined>,\n\tfetcher: WebSearchFetcher,\n\tsignal: AbortSignal | undefined,\n\ttimeoutMs: number,\n): Promise<WebSearchResponse> {\n\tconst model = context.model;\n\tconst isCodexModel = model.provider === \"openai-codex\";\n\tconst headers = new Headers(makeHeaders({ \"content-type\": \"application/json\" }));\n\tsetHeaders(headers, context.headers);\n\tif (!context.apiKey) {\n\t\tthrow new Error(`web_search requires authentication for ${model.provider}/${model.id}`);\n\t}\n\theaders.set(\"authorization\", `Bearer ${context.apiKey}`);\n\n\tconst provider = isCodexModel ? \"openai-codex\" : \"openai\";\n\tconst input = isCodexModel ? resolveCodexSearchUrl(model.baseUrl) : resolveOpenAISearchUrl(model.baseUrl);\n\tif (isCodexModel) {\n\t\theaders.set(\"chatgpt-account-id\", extractChatGptAccountId(context.apiKey));\n\t\theaders.set(\"originator\", \"volt\");\n\t}\n\n\tconst body = await fetchJson({\n\t\tinput,\n\t\tinit: {\n\t\t\tmethod: \"POST\",\n\t\t\theaders,\n\t\t\tbody: JSON.stringify(buildCodexSearchBody(context, request, env)),\n\t\t},\n\t\tfetcher,\n\t\tprovider: `${provider} web search`,\n\t\tsignal,\n\t\ttimeoutMs,\n\t});\n\tif (!isRecord(body)) {\n\t\tthrow new Error(`${provider} web search returned an invalid JSON response`);\n\t}\n\tconst content = getString(body, \"output\");\n\tif (!content) {\n\t\treturn normalizeSearchResponse(body, provider, request.query);\n\t}\n\treturn {\n\t\tprovider,\n\t\tquery: request.query,\n\t\tresults: [],\n\t\tcontent,\n\t};\n}\n\nasync function searchCustomEndpoint(\n\tendpoint: string,\n\tapiKey: string | undefined,\n\trequest: WebSearchRequest,\n\tfetcher: WebSearchFetcher,\n\tsignal: AbortSignal | undefined,\n\ttimeoutMs: number,\n): Promise<WebSearchResponse> {\n\tconst headers = makeHeaders({ \"content-type\": \"application/json\" });\n\tif (apiKey) {\n\t\theaders.authorization = `Bearer ${apiKey}`;\n\t}\n\tconst body = await fetchJson({\n\t\tinput: endpoint,\n\t\tinit: {\n\t\t\tmethod: \"POST\",\n\t\t\theaders,\n\t\t\tbody: JSON.stringify(request),\n\t\t},\n\t\tfetcher,\n\t\tprovider: \"Volt web search endpoint\",\n\t\tsignal,\n\t\ttimeoutMs,\n\t});\n\treturn normalizeSearchResponse(body, \"custom\", request.query);\n}\n\nasync function searchBrave(\n\tapiKey: string,\n\trequest: WebSearchRequest,\n\tfetcher: WebSearchFetcher,\n\tsignal: AbortSignal | undefined,\n\ttimeoutMs: number,\n\tnow: () => Date,\n): Promise<WebSearchResponse> {\n\tconst submittedQuery = buildDomainScopedQuery(request.query, request.domains);\n\tconst url = new URL(\"https://api.search.brave.com/res/v1/web/search\");\n\turl.searchParams.set(\"q\", submittedQuery);\n\turl.searchParams.set(\"count\", String(request.limit));\n\turl.searchParams.set(\"result_filter\", \"web\");\n\turl.searchParams.set(\"text_decorations\", \"false\");\n\turl.searchParams.set(\"extra_snippets\", \"false\");\n\tconst freshness = getBraveFreshness(request.recencyDays, now);\n\tif (freshness) {\n\t\turl.searchParams.set(\"freshness\", freshness);\n\t}\n\n\tconst body = await fetchJson({\n\t\tinput: url.toString(),\n\t\tinit: {\n\t\t\tmethod: \"GET\",\n\t\t\theaders: makeHeaders({ \"X-Subscription-Token\": apiKey }),\n\t\t},\n\t\tfetcher,\n\t\tprovider: \"Brave Search API\",\n\t\tsignal,\n\t\ttimeoutMs,\n\t});\n\treturn normalizeSearchResponse(body, \"brave\", submittedQuery);\n}\n\nexport function createDefaultWebSearchOperations(options: DefaultWebSearchOperationsOptions = {}): WebSearchOperations {\n\tconst env = options.env ?? process.env;\n\tconst fetcher = options.fetcher ?? ((input, init) => globalThis.fetch(input, init));\n\tconst modelContext = options.modelContext;\n\tconst timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n\tconst now = options.now ?? (() => new Date());\n\treturn {\n\t\tasync search(request, signal) {\n\t\t\tif (isTruthyEnvFlag(env.VOLT_OFFLINE)) {\n\t\t\t\tthrow new Error(\"web_search is unavailable because VOLT_OFFLINE is enabled\");\n\t\t\t}\n\n\t\t\tconst endpoint = env.VOLT_WEB_SEARCH_URL?.trim();\n\t\t\tif (endpoint) {\n\t\t\t\tconst apiKey = env.VOLT_WEB_SEARCH_API_KEY?.trim();\n\t\t\t\treturn searchCustomEndpoint(endpoint, apiKey, request, fetcher, signal, timeoutMs);\n\t\t\t}\n\n\t\t\tconst context = await modelContext?.();\n\t\t\tif (context && supportsOpenAISearchBackend(context.model)) {\n\t\t\t\treturn searchOpenAIBackend(context, request, env, fetcher, signal, timeoutMs);\n\t\t\t}\n\n\t\t\tconst braveApiKey = env.BRAVE_SEARCH_API_KEY?.trim() || (await options.fallbackBraveApiKey?.())?.trim();\n\t\t\tif (braveApiKey) {\n\t\t\t\treturn searchBrave(braveApiKey, request, fetcher, signal, timeoutMs, now);\n\t\t\t}\n\n\t\t\tthrow new Error(\n\t\t\t\t\"web_search is not configured. Use an authenticated OpenAI/OpenAI Codex model, set VOLT_WEB_SEARCH_URL, or set BRAVE_SEARCH_API_KEY.\",\n\t\t\t);\n\t\t},\n\t};\n}\n\nfunction formatRecency(recencyDays: number): string {\n\treturn recencyDays === 1 ? \"last day\" : `last ${recencyDays} days`;\n}\n\nfunction createOutput(\n\trequest: WebSearchRequest,\n\tresponse: WebSearchResponse,\n): {\n\ttext: string;\n\tdetails: WebSearchToolDetails;\n} {\n\tconst normalizedResults = response.results\n\t\t.map((result) => parseSearchResult(result))\n\t\t.filter((result): result is WebSearchResult => result !== undefined);\n\tconst results = normalizedResults.slice(0, request.limit);\n\tconst lines: string[] = [`Web search results (${response.provider})`, `Query: ${request.query}`];\n\tif (response.query && response.query !== request.query) {\n\t\tlines.push(`Submitted query: ${response.query}`);\n\t}\n\tif (request.domains && request.domains.length > 0) {\n\t\tlines.push(`Domains: ${request.domains.join(\", \")}`);\n\t}\n\tif (request.recencyDays) {\n\t\tlines.push(`Recency: ${formatRecency(request.recencyDays)}`);\n\t}\n\n\tif (response.content) {\n\t\tlines.push(\"\", response.content.trim());\n\t} else if (results.length === 0) {\n\t\tlines.push(\"\", \"No web results found\");\n\t} else {\n\t\tlines.push(\"\");\n\t\tfor (let i = 0; i < results.length; i++) {\n\t\t\tconst result = results[i];\n\t\t\tlines.push(`[${i + 1}] ${result.title}`);\n\t\t\tlines.push(`URL: ${result.url}`);\n\t\t\tif (result.snippet) {\n\t\t\t\tlines.push(`Snippet: ${result.snippet}`);\n\t\t\t}\n\t\t\tif (result.publishedAt) {\n\t\t\t\tlines.push(`Published: ${result.publishedAt}`);\n\t\t\t}\n\t\t\tif (result.source && result.source !== hostnameFromUrl(result.url)) {\n\t\t\t\tlines.push(`Source: ${result.source}`);\n\t\t\t}\n\t\t\tif (i < results.length - 1) {\n\t\t\t\tlines.push(\"\");\n\t\t\t}\n\t\t}\n\t}\n\n\tconst rawOutput = lines.join(\"\\n\");\n\tconst truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });\n\tconst details: WebSearchToolDetails = {\n\t\tquery: request.query,\n\t\t...(response.query ? { submittedQuery: response.query } : {}),\n\t\tprovider: response.provider,\n\t\tresults,\n\t};\n\tconst notices: string[] = [];\n\tif (normalizedResults.length > request.limit) {\n\t\tdetails.resultLimitReached = request.limit;\n\t\tnotices.push(`${request.limit} results limit reached`);\n\t}\n\tif (truncation.truncated) {\n\t\tdetails.truncation = truncation;\n\t\tnotices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);\n\t}\n\n\tlet text = truncation.content;\n\tif (notices.length > 0) {\n\t\ttext += `\\n\\n[${notices.join(\". \")}]`;\n\t}\n\treturn { text, details };\n}\n\nfunction formatWebSearchCall(\n\targs: { query?: string; limit?: number; domains?: string[]; recencyDays?: number } | undefined,\n\ttheme: Theme,\n): string {\n\tconst query = str(args?.query);\n\tconst invalidArg = invalidArgText(theme);\n\tlet text =\n\t\ttheme.fg(\"toolTitle\", theme.bold(\"web_search\")) +\n\t\t\" \" +\n\t\t(query === null ? invalidArg : theme.fg(\"accent\", query || \"...\"));\n\tif (Array.isArray(args?.domains) && args.domains.length > 0) {\n\t\ttext += theme.fg(\"toolOutput\", ` (${args.domains.join(\", \")})`);\n\t}\n\tif (typeof args?.recencyDays === \"number\") {\n\t\ttext += theme.fg(\"toolOutput\", ` ${formatRecency(args.recencyDays)}`);\n\t}\n\tif (typeof args?.limit === \"number\") {\n\t\ttext += theme.fg(\"toolOutput\", ` limit ${args.limit}`);\n\t}\n\treturn text;\n}\n\nfunction formatWebSearchResult(\n\tresult: RenderableWebSearchResult,\n\toptions: ToolRenderResultOptions,\n\ttheme: Theme,\n\tshowImages: boolean,\n): string {\n\tconst output = getTextOutput(result, showImages).trim();\n\tlet text = \"\";\n\tif (output) {\n\t\tconst lines = output.split(\"\\n\");\n\t\tconst maxLines = options.expanded ? lines.length : 16;\n\t\tconst displayLines = lines.slice(0, maxLines);\n\t\tconst remaining = lines.length - maxLines;\n\t\ttext += `\\n${displayLines.map((line) => theme.fg(\"toolOutput\", line)).join(\"\\n\")}`;\n\t\tif (remaining > 0) {\n\t\t\ttext += `${theme.fg(\"muted\", `\\n... (${remaining} more lines,`)} ${keyHint(\"app.tools.expand\", \"to expand\")}${theme.fg(\"muted\", \")\")}`;\n\t\t}\n\t}\n\n\tconst resultLimit = result.details?.resultLimitReached;\n\tconst truncation = result.details?.truncation;\n\tif (resultLimit || truncation?.truncated) {\n\t\tconst warnings: string[] = [];\n\t\tif (resultLimit) warnings.push(`${resultLimit} results limit`);\n\t\tif (truncation?.truncated) warnings.push(`${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit`);\n\t\ttext += `\\n${theme.fg(\"warning\", `[Truncated: ${warnings.join(\", \")}]`)}`;\n\t}\n\treturn text;\n}\n\nexport function createWebSearchToolDefinition(\n\t_cwd: string,\n\toptions?: WebSearchToolOptions,\n): ToolDefinition<typeof webSearchSchema, WebSearchToolDetails> {\n\tconst ops = options?.operations ?? createDefaultWebSearchOperations();\n\treturn {\n\t\tname: \"web_search\",\n\t\tlabel: \"web_search\",\n\t\tdescription:\n\t\t\t\"Search the web for current or external information. Returns ranked results with titles, URLs, snippets, and publication dates when available. Use domains to restrict sources and recencyDays for fresh results.\",\n\t\tpromptSnippet: \"Search the web for current or external information\",\n\t\tpromptGuidelines: [\n\t\t\t\"Use web_search when the user asks for current, recently changed, external, or source-attributed information.\",\n\t\t\t\"After using web_search, cite relevant URLs in your response when the answer depends on search results.\",\n\t\t],\n\t\tparameters: webSearchSchema,\n\t\tasync execute(_toolCallId, params: WebSearchToolInput, signal?: AbortSignal) {\n\t\t\tif (signal?.aborted) {\n\t\t\t\tthrow new Error(\"Operation aborted\");\n\t\t\t}\n\t\t\tconst query = params.query.trim();\n\t\t\tif (!query) {\n\t\t\t\tthrow new Error(\"web_search query must not be empty\");\n\t\t\t}\n\t\t\tconst domains = normalizeDomains(params.domains);\n\t\t\tconst recencyDays = normalizeRecencyDays(params.recencyDays);\n\t\t\tconst request: WebSearchRequest = {\n\t\t\t\tquery,\n\t\t\t\tlimit: normalizeLimit(params.limit),\n\t\t\t\t...(domains ? { domains } : {}),\n\t\t\t\t...(recencyDays ? { recencyDays } : {}),\n\t\t\t};\n\t\t\tconst response = await ops.search(request, signal);\n\t\t\tif (signal?.aborted) {\n\t\t\t\tthrow new Error(\"Operation aborted\");\n\t\t\t}\n\t\t\tconst { text, details } = createOutput(request, response);\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text }],\n\t\t\t\tdetails,\n\t\t\t};\n\t\t},\n\t\trenderCall(args, theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\ttext.setText(formatWebSearchCall(args, theme));\n\t\t\treturn text;\n\t\t},\n\t\trenderResult(result, options, theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\ttext.setText(formatWebSearchResult(result as RenderableWebSearchResult, options, theme, context.showImages));\n\t\t\treturn text;\n\t\t},\n\t};\n}\n\nexport function createWebSearchTool(cwd: string, options?: WebSearchToolOptions): AgentTool<typeof webSearchSchema> {\n\treturn wrapToolDefinition(createWebSearchToolDefinition(cwd, options));\n}\n"]}