webfox 4.9.0 → 4.11.0

package/dist/providers/registry.d.ts

@@ -5,6 +5,7 @@ export declare const providers: {
     readonly exa: import("./definition.js").ProviderDefinitionFor<"exa">;
     readonly firecrawl: import("./definition.js").ProviderDefinitionFor<"firecrawl">;
     readonly gemini: import("./definition.js").ProviderDefinitionFor<"gemini">;
+    readonly keenable: import("./definition.js").ProviderDefinitionFor<"keenable">;
     readonly linkup: import("./definition.js").ProviderDefinitionFor<"linkup">;
     readonly ollama: import("./definition.js").ProviderDefinitionFor<"ollama">;
     readonly openai: import("./definition.js").ProviderDefinitionFor<"openai">;
@@ -12,6 +13,7 @@ export declare const providers: {
     readonly perplexity: import("./definition.js").ProviderDefinitionFor<"perplexity">;
     readonly serpbase: import("./definition.js").ProviderDefinitionFor<"serpbase">;
     readonly serper: import("./definition.js").ProviderDefinitionFor<"serper">;
+    readonly sofya: import("./definition.js").ProviderDefinitionFor<"sofya">;
     readonly tavily: import("./definition.js").ProviderDefinitionFor<"tavily">;
     readonly valyu: import("./definition.js").ProviderDefinitionFor<"valyu">;
     readonly youcom: import("./definition.js").ProviderDefinitionFor<"youcom">;

package/dist/providers/sofya/adapter.d.ts

@@ -0,0 +1,8 @@
+import type { ProviderContext, ProviderRequest, SearchResponse, ToolOutput } from "../contract.js";
+import type { Sofya } from "./types.js";
+export declare const adapter: {
+    search(request: ProviderRequest<"search">, config: Sofya, context: ProviderContext): Promise<SearchResponse>;
+    contents(request: ProviderRequest<"contents">, config: Sofya, context: ProviderContext): Promise<import("../../contents.js").IndexedContentsResponse>;
+    answer(request: ProviderRequest<"answer">, config: Sofya, context: ProviderContext): Promise<ToolOutput>;
+    research(request: ProviderRequest<"research">, config: Sofya, context: ProviderContext): Promise<ToolOutput>;
+};

package/dist/providers/sofya/definition.d.ts

@@ -0,0 +1 @@
+export declare const sofyaProvider: import("../definition.js").ProviderDefinitionFor<"sofya">;

package/dist/providers/sofya/types.d.ts

@@ -0,0 +1,4 @@
+import type { Provider } from "../contract.js";
+export interface Sofya extends Provider {
+    baseUrl?: string;
+}

package/dist/render.d.ts

@@ -1,5 +1,11 @@
-import type { WebDocument } from "./domain.js";
-/** Presentation is deliberately outside the application/runtime. */
+import type { Capability, SearchResult, Source, WebDocument } from "./domain.js";
+/**
+ * Presentation is deliberately outside the application/runtime: providers
+ * return empty results as data, and only renderers decide how they look.
+ */
+export declare function emptyResultText(capability: Capability): string;
+/** Label a search result or source by its title, falling back to its URL. */
+export declare function resultLabel(result: SearchResult | Source): string;
 export declare function renderTextDocument(document: WebDocument, { includeErrors }?: {
     includeErrors?: boolean;
 }): string;

package/docs/provider.md

@@ -123,6 +123,23 @@ The research agent is fixed; answer model settings don't affect it.
 If you previously selected Gemini for search, choose a search-capable provider
 and remove `providers.gemini.options.search` from your configuration.
 
+## Keenable
+
+Supports search. Set `KEENABLE_API_KEY`, or configure
+`providers.keenable.credentials.api` with a credential source. No defaults change
+unless you select Keenable.
+
+```sh
+web search "Node.js release notes" --provider keenable \
+  --site nodejs.org --published-after 30d
+web config default search keenable
+```
+
+Keenable caps `maxResults` at 50. Native options include `mode` (`pro` or
+`realtime`), `site`, `published_after`/`published_before`,
+`acquired_after`/`acquired_before`, `query_time`, and `snippet_max_length`.
+Time filters accept dates, ISO 8601 timestamps, or relative deltas such as `7d`.
+
 ## Linkup
 
 Supports search, page extraction, and research. Set `LINKUP_API_KEY`.
@@ -323,6 +340,33 @@ Supports search. Set `SERPER_API_KEY`.
 web search "Node.js release notes" --provider serper
 ```
 
+## Sofya
+
+Supports search, page extraction, answers, and research. Set `SOFYA_API_KEY`,
+or configure `providers.sofya.credentials.api` with a credential source. No
+defaults change unless you select Sofya.
+
+```sh
+web search "Node.js release notes" --provider sofya --freshness month
+web contents https://nodejs.org/en/blog --provider sofya
+web answer "What is the latest Node.js LTS?" --provider sofya
+web research "State of WebAssembly outside the browser" --provider sofya
+web config default search sofya
+```
+
+Search caps `maxResults` at 20 and defaults to `search_depth: "snippets"`;
+`basic` also reads each page and returns its text in `metadata.content`. Native
+options include `topic` (`general` or `news`), `freshness` (`day`, `week`,
+`month`, `year`, or a `YYYY-MM-DD:YYYY-MM-DD` range), and
+`include_domains`/`exclude_domains`. Answers come from a search with
+`include_answer` and report Sofya's `altered_query` or `relaxed_query` in
+metadata. Contents accepts `include_raw_html`. Research accepts `topic`,
+`freshness`, and `max_sources` (5-30) and usually takes 20-60 seconds.
+
+Sofya calls can take up to 60 seconds, so search, contents, and answers have a
+90-second overall deadline by default. An explicit CLI `--timeout`, library
+`timeoutMs`, or YAML `execution.timeoutMs` takes precedence.
+
 ## You.com
 
 Supports search. Set `YDC_API_KEY`; the library, CLI, and Pi extension use the

package/examples/custom/README.md

@@ -32,10 +32,16 @@ Payloads and responses:
 
 | Capability | Input | Response |
 | --- | --- | --- |
-| Search | `{ "query": "...", "maxResults": 5 }` | `{ "results": [{ "title": "...", "url": "https://...", "snippet": "..." }] }` |
+| Search | `{ "query": "...", "maxResults": 5 }` | `{ "results": [{ "title": "...", "url": "https://...", "snippet": "..." }] }` (`title` is optional) |
 | Contents | `{ "urls": ["https://..."] }` | `{ "answers": [{ "inputIndex": 0, "url": "https://...", "content": "..." }] }` |
-| Answer | `{ "query": "..." }` | `{ "text": "..." }` |
-| Research | `{ "input": "..." }` | `{ "text": "..." }` |
+| Answer | `{ "query": "..." }` | `{ "text": "...", "sources": [{ "url": "https://...", "title": "..." }] }` |
+| Research | `{ "input": "..." }` | `{ "text": "...", "sources": [{ "url": "https://...", "title": "..." }] }` |
+
+Return results as data and leave presentation to webfox. Empty results are
+valid: return no search results, an empty `text`, or a page without `content`
+instead of placeholder text. Omit titles you don't have rather than repeating
+the URL. `sources` is optional; webfox drops sources that have neither a `url`
+nor a `title`.
 
 Contents answers must cover every request index exactly once. `inputIndex`
 associates a response with the requested URL; `url` can hold a redirected URL.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webfox",
-  "version": "4.9.0",
+  "version": "4.11.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": [

package/dist/chunk-BTWECET5.js

@@ -1,31 +0,0 @@
-// src/render.ts
-function renderTextDocument(document, { includeErrors = true } = {}) {
-  return document.results.map((entry, index) => {
-    const heading = document.results.length > 1 ? `## ${index + 1}. ${entry.input}` : "";
-    if (!entry.ok)
-      return includeErrors ? [heading, `Error: ${entry.error.message}`].filter(Boolean).join("\n\n") : void 0;
-    let body;
-    if ("results" in entry.value)
-      body = entry.value.results.length ? entry.value.results.map(
-        (result, i) => `${i + 1}. ${result.title}
-   ${result.url}
-   ${result.snippet.replaceAll("\n", "\n   ")}`
-      ).join("\n\n") : "No results found.";
-    else if ("text" in entry.value) body = entry.value.text;
-    else body = renderContents(entry.value);
-    return [heading, body].filter(Boolean).join("\n\n");
-  }).filter((part) => part !== void 0).join("\n\n");
-}
-function renderContents(answer) {
-  return [
-    `## ${answer.url}`,
-    answer.content,
-    answer.summary === void 0 ? void 0 : `### Summary
-
-${typeof answer.summary === "string" ? answer.summary : JSON.stringify(answer.summary, null, 2)}`
-  ].filter(Boolean).join("\n\n");
-}
-
-export {
-  renderTextDocument
-};