pi-web-search 1.2.0 → 1.2.1

package/README.md

@@ -1,95 +1,48 @@
 # pi-web-search
 
-A pi extension that provides provider-native web search across Google Gemini, OpenAI, and Anthropic, plus Gemini-native URL Context analysis.
+Provider-native web search for [pi](https://github.com/earendil-works/pi-coding-agent), across Google Gemini, OpenAI, and Anthropic, plus Gemini-only URL Context analysis.
 
-## Features
+## Tools
 
-- **🔍 Web Search** - Provider-native web search across Google Gemini, OpenAI Responses, and Anthropic Messages
-- **📄 URL Context** - Gemini-native analysis of up to 20 public URLs, including web pages, documents, images, and YouTube videos
-- **🧾 Search telemetry** - Tool results include provider, search queries, result URLs, citations, and whether native search metadata was actually observed
-- **🔗 Canonicalized Google grounding links** - Gemini grounding redirect URLs are resolved to their underlying destination URLs when possible
+### `web_search`
 
-## Installation
+Search the web using your currently selected model. Automatically picks the right provider API:
 
-```bash
-pi install npm:pi-web-search
-```
-
-## Release highlights for v1.2.0
-
-- `web_search` now follows the current model across Google Gemini, OpenAI Responses, and Anthropic Messages
-- `url_context` is explicitly Gemini-only and is removed from the active tool set for non-Gemini models
-- Provider-native search telemetry now exposes queries, URLs, citations, and verification metadata in tool `details`
-- Gemini grounding redirect URLs are resolved to canonical destination URLs when possible
-- Real test scripts now read configuration from `.env` / `.env.example`
-- The package now ships source-only TypeScript entrypoints for pi; no `dist/` build output is required in the project or published package
-
-## Behavior notes
-
-- `web_search` follows the **currently selected model** when that model exposes a supported native search API.
-- `web_search` supports Google Gemini, OpenAI Responses, Anthropic Messages, and compatible proxy providers exposing those APIs.
-- `url_context` is intentionally **Gemini-only**. When the current model is not Gemini-compatible, the extension removes `url_context` from the active tool set and the executor also fast-fails with a clear unsupported-provider message as a second safety net.
-- If `web_search` returns only plain text and does **not** return native search metadata, the tool output includes a warning and marks the result as ungrounded in `details`.
-- If `url_context` does not return verified URL-context metadata, the tool output includes an explicit warning so the caller can distinguish a best-effort summary from a verified retrieval.
-- For Gemini grounding results, the extension attempts to resolve Google redirect URLs to the final destination URL before returning `sources` / `searchResults`.
-
-## Tool matrix
-
-| Tool | Google Gemini | OpenAI Responses | Anthropic Messages | Proxy providers exposing those APIs |
-|---|---|---|---|---|
-| `web_search` | ✅ | ✅ | ✅ | ✅ |
-| `url_context` | ✅ | ❌ | ❌ | ✅, but only when the selected model is Gemini-compatible |
+| Provider | API |
+|---|---|
+| Google Gemini | Grounding with Google Search |
+| OpenAI | Responses API web search |
+| Anthropic | Messages API web search |
 
-## Configuration
+Supports passing up to 20 additional URLs to analyze alongside the query.
 
-No special configuration required. Configure or login to any of the following model providers in pi, and it will be automatically detected and used:
+### `url_context`
 
-### For `web_search`
+Gemini-only. Analyze up to 20 public URLs — web pages, documents, images, and YouTube videos. Uses Gemini's native URL Context retrieval with verified metadata.
 
-- google
-- google-generative-ai
-- openai
-- anthropic
-- compatible proxy providers whose selected model API is OpenAI Responses, Anthropic Messages, or Google Generative AI
+When using `google-generative-ai`, YouTube URLs are passed as `file_data` for native video understanding.
 
-### For `url_context`
-
-- google
-- google-generative-ai
-- compatible proxy providers whose selected model API is Google Generative AI
-
-## Verification scripts
-
-Create a local `.env` first, ideally by copying `.env.example`. Real-test scripts read all configuration from environment variables instead of hardcoding any provider or extension.
+## Install
 
 ```bash
-# Mock/unit parsing tests
-npm test
+pi install npm:pi-web-search
+```
 
-# Real multi-provider web_search verification using models from .env
-node tests/real-web-search.mjs
+## Usage
 
-# Real Gemini url_context verification using model from .env
-# Passes when url_context either returns verified metadata/URLs
-# or emits the explicit unverified-warning path.
-node tests/real-url-context.mjs
-```
+No extra config needed. Just configure any supported provider in pi and the tools auto-detect it.
+
+`url_context` is automatically removed from active tools when using a non-Gemini model.
 
-Example `.env` keys:
+## Test
 
 ```bash
-PI_BIN=pi
-PI_WEB_SEARCH_EXTENSION=./src/index.ts
-PI_PROVIDER_EXTENSIONS=/path/to/provider-extension.ts
-PI_WEB_SEARCH_MODEL_OPENAI=provider/model-openai
-PI_WEB_SEARCH_MODEL_ANTHROPIC=provider/model-anthropic
-PI_WEB_SEARCH_MODEL_GOOGLE=provider/model-google
-PI_URL_CONTEXT_MODEL=provider/model-google
+cp .env.example .env   # edit with your models
+npm test               # unit tests
+npm run test:real:web-search
+npm run test:real:url-context
 ```
 
-Recommended setup:
+## License
 
-```bash
-cp .env.example .env
-# then edit .env with models/extensions available in your local pi setup
-```
+MIT

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "pi-web-search",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Provider-native web search for pi across Google Gemini, OpenAI, and Anthropic, plus Gemini URL Context",
   "type": "module",
   "main": "src/index.ts",
   "keywords": [
     "pi",
     "pi-extension",
+    "pi-package",
     "web-search",
     "gemini",
     "google",
@@ -38,13 +39,18 @@
   "devDependencies": {
     "@earendil-works/pi-ai": "^0.75.4",
     "@earendil-works/pi-coding-agent": "^0.75.4",
-    "@sinclair/typebox": "^0.34.49",
     "@types/node": "^25.9.1",
+    "typebox": "^1.1.38",
     "typescript": "^6.0.3"
   },
   "pi": {
     "extensions": [
       "./src/index.ts"
     ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "typebox": "*"
   }
 }

package/src/index.ts

@@ -77,7 +77,6 @@ export default function (pi: ExtensionAPI) {
 
     const toolManager = createModelScopedToolManager(pi);
     pi.on("session_start", (_event, ctx) => toolManager.sync(ctx.model));
-    pi.on("session_switch", (_event, ctx) => toolManager.sync(ctx.model));
     pi.on("session_tree", (_event, ctx) => toolManager.sync(ctx.model));
     pi.on("model_select", (event) => toolManager.sync(event.model));
 }

package/src/url_context.ts

@@ -1,5 +1,5 @@
 import type { ExtensionContext, AgentToolUpdateCallback } from "@earendil-works/pi-coding-agent";
-import { Type, type Static } from "@sinclair/typebox";
+import { Type, type Static } from "typebox";
 import { callApiStream, getConfig, applyCitations } from "./api.ts";
 import { getModel, missingConfigResult, errorResult, formatResult } from "./utils.ts";
 

package/src/web_search.ts

@@ -1,5 +1,5 @@
 import type { ExtensionContext, AgentToolUpdateCallback } from "@earendil-works/pi-coding-agent";
-import { Type, type Static } from "@sinclair/typebox";
+import { Type, type Static } from "typebox";
 import { callApiStream, getConfig, applyCitations } from "./api.ts";
 import { getModel, missingConfigResult, errorResult, formatResult } from "./utils.ts";