@diegopetrucci/pi-oracle 0.1.11 → 0.1.13

package/README.md

@@ -27,7 +27,7 @@ By default, the extension:
 4. tries a provider-specific hardcoded priority list first
 5. falls back to a heuristic that favors stronger tiers like `opus`, `pro`, newer versions, and penalizes `mini`, `flash`, `haiku`, `spark`, etc.
 
-The hardcoded rankings now cover pi's built-in provider set, including Together; see the provider matrix for the current provider-by-provider top picks.
+The hardcoded rankings now cover pi's built-in provider set, including Claude Fable on Anthropic-compatible providers and Together; see the provider matrix for the current provider-by-provider top picks.
 
 If no reasoning model exists on the current provider, it falls back to the best available model on that provider.
 

package/index.ts

@@ -75,6 +75,7 @@ const ORACLE_CONFIG_FILE = "oracle.json";
 
 const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 	"amazon-bedrock": [
+		"claude-fable-5",
 		"claude-opus-4-8",
 		"claude-opus-4-7",
 		"claude-opus-4-6",
@@ -92,6 +93,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"zai.glm-5",
 	],
 	anthropic: [
+		"claude-fable-5",
 		"claude-opus-4-8",
 		"claude-opus-4.8",
 		"claude-opus-4-7",
@@ -132,6 +134,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 	],
 	cerebras: ["gpt-oss-120b", "zai-glm-4.7", "llama3.1-8b"],
 	"cloudflare-ai-gateway": [
+		"claude-fable-5",
 		"claude-opus-4-7",
 		"claude-opus-4-6",
 		"claude-opus-4-5",
@@ -159,6 +162,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"accounts/fireworks/models/gpt-oss-120b",
 	],
 	"github-copilot": [
+		"claude-fable-5",
 		"claude-opus-4.8",
 		"claude-opus-4.7",
 		"claude-opus-4.6",
@@ -257,6 +261,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"big-pickle",
 	],
 	opencode: [
+		"claude-fable-5",
 		"gpt-5.5-pro",
 		"gpt-5.5",
 		"gpt-5.4-pro",
@@ -289,6 +294,8 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"kimi-k2.5",
 	],
 	openrouter: [
+		"anthropic/claude-fable-5",
+		"~anthropic/claude-fable-latest",
 		"anthropic/claude-opus-4.8",
 		"anthropic/claude-opus-4.8-fast",
 		"anthropic/claude-opus-4.7",
@@ -327,6 +334,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"MiniMaxAI/MiniMax-M2.5",
 	],
 	"vercel-ai-gateway": [
+		"anthropic/claude-fable-5",
 		"anthropic/claude-opus-4.8",
 		"anthropic/claude-opus-4.7",
 		"anthropic/claude-opus-4.6",
@@ -549,6 +557,26 @@ function extractTextFromContent(content: unknown): string {
 	return parts.join("\n\n").trim();
 }
 
+// Errors that typically resolve on retry: provider overload, rate limiting,
+// transient 5xx, gateway/network failures, and request timeouts. Keep this list
+// pattern-based so we recognize variants across providers without enumerating them.
+const TRANSIENT_ERROR_PATTERN =
+	/\b(overload(?:ed)?|rate[ _-]?limit(?:ed)?|too many requests|429|500|502|503|504|bad gateway|service unavailable|gateway timeout|temporarily unavailable|timed?[ _-]?out|timeout|econnreset|econnrefused|etimedout|enetunreach|socket hang up|fetch failed)\b/i;
+
+function isTransientErrorMessage(message: string): boolean {
+	return TRANSIENT_ERROR_PATTERN.test(message);
+}
+
+function formatOracleModelError(stopReason: "error" | "aborted", errorMessage: string | undefined): string {
+	const trimmed = errorMessage?.trim();
+	if (stopReason === "aborted") {
+		return trimmed ? `Oracle model turn aborted: ${trimmed}` : "Oracle model turn aborted.";
+	}
+	if (!trimmed) return "Oracle model error (no detail provided by provider).";
+	const base = `Oracle model error: ${trimmed}`;
+	return isTransientErrorMessage(trimmed) ? `${base} (transient; retry may succeed)` : base;
+}
+
 function parseVersionScore(text: string): number {
 	const matches = text.match(/\d+(?:\.\d+){0,2}/g) ?? [];
 	let best = 0;
@@ -809,6 +837,9 @@ async function runOracle(
 	let finalOutput = "";
 	let stderr = "";
 
+	let lastStopReason: string | undefined;
+	let lastErrorMessage: string | undefined;
+
 	const details: OracleDetails = {
 		...selection,
 		includeBash,
@@ -880,6 +911,11 @@ async function runOracle(
 				if (text) finalOutput = text;
 				currentText = "";
 
+				const stopReason = event.message.stopReason;
+				lastStopReason = typeof stopReason === "string" ? stopReason : undefined;
+				const errorMessageField = event.message.errorMessage;
+				lastErrorMessage = typeof errorMessageField === "string" ? errorMessageField : undefined;
+
 				const messageUsage = event.message.usage;
 				if (messageUsage) {
 					usage.turns += 1;
@@ -938,6 +974,19 @@ async function runOracle(
 		return { ok: false, error: "Oracle was aborted.", details };
 	}
 
+	// The pi subprocess in `--mode json` does not promote an errored assistant
+	// turn to a non-zero exit code or stderr; the error is only carried on the
+	// streamed assistant message via stopReason/errorMessage. Surface that here
+	// so callers can distinguish transient provider errors from a genuinely
+	// empty response.
+	if (lastStopReason === "error" || lastStopReason === "aborted") {
+		return {
+			ok: false,
+			error: formatOracleModelError(lastStopReason, lastErrorMessage),
+			details,
+		};
+	}
+
 	if (exitCode !== 0) {
 		return {
 			ok: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-oracle",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "An Amp-style oracle extension for pi that consults the strongest reasoning model on your current provider.",
   "keywords": [
     "pi-package",