@zeldrisho/pi-web-search 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.14.0] - 2026-10-25
+
+### Changed
+
+- Show cache progress and a compact search summary in Pi's tool preview without adding model-facing output.
+- Declare read-only network access hints for permission integrations.
+
 ## [0.13.0] - 2026-10-24
 
 ### Added
@@ -162,7 +169,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Add bounded Brave web search ([cbc9491](https://github.com/zeldrisho/pi-packages/commit/cbc9491dce36555ab91b6bef203ec8b380596a89))
 
-[Unreleased]: https://github.com/zeldrisho/pi-packages/compare/pi-web-search-v0.13.0...HEAD
+[Unreleased]: https://github.com/zeldrisho/pi-packages/compare/pi-web-search-v0.14.0...HEAD
+[0.14.0]: https://github.com/zeldrisho/pi-packages/compare/pi-web-search-v0.13.0...pi-web-search-v0.14.0
 [0.13.0]: https://github.com/zeldrisho/pi-packages/compare/pi-web-search-v0.12.1...pi-web-search-v0.13.0
 [0.12.1]: https://github.com/zeldrisho/pi-packages/compare/pi-web-search-v0.12.0...pi-web-search-v0.12.1
 [0.12.0]: https://github.com/zeldrisho/pi-packages/compare/pi-web-search-v0.11.0...pi-web-search-v0.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeldrisho/pi-web-search",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Pi extension for bounded Brave web search with generated-answer fallback",
   "keywords": [
     "brave-search",

package/src/index.ts

@@ -3,7 +3,7 @@ import { Text } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
 import { SEARCH_WEB_MAX_QUERY_CHARACTERS } from "./limits";
 import { formatCollapsibleOutput } from "./render";
-import { SearchRuntime, webSearchOutputSchema } from "./search";
+import { SearchRuntime, webSearchOutputSchema, type SearchDetails } from "./search";
 
 export { ExpiringLruCache } from "./cache";
 
@@ -43,12 +43,13 @@ export default function (pi: ExtensionAPI) {
   const runtime = new SearchRuntime();
   pi.on("session_shutdown", () => runtime.shutdown());
 
-  pi.registerTool({
+  pi.registerTool<typeof webSearchParameters, Partial<SearchDetails>>({
     name: "web_search",
     label: "Web Search",
     description: "Search the web. Use web_fetch to read sources.",
     parameters: webSearchParameters,
     outputSchema: webSearchOutputSchema,
+    annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
 
     renderCall(args, theme) {
       return new Text(
@@ -62,14 +63,25 @@ export default function (pi: ExtensionAPI) {
       return runtime.execute(params, signal, onUpdate, ctx?.cwd);
     },
 
+    /**
+     * Renders partial text or "Searching…" while pending. Completed text gets a
+     * result and cache summary when available and a collapsible body; absent text shows "No results".
+     */
     renderResult(result, { expanded, isPartial }, theme) {
-      if (isPartial) return new Text(theme.fg("warning", "Searching…"), 0, 0);
-
       const content = result.content.find((item) => item.type === "text");
 
+      if (isPartial) return new Text(theme.fg("warning", content?.text || "Searching…"), 0, 0);
+
+      const details = result.details;
+
+      const summary =
+        details?.resultCount !== undefined
+          ? `${details.answer ? "Generated answer" : `${details.resultCount} results`} · ${details.cached ? "cached" : "miss"}${details.truncated ? " · truncated" : ""}`
+          : "";
+
       return new Text(
         content?.type === "text"
-          ? formatCollapsibleOutput(content.text, expanded, theme)
+          ? `${theme.fg("dim", summary)}${formatCollapsibleOutput(content.text, expanded, theme)}`
           : theme.fg("dim", "No results"),
         0,
         0,