@zeldrisho/pi-web-fetch 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, focus queries, offsets, and a compact fetch summary in Pi's tool preview without adding model-facing output.
+- Declare read-only network access hints for permission integrations and validate existing input limits in the tool schema.
+
 ## [0.13.0] - 2026-10-24
 
 ### Added
@@ -256,7 +263,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Add bounded public page fetching ([b979496](https://github.com/zeldrisho/pi-packages/commit/b979496b32de1cead172ba570307e4a4a7b3421d))
 
-[Unreleased]: https://github.com/zeldrisho/pi-packages/compare/pi-web-fetch-v0.13.0...HEAD
+[Unreleased]: https://github.com/zeldrisho/pi-packages/compare/pi-web-fetch-v0.14.0...HEAD
+[0.14.0]: https://github.com/zeldrisho/pi-packages/compare/pi-web-fetch-v0.13.0...pi-web-fetch-v0.14.0
 [0.13.0]: https://github.com/zeldrisho/pi-packages/compare/pi-web-fetch-v0.12.0...pi-web-fetch-v0.13.0
 [0.12.0]: https://github.com/zeldrisho/pi-packages/compare/pi-web-fetch-v0.11.1...pi-web-fetch-v0.12.0
 [0.11.1]: https://github.com/zeldrisho/pi-packages/compare/pi-web-fetch-v0.11.0...pi-web-fetch-v0.11.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeldrisho/pi-web-fetch",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Pi extension for secure, bounded public web page fetching and Markdown extraction",
   "keywords": [
     "pi",

package/src/index.ts

@@ -1,9 +1,14 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Text } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
+import {
+  FETCH_MAX_OFFSET_CHARACTERS,
+  FETCH_MAX_QUERY_CHARACTERS,
+  FETCH_MAX_URL_CHARACTERS,
+} from "./limits";
 import { redactUrlForDisplay } from "./redact";
 import { formatCollapsibleOutput } from "./render";
-import { executeWebFetch, webFetchOutputSchema } from "./service";
+import { executeWebFetch, webFetchOutputSchema, type WebFetchDetails } from "./service";
 
 export { ExpiringLruCache } from "./cache";
 
@@ -62,9 +67,21 @@ export {
 } from "./network/network.ts";
 
 export const webFetchParameters = Type.Object({
-  url: Type.String(),
-  query: Type.Optional(Type.String({ description: "Find sections matching this text." })),
-  offset: Type.Optional(Type.Integer({ description: "Start at this character offset." })),
+  url: Type.String({ minLength: 1, maxLength: FETCH_MAX_URL_CHARACTERS }),
+  query: Type.Optional(
+    Type.String({
+      minLength: 1,
+      maxLength: FETCH_MAX_QUERY_CHARACTERS,
+      description: "Find sections matching this text.",
+    }),
+  ),
+  offset: Type.Optional(
+    Type.Integer({
+      minimum: 0,
+      maximum: FETCH_MAX_OFFSET_CHARACTERS,
+      description: "Start at this character offset.",
+    }),
+  ),
 });
 
 /**
@@ -73,16 +90,18 @@ export const webFetchParameters = Type.Object({
  * @param pi - The extension API instance
  */
 export default function (pi: ExtensionAPI) {
-  pi.registerTool({
+  pi.registerTool<typeof webFetchParameters, Partial<WebFetchDetails>>({
     name: "web_fetch",
     label: "Web Fetch",
     description: "Read a public webpage as Markdown.",
     parameters: webFetchParameters,
     outputSchema: webFetchOutputSchema,
+    annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
 
+    /** Renders the redacted URL, optional focus query, and character offset in the call preview. */
     renderCall(args, theme) {
       return new Text(
-        `${theme.fg("toolTitle", theme.bold("web_fetch"))} ${theme.fg("accent", redactUrlForDisplay(args.url))}`,
+        `${theme.fg("toolTitle", theme.bold("web_fetch"))} ${theme.fg("accent", redactUrlForDisplay(args.url))}${args.query === undefined ? "" : ` query=${JSON.stringify(args.query)}`}${args.offset === undefined ? "" : ` offset=${args.offset}`}`,
         0,
         0,
       );
@@ -92,14 +111,34 @@ export default function (pi: ExtensionAPI) {
       return executeWebFetch(params, signal, onUpdate);
     },
 
+    /**
+     * Renders partial text or "Fetching…" while pending. Completed text gets a
+     * detail summary when available and a collapsible body; absent text shows "No content".
+     */
     renderResult(result, { expanded, isPartial }, theme) {
-      if (isPartial) return new Text(theme.fg("warning", "Fetching…"), 0, 0);
-
       const content = result.content.find((item) => item.type === "text");
 
+      if (isPartial) return new Text(theme.fg("warning", content?.text || "Fetching…"), 0, 0);
+
+      const details = result.details;
+
+      const summary =
+        details?.characterCount !== undefined
+          ? [
+              details.extractionDiagnostics?.botWall
+                ? "Blocked"
+                : `${details.characterCount} characters`,
+              details.cacheStatus ?? (details.cached ? "cached" : "miss"),
+              ...(details.focus
+                ? [`${details.focus.matchedSections}/${details.focus.totalSections} sections`]
+                : []),
+              ...(details.nextOffset === undefined ? [] : [`next offset=${details.nextOffset}`]),
+            ].join(" · ")
+          : "";
+
       return new Text(
         content?.type === "text"
-          ? formatCollapsibleOutput(content.text, expanded, theme)
+          ? `${theme.fg("dim", summary)}${formatCollapsibleOutput(content.text, expanded, theme)}`
           : theme.fg("dim", "No content"),
         0,
         0,