opencode-anthropic-fix 0.0.25 → 0.0.27

package/README.md

@@ -43,13 +43,20 @@ The [original plugin](https://github.com/anomalyco/opencode-anthropic-auth) prov
 - **Standalone CLI** — manage accounts without opening OpenCode
 - **Configurable strategies** — sticky, round-robin, or hybrid account selection
 - **Claude Code signature emulation** — full HTTP header, system prompt, beta flag, and metadata mimicry derived from Claude Code's open source code
-- **OAuth endpoint fingerprint parity** — sends Claude Code-style `User-Agent` on `/v1/oauth/token` and `/v1/oauth/revoke` to match current OAuth validation
-- **Effort-based thinking for Opus 4.6** — maps `budgetTokens` to effort levels (`low`/`medium`/`high`) and includes `effort-2025-11-24`
-- **Upstream-aligned auto betas** — `advanced-tool-use-2025-11-20` and `fast-mode-2026-02-01` auto-included to match Claude Code 2.1.79+ (`redact-thinking-2026-02-12` available as opt-in to preserve thinking block visibility)
+- **OAuth endpoint fingerprint parity** — matches the real CLI's bundled axios 1.13.6 HTTP client signature (`Accept`, `User-Agent`, `Content-Type`) on all OAuth token endpoint calls, required since 2026-03-21 server-side enforcement
+- **Dynamic billing cache hash** — computes the `cch` field in the billing header using the real CLI's `NP1()` algorithm (SHA-256 of salt + first user message chars + version), replacing the static `00000` placeholder
+- **Adaptive thinking for Opus/Sonnet 4.6** — automatically normalizes thinking to `{type: "adaptive"}` for supported models, with `effort-2025-11-24` beta
+- **Upstream-aligned auto betas** — 13+ always-on betas matching Claude Code 2.1.81 (`redact-thinking-2026-02-12` available as opt-in to preserve thinking block visibility)
 - **1M context limit override** — patches `model.limit.context` so OpenCode compacts at the right threshold while `models.dev` catches up
 - **Runtime config + custom betas** — `/anthropic set`, `/anthropic config`, and `/anthropic betas` slash commands for live feature toggling without restarting OpenCode
 - **Files API integration** — upload, list, download, and manage files via `/anthropic files` with endpoint/content-scoped `files-api-2025-04-14` beta injection
 - **Code execution support** — available via explicit custom beta opt-in (`code-execution-2025-08-25`), not auto-enabled
+- **Deep QA conformance** — 491 tests across 11 test files, including 40 regression tests validating every header, body field, OAuth parameter, beta flag, system prompt block, response handling path, and telemetry schema against the [reverse-engineering doc](docs/claude-code-reverse-engineering.md)
+- **Prompt caching with 1h TTL** — extended cache TTL on system prompt blocks, auto-disabled if API rejects; cache hit rate tracking with configurable warning threshold
+- **Proactive rate limit detection** — reads `anthropic-ratelimit-unified-*-utilization` headers (tokens, requests, input-tokens) and applies health penalties before hitting 429
+- **529/503 retry with Stainless backoff** — service-wide overload errors retried up to 2 times using the same exponential backoff formula as the official SDK
+- **OAuth CSRF protection** — state parameter stored and validated on callback, independent from PKCE verifier
+- **Telemetry emulation (opt-in)** — minimal `tengu_started`/`tengu_exit` events matching Claude Code's schema; disabled by default for privacy
 
 ## Installation
 
@@ -492,7 +499,7 @@ When you make a request through OpenCode:
 2. It refreshes the OAuth token if expired
 3. It transforms the request (adds OAuth headers, `oauth-2025-04-20`, signature headers, beta flags, tool prefixes)
 4. If the response is account-specific (429/401, plus 400/403 billing/quota/permission errors), it marks that account and immediately tries the next account
-5. If the response is service-wide (500/503/529), it returns the error directly (switching accounts would not help)
+5. If the response is service-wide (529/503), it retries up to 2 times with exponential backoff before returning the error
 6. It tries each available account at most once per request
 7. Successful responses have tool name prefixes stripped from the stream
 
@@ -523,6 +530,33 @@ Account credentials are stored with restrictive file permissions (owner read/wri
 
 Make sure the plugin is installed in `~/.config/opencode/plugin/`. Restart OpenCode after installing.
 
+### "TypeError: undefined is not an object (evaluating 'hook.config')"
+
+This usually means OpenCode loaded a broken/missing plugin entry (often a stale file in `~/.config/opencode/plugin/`, or a plugin listed in `opencode.json` that is not actually installed).
+
+For OpenCode v1.x, the safest local-dev setup is to link the package directory into OpenCode's `node_modules` and load it by package name:
+
+```powershell
+$link = "$env:USERPROFILE\.config\opencode\node_modules\opencode-anthropic-fix"
+$target = "D:\git\opencode-anthropic-fix"
+
+New-Item -ItemType Directory -Force -Path (Split-Path $link) | Out-Null
+if (Test-Path $link) { Remove-Item $link -Recurse -Force }
+New-Item -ItemType Junction -Path $link -Target $target
+```
+
+Then ensure `~/.config/opencode/opencode.json` contains:
+
+```json
+{
+  "plugin": ["opencode-anthropic-fix"]
+}
+```
+
+If you still see the error, temporarily keep only `"opencode-anthropic-fix"` in the plugin array and add other plugins back one-by-one to find the broken one.
+
+Important: remove stale standalone files like `~/.config/opencode/plugin/opencode-anthropic-auth-plugin.js` if present. They can shadow package loading and trigger `hook.config` crashes.
+
 ### "Auth flow completes but requests fail"
 
 Your OAuth token may have expired. Try a quick refresh first, or re-authenticate with fresh browser login:
@@ -597,7 +631,9 @@ export PATH="$HOME/.local/bin:$PATH"
 
 ## License
 
-Same as upstream. See [anomalyco/opencode-anthropic-auth](https://github.com/anomalyco/opencode-anthropic-auth).
+This project is licensed under the [GNU General Public License v3.0](LICENSE) (GPLv3).
+
+Copyright © 2025-2026 Marco Jardim and contributors.
 
 ---