@code-yeongyu/senpi 2026.6.15 → 2026.6.16

package/dist/core/extensions/builtin/webfetch/webfetch/fetcher.js

@@ -0,0 +1,148 @@
+import { InvalidWebfetchUrlError, WebfetchAbortError, WebfetchResponseTooLargeError, WebfetchTimeoutError, } from "./errors.js";
+export const MAX_RESPONSE_SIZE_BYTES = 5 * 1024 * 1024;
+export const DEFAULT_TIMEOUT_SECONDS = 30;
+export const MAX_TIMEOUT_SECONDS = 120;
+const BROWSER_USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36";
+export async function fetchUrl(options) {
+    validateUrl(options.url);
+    const timeoutSeconds = clampTimeout(options.timeoutSeconds);
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(new WebfetchTimeoutError(`Request timed out after ${timeoutSeconds}s`)), timeoutSeconds * 1000);
+    const removeAbortForwarder = forwardAbort(options.signal, controller);
+    try {
+        const response = await fetch(options.url, {
+            headers: buildHeaders(options.format, BROWSER_USER_AGENT),
+            signal: controller.signal,
+        });
+        if (response.status === 403 && response.headers.get("cf-mitigated") === "challenge") {
+            await cancelBody(response);
+            const retry = await fetch(options.url, {
+                headers: buildHeaders(options.format, "pi-webfetch"),
+                signal: controller.signal,
+            });
+            return await readFetchResponse(options.url, retry, controller.signal);
+        }
+        return await readFetchResponse(options.url, response, controller.signal);
+    }
+    finally {
+        clearTimeout(timeout);
+        removeAbortForwarder();
+    }
+}
+export function validateUrl(url) {
+    if (!url.startsWith("http://") && !url.startsWith("https://")) {
+        throw new InvalidWebfetchUrlError("URL must start with http:// or https://");
+    }
+    try {
+        new URL(url);
+    }
+    catch {
+        throw new InvalidWebfetchUrlError(`Invalid URL: ${url}`);
+    }
+}
+export function clampTimeout(timeoutSeconds) {
+    if (timeoutSeconds === undefined)
+        return DEFAULT_TIMEOUT_SECONDS;
+    if (!Number.isFinite(timeoutSeconds) || timeoutSeconds <= 0)
+        return DEFAULT_TIMEOUT_SECONDS;
+    return Math.min(Math.ceil(timeoutSeconds), MAX_TIMEOUT_SECONDS);
+}
+export function buildAcceptHeader(format) {
+    switch (format) {
+        case "markdown":
+            return "text/markdown;q=1.0, text/x-markdown;q=0.9, text/plain;q=0.8, text/html;q=0.7, */*;q=0.1";
+        case "text":
+            return "text/plain;q=1.0, text/markdown;q=0.9, text/html;q=0.8, */*;q=0.1";
+        case "html":
+            return "text/html;q=1.0, application/xhtml+xml;q=0.9, text/plain;q=0.8, text/markdown;q=0.7, */*;q=0.1";
+    }
+}
+function buildHeaders(format, userAgent) {
+    return {
+        Accept: buildAcceptHeader(format),
+        "Accept-Language": "en-US,en;q=0.9",
+        "User-Agent": userAgent,
+    };
+}
+async function readFetchResponse(url, response, signal) {
+    await rejectOversizedContentLength(response);
+    const body = await readResponseBody(response, signal);
+    return {
+        url: response.url || url,
+        status: response.status,
+        statusText: response.statusText,
+        contentType: response.headers.get("content-type") ?? "",
+        bytes: body.length,
+        body,
+        truncated: body.length === MAX_RESPONSE_SIZE_BYTES,
+    };
+}
+async function rejectOversizedContentLength(response) {
+    const contentLength = response.headers.get("content-length");
+    if (contentLength && Number.parseInt(contentLength, 10) > MAX_RESPONSE_SIZE_BYTES) {
+        await cancelBody(response);
+        throw new WebfetchResponseTooLargeError("Response too large (exceeds 5MB limit)");
+    }
+}
+async function cancelBody(response) {
+    try {
+        await response.body?.cancel();
+    }
+    catch {
+        // Preserve the caller's original failure.
+    }
+}
+async function readResponseBody(response, signal) {
+    if (!response.body)
+        return new Uint8Array();
+    const reader = response.body.getReader();
+    const chunks = [];
+    let total = 0;
+    try {
+        while (true) {
+            if (signal.aborted) {
+                await cancelReader(reader);
+                throw new WebfetchAbortError("Request aborted");
+            }
+            const read = await reader.read();
+            if (read.done)
+                break;
+            chunks.push(read.value);
+            total += read.value.length;
+            if (total > MAX_RESPONSE_SIZE_BYTES) {
+                await cancelReader(reader);
+                throw new WebfetchResponseTooLargeError("Response too large (exceeds 5MB limit)");
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const body = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        body.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return body;
+}
+async function cancelReader(reader) {
+    try {
+        await reader.cancel();
+    }
+    catch {
+        // Preserve the caller's original failure.
+    }
+}
+function forwardAbort(signal, controller) {
+    if (!signal)
+        return () => { };
+    if (signal.aborted) {
+        controller.abort(signal.reason);
+        return () => { };
+    }
+    const listener = () => controller.abort(signal.reason);
+    signal.addEventListener("abort", listener, { once: true });
+    return () => signal.removeEventListener("abort", listener);
+}
+//# sourceMappingURL=fetcher.js.map

package/dist/core/extensions/builtin/webfetch/webfetch/fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/webfetch/webfetch/fetcher.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tInvalidWebfetchUrlError,\n\tWebfetchAbortError,\n\tWebfetchResponseTooLargeError,\n\tWebfetchTimeoutError,\n} from \"./errors.ts\";\n\nexport const MAX_RESPONSE_SIZE_BYTES = 5 * 1024 * 1024;\nexport const DEFAULT_TIMEOUT_SECONDS = 30;\nexport const MAX_TIMEOUT_SECONDS = 120;\n\nconst BROWSER_USER_AGENT =\n\t\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36\";\n\nexport type WebfetchFormat = \"markdown\" | \"text\" | \"html\";\n\nexport interface FetchOptions {\n\turl: string;\n\tformat: WebfetchFormat;\n\ttimeoutSeconds?: number;\n\tsignal?: AbortSignal;\n}\n\nexport interface FetchResult {\n\turl: string;\n\tstatus: number;\n\tstatusText: string;\n\tcontentType: string;\n\tbytes: number;\n\tbody: Uint8Array;\n\ttruncated: boolean;\n}\n\nexport async function fetchUrl(options: FetchOptions): Promise<FetchResult> {\n\tvalidateUrl(options.url);\n\n\tconst timeoutSeconds = clampTimeout(options.timeoutSeconds);\n\tconst controller = new AbortController();\n\tconst timeout = setTimeout(\n\t\t() => controller.abort(new WebfetchTimeoutError(`Request timed out after ${timeoutSeconds}s`)),\n\t\ttimeoutSeconds * 1000,\n\t);\n\tconst removeAbortForwarder = forwardAbort(options.signal, controller);\n\n\ttry {\n\t\tconst response = await fetch(options.url, {\n\t\t\theaders: buildHeaders(options.format, BROWSER_USER_AGENT),\n\t\t\tsignal: controller.signal,\n\t\t});\n\n\t\tif (response.status === 403 && response.headers.get(\"cf-mitigated\") === \"challenge\") {\n\t\t\tawait cancelBody(response);\n\t\t\tconst retry = await fetch(options.url, {\n\t\t\t\theaders: buildHeaders(options.format, \"pi-webfetch\"),\n\t\t\t\tsignal: controller.signal,\n\t\t\t});\n\t\t\treturn await readFetchResponse(options.url, retry, controller.signal);\n\t\t}\n\n\t\treturn await readFetchResponse(options.url, response, controller.signal);\n\t} finally {\n\t\tclearTimeout(timeout);\n\t\tremoveAbortForwarder();\n\t}\n}\n\nexport function validateUrl(url: string): void {\n\tif (!url.startsWith(\"http://\") && !url.startsWith(\"https://\")) {\n\t\tthrow new InvalidWebfetchUrlError(\"URL must start with http:// or https://\");\n\t}\n\n\ttry {\n\t\tnew URL(url);\n\t} catch {\n\t\tthrow new InvalidWebfetchUrlError(`Invalid URL: ${url}`);\n\t}\n}\n\nexport function clampTimeout(timeoutSeconds: number | undefined): number {\n\tif (timeoutSeconds === undefined) return DEFAULT_TIMEOUT_SECONDS;\n\tif (!Number.isFinite(timeoutSeconds) || timeoutSeconds <= 0) return DEFAULT_TIMEOUT_SECONDS;\n\treturn Math.min(Math.ceil(timeoutSeconds), MAX_TIMEOUT_SECONDS);\n}\n\nexport function buildAcceptHeader(format: WebfetchFormat): string {\n\tswitch (format) {\n\t\tcase \"markdown\":\n\t\t\treturn \"text/markdown;q=1.0, text/x-markdown;q=0.9, text/plain;q=0.8, text/html;q=0.7, */*;q=0.1\";\n\t\tcase \"text\":\n\t\t\treturn \"text/plain;q=1.0, text/markdown;q=0.9, text/html;q=0.8, */*;q=0.1\";\n\t\tcase \"html\":\n\t\t\treturn \"text/html;q=1.0, application/xhtml+xml;q=0.9, text/plain;q=0.8, text/markdown;q=0.7, */*;q=0.1\";\n\t}\n}\n\nfunction buildHeaders(format: WebfetchFormat, userAgent: string): Record<string, string> {\n\treturn {\n\t\tAccept: buildAcceptHeader(format),\n\t\t\"Accept-Language\": \"en-US,en;q=0.9\",\n\t\t\"User-Agent\": userAgent,\n\t};\n}\n\nasync function readFetchResponse(url: string, response: Response, signal: AbortSignal): Promise<FetchResult> {\n\tawait rejectOversizedContentLength(response);\n\tconst body = await readResponseBody(response, signal);\n\treturn {\n\t\turl: response.url || url,\n\t\tstatus: response.status,\n\t\tstatusText: response.statusText,\n\t\tcontentType: response.headers.get(\"content-type\") ?? \"\",\n\t\tbytes: body.length,\n\t\tbody,\n\t\ttruncated: body.length === MAX_RESPONSE_SIZE_BYTES,\n\t};\n}\n\nasync function rejectOversizedContentLength(response: Response): Promise<void> {\n\tconst contentLength = response.headers.get(\"content-length\");\n\tif (contentLength && Number.parseInt(contentLength, 10) > MAX_RESPONSE_SIZE_BYTES) {\n\t\tawait cancelBody(response);\n\t\tthrow new WebfetchResponseTooLargeError(\"Response too large (exceeds 5MB limit)\");\n\t}\n}\n\nasync function cancelBody(response: Response): Promise<void> {\n\ttry {\n\t\tawait response.body?.cancel();\n\t} catch {\n\t\t// Preserve the caller's original failure.\n\t}\n}\n\nasync function readResponseBody(response: Response, signal: AbortSignal): Promise<Uint8Array> {\n\tif (!response.body) return new Uint8Array();\n\n\tconst reader = response.body.getReader();\n\tconst chunks: Uint8Array[] = [];\n\tlet total = 0;\n\n\ttry {\n\t\twhile (true) {\n\t\t\tif (signal.aborted) {\n\t\t\t\tawait cancelReader(reader);\n\t\t\t\tthrow new WebfetchAbortError(\"Request aborted\");\n\t\t\t}\n\t\t\tconst read = await reader.read();\n\t\t\tif (read.done) break;\n\t\t\tchunks.push(read.value);\n\t\t\ttotal += read.value.length;\n\t\t\tif (total > MAX_RESPONSE_SIZE_BYTES) {\n\t\t\t\tawait cancelReader(reader);\n\t\t\t\tthrow new WebfetchResponseTooLargeError(\"Response too large (exceeds 5MB limit)\");\n\t\t\t}\n\t\t}\n\t} finally {\n\t\treader.releaseLock();\n\t}\n\n\tconst body = new Uint8Array(total);\n\tlet offset = 0;\n\tfor (const chunk of chunks) {\n\t\tbody.set(chunk, offset);\n\t\toffset += chunk.length;\n\t}\n\treturn body;\n}\n\nasync function cancelReader(reader: ReadableStreamDefaultReader<Uint8Array>): Promise<void> {\n\ttry {\n\t\tawait reader.cancel();\n\t} catch {\n\t\t// Preserve the caller's original failure.\n\t}\n}\n\nfunction forwardAbort(signal: AbortSignal | undefined, controller: AbortController): () => void {\n\tif (!signal) return () => {};\n\tif (signal.aborted) {\n\t\tcontroller.abort(signal.reason);\n\t\treturn () => {};\n\t}\n\n\tconst listener = (): void => controller.abort(signal.reason);\n\tsignal.addEventListener(\"abort\", listener, { once: true });\n\treturn () => signal.removeEventListener(\"abort\", listener);\n}\n"]}

package/dist/core/extensions/builtin/webfetch/webfetch/renderers.d.ts

@@ -0,0 +1,15 @@
+import { Text } from "@earendil-works/pi-tui";
+import type { Theme } from "../../../../../modes/interactive/theme/theme.ts";
+import type { ToolRenderResultOptions } from "../../../types.ts";
+import type { WebfetchRenderDetails } from "./tool.ts";
+interface ResultLike<TDetails> {
+    content: ReadonlyArray<{
+        type: string;
+        text?: string;
+    }>;
+    details?: TDetails;
+}
+export declare function renderWebfetchCall(args: unknown, theme: Theme): Text;
+export declare function renderWebfetchResult(result: ResultLike<WebfetchRenderDetails>, options: ToolRenderResultOptions, theme: Theme): Text;
+export {};
+//# sourceMappingURL=renderers.d.ts.map

package/dist/core/extensions/builtin/webfetch/webfetch/renderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderers.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/webfetch/webfetch/renderers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iDAAiD,CAAC;AAC7E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEjE,OAAO,KAAK,EAA4C,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAYjG,UAAU,UAAU,CAAC,QAAQ;IAC5B,OAAO,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,OAAO,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAOpE;AAED,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,UAAU,CAAC,qBAAqB,CAAC,EACzC,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,KAAK,GACV,IAAI,CA0CN"}

package/dist/core/extensions/builtin/webfetch/webfetch/renderers.js

@@ -0,0 +1,110 @@
+import { Text, truncateToWidth } from "@earendil-works/pi-tui";
+const URL_BUDGET = 92;
+const PREVIEW_LINES = 4;
+const PREVIEW_WIDTH = 120;
+export function renderWebfetchCall(args, theme) {
+    const webfetchArgs = parseWebfetchArgs(args);
+    const head = theme.fg("toolTitle", theme.bold("webfetch "));
+    const url = theme.fg("accent", shorten(webfetchArgs.url, URL_BUDGET));
+    const format = theme.fg("muted", ` [${webfetchArgs.format ?? "markdown"}]`);
+    const timeout = webfetchArgs.timeout === undefined ? "" : theme.fg("dim", ` ${webfetchArgs.timeout}s`);
+    return new Text(head + url + format + timeout, 0, 0);
+}
+export function renderWebfetchResult(result, options, theme) {
+    if (options.isPartial) {
+        const details = result.details;
+        if (isWebfetchProgressDetails(details)) {
+            return new Text(theme.fg("warning", `Fetching ${shorten(details.url, URL_BUDGET)} as ${details.format} (${details.timeoutSeconds}s)`), 0, 0);
+        }
+        return new Text(theme.fg("warning", "Fetching..."), 0, 0);
+    }
+    const details = result.details;
+    const text = result.content.find((block) => block.type === "text")?.text ?? "";
+    if (!isWebfetchDetails(details)) {
+        return new Text(theme.fg("muted", truncateToWidth(text, PREVIEW_WIDTH)), 0, 0);
+    }
+    const statusKey = details.status >= 200 && details.status < 300 ? "success" : "warning";
+    const status = theme.fg(statusKey, `${details.status} ${details.statusText || "OK"}`);
+    const format = theme.fg("accent", details.format);
+    const size = theme.fg("muted", formatBytes(details.bytes));
+    const converted = details.converted ? theme.fg("dim", " converted") : "";
+    const header = `${status} ${theme.fg("muted", "•")} ${format} ${theme.fg("muted", "•")} ${size}${converted}`;
+    if (!options.expanded) {
+        const preview = previewText(text, theme);
+        return new Text([header, ...preview].join("\n"), 0, 0);
+    }
+    const lines = [
+        header,
+        theme.fg("dim", `URL: ${shorten(details.finalUrl, URL_BUDGET)}`),
+        theme.fg("dim", `Content-Type: ${details.contentType || "unknown"}`),
+        "",
+        ...collectLines(text, 24).map((line) => theme.fg("toolOutput", truncateToWidth(line, PREVIEW_WIDTH))),
+    ];
+    return new Text(lines.join("\n"), 0, 0);
+}
+function collectLines(text, limit) {
+    const lines = [];
+    let start = 0;
+    while (lines.length < limit && start <= text.length) {
+        const newlineIndex = text.indexOf("\n", start);
+        if (newlineIndex === -1) {
+            lines.push(text.slice(start));
+            break;
+        }
+        lines.push(text.slice(start, newlineIndex));
+        start = newlineIndex + 1;
+    }
+    return lines;
+}
+function collectNonEmptyTrimmedLines(text, limit) {
+    const lines = [];
+    let start = 0;
+    while (lines.length < limit && start <= text.length) {
+        const newlineIndex = text.indexOf("\n", start);
+        const line = (newlineIndex === -1 ? text.slice(start) : text.slice(start, newlineIndex)).trim();
+        if (line.length > 0)
+            lines.push(line);
+        if (newlineIndex === -1)
+            break;
+        start = newlineIndex + 1;
+    }
+    return lines;
+}
+function parseWebfetchArgs(args) {
+    if (typeof args !== "object" || args === null) {
+        return { url: "" };
+    }
+    const webfetchArgs = {
+        url: "url" in args && typeof args.url === "string" ? args.url : "",
+    };
+    if ("format" in args && typeof args.format === "string")
+        webfetchArgs.format = args.format;
+    if ("timeout" in args && typeof args.timeout === "number")
+        webfetchArgs.timeout = args.timeout;
+    return webfetchArgs;
+}
+function isWebfetchProgressDetails(details) {
+    return typeof details === "object" && details !== null && "phase" in details && details.phase === "fetching";
+}
+function isWebfetchDetails(details) {
+    return typeof details === "object" && details !== null && "status" in details && typeof details.status === "number";
+}
+function previewText(text, theme) {
+    const lines = collectNonEmptyTrimmedLines(text, PREVIEW_LINES);
+    if (lines.length === 0)
+        return [theme.fg("dim", "  empty response")];
+    return lines.map((line) => theme.fg("toolOutput", `  ${truncateToWidth(line, PREVIEW_WIDTH)}`));
+}
+function shorten(value, max) {
+    if (value.length <= max)
+        return value;
+    return `${value.slice(0, max - 1)}…`;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=renderers.js.map

package/dist/core/extensions/builtin/webfetch/webfetch/renderers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderers.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/webfetch/webfetch/renderers.ts"],"names":[],"mappings":"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","sourcesContent":["import { Text, truncateToWidth } from \"@earendil-works/pi-tui\";\nimport type { Theme } from \"../../../../../modes/interactive/theme/theme.ts\";\nimport type { ToolRenderResultOptions } from \"../../../types.ts\";\n\nimport type { WebfetchDetails, WebfetchProgressDetails, WebfetchRenderDetails } from \"./tool.ts\";\n\nconst URL_BUDGET = 92;\nconst PREVIEW_LINES = 4;\nconst PREVIEW_WIDTH = 120;\n\ninterface WebfetchArgs {\n\turl: string;\n\tformat?: string;\n\ttimeout?: number;\n}\n\ninterface ResultLike<TDetails> {\n\tcontent: ReadonlyArray<{ type: string; text?: string }>;\n\tdetails?: TDetails;\n}\n\nexport function renderWebfetchCall(args: unknown, theme: Theme): Text {\n\tconst webfetchArgs = parseWebfetchArgs(args);\n\tconst head = theme.fg(\"toolTitle\", theme.bold(\"webfetch \"));\n\tconst url = theme.fg(\"accent\", shorten(webfetchArgs.url, URL_BUDGET));\n\tconst format = theme.fg(\"muted\", ` [${webfetchArgs.format ?? \"markdown\"}]`);\n\tconst timeout = webfetchArgs.timeout === undefined ? \"\" : theme.fg(\"dim\", ` ${webfetchArgs.timeout}s`);\n\treturn new Text(head + url + format + timeout, 0, 0);\n}\n\nexport function renderWebfetchResult(\n\tresult: ResultLike<WebfetchRenderDetails>,\n\toptions: ToolRenderResultOptions,\n\ttheme: Theme,\n): Text {\n\tif (options.isPartial) {\n\t\tconst details = result.details;\n\t\tif (isWebfetchProgressDetails(details)) {\n\t\t\treturn new Text(\n\t\t\t\ttheme.fg(\n\t\t\t\t\t\"warning\",\n\t\t\t\t\t`Fetching ${shorten(details.url, URL_BUDGET)} as ${details.format} (${details.timeoutSeconds}s)`,\n\t\t\t\t),\n\t\t\t\t0,\n\t\t\t\t0,\n\t\t\t);\n\t\t}\n\t\treturn new Text(theme.fg(\"warning\", \"Fetching...\"), 0, 0);\n\t}\n\n\tconst details = result.details;\n\tconst text = result.content.find((block) => block.type === \"text\")?.text ?? \"\";\n\tif (!isWebfetchDetails(details)) {\n\t\treturn new Text(theme.fg(\"muted\", truncateToWidth(text, PREVIEW_WIDTH)), 0, 0);\n\t}\n\n\tconst statusKey = details.status >= 200 && details.status < 300 ? \"success\" : \"warning\";\n\tconst status = theme.fg(statusKey, `${details.status} ${details.statusText || \"OK\"}`);\n\tconst format = theme.fg(\"accent\", details.format);\n\tconst size = theme.fg(\"muted\", formatBytes(details.bytes));\n\tconst converted = details.converted ? theme.fg(\"dim\", \" converted\") : \"\";\n\tconst header = `${status} ${theme.fg(\"muted\", \"•\")} ${format} ${theme.fg(\"muted\", \"•\")} ${size}${converted}`;\n\n\tif (!options.expanded) {\n\t\tconst preview = previewText(text, theme);\n\t\treturn new Text([header, ...preview].join(\"\\n\"), 0, 0);\n\t}\n\n\tconst lines = [\n\t\theader,\n\t\ttheme.fg(\"dim\", `URL: ${shorten(details.finalUrl, URL_BUDGET)}`),\n\t\ttheme.fg(\"dim\", `Content-Type: ${details.contentType || \"unknown\"}`),\n\t\t\"\",\n\t\t...collectLines(text, 24).map((line) => theme.fg(\"toolOutput\", truncateToWidth(line, PREVIEW_WIDTH))),\n\t];\n\treturn new Text(lines.join(\"\\n\"), 0, 0);\n}\n\nfunction collectLines(text: string, limit: number): string[] {\n\tconst lines: string[] = [];\n\tlet start = 0;\n\twhile (lines.length < limit && start <= text.length) {\n\t\tconst newlineIndex = text.indexOf(\"\\n\", start);\n\t\tif (newlineIndex === -1) {\n\t\t\tlines.push(text.slice(start));\n\t\t\tbreak;\n\t\t}\n\t\tlines.push(text.slice(start, newlineIndex));\n\t\tstart = newlineIndex + 1;\n\t}\n\treturn lines;\n}\n\nfunction collectNonEmptyTrimmedLines(text: string, limit: number): string[] {\n\tconst lines: string[] = [];\n\tlet start = 0;\n\twhile (lines.length < limit && start <= text.length) {\n\t\tconst newlineIndex = text.indexOf(\"\\n\", start);\n\t\tconst line = (newlineIndex === -1 ? text.slice(start) : text.slice(start, newlineIndex)).trim();\n\t\tif (line.length > 0) lines.push(line);\n\t\tif (newlineIndex === -1) break;\n\t\tstart = newlineIndex + 1;\n\t}\n\treturn lines;\n}\n\nfunction parseWebfetchArgs(args: unknown): WebfetchArgs {\n\tif (typeof args !== \"object\" || args === null) {\n\t\treturn { url: \"\" };\n\t}\n\tconst webfetchArgs: WebfetchArgs = {\n\t\turl: \"url\" in args && typeof args.url === \"string\" ? args.url : \"\",\n\t};\n\tif (\"format\" in args && typeof args.format === \"string\") webfetchArgs.format = args.format;\n\tif (\"timeout\" in args && typeof args.timeout === \"number\") webfetchArgs.timeout = args.timeout;\n\treturn webfetchArgs;\n}\n\nfunction isWebfetchProgressDetails(details: WebfetchRenderDetails | unknown): details is WebfetchProgressDetails {\n\treturn typeof details === \"object\" && details !== null && \"phase\" in details && details.phase === \"fetching\";\n}\n\nfunction isWebfetchDetails(details: WebfetchRenderDetails | unknown): details is WebfetchDetails {\n\treturn typeof details === \"object\" && details !== null && \"status\" in details && typeof details.status === \"number\";\n}\n\nfunction previewText(text: string, theme: Theme): string[] {\n\tconst lines = collectNonEmptyTrimmedLines(text, PREVIEW_LINES);\n\tif (lines.length === 0) return [theme.fg(\"dim\", \"  empty response\")];\n\treturn lines.map((line) => theme.fg(\"toolOutput\", `  ${truncateToWidth(line, PREVIEW_WIDTH)}`));\n}\n\nfunction shorten(value: string, max: number): string {\n\tif (value.length <= max) return value;\n\treturn `${value.slice(0, max - 1)}…`;\n}\n\nfunction formatBytes(bytes: number): string {\n\tif (bytes < 1024) return `${bytes} B`;\n\tif (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;\n\treturn `${(bytes / (1024 * 1024)).toFixed(1)} MB`;\n}\n"]}

package/dist/core/extensions/builtin/webfetch/webfetch/tool.d.ts

@@ -0,0 +1,28 @@
+import { Type } from "typebox";
+import { type WebfetchFormat } from "./fetcher.ts";
+export interface WebfetchDetails {
+    url: string;
+    finalUrl: string;
+    format: WebfetchFormat;
+    status: number;
+    statusText: string;
+    contentType: string;
+    bytes: number;
+    timeoutSeconds: number;
+    converted: boolean;
+    truncated: boolean;
+}
+export interface WebfetchProgressDetails {
+    phase: "fetching";
+    url: string;
+    format: WebfetchFormat;
+    timeoutSeconds: number;
+}
+export type WebfetchRenderDetails = WebfetchDetails | WebfetchProgressDetails;
+export declare const webfetch: import("../../../types.ts").ToolDefinition<Type.TObject<{
+    url: Type.TString;
+    format: Type.TOptional<Type.TUnsafe<"html" | "markdown" | "text">>;
+    timeout: Type.TOptional<Type.TNumber>;
+}>, WebfetchRenderDetails, any> & import("../../../types.ts").ToolDefinition<any, any, any>;
+export declare function parseWebfetchFormat(value: unknown): WebfetchFormat;
+//# sourceMappingURL=tool.d.ts.map

package/dist/core/extensions/builtin/webfetch/webfetch/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/webfetch/webfetch/tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAI/B,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAc3E,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,UAAU,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,qBAAqB,GAAG,eAAe,GAAG,uBAAuB,CAAC;AAE9E,eAAO,MAAM,QAAQ;;;;2FA2DnB,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAMlE"}

package/dist/core/extensions/builtin/webfetch/webfetch/tool.js

@@ -0,0 +1,79 @@
+import { StringEnum } from "@earendil-works/pi-ai";
+import { Type } from "typebox";
+import { defineTool } from "../../../types.js";
+import { htmlToMarkdown, htmlToText } from "./content.js";
+import { clampTimeout, fetchUrl } from "./fetcher.js";
+const WEBFETCH_FORMATS = ["markdown", "text", "html"];
+const Params = Type.Object({
+    url: Type.String({ description: "The URL to fetch content from" }),
+    format: Type.Optional(StringEnum(["markdown", "text", "html"], {
+        description: "The format to return the content in. Defaults to markdown.",
+    })),
+    timeout: Type.Optional(Type.Number({ description: "Optional timeout in seconds. Maximum 120." })),
+});
+export const webfetch = defineTool({
+    name: "webfetch",
+    label: "Web Fetch",
+    description: "Fetches content from a URL and returns it as markdown, plain text, or HTML. " +
+        "Network use is bounded by timeout and response size limits.",
+    promptSnippet: "webfetch: retrieve URL content as markdown, text, or html",
+    promptGuidelines: [
+        "Use webfetch when a specific URL must be retrieved.",
+        "Prefer markdown format unless raw HTML or plain text is explicitly needed.",
+        "The tool is read-only and does not modify files.",
+    ],
+    parameters: Params,
+    async execute(_toolCallId, params, signal, onUpdate, _ctx) {
+        const format = parseWebfetchFormat(params.format);
+        const timeoutSeconds = clampTimeout(params.timeout);
+        onUpdate?.({
+            content: [{ type: "text", text: `Fetching ${params.url} as ${format} (timeout ${timeoutSeconds}s)` }],
+            details: { phase: "fetching", url: params.url, format, timeoutSeconds },
+        });
+        const fetched = await fetchUrl({
+            url: params.url,
+            format,
+            timeoutSeconds,
+            ...(signal === undefined ? {} : { signal }),
+        });
+        const raw = new TextDecoder().decode(fetched.body);
+        const contentType = fetched.contentType.toLowerCase();
+        const isHtml = contentType.includes("text/html") || contentType.includes("application/xhtml+xml");
+        let text = raw;
+        let converted = false;
+        if (isHtml && format === "markdown") {
+            text = htmlToMarkdown(raw);
+            converted = true;
+        }
+        else if (isHtml && format === "text") {
+            text = htmlToText(raw);
+            converted = true;
+        }
+        const details = {
+            url: params.url,
+            finalUrl: fetched.url,
+            format,
+            status: fetched.status,
+            statusText: fetched.statusText,
+            contentType: fetched.contentType,
+            bytes: fetched.bytes,
+            timeoutSeconds,
+            converted,
+            truncated: fetched.truncated,
+        };
+        return {
+            content: [{ type: "text", text }],
+            details,
+        };
+    },
+});
+export function parseWebfetchFormat(value) {
+    if (value === undefined)
+        return "markdown";
+    for (const format of WEBFETCH_FORMATS) {
+        if (value === format)
+            return format;
+    }
+    return "markdown";
+}
+//# sourceMappingURL=tool.js.map

package/dist/core/extensions/builtin/webfetch/webfetch/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/webfetch/webfetch/tool.ts"],"names":[],"mappings":"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","sourcesContent":["import { StringEnum } from \"@earendil-works/pi-ai\";\nimport { Type } from \"typebox\";\nimport { defineTool } from \"../../../types.ts\";\n\nimport { htmlToMarkdown, htmlToText } from \"./content.ts\";\nimport { clampTimeout, fetchUrl, type WebfetchFormat } from \"./fetcher.ts\";\n\nconst WEBFETCH_FORMATS = [\"markdown\", \"text\", \"html\"] as const;\n\nconst Params = Type.Object({\n\turl: Type.String({ description: \"The URL to fetch content from\" }),\n\tformat: Type.Optional(\n\t\tStringEnum([\"markdown\", \"text\", \"html\"] as const, {\n\t\t\tdescription: \"The format to return the content in. Defaults to markdown.\",\n\t\t}),\n\t),\n\ttimeout: Type.Optional(Type.Number({ description: \"Optional timeout in seconds. Maximum 120.\" })),\n});\n\nexport interface WebfetchDetails {\n\turl: string;\n\tfinalUrl: string;\n\tformat: WebfetchFormat;\n\tstatus: number;\n\tstatusText: string;\n\tcontentType: string;\n\tbytes: number;\n\ttimeoutSeconds: number;\n\tconverted: boolean;\n\ttruncated: boolean;\n}\n\nexport interface WebfetchProgressDetails {\n\tphase: \"fetching\";\n\turl: string;\n\tformat: WebfetchFormat;\n\ttimeoutSeconds: number;\n}\n\nexport type WebfetchRenderDetails = WebfetchDetails | WebfetchProgressDetails;\n\nexport const webfetch = defineTool<typeof Params, WebfetchRenderDetails>({\n\tname: \"webfetch\",\n\tlabel: \"Web Fetch\",\n\tdescription:\n\t\t\"Fetches content from a URL and returns it as markdown, plain text, or HTML. \" +\n\t\t\"Network use is bounded by timeout and response size limits.\",\n\tpromptSnippet: \"webfetch: retrieve URL content as markdown, text, or html\",\n\tpromptGuidelines: [\n\t\t\"Use webfetch when a specific URL must be retrieved.\",\n\t\t\"Prefer markdown format unless raw HTML or plain text is explicitly needed.\",\n\t\t\"The tool is read-only and does not modify files.\",\n\t],\n\tparameters: Params,\n\tasync execute(_toolCallId, params, signal, onUpdate, _ctx) {\n\t\tconst format = parseWebfetchFormat(params.format);\n\t\tconst timeoutSeconds = clampTimeout(params.timeout);\n\t\tonUpdate?.({\n\t\t\tcontent: [{ type: \"text\", text: `Fetching ${params.url} as ${format} (timeout ${timeoutSeconds}s)` }],\n\t\t\tdetails: { phase: \"fetching\", url: params.url, format, timeoutSeconds },\n\t\t});\n\n\t\tconst fetched = await fetchUrl({\n\t\t\turl: params.url,\n\t\t\tformat,\n\t\t\ttimeoutSeconds,\n\t\t\t...(signal === undefined ? {} : { signal }),\n\t\t});\n\t\tconst raw = new TextDecoder().decode(fetched.body);\n\t\tconst contentType = fetched.contentType.toLowerCase();\n\t\tconst isHtml = contentType.includes(\"text/html\") || contentType.includes(\"application/xhtml+xml\");\n\t\tlet text = raw;\n\t\tlet converted = false;\n\n\t\tif (isHtml && format === \"markdown\") {\n\t\t\ttext = htmlToMarkdown(raw);\n\t\t\tconverted = true;\n\t\t} else if (isHtml && format === \"text\") {\n\t\t\ttext = htmlToText(raw);\n\t\t\tconverted = true;\n\t\t}\n\n\t\tconst details: WebfetchDetails = {\n\t\t\turl: params.url,\n\t\t\tfinalUrl: fetched.url,\n\t\t\tformat,\n\t\t\tstatus: fetched.status,\n\t\t\tstatusText: fetched.statusText,\n\t\t\tcontentType: fetched.contentType,\n\t\t\tbytes: fetched.bytes,\n\t\t\ttimeoutSeconds,\n\t\t\tconverted,\n\t\t\ttruncated: fetched.truncated,\n\t\t};\n\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text }],\n\t\t\tdetails,\n\t\t};\n\t},\n});\n\nexport function parseWebfetchFormat(value: unknown): WebfetchFormat {\n\tif (value === undefined) return \"markdown\";\n\tfor (const format of WEBFETCH_FORMATS) {\n\t\tif (value === format) return format;\n\t}\n\treturn \"markdown\";\n}\n"]}

package/dist/core/extensions/builtin/websearch/index.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "../../types.ts";
+export default function (pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/extensions/builtin/websearch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/websearch/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AA2BrE,MAAM,CAAC,OAAO,WAAW,EAAE,EAAE,YAAY,GAAG,IAAI,CAuE/C"}

package/dist/core/extensions/builtin/websearch/index.js

@@ -0,0 +1,76 @@
+import { loadWebsearchConfig } from "./websearch/config.js";
+import { createWebSearchTool } from "./websearch/tool.js";
+const STATUS_KEY = "pi-websearch";
+const WIDGET_KEY = "pi-websearch";
+const NATIVE_BYPASS_MESSAGE = "Native provider web search is handled by the built-in provider extension.";
+function isProviderNativeBypass(model) {
+    // kimi-coding uses the anthropic-messages protocol but its search is the kimi provider (native route), not Anthropic-native; must not be bypassed.
+    if (model?.provider === "kimi-coding")
+        return false;
+    return (model?.provider === "openai" ||
+        model?.provider === "anthropic" ||
+        model?.api === "anthropic-messages" ||
+        model?.api === "openai-responses" ||
+        model?.api === "azure-openai-responses");
+}
+export default function (pi) {
+    let state = {
+        ok: false,
+        reason: "missing_config",
+        message: "Missing websearch config. Create .pi/websearch.json or ~/.pi/websearch.json before starting pi.",
+    };
+    function providerLabel(provider) {
+        return provider.id ? `${provider.id}/${provider.provider}` : provider.provider;
+    }
+    function providerList(config) {
+        return config.providers.map(providerLabel).join(", ");
+    }
+    function clearUi(ctx) {
+        if (ctx.hasUI === false)
+            return;
+        ctx.ui.setStatus(STATUS_KEY, undefined);
+        ctx.ui.setWidget(WIDGET_KEY, undefined);
+    }
+    function updateUi(ctx) {
+        if (ctx.hasUI === false)
+            return;
+        if (state.ok) {
+            clearUi(ctx);
+            return;
+        }
+        if (state.reason === "provider_native_bypass") {
+            clearUi(ctx);
+            return;
+        }
+        clearUi(ctx);
+        ctx.ui.notify(state.message, "error");
+    }
+    pi.registerTool(createWebSearchTool(() => state));
+    pi.on("session_start", async (_event, ctx) => {
+        state = isProviderNativeBypass(ctx.model)
+            ? { ok: false, reason: "provider_native_bypass", message: NATIVE_BYPASS_MESSAGE }
+            : await loadWebsearchConfig({ cwd: ctx.cwd });
+        updateUi(ctx);
+    });
+    pi.on("session_shutdown", async (_event, ctx) => {
+        clearUi(ctx);
+    });
+    pi.registerCommand("websearch", {
+        description: "Show web search provider status",
+        handler: async (rawArgs, ctx) => {
+            const args = rawArgs.trim();
+            if (args !== "" && args !== "status") {
+                ctx.ui.notify("Usage: /websearch status", "warning");
+                return;
+            }
+            if (state.ok) {
+                ctx.ui.notify(`Web search active: strategy=${state.config.strategy}, auto=${state.config.auto ? "enabled" : "disabled"}, providers=${providerList(state.config)}`, "info");
+                return;
+            }
+            ctx.ui.notify(state.reason === "provider_native_bypass"
+                ? `Web search deferred: ${state.message}`
+                : `Web search inactive: ${state.message}`, state.reason === "provider_native_bypass" ? "info" : "error");
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/core/extensions/builtin/websearch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/websearch/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,MAAM,UAAU,GAAG,cAAc,CAAC;AAClC,MAAM,UAAU,GAAG,cAAc,CAAC;AAClC,MAAM,qBAAqB,GAAG,2EAA2E,CAAC;AAO1G,SAAS,sBAAsB,CAAC,KAAuC;IACtE,mJAAmJ;IACnJ,IAAI,KAAK,EAAE,QAAQ,KAAK,aAAa;QAAE,OAAO,KAAK,CAAC;IACpD,OAAO,CACN,KAAK,EAAE,QAAQ,KAAK,QAAQ;QAC5B,KAAK,EAAE,QAAQ,KAAK,WAAW;QAC/B,KAAK,EAAE,GAAG,KAAK,oBAAoB;QACnC,KAAK,EAAE,GAAG,KAAK,kBAAkB;QACjC,KAAK,EAAE,GAAG,KAAK,wBAAwB,CACvC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,OAAO,WAAW,EAAgB;IACxC,IAAI,KAAK,GAAqB;QAC7B,EAAE,EAAE,KAAK;QACT,MAAM,EAAE,gBAAgB;QACxB,OAAO,EAAE,iGAAiG;KAC1G,CAAC;IAEF,SAAS,aAAa,CAAC,QAA8C;QACpE,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAChF,CAAC;IAED,SAAS,YAAY,CAAC,MAAuB;QAC5C,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,SAAS,OAAO,CAAC,GAAqB;QACrC,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK;YAAE,OAAO;QAChC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACxC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,SAAS,QAAQ,CAAC,GAAqB;QACtC,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK;YAAE,OAAO;QAChC,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,CAAC;YACb,OAAO;QACR,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,wBAAwB,EAAE,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,CAAC;YACb,OAAO;QACR,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,CAAC;QACb,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,EAAE,CAAC,YAAY,CAAC,mBAAmB,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAElD,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QAC5C,KAAK,GAAG,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC;YACxC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,OAAO,EAAE,qBAAqB,EAAE;YACjF,CAAC,CAAC,MAAM,mBAAmB,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/C,QAAQ,CAAC,GAAG,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QAC/C,OAAO,CAAC,GAAG,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,eAAe,CAAC,WAAW,EAAE;QAC/B,WAAW,EAAE,iCAAiC;QAC9C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE;YAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,0BAA0B,EAAE,SAAS,CAAC,CAAC;gBACrD,OAAO;YACR,CAAC;YACD,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;gBACd,GAAG,CAAC,EAAE,CAAC,MAAM,CACZ,+BAA+B,KAAK,CAAC,MAAM,CAAC,QAAQ,UAAU,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,eAAe,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EACnJ,MAAM,CACN,CAAC;gBACF,OAAO;YACR,CAAC;YACD,GAAG,CAAC,EAAE,CAAC,MAAM,CACZ,KAAK,CAAC,MAAM,KAAK,wBAAwB;gBACxC,CAAC,CAAC,wBAAwB,KAAK,CAAC,OAAO,EAAE;gBACzC,CAAC,CAAC,wBAAwB,KAAK,CAAC,OAAO,EAAE,EAC1C,KAAK,CAAC,MAAM,KAAK,wBAAwB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAC5D,CAAC;QACH,CAAC;KACD,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import type { ExtensionAPI, ExtensionContext } from \"../../types.ts\";\n\nimport { loadWebsearchConfig } from \"./websearch/config.ts\";\nimport { createWebSearchTool } from \"./websearch/tool.ts\";\nimport type { ConfigLoadResult, WebsearchConfig } from \"./websearch/types.ts\";\n\nconst STATUS_KEY = \"pi-websearch\";\nconst WIDGET_KEY = \"pi-websearch\";\nconst NATIVE_BYPASS_MESSAGE = \"Native provider web search is handled by the built-in provider extension.\";\n\ntype ProviderModelContext = {\n\tprovider?: string;\n\tapi?: string;\n};\n\nfunction isProviderNativeBypass(model: ProviderModelContext | undefined): boolean {\n\t// kimi-coding uses the anthropic-messages protocol but its search is the kimi provider (native route), not Anthropic-native; must not be bypassed.\n\tif (model?.provider === \"kimi-coding\") return false;\n\treturn (\n\t\tmodel?.provider === \"openai\" ||\n\t\tmodel?.provider === \"anthropic\" ||\n\t\tmodel?.api === \"anthropic-messages\" ||\n\t\tmodel?.api === \"openai-responses\" ||\n\t\tmodel?.api === \"azure-openai-responses\"\n\t);\n}\n\nexport default function (pi: ExtensionAPI): void {\n\tlet state: ConfigLoadResult = {\n\t\tok: false,\n\t\treason: \"missing_config\",\n\t\tmessage: \"Missing websearch config. Create .pi/websearch.json or ~/.pi/websearch.json before starting pi.\",\n\t};\n\n\tfunction providerLabel(provider: WebsearchConfig[\"providers\"][number]): string {\n\t\treturn provider.id ? `${provider.id}/${provider.provider}` : provider.provider;\n\t}\n\n\tfunction providerList(config: WebsearchConfig): string {\n\t\treturn config.providers.map(providerLabel).join(\", \");\n\t}\n\n\tfunction clearUi(ctx: ExtensionContext): void {\n\t\tif (ctx.hasUI === false) return;\n\t\tctx.ui.setStatus(STATUS_KEY, undefined);\n\t\tctx.ui.setWidget(WIDGET_KEY, undefined);\n\t}\n\n\tfunction updateUi(ctx: ExtensionContext): void {\n\t\tif (ctx.hasUI === false) return;\n\t\tif (state.ok) {\n\t\t\tclearUi(ctx);\n\t\t\treturn;\n\t\t}\n\t\tif (state.reason === \"provider_native_bypass\") {\n\t\t\tclearUi(ctx);\n\t\t\treturn;\n\t\t}\n\t\tclearUi(ctx);\n\t\tctx.ui.notify(state.message, \"error\");\n\t}\n\n\tpi.registerTool(createWebSearchTool(() => state));\n\n\tpi.on(\"session_start\", async (_event, ctx) => {\n\t\tstate = isProviderNativeBypass(ctx.model)\n\t\t\t? { ok: false, reason: \"provider_native_bypass\", message: NATIVE_BYPASS_MESSAGE }\n\t\t\t: await loadWebsearchConfig({ cwd: ctx.cwd });\n\t\tupdateUi(ctx);\n\t});\n\n\tpi.on(\"session_shutdown\", async (_event, ctx) => {\n\t\tclearUi(ctx);\n\t});\n\n\tpi.registerCommand(\"websearch\", {\n\t\tdescription: \"Show web search provider status\",\n\t\thandler: async (rawArgs, ctx) => {\n\t\t\tconst args = rawArgs.trim();\n\t\t\tif (args !== \"\" && args !== \"status\") {\n\t\t\t\tctx.ui.notify(\"Usage: /websearch status\", \"warning\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (state.ok) {\n\t\t\t\tctx.ui.notify(\n\t\t\t\t\t`Web search active: strategy=${state.config.strategy}, auto=${state.config.auto ? \"enabled\" : \"disabled\"}, providers=${providerList(state.config)}`,\n\t\t\t\t\t\"info\",\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tctx.ui.notify(\n\t\t\t\tstate.reason === \"provider_native_bypass\"\n\t\t\t\t\t? `Web search deferred: ${state.message}`\n\t\t\t\t\t: `Web search inactive: ${state.message}`,\n\t\t\t\tstate.reason === \"provider_native_bypass\" ? \"info\" : \"error\",\n\t\t\t);\n\t\t},\n\t});\n}\n"]}

package/dist/core/extensions/builtin/websearch/websearch/config.d.ts

@@ -0,0 +1,12 @@
+import type { ConfigLoadResult, ProviderValidationResult, SearchProviderEntry, WebsearchConfig } from "./types.ts";
+export interface ConfigLoadOptions {
+    cwd: string;
+    homeDir?: string;
+}
+export declare function validateProviderConfig(config: SearchProviderEntry): ProviderValidationResult;
+export declare function validateWebsearchConfig(config: WebsearchConfig): ProviderValidationResult | {
+    ok: true;
+    config: WebsearchConfig;
+};
+export declare function loadWebsearchConfig(options: ConfigLoadOptions): Promise<ConfigLoadResult>;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/extensions/builtin/websearch/websearch/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/websearch/websearch/config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEX,gBAAgB,EAGhB,wBAAwB,EAKxB,mBAAmB,EAEnB,eAAe,EACf,MAAM,YAAY,CAAC;AA2BpB,MAAM,WAAW,iBAAiB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AA8HD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,wBAAwB,CA+C5F;AAED,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,eAAe,GACrB,wBAAwB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAiBlE;AAWD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwB/F"}