The best way to control Claude Code, Codex and more from any computer or phone
Mirrored from https://github.com/Camo67/t3code.git
Synced Nov 22, 05:45 UTC
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
),