@jini-ai/chat 0.3.11 → 0.5.0

package/dist/react/features/chat-pane/components/ChatPane.js

@@ -108,11 +108,11 @@ function resolveComposerAttachmentPicker(uploadAttachments, pane, attachmentAcce
     if (uploadAttachments === undefined)
         return {};
     return {
-        attachmentPicker: definedProps({
-            onFiles: pane.addAttachments,
-            uploading: pane.isUploadingAttachments,
-            accept: attachmentAccept,
-        }),
+        attachmentPicker: definedProps({ source: {
+                onFiles: pane.addAttachments,
+                uploading: pane.isUploadingAttachments,
+                accept: attachmentAccept,
+            } }),
     };
 }
 /**
@@ -169,7 +169,7 @@ function ChatPaneComposerArea({ fileDrop, uploadAttachments, pane, disabled, una
                 // rather than refusing it, so the operator can keep writing while the agent thinks.
                 disabled: disabled || unavailable, 
                 // The one blocker `send()` handles itself. Every other refusal still greys out the button.
-                sendDisabled: !pane.canSend && pane.sendBlocker !== 'streaming', running: pane.conversation.isStreaming, onCancel: pane.conversation.cancel, onInterrupt: pane.interruptSend, ...definedProps({ placeholder }), slots: slots, ...resolveComposerAttachmentPicker(uploadAttachments, pane, attachmentAccept), ...resolveComposerWorkingDirectory(workingDirectoryAccess, workingDirectoryControlPlacement, pane) }), _jsx(ChatPaneWorkingDirectoryBlock, { workingDirectoryAccess: workingDirectoryAccess, workingDirectoryControlPlacement: workingDirectoryControlPlacement, pane: pane, t: t })] }));
+                sendDisabled: !pane.canSend && pane.sendBlocker !== 'streaming', running: pane.conversation.isStreaming, onCancel: pane.conversation.cancel, onInterrupt: pane.interruptSend, ...definedProps({ source: { placeholder } }), slots: slots, ...resolveComposerAttachmentPicker(uploadAttachments, pane, attachmentAccept), ...resolveComposerWorkingDirectory(workingDirectoryAccess, workingDirectoryControlPlacement, pane) }), _jsx(ChatPaneWorkingDirectoryBlock, { workingDirectoryAccess: workingDirectoryAccess, workingDirectoryControlPlacement: workingDirectoryControlPlacement, pane: pane, t: t })] }));
 }
 /**
  * Renders the self-contained chat-pane composition, including runtime and
@@ -180,37 +180,37 @@ function ChatPaneComposerArea({ fileDrop, uploadAttachments, pane, disabled, una
  */
 export function ChatPane({ transport, agents: injectedAgents = EMPTY_AGENTS, runtimeAccess, runtimeStatusPollMs = 5_000, title, variant = 'workspace', initialMessages, conversationId, initialSelection, selection: controlledSelection, onSelectionChange, runContext, agentControl, onActivityChange, onMessagesChange, onRescanAgents, scanningAgents = false, daemonOnline = true, executionMode = 'local', apiModeAvailable = false, onExecutionModeChange, byokRuntime, onByokModelChange, initialDraft, validateAttachments, composerHandle, placeholder, placeholders, suggestions = [], workingDirectory, initialWorkingDirectory, onChangeWorkingDirectory, workingDirectoryAccess, workingDirectoryControlPlacement = 'below', projectFileNames, uploadAttachments, attachmentAccept, disabled = false, runtimePickerPlacement = 'up', composerSlots, header, leadingAccessory, footer, className, style, }) {
     const t = useT();
-    const composerPlaceholder = useChatPaneComposerPlaceholder(placeholder, placeholders);
-    const inventory = useChatPaneRuntimeInventory(definedProps({
-        access: runtimeAccess,
-        initialAgents: injectedAgents,
-        pollIntervalMs: runtimeStatusPollMs,
-    }));
+    const composerPlaceholder = useChatPaneComposerPlaceholder({ placeholder: placeholder, placeholders: placeholders });
+    const inventory = useChatPaneRuntimeInventory(definedProps({ source: {
+            access: runtimeAccess,
+            initialAgents: injectedAgents,
+            pollIntervalMs: runtimeStatusPollMs,
+        } }));
     const runtimeView = resolveRuntimeAccessView(runtimeAccess, injectedAgents, scanningAgents, daemonOnline, onRescanAgents, inventory);
     // Computed once and threaded into both `useChatPane` (so `sendBlocker` agrees) and this
     // component's own `unavailable` below (so the status banner and composer agree) — see
     // `isChatPaneApiModeConfigured` for why API mode alone isn't enough.
     const apiModeConfigured = isChatPaneApiModeConfigured({ executionMode, apiModeAvailable, byokRuntime });
-    const pane = useChatPane(definedProps({
-        transport,
-        agents: runtimeView.agents,
-        initialMessages,
-        conversationId,
-        initialSelection,
-        selection: controlledSelection,
-        onSelectionChange,
-        runContext,
-        initialDraft,
-        validateAttachments,
-        uploadAttachments,
-        onActivityChange,
-        onMessagesChange,
-        workingDirectory,
-        initialWorkingDirectory,
-        onChangeWorkingDirectory,
-        workingDirectoryAccess,
-        apiModeConfigured,
-    }));
+    const pane = useChatPane(definedProps({ source: {
+            transport,
+            agents: runtimeView.agents,
+            initialMessages,
+            conversationId,
+            initialSelection,
+            selection: controlledSelection,
+            onSelectionChange,
+            runContext,
+            initialDraft,
+            validateAttachments,
+            uploadAttachments,
+            onActivityChange,
+            onMessagesChange,
+            workingDirectory,
+            initialWorkingDirectory,
+            onChangeWorkingDirectory,
+            workingDirectoryAccess,
+            apiModeConfigured,
+        } }));
     // Mirrors `Composer.tsx`'s own `draftRef`: `composerHandle.insertText` (below) is called from
     // OUTSIDE any render, so it cannot close over `pane.composer.draft` directly — that would freeze
     // it at whatever the draft was on the render that captured it. Reassigned unconditionally every
@@ -222,7 +222,7 @@ export function ChatPane({ transport, agents: injectedAgents = EMPTY_AGENTS, run
             return;
         composerHandle.current = {
             insertText: (text) => {
-                pane.composer.setDraft(appendComposerDiscovery(composerDraftRef.current, text));
+                pane.composer.setDraft(appendComposerDiscovery({ draft: composerDraftRef.current, insertText: text }));
             },
         };
         return () => {
@@ -236,11 +236,11 @@ export function ChatPane({ transport, agents: injectedAgents = EMPTY_AGENTS, run
     // No `runContext` here on purpose: agent-driven sends go through `pane.sendPrompt`, which builds
     // the context from the SAME `runContext` already handed to `useChatPane` above. A second copy
     // would be a second source of truth that could silently drift from the composer's.
-    useChatPaneAgentControl(pane, definedProps({
-        enabled: agentControl?.enabled ?? false,
-        bridgeAccess: agentControl?.bridgeAccess,
-        webmcp: agentControl?.webmcp,
-    }));
+    useChatPaneAgentControl({ pane: pane }, definedProps({ source: {
+            enabled: agentControl?.enabled ?? false,
+            bridgeAccess: agentControl?.bridgeAccess,
+            webmcp: agentControl?.webmcp,
+        } }));
     // Selection resolution only returns available agents, so absence normally means nothing usable
     // is selected — except a configured BYOK turn (`apiModeConfigured`, computed above), which calls
     // the provider directly over HTTP and never touches the CLI inventory.
@@ -256,11 +256,11 @@ export function ChatPane({ transport, agents: injectedAgents = EMPTY_AGENTS, run
     // `composerSlots`'s type excludes both `leadingAccessories` and `footerAccessories` (see
     // `ChatPaneProps.composerSlots`'s doc), so the two explicit keys below are never overwriting a
     // caller-supplied value — they are the ONLY source for both.
-    const slots = definedProps({
-        ...composerSlots,
-        leadingAccessories: leadingAccessory,
-        footerAccessories: (_jsx(AgentRuntimePicker, { agents: runtimeView.agents, value: pane.selection, onChange: pane.setSelection, ...definedProps({ onRescan: runtimeView.rescanAgents }), scanning: runtimeView.scanningAgents, daemonOnline: runtimeView.daemonOnline, placement: runtimePickerPlacement, executionMode: executionMode, apiModeAvailable: apiModeAvailable, ...definedProps({ onExecutionModeChange, byokRuntime, onByokModelChange }) })),
-    });
+    const slots = definedProps({ source: {
+            ...composerSlots,
+            leadingAccessories: leadingAccessory,
+            footerAccessories: (_jsx(AgentRuntimePicker, { agents: runtimeView.agents, value: pane.selection, onChange: pane.setSelection, ...definedProps({ source: { onRescan: runtimeView.rescanAgents } }), scanning: runtimeView.scanningAgents, daemonOnline: runtimeView.daemonOnline, placement: runtimePickerPlacement, executionMode: executionMode, apiModeAvailable: apiModeAvailable, ...definedProps({ source: { onExecutionModeChange, byokRuntime, onByokModelChange } }) })),
+        } });
     const { rootRef, controlsRef } = useChatPaneControlsHeight();
     return (_jsxs("section", { className: chatPaneClassName(variant, className), style: style, "data-activity": pane.activity, ref: rootRef, children: [_jsx("style", { "data-jini-chat-pane-styles": "true", children: CHAT_PANE_STYLES }), resolveChatPaneHeader(header, title, pane.reset, t), _jsxs("div", { className: "jini-chat-pane__body", children: [_jsx(MessageList, { messages: pane.conversation.messages, isStreaming: pane.conversation.isStreaming, scrollIntent: pane.conversation.scrollIntent, onScrolled: pane.conversation.acknowledgeScroll, pendingPrompt: pane.queuedPrompt === null ? null : { text: pane.queuedPrompt, onCancel: pane.cancelQueued }, ...(projectFileNames === undefined ? {} : { projectFileNames: new Set(projectFileNames) }) }), _jsxs("div", { className: "jini-chat-pane__controls", ref: controlsRef, children: [_jsx(ChatPaneSuggestionsRow, { suggestions: suggestions, onSelect: pane.composer.setDraft, t: t }), _jsx(ChatPaneStatusMessages, { unavailable: unavailable, scanningAgents: runtimeView.scanningAgents, connectingAgents: runtimeView.connectingAgents, executionMode: executionMode, apiModeAvailable: apiModeAvailable, onExecutionModeChange: onExecutionModeChange, conversationError: pane.conversation.error, attachmentError: pane.attachmentError, dropReadError: fileDrop.dropReadError, workingDirectoryError: pane.workingDirectoryError, workingDirectoryPending: pane.workingDirectoryPending, workingDirectoryInvalid: pane.workingDirectoryInvalid, runtimeInventoryError: inventory.runtimeInventoryError, t: t }), _jsx(ChatPaneComposerArea, { fileDrop: fileDrop, uploadAttachments: uploadAttachments, pane: pane, disabled: disabled, unavailable: unavailable, placeholder: composerPlaceholder, slots: slots, attachmentAccept: attachmentAccept, workingDirectoryAccess: workingDirectoryAccess, workingDirectoryControlPlacement: workingDirectoryControlPlacement, t: t })] })] }), footer] }));
 }

package/dist/react/features/chat-pane/create-daemon-attachment-uploader.d.ts

@@ -17,5 +17,8 @@ export interface CreateDaemonAttachmentUploaderOptions {
  * @param baseUrl Origin (or same-origin path prefix) the daemon's API is reachable at. Pass `''`
  * when the page is served through a proxy that already forwards `/api`.
  */
-export declare function createDaemonAttachmentUploader(baseUrl: string, options?: CreateDaemonAttachmentUploaderOptions): NonNullable<ChatPaneProps['uploadAttachments']>;
+export declare function createDaemonAttachmentUploader({ baseUrl, fetch }: {
+    baseUrl: string;
+    fetch?: typeof globalThis.fetch;
+}, options?: CreateDaemonAttachmentUploaderOptions): NonNullable<ChatPaneProps['uploadAttachments']>;
 //# sourceMappingURL=create-daemon-attachment-uploader.d.ts.map

package/dist/react/features/chat-pane/create-daemon-attachment-uploader.js

@@ -1,34 +1,3 @@
-/**
- * @module create-daemon-attachment-uploader
- *
- * The client half of `@jini-ai/http-kit`'s attachment capability: a ready-made
- * `ChatPaneProps['uploadAttachments']` that talks to `POST`/`DELETE /api/attachments`.
- *
- * ```tsx
- * <ChatPane transport={transport} uploadAttachments={createDaemonAttachmentUploader(daemonUrl)} />
- * ```
- *
- * That one line is the whole wire-up for composer drag-and-drop and the file picker — `ChatPane`
- * gates both on `uploadAttachments` being present (see `ChatPane.tsx`'s `resolveDropTargetProps`).
- *
- * **Why the client enforces quotas at all**, when the daemon enforces them anyway: a user who drags
- * in a 400 MB video should be told immediately, not after the browser has finished streaming it to
- * localhost. These checks are a courtesy, never the security boundary — the daemon re-derives every
- * one of them, and only its answer decides anything.
- *
- * **Bounded concurrency, preserved order.** Two workers pull from a shared index, so at most two
- * requests are in flight while results still land at their input positions. The first failure aborts
- * the rest and deletes whatever already landed, so a partly-uploaded turn never leaves files behind
- * on the daemon waiting for their TTL.
- *
- * **`content-type` is always `application/octet-stream`**, deliberately not `file.type`. The daemon
- * sniffs the real kind from the leading bytes and ignores this header entirely, so forwarding the
- * browser's guess buys nothing — and actively breaks things: a dropped `.json` file gets
- * `content-type: application/json` from the browser, which an app-wide `express.json()` on the
- * daemon then claims, draining the request stream before the upload route can read a byte. A fixed
- * octet-stream type is immune to every body parser.
- */
-import { FETCH_TIMEOUT_MS, fetchWithTimeout } from '@jini-ai/platform/fetch-with-timeout';
 const DEFAULTS = {
     maxAttachmentBytes: 20 * 1024 * 1024,
     maxAttachmentCount: 10,
@@ -80,7 +49,7 @@ async function messageForFailedUpload(response, fallback) {
  * @param baseUrl Origin (or same-origin path prefix) the daemon's API is reachable at. Pass `''`
  * when the page is served through a proxy that already forwards `/api`.
  */
-export function createDaemonAttachmentUploader(baseUrl, options = {}) {
+export function createDaemonAttachmentUploader({ baseUrl, fetch }, options = {}) {
     const maxAttachmentBytes = options.maxAttachmentBytes ?? DEFAULTS.maxAttachmentBytes;
     const maxAttachmentCount = options.maxAttachmentCount ?? DEFAULTS.maxAttachmentCount;
     const maxBatchBytes = options.maxBatchBytes ?? DEFAULTS.maxBatchBytes;
@@ -91,7 +60,7 @@ export function createDaemonAttachmentUploader(baseUrl, options = {}) {
     const batchUsage = new Map();
     async function uploadOne(file, batchId, signal) {
         const query = new URLSearchParams({ batch: batchId, name: file.name });
-        const response = await fetch(`${endpoint}?${query}`, {
+        const response = await (fetch ?? globalThis.fetch)(`${endpoint}?${query}`, {
             method: 'POST',
             // Fixed, not `file.type` — see this module's doc.
             headers: { 'content-type': 'application/octet-stream' },
@@ -115,11 +84,12 @@ export function createDaemonAttachmentUploader(baseUrl, options = {}) {
             // caller-supplied signal to compose with and no large body — it is a small best-effort JSON
             // DELETE, and an unprotected `fetch` here would hang `uploadAttachments`'s rejection (the
             // `await` below) on a stalled daemon instead of surfacing `firstError` promptly.
-            await fetchWithTimeout(endpoint, {
+            await (fetch ?? globalThis.fetch)(endpoint, {
                 method: 'DELETE',
+                signal: AbortSignal.timeout(15_000),
                 headers: { 'content-type': 'application/json' },
                 body: JSON.stringify({ batchId, paths: attachments.map((attachment) => attachment.path) }),
-            }, { timeoutMs: FETCH_TIMEOUT_MS.QUICK });
+            });
         }
         catch {
             // Best effort by design: the daemon expires unclaimed uploads on its own, so a failed cleanup

package/dist/react/features/chat-pane/create-mcp-ui-tool-caller.d.ts

@@ -5,7 +5,7 @@
  * {@link McpUiToolCallHandler} that relays a View's `tools/call` to an HTTP endpoint.
  *
  * ```tsx
- * registerMcpUiSurfaceRenderer({ onToolCall: createMcpUiToolCaller('') });
+ * registerMcpUiSurfaceRenderer({ onToolCall: createMcpUiToolCaller({ baseUrl: '', fetch }) });
  * ```
  *
  * That one line completes the loop. `@jini-ai/daemon`'s `delegated-tool-bridge.ts` splits a UI
@@ -66,5 +66,8 @@ export interface McpUiToolCallRequest {
  *   proxied to its own API.
  * @complexity O(1) — one request per call.
  */
-export declare function createMcpUiToolCaller(baseUrl: string, options?: CreateMcpUiToolCallerOptions): McpUiToolCallHandler;
+export declare function createMcpUiToolCaller({ baseUrl, fetch }: {
+    baseUrl: string;
+    fetch: typeof globalThis.fetch;
+}, options?: CreateMcpUiToolCallerOptions): McpUiToolCallHandler;
 //# sourceMappingURL=create-mcp-ui-tool-caller.d.ts.map

package/dist/react/features/chat-pane/create-mcp-ui-tool-caller.js

@@ -38,7 +38,7 @@ function errorFrom(body, status) {
  *   proxied to its own API.
  * @complexity O(1) — one request per call.
  */
-export function createMcpUiToolCaller(baseUrl, options = {}) {
+export function createMcpUiToolCaller({ baseUrl, fetch }, options = {}) {
     const path = options.path ?? DEFAULT_PATH;
     const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     const endpoint = `${baseUrl.replace(/\/$/u, '')}${path}`;

package/dist/react/features/chat-pane/hooks/useAgentRuntimePicker.hooks.d.ts

@@ -29,34 +29,59 @@ import type { ByokRuntimeSummary, ChatPaneAgent, ChatPaneAgentSelection, Runtime
  * @complexity Time: O(n) in the supplied option count; space: O(1).
  * @overallScore 100/100
  */
-export declare function runtimeOptionLabel(options: readonly {
-    id: string;
-    label: string;
-}[] | undefined, value: string | undefined, fallback: string): string;
+export declare function runtimeOptionLabel({ options, value, fallback }: {
+    options: readonly {
+        id: string;
+        label: string;
+    }[] | undefined;
+    value: string | undefined;
+    fallback: string;
+}): string;
 /**
  * Computes a viewport-bounded fixed position for the body-portaled picker.
  *
  * @complexity Time/space: O(1).
  * @overallScore 100/100
  */
-export declare function runtimePopoverPosition(trigger: DOMRect, placement: RuntimePickerPlacement): CSSProperties;
+export declare function runtimePopoverPosition({ trigger, placement }: {
+    trigger: DOMRect;
+    placement: RuntimePickerPlacement;
+}): CSSProperties;
 /** `Tab` wraps focus around the popover's control list instead of leaving it (the popover is a
  * modal-ish dialog). Returns the index to wrap TO, or `null` when `Tab` should behave natively
  * (not at an edge). `currentIndex` may be `-1` (active element not in `controls`); `atStart`/
  * `atEnd` below only matter when it legitimately is 0 or `count - 1`. */
-export declare function resolveTabWrapIndex(shiftKey: boolean, currentIndex: number, count: number): number | null;
+export declare function resolveTabWrapIndex({ shiftKey, currentIndex, count }: {
+    shiftKey: boolean;
+    currentIndex: number;
+    count: number;
+}): number | null;
 /** Arrow/Home/End roving-tabindex target, or `null` for any other key. `currentIndex === -1`
  * (nothing in `controls` focused yet) is a legitimate input — the modulo arithmetic below relies
  * on it wrapping the same way a real index would. */
-export declare function resolveRovingIndex(key: string, currentIndex: number, count: number): number | null;
+export declare function resolveRovingIndex({ key, currentIndex, count }: {
+    key: string;
+    currentIndex: number;
+    count: number;
+}): number | null;
 /**
  * The control index the popover's key handler should move focus to, or `null` to leave focus alone
  * (and, in the caller, to skip `preventDefault()`). `Tab` is resolved and returned immediately —
  * it must never fall through to the roving-tabindex logic below it.
  */
-export declare function resolvePopoverKeyAction(key: string, shiftKey: boolean, isButtonTarget: boolean, currentIndex: number, count: number): number | null;
+export declare function resolvePopoverKeyAction({ key, shiftKey, isButtonTarget, currentIndex, count }: {
+    key: string;
+    shiftKey: boolean;
+    isButtonTarget: boolean;
+    currentIndex: number;
+    count: number;
+}): number | null;
 /** Builds the one-line "which runtime am I talking to" summary shown in the popover head. */
-export declare function runtimeSummaryText(selectedAgent: ChatPaneAgent | undefined, modelLabel: string, t: (key: string) => string): string;
+export declare function runtimeSummaryText({ selectedAgent, modelLabel, t }: {
+    selectedAgent: ChatPaneAgent | undefined;
+    modelLabel: string;
+    t: (key: string) => string;
+}): string;
 /**
  * The head/trigger labels while `executionMode` is `'api'`.
  *
@@ -68,7 +93,10 @@ export declare function runtimeSummaryText(selectedAgent: ChatPaneAgent | undefi
  *
  * @complexity Time/space: O(1).
  */
-export declare function byokSummaryText(byokRuntime: ByokRuntimeSummary | undefined, t: (key: string) => string): {
+export declare function byokSummaryText({ byokRuntime, t }: {
+    byokRuntime: ByokRuntimeSummary | undefined;
+    t: (key: string) => string;
+}): {
     title: string;
     modelLabel: string;
     summary: string;

package/dist/react/features/chat-pane/hooks/useAgentRuntimePicker.hooks.js

@@ -31,7 +31,7 @@ const FOCUSABLE_CONTROLS = 'button:not(:disabled), select:not(:disabled), input:
  * @complexity Time: O(n) in the supplied option count; space: O(1).
  * @overallScore 100/100
  */
-export function runtimeOptionLabel(options, value, fallback) {
+export function runtimeOptionLabel({ options, value, fallback }) {
     if (!value || value === 'default')
         return fallback;
     return options?.find((option) => option.id === value)?.label ?? value;
@@ -42,7 +42,7 @@ export function runtimeOptionLabel(options, value, fallback) {
  * @complexity Time/space: O(1).
  * @overallScore 100/100
  */
-export function runtimePopoverPosition(trigger, placement) {
+export function runtimePopoverPosition({ trigger, placement }) {
     const margin = 12;
     const gap = 8;
     const width = Math.min(320, window.innerWidth - margin * 2);
@@ -75,7 +75,7 @@ export function runtimePopoverPosition(trigger, placement) {
  * modal-ish dialog). Returns the index to wrap TO, or `null` when `Tab` should behave natively
  * (not at an edge). `currentIndex` may be `-1` (active element not in `controls`); `atStart`/
  * `atEnd` below only matter when it legitimately is 0 or `count - 1`. */
-export function resolveTabWrapIndex(shiftKey, currentIndex, count) {
+export function resolveTabWrapIndex({ shiftKey, currentIndex, count }) {
     if (shiftKey && currentIndex === 0)
         return count - 1;
     if (!shiftKey && currentIndex === count - 1)
@@ -85,7 +85,7 @@ export function resolveTabWrapIndex(shiftKey, currentIndex, count) {
 /** Arrow/Home/End roving-tabindex target, or `null` for any other key. `currentIndex === -1`
  * (nothing in `controls` focused yet) is a legitimate input — the modulo arithmetic below relies
  * on it wrapping the same way a real index would. */
-export function resolveRovingIndex(key, currentIndex, count) {
+export function resolveRovingIndex({ key, currentIndex, count }) {
     if (key === 'Home')
         return 0;
     if (key === 'End')
@@ -101,17 +101,17 @@ export function resolveRovingIndex(key, currentIndex, count) {
  * (and, in the caller, to skip `preventDefault()`). `Tab` is resolved and returned immediately —
  * it must never fall through to the roving-tabindex logic below it.
  */
-export function resolvePopoverKeyAction(key, shiftKey, isButtonTarget, currentIndex, count) {
+export function resolvePopoverKeyAction({ key, shiftKey, isButtonTarget, currentIndex, count }) {
     if (key === 'Tab')
-        return resolveTabWrapIndex(shiftKey, currentIndex, count);
+        return resolveTabWrapIndex({ shiftKey: shiftKey, currentIndex: currentIndex, count: count });
     // Native selects own their arrow/Home/End behavior. Roving applies only
     // when a button (including the agent radios) has focus.
     if (!isButtonTarget)
         return null;
-    return resolveRovingIndex(key, currentIndex, count);
+    return resolveRovingIndex({ key: key, currentIndex: currentIndex, count: count });
 }
 /** Builds the one-line "which runtime am I talking to" summary shown in the popover head. */
-export function runtimeSummaryText(selectedAgent, modelLabel, t) {
+export function runtimeSummaryText({ selectedAgent, modelLabel, t }) {
     if (selectedAgent === undefined)
         return t('No agent selected');
     const version = selectedAgent.version ? ` · ${selectedAgent.version}` : '';
@@ -128,7 +128,7 @@ export function runtimeSummaryText(selectedAgent, modelLabel, t) {
  *
  * @complexity Time/space: O(1).
  */
-export function byokSummaryText(byokRuntime, t) {
+export function byokSummaryText({ byokRuntime, t }) {
     const title = byokRuntime?.providerLabel?.trim() || t('API · BYOK');
     const model = byokRuntime?.model?.trim();
     const modelLabel = model || t('No model configured');
@@ -146,16 +146,16 @@ export function useAgentRuntimePicker({ agents, value, placement, t, executionMo
     const [position, setPosition] = useState();
     const triggerRef = useRef(null);
     const popoverRef = useRef(null);
-    const orderedAgents = useMemo(() => orderChatPaneAgents(agents.filter((agent) => agent.available !== false)), [agents]);
+    const orderedAgents = useMemo(() => orderChatPaneAgents({ agents: agents.filter((agent) => agent.available !== false) }), [agents]);
     const selectedAgent = orderedAgents.find((agent) => agent.id === value.agentId);
     // `selectedAgent` stays resolved in BOTH modes on purpose — the CLI selection is still the stored
     // one, and switching back to Local CLI must not have silently lost it. What changes in `'api'` is
     // only what gets DESCRIBED, because none of the CLI's labels are true of an API turn.
-    const localModelLabel = runtimeOptionLabel(selectedAgent?.models, value.model, t('Default model'));
-    const byok = byokSummaryText(byokRuntime, t);
+    const localModelLabel = runtimeOptionLabel({ options: selectedAgent?.models, value: value.model, fallback: t('Default model') });
+    const byok = byokSummaryText({ byokRuntime: byokRuntime, t: t });
     const isApi = executionMode === 'api';
     const modelLabel = isApi ? byok.modelLabel : localModelLabel;
-    const runtimeSummary = isApi ? byok.summary : runtimeSummaryText(selectedAgent, localModelLabel, t);
+    const runtimeSummary = isApi ? byok.summary : runtimeSummaryText({ selectedAgent: selectedAgent, modelLabel: localModelLabel, t: t });
     const triggerTitle = isApi ? byok.title : (selectedAgent?.name ?? t('Choose agent'));
     // Read during render rather than in an effect: the popover only mounts once `open` is true, which
     // is itself a re-render, and `triggerRef` is populated at the first commit — so by the time this
@@ -205,7 +205,7 @@ export function useAgentRuntimePicker({ agents, value, placement, t, executionMo
         const update = () => {
             const rect = triggerRef.current?.getBoundingClientRect();
             if (rect)
-                setPosition(runtimePopoverPosition(rect, placement));
+                setPosition(runtimePopoverPosition({ trigger: rect, placement: placement }));
         };
         update();
         window.addEventListener('resize', update);
@@ -233,7 +233,7 @@ export function useAgentRuntimePicker({ agents, value, placement, t, executionMo
         if (controls.length === 0)
             return;
         const currentIndex = controls.indexOf(document.activeElement);
-        const nextIndex = resolvePopoverKeyAction(event.key, event.shiftKey, event.target instanceof HTMLButtonElement, currentIndex, controls.length);
+        const nextIndex = resolvePopoverKeyAction({ key: event.key, shiftKey: event.shiftKey, isButtonTarget: event.target instanceof HTMLButtonElement, currentIndex: currentIndex, count: controls.length });
         if (nextIndex === null)
             return;
         event.preventDefault();

package/dist/react/features/chat-pane/hooks/useChatPane.hooks.js

@@ -70,29 +70,29 @@ export function useChatPane(options) {
     const attachmentBatchIdRef = useRef(createAttachmentBatchId());
     const activeUploadsRef = useRef(new Set());
     const [internalSelection, setInternalSelection] = useState(options.initialSelection ?? { agentId: '' });
-    const workingDirectoryState = useChatPaneWorkingDirectory(definedProps({
-        workingDirectory: options.workingDirectory,
-        initialWorkingDirectory: options.initialWorkingDirectory,
-        onChangeWorkingDirectory: options.onChangeWorkingDirectory,
-        workingDirectoryAccess: options.workingDirectoryAccess,
-    }));
+    const workingDirectoryState = useChatPaneWorkingDirectory(definedProps({ source: {
+            workingDirectory: options.workingDirectory,
+            initialWorkingDirectory: options.initialWorkingDirectory,
+            onChangeWorkingDirectory: options.onChangeWorkingDirectory,
+            workingDirectoryAccess: options.workingDirectoryAccess,
+        } }));
     const requestedSelection = options.selection ?? internalSelection;
-    const selection = useMemo(() => resolveChatPaneSelection(options.agents, requestedSelection), [options.agents, requestedSelection]);
+    const selection = useMemo(() => resolveChatPaneSelection({ agents: options.agents, requested: requestedSelection }), [options.agents, requestedSelection]);
     const selectedAgent = options.agents.find((agent) => agent.id === selection.agentId);
-    const composer = useComposer(definedProps({
-        initialDraft: options.initialDraft,
-        initialAgent: selection,
-        conversationId: options.conversationId,
-        validateAttachments: options.validateAttachments,
-    }));
-    const conversation = useConversation(definedProps({
-        transport: options.transport,
-        initialMessages: options.initialMessages,
-        conversationId: options.conversationId,
-        // Keys off an empty string, not `undefined` — `selection.agentId` is always a string (never
-        // absent), so only the falsy "no agent selected" case should omit the key.
-        agentId: selection.agentId || undefined,
-    }));
+    const composer = useComposer(definedProps({ source: {
+            initialDraft: options.initialDraft,
+            initialAgent: selection,
+            conversationId: options.conversationId,
+            validateAttachments: options.validateAttachments,
+        } }));
+    const conversation = useConversation(definedProps({ source: {
+            transport: options.transport,
+            initialMessages: options.initialMessages,
+            conversationId: options.conversationId,
+            // Keys off an empty string, not `undefined` — `selection.agentId` is always a string (never
+            // absent), so only the falsy "no agent selected" case should omit the key.
+            agentId: selection.agentId || undefined,
+        } }));
     const activity = resolveChatPaneActivity(selectedAgent, conversation);
     useEffect(() => {
         options.onActivityChange?.(activity);
@@ -131,7 +131,7 @@ export function useChatPane(options) {
         selection,
     ]);
     const setSelection = useCallback((next) => {
-        const validated = resolveChatPaneSelection(options.agents, next);
+        const validated = resolveChatPaneSelection({ agents: options.agents, requested: next });
         setInternalSelection(validated);
         composer.setAgent(validated);
         options.onSelectionChange?.(validated);
@@ -174,7 +174,7 @@ export function useChatPane(options) {
                 onAttachment: (attachment, file) => {
                     composer.addAttachment(attachment);
                     if (file)
-                        cacheAttachmentPreviewSource(attachment.path, file);
+                        cacheAttachmentPreviewSource({ path: attachment.path, file });
                 },
                 onError: setAttachmentError,
             });
@@ -204,13 +204,13 @@ export function useChatPane(options) {
         attachmentGenerationRef.current += 1;
         attachmentBatchIdRef.current = createAttachmentBatchId();
         options.onActivityChange?.('queued');
-        await conversation.sendMessage(trimmed, definedProps({
-            agentId: selection.agentId,
-            // Omitted when the array is EMPTY, not merely absent — an empty `attachments: []` would be a
-            // different (valid, present) value to the transport than "no attachments key at all".
-            attachments: attachments.length === 0 ? undefined : attachments,
-            context,
-        }));
+        await conversation.sendMessage(trimmed, definedProps({ source: {
+                agentId: selection.agentId,
+                // Omitted when the array is EMPTY, not merely absent — an empty `attachments: []` would be a
+                // different (valid, present) value to the transport than "no attachments key at all".
+                attachments: attachments.length === 0 ? undefined : attachments,
+                context,
+            } }));
     }, [
         composer,
         conversation,
@@ -226,7 +226,7 @@ export function useChatPane(options) {
             return;
         // Queue instead of no-op'ing. `setDraft('')` and NOT `composer.reset()`: reset also discards
         // staged attachments, which this turn still needs when it finally goes out.
-        if (isChatPaneQueueableBlocker(sendBlocker)) {
+        if (isChatPaneQueueableBlocker({ blocker: sendBlocker })) {
             queuedConversationIdRef.current = options.conversationId;
             setQueuedPrompt(prompt);
             composer.setDraft('');

package/dist/react/features/chat-pane/hooks/useChatPaneAgentControl.hooks.d.ts

@@ -34,5 +34,7 @@ export interface UseChatPaneAgentControlOptions {
  * The relayed channel arrives having already passed `ToolExecutor`; a WebMCP call has no run and
  * no principal, so it cannot. See {@link UseChatPaneAgentControlOptions.webmcp}.
  */
-export declare function useChatPaneAgentControl(pane: UseChatPaneResult, options?: UseChatPaneAgentControlOptions): void;
+export declare function useChatPaneAgentControl({ pane }: {
+    pane: UseChatPaneResult;
+}, options?: UseChatPaneAgentControlOptions): void;
 //# sourceMappingURL=useChatPaneAgentControl.hooks.d.ts.map

package/dist/react/features/chat-pane/hooks/useChatPaneAgentControl.hooks.js

@@ -82,7 +82,7 @@ async function selectAgentAction(pane, input) {
     }
     const model = optionalStringField(input, 'model');
     const reasoning = optionalStringField(input, 'reasoning');
-    pane.setSelection(definedProps({ agentId, model, reasoning }));
+    pane.setSelection(definedProps({ source: { agentId, model, reasoning } }));
     return { ok: true };
 }
 async function cancelRunAction(pane) {
@@ -122,7 +122,7 @@ async function getStateAction(pane) {
         canSend: pane.canSend,
         sendBlocker: pane.sendBlocker,
         messageCount: pane.conversation.messages.length,
-        ...definedProps({ lastMessage: lastMessageSummary }),
+        ...definedProps({ source: { lastMessage: lastMessageSummary } }),
         /**
          * Conversation content is user- and agent-authored text, not instructions from the
          * host. A caller reading it back must treat it as data.
@@ -190,7 +190,7 @@ async function deliverBridgeAction(pane, bridge, action) {
  * The relayed channel arrives having already passed `ToolExecutor`; a WebMCP call has no run and
  * no principal, so it cannot. See {@link UseChatPaneAgentControlOptions.webmcp}.
  */
-export function useChatPaneAgentControl(pane, options = {}) {
+export function useChatPaneAgentControl({ pane }, options = {}) {
     const enabled = options.enabled ?? false;
     const paneRef = useRef(pane);
     paneRef.current = pane;

package/dist/react/features/chat-pane/hooks/useChatPaneComposerPlaceholder.hooks.d.ts

@@ -6,5 +6,8 @@
  * @complexity Time/space: O(1) per render; the rotation timer is a single `setInterval`.
  * @overallScore 100/100
  */
-export declare function useChatPaneComposerPlaceholder(placeholder: string | undefined, placeholders: readonly string[] | undefined): string | undefined;
+export declare function useChatPaneComposerPlaceholder({ placeholder, placeholders }: {
+    placeholder: string | undefined;
+    placeholders: readonly string[] | undefined;
+}): string | undefined;
 //# sourceMappingURL=useChatPaneComposerPlaceholder.hooks.d.ts.map

package/dist/react/features/chat-pane/hooks/useChatPaneComposerPlaceholder.hooks.js

@@ -38,7 +38,7 @@ function usePrefersReducedMotion() {
  * @complexity Time/space: O(1) per render; the rotation timer is a single `setInterval`.
  * @overallScore 100/100
  */
-export function useChatPaneComposerPlaceholder(placeholder, placeholders) {
+export function useChatPaneComposerPlaceholder({ placeholder, placeholders }) {
     const reducedMotion = usePrefersReducedMotion();
     const [index, setIndex] = useState(0);
     // A joined key, not the array reference: a host writing `placeholders={['a', 'b']}` inline