Skip to content

Commit 44d0dbc

Browse files
fix(clients): skill menus show loading while project skills arrive
A slash or skill query typed right after opening a thread could run before the folder's project skills loaded. The menu said "No matching command." and a typed /skill stayed plain text, while the same skill picked a moment later became a badge. Composer menus now show their existing loading text while a workspace scan is in flight for a folder without a complete snapshot. The state clears when the snapshot arrives, when the scan fails, and after the retry limit. Co-Authored-By: Claude Opus 5.5 <[email protected]>
1 parent 15fe283 commit 44d0dbc

7 files changed

Lines changed: 96 additions & 22 deletions

File tree

‎apps/mobile/src/features/threads/use-composer-command-menu.ts‎

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -47,10 +47,12 @@ import {
4747
getProviderSkillsForSlashMenu,
4848
getProviderSlashCommandsForSlashMenu,
4949
isProviderSkillUserInvocable,
50+
isProviderWorkspaceSnapshotScanning,
51+
type ProviderWorkspaceSnapshotRefreshState,
5052
resolveProviderSkillsForCwd,
5153
resolveProviderSlashCommandsForCwd,
5254
} from "@t3tools/client-runtime/providerSkills";
53-
import { useAtomRefresh } from "@effect/atom-react";
55+
import { useAtomRefresh, useAtomValue } from "@effect/atom-react";
5456
import { Atom } from "effect/reactivity";
5557
import { useEffect, useState } from "react";
5658

@@ -69,7 +71,9 @@ const providerWorkspaceSnapshotRefresh = createProviderWorkspaceSnapshotRefreshA
6971
refreshProviders: serverEnvironment.refreshProviders,
7072
});
7173

72-
const idleWorkspaceSnapshotRefreshAtom: Atom.Atom<unknown> = Atom.make<void>(undefined).pipe(
74+
const idleWorkspaceSnapshotRefreshAtom: Atom.Atom<
75+
ProviderWorkspaceSnapshotRefreshState | undefined
76+
> = Atom.make<ProviderWorkspaceSnapshotRefreshState | undefined>(undefined).pipe(
7377
Atom.withLabel("mobile:provider-workspace-snapshot-refresh:idle"),
7478
);
7579

@@ -267,14 +271,17 @@ export function useComposerCommandMenu({
267271
? resolveProviderSkillsForCwd(selectedProviderStatus, projectCwd)
268272
: [];
269273
const selectedProviderInstanceId = selectedProviderStatus?.instanceId;
270-
const refreshWorkspaceSnapshot = useAtomRefresh(
274+
const workspaceSnapshotRefreshAtom =
271275
environmentId && projectCwd && selectedProviderInstanceId
272276
? providerWorkspaceSnapshotRefresh({
273277
environmentId,
274278
instanceId: selectedProviderInstanceId,
275279
cwd: projectCwd,
276280
})
277-
: idleWorkspaceSnapshotRefreshAtom,
281+
: idleWorkspaceSnapshotRefreshAtom;
282+
const refreshWorkspaceSnapshot = useAtomRefresh(workspaceSnapshotRefreshAtom);
283+
const workspaceSkillsScanning = isProviderWorkspaceSnapshotScanning(
284+
useAtomValue(workspaceSnapshotRefreshAtom),
278285
);
279286
// Every draft change rechecks a stale snapshot, including drafts written by
280287
// another surface (a prompt link) that never move the editor selection.
@@ -616,7 +623,11 @@ export function useComposerCommandMenu({
616623
items,
617624
skills,
618625
isLoading:
619-
trigger?.kind === "pull-request" ? pullRequestSearch.isPending : pathSearch.isPending,
626+
trigger?.kind === "pull-request"
627+
? pullRequestSearch.isPending
628+
: trigger?.kind === "skill" || trigger?.kind === "slash-command"
629+
? workspaceSkillsScanning
630+
: pathSearch.isPending,
620631
error:
621632
trigger?.kind === "pull-request"
622633
? pullRequestProjectId === null || pullRequestRepository === null

‎apps/web/src/components/chat/ChatComposer.tsx‎

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -934,11 +934,12 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
934934
const selectedProviderSlashCommands = selectedProviderStatus
935935
? resolveProviderSlashCommandsForCwd(selectedProviderStatus, gitCwd)
936936
: NO_PROVIDER_SLASH_COMMANDS;
937-
const refreshWorkspaceSnapshotOnTyping = useProviderWorkspaceSnapshotRefresh({
938-
environmentId,
939-
gitCwd,
940-
instanceId: selectedProviderEntry?.instanceId,
941-
});
937+
const { refresh: refreshWorkspaceSnapshotOnTyping, scanning: workspaceSkillsScanning } =
938+
useProviderWorkspaceSnapshotRefresh({
939+
environmentId,
940+
gitCwd,
941+
instanceId: selectedProviderEntry?.instanceId,
942+
});
942943

943944
const selectedPromptEffort = composerProviderState.promptEffort;
944945
const selectedModelOptionsForDispatch = composerProviderState.modelOptionsForDispatch;
@@ -1139,6 +1140,7 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
11391140
selectedProviderSkills,
11401141
selectedProviderSlashCommands,
11411142
showSkillsInSlashMenu: settings.showSkillsInSlashMenu,
1143+
workspaceSkillsScanning,
11421144
questionAttachmentTarget,
11431145
});
11441146

@@ -3289,7 +3291,9 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
32893291
? isComposerMenuLoading
32903292
? composerTriggerKind === "pull-request"
32913293
? "Finding pull request..."
3292-
: "Searching workspace files..."
3294+
: composerTriggerKind === "skill" || composerTriggerKind === "slash-command"
3295+
? "Searching workspace skills..."
3296+
: "Searching workspace files..."
32933297
: composerMenuEmptyState
32943298
: ""}
32953299
</div>

‎apps/web/src/components/chat/ComposerCommandMenu.tsx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -152,7 +152,7 @@ export const ComposerCommandMenu = memo(function ComposerCommandMenu(props: {
152152
<div className="px-5 pt-3.5 pb-7">
153153
<p className="text-secondary-label text-xs">
154154
{props.isLoading
155-
? props.triggerKind === "skill"
155+
? props.triggerKind === "skill" || props.triggerKind === "slash-command"
156156
? "Searching workspace skills..."
157157
: props.triggerKind === "pull-request"
158158
? "Finding pull request..."

‎apps/web/src/components/chat/useComposerMenuItems.ts‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,7 @@ export function useComposerMenuItems({
7171
selectedProviderSkills,
7272
selectedProviderSlashCommands,
7373
showSkillsInSlashMenu,
74+
workspaceSkillsScanning,
7475
questionAttachmentTarget,
7576
}: {
7677
readonly composerTrigger: ComposerTrigger | null;
@@ -89,6 +90,7 @@ export function useComposerMenuItems({
8990
readonly selectedProviderSkills: ServerProvider["skills"];
9091
readonly selectedProviderSlashCommands: ServerProvider["slashCommands"];
9192
readonly showSkillsInSlashMenu: boolean;
93+
readonly workspaceSkillsScanning: boolean;
9294
readonly questionAttachmentTarget: DraftId | null;
9395
}) {
9496
// Thread mentions rank by recency as of when the composer mounted.
@@ -373,6 +375,9 @@ export function useComposerMenuItems({
373375
})();
374376
const isLoading =
375377
(composerTriggerKind === "path" && pathTriggerQuery.length > 0 && workspaceEntries.isPending) ||
378+
((composerTriggerKind === "skill" ||
379+
(composerTriggerKind === "slash-command" && showSkillsInSlashMenu)) &&
380+
workspaceSkillsScanning) ||
376381
(composerTriggerKind === "pull-request" &&
377382
pullRequestProjectId !== null &&
378383
pullRequestRepository !== null &&
Lines changed: 16 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,10 @@
1-
import { useAtomRefresh } from "@effect/atom-react";
1+
import { useAtomRefresh, useAtomValue } from "@effect/atom-react";
22
import { type EnvironmentId, type ProviderInstanceId } from "@t3tools/contracts";
3-
import { createProviderWorkspaceSnapshotRefreshAtomFamily } from "@t3tools/client-runtime/providerSkills";
3+
import {
4+
createProviderWorkspaceSnapshotRefreshAtomFamily,
5+
isProviderWorkspaceSnapshotScanning,
6+
type ProviderWorkspaceSnapshotRefreshState,
7+
} from "@t3tools/client-runtime/providerSkills";
48
import { Atom } from "effect/reactivity";
59

610
import { serverEnvironment } from "../../state/server";
@@ -10,23 +14,27 @@ const providerWorkspaceSnapshotRefresh = createProviderWorkspaceSnapshotRefreshA
1014
refreshProviders: serverEnvironment.refreshProviders,
1115
});
1216

13-
const idleRefreshAtom: Atom.Atom<unknown> = Atom.make<void>(undefined).pipe(
14-
Atom.withLabel("provider-workspace-snapshot-refresh:idle"),
15-
);
17+
const idleRefreshAtom: Atom.Atom<ProviderWorkspaceSnapshotRefreshState | undefined> = Atom.make<
18+
ProviderWorkspaceSnapshotRefreshState | undefined
19+
>(undefined).pipe(Atom.withLabel("provider-workspace-snapshot-refresh:idle"));
1620

1721
/**
1822
* Keeps the selected provider's workspace snapshot fresh for the composer's
19-
* cwd while mounted. Returns a check to run when the user types.
23+
* cwd while mounted. Returns a check to run when the user types, and whether
24+
* the cwd's skills are still being scanned.
2025
*/
2126
export function useProviderWorkspaceSnapshotRefresh(input: {
2227
readonly environmentId: EnvironmentId;
2328
readonly gitCwd: string | null;
2429
readonly instanceId: ProviderInstanceId | undefined;
25-
}): () => void {
30+
}): { readonly refresh: () => void; readonly scanning: boolean } {
2631
const { environmentId, gitCwd, instanceId } = input;
2732
const atom =
2833
gitCwd && instanceId
2934
? providerWorkspaceSnapshotRefresh({ environmentId, instanceId, cwd: gitCwd })
3035
: idleRefreshAtom;
31-
return useAtomRefresh(atom);
36+
return {
37+
refresh: useAtomRefresh(atom),
38+
scanning: isProviderWorkspaceSnapshotScanning(useAtomValue(atom)),
39+
};
3240
}

‎packages/client-runtime/src/providerSkills.test.ts‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ import {
1212
createProviderWorkspaceSnapshotRefreshAtomFamily,
1313
getProviderSkillsForSlashMenu,
1414
hasCompleteProviderWorkspaceSnapshot,
15+
isProviderWorkspaceSnapshotScanning,
1516
resolveProviderSkillsForCwd,
1617
resolveProviderSlashCommandsForCwd,
1718
} from "./providerSkills.ts";
@@ -298,6 +299,33 @@ describe("provider workspace snapshot refresh atom", () => {
298299
unmount();
299300
});
300301

302+
it("reports skills loading while a missing snapshot is scanned, until it arrives", async () => {
303+
vi.useFakeTimers({ now: Date.parse("2026-01-01T00:00:00.000Z") });
304+
const scanned = withSnapshot("2026-01-01T00:00:00.000Z");
305+
const { registry, atom, providersAtom, unmount } = setup(noSnapshot, [() => scanned]);
306+
expect(isProviderWorkspaceSnapshotScanning(registry.get(atom))).toBe(true);
307+
registry.set(providersAtom, scanned);
308+
await vi.advanceTimersByTimeAsync(0);
309+
expect(isProviderWorkspaceSnapshotScanning(registry.get(atom))).toBe(false);
310+
unmount();
311+
});
312+
313+
it("stops reporting skills loading when the scan fails", async () => {
314+
vi.useFakeTimers({ now: Date.parse("2026-01-01T00:00:00.000Z") });
315+
const { registry, atom, unmount } = setup(noSnapshot);
316+
expect(isProviderWorkspaceSnapshotScanning(registry.get(atom))).toBe(true);
317+
await vi.advanceTimersByTimeAsync(0);
318+
expect(isProviderWorkspaceSnapshotScanning(registry.get(atom))).toBe(false);
319+
unmount();
320+
});
321+
322+
it("does not report skills loading for a current snapshot", () => {
323+
vi.useFakeTimers({ now: Date.parse("2026-01-01T00:01:00.000Z") });
324+
const { registry, atom, unmount } = setup(withSnapshot("2026-01-01T00:00:00.000Z"));
325+
expect(isProviderWorkspaceSnapshotScanning(registry.get(atom))).toBe(false);
326+
unmount();
327+
});
328+
301329
it("does not retry on a timer when the failed scan left no pending snapshot", async () => {
302330
vi.useFakeTimers({ now: Date.parse("2026-01-01T00:00:00.000Z") });
303331
const { registry, atom, run, unmount } = setup(noSnapshot);

‎packages/client-runtime/src/providerSkills.ts‎

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -136,7 +136,7 @@ const WORKSPACE_SNAPSHOT_RETRY_COOLDOWN_MS = 10_000;
136136
// A cwd that never scans, such as a deleted worktree, would otherwise retry forever.
137137
const WORKSPACE_SNAPSHOT_MAX_ATTEMPTS = 3;
138138

139-
interface ProviderWorkspaceSnapshotRefreshState {
139+
export interface ProviderWorkspaceSnapshotRefreshState {
140140
/**
141141
* When the last scan was requested. A request inside the TTL is not
142142
* repeated, so a client clock ahead of the server's cannot loop rescans.
@@ -223,6 +223,22 @@ function failProviderWorkspaceSnapshotRefresh(
223223
};
224224
}
225225

226+
/**
227+
* A scan is in flight for a cwd without a complete snapshot, so its project
228+
* skills may still arrive. A failed scan clears `requestedAt` (or exhausts its
229+
* attempts), so this never stays true for a scan that is not running.
230+
*/
231+
export function isProviderWorkspaceSnapshotScanning(
232+
state: ProviderWorkspaceSnapshotRefreshState | undefined,
233+
): boolean {
234+
return (
235+
state !== undefined &&
236+
state.requestedAt !== null &&
237+
!state.hadSnapshot &&
238+
state.failedAttempts < WORKSPACE_SNAPSHOT_MAX_ATTEMPTS
239+
);
240+
}
241+
226242
type WorkspaceSnapshotStatus = "absent" | "pending" | "complete";
227243

228244
function resolveWorkspaceSnapshotStatus(
@@ -330,6 +346,8 @@ export function createProviderWorkspaceSnapshotRefreshAtomFamily(input: {
330346
).pipe(Atom.withLabel(`provider-workspace-snapshot-refresh:${key}`));
331347
return refreshAtom;
332348
});
333-
return (target: ProviderWorkspaceSnapshotRefreshTarget): Atom.Atom<unknown> =>
349+
return (
350+
target: ProviderWorkspaceSnapshotRefreshTarget,
351+
): Atom.Atom<ProviderWorkspaceSnapshotRefreshState> =>
334352
family({ environmentId: target.environmentId, instanceId: target.instanceId, cwd: target.cwd });
335353
}

0 commit comments

Comments
 (0)