@zeldrisho/pi-web-fetch 0.11.0 → 0.11.1

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.11.1] - 2026-10-20
+
+### Changed
+
+- Simplify the model-facing fetch tool and parameter descriptions.
+
+### Fixed
+
+- Retry 404 and 406 responses to Markdown-negotiated requests with HTML preferred, allowing pages whose HTML representation is available to fetch successfully.
+
 ## [0.11.0] - 2026-10-19
 
 ### Added
@@ -223,7 +233,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.11.0...HEAD
+[Unreleased]: https://github.com/zeldrisho/pi-packages/compare/pi-web-fetch-v0.11.1...HEAD
+[0.11.1]: https://github.com/zeldrisho/pi-packages/compare/pi-web-fetch-v0.11.0...pi-web-fetch-v0.11.1
 [0.11.0]: https://github.com/zeldrisho/pi-packages/compare/pi-web-fetch-v0.10.2...pi-web-fetch-v0.11.0
 [0.10.2]: https://github.com/zeldrisho/pi-packages/compare/pi-web-fetch-v0.10.1...pi-web-fetch-v0.10.2
 [0.10.1]: https://github.com/zeldrisho/pi-packages/compare/pi-web-fetch-v0.10.0...pi-web-fetch-v0.10.1

package/package.json

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

package/src/acquisition/fetch.ts

@@ -478,13 +478,29 @@ async function fetchDocument(
   };
 
   try {
+    const requestUrl = normalizeGitHubRawUrl(rawUrl);
+
     let { target, response } = await requestFollowingRedirects(
-      normalizeGitHubRawUrl(rawUrl),
+      requestUrl,
       controller.signal,
       requestDependencies,
       conditionalHeaders,
     );
 
+    // Some servers route Markdown negotiation to a missing representation even
+    // though their HTML page exists (for example, Redis documentation URLs).
+    // Retry only these representation-related statuses, through the same
+    // validated redirect/network boundary, with HTML preferred.
+    if ([404, 406].includes(response.statusCode ?? 0)) {
+      response.resume();
+      ({ target, response } = await requestFollowingRedirects(
+        target.url,
+        controller.signal,
+        requestDependencies,
+        { Accept: "text/html, text/plain;q=0.9, */*;q=0.1" },
+      ));
+    }
+
     if (
       response.statusCode !== undefined &&
       responseHeader(response, "cf-mitigated")?.trim().toLowerCase() === "challenge"

package/src/index.ts

@@ -61,10 +61,8 @@ export {
 
 export const webFetchParameters = Type.Object({
   url: Type.String(),
-  query: Type.Optional(Type.String({ description: "Return only matching sections (long pages)." })),
-  offset: Type.Optional(
-    Type.Integer({ description: "Character offset; use nextOffset to continue." }),
-  ),
+  query: Type.Optional(Type.String({ description: "Find sections matching this text." })),
+  offset: Type.Optional(Type.Integer({ description: "Start at this character offset." })),
 });
 
 /**
@@ -80,7 +78,7 @@ export default function (pi: ExtensionAPI) {
   pi.registerTool({
     name: "web_fetch",
     label: "Web Fetch",
-    description: "Fetch a public HTTP(S) page as Markdown (6,000 chars per call).",
+    description: "Read a public webpage as Markdown.",
     parameters: webFetchParameters,
 
     renderCall(args, theme) {