pi-squire 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -6,6 +6,18 @@ follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.8.1] - 2026-10-20
+
+### Fixed
+
+- A 429 whose text says the endpoint is unavailable, such as OpenCode Go's
+  `429: Endpoint is unavailable`, no longer marks the provider as
+  usage-limited. It is an outage, not a used-up quota, so `/delegate` keeps
+  launching on the provider instead of refusing it for five minutes or more.
+  Pi has already retried the request by then. A running delegate that hits
+  it moves to its next fallback model and carries on, as it does on a usage
+  limit.
+
 ## [0.8.0] - 2026-10-20
 
 ### Added
@@ -273,7 +285,8 @@ author's dotfiles; the changes below are against that copy.
 
 - The published file list includes `child.ts`, which `index.ts` imports.
 
-[Unreleased]: https://github.com/gvanderclay/pi-squire/compare/v0.8.0...HEAD
+[Unreleased]: https://github.com/gvanderclay/pi-squire/compare/v0.8.1...HEAD
+[0.8.1]: https://github.com/gvanderclay/pi-squire/compare/v0.8.0...v0.8.1
 [0.8.0]: https://github.com/gvanderclay/pi-squire/compare/v0.7.0...v0.8.0
 [0.7.0]: https://github.com/gvanderclay/pi-squire/compare/v0.6.0...v0.7.0
 [0.6.0]: https://github.com/gvanderclay/pi-squire/compare/v0.5.1...v0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-squire",
-	"version": "0.8.0",
+	"version": "0.8.1",
 	"description": "Starts a delegate Pi session in a background tmux window, sends it the task over message:*, and shows the parent its result",
 	"keywords": [
 		"pi-package",

package/src/child.ts

@@ -84,27 +84,39 @@ function registerTakeover(pi: ExtensionAPI, parent: string): void {
 }
 
 /**
- * A usage limit moves the run to the next fallback that is usable and not
- * marked, and continues it in this session; each fallback is tried once.
- * Returns the setter for the model whose usage limit ended the last run.
+ * A usage limit or an unavailable endpoint moves the run to the next fallback
+ * that is usable and not marked, and continues it in this session; each
+ * fallback is tried once. Returns the setter for what ended the last run, as
+ * `<provider/model> <what happened>`.
  */
-function registerFallback(pi: ExtensionAPI): (model: string | undefined) => void {
+function registerFallback(pi: ExtensionAPI): (failure: string | undefined) => void {
 	/** The models still to move to on a usage limit, in order. */
 	const fallback = (process.env[FALLBACK_ENV] ?? "").split(",").filter((model) => model.includes("/"));
-	let limited: string | undefined;
+	let failure: string | undefined;
 	pi.on("agent_before_settle", async (_event, ctx) => {
-		const from = limited;
-		limited = undefined;
+		const from = failure;
+		failure = undefined;
 		const next = from === undefined ? undefined : await switchModel(pi, ctx, fallback);
 		if (next === undefined) return;
-		const content = `[delegate] ${from} hit a usage limit, so this session switched to ${next}. Carry on with the task from where it stopped.`;
+		const content = `[delegate] ${from}, so this session switched to ${next}. Carry on with the task from where it stopped.`;
 		return { continue: true, entries: [{ type: "custom_message", customType: "delegate", content, display: true }] };
 	});
-	return (model) => {
-		limited = model;
+	return (value) => {
+		failure = value;
 	};
 }
 
+/** Why a failed run should move to a fallback, as `<provider/model> <what happened>`; undefined when it should not. */
+function fallbackReason(last: Message | undefined): string | undefined {
+	const error = last?.errorMessage;
+	if (typeof error !== "string") return undefined;
+	const model = `${String(last?.provider)}/${String(last?.model)}`;
+	if (classify(error) !== undefined) return `${model} hit a usage limit`;
+	// Pi has already retried an unavailable endpoint; it marks nothing, but this run moves on.
+	if (/unavailable/i.test(error)) return `${model} was unavailable (${error})`;
+	return undefined;
+}
+
 /** This delegate's footer icon, picked once per load. */
 const ICON = Math.random() < 0.5 ? "👦" : "👧";
 
@@ -120,7 +132,7 @@ function showStatus(ctx: ExtensionContext, armed: boolean): void {
 
 export function registerChild(pi: ExtensionAPI, parent: string): void {
 	registerTakeover(pi, parent);
-	const setLimited = registerFallback(pi);
+	const setFailure = registerFallback(pi);
 
 	let armed = process.env[AUTO_EXIT_ENV] === "1";
 	/** Whether the run that just ended finished without the user stopping it. */
@@ -162,11 +174,7 @@ export function registerChild(pi: ExtensionAPI, parent: string): void {
 		const stopped = last?.stopReason === "aborted" || ctx.signal?.aborted === true;
 		if (stopped) disarm(ctx);
 		if (!stopped && last?.stopReason === "error") recordUsageLimit(last, ctx, response);
-		setLimited(
-			!stopped && typeof last?.errorMessage === "string" && classify(last.errorMessage) !== undefined
-				? `${String(last.provider)}/${String(last.model)}`
-				: undefined,
-		);
+		setFailure(stopped ? undefined : fallbackReason(last));
 		// A failure ends the work like a completion: the parent gets the error, the session file stays.
 		completed = !stopped;
 	});

package/src/limits.ts

@@ -145,10 +145,12 @@ export function headerReset(response: Response | undefined, now = Date.now()): n
 
 /**
  * Whether an error message (Pi's `<status>: <body>`) is a usage limit, and
- * the reset time the text states, if any. Overloaded and 5xx errors never are.
+ * the reset time the text states, if any. Overloaded, unavailable and 5xx
+ * errors never are: OpenCode Go sends "429: Endpoint is unavailable" for an
+ * outage, with quota left.
  */
 export function classify(message: string, now = Date.now()): { resetAt?: number } | undefined {
-	if (/overloaded/i.test(message) || /^\s*5\d\d\b/.test(message)) return undefined;
+	if (/overloaded|unavailable/i.test(message) || /^\s*5\d\d\b/.test(message)) return undefined;
 	if (!LIMIT_PATTERN.test(message) && !/^\s*429\b/.test(message)) return undefined;
 	const resetAt = statedReset(message, now);
 	return resetAt !== undefined && resetAt > now ? { resetAt } : {};