ai/prompt-queue.tsx
GitHub'use client';
import * as React from 'react';
import {Icon, ArrowDown, ArrowUp, Edit, Close} from '../icon';
import {Button} from '../ui/button';
import {Input} from '../ui/input';
import {Status} from '../ui/status';
import {cn, mergeRefs} from '../lib/utils';
import {isComposing} from './prompt-input/codec';
type QueuedMessage = {
id: string;
text: string;
status?: 'queued' | 'sending' | 'failed';
error?: string;
};
type PromptQueueLabels = {
summary?: (count: number, halted: boolean) => string;
queued?: string;
sending?: string;
failed?: string;
retry?: string;
sendNow?: string;
edit?: (text: string) => string;
editField?: string;
save?: string;
cancel?: string;
moveUp?: string;
moveDown?: string;
remove?: string;
notSent?: string;
held?: string;
};
const queueLabels: Required<PromptQueueLabels> = {
summary: (count, halted) => `${count} queued, ${halted ? 'held because the first one failed' : 'sent in order when the agent finishes'}`,
queued: 'Queued',
sending: 'Sending',
failed: 'Failed',
retry: 'Retry',
sendNow: 'Send now',
edit: text => `Edit "${text.slice(0, 40)}"`,
editField: 'Edit queued message',
save: 'Save',
cancel: 'Cancel',
moveUp: 'Move up',
moveDown: 'Move down',
remove: 'Remove from queue',
notSent: 'Not sent.',
held: 'The queue waits until you retry, edit or remove it.',
};
type PromptQueueProps = Omit<React.ComponentProps<'div'>, 'children'> & {
items: QueuedMessage[];
onEdit?: (id: string, text: string) => void;
onSendNow?: (id: string) => void;
onRemove?: (id: string) => void;
onRetry?: (id: string) => void;
onMove?: (id: string, index: number) => void;
editingId?: string | null;
onEditingChange?: (id: string | null) => void;
returnFocus?: () => void;
labels?: PromptQueueLabels;
};
function QueueRow({item, index, count, editing, setEditing, onEdit, onSendNow, onRemove, onRetry, onMove, words}: {
item: QueuedMessage;
index: number;
count: number;
editing: boolean;
setEditing: (on: boolean) => void;
words: Required<PromptQueueLabels>;
} & Pick<PromptQueueProps, 'onEdit' | 'onSendNow' | 'onRemove' | 'onRetry' | 'onMove'>) {
const [draft, setDraft] = React.useState(item.text);
const inputRef = React.useRef<HTMLInputElement>(null);
const editRef = React.useRef<HTMLButtonElement>(null);
const wasEditing = React.useRef(editing);
React.useEffect(() => { if (editing) { setDraft(item.text); requestAnimationFrame(() => inputRef.current?.select()); } }, [editing, item.text]);
React.useLayoutEffect(() => {
const active = document.activeElement;
if (wasEditing.current && !editing && (!active || active === document.body || !active.isConnected)) editRef.current?.focus();
wasEditing.current = editing;
}, [editing]);
const save = () => { const text = draft.trim(); if (text && text !== item.text) onEdit?.(item.id, text); setEditing(false); };
const status = item.status ?? 'queued';
const sending = status === 'sending';
const failed = status === 'failed';
if (editing) {
return <li data-slot="prompt-queue-item" data-index={index} data-state="editing" className="flex min-h-(--row) min-w-0 flex-wrap items-center gap-1.5 py-1 ps-3 pe-1 rule-row">
<Input
ref={inputRef}
size="sm"
value={draft}
aria-label={words.editField}
onValueChange={setDraft}
onKeyDown={event => {
if (isComposing(event)) return;
if (event.key === 'Enter') { event.preventDefault(); save(); }
if (event.key === 'Escape') { event.preventDefault(); event.stopPropagation(); setEditing(false); }
}}
className="min-w-0 flex-1 basis-40"
/>
<span className="flex shrink-0 gap-1.5">
<Button size="sm" variant="secondary" onClick={() => setEditing(false)}>{words.cancel}</Button>
<Button size="sm" onClick={save}>{words.save}</Button>
</span>
</li>;
}
return <li
data-slot="prompt-queue-item"
data-index={index}
data-state={status}
data-status={failed ? 'fail' : undefined}
onKeyDown={event => {
if (!event.altKey || !onMove || sending) return;
if (event.key === 'ArrowUp' && index > 0) { event.preventDefault(); onMove(item.id, index - 1); }
if (event.key === 'ArrowDown' && index < count - 1) { event.preventDefault(); onMove(item.id, index + 1); }
}}
className="@container/queue-row flex min-w-0 flex-col py-1 ps-3 pe-1 rule-row"
>
<div className="flex min-h-(--control-sm) min-w-0 items-center gap-x-2.5">
<Status status={failed ? 'fail' : sending ? 'running' : 'queued'} size="sm" className="shrink-0 @xs/queue-row:w-18"><span className="sr-only @xs/queue-row:not-sr-only">{failed ? words.failed : sending ? words.sending : words.queued}</span></Status>
<span className="min-w-0 flex-1 truncate type-body-sm text-text-1" title={item.text}>{item.text}</span>
<span className="flex shrink-0 items-center justify-end">
{(onRetry || onSendNow) && <span data-slot="prompt-queue-primary" className="flex w-22 shrink-0 justify-end">
{failed && onRetry
? <Button size="sm" variant="secondary" onClick={() => onRetry(item.id)} className="w-full">{words.retry}</Button>
: onSendNow && !failed && <Button size="sm" variant="ghost" disabled={sending} pending={sending} pendingLabel={words.sending} onClick={() => onSendNow(item.id)} className="w-full">{words.sendNow}</Button>}
</span>}
{onEdit && <Button ref={editRef} size="icon-sm" variant="ghost" aria-label={words.edit(item.text)} disabled={sending} onClick={() => setEditing(true)}><Icon icon={Edit} size={12}/></Button>}
{onMove && count > 1 && <>
<Button size="icon-sm" variant="ghost" aria-label={words.moveUp} aria-keyshortcuts="Alt+ArrowUp" disabled={sending || index === 0} onClick={() => onMove(item.id, index - 1)}><Icon icon={ArrowUp} size={12}/></Button>
<Button size="icon-sm" variant="ghost" aria-label={words.moveDown} aria-keyshortcuts="Alt+ArrowDown" disabled={sending || index === count - 1} onClick={() => onMove(item.id, index + 1)}><Icon icon={ArrowDown} size={12}/></Button>
</>}
{onRemove && <Button size="icon-sm" variant="ghost" aria-label={words.remove} disabled={sending} onClick={() => onRemove(item.id)}><Icon icon={Close} size={12}/></Button>}
</span>
</div>
{failed && <p className="ps-5 pb-1 @xs/queue-row:ps-20.5 type-caption break-words text-text-2">{item.error ?? words.notSent} {words.held}</p>}
</li>;
}
function PromptQueue({items, onEdit, onSendNow, onRemove, onRetry, onMove, editingId, onEditingChange, returnFocus, labels, className, ref, ...props}: PromptQueueProps) {
const words = {...queueLabels, ...labels};
const id = React.useId();
const rootRef = React.useRef<HTMLDivElement>(null);
const rootRefs = React.useMemo(() => mergeRefs(rootRef, ref), [ref]);
const [innerEditing, setInnerEditing] = React.useState<string | null>(null);
const editing = editingId !== undefined ? editingId : innerEditing;
const setEditing = (next: string | null) => { if (editingId === undefined) setInnerEditing(next); onEditingChange?.(next); };
const lastIndex = React.useRef<number | null>(null);
React.useEffect(() => {
const away = (event: PointerEvent) => { if (!rootRef.current?.contains(event.target as Node)) lastIndex.current = null; };
document.addEventListener('pointerdown', away, true);
return () => document.removeEventListener('pointerdown', away, true);
}, []);
React.useLayoutEffect(() => {
if (lastIndex.current === null) return;
const active = document.activeElement as HTMLElement | null;
const lost = !active || active === document.body || !active.isConnected || (!!rootRef.current?.contains(active) && active.matches(':disabled'));
if (!lost) return;
const rows = rootRef.current?.querySelectorAll<HTMLElement>('[data-slot="prompt-queue-item"]') ?? [];
const row = rows[Math.min(lastIndex.current, rows.length - 1)];
const target = row?.querySelector<HTMLElement>('input, button:not(:disabled)');
if (target) { target.focus(); return; }
lastIndex.current = null;
returnFocus?.();
});
if (!items.length) return null;
const halted = items[0]?.status === 'failed';
return <div
ref={rootRefs}
data-slot="prompt-queue"
data-state={halted ? 'halted' : 'waiting'}
onFocus={event => { const row = (event.target as HTMLElement).closest<HTMLElement>('[data-index]'); if (row) lastIndex.current = Number(row.dataset.index); }}
onBlur={event => { const next = event.relatedTarget as Node | null; if (next && !event.currentTarget.contains(next)) lastIndex.current = null; }}
className={cn('panel relative flex min-w-0 flex-col overflow-hidden', className)}
{...props}
>
<p id={id} className="flex min-h-(--control) items-center px-3 type-caption text-text-2 data rule-row" aria-live="polite">{words.summary(items.length, halted)}</p>
<ol aria-labelledby={id} className="flex flex-col">
{items.map((item, i) => <QueueRow
key={item.id}
item={item}
index={i}
count={items.length}
editing={editing === item.id}
setEditing={on => setEditing(on ? item.id : null)}
onEdit={onEdit}
onSendNow={onSendNow}
onRemove={onRemove}
onRetry={onRetry}
onMove={onMove}
words={words}
/>)}
</ol>
</div>;
}
export {PromptQueue, type QueuedMessage, type PromptQueueProps, type PromptQueueLabels};