webfox 4.9.0 → 4.11.0

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

@@ -1,6 +1,6 @@
 import {
   CAPABILITIES
-} from "./chunk-GPACLYNT.js";
+} from "./chunk-NENL6L6N.js";
 import {
   WebfoxError
 } from "./chunk-U4BLULLV.js";
@@ -504,7 +504,7 @@ var braveProvider = defineProvider({
       retrySafe: false
     }
   },
-  load: async () => (await import("./adapter-A5WYGGZI.js")).adapter
+  load: async () => (await import("./adapter-YVZ4YBK5.js")).adapter
 });
 
 // src/providers/cloudflare/definition.ts
@@ -606,7 +606,7 @@ var cloudflareProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-AUYLTDPM.js")).adapter
+  load: async () => (await import("./adapter-RR55EZAW.js")).adapter
 });
 
 // src/providers/custom/definition.ts
@@ -633,7 +633,7 @@ var customProvider = defineProvider({
       retrySafe: false
     }
   },
-  load: async () => (await import("./adapter-VW4FMMJC.js")).adapter
+  load: async () => (await import("./adapter-XSQX3GAI.js")).adapter
 });
 
 // src/providers/exa/definition.ts
@@ -944,7 +944,7 @@ var exaProvider = defineProvider({
       retrySafe: false
     }
   },
-  load: async () => (await import("./adapter-HRI5ZMGK.js")).adapter
+  load: async () => (await import("./adapter-GFXYSHKP.js")).adapter
 });
 
 // src/providers/firecrawl/definition.ts
@@ -1150,7 +1150,7 @@ var firecrawlProvider = defineProvider({
       retrySafe: false
     }
   },
-  load: async () => (await import("./adapter-L6BFKWGX.js")).adapter
+  load: async () => (await import("./adapter-WXEVTCM3.js")).adapter
 });
 
 // src/providers/gemini/definition.ts
@@ -1275,7 +1275,74 @@ var geminiProvider = defineProvider({
       retrySafe: false
     }
   },
-  load: async () => (await import("./adapter-6EZAIE65.js")).adapter
+  load: async () => (await import("./adapter-VXT4C6RZ.js")).adapter
+});
+
+// src/providers/keenable/definition.ts
+var timeFilter = (description) => ({
+  type: "string",
+  minLength: 1,
+  description: `${description} Accepts YYYY-MM-DD, an ISO 8601 timestamp, or a relative delta such as 7d, 12h, or 30min.`
+});
+var keenableProvider = defineProvider({
+  id: "keenable",
+  label: "Keenable",
+  docsUrl: "https://docs.keenable.ai/api-reference/search",
+  local: false,
+  credentials: [{ name: "api", environmentVariable: "KEENABLE_API_KEY" }],
+  fields: ["credentials", "baseUrl", "options"],
+  defaults: {},
+  credentialDefaults: {},
+  capabilities: {
+    search: {
+      options: {
+        type: "object",
+        properties: {
+          mode: {
+            type: "string",
+            enum: ["pro", "realtime"],
+            description: "Search mode: 'pro' (default) for deeper retrieval, 'realtime' for the fastest results. Each mode is billed separately."
+          },
+          site: {
+            type: "string",
+            minLength: 1,
+            description: "Restrict results to one site, e.g. 'techcrunch.com'."
+          },
+          published_after: timeFilter(
+            "Only pages published at or after this time."
+          ),
+          published_before: timeFilter(
+            "Only pages published at or before this time."
+          ),
+          acquired_after: timeFilter(
+            "Only pages indexed at or after this time."
+          ),
+          acquired_before: timeFilter(
+            "Only pages indexed at or before this time."
+          ),
+          query_time: {
+            type: "string",
+            minLength: 1,
+            description: "Search the index as it stood at this date or ISO 8601 timestamp; relative time filters resolve against it."
+          },
+          snippet_max_length: {
+            type: "integer",
+            minimum: 180,
+            maximum: 1e4,
+            description: "Maximum characters of the excerpt per result."
+          }
+        },
+        description: "Keenable search options."
+      },
+      promptGuidelines: [
+        "Keenable returns ranked web results with page excerpts; use web_contents to read selected sources in full.",
+        "Use Keenable site to restrict results to one domain, and published_after/published_before (e.g. '7d') for recent or date-bounded results.",
+        "Use Keenable mode='realtime' only when latency matters more than retrieval depth."
+      ],
+      retrySafe: true
+    }
+  },
+  load: async () => (await import("./adapter-SZMVKAMC.js")).adapter
 });
 
 // src/providers/linkup/definition.ts
@@ -1473,7 +1540,7 @@ var linkupProvider = defineProvider({
       retrySafe: false
     }
   },
-  load: async () => (await import("./adapter-K6AMSUCR.js")).adapter
+  load: async () => (await import("./adapter-QQZFHUOP.js")).adapter
 });
 
 // src/providers/ollama/definition.ts
@@ -1502,7 +1569,7 @@ var ollamaProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-HTMXAJTU.js")).adapter
+  load: async () => (await import("./adapter-57MELLYI.js")).adapter
 });
 
 // src/providers/openai/definition.ts
@@ -1610,7 +1677,7 @@ var openaiProvider = defineProvider({
       retrySafe: false
     }
   },
-  load: async () => (await import("./adapter-VMMS4YQG.js")).adapter
+  load: async () => (await import("./adapter-BZO5UEI6.js")).adapter
 });
 
 // src/providers/parallel/definition.ts
@@ -1769,7 +1836,7 @@ var parallelProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-G3I7JEO5.js")).adapter
+  load: async () => (await import("./adapter-DJCTEEOA.js")).adapter
 });
 
 // src/providers/perplexity/definition.ts
@@ -1890,7 +1957,7 @@ var perplexityProvider = defineProvider({
     answer: { options: chatOptions, retrySafe: false },
     research: { options: chatOptions, retrySafe: false }
   },
-  load: async () => (await import("./adapter-OK2PTP6R.js")).adapter
+  load: async () => (await import("./adapter-D4EXZEDL.js")).adapter
 });
 
 // src/providers/serpbase/definition.ts
@@ -1991,7 +2058,7 @@ var serpbaseProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-QIP32KA4.js")).adapter
+  load: async () => (await import("./adapter-XU2APKPC.js")).adapter
 });
 
 // src/providers/serper/definition.ts
@@ -2131,7 +2198,120 @@ var serperProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-C2VZHFUB.js")).adapter
+  load: async () => (await import("./adapter-MZ7USB6Q.js")).adapter
+});
+
+// src/providers/sofya/definition.ts
+var filters = {
+  topic: {
+    type: "string",
+    enum: ["general", "news"],
+    description: "'news' for news articles, 'general' (default) for web search."
+  },
+  freshness: {
+    type: "string",
+    pattern: "^(day|week|month|year|\\d{4}-\\d{2}-\\d{2}:\\d{4}-\\d{2}-\\d{2})$",
+    description: "Recency filter: day, week, month, year, or a YYYY-MM-DD:YYYY-MM-DD range."
+  }
+};
+var domainFilters = {
+  include_domains: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    maxItems: 10,
+    description: "Only return results from these domains, e.g. 'github.com'."
+  },
+  exclude_domains: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    maxItems: 10,
+    description: "Exclude results from these domains."
+  }
+};
+var searchDepth = {
+  type: "string",
+  enum: ["snippets", "basic"],
+  description: "'snippets' (1 credit) returns search snippets; 'basic' (2 credits) also reads each page and returns its text in metadata.content."
+};
+var sofyaProvider = defineProvider({
+  id: "sofya",
+  label: "Sofya",
+  docsUrl: "https://sofya.co/docs",
+  local: false,
+  credentials: [{ name: "api", environmentVariable: "SOFYA_API_KEY" }],
+  fields: ["credentials", "baseUrl", "options"],
+  defaults: { search: { search_depth: "snippets" } },
+  credentialDefaults: {},
+  capabilities: {
+    search: {
+      // Sofya calls can take up to 60 seconds; allow headroom.
+      defaultTimeoutMs: 9e4,
+      options: {
+        type: "object",
+        properties: {
+          search_depth: searchDepth,
+          ...filters,
+          ...domainFilters
+        },
+        description: "Sofya search options."
+      },
+      promptGuidelines: [
+        "Sofya search returns ranked results with snippets; use web_contents to read selected sources in full.",
+        "Use Sofya topic='news' and freshness (e.g. 'week') for recent events, and include_domains to restrict results to specific sites."
+      ],
+      retrySafe: true
+    },
+    contents: {
+      defaultTimeoutMs: 9e4,
+      options: {
+        type: "object",
+        properties: {
+          include_raw_html: {
+            type: "boolean",
+            description: "Include the raw HTML source in metadata.raw_html."
+          }
+        },
+        description: "Sofya contents options."
+      },
+      retrySafe: true
+    },
+    answer: {
+      defaultTimeoutMs: 9e4,
+      options: {
+        type: "object",
+        properties: {
+          search_depth: searchDepth,
+          max_results: {
+            type: "integer",
+            minimum: 1,
+            maximum: 20,
+            description: "Search results the answer is grounded in."
+          },
+          ...filters,
+          ...domainFilters
+        },
+        description: "Sofya answer options."
+      },
+      retrySafe: false
+    },
+    research: {
+      options: {
+        type: "object",
+        properties: {
+          ...filters,
+          max_sources: {
+            type: "integer",
+            minimum: 5,
+            maximum: 30,
+            description: "Maximum sources to read (default 20)."
+          }
+        },
+        description: "Sofya research options."
+      },
+      retrySafe: false
+    }
+  },
+  load: async () => (await import("./adapter-ODDFBGJG.js")).adapter
 });
 
 // src/providers/tavily/definition.ts
@@ -2326,7 +2506,7 @@ var tavilyProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-UIFBJKKF.js")).adapter
+  load: async () => (await import("./adapter-44ZBIK47.js")).adapter
 });
 
 // src/providers/valyu/definition.ts
@@ -2794,7 +2974,7 @@ var valyuProvider = defineProvider({
       retrySafe: false
     }
   },
-  load: async () => (await import("./adapter-764OQFKY.js")).adapter
+  load: async () => (await import("./adapter-DLNMW34W.js")).adapter
 });
 
 // src/providers/youcom/definition.ts
@@ -2985,7 +3165,7 @@ var youcomProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-2UVAARTV.js")).adapter
+  load: async () => (await import("./adapter-GJOUFE2U.js")).adapter
 });
 
 // src/providers/registry.ts
@@ -2996,6 +3176,7 @@ var providers = {
   exa: exaProvider,
   firecrawl: firecrawlProvider,
   gemini: geminiProvider,
+  keenable: keenableProvider,
   linkup: linkupProvider,
   ollama: ollamaProvider,
   openai: openaiProvider,
@@ -3003,6 +3184,7 @@ var providers = {
   perplexity: perplexityProvider,
   serpbase: serpbaseProvider,
   serper: serperProvider,
+  sofya: sofyaProvider,
   tavily: tavilyProvider,
   valyu: valyuProvider,
   youcom: youcomProvider

package/dist/{chunk-YZXM4U2C.js → chunk-TYJ6RHKB.js}

@@ -3,6 +3,15 @@ import {
 } from "./chunk-U4BLULLV.js";
 
 // src/contents.ts
+function omittedContents(url) {
+  return {
+    url,
+    error: new WebfoxError(
+      "PROVIDER_FAILURE",
+      "The provider omitted a result for this URL."
+    ).toJSON()
+  };
+}
 function orderedContents(response) {
   return {
     provider: response.provider,
@@ -17,5 +26,6 @@ function orderedContents(response) {
 }
 
 export {
+  omittedContents,
   orderedContents
 };

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

@@ -6,21 +6,21 @@ import {
 } from "./chunk-WCTOYZVB.js";
 import {
   configurationSchema
-} from "./chunk-HCYQF24V.js";
+} from "./chunk-KMUCUJVN.js";
 import {
   effectiveOptions,
   optionSchema,
   providers,
   selectProvider,
   validateConfiguredOptions
-} from "./chunk-LTJOWNI2.js";
+} from "./chunk-PVNWACMT.js";
 import {
   cancelProcessGroup,
   killProcessGroup
 } from "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES
-} from "./chunk-GPACLYNT.js";
+} from "./chunk-NENL6L6N.js";
 import {
   WebfoxError,
   asWebfoxError
@@ -442,7 +442,13 @@ var ExecutionRuntime = class {
               throw new WebfoxError(answer.error.code, answer.error.message, {
                 retryable: answer.error.retryable
               });
-            const { inputIndex: _index, error: _error, ...value2 } = answer;
+            const {
+              inputIndex: _index,
+              error: _error,
+              content,
+              ...rest
+            } = answer;
+            const value2 = content?.trim() ? { ...rest, content } : rest;
             return { input, ok: true, value: value2 };
           }
           const operation = capability === "search" ? {
@@ -459,10 +465,7 @@ var ExecutionRuntime = class {
             context
           );
           const value = capability === "search" ? {
-            results: result.results.slice(
-              0,
-              plan.maxResults
-            )
+            results: result.results.slice(0, plan.maxResults).map(searchValue)
           } : textValue(result);
           return { input, ok: true, value };
         } catch (error) {
@@ -546,13 +549,24 @@ var ExecutionRuntime = class {
     }
   }
 };
+function searchValue({ title, ...result }) {
+  const trimmed = title?.trim();
+  return trimmed ? { title: trimmed, ...result } : result;
+}
 function textValue(value) {
+  const sources = value.sources?.flatMap(sourceValue);
   return {
     text: value.text,
-    ...value.itemCount === void 0 ? {} : { itemCount: value.itemCount },
+    ...sources === void 0 ? {} : { sources, itemCount: sources.length },
     ...value.metadata === void 0 ? {} : { metadata: value.metadata }
   };
 }
+function sourceValue(source) {
+  const url = typeof source.url === "string" ? source.url.trim() : "";
+  const title = typeof source.title === "string" ? source.title.trim() : "";
+  if (url) return [title ? { url, title } : { url }];
+  return title ? [{ title }] : [];
+}
 
 // src/application.ts
 function createWebfox(options = {}) {

package/dist/cli.js

@@ -4,26 +4,26 @@ import {
 } from "./chunk-I2UIACY3.js";
 import {
   renderTextDocument
-} from "./chunk-BTWECET5.js";
+} from "./chunk-6RQGO727.js";
 import {
   createWebfox,
   loadConfig,
   redactConfig,
   resolveConfigPath,
   setCapabilityDefault
-} from "./chunk-QZFN2747.js";
+} from "./chunk-YILOS4E7.js";
 import "./chunk-WCTOYZVB.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-HCYQF24V.js";
+} from "./chunk-KMUCUJVN.js";
 import {
   validateConfiguredOptions
-} from "./chunk-LTJOWNI2.js";
+} from "./chunk-PVNWACMT.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES,
   PROVIDER_IDS
-} from "./chunk-GPACLYNT.js";
+} from "./chunk-NENL6L6N.js";
 import {
   WebfoxError
 } from "./chunk-U4BLULLV.js";