webfox 4.10.0 → 4.11.0

package/dist/{chunk-5FP7KNMC.js → chunk-PVNWACMT.js}

@@ -1,6 +1,6 @@
 import {
   CAPABILITIES
-} from "./chunk-57OOEOXI.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-ZYDUANQL.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,7 @@ 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
@@ -1342,7 +1342,7 @@ var keenableProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-JJSMYZXG.js")).adapter
+  load: async () => (await import("./adapter-SZMVKAMC.js")).adapter
 });
 
 // src/providers/linkup/definition.ts
@@ -1540,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
@@ -1569,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
@@ -1677,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
@@ -1836,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
@@ -1957,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
@@ -2058,7 +2058,7 @@ var serpbaseProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-EIDSGLOP.js")).adapter
+  load: async () => (await import("./adapter-XU2APKPC.js")).adapter
 });
 
 // src/providers/serper/definition.ts
@@ -2198,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
@@ -2393,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
@@ -2861,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
@@ -3052,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
@@ -3071,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-3WBE6UEW.js → chunk-YILOS4E7.js}

@@ -6,21 +6,21 @@ import {
 } from "./chunk-WCTOYZVB.js";
 import {
   configurationSchema
-} from "./chunk-TGULKHB5.js";
+} from "./chunk-KMUCUJVN.js";
 import {
   effectiveOptions,
   optionSchema,
   providers,
   selectProvider,
   validateConfiguredOptions
-} from "./chunk-5FP7KNMC.js";
+} from "./chunk-PVNWACMT.js";
 import {
   cancelProcessGroup,
   killProcessGroup
 } from "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES
-} from "./chunk-57OOEOXI.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-3WBE6UEW.js";
+} from "./chunk-YILOS4E7.js";
 import "./chunk-WCTOYZVB.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-TGULKHB5.js";
+} from "./chunk-KMUCUJVN.js";
 import {
   validateConfiguredOptions
-} from "./chunk-5FP7KNMC.js";
+} from "./chunk-PVNWACMT.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES,
   PROVIDER_IDS
-} from "./chunk-57OOEOXI.js";
+} from "./chunk-NENL6L6N.js";
 import {
   WebfoxError
 } from "./chunk-U4BLULLV.js";

package/dist/config.schema.json

@@ -31,6 +31,7 @@
                 "perplexity",
                 "serpbase",
                 "serper",
+                "sofya",
                 "tavily",
                 "valyu",
                 "youcom"
@@ -55,6 +56,7 @@
                 "linkup",
                 "ollama",
                 "parallel",
+                "sofya",
                 "tavily",
                 "valyu"
               ]
@@ -74,6 +76,7 @@
                 "gemini",
                 "openai",
                 "perplexity",
+                "sofya",
                 "valyu"
               ]
             }
@@ -92,6 +95,7 @@
                 "linkup",
                 "openai",
                 "perplexity",
+                "sofya",
                 "valyu"
               ]
             }
@@ -3786,6 +3790,189 @@
             }
           }
         },
+        "sofya": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "credentials": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "api": {
+                  "oneOf": [
+                    {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "env": {
+                          "type": "string",
+                          "minLength": 1
+                        }
+                      },
+                      "required": ["env"]
+                    },
+                    {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "value": {
+                          "type": "string",
+                          "minLength": 1
+                        }
+                      },
+                      "required": ["value"]
+                    },
+                    {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "command": {
+                          "type": "array",
+                          "minItems": 1,
+                          "items": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        }
+                      },
+                      "required": ["command"]
+                    }
+                  ]
+                }
+              }
+            },
+            "baseUrl": {
+              "type": "string",
+              "minLength": 1
+            },
+            "options": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "search": {
+                  "type": "object",
+                  "properties": {
+                    "search_depth": {
+                      "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."
+                    },
+                    "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."
+                    },
+                    "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."
+                    }
+                  },
+                  "description": "Sofya search options.",
+                  "additionalProperties": false
+                },
+                "contents": {
+                  "type": "object",
+                  "properties": {
+                    "include_raw_html": {
+                      "type": "boolean",
+                      "description": "Include the raw HTML source in metadata.raw_html."
+                    }
+                  },
+                  "description": "Sofya contents options.",
+                  "additionalProperties": false
+                },
+                "answer": {
+                  "type": "object",
+                  "properties": {
+                    "search_depth": {
+                      "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."
+                    },
+                    "max_results": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 20,
+                      "description": "Search results the answer is grounded in."
+                    },
+                    "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."
+                    },
+                    "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."
+                    }
+                  },
+                  "description": "Sofya answer options.",
+                  "additionalProperties": false
+                },
+                "research": {
+                  "type": "object",
+                  "properties": {
+                    "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."
+                    },
+                    "max_sources": {
+                      "type": "integer",
+                      "minimum": 5,
+                      "maximum": 30,
+                      "description": "Maximum sources to read (default 20)."
+                    }
+                  },
+                  "description": "Sofya research options.",
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        },
         "tavily": {
           "type": "object",
           "additionalProperties": false,

package/dist/contents.d.ts

@@ -15,5 +15,10 @@ export interface IndexedContentsResponse {
         error?: SerializedError;
     }>;
 }
+/**
+ * A batch response that leaves out a requested URL has no result for it. This
+ * is a failure, unlike a page that the provider returned without content.
+ */
+export declare function omittedContents(url: string): ContentsAnswer;
 /** Only adapters that themselves assemble pages in request order use this helper. */
 export declare function orderedContents(response: ContentsResponse): IndexedContentsResponse;