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, 13:15 UTC
feat(server,web,mobile): fall back when the default provider is out of usage (#26164)
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
maria committed
Oct 29, 2026 at 02:07 UTC
861a51a6c4a036a6f14fea2a6f093808de1d96ce
19 files changed
+763
-37
apps/mobile/src/features/threads/new-task-flow-provider.tsx
+16
-1
@@ -1,4 +1,6 @@
1
import { ActiveNewTaskContext } from "../../state/active-new-task";
2
+import { resolveNewThreadModelSelection } from "@t3tools/shared/usageLimits";
3
+import { useNowMinuteMs } from "../../lib/clock";
4
import * as Dialog from "../../components/ui/Dialog";
5
import React, { useEffect, useRef, useState } from "react";
6
@@ -483,6 +485,7 @@ export function NewTaskFlowProvider(
485
selectedProjectDraft.modelSelection ?? null,
486
selectedProject?.id ?? null,
487
);
488
+ const modelSelectionNow = useNowMinuteMs();
489
const projectDefaultModelSelection = resolveDefaultableModelSelection(
490
selectedEnvironmentServerConfig,
491
projectSettings.settings.defaultModelSelection,
@@ -501,12 +504,24 @@ export function NewTaskFlowProvider(
504
selectedProject?.id ?? null,
505
);
506
504
- const selectedModel = resolveNewTaskModelSelection({
507
+ const selectedDefaultModel = resolveNewTaskModelSelection({
508
draftSelection: draftModelSelection,
509
projectDefaultSelection: projectDefaultModelSelection,
510
stickySelection: stickyModelSelection,
511
modelOptions,
512
});
513
+ const selectedModel = resolveNewThreadModelSelection({
514
+ defaultSelection: selectedDefaultModel,
515
+ explicitSelection:
516
+ draftModelSelection ?? (projectDefaultModelSelection ? null : stickyModelSelection),
517
+ fallbackSelection: selectedEnvironmentServerConfig?.settings.fallbackModelSelection ?? null,
518
+ providers: selectedEnvironmentServerConfig?.providers ?? [],
519
+ ...(selectedEnvironmentServerConfig
520
+ ? { settings: selectedEnvironmentServerConfig.settings }
521
+ : {}),
522
+ projectId: selectedProject?.id ?? null,
523
+ now: modelSelectionNow,
524
+ }).selection;
525
const selectedModelKey = selectedModel
526
? `${selectedModel.instanceId}:${selectedModel.model}`
527
: null;
apps/server/src/mcp/toolkits/project/handlers.test.ts
+58
@@ -1,8 +1,11 @@
1
+import * as ProviderRegistry from "../../../provider/ProviderRegistry.ts";
2
import { expect, it } from "@effect/vitest";
3
import {
4
EnvironmentId,
5
ProjectId,
6
ProviderInstanceId,
7
+ ProviderDriverKind,
8
+ type ServerProvider,
9
type Project as ProjectRecord,
10
type ModelSelection,
11
type RuntimeMode,
@@ -37,6 +40,8 @@ import { ProjectToolkit } from "./tools.ts";
40
const clientLaunchHarness = (input: {
41
readonly runtimeModeCeiling: RuntimeMode;
42
readonly defaultRuntimeMode?: RuntimeMode;
43
+ readonly fallbackModel?: ModelSelection;
44
+ readonly providers?: readonly ServerProvider[];
45
/** Where Settings saves a project's model; the legacy project field stays null. */
46
readonly overrideModel?: ModelSelection;
47
readonly launched: Array<ThreadLaunch.ThreadLaunchInput>;
@@ -54,7 +59,11 @@ const clientLaunchHarness = (input: {
59
model: input.overrideModel === undefined ? modelSelection : null,
60
};
61
const layerDependencies = Layer.mergeAll(
62
+ Layer.mock(ProviderRegistry.ProviderRegistry)({
63
+ getProviders: Effect.succeed(input.providers ?? []),
64
+ }),
65
ServerSettings.layerTest({
66
+ fallbackModelSelection: input.fallbackModel ?? null,
67
...(input.defaultRuntimeMode === undefined
68
? {}
69
: { defaultRuntimeMode: input.defaultRuntimeMode }),
@@ -473,3 +482,52 @@ it.effect("a retried worktree launch replays after its base ref is gone", () =>
482
]);
483
}),
484
);
485
+
486
+it.effect("a client launches with the fallback for an exhausted default", () =>
487
+ Effect.gen(function* () {
488
+ const launched: ThreadLaunch.ThreadLaunchInput[] = [];
489
+ const fallbackModel = { instanceId: ProviderInstanceId.make("codex"), model: "gpt-6.1-sol" };
490
+ const providers: ServerProvider[] = ["claudeAgent", "codex"].map((driver) => ({
491
+ instanceId: ProviderInstanceId.make(driver),
492
+ driver: ProviderDriverKind.make(driver),
493
+ enabled: true,
494
+ installed: true,
495
+ status: "ready",
496
+ version: null,
497
+ auth: { status: "authenticated" },
498
+ checkedAt: "2026-01-01T00:00:00Z",
499
+ models: [],
500
+ slashCommands: [],
501
+ skills: [],
502
+ ...(driver === "claudeAgent"
503
+ ? {
504
+ usageLimits: {
505
+ checkedAt: "2026-01-01T00:00:00Z",
506
+ windows: [{ id: "session", kind: "session", label: "Session", usedPercent: 100 }],
507
+ },
508
+ }
509
+ : {}),
510
+ }));
511
+ const { projectId, dependencies } = clientLaunchHarness({
512
+ runtimeModeCeiling: "full-access",
513
+ launched,
514
+ fallbackModel,
515
+ providers,
516
+ });
517
+ const toolkit = yield* ProjectToolkit.pipe(
518
+ Effect.provide(
519
+ McpToolAccess.HandlersLayer.layer(ProjectHandlers.layer).pipe(Layer.provide(dependencies)),
520
+ ),
521
+ );
522
+ const result = yield* toolkit
523
+ .handle("t3_thread_launch", {
524
+ projectId,
525
+ title: "Fallback",
526
+ })
527
+ .pipe(Stream.unwrap, Stream.runCollect, Effect.provide(dependencies));
528
+ expect(result.at(-1)?.result).toMatchObject({
529
+ modelSelection: fallbackModel,
530
+ });
531
+ expect(launched[0]?.modelSelection).toEqual(fallbackModel);
532
+ }),
533
+);
apps/server/src/mcp/toolkits/project/handlers.ts
+15
-1
@@ -18,6 +18,9 @@ import * as ManagedProjectFolders from "../../../project/ManagedProjectFolders.t
18
import * as Repositories from "../../../sourceControl/SourceControlRepositoryService.ts";
19
import * as GitVcsDriver from "../../../vcs/GitVcsDriver.ts";
20
import * as ServerSettings from "../../../serverSettings.ts";
21
+import * as ProviderRegistry from "../../../provider/ProviderRegistry.ts";
22
+import * as DateTime from "effect/DateTime";
23
+import { resolveNewThreadModelSelection } from "@t3tools/shared/usageLimits";
24
import { resolveProjectSettings } from "@t3tools/shared/projectSettings";
25
import { resolveRuntimeMode } from "../../delegatedTaskModes.ts";
26
import * as McpInvocationContext from "../../McpInvocationContext.ts";
@@ -180,7 +183,18 @@ export const layer = McpToolAccess.toLayer(ProjectToolkit, {
183
input.modelSelection ??
184
launchedModel ??
185
caller?.modelSelection ??
183
- projectDefaults?.defaultModelSelection ??
186
+ (projectDefaults
187
+ ? resolveNewThreadModelSelection({
188
+ defaultSelection: projectDefaults.defaultModelSelection,
189
+ fallbackSelection: projectDefaults.fallbackModelSelection,
190
+ providers: yield* ProviderRegistry.ProviderRegistry.pipe(
191
+ Effect.flatMap((registry) => registry.getProviders),
192
+ ),
193
+ settings: projectDefaults,
194
+ projectId,
195
+ now: DateTime.toEpochMillis(yield* DateTime.now),
196
+ }).selection
197
+ : null) ??
198
undefined;
199
if (modelSelection === undefined)
200
return yield* new OrchestratorMcpFailure({
apps/server/src/mcp/toolkits/project/tools.ts
+2
@@ -23,6 +23,7 @@ import {
23
import * as FileSystem from "effect/FileSystem";
24
import * as DocumentText from "../../../provider/DocumentText.ts";
25
import * as ServerConfig from "../../../config.ts";
26
+import * as ProviderRegistry from "../../../provider/ProviderRegistry.ts";
27
import * as ServerSettings from "../../../serverSettings.ts";
28
import * as ThreadLaunchService from "../../../orchestration-v2/ThreadLaunchService.ts";
29
import * as Crypto from "effect/Crypto";
@@ -166,6 +167,7 @@ const ThreadLaunchTool = Tool.make("t3_thread_launch", {
167
FileSystem.FileSystem,
168
ServerConfig.ServerConfig,
169
ServerSettings.ServerSettingsService,
170
+ ProviderRegistry.ProviderRegistry,
171
DocumentText.DocumentText,
172
],
173
})
apps/server/src/serverSettings.ts
+1
@@ -435,6 +435,7 @@ const ATOMIC_SETTINGS_KEYS: ReadonlySet<string> = new Set([
435
"sourceControlWriterModelSelection",
436
"reviewGuideModelSelection",
437
"textGenerationModelSelection",
438
+ "fallbackModelSelection",
439
"pullRequestMergeMethod",
440
]);
441
apps/server/src/textGeneration/CodexTextGeneration.test.ts
+103
@@ -1,3 +1,13 @@
1
+import {
2
+ DEFAULT_TEXT_GENERATION_MODEL_BY_PROVIDER,
3
+ ProviderDriverKind,
4
+ type ModelSelection,
5
+ type ServerProvider,
6
+} from "@t3tools/contracts";
7
+import type { ProviderInstance } from "@t3tools/provider-core/server/driver";
8
+import * as ProviderInstanceRegistry from "../provider/ProviderInstanceRegistry.ts";
9
+import * as ServerSettings from "../serverSettings.ts";
10
+import * as SourceControlProviderRegistry from "../sourceControl/SourceControlProviderRegistry.ts";
11
import * as NodeServices from "@effect/platform-node/NodeServices";
12
import { it } from "@effect/vitest";
13
import * as Cause from "effect/Cause";
@@ -433,3 +443,96 @@ it.layer(layerCodexTextGenerationTest)("CodexTextGeneration", (it) => {
443
),
444
);
445
});
446
+
447
+it.effect.each([false, true])("text generation preflight: exhausted=%s", (exhausted) =>
448
+ Effect.gen(function* () {
449
+ const primary = ProviderInstanceId.make("codex");
450
+ const fallback = ProviderInstanceId.make("claude_work");
451
+ const selection = {
452
+ instanceId: primary,
453
+ model: "chat-model",
454
+ options: [{ id: "effort", value: "high" }],
455
+ };
456
+ const calls: ModelSelection[] = [];
457
+ const instances: ProviderInstance[] = [primary, fallback].map((instanceId) => {
458
+ const driver = ProviderDriverKind.make(instanceId === primary ? "codex" : "claudeAgent");
459
+ const snapshot: ServerProvider = {
460
+ instanceId,
461
+ driver,
462
+ enabled: true,
463
+ installed: true,
464
+ status: "ready",
465
+ auth: { status: "authenticated" },
466
+ version: null,
467
+ checkedAt: "1970-01-01T00:00:00Z",
468
+ models: [],
469
+ slashCommands: [],
470
+ skills: [],
471
+ ...(exhausted && instanceId === primary
472
+ ? {
473
+ usageLimits: {
474
+ checkedAt: "1970-01-01T00:00:00Z",
475
+ windows: [{ id: "session", kind: "session", label: "Session", usedPercent: 100 }],
476
+ },
477
+ }
478
+ : {}),
479
+ };
480
+ return {
481
+ instanceId,
482
+ driverKind: driver,
483
+ continuationIdentity: { driverKind: driver, continuationKey: instanceId },
484
+ displayName: undefined,
485
+ enabled: true,
486
+ snapshot: { getSnapshot: Effect.succeed(snapshot) } as ProviderInstance["snapshot"],
487
+ orchestrationAdapter: {} as ProviderInstance["orchestrationAdapter"],
488
+ textGeneration: TextGeneration.TextGeneration.of({
489
+ generateCommitMessage: () => Effect.die("unused"),
490
+ generatePrContent: () => Effect.die("unused"),
491
+ generateBranchName: () => Effect.die("unused"),
492
+ generateReviewGuide: () => Effect.die("unused"),
493
+ generateThreadTitle: (input) =>
494
+ Effect.sync(() => {
495
+ calls.push(input.modelSelection);
496
+ return { title: "Generated title" };
497
+ }),
498
+ }),
499
+ };
500
+ });
501
+ const service = yield* TextGeneration.make.pipe(
502
+ Effect.provide(
503
+ Layer.mergeAll(
504
+ Layer.mock(ProviderInstanceRegistry.ProviderInstanceRegistry)({
505
+ listInstances: Effect.succeed(instances),
506
+ getInstance: (id) =>
507
+ Effect.succeed(instances.find((instance) => instance.instanceId === id)),
508
+ }),
509
+ ServerSettings.layerTest({
510
+ providerInstances: {
511
+ [fallback]: { driver: ProviderDriverKind.make("claudeAgent"), config: {} },
512
+ },
513
+ }),
514
+ Layer.mock(SourceControlProviderRegistry.SourceControlProviderRegistry)({
515
+ resolveLink: () => Effect.die("unused"),
516
+ }),
517
+ ),
518
+ ),
519
+ );
520
+ expect(
521
+ yield* service.generateThreadTitle({
522
+ cwd: "/tmp",
523
+ message: "hello",
524
+ linkedContext: "",
525
+ modelSelection: selection,
526
+ }),
527
+ ).toEqual({ title: "Generated title" });
528
+ expect(calls).toEqual([
529
+ exhausted
530
+ ? {
531
+ instanceId: fallback,
532
+ model:
533
+ DEFAULT_TEXT_GENERATION_MODEL_BY_PROVIDER[ProviderDriverKind.make("claudeAgent")],
534
+ }
535
+ : selection,
536
+ ]);
537
+ }),
538
+);
apps/server/src/textGeneration/TextGeneration.ts
+89
-16
@@ -1,7 +1,19 @@
1
import * as Context from "effect/Context";
2
import * as Effect from "effect/Effect";
3
import * as Layer from "effect/Layer";
4
-import type { ProviderInstanceId } from "@t3tools/contracts";
4
+import type { ModelSelection, ProviderInstanceId } from "@t3tools/contracts";
5
+import {
6
+ isProviderAvailable,
7
+ isProviderTextGenerationCapable,
8
+ resolveProjectProviderInstanceEnabled,
9
+} from "@t3tools/contracts";
10
+import * as DateTime from "effect/DateTime";
11
+import { exhaustedUsageWindow } from "@t3tools/shared/usageLimits";
12
+import {
13
+ defaultTextGenerationModel,
14
+ fallbackTextGenerationModelSelection,
15
+} from "@t3tools/shared/serverSettings";
16
+import * as ServerSettings from "../serverSettings.ts";
17
import type { ProviderTextGeneration } from "@t3tools/provider-core/server/textGeneration";
18
import { TextGenerationError } from "@t3tools/contracts";
19
@@ -52,36 +64,94 @@ const resolveInstance = (
64
),
65
);
66
67
+// Review guides investigate the checkout read-only; the other drivers reject that request.
68
+const INVESTIGATING_DRIVERS = new Set(["codex", "claudeAgent"]);
69
+
70
/** @public */
71
export const make = Effect.gen(function* () {
72
const registry = yield* ProviderInstanceRegistry.ProviderInstanceRegistry;
73
const sourceControl = yield* SourceControlProviderRegistry.SourceControlProviderRegistry;
74
+ const serverSettings = yield* ServerSettings.ServerSettingsService;
75
+ const generate = Effect.fn("TextGeneration.generate")(function* <A>(
76
+ operation: TextGenerationOp,
77
+ selection: ModelSelection,
78
+ invoke: (
79
+ service: ProviderTextGeneration,
80
+ modelSelection: ModelSelection,
81
+ ) => Effect.Effect<A, TextGenerationError>,
82
+ ) {
83
+ const snapshots = yield* registry.listInstances.pipe(
84
+ Effect.flatMap((instances) =>
85
+ Effect.forEach(instances, (instance) => instance.snapshot.getSnapshot),
86
+ ),
87
+ );
88
+ const now = DateTime.toEpochMillis(yield* DateTime.now);
89
+ const limited = exhaustedUsageWindow(
90
+ snapshots.find((provider) => provider.instanceId === selection.instanceId),
91
+ now,
92
+ selection.model,
93
+ );
94
+ if (limited) {
95
+ const settings = yield* serverSettings.getSettings.pipe(
96
+ Effect.mapError(
97
+ (cause) =>
98
+ new TextGenerationError({
99
+ operation,
100
+ detail: "Could not read fallback model settings.",
101
+ cause,
102
+ }),
103
+ ),
104
+ );
105
+ selection =
106
+ fallbackTextGenerationModelSelection(
107
+ settings.providerInstances,
108
+ (instanceId, driver) => {
109
+ const provider = snapshots.find((candidate) => candidate.instanceId === instanceId);
110
+ return (
111
+ instanceId !== selection.instanceId &&
112
+ provider?.enabled === true &&
113
+ resolveProjectProviderInstanceEnabled(settings, null, instanceId) &&
114
+ provider.installed &&
115
+ provider.auth.status !== "unauthenticated" &&
116
+ isProviderAvailable(provider) &&
117
+ isProviderTextGenerationCapable(provider) &&
118
+ (operation !== "generateReviewGuide" || INVESTIGATING_DRIVERS.has(driver)) &&
119
+ !exhaustedUsageWindow(provider, now, defaultTextGenerationModel(driver))
120
+ );
121
+ },
122
+ { includeConfiguredInstances: true },
123
+ ) ?? selection;
124
+ }
125
+ return yield* resolveInstance(registry, operation, selection.instanceId).pipe(
126
+ Effect.flatMap((service) => invoke(service, selection)),
127
+ );
128
+ });
129
return TextGeneration.of({
130
generateCommitMessage: Effect.fn("TextGeneration.generateCommitMessage")(function (input) {
61
- return resolveInstance(
62
- registry,
63
- "generateCommitMessage",
64
- input.modelSelection.instanceId,
65
- ).pipe(Effect.flatMap((textGeneration) => textGeneration.generateCommitMessage(input)));
131
+ return generate("generateCommitMessage", input.modelSelection, (service, modelSelection) =>
132
+ service.generateCommitMessage({ ...input, modelSelection }),
133
+ );
134
}),
135
generatePrContent: Effect.fn("TextGeneration.generatePrContent")(function (input) {
68
- return resolveInstance(registry, "generatePrContent", input.modelSelection.instanceId).pipe(
69
- Effect.flatMap((textGeneration) => textGeneration.generatePrContent(input)),
136
+ return generate("generatePrContent", input.modelSelection, (service, modelSelection) =>
137
+ service.generatePrContent({ ...input, modelSelection }),
138
);
139
}),
140
generateBranchName: Effect.fn("TextGeneration.generateBranchName")(function (input) {
73
- return resolveInstance(registry, "generateBranchName", input.modelSelection.instanceId).pipe(
74
- Effect.flatMap((textGeneration) => textGeneration.generateBranchName(input)),
141
+ return generate("generateBranchName", input.modelSelection, (service, modelSelection) =>
142
+ service.generateBranchName({ ...input, modelSelection }),
143
);
144
}),
145
generateReviewGuide: Effect.fn("TextGeneration.generateReviewGuide")(function (input) {
78
- return resolveInstance(registry, "generateReviewGuide", input.modelSelection.instanceId).pipe(
79
- Effect.flatMap((textGeneration) => textGeneration.generateReviewGuide(input)),
146
+ return generate("generateReviewGuide", input.modelSelection, (service, modelSelection) =>
147
+ service.generateReviewGuide({ ...input, modelSelection }),
148
);
149
}),
150
generateThreadTitle: Effect.fn("TextGeneration.generateThreadTitle")(function (input) {
83
- return resolveInstance(registry, "generateThreadTitle", input.modelSelection.instanceId).pipe(
84
- Effect.flatMap((textGeneration) =>
151
+ return generate(
152
+ "generateThreadTitle",
153
+ input.modelSelection,
154
+ (textGeneration, modelSelection) =>
155
Effect.gen(function* () {
156
const linkedContext =
157
input.linkedContext ??
@@ -91,9 +161,12 @@ export const make = Effect.gen(function* () {
161
sourceControl,
162
),
163
));
94
- return yield* textGeneration.generateThreadTitle({ ...input, linkedContext });
164
+ return yield* textGeneration.generateThreadTitle({
165
+ ...input,
166
+ linkedContext,
167
+ modelSelection,
168
+ });
169
}),
96
- ),
170
);
171
}),
172
});
apps/web/src/components/ChatView.tsx
+91
-7
@@ -1,5 +1,6 @@
1
import { workspaceAreaProps } from "../lib/workspaceFocus";
2
import { sourceControlClients } from "@t3tools/client-runtime/source-control-clients";
3
+import { resolveNewThreadModelSelection } from "@t3tools/shared/usageLimits";
4
import { queuedRunEditBlockedReason } from "@t3tools/client-runtime/queued-run-edit";
5
import { ScrollToEndButton, WorkspaceFileDropOverlay } from "./chat/TimelineOverlays";
6
import { usePasteToFocusComposer } from "./chat/usePasteToFocusComposer";
@@ -189,6 +190,7 @@ import { newMessageId } from "~/lib/utils";
190
import {
191
NO_PROVIDER_MODEL_SELECTION,
192
providerInstanceEntriesFor,
193
+ resolveProjectDefaultProviderModelSelection,
194
shouldShowInstanceBadge,
195
} from "../providerInstances";
196
import {
@@ -305,6 +307,7 @@ import { useProactivePanels } from "../hooks/useProactivePanels";
307
import { useIncrementalTimelineEntries } from "../hooks/useIncrementalTimelineEntries";
308
import { useRightPanelSurfaceClose } from "../hooks/useRightPanelSurfaceClose";
309
import type { ComposerBannerStackItem } from "./chat/ComposerBannerStack";
310
+import { modelFallbackBannerItem } from "./chat/ComposerUsageLimits";
311
import { ComposerSurface } from "./chat/ComposerSurface";
312
import { resolveThreadSyncPhase } from "../threadSync";
313
import {
@@ -400,6 +403,8 @@ type ChatViewProps =
403
draftId: DraftId;
404
};
405
406
+const DismissedFallbackWindowSchema = Schema.NullOr(Schema.String);
407
+
408
export default function ChatView(props: ChatViewProps) {
409
const {
410
environmentId,
@@ -586,6 +591,9 @@ export default function ChatView(props: ChatViewProps) {
591
? (draft.modelSelectionByProvider[draft.activeProvider] ?? null)
592
: null;
593
});
594
+ const composerModelSelectionExplicit = useComposerDraftStore(
595
+ (store) => store.getComposerDraft(composerDraftTarget)?.modelSelectionExplicit === true,
596
+ );
597
const composerHasAttachments = useComposerDraftStore((store) => {
598
const draft = store.getComposerDraft(composerDraftTarget);
599
return (draft?.images.length ?? 0) > 0 || (draft?.files.length ?? 0) > 0;
@@ -751,15 +759,37 @@ export default function ChatView(props: ChatViewProps) {
759
});
760
}
761
}
762
+ const nowMinute = useNowMinute();
763
+ const draftDefaultModelSelection = draftThread
764
+ ? resolveProjectSettings(
765
+ settings,
766
+ fallbackDraftProject?.id ?? null,
767
+ fallbackDraftProject ?? undefined,
768
+ ).settings.defaultModelSelection
769
+ : null;
770
+ const draftModelResolution = draftThread
771
+ ? resolveNewThreadModelSelection({
772
+ defaultSelection:
773
+ draftDefaultModelSelection ??
774
+ resolveProjectDefaultProviderModelSelection(
775
+ providersByEnvironment.get(draftThread.environmentId) ?? [],
776
+ settings,
777
+ draftThread.projectId,
778
+ ),
779
+ fallbackSelection: settings.fallbackModelSelection,
780
+ providers: providersByEnvironment.get(draftThread.environmentId) ?? [],
781
+ settings,
782
+ projectId: draftThread.projectId,
783
+ now: Date.parse(`${nowMinute}:00Z`),
784
+ })
785
+ : null;
786
+ const draftFallback = draftModelResolution?.fallback ? draftModelResolution : null;
787
const localDraftThread = draftThread
788
? buildLocalDraftThread(
789
threadId,
790
draftThread,
758
- resolveProjectSettings(
759
- settings,
760
- fallbackDraftProject?.id ?? null,
761
- fallbackDraftProject ?? undefined,
762
- ).settings.defaultModelSelection ?? NO_PROVIDER_MODEL_SELECTION,
791
+ (draftFallback ? draftFallback.selection : draftDefaultModelSelection) ??
792
+ NO_PROVIDER_MODEL_SELECTION,
793
)
794
: undefined;
795
const isServerThread = serverThread !== null;
@@ -1052,7 +1082,10 @@ export default function ChatView(props: ChatViewProps) {
1082
const activeProjectScripts = activeProject ? resolveProjectScripts(settings, activeProject) : [];
1083
const { projectCloneBannerItem, projectCloneSendBlockReason } =
1084
useProjectCloneBanner(activeProjectRef);
1055
- const activeProjectDefaultModelSelection = activeProjectSettings.settings.defaultModelSelection;
1085
+ const activeProjectDefaultModelSelection =
1086
+ !isServerThread && draftFallback
1087
+ ? draftFallback.selection
1088
+ : activeProjectSettings.settings.defaultModelSelection;
1089
const handleNewThreadInActiveProject = () => {
1090
startNewThreadForProject(activeProjectRef, handleNewThread);
1091
};
@@ -1624,6 +1657,11 @@ export default function ChatView(props: ChatViewProps) {
1657
resumeCompactionPermanentlyDismissed,
1658
setResumeCompactionPermanentlyDismissed,
1659
]);
1660
+ const [dismissedFallbackWindow, setDismissedFallbackWindow] = useLocalStorage(
1661
+ `t3code:fallback-notice-dismissed:${environmentId}`,
1662
+ null,
1663
+ DismissedFallbackWindowSchema,
1664
+ );
1665
const providerStatusBannerKey = getProviderStatusBannerKey(activeProviderStatus);
1666
const [dismissedProviderStatusBannerKey, setDismissedProviderStatusBannerKey] = useState<
1667
string | null
@@ -2308,7 +2346,6 @@ export default function ChatView(props: ChatViewProps) {
2346
closeRightPanelSurface,
2347
});
2348
const pullRequestSurfaceAvailable = supportsPullRequests && pullRequestPanelTarget !== null;
2311
- const nowMinute = useNowMinute();
2349
const {
2350
acknowledgeActiveThreadWoke,
2351
activeBranchMismatchKey,
@@ -2478,12 +2515,58 @@ export default function ChatView(props: ChatViewProps) {
2515
})
2516
: null;
2517
const composerBannerItems = (() => {
2518
+ const fallbackSelection = draftFallback?.selection;
2519
+ const defaultSelection =
2520
+ draftDefaultModelSelection ??
2521
+ resolveProjectDefaultProviderModelSelection(
2522
+ providerStatuses,
2523
+ settings,
2524
+ draftThread?.projectId ?? null,
2525
+ );
2526
+ const fallback =
2527
+ !isServerThread &&
2528
+ multipleModelSelections === null &&
2529
+ !composerModelSelectionExplicit &&
2530
+ draftFallback?.fallback &&
2531
+ (!composerSelectedModelSelection ||
2532
+ (composerSelectedModelSelection.instanceId === fallbackSelection?.instanceId &&
2533
+ composerSelectedModelSelection.model === fallbackSelection?.model))
2534
+ ? draftFallback.fallback
2535
+ : null;
2536
+ const fallbackWindow = fallback
2537
+ ? `${fallback.provider.instanceId}:${fallback.resetsAt ?? ""}`
2538
+ : null;
2539
+ const fallbackItems: ComposerBannerStackItem[] =
2540
+ fallback &&
2541
+ fallbackSelection &&
2542
+ defaultSelection &&
2543
+ fallbackWindow !== dismissedFallbackWindow
2544
+ ? [
2545
+ modelFallbackBannerItem({
2546
+ fallbackModelName:
2547
+ providerStatuses
2548
+ .find((provider) => provider.instanceId === fallbackSelection.instanceId)
2549
+ ?.models.find((model) => model.slug === fallbackSelection.model)?.name ??
2550
+ fallbackSelection.model,
2551
+ defaultProviderName: fallback.provider.displayName ?? fallback.provider.driver,
2552
+ defaultModelName:
2553
+ fallback.provider.models.find((model) => model.slug === defaultSelection.model)
2554
+ ?.name ?? defaultSelection.model,
2555
+ resetsAt: fallback.resetsAt,
2556
+ timestampFormat,
2557
+ onUseDefault: () =>
2558
+ onProviderModelSelectStable(defaultSelection.instanceId, defaultSelection.model),
2559
+ onDismiss: () => setDismissedFallbackWindow(fallbackWindow),
2560
+ }),
2561
+ ]
2562
+ : [];
2563
const limitRecoveryItems = limitRecoveryBanner === null ? [] : [limitRecoveryBanner];
2564
const usageLimitsItems = usageLimitsBanner === null ? [] : [usageLimitsBanner];
2565
const projectCloneItems = projectCloneBannerItem === null ? [] : [projectCloneBannerItem];
2566
if (!localCheckoutBranchMismatch || !showBranchMismatchBanner || !activeBranchMismatchKey) {
2567
return [
2568
...feedbackBannerItems,
2569
+ ...fallbackItems,
2570
...limitRecoveryItems,
2571
...usageLimitsItems,
2572
...projectCloneItems,
@@ -2492,6 +2575,7 @@ export default function ChatView(props: ChatViewProps) {
2575
}
2576
return [
2577
...feedbackBannerItems,
2578
+ ...fallbackItems,
2579
...limitRecoveryItems,
2580
...usageLimitsItems,
2581
...projectCloneItems,
apps/web/src/components/chat/ComposerUsageLimits.tsx
+35
@@ -1,8 +1,10 @@
1
import type { EnvironmentId, UsageLimitsReport } from "@t3tools/contracts";
2
+import type { TimestampFormat } from "@t3tools/contracts/settings";
3
import { limitsNotice } from "@t3tools/shared/usageLimits";
4
import { GaugeIcon } from "lucide-react";
5
6
import { ensureLocalApi } from "../../localApi";
7
+import { formatUpcomingTimestamp } from "../../timestampFormat";
8
import { Button } from "../ui/button";
9
import { providerClients } from "../settings/providerDriverMeta";
10
import { RedactedSensitiveText } from "../settings/RedactedSensitiveText";
@@ -67,6 +69,39 @@ export function usageLimitsBannerItem(
69
};
70
}
71
72
+export function modelFallbackBannerItem({
73
+ fallbackModelName,
74
+ defaultProviderName,
75
+ defaultModelName,
76
+ resetsAt,
77
+ timestampFormat,
78
+ onUseDefault,
79
+ onDismiss,
80
+}: {
81
+ readonly fallbackModelName: string;
82
+ readonly defaultProviderName: string;
83
+ readonly defaultModelName: string;
84
+ readonly resetsAt: string | null;
85
+ readonly timestampFormat: TimestampFormat;
86
+ readonly onUseDefault: () => void;
87
+ readonly onDismiss: () => void;
88
+}): ComposerBannerStackItem {
89
+ return {
90
+ id: "fallback-model",
91
+ variant: "info",
92
+ icon: <GaugeIcon />,
93
+ title: `Using ${fallbackModelName}`,
94
+ description: `${defaultProviderName} is out of usage${resetsAt ? ` · resets ${formatUpcomingTimestamp(resetsAt, timestampFormat)}` : ""}`,
95
+ actions: (
96
+ <Button size="xs" variant="ghost" onClick={onUseDefault}>
97
+ Use {defaultModelName}
98
+ </Button>
99
+ ),
100
+ dismissLabel: "Dismiss fallback model notice",
101
+ onDismiss,
102
+ };
103
+}
104
+
105
function UsageLimitsBannerBody({
106
report,
107
environmentId,
apps/web/src/components/chat/DraftHeroHeadline.tsx
+31
-4
@@ -25,7 +25,11 @@ import {
25
projectGroupsSpanEnvironments,
26
} from "~/sidebarProjectGrouping";
27
import { useProjects, useThreadShells } from "~/state/entities";
28
-import { useEnvironments, usePrimaryEnvironmentId } from "~/state/environments";
28
+import {
29
+ useEnvironments,
30
+ usePrimaryEnvironmentId,
31
+ useEnvironmentProviders,
32
+} from "~/state/environments";
33
import { ProjectEnvironmentBadge } from "../ProjectEnvironmentBadge";
34
import { ProjectFavicon } from "../ProjectFavicon";
35
import { sortLogicalProjectsForSidebar } from "../Sidebar.logic";
@@ -45,6 +49,8 @@ import { DraftProjectName } from "./DraftProjectName";
49
import { DraftHeroProjectHeading } from "./DraftHeroProjectHeading";
50
import { TriageDraftHero } from "./TriageDraftHero";
51
import { resolveProjectSettings } from "@t3tools/shared/projectSettings";
52
+import { resolveProjectDefaultProviderModelSelection } from "../../providerInstances";
53
+import { resolveNewThreadModelSelection } from "@t3tools/shared/usageLimits";
54
55
const ADD_PROJECT_VALUE = "add-project";
56
@@ -67,6 +73,7 @@ export function DraftHeroHeadline({
73
const projects = useProjects();
74
const threads = useThreadShells();
75
const { environments } = useEnvironments();
76
+ const providersByEnvironment = useEnvironmentProviders();
77
const primaryEnvironmentId = usePrimaryEnvironmentId();
78
const projectGroupingSettings = useClientSettings(selectProjectGroupingSettings);
79
const projectSortOrder = useClientSettings((settings) => settings.sidebarProjectSortOrder);
@@ -193,13 +200,33 @@ export function DraftHeroHeadline({
200
);
201
if (!hasExplicitComposerModelSelection(currentDraft)) {
202
applyStickyState(draftId);
196
- const environmentSettings = environments.find(
203
+ const environmentConfig = environments.find(
204
(environment) => environment.environmentId === project.environmentId,
198
- )?.serverConfig?.settings;
199
- const defaultModelSelection = environmentSettings
205
+ )?.serverConfig;
206
+ const environmentSettings = environmentConfig?.settings;
207
+ const defaultSelection = environmentSettings
208
? resolveProjectSettings(environmentSettings, project.id, project).settings
209
.defaultModelSelection
210
: project.defaultModelSelection;
211
+ const fallbackResolution = resolveNewThreadModelSelection({
212
+ defaultSelection:
213
+ defaultSelection ??
214
+ (useComposerDraftStore.getState().stickyActiveProvider !== null || !environmentSettings
215
+ ? null
216
+ : resolveProjectDefaultProviderModelSelection(
217
+ providersByEnvironment.get(project.environmentId) ?? [],
218
+ environmentSettings,
219
+ project.id,
220
+ )),
221
+ fallbackSelection: environmentSettings?.fallbackModelSelection ?? null,
222
+ providers: providersByEnvironment.get(project.environmentId) ?? [],
223
+ ...(environmentSettings ? { settings: environmentSettings } : {}),
224
+ projectId: project.id,
225
+ now: Date.now(),
226
+ });
227
+ const defaultModelSelection = fallbackResolution.fallback
228
+ ? fallbackResolution.selection
229
+ : defaultSelection;
230
if (defaultModelSelection) {
231
setModelSelection(draftId, defaultModelSelection, {
232
replaceOptions: true,
apps/web/src/components/settings/ProjectDefaultsSettings.tsx
+63
@@ -77,6 +77,14 @@ export function ProjectDefaultsSettings({ category }: { category: ProjectSetting
77
);
78
const activeEntry = entries.find((entry) => entry.instanceId === selection?.instanceId);
79
const mixedModel = useScopedSettingsMixed(["defaultModelSelection"]);
80
+ const mixedFallback = useScopedSettingsMixed(["fallbackModelSelection"]);
81
+ const fallbackSelection = settings.fallbackModelSelection ?? selection;
82
+ const fallbackModelOptions = getCustomModelOptionsByInstance(
83
+ settings,
84
+ providers,
85
+ fallbackSelection?.instanceId,
86
+ fallbackSelection?.model,
87
+ );
88
const mixedPermissions = useScopedSettingsMixed(["defaultRuntimeMode"]);
89
const PermissionIcon = runtimeModeConfig[settings.defaultRuntimeMode].icon;
90
const mixedWorkspace = useScopedSettingsMixed(["defaultThreadEnvMode"]);
@@ -216,6 +224,59 @@ export function ProjectDefaultsSettings({ category }: { category: ProjectSetting
224
/>
225
);
226
227
+ const fallbackRow = !isProjectScope ? (
228
+ <SettingsRow
229
+ serverScoped
230
+ settingKeys={["fallbackModelSelection"]}
231
+ mixed={mixedFallback}
232
+ id="fallback-model"
233
+ title="Fallback model"
234
+ description="Used for new threads when the default model's provider is out of usage."
235
+ resetAction={
236
+ mixedFallback || settings.fallbackModelSelection !== null ? (
237
+ <SettingResetButton
238
+ label="fallback model"
239
+ onClick={() => updateSettings({ fallbackModelSelection: null })}
240
+ />
241
+ ) : null
242
+ }
243
+ control={
244
+ fallbackSelection ? (
245
+ <ProviderModelPicker
246
+ environmentId={representative?.environmentId ?? null}
247
+ activeInstanceId={fallbackSelection.instanceId}
248
+ model={fallbackSelection.model}
249
+ lockedProvider={null}
250
+ instanceEntries={entries}
251
+ modelOptionsByInstance={fallbackModelOptions}
252
+ triggerClassName={SETTINGS_PICKER_TRIGGER_CLASSNAME}
253
+ triggerAriaLabel="Fallback model"
254
+ {...(mixedFallback
255
+ ? { triggerLabel: "Mixed" }
256
+ : settings.fallbackModelSelection === null
257
+ ? { triggerLabel: "None" }
258
+ : {})}
259
+ getModelDisabledReason={modelDisabledReason}
260
+ onInstanceModelChange={(instanceId, model) => {
261
+ const reason = modelDisabledReason(instanceId, model);
262
+ if (reason) {
263
+ toastManager.add({
264
+ type: "error",
265
+ title: "Fallback model not saved",
266
+ description: reason,
267
+ });
268
+ return;
269
+ }
270
+ updateSettings({ fallbackModelSelection: createModelSelection(instanceId, model) });
271
+ }}
272
+ />
273
+ ) : (
274
+ <span className="text-sm text-muted-foreground">No providers available</span>
275
+ )
276
+ }
277
+ />
278
+ ) : null;
279
+
280
return (
281
<SettingsSection
282
id={category === "source-control" ? "source-control-defaults" : "project-defaults"}
@@ -224,11 +285,13 @@ export function ProjectDefaultsSettings({ category }: { category: ProjectSetting
285
{category === "project" ? (
286
<>
287
{modelRow}
288
+ {fallbackRow}
289
{workspaceRow}
290
</>
291
) : category === "general" ? (
292
<>
293
{modelRow}
294
+ {fallbackRow}
295
<SettingsRow
296
serverScoped
297
settingKeys={["defaultRuntimeMode"]}
apps/web/src/hooks/useHandleNewThread.test.ts
+1
@@ -200,6 +200,7 @@ vi.mock("../lib/chatThreadActions", async (importOriginal) => ({
200
hasExplicitComposerModelSelection: () => false,
201
resolveNewThreadModelSelectionOverride: () => null,
202
}));
203
+vi.mock("../providerInstances", () => ({ resolveDefaultProviderModelSelection: () => null }));
204
vi.mock("../lib/t3ProjectFileDefaults", () => ({
205
readT3ProjectFile: () => testState.projectFileRead,
206
}));
apps/web/src/hooks/useHandleNewThread.ts
+22
-1
@@ -44,6 +44,8 @@ import { legacyProjectCwdPreferenceKey, useUiStateStore } from "../uiStateStore"
44
import { getClientSettings } from "./useSettings";
45
import { useThreadRouteTarget } from "./useThreadRouteTarget";
46
import { readUnloadedThreadCount } from "../state/olderSettledShelf";
47
+import { resolveProjectDefaultProviderModelSelection } from "../providerInstances";
48
+import { resolveNewThreadModelSelection } from "@t3tools/shared/usageLimits";
49
50
interface NewThreadWorkspaceOptions {
51
branch?: string | null;
@@ -144,7 +146,26 @@ export function createNewThreadHandler(router: AnyRouter) {
146
project?.id ?? null,
147
project,
148
);
147
- const projectDefaultModelSelection = projectSettings.settings.defaultModelSelection;
149
+ const configuredDefaultModelSelection = projectSettings.settings.defaultModelSelection ?? null;
150
+ const fallbackResolution = resolveNewThreadModelSelection({
151
+ defaultSelection:
152
+ configuredDefaultModelSelection ??
153
+ (carryModelSelection || useComposerDraftStore.getState().stickyActiveProvider !== null
154
+ ? null
155
+ : resolveProjectDefaultProviderModelSelection(
156
+ environmentServerConfigs.get(projectRef.environmentId)?.providers ?? [],
157
+ targetServerSettings,
158
+ projectRef.projectId,
159
+ )),
160
+ fallbackSelection: targetServerSettings.fallbackModelSelection ?? null,
161
+ providers: environmentServerConfigs.get(projectRef.environmentId)?.providers ?? [],
162
+ settings: targetServerSettings,
163
+ projectId: projectRef.projectId,
164
+ now: Date.now(),
165
+ });
166
+ const projectDefaultModelSelection = fallbackResolution.fallback
167
+ ? fallbackResolution.selection
168
+ : configuredDefaultModelSelection;
169
const defaultRuntimeMode = projectSettings.settings.defaultRuntimeMode;
170
const resolveModelSelectionOverride = (destinationDraftId: DraftId) =>
171
resolveNewThreadModelSelectionOverride({
apps/web/src/providerInstances.ts
+16
@@ -240,3 +240,19 @@ export function resolveDefaultProviderModelSelection(
240
const model = getDefaultProviderInstanceModel(providers, instanceId);
241
return model ? { instanceId, model } : null;
242
}
243
+
244
+export function resolveProjectDefaultProviderModelSelection(
245
+ providers: ReadonlyArray<ServerProvider>,
246
+ settings: ServerSettings,
247
+ projectId: ProjectId | null,
248
+): ModelSelection | null {
249
+ const entries = providerInstanceEntriesFor(providers, settings, projectId);
250
+ // Matches resolveComposerProviderSelection: the first driver group wins before any other.
251
+ const entry =
252
+ resolveSelectableProviderInstanceEntry(
253
+ entries.filter((candidate) => candidate.driverKind === entries[0]?.driverKind),
254
+ undefined,
255
+ ) ?? resolveSelectableProviderInstanceEntry(entries, undefined);
256
+ const model = entry ? getDefaultProviderInstanceModel(providers, entry.instanceId) : undefined;
257
+ return entry && model ? { instanceId: entry.instanceId, model } : null;
258
+}
packages/contracts/src/settings.ts
+4
@@ -1179,6 +1179,9 @@ export const ServerSettings = Schema.Struct({
1179
defaultModelSelection: Schema.NullOr(ModelSelection).pipe(
1180
Schema.withDecodingDefault(Effect.succeed(null)),
1181
),
1182
+ fallbackModelSelection: Schema.NullOr(ModelSelection).pipe(
1183
+ Schema.withDecodingDefault(Effect.succeed(null)),
1184
+ ),
1185
defaultRuntimeMode: RuntimeMode.pipe(
1186
Schema.withDecodingDefault(Effect.succeed(DEFAULT_RUNTIME_MODE)),
1187
),
@@ -1537,6 +1540,7 @@ export const ServerSettingsPatch = Schema.Struct({
1540
),
1541
defaultModelSelection: Schema.optionalKey(Schema.NullOr(ModelSelection)),
1542
defaultRuntimeMode: Schema.optionalKey(RuntimeMode),
1543
+ fallbackModelSelection: Schema.optionalKey(Schema.NullOr(ModelSelection)),
1544
/** Replaces each project's override set; null removes it. Omitted providerInstances retains its stored value. */
1545
projectSettingsOverrides: Schema.optionalKey(
1546
Schema.Record(
packages/shared/src/serverSettings.test.ts
+18
@@ -24,6 +24,24 @@ import {
24
const FOLDED_SERVER_SETTINGS = { ...DEFAULT_SERVER_SETTINGS, projectSettingsFolded: true };
25
26
describe("fallbackTextGenerationModelSelection", () => {
27
+ it("replaces and clears the fallback without carrying model options", () => {
28
+ const fallbackModelSelection = { instanceId: ProviderInstanceId.make("codex"), model: "new" };
29
+ const settings = applyServerSettingsPatch(
30
+ {
31
+ ...DEFAULT_SERVER_SETTINGS,
32
+ fallbackModelSelection: {
33
+ ...fallbackModelSelection,
34
+ model: "old",
35
+ options: [{ id: "effort", value: "high" }],
36
+ },
37
+ },
38
+ { fallbackModelSelection },
39
+ );
40
+ expect(settings.fallbackModelSelection).toEqual(fallbackModelSelection);
41
+ expect(
42
+ applyServerSettingsPatch(settings, { fallbackModelSelection: null }).fallbackModelSelection,
43
+ ).toBeNull();
44
+ });
45
it("ignores a configured non-default instance at machine scope, matching no fallback", () => {
46
const configured = ProviderInstanceId.make("codex_work");
47
const providerInstances = {
packages/shared/src/serverSettings.ts
+12
-7
@@ -92,13 +92,15 @@ export function fallbackTextGenerationModelSelection(
92
) {
93
return threadDefault;
94
}
95
- return {
96
- instanceId,
97
- model:
98
- DEFAULT_TEXT_GENERATION_MODEL_BY_PROVIDER[driver] ??
99
- DEFAULT_MODEL_BY_PROVIDER[driver] ??
100
- DEFAULT_TEXT_GENERATION_MODEL,
101
- };
95
+ return { instanceId, model: defaultTextGenerationModel(driver) };
96
+}
97
+
98
+export function defaultTextGenerationModel(driver: ProviderDriverKind): string {
99
+ return (
100
+ DEFAULT_TEXT_GENERATION_MODEL_BY_PROVIDER[driver] ??
101
+ DEFAULT_MODEL_BY_PROVIDER[driver] ??
102
+ DEFAULT_TEXT_GENERATION_MODEL
103
+ );
104
}
105
106
export function resolveSourceControlWriterModelSelection(
@@ -538,6 +540,9 @@ export function applyServerSettingsPatch(
540
...(patch.defaultModelSelection !== undefined
541
? { defaultModelSelection: patch.defaultModelSelection }
542
: {}),
543
+ ...(patch.fallbackModelSelection !== undefined
544
+ ? { fallbackModelSelection: patch.fallbackModelSelection }
545
+ : {}),
546
...(patch.defaultProjectScripts !== undefined
547
? { defaultProjectScripts: patch.defaultProjectScripts }
548
: {}),
packages/shared/src/usageLimits.test.ts
+103
@@ -1,4 +1,5 @@
1
import {
2
+ DEFAULT_SERVER_SETTINGS,
3
EnvironmentId,
4
ProviderDriverKind,
5
ProviderInstanceId,
@@ -17,9 +18,11 @@ import {
18
collectLimitNotices,
19
collectLimitPools,
20
elapsedShare,
21
+ exhaustedUsageWindow,
22
paceOf,
23
paceRemainingPercent,
24
usesChatGptSharing,
25
+ resolveNewThreadModelSelection,
26
} from "./usageLimits.ts";
27
28
const now = Date.parse("2026-09-03T12:00:00.000Z");
@@ -50,6 +53,106 @@ function provider(overrides: Partial<ServerProvider>): ServerProvider {
53
};
54
}
55
56
+describe("new thread model fallback", () => {
57
+ const selection = { instanceId: ProviderInstanceId.make("codex"), model: "gpt-6.1-sol" };
58
+ const fallback = { instanceId: ProviderInstanceId.make("claude"), model: "claude-fable-5-1" };
59
+ const limited = provider({
60
+ usageLimits: {
61
+ checkedAt: "2026-09-03T11:00:00.000Z",
62
+ windows: [{ ...window, usedPercent: 100 }],
63
+ },
64
+ });
65
+ const available = provider({
66
+ instanceId: fallback.instanceId,
67
+ driver: ProviderDriverKind.make("claudeAgent"),
68
+ });
69
+
70
+ const defaults = {
71
+ defaultSelection: selection,
72
+ fallbackSelection: fallback,
73
+ providers: [limited, available],
74
+ now,
75
+ };
76
+ it.each([
77
+ ["exhausted default", {}, fallback],
78
+ ["explicit selection", { explicitSelection: selection }, selection],
79
+ ["missing default", { defaultSelection: null }, null],
80
+ ["no fallback", { fallbackSelection: null }, selection],
81
+ ["expired window", { now: Date.parse("2026-09-04T00:00:00Z") }, selection],
82
+ [
83
+ "environment disabled",
84
+ {
85
+ settings: {
86
+ ...DEFAULT_SERVER_SETTINGS,
87
+ providerInstances: {
88
+ [fallback.instanceId]: { driver: available.driver, enabled: false, config: {} },
89
+ },
90
+ },
91
+ },
92
+ selection,
93
+ ],
94
+ ] as const)("resolves %s", (_name, overrides, expected) => {
95
+ expect(resolveNewThreadModelSelection({ ...defaults, ...overrides }).selection).toEqual(
96
+ expected,
97
+ );
98
+ });
99
+ it.each([
100
+ { enabled: false },
101
+ { installed: false },
102
+ { auth: { status: "unauthenticated" as const } },
103
+ { availability: "unavailable" as const },
104
+ { usageLimits: limited.usageLimits },
105
+ ])("rejects an unusable fallback: %j", (overrides) => {
106
+ expect(
107
+ resolveNewThreadModelSelection({
108
+ ...defaults,
109
+ providers: [limited, { ...available, ...overrides }],
110
+ }).selection,
111
+ ).toEqual(selection);
112
+ });
113
+ it.each([undefined, "invalid"])("treats an unknown reset as exhausted: %s", (resetsAt) => {
114
+ expect(
115
+ exhaustedUsageWindow(
116
+ provider({
117
+ usageLimits: {
118
+ checkedAt: limited.checkedAt,
119
+ windows: [{ ...window, usedPercent: 100, resetsAt }],
120
+ },
121
+ }),
122
+ now,
123
+ ),
124
+ ).toBeDefined();
125
+ });
126
+ it.each([
127
+ ["cursor", ["autoPercentUsed"], "claude-opus-5-5", false],
128
+ ["cursor", ["autoPercentUsed"], "composer-2.5", false],
129
+ ["cursor", ["autoPercentUsed", "apiPercentUsed"], "composer-2.5", true],
130
+ ["antigravity", ["gemini-weekly"], "claude-opus-5-5", false],
131
+ ["antigravity", ["3p-weekly"], "claude-opus-5-5", true],
132
+ ["antigravity", ["gemini-weekly"], "antigravity-default", true],
133
+ ["opencode", ["go_weekly"], "opencode/big-pickle", false],
134
+ ["opencode", ["go_weekly"], "opencode-go/big-pickle", true],
135
+ ] as const)("matches %s pools %s to %s", (driver, ids, model, usesFallback) => {
136
+ const defaultSelection = { ...selection, model };
137
+ expect(
138
+ resolveNewThreadModelSelection({
139
+ ...defaults,
140
+ defaultSelection,
141
+ providers: [
142
+ provider({
143
+ driver: ProviderDriverKind.make(driver),
144
+ usageLimits: {
145
+ checkedAt: limited.checkedAt,
146
+ windows: ids.map((id) => ({ ...window, id, usedPercent: 100 })),
147
+ },
148
+ }),
149
+ available,
150
+ ],
151
+ }).selection,
152
+ ).toEqual(usesFallback ? fallback : defaultSelection);
153
+ });
154
+});
155
+
156
describe("pace", () => {
157
it("places the clock three fifths through a five-hour window with two hours left", () => {
158
expect(elapsedShare(window, now)).toBeCloseTo(0.6);
packages/shared/src/usageLimits.ts
+83
@@ -1,5 +1,9 @@
1
import {
2
type EnvironmentId,
3
+ type ModelSelection,
4
+ type ServerSettings,
5
+ type ProjectId,
6
+ resolveProjectProviderInstanceEnabled,
7
type UsageLimitsReport,
8
type ProviderInstanceId,
9
type ProviderConsumeResetCreditInput,
@@ -17,6 +21,85 @@ const MINUTE = 60_000;
21
const HOUR = 60 * MINUTE;
22
const DAY = 24 * HOUR;
23
24
+export function exhaustedUsageWindow(
25
+ provider: ServerProvider | undefined,
26
+ now: number,
27
+ model?: string,
28
+) {
29
+ const exhausted = (provider?.usageLimits?.windows ?? []).filter(
30
+ (window) =>
31
+ (window.usedPercent ?? 0) >= 100 &&
32
+ (!window.resetsAt ||
33
+ !Number.isFinite(Date.parse(window.resetsAt)) ||
34
+ Date.parse(window.resetsAt) > now),
35
+ );
36
+ if (model === undefined) return exhausted[0];
37
+ switch (provider?.driver) {
38
+ case "cursor": {
39
+ const api = exhausted.find((window) => window.id === "apiPercentUsed");
40
+ const auto = exhausted.find((window) => window.id === "autoPercentUsed");
41
+ return /^(auto|default|grok|composer)/.test(model) ? auto && api : api;
42
+ }
43
+ case "antigravity": {
44
+ const family = model.match(/^(gemini|claude|gpt)-/)?.[1];
45
+ return exhausted.find((window) => {
46
+ const pool = window.id.match(/^(gemini|claude|gpt|3p)-/)?.[1];
47
+ return (
48
+ pool === undefined ||
49
+ family === undefined ||
50
+ pool === family ||
51
+ (pool === "3p" && (family === "claude" || family === "gpt"))
52
+ );
53
+ });
54
+ }
55
+ case "opencode":
56
+ return exhausted.find(
57
+ (window) => !window.id.startsWith("go_") || model.startsWith("opencode-go/"),
58
+ );
59
+ default:
60
+ return exhausted[0];
61
+ }
62
+}
63
+
64
+export function resolveNewThreadModelSelection(input: {
65
+ readonly defaultSelection: ModelSelection | null;
66
+ readonly explicitSelection?: ModelSelection | null;
67
+ readonly fallbackSelection: ModelSelection | null;
68
+ readonly providers: readonly ServerProvider[];
69
+ readonly now: number;
70
+ readonly settings?: ServerSettings;
71
+ readonly projectId?: ProjectId | null;
72
+}) {
73
+ const selection = input.explicitSelection ?? input.defaultSelection;
74
+ const unchanged = { selection, fallback: null };
75
+ if (input.explicitSelection || !selection || !input.fallbackSelection) return unchanged;
76
+ const provider = input.providers.find((entry) => entry.instanceId === selection.instanceId);
77
+ const window = exhaustedUsageWindow(provider, input.now, selection.model);
78
+ const fallback = input.providers.find(
79
+ (entry) => entry.instanceId === input.fallbackSelection?.instanceId,
80
+ );
81
+ if (
82
+ !provider ||
83
+ !window ||
84
+ !fallback?.enabled ||
85
+ !fallback.installed ||
86
+ fallback.auth.status === "unauthenticated" ||
87
+ !isProviderAvailable(fallback) ||
88
+ exhaustedUsageWindow(fallback, input.now, input.fallbackSelection.model) ||
89
+ (input.settings &&
90
+ !resolveProjectProviderInstanceEnabled(
91
+ input.settings,
92
+ input.projectId ?? null,
93
+ fallback.instanceId,
94
+ ))
95
+ )
96
+ return unchanged;
97
+ return {
98
+ selection: input.fallbackSelection,
99
+ fallback: { provider, resetsAt: window.resetsAt ?? null },
100
+ };
101
+}
102
+
103
export const CHATGPT_USAGE_URL = "https://chatgpt.com/#settings/Usage";
104
export const CHATGPT_USAGE_LIMIT_CODE = "subscription_sharing_usage_limit_exceeded";
105
/** A ChatGPT Business admin caps plan use in other apps; only the admin can raise it. */