@jini-ai/chat 0.3.11 → 0.5.0

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

@@ -34,8 +34,8 @@ export function useChatPaneRuntimeInventory({ access, initialAgents = EMPTY_AGEN
     const [connectingAgents, setConnectingAgents] = useState(false);
     const [daemonOnline, setDaemonOnline] = useState(false);
     const [runtimeInventoryError, setRuntimeInventoryError] = useState(null);
-    const inventory = useLatestOperation();
-    const health = useLatestOperation();
+    const inventory = useLatestOperation({});
+    const health = useLatestOperation({});
     const retry = useInventoryRetry(retryDelaysMs);
     useEffect(() => {
         if (access !== undefined)
@@ -53,24 +53,24 @@ export function useChatPaneRuntimeInventory({ access, initialAgents = EMPTY_AGEN
         retry.cancel();
         setScanningAgents(true);
         setRuntimeInventoryError(null);
-        await inventory.run(async (token) => {
-            const nextAgents = await (rescan ? access.rescanAgents() : access.listAgents());
-            token.ensureCurrent();
-            retry.answered();
-            setAgents([...nextAgents]);
-            setConnectingAgents(false);
-            setScanningAgents(false);
-        }, (error) => {
-            // A failed load after a good answer keeps that inventory on screen. Before one there is no
-            // last-good to keep: clear to empty, report "connecting", and try again on the backoff.
-            if (!retry.hasAnswer()) {
-                setAgents([]);
-                setConnectingAgents(true);
-                retry.schedule(() => void loadAgents(false));
-            }
-            setRuntimeInventoryError(error);
-            setScanningAgents(false);
-        });
+        await inventory.run({ body: async (token) => {
+                const nextAgents = await (rescan ? access.rescanAgents() : access.listAgents());
+                token.ensureCurrent();
+                retry.answered();
+                setAgents([...nextAgents]);
+                setConnectingAgents(false);
+                setScanningAgents(false);
+            }, onError: (error) => {
+                // A failed load after a good answer keeps that inventory on screen. Before one there is no
+                // last-good to keep: clear to empty, report "connecting", and try again on the backoff.
+                if (!retry.hasAnswer()) {
+                    setAgents([]);
+                    setConnectingAgents(true);
+                    retry.schedule(() => void loadAgents(false));
+                }
+                setRuntimeInventoryError(error);
+                setScanningAgents(false);
+            } });
     }, [access, inventory, retry]);
     /** A fresh attempt now, with the backoff restarted — only while nothing has answered yet. */
     const reloadIfUnanswered = useCallback(() => {
@@ -86,16 +86,16 @@ export function useChatPaneRuntimeInventory({ access, initialAgents = EMPTY_AGEN
         // below) all sit behind their own `if (!access) return` — `access` is guaranteed defined by
         // the time any one runs.
         const runtimeAccess = access;
-        await health.run(async (token) => {
-            const online = await runtimeAccess.daemonOnline();
-            token.ensureCurrent();
-            setDaemonOnline(online);
-            if (retry.observeOnline(online))
-                reloadIfUnanswered();
-        }, () => {
-            retry.observeOnline(false);
-            setDaemonOnline(false);
-        });
+        await health.run({ body: async (token) => {
+                const online = await runtimeAccess.daemonOnline();
+                token.ensureCurrent();
+                setDaemonOnline(online);
+                if (retry.observeOnline(online))
+                    reloadIfUnanswered();
+            }, onError: () => {
+                retry.observeOnline(false);
+                setDaemonOnline(false);
+            } });
     }, [access, health, reloadIfUnanswered, retry]);
     useEffect(() => {
         if (!access)

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

@@ -25,7 +25,7 @@ export function useChatPaneWorkingDirectory(options) {
     const [workingDirectoryInvalid, setWorkingDirectoryInvalid] = useState(false);
     const [workingDirectoryPending, setWorkingDirectoryPending] = useState(false);
     const [workingDirectoryError, setWorkingDirectoryError] = useState(null);
-    const operation = useLatestOperation();
+    const operation = useLatestOperation({});
     const observedDirectoryRef = useRef(undefined);
     const workingDirectory = controlled
         ? options.workingDirectory ?? null
@@ -55,29 +55,29 @@ export function useChatPaneWorkingDirectory(options) {
         }
         let validationSettled = false;
         setWorkingDirectoryPending(true);
-        void operation.run(async (token) => {
-            const normalized = access.normalizeWorkingDirectory
-                ? await access.normalizeWorkingDirectory(workingDirectory)
-                : workingDirectory;
-            token.ensureCurrent();
-            if (normalized === null) {
+        void operation.run({ body: async (token) => {
+                const normalized = access.normalizeWorkingDirectory
+                    ? await access.normalizeWorkingDirectory(workingDirectory)
+                    : workingDirectory;
+                token.ensureCurrent();
+                if (normalized === null) {
+                    validationSettled = true;
+                    setWorkingDirectoryInvalid(true);
+                    setWorkingDirectoryPending(false);
+                    return;
+                }
+                const exists = await access.directoryExists(normalized);
+                token.ensureCurrent();
+                if (normalized !== workingDirectory)
+                    reportWorkingDirectory(normalized);
                 validationSettled = true;
-                setWorkingDirectoryInvalid(true);
+                setWorkingDirectoryInvalid(!exists);
                 setWorkingDirectoryPending(false);
-                return;
-            }
-            const exists = await access.directoryExists(normalized);
-            token.ensureCurrent();
-            if (normalized !== workingDirectory)
-                reportWorkingDirectory(normalized);
-            validationSettled = true;
-            setWorkingDirectoryInvalid(!exists);
-            setWorkingDirectoryPending(false);
-        }, (error) => {
-            validationSettled = true;
-            setWorkingDirectoryInvalid(true);
-            reportFailure(error);
-        });
+            }, onError: (error) => {
+                validationSettled = true;
+                setWorkingDirectoryInvalid(true);
+                reportFailure(error);
+            } });
         return () => {
             operation.supersede();
             // React Strict Mode replays this effect while preserving refs. Release
@@ -102,18 +102,18 @@ export function useChatPaneWorkingDirectory(options) {
             return;
         setWorkingDirectoryError(null);
         setWorkingDirectoryPending(true);
-        await operation.run(async (token) => {
-            const [recent, exists] = await Promise.all([
-                access.recentDirectories(),
-                workingDirectory === null
-                    ? Promise.resolve(true)
-                    : access.directoryExists(workingDirectory),
-            ]);
-            token.ensureCurrent();
-            setRecentDirectories([...recent]);
-            setWorkingDirectoryInvalid(!exists);
-            setWorkingDirectoryPending(false);
-        }, reportFailure);
+        await operation.run({ body: async (token) => {
+                const [recent, exists] = await Promise.all([
+                    access.recentDirectories(),
+                    workingDirectory === null
+                        ? Promise.resolve(true)
+                        : access.directoryExists(workingDirectory),
+                ]);
+                token.ensureCurrent();
+                setRecentDirectories([...recent]);
+                setWorkingDirectoryInvalid(!exists);
+                setWorkingDirectoryPending(false);
+            }, onError: reportFailure });
     }, [operation, options.workingDirectoryAccess, reportFailure, workingDirectory]);
     const pickWorkingDirectory = useCallback(async () => {
         const access = options.workingDirectoryAccess;
@@ -121,23 +121,23 @@ export function useChatPaneWorkingDirectory(options) {
             return;
         setWorkingDirectoryError(null);
         setWorkingDirectoryPending(true);
-        await operation.run(async (token) => {
-            const selected = await access.pickWorkingDirectory(workingDirectory ?? undefined);
-            token.ensureCurrent();
-            if (selected === null) {
+        await operation.run({ body: async (token) => {
+                const selected = await access.pickWorkingDirectory(workingDirectory ?? undefined);
+                token.ensureCurrent();
+                if (selected === null) {
+                    setWorkingDirectoryPending(false);
+                    return;
+                }
+                const [exists, recent] = await Promise.all([
+                    access.directoryExists(selected),
+                    access.recentDirectories(),
+                ]);
+                token.ensureCurrent();
+                reportWorkingDirectory(selected);
+                setWorkingDirectoryInvalid(!exists);
+                setRecentDirectories([...recent]);
                 setWorkingDirectoryPending(false);
-                return;
-            }
-            const [exists, recent] = await Promise.all([
-                access.directoryExists(selected),
-                access.recentDirectories(),
-            ]);
-            token.ensureCurrent();
-            reportWorkingDirectory(selected);
-            setWorkingDirectoryInvalid(!exists);
-            setRecentDirectories([...recent]);
-            setWorkingDirectoryPending(false);
-        }, reportFailure);
+            }, onError: reportFailure });
     }, [
         operation,
         options.workingDirectoryAccess,
@@ -154,13 +154,13 @@ export function useChatPaneWorkingDirectory(options) {
             return;
         }
         setWorkingDirectoryPending(true);
-        await operation.run(async (token) => {
-            const exists = await access.directoryExists(directory);
-            token.ensureCurrent();
-            reportWorkingDirectory(directory);
-            setWorkingDirectoryInvalid(!exists);
-            setWorkingDirectoryPending(false);
-        }, reportFailure);
+        await operation.run({ body: async (token) => {
+                const exists = await access.directoryExists(directory);
+                token.ensureCurrent();
+                reportWorkingDirectory(directory);
+                setWorkingDirectoryInvalid(!exists);
+                setWorkingDirectoryPending(false);
+            }, onError: reportFailure });
     }, [operation, options.workingDirectoryAccess, reportFailure, reportWorkingDirectory]);
     const clearWorkingDirectory = useCallback(() => {
         operation.supersede();

package/dist/react/features/chat-pane/rules.d.ts

@@ -1,6 +1,11 @@
 import type { ByokRuntimeSummary, ChatPaneAgent, ChatPaneAgentSelection } from './types.js';
-export declare function defaultChatPaneSelection(agent: ChatPaneAgent): ChatPaneAgentSelection;
-export declare function resolveChatPaneSelection(agents: readonly ChatPaneAgent[], requested: ChatPaneAgentSelection): ChatPaneAgentSelection;
+export declare function defaultChatPaneSelection({ agent }: {
+    agent: ChatPaneAgent;
+}): ChatPaneAgentSelection;
+export declare function resolveChatPaneSelection({ agents, requested }: {
+    agents: readonly ChatPaneAgent[];
+    requested: ChatPaneAgentSelection;
+}): ChatPaneAgentSelection;
 /**
  * Why a send would be refused, or `null` when the pane is ready to send.
  *
@@ -63,6 +68,10 @@ export declare function describeChatPaneSendBlocker(blocker: ChatPaneSendBlocker
  * those are clear. A flush path must therefore wait for a fully `null` blocker before sending,
  * not merely for streaming to end.
  */
-export declare function isChatPaneQueueableBlocker(blocker: ChatPaneSendBlocker | null): boolean;
-export declare function orderChatPaneAgents(agents: readonly ChatPaneAgent[]): ChatPaneAgent[];
+export declare function isChatPaneQueueableBlocker({ blocker }: {
+    blocker: ChatPaneSendBlocker | null;
+}): boolean;
+export declare function orderChatPaneAgents({ agents }: {
+    agents: readonly ChatPaneAgent[];
+}): ChatPaneAgent[];
 //# sourceMappingURL=rules.d.ts.map

package/dist/react/features/chat-pane/rules.js

@@ -6,7 +6,7 @@ function validatedOptionId(options, requested, fallback) {
         return requested;
     return fallback;
 }
-export function defaultChatPaneSelection(agent) {
+export function defaultChatPaneSelection({ agent }) {
     const model = preferredOptionId(agent.models);
     const reasoning = preferredOptionId(agent.reasoningOptions);
     return {
@@ -15,12 +15,12 @@ export function defaultChatPaneSelection(agent) {
         ...(reasoning === undefined ? {} : { reasoning }),
     };
 }
-export function resolveChatPaneSelection(agents, requested) {
+export function resolveChatPaneSelection({ agents, requested }) {
     const requestedAgent = agents.find((agent) => agent.id === requested.agentId && agent.available !== false);
     const agent = requestedAgent ?? agents.find((candidate) => candidate.available !== false);
     if (!agent)
         return { agentId: '' };
-    const defaults = defaultChatPaneSelection(agent);
+    const defaults = defaultChatPaneSelection({ agent: agent });
     if (agent !== requestedAgent)
         return defaults;
     const model = requested.model
@@ -102,10 +102,10 @@ export function describeChatPaneSendBlocker(blocker) {
  * those are clear. A flush path must therefore wait for a fully `null` blocker before sending,
  * not merely for streaming to end.
  */
-export function isChatPaneQueueableBlocker(blocker) {
+export function isChatPaneQueueableBlocker({ blocker }) {
     return blocker === 'streaming';
 }
-export function orderChatPaneAgents(agents) {
+export function orderChatPaneAgents({ agents }) {
     return [...agents].sort((left, right) => {
         const availability = Number(left.available === false) - Number(right.available === false);
         return availability

package/dist/react/features/chat-pane/types.d.ts

@@ -22,7 +22,7 @@ export interface ChatPaneAgent {
     supportsCustomModel?: boolean;
     diagnostic?: string;
     /**
-     * Whether this runtime can receive external MCP servers (Tovu/Jini tools) at all — mirrors
+     * Whether this runtime can receive external MCP servers (host/Jini tools) at all — mirrors
      * `@jini-ai/http-kit`'s `AgentSummary.supportsTools`, itself derived from
      * `@jini-ai/agent-runtime`'s `runtimeSupportsExternalTools(def)`. `AgentRuntimePicker` reads this
      * to show a "No tools" badge; `undefined` (a host on an older wire payload) is treated the same

package/dist/react/hooks/attachment-preview-cache.d.ts

@@ -34,14 +34,19 @@ export declare const MAX_CACHED_ATTACHMENT_PREVIEWS = 50;
  * if this would introduce a new entry past {@link MAX_CACHED_ATTACHMENT_PREVIEWS}.
  * @complexity Time/space: O(1) amortized.
  */
-export declare function cacheAttachmentPreviewSource(path: string, file: File): void;
+export declare function cacheAttachmentPreviewSource({ path, file }: {
+    path: string;
+    file: File;
+}): void;
 /**
  * Reads back the `File` cached for `path`, or `undefined` when this browser never staged it (a
  * different session, a reload, or eviction past the cap) - the only signal a preview needs to fall
  * back to an honest metadata view instead of pretending to render content it does not have.
  * @complexity Time/space: O(1).
  */
-export declare function getAttachmentPreviewSource(path: string): File | undefined;
+export declare function getAttachmentPreviewSource({ path }: {
+    path: string;
+}): File | undefined;
 /** Test-only: empties the module-level cache so test cases cannot leak attachments into each other. */
 export declare function __resetAttachmentPreviewCacheForTests(): void;
 //# sourceMappingURL=attachment-preview-cache.d.ts.map

package/dist/react/hooks/attachment-preview-cache.js

@@ -35,7 +35,7 @@ const sources = new Map();
  * if this would introduce a new entry past {@link MAX_CACHED_ATTACHMENT_PREVIEWS}.
  * @complexity Time/space: O(1) amortized.
  */
-export function cacheAttachmentPreviewSource(path, file) {
+export function cacheAttachmentPreviewSource({ path, file }) {
     if (!sources.has(path) && sources.size >= MAX_CACHED_ATTACHMENT_PREVIEWS) {
         const oldest = sources.keys().next().value;
         if (oldest !== undefined)
@@ -49,7 +49,7 @@ export function cacheAttachmentPreviewSource(path, file) {
  * back to an honest metadata view instead of pretending to render content it does not have.
  * @complexity Time/space: O(1).
  */
-export function getAttachmentPreviewSource(path) {
+export function getAttachmentPreviewSource({ path }) {
     return sources.get(path);
 }
 /** Test-only: empties the module-level cache so test cases cannot leak attachments into each other. */

package/dist/react/hooks/composer-draft-cache.d.ts

@@ -72,7 +72,9 @@ export declare const COMPOSER_ATTACHMENTS_STORAGE_PREFIX = "jini.chat.composer-a
  * treat `null` as "nothing to restore".
  * @complexity Time/space: O(1) on an in-memory hit, O(n) in the stored draft's length otherwise.
  */
-export declare function readCachedDraft(conversationId: string | null | undefined): string | null;
+export declare function readCachedDraft({ conversationId }: {
+    conversationId: string | null | undefined;
+}): string | null;
 /**
  * Stores `draft` for `conversationId` in both tiers.
  *
@@ -83,7 +85,10 @@ export declare function readCachedDraft(conversationId: string | null | undefine
  * writes `''` here.
  * @complexity Time/space: O(n) in the draft's length; see {@link writeStoredDraft}.
  */
-export declare function writeCachedDraft(conversationId: string | null | undefined, draft: string): void;
+export declare function writeCachedDraft({ conversationId, draft }: {
+    conversationId: string | null | undefined;
+    draft: string;
+}): void;
 /**
  * Explicitly evicts `conversationId`'s draft from both tiers, for a host that wants to free it
  * immediately (e.g. on conversation delete) rather than waiting for the cap-triggered eviction.
@@ -91,7 +96,9 @@ export declare function writeCachedDraft(conversationId: string | null | undefin
  * follow-up caller, out of scope here (that flow lives outside this package).
  * @complexity Time/space: O(1).
  */
-export declare function clearCachedDraft(conversationId: string | null | undefined): void;
+export declare function clearCachedDraft({ conversationId }: {
+    conversationId: string | null | undefined;
+}): void;
 /**
  * Reads the cached attachment references for `conversationId`, in memory first, storage second.
  *
@@ -105,7 +112,9 @@ export declare function clearCachedDraft(conversationId: string | null | undefin
  * @returns The cached references, or `null` when there are none.
  * @complexity Time/space: O(1) on an in-memory hit, O(n) in the stored count otherwise.
  */
-export declare function readCachedAttachments(conversationId: string | null | undefined): readonly ChatAttachment[] | null;
+export declare function readCachedAttachments({ conversationId }: {
+    conversationId: string | null | undefined;
+}): readonly ChatAttachment[] | null;
 /**
  * Stores `attachments` for `conversationId` in both tiers.
  *
@@ -113,7 +122,10 @@ export declare function readCachedAttachments(conversationId: string | null | un
  * restore — the same rule the draft text follows.
  * @complexity Time/space: O(n) in the number of references.
  */
-export declare function writeCachedAttachments(conversationId: string | null | undefined, attachments: readonly ChatAttachment[]): void;
+export declare function writeCachedAttachments({ conversationId, attachments }: {
+    conversationId: string | null | undefined;
+    attachments: readonly ChatAttachment[];
+}): void;
 /**
  * Test-only: empties the cache so test cases cannot leak drafts into each other.
  *

package/dist/react/hooks/composer-draft-cache.js

@@ -210,7 +210,7 @@ function rememberInMemory(conversationId, draft) {
  * treat `null` as "nothing to restore".
  * @complexity Time/space: O(1) on an in-memory hit, O(n) in the stored draft's length otherwise.
  */
-export function readCachedDraft(conversationId) {
+export function readCachedDraft({ conversationId }) {
     if (!conversationId)
         return null;
     const remembered = drafts.get(conversationId);
@@ -232,7 +232,7 @@ export function readCachedDraft(conversationId) {
  * writes `''` here.
  * @complexity Time/space: O(n) in the draft's length; see {@link writeStoredDraft}.
  */
-export function writeCachedDraft(conversationId, draft) {
+export function writeCachedDraft({ conversationId, draft }) {
     if (!conversationId)
         return;
     if (draft.trim() === '') {
@@ -250,12 +250,12 @@ export function writeCachedDraft(conversationId, draft) {
  * follow-up caller, out of scope here (that flow lives outside this package).
  * @complexity Time/space: O(1).
  */
-export function clearCachedDraft(conversationId) {
+export function clearCachedDraft({ conversationId }) {
     if (!conversationId)
         return;
     drafts.delete(conversationId);
     writeStoredDraft(conversationId, '');
-    writeCachedAttachments(conversationId, []);
+    writeCachedAttachments({ conversationId: conversationId, attachments: [] });
 }
 /**
  * Narrows one parsed array element to a `ChatAttachment`.
@@ -336,7 +336,7 @@ function readStoredAttachments(conversationId) {
  * @returns The cached references, or `null` when there are none.
  * @complexity Time/space: O(1) on an in-memory hit, O(n) in the stored count otherwise.
  */
-export function readCachedAttachments(conversationId) {
+export function readCachedAttachments({ conversationId }) {
     if (!conversationId)
         return null;
     const remembered = stagedAttachments.get(conversationId);
@@ -355,7 +355,7 @@ export function readCachedAttachments(conversationId) {
  * restore — the same rule the draft text follows.
  * @complexity Time/space: O(n) in the number of references.
  */
-export function writeCachedAttachments(conversationId, attachments) {
+export function writeCachedAttachments({ conversationId, attachments }) {
     if (!conversationId)
         return;
     const key = `${COMPOSER_ATTACHMENTS_STORAGE_PREFIX}${conversationId}`;

package/dist/react/hooks/useArtifactStream.d.ts

@@ -14,5 +14,9 @@ export interface UseArtifactStreamResult {
     /** The last item — the one most likely to be "the artifact this turn produced". */
     current: ArtifactStreamItem | null;
 }
-export declare function useArtifactStream(content: string, registry?: RendererRegistry): UseArtifactStreamResult;
+export declare function useArtifactStream({ content }: {
+    content: string;
+}, { registry }?: {
+    registry?: (RendererRegistry) | undefined;
+}): UseArtifactStreamResult;
 //# sourceMappingURL=useArtifactStream.d.ts.map

package/dist/react/hooks/useArtifactStream.js

@@ -17,7 +17,7 @@ import { parseArtifacts, splitStreamingArtifact } from '../../core/index.js';
 function toFile(item) {
     return { name: item.identifier || item.title || 'artifact', kind: item.artifactType, content: item.content };
 }
-export function useArtifactStream(content, registry) {
+export function useArtifactStream({ content }, { registry } = {}) {
     return useMemo(() => {
         const items = [];
         // `splitStreamingArtifact` is the authority on "is there a trailing,
@@ -28,9 +28,9 @@ export function useArtifactStream(content, registry) {
         // Running it on the raw `content` would double-count a live artifact:
         // once (wrongly) as "complete" via the synthetic flush, and again (correctly)
         // as "streaming" below.
-        const { head, live } = splitStreamingArtifact(content);
+        const { head, live } = splitStreamingArtifact({ content: content });
         let current = null;
-        for (const ev of parseArtifacts(head)) {
+        for (const ev of parseArtifacts({ content: head })) {
             if (ev.type === 'artifact:start') {
                 current = { identifier: ev.identifier, artifactType: ev.artifactType, title: ev.title, content: '' };
             }

package/dist/react/hooks/useChatFabDrag.d.ts

@@ -17,9 +17,14 @@ export interface UseChatFabDragResult {
     onPointerCancel: (event: ReactPointerEvent<HTMLButtonElement>) => void;
 }
 /** Keeps a dragged position fully on screen, re-clamped on drag and on viewport resize. */
-export declare function clampChatFabToViewport(position: ChatFabPosition, size: {
-    width: number;
-    height: number;
+export declare function clampChatFabToViewport({ position, size }: {
+    position: ChatFabPosition;
+    size: {
+        width: number;
+        height: number;
+    };
 }): ChatFabPosition;
-export declare function useChatFabDrag(onClick: () => void): UseChatFabDragResult;
+export declare function useChatFabDrag({ onClick }: {
+    onClick: () => void;
+}): UseChatFabDragResult;
 //# sourceMappingURL=useChatFabDrag.d.ts.map

package/dist/react/hooks/useChatFabDrag.js

@@ -13,7 +13,7 @@ export const CHAT_FAB_DRAG_THRESHOLD_PX = 4;
 /** Keeps the button fully on screen with a small margin. */
 export const CHAT_FAB_EDGE_MARGIN_PX = 8;
 /** Keeps a dragged position fully on screen, re-clamped on drag and on viewport resize. */
-export function clampChatFabToViewport(position, size) {
+export function clampChatFabToViewport({ position, size }) {
     const maxX = Math.max(CHAT_FAB_EDGE_MARGIN_PX, globalThis.innerWidth - size.width - CHAT_FAB_EDGE_MARGIN_PX);
     const maxY = Math.max(CHAT_FAB_EDGE_MARGIN_PX, globalThis.innerHeight - size.height - CHAT_FAB_EDGE_MARGIN_PX);
     return {
@@ -21,7 +21,7 @@ export function clampChatFabToViewport(position, size) {
         y: Math.min(Math.max(position.y, CHAT_FAB_EDGE_MARGIN_PX), maxY),
     };
 }
-export function useChatFabDrag(onClick) {
+export function useChatFabDrag({ onClick }) {
     const buttonRef = useRef(null);
     const [position, setPosition] = useState(null);
     const drag = useRef(null);
@@ -32,7 +32,7 @@ export function useChatFabDrag(onClick) {
                 return;
             setPosition((current) => (current === null
                 ? null
-                : clampChatFabToViewport(current, { width: element.offsetWidth, height: element.offsetHeight })));
+                : clampChatFabToViewport({ position: current, size: { width: element.offsetWidth, height: element.offsetHeight } })));
         };
         globalThis.addEventListener('resize', onResize);
         return () => globalThis.removeEventListener('resize', onResize);
@@ -54,7 +54,7 @@ export function useChatFabDrag(onClick) {
         if (state === null || state.pointerId !== event.pointerId)
             return;
         const element = event.currentTarget;
-        const next = clampChatFabToViewport({ x: event.clientX - state.offsetX, y: event.clientY - state.offsetY }, { width: element.offsetWidth, height: element.offsetHeight });
+        const next = clampChatFabToViewport({ position: { x: event.clientX - state.offsetX, y: event.clientY - state.offsetY }, size: { width: element.offsetWidth, height: element.offsetHeight } });
         const rect = element.getBoundingClientRect();
         if (Math.abs(next.x - rect.left) > CHAT_FAB_DRAG_THRESHOLD_PX || Math.abs(next.y - rect.top) > CHAT_FAB_DRAG_THRESHOLD_PX) {
             state.moved = true;

package/dist/react/hooks/useComposer.js

@@ -33,14 +33,14 @@ import { cacheAttachmentPreviewSource } from './attachment-preview-cache.js';
 const EMPTY_MENTION = { open: false, query: '', results: [] };
 export function useComposer(options = {}) {
     const { project, composerSlots, persistence, conversationId, validateAttachments } = options;
-    const [draft, setDraftState] = useState(() => options.initialDraft ?? persistence?.read() ?? readCachedDraft(conversationId) ?? '');
+    const [draft, setDraftState] = useState(() => options.initialDraft ?? persistence?.read() ?? readCachedDraft({ conversationId: conversationId }) ?? '');
     const [attachments, setAttachments] = useState([]);
     const [agent, setAgent] = useState(options.initialAgent);
     const [mention, setMention] = useState(EMPTY_MENTION);
     const setDraft = useCallback((next) => {
         setDraftState(next);
         persistence?.write(next);
-        writeCachedDraft(conversationId, next);
+        writeCachedDraft({ conversationId: conversationId, draft: next });
     }, [persistence, conversationId]);
     // Lets the conversation-change effect below read the live draft without taking `draft` as a
     // dependency, which would re-run it on every keystroke.
@@ -57,7 +57,7 @@ export function useComposer(options = {}) {
         if (conversationId === previousConversationIdRef.current)
             return;
         previousConversationIdRef.current = conversationId;
-        const restored = readCachedDraft(conversationId);
+        const restored = readCachedDraft({ conversationId: conversationId });
         // An id arriving where there was none is NOT a switch between two conversations — it is the one
         // the operator is already looking at finally getting a key (a new chat created server-side
         // mid-compose, or a host that resolves the active id asynchronously after mount). Adopt what
@@ -68,7 +68,7 @@ export function useComposer(options = {}) {
         // message into another. Attachments and the mention popover are left alone here for the same
         // reason — nothing was switched away from.
         if (previousConversationId == null && conversationId != null && restored === null && draftRef.current.trim() !== '') {
-            writeCachedDraft(conversationId, draftRef.current);
+            writeCachedDraft({ conversationId: conversationId, draft: draftRef.current });
             return;
         }
         setDraftState(restored ?? '');
@@ -93,7 +93,7 @@ export function useComposer(options = {}) {
             attachmentsHydratedForRef.current = conversationId;
             return;
         }
-        const cached = readCachedAttachments(conversationId);
+        const cached = readCachedAttachments({ conversationId: conversationId });
         if (cached === null || cached.length === 0) {
             attachmentsHydratedForRef.current = conversationId;
             return;
@@ -118,7 +118,7 @@ export function useComposer(options = {}) {
             }
             else {
                 // Every reference was dead. Purge them so the next load does not pay for this again.
-                writeCachedAttachments(conversationId, []);
+                writeCachedAttachments({ conversationId: conversationId, attachments: [] });
             }
             attachmentsHydratedForRef.current = conversationId;
         })();
@@ -135,7 +135,7 @@ export function useComposer(options = {}) {
             return;
         if (attachmentsHydratedForRef.current !== conversationId)
             return;
-        writeCachedAttachments(conversationId, attachments);
+        writeCachedAttachments({ conversationId: conversationId, attachments: attachments });
     }, [attachments, conversationId]);
     const addAttachment = useCallback((attachment) => {
         setAttachments((prev) => [...prev, attachment]);
@@ -157,7 +157,7 @@ export function useComposer(options = {}) {
         uploaded.forEach((a, i) => {
             const file = files[i];
             if (file)
-                cacheAttachmentPreviewSource(a.path, file);
+                cacheAttachmentPreviewSource({ path: a.path, file });
         });
         for (const a of uploaded)
             composerSlots?.onAttach?.(a);