@devries-cameron20 / t3code Mirror · read-only / commits / 861a51a6c4
Fork 0

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. */