webfox 4.6.0 → 4.8.0

package/README.md

@@ -244,6 +244,95 @@ Ask Pi: **Search the web for the latest Node.js release notes.**
 Add `contents`, `answer`, or `research` defaults for more tools.
 Restart Pi after changing defaults.
 
+### Compose web calls with codemode
+
+With Pi 0.99 or later, you can use its built-in `codemode` tool to chain web
+calls, run independent calls in parallel, and filter results before they reach
+the model. In `~/.pi/agent/settings.json` or your project's `.pi/settings.json`,
+add:
+
+```json
+{
+  "defaultTools": ["+codemode"]
+}
+```
+
+This keeps your existing tools and adds codemode. Webfox tools remain directly
+callable; you don't need an MCP server or another extension. In codemode, calls
+such as `tools.web_search(...)` return structured result objects, not text.
+Scripts receive complete results even when the direct tool output is truncated.
+Only the output you emit with `text(...)` or `return` reaches the model.
+
+Ask Pi: **Use codemode to search for Node.js and Bun cancellation, fetch up to
+five unique pages, and return a short excerpt from each.** Pi can run a script
+like this, provided you have configured both `search` and `contents` defaults:
+
+```js
+const search = await tools.web_search({
+  queries: ["Node.js cancellation", "Bun cancellation"],
+  maxResults: 3,
+});
+
+// Keep failed inputs visible while using the successful results.
+for (const entry of search.results) {
+  if (!entry.ok) text({ input: entry.input, error: entry.error });
+}
+
+const urls = [...new Set(
+  search.results.flatMap(entry =>
+    entry.ok ? entry.value.results.map(hit => hit.url) : []
+  )
+)].slice(0, 5);
+
+if (!urls.length) exit();
+
+const pages = await tools.web_contents({ urls });
+text(pages.results.map(entry =>
+  entry.ok
+    ? { url: entry.value.url, excerpt: entry.value.content?.slice(0, 3000) }
+    : { url: entry.input, error: entry.error }
+));
+```
+
+For independent tasks, await every call with `Promise.allSettled`. This example
+requires an `answer` default and keeps one rejected call from discarding the
+other call's result:
+
+```js
+const answers = await Promise.allSettled([
+  tools.web_answer({ queries: ["What is an AbortSignal?"] }),
+  tools.web_answer({ queries: ["How does Bun handle cancellation?"] }),
+]);
+
+for (const answer of answers) {
+  if (answer.status === "fulfilled") text(answer.value);
+  else text({ error: String(answer.reason) });
+}
+```
+
+A Webfox document with `status: "partial"` still resolves: check each result's
+`ok` field before accessing `value`. Invalid arguments and blocked tool calls
+reject instead. Nested calls still pass through Pi's validation and permission
+hooks.
+
+To return less data, select the fields you need rather than emit a whole
+document. For example, this returns only titles and source URLs:
+
+```js
+const search = await tools.web_search({ queries: ["Node.js release notes"] });
+text(search.results.flatMap(entry =>
+  entry.ok
+    ? entry.value.results.map(({ title, url }) => ({ title, url }))
+    : [{ input: entry.input, error: entry.error }]
+));
+```
+
+Webfox tools belong to the `web` namespace, which you can search from scripts
+with `await searchTools("search", { namespace: "web" })`. To route all callable
+tools through scripts, set `"codemode": { "mode": "only" }` in Pi's settings
+alongside `defaultTools`. This setting affects all callable tools, not only
+Webfox.
+
 ## 📚 Use with TypeScript
 
 ```ts
@@ -266,6 +355,25 @@ The client also provides `contents`, `answer`, and `research`. See the
 [library reference](./docs/reference.md#typescript-library) for request controls,
 configuration, progress, and errors.
 
+## 🧬 Use with Pi Durable
+
+A custom Pi Durable host can install the web tools directly:
+
+```ts
+import { createWebfoxExtension } from "webfox/durable";
+
+registry.install(createWebfoxExtension({ cwd: process.cwd() }));
+```
+
+The adapter uses the shared Webfox configuration and provider-specific schemas.
+Each call follows its conversation's execution environment, streams progress,
+and preserves partial failures. Large text results are saved to private files.
+Interrupted requests are not replayed automatically, since providers may charge
+for them. Cancelling a request may not cancel a provider's already-running job.
+
+The adapter requires Pi Durable 1.0. It does not install a CLI, register standard
+Pi renderers, or provide codemode's structured-result interface.
+
 ## 🩺 Troubleshooting
 
 - **No provider selected:** Pass `--provider <id>` or save a default with

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

@@ -2,11 +2,11 @@ import {
   SERPBASE_MODES,
   serpbaseProvider,
   validateOptions
-} from "./chunk-KH54YH7D.js";
-import "./chunk-GPACLYNT.js";
+} from "./chunk-QERSNL3J.js";
 import {
   trimSnippet
 } from "./chunk-X6ZBIHZC.js";
+import "./chunk-GPACLYNT.js";
 import {
   WebfoxError,
   httpError

package/dist/{adapter-NEXSOHGT.js → adapter-SLTIAAML.js}

@@ -130,9 +130,21 @@ function createClient(config) {
   return new PerplexityClient({
     maxRetries: 0,
     apiKey,
-    baseURL: config.baseUrl
+    baseURL: config.baseUrl,
+    ...shouldSendIntegrationHeader(config.baseUrl) ? { defaultHeaders: { "X-Pplx-Integration": "webfox" } } : {}
   });
 }
+function shouldSendIntegrationHeader(baseUrl) {
+  const customHeaders = process.env.PERPLEXITY_CUSTOM_HEADERS ?? "";
+  if (/^\s*x-pplx-integration\s*:/im.test(customHeaders)) return false;
+  const url = baseUrl ?? process.env.PERPLEXITY_BASE_URL?.trim();
+  if (!url) return true;
+  try {
+    return new URL(url).hostname === "api.perplexity.ai";
+  } catch {
+    return false;
+  }
+}
 function resolveModel(optionModel, fallbackModel) {
   if (typeof optionModel === "string" && optionModel.trim().length > 0) {
     return optionModel;

package/dist/{chunk-5TNPVBAZ.js → chunk-G7LMBPW4.js}

@@ -1,7 +1,7 @@
 import {
   optionSchema,
   providers
-} from "./chunk-KH54YH7D.js";
+} from "./chunk-QERSNL3J.js";
 import {
   CAPABILITIES
 } from "./chunk-GPACLYNT.js";
@@ -9,7 +9,7 @@ import {
 // package.json
 var package_default = {
   name: "webfox",
-  version: "4.6.0",
+  version: "4.8.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: [
@@ -82,10 +82,14 @@ var package_default = {
       types: "./dist/pi.d.ts",
       import: "./dist/pi.js"
     },
+    "./durable": {
+      types: "./dist/durable.d.ts",
+      import: "./dist/durable.js"
+    },
     "./config.schema.json": "./dist/config.schema.json"
   },
   scripts: {
-    build: "rm -rf dist && esbuild index=src/index.ts cli=src/cli.ts pi=src/pi.ts generate-schema=scripts/generate-schema.ts --bundle --splitting --format=esm --platform=node --target=node22 --packages=external --outdir=dist && node dist/generate-schema.js && biome format --write src/config.schema.json >&2 && rm dist/generate-schema.js && tsc --project tsconfig.build.json && cp src/config.schema.json dist/config.schema.json && chmod +x dist/cli.js",
+    build: "rm -rf dist && esbuild index=src/index.ts cli=src/cli.ts pi=src/pi.ts durable=src/durable.ts generate-schema=scripts/generate-schema.ts --bundle --splitting --format=esm --platform=node --target=node22 --packages=external --outdir=dist && node dist/generate-schema.js && biome format --write src/config.schema.json >&2 && rm dist/generate-schema.js && tsc --project tsconfig.build.json && cp src/config.schema.json dist/config.schema.json && chmod +x dist/cli.js",
     prepare: "npm run build",
     prepack: "npm run build",
     check: "tsc --noEmit",
@@ -112,20 +116,26 @@ var package_default = {
   },
   devDependencies: {
     "@biomejs/biome": "^2.5.4",
-    "@earendil-works/pi-ai": "^0.99.0",
-    "@earendil-works/pi-coding-agent": "^0.99.0",
-    "@earendil-works/pi-tui": "^0.99.0",
+    "@earendil-works/chord": "^1.0.0",
+    "@earendil-works/pi-ai": "^1.0.0",
+    "@earendil-works/pi-coding-agent": "^1.0.0",
+    "@earendil-works/pi-durable": "^1.0.0",
+    "@earendil-works/pi-tui": "^1.0.0",
     "@types/node": "^26.1.1",
     esbuild: "^0.28.1",
     typescript: "^7.0.2",
     vitest: "^4.1.10"
   },
   peerDependencies: {
+    "@earendil-works/pi-durable": "^1.0.0",
     "@earendil-works/pi-coding-agent": "*",
     "@earendil-works/pi-tui": "*",
     typebox: "*"
   },
   peerDependenciesMeta: {
+    "@earendil-works/pi-durable": {
+      optional: true
+    },
     "@earendil-works/pi-coding-agent": {
       optional: true
     },

package/dist/{chunk-QXTTUDLI.js → chunk-IRKSK34I.js}

@@ -6,14 +6,14 @@ import {
 } from "./chunk-WCTOYZVB.js";
 import {
   configurationSchema
-} from "./chunk-5TNPVBAZ.js";
+} from "./chunk-G7LMBPW4.js";
 import {
   effectiveOptions,
   optionSchema,
   providers,
   selectProvider,
   validateConfiguredOptions
-} from "./chunk-KH54YH7D.js";
+} from "./chunk-QERSNL3J.js";
 import {
   cancelProcessGroup,
   killProcessGroup

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

@@ -1890,7 +1890,7 @@ var perplexityProvider = defineProvider({
     answer: { options: chatOptions, retrySafe: false },
     research: { options: chatOptions, retrySafe: false }
   },
-  load: async () => (await import("./adapter-NEXSOHGT.js")).adapter
+  load: async () => (await import("./adapter-SLTIAAML.js")).adapter
 });
 
 // src/providers/serpbase/definition.ts
@@ -1991,7 +1991,7 @@ var serpbaseProvider = defineProvider({
       retrySafe: true
     }
   },
-  load: async () => (await import("./adapter-BQUN3ME2.js")).adapter
+  load: async () => (await import("./adapter-QU2G7O25.js")).adapter
 });
 
 // src/providers/serper/definition.ts

package/dist/chunk-VVOQKYOP.js

@@ -0,0 +1,112 @@
+// src/tool-definition.ts
+import { Type } from "typebox";
+function webToolParameters(inspection) {
+  const capability = inspection.capability;
+  const fields = capability === "contents" ? { urls: Type.Array(Type.String({ minLength: 1 }), { minItems: 1 }) } : capability === "research" ? { input: Type.String({ minLength: 1 }) } : {
+    queries: Type.Array(Type.String({ minLength: 1 }), {
+      minItems: 1,
+      maxItems: 10
+    }),
+    ...capability === "search" ? { maxResults: Type.Optional(Type.Integer({ minimum: 1 })) } : {}
+  };
+  return Type.Object(
+    {
+      ...fields,
+      ...inspection.optionSchema ? {
+        options: Type.Optional(
+          inspection.optionSchema
+        )
+      } : {}
+    },
+    { additionalProperties: false }
+  );
+}
+var descriptions = {
+  search: "Search up to ten queries and return titles, URLs, and snippets in input order.",
+  contents: "Fetch and extract readable contents from web URLs.",
+  answer: "Answer up to ten questions using web-grounded evidence.",
+  research: "Run foreground multi-step web research and return the final report."
+};
+
+// src/pi-validation.ts
+import { stripVTControlCharacters } from "node:util";
+import { Check, Errors } from "typebox/value";
+function isSchema(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function alternatives(schema) {
+  return ["anyOf", "oneOf", "allOf"].flatMap(
+    (key) => Array.isArray(schema[key]) ? schema[key].filter(isSchema) : []
+  );
+}
+function acceptsPath(schema, path) {
+  if (schema === true) return true;
+  if (!isSchema(schema)) return false;
+  if (!path.length) return true;
+  if (alternatives(schema).some((branch) => acceptsPath(branch, path)))
+    return true;
+  const [key, ...rest] = path;
+  if (schema.type === "array") return acceptsPath(schema.items, rest);
+  if (schema.properties && Object.hasOwn(schema.properties, key))
+    return acceptsPath(schema.properties[key], rest);
+  if (isSchema(schema.patternProperties)) {
+    for (const [pattern, child] of Object.entries(schema.patternProperties))
+      if (new RegExp(pattern).test(key) && acceptsPath(child, rest))
+        return true;
+  }
+  if (schema.additionalProperties === false) return false;
+  if (schema.type && schema.type !== "object") return false;
+  if (alternatives(schema).length && !schema.properties && schema.additionalProperties === void 0)
+    return false;
+  return schema.additionalProperties === void 0 || acceptsPath(schema.additionalProperties, rest);
+}
+function displayPath(path) {
+  return path.map((part, index) => {
+    const safe = stripVTControlCharacters(part);
+    if (/^[a-zA-Z_][\w-]*$/.test(safe)) return `${index ? "." : ""}${safe}`;
+    if (/^\d+$/.test(safe)) return `[${safe}]`;
+    return `[${JSON.stringify(safe)}]`;
+  }).join("");
+}
+function locations(schema, name, path = []) {
+  if (!isSchema(schema)) return [];
+  const found = alternatives(schema).flatMap(
+    (branch) => locations(branch, name, path)
+  );
+  if (isSchema(schema.properties)) {
+    for (const [key, child] of Object.entries(schema.properties)) {
+      const next = [...path, key];
+      if (key === name) found.push(next);
+      found.push(...locations(child, name, next));
+    }
+  }
+  return found;
+}
+function prepareToolArguments(schema, args) {
+  if (Check(schema, args)) return args;
+  const messages = /* @__PURE__ */ new Set();
+  for (const error of Errors(schema, args)) {
+    if (error.keyword !== "additionalProperties") continue;
+    const names = error.params.additionalProperties;
+    if (!Array.isArray(names)) continue;
+    const parent = error.instancePath.split("/").slice(1).map((part) => part.replaceAll("~1", "/").replaceAll("~0", "~"));
+    for (const name of names) {
+      if (typeof name !== "string") continue;
+      const path = [...parent, name];
+      if (acceptsPath(schema, path)) continue;
+      const targets = [...new Set(locations(schema, name).map(displayPath))];
+      const suggestion = targets.length === 1 ? ` Use ${targets[0]} instead.` : " Check the tool's parameter schema.";
+      messages.add(`Invalid parameter: ${displayPath(path)}.${suggestion}`);
+      if (messages.size === 3) break;
+    }
+    if (messages.size === 3) break;
+  }
+  if (messages.size) throw new Error([...messages].join("\n"));
+  return args;
+}
+
+export {
+  webToolParameters,
+  descriptions,
+  prepareToolArguments
+};

package/dist/cli.js

@@ -11,14 +11,14 @@ import {
   redactConfig,
   resolveConfigPath,
   setCapabilityDefault
-} from "./chunk-QXTTUDLI.js";
+} from "./chunk-IRKSK34I.js";
 import "./chunk-WCTOYZVB.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-5TNPVBAZ.js";
+} from "./chunk-G7LMBPW4.js";
 import {
   validateConfiguredOptions
-} from "./chunk-KH54YH7D.js";
+} from "./chunk-QERSNL3J.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES,

package/dist/durable.d.ts

@@ -0,0 +1,8 @@
+import { type Extension } from "@earendil-works/pi-durable";
+import { type WebfoxClient, type CreateWebfoxOptions } from "./index.js";
+export interface DurableWebfoxOptions extends CreateWebfoxOptions {
+    /** Supply a client for an embedded host or deterministic tests. */
+    client?: WebfoxClient;
+}
+/** Install alongside CodingTools. Every call uses the conversation's current environment. */
+export declare function createWebfoxExtension(options?: DurableWebfoxOptions): Extension;

package/dist/durable.js

@@ -0,0 +1,124 @@
+import {
+  descriptions,
+  prepareToolArguments,
+  webToolParameters
+} from "./chunk-VVOQKYOP.js";
+import {
+  renderTextDocument
+} from "./chunk-BTWECET5.js";
+import {
+  createWebfox
+} from "./chunk-IRKSK34I.js";
+import "./chunk-WCTOYZVB.js";
+import "./chunk-G7LMBPW4.js";
+import "./chunk-QERSNL3J.js";
+import "./chunk-ZVTVERW5.js";
+import {
+  CAPABILITIES
+} from "./chunk-GPACLYNT.js";
+import "./chunk-U4BLULLV.js";
+
+// src/durable.ts
+import { mkdtemp, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import {
+  truncateHead,
+  withFileMutationQueue
+} from "@earendil-works/pi-coding-agent";
+import {
+  defineExtension,
+  defineTool
+} from "@earendil-works/pi-durable";
+function createWebfoxExtension(options = {}) {
+  const clients = /* @__PURE__ */ new Map();
+  const clientFor = (cwd) => {
+    if (options.client) return options.client;
+    let client = clients.get(cwd);
+    if (!client) {
+      client = createWebfox({ ...options, cwd });
+      clients.set(cwd, client);
+    }
+    return client;
+  };
+  const initialCwd = options.cwd ?? process.cwd();
+  const initial = clientFor(initialCwd);
+  const inspections = CAPABILITIES.map(
+    (capability) => initial.inspectCapability(capability)
+  ).filter((inspection) => inspection.provider);
+  return defineExtension({
+    name: "webfox",
+    tools: inspections.map((inspection) => {
+      const capability = inspection.capability;
+      const parameters = webToolParameters(inspection);
+      return defineTool({
+        name: `web_${capability}`,
+        description: [
+          descriptions[capability],
+          ...inspection.promptGuidelines ?? [],
+          "Output is limited to 2000 lines or 50 KiB; complete results are saved to a private file when truncated."
+        ].join("\n"),
+        parameters,
+        // Web requests may incur charges. A crash reports interruption rather than silently charging again.
+        replay: "unsafe",
+        prepareArguments: (args) => prepareToolArguments(parameters, args),
+        async execute(args, api, context) {
+          const client = clientFor(
+            api.env?.cwd ?? (await api.agent(context)).cwd ?? initialCwd
+          );
+          const request = {
+            provider: inspection.provider,
+            signal: context.abortSignal,
+            options: args.options,
+            onProgress: (event) => api.output(`${event.message}
+`)
+          };
+          const result = capability === "search" ? await client.search({
+            ...request,
+            queries: args.queries,
+            maxResults: args.maxResults
+          }) : capability === "contents" ? await client.contents({
+            ...request,
+            urls: args.urls
+          }) : capability === "answer" ? await client.answer({
+            ...request,
+            queries: args.queries
+          }) : await client.research({
+            ...request,
+            input: args.input
+          });
+          const truncated = truncateHead(renderTextDocument(result));
+          let body = truncated.content;
+          let fullOutputPath;
+          if (truncated.truncated) {
+            fullOutputPath = join(
+              await mkdtemp(join(tmpdir(), "web-")),
+              "result.json"
+            );
+            await withFileMutationQueue(
+              fullOutputPath,
+              () => writeFile(fullOutputPath, JSON.stringify(result), {
+                mode: 384
+              })
+            );
+            body += `
+
+Full results: ${fullOutputPath}`;
+          }
+          return {
+            content: [{ type: "text", text: body }],
+            isError: result.status === "partial",
+            details: {
+              status: result.status,
+              capability,
+              ...fullOutputPath ? { fullOutputPath } : {}
+            }
+          };
+        }
+      });
+    })
+  });
+}
+export {
+  createWebfoxExtension
+};

package/dist/index.js

@@ -6,14 +6,14 @@ import {
   resolveConfigPath,
   setCapabilityDefault,
   validateConfig
-} from "./chunk-QXTTUDLI.js";
+} from "./chunk-IRKSK34I.js";
 import "./chunk-WCTOYZVB.js";
 import {
   CONFIG_SCHEMA_URL
-} from "./chunk-5TNPVBAZ.js";
+} from "./chunk-G7LMBPW4.js";
 import {
   validateConfiguredOptions
-} from "./chunk-KH54YH7D.js";
+} from "./chunk-QERSNL3J.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES,

package/dist/pi.js

@@ -1,13 +1,18 @@
+import {
+  descriptions,
+  prepareToolArguments,
+  webToolParameters
+} from "./chunk-VVOQKYOP.js";
 import {
   renderTextDocument
 } from "./chunk-BTWECET5.js";
 import {
   createWebfox,
   resolveConfigPath
-} from "./chunk-QXTTUDLI.js";
+} from "./chunk-IRKSK34I.js";
 import "./chunk-WCTOYZVB.js";
-import "./chunk-5TNPVBAZ.js";
-import "./chunk-KH54YH7D.js";
+import "./chunk-G7LMBPW4.js";
+import "./chunk-QERSNL3J.js";
 import "./chunk-ZVTVERW5.js";
 import {
   CAPABILITIES,
@@ -26,7 +31,6 @@ import {
   truncateHead,
   withFileMutationQueue
 } from "@earendil-works/pi-coding-agent";
-import { Type as Type2 } from "typebox";
 
 // src/pi-render.ts
 import { stripVTControlCharacters as stripVTControlCharacters3 } from "node:util";
@@ -342,83 +346,6 @@ function renderWebResult(result, options, theme, isError, capability) {
   };
 }
 
-// src/pi-validation.ts
-import { stripVTControlCharacters as stripVTControlCharacters4 } from "node:util";
-import { Check, Errors } from "typebox/value";
-function isSchema(value) {
-  return !!value && typeof value === "object" && !Array.isArray(value);
-}
-function alternatives(schema) {
-  return ["anyOf", "oneOf", "allOf"].flatMap(
-    (key) => Array.isArray(schema[key]) ? schema[key].filter(isSchema) : []
-  );
-}
-function acceptsPath(schema, path) {
-  if (schema === true) return true;
-  if (!isSchema(schema)) return false;
-  if (!path.length) return true;
-  if (alternatives(schema).some((branch) => acceptsPath(branch, path)))
-    return true;
-  const [key, ...rest] = path;
-  if (schema.type === "array") return acceptsPath(schema.items, rest);
-  if (schema.properties && Object.hasOwn(schema.properties, key))
-    return acceptsPath(schema.properties[key], rest);
-  if (isSchema(schema.patternProperties)) {
-    for (const [pattern, child] of Object.entries(schema.patternProperties))
-      if (new RegExp(pattern).test(key) && acceptsPath(child, rest))
-        return true;
-  }
-  if (schema.additionalProperties === false) return false;
-  if (schema.type && schema.type !== "object") return false;
-  if (alternatives(schema).length && !schema.properties && schema.additionalProperties === void 0)
-    return false;
-  return schema.additionalProperties === void 0 || acceptsPath(schema.additionalProperties, rest);
-}
-function displayPath(path) {
-  return path.map((part, index) => {
-    const safe = stripVTControlCharacters4(part);
-    if (/^[a-zA-Z_][\w-]*$/.test(safe)) return `${index ? "." : ""}${safe}`;
-    if (/^\d+$/.test(safe)) return `[${safe}]`;
-    return `[${JSON.stringify(safe)}]`;
-  }).join("");
-}
-function locations(schema, name, path = []) {
-  if (!isSchema(schema)) return [];
-  const found = alternatives(schema).flatMap(
-    (branch) => locations(branch, name, path)
-  );
-  if (isSchema(schema.properties)) {
-    for (const [key, child] of Object.entries(schema.properties)) {
-      const next = [...path, key];
-      if (key === name) found.push(next);
-      found.push(...locations(child, name, next));
-    }
-  }
-  return found;
-}
-function prepareToolArguments(schema, args) {
-  if (Check(schema, args)) return args;
-  const messages = /* @__PURE__ */ new Set();
-  for (const error of Errors(schema, args)) {
-    if (error.keyword !== "additionalProperties") continue;
-    const names = error.params.additionalProperties;
-    if (!Array.isArray(names)) continue;
-    const parent = error.instancePath.split("/").slice(1).map((part) => part.replaceAll("~1", "/").replaceAll("~0", "~"));
-    for (const name of names) {
-      if (typeof name !== "string") continue;
-      const path = [...parent, name];
-      if (acceptsPath(schema, path)) continue;
-      const targets = [...new Set(locations(schema, name).map(displayPath))];
-      const suggestion = targets.length === 1 ? ` Use ${targets[0]} instead.` : " Check the tool's parameter schema.";
-      messages.add(`Invalid parameter: ${displayPath(path)}.${suggestion}`);
-      if (messages.size === 3) break;
-    }
-    if (messages.size === 3) break;
-  }
-  if (messages.size) throw new Error([...messages].join("\n"));
-  return args;
-}
-
 // src/pi-diagnostics.ts
 import { homedir } from "node:os";
 import { sep } from "node:path";
@@ -556,32 +483,19 @@ function webExtension(pi) {
   for (const inspection of selected) {
     const capability = inspection.capability;
     const provider = inspection.provider;
-    const fields = capability === "contents" ? { urls: Type2.Array(Type2.String({ minLength: 1 }), { minItems: 1 }) } : capability === "research" ? { input: Type2.String({ minLength: 1 }) } : {
-      queries: Type2.Array(Type2.String({ minLength: 1 }), {
-        minItems: 1,
-        maxItems: 10
-      }),
-      ...capability === "search" ? { maxResults: Type2.Optional(Type2.Integer({ minimum: 1 })) } : {}
-    };
-    const parameters = Type2.Object(
-      {
-        ...fields,
-        ...inspection.optionSchema ? {
-          options: Type2.Optional(
-            inspection.optionSchema
-          )
-        } : {}
-      },
-      { additionalProperties: false }
-    );
+    const parameters = webToolParameters(inspection);
     pi.registerTool({
       name: `web_${capability}`,
+      namespace: {
+        name: "web",
+        description: "Search, extract pages, answer, and research the web."
+      },
       label: `Web ${capability[0].toUpperCase()}${capability.slice(1)}`,
       // Keep provider guidance with the tool schema, including with custom system prompts.
       description: [
         descriptions[capability],
         ...inspection.promptGuidelines ?? [],
-        "Output is truncated to 2000 lines or 50 KiB; full results are saved to a file when truncated."
+        "Model-facing text is truncated to 2000 lines or 50 KiB; full results are saved to a file when truncated. Codemode scripts receive complete structured results."
       ].join("\n"),
       parameters,
       // Let permission extensions and tool loadouts treat web access as a
@@ -676,12 +590,6 @@ Full results: ${fullOutputPath}`;
     });
   }
 }
-var descriptions = {
-  search: "Search up to ten queries and return titles, URLs, and snippets in input order.",
-  contents: "Fetch and extract readable contents from web URLs.",
-  answer: "Answer up to ten questions using web-grounded evidence.",
-  research: "Run foreground multi-step web research and return the final report."
-};
 export {
   webExtension as default
 };

package/dist/tool-definition.d.ts

@@ -0,0 +1,4 @@
+import { type TObject } from "typebox";
+import type { Capability, WebfoxClient } from "./index.js";
+export declare function webToolParameters(inspection: ReturnType<WebfoxClient["inspectCapability"]>): TObject;
+export declare const descriptions: Record<Capability, string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webfox",
-  "version": "4.6.0",
+  "version": "4.8.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": [
@@ -73,10 +73,14 @@
       "types": "./dist/pi.d.ts",
       "import": "./dist/pi.js"
     },
+    "./durable": {
+      "types": "./dist/durable.d.ts",
+      "import": "./dist/durable.js"
+    },
     "./config.schema.json": "./dist/config.schema.json"
   },
   "scripts": {
-    "build": "rm -rf dist && esbuild index=src/index.ts cli=src/cli.ts pi=src/pi.ts generate-schema=scripts/generate-schema.ts --bundle --splitting --format=esm --platform=node --target=node22 --packages=external --outdir=dist && node dist/generate-schema.js && biome format --write src/config.schema.json >&2 && rm dist/generate-schema.js && tsc --project tsconfig.build.json && cp src/config.schema.json dist/config.schema.json && chmod +x dist/cli.js",
+    "build": "rm -rf dist && esbuild index=src/index.ts cli=src/cli.ts pi=src/pi.ts durable=src/durable.ts generate-schema=scripts/generate-schema.ts --bundle --splitting --format=esm --platform=node --target=node22 --packages=external --outdir=dist && node dist/generate-schema.js && biome format --write src/config.schema.json >&2 && rm dist/generate-schema.js && tsc --project tsconfig.build.json && cp src/config.schema.json dist/config.schema.json && chmod +x dist/cli.js",
     "prepare": "npm run build",
     "prepack": "npm run build",
     "check": "tsc --noEmit",
@@ -103,20 +107,26 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.4",
-    "@earendil-works/pi-ai": "^0.99.0",
-    "@earendil-works/pi-coding-agent": "^0.99.0",
-    "@earendil-works/pi-tui": "^0.99.0",
+    "@earendil-works/chord": "^1.0.0",
+    "@earendil-works/pi-ai": "^1.0.0",
+    "@earendil-works/pi-coding-agent": "^1.0.0",
+    "@earendil-works/pi-durable": "^1.0.0",
+    "@earendil-works/pi-tui": "^1.0.0",
     "@types/node": "^26.1.1",
     "esbuild": "^0.28.1",
     "typescript": "^7.0.2",
     "vitest": "^4.1.10"
   },
   "peerDependencies": {
+    "@earendil-works/pi-durable": "^1.0.0",
     "@earendil-works/pi-coding-agent": "*",
     "@earendil-works/pi-tui": "*",
     "typebox": "*"
   },
   "peerDependenciesMeta": {
+    "@earendil-works/pi-durable": {
+      "optional": true
+    },
     "@earendil-works/pi-coding-agent": {
       "optional": true
     },