cursor-opencode-provider 0.6.2 → 0.6.3

package/README.md

@@ -338,7 +338,7 @@ const model = cursor.languageModel("composer-2.5")
 // model implements AI SDK LanguageModelV3 (doStream / doGenerate)
 ```
 
-Pass either `accessToken` (JWT from OAuth or key exchange) or `apiKey` (raw `crsr_...` key). Optional: `apiBaseURL`, `agentBaseURL`, `cacheDir`, `headers`, `telemetryEnabled`, `retry`, and `continuation`. `cacheDir` pins the host cache root for model/version caches and Cursor project metadata; when omitted, the provider uses an injected structural host path bridge or the native OpenCode XDG cache described in [Paths](#paths-host-cache). Transient failures resume from the latest checkpoint produced by that Run, matching Cursor CLI; without an eligible checkpoint, retries remain limited to replay-safe attempts so completed text or tool work is not duplicated. Pending-tool inactivity is renewed by OpenCode activity from the session or its descendants. The older `baseURL` option is still accepted as a legacy alias for `agentBaseURL`.
+Pass either `accessToken` (JWT from OAuth or key exchange) or `apiKey` (raw `crsr_...` key). Optional: `apiBaseURL`, `agentBaseURL`, `cacheDir`, `headers`, `telemetryEnabled`, `retry`, and `continuation`. `cacheDir` pins the host cache root for model/version caches and Cursor project metadata; when omitted, the provider uses an injected structural host path bridge or the native OpenCode XDG cache described in [Paths](#paths-host-cache). Transient failures resume from the latest checkpoint produced by that Run, matching Cursor CLI; without an eligible checkpoint, retries remain limited to replay-safe attempts so completed text or tool work is not duplicated. Once that budget is spent, or replay is unsafe, the terminal error does not re-arm OpenCode's outer retry loop. Pending-tool inactivity is renewed by OpenCode activity from the session or its descendants. The older `baseURL` option is still accepted as a legacy alias for `agentBaseURL`.
 
 ## Environment variables
 

package/dist/errors.d.ts

@@ -43,6 +43,16 @@ export declare class CursorAuthError extends CursorProviderError {
         cause?: unknown;
     });
 }
+/**
+ * OpenCode's SessionRetry treats several substrings in provider error messages
+ * as always-retryable — notably bare "unavailable" and "exhausted", plus a
+ * broader regex set (resource_exhausted, service unavailable, …).
+ *
+ * When this provider has already spent its Run retry budget, or has decided a
+ * replay would be unsafe, the host-facing message must not re-arm that loop.
+ * Keep the real gRPC/HTTP code on structured fields (`code`, `grpcStatus`).
+ */
+export declare function sanitizeHostTerminalMessage(message: string): string;
 export declare class CursorRetryExhaustedError extends CursorProviderError {
     readonly attempts: number;
     constructor(attempts: number, last: CursorProviderError);

package/dist/errors.js

@@ -69,10 +69,30 @@ export class CursorAuthError extends CursorProviderError {
         this.name = "CursorAuthError";
     }
 }
+/**
+ * OpenCode's SessionRetry treats several substrings in provider error messages
+ * as always-retryable — notably bare "unavailable" and "exhausted", plus a
+ * broader regex set (resource_exhausted, service unavailable, …).
+ *
+ * When this provider has already spent its Run retry budget, or has decided a
+ * replay would be unsafe, the host-facing message must not re-arm that loop.
+ * Keep the real gRPC/HTTP code on structured fields (`code`, `grpcStatus`).
+ */
+export function sanitizeHostTerminalMessage(message) {
+    return message
+        .replace(/\bresource[_\s-]?exhausted\b/gi, "capacity_limit")
+        .replace(/\bservice[_\s-]?unavailable\b/gi, "capacity_limit")
+        .replace(/\bunavailable\b/gi, "capacity_limit")
+        .replace(/\boverloaded\b/gi, "capacity_limit")
+        .replace(/\bretry exhausted\b/gi, "retries finished")
+        .replace(/\bexhausted\b/gi, "finished");
+}
 export class CursorRetryExhaustedError extends CursorProviderError {
     attempts;
     constructor(attempts, last) {
-        super(`Cursor retry exhausted after ${attempts} attempts: ${last.message}`, {
+        // Host-facing text must not contain OpenCode SessionRetry trigger words
+        // ("unavailable", "exhausted", …). Structured fields keep the real code.
+        super(`Cursor Run failed after ${attempts} attempts: ${sanitizeHostTerminalMessage(last.message)}`, {
             origin: last.origin,
             transient: false,
             replaySafe: false,
@@ -184,7 +204,7 @@ export function toCursorProviderError(error, options = { replaySafe: false }) {
     });
 }
 export function retrySuppressedError(cause, reason, attempt, maxAttempts) {
-    const subject = cause.message.replace(/^Cursor Run stream /, "Cursor stream ");
+    const subject = sanitizeHostTerminalMessage(cause.message.replace(/^Cursor Run stream /, "Cursor stream "));
     return new CursorProviderError(`${subject} ${reason}; automatic retry unsafe (attempt ${attempt}/${maxAttempts})`, {
         origin: cause.origin,
         transient: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cursor-opencode-provider",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Use Cursor subscription models from OpenCode via Cursor's Connect-RPC agent protocol",
   "type": "module",
   "license": "MIT",