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 21, 07:15 UTC
fix(muse): failed Muse text generation explains Muse's error category (#29861)
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Julius Marminge <julius0216@outlook.com>
Alex Southwell committed
Nov 18, 2026 at 20:07 UTC
a1f8dcf9979fd524d7ffb526a7eeacf3318d268d
2 files changed
+93
-4
packages/provider-muse/src/server/textGeneration.test.ts
+56
@@ -226,6 +226,62 @@ it.layer(NodeServices.layer)("Muse text generation", (it) => {
226
}),
227
);
228
229
+ it.effect("explains a failed turn by Muse's error category", () =>
230
+ Effect.gen(function* () {
231
+ const message = "API error 429: raw provider text";
232
+ const cases = [
233
+ {
234
+ error: { kind: "modelError", quota: { limitKind: "tierLimit", resetsAtMs: 1 } },
235
+ detail: "Muse Code usage limit reached. Try again after it resets.",
236
+ },
237
+ {
238
+ // Credential proxies can refuse with a 429 quota message and no quota object.
239
+ error: { kind: "modelError", message: "upstream 429: quota exceeded for this key" },
240
+ detail: "Muse Code usage limit reached. Try again after it resets.",
241
+ },
242
+ {
243
+ error: { kind: "authRequired" },
244
+ detail: "Muse Code is not signed in. Run `muse login` on this T3 server host.",
245
+ },
246
+ {
247
+ error: { kind: "modelError" },
248
+ detail: "Muse Code's model request failed. Try again or choose another Muse model.",
249
+ },
250
+ {
251
+ error: { kind: "stepLimit" },
252
+ detail:
253
+ "Muse Code text generation failed. Check Muse login and availability on this T3 server host.",
254
+ },
255
+ {
256
+ reason: "upstream 429: quota exceeded for this key",
257
+ detail: "Muse Code usage limit reached. Try again after it resets.",
258
+ },
259
+ {
260
+ reason: "raw provider refusal",
261
+ detail:
262
+ "Muse Code text generation failed. Check Muse login and availability on this T3 server host.",
263
+ },
264
+ ];
265
+ for (const { error, reason, detail } of cases) {
266
+ const raw = error === undefined ? reason : "message" in error ? error.message : message;
267
+ const test = fixture((emit) =>
268
+ emit("turn/completed", {
269
+ terminal: "failed",
270
+ ...(error === undefined
271
+ ? { reason }
272
+ : { error: { message, ...error, retryable: false } }),
273
+ }),
274
+ );
275
+ const service = yield* test.make;
276
+ const failure = yield* service.generateThreadTitle(titleInput).pipe(Effect.flip);
277
+ expect(failure).toMatchObject({ _tag: "TextGenerationError", detail });
278
+ expect(failure.detail).not.toContain(raw);
279
+ expect(failure.cause).toMatchObject({ cause: { message: raw } });
280
+ expect(test.host.close).toHaveBeenCalledOnce();
281
+ }
282
+ }),
283
+ );
284
+
285
it.effect("settles a completed turn even when its start acknowledgement never arrives", () =>
286
Effect.gen(function* () {
287
const test = fixture(finish('{"title":"Fix login form"}'), false);
packages/provider-muse/src/server/textGeneration.ts
+37
-4
@@ -21,6 +21,7 @@ import {
21
type MuseSdkHost,
22
} from "./sdk.ts";
23
import { museModelCapabilities, resolveMuseReasoningEffort } from "./modelCatalog.ts";
24
+import { isMuseUsageLimitFailure } from "./usageLimits.ts";
25
import type { ProviderTextGeneration } from "@t3tools/provider-core/server/textGeneration";
26
import {
27
generatedThreadTitle,
@@ -52,11 +53,17 @@ const ItemNotification = Schema.Struct({
53
truncated: Schema.optionalKey(Schema.Boolean),
54
}),
55
});
56
+const TurnError = Schema.Struct({
57
+ kind: Schema.optionalKey(Schema.String),
58
+ message: Schema.String,
59
+ quota: Schema.optionalKey(Schema.Unknown),
60
+});
61
const TurnCompleted = Schema.Struct({
62
sessionId: Schema.String,
63
turnId: Schema.String,
64
terminal: Schema.String,
59
- error: Schema.optionalKey(Schema.Struct({ message: Schema.String })),
65
+ reason: Schema.optionalKey(Schema.String),
66
+ error: Schema.optionalKey(TurnError),
67
});
68
const ApprovalRequested = Schema.Struct({
69
sessionId: Schema.String,
@@ -75,10 +82,32 @@ const decodeItem = Schema.decodeUnknownSync(ItemNotification);
82
const decodeCompleted = Schema.decodeUnknownSync(TurnCompleted);
83
const decodeApproval = Schema.decodeUnknownSync(ApprovalRequested);
84
const decodeUserInput = Schema.decodeUnknownSync(UserInputRequested);
85
+const isMuseSdkError = Schema.is(MuseSdkError);
86
const encodeJson = Schema.encodeEffect(Schema.fromJsonString(Schema.Unknown));
87
const decodeJson = Schema.decodeEffect(Schema.fromJsonString(Schema.Unknown));
88
89
type Operation = keyof ProviderTextGeneration;
90
+class MuseTurnFailure extends Schema.TaggedError<MuseTurnFailure>()("MuseTurnFailure", {
91
+ turnError: TurnError,
92
+}) {
93
+ override get message() {
94
+ return this.turnError.message;
95
+ }
96
+}
97
+const isMuseTurnFailure = Schema.is(MuseTurnFailure);
98
+
99
+function museFailureDetail(cause: unknown): string {
100
+ const error =
101
+ isMuseSdkError(cause) && isMuseTurnFailure(cause.cause) ? cause.cause.turnError : undefined;
102
+ // Muse sends `quota` only for quota exhaustion, which it still labels `modelError`.
103
+ if (error?.quota !== undefined || isMuseUsageLimitFailure(error?.message))
104
+ return "Muse Code usage limit reached. Try again after it resets.";
105
+ if (error?.kind === "authRequired")
106
+ return "Muse Code is not signed in. Run `muse login` on this T3 server host.";
107
+ if (error?.kind === "modelError")
108
+ return "Muse Code's model request failed. Try again or choose another Muse model.";
109
+ return "Muse Code text generation failed. Check Muse login and availability on this T3 server host.";
110
+}
111
112
async function generateMuseText(
113
host: MuseSdkHost,
@@ -144,8 +173,13 @@ async function generateMuseText(
173
resolveCompletion(answer?.text ?? "");
174
}
175
} else {
176
+ const error =
177
+ completed.error ??
178
+ (completed.reason !== undefined ? { message: completed.reason } : undefined);
179
rejectCompletion(
148
- new Error(completed.error?.message ?? `Muse turn ${completed.terminal}.`),
180
+ error
181
+ ? new MuseTurnFailure({ turnError: error })
182
+ : new Error(`Muse turn ${completed.terminal}.`),
183
);
184
}
185
} else if (
@@ -276,8 +310,7 @@ export const makeMuseTextGeneration = Effect.fn("makeMuseTextGeneration")(functi
310
(cause) =>
311
new TextGenerationError({
312
operation,
279
- detail:
280
- "Muse Code text generation failed. Check Muse login and availability on this T3 server host.",
313
+ detail: museFailureDetail(cause),
314
cause,
315
}),
316
),