webfox 4.8.0 → 4.9.0

package/dist/{adapter-YOHLAGYM.js → adapter-2UVAARTV.js}

@@ -1,6 +1,6 @@
 import {
   trimSnippet
-} from "./chunk-X6ZBIHZC.js";
+} from "./chunk-FSTCLBSF.js";
 import {
   httpError
 } from "./chunk-U4BLULLV.js";

package/dist/{adapter-UAZNLDSS.js → adapter-764OQFKY.js}

@@ -9,7 +9,7 @@ import {
 import {
   formatJson,
   trimSnippet
-} from "./chunk-X6ZBIHZC.js";
+} from "./chunk-FSTCLBSF.js";
 import {
   orderedContents
 } from "./chunk-YZXM4U2C.js";
@@ -78,14 +78,18 @@ var valyuImplementation = {
             error: "No content returned for this URL."
           };
         }
-        return result.status === "failed" ? {
-          url,
-          error: result.error ?? formatJson(result)
-        } : {
-          url: result.url,
-          ...typeof result.content === "string" || typeof result.content === "number" ? { content: String(result.content) } : {},
-          ...result.summary !== void 0 ? { summary: result.summary } : {},
-          metadata: result
+        if (result.status === "failed" || result.status === "not_found") {
+          return {
+            url,
+            error: result.error ?? formatJson(result)
+          };
+        }
+        const page = result;
+        return {
+          url: page.url,
+          ...typeof page.content === "string" || typeof page.content === "number" ? { content: String(page.content) } : {},
+          ...page.summary !== void 0 ? { summary: page.summary } : {},
+          metadata: page
         };
       })
     };

package/dist/{adapter-67TIISDW.js → adapter-A5WYGGZI.js}

@@ -1,6 +1,6 @@
 import {
   trimSnippet
-} from "./chunk-X6ZBIHZC.js";
+} from "./chunk-FSTCLBSF.js";
 import {
   httpError
 } from "./chunk-U4BLULLV.js";

package/dist/{adapter-I6OUKBZQ.js → adapter-C2VZHFUB.js}

@@ -1,7 +1,7 @@
 import {
   asJsonObject,
   trimSnippet
-} from "./chunk-X6ZBIHZC.js";
+} from "./chunk-FSTCLBSF.js";
 import {
   httpError
 } from "./chunk-U4BLULLV.js";

package/dist/{adapter-2YBFCBCZ.js → adapter-G3I7JEO5.js}

@@ -1,7 +1,7 @@
 import {
   formatJson,
   trimSnippet
-} from "./chunk-X6ZBIHZC.js";
+} from "./chunk-FSTCLBSF.js";
 import {
   orderedContents
 } from "./chunk-YZXM4U2C.js";

package/dist/{adapter-PADXKW43.js → adapter-HRI5ZMGK.js}

@@ -1,7 +1,9 @@
 import {
   formatJson,
+  joinUrl,
+  requestJson,
   trimSnippet
-} from "./chunk-X6ZBIHZC.js";
+} from "./chunk-FSTCLBSF.js";
 import {
   orderedContents
 } from "./chunk-YZXM4U2C.js";
@@ -10,15 +12,19 @@ import {
 } from "./chunk-U4BLULLV.js";
 
 // src/providers/exa/adapter.ts
-import { Exa as ExaClient } from "exa-js";
+var DEFAULT_BASE_URL = "https://api.exa.ai";
+var DEFAULT_MAX_CHARACTERS = 1e4;
 var exaImplementation = {
-  async search(query, maxResults, config, _context, searchOptions) {
-    const client = createClient(config);
-    const options = {
-      ...searchOptions ?? {},
-      numResults: maxResults
-    };
-    const response = await client.search(query, options);
+  async search(query, maxResults, config, context, searchOptions) {
+    const response = await exaRequest(
+      config,
+      "/search",
+      buildSearchBody(query, {
+        ...searchOptions ?? {},
+        numResults: maxResults
+      }),
+      context
+    );
     return {
       provider: "exa",
       results: (response.results ?? []).slice(0, maxResults).map((result) => ({
@@ -31,9 +37,13 @@ var exaImplementation = {
       }))
     };
   },
-  async contents(urls, config, _context, options) {
-    const client = createClient(config);
-    const response = await client.getContents(urls, options);
+  async contents(urls, config, context, options) {
+    const response = await exaRequest(
+      config,
+      "/contents",
+      { urls, ...options ?? {} },
+      context
+    );
     const results = response.results ?? [];
     return {
       provider: "exa",
@@ -54,9 +64,21 @@ var exaImplementation = {
       })
     };
   },
-  async answer(query, config, _context, options) {
-    const client = createClient(config);
-    const response = await client.answer(query, options);
+  async answer(query, config, context, options) {
+    const response = await exaRequest(
+      config,
+      "/answer",
+      {
+        query,
+        stream: false,
+        text: options?.text ?? false,
+        model: options?.model ?? "exa",
+        systemPrompt: options?.systemPrompt,
+        outputSchema: options?.outputSchema,
+        userLocation: options?.userLocation
+      },
+      context
+    );
     const lines = [];
     lines.push(
       typeof response.answer === "string" ? response.answer : formatJson(response.answer)
@@ -81,15 +103,19 @@ var exaImplementation = {
   async research(input, config, context, options) {
     context.signal?.throwIfAborted();
     context.onProgress?.("Exa is researching and synthesizing the report.");
-    const client = createClient(config);
-    const result = await client.search(input, {
-      ...options ?? {},
-      type: "deep-reasoning",
-      outputSchema: {
-        type: "text",
-        description: "A detailed Markdown research report answering the query. Cite sources with links, distinguish evidence from uncertainty, and include a conclusion."
-      }
-    });
+    const result = await exaRequest(
+      config,
+      "/search",
+      buildSearchBody(input, {
+        ...options ?? {},
+        type: "deep-reasoning",
+        outputSchema: {
+          type: "text",
+          description: "A detailed Markdown research report answering the query. Cite sources with links, distinguish evidence from uncertainty, and include a conclusion."
+        }
+      }),
+      context
+    );
     const content = result.output?.content;
     if (typeof content !== "string" || !content.trim())
       throw new WebfoxError(
@@ -113,12 +139,42 @@ var exaImplementation = {
     };
   }
 };
-function createClient(config) {
+function buildSearchBody(query, options) {
+  const { stream: _stream, ...rest } = options;
+  if (!("contents" in rest)) {
+    return {
+      query,
+      ...rest,
+      contents: { text: { maxCharacters: DEFAULT_MAX_CHARACTERS } }
+    };
+  }
+  if (rest.contents === false || rest.contents == null) {
+    const { contents: _contents, ...withoutContents } = rest;
+    return { query, ...withoutContents };
+  }
+  return { query, ...rest };
+}
+async function exaRequest(config, path, body, context) {
   const apiKey = config.credentials?.api;
   if (!apiKey) {
     throw new Error("is missing an API key");
   }
-  return new ExaClient(apiKey, config.baseUrl);
+  return await requestJson(
+    joinUrl(config.baseUrl ?? DEFAULT_BASE_URL, path),
+    { headers: { "x-api-key": apiKey }, body, signal: context.signal },
+    readExaError
+  );
+}
+function readExaError(payload, response) {
+  if (typeof payload !== "object" || payload === null) {
+    const text = typeof payload === "string" ? payload.trim().slice(0, 500) : "";
+    return text ? `Request failed with status ${response.status}: ${text}` : `Request failed with status ${response.status}.`;
+  }
+  const record = payload;
+  const envelope = typeof record.error === "object" && record.error !== null ? record.error : void 0;
+  const parts = envelope ? [envelope.message ?? record.message] : [record.error, record.message];
+  const message = parts.filter((part) => typeof part === "string" && part !== "").join(". ");
+  return message || `Request failed with status ${response.status}.`;
 }
 var adapter = {
   async search(input, config, context) {

package/dist/{adapter-ISZQTZDP.js → adapter-HTMXAJTU.js}

@@ -1,7 +1,7 @@
 import {
   normalizeContentText,
   trimSnippet
-} from "./chunk-X6ZBIHZC.js";
+} from "./chunk-FSTCLBSF.js";
 import {
   orderedContents
 } from "./chunk-YZXM4U2C.js";

package/dist/{adapter-HPTMLH75.js → adapter-K6AMSUCR.js}

@@ -4,45 +4,45 @@ import {
 import "./chunk-I2UIACY3.js";
 import "./chunk-WCTOYZVB.js";
 import {
+  expectJsonBody,
   formatJson,
+  joinUrl,
+  readResponseBody,
   trimSnippet
-} from "./chunk-X6ZBIHZC.js";
+} from "./chunk-FSTCLBSF.js";
 import {
   orderedContents
 } from "./chunk-YZXM4U2C.js";
 import {
+  WebfoxError,
   asWebfoxError
 } from "./chunk-U4BLULLV.js";
 
 // src/providers/linkup/adapter.ts
-import {
-  LinkupClient
-} from "linkup-sdk";
+var DEFAULT_BASE_URL = "https://api.linkup.so/v1";
 var linkupImplementation = {
-  async search(query, maxResults, config, _context, options) {
-    const client = createClient(config);
-    const response = await client.search(
-      buildSearchParams(query, maxResults, {
+  async search(query, maxResults, config, context, options) {
+    const response = await linkupRequest(config, context, "/search", {
+      body: buildSearchParams(query, maxResults, {
         ...options ?? {}
       })
-    );
+    });
     return {
       provider: "linkup",
       results: (response.results ?? []).map(toSearchResult).filter((result) => result !== null).slice(0, maxResults)
     };
   },
-  async contents(urls, config, _context, options) {
-    const client = createClient(config);
+  async contents(urls, config, context, options) {
     return {
       provider: "linkup",
       answers: await Promise.all(
         urls.map(async (url) => {
           try {
-            const response = await client.fetch(
-              buildFetchParams(url, {
+            const response = await linkupRequest(config, context, "/fetch", {
+              body: buildFetchParams(url, {
                 ...options ?? {}
               })
-            );
+            });
             const metadata = Object.fromEntries(
               Object.entries(response).filter(
                 ([key, value]) => [
@@ -86,18 +86,20 @@ var linkupImplementation = {
       poll: (id, researchContext) => linkupImplementation.pollResearch(id, config, researchContext)
     });
   },
-  async startResearch(input, config, _context, options) {
-    const client = createClient(config);
-    const task = await client.research(
-      buildResearchParams(input, {
+  async startResearch(input, config, context, options) {
+    const task = await linkupRequest(config, context, "/research", {
+      body: buildResearchParams(input, {
         ...options ?? {}
       })
-    );
+    });
     return { id: task.id };
   },
-  async pollResearch(id, config, _context) {
-    const client = createClient(config);
-    const task = await client.getResearch(id);
+  async pollResearch(id, config, context) {
+    const task = await linkupRequest(
+      config,
+      context,
+      `/research/${encodeURIComponent(id)}`
+    );
     if (task.status === "completed") {
       return {
         status: "completed",
@@ -135,7 +137,7 @@ function buildSearchParams(query, maxResults, options) {
     );
   }
   return {
-    query,
+    q: query,
     depth: searchOptions.depth ?? "standard",
     outputType: "searchResults",
     maxResults,
@@ -179,7 +181,7 @@ function buildResearchParams(input, options) {
     );
   }
   const commonParams = {
-    query: input,
+    q: input,
     ...researchOptions.includeDomains !== void 0 ? { includeDomains: researchOptions.includeDomains } : {},
     ...researchOptions.excludeDomains !== void 0 ? { excludeDomains: researchOptions.excludeDomains } : {},
     ...researchOptions.fromDate !== void 0 ? { fromDate: toDate(researchOptions.fromDate, "fromDate") } : {},
@@ -191,7 +193,9 @@ function buildResearchParams(input, options) {
     return {
       ...commonParams,
       outputType,
-      structuredOutputSchema: researchOptions.structuredOutputSchema
+      structuredOutputSchema: serializeSchema(
+        researchOptions.structuredOutputSchema
+      )
     };
   }
   return {
@@ -199,14 +203,50 @@ function buildResearchParams(input, options) {
     outputType
   };
 }
-function createClient(config) {
+function serializeSchema(schema) {
+  return typeof schema === "string" ? schema : JSON.stringify(schema);
+}
+async function linkupRequest(config, context, path, init = {}) {
   const apiKey = config.credentials?.api;
   if (!apiKey) {
     throw new Error("is missing an API key");
   }
-  return new LinkupClient({
-    apiKey,
-    baseUrl: config.baseUrl
+  const response = await fetch(
+    joinUrl(config.baseUrl ?? DEFAULT_BASE_URL, path),
+    {
+      method: init.body === void 0 ? "GET" : "POST",
+      headers: {
+        Accept: "application/json",
+        Authorization: `Bearer ${apiKey}`,
+        ...init.body === void 0 ? {} : { "Content-Type": "application/json" }
+      },
+      ...init.body === void 0 ? {} : { body: JSON.stringify(init.body) },
+      signal: context.signal
+    }
+  );
+  const payload = await readResponseBody(response);
+  if (!response.ok) {
+    throw linkupError(response, payload);
+  }
+  return expectJsonBody(payload, response);
+}
+var NON_RETRYABLE_CODES = /* @__PURE__ */ new Set([
+  "INSUFFICIENT_FUNDS_CREDITS",
+  "EXCEED_BUDGET_LIMIT"
+]);
+function linkupError(response, payload) {
+  const error = asRecord(asRecord(payload)?.error);
+  const code = readString(error?.code);
+  const details = Array.isArray(error?.details) ? error.details : [];
+  const message = [
+    readString(error?.message) ?? (typeof payload === "string" && payload.trim() ? payload.trim().slice(0, 500) : `Linkup request failed with status ${response.status}.`),
+    ...details.flatMap((detail) => {
+      const text = readString(asRecord(detail)?.message);
+      return text ? [text] : [];
+    })
+  ].join(" ");
+  return new WebfoxError("PROVIDER_FAILURE", message, {
+    retryable: [408, 429, 500, 502, 503, 504].includes(response.status) && !(code && NON_RETRYABLE_CODES.has(code))
   });
 }
 function formatResearchTaskOutput(task) {
@@ -298,7 +338,7 @@ function toDate(value, name) {
       `Linkup option '${name}' must be a valid date string, timestamp, or Date.`
     );
   }
-  return date;
+  return date.toISOString().slice(0, 10);
 }
 var adapter = {
   async search(input, config, context) {

package/dist/{adapter-XBAQSK7I.js → adapter-L6BFKWGX.js}

@@ -1,52 +1,65 @@
 import {
   formatJson,
+  joinUrl,
+  requestJson,
   trimSnippet
-} from "./chunk-X6ZBIHZC.js";
+} from "./chunk-FSTCLBSF.js";
 import {
   orderedContents
 } from "./chunk-YZXM4U2C.js";
 import {
   WebfoxError,
-  asWebfoxError,
-  httpError
+  asWebfoxError
 } from "./chunk-U4BLULLV.js";
 
 // src/providers/firecrawl/adapter.ts
-import FirecrawlClient from "@mendable/firecrawl-js";
 var FIRECRAWL_CLOUD_HOST = "api.firecrawl.dev";
 var FIRECRAWL_DEFAULT_API_URL = "https://api.firecrawl.dev";
 var FIRECRAWL_QUESTION_LIMIT = 1e4;
 var firecrawlImplementation = {
-  async search(query, maxResults, config, _context, options) {
-    const client = createClient(config);
-    const response = await client.search(query, {
-      ...options ?? {},
-      limit: maxResults
-    });
+  async search(query, maxResults, config, context, options) {
+    if (!query.trim()) {
+      throw new Error("Query cannot be empty");
+    }
+    const response = await firecrawlRequest(
+      config,
+      "/v2/search",
+      { ...options ?? {}, query, limit: maxResults },
+      context.signal,
+      "Firecrawl search failed."
+    );
     return {
       provider: "firecrawl",
-      results: flattenSearchResults(response).slice(0, maxResults)
+      results: flattenSearchResults(
+        asRecord(response.data) ?? {}
+      ).slice(0, maxResults)
     };
   },
-  async contents(urls, config, _context, options) {
-    const client = createClient(config);
+  async contents(urls, config, context, options) {
+    const { autoResume: _autoResume, ...callOptions } = options ?? {};
     const scrapeOptions = {
       formats: ["markdown"],
       onlyMainContent: true,
-      ...options ?? {},
-      autoResume: false
+      ...callOptions
     };
     return {
       provider: "firecrawl",
       answers: await Promise.all(
         urls.map(async (url) => {
           try {
-            const document = await client.scrape(url, scrapeOptions);
+            const response = await firecrawlRequest(
+              config,
+              "/v2/scrape",
+              { ...scrapeOptions, url: url.trim() },
+              context.signal,
+              "Firecrawl scrape failed."
+            );
+            const document = asRecord(response.data) ?? {};
             const content = getDocumentContent(document);
             return content ? {
               url,
               content,
-              ...document.metadata ? {
+              ...asRecord(document.metadata) ? {
                 metadata: document.metadata
               } : {}
             } : {
@@ -94,22 +107,6 @@ var firecrawlImplementation = {
     };
   }
 };
-function createClient(config) {
-  const apiUrl = config.baseUrl;
-  const apiKey = config.credentials?.api;
-  if (isFirecrawlCloudApiUrl(apiUrl) && !apiKey) {
-    throw new WebfoxError(
-      "PROVIDER_UNAVAILABLE",
-      "Firecrawl cloud requires FIRECRAWL_API_KEY; self-hosted instances can use baseUrl without a key."
-    );
-  }
-  return new FirecrawlClient({
-    // Firecrawl counts attempts, unlike SDKs whose maxRetries excludes the first call.
-    maxRetries: 1,
-    apiKey,
-    apiUrl
-  });
-}
 function isFirecrawlCloudApiUrl(apiUrl) {
   return !apiUrl || apiUrl.includes(FIRECRAWL_CLOUD_HOST);
 }
@@ -136,6 +133,19 @@ function stripAnswerOnlyOptions(options) {
   return scrapeOptions;
 }
 async function scrapeQuestion(config, url, question, options, signal) {
+  return await firecrawlRequest(
+    config,
+    "/v2/scrape",
+    {
+      ...options,
+      url,
+      formats: [{ type: "question", question }]
+    },
+    signal,
+    "Firecrawl scrape failed."
+  );
+}
+async function firecrawlRequest(config, path, body, signal, failure) {
   const apiUrl = config.baseUrl ?? FIRECRAWL_DEFAULT_API_URL;
   const apiKey = config.credentials?.api;
   if (isFirecrawlCloudApiUrl(apiUrl) && !apiKey) {
@@ -144,45 +154,28 @@ async function scrapeQuestion(config, url, question, options, signal) {
       "Firecrawl cloud requires FIRECRAWL_API_KEY; self-hosted instances can use baseUrl without a key."
     );
   }
-  const response = await fetch(joinUrl(apiUrl, "/v2/scrape"), {
-    signal,
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      ...apiKey ? { Authorization: `Bearer ${apiKey}` } : {}
+  const payload = await requestJson(
+    joinUrl(apiUrl, path),
+    {
+      // Omit Authorization without a key: Firecrawl grants keyless access
+      // only when the header is absent.
+      headers: apiKey ? { Authorization: `Bearer ${apiKey}` } : {},
+      body,
+      signal
     },
-    body: JSON.stringify({
-      ...options,
-      url,
-      formats: [{ type: "question", question }]
-    })
-  });
-  const payload = await readJsonResponse(response);
-  if (!response.ok) {
-    throw httpError(response, readFirecrawlError(payload, response.statusText));
-  }
+    (value, response) => readFirecrawlError(value, response.statusText || failure)
+  );
   if (isFirecrawlFailure(payload)) {
-    throw new Error(readFirecrawlError(payload, "Firecrawl scrape failed."));
+    throw new Error(readFirecrawlError(payload, failure));
   }
-  return payload;
-}
-function joinUrl(baseUrl, path) {
-  return `${baseUrl.replace(/\/+$/g, "")}/${path.replace(/^\/+/g, "")}`;
-}
-async function readJsonResponse(response) {
-  const text = await response.text();
-  if (!text) {
-    return {};
-  }
-  try {
-    return JSON.parse(text);
-  } catch {
-    return text;
+  const record = asRecord(payload);
+  if (!record) {
+    throw new Error(`Unexpected Firecrawl response: ${formatJson(payload)}`);
   }
+  return record;
 }
 function isFirecrawlFailure(value) {
-  const record = asRecord(value);
-  return record?.success === false || record?.error !== void 0;
+  return asRecord(value)?.success !== true;
 }
 function readFirecrawlError(value, fallback) {
   const record = asRecord(value);
@@ -201,7 +194,12 @@ function getFirecrawlDocument(value) {
 }
 function flattenSearchResults(response) {
   return ["web", "news", "images"].flatMap(
-    (source) => (response[source] ?? []).map((entry) => toSearchResult(source, entry)).filter((entry) => entry !== null)
+    (source) => (response[source] ?? []).map(
+      (entry) => toSearchResult(
+        source,
+        typeof entry === "string" ? { url: entry } : entry
+      )
+    ).filter((entry) => entry !== null)
   );
 }
 function toSearchResult(source, value) {

package/dist/{adapter-SLTIAAML.js → adapter-OK2PTP6R.js}

@@ -1,6 +1,7 @@
 import {
   trimSnippet
-} from "./chunk-X6ZBIHZC.js";
+} from "./chunk-FSTCLBSF.js";
+import "./chunk-U4BLULLV.js";
 
 // src/providers/perplexity/adapter.ts
 import PerplexityClient from "@perplexity-ai/perplexity_ai";

package/dist/{adapter-QU2G7O25.js → adapter-QIP32KA4.js}

@@ -2,10 +2,10 @@ import {
   SERPBASE_MODES,
   serpbaseProvider,
   validateOptions
-} from "./chunk-QERSNL3J.js";
+} from "./chunk-LTJOWNI2.js";
 import {
   trimSnippet
-} from "./chunk-X6ZBIHZC.js";
+} from "./chunk-FSTCLBSF.js";
 import "./chunk-GPACLYNT.js";
 import {
   WebfoxError,

package/dist/{adapter-SDQX2533.js → adapter-UIFBJKKF.js}

@@ -1,6 +1,6 @@
 import {
   trimSnippet
-} from "./chunk-X6ZBIHZC.js";
+} from "./chunk-FSTCLBSF.js";
 import {
   orderedContents
 } from "./chunk-YZXM4U2C.js";

package/dist/{adapter-HITGYUXN.js → adapter-VMMS4YQG.js}

@@ -5,7 +5,7 @@ import "./chunk-I2UIACY3.js";
 import "./chunk-WCTOYZVB.js";
 import {
   trimSnippet
-} from "./chunk-X6ZBIHZC.js";
+} from "./chunk-FSTCLBSF.js";
 import "./chunk-U4BLULLV.js";
 
 // src/providers/openai/adapter.ts

package/dist/chunk-FSTCLBSF.js

@@ -0,0 +1,76 @@
+import {
+  WebfoxError,
+  httpError
+} from "./chunk-U4BLULLV.js";
+
+// src/providers/shared.ts
+function trimSnippet(input, maxLength = 300) {
+  const text = (input ?? "").replace(/\s+/g, " ").trim();
+  return text.length <= maxLength ? text : `${text.slice(0, maxLength - 1)}\u2026`;
+}
+function normalizeContentText(input) {
+  return (input ?? "").replace(/\r/g, "").trim().split("\n").map((line) => line.replace(/[ \t]+$/g, "")).join("\n").replace(/\n{3,}/g, "\n\n");
+}
+function asJsonObject(value) {
+  return value ? { ...value } : {};
+}
+function formatJson(value) {
+  return JSON.stringify(value, null, 2);
+}
+function joinUrl(baseUrl, path) {
+  return `${baseUrl.replace(/\/+$/g, "")}/${path.replace(/^\/+/g, "")}`;
+}
+async function readResponseBody(response) {
+  const text = await response.text();
+  if (!text) return void 0;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+function expectJsonBody(payload, response) {
+  if (payload === void 0) {
+    throw new WebfoxError(
+      "PROVIDER_FAILURE",
+      `Expected a JSON response but received an empty body (status ${response.status}).`
+    );
+  }
+  if (typeof payload === "string") {
+    const snippet = payload.trim().replace(/\s+/g, " ").slice(0, 200);
+    throw new WebfoxError(
+      "PROVIDER_FAILURE",
+      `Expected a JSON response but received a non-JSON body (status ${response.status}): ${snippet}`
+    );
+  }
+  return payload;
+}
+async function requestJson(url, init, describeError) {
+  const method = init.method ?? (init.body === void 0 ? "GET" : "POST");
+  const response = await fetch(url, {
+    method,
+    headers: {
+      Accept: "application/json",
+      ...init.body === void 0 ? {} : { "Content-Type": "application/json" },
+      ...init.headers
+    },
+    ...init.body === void 0 ? {} : { body: JSON.stringify(init.body) },
+    signal: init.signal
+  });
+  const payload = await readResponseBody(response);
+  if (!response.ok) {
+    throw httpError(response, describeError(payload, response));
+  }
+  return expectJsonBody(payload, response);
+}
+
+export {
+  trimSnippet,
+  normalizeContentText,
+  asJsonObject,
+  formatJson,
+  joinUrl,
+  readResponseBody,
+  expectJsonBody,
+  requestJson
+};

package/dist/{chunk-G7LMBPW4.js → chunk-HCYQF24V.js}

@@ -1,7 +1,7 @@
 import {
   optionSchema,
   providers
-} from "./chunk-QERSNL3J.js";
+} from "./chunk-LTJOWNI2.js";
 import {
   CAPABILITIES
 } from "./chunk-GPACLYNT.js";
@@ -9,7 +9,7 @@ import {
 // package.json
 var package_default = {
   name: "webfox",
-  version: "4.8.0",
+  version: "4.9.0",
   description: "Search the web, extract pages, get grounded answers, and run deep research with the web CLI, a TypeScript library, and a pi extension. Bring your own providers and API keys.",
   type: "module",
   files: [
@@ -101,17 +101,14 @@ var package_default = {
     "test:watch": "vitest"
   },
   dependencies: {
-    "@mendable/firecrawl-js": "^4.38.0",
-    "@perplexity-ai/perplexity_ai": "^0.38.5",
-    "@tavily/core": "^0.7.9",
-    cloudflare: "^7.1.0",
+    "@perplexity-ai/perplexity_ai": "^0.41.0",
+    "@tavily/core": "^0.7.14",
+    cloudflare: "^7.3.0",
     commander: "^14.0.3",
-    "exa-js": "^2.19.0",
-    "linkup-sdk": "^3.6.0",
-    openai: "^7.10.0",
-    "parallel-web": "^1.3.3",
+    openai: "^7.47.0",
+    "parallel-web": "^1.3.7",
     picocolors: "^1.1.1",
-    "valyu-js": "^2.10.1",
+    "valyu-js": "^2.11.5",
     yaml: "^2.9.0"
   },
   devDependencies: {

package/dist/{chunk-QERSNL3J.js → chunk-LTJOWNI2.js}

@@ -504,7 +504,7 @@ var braveProvider = defineProvider({
       retrySafe: false
     }
   },
-  load: async () => (await import("./adapter-67TIISDW.js")).adapter
+  load: async () => (await import("./adapter-A5WYGGZI.js")).adapter
 });
 
 // src/providers/cloudflare/definition.ts
@@ -944,7 +944,7 @@ var exaProvider = defineProvider({
       retrySafe: false
     }
   },
-  load: async () => (await import("./adapter-PADXKW43.js")).adapter
+  load: async () => (await import("./adapter-HRI5ZMGK.js")).adapter
 });
 
 // src/providers/firecrawl/definition.ts
@@ -1150,7 +1150,7 @@ var firecrawlProvider = defineProvider({
       retrySafe: false
     }
   },
-  load: async () => (await import("./adapter-XBAQSK7I.js")).adapter
+  load: async () => (await import("./adapter-L6BFKWGX.js")).adapter
 });
 
 // src/providers/gemini/definition.ts
@@ -1473,7 +1473,7 @@ var linkupProvider = defineProvider({
       retrySafe: false
     }
   },
-  load: async () => (await import("./adapter-HPTMLH75.js")).adapter
+  load: async () => (await import("./adapter-K6AMSUCR.js")).adapter
 });
 
 // src/providers/ollama/definition.ts
@@ -1502,7 +1502,7 @@ var ollamaProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-ISZQTZDP.js")).adapter
+  load: async () => (await import("./adapter-HTMXAJTU.js")).adapter
 });
 
 // src/providers/openai/definition.ts
@@ -1610,7 +1610,7 @@ var openaiProvider = defineProvider({
       retrySafe: false
     }
   },
-  load: async () => (await import("./adapter-HITGYUXN.js")).adapter
+  load: async () => (await import("./adapter-VMMS4YQG.js")).adapter
 });
 
 // src/providers/parallel/definition.ts
@@ -1769,7 +1769,7 @@ var parallelProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-2YBFCBCZ.js")).adapter
+  load: async () => (await import("./adapter-G3I7JEO5.js")).adapter
 });
 
 // src/providers/perplexity/definition.ts
@@ -1890,7 +1890,7 @@ var perplexityProvider = defineProvider({
     answer: { options: chatOptions, retrySafe: false },
     research: { options: chatOptions, retrySafe: false }
   },
-  load: async () => (await import("./adapter-SLTIAAML.js")).adapter
+  load: async () => (await import("./adapter-OK2PTP6R.js")).adapter
 });
 
 // src/providers/serpbase/definition.ts
@@ -1991,7 +1991,7 @@ var serpbaseProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-QU2G7O25.js")).adapter
+  load: async () => (await import("./adapter-QIP32KA4.js")).adapter
 });
 
 // src/providers/serper/definition.ts
@@ -2131,7 +2131,7 @@ var serperProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-I6OUKBZQ.js")).adapter
+  load: async () => (await import("./adapter-C2VZHFUB.js")).adapter
 });
 
 // src/providers/tavily/definition.ts
@@ -2326,7 +2326,7 @@ var tavilyProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-SDQX2533.js")).adapter
+  load: async () => (await import("./adapter-UIFBJKKF.js")).adapter
 });
 
 // src/providers/valyu/definition.ts
@@ -2794,7 +2794,7 @@ var valyuProvider = defineProvider({
       retrySafe: false
     }
   },
-  load: async () => (await import("./adapter-UAZNLDSS.js")).adapter
+  load: async () => (await import("./adapter-764OQFKY.js")).adapter
 });
 
 // src/providers/youcom/definition.ts
@@ -2985,7 +2985,7 @@ var youcomProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-YOHLAGYM.js")).adapter
+  load: async () => (await import("./adapter-2UVAARTV.js")).adapter
 });
 
 // src/providers/registry.ts

package/dist/{chunk-IRKSK34I.js → chunk-QZFN2747.js}

@@ -6,14 +6,14 @@ import {
 } from "./chunk-WCTOYZVB.js";
 import {
   configurationSchema
-} from "./chunk-G7LMBPW4.js";
+} from "./chunk-HCYQF24V.js";
 import {
   effectiveOptions,
   optionSchema,
   providers,
   selectProvider,
   validateConfiguredOptions
-} from "./chunk-QERSNL3J.js";
+} from "./chunk-LTJOWNI2.js";
 import {
   cancelProcessGroup,
   killProcessGroup

package/dist/cli.js

@@ -11,14 +11,14 @@ import {
   redactConfig,
   resolveConfigPath,
   setCapabilityDefault
-} from "./chunk-IRKSK34I.js";
+} from "./chunk-QZFN2747.js";
 import "./chunk-WCTOYZVB.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-G7LMBPW4.js";
+} from "./chunk-HCYQF24V.js";
 import {
   validateConfiguredOptions
-} from "./chunk-QERSNL3J.js";
+} from "./chunk-LTJOWNI2.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES,

package/dist/durable.js

@@ -8,10 +8,10 @@ import {
 } from "./chunk-BTWECET5.js";
 import {
   createWebfox
-} from "./chunk-IRKSK34I.js";
+} from "./chunk-QZFN2747.js";
 import "./chunk-WCTOYZVB.js";
-import "./chunk-G7LMBPW4.js";
-import "./chunk-QERSNL3J.js";
+import "./chunk-HCYQF24V.js";
+import "./chunk-LTJOWNI2.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES

package/dist/index.js

@@ -6,14 +6,14 @@ import {
   resolveConfigPath,
   setCapabilityDefault,
   validateConfig
-} from "./chunk-IRKSK34I.js";
+} from "./chunk-QZFN2747.js";
 import "./chunk-WCTOYZVB.js";
 import {
   CONFIG_SCHEMA_URL
-} from "./chunk-G7LMBPW4.js";
+} from "./chunk-HCYQF24V.js";
 import {
   validateConfiguredOptions
-} from "./chunk-QERSNL3J.js";
+} from "./chunk-LTJOWNI2.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES,

package/dist/pi.js

@@ -9,10 +9,10 @@ import {
 import {
   createWebfox,
   resolveConfigPath
-} from "./chunk-IRKSK34I.js";
+} from "./chunk-QZFN2747.js";
 import "./chunk-WCTOYZVB.js";
-import "./chunk-G7LMBPW4.js";
-import "./chunk-QERSNL3J.js";
+import "./chunk-HCYQF24V.js";
+import "./chunk-LTJOWNI2.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES,

package/dist/providers/shared.d.ts

@@ -2,3 +2,19 @@ export declare function trimSnippet(input: string | undefined, maxLength?: numbe
 export declare function normalizeContentText(input: string | undefined): string;
 export declare function asJsonObject(value: Record<string, unknown> | undefined): Record<string, unknown>;
 export declare function formatJson(value: unknown): string;
+export declare function joinUrl(baseUrl: string, path: string): string;
+/** Read a response body as JSON, falling back to its text. */
+export declare function readResponseBody(response: Response): Promise<unknown>;
+/** Reject successful responses whose body is empty or not JSON. */
+export declare function expectJsonBody(payload: unknown, response: Response): unknown;
+/**
+ * Send one JSON request without retries; the runtime owns retry policy.
+ * Non-2xx responses become classified provider errors with the message that
+ * `describeError` extracts from the response body.
+ */
+export declare function requestJson(url: string, init: {
+    method?: "GET" | "POST";
+    headers?: Record<string, string>;
+    body?: unknown;
+    signal?: AbortSignal;
+}, describeError: (payload: unknown, response: Response) => string): Promise<unknown>;

package/docs/provider.md

@@ -160,8 +160,49 @@ web search --provider openai --help
 
 Supports search and page extraction. Set `PARALLEL_API_KEY`.
 
+Search defaults to `advanced`. Choose `fast` for interactive lookups, or see
+[Parallel's search modes](https://docs.parallel.ai/search/modes) for the available
+tradeoffs:
+
+```sh
+web search "Node.js release notes" --provider parallel --mode fast
+```
+
+Limit a query to particular sources with `advanced_settings.source_policy`.
+Use Webfox's `--max-results` to control the number of results:
+
+```sh
+web search "Node.js release notes" --provider parallel --mode fast --max-results 3 \
+  --options-json '{"advanced_settings":{"source_policy":{"include_domains":["nodejs.org"]}}}'
+```
+
+To reuse Fast mode, merge this into your [configuration](./reference.md#configuration):
+
+```yaml
+providers:
+  parallel:
+    options:
+      search:
+        mode: fast
+```
+
+Provider options don't select a provider. Continue to pass `--provider parallel`
+or use your saved Parallel search default. A request's `--mode` overrides the
+saved mode.
+
+For known URLs, use page extraction instead of another search. Parallel returns
+full page content by default:
+
+```sh
+web contents https://nodejs.org/en/about/previous-releases --provider parallel
+```
+
+To request only excerpts relevant to a question, disable full content and enable
+excerpts with an objective:
+
 ```sh
-web search "Node.js release notes" --provider parallel
+web contents https://nodejs.org/en/about/previous-releases --provider parallel \
+  --no-full-content --excerpts --objective "Which Node.js releases are supported?"
 ```
 
 ## Perplexity

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webfox",
-  "version": "4.8.0",
+  "version": "4.9.0",
   "description": "Search the web, extract pages, get grounded answers, and run deep research with the web CLI, a TypeScript library, and a pi extension. Bring your own providers and API keys.",
   "type": "module",
   "files": [
@@ -92,17 +92,14 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@mendable/firecrawl-js": "^4.38.0",
-    "@perplexity-ai/perplexity_ai": "^0.38.5",
-    "@tavily/core": "^0.7.9",
-    "cloudflare": "^7.1.0",
+    "@perplexity-ai/perplexity_ai": "^0.41.0",
+    "@tavily/core": "^0.7.14",
+    "cloudflare": "^7.3.0",
     "commander": "^14.0.3",
-    "exa-js": "^2.19.0",
-    "linkup-sdk": "^3.6.0",
-    "openai": "^7.10.0",
-    "parallel-web": "^1.3.3",
+    "openai": "^7.47.0",
+    "parallel-web": "^1.3.7",
     "picocolors": "^1.1.1",
-    "valyu-js": "^2.10.1",
+    "valyu-js": "^2.11.5",
     "yaml": "^2.9.0"
   },
   "devDependencies": {

package/dist/chunk-X6ZBIHZC.js

@@ -1,21 +0,0 @@
-// src/providers/shared.ts
-function trimSnippet(input, maxLength = 300) {
-  const text = (input ?? "").replace(/\s+/g, " ").trim();
-  return text.length <= maxLength ? text : `${text.slice(0, maxLength - 1)}\u2026`;
-}
-function normalizeContentText(input) {
-  return (input ?? "").replace(/\r/g, "").trim().split("\n").map((line) => line.replace(/[ \t]+$/g, "")).join("\n").replace(/\n{3,}/g, "\n\n");
-}
-function asJsonObject(value) {
-  return value ? { ...value } : {};
-}
-function formatJson(value) {
-  return JSON.stringify(value, null, 2);
-}
-
-export {
-  trimSnippet,
-  normalizeContentText,
-  asJsonObject,
-  formatJson
-};