@jini-ai/chat 0.6.15-rc.2 → 0.6.16

package/dist/embed-widget/vanilla/state.js

@@ -1,16 +1,15 @@
 import { assistantContentFromEvents } from '../../core/assistant-content.js';
-import { extractPageActions, splitPageActions } from '../../core/browser/page-actions.js';
 /**
- * Framework-free visitor state over the existing transport/session/page-action owners.
- * Restored messages never replay directives. Only a successful live settlement can act;
- * persistence and queued effects finish synchronously before navigation tears down the page.
+ * Framework-free visitor state over the existing transport/session owners.
+ * Restored messages never replay effects; page control belongs to the shared frontend bridge.
+ * Terminal navigation flushes the transport snapshot before the host tears down the page.
  * Reset invalidates callbacks before aborting, preventing late chunks from reviving a thread.
  * @complexity O(retained transcript + reply events + reply characters) per update; storage writes
  * occur only on settle/open/reset/navigation, never per streamed chunk. Session bounds persisted bytes.
  */
 export function createVanillaChatController(args, _options = {}) {
     const initial = args.session.load({});
-    let state = { ...initial, busy: false, error: null, proposal: null };
+    let state = { ...initial, busy: false, error: null };
     let generation = 0;
     let active = null;
     const publish = ({ persist = true } = {}) => {
@@ -18,32 +17,6 @@ export function createVanillaChatController(args, _options = {}) {
             args.session.save({ state: { open: state.open, messages: state.messages } });
         args.onChange({ state });
     };
-    const go = (proposal) => {
-        if (!args.pageActions.allows({ action: proposal.navigate }))
-            return;
-        if (proposal.bundled && args.pageActions.allows({ action: proposal.bundled }))
-            args.session.enqueue({ action: proposal.bundled });
-        state = { ...state, proposal: null };
-        publish();
-        args.pageActions.navigate({ action: proposal.navigate });
-    };
-    const settleActions = (events) => {
-        const actions = extractPageActions({ events, directiveEventName: args.directiveEventName })
-            .filter(action => args.pageActions.allows({ action }));
-        const { navigate, other } = splitPageActions({ actions });
-        if (!navigate) {
-            if (other)
-                args.pageActions.execute({ action: other });
-            return;
-        }
-        const proposal = { navigate, bundled: other };
-        if (navigate.auto)
-            go(proposal);
-        else {
-            state = { ...state, proposal };
-            publish();
-        }
-    };
     return {
         getState(_input = {}, _opts = {}) { return state; },
         setOpen({ open }, _opts = {}) { state = { ...state, open }; publish(); },
@@ -51,12 +24,13 @@ export function createVanillaChatController(args, _options = {}) {
             const content = text.trim();
             if (!content || state.busy)
                 return false;
-            const token = ++generation;
+            generation += 1;
+            const token = generation;
             const abort = args.createAbortController({});
             active = abort;
             const history = [...state.messages, { id: args.ids({}), role: 'user', content }];
             const reply = { id: args.ids({}), role: 'assistant', content: '', events: [], runStatus: 'running' };
-            state = { ...state, messages: [...history, reply], busy: true, error: null, proposal: null };
+            state = { ...state, messages: [...history, reply], busy: true, error: null };
             publish({ persist: false });
             let events = [];
             let failed = false;
@@ -80,10 +54,9 @@ export function createVanillaChatController(args, _options = {}) {
                 active = null;
                 events = final;
                 state = { ...state, busy: false };
+                const completedStatus = abort.signal.aborted ? 'canceled' : 'succeeded';
                 updateReply({ ...reply, content: assistantContentFromEvents({ events }), events: [...events],
-                    runStatus: failed ? 'failed' : abort.signal.aborted ? 'canceled' : 'succeeded' }, { persist: true });
-                if (!failed && !abort.signal.aborted)
-                    settleActions(events);
+                    runStatus: failed ? 'failed' : completedStatus }, { persist: true });
             };
             try {
                 await args.transport.startRun({ history, agentId: args.agentId, assistantMessageId: reply.id, signal: abort.signal }, {
@@ -103,15 +76,13 @@ export function createVanillaChatController(args, _options = {}) {
             }
             return true;
         },
-        acceptProposal(_input = {}, _opts = {}) { if (state.proposal)
-            go(state.proposal); },
         cancel(_input = {}, _opts = {}) { active?.abort(); },
         reset(_input = {}, _opts = {}) {
             generation += 1;
             active?.abort();
             active = null;
             args.session.clear({});
-            state = { open: state.open, messages: [], busy: false, error: null, proposal: null };
+            state = { open: state.open, messages: [], busy: false, error: null };
             publish();
         },
         dispose(_input = {}, _opts = {}) { generation += 1; active?.abort(); active = null; },

package/dist/embed-widget/vanilla/style.css

@@ -10,7 +10,7 @@
 .jini-chat-vanilla :focus-visible{outline:3px solid var(--jini-chat-accent,#2563eb);outline-offset:3px}
 .jini-chat-vanilla{font:14px/1.5 var(--font-body,system-ui,sans-serif);color:var(--jini-chat-text,var(--color-text,CanvasText))}
 .jini-chat-vanilla__panel{position:fixed;right:var(--jini-embed-right,24px);bottom:88px;width:min(var(--jini-embed-width,440px),calc(100vw - 32px));height:min(var(--jini-embed-height,620px),calc(100dvh - 120px));z-index:var(--jini-embed-z-index,1000);display:flex;flex-direction:column;background:var(--jini-chat-background,var(--color-background,Canvas));border:1px solid var(--jini-chat-border,#767676);border-radius:16px;box-shadow:0 12px 48px #0003;overflow:hidden}
-.jini-chat-vanilla__header,.jini-chat-vanilla__composer,.jini-chat-vanilla__confirmation,.jini-chat-vanilla__proposal{display:flex;align-items:center;gap:8px;padding:12px;border-bottom:1px solid var(--jini-chat-border,#767676)}
+.jini-chat-vanilla__header,.jini-chat-vanilla__composer,.jini-chat-vanilla__confirmation,.jini-chat-vanilla__tool-confirmation{display:flex;align-items:center;gap:8px;padding:12px;border-bottom:1px solid var(--jini-chat-border,#767676)}
 .jini-chat-vanilla__title{flex:1}
 .jini-chat-vanilla__button{font:inherit;color:inherit;background:transparent;border:1px solid var(--jini-chat-border,#767676);border-radius:8px;padding:6px 10px;cursor:pointer}
 .jini-chat-vanilla__button:disabled{opacity:.5;cursor:default}

package/dist/react/agent-bridge/frontend-session-bridge.d.ts

@@ -1,57 +1,3 @@
-import { type PageDriver } from '@jini-ai/agentic';
-import type { ChatPaneAgentBridgeAccess, ChatPaneAgentToolAction } from '../features/chat-pane/types.js';
-export interface FrontendSessionBridgeOptions {
-    /** Supplying one claims the six `page.*` verbs. Omit for a chat-only surface. */
-    readonly pageDriver?: PageDriver;
-    /**
-     * Product capabilities, keyed by id prefix (`'cms.'`). Each claims every capability under it.
-     * This is how a consumer exposes verbs the engine has never heard of.
-     */
-    readonly executors?: Readonly<Record<string, (capabilityId: string, input: Record<string, unknown>) => Promise<unknown>>>;
-    /** Called for every invocation before it runs — the hook a product uses to show an activity trail. */
-    readonly onInvocation?: (action: ChatPaneAgentToolAction) => void;
-    /** Reported for failures that are nobody's tool call: stream errors, malformed frames. */
-    readonly onError?: (error: unknown) => void;
-}
-/** The host supplies its origin and stream transport; native fetch defaults may be overridden. */
-export interface FrontendSessionBridgeArgs {
-    /** Pass an empty string for the same-origin proxy used by a browser host. */
-    readonly baseUrl: string;
-    readonly openStream: (args: {
-        url: string;
-    }) => EventSource;
-    readonly fetch?: typeof globalThis.fetch;
-    readonly request?: (args: {
-        url: string;
-        init: RequestInit;
-        timeoutMs: number;
-    }) => Promise<Response>;
-}
-export interface FrontendSessionBridge {
-    /** Hand this to `ChatPane`'s `agentControl.bridgeAccess`. */
-    readonly bridgeAccess: ChatPaneAgentBridgeAccess;
-    /**
-     * Resolves the *first* time the daemon attaches this surface — an "is it live yet" signal.
-     *
-     * Its `bindToken` is only correct until the next reconnect, so do not stash it. Call
-     * {@link FrontendSessionBridge.bindToken} when building a run request instead.
-     */
-    readonly ready: Promise<{
-        sessionId: string;
-        bindToken: string;
-    }>;
-    /**
-     * The token for the attachment that is live *now*, or `undefined` before the first attach and
-     * after {@link FrontendSessionBridge.close}. Read it at run-start; see the module doc.
-     */
-    bindToken(): string | undefined;
-    close(): void;
-}
-/**
- * Opens the surface's connection and starts routing invocations.
- *
- * @param options - What this page can serve and where the daemon is.
- * @returns The pane's bridge, the attach result, and a teardown.
- */
-export declare function createFrontendSessionBridge({ baseUrl: base, openStream, request, fetch }: FrontendSessionBridgeArgs, options?: FrontendSessionBridgeOptions): FrontendSessionBridge;
+/** Compatibility entry; the framework-free browser bridge owns the lifecycle. */
+export * from '../../embed-widget/browser/frontend-session-bridge.js';
 //# sourceMappingURL=frontend-session-bridge.d.ts.map

package/dist/react/agent-bridge/frontend-session-bridge.js

@@ -1,249 +1,3 @@
-/**
- * @module agent-bridge/frontend-session-bridge
- *
- * The browser half of agent-driven frontend control: one SSE connection to the daemon, and the
- * routing that turns each relayed invocation into a call on something in this page.
- *
- * Everything on the server side already existed — `FrontendSessionRegistry` addresses a run to a
- * surface, the frontend-session routes carry invocations out and answers back, and
- * `createFrontendControl` assembles them. `ChatPaneAgentBridgeAccess` declared the contract this
- * satisfies and had **zero implementations**, which is why an agent could reach a tool and the
- * tool could reach nothing.
- *
- * Design notes worth knowing before changing this:
- *
- * - **The connection is owned here, not by `subscribe`.** `ChatPaneAgentBridgeAccess.subscribe` is
- *   called by the chat pane's own effect, so tying the stream's lifetime to it would mean page
- *   control dies when the pane unmounts — and the page is drivable whether or not a chat pane
- *   exists. `subscribe` registers a listener; `close()` tears the connection down.
- * - **Capabilities are claimed from what is actually wired.** The claim sent at connect time is
- *   derived from the presence of a `pageDriver` and the keys of `executors`, never from a static
- *   list. A surface that claims what it cannot serve turns a fast, named refusal into a timeout.
- * - **An executed invocation is never executed twice.** If the stream drops between the daemon
- *   delivering an invocation and this page POSTing the answer, the daemon correctly fails that
- *   call — but the click already happened. Without the `executed` set below, the retry clicks
- *   again. Buttons are not idempotent.
- * - **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
- *   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.
- */
-import { CHAT_CAPABILITIES } from '../../core/index.js';
-import { PAGE_CAPABILITIES, executePageCapability } from '@jini-ai/agentic';
-/** How many settled invocation ids to remember for replay suppression. */
-const EXECUTED_MEMORY = 256;
-/** Ids this surface can actually serve, given what the host wired up. */
-function claimedCapabilities(options) {
-    const claims = CHAT_CAPABILITIES.map((capability) => capability.id);
-    if (options.pageDriver !== undefined) {
-        claims.push(...PAGE_CAPABILITIES.map((capability) => capability.id));
-    }
-    claims.push(...Object.keys(options.executors ?? {}));
-    return claims;
-}
-function errorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-/** Parses a frame's data into an object, or says why it is not one. */
-function parseFrameObject(data) {
-    let parsed;
-    try {
-        parsed = JSON.parse(data);
-    }
-    catch (error) {
-        return { error };
-    }
-    // `JSON.parse` succeeds on any valid JSON value, not just objects — a bare `null`, number,
-    // string or boolean parses cleanly and would throw *outside* this try/catch on the very next
-    // `frame['type']` read (`null` is the one of those that actually throws; the others just read
-    // back `undefined` harmlessly). Guarding here routes every one of those through the same
-    // `onError` path as an unparseable frame, rather than only some of them crashing the listener.
-    if (parsed === null || typeof parsed !== 'object') {
-        return { error: new Error(`malformed frame: expected a JSON object, got ${JSON.stringify(parsed)}`) };
-    }
-    return { frame: parsed };
-}
-/** Reads an `invocation` frame into the pane's action shape, refusing one with no usable id. */
-function readInvocation(frame) {
-    const rawInvocationId = frame['invocationId'];
-    if (typeof rawInvocationId !== 'string' || rawInvocationId.length === 0) {
-        return { kind: 'malformed', error: new Error('invocation frame missing invocationId') };
-    }
-    return {
-        kind: 'invocation',
-        action: {
-            invocationId: rawInvocationId,
-            capabilityId: String(frame['capabilityId']),
-            input: (frame['input'] ?? {}),
-        },
-    };
-}
-/** Classifies one frame's raw data; the listener only applies the result. */
-function readFrame(data) {
-    const parsed = parseFrameObject(data);
-    if ('error' in parsed)
-        return { kind: 'malformed', error: parsed.error };
-    const { frame } = parsed;
-    switch (frame['type']) {
-        case 'attached':
-            return { kind: 'attached', sessionId: String(frame['sessionId']), bindToken: String(frame['bindToken']) };
-        case 'error':
-            return { kind: 'refused', message: String(frame['message']) };
-        case 'invocation':
-            return readInvocation(frame);
-        default:
-            // Unknown frame types are ignored rather than treated as errors, so the daemon's event
-            // vocabulary can grow without every deployed surface needing to ship first.
-            return { kind: 'ignored' };
-    }
-}
-/**
- * Opens the surface's connection and starts routing invocations.
- *
- * @param options - What this page can serve and where the daemon is.
- * @returns The pane's bridge, the attach result, and a teardown.
- */
-export function createFrontendSessionBridge({ baseUrl: base, openStream, request, fetch }, options = {}) {
-    const capabilities = claimedCapabilities(options);
-    // 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;
-    /** Replaced on every reattach; a promise resolved once could never carry this. */
-    let currentBindToken;
-    // Definite assignment rather than no-op placeholders: a Promise executor runs synchronously, so
-    // both are set before this line finishes, and placeholders would only add two functions that
-    // can never be called.
-    let resolveReady;
-    let rejectReady;
-    const ready = new Promise((resolve, reject) => {
-        resolveReady = resolve;
-        rejectReady = reject;
-    });
-    /** Chat-pane listeners. The pane registers exactly one; a second host could register another. */
-    const chatListeners = new Set();
-    /** Invocation ids already run here, so a stream reconnect cannot double-click a button. */
-    const executed = new Set();
-    const query = capabilities.map((id) => `capability=${encodeURIComponent(id)}`).join('&');
-    const source = openStream({ url: `${base}/api/frontend-sessions/stream?${query}` });
-    async function respond(invocationId, body) {
-        if (sessionId === undefined)
-            throw new Error('the surface is not attached yet');
-        const response = await send({
-            url: `${base}/api/frontend-sessions/${encodeURIComponent(sessionId)}/responses`,
-            init: { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ invocationId, ...body }) },
-            timeoutMs: 15_000,
-        });
-        if (!response.ok)
-            throw new Error(`answering "${invocationId}" failed: ${response.status}`);
-    }
-    const respondSuccess = (invocationId, output) => respond(invocationId, { ok: true, output });
-    const respondError = (invocationId, message) => respond(invocationId, { ok: false, message });
-    /** Runs one non-chat invocation here and answers it. Chat ones go to the pane instead. */
-    async function serveLocally(action) {
-        let output;
-        try {
-            if (options.pageDriver !== undefined && action.capabilityId.startsWith('page.')) {
-                output = await executePageCapability({ driver: options.pageDriver, capabilityId: action.capabilityId, input: action.input });
-            }
-            else {
-                const entry = Object.entries(options.executors ?? {})
-                    .find(([prefix]) => action.capabilityId.startsWith(prefix));
-                if (entry === undefined)
-                    throw new Error(`nothing on this page serves "${action.capabilityId}"`);
-                output = await entry[1](action.capabilityId, action.input);
-            }
-        }
-        catch (error) {
-            await respondError(action.invocationId, errorMessage(error)).catch(options.onError ?? (() => undefined));
-            return;
-        }
-        await respondSuccess(action.invocationId, output).catch(options.onError ?? (() => undefined));
-    }
-    function remember(invocationId) {
-        executed.add(invocationId);
-        if (executed.size > EXECUTED_MEMORY) {
-            const oldest = executed.values().next().value;
-            if (oldest !== undefined)
-                executed.delete(oldest);
-        }
-    }
-    /** Runs one well-formed invocation: replay check, announcement, then pane or local serving. */
-    function handleInvocation(action) {
-        // A redelivery after a dropped answer must not re-run the side effect.
-        if (executed.has(action.invocationId)) {
-            void respondError(action.invocationId, 'already executed on this surface').catch(() => undefined);
-            return;
-        }
-        remember(action.invocationId);
-        options.onInvocation?.(action);
-        if (action.capabilityId.startsWith('chat.')) {
-            for (const listener of chatListeners)
-                listener(action);
-            return;
-        }
-        void serveLocally(action);
-    }
-    source.addEventListener('message', (event) => {
-        const frame = readFrame(event.data);
-        switch (frame.kind) {
-            case 'attached':
-                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':
-                return;
-        }
-    });
-    source.addEventListener('error', (event) => {
-        // 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);
-    });
-    const bridgeAccess = {
-        subscribe(onAction) {
-            chatListeners.add(onAction);
-            // Removes this listener only. The connection outlives any one pane — see the module doc.
-            return () => chatListeners.delete(onAction);
-        },
-        respondSuccess,
-        respondError,
-    };
-    return {
-        bridgeAccess,
-        ready,
-        bindToken: () => currentBindToken,
-        close() {
-            source.close();
-            chatListeners.clear();
-            // 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;
-        },
-    };
-}
+/** Compatibility entry; the framework-free browser bridge owns the lifecycle. */
+export * from '../../embed-widget/browser/frontend-session-bridge.js';
 //# sourceMappingURL=frontend-session-bridge.js.map

package/dist/react/components/AttachmentPreviewModal.hooks.js

@@ -154,7 +154,8 @@ export function useAttachmentPreviewModal({ attachment, onClose, navigation }, {
     const cachedFile = getAttachmentPreviewSource({ path: attachment.path });
     const attemptImage = !imageFailed && cachedFile !== undefined && looksLikeImageAttachment({ attachment: attachment }) && canCreateObjectUrl();
     const attemptText = !attemptImage && cachedFile !== undefined && looksLikeTextAttachment(attachment.name);
-    const status = attemptImage ? 'image' : attemptText ? 'text' : 'unsupported';
+    const fallbackStatus = attemptText ? 'text' : 'unsupported';
+    const status = attemptImage ? 'image' : fallbackStatus;
     // Object URL: created/revoked in an effect (not `useMemo`) so a React 18 Strict Mode double-render
     // can never create two URLs and revoke only one — the cleanup below always pairs with the create
     // that produced the URL currently in state.

package/dist/react/components/ChatSettingsDialog.js

@@ -24,7 +24,7 @@ export function ChatSettingsDialog(required, _optional = {}) {
     useLayoutEffect(() => {
         const dialog = dialogRef.current;
         if (!dialog || !required.open)
-            return;
+            return undefined;
         openerRef.current = document.activeElement;
         if (typeof dialog.showModal === 'function') {
             if (!dialog.open)
@@ -47,7 +47,7 @@ export function ChatSettingsDialog(required, _optional = {}) {
     // layout cleanups and would pull focus straight back to the closing dialog's × button.
     useEffect(() => {
         if (!required.open)
-            return;
+            return undefined;
         return () => {
             const opener = openerRef.current;
             if (opener instanceof HTMLElement && opener.isConnected)
@@ -60,13 +60,22 @@ export function ChatSettingsDialog(required, _optional = {}) {
             if (event.target !== event.currentTarget)
                 return;
             const { clientX: x, clientY: y } = event, box = event.currentTarget.getBoundingClientRect();
-            if ((x === 0 && y === 0) || x < box.left || x > box.right || y < box.top || y > box.bottom)
+            const horizontalOutside = x < box.left || x > box.right;
+            const verticalOutside = y < box.top || y > box.bottom;
+            if ((x === 0 && y === 0) || horizontalOutside || verticalOutside)
                 required.onClose();
-        }, children: [_jsxs("header", { className: "jini-chat-settings-header", children: [_jsx("h2", { id: titleId, className: "jini-dialog-title", children: vm.t('Chat settings') }), _jsx("button", { ref: closeRef, type: "button", className: "jini-dialog-close jini-chat-settings-close", "aria-label": vm.t('Close'), onClick: required.onClose, children: _jsx("span", { "aria-hidden": "true", children: "\u00D7" }) })] }), _jsx(TabBar, { tabs: vm.tabs, activeId: vm.tab, onChange: vm.setTab, ariaLabel: vm.t('Chat settings') }), _jsx("div", { className: "jini-chat-settings-body", role: "tabpanel", "aria-label": vm.tab === 'display' ? vm.t('Display') : vm.t('Agent permissions'), children: vm.tab === 'display' ? vm.display.map(section => section.radio
-                    // One ⓘ for the whole choice, beside the legend (owner, 2026-10-18), not one per option. The
-                    // fieldset is named by the label span alone, so the tip's text never joins the group's name.
-                    ? _jsxs("fieldset", { className: "jini-chat-settings-group", "aria-labelledby": section.label ? section.labelId : undefined, "aria-describedby": [section.hint ? section.hintId : '', section.tooltip ? section.tooltipId : ''].filter(Boolean).join(' ') || undefined, children: [section.label && _jsxs("legend", { className: "jini-chat-settings-legend", children: [_jsx("span", { id: section.labelId, children: section.label }), section.tooltip && _jsx(InfoTip, { label: section.tooltip, descriptionId: section.tooltipId })] }), section.hint && _jsx("p", { id: section.hintId, className: "jini-chat-settings-description jini-chat-settings-description--group", children: section.hint }), _jsx(ChatSettingsSegmented, { name: section.name, items: section.items })] }, section.key)
-                    : _jsxs("fieldset", { className: "jini-chat-settings-group", children: [section.label && _jsx("legend", { className: "jini-chat-settings-legend", children: section.label }), section.items.map(item => _jsx(SettingSwitch, { label: item.label, checked: !!item.checked, disabled: item.disabled, onChange: item.change, description: item.hint, descriptionId: item.hintId, tooltip: item.tooltip }, item.key))] }, section.key))
-                    : _jsxs(_Fragment, { children: [_jsx("p", { className: "jini-chat-settings-note", children: vm.t('Permission changes apply to the next run.') }), vm.permissions.unavailableReason && _jsx("p", { className: "jini-chat-settings-note", children: vm.t(vm.permissions.unavailableReason) }), _jsx(SettingSwitch, { className: "jini-chat-settings-row--master", label: vm.master.label, checked: vm.master.checked, disabled: vm.master.disabled, onChange: checked => vm.master.onCheckedChange({ checked }), description: vm.master.description, descriptionId: vm.master.descriptionId }), _jsx("div", { className: "jini-chat-settings-capabilities", children: vm.capabilities.map(item => _jsx(SettingSwitch, { label: item.control.label, checked: item.control.checked, disabled: item.control.disabled, onChange: checked => item.control.onCheckedChange({ checked }), description: item.description, descriptionId: item.descriptionId }, item.key)) }), vm.permissions.busy && _jsx("p", { role: "status", className: "jini-chat-settings-note", children: vm.t('Saving…') }), vm.permissions.error && _jsx("p", { role: "alert", className: "jini-chat-settings-error", children: vm.permissions.error })] }) })] });
+        }, children: [_jsxs("header", { className: "jini-chat-settings-header", children: [_jsx("h2", { id: titleId, className: "jini-dialog-title", children: vm.t('Chat settings') }), _jsx("button", { ref: closeRef, type: "button", className: "jini-dialog-close jini-chat-settings-close", "aria-label": vm.t('Close'), onClick: required.onClose, children: _jsx("span", { "aria-hidden": "true", children: "\u00D7" }) })] }), _jsx(TabBar, { tabs: vm.tabs, activeId: vm.tab, onChange: vm.setTab, ariaLabel: vm.t('Chat settings') }), _jsx("div", { className: "jini-chat-settings-body", role: "tabpanel", "aria-label": vm.tab === 'display' ? vm.t('Display') : vm.t('Agent permissions'), children: vm.tab === 'display' ? vm.display.map(renderDisplaySection)
+                    : renderPermissions(vm) })] });
+}
+function renderDisplaySection(section) {
+    if (section.radio)
+        return (
+        // One ⓘ for the whole choice, beside the legend (owner, 2026-10-18), not one per option. The
+        // fieldset is named by the label span alone, so the tip's text never joins the group's name.
+        _jsxs("fieldset", { className: "jini-chat-settings-group", "aria-labelledby": section.label ? section.labelId : undefined, "aria-describedby": [section.hint ? section.hintId : '', section.tooltip ? section.tooltipId : ''].filter(Boolean).join(' ') || undefined, children: [section.label && _jsxs("legend", { className: "jini-chat-settings-legend", children: [_jsx("span", { id: section.labelId, children: section.label }), section.tooltip && _jsx(InfoTip, { label: section.tooltip, descriptionId: section.tooltipId })] }), section.hint && _jsx("p", { id: section.hintId, className: "jini-chat-settings-description jini-chat-settings-description--group", children: section.hint }), _jsx(ChatSettingsSegmented, { name: section.name, items: section.items })] }, section.key));
+    return _jsxs("fieldset", { className: "jini-chat-settings-group", children: [section.label && _jsx("legend", { className: "jini-chat-settings-legend", children: section.label }), section.items.map(item => _jsx(SettingSwitch, { label: item.label, checked: !!item.checked, disabled: item.disabled, onChange: item.change, description: item.hint, descriptionId: item.hintId, tooltip: item.tooltip }, item.key))] }, section.key);
+}
+function renderPermissions(vm) {
+    return _jsxs(_Fragment, { children: [_jsx("p", { className: "jini-chat-settings-note", children: vm.t('Permission changes apply to the next run.') }), vm.permissions.unavailableReason && _jsx("p", { className: "jini-chat-settings-note", children: vm.t(vm.permissions.unavailableReason) }), _jsx(SettingSwitch, { className: "jini-chat-settings-row--master", label: vm.master.label, checked: vm.master.checked, disabled: vm.master.disabled, onChange: checked => vm.master.onCheckedChange({ checked }), description: vm.master.description, descriptionId: vm.master.descriptionId }), _jsx("div", { className: "jini-chat-settings-capabilities", children: vm.capabilities.map(item => _jsx(SettingSwitch, { label: item.control.label, checked: item.control.checked, disabled: item.control.disabled, onChange: checked => item.control.onCheckedChange({ checked }), description: item.description, descriptionId: item.descriptionId }, item.key)) }), vm.permissions.busy && _jsx("p", { role: "status", className: "jini-chat-settings-note", children: vm.t('Saving…') }), vm.permissions.error && _jsx("p", { role: "alert", className: "jini-chat-settings-error", children: vm.permissions.error })] });
 }
 //# sourceMappingURL=ChatSettingsDialog.js.map

package/dist/react/components/Composer.js

@@ -114,11 +114,11 @@ export function Composer({ composer, onSend, disabled = false, sendDisabled = fa
      */
     useEffect(() => {
         if (!anyPopoverOpen(popovers))
-            return;
+            return undefined;
         const textarea = textareaRef.current;
         const composerRoot = textarea?.closest('.jini-composer');
         if (!composerRoot)
-            return;
+            return undefined;
         function handleOutsideMouseDown(event) {
             const target = event.target;
             if (!target)
@@ -327,7 +327,7 @@ export function Composer({ composer, onSend, disabled = false, sendDisabled = fa
                 }, onKeyDown: handleKeyDown, 
                 // Draft persistence is debounced (see `DRAFT_PERSIST_DEBOUNCE_MS`); leaving the field is a
                 // natural point to make it durable now.
-                onBlur: () => composer.flushDraft?.(), onPaste: handleAttachmentPaste, ...slashTextareaAria(slashOpen, slashActiveOption), rows: 3 }), slashOpen ? (_jsx(ComposerSlashMenu, { matches: slash.matches, activeIndex: slashActiveOption, onSelect: selectSlashItem, showFilterHint: slash.showFilterHint, style: slashMenuPosition, t: t })) : null, _jsxs("div", { className: "jini-composer-footer", children: [_jsx(ComposerAttachButton, { attachmentPicker: attachmentPicker, hidden: hasDiscoveryItems, disabled: disabled, inputRef: attachmentInputRef, onChange: handleAttachmentChange, t: t }), _jsx(ComposerDiscoveryMenu, { groups: discoveryGroups, open: discoveryMenuOpen, disabled: disabled, ...(attachmentPicker ? { attachmentPicker } : {}), attachmentInputRef: attachmentInputRef, onToggle: () => setDiscoveryMenuOpen((open) => !open), onClose: () => setDiscoveryMenuOpen(false), onSelect: selectPlusItem, onAttachmentChange: handleAttachmentChange, style: discoveryMenuPosition, t: t }), _jsx(AccessorySlot, { className: "jini-composer-footer-leading", children: footerLeadingAccessory }), _jsx(ComposerWorkdirControl, { workingDirectory: workingDirectory, onChangeWorkingDirectory: onChangeWorkingDirectory, onPickWorkingDirectory: onPickWorkingDirectory, disabled: disabled, open: workdirOpen, draft: workdirDraft, position: workdirPosition, onToggle: toggleWorkdir, onDraftChange: setWorkdirDraft, onConfirm: confirmWorkdir, onClose: () => setWorkdirOpen(false), t: t }), _jsx(AccessorySlot, { className: "jini-composer-footer-accessories", children: footerAccessories }), _jsx(ComposerPlusMenu, { items: plusMenuItems, t: t }), _jsx(ComposerSendGroup, { running: running, disabled: disabled, sendDisabled: sendDisabled, canSubmit: composer.canSubmit, onSend: onSend, onCancel: onCancel, sendDisabledReason: sendDisabledReason, sendDisabledReasonId: sendDisabledReasonId, t: t })] })] }));
+                onBlur: () => composer.flushDraft?.(), onPaste: handleAttachmentPaste, ...slashTextareaAria(slashOpen, slashActiveOption), rows: 3 }), slashOpen ? (_jsx(ComposerSlashMenu, { matches: slash.matches, activeIndex: slashActiveOption, onSelect: selectSlashItem, showFilterHint: slash.showFilterHint, style: slashMenuPosition, t: t })) : null, _jsxs("div", { className: "jini-composer-footer", children: [_jsx(ComposerAttachButton, { attachmentPicker: attachmentPicker, hidden: hasDiscoveryItems, disabled: disabled, inputRef: attachmentInputRef, onChange: handleAttachmentChange, t: t }), _jsx(ComposerDiscoveryMenu, { groups: discoveryGroups, open: discoveryMenuOpen, disabled: disabled, ...(attachmentPicker ? { attachmentPicker } : {}), attachmentInputRef: attachmentInputRef, onToggle: () => setDiscoveryMenuOpen((open) => !open), onClose: () => setDiscoveryMenuOpen(false), onSelect: selectPlusItem, onAttachmentChange: handleAttachmentChange, style: discoveryMenuPosition, t: t }), _jsx(AccessorySlot, { className: "jini-composer-footer-leading", children: footerLeadingAccessory }), _jsx(ComposerWorkdirControl, { workingDirectory: workingDirectory, onChangeWorkingDirectory: onChangeWorkingDirectory, onPickWorkingDirectory: onPickWorkingDirectory, disabled: disabled, open: workdirOpen, draft: workdirDraft, position: workdirPosition, onToggle: toggleWorkdir, onDraftChange: setWorkdirDraft, onConfirm: confirmWorkdir, onClose: () => setWorkdirOpen(false), t: t }), _jsxs("div", { className: "jini-composer-footer-trailing", children: [_jsx(AccessorySlot, { className: "jini-composer-footer-accessories", children: footerAccessories }), _jsx(ComposerPlusMenu, { items: plusMenuItems, t: t }), _jsx(ComposerSendGroup, { running: running, disabled: disabled, sendDisabled: sendDisabled, canSubmit: composer.canSubmit, onSend: onSend, onCancel: onCancel, sendDisabledReason: sendDisabledReason, sendDisabledReasonId: sendDisabledReasonId, t: t })] })] })] }));
 }
 function anyPopoverOpen({ discoveryMenuOpen, slashOpen, workdirOpen }) {
     return discoveryMenuOpen || slashOpen || workdirOpen;
@@ -380,8 +380,9 @@ function ComposerWorkdirControl({ workingDirectory, onChangeWorkingDirectory, on
                             if (e.key === 'Enter') {
                                 e.preventDefault();
                                 onConfirm();
+                                return;
                             }
-                            else if (e.key === 'Escape') {
+                            if (e.key === 'Escape') {
                                 e.preventDefault();
                                 onClose();
                             }

package/dist/react/components/ConversationList.js

@@ -105,7 +105,7 @@ export function ConversationList({ conversations: savedConversations, activeConv
     // nothing on every document event.
     useEffect(() => {
         if (!open)
-            return;
+            return undefined;
         // The root div is committed before any effect runs, so it is never null here. Capturing it
         // (rather than reading the ref per event) keeps a late event during unmount, after React has
         // detached the ref but before this cleanup runs, measured against the real node.
@@ -135,10 +135,10 @@ export function ConversationList({ conversations: savedConversations, activeConv
     }, [open]);
     useEffect(() => {
         if (!onSearch)
-            return;
+            return undefined;
         if (!deferredQuery) {
             setServerResults(null);
-            return;
+            return undefined;
         }
         // `cancelled` guards the classic out-of-order response: a slow query for "a" resolving after
         // a fast one for "abc" would otherwise overwrite the newer, correct results.
@@ -190,6 +190,7 @@ export function ConversationList({ conversations: savedConversations, activeConv
         });
     }, [confirmDelete, onDelete, t]);
     const active = conversations.find((c) => c.id === activeConversationId) ?? null;
+    const emptyLabel = () => conversations.length === 0 ? emptyState ?? t('No conversations yet') : t('No conversations match');
     return (_jsxs("div", { className: "jini-conv", ref: rootRef, children: [_jsx("button", { type: "button", className: `jini-conv-trigger${open ? ' jini-conv-trigger-open' : ''}`, "aria-haspopup": "menu", "aria-expanded": open, ...conversationTriggerAttributes({ activeTitle: active?.title, t }, { label: triggerLabel, nativeTitle }), "data-testid": "conversation-trigger", onClick: () => setOpen((v) => !v), children: _jsx(Icon, { name: "comment", size: 16 }) }), open ? (_jsxs("div", { className: "jini-conv-menu", role: "menu", "data-testid": "conversation-menu", children: [_jsxs("div", { className: "jini-conv-head", children: [_jsxs("span", { className: "jini-conv-heading", children: [t('Conversations'), _jsx("span", { className: "jini-conv-count", "data-testid": "conversation-count", children: conversations.length })] }), _jsxs("button", { type: "button", className: "jini-conv-new", disabled: createDisabled, "data-testid": "conversation-new", 
                                 // `disabled` alone guards this: a disabled button never dispatches a click.
                                 onClick: () => {
@@ -199,7 +200,7 @@ export function ConversationList({ conversations: savedConversations, activeConv
                                     // the remaining gap between "switcher closed" and "the host actually knows".
                                     runConversationListHostEffect('onCreate', () => onCreate());
                                     setOpen(false);
-                                }, children: [_jsx(Icon, { name: "plus", size: 12 }), _jsx("span", { children: t('New') })] })] }), _jsxs("label", { className: "jini-conv-search", children: [_jsx(Icon, { name: "search", size: 13 }), _jsx("input", { type: "search", value: query, placeholder: t('Search conversations'), "data-testid": "conversation-search", onChange: (event) => setQuery(event.currentTarget.value) })] }), _jsx("div", { className: "jini-conv-list", "data-testid": "conversation-list", children: conversations.length === 0 ? (_jsx("div", { className: "jini-conv-empty", children: emptyState ?? t('No conversations yet') })) : visible.length === 0 ? (_jsx("div", { className: "jini-conv-empty", children: t('No conversations match') })) : (visible.map((item) => (_jsxs("div", { className: `jini-conv-item${item.id === activeConversationId ? ' jini-conv-item-active' : ''}`, "data-testid": `conversation-item-${item.id}`, children: [editingId === item.id ? (_jsx(ConversationTitleEditor, { title: rawTitles.get(item.id) ?? null, "data-testid": `conversation-rename-${item.id}`, onCommit: (next) => commitRename(item.id, next), onCancel: () => setEditingId(null) })) : (_jsxs("button", { type: "button", className: "jini-conv-item-select", "data-testid": `conversation-select-${item.id}`, title: t('Double-click to rename'), onClick: () => {
+                                }, children: [_jsx(Icon, { name: "plus", size: 12 }), _jsx("span", { children: t('New') })] })] }), _jsxs("label", { className: "jini-conv-search", children: [_jsx(Icon, { name: "search", size: 13 }), _jsx("input", { type: "search", value: query, placeholder: t('Search conversations'), "data-testid": "conversation-search", onChange: (event) => setQuery(event.currentTarget.value) })] }), _jsx("div", { className: "jini-conv-list", "data-testid": "conversation-list", children: conversations.length === 0 || visible.length === 0 ? (_jsx("div", { className: "jini-conv-empty", children: emptyLabel() })) : (visible.map((item) => (_jsxs("div", { className: `jini-conv-item${item.id === activeConversationId ? ' jini-conv-item-active' : ''}`, "data-testid": `conversation-item-${item.id}`, children: [editingId === item.id ? (_jsx(ConversationTitleEditor, { title: rawTitles.get(item.id) ?? null, "data-testid": `conversation-rename-${item.id}`, onCommit: (next) => commitRename(item.id, next), onCancel: () => setEditingId(null) })) : (_jsxs("button", { type: "button", className: "jini-conv-item-select", "data-testid": `conversation-select-${item.id}`, title: t('Double-click to rename'), onClick: () => {
                                         cancelPendingSelect();
                                         pendingSelectRef.current = setTimeout(() => {
                                             pendingSelectRef.current = null;

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';
+export type IconName = 'spinner' | 'check' | 'close' | 'chevron-down' | 'chevron-left' | 'chevron-right' | 'attach' | '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

@@ -6,6 +6,7 @@ const ICON_GLYPHS = {
     check: _jsx("path", { d: "M20 6 9 17l-5-5" }),
     close: CROSS,
     x: CROSS,
+    retry: _jsxs(_Fragment, { children: [_jsx("path", { d: "M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8" }), _jsx("path", { d: "M3 3v5h5" })] }),
     'chevron-down': _jsx("path", { d: "m6 9 6 6 6-6" }),
     /** Conversation-switcher trigger — a speech bubble reads as "chat history" without a label. */
     comment: (_jsx("path", { d: "M21 11.5a8.38 8.38 0 0 1-.9 3.8 8.5 8.5 0 0 1-7.6 4.7 8.38 8.38 0 0 1-3.8-.9L3 21l1.9-5.7a8.38 8.38 0 0 1-.9-3.8 8.5 8.5 0 0 1 4.7-7.6 8.38 8.38 0 0 1 3.8-.9h.5a8.48 8.48 0 0 1 8 8v.5z" })),

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

@@ -2,4 +2,5 @@ export interface MarkdownProps {
     children: string;
 }
 export declare function Markdown({ children }: MarkdownProps): import("react").JSX.Element;
+export declare const SAFE_LINK_HREF: RegExp;
 //# sourceMappingURL=Markdown.d.ts.map