webfox 4.8.0 → 4.10.0

package/README.md

@@ -144,6 +144,7 @@ Use different providers for different tasks:
 | [Exa]        |   ✔︎    |    ✔︎     |   ✔︎    |    ✔︎     |
 | [Firecrawl]  |   ✔︎    |    ✔︎     |   ✔︎    |          |
 | [Gemini]     |        |          |   ✔︎    |    ✔︎     |
+| [Keenable]   |   ✔︎    |          |        |          |
 | [Linkup]     |   ✔︎    |    ✔︎     |        |    ✔︎     |
 | [Ollama]     |   ✔︎    |    ✔︎     |        |          |
 | [OpenAI]     |   ✔︎    |          |   ✔︎    |    ✔︎     |
@@ -161,6 +162,7 @@ Use different providers for different tasks:
 [Exa]: ./docs/provider.md#exa
 [Firecrawl]: ./docs/provider.md#firecrawl
 [Gemini]: ./docs/provider.md#gemini
+[Keenable]: ./docs/provider.md#keenable
 [Linkup]: ./docs/provider.md#linkup
 [Ollama]: ./docs/provider.md#ollama
 [OpenAI]: ./docs/provider.md#openai

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-QU2G7O25.js → adapter-EIDSGLOP.js}

@@ -2,11 +2,11 @@ import {
   SERPBASE_MODES,
   serpbaseProvider,
   validateOptions
-} from "./chunk-QERSNL3J.js";
+} from "./chunk-5FP7KNMC.js";
 import {
   trimSnippet
-} from "./chunk-X6ZBIHZC.js";
-import "./chunk-GPACLYNT.js";
+} from "./chunk-FSTCLBSF.js";
+import "./chunk-57OOEOXI.js";
 import {
   WebfoxError,
   httpError

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-JJSMYZXG.js

@@ -0,0 +1,91 @@
+import {
+  joinUrl,
+  requestJson,
+  trimSnippet
+} from "./chunk-FSTCLBSF.js";
+import {
+  WebfoxError
+} from "./chunk-U4BLULLV.js";
+
+// src/providers/keenable/adapter.ts
+var DEFAULT_BASE_URL = "https://api.keenable.ai";
+var MAX_RESULTS = 50;
+var FORWARDED_OPTIONS = [
+  "mode",
+  "site",
+  "published_after",
+  "published_before",
+  "acquired_after",
+  "acquired_before",
+  "query_time",
+  "snippet_max_length"
+];
+var adapter = {
+  async search(request, config, context) {
+    const apiKey = config.credentials?.api;
+    if (!apiKey) throw new Error("Keenable search is missing an API key");
+    const maxResults = Math.max(
+      1,
+      Math.min(MAX_RESULTS, Math.trunc(request.maxResults || 0))
+    );
+    const options = asRecord(request.options) ?? {};
+    const payload = asRecord(
+      await requestJson(
+        joinUrl(config.baseUrl ?? DEFAULT_BASE_URL, "v1/search"),
+        {
+          method: "POST",
+          headers: { "X-API-Key": apiKey, "X-Keenable-Title": "webfox" },
+          body: {
+            query: request.query,
+            max_results: maxResults,
+            ...Object.fromEntries(
+              FORWARDED_OPTIONS.flatMap(
+                (key) => options[key] === void 0 ? [] : [[key, options[key]]]
+              )
+            )
+          },
+          signal: context.signal
+        },
+        describeError
+      )
+    );
+    const entries = payload?.results;
+    if (!payload || !Array.isArray(entries)) {
+      throw new WebfoxError(
+        "PROVIDER_FAILURE",
+        "Keenable returned an invalid search response.",
+        { retryable: false }
+      );
+    }
+    const results = entries.map(toSearchResult).filter((result) => result !== void 0);
+    return { provider: "keenable", results: results.slice(0, maxResults) };
+  }
+};
+function describeError(payload, response) {
+  const record = asRecord(payload);
+  const detail = text(record?.detail) ?? text(record?.error) ?? text(record?.message) ?? (typeof payload === "string" ? text(payload) : void 0) ?? (record ? JSON.stringify(record) : void 0);
+  const trimmed = detail?.trim().slice(0, 500);
+  return `Keenable search failed (HTTP ${response.status})${trimmed ? `: ${trimmed}` : "."}`;
+}
+function toSearchResult(entry) {
+  const record = asRecord(entry);
+  const url = text(record?.url);
+  if (!record || !url) return void 0;
+  const { title, url: _url, description, snippet, ...metadata } = record;
+  const excerpt = text(snippet) ?? text(description);
+  return {
+    title: text(title) ?? url,
+    url,
+    snippet: excerpt ? trimSnippet(excerpt) : "",
+    ...Object.keys(metadata).length > 0 ? { metadata } : {}
+  };
+}
+function asRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function text(value) {
+  return typeof value === "string" && value.trim() ? value : void 0;
+}
+export {
+  adapter
+};

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) {