@osovv/vv-opencode 1.1.5 → 1.2.0

package/dist/plugins/web-tools/media-loader.js

@@ -0,0 +1,178 @@
+// FILE: src/plugins/web-tools/media-loader.ts
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Load supported images and PDFs as base64 file attachments for the web tools fetch path.
+//   SCOPE: MIME and magic-byte identification, base64 data-URL attachment construction, filename derivation, and rejection of unsupported or oversized payloads.
+//   DEPENDS: [src/plugins/web-tools/http.ts, @opencode-ai/plugin]
+//   LINKS: [M-WEB-MEDIA-LOADER, M-WEB-HTTP, M-WEB-NATIVE-FETCH, M-WEB-SPIDER]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   SUPPORTED_MEDIA_MIME_TYPES - Tuple of supported media MIME types.
+//   SupportedMediaMimeType - Supported media MIME type union.
+//   WebMediaError - Unsupported-media error carrying the detected or declared MIME type.
+//   sniffMediaMimeType - Detect a supported MIME type from leading bytes.
+//   mediaAttachmentFromBytes - Build a base64 data-URL attachment from already-fetched bytes.
+//   loadMediaAttachment - Fetch a URL and return it as an attachment when supported.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v1.0.0 - Initial direct media attachment loader for the unified web tools.]
+// END_CHANGE_SUMMARY
+import { DEFAULT_MEDIA_MAX_BYTES, DEFAULT_REQUEST_TIMEOUT_MS, requestBounded, WebHttpError, } from "./http.js";
+export const SUPPORTED_MEDIA_MIME_TYPES = [
+    "image/jpeg",
+    "image/png",
+    "image/gif",
+    "image/webp",
+    "application/pdf",
+];
+/** Unsupported-media failure. The message names the detected or declared MIME type and never includes the payload. */
+export class WebMediaError extends Error {
+    code;
+    mime;
+    constructor(message, mime) {
+        super(message);
+        this.name = "WebMediaError";
+        this.code = "UNSUPPORTED";
+        this.mime = mime;
+    }
+}
+const EXTENSION_BY_MIME = {
+    "image/jpeg": ".jpg",
+    "image/png": ".png",
+    "image/gif": ".gif",
+    "image/webp": ".webp",
+    "application/pdf": ".pdf",
+};
+// START_BLOCK_SNIFF
+/**
+ * Sniff the media MIME type from leading bytes.
+ * Returns undefined when the signature matches no supported format.
+ */
+export function sniffMediaMimeType(bytes) {
+    if (bytes.length >= 3 && bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff) {
+        return "image/jpeg";
+    }
+    if (bytes.length >= 4 &&
+        bytes[0] === 0x89 &&
+        bytes[1] === 0x50 &&
+        bytes[2] === 0x4e &&
+        bytes[3] === 0x47) {
+        return "image/png";
+    }
+    if (bytes.length >= 4 &&
+        bytes[0] === 0x47 &&
+        bytes[1] === 0x49 &&
+        bytes[2] === 0x46 &&
+        bytes[3] === 0x38) {
+        return "image/gif";
+    }
+    if (bytes.length >= 12 &&
+        bytes[0] === 0x52 &&
+        bytes[1] === 0x49 &&
+        bytes[2] === 0x46 &&
+        bytes[3] === 0x46 &&
+        bytes[8] === 0x57 &&
+        bytes[9] === 0x45 &&
+        bytes[10] === 0x42 &&
+        bytes[11] === 0x50) {
+        return "image/webp";
+    }
+    if (bytes.length >= 4 &&
+        bytes[0] === 0x25 &&
+        bytes[1] === 0x50 &&
+        bytes[2] === 0x44 &&
+        bytes[3] === 0x46) {
+        return "application/pdf";
+    }
+    return undefined;
+}
+// END_BLOCK_SNIFF
+// START_BLOCK_HELPERS
+function normalizeDeclaredContentType(declared) {
+    if (!declared) {
+        return undefined;
+    }
+    const mime = declared.split(";")[0]?.trim().toLowerCase();
+    return mime || undefined;
+}
+function filenameFromUrl(url, mime) {
+    const extension = EXTENSION_BY_MIME[mime];
+    try {
+        const base = new URL(url).pathname.split("/").pop() ?? "";
+        if (base && base.includes(".")) {
+            return base;
+        }
+        if (base) {
+            return `${base}${extension}`;
+        }
+        return `resource${extension}`;
+    }
+    catch {
+        return `resource${extension}`;
+    }
+}
+function resolveMimeType(bytes, declaredContentType) {
+    const sniffed = sniffMediaMimeType(bytes);
+    if (sniffed) {
+        return sniffed;
+    }
+    const declared = normalizeDeclaredContentType(declaredContentType);
+    if (declared && SUPPORTED_MEDIA_MIME_TYPES.includes(declared)) {
+        return declared;
+    }
+    return undefined;
+}
+// END_BLOCK_HELPERS
+// START_CONTRACT: mediaAttachmentFromBytes
+//   PURPOSE: Build a base64 data-URL file attachment from already-fetched bytes.
+//   INPUTS: { bytes: payload; source: url, declaredContentType, optional maxBytes }
+//   OUTPUTS: { ToolAttachment - type file, mime, data URL, filename }
+//   SIDE_EFFECTS: none; performs no network I/O
+//   LINKS: M-WEB-NATIVE-FETCH, M-WEB-SPIDER
+// END_CONTRACT: mediaAttachmentFromBytes
+export function mediaAttachmentFromBytes(bytes, source) {
+    const maxBytes = source.maxBytes ?? DEFAULT_MEDIA_MAX_BYTES;
+    if (bytes.byteLength > maxBytes) {
+        throw new WebHttpError("OVERSIZED", `media payload exceeded ${maxBytes} bytes`);
+    }
+    const mime = resolveMimeType(bytes, source.declaredContentType);
+    if (!mime) {
+        const detail = sniffMediaMimeType(bytes) ??
+            normalizeDeclaredContentType(source.declaredContentType) ??
+            "unknown";
+        throw new WebMediaError(`unsupported media type: ${detail}`, detail === "unknown" ? undefined : detail);
+    }
+    const base64 = Buffer.from(bytes).toString("base64");
+    return {
+        type: "file",
+        mime,
+        url: `data:${mime};base64,${base64}`,
+        filename: filenameFromUrl(source.url, mime),
+    };
+}
+// START_CONTRACT: loadMediaAttachment
+//   PURPOSE: Fetch a URL through the bounded transport and return it as an attachment when supported.
+//   INPUTS: { input: url, optional abort, timeoutMs, maxBytes; fetchImpl: injectable fetch }
+//   OUTPUTS: { ToolAttachment }
+//   SIDE_EFFECTS: performs network I/O through fetchImpl
+//   LINKS: M-WEB-HTTP
+// END_CONTRACT: loadMediaAttachment
+export async function loadMediaAttachment(input, fetchImpl) {
+    const maxBytes = input.maxBytes ?? DEFAULT_MEDIA_MAX_BYTES;
+    const response = await requestBounded({
+        url: input.url,
+        timeoutMs: input.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
+        maxBytes,
+        abort: input.abort,
+    }, fetchImpl);
+    return mediaAttachmentFromBytes(response.bytes, {
+        url: response.finalUrl,
+        declaredContentType: response.headers.get("content-type") ?? undefined,
+        maxBytes,
+    });
+}
+//# sourceMappingURL=media-loader.js.map

package/dist/plugins/web-tools/media-loader.js.map

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

package/dist/plugins/web-tools/providers/brave.d.ts

@@ -0,0 +1,3 @@
+import { type FetchLike } from "../http.js";
+import { type WebSearchInput, type WebSearchResult } from "./exa.js";
+export declare function searchBrave(input: WebSearchInput, fetchImpl?: FetchLike): Promise<WebSearchResult[]>;

package/dist/plugins/web-tools/providers/brave.js

@@ -0,0 +1,101 @@
+// FILE: src/plugins/web-tools/providers/brave.ts
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Call the Brave Web Search endpoint directly and normalize web results for the web_search tool.
+//   SCOPE: Brave request construction with X-Subscription-Token auth, count and freshness mapping, moderate safe search, and web result normalization.
+//   DEPENDS: [src/plugins/web-tools/http.ts, src/plugins/web-tools/providers/exa.ts]
+//   LINKS: [M-WEB-BRAVE, M-WEB-HTTP, M-WEB-SEARCH-SERVICE]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   searchBrave - Execute one Brave Web Search.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v1.0.0 - Initial Brave Web Search adapter.]
+// END_CHANGE_SUMMARY
+import { DEFAULT_TEXT_MAX_BYTES, requestBounded, } from "../http.js";
+import { mapHttpErrorToProviderError, WebProviderError, } from "./exa.js";
+const BRAVE_SEARCH_URL = "https://api.search.brave.com/res/v1/web/search";
+const BRAVE_FRESHNESS = { day: "pd", week: "pw", month: "pm", year: "py" };
+// START_BLOCK_HELPERS
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizeBraveResult(item) {
+    if (!isPlainObject(item)) {
+        return undefined;
+    }
+    const url = typeof item.url === "string" ? item.url : undefined;
+    if (!url) {
+        return undefined;
+    }
+    const title = typeof item.title === "string" && item.title.length > 0 ? item.title : url;
+    const snippet = typeof item.description === "string" && item.description.length > 0
+        ? item.description
+        : undefined;
+    const publishedAt = typeof item.page_age === "string" ? item.page_age : undefined;
+    return {
+        title,
+        url,
+        ...(snippet ? { snippet } : {}),
+        ...(publishedAt ? { publishedAt } : {}),
+    };
+}
+function parseBraveResults(bytes) {
+    let parsed;
+    try {
+        parsed = JSON.parse(new TextDecoder().decode(bytes));
+    }
+    catch {
+        throw new WebProviderError("brave", "BAD_RESPONSE", "malformed JSON response from brave");
+    }
+    const web = isPlainObject(parsed) ? parsed.web : undefined;
+    const results = isPlainObject(web) && Array.isArray(web.results) ? web.results : undefined;
+    if (!results) {
+        throw new WebProviderError("brave", "BAD_RESPONSE", "unexpected brave response envelope");
+    }
+    return results
+        .map(normalizeBraveResult)
+        .filter((result) => result !== undefined);
+}
+// END_BLOCK_HELPERS
+// START_CONTRACT: searchBrave
+//   PURPOSE: GET the Brave Web Search endpoint with X-Subscription-Token auth and normalize web.results.
+//   INPUTS: { input: WebSearchInput; fetchImpl: injectable fetch }
+//   OUTPUTS: { WebSearchResult[] - ranked results, empty array when none }
+//   SIDE_EFFECTS: performs network I/O through fetchImpl; never logs the credential
+//   LINKS: M-WEB-SEARCH-SERVICE
+// END_CONTRACT: searchBrave
+export async function searchBrave(input, fetchImpl) {
+    const params = new URLSearchParams();
+    params.set("q", input.query);
+    params.set("count", String(input.count));
+    params.set("safesearch", "moderate");
+    if (input.freshness) {
+        params.set("freshness", BRAVE_FRESHNESS[input.freshness]);
+    }
+    const url = `${BRAVE_SEARCH_URL}?${params.toString()}`;
+    let response;
+    try {
+        response = await requestBounded({
+            url,
+            method: "GET",
+            headers: {
+                "X-Subscription-Token": input.credential.value,
+                accept: "application/json",
+            },
+            timeoutMs: input.timeoutMs,
+            maxBytes: DEFAULT_TEXT_MAX_BYTES,
+            abort: input.abort,
+        }, fetchImpl);
+    }
+    catch (error) {
+        mapHttpErrorToProviderError(error, "brave");
+        throw error;
+    }
+    return parseBraveResults(response.bytes);
+}
+//# sourceMappingURL=brave.js.map

package/dist/plugins/web-tools/providers/brave.js.map

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

package/dist/plugins/web-tools/providers/exa.d.ts

@@ -0,0 +1,28 @@
+import type { WebProviderCredential } from "../config.js";
+import { type FetchLike } from "../http.js";
+export type WebProviderName = "exa" | "brave" | "spider" | "native" | "zai";
+export type WebProviderErrorCode = "AUTH_FAILED" | "RATE_LIMITED" | "PROVIDER_ERROR" | "BAD_RESPONSE" | "MISSING_CREDENTIAL" | "UNSUPPORTED" | "CONVERSION_FAILED";
+/** Provider-facing search or scrape error. Messages name the provider and never include the credential. */
+export declare class WebProviderError extends Error {
+    readonly provider: WebProviderName;
+    readonly code: WebProviderErrorCode;
+    readonly status?: number;
+    constructor(provider: WebProviderName, code: WebProviderErrorCode, message: string, status?: number);
+}
+export type WebSearchResult = {
+    title: string;
+    url: string;
+    snippet?: string;
+    publishedAt?: string;
+};
+export type WebSearchInput = {
+    query: string;
+    count: number;
+    freshness?: "day" | "week" | "month" | "year";
+    credential: WebProviderCredential;
+    abort: AbortSignal;
+    timeoutMs: number;
+};
+/** Map a bounded-transport HTTP error to a provider error; re-throw timeout, abort, oversized, and network errors unchanged. */
+export declare function mapHttpErrorToProviderError(error: unknown, provider: WebProviderName): never;
+export declare function searchExa(input: WebSearchInput, fetchImpl?: FetchLike): Promise<WebSearchResult[]>;

package/dist/plugins/web-tools/providers/exa.js

@@ -0,0 +1,138 @@
+// FILE: src/plugins/web-tools/providers/exa.ts
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Call the official Exa Search API directly and normalize ranked results for the web_search tool.
+//   SCOPE: Exa request construction with x-api-key auth, count and freshness mapping, result normalization, and provider error mapping. Also owns the shared provider search types and WebProviderError used by sibling adapters.
+//   DEPENDS: [src/plugins/web-tools/http.ts, src/plugins/web-tools/config.ts]
+//   LINKS: [M-WEB-EXA, M-WEB-HTTP, M-WEB-SEARCH-SERVICE]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   WebProviderName - Provider identifiers for error attribution.
+//   WebProviderErrorCode - Provider-facing error codes.
+//   WebProviderError - Provider error carrying provider, code, and optional status.
+//   WebSearchResult - Normalized ranked search result.
+//   WebSearchInput - Provider-neutral search input.
+//   mapHttpErrorToProviderError - Map bounded HTTP status failures into credential-safe provider errors.
+//   searchExa - Execute one Exa search.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [C-ZAI-DIRECT-WEB-PROVIDERS - Extended shared provider error attribution with the direct zai adapter.]
+//   LAST_CHANGE: [v1.0.0 - Initial Exa Search API adapter and shared provider search contracts.]
+// END_CHANGE_SUMMARY
+import { DEFAULT_TEXT_MAX_BYTES, requestBounded, WebHttpError, } from "../http.js";
+/** Provider-facing search or scrape error. Messages name the provider and never include the credential. */
+export class WebProviderError extends Error {
+    provider;
+    code;
+    status;
+    constructor(provider, code, message, status) {
+        super(message);
+        this.name = "WebProviderError";
+        this.provider = provider;
+        this.code = code;
+        this.status = status;
+    }
+}
+const EXA_SEARCH_URL = "https://api.exa.ai/search";
+const FRESHNESS_DAYS = { day: 1, week: 7, month: 31, year: 365 };
+// START_BLOCK_HELPERS
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function freshnessToDate(freshness) {
+    const ms = Date.now() - FRESHNESS_DAYS[freshness] * 24 * 60 * 60 * 1000;
+    return new Date(ms).toISOString();
+}
+/** Map a bounded-transport HTTP error to a provider error; re-throw timeout, abort, oversized, and network errors unchanged. */
+export function mapHttpErrorToProviderError(error, provider) {
+    if (error instanceof WebHttpError && error.code === "HTTP_ERROR") {
+        const status = error.status ?? 0;
+        if (status === 401 || status === 403) {
+            throw new WebProviderError(provider, "AUTH_FAILED", `${provider} authentication failed`, status);
+        }
+        if (status === 429) {
+            throw new WebProviderError(provider, "RATE_LIMITED", `${provider} rate limit exceeded`, status);
+        }
+        throw new WebProviderError(provider, "PROVIDER_ERROR", `${provider} server error HTTP ${status}`, status);
+    }
+    throw error;
+}
+function normalizeExaResult(item) {
+    if (!isPlainObject(item)) {
+        return undefined;
+    }
+    const url = typeof item.url === "string" ? item.url : undefined;
+    if (!url) {
+        return undefined;
+    }
+    const title = typeof item.title === "string" && item.title.length > 0 ? item.title : url;
+    const highlights = Array.isArray(item.highlights)
+        ? item.highlights.filter((entry) => typeof entry === "string")
+        : [];
+    const snippet = highlights[0];
+    const publishedAt = typeof item.publishedDate === "string" ? item.publishedDate : undefined;
+    return {
+        title,
+        url,
+        ...(snippet ? { snippet } : {}),
+        ...(publishedAt ? { publishedAt } : {}),
+    };
+}
+function parseExaResults(bytes) {
+    let parsed;
+    try {
+        parsed = JSON.parse(new TextDecoder().decode(bytes));
+    }
+    catch {
+        throw new WebProviderError("exa", "BAD_RESPONSE", "malformed JSON response from exa");
+    }
+    if (!isPlainObject(parsed) || !Array.isArray(parsed.results)) {
+        throw new WebProviderError("exa", "BAD_RESPONSE", "unexpected exa response envelope");
+    }
+    return parsed.results
+        .map(normalizeExaResult)
+        .filter((result) => result !== undefined);
+}
+// END_BLOCK_HELPERS
+// START_CONTRACT: searchExa
+//   PURPOSE: POST https://api.exa.ai/search with x-api-key auth and normalize results.
+//   INPUTS: { input: WebSearchInput; fetchImpl: injectable fetch }
+//   OUTPUTS: { WebSearchResult[] - ranked results, empty array when none }
+//   SIDE_EFFECTS: performs network I/O through fetchImpl; never logs the credential
+//   LINKS: M-WEB-SEARCH-SERVICE
+// END_CONTRACT: searchExa
+export async function searchExa(input, fetchImpl) {
+    const body = JSON.stringify({
+        query: input.query,
+        type: "auto",
+        numResults: input.count,
+        contents: { highlights: { query: input.query, numSentences: 3 } },
+        ...(input.freshness ? { startPublishedDate: freshnessToDate(input.freshness) } : {}),
+    });
+    let response;
+    try {
+        response = await requestBounded({
+            url: EXA_SEARCH_URL,
+            method: "POST",
+            headers: {
+                "x-api-key": input.credential.value,
+                "content-type": "application/json",
+                accept: "application/json",
+            },
+            body,
+            timeoutMs: input.timeoutMs,
+            maxBytes: DEFAULT_TEXT_MAX_BYTES,
+            abort: input.abort,
+        }, fetchImpl);
+    }
+    catch (error) {
+        mapHttpErrorToProviderError(error, "exa");
+        throw error;
+    }
+    return parseExaResults(response.bytes);
+}
+//# sourceMappingURL=exa.js.map

package/dist/plugins/web-tools/providers/exa.js.map

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

package/dist/plugins/web-tools/providers/native-fetch.d.ts

@@ -0,0 +1,21 @@
+import type { ToolAttachment } from "@opencode-ai/plugin";
+import { type FetchLike } from "../http.js";
+export type NativeFetchOutcome = {
+    kind: "text";
+    content: string;
+    contentType: string;
+    finalUrl: string;
+    status: number;
+} | {
+    kind: "media";
+    attachment: ToolAttachment;
+    finalUrl: string;
+    status: number;
+};
+export declare function fetchNative(input: {
+    url: string;
+    format: "markdown" | "text" | "html";
+    abort: AbortSignal;
+    timeoutMs: number;
+    maxBytes?: number;
+}, fetchImpl?: FetchLike): Promise<NativeFetchOutcome>;

package/dist/plugins/web-tools/providers/native-fetch.js

@@ -0,0 +1,112 @@
+// FILE: src/plugins/web-tools/providers/native-fetch.ts
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Fetch HTTP and HTTPS resources directly and dispatch the body to media, HTML conversion, or plain text passthrough.
+//   SCOPE: Redirect following and size limits via the bounded transport, MIME and signature sniffing, local HTML conversion, and rejection of unsupported binaries.
+//   DEPENDS: [src/plugins/web-tools/http.ts, src/plugins/web-tools/html-markdown.ts, src/plugins/web-tools/media-loader.ts, src/plugins/web-tools/providers/exa.ts, @opencode-ai/plugin]
+//   LINKS: [M-WEB-NATIVE-FETCH, M-WEB-HTTP, M-WEB-HTML-MARKDOWN, M-WEB-MEDIA-LOADER]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   NativeFetchOutcome - Text or media outcome of a native fetch.
+//   fetchNative - Fetch one URL and dispatch its body by content.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v1.0.0 - Initial native fetch provider with local conversion.]
+// END_CHANGE_SUMMARY
+import { convertHtmlToMarkdown, convertHtmlToText } from "../html-markdown.js";
+import { DEFAULT_MEDIA_MAX_BYTES, DEFAULT_TEXT_MAX_BYTES, requestBounded, WebHttpError, } from "../http.js";
+import { mediaAttachmentFromBytes, sniffMediaMimeType, SUPPORTED_MEDIA_MIME_TYPES, } from "../media-loader.js";
+import { WebProviderError } from "./exa.js";
+const STRUCTURED_TEXT_TYPES = new Set([
+    "application/json",
+    "application/xml",
+    "text/xml",
+    "application/javascript",
+    "text/javascript",
+]);
+// START_BLOCK_HELPERS
+function normalizeContentType(declared) {
+    if (!declared) {
+        return undefined;
+    }
+    const mime = declared.split(";")[0]?.trim().toLowerCase();
+    return mime || undefined;
+}
+function isSupportedMediaMime(mime) {
+    return SUPPORTED_MEDIA_MIME_TYPES.includes(mime);
+}
+function isTextLike(mime) {
+    if (!mime) {
+        return true;
+    }
+    if (mime.startsWith("text/")) {
+        return true;
+    }
+    if (STRUCTURED_TEXT_TYPES.has(mime)) {
+        return true;
+    }
+    return mime.endsWith("+json") || mime.endsWith("+xml");
+}
+function looksLikeHtml(mime, text) {
+    if (mime === "text/html" || mime === "application/xhtml+xml") {
+        return true;
+    }
+    if (!mime || mime === "application/octet-stream") {
+        return /<\s*(html|body|div|p|h[1-6]|table)\b/i.test(text.slice(0, 2000));
+    }
+    return false;
+}
+// END_BLOCK_HELPERS
+// START_CONTRACT: fetchNative
+//   PURPOSE: Fetch one URL through the bounded transport with redirects followed and dispatch the body by content.
+//   INPUTS: { input: url, format, abort, timeoutMs, optional maxBytes; fetchImpl: injectable fetch }
+//   OUTPUTS: { NativeFetchOutcome - text or media }
+//   SIDE_EFFECTS: performs network I/O through fetchImpl
+//   LINKS: M-WEB-FETCH-SERVICE
+// END_CONTRACT: fetchNative
+export async function fetchNative(input, fetchImpl) {
+    const downloadCap = input.maxBytes ?? DEFAULT_MEDIA_MAX_BYTES;
+    const response = await requestBounded({
+        url: input.url,
+        timeoutMs: input.timeoutMs,
+        maxBytes: downloadCap,
+        abort: input.abort,
+    }, fetchImpl);
+    const declared = normalizeContentType(response.headers.get("content-type") ?? undefined);
+    const sniffed = sniffMediaMimeType(response.bytes);
+    if (sniffed || (declared && isSupportedMediaMime(declared))) {
+        const attachment = mediaAttachmentFromBytes(response.bytes, {
+            url: response.finalUrl,
+            declaredContentType: declared,
+            maxBytes: downloadCap,
+        });
+        return { kind: "media", attachment, finalUrl: response.finalUrl, status: response.status };
+    }
+    if (isTextLike(declared)) {
+        const textCap = input.maxBytes ?? DEFAULT_TEXT_MAX_BYTES;
+        if (response.bytes.byteLength > textCap) {
+            throw new WebHttpError("OVERSIZED", `text response exceeded ${textCap} bytes`);
+        }
+        const text = new TextDecoder().decode(response.bytes);
+        const content = looksLikeHtml(declared, text)
+            ? input.format === "markdown"
+                ? convertHtmlToMarkdown(text)
+                : input.format === "text"
+                    ? convertHtmlToText(text)
+                    : text
+            : text;
+        return {
+            kind: "text",
+            content,
+            contentType: declared ?? "text/plain",
+            finalUrl: response.finalUrl,
+            status: response.status,
+        };
+    }
+    throw new WebProviderError("native", "UNSUPPORTED", `unsupported content type: ${declared ?? "unknown"}`);
+}
+//# sourceMappingURL=native-fetch.js.map

package/dist/plugins/web-tools/providers/native-fetch.js.map

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

package/dist/plugins/web-tools/providers/spider.d.ts

@@ -0,0 +1,25 @@
+import type { ToolAttachment } from "@opencode-ai/plugin";
+import type { WebProviderCredential } from "../config.js";
+import { type FetchLike } from "../http.js";
+export type SpiderOutcome = {
+    kind: "text";
+    content: string;
+    metadata: {
+        status?: number;
+        durationMs?: number;
+    };
+} | {
+    kind: "media";
+    attachment: ToolAttachment;
+    metadata: {
+        status?: number;
+        durationMs?: number;
+    };
+};
+export declare function scrapeSpider(input: {
+    url: string;
+    format: "markdown" | "text" | "html";
+    credential: WebProviderCredential;
+    abort: AbortSignal;
+    timeoutMs: number;
+}, fetchImpl?: FetchLike): Promise<SpiderOutcome>;