pi-web-providers 2.3.0 → 2.4.1

package/README.md

@@ -13,6 +13,9 @@ off entirely.
 
 ## ✨ Features
 
+- **Multiple providers**: Claude, Cloudflare, Codex, Exa, Firecrawl,
+  Gemini, Linkup, OpenAI, Perplexity, Parallel, Serper,
+  [Tavily](https://tavily.com), Valyu
 - **Provider-aware tool options**: pi only exposes the provider settings that
   actually apply to the backend you selected, so tool calls are easier to
   discover and harder to get wrong
@@ -61,6 +64,7 @@ Each tool can be routed to any compatible provider:
 | **OpenAI**     |   ✔    |          |   ✔    |    ✔     | `OPENAI_API_KEY`                                 |
 | **Parallel**   |   ✔    |    ✔     |        |          | `PARALLEL_API_KEY`                               |
 | **Perplexity** |   ✔    |          |   ✔    |    ✔     | `PERPLEXITY_API_KEY`                             |
+| **Serper**     |   ✔    |          |        |          | `SERPER_API_KEY`                                 |
 | **Tavily**     |   ✔    |    ✔     |        |          | `TAVILY_API_KEY`                                 |
 | **Valyu**      |   ✔    |    ✔     |   ✔    |    ✔     | `VALYU_API_KEY`                                  |
 
@@ -377,6 +381,35 @@ call.
 
 </details>
 
+<details>
+<summary><strong>Serper</strong></summary>
+
+- API: Serper HTTP API
+- Supports `web_search` via Serper's Google search endpoint
+- Good fit for fast, straightforward Google-style organic search results
+- Exposes search options `gl`, `hl`, `location`, `page`, and `autocorrect`
+- Preserves rich metadata from Serper responses, including ranking position,
+  sitelinks, attributes, and top-level response context such as
+  `knowledgeGraph`, `answerBox`, `peopleAlsoAsk`, and `relatedSearches`
+- Optional `baseUrl` overrides are supported for proxies and testing
+
+Minimal config:
+
+```json
+{
+  "tools": {
+    "search": "serper"
+  },
+  "providers": {
+    "serper": {
+      "apiKey": "SERPER_API_KEY"
+    }
+  }
+}
+```
+
+</details>
+
 <details>
 <summary><strong>Tavily</strong></summary>
 

package/dist/index.js

@@ -23,7 +23,7 @@ import {
   visibleWidth,
   wrapTextWithAnsi
 } from "@mariozechner/pi-tui";
-import { Type as Type15 } from "@sinclair/typebox";
+import { Type as Type16 } from "typebox";
 
 // src/config.ts
 import { execSync } from "node:child_process";
@@ -44,6 +44,7 @@ var PROVIDER_TOOLS_BY_ID = {
   openai: ["search", "answer", "research"],
   parallel: ["search", "contents"],
   perplexity: ["search", "answer", "research"],
+  serper: ["search"],
   tavily: ["search", "contents"],
   valyu: ["search", "contents", "answer", "research"]
 };
@@ -90,6 +91,7 @@ var PROVIDER_IDS = [
   "openai",
   "parallel",
   "perplexity",
+  "serper",
   "tavily",
   "valyu"
 ];
@@ -289,6 +291,29 @@ function normalizeProvider(providerId, raw, source) {
     case "linkup":
     case "parallel":
     case "perplexity":
+      return parseProviderWithShape(
+        raw,
+        source,
+        providerId,
+        {
+          apiKey: readOptionalString,
+          baseUrl: readOptionalString,
+          options: readOptionalObject,
+          settings: parseOptionalExecutionSettings
+        }
+      );
+    case "serper":
+      return parseProviderWithShape(raw, source, providerId, {
+        apiKey: readOptionalString,
+        baseUrl: readOptionalString,
+        options: (value, innerSource, field) => parseOptionalCapabilityOptions(
+          value,
+          innerSource,
+          field,
+          ["search"]
+        ),
+        settings: parseOptionalExecutionSettings
+      });
     case "tavily":
       return parseProviderWithShape(raw, source, providerId, {
         apiKey: readOptionalString,
@@ -1154,7 +1179,7 @@ function parseOptionalNonNegativeIntegerOption(options, key) {
 }
 
 // src/options.ts
-import { Type } from "@sinclair/typebox";
+import { Type } from "typebox";
 var runtimeOptionFields = {
   requestTimeoutMs: Type.Optional(
     Type.Integer({
@@ -1249,7 +1274,7 @@ import { createHash } from "node:crypto";
 // src/providers/claude.ts
 import { existsSync } from "node:fs";
 import { query } from "@anthropic-ai/claude-agent-sdk";
-import { Type as Type3 } from "@sinclair/typebox";
+import { Type as Type3 } from "typebox";
 
 // src/provider-plans.ts
 function createProviderPlan({
@@ -1347,7 +1372,7 @@ function asPlanConfig(config) {
 }
 
 // src/providers/schema.ts
-import { Type as Type2 } from "@sinclair/typebox";
+import { Type as Type2 } from "typebox";
 function literalUnion(values, options) {
   return Type2.Union(
     values.map((value) => Type2.Literal(value)),
@@ -1723,7 +1748,7 @@ function readString(value, key) {
 }
 
 // src/providers/cloudflare.ts
-import { Type as Type4 } from "@sinclair/typebox";
+import { Type as Type4 } from "typebox";
 import CloudflareClient from "cloudflare";
 var cloudflareContentsOptionsSchema = Type4.Object(
   {
@@ -1863,7 +1888,7 @@ function buildRequestOptions(context) {
 
 // src/providers/codex.ts
 import { Codex as CodexClient } from "@openai/codex-sdk";
-import { Type as Type5 } from "@sinclair/typebox";
+import { Type as Type5 } from "typebox";
 var codexOutputSchema = Type5.Object({
   sources: Type5.Array(
     Type5.Object({
@@ -2468,7 +2493,7 @@ function isJsonObject2(value) {
 }
 
 // src/providers/exa.ts
-import { Type as Type6 } from "@sinclair/typebox";
+import { Type as Type6 } from "typebox";
 import { Exa as ExaClient } from "exa-js";
 var exaSearchOptionsSchema = Type6.Object(
   {
@@ -2766,7 +2791,7 @@ function createClient2(config) {
 
 // src/providers/firecrawl.ts
 import FirecrawlClient from "@mendable/firecrawl-js";
-import { Type as Type7 } from "@sinclair/typebox";
+import { Type as Type7 } from "typebox";
 var firecrawlSearchOptionsSchema = Type7.Object(
   {
     lang: Type7.Optional(
@@ -3061,7 +3086,7 @@ function readString2(value) {
 
 // src/providers/gemini.ts
 import { GoogleGenAI } from "@google/genai";
-import { Type as Type8 } from "@sinclair/typebox";
+import { Type as Type8 } from "typebox";
 var DEFAULT_SEARCH_MODEL = "gemini-2.5-flash";
 var DEFAULT_ANSWER_MODEL = "gemini-2.5-flash";
 var DEFAULT_RESEARCH_AGENT = "deep-research-pro-preview-12-2025";
@@ -3844,7 +3869,7 @@ function readNonEmptyString3(value) {
 }
 
 // src/providers/linkup.ts
-import { Type as Type9 } from "@sinclair/typebox";
+import { Type as Type9 } from "typebox";
 import {
   LinkupClient
 } from "linkup-sdk";
@@ -4097,7 +4122,7 @@ function toDate(value, name) {
 }
 
 // src/providers/openai.ts
-import { Type as Type10 } from "@sinclair/typebox";
+import { Type as Type10 } from "typebox";
 import OpenAI from "openai";
 var DEFAULT_SEARCH_MODEL2 = "gpt-4.1";
 var DEFAULT_ANSWER_MODEL2 = "gpt-4.1";
@@ -4613,7 +4638,7 @@ function readInteger(value) {
 }
 
 // src/providers/parallel.ts
-import { Type as Type11 } from "@sinclair/typebox";
+import { Type as Type11 } from "typebox";
 import ParallelClient from "parallel-web";
 var parallelSearchOptionsSchema = Type11.Object(
   {
@@ -4794,7 +4819,7 @@ function buildRequestOptions3(context) {
 
 // src/providers/perplexity.ts
 import PerplexityClient from "@perplexity-ai/perplexity_ai";
-import { Type as Type12 } from "@sinclair/typebox";
+import { Type as Type12 } from "typebox";
 var DEFAULT_ANSWER_MODEL3 = "sonar";
 var DEFAULT_RESEARCH_MODEL2 = "sonar-deep-research";
 var perplexitySearchOptionsSchema = Type12.Object(
@@ -5107,56 +5132,287 @@ function buildRequestOptions4(context) {
   return context.signal ? { signal: context.signal } : void 0;
 }
 
+// src/providers/serper.ts
+import { Type as Type13 } from "typebox";
+var DEFAULT_BASE_URL = "https://google.serper.dev";
+var serperSearchOptionsSchema = Type13.Object(
+  {
+    gl: Type13.Optional(
+      Type13.String({
+        description: "Country code hint for Google results (for example 'us')."
+      })
+    ),
+    hl: Type13.Optional(
+      Type13.String({
+        description: "Language code hint for Google results (for example 'en')."
+      })
+    ),
+    location: Type13.Optional(
+      Type13.String({
+        description: "Geographic location hint for Google results."
+      })
+    ),
+    page: Type13.Optional(
+      Type13.Integer({
+        minimum: 1,
+        description: "1-based results page to request from Serper."
+      })
+    ),
+    autocorrect: Type13.Optional(
+      Type13.Boolean({
+        description: "Enable or disable Serper query autocorrection."
+      })
+    )
+  },
+  { description: "Serper search options." }
+);
+var serperAdapter = {
+  id: "serper",
+  label: "Serper",
+  docsUrl: "https://serper.dev/",
+  tools: ["search"],
+  getToolOptionsSchema(capability) {
+    switch (capability) {
+      case "search":
+        return serperSearchOptionsSchema;
+      default:
+        return void 0;
+    }
+  },
+  createTemplate() {
+    return {
+      apiKey: "SERPER_API_KEY",
+      options: {}
+    };
+  },
+  getConfigForCapability(capability, config) {
+    switch (capability) {
+      case "search":
+        return {
+          apiKey: config.apiKey,
+          baseUrl: config.baseUrl,
+          options: config.options?.search,
+          settings: config.settings
+        };
+      default:
+        return config;
+    }
+  },
+  getCapabilityStatus(config) {
+    return getApiKeyStatus(config?.apiKey);
+  },
+  buildPlan(request, config) {
+    return buildProviderPlan({
+      request,
+      config,
+      providerId: serperAdapter.id,
+      providerLabel: serperAdapter.label,
+      handlers: {
+        search: {
+          execute: (searchRequest, providerConfig, context) => serperAdapter.search(
+            searchRequest.query,
+            searchRequest.maxResults,
+            providerConfig,
+            context,
+            searchRequest.options
+          )
+        }
+      }
+    });
+  },
+  async search(query2, maxResults, config, context, options) {
+    const apiKey = resolveConfigValue(config.apiKey);
+    if (!apiKey) {
+      throw new Error("is missing an API key");
+    }
+    const defaults = stripLocalExecutionOptions(asJsonObject(config.options?.search)) ?? {};
+    const runtimeOptions = stripLocalExecutionOptions(asJsonObject(options));
+    const {
+      q: _ignoredQuery,
+      num: _ignoredNum,
+      ...providerOptions
+    } = {
+      ...defaults,
+      ...runtimeOptions ?? {}
+    };
+    const response = await fetch(joinUrl(resolveConfigValue(config.baseUrl)), {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        "x-api-key": apiKey
+      },
+      body: JSON.stringify({
+        q: query2,
+        num: clampMaxResults(maxResults),
+        ...providerOptions
+      }),
+      signal: context.signal
+    });
+    if (!response.ok) {
+      throw new Error(await buildHttpError(response));
+    }
+    const payload = await response.json();
+    const responseRecord = asRecord3(payload) ?? {};
+    const organic = asArray(responseRecord.organic) ?? [];
+    const searchContext = buildSearchContext(responseRecord);
+    return {
+      provider: serperAdapter.id,
+      results: organic.map((entry) => toSearchResult3(entry, searchContext)).filter(
+        (result) => result !== null
+      ).slice(0, clampMaxResults(maxResults))
+    };
+  }
+};
+function joinUrl(baseUrl) {
+  const base = (baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+  return `${base}/search`;
+}
+function clampMaxResults(value) {
+  return Math.max(1, Math.min(20, Math.trunc(value || 0)));
+}
+async function buildHttpError(response) {
+  const detail = await readErrorDetail(response);
+  const status = `${response.status}${response.statusText ? ` ${response.statusText}` : ""}`;
+  return detail ? `Serper API request failed (${status}): ${detail}` : `Serper API request failed (${status}).`;
+}
+async function readErrorDetail(response) {
+  const text = (await response.text()).trim();
+  if (!text) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(text);
+    const record = asRecord3(parsed);
+    const detail = readString4(record?.message) ?? readString4(record?.error) ?? readString4(record?.detail);
+    if (detail) {
+      return detail;
+    }
+    return JSON.stringify(parsed);
+  } catch {
+    return text;
+  }
+}
+function toSearchResult3(entry, searchContext) {
+  const record = asRecord3(entry);
+  if (!record) {
+    return null;
+  }
+  const url = readString4(record.link) ?? "";
+  const title = readString4(record.title) || url || "Untitled";
+  const snippet = trimSnippet(
+    readString4(record.snippet) ?? readString4(record.richSnippet) ?? readString4(record.date) ?? ""
+  );
+  const metadata = omitUndefined({
+    source: "organic",
+    position: readNumber(record.position),
+    date: readString4(record.date),
+    attributes: asRecord3(record.attributes),
+    sitelinks: asArray(record.sitelinks),
+    rating: readNumber(record.rating),
+    ratingCount: readNumber(record.ratingCount),
+    cid: readString4(record.cid),
+    ...extractExtraMetadata(record, ["title", "link", "snippet"]),
+    ...searchContext ? { searchContext } : {}
+  });
+  return {
+    title,
+    url,
+    snippet,
+    ...Object.keys(metadata).length > 0 ? { metadata } : {}
+  };
+}
+function buildSearchContext(response) {
+  const context = omitUndefined({
+    searchParameters: asRecord3(response.searchParameters),
+    searchInformation: asRecord3(response.searchInformation),
+    credits: readNumber(response.credits),
+    answerBox: asRecord3(response.answerBox),
+    knowledgeGraph: asRecord3(response.knowledgeGraph),
+    peopleAlsoAsk: asArray(response.peopleAlsoAsk),
+    relatedSearches: asArray(response.relatedSearches),
+    topStories: asArray(response.topStories),
+    news: asArray(response.news),
+    images: asArray(response.images),
+    videos: asArray(response.videos),
+    places: asArray(response.places)
+  });
+  return Object.keys(context).length > 0 ? context : void 0;
+}
+function extractExtraMetadata(record, ignoredKeys) {
+  return Object.fromEntries(
+    Object.entries(record).filter(
+      ([key, value]) => !ignoredKeys.includes(key) && value !== void 0
+    )
+  );
+}
+function omitUndefined(value) {
+  return Object.fromEntries(
+    Object.entries(value).filter(([, entry]) => entry !== void 0)
+  );
+}
+function asRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function asArray(value) {
+  return Array.isArray(value) ? value : void 0;
+}
+function readString4(value) {
+  return typeof value === "string" ? value : void 0;
+}
+function readNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+
 // src/providers/tavily.ts
-import { Type as Type13 } from "@sinclair/typebox";
+import { Type as Type14 } from "typebox";
 import {
   tavily
 } from "@tavily/core";
-var tavilySearchOptionsSchema = Type13.Object(
+var tavilySearchOptionsSchema = Type14.Object(
   {
-    topic: Type13.Optional(
+    topic: Type14.Optional(
       literalUnion(["general", "news", "finance"], {
         description: "Category of the search query."
       })
     ),
-    searchDepth: Type13.Optional(
+    searchDepth: Type14.Optional(
       literalUnion(["basic", "advanced"], {
         description: "Depth of the search. 'advanced' is slower but more thorough."
       })
     ),
-    timeRange: Type13.Optional(
-      Type13.String({ description: "Named time range filter." })
+    timeRange: Type14.Optional(
+      Type14.String({ description: "Named time range filter." })
     ),
-    country: Type13.Optional(
-      Type13.String({ description: "Country hint for search results." })
+    country: Type14.Optional(
+      Type14.String({ description: "Country hint for search results." })
     ),
-    exactMatch: Type13.Optional(
-      Type13.Boolean({ description: "Prefer exact matches." })
+    exactMatch: Type14.Optional(
+      Type14.Boolean({ description: "Prefer exact matches." })
     ),
-    includeAnswer: Type13.Optional(
-      Type13.Boolean({ description: "Include a short AI-generated answer." })
+    includeAnswer: Type14.Optional(
+      Type14.Boolean({ description: "Include a short AI-generated answer." })
     ),
-    includeRawContent: Type13.Optional(
-      Type13.Boolean({ description: "Include raw page content in results." })
+    includeRawContent: Type14.Optional(
+      Type14.Boolean({ description: "Include raw page content in results." })
     ),
-    includeImages: Type13.Optional(
-      Type13.Boolean({ description: "Include related images." })
+    includeImages: Type14.Optional(
+      Type14.Boolean({ description: "Include related images." })
     ),
-    includeFavicon: Type13.Optional(
-      Type13.Boolean({ description: "Include favicon URLs." })
+    includeFavicon: Type14.Optional(
+      Type14.Boolean({ description: "Include favicon URLs." })
     ),
-    includeDomains: Type13.Optional(
-      Type13.Array(Type13.String(), {
+    includeDomains: Type14.Optional(
+      Type14.Array(Type14.String(), {
         description: "Restrict results to these domains."
       })
     ),
-    excludeDomains: Type13.Optional(
-      Type13.Array(Type13.String(), {
+    excludeDomains: Type14.Optional(
+      Type14.Array(Type14.String(), {
         description: "Exclude these domains from results."
       })
     ),
-    days: Type13.Optional(
-      Type13.Integer({
+    days: Type14.Optional(
+      Type14.Integer({
         minimum: 1,
         description: "Limit results to the last N days."
       })
@@ -5164,27 +5420,27 @@ var tavilySearchOptionsSchema = Type13.Object(
   },
   { description: "Tavily search options." }
 );
-var tavilyExtractOptionsSchema = Type13.Object(
+var tavilyExtractOptionsSchema = Type14.Object(
   {
-    extractDepth: Type13.Optional(
-      Type13.String({ description: "Depth setting for extraction." })
+    extractDepth: Type14.Optional(
+      Type14.String({ description: "Depth setting for extraction." })
     ),
-    format: Type13.Optional(
+    format: Type14.Optional(
       literalUnion(["markdown", "text"], {
         description: "Output format for extracted content."
       })
     ),
-    includeImages: Type13.Optional(
-      Type13.Boolean({ description: "Include extracted images." })
+    includeImages: Type14.Optional(
+      Type14.Boolean({ description: "Include extracted images." })
     ),
-    query: Type13.Optional(
-      Type13.String({ description: "Optional query to focus extraction." })
+    query: Type14.Optional(
+      Type14.String({ description: "Optional query to focus extraction." })
     ),
-    chunksPerSource: Type13.Optional(
-      Type13.Integer({ minimum: 1, description: "Maximum chunks per source." })
+    chunksPerSource: Type14.Optional(
+      Type14.Integer({ minimum: 1, description: "Maximum chunks per source." })
     ),
-    includeFavicon: Type13.Optional(
-      Type13.Boolean({ description: "Include favicon URLs." })
+    includeFavicon: Type14.Optional(
+      Type14.Boolean({ description: "Include favicon URLs." })
     )
   },
   { description: "Tavily extract options." }
@@ -5358,48 +5614,48 @@ function buildExtractMetadata(response, result) {
 }
 
 // src/providers/valyu.ts
-import { Type as Type14 } from "@sinclair/typebox";
+import { Type as Type15 } from "typebox";
 import { Valyu as ValyuClient } from "valyu-js";
-var valyuSearchOptionsSchema = Type14.Object(
+var valyuSearchOptionsSchema = Type15.Object(
   {
-    searchType: Type14.Optional(
+    searchType: Type15.Optional(
       literalUnion(["all", "web", "proprietary", "news"], {
         description: "Valyu search type."
       })
     ),
-    responseLength: Type14.Optional(
+    responseLength: Type15.Optional(
       literalUnion(["short", "medium", "large", "max"], {
         description: "Response length."
       })
     ),
-    countryCode: Type14.Optional(
-      Type14.String({ description: "Country code to scope search results." })
+    countryCode: Type15.Optional(
+      Type15.String({ description: "Country code to scope search results." })
     )
   },
   { description: "Valyu search options." }
 );
-var valyuAnswerOptionsSchema = Type14.Object(
+var valyuAnswerOptionsSchema = Type15.Object(
   {
-    responseLength: Type14.Optional(
+    responseLength: Type15.Optional(
       literalUnion(["short", "medium", "large", "max"], {
         description: "Response length for answers."
       })
     ),
-    countryCode: Type14.Optional(
-      Type14.String({ description: "Country code to scope answer results." })
+    countryCode: Type15.Optional(
+      Type15.String({ description: "Country code to scope answer results." })
     )
   },
   { description: "Valyu answer options." }
 );
-var valyuResearchOptionsSchema = Type14.Object(
+var valyuResearchOptionsSchema = Type15.Object(
   {
-    responseLength: Type14.Optional(
+    responseLength: Type15.Optional(
       literalUnion(["short", "medium", "large", "max"], {
         description: "Response length for research."
       })
     ),
-    countryCode: Type14.Optional(
-      Type14.String({ description: "Country code to scope research results." })
+    countryCode: Type15.Optional(
+      Type15.String({ description: "Country code to scope research results." })
     )
   },
   { description: "Valyu research options." }
@@ -5684,6 +5940,7 @@ var ADAPTERS_BY_ID = {
   openai: openaiAdapter,
   parallel: parallelAdapter,
   perplexity: perplexityAdapter,
+  serper: serperAdapter,
   tavily: tavilyAdapter,
   valyu: valyuAdapter
 };
@@ -6780,7 +7037,7 @@ var PROVIDER_CONFIG_MANIFESTS = {
           "deep-reasoning",
           "deep-max"
         ],
-        getValue: (config) => readString4(getExaSearchOptions(config)?.type) ?? "default",
+        getValue: (config) => readString5(getExaSearchOptions(config)?.type) ?? "default",
         setValue: (config, value) => {
           const options = ensureExaSearchOptions(config);
           if (value === "default") {
@@ -7004,7 +7261,7 @@ var PROVIDER_CONFIG_MANIFESTS = {
         label: "Search mode",
         help: "Parallel search mode. 'default' uses the SDK default.",
         values: ["default", "agentic", "one-shot"],
-        getValue: (config) => readString4(getParallelOptions(config)?.search?.mode) ?? "default",
+        getValue: (config) => readString5(getParallelOptions(config)?.search?.mode) ?? "default",
         setValue: (config, value) => {
           const options = ensureParallelOptions(config);
           options.search = asJsonObject2(options.search) ?? {};
@@ -7058,6 +7315,9 @@ var PROVIDER_CONFIG_MANIFESTS = {
       })
     ]
   },
+  serper: {
+    settings: [apiKeySetting(), baseUrlSetting()]
+  },
   tavily: {
     settings: [apiKeySetting(), baseUrlSetting()]
   },
@@ -7070,7 +7330,7 @@ var PROVIDER_CONFIG_MANIFESTS = {
         label: "Search type",
         help: "Valyu search type. 'default' uses the SDK default.",
         values: ["default", "all", "web", "proprietary", "news"],
-        getValue: (config) => readString4(getValyuCapabilityOptions(config, "search")?.searchType) ?? "default",
+        getValue: (config) => readString5(getValyuCapabilityOptions(config, "search")?.searchType) ?? "default",
         setValue: (config, value) => {
           const options = ensureValyuCapabilityOptions(config, "search");
           if (value === "default") {
@@ -7086,7 +7346,7 @@ var PROVIDER_CONFIG_MANIFESTS = {
         label: "Search response length",
         help: "Valyu search response length. 'default' uses the SDK default.",
         values: ["default", "short", "medium", "large", "max"],
-        getValue: (config) => readString4(
+        getValue: (config) => readString5(
           getValyuCapabilityOptions(config, "search")?.responseLength
         ) ?? "default",
         setValue: (config, value) => {
@@ -7098,7 +7358,7 @@ var PROVIDER_CONFIG_MANIFESTS = {
         label: "Answer response length",
         help: "Valyu answer response length. 'default' uses the SDK default.",
         values: ["default", "short", "medium", "large", "max"],
-        getValue: (config) => readString4(
+        getValue: (config) => readString5(
           getValyuCapabilityOptions(config, "answer")?.responseLength
         ) ?? "default",
         setValue: (config, value) => {
@@ -7110,7 +7370,7 @@ var PROVIDER_CONFIG_MANIFESTS = {
         label: "Research response length",
         help: "Valyu research response length. 'default' uses the SDK default.",
         values: ["default", "short", "medium", "large", "max"],
-        getValue: (config) => readString4(
+        getValue: (config) => readString5(
           getValyuCapabilityOptions(config, "research")?.responseLength
         ) ?? "default",
         setValue: (config, value) => {
@@ -7202,7 +7462,7 @@ function getIntegerString(value) {
 function getBooleanValue(value) {
   return typeof value === "boolean" ? String(value) : "default";
 }
-function readString4(value) {
+function readString5(value) {
   return typeof value === "string" ? value : void 0;
 }
 function asJsonObject2(value) {
@@ -7528,10 +7788,6 @@ function webProvidersExtension(pi) {
       { addAvailable: true }
     );
   });
-  pi.on("session_switch", async (_event, ctx) => {
-    latestWidgetContext = ctx;
-    updateWebResearchWidget(ctx);
-  });
   pi.on("before_agent_start", async (_event, ctx) => {
     latestWidgetContext = ctx;
     await cleanupContentStore();
@@ -7577,14 +7833,14 @@ function registerWebSearchTool(pi, providerIds) {
     promptGuidelines: [
       "Batch related searches when grouped comparison matters; use separate sibling web_search calls when independent results should surface as soon as they are ready."
     ],
-    parameters: Type15.Object({
-      queries: Type15.Array(Type15.String({ minLength: 1 }), {
+    parameters: Type16.Object({
+      queries: Type16.Array(Type16.String({ minLength: 1 }), {
         minItems: 1,
         maxItems: MAX_SEARCH_QUERIES,
         description: `One or more search queries to run in one call (max ${MAX_SEARCH_QUERIES})`
       }),
-      maxResults: Type15.Optional(
-        Type15.Integer({
+      maxResults: Type16.Optional(
+        Type16.Integer({
           minimum: 1,
           maximum: MAX_ALLOWED_RESULTS,
           description: `Maximum number of results to return (default: ${DEFAULT_MAX_RESULTS})`
@@ -7633,8 +7889,8 @@ function registerWebContentsTool(pi, providerIds) {
     name: "web_contents",
     label: "Web Contents",
     description: "Read and extract the main contents of one or more web pages. Batch related pages together, or use separate sibling calls when each page can be acted on independently.",
-    parameters: Type15.Object({
-      urls: Type15.Array(Type15.String({ minLength: 1 }), {
+    parameters: Type16.Object({
+      urls: Type16.Array(Type16.String({ minLength: 1 }), {
         minItems: 1,
         description: "One or more URLs to extract"
       }),
@@ -7684,8 +7940,8 @@ function registerWebAnswerTool(pi, providerIds) {
     name: "web_answer",
     label: "Web Answer",
     description: `Answer one or more questions using web-grounded evidence (up to ${MAX_SEARCH_QUERIES} per call).`,
-    parameters: Type15.Object({
-      queries: Type15.Array(Type15.String({ minLength: 1 }), {
+    parameters: Type16.Object({
+      queries: Type16.Array(Type16.String({ minLength: 1 }), {
         minItems: 1,
         maxItems: MAX_SEARCH_QUERIES,
         description: `One or more questions to answer in one call (max ${MAX_SEARCH_QUERIES})`
@@ -7739,8 +7995,8 @@ function registerWebResearchTool(pi, webResearchLifecycle, providerIds) {
     name: "web_research",
     label: "Web Research",
     description: "Start a long-running web research job. Returns immediately with a dispatch notice; the final report is saved to a file and posted later as a custom message.",
-    parameters: Type15.Object({
-      input: Type15.String({ description: "Research brief or question" }),
+    parameters: Type16.Object({
+      input: Type16.String({ description: "Research brief or question" }),
       ...optionalField(
         "options",
         buildStructuredOptionsSchema("research", selectedProviderId)
@@ -7883,7 +8139,7 @@ function optionalField(name, schema) {
 function buildStructuredOptionsSchema(capability, providerId) {
   const providerSchema = resolveProviderOptionsSchema(capability, providerId);
   const schema = buildToolOptionsSchema(capability, providerSchema);
-  return schema ? Type15.Optional(schema) : void 0;
+  return schema ? Type16.Optional(schema) : void 0;
 }
 function resolveProviderOptionsSchema(capability, providerId) {
   if (!providerId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-web-providers",
-  "version": "2.3.0",
+  "version": "2.4.1",
   "description": "Configurable web access extension for pi with per-tool provider routing and explicit provider option schemas for search, contents, answers, and research.",
   "type": "module",
   "files": [
@@ -30,6 +30,7 @@
     "openai",
     "parallel",
     "perplexity",
+    "serper",
     "tavily",
     "valyu"
   ],
@@ -51,7 +52,7 @@
     ]
   },
   "scripts": {
-    "build": "rm -rf dist && esbuild src/index.ts --bundle --format=esm --platform=node --outfile=dist/index.js --external:@mariozechner/pi-coding-agent --external:@mariozechner/pi-ai --external:@mariozechner/pi-tui --external:@sinclair/typebox --external:@anthropic-ai/claude-agent-sdk --external:@google/genai --external:@mendable/firecrawl-js --external:@openai/codex-sdk --external:@perplexity-ai/perplexity_ai --external:@tavily/core --external:cloudflare --external:exa-js --external:linkup-sdk --external:openai --external:parallel-web --external:valyu-js",
+    "build": "rm -rf dist && esbuild src/index.ts --bundle --format=esm --platform=node --outfile=dist/index.js --external:@mariozechner/pi-coding-agent --external:@mariozechner/pi-ai --external:@mariozechner/pi-tui --external:typebox --external:@anthropic-ai/claude-agent-sdk --external:@google/genai --external:@mendable/firecrawl-js --external:@openai/codex-sdk --external:@perplexity-ai/perplexity_ai --external:@tavily/core --external:cloudflare --external:exa-js --external:linkup-sdk --external:openai --external:parallel-web --external:valyu-js",
     "prepare": "npm run build",
     "prepack": "npm run build",
     "check": "tsc --noEmit",
@@ -77,12 +78,18 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.10",
-    "@mariozechner/pi-ai": "^0.64.0",
-    "@mariozechner/pi-coding-agent": "^0.64.0",
-    "@sinclair/typebox": "^0.34.49",
+    "@mariozechner/pi-ai": "^0.69.0",
+    "@mariozechner/pi-coding-agent": "^0.69.0",
+    "@mariozechner/pi-tui": "^0.69.0",
+    "typebox": "^1.1.31",
     "@types/node": "^25.5.0",
     "esbuild": "^0.27.4",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*",
+    "@mariozechner/pi-tui": "*",
+    "typebox": "*"
   }
 }