@jini-ai/chat 0.6.16 → 0.6.19

package/dist/embed-widget/browser/frontend-session-bridge.js

@@ -27,13 +27,13 @@ import { decodeSseFrames } from '@jini-ai/core/primitives';
  * - **The bind token never leaves this module except to the host.** It arrives on the `attached`
  *   event and must ride to run-start; it deliberately does not appear in any URL (see
  *   `@jini-ai/daemon`'s `FrontendSessionHandle`).
- * - **Read the bind token at send time, not once.** `EventSource` reconnects on its own — after a
- *   daemon restart, a sleeping laptop, or an ordinary network blip — and each reattach mints a new
+ * - **Read the bind token at send time, not once.** After a
+ *   daemon restart, a sleeping laptop, or an ordinary network blip, each reattach mints a new
  *   session and a new token. A host that captured `ready`'s token keeps sending a dead one, every
  *   later run fails to bind, and the only trace is a daemon-side log line: the agent is simply told
  *   "no frontend is bound to this run". `ready` therefore answers "has it attached at least once";
  *   {@link FrontendSessionBridge.bindToken} answers "what is valid now", and only the latter
- *   belongs in a run request.
+ *   belongs in a run request. Park/failure closes the transport; hosts explicitly rebind after wake.
  */
 import { CHAT_CAPABILITIES } from '../../core/index.js';
 import { PAGE_CAPABILITIES, executePageCapability } from '@jini-ai/agentic';
@@ -119,6 +119,8 @@ function readFrame(data) {
  */
 export function createFrontendSessionBridge({ baseUrl: base, openStream, request, fetch, endpointPrefix = '/api/frontend-sessions', headers }, options = {}) {
     const capabilities = claimedCapabilities(options);
+    // 0.6.x compatibility: fetch was optional for published hosts;
+    // remove when fetch injection becomes required in the next minor.
     // The only caller (`respond`) never passes its own signal, so the deadline is the whole signal.
     const send = request ?? (({ url, init, timeoutMs }) => (fetch ?? globalThis.fetch)(url, { ...init, signal: AbortSignal.timeout(timeoutMs) }));
     let sessionId;
@@ -138,6 +140,9 @@ export function createFrontendSessionBridge({ baseUrl: base, openStream, request
     /** Invocation ids already run here, so a stream reconnect cannot double-click a button. */
     const executed = new Set();
     const pending = new Map();
+    const attachments = new Set();
+    let source;
+    let closed = false;
     // A page driver owns one live screen. Serialize its observations, effect and acknowledgement;
     // otherwise a second invocation could overwrite the first one's host-bound navigation plan.
     let pageQueue = Promise.resolve();
@@ -148,7 +153,29 @@ export function createFrontendSessionBridge({ baseUrl: base, openStream, request
         pending.clear();
     };
     const query = capabilities.map((id) => `capability=${encodeURIComponent(id)}`).join('&');
-    const source = openStream({ url: `${base}${endpointPrefix}/stream?${query}`, ...(headers ? { headers: headers() } : {}) });
+    /** Invalidate before any reopen; queued and running page work cannot cross attachments.
+     * O(pending invocations + attachment waiters), with no retained settled waiters. */
+    function invalidate({ error }) {
+        abortPending();
+        pageQueue = Promise.resolve();
+        // The daemon deletes a session's bind token the instant that connection drops, so by the time
+        // this fires the token in hand is already gone from the registry. Holding it until the next
+        // `attached` frame leaves a window where `bindToken()` hands back something dead, and a run
+        // started in that window fails to bind — reported to the agent only as "no frontend is bound
+        // to this run", with the real reason (a reconnect it never saw) nowhere in view.
+        // Reporting no token is the honest answer for a surface that is, right now, not attached.
+        currentBindToken = undefined;
+        sessionId = undefined;
+        for (const waiter of attachments)
+            waiter.reject(error);
+        attachments.clear();
+    }
+    function disconnect({ error }) {
+        const previous = source;
+        source = undefined;
+        invalidate({ error });
+        previous?.close();
+    }
     async function respond(invocationId, body) {
         if (sessionId === undefined)
             throw new Error('the surface is not attached yet');
@@ -169,7 +196,9 @@ export function createFrontendSessionBridge({ baseUrl: base, openStream, request
         const args = { capabilityId: action.capabilityId, input };
         if (options.pageApproval && !options.pageApproval.isDirect(args)) {
             await respond(action.invocationId, { phase: 'approval-pending' });
+            signal.throwIfAborted();
             const answer = await options.pageApproval.request({ ...args, input: structuredClone(input), signal });
+            signal.throwIfAborted();
             // Report the decision before effects, including decline/expiry; the server audits it.
             await respond(action.invocationId, { phase: 'execution-started', decision: answer.confirmed ? 'approved' : answer.reason });
             if (!answer.confirmed)
@@ -197,6 +226,8 @@ export function createFrontendSessionBridge({ baseUrl: base, openStream, request
         }
         catch (error) {
             pending.delete(action.invocationId);
+            if (controller.signal.aborted)
+                return;
             await respondError(action.invocationId, errorMessage(error)).catch(options.onError ?? (() => undefined));
             return;
         }
@@ -207,6 +238,7 @@ export function createFrontendSessionBridge({ baseUrl: base, openStream, request
         try {
             signal.throwIfAborted();
             const projected = await options.onBeforeResponse?.({ action, output });
+            signal.throwIfAborted();
             const acceptedOutput = projected ?? output;
             await respondSuccess(action.invocationId, acceptedOutput);
             signal.throwIfAborted();
@@ -250,44 +282,60 @@ export function createFrontendSessionBridge({ baseUrl: base, openStream, request
         else
             void serveLocally(action, controller);
     }
-    source.addEventListener('message', (event) => {
-        const frame = readFrame(event.data);
-        switch (frame.kind) {
-            case 'cancelled':
-                pending.get(frame.invocationId)?.abort();
+    function connect() {
+        const current = openStream({ url: `${base}${endpointPrefix}/stream?${query}`, ...(headers ? { headers: headers() } : {}) });
+        source = current;
+        current.addEventListener('message', (event) => {
+            if (source !== current)
                 return;
-            case 'attached':
-                abortPending();
-                sessionId = frame.sessionId;
-                currentBindToken = frame.bindToken;
-                // A no-op after the first attach — which is exactly why `currentBindToken` exists.
-                resolveReady({ sessionId, bindToken: currentBindToken });
-                return;
-            case 'refused':
-                rejectReady(new Error(frame.message));
-                return;
-            case 'malformed':
-                options.onError?.(frame.error);
-                return;
-            case 'invocation':
-                handleInvocation(frame.action);
-                return;
-            case 'ignored':
+            const frame = readFrame(event.data);
+            switch (frame.kind) {
+                case 'cancelled':
+                    pending.get(frame.invocationId)?.abort();
+                    return;
+                case 'attached':
+                    abortPending();
+                    sessionId = frame.sessionId;
+                    currentBindToken = frame.bindToken;
+                    // A no-op after the first attach — which is exactly why `currentBindToken` exists.
+                    resolveReady({ sessionId, bindToken: currentBindToken });
+                    for (const waiter of attachments)
+                        waiter.resolve({ sessionId, bindToken: currentBindToken });
+                    attachments.clear();
+                    return;
+                case 'refused': {
+                    const error = new Error(frame.message);
+                    rejectReady(error);
+                    disconnect({ error });
+                    return;
+                }
+                case 'malformed':
+                    options.onError?.(frame.error);
+                    return;
+                case 'invocation':
+                    handleInvocation(frame.action);
+                    return;
+                case 'ignored':
+                    return;
+            }
+        });
+        current.addEventListener('parked', () => {
+            if (source === current)
+                disconnect({ error: new Error('the surface is parked') });
+        });
+        // Intentional visibility pauses keep their transport owner, which reopens on visibility/activity.
+        current.addEventListener('suspended', () => {
+            if (source === current)
+                invalidate({ error: new Error('the surface is suspended') });
+        });
+        current.addEventListener('error', (event) => {
+            if (source !== current)
                 return;
-        }
-    });
-    source.addEventListener('error', (event) => {
-        abortPending();
-        // The daemon deletes a session's bind token the instant that connection drops, so by the time
-        // this fires the token in hand is already gone from the registry. Holding it until the next
-        // `attached` frame leaves a window where `bindToken()` hands back something dead, and a run
-        // started in that window fails to bind — reported to the agent only as "no frontend is bound
-        // to this run", with the real reason (a reconnect it never saw) nowhere in view.
-        // Reporting no token is the honest answer for a surface that is, right now, not attached.
-        currentBindToken = undefined;
-        sessionId = undefined;
-        options.onError?.(event);
-    });
+            disconnect({ error: new Error('the frontend stream failed') });
+            options.onError?.(event);
+        });
+    }
+    connect();
     const bridgeAccess = {
         subscribe(onAction) {
             chatListeners.add(onAction);
@@ -301,21 +349,46 @@ export function createFrontendSessionBridge({ baseUrl: base, openStream, request
         bridgeAccess,
         ready,
         bindToken: () => currentBindToken,
+        async rebind({ signal } = {}, _optional = {}) {
+            signal?.throwIfAborted();
+            if (closed)
+                throw new Error('the frontend bridge is closed');
+            if (sessionId !== undefined && currentBindToken !== undefined)
+                return { sessionId, bindToken: currentBindToken };
+            return new Promise((resolve, reject) => {
+                const cleanup = () => { attachments.delete(waiter); signal?.removeEventListener('abort', abort); };
+                const waiter = {
+                    resolve: (value) => { cleanup(); resolve(value); },
+                    reject: (error) => { cleanup(); reject(error); },
+                };
+                const abort = () => waiter.reject(signal?.reason);
+                attachments.add(waiter);
+                signal?.addEventListener('abort', abort, { once: true });
+                if (!source) {
+                    try {
+                        connect();
+                    }
+                    catch (error) {
+                        disconnect({ error });
+                    }
+                }
+            });
+        },
         close() {
-            abortPending();
-            source.close();
-            chatListeners.clear();
+            closed = true;
             // A closed bridge serves nothing, so binding a run to it would strand that run rather than
             // fail it — this is what stops a torn-down surface (a StrictMode remount, a route change)
             // from handing its dead token to the next run.
-            currentBindToken = undefined;
-            sessionId = undefined;
+            disconnect({ error: new Error('the frontend bridge is closed') });
+            chatListeners.clear();
         },
     };
 }
 /** Authenticated streaming replacement for EventSource when credentials belong in headers.
  * Uses the shared SSE decoder; reconnect creates a new attachment and clears the old token.
  * O(stream bytes), bounded frame buffer; close aborts fetch/readers and the reconnect timer. */
+// 0.6.x compatibility: existing hosts may omit fetch;
+// remove when fetch injection becomes required in the next minor.
 export function openFetchFrontendStream({ url, headers }, { fetch: send = globalThis.fetch, reconnectMs = 1000 } = {}) {
     const events = new EventTarget();
     const abort = new AbortController();
@@ -331,14 +404,14 @@ export function openFetchFrontendStream({ url, headers }, { fetch: send = global
             for await (const frame of decodeSseFrames({ source: streamChunks(response.body) }, { maxBufferChars: 128_000 })) {
                 delay = reconnectMs; // A delivered event proves the connection recovered.
                 if (!abort.signal.aborted)
-                    events.dispatchEvent(new MessageEvent('message', { data: frame.data }));
+                    events.dispatchEvent(new MessageEvent(frame.event === 'parked' ? 'parked' : 'message', { data: frame.data }));
             }
         }
         catch { /* The stream error has one value-free notification below. */ }
         if (abort.signal.aborted)
             return;
         events.dispatchEvent(new Event('error'));
-        if (retryable) {
+        if (retryable && !abort.signal.aborted) {
             retry = setTimeout(() => { void connect(); }, delay);
             delay = Math.min(delay * 2, 30_000);
         }

package/dist/react/components/Composer.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { formatErrorForLog } from '@jini-ai/core';
 /**
  * @module Composer
  *
@@ -12,6 +13,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * the slots a host supplies; it does not itself know what a "library
  * picker" or "session mode" is.
  */
+import { FolderChips } from './FolderChips.js';
 import { useEffect, useLayoutEffect, useRef, useState, } from 'react';
 import { RemixIcon } from '@jini-ai/ui';
 import { useT } from '../hooks/context.js';
@@ -20,7 +22,7 @@ import { AttachmentTray } from './AttachmentTray.js';
 import { ComposerDiscoveryMenu, ComposerSlashMenu } from './ComposerDiscovery.js';
 import { appendComposerDiscovery, composerDiscoveryMenuPosition, composerSlashMenuPosition, filterComposerDiscovery, parseComposerSlashQuery, replaceComposerSlashTrigger, resolveComposerSlashInvocation, resolveComposerSlashKeyAction, } from './composer-discovery.js';
 function reportComposerHostEffectFailure(effectName, error) {
-    console.error(`[@jini-ai/chat] Composer ${effectName} host effect failed:`, error);
+    console.error(`[@jini-ai/chat] Composer ${effectName} host effect failed:`, formatErrorForLog({ error }));
 }
 /**
  * Invokes host code synchronously, then observes either its synchronous result or async failure.
@@ -320,7 +322,7 @@ export function Composer({ composer, onSend, disabled = false, sendDisabled = fa
         event.preventDefault();
         runComposerHostEffect('attachmentPicker.onFiles', () => attachmentPicker.onFiles(files));
     }
-    return (_jsxs("div", { className: "jini-composer", children: [_jsx(AccessorySlot, { className: "jini-composer-leading", children: leadingAccessories }), _jsx(AttachmentTray, { attachments: composer.attachments, onRemove: composer.removeAttachment }), _jsx("textarea", { ref: textareaRef, className: "jini-composer-input", value: composer.draft, placeholder: placeholder ?? t('Send a message…'), disabled: disabled, onChange: (e) => {
+    return (_jsxs("div", { className: "jini-composer", children: [_jsx(AccessorySlot, { className: "jini-composer-leading", children: leadingAccessories }), _jsxs("div", { className: "jini-composer-attachments", children: [_jsx(AttachmentTray, { attachments: composer.attachments, onRemove: composer.removeAttachment }), _jsx(FolderChips, { folders: composer.folders, onRemove: composer.removeFolder })] }), _jsx("textarea", { ref: textareaRef, className: "jini-composer-input", value: composer.draft, placeholder: placeholder ?? t('Send a message…'), disabled: disabled, onChange: (e) => {
                     composer.setDraft(e.target.value);
                     setSlashActiveIndex(0);
                     setDismissedSlashDraft(null);

package/dist/react/components/ConversationList.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { formatErrorForLog } from '@jini-ai/core';
 /**
  * @module ConversationList
  *
@@ -33,7 +34,7 @@ import { ConversationTitleEditor } from './ConversationTitleEditor.js';
  */
 const DOUBLE_CLICK_GRACE_MS = 500;
 function reportConversationListHostEffectFailure(effectName, error) {
-    console.error(`[@jini-ai/chat] ConversationList ${effectName} host effect failed:`, error);
+    console.error(`[@jini-ai/chat] ConversationList ${effectName} host effect failed:`, formatErrorForLog({ error }));
 }
 /** Invokes a host callback and reports a synchronous throw or async rejection without leaving it unhandled. */
 function runConversationListHostEffect(effectName, effect) {

package/dist/react/components/ConversationTitleEditor.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { formatErrorForLog } from '@jini-ai/core';
 import { useRef, useState } from 'react';
 import { MAX_CONVERSATION_TITLE_LENGTH } from '../../core/conversation-title.js';
 import { useT } from '../hooks/context.js';
@@ -28,7 +29,7 @@ export function ConversationTitleEditor({ title, onCommit, onCancel, className =
             await onCommit(next);
         }
         catch (error) {
-            console.error('[@jini-ai/chat] ConversationTitleEditor onCommit host effect failed:', error);
+            console.error('[@jini-ai/chat] ConversationTitleEditor onCommit host effect failed:', formatErrorForLog({ error }));
         }
     };
     return _jsx("input", { autoFocus: true, className: className, "aria-label": t('Rename chat'), "data-testid": testId, maxLength: MAX_CONVERSATION_TITLE_LENGTH, value: draft, onChange: (event) => setDraft(event.currentTarget.value), onBlur: () => { void finish(); }, onKeyDown: (event) => {

package/dist/react/components/CopyMessageButton.d.ts

@@ -3,6 +3,8 @@ interface CopyMessageButtonProps {
     text: string;
     /** Accessible name while idle; swaps to a "Copied" label once the copy lands. */
     label: string;
+    /** Optional hover tooltip; icon-only buttons outside a message action row have no other visible label. */
+    title?: string | undefined;
 }
 /**
  * Quiet, icon-only copy affordance shared by the user- and assistant-message
@@ -11,8 +13,9 @@ interface CopyMessageButtonProps {
  * the icon swap and the accessible announcement of the transient state.
  * @param props.text - Exact string to copy, verbatim.
  * @param props.label - Idle accessible name (already translated by the caller).
+ * @param props.title - Optional hover tooltip (already translated); swaps to "Copied" like the label.
  * @complexity O(1) — one child hook call, no branching beyond the copied-state read.
  */
-export declare function CopyMessageButton({ text, label }: CopyMessageButtonProps): import("react").JSX.Element;
+export declare function CopyMessageButton({ text, label, title }: CopyMessageButtonProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=CopyMessageButton.d.ts.map

package/dist/react/components/CopyMessageButton.js

@@ -10,12 +10,13 @@ import { Icon } from './Icon.js';
  * the icon swap and the accessible announcement of the transient state.
  * @param props.text - Exact string to copy, verbatim.
  * @param props.label - Idle accessible name (already translated by the caller).
+ * @param props.title - Optional hover tooltip (already translated); swaps to "Copied" like the label.
  * @complexity O(1) — one child hook call, no branching beyond the copied-state read.
  */
-export function CopyMessageButton({ text, label }) {
+export function CopyMessageButton({ text, label, title }) {
     const t = useT();
     const { copied, copy } = useCopyToClipboard();
-    return (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", className: "jini-message-action-btn", "aria-label": copied ? t('Copied') : label, onClick: () => {
+    return (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", className: "jini-message-action-btn", "aria-label": copied ? t('Copied') : label, title: title && (copied ? t('Copied') : title), onClick: () => {
                     void copy(text);
                 }, children: _jsx(Icon, { name: copied ? 'check' : 'copy' }) }), _jsx("span", { className: "jini-message-copy-status", "aria-live": "polite", children: copied ? t('Copied to clipboard') : '' })] }));
 }

package/dist/react/components/ExtEventErrorBoundary.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { formatErrorForLog } from '@jini-ai/core';
 /**
  * @module ExtEventErrorBoundary
  *
@@ -25,7 +26,7 @@ export class ExtEventErrorBoundary extends Component {
         // React already surfaces this in the dev console via its own error-boundary reporting; this
         // adds the ext-event `name` React's generic report has no way to know, and gives a host a
         // hook to route it into its own error reporting.
-        console.error(`[ExtEventErrorBoundary] ext event "${this.props.name}" failed to render:`, error);
+        console.error(`[ExtEventErrorBoundary] ext event "${this.props.name}" failed to render:`, formatErrorForLog({ error }));
         this.props.onError?.(error, info);
     }
     render() {

package/dist/react/components/FolderChips.d.ts

@@ -0,0 +1,13 @@
+type OnRemove = (input: {
+    path: string;
+}, options?: {}) => void;
+/**
+ * Shared composer/sent-message folder indicator; references never participate in uploads.
+ * One folder shows its chip directly; a "Folders (n)" toggle would only repeat its name.
+ */
+export declare function FolderChips({ folders, onRemove }: {
+    folders?: readonly string[] | undefined;
+    onRemove?: OnRemove | undefined;
+}): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=FolderChips.d.ts.map

package/dist/react/components/FolderChips.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId, useState } from 'react';
+import { useT } from '../hooks/context.js';
+import { CopyMessageButton } from './CopyMessageButton.js';
+import { Icon } from './Icon.js';
+/** Display only: splitting both separators never changes the exact path carried or copied. */
+function folderName({ path }, _options = {}) {
+    return path.split(/[\\/]/).filter(Boolean).at(-1) ?? path;
+}
+/** One folder: last name (full path on hover), copy, and × when removable. */
+function FolderChip({ path, onRemove }) {
+    const t = useT();
+    const copyLabel = t('Copy folder path: {path}', { path });
+    const removeLabel = t('Remove folder: {path}', { path });
+    return _jsxs("li", { className: "jini-folder-chips__item", children: [_jsx(Icon, { name: "folder" }), _jsx("span", { className: "jini-folder-chips__name", title: path, "aria-label": path, children: folderName({ path }) }), _jsx(CopyMessageButton, { text: path, label: copyLabel, title: copyLabel }), onRemove && _jsx("button", { type: "button", className: "jini-folder-chips__remove", title: removeLabel, "aria-label": removeLabel, onClick: () => onRemove({ path }), children: _jsx(Icon, { name: "close" }) })] });
+}
+/**
+ * Shared composer/sent-message folder indicator; references never participate in uploads.
+ * One folder shows its chip directly; a "Folders (n)" toggle would only repeat its name.
+ */
+export function FolderChips({ folders = [], onRemove }) {
+    const t = useT();
+    const [expanded, setExpanded] = useState(false);
+    const id = useId();
+    if (folders.length === 0)
+        return null;
+    const list = (listId) => _jsx("ul", { id: listId, className: "jini-folder-chips__list", children: folders.map(path => _jsx(FolderChip, { path: path, onRemove: onRemove }, path)) });
+    if (folders.length === 1)
+        return _jsx("div", { className: "jini-folder-chips", children: list() });
+    return _jsxs("div", { className: "jini-folder-chips", children: [_jsxs("button", { type: "button", className: "jini-folder-chips__toggle", "aria-expanded": expanded, "aria-controls": id, onClick: () => setExpanded(value => !value), children: [_jsx(Icon, { name: "folder" }), _jsx("span", { children: t('Folders ({count})', { count: folders.length }) }), _jsx(Icon, { name: expanded ? 'chevron-down' : 'chevron-right' })] }), expanded && list(id)] });
+}
+//# sourceMappingURL=FolderChips.js.map

package/dist/react/components/Icon.d.ts

@@ -7,7 +7,7 @@
  * AgentIcon and WorkingDirPicker.
  */
 import type { SVGProps } from 'react';
-export type IconName = 'spinner' | 'check' | 'close' | 'chevron-down' | 'chevron-left' | 'chevron-right' | 'attach' | 'file' | 'image' | 'x' | 'comment' | 'search' | 'plus' | 'pencil' | 'copy' | 'retry';
+export type IconName = 'spinner' | 'check' | 'close' | 'chevron-down' | 'chevron-left' | 'chevron-right' | 'attach' | 'folder' | 'file' | 'image' | 'x' | 'comment' | 'search' | 'plus' | 'pencil' | 'copy' | 'retry';
 interface IconProps extends Omit<SVGProps<SVGSVGElement>, 'name'> {
     name: IconName;
     size?: number | string;

package/dist/react/components/Icon.js

@@ -15,6 +15,7 @@ const ICON_GLYPHS = {
     'chevron-left': _jsx("path", { d: "m15 18-6-6 6-6" }),
     'chevron-right': _jsx("path", { d: "m9 18 6-6-6-6" }),
     attach: _jsx("path", { d: "m21.44 11.05-9.19 9.19a6 6 0 0 1-8.49-8.49l9.19-9.19a4 4 0 0 1 5.66 5.66l-9.2 9.19a2 2 0 0 1-2.83-2.83l8.49-8.48" }),
+    folder: _jsx("path", { d: "M3 7V5a2 2 0 0 1 2-2h5l2 3h7a2 2 0 0 1 2 2v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V7Z" }),
     file: _jsxs(_Fragment, { children: [_jsx("path", { d: "M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8Z" }), _jsx("path", { d: "M14 2v6h6" }), _jsx("path", { d: "M8 13h8M8 17h6" })] }),
     image: _jsxs(_Fragment, { children: [_jsx("rect", { width: "18", height: "18", x: "3", y: "3", rx: "2" }), _jsx("circle", { cx: "9", cy: "9", r: "2" }), _jsx("path", { d: "m21 15-5-5L5 21" })] }),
     pencil: _jsxs(_Fragment, { children: [_jsx("path", { d: "m16 3 5 5L8 21H3v-5L16 3Z" }), _jsx("path", { d: "m14 5 5 5" })] }),

package/dist/react/components/McpUiSurfaceCard.js

@@ -71,6 +71,7 @@ import { useT } from '../hooks/context.js';
 import { useSurfaceExpiry } from '../hooks/useSurfaceExpiry.js';
 import { closedSurfaceLabel, reportDeliveredAnswer } from './mcp-ui-surface-state.js';
 import { surfaceQuestionInput } from './mcp-ui-question-input.js';
+import { useSurfaceRecovery } from '../hooks/useSurfaceRecovery.js';
 /** The `kind: 'ext'` event name this renderer claims. */
 export const MCP_UI_EXT_EVENT_NAME = 'mcp-ui';
 /** Collapses the event stream to the newest resource per `ui://` URI, in first-appearance order. */
@@ -147,18 +148,24 @@ function surfaceInteraction({ resource, answered, onToolCall, onAnswered, onAnsw
 /** Registered against `ext-event-renderer-registry.ts`'s `'mcp-ui'` name — see module doc. */
 export function McpUiSurfaceCard({ events, sandboxProxyUrl, onToolCall, onOpenLink, maxHeight, call, runStreaming, expiryClock, answered, onAnswered, onAnswerText, answerText, answerRecorded }) {
     const t = useT();
-    const resources = useMemo(() => latestResourcesByUri(events), [events]);
+    const originalResources = useMemo(() => latestResourcesByUri(events), [events]);
+    const recovery = useSurfaceRecovery({ resource: originalResources.length === 1 ? originalResources[0] : undefined,
+        call, runStreaming, onToolCall });
+    const resources = recovery.restored && recovery.resource ? [recovery.resource] : originalResources;
     // One card per slot is the registered shape (`mcpUiSurfaceSlotKey`), so `call` belongs to exactly
     // that card. A group holding several URIs has no single call to judge them by, and stays live.
     const single = resources.length === 1 ? resources[0] : undefined;
-    const { displayCall, input, standalone } = useSurfaceQuestionCall({ events, call });
-    const { expiresAtMs, toolCall } = surfaceInteraction({ resource: single, answered, onToolCall, onAnswered, onAnswerText, call: displayCall });
+    const currentEvents = recovery.restored && recovery.resource ? [recovery.resource] : events;
+    const currentCall = recovery.restored ? undefined : call;
+    const { displayCall, input, standalone } = useSurfaceQuestionCall({ events: currentEvents, call: currentCall });
+    const { expiresAtMs, toolCall } = surfaceInteraction({ resource: single, answered, onToolCall: recovery.onToolCall, onAnswered, onAnswerText, call: displayCall });
     const expiry = useSurfaceExpiry({ expiresAtMs }, expiryClock === undefined ? {} : { clock: expiryClock });
     const closed = single === undefined
         ? undefined
-        : closedSurfaceLabel({ t, call, runStreaming, documentsForUri: events.length, expired: expiry?.expired === true });
+        : closedSurfaceLabel({ t, call: currentCall, runStreaming: recovery.live || runStreaming,
+            documentsForUri: currentEvents.length, expired: expiry?.expired === true });
     // A completed call answered the original document; a replacement outcome or retry owns its view.
-    const answer = (events.length === 1 ? questionAnswerFromResult({ result: call?.result, input }) : undefined) ?? answerText;
+    const answer = (currentEvents.length === 1 ? questionAnswerFromResult({ result: currentCall?.result, input }) : undefined) ?? answerText;
     return _jsx(SurfaceCardContent, { resources: resources, single: single, answerRecorded: answerRecorded, answer: answer, closed: closed, call: displayCall, standalone: standalone, t: t, sandboxProxyUrl: sandboxProxyUrl, toolCall: toolCall, onOpenLink: onOpenLink, maxHeight: maxHeight, expiry: expiry });
 }
 /** A standalone form's call may lack the question; its current document supplies the title and

package/dist/react/components/MessageList.d.ts

@@ -3,6 +3,7 @@ import { type MessageRowProps } from './MessageRow.js';
 interface PendingPrompt {
     id?: string;
     text: string;
+    folders?: string[];
     attachments?: ChatAttachment[];
     onCancel: () => void;
 }

package/dist/react/components/MessageList.js

@@ -10,6 +10,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * scroll-anchoring state lives in `useMessageListAutoScroll`
  * (`MessageList.hooks.ts`); see that file for why it is presentational.
  */
+import { FolderChips } from './FolderChips.js';
 import { memo, useMemo } from 'react';
 import { projectAcceptedInputMessages } from '../../core/accepted-input.js';
 import { isTerminalRunStatus } from '../../core/index.js';
@@ -55,6 +56,6 @@ function QueuedMessage({ prompt, renderAttachment }) {
     const t = useT();
     const attachments = prompt.attachments ?? [];
     const gallery = useAttachmentGallery({ attachments });
-    return (_jsxs("div", { className: "jini-chat-pane__queued", role: "status", "aria-label": t('Message queued — not yet sent, will send once the current run finishes'), "data-testid": "chat-pane-queued", "data-agent-element": "chat-message-pending", "data-agent-role": "region", "data-agent-label": "A message queued to send once the current run finishes", children: [_jsx("div", { children: t('Queued — sends when this reply finishes') }), _jsx("div", { className: "jini-chat-pane__queued-text", children: prompt.text }), attachments.length > 0 && _jsx("div", { className: "jini-message-attachments", children: attachments.map(attachment => _jsx(SentAttachmentButton, { attachment: attachment, onOpen: gallery.open, renderAttachment: renderAttachment }, attachment.path)) }), gallery.opened !== null && _jsx(AttachmentPreviewModal, { attachment: gallery.opened, onClose: gallery.close, navigation: gallery.navigation }), _jsx("div", { className: "jini-chat-pane__queued-actions", children: _jsx("button", { type: "button", className: "jini-chat-pane__queued-cancel", onClick: () => prompt.onCancel(), title: t('Cancel queued message'), children: t('Cancel') }) })] }));
+    return (_jsxs("div", { className: "jini-chat-pane__queued", role: "status", "aria-label": t('Message queued — not yet sent, will send once the current run finishes'), "data-testid": "chat-pane-queued", "data-agent-element": "chat-message-pending", "data-agent-role": "region", "data-agent-label": "A message queued to send once the current run finishes", children: [_jsx("div", { children: t('Queued — sends when this reply finishes') }), prompt.folders?.length ? _jsx("div", { className: "jini-message-attachments", children: _jsx(FolderChips, { folders: prompt.folders }) }) : null, _jsx("div", { className: "jini-chat-pane__queued-text", children: prompt.text }), attachments.length > 0 && _jsx("div", { className: "jini-message-attachments", children: attachments.map(attachment => _jsx(SentAttachmentButton, { attachment: attachment, onOpen: gallery.open, renderAttachment: renderAttachment }, attachment.path)) }), gallery.opened !== null && _jsx(AttachmentPreviewModal, { attachment: gallery.opened, onClose: gallery.close, navigation: gallery.navigation }), _jsx("div", { className: "jini-chat-pane__queued-actions", children: _jsx("button", { type: "button", className: "jini-chat-pane__queued-cancel", onClick: () => prompt.onCancel(), title: t('Cancel queued message'), children: t('Cancel') }) })] }));
 }
 //# sourceMappingURL=MessageList.js.map

package/dist/react/components/MessageRow.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { FolderChips } from './FolderChips.js';
 import { projectAcceptedInputEvents } from '../../core/accepted-input.js';
 import { MidRunUserMessage, MID_RUN_USER_MESSAGE_EXT_EVENT_NAME } from './MidRunUserMessage.js';
 import { useSurfaceAnswerContexts } from './mcp-ui-question-input.js';
@@ -184,7 +185,7 @@ function UserMessageRow({ message, renderAttachment }) {
     // different messages opening their own attachments independently is fine and expected.
     // Previous/next steps through this message's images only.
     const gallery = useAttachmentGallery({ attachments: message.attachments ?? NO_ATTACHMENTS });
-    return (_jsxs("div", { className: "jini-message jini-message-user", "data-message-id": message.id, "data-agent-element": `chat-message-${message.id}`, "data-agent-role": "region", "data-agent-label": "A message from the user", children: [message.attachments && message.attachments.length > 0 ? (_jsx("div", { className: "jini-message-attachments", children: message.attachments.map((a) => (_jsx(SentAttachmentButton, { attachment: a, onOpen: gallery.open, renderAttachment: renderAttachment }, a.path))) })) : null, _jsx("div", { className: "jini-message-content", children: message.content }), _jsx("div", { className: "jini-message-actions jini-message-actions--user", children: _jsx(CopyMessageButton, { text: message.content, label: t('Copy message') }) }), gallery.opened ? (_jsx(AttachmentPreviewModal, { attachment: gallery.opened, onClose: gallery.close, navigation: gallery.navigation })) : null] }));
+    return (_jsxs("div", { className: "jini-message jini-message-user", "data-message-id": message.id, "data-agent-element": `chat-message-${message.id}`, "data-agent-role": "region", "data-agent-label": "A message from the user", children: [(message.attachments?.length || message.folders?.length) ? (_jsxs("div", { className: "jini-message-attachments", children: [_jsx(FolderChips, { folders: message.folders }), (message.attachments ?? []).map((a) => (_jsx(SentAttachmentButton, { attachment: a, onOpen: gallery.open, renderAttachment: renderAttachment }, a.path)))] })) : null, _jsx("div", { className: "jini-message-content", children: message.content }), _jsx("div", { className: "jini-message-actions jini-message-actions--user", children: _jsx(CopyMessageButton, { text: message.content, label: t('Copy message') }) }), gallery.opened ? (_jsx(AttachmentPreviewModal, { attachment: gallery.opened, onClose: gallery.close, navigation: gallery.navigation })) : null] }));
 }
 function AssistantMessageRow({ message, usageSummary, showUsageTotal, showUsageLine, toolCallDisplay, showThinking, runStreaming, runSending, sendingLabel, runSucceeded, questionFormInteractive, questionFormSubmittedAnswers, onQuestionFormSubmit, projectFileNames, onRequestOpenFile, }) {
     const registry = useExtEventRendererRegistry();

package/dist/react/components/MidRunUserMessage.js

@@ -10,6 +10,7 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
  * It is stored as an event of the assistant turn, not a `ChatMessage` of its own, because the agent folded it
  * into the turn it was already running — there is no separate reply to hang off it.
  */
+import { FolderChips } from './FolderChips.js';
 import { acceptedInputEvent } from '../../core/accepted-input.js';
 import { SentAttachmentButton } from './SentAttachment.js';
 import { CopyMessageButton } from './CopyMessageButton.js';
@@ -37,7 +38,7 @@ export function MidRunUserMessage({ events, runStreaming = false, transcriptRow
         return null;
     const receipt = acceptedInputEvent({ event: { kind: 'ext', name: MID_RUN_USER_MESSAGE_EVENT_NAME, data } });
     // MOVE: A single live delivery may contain several queued inputs; display their original receipts.
-    const inputs = receipt?.data.inputs ?? [{ id: field(data, 'id') ?? 'mid-run', text }];
+    const inputs = receipt?.data.inputs ?? [receipt?.data ?? { id: field(data, 'id') ?? 'mid-run', text }];
     // A run that ended without reading the message hands it to the next turn; it is no longer queued here.
     return _jsx(_Fragment, { children: inputs.map(input => _jsx(MidRunInput, { input: input, transcriptRow: transcriptRow, queued: runStreaming && (input.deliveryState ?? receipt?.data.deliveryState) === 'queued' }, input.id)) });
 }
@@ -48,7 +49,7 @@ function MidRunInput({ input, queued, transcriptRow }) {
     const t = useT();
     const attachments = input.attachments ?? [];
     const gallery = useAttachmentGallery({ attachments });
-    return (_jsxs("div", { className: `jini-message jini-message-user${transcriptRow ? '' : ' jini-message-user--mid-run'}`, "data-agent-role": "region", "data-agent-label": "A message from the user, sent while the agent was working", children: [queued && _jsx("div", { className: "jini-message-user__queued", role: "status", children: t('Queued — read after the current step') }), _jsx("div", { className: "jini-message-content", children: input.text }), attachments.length > 0 && _jsx("div", { className: "jini-message-attachments", children: attachments.map(attachment => _jsx(SentAttachmentButton, { attachment: attachment, onOpen: gallery.open }, attachment.path)) }), _jsx("div", { className: "jini-message-actions jini-message-actions--user", children: _jsx(CopyMessageButton, { text: input.text, label: t('Copy message') }) }), gallery.opened !== null && _jsx(AttachmentPreviewModal, { attachment: gallery.opened, onClose: gallery.close, navigation: gallery.navigation })] }));
+    return (_jsxs("div", { className: `jini-message jini-message-user${transcriptRow ? '' : ' jini-message-user--mid-run'}`, "data-agent-role": "region", "data-agent-label": "A message from the user, sent while the agent was working", children: [queued && _jsx("div", { className: "jini-message-user__queued", role: "status", children: t('Queued — read after the current step') }), input.folders?.length ? _jsx("div", { className: "jini-message-attachments", children: _jsx(FolderChips, { folders: input.folders }) }) : null, _jsx("div", { className: "jini-message-content", children: input.text }), attachments.length > 0 && _jsx("div", { className: "jini-message-attachments", children: attachments.map(attachment => _jsx(SentAttachmentButton, { attachment: attachment, onOpen: gallery.open }, attachment.path)) }), _jsx("div", { className: "jini-message-actions jini-message-actions--user", children: _jsx(CopyMessageButton, { text: input.text, label: t('Copy message') }) }), gallery.opened !== null && _jsx(AttachmentPreviewModal, { attachment: gallery.opened, onClose: gallery.close, navigation: gallery.navigation })] }));
 }
 /**
  * Registers {@link MidRunUserMessage} against the ext-event registry.

package/dist/react/components/ToolCard.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { formatErrorForLog } from '@jini-ai/core';
 const RUNNING_TITLE_CLASS = ' shimmer-text';
 /**
  * @module ToolCard
@@ -79,7 +80,7 @@ function renderRegistered({ use, card, registry }) {
             return node;
     }
     catch (err) {
-        console.error(`[ToolCard] custom renderer for "${use.name}" threw; falling back`, err);
+        console.error(`[ToolCard] custom renderer for "${use.name}" threw; falling back`, formatErrorForLog({ error: err }));
     }
     return undefined;
 }
@@ -124,7 +125,7 @@ function renderToolCardBody(args) {
  * The head every Jini/MCP/unknown tool row shares: status, "<Humanized Name>" (announced as
  * "Tool call · <Humanized Name>"), and the
  * target ({@link toolRowTarget}). One place, so a tool id the family table doesn't know (`content_post_update`,
- * `mcp__tovu__theme_list_files`) still reads as a label and never as its raw name and JSON args.
+ * `mcp__acme__theme_list_files`) still reads as a label and never as its raw name and JSON args.
  */
 function ToolRowHead({ name, input, result, runStreaming, runSucceeded }) {
     const t = useT();

package/dist/react/components/ToolCard.rules.js

@@ -48,7 +48,8 @@ function resultName(content) {
     const obj = parsed;
     if (isErrorResult(obj))
         return undefined;
-    const nested = Object.values(obj).filter((v) => v != null && typeof v === 'object' && !Array.isArray(v));
+    // The nested level gets the same error check: `{ result: { error, name: 'NotFoundError' } }` is still a failure.
+    const nested = Object.values(obj).filter((v) => v != null && typeof v === 'object' && !Array.isArray(v) && !isErrorResult(v));
     return firstReadable(obj, RESULT_NAME_KEYS) ?? nested.map((v) => firstReadable(v, RESULT_NAME_KEYS)).find(Boolean);
 }
 /** A batch member's own target: a readable string member, or an object member's summary key. O(k). */