@adecore/agents-react 0.21.2 → 0.22.1

package/src/chat/ui/Pickers.tsx

@@ -1,10 +1,15 @@
-import { useEffect, useMemo, useRef, useState, type ReactNode, type RefObject } from 'react';
+import { useContext, useEffect, useMemo, useRef, useState, type ReactNode, type RefObject } from 'react';
 import { useTranslation } from 'react-i18next';
 import { Bookmark, ChevronDown, ChevronRight, Search, Trash2 } from 'lucide-react';
-import type { AgentKind, ModelInfo, ModelSelection, ProviderInfo, UsageProvider } from '@adecore/agent-contracts';
+import type { AgentKind, ModelSelection, ProviderInfo, UsageProvider } from '@adecore/agent-contracts';
 import { AgentIcon } from '../../agents/AgentIcon';
 import { ProviderLogo } from '../../agents/ProviderLogo';
 import { agentChipOf, modelName } from '../../agents/model-name';
+import { modelRequirementOf } from '../../agents/model-requirement';
+import { chatHost } from '../../host';
+import { ChatScopeContext } from '../../scope';
+import { useReportedModels } from '../../state/chats';
+import { pickerEntriesOf, type PickerEntry } from '../logic/picker-entries';
 import { forgetStashed, STASH_SHORTCUT, useStash, type StashedPrompt } from '../stash';
 import { Icon, IconButton, Menu, Popover, Tooltip } from '@adecore/ui';
 
@@ -14,13 +19,6 @@ const triggerClass =
 const chipClass =
     'flex h-6 min-w-0 shrink items-center gap-1.5 whitespace-nowrap rounded-md bg-surface-hover px-2 text-xs text-text hover:bg-surface-active data-[popup-open]:bg-surface-active';
 
-/* A model row, or the one row that folds the legacy models open. Both take a turn in the arrow keys. */
-type PickerEntry = { kind: 'model'; provider: ProviderInfo; model: ModelInfo } | { kind: 'legacy'; count: number };
-
-function matches(model: ModelInfo, query: string): boolean {
-    return model.name.toLowerCase().includes(query) || model.slug.toLowerCase().includes(query);
-}
-
 interface ModelPickerProps {
     /* Whose models may be picked: every installed chat CLI before the first message, the chat's own after it. */
     providers: ProviderInfo[];
@@ -73,18 +71,13 @@ export function ModelPicker({
     const grouped = providers.length > 1;
     const trimmed = query.trim().toLowerCase();
 
-    const entries = useMemo((): PickerEntry[] => {
-        const rows = providers.flatMap((entry) => entry.models.map((model) => ({ kind: 'model' as const, provider: entry, model })));
-        if (trimmed !== '') {
-            return rows.filter((row) => matches(row.model, trimmed));
-        }
-        const live = rows.filter((row) => !row.model.legacy);
-        const legacy = rows.filter((row) => row.model.legacy);
-        if (legacy.length === 0) {
-            return live;
-        }
-        return legacyOpen ? [...live, { kind: 'legacy', count: legacy.length }, ...legacy] : [...live, { kind: 'legacy', count: legacy.length }];
-    }, [providers, trimmed, legacyOpen]);
+    const entries = useMemo(() => pickerEntriesOf(providers, trimmed, legacyOpen), [providers, trimmed, legacyOpen]);
+    const scope = useContext(ChatScopeContext);
+    const machine = chatHost().useMachineLabel(scope?.id ?? '');
+    const reported = useReportedModels(provider);
+    const requirementOf = (entry: PickerEntry & { kind: 'model' }) => modelRequirementOf(entry.model, entry.provider, reported);
+    // A CLI that is too old blocks all its models; one way to its settings under the group says it once.
+    const blockedKinds = new Set(entries.flatMap((entry) => (entry.kind === 'model' && requirementOf(entry) !== null ? [entry.provider.kind] : [])));
 
     /* Closing forgets the search, so the next open (a click or `/model`) starts on the whole list. */
     const setOpen = (next: boolean): void => {
@@ -110,6 +103,9 @@ export function ModelPicker({
             inputRef.current?.focus();
             return;
         }
+        if (requirementOf(entry) !== null) {
+            return;
+        }
         onChange(entry.provider.kind, entry.model.slug);
         setOpen(false);
     };
@@ -184,6 +180,9 @@ export function ModelPicker({
                         }
                         const previous = entries[i - 1];
                         const first = grouped && (previous === undefined || previous.kind !== 'model' || previous.provider.kind !== entry.provider.kind);
+                        const requirement = requirementOf(entry);
+                        const next = entries[i + 1];
+                        const lastOfGroup = next === undefined || next.kind !== 'model' || next.provider.kind !== entry.provider.kind;
                         const chosen = entry.provider.kind === provider && entry.model.slug === selection.model;
                         return (
                             <div key={`${entry.provider.kind}/${entry.model.slug}`}>
@@ -196,21 +195,43 @@ export function ModelPicker({
                                 <button
                                     role="option"
                                     aria-selected={chosen}
+                                    aria-disabled={requirement !== null || undefined}
                                     data-active={i === index}
-                                    className="cursor-row flex w-full items-center gap-2 rounded-md px-2.5 py-1.5 text-left text-sm text-text-muted"
+                                    className={`cursor-row flex w-full flex-col items-stretch gap-0.5 rounded-md px-2.5 py-1.5 text-left text-sm ${requirement === null ? 'text-text-muted' : 'text-text-faint'}`}
                                     onMouseEnter={() => setIndex(i)}
                                     onClick={() => choose(entry)}
                                 >
-                                    <Menu.Check kind="radio" checked={chosen} />
-                                    <span className="min-w-0 truncate">{entry.model.name}</span>
-                                    {entry.model.badge && (
-                                        <span className="rounded bg-accent-soft px-1 text-[11px] leading-5 font-medium uppercase text-accent">
-                                            {entry.model.badge}
+                                    <span className="flex w-full items-center gap-2">
+                                        <Menu.Check kind="radio" checked={chosen} />
+                                        <span className="min-w-0 truncate">{entry.model.name}</span>
+                                        {entry.model.badge && (
+                                            <span className="rounded bg-accent-soft px-1 text-[11px] leading-5 font-medium uppercase text-accent">
+                                                {entry.model.badge}
+                                            </span>
+                                        )}
+                                        <span className="grow" />
+                                        {entry.model.legacy && <span className="text-xs text-text-faint">{t('pickers.model.legacy')}</span>}
+                                    </span>
+                                    {requirement !== null && (
+                                        <span className="pl-6 text-xs text-text-faint">
+                                            {machine === null
+                                                ? t('pickers.model.requiresHere', { cli: requirement.cli, version: requirement.minVersion })
+                                                : t('pickers.model.requires', { cli: requirement.cli, version: requirement.minVersion, machine })}
                                         </span>
                                     )}
-                                    <span className="grow" />
-                                    {entry.model.legacy && <span className="text-xs text-text-faint">{t('pickers.model.legacy')}</span>}
                                 </button>
+                                {lastOfGroup && blockedKinds.has(entry.provider.kind) && (
+                                    <button
+                                        type="button"
+                                        className="cursor-row flex w-full items-center rounded-md px-2.5 py-1.5 text-left text-xs text-text-muted"
+                                        onClick={() => {
+                                            setOpen(false);
+                                            chatHost().openSettings('providers');
+                                        }}
+                                    >
+                                        {t('pickers.model.providerSettings')}
+                                    </button>
+                                )}
                             </div>
                         );
                     })}
@@ -247,7 +268,7 @@ export function StashPicker({ onRestore }: { onRestore(prompt: StashedPrompt): v
                                 className="flex min-w-0 grow flex-col gap-0.5 rounded-md px-2 py-1.5 text-left text-xs text-text-muted hover:bg-surface-hover hover:text-text"
                                 onClick={() => onRestore(prompt)}
                             >
-                                <span className="line-clamp-2 whitespace-pre-wrap">{prompt.text || t('pickers.stash.noText')}</span>
+                                <span className="line-clamp-2 whitespace-pre-wrap">{prompt.text || prompt.quote?.text || t('pickers.stash.noText')}</span>
                                 {prompt.attachments.length > 0 && (
                                     <span className="text-text-faint">{t('pickers.stash.files', { count: prompt.attachments.length })}</span>
                                 )}

package/src/chat/ui/PromptComposer.tsx

@@ -1,6 +1,7 @@
 import { useEffect, useMemo, useRef, type ReactNode } from 'react';
 import { useTranslation } from 'react-i18next';
 import { ArrowDown, Hand, MessageCircleQuestionMark } from 'lucide-react';
+import type { HoldRelease } from '../prompt-hold';
 import { focusPromptHeading, focusPromptStart } from '../../prompts/logic/focus';
 import { orderPrompts, type PendingPrompt } from '../../prompts/logic/prompts';
 import { answerPrompt, isBlockingSubject, promptCreatedAt, promptIdOf, type PromptSubject } from '../../prompts/logic/subjects';
@@ -10,7 +11,14 @@ import { PromptView } from '../../prompts/ui/PromptView';
 import { chatHost } from '../../host';
 import { useChatScope } from '../../scope';
 import { useChatActions } from '../actions';
-import { Icon } from '@adecore/ui';
+import { Button, Icon } from '@adecore/ui';
+
+/* Keeps a prompt card behind the draft while the person types; `released` says what lifted the hold last. */
+export interface PromptHold {
+    held: boolean;
+    releasedBy: HoldRelease | null;
+    release(reason: HoldRelease): void;
+}
 
 /* The one being read stays in front; otherwise blocking before optional, oldest first, as everywhere else. */
 function pickSubject(waiting: readonly PromptSubject[], activeId: string | null): PromptSubject | null {
@@ -26,6 +34,7 @@ export function PromptComposer({
     hasDraft,
     denyReason,
     onAllAnswered,
+    hold,
     children
 }: {
     chatId: string;
@@ -38,6 +47,8 @@ export function PromptComposer({
     denyReason: boolean;
     /* Takes the keyboard back to the composer once the last prompt was answered from its card. */
     onAllAnswered?: () => void;
+    /* Without it a card takes the composer's place at once. */
+    hold?: PromptHold;
     children: ReactNode;
 }) {
     const { t } = useTranslation('agent-chat');
@@ -56,10 +67,23 @@ export function PromptComposer({
     const session = usePromptSession({ prompts: subjects, idOf: promptIdOf, pick: pickSubject, disabled });
     const ref = useRef<HTMLDivElement>(null);
     const { active, activeId: activeKey } = session;
-    const expanded = !!active;
+    const asksApproval = active?.kind === 'chat' ? active.item.kind === 'approval' : active?.prompt.asks === 'approval';
+    const held = !!active && (hold?.held ?? false);
+    const expanded = !!active && !held;
+    // The card that waited behind the draft, so a blur that released it is not mistaken for one released long before.
+    const heldKey = useRef<string | null>(null);
     const refocus = useFocusAfterAnswer(activeKey, ref, () => onAllAnswered?.());
 
     useEffect(() => {
+        if (held) {
+            heldKey.current = activeKey;
+        }
+    }, [held, activeKey]);
+
+    useEffect(() => {
+        if (hold?.releasedBy === 'blur' && heldKey.current === activeKey) {
+            return;
+        }
         if (focused && expanded && !elsewhere && !ref.current?.querySelector('.prompt-card')?.contains(document.activeElement)) {
             // Keys meant for the draft may still be coming, and on a button the next Space would answer the card.
             if (hasDraft) {
@@ -68,7 +92,7 @@ export function PromptComposer({
                 focusPromptStart(ref.current);
             }
         }
-    }, [activeKey, expanded, focused, elsewhere, hasDraft]);
+    }, [activeKey, expanded, focused, elsewhere, hasDraft, hold?.releasedBy]);
 
     return (
         <div ref={ref} onPointerDownCapture={session.onPointerDownCapture} onClickCapture={session.onClickCapture}>
@@ -78,11 +102,7 @@ export function PromptComposer({
                     className="flex w-full items-center gap-2 px-3.5 py-3 text-left text-sm text-text-muted hover:text-text"
                     onClick={onShowElsewhere}
                 >
-                    <Icon
-                        icon={(active.kind === 'chat' ? active.item.kind === 'approval' : active.prompt.asks === 'approval') ? Hand : MessageCircleQuestionMark}
-                        size={16}
-                        className="shrink-0 text-status-needs-you"
-                    />
+                    <Icon icon={asksApproval ? Hand : MessageCircleQuestionMark} size={16} className="shrink-0 text-status-needs-you" />
                     <span className="grow">{t('composer.waitingBelow')}</span>
                     <Icon icon={ArrowDown} size={16} className="shrink-0" />
                 </button>
@@ -113,6 +133,15 @@ export function PromptComposer({
                     />
                 </div>
             )}
+            {held && active && (
+                <div role="status" className="flex items-center gap-2 border-b border-border px-3.5 py-2.5">
+                    <Icon icon={asksApproval ? Hand : MessageCircleQuestionMark} size={16} className="shrink-0 text-status-needs-you" />
+                    <span className="grow text-sm text-text-muted">{t(asksApproval ? 'composer.held.approval' : 'composer.held.question')}</span>
+                    <Button size="sm" onMouseDown={(e) => e.preventDefault()} onClick={() => hold?.release('show')}>
+                        {t('composer.held.show')}
+                    </Button>
+                </div>
+            )}
             <div hidden={expanded}>{children}</div>
         </div>
     );

package/src/chat/ui/QuoteButton.tsx

@@ -10,6 +10,7 @@ const EDGE_PX = 40;
 
 interface Offer {
     quote: string;
+    itemId: string | null;
     x: number;
     y: number;
 }
@@ -52,7 +53,7 @@ export function QuoteButton({
             const zoom = box.offsetWidth > 0 ? bounds.width / box.offsetWidth : 1;
             const x = Math.min(Math.max((line.right - bounds.left) / zoom, EDGE_PX), box.offsetWidth - EDGE_PX);
             const y = (line.bottom - bounds.top) / zoom + GAP_PX;
-            setOffer({ quote, x: Math.round(x), y: Math.round(y) });
+            setOffer({ quote: quote.text, itemId: quote.itemId, x: Math.round(x), y: Math.round(y) });
         };
         const press = (): void => {
             pressed = true;
@@ -91,7 +92,7 @@ export function QuoteButton({
             onMouseDown={(e) => e.preventDefault()}
             onClick={() => {
                 document.getSelection()?.removeAllRanges();
-                taker.current?.(offer.quote);
+                taker.current?.(offer.quote, offer.itemId);
                 setOffer(null);
             }}
         >

package/src/chat/ui/SubagentControls.tsx

@@ -21,31 +21,18 @@ export function SubagentTitleCrumb({ chatId, className, children }: { chatId: st
     );
 }
 
-/*
- * The way down after the chat's title, each step a way back up, and a close that goes straight back
- * to the main agent. A bar that does not draw the title itself passes it, and it opens the way.
- * Nothing while the main agent itself is on screen.
- */
-export function SubagentBreadcrumb({ chatId, title, className }: { chatId: string; title?: string; className?: string }) {
+/* The way down to the sub-agent on screen, each step but the last a way back up. Nothing while the main agent is on screen. */
+export function SubagentBreadcrumb({ chatId, className }: { chatId: string; className?: string }) {
     const { t } = useTranslation('agent-chat');
     const { trail, show } = useSubagentTrail(chatId);
-    const subagents = useOpenableSubagents(chatId);
     if (trail.length === 0) {
         return null;
     }
-    const steps = breadcrumbOf(trail);
-    // Only a row of the chat's own thread can be stopped; a grandchild belongs to the sub-agent that opened it.
-    const shown = trail.length === 1 ? subagents.find((item) => item.toolUseId === trail[0]!.toolUseId) : undefined;
     return (
-        <nav aria-label={t('subagents.title')} className={clsx('flex min-w-0 items-center gap-1 text-xs', className)}>
-            {title !== undefined && (
-                <button type="button" className={clsx(CRUMB_LINK, 'min-w-0 shrink')} onClick={() => show(MAIN_AGENT)}>
-                    {title}
-                </button>
-            )}
-            {steps.map((step) => (
+        <nav aria-label={t('subagents.title')} className={clsx('flex min-w-0 items-center gap-1', className)}>
+            {breadcrumbOf(trail).map((step) => (
                 <Fragment key={step.depth}>
-                    <Icon icon={ChevronRight} size={12} className="shrink-0 text-text-faint" />
+                    {step.depth > 1 && <Icon icon={ChevronRight} size={12} className="shrink-0 text-text-faint" />}
                     {step.current ? (
                         <span aria-current="page" className="min-w-0 truncate text-text">
                             {step.label}
@@ -57,8 +44,24 @@ export function SubagentBreadcrumb({ chatId, title, className }: { chatId: strin
                     )}
                 </Fragment>
             ))}
+        </nav>
+    );
+}
+
+/* Stops the sub-agent on screen where that is on offer, and closes it straight back to the main agent. */
+export function SubagentActions({ chatId }: { chatId: string }) {
+    const { t } = useTranslation('agent-chat');
+    const { trail, show } = useSubagentTrail(chatId);
+    const subagents = useOpenableSubagents(chatId);
+    if (trail.length === 0) {
+        return null;
+    }
+    // Only a row of the chat's own thread can be stopped; a grandchild belongs to the sub-agent that opened it.
+    const shown = trail.length === 1 ? subagents.find((item) => item.toolUseId === trail[0]!.toolUseId) : undefined;
+    return (
+        <div className="flex shrink-0 items-center gap-1">
             {shown !== undefined && <SubagentStopButton chatId={chatId} item={shown} size="sm" />}
             <IconButton icon={X} size="sm" label={t('subagents.backToMain')} onClick={() => show(MAIN_AGENT)} />
-        </nav>
+        </div>
     );
 }

package/src/chat/ui/SubagentInfo.tsx

@@ -1,20 +1,18 @@
-import { Fragment, useState } from 'react';
-import clsx from 'clsx';
+import { Fragment } from 'react';
 import { useTranslation } from 'react-i18next';
-import { ChevronDown } from 'lucide-react';
 import { entryTimeOf, statusWordOf, subagentFacts, taskIdOf } from '../subagent-list';
 import { useSubagentItem } from '../subagent-view';
 import { StatusIcon } from './ChatActivity';
-import { Markdown } from './Markdown';
-import { Icon, useNow } from '@adecore/ui';
+import { SubagentActions, SubagentBreadcrumb } from './SubagentControls';
+import { useNow } from '@adecore/ui';
 import { useModelName } from '../../agents/model-name';
 import { useChatRow } from '../../state/chats';
 import { chatHost } from '../../host';
 import { useChatScope } from '../../scope';
 
 /*
- * What a sub-agent is, over its conversation: its state and time, the model it runs on and what it
- * spent, and the task it was given behind a fold. Nothing for a conversation whose row the thread lost.
+ * What a sub-agent is, over its conversation: the way down to it, its state and time, the model it runs on
+ * and what it spent, and the way out. Only the way down and out for a conversation whose row the thread lost.
  */
 export function SubagentInfo({ chatId, toolUseId }: { chatId: string; toolUseId: string }) {
     const { t } = useTranslation('agent-chat');
@@ -24,43 +22,27 @@ export function SubagentInfo({ chatId, toolUseId }: { chatId: string; toolUseId:
     const task = chatHost().tasks.useTask(id, item === null ? null : taskIdOf(item));
     const modelName = useModelName(provider, item?.model ?? '');
     const now = useNow(1000, item?.status === 'running');
-    const [open, setOpen] = useState(false);
-    if (item === null) {
-        return null;
-    }
-    const word = statusWordOf(item, task);
-    const facts = subagentFacts(item, item.model === undefined ? null : modelName);
+    const word = item === null ? null : statusWordOf(item, task);
+    const facts = item === null ? [] : subagentFacts(item, item.model === undefined ? null : modelName);
     return (
-        <section aria-label={t('subagents.info.label')} className="shrink-0 border-b border-border px-4 py-2">
-            <div className="chat-column-content flex flex-col gap-2">
-                <div className="flex min-w-0 items-center gap-2 text-xs text-text-faint">
-                    <StatusIcon word={word} />
-                    <span className="sr-only">{t(`common.status.${word}`)}</span>
-                    <span className="shrink-0 text-text-muted tabular-nums">{entryTimeOf(item, task, now)}</span>
-                    {facts.map((fact) => (
-                        <Fragment key={fact}>
-                            <span aria-hidden="true">·</span>
-                            <span className="min-w-0 truncate">{fact}</span>
-                        </Fragment>
-                    ))}
-                    <span className="grow" />
-                    {item.prompt && (
-                        <button
-                            type="button"
-                            className="flex shrink-0 items-center gap-1.5 text-text-muted hover:text-text"
-                            aria-expanded={open}
-                            onClick={() => setOpen((current) => !current)}
-                        >
-                            <Icon icon={ChevronDown} size={12} className={clsx('transition-transform', open && 'rotate-180')} />
-                            {open ? t('subagents.info.hideTask') : t('subagents.info.showTask')}
-                        </button>
-                    )}
-                </div>
-                {open && item.prompt && (
-                    <div className="max-h-60 overflow-auto rounded-md border border-border bg-surface-raised px-3 py-2 text-xs select-text">
-                        <Markdown text={item.prompt} />
-                    </div>
+        <section aria-label={t('subagents.info.label')} className="shrink-0 border-b border-border px-4 py-1.5">
+            <div className="flex min-w-0 items-center gap-2 text-xs text-text-faint">
+                <SubagentBreadcrumb chatId={chatId} className="max-w-1/3 shrink-0 font-medium" />
+                {item !== null && word !== null && (
+                    <>
+                        <StatusIcon word={word} />
+                        <span className="sr-only">{t(`common.status.${word}`)}</span>
+                        <span className="shrink-0 text-text-muted tabular-nums">{entryTimeOf(item, task, now)}</span>
+                    </>
                 )}
+                {facts.map((fact) => (
+                    <Fragment key={fact}>
+                        <span aria-hidden="true">·</span>
+                        <span className="min-w-0 truncate">{fact}</span>
+                    </Fragment>
+                ))}
+                <span className="grow" />
+                <SubagentActions chatId={chatId} />
             </div>
         </section>
     );

package/src/chat/ui/SubagentStopButton.tsx

@@ -30,7 +30,8 @@ export function SubagentStopButton({
     }
     const send = (): void => {
         void actions.stopSubagent(chatId, item.toolUseId).catch((e: unknown) => {
-            const description = e instanceof Error ? e.message : t('subagents.noAnswer');
+            const stale = e instanceof Error && 'code' in e && e.code === 'subagent-stale';
+            const description = stale ? t('subagents.stale') : e instanceof Error ? e.message : t('subagents.noAnswer');
             chatHost().notify({ kind: 'error', title: t('subagents.stopFailed'), description });
         });
     };

package/src/chat/ui/Timeline.tsx

@@ -16,6 +16,7 @@ import {
     registerTurnJumper,
     setTimelineAtEnd,
     wantsEarlier,
+    type ItemJumpOptions,
     type ReadingAnchor,
     type TurnTarget
 } from '../timeline-scroll';
@@ -66,6 +67,8 @@ import { useModelName } from '../../agents/model-name';
 import { ContextMenu, EmptyState, ErrorBoundary, Icon, SectionLabel } from '@adecore/ui';
 
 const ESTIMATED_ROW_PX = 56;
+// How long a jump waits for a thread that is still loading before it calls the item missing.
+const JUMP_THREAD_WAIT_MS = 8000;
 
 /* A jump puts its row at the top and stops following the end, so the reader stays where they landed. */
 function showRowAtTop(virtualizer: Virtualizer<HTMLDivElement, Element>, followRef: RefObject<boolean>, index: number): void {
@@ -222,7 +225,7 @@ export function Timeline({ chatId, composer, overlay }: { chatId: string; compos
     const marks = useMemo(() => bookmarkRows(rows, bookmarks ?? [], items ?? {}), [rows, bookmarks, items]);
     const ticks = useMemo(() => ticksOf(rows, marks), [rows, marks]);
     // A message a jump is on its way to; it may first have to open the turn its reply folded into.
-    const [seeking, setSeeking] = useState<{ itemId: string; block?: UiReplyTarget; key: string } | null>(null);
+    const [seeking, setSeeking] = useState<{ itemId: string; block?: UiReplyTarget; key: string; options?: ItemJumpOptions } | null>(null);
     const [landing, setLanding] = useState<{ target: UiReplyTarget; key: string } | null>(null);
     // A turn a jump is on its way to, which waits for the page its messages are on to come in.
     const [revealing, setRevealing] = useState<{ turnId: string; target: TurnTarget } | null>(null);
@@ -451,9 +454,16 @@ export function Timeline({ chatId, composer, overlay }: { chatId: string; compos
         if (index !== -1) {
             setSeeking(null);
             showRowAtTop(virtualizer, followRef, index);
+            if (seeking.options?.flash) {
+                useTimelineFlash.getState().flash(seeking.key, seeking.itemId, false);
+            }
+            return;
+        }
+        // The thread has not loaded yet, so nothing says the item is missing; the effect below bounds the wait.
+        if (items === undefined) {
             return;
         }
-        const item = items?.[seeking.itemId];
+        const item = items[seeking.itemId];
         if (item === undefined && cursor !== null) {
             loadEarlier();
             return;
@@ -464,12 +474,24 @@ export function Timeline({ chatId, composer, overlay }: { chatId: string; compos
             return;
         }
         setSeeking(null);
+        seeking.options?.onMissing?.();
     }, [seeking, rows, items, turns, virtualizer, cursor, loadEarlier, keyOf, chatId]);
+    const waitingForThread = seeking !== null && items === undefined;
+    useEffect(() => {
+        if (!waitingForThread) {
+            return;
+        }
+        const timer = window.setTimeout(() => {
+            setSeeking(null);
+            seeking?.options?.onMissing?.();
+        }, JUMP_THREAD_WAIT_MS);
+        return () => window.clearTimeout(timer);
+    }, [waitingForThread, seeking]);
     useEffect(
         () =>
-            registerItemJumper(keyOf(chatId), (itemId) => {
+            registerItemJumper(keyOf(chatId), (itemId, options) => {
                 setLanding(null);
-                setSeeking({ itemId, key: keyOf(chatId) });
+                setSeeking({ itemId, key: keyOf(chatId), options });
             }),
         [keyOf, chatId]
     );

package/src/chat/ui/composer/menu-aria.ts

@@ -0,0 +1,29 @@
+export interface ComposerMenuAriaInput {
+    label: string;
+    listId: string;
+    open: boolean;
+    /* Counts across every group of the menu, the way the keyboard moves through it. */
+    activeIndex: number;
+    count: number;
+}
+
+/* The index that still points at an option once the list has shrunk under a stale one. */
+export function clampMenuIndex(index: number, count: number): number {
+    return Math.min(index, Math.max(count - 1, 0));
+}
+
+export function optionIdOf(listId: string, index: number): string {
+    return `${listId}-${index}`;
+}
+
+/*
+ * The attributes the editor's content element takes while a suggestion menu stands beside it. The
+ * element keeps its `textbox` role; ARIA 1.2 lets it name the option the arrow keys are on.
+ */
+export function composerMenuAria({ label, listId, open, activeIndex, count }: ComposerMenuAriaInput): Record<string, string> {
+    return {
+        'aria-label': label,
+        'aria-autocomplete': 'list',
+        ...(open && count > 0 ? { 'aria-controls': listId, 'aria-activedescendant': optionIdOf(listId, activeIndex) } : {})
+    };
+}

package/src/chat/ui/intelligent-ui/UiBlockFrame.tsx

@@ -2,14 +2,14 @@ import { useId, useLayoutEffect, useRef, useState, type ReactNode, type RefObjec
 import clsx from 'clsx';
 import { useTranslation } from 'react-i18next';
 import type { UiViewNode } from '@adecore/intelligent-ui';
-import { Lock, Radio, TriangleAlert, Wrench } from 'lucide-react';
+import { Info, Lock, Radio, TriangleAlert } from 'lucide-react';
 import { Icon, Skeleton, Spinner, Tooltip, useTickingText } from '@adecore/ui';
 import { formatAgo, formatMoment } from '@adecore/ui/format';
 import { uiBlockHead, uiReasonText } from './node-text';
 import { UiHeadContext, type UiLiveStatus } from './render-context';
 import { useLater } from './use-later';
 
-/* Something the compiler repaired, such as a prop it dropped; never an error to a person. */
+/* Something the compiler noted about a block: a prop it dropped, or a part it could only draw as text. */
 export interface UiBlockFix {
     code: string;
     message: string;
@@ -82,7 +82,7 @@ function LivePart({ live }: { live: UiLiveStatus }) {
 }
 
 /*
- * The line under a block, only when it has something to say: live, answered, repaired or drawn as
+ * The line under a block, only when it has something to say: live, answered, noted or drawn as
  * text, in that order. A hairline of the soft border runs the full width of the card over it.
  */
 function UiBlockFooter({ live = null, answered = null, fixes = NO_FIXES, shownAsText = null }: UiBlockFooterProps) {
@@ -111,8 +111,8 @@ function UiBlockFooter({ live = null, answered = null, fixes = NO_FIXES, shownAs
                         className="flex items-center gap-1.5 rounded-sm hover:text-text-muted"
                         onClick={() => setFixesOpen(!fixesOpen)}
                     >
-                        <Icon icon={Wrench} size={12} />
-                        {t('blocks.fixes', { count: fixes.length })}
+                        <Icon icon={Info} size={12} />
+                        {t('blocks.notes', { count: fixes.length })}
                     </button>
                 )}
                 {shownAsText !== null && (

package/src/chat/ui/intelligent-ui/UiFallbackPart.tsx

@@ -15,7 +15,12 @@ export function UiFallbackPart({ fallback, problem }: { fallback: string; proble
             <span className="text-xs text-text-faint">
                 {problem.kind === 'unknown' ? t('blocks.unknownComponent', { component: problem.component }) : t('blocks.renderFailed')}
             </span>
-            {fallback !== '' && <Markdown text={fallback} fileLinks={false} />}
+            {fallback !== '' && (
+                // A fallback is often data without a space in it, such as the JSON of a chart.
+                <div className="min-w-0 wrap-anywhere">
+                    <Markdown text={fallback} fileLinks={false} />
+                </div>
+            )}
         </div>
     );
 }