@narumitw/pi-retry 0.1.2 → 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 narumiruna
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -14,12 +14,40 @@ Try without installing:
 pi -e npm:@narumitw/pi-retry
 ```
 
-Try this working tree locally:
+Try this package locally from the repository root:
 
 ```bash
-pi -e .
+pi -e ./extensions/pi-retry
 ```
 
 ## What it does
 
 When an assistant message ends with `stopReason: "error"` and the error message matches `Unknown error (no error details in response)`, the extension appends pi's retryable-provider-error hint so pi's built-in retry path can continue the turn.
+
+## Package layout
+
+```txt
+extensions/pi-retry/
+├── src/
+│   └── unknown-error-retry.ts
+├── README.md
+├── LICENSE
+├── tsconfig.json
+└── package.json
+```
+
+The package exposes its extension through `package.json`:
+
+```json
+{
+  "pi": {
+    "extensions": ["./src/unknown-error-retry.ts"]
+  }
+}
+```
+
+Install this package with Pi:
+
+```bash
+pi install npm:@narumitw/pi-retry
+```

package/package.json

@@ -1,37 +1,34 @@
 {
-  "name": "@narumitw/pi-retry",
-  "version": "0.1.2",
-  "description": "Public pi extension that retries empty-detail provider unknown errors.",
-  "type": "module",
-  "license": "MIT",
-  "private": false,
-  "keywords": [
-    "pi-package",
-    "pi-extension",
-    "pi",
-    "retry"
-  ],
-  "files": [
-    "extensions",
-    "README.md",
-    "biome.json"
-  ],
-  "pi": {
-    "extensions": [
-      "./extensions"
-    ]
-  },
-  "scripts": {
-    "check": "biome check . && npm run typecheck",
-    "format": "biome check --write .",
-    "typecheck": "tsc --noEmit"
-  },
-  "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "*"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "2.4.14",
-    "@mariozechner/pi-coding-agent": "0.73.0",
-    "typescript": "6.0.3"
-  }
+	"name": "@narumitw/pi-retry",
+	"version": "0.1.4",
+	"description": "Public pi extension that retries empty-detail provider unknown errors.",
+	"type": "module",
+	"license": "MIT",
+	"private": false,
+	"keywords": [
+		"pi-package",
+		"pi-extension",
+		"pi",
+		"retry"
+	],
+	"files": [
+		"src",
+		"README.md",
+		"LICENSE"
+	],
+	"pi": {
+		"extensions": [
+			"./src/unknown-error-retry.ts"
+		]
+	},
+	"scripts": {
+		"check": "biome check . && npm run typecheck",
+		"format": "biome check --write .",
+		"typecheck": "tsc --noEmit"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.4.14",
+		"@mariozechner/pi-coding-agent": "0.73.0",
+		"typescript": "6.0.3"
+	}
 }

package/src/unknown-error-retry.ts

@@ -0,0 +1,53 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+
+const UNKNOWN_NO_DETAILS_RE = /Unknown error \(no error details in response\)/i;
+const RETRYABLE_HINT = "provider returned error";
+const EXTENSION_TAG = "[unknown-error-retry]";
+
+export default function unknownErrorRetry(pi: ExtensionAPI) {
+	pi.on("session_start", (_event, ctx) => {
+		ctx.ui.setStatus("unknown-error-retry", "unknown-error retry: on");
+	});
+
+	pi.on("session_shutdown", (_event, ctx) => {
+		ctx.ui.setStatus("unknown-error-retry", undefined);
+	});
+
+	pi.on("message_end", (event, ctx) => {
+		const message = event.message as unknown as {
+			role?: string;
+			stopReason?: string;
+			errorMessage?: unknown;
+			[key: string]: unknown;
+		};
+
+		if (message.role !== "assistant") return;
+		if (message.stopReason !== "error") return;
+		if (typeof message.errorMessage !== "string") return;
+		if (!UNKNOWN_NO_DETAILS_RE.test(message.errorMessage)) return;
+
+		// Avoid appending the hint repeatedly if a resumed/replayed message already has it.
+		if (message.errorMessage.includes(EXTENSION_TAG)) return;
+
+		// pi already has agent-level auto-retry for transient provider errors, but its
+		// matcher does not classify this empty-detail "Unknown error" message as retryable.
+		// Adding this hint before the message is finalized makes pi's built-in auto-retry
+		// path pick it up, remove the failed assistant message from live agent state, and
+		// call agent.continue() with the normal retry settings/backoff.
+		const errorMessage = `${message.errorMessage}\n\n${EXTENSION_TAG} ${RETRYABLE_HINT}; treating empty-detail provider failure as retryable.`;
+
+		if (ctx.hasUI) {
+			ctx.ui.notify(
+				"Matched provider 'Unknown error (no error details in response)'; letting pi auto-retry this turn.",
+				"warning",
+			);
+		}
+
+		return {
+			message: {
+				...message,
+				errorMessage,
+			} as typeof event.message,
+		};
+	});
+}

package/biome.json

@@ -1,6 +0,0 @@
-{
-  "formatter": {
-    "indentStyle": "space",
-    "indentWidth": 2
-  }
-}

package/extensions/unknown-error-retry.ts

@@ -1,53 +0,0 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-
-const UNKNOWN_NO_DETAILS_RE = /Unknown error \(no error details in response\)/i;
-const RETRYABLE_HINT = "provider returned error";
-const EXTENSION_TAG = "[unknown-error-retry]";
-
-export default function unknownErrorRetry(pi: ExtensionAPI) {
-  pi.on("session_start", (_event, ctx) => {
-    ctx.ui.setStatus("unknown-error-retry", "unknown-error retry: on");
-  });
-
-  pi.on("session_shutdown", (_event, ctx) => {
-    ctx.ui.setStatus("unknown-error-retry", undefined);
-  });
-
-  pi.on("message_end", (event, ctx) => {
-    const message = event.message as unknown as {
-      role?: string;
-      stopReason?: string;
-      errorMessage?: unknown;
-      [key: string]: unknown;
-    };
-
-    if (message.role !== "assistant") return;
-    if (message.stopReason !== "error") return;
-    if (typeof message.errorMessage !== "string") return;
-    if (!UNKNOWN_NO_DETAILS_RE.test(message.errorMessage)) return;
-
-    // Avoid appending the hint repeatedly if a resumed/replayed message already has it.
-    if (message.errorMessage.includes(EXTENSION_TAG)) return;
-
-    // pi already has agent-level auto-retry for transient provider errors, but its
-    // matcher does not classify this empty-detail "Unknown error" message as retryable.
-    // Adding this hint before the message is finalized makes pi's built-in auto-retry
-    // path pick it up, remove the failed assistant message from live agent state, and
-    // call agent.continue() with the normal retry settings/backoff.
-    const errorMessage = `${message.errorMessage}\n\n${EXTENSION_TAG} ${RETRYABLE_HINT}; treating empty-detail provider failure as retryable.`;
-
-    if (ctx.hasUI) {
-      ctx.ui.notify(
-        "Matched provider 'Unknown error (no error details in response)'; letting pi auto-retry this turn.",
-        "warning",
-      );
-    }
-
-    return {
-      message: {
-        ...message,
-        errorMessage,
-      } as typeof event.message,
-    };
-  });
-}