webfox 4.4.1 → 4.5.0

package/README.md

@@ -42,7 +42,7 @@ configuration in your terminal, TypeScript applications, and pi.
   nix run github:mavam/webfox -- --help
   ```
 
-  The flake exports `packages.<system>.default` and `overlays.default` for Linux
+  The flake exports `packages.<system>.default` for Linux
   (`aarch64`, `x86_64`) and macOS (Apple Silicon).
 - **TypeScript:** Add `webfox` as an application dependency.
 - **Pi:** Install the extension:

package/dist/{adapter-RL7JNB22.js → adapter-BQUN3ME2.js}

@@ -2,7 +2,7 @@ import {
   SERPBASE_MODES,
   serpbaseProvider,
   validateOptions
-} from "./chunk-VYMIR35R.js";
+} from "./chunk-KH54YH7D.js";
 import "./chunk-GPACLYNT.js";
 import {
   trimSnippet

package/dist/{chunk-DZ6C4PJH.js → chunk-D4HCJRBE.js}

@@ -6,14 +6,14 @@ import {
 } from "./chunk-WCTOYZVB.js";
 import {
   configurationSchema
-} from "./chunk-HFTQQEQC.js";
+} from "./chunk-VI3473TU.js";
 import {
   effectiveOptions,
   optionSchema,
   providers,
   selectProvider,
   validateConfiguredOptions
-} from "./chunk-VYMIR35R.js";
+} from "./chunk-KH54YH7D.js";
 import {
   cancelProcessGroup,
   killProcessGroup

package/dist/{chunk-VYMIR35R.js → chunk-KH54YH7D.js}

@@ -637,6 +637,11 @@ var customProvider = defineProvider({
 });
 
 // src/providers/exa/definition.ts
+var snapshotAsOf = {
+  type: "string",
+  minLength: 1,
+  description: "ISO datetime cutoff, such as '2026-07-01T00:00:00Z'. Return the newest stored page version at or before this instant; pages without an eligible version are omitted. Do not combine with maxAgeHours, livecrawlTimeout, or subpages."
+};
 var exaProvider = defineProvider({
   id: "exa",
   label: "Exa",
@@ -844,6 +849,7 @@ var exaProvider = defineProvider({
                 ],
                 description: "Include AI-generated summary."
               },
+              snapshotAsOf,
               livecrawlTimeout: {
                 type: "integer",
                 minimum: 1,
@@ -897,7 +903,7 @@ var exaProvider = defineProvider({
               }
             },
             additionalProperties: false,
-            description: "Content extraction and freshness controls. Put text, highlights, summary, maxAgeHours, and livecrawlTimeout here, not directly in options."
+            description: "Content extraction, freshness, and historical snapshot controls. Put text, highlights, summary, snapshotAsOf, maxAgeHours, and livecrawlTimeout here, not directly in options."
           }
         },
         description: "Exa search options."
@@ -908,12 +914,27 @@ var exaProvider = defineProvider({
         "Set includeDomains or excludeDomains when the task names preferred sources, requires primary sources, or needs noisy domains filtered out.",
         "For fresh Exa search content, use options.contents.maxAgeHours=0; for cache-only retrieval use -1. Never put maxAgeHours at the top level of options.",
         "Do not send deprecated livecrawl, even alongside maxAgeHours. Remove livecrawl rather than moving it into contents. Exa ignores startCrawlDate/endCrawlDate; use startPublishedDate/endPublishedDate to filter publication dates, not cache freshness.",
+        "For historical page versions, set options.contents.snapshotAsOf to an ISO datetime. Use type auto, fast, or instant; omit category, maxAgeHours, livecrawl, livecrawlTimeout, and subpages. Snapshot bounds content, not ranking: Exa still discovers URLs using current retrieval signals. Snapshot is a research preview with limited access and lookback.",
         "Use includeText/excludeText for short required or forbidden phrases in page text.",
         "Request contents.text, contents.highlights, or contents.summary only when snippets are insufficient and richer source context is needed directly in search results."
       ],
       retrySafe: true
     },
     contents: {
+      options: {
+        type: "object",
+        properties: {
+          snapshotAsOf,
+          text: {
+            type: "boolean",
+            description: "Include text content."
+          }
+        },
+        description: "Exa contents options."
+      },
+      promptGuidelines: [
+        "For historical page versions, set options.snapshotAsOf to an ISO datetime (not nested inside contents). Exa returns the newest stored version at or before that instant and omits pages without an eligible version. Snapshot is a research preview with limited access and lookback."
+      ],
       retrySafe: true
     },
     answer: {
@@ -1970,7 +1991,7 @@ var serpbaseProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-RL7JNB22.js")).adapter
+  load: async () => (await import("./adapter-BQUN3ME2.js")).adapter
 });
 
 // src/providers/serper/definition.ts

package/dist/{chunk-HFTQQEQC.js → chunk-VI3473TU.js}

@@ -1,7 +1,7 @@
 import {
   optionSchema,
   providers
-} from "./chunk-VYMIR35R.js";
+} from "./chunk-KH54YH7D.js";
 import {
   CAPABILITIES
 } from "./chunk-GPACLYNT.js";
@@ -9,7 +9,7 @@ import {
 // package.json
 var package_default = {
   name: "webfox",
-  version: "4.4.1",
+  version: "4.5.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,14 +11,14 @@ import {
   redactConfig,
   resolveConfigPath,
   setCapabilityDefault
-} from "./chunk-DZ6C4PJH.js";
+} from "./chunk-D4HCJRBE.js";
 import "./chunk-WCTOYZVB.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-HFTQQEQC.js";
+} from "./chunk-VI3473TU.js";
 import {
   validateConfiguredOptions
-} from "./chunk-VYMIR35R.js";
+} from "./chunk-KH54YH7D.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES,

package/dist/config.schema.json

@@ -1388,6 +1388,11 @@
                           ],
                           "description": "Include AI-generated summary."
                         },
+                        "snapshotAsOf": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "ISO datetime cutoff, such as '2026-07-01T00:00:00Z'. Return the newest stored page version at or before this instant; pages without an eligible version are omitted. Do not combine with maxAgeHours, livecrawlTimeout, or subpages."
+                        },
                         "livecrawlTimeout": {
                           "type": "integer",
                           "minimum": 1,
@@ -1441,7 +1446,7 @@
                         }
                       },
                       "additionalProperties": false,
-                      "description": "Content extraction and freshness controls. Put text, highlights, summary, maxAgeHours, and livecrawlTimeout here, not directly in options."
+                      "description": "Content extraction, freshness, and historical snapshot controls. Put text, highlights, summary, snapshotAsOf, maxAgeHours, and livecrawlTimeout here, not directly in options."
                     }
                   },
                   "description": "Exa search options.",
@@ -1449,6 +1454,18 @@
                 },
                 "contents": {
                   "type": "object",
+                  "properties": {
+                    "snapshotAsOf": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "ISO datetime cutoff, such as '2026-07-01T00:00:00Z'. Return the newest stored page version at or before this instant; pages without an eligible version are omitted. Do not combine with maxAgeHours, livecrawlTimeout, or subpages."
+                    },
+                    "text": {
+                      "type": "boolean",
+                      "description": "Include text content."
+                    }
+                  },
+                  "description": "Exa contents options.",
                   "additionalProperties": false
                 },
                 "answer": {

package/dist/index.js

@@ -6,14 +6,14 @@ import {
   resolveConfigPath,
   setCapabilityDefault,
   validateConfig
-} from "./chunk-DZ6C4PJH.js";
+} from "./chunk-D4HCJRBE.js";
 import "./chunk-WCTOYZVB.js";
 import {
   CONFIG_SCHEMA_URL
-} from "./chunk-HFTQQEQC.js";
+} from "./chunk-VI3473TU.js";
 import {
   validateConfiguredOptions
-} from "./chunk-VYMIR35R.js";
+} from "./chunk-KH54YH7D.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES,

package/dist/pi.js

@@ -4,10 +4,10 @@ import {
 import {
   createWebfox,
   resolveConfigPath
-} from "./chunk-DZ6C4PJH.js";
+} from "./chunk-D4HCJRBE.js";
 import "./chunk-WCTOYZVB.js";
-import "./chunk-HFTQQEQC.js";
-import "./chunk-VYMIR35R.js";
+import "./chunk-VI3473TU.js";
+import "./chunk-KH54YH7D.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES
@@ -288,11 +288,7 @@ var WebCall = class {
     const { args, theme, capability } = this;
     const title = theme.fg("toolTitle", theme.bold(`web ${capability}`));
     let text = title;
-    const parameters = callParameters(
-      capability,
-      args,
-      (key2) => theme.bold(key2)
-    );
+    const parameters = callParameters(capability, args);
     if (parameters) text += theme.fg("dim", ` ${parameters}`);
     if (this.expanded)
       return visibleWidth2(text) <= width ? [text] : new Text2(text, 0, 0).render(width).map((line) => truncateLine(line, width));

package/docs/provider.md

@@ -74,6 +74,26 @@ web search "Node.js release notes" --provider exa
 web research "Compare databases for an analytics service" --provider exa --timeout 20m
 ```
 
+Use [Exa Snapshot](https://exa.ai/docs/search/snapshot) to retrieve the newest
+stored page version at or before an ISO datetime. For search, set
+`options.contents.snapshotAsOf`; for page extraction, set `options.snapshotAsOf`.
+Both options are also exposed to the model when Exa is selected in pi.
+
+```sh
+web search "Python release notes" --provider exa \
+  --options-json '{"contents":{"snapshotAsOf":"2026-07-01T00:00:00Z"}}'
+web contents https://docs.python.org/3/whatsnew/ --provider exa \
+  --options-json '{"snapshotAsOf":"2026-07-01T00:00:00Z","text":true}'
+```
+
+Snapshot search supports `auto`, `fast`, and `instant`, without `category`.
+Do not combine snapshots with `maxAgeHours`, `livecrawl`, `livecrawlTimeout`, or
+`subpages`, including saved defaults. Pages without an eligible snapshot are
+omitted by Exa; page extraction reports those URLs as failures. The cutoff bounds
+page content, not ranking: Exa still discovers candidate URLs using current
+retrieval signals. Snapshot is a research preview with limited access and
+lookback; consult Exa's documentation for current limits.
+
 ## Firecrawl
 
 Supports search, page extraction, and page-scoped answers. Set `FIRECRAWL_API_KEY`

package/package.json

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