pi-quiver 3.3.1 → 3.3.2

package/CHANGELOG.md

@@ -8,6 +8,10 @@ Published to npm as `pi-quiver` (`pi install npm:pi-quiver`). Pushing a
 via OIDC trusted publishing. The release helper at
 `.agents/skills/release/scripts/release.sh` cuts the tag; CI publishes.
 
+## v3.3.2 - 2026-07-30
+
+- **`fast-mode` supports Claude Opus 5.** Added `claude-opus-5` to the model prefix allowlist (fast mode API mechanics are identical to Opus 4.8: `speed: "fast"` + `fast-mode-2026-02-01` beta; compat verified identical in pi-ai 0.82.1, so `buildBetaHeader`'s OAuth-only preservation still holds).
+
 ## v3.3.1 - 2026-07-19
 
 - **`provider-stall-watchdog`: bounded multi-stall retry via `maxStallRetries`.** Each semantic stall converts to a retryable error until the budget is exhausted; previously only the first stall retried, so a longer provider outage forced manual resubmission (observed stuck streams recover in seconds on a fresh request). Default = layered `retry.maxRetries` (Pi default 3); explicit config wins; positive integer, fails closed. A successful assistant turn resets the counter, mirroring Pi's retry loop.

package/README.md

@@ -66,7 +66,7 @@ A 300 KB changelog page never touches your context window - you get a preview an
 | `doc_to_md.ts` | `doc_to_md` | Convert a local PDF/DOCX/PPTX to Markdown. High-fidelity via `pymupdf4llm` (run through `uv`); degraded pure-JS fallback (`unpdf`) when `uv`/Python is unavailable or conversion times out. DOCX/PPTX convert via LibreOffice first. |
 | `session-name.ts` | `/session-name` | Manual + opt-in automatic session naming, with Ghostty tab rename. OFF by default. |
 | `sword-header.ts` | `/builtin-header` | Themed ASCII startup header replacing pi's default logo. OFF by default. |
-| `fast-mode.ts` | `/fast` | Inject Anthropic fast-mode (`speed: "fast"` + `anthropic-beta: fast-mode-2026-02-01`) into every Claude Opus 4.8 request, any thinking level. `--fast` flag + `/fast [on\|off\|status]`. OFF by default. |
+| `fast-mode.ts` | `/fast` | Inject Anthropic fast-mode (`speed: "fast"` + `anthropic-beta: fast-mode-2026-02-01`) into every Claude Opus 4.8 / Opus 5 request, any thinking level. `--fast` flag + `/fast [on\|off\|status]`. OFF by default. |
 | `provider-stall-watchdog.ts` | - | Opt-in semantic-silence watchdog for human interactive TUI runs. Warns after 2 minutes and recovers after 4 minutes; policy D offers each stall to Pi's retry loop until the stall retry budget (`maxStallRetries`, default = `retry.maxRetries`) is exhausted. OFF by default. |
 
 Full routing rules, size-gate mechanics, and config: [doc/fetch.md](doc/fetch.md), [doc/doc-to-md.md](doc/doc-to-md.md).
@@ -148,7 +148,7 @@ These extensions are opt-in via `settings.json` (project `.pi/settings.json` ove
 }
 ```
 
-`sessionAutoName.enabled` makes one extra short LLM call per session (once, after the first turn) to title it; `false` (default) makes no model calls. `fastMode` only affects `claude-opus-4-8` requests on Anthropic's `anthropic-messages` API; enabling it opts into premium fast-mode pricing. `--fast` forces it on for one launch; `/fast on|off` toggles live. Proxy providers (opencode, cloudflare-ai-gateway) are excluded. `fastMode`'s header injection needs the `before_provider_headers` hook (pi bundling `@earendil-works/pi-coding-agent` >= 0.80.5); on older pi the beta header is silently not sent. See [doc/fetch.md](doc/fetch.md) and [doc/doc-to-md.md](doc/doc-to-md.md) for the ingestion tools' full reference; session-name/sword-header behavior above is complete.
+`sessionAutoName.enabled` makes one extra short LLM call per session (once, after the first turn) to title it; `false` (default) makes no model calls. `fastMode` only affects `claude-opus-4-8` and `claude-opus-5` requests on Anthropic's `anthropic-messages` API; enabling it opts into premium fast-mode pricing. `--fast` forces it on for one launch; `/fast on|off` toggles live. Proxy providers (opencode, cloudflare-ai-gateway) are excluded. `fastMode`'s header injection needs the `before_provider_headers` hook (pi bundling `@earendil-works/pi-coding-agent` >= 0.80.5); on older pi the beta header is silently not sent. See [doc/fetch.md](doc/fetch.md) and [doc/doc-to-md.md](doc/doc-to-md.md) for the ingestion tools' full reference; session-name/sword-header behavior above is complete.
 
 Recommended explicit retry and watchdog settings:
 

package/fast-mode.ts

@@ -1,8 +1,8 @@
 /**
- * Fast mode for Claude Opus 4.8.
+ * Fast mode for Claude Opus 4.8 / Opus 5.
  *
  * When enabled, injects Anthropic's fast-mode signals into every qualifying
- * Opus 4.8 request on the anthropic-messages API, regardless of thinking level:
+ * Opus 4.8 / Opus 5 request on the anthropic-messages API, regardless of thinking level:
  *   - payload: { ...payload, speed: "fast" }        (before_provider_request)
  *   - header:  anthropic-beta: ...,fast-mode-2026-02-01  (before_provider_headers)
  *
@@ -13,11 +13,12 @@
  *
  * Header coupling to pi-ai internals: pi assembles `anthropic-beta` AFTER this
  * hook and merges the hook's headers LAST, so setting the header here REPLACES
- * pi's list. For opus-4-8 pi's conditional betas (fine-grained tool streaming,
- * interleaved thinking) are never applied (eager tool streaming defaults on +
- * forceAdaptiveThinking), so the only betas to preserve are the OAuth identity
- * betas. We detect OAuth via the same token marker pi uses and rebuild the
- * exact list. If pi later adds betas for opus-4-8, revisit buildBetaHeader.
+ * pi's list. For opus-4-8 and opus-5 pi's conditional betas (fine-grained tool
+ * streaming, interleaved thinking) are never applied (eager tool streaming
+ * defaults on + forceAdaptiveThinking; verified identical compat in pi-ai
+ * 0.82.1), so the only betas to preserve are the OAuth identity betas. We
+ * detect OAuth via the same token marker pi uses and rebuild the exact list.
+ * If pi later adds betas for these models, revisit buildBetaHeader.
  */
 
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
@@ -25,9 +26,9 @@ import { resolveConfig } from "./extension-config.ts";
 
 export const FAST_MODE_BETA = "fast-mode-2026-02-01";
 export const FAST_SPEED = "fast";
-// Loose prefix: matches dated snapshots (claude-opus-4-8-*). Opus 4.7 is out of
-// scope (D1); a future 4.9 needs a one-line addition here.
-export const FAST_MODE_MODEL_PREFIXES = ["claude-opus-4-8"];
+// Loose prefixes: match dated snapshots (claude-opus-4-8-*, claude-opus-5-*).
+// Opus 4.7 is out of scope (D1); a future model needs a one-line addition here.
+export const FAST_MODE_MODEL_PREFIXES = ["claude-opus-4-8", "claude-opus-5"];
 export const OAUTH_IDENTITY_BETAS = ["claude-code-20250219", "oauth-2025-04-20"];
 const STATUS_KEY = "fast-mode";
 const BETA_HEADER = "anthropic-beta";
@@ -121,7 +122,7 @@ export default function (pi: ExtensionAPI) {
 
 	pi.registerFlag("fast", {
 		type: "boolean",
-		description: "Enable Anthropic fast mode for Opus 4.8 requests this launch",
+		description: "Enable Anthropic fast mode for Opus 4.8/5 requests this launch",
 	});
 
 	pi.on("session_start", async (_event, ctx) => {
@@ -147,7 +148,7 @@ export default function (pi: ExtensionAPI) {
 	});
 
 	pi.registerCommand("fast", {
-		description: "Manage Opus 4.8 fast mode: /fast [on|off|status]",
+		description: "Manage Opus 4.8/5 fast mode: /fast [on|off|status]",
 		getArgumentCompletions: (prefix) => {
 			const p = prefix.trim().toLowerCase();
 			if (p.includes(" ")) return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-quiver",
-  "version": "3.3.1",
+  "version": "3.3.2",
   "description": "Personal pack of Pi coding-agent extensions: context-safe fetch, doc_to_md PDF/DOCX/PPTX-to-Markdown conversion, session naming, a themed ASCII startup header, Opus 4.8 fast mode, and a provider-stall watchdog.",
   "author": "Jacek Juraszek",
   "license": "MIT",