@osovv/vv-opencode 1.1.6 → 1.2.0

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":"AAAA,wDAAwD;AACxD,iBAAiB;AACjB,wBAAwB;AACxB,iIAAiI;AACjI,oKAAoK;AACpK,yLAAyL;AACzL,qFAAqF;AACrF,kBAAkB;AAClB,sBAAsB;AACtB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,kEAAkE;AAClE,kEAAkE;AAClE,iBAAiB;AACjB,EAAE;AACF,uBAAuB;AACvB,iFAAiF;AACjF,qBAAqB;AAGrB,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACd,YAAY,GAEb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAiB5C,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,kBAAkB;IAClB,iBAAiB;IACjB,UAAU;IACV,wBAAwB;IACxB,iBAAiB;CAClB,CAAC,CAAC;AAEH,sBAAsB;AACtB,SAAS,oBAAoB,CAAC,QAAiB;IAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1D,OAAO,IAAI,IAAI,SAAS,CAAC;AAC3B,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,OAAQ,0BAAgD,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,UAAU,CAAC,IAAwB;IAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,aAAa,CAAC,IAAwB,EAAE,IAAY;IAC3D,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,uBAAuB,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,0BAA0B,EAAE,CAAC;QACjD,OAAO,uCAAuC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AACD,oBAAoB;AAEpB,8BAA8B;AAC9B,mHAAmH;AACnH,qGAAqG;AACrG,oDAAoD;AACpD,yDAAyD;AACzD,+BAA+B;AAC/B,4BAA4B;AAC5B,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAMC,EACD,SAAqB;IAErB,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,IAAI,uBAAuB,CAAC;IAC9D,MAAM,QAAQ,GAAG,MAAM,cAAc,CACnC;QACE,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,EACD,SAAS,CACV,CAAC;IAEF,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC,CAAC;IACzF,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEnD,IAAI,OAAO,IAAI,CAAC,QAAQ,IAAI,oBAAoB,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,UAAU,GAAG,wBAAwB,CAAC,QAAQ,CAAC,KAAK,EAAE;YAC1D,GAAG,EAAE,QAAQ,CAAC,QAAQ;YACtB,mBAAmB,EAAE,QAAQ;YAC7B,QAAQ,EAAE,WAAW;SACtB,CAAC,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC7F,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,IAAI,sBAAsB,CAAC;QACzD,IAAI,QAAQ,CAAC,KAAK,CAAC,UAAU,GAAG,OAAO,EAAE,CAAC;YACxC,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,0BAA0B,OAAO,QAAQ,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC;YAC3C,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,UAAU;gBAC3B,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC;gBAC7B,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM;oBACvB,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC;oBACzB,CAAC,CAAC,IAAI;YACV,CAAC,CAAC,IAAI,CAAC;QACT,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,OAAO;YACP,WAAW,EAAE,QAAQ,IAAI,YAAY;YACrC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;SACxB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,gBAAgB,CACxB,QAAQ,EACR,aAAa,EACb,6BAA6B,QAAQ,IAAI,SAAS,EAAE,CACrD,CAAC;AACJ,CAAC"}

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>;

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

@@ -0,0 +1,104 @@
+// FILE: src/plugins/web-tools/providers/spider.ts
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Call the Spider.cloud Scrape API for one exact URL and serve binary targets through the shared direct media loader.
+//   SCOPE: Bearer auth, mapped return_format, array envelope validation, status and duration metadata, provider error mapping, and media-first dispatch.
+//   DEPENDS: [src/plugins/web-tools/http.ts, src/plugins/web-tools/config.ts, src/plugins/web-tools/media-loader.ts, src/plugins/web-tools/providers/exa.ts, @opencode-ai/plugin]
+//   LINKS: [M-WEB-SPIDER, M-WEB-HTTP, M-WEB-MEDIA-LOADER, M-WEB-FETCH-SERVICE]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   SpiderOutcome - Text or media outcome of a Spider scrape.
+//   scrapeSpider - Serve media targets directly, otherwise scrape one URL through Spider.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v1.0.0 - Initial Spider Scrape adapter.]
+// END_CHANGE_SUMMARY
+import { DEFAULT_TEXT_MAX_BYTES, requestBounded, } from "../http.js";
+import { loadMediaAttachment, WebMediaError } from "../media-loader.js";
+import { mapHttpErrorToProviderError, WebProviderError } from "./exa.js";
+const SPIDER_SCRAPE_URL = "https://api.spider.cloud/scrape";
+const SPIDER_RETURN_FORMAT = { markdown: "markdown", text: "text", html: "raw" };
+// START_BLOCK_HELPERS
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseSpiderResponse(bytes) {
+    let parsed;
+    try {
+        parsed = JSON.parse(new TextDecoder().decode(bytes));
+    }
+    catch {
+        throw new WebProviderError("spider", "BAD_RESPONSE", "malformed JSON response from spider");
+    }
+    if (!Array.isArray(parsed) || parsed.length === 0) {
+        throw new WebProviderError("spider", "BAD_RESPONSE", "unexpected spider response envelope");
+    }
+    const entry = parsed[0];
+    if (!isPlainObject(entry)) {
+        throw new WebProviderError("spider", "BAD_RESPONSE", "unexpected spider response envelope");
+    }
+    const status = typeof entry.status === "number" ? entry.status : undefined;
+    const duration = typeof entry.duration === "number" ? entry.duration : undefined;
+    const metadata = {
+        ...(status !== undefined ? { status } : {}),
+        ...(duration !== undefined ? { durationMs: duration } : {}),
+    };
+    if (entry.error) {
+        const detail = typeof entry.error === "string" ? entry.error : "scrape failed";
+        throw new WebProviderError("spider", "PROVIDER_ERROR", `spider error: ${detail}`, status);
+    }
+    const content = typeof entry.content === "string" ? entry.content : undefined;
+    if (content === undefined) {
+        throw new WebProviderError("spider", "BAD_RESPONSE", "spider response missing content");
+    }
+    return { kind: "text", content, metadata };
+}
+// END_BLOCK_HELPERS
+// START_CONTRACT: scrapeSpider
+//   PURPOSE: Serve image and PDF targets through the shared media loader; scrape textual targets through Spider.
+//   INPUTS: { input: url, format, credential, abort, timeoutMs; fetchImpl: injectable fetch }
+//   OUTPUTS: { SpiderOutcome - text or media with provider metadata }
+//   SIDE_EFFECTS: performs network I/O through fetchImpl; never logs the credential
+//   LINKS: M-WEB-FETCH-SERVICE
+// END_CONTRACT: scrapeSpider
+export async function scrapeSpider(input, fetchImpl) {
+    try {
+        const attachment = await loadMediaAttachment({ url: input.url, abort: input.abort, timeoutMs: input.timeoutMs }, fetchImpl);
+        return { kind: "media", attachment, metadata: {} };
+    }
+    catch (error) {
+        if (!(error instanceof WebMediaError)) {
+            throw error;
+        }
+    }
+    const body = JSON.stringify({
+        url: input.url,
+        return_format: [SPIDER_RETURN_FORMAT[input.format]],
+    });
+    let response;
+    try {
+        response = await requestBounded({
+            url: SPIDER_SCRAPE_URL,
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${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, "spider");
+        throw error;
+    }
+    return parseSpiderResponse(response.bytes);
+}
+//# sourceMappingURL=spider.js.map

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

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

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

@@ -0,0 +1,33 @@
+import type { ToolAttachment } from "@opencode-ai/plugin";
+import type { VvocWebRegion } from "../../../lib/vvoc-config.js";
+import type { WebProviderCredential } from "../config.js";
+import { type FetchLike } from "../http.js";
+import { type WebSearchInput, type WebSearchResult } from "./exa.js";
+type FetchFormat = "markdown" | "text" | "html";
+export type ZaiReaderOutcome = {
+    kind: "text";
+    content: string;
+    metadata: {
+        status: number;
+        requestId?: string;
+        model?: string;
+        created?: number;
+        title?: string;
+    };
+} | {
+    kind: "media";
+    attachment: ToolAttachment;
+    metadata: Record<string, never>;
+};
+export declare function searchZai(input: WebSearchInput & {
+    region: VvocWebRegion;
+}, fetchImpl?: FetchLike): Promise<WebSearchResult[]>;
+export declare function fetchZai(input: {
+    url: string;
+    format: FetchFormat;
+    region: VvocWebRegion;
+    credential: WebProviderCredential;
+    abort: AbortSignal;
+    timeoutMs: number;
+}, fetchImpl?: FetchLike): Promise<ZaiReaderOutcome>;
+export {};