@narumitw/pi-retry 0.1.1

package/README.md

@@ -0,0 +1,25 @@
+# pi-retry
+
+A public [pi](https://pi.dev) extension package that treats provider responses containing `Unknown error (no error details in response)` as retryable.
+
+## Install
+
+```bash
+pi install npm:@narumitw/pi-retry
+```
+
+Try without installing:
+
+```bash
+pi -e npm:@narumitw/pi-retry
+```
+
+Try this working tree locally:
+
+```bash
+pi -e .
+```
+
+## 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/biome.json

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

package/extensions/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/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@narumitw/pi-retry",
+  "version": "0.1.1",
+  "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"
+  }
+}