webfox 4.9.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-QIP32KA4.js → adapter-EIDSGLOP.js}

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

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-VW4FMMJC.js → adapter-ZYDUANQL.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-ZVTVERW5.js";
 import {
   WEBFOX_ERROR_CODES
-} from "./chunk-GPACLYNT.js";
+} from "./chunk-57OOEOXI.js";
 import {
   WebfoxError
 } from "./chunk-U4BLULLV.js";

package/dist/{chunk-QZFN2747.js → chunk-3WBE6UEW.js}

@@ -6,21 +6,21 @@ import {
 } from "./chunk-WCTOYZVB.js";
 import {
   configurationSchema
-} from "./chunk-HCYQF24V.js";
+} from "./chunk-TGULKHB5.js";
 import {
   effectiveOptions,
   optionSchema,
   providers,
   selectProvider,
   validateConfiguredOptions
-} from "./chunk-LTJOWNI2.js";
+} from "./chunk-5FP7KNMC.js";
 import {
   cancelProcessGroup,
   killProcessGroup
 } from "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES
-} from "./chunk-GPACLYNT.js";
+} from "./chunk-57OOEOXI.js";
 import {
   WebfoxError,
   asWebfoxError

package/dist/{chunk-GPACLYNT.js → chunk-57OOEOXI.js}

@@ -12,6 +12,7 @@ var PROVIDER_IDS = [
   "exa",
   "firecrawl",
   "gemini",
+  "keenable",
   "linkup",
   "ollama",
   "openai",

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

@@ -1,6 +1,6 @@
 import {
   CAPABILITIES
-} from "./chunk-GPACLYNT.js";
+} from "./chunk-57OOEOXI.js";
 import {
   WebfoxError
 } from "./chunk-U4BLULLV.js";
@@ -633,7 +633,7 @@ var customProvider = defineProvider({
       retrySafe: false
     }
   },
-  load: async () => (await import("./adapter-VW4FMMJC.js")).adapter
+  load: async () => (await import("./adapter-ZYDUANQL.js")).adapter
 });
 
 // src/providers/exa/definition.ts
@@ -1278,6 +1278,73 @@ var geminiProvider = defineProvider({
   load: async () => (await import("./adapter-6EZAIE65.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-JJSMYZXG.js")).adapter
+});
+
 // src/providers/linkup/definition.ts
 var linkupProvider = defineProvider({
   id: "linkup",
@@ -1991,7 +2058,7 @@ var serpbaseProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-QIP32KA4.js")).adapter
+  load: async () => (await import("./adapter-EIDSGLOP.js")).adapter
 });
 
 // src/providers/serper/definition.ts
@@ -2996,6 +3063,7 @@ var providers = {
   exa: exaProvider,
   firecrawl: firecrawlProvider,
   gemini: geminiProvider,
+  keenable: keenableProvider,
   linkup: linkupProvider,
   ollama: ollamaProvider,
   openai: openaiProvider,

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

@@ -1,15 +1,15 @@
 import {
   optionSchema,
   providers
-} from "./chunk-LTJOWNI2.js";
+} from "./chunk-5FP7KNMC.js";
 import {
   CAPABILITIES
-} from "./chunk-GPACLYNT.js";
+} from "./chunk-57OOEOXI.js";
 
 // package.json
 var package_default = {
   name: "webfox",
-  version: "4.9.0",
+  version: "4.10.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/cli.js

@@ -11,19 +11,19 @@ import {
   redactConfig,
   resolveConfigPath,
   setCapabilityDefault
-} from "./chunk-QZFN2747.js";
+} from "./chunk-3WBE6UEW.js";
 import "./chunk-WCTOYZVB.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-HCYQF24V.js";
+} from "./chunk-TGULKHB5.js";
 import {
   validateConfiguredOptions
-} from "./chunk-LTJOWNI2.js";
+} from "./chunk-5FP7KNMC.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES,
   PROVIDER_IDS
-} from "./chunk-GPACLYNT.js";
+} from "./chunk-57OOEOXI.js";
 import {
   WebfoxError
 } from "./chunk-U4BLULLV.js";

package/dist/config.schema.json

@@ -23,6 +23,7 @@
                 "custom",
                 "exa",
                 "firecrawl",
+                "keenable",
                 "linkup",
                 "ollama",
                 "openai",
@@ -2197,6 +2198,117 @@
             }
           }
         },
+        "keenable": {
+          "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": {
+                    "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": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Only pages published at or after this time. Accepts YYYY-MM-DD, an ISO 8601 timestamp, or a relative delta such as 7d, 12h, or 30min."
+                    },
+                    "published_before": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Only pages published at or before this time. Accepts YYYY-MM-DD, an ISO 8601 timestamp, or a relative delta such as 7d, 12h, or 30min."
+                    },
+                    "acquired_after": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Only pages indexed at or after this time. Accepts YYYY-MM-DD, an ISO 8601 timestamp, or a relative delta such as 7d, 12h, or 30min."
+                    },
+                    "acquired_before": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Only pages indexed at or before this time. Accepts YYYY-MM-DD, an ISO 8601 timestamp, or a relative delta such as 7d, 12h, or 30min."
+                    },
+                    "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": 10000,
+                      "description": "Maximum characters of the excerpt per result."
+                    }
+                  },
+                  "description": "Keenable search options.",
+                  "additionalProperties": false
+                }
+              }
+            }
+          }
+        },
         "linkup": {
           "type": "object",
           "additionalProperties": false,

package/dist/document-schema.d.ts

@@ -8,7 +8,7 @@ export declare const DOCUMENT_SCHEMAS: {
     readonly search: Type.TObject<{
         schemaVersion: Type.TLiteral<1>;
         capability: Type.TLiteral<"search">;
-        provider: Type.TEnum<["brave", "cloudflare", "custom", "exa", "firecrawl", "gemini", "linkup", "ollama", "openai", "parallel", "perplexity", "serpbase", "serper", "tavily", "valyu", "youcom"]>;
+        provider: Type.TEnum<["brave", "cloudflare", "custom", "exa", "firecrawl", "gemini", "keenable", "linkup", "ollama", "openai", "parallel", "perplexity", "serpbase", "serper", "tavily", "valyu", "youcom"]>;
         status: Type.TEnum<["ok", "partial"]>;
         results: Type.TArray<Type.TUnion<[Type.TObject<{
             input: Type.TString;
@@ -35,7 +35,7 @@ export declare const DOCUMENT_SCHEMAS: {
     readonly contents: Type.TObject<{
         schemaVersion: Type.TLiteral<1>;
         capability: Type.TLiteral<"contents">;
-        provider: Type.TEnum<["brave", "cloudflare", "custom", "exa", "firecrawl", "gemini", "linkup", "ollama", "openai", "parallel", "perplexity", "serpbase", "serper", "tavily", "valyu", "youcom"]>;
+        provider: Type.TEnum<["brave", "cloudflare", "custom", "exa", "firecrawl", "gemini", "keenable", "linkup", "ollama", "openai", "parallel", "perplexity", "serpbase", "serper", "tavily", "valyu", "youcom"]>;
         status: Type.TEnum<["ok", "partial"]>;
         results: Type.TArray<Type.TUnion<[Type.TObject<{
             input: Type.TString;
@@ -59,7 +59,7 @@ export declare const DOCUMENT_SCHEMAS: {
     readonly answer: Type.TObject<{
         schemaVersion: Type.TLiteral<1>;
         capability: Type.TLiteral<"answer">;
-        provider: Type.TEnum<["brave", "cloudflare", "custom", "exa", "firecrawl", "gemini", "linkup", "ollama", "openai", "parallel", "perplexity", "serpbase", "serper", "tavily", "valyu", "youcom"]>;
+        provider: Type.TEnum<["brave", "cloudflare", "custom", "exa", "firecrawl", "gemini", "keenable", "linkup", "ollama", "openai", "parallel", "perplexity", "serpbase", "serper", "tavily", "valyu", "youcom"]>;
         status: Type.TEnum<["ok", "partial"]>;
         results: Type.TArray<Type.TUnion<[Type.TObject<{
             input: Type.TString;
@@ -82,7 +82,7 @@ export declare const DOCUMENT_SCHEMAS: {
     readonly research: Type.TObject<{
         schemaVersion: Type.TLiteral<1>;
         capability: Type.TLiteral<"research">;
-        provider: Type.TEnum<["brave", "cloudflare", "custom", "exa", "firecrawl", "gemini", "linkup", "ollama", "openai", "parallel", "perplexity", "serpbase", "serper", "tavily", "valyu", "youcom"]>;
+        provider: Type.TEnum<["brave", "cloudflare", "custom", "exa", "firecrawl", "gemini", "keenable", "linkup", "ollama", "openai", "parallel", "perplexity", "serpbase", "serper", "tavily", "valyu", "youcom"]>;
         status: Type.TEnum<["ok", "partial"]>;
         results: Type.TArray<Type.TUnion<[Type.TObject<{
             input: Type.TString;

package/dist/domain.d.ts

@@ -1,6 +1,6 @@
 export declare const CAPABILITIES: readonly ["search", "contents", "answer", "research"];
 export type Capability = (typeof CAPABILITIES)[number];
-export declare const PROVIDER_IDS: readonly ["brave", "cloudflare", "custom", "exa", "firecrawl", "gemini", "linkup", "ollama", "openai", "parallel", "perplexity", "serpbase", "serper", "tavily", "valyu", "youcom"];
+export declare const PROVIDER_IDS: readonly ["brave", "cloudflare", "custom", "exa", "firecrawl", "gemini", "keenable", "linkup", "ollama", "openai", "parallel", "perplexity", "serpbase", "serper", "tavily", "valyu", "youcom"];
 export type ProviderId = (typeof PROVIDER_IDS)[number];
 export declare const WEBFOX_ERROR_CODES: readonly ["INVALID_CONFIG", "INVALID_INPUT", "PROVIDER_UNAVAILABLE", "PROVIDER_FAILURE", "PARTIAL_BATCH", "TIMEOUT", "CANCELLED"];
 export type WebfoxErrorCode = (typeof WEBFOX_ERROR_CODES)[number];

package/dist/durable.js

@@ -8,14 +8,14 @@ import {
 } from "./chunk-BTWECET5.js";
 import {
   createWebfox
-} from "./chunk-QZFN2747.js";
+} from "./chunk-3WBE6UEW.js";
 import "./chunk-WCTOYZVB.js";
-import "./chunk-HCYQF24V.js";
-import "./chunk-LTJOWNI2.js";
+import "./chunk-TGULKHB5.js";
+import "./chunk-5FP7KNMC.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES
-} from "./chunk-GPACLYNT.js";
+} from "./chunk-57OOEOXI.js";
 import "./chunk-U4BLULLV.js";
 
 // src/durable.ts

package/dist/index.js

@@ -6,20 +6,20 @@ import {
   resolveConfigPath,
   setCapabilityDefault,
   validateConfig
-} from "./chunk-QZFN2747.js";
+} from "./chunk-3WBE6UEW.js";
 import "./chunk-WCTOYZVB.js";
 import {
   CONFIG_SCHEMA_URL
-} from "./chunk-HCYQF24V.js";
+} from "./chunk-TGULKHB5.js";
 import {
   validateConfiguredOptions
-} from "./chunk-LTJOWNI2.js";
+} from "./chunk-5FP7KNMC.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES,
   PROVIDER_IDS,
   WEBFOX_ERROR_CODES
-} from "./chunk-GPACLYNT.js";
+} from "./chunk-57OOEOXI.js";
 import {
   WebfoxError
 } from "./chunk-U4BLULLV.js";

package/dist/pi.js

@@ -9,16 +9,16 @@ import {
 import {
   createWebfox,
   resolveConfigPath
-} from "./chunk-QZFN2747.js";
+} from "./chunk-3WBE6UEW.js";
 import "./chunk-WCTOYZVB.js";
-import "./chunk-HCYQF24V.js";
-import "./chunk-LTJOWNI2.js";
+import "./chunk-TGULKHB5.js";
+import "./chunk-5FP7KNMC.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES,
   PROVIDER_IDS,
   WEBFOX_ERROR_CODES
-} from "./chunk-GPACLYNT.js";
+} from "./chunk-57OOEOXI.js";
 import {
   WebfoxError
 } from "./chunk-U4BLULLV.js";

package/dist/providers/contract.d.ts

@@ -76,6 +76,7 @@ export interface ProviderConfigMap {
     exa: import("./exa/types.js").Exa;
     firecrawl: import("./firecrawl/types.js").Firecrawl;
     gemini: import("./gemini/types.js").Gemini;
+    keenable: import("./keenable/types.js").Keenable;
     linkup: import("./linkup/types.js").Linkup;
     ollama: import("./ollama/types.js").Ollama;
     openai: import("./openai/types.js").OpenAI;

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

@@ -0,0 +1,5 @@
+import type { ProviderContext, ProviderRequest, SearchResponse } from "../contract.js";
+import type { Keenable } from "./types.js";
+export declare const adapter: {
+    search(request: ProviderRequest<"search">, config: Keenable, context: ProviderContext): Promise<SearchResponse>;
+};

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

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

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

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

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">;

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`.

package/package.json

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