@fungi.computer/parakeet 0.4.0 → 0.6.0

package/dist/components/DecisionComposer.d.ts

@@ -0,0 +1,30 @@
+import type { AwaitingItem, DecisionIntent, DecisionView } from "../core/awaiting-answer.js";
+/** Props for the decision that has taken over the composer. */
+export type DecisionComposerProps = Readonly<{
+    /** The waiting decision to answer. */
+    item: AwaitingItem;
+    /** One-based place among every waiting decision. */
+    position: number;
+    /** Every waiting decision. */
+    total: number;
+    /** Postpone the decision; it waits in the footer row. */
+    onLater: () => void;
+    /** The person was typing in the composer, so focus follows into the list. */
+    takeFocus: boolean;
+}>;
+/**
+ * The composer while the Agent waits on the person: the decision's rows,
+ * an Other line, and Send / Later. It binds one waiting decision to its
+ * reducer and draws the result.
+ */
+export declare function DecisionComposer({ item, position, total, onLater, takeFocus, }: DecisionComposerProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Draw Parakeet's decision view with Caps parts and forward keys and clicks as
+ * intents; the rules live in the reducer, so every surface answers alike.
+ */
+export declare function DecisionPanel({ view, dispatch, onLater, takeFocus, }: Readonly<{
+    view: DecisionView;
+    dispatch: (intent: DecisionIntent) => void;
+    onLater: () => void;
+    takeFocus: boolean;
+}>): import("react/jsx-runtime").JSX.Element;

package/dist/components/DecisionComposer.js

@@ -0,0 +1,145 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Checkbox } from "@fungi.computer/caps/components/checkbox";
+import { KeycapButton } from "@fungi.computer/caps/components/keycap";
+import { Input } from "@fungi.computer/caps/components/input";
+import { Listbox } from "@fungi.computer/caps/components/listbox";
+import { isImeComposing } from "@fungi.computer/caps/lib/ime";
+import { useEffect, useRef } from "react";
+import { useDecision } from "../use-decision.js";
+import { PromptHeader } from "./InteractionPanel.js";
+const kindNames = { question: "Question", approval: "Approval" };
+/**
+ * The composer while the Agent waits on the person: the decision's rows,
+ * an Other line, and Send / Later. It binds one waiting decision to its
+ * reducer and draws the result.
+ */
+export function DecisionComposer({ item, position, total, onLater, takeFocus, }) {
+    const decision = useDecision(item, { position, total, later: onLater });
+    if (decision.view === undefined)
+        return null;
+    return (_jsx(DecisionPanel, { view: decision.view, dispatch: decision.dispatch, onLater: decision.later, takeFocus: takeFocus }));
+}
+/**
+ * Draw Parakeet's decision view with Caps parts and forward keys and clicks as
+ * intents; the rules live in the reducer, so every surface answers alike.
+ */
+export function DecisionPanel({ view, dispatch, onLater, takeFocus, }) {
+    const list = useRef(null);
+    const input = useRef(null);
+    const typing = view.phase === "other";
+    const wasTyping = useRef(false);
+    useEffect(() => {
+        if (takeFocus)
+            list.current?.focus();
+    }, [takeFocus]);
+    useEffect(() => {
+        if (typing)
+            input.current?.focus();
+        else if (wasTyping.current && document.activeElement === input.current)
+            list.current?.focus();
+        wasTyping.current = typing;
+    }, [typing]);
+    const rows = view.rows;
+    const field = view.other;
+    const sending = view.phase === "sending";
+    const act = (event, handled, run) => {
+        if (!handled)
+            return false;
+        event.preventDefault();
+        run();
+        return true;
+    };
+    const onListKey = (event) => {
+        // Keys typed in the Other row's field belong to the field.
+        if (event.target instanceof HTMLInputElement)
+            return;
+        if (isImeComposing(event))
+            return;
+        if (event.ctrlKey || event.metaKey || event.altKey)
+            return;
+        const { key } = event;
+        if (act(event, key === "ArrowDown", () => {
+            dispatch({ type: "move", delta: 1 });
+        }) ||
+            act(event, key === "ArrowUp", () => {
+                dispatch({ type: "move", delta: -1 });
+            }) ||
+            act(event, key === "Enter", () => {
+                dispatch({ type: "enter" });
+            }) ||
+            act(event, key === " ", () => {
+                dispatch({ type: "toggle" });
+            }) ||
+            act(event, key === "Escape", () => {
+                dispatch({ type: "escape" });
+            }) ||
+            act(event, /^[1-9]$/u.test(key), () => {
+                dispatch({ type: "pick", number: Number(key) });
+            }) ||
+            act(event, key.length === 1, () => {
+                dispatch({ type: "append", text: key });
+            }))
+            return;
+    };
+    const onOtherKey = (event) => {
+        if (isImeComposing(event))
+            return;
+        const { key } = event;
+        if (act(event, key === "ArrowDown", () => {
+            dispatch({ type: "move", delta: 1 });
+        }) ||
+            act(event, key === "ArrowUp", () => {
+                dispatch({ type: "move", delta: -1 });
+            }) ||
+            act(event, key === "Enter", () => {
+                dispatch({ type: "enter" });
+            }) ||
+            act(event, key === "Escape", () => {
+                dispatch({ type: "escape" });
+            }))
+            return;
+    };
+    // A multiple decision's marker is a Caps check, not `[x]` text. The row
+    // itself is the control: the option owns aria-selected and the click, so
+    // the check is drawn for sight only.
+    const check = (row) => (_jsx("span", { "aria-hidden": "true", className: "pointer-events-none flex shrink-0", children: _jsx(Checkbox, { checked: row.toggled, readOnly: true, tabIndex: -1 }) }));
+    const words = (row) => (_jsxs("span", { className: "flex flex-col", children: [_jsx("span", { className: row.destructive ? "text-error" : undefined, children: view.multiple ? row.caption : row.text }), row.description === undefined ? null : (_jsx("span", { className: "text-sm opacity-70", children: row.description }))] }));
+    const rowContent = (row) => view.multiple ? (_jsxs("span", { className: "flex items-start gap-xs", children: [check(row), words(row)] })) : (words(row));
+    const picked = rows.find((row) => row.highlighted);
+    return (_jsxs("div", { "aria-label": view.label, className: "parakeet-decision flex flex-col gap-xs p-sm", "data-kind": view.kind, "data-phase": view.phase, role: "group", children: [_jsx(PromptHeader, { request: {
+                    message: view.title,
+                    summary: view.summary,
+                    facts: view.facts,
+                    body: view.body,
+                    bodyLabel: view.bodyLabel,
+                    details: view.details.length === 0 ? undefined : view.details,
+                }, trailing: _jsx("span", { className: "shrink-0 text-sm opacity-70", children: view.counter ?? kindNames[view.kind] }) }), _jsx(Listbox, { "aria-label": view.title, className: "parakeet-decision-list", getKey: (row) => String(row.index), getLabel: (row) => row.label, isDisabled: () => sending, items: rows, rootRef: list, renderItem: (row) => row.kind === "other" && field !== undefined ? (_jsxs("span", { className: "flex items-center gap-xs", "data-highlight": row.highlighted || undefined, "data-row": "other", children: [view.multiple ? check(row) : null, _jsx("span", { className: "shrink-0", children: view.multiple ? row.caption : row.text }), row.highlighted || field.text !== "" ? (_jsx(Input, { "aria-label": field.label, autoComplete: "off", disabled: sending, maxLength: field.maxLength, onChange: (event) => {
+                                dispatch({ type: "type", text: event.target.value });
+                            }, onKeyDown: onOtherKey, placeholder: field.placeholder, ref: input, value: field.text })) : null] })) : (_jsx("span", { "data-highlight": row.highlighted || undefined, children: rowContent(row) })), onKeyDown: onListKey, ...(view.multiple
+                    ? {
+                        multiple: true,
+                        value: rows
+                            .filter((row) => row.toggled)
+                            .map((row) => String(row.index)),
+                        onValueChange: (_value, selected) => {
+                            const clicked = rows.find((row) => selected.some((chosen) => chosen.index === row.index) !==
+                                row.toggled);
+                            if (clicked === undefined)
+                                return;
+                            dispatch({ type: "pick", number: clicked.index + 1 });
+                            if (clicked.kind === "option")
+                                dispatch({ type: "toggle" });
+                        },
+                    }
+                    : {
+                        value: picked === undefined ? null : String(picked.index),
+                        onValueChange: (_value, row) => {
+                            if (row !== null)
+                                dispatch({ type: "pick", number: row.index + 1 });
+                        },
+                    }) }), view.status === undefined ? null : (_jsx("p", { className: view.status.tone === "error"
+                    ? "text-sm text-error"
+                    : "text-sm opacity-70", role: view.status.tone === "error" ? "alert" : "status", children: view.status.text })), _jsxs("div", { className: "parakeet-decision-actions", children: [_jsx(KeycapButton, { label: "Later", tone: "neutral", onClick: onLater }), _jsx(KeycapButton, { disabled: !view.canSend, label: "Send", onClick: () => {
+                            dispatch({ type: "enter" });
+                        }, tone: "primary" })] })] }));
+}

package/dist/components/InteractionPanel.d.ts

@@ -1,4 +1,5 @@
-import type { WhistleInteractionHost } from "@fungi.computer/whistle/interaction";
+import type { WhistleInteractionHost, WhistlePendingPrompt } from "@fungi.computer/whistle/interaction";
+import { type ReactNode } from "react";
 /** The interaction to draw and the page's close callback. */
 export type InteractionPanelProps = Readonly<{
     /** The renderer-neutral interaction store. */
@@ -6,6 +7,14 @@ export type InteractionPanelProps = Readonly<{
     /** Close a settled interaction. */
     onClose?: () => void;
 }>;
+/** The text every prompt carries above its choices. */
+export type PromptContent = Pick<WhistlePendingPrompt["request"], "message" | "summary" | "facts" | "body" | "bodyLabel" | "details">;
+/** Summary, facts, long text and on-demand details: the shared modal anatomy. */
+export declare function PromptHeader({ request, trailing, }: Readonly<{
+    request: PromptContent;
+    /** Drawn at the end of the title line, e.g. a `1 of 3` marker. */
+    trailing?: ReactNode;
+}>): import("react/jsx-runtime").JSX.Element;
 /**
  * Browser renderer for one Whistle interaction. It draws the same host
  * snapshot the terminal draws; the command, not the page, defines the steps.

package/dist/components/InteractionPanel.js

@@ -8,12 +8,14 @@ import { Input } from "@fungi.computer/caps/components/input";
 import { Listbox } from "@fungi.computer/caps/components/listbox";
 import { Status } from "@fungi.computer/caps/components/status";
 import { Display } from "@fungi.computer/caps/components/surface";
-import { useState, useSyncExternalStore } from "react";
+import { useState, useSyncExternalStore, } from "react";
 /** Summary, facts, long text and on-demand details: the shared modal anatomy. */
-function PromptHeader({ request }) {
+export function PromptHeader({ request, trailing, }) {
     const [open, setOpen] = useState(false);
-    const entries = (list) => list === undefined ? null : (_jsx(DataList, { density: "compact", children: list.map((entry) => (_jsxs(DataRow, { children: [_jsx("span", { className: "text-sm opacity-70", children: entry.label }), " ", _jsx("span", { className: "break-words", children: entry.value })] }, entry.label))) }));
-    return (_jsxs(_Fragment, { children: [_jsx("p", { className: "font-medium", children: request.message }), request.summary === undefined ? null : (_jsx("p", { className: "text-sm opacity-70", children: request.summary })), entries(request.facts), request.body === undefined ? null : (_jsxs("p", { className: "line-clamp-3 whitespace-pre-line break-words", children: [request.bodyLabel === undefined ? null : (_jsxs("span", { className: "text-sm opacity-70", children: [request.bodyLabel, " "] })), request.body] })), request.details === undefined && request.body === undefined ? null : (_jsxs(Disclosure, { open: open, onOpenChange: setOpen, summary: "Details", children: [request.body === undefined ? null : (_jsx("p", { className: "whitespace-pre-line break-words", children: request.body })), entries(request.details)] }))] }));
+    const entries = (list) => list === undefined ? null : (_jsx(DataList, { density: "compact", children: list.map((entry) => (
+        // Facts read as one block of label/value lines, with no rules between.
+        _jsxs(DataRow, { className: "after:hidden", children: [_jsx("span", { className: "text-sm opacity-70", children: entry.label }), " ", _jsx("span", { className: "break-words", children: entry.value })] }, entry.label))) }));
+    return (_jsxs(_Fragment, { children: [trailing === undefined ? (_jsx("p", { className: "font-medium", children: request.message })) : (_jsxs("div", { className: "flex items-baseline justify-between gap-sm", children: [_jsx("p", { className: "font-medium", children: request.message }), trailing] })), request.summary === undefined ? null : (_jsx("p", { className: "text-sm opacity-70", children: request.summary })), entries(request.facts), request.body === undefined ? null : (_jsxs("p", { className: "line-clamp-3 whitespace-pre-line break-words", children: [request.bodyLabel === undefined ? null : (_jsxs("span", { className: "text-sm opacity-70", children: [request.bodyLabel, " "] })), request.body] })), request.details === undefined && request.body === undefined ? null : (_jsxs(Disclosure, { open: open, onOpenChange: setOpen, summary: "Details", children: [request.body === undefined ? null : (_jsx("p", { className: "whitespace-pre-line break-words", children: request.body })), entries(request.details)] }))] }));
 }
 function PromptView({ host, pending, }) {
     const [text, setText] = useState("");
@@ -29,6 +31,9 @@ function PromptView({ host, pending, }) {
                         , { 
                             // A destructive question focuses the safe answer, which comes first.
                             autoFocus: request.destructive === true, variant: "ghost", onClick: () => host.answer(pending.sequence, false), children: request.cancelLabel ?? "Cancel" }), _jsx(Button, { variant: request.destructive === true ? "destructive" : "primary", onClick: () => host.answer(pending.sequence, true), children: request.confirmLabel ?? "Confirm" })] })] }));
+    // A decision is answered in the composer; no dialog ever receives one.
+    if (request.type === "decision")
+        return null;
     const submit = (event) => {
         event.preventDefault();
         host.answer(pending.sequence, text);

package/dist/components/SlashMenu.d.ts

@@ -1,7 +1,5 @@
 import type { SlashCommandController } from "../commands/use-slash-commands.js";
-/** Stable id of one slash row, for `aria-activedescendant`. */
-export declare function slashOptionId(listId: string, index: number): string;
-/** The browser slash menu: draws Parakeet's completion rows, nothing more. */
+/** Parakeet's slash adapter: maps its completion rows onto the shared menu. */
 export declare function SlashMenu({ slash, listId, }: Readonly<{
     slash: SlashCommandController;
     listId: string;

package/dist/components/SlashMenu.js

@@ -1,5 +1,5 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { PopoverOption } from "@fungi.computer/caps/components/popover";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { CompletionMenu } from "./CompletionMenu.js";
 /** Split a label into matched and unmatched runs (UTF-16 indices, like the matcher). */
 function emphasize(label, matches) {
     if (matches.length === 0)
@@ -16,13 +16,9 @@ function emphasize(label, matches) {
     }
     return runs.map((run) => run.marked ? (_jsx("mark", { className: "parakeet-slash-match", children: run.text }, run.start)) : (_jsx("span", { children: run.text }, run.start)));
 }
-/** Stable id of one slash row, for `aria-activedescendant`. */
-export function slashOptionId(listId, index) {
-    return `${listId}-${String(index)}`;
-}
-/** The browser slash menu: draws Parakeet's completion rows, nothing more. */
+/** Parakeet's slash adapter: maps its completion rows onto the shared menu. */
 export function SlashMenu({ slash, listId, }) {
-    const { completion, selected } = slash;
+    const { completion } = slash;
     if (completion.kind === "none")
         return null;
     const rows = completion.kind === "commands"
@@ -42,9 +38,5 @@ export function SlashMenu({ slash, listId, }) {
             keys: "",
             disabled: false,
         }));
-    return (_jsxs("div", { className: "parakeet-slash-menu", "data-kind": completion.kind, children: [completion.kind === "arguments" ? (_jsx("p", { className: "parakeet-slash-hint", children: completion.hint })) : null, rows.length === 0 ? null : (_jsx("div", { id: listId, role: "listbox", "aria-label": "Commands", children: rows.map((row, index) => (_jsxs(PopoverOption, { id: slashOptionId(listId, index), active: index === selected, "aria-disabled": row.disabled || undefined, "data-disabled": row.disabled, onMouseEnter: () => {
-                        slash.highlight(index);
-                    }, onClick: () => {
-                        slash.choose(index);
-                    }, children: [_jsx("span", { className: "parakeet-slash-label", children: row.label }), _jsx("span", { className: "parakeet-slash-detail", children: row.detail }), row.keys.length === 0 ? null : (_jsx("kbd", { className: "parakeet-slash-keys", children: row.keys }))] }, row.key))) }))] }));
+    return (_jsx(CompletionMenu, { open: slash.open, rows: rows, selected: slash.selected, listId: listId, label: "Commands", kind: completion.kind, hint: completion.kind === "arguments" ? completion.hint : undefined, onHighlight: slash.highlight, onChoose: slash.choose }));
 }

package/dist/components/TimelineItem.d.ts

@@ -8,6 +8,7 @@ export declare const TimelineItem: import("react").NamedExoticComponent<Readonly
     onCancelQueued?: ((commandId: string) => void) | undefined;
     cancellingQueued?: boolean | undefined;
     renderToolActions?: ((item: ToolItem) => ReactNode) | undefined;
+    claimsToolMedia?: ((item: ToolItem) => boolean) | undefined;
     renderAssistantAttachment?: ((text: string) => ReactNode) | undefined;
     formatAssistantText?: ((text: string) => string) | undefined;
     /** View-only open state for tool groups and calls. */

package/dist/components/TimelineItem.js

@@ -14,7 +14,7 @@ const compactionNoticeLabel = {
     stale: "compaction skipped: the context moved on",
     insufficient: "compaction skipped: the summary would not fit",
 };
-export const TimelineItem = memo(function TimelineItem({ item, onDismissFailed, onCancelQueued, cancellingQueued = false, renderToolActions, renderAssistantAttachment, formatAssistantText, toolDisclosure = initialToolDisclosure, onToggleTool = ignoreToggle, }) {
+export const TimelineItem = memo(function TimelineItem({ item, onDismissFailed, onCancelQueued, cancellingQueued = false, renderToolActions, claimsToolMedia, renderAssistantAttachment, formatAssistantText, toolDisclosure = initialToolDisclosure, onToggleTool = ignoreToggle, }) {
     switch (item.kind) {
         case "user_message": {
             const pending = item.status === "pending" || item.status === "queued";
@@ -25,7 +25,7 @@ export const TimelineItem = memo(function TimelineItem({ item, onDismissFailed,
                 onCancelQueued !== undefined ? (_jsx("div", { className: "flex justify-end px-3", children: _jsx(Button, { "aria-label": "Cancel queued message", disabled: cancellingQueued, size: "sm", variant: "ghost", onClick: () => {
                         onCancelQueued(commandId);
                     }, children: "Cancel" }) })) : null;
-            const dismissAction = requestId === undefined || onDismissFailed === undefined ? null : (_jsx("button", { "aria-label": "Dismiss failed prompt", className: "btn btn-ghost btn-xs", onClick: () => {
+            const dismissAction = requestId === undefined || onDismissFailed === undefined ? null : (_jsx(Button, { "aria-label": "Dismiss failed prompt", variant: "outline", size: "xs", onClick: () => {
                     onDismissFailed(requestId);
                 }, type: "button", children: "Dismiss" }));
             const failed = item.status === "failed" ? (_jsxs("div", { className: "flex items-center gap-2 px-3 text-xs text-error", role: "alert", children: [_jsx("span", { children: item.author?.kind === "agent"
@@ -44,11 +44,11 @@ export const TimelineItem = memo(function TimelineItem({ item, onDismissFailed,
         case "assistant_message":
             if (!assistantMessageVisible(item))
                 return null;
-            return (_jsxs(_Fragment, { children: [item.author ? (_jsx("div", { className: "px-3 text-xs text-dim", "data-author": item.author.id, children: item.author.name })) : null, _jsx(ChatMessage, { isError: item.isError === true, pending: item.pending, speaker: "agent", ...(item.thinking ? { thinking: item.thinking } : {}), children: formatAssistantText?.(item.text) ?? item.text }), item.isError && item.providerError !== undefined ? (_jsxs("div", { className: "px-3 text-error", "data-provider-error": item.id, children: [_jsx("p", { className: "whitespace-pre-wrap", children: item.providerError }), _jsxs("details", { children: [_jsx("summary", { children: "Provider details" }), _jsx("pre", { className: "whitespace-pre-wrap", children: item.providerError })] })] })) : null, !item.pending && !item.isError
+            return (_jsxs(_Fragment, { children: [item.author ? (_jsx("div", { className: "px-3 text-xs text-dim", "data-author": item.author.id, children: item.author.name })) : null, _jsx(ChatMessage, { isError: item.isError === true, pending: item.pending, speaker: "agent", ...(item.thinking ? { thinking: item.thinking } : {}), children: formatAssistantText?.(item.text) ?? item.text }), item.isError && item.repeatCount !== undefined ? (_jsxs("span", { className: "px-3 text-error", children: ["x", item.repeatCount] })) : null, item.isError && item.errorDetail ? (_jsx("p", { className: "px-3 text-dim", children: item.errorDetail })) : null, item.isError && item.providerError !== undefined ? (_jsx("div", { className: "px-3 text-error", "data-provider-error": item.id, children: _jsxs("details", { children: [_jsx("summary", { children: "Provider details (latest response)" }), _jsx("pre", { className: "whitespace-pre-wrap", children: item.providerError })] }) })) : null, !item.pending && !item.isError
                         ? renderAssistantAttachment?.(item.text)
                         : null] }));
         case "tool_group":
-            return (_jsx(ToolGroup, { disclosure: toolDisclosure, group: item, onToggle: onToggleTool, renderToolActions: renderToolActions }));
+            return (_jsx(ToolGroup, { disclosure: toolDisclosure, group: item, onToggle: onToggleTool, renderToolActions: renderToolActions, claimsToolMedia: claimsToolMedia }));
         case "compaction_divider":
             return (_jsx("div", { className: "divider text-dim my-2 text-xs", role: "separator", children: item.tokensAfter === null
                     ? "compacted · the agent’s memory starts below"

package/dist/components/ToolGroup.d.ts

@@ -9,4 +9,5 @@ export declare const ToolGroup: import("react").NamedExoticComponent<Readonly<{
     disclosure: ToolDisclosureState;
     onToggle: ToggleToolDisclosure;
     renderToolActions?: ((item: ToolItem) => ReactNode) | undefined;
+    claimsToolMedia?: ((item: ToolItem) => boolean) | undefined;
 }>>;

package/dist/components/ToolGroup.js

@@ -6,7 +6,7 @@ import { Status } from "@fungi.computer/caps/components/status";
 import { Sigil } from "@fungi.computer/sigils";
 import { memo } from "react";
 import { disclosureOpen, toolCallDefaultOpen, toolGroupDefaultOpen, visibleToolCalls, } from "../core/tool-groups.js";
-import { formatToolDuration, toolStatusTone as statusTone, toolKindSigils, } from "../core/tool-view.js";
+import { formatToolDuration, toolStatusTone as statusTone, toolKindSigils, toolLiveLines, } from "../core/tool-view.js";
 import { CodeBlock } from "./CodeBlock.js";
 /** Items beyond a section's preview, unless the reader asked for all. */
 function visible(items, preview, full) {
@@ -53,38 +53,38 @@ function SectionView({ section, full, onShowAll, }) {
         }
     }
 }
-function CallBody({ call, tool, disclosure, onToggle, }) {
+function CallBody({ call, tool, disclosure, onToggle, mediaClaimed, }) {
     const fullId = `${call.id}:full`;
     const full = disclosureOpen(disclosure, fullId, false);
     const showAll = () => {
         onToggle(fullId, false);
     };
-    return (_jsxs("div", { className: "space-y-1.5 py-1.5 pr-2", "data-parakeet-call-body": true, children: [call.error === undefined ? null : (_jsx("p", { className: "not-prose m-0 font-mono text-[11px] text-error", role: "alert", children: call.error })), call.sections.map((section, index) => (_jsx(SectionView, { full: full, onShowAll: showAll, section: section }, `${section.kind}:${String(index)}`))), tool?.result?.content
+    return (_jsxs("div", { className: "space-y-1.5 py-1.5 pr-2", "data-parakeet-call-body": true, children: [call.error === undefined ? null : (_jsx("p", { className: "not-prose m-0 font-mono text-[11px] text-error", role: "alert", children: call.error })), call.sections.map((section, index) => (_jsx(SectionView, { full: full, onShowAll: showAll, section: section }, `${section.kind}:${String(index)}`))), (mediaClaimed ? [] : (tool?.result?.content ?? []))
                 .filter((part) => part.type === "image")
                 .map((part, index) => (_jsx("img", { alt: "Tool result", className: "max-w-full", src: `data:${part.mimeType};base64,${part.data}`, style: { maxHeight: 400 } }, `${call.id}-image-${String(index)}`)))] }));
 }
-function CallRow({ call, tool, disclosureId, size, disclosure, onToggle, renderToolActions, }) {
+function CallRow({ call, tool, disclosureId, size, disclosure, onToggle, renderToolActions, claimsToolMedia, }) {
     const defaultOpen = toolCallDefaultOpen(call);
     const open = disclosureOpen(disclosure, disclosureId, defaultOpen);
     const running = call.status === "running";
     return (_jsxs("div", { "data-parakeet-call": call.kind, "data-status": call.status, children: [_jsx(Disclosure, { leading: _jsx(Sigil, { name: toolKindSigils[call.kind], size: 16 }), onOpenChange: () => {
                     onToggle(disclosureId, defaultOpen);
-                }, open: open, size: size, summary: _jsxs(_Fragment, { children: [_jsx("span", { className: "text-base-content", children: running ? call.activeVerb : call.verb }), " ", _jsx("span", { className: "font-mono", children: call.label })] }), tone: call.status === "error" ? "error" : "neutral", trailing: _jsxs(_Fragment, { children: [call.exitCode === undefined ? null : (_jsxs(Badge, { size: "sm", tone: "error", children: ["exit ", String(call.exitCode)] })), call.durationMs === undefined ? null : (_jsx("span", { children: formatToolDuration(call.durationMs) })), _jsx(Status, { motion: running ? "bounce" : "none", title: call.status === "unknown" ? "result unavailable" : call.status, tone: statusTone(call.status) })] }), children: _jsx(CallBody, { call: call, disclosure: disclosure, onToggle: onToggle, tool: tool }) }), call.status === "completed" && tool?.result !== undefined
+                }, open: open, size: size, summary: _jsxs(_Fragment, { children: [_jsx("span", { className: "text-base-content", children: running ? call.activeVerb : call.verb }), " ", _jsx("span", { className: "font-mono", children: call.label })] }), tone: call.status === "error" ? "error" : "neutral", trailing: _jsxs(_Fragment, { children: [call.exitCode === undefined ? null : (_jsxs(Badge, { size: "sm", tone: "error", children: ["exit ", String(call.exitCode)] })), call.durationMs === undefined ? null : (_jsx("span", { children: formatToolDuration(call.durationMs) })), _jsx(Status, { motion: running ? "bounce" : "none", title: call.status === "unknown" ? "result unavailable" : call.status, tone: statusTone(call.status) })] }), children: _jsx(CallBody, { call: call, disclosure: disclosure, onToggle: onToggle, mediaClaimed: tool !== undefined && claimsToolMedia?.(tool) === true, tool: tool }) }), call.live === undefined ? null : (_jsx("pre", { className: monoBlock, "aria-label": "Live tool output", children: toolLiveLines(call, open).map((line, index) => (_jsx("span", { className: "block whitespace-pre", children: line || "\u00a0" }, String(index)))) })), call.status === "completed" && tool?.result !== undefined
                 ? renderToolActions?.(tool)
                 : null] }));
 }
 /** Recent finished calls, or a live group, with reader-owned disclosure. */
-export const ToolGroup = memo(function ToolGroup({ group, disclosure, onToggle, renderToolActions, }) {
+export const ToolGroup = memo(function ToolGroup({ group, disclosure, onToggle, renderToolActions, claimsToolMedia, }) {
     const defaultOpen = toolGroupDefaultOpen(group);
     const open = disclosureOpen(disclosure, group.id, defaultOpen);
     const running = group.status === "running";
     const active = group.active;
     const single = group.calls.length === 1 ? group.calls[0] : undefined;
     if (single !== undefined)
-        return (_jsx("div", { className: "px-1", children: _jsx(CallRow, { call: single, disclosure: disclosure, disclosureId: single.id, onToggle: onToggle, renderToolActions: renderToolActions, size: "row", tool: group.tools[0] }) }));
+        return (_jsx("div", { className: "px-1", children: _jsx(CallRow, { call: single, disclosure: disclosure, disclosureId: single.id, onToggle: onToggle, renderToolActions: renderToolActions, claimsToolMedia: claimsToolMedia, size: "row", tool: group.tools[0] }) }));
     return (_jsxs("div", { className: "px-1", children: [_jsx(Disclosure, { className: "[&>.caps-disclosure-panel]:hidden", leading: _jsx(Sigil, { name: "list", size: 16 }), onOpenChange: () => {
                     onToggle(group.id, defaultOpen);
-                }, open: open, summary: running && active !== undefined ? (_jsxs(_Fragment, { children: [_jsx("span", { className: "text-base-content", children: active.activeVerb }), " ", _jsx("span", { className: "font-mono", children: active.label }), " \u00B7", " ", String(group.calls.length), " ", group.calls.length === 1 ? "call" : "calls"] })) : (_jsxs("span", { className: "text-base-content", children: [group.summary, " \u00B7 ", String(group.calls.length), " ", group.calls.length === 1 ? "call" : "calls"] })), tone: group.status === "error" ? "error" : "neutral", trailing: _jsxs(_Fragment, { children: [group.failedCount > 0 ? (_jsxs("span", { className: "text-error", children: [String(group.failedCount), " failed"] })) : null, group.durationMs === undefined ? null : (_jsx("span", { children: formatToolDuration(group.durationMs) })), _jsx(Status, { motion: running ? "bounce" : "none", title: group.status === "unknown" ? "result unavailable" : group.status, tone: statusTone(group.status) })] }) }), visibleToolCalls(group, open).map((call) => (_jsx(CallRow, { call: call, disclosure: disclosure, disclosureId: call.id, onToggle: onToggle, renderToolActions: renderToolActions, size: "row", tool: group.tools.find((tool) => tool.id === call.id) }, call.id))), group.status === "completed" && group.calls.length > 3 ? (_jsx("button", { "aria-expanded": open, className: "btn btn-ghost btn-xs text-dim", onClick: () => {
+                }, open: open, summary: running && active !== undefined ? (_jsxs(_Fragment, { children: [_jsx("span", { className: "text-base-content", children: active.activeVerb }), " ", _jsx("span", { className: "font-mono", children: active.label }), " \u00B7", " ", String(group.calls.length), " ", group.calls.length === 1 ? "call" : "calls"] })) : (_jsxs("span", { className: "text-base-content", children: [group.summary, " \u00B7 ", String(group.calls.length), " ", group.calls.length === 1 ? "call" : "calls"] })), tone: group.status === "error" ? "error" : "neutral", trailing: _jsxs(_Fragment, { children: [group.failedCount > 0 ? (_jsxs("span", { className: "text-error", children: [String(group.failedCount), " failed"] })) : null, group.durationMs === undefined ? null : (_jsx("span", { children: formatToolDuration(group.durationMs) })), _jsx(Status, { motion: running ? "bounce" : "none", title: group.status === "unknown" ? "result unavailable" : group.status, tone: statusTone(group.status) })] }) }), visibleToolCalls(group, open).map((call) => (_jsx(CallRow, { call: call, disclosure: disclosure, disclosureId: call.id, onToggle: onToggle, renderToolActions: renderToolActions, claimsToolMedia: claimsToolMedia, size: "row", tool: group.tools.find((tool) => tool.id === call.id) }, call.id))), group.status === "completed" && group.calls.length > 3 ? (_jsx("button", { "aria-expanded": open, className: "btn btn-ghost btn-xs text-dim", onClick: () => {
                     onToggle(group.id, defaultOpen);
                 }, type: "button", children: open ? "Show less" : `Show all ${String(group.calls.length)} calls` })) : null] }));
 });

package/dist/conversation-opening.d.ts

@@ -41,7 +41,7 @@ export declare function createConversationOpeningOwner<Session extends ParakeetS
     /** Only the primary conversation is the selection the host shell sees. */
     reportsSelection?: boolean;
 }>): {
-    select: (agentId: string, sessionId: string, fromOpenRequest?: boolean, waitForBaseline?: boolean) => void;
+    select: (agentId: string, sessionId: string, fromOpenRequest?: boolean) => void;
     clear: () => void;
     close: () => void;
 };

package/dist/conversation-opening.js

@@ -68,7 +68,7 @@ export function createConversationOpeningOwner(options) {
     let disposed = false;
     const same = (left, right) => left?.agentId === right.agentId && left.sessionId === right.sessionId;
     const isCurrent = (opening) => !disposed && pending === opening;
-    const select = (agentId, sessionId, fromOpenRequest = false, waitForBaseline = true) => {
+    const select = (agentId, sessionId, fromOpenRequest = false) => {
         if (disposed)
             return;
         const selection = { agentId, sessionId };
@@ -114,7 +114,7 @@ export function createConversationOpeningOwner(options) {
                     void Promise.allSettled([client.close(), transport.close()]);
                 };
                 await observation.ready;
-                if (waitForBaseline && options.reportsSelection !== false) {
+                if (options.reportsSelection !== false) {
                     await connection.ui.reportAgentSessionSelection({
                         agentId,
                         sessionId,

package/dist/conversation.d.ts

@@ -118,7 +118,7 @@ export type ComposerController = Readonly<{
     /** Typed reason the latest prompt did not complete. */
     failure: "admission" | "failed" | "cancelled" | "interrupted" | undefined;
     /** Current send could not enter the bounded local admission queue. */
-    admissionError: "queue_full" | undefined;
+    admissionError: "offline_queue_full" | "queue_full" | undefined;
     /** Retry the exact most recent failed prompt. */
     retry: () => void;
     /** Remove one failed local admission from this conversation. */
@@ -135,6 +135,8 @@ export type ComposerController = Readonly<{
     submitCommand: (run: (draft: string, consumeDraft: () => void) => Promise<WhistleExecutionOutcome | undefined>) => Promise<WhistleExecutionOutcome | undefined>;
     /** Replace the local input. */
     setDraft: (value: string) => void;
+    /** Replace the images riding with the draft; the Session owner admits them on send. */
+    setImages: (images: PromptCommand["images"]) => void;
 }>;
 /** Session activity, observation, and Agent-lifetime controls. */
 export type StatusController = Readonly<{
@@ -203,6 +205,8 @@ export declare function useParakeetSession(): ParakeetSession;
 export declare function useExtensionSlots(): SessionExtensionSlots;
 /** Read Session activity and operate its observation. */
 export declare function useStatus(): StatusController;
+/** Time of the last delivered watch snapshot or frame, not an SSE comment. */
+export declare function useLastSessionReplyAt(): number | undefined;
 /** Presentation admitted once from the selected Session's already observed slots. */
 export declare function useClientContributions(): readonly ClientContribution[];
 /** The selected Session's ordinary command interaction owner. */