@devries-cameron20 / t3code-1 / commits / a1f8dcf997
Fork 0

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

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 ),