@devries-cameron20 / t3code-1 / commits / 68c38b959a
Fork 0

The best way to control Claude Code, Codex and more from any computer or phone

fix(opencode): text generation errors explain known provider failures without raw provider text (#29877)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

Alex Southwell committed Nov 3, 2026 at 17:20 UTC 68c38b959ae89b96c80c3e67402d6cfe5e0c1437
2 files changed +109 -24
packages/provider-opencode/src/server/textGeneration.test.ts
+61
@@ -456,6 +456,67 @@ it.layer(layerOpenCodeTextGenerationTest)("OpenCodeTextGeneration", (it) => {
456 ),
457 );
458
459 + it.effect(
460 + "maps OpenCode prompt errors to fixed details and keeps provider text in the cause",
461 + () =>
462 + Effect.forEach(
463 + [
464 + {
465 + error: {
466 + name: "APIError",
467 + data: {
468 + message: "Org quota secret-org exceeded",
469 + statusCode: 429,
470 + isRetryable: true,
471 + },
472 + },
473 + rawText: "secret-org",
474 + detail: "The model provider's usage or rate limit was reached. Try again later.",
475 + },
476 + {
477 + error: {
478 + name: "APIError",
479 + data: {
480 + message: "<none>",
481 + statusCode: 503,
482 + isRetryable: true,
483 + responseBody: "<title>Upstream gateway secret-host</title>",
484 + },
485 + },
486 + rawText: "secret-host",
487 + detail: "The model provider failed the request (HTTP 503).",
488 + },
489 + {
490 + error: { name: "UnknownError", data: { message: "Provider stack trace secret-token" } },
491 + rawText: "secret-token",
492 + detail: "OpenCode could not generate the text.",
493 + },
494 + ],
495 + (testCase) =>
496 + withOpenCodeTextGeneration(DEFAULT_OPENCODE_SETTINGS, (textGeneration) =>
497 + Effect.gen(function* () {
498 + runtimeMock.state.promptResult = {
499 + data: { info: { error: testCase.error }, parts: [] },
500 + };
501 +
502 + const error = yield* textGeneration
503 + .generateCommitMessage(DEFAULT_COMMIT_MESSAGE_INPUT)
504 + .pipe(Effect.flip);
505 +
506 + expect(error.detail).toBe(testCase.detail);
507 + expect(error.message).not.toContain(testCase.rawText);
508 + expect(error.cause).toMatchObject({
509 + _tag: "OpenCodeTextGenerationPromptResponseError",
510 + providerErrorName: testCase.error.name,
511 + cause: testCase.error,
512 + });
513 + expect((error.cause as Error).message).not.toContain(testCase.rawText);
514 + }),
515 + ),
516 + { discard: true },
517 + ),
518 + );
519 +
520 it.effect("deletes the session when the prompt request rejects", () =>
521 withOpenCodeTextGeneration(DEFAULT_OPENCODE_SETTINGS, (textGeneration) =>
522 Effect.gen(function* () {
packages/provider-opencode/src/server/textGeneration.ts
+48 -24
@@ -70,15 +70,40 @@ export class OpenCodeTextGenerationPromptResponseError extends Schema.TaggedErro
70 {
71 ...openCodePromptErrorContext,
72 providerErrorName: Schema.optional(Schema.String),
73 - providerMessage: Schema.String,
73 + statusCode: Schema.optional(Schema.Int),
74 + cause: Schema.Defect(),
75 },
76 ) {
77 override get message(): string {
78 const providerError = this.providerErrorName ? ` ${this.providerErrorName}` : "";
78 - return `OpenCode prompt${providerError} failed for ${this.operation} in ${this.cwd} using ${this.providerId}/${this.modelId} (session ${this.sessionId}): ${this.providerMessage}`;
79 + const status = this.statusCode === undefined ? "" : `, HTTP ${this.statusCode}`;
80 + return `OpenCode prompt${providerError} failed for ${this.operation} in ${this.cwd} using ${this.providerId}/${this.modelId} (session ${this.sessionId}${status}).`;
81 }
82 }
83
84 +function openCodePromptResponseErrorDetail(error: OpenCodeTextGenerationPromptResponseError) {
85 + if (
86 + error.providerErrorName === "ProviderAuthError" ||
87 + error.statusCode === 401 ||
88 + error.statusCode === 403
89 + ) {
90 + return "The model provider rejected the credentials. Check the provider's sign-in or API key in OpenCode.";
91 + }
92 + if (error.statusCode === 429) {
93 + return "The model provider's usage or rate limit was reached. Try again later.";
94 + }
95 + if (error.providerErrorName === "ContextOverflowError") {
96 + return "The prompt is too long for the selected model's context window.";
97 + }
98 + if (error.providerErrorName === "MessageAbortedError") {
99 + return "OpenCode stopped the generation.";
100 + }
101 + if (error.statusCode !== undefined) {
102 + return `The model provider failed the request (HTTP ${error.statusCode}).`;
103 + }
104 + return "OpenCode could not generate the text.";
105 +}
106 +
107 export class OpenCodeTextGenerationEmptyOutputError extends Schema.TaggedError<OpenCodeTextGenerationEmptyOutputError>()(
108 "OpenCodeTextGenerationEmptyOutputError",
109 {
@@ -94,7 +119,7 @@ export class OpenCodeTextGenerationEmptyOutputError extends Schema.TaggedError<O
119
120 interface OpenCodePromptFailure {
121 readonly name?: string;
97 - readonly message: string;
122 + readonly statusCode?: number;
123 }
124
125 interface OpenCodeTextPart {
@@ -111,26 +136,21 @@ function getOpenCodePromptFailure(error: unknown): OpenCodePromptFailure | null
136 "name" in error && typeof error.name === "string" && error.name.trim().length > 0
137 ? error.name.trim()
138 : undefined;
114 - const message =
115 - "data" in error &&
116 - error.data &&
117 - typeof error.data === "object" &&
118 - "message" in error.data &&
119 - typeof error.data.message === "string"
120 - ? error.data.message.trim()
121 - : "";
122 - if (message.length > 0) {
123 - return {
124 - ...(name ? { name } : {}),
125 - message,
126 - };
127 - }
128 -
129 - if (name) {
130 - return { name, message: name };
139 + const data = "data" in error && error.data && typeof error.data === "object" ? error.data : {};
140 + const statusCode =
141 + "statusCode" in data && typeof data.statusCode === "number" && Number.isInteger(data.statusCode)
142 + ? data.statusCode
143 + : undefined;
144 + const hasMessage =
145 + "message" in data && typeof data.message === "string" && data.message.trim().length > 0;
146 + if (!name && statusCode === undefined && !hasMessage) {
147 + return null;
148 }
149
133 - return null;
150 + return {
151 + ...(name ? { name } : {}),
152 + ...(statusCode !== undefined ? { statusCode } : {}),
153 + };
154 }
155
156 function isOpenCodeTextPart(part: unknown): part is OpenCodeTextPart {
@@ -263,12 +283,16 @@ export const makeOpenCodeTextGeneration = Effect.fn("makeOpenCodeTextGeneration"
283 ),
284 ),
285 );
266 - const promptFailure = getOpenCodePromptFailure(result.data?.info?.error);
286 + const promptError = result.data?.info?.error;
287 + const promptFailure = getOpenCodePromptFailure(promptError);
288 if (promptFailure) {
289 return yield* new OpenCodeTextGenerationPromptResponseError({
290 ...promptContext,
291 ...(promptFailure.name ? { providerErrorName: promptFailure.name } : {}),
271 - providerMessage: promptFailure.message,
292 + ...(promptFailure.statusCode !== undefined
293 + ? { statusCode: promptFailure.statusCode }
294 + : {}),
295 + cause: promptError,
296 });
297 }
298 const responseParts = result.data?.parts ?? [];
@@ -312,7 +336,7 @@ export const makeOpenCodeTextGeneration = Effect.fn("makeOpenCodeTextGeneration"
336 Effect.fail(
337 new TextGenerationError({
338 operation: cause.operation,
315 - detail: cause.providerMessage,
339 + detail: openCodePromptResponseErrorDetail(cause),
340 cause,
341 }),
342 ),