@steerable/agent-ui 0.2.3 → 0.2.4

package/dist/state/parseSSE.js

@@ -0,0 +1,112 @@
+/**
+ * `parseSSE` — wire-level Server-Sent-Events parser.
+ *
+ * Feed it raw text chunks from any source (fetch ReadableStream chunks,
+ * Electron IPC `webContents.send` payloads, mocked fixtures, …). It buffers,
+ * splits on the `\r?\n\r?\n` frame terminator, and emits one
+ * `{ event?, data?, id?, retry? }` per complete frame. JSON parsing of `data`
+ * is intentionally out of scope; downstream layers like {@link bridgeLegacySSE}
+ * handle that.
+ *
+ * Replaces deeppath's `SSEParser` and deeppath-agent's `LocalBackendSseParser`
+ * with a single dependency-free implementation that compiles to both Node and
+ * the browser. Heartbeat-timeout watchdogs (deeppath had a 30 s gate) live on
+ * the transport, not here — this class is a pure parser.
+ */
+export class SSEParser {
+    options;
+    buffer = '';
+    completed = false;
+    constructor(options) {
+        this.options = options;
+    }
+    /** Feed one chunk. Safe to call with partial UTF-8 strings (we don't decode). */
+    feed(chunk) {
+        if (this.completed)
+            return;
+        this.buffer += chunk;
+        const parts = this.buffer.split(/\r?\n\r?\n/);
+        this.buffer = parts.pop() ?? '';
+        for (const frame of parts) {
+            if (frame.length > 0)
+                this.processFrame(frame);
+        }
+    }
+    /** Call when the source signals end-of-stream. Flushes any trailing frame. */
+    end() {
+        if (this.completed)
+            return;
+        if (this.buffer.trim().length > 0)
+            this.processFrame(this.buffer);
+        this.buffer = '';
+    }
+    /** Drop all state and stop emitting. */
+    cleanup() {
+        this.buffer = '';
+        this.completed = true;
+    }
+    processFrame(raw) {
+        const frame = {};
+        const dataLines = [];
+        for (const line of raw.split(/\r?\n/)) {
+            if (line.length === 0)
+                continue;
+            // Comments per the SSE spec — leading `:` lines.
+            if (line.startsWith(':'))
+                continue;
+            const colon = line.indexOf(':');
+            const field = colon === -1 ? line : line.substring(0, colon);
+            let value = colon === -1 ? '' : line.substring(colon + 1);
+            if (value.startsWith(' '))
+                value = value.substring(1);
+            switch (field) {
+                case 'event':
+                    frame.event = value;
+                    break;
+                case 'data':
+                    dataLines.push(value);
+                    break;
+                case 'id':
+                    frame.id = value;
+                    break;
+                case 'retry': {
+                    const ms = Number.parseInt(value, 10);
+                    if (Number.isFinite(ms))
+                        frame.retry = ms;
+                    break;
+                }
+                default:
+                    break;
+            }
+        }
+        if (dataLines.length === 0 && frame.event === undefined && frame.id === undefined) {
+            return;
+        }
+        if (dataLines.length > 0)
+            frame.data = dataLines.join('\n');
+        if (frame.data === '[DONE]' || frame.data === '"[DONE]"') {
+            this.completed = true;
+            this.options.onComplete?.();
+            return;
+        }
+        try {
+            this.options.onFrame(frame);
+        }
+        catch (err) {
+            this.options.onError?.(err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+}
+/**
+ * Tolerant JSON parser for SSE `data:` payloads — returns the raw string when
+ * the body isn't JSON, which deeppath relies on for bare-text content deltas.
+ */
+export function parseSSEData(data) {
+    try {
+        return JSON.parse(data);
+    }
+    catch {
+        return data;
+    }
+}
+//# sourceMappingURL=parseSSE.js.map

package/dist/state/parseSSE.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseSSE.js","sourceRoot":"","sources":["../../src/state/parseSSE.ts"],"names":[],"mappings":"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"}

package/dist/state/useChatComposer.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `useChatComposer` — input draft + send/cancel + keyboard glue.
+ *
+ * Lifted from deeppath-agent's `LocalChatPanel.tsx` (inline `inputValue` /
+ * `handleSubmit`) and deeppath's `ChatInput` (cancel handling). The hook is
+ * intentionally UI-free: it owns the draft string and the keyboard
+ * dispatcher; the visible textarea and send button live in the consuming
+ * component.
+ *
+ * Typical wiring:
+ *
+ *   const composer = useChatComposer({ onSend: send, onCancel: cancel });
+ *
+ *   <textarea
+ *     value={composer.value}
+ *     onChange={(e) => composer.setValue(e.target.value)}
+ *     onKeyDown={composer.handleKeyDown}
+ *   />
+ *   <button onClick={composer.submit}>Send</button>
+ */
+export interface UseChatComposerOptions {
+    initialValue?: string;
+    /** Called with the trimmed value when the user submits a non-empty draft. */
+    onSend: (value: string) => void | Promise<void>;
+    /** Called when the user wants to cancel the in-flight stream. Optional. */
+    onCancel?: () => void;
+    /**
+     * If true (default), Enter submits and Shift+Enter inserts a newline. Set
+     * to false for "Enter inserts newline, Cmd/Ctrl+Enter submits" semantics.
+     */
+    enterToSubmit?: boolean;
+    /** Whether the composer is currently disabled (no submit / no key handling). */
+    disabled?: boolean;
+    /**
+     * Whether the parent reports an in-flight stream. When true, `submit()` is
+     * a no-op and Enter triggers `onCancel` instead. Mirrors the cloud product.
+     */
+    isStreaming?: boolean;
+}
+export interface UseChatComposerReturn {
+    value: string;
+    setValue: (value: string) => void;
+    submit: () => Promise<void> | void;
+    cancel: () => void;
+    clear: () => void;
+    handleKeyDown: (e: React.KeyboardEvent<HTMLElement>) => void;
+    /** True if `value.trim()` is non-empty and we're not disabled. */
+    canSubmit: boolean;
+}
+export declare function useChatComposer(options: UseChatComposerOptions): UseChatComposerReturn;
+//# sourceMappingURL=useChatComposer.d.ts.map

package/dist/state/useChatComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatComposer.d.ts","sourceRoot":"","sources":["../../src/state/useChatComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,aAAa,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC7D,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CA8DtF"}

package/dist/state/useChatComposer.js

@@ -0,0 +1,82 @@
+/**
+ * `useChatComposer` — input draft + send/cancel + keyboard glue.
+ *
+ * Lifted from deeppath-agent's `LocalChatPanel.tsx` (inline `inputValue` /
+ * `handleSubmit`) and deeppath's `ChatInput` (cancel handling). The hook is
+ * intentionally UI-free: it owns the draft string and the keyboard
+ * dispatcher; the visible textarea and send button live in the consuming
+ * component.
+ *
+ * Typical wiring:
+ *
+ *   const composer = useChatComposer({ onSend: send, onCancel: cancel });
+ *
+ *   <textarea
+ *     value={composer.value}
+ *     onChange={(e) => composer.setValue(e.target.value)}
+ *     onKeyDown={composer.handleKeyDown}
+ *   />
+ *   <button onClick={composer.submit}>Send</button>
+ */
+import { useCallback, useRef, useState } from 'react';
+export function useChatComposer(options) {
+    const [value, setValue] = useState(options.initialValue ?? '');
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const submit = useCallback(async () => {
+        const opts = optionsRef.current;
+        if (opts.disabled || opts.isStreaming)
+            return;
+        const trimmed = value.trim();
+        if (!trimmed)
+            return;
+        // Clear synchronously so the user can keep typing while the request flies.
+        setValue('');
+        await opts.onSend(trimmed);
+    }, [value]);
+    const cancel = useCallback(() => {
+        optionsRef.current.onCancel?.();
+    }, []);
+    const clear = useCallback(() => setValue(''), []);
+    const handleKeyDown = useCallback((e) => {
+        const opts = optionsRef.current;
+        if (opts.disabled)
+            return;
+        const enterSubmits = opts.enterToSubmit ?? true;
+        if (e.key === 'Enter') {
+            if (enterSubmits && !e.shiftKey && !e.metaKey && !e.ctrlKey) {
+                e.preventDefault();
+                if (opts.isStreaming) {
+                    cancel();
+                }
+                else {
+                    void submit();
+                }
+                return;
+            }
+            if (!enterSubmits && (e.metaKey || e.ctrlKey)) {
+                e.preventDefault();
+                if (opts.isStreaming)
+                    cancel();
+                else
+                    void submit();
+                return;
+            }
+        }
+        if (e.key === 'Escape' && opts.isStreaming) {
+            e.preventDefault();
+            cancel();
+        }
+    }, [submit, cancel]);
+    const canSubmit = value.trim().length > 0 && !(options.disabled || options.isStreaming);
+    return {
+        value,
+        setValue,
+        submit,
+        cancel,
+        clear,
+        handleKeyDown,
+        canSubmit,
+    };
+}
+//# sourceMappingURL=useChatComposer.js.map

package/dist/state/useChatComposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatComposer.js","sourceRoot":"","sources":["../../src/state/useChatComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAiCtD,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACpC,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC;QAChC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,2EAA2E;QAC3E,QAAQ,CAAC,EAAE,CAAC,CAAC;QACb,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;IAClC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAElD,MAAM,aAAa,GAAG,WAAW,CAC/B,CAAC,CAAmC,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC;QAChC,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC;QAChD,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;YACtB,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC5D,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;oBACrB,MAAM,EAAE,CAAC;gBACX,CAAC;qBAAM,CAAC;oBACN,KAAK,MAAM,EAAE,CAAC;gBAChB,CAAC;gBACD,OAAO;YACT,CAAC;YACD,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9C,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,IAAI,IAAI,CAAC,WAAW;oBAAE,MAAM,EAAE,CAAC;;oBAC1B,KAAK,MAAM,EAAE,CAAC;gBACnB,OAAO;YACT,CAAC;QACH,CAAC;QACD,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3C,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC,EACD,CAAC,MAAM,EAAE,MAAM,CAAC,CACjB,CAAC;IAEF,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAExF,OAAO;QACL,KAAK;QACL,QAAQ;QACR,MAAM;QACN,MAAM;QACN,KAAK;QACL,aAAa;QACb,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/state/useChatList.d.ts

@@ -0,0 +1,71 @@
+/**
+ * `useChatList` — paginated chat-summary + agent-catalog state for the chat
+ * sidebar. Generic in the chat and agent shapes so cloud and local apps reuse
+ * the same hook (the cloud schema has extra fields on `Chat`, the local
+ * schema has fewer).
+ *
+ * Lifted from deeppath-agent's `useChatsAndAgents.ts` and deeppath's
+ * `useChatUI` chat-list subset. The hook owns:
+ *   - paginated chat list with "load more" and refresh
+ *   - the agent catalog (single page for now)
+ *   - the agent picked for the next new chat
+ *   - in-place title patching (used by `chat_title_updated` SSE events to
+ *     avoid clobbering pagination state with a full refresh)
+ *   - create / delete chat actions, with optimistic patching of the local
+ *     list.
+ *
+ * The transport is provided by the consumer so the same hook serves Electron
+ * IPC, the cloud REST client, or any other backend.
+ */
+import { type Dispatch, type SetStateAction } from 'react';
+export interface ChatListTransport<TChat, TAgent> {
+    listChats: (input: {
+        page: number;
+        pageSize: number;
+    }) => Promise<{
+        chats: TChat[];
+        hasMore: boolean;
+    }>;
+    listAgents: () => Promise<TAgent[]>;
+    createChat?: (input: {
+        agentId?: string;
+    }) => Promise<TChat | string>;
+    deleteChat?: (chatId: string) => Promise<boolean>;
+    /** Tell the hook how to read a chat's id and title. */
+    getChatId: (chat: TChat) => string;
+    setChatTitle?: (chat: TChat, title: string) => TChat;
+    /** Tell the hook how to read an agent's id (for `selectedAgentId`). */
+    getAgentId: (agent: TAgent) => string;
+}
+export interface UseChatListOptions<TChat, TAgent> {
+    transport: ChatListTransport<TChat, TAgent>;
+    /** Defaults to 50. */
+    pageSize?: number;
+    /** Skip the mount-time fetch (e.g. SSR contexts). */
+    skipInitialLoad?: boolean;
+}
+export interface UseChatListReturn<TChat, TAgent> {
+    chats: TChat[];
+    agents: TAgent[];
+    isLoading: boolean;
+    isLoadingMoreChats: boolean;
+    hasMoreChats: boolean;
+    error: Error | null;
+    selectedAgentId: string | null;
+    /**
+     * Accepts either a plain value or a React-style updater function so
+     * adapters can patch the selection without re-reading the current value.
+     */
+    setSelectedAgentId: Dispatch<SetStateAction<string | null>>;
+    refreshChats: () => Promise<void>;
+    refreshAgents: () => Promise<void>;
+    loadMoreChats: () => Promise<void>;
+    createChat: (input?: {
+        agentId?: string;
+    }) => Promise<string | null>;
+    deleteChat: (chatId: string) => Promise<boolean>;
+    /** In-place title patcher — does not hit the server. */
+    patchChatTitle: (chatId: string, title: string) => void;
+}
+export declare function useChatList<TChat, TAgent>(options: UseChatListOptions<TChat, TAgent>): UseChatListReturn<TChat, TAgent>;
+//# sourceMappingURL=useChatList.d.ts.map

package/dist/state/useChatList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatList.d.ts","sourceRoot":"","sources":["../../src/state/useChatList.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAML,KAAK,QAAQ,EACb,KAAK,cAAc,EACpB,MAAM,OAAO,CAAC;AAEf,MAAM,WAAW,iBAAiB,CAAC,KAAK,EAAE,MAAM;IAC9C,SAAS,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAChE,KAAK,EAAE,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;IACtE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,uDAAuD;IACvD,SAAS,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAC;IACnC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC;IACrD,uEAAuE;IACvE,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB,CAAC,KAAK,EAAE,MAAM;IAC/C,SAAS,EAAE,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC5C,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB,CAAC,KAAK,EAAE,MAAM;IAC9C,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;OAGG;IACH,kBAAkB,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IAC5D,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACrE,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,wDAAwD;IACxD,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EACvC,OAAO,EAAE,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,GACzC,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CA2IlC"}

package/dist/state/useChatList.js

@@ -0,0 +1,158 @@
+/**
+ * `useChatList` — paginated chat-summary + agent-catalog state for the chat
+ * sidebar. Generic in the chat and agent shapes so cloud and local apps reuse
+ * the same hook (the cloud schema has extra fields on `Chat`, the local
+ * schema has fewer).
+ *
+ * Lifted from deeppath-agent's `useChatsAndAgents.ts` and deeppath's
+ * `useChatUI` chat-list subset. The hook owns:
+ *   - paginated chat list with "load more" and refresh
+ *   - the agent catalog (single page for now)
+ *   - the agent picked for the next new chat
+ *   - in-place title patching (used by `chat_title_updated` SSE events to
+ *     avoid clobbering pagination state with a full refresh)
+ *   - create / delete chat actions, with optimistic patching of the local
+ *     list.
+ *
+ * The transport is provided by the consumer so the same hook serves Electron
+ * IPC, the cloud REST client, or any other backend.
+ */
+import { useCallback, useEffect, useMemo, useRef, useState, } from 'react';
+export function useChatList(options) {
+    const pageSize = options.pageSize ?? 50;
+    const transportRef = useRef(options.transport);
+    transportRef.current = options.transport;
+    const [chats, setChats] = useState([]);
+    const [agents, setAgents] = useState([]);
+    const [isLoading, setLoading] = useState(!options.skipInitialLoad);
+    const [isLoadingMoreChats, setLoadingMore] = useState(false);
+    const [hasMoreChats, setHasMore] = useState(false);
+    const [error, setError] = useState(null);
+    const [selectedAgentId, setSelectedAgentId] = useState(null);
+    const pageRef = useRef(1);
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    const refreshChats = useCallback(async () => {
+        setLoading(true);
+        try {
+            const res = await transportRef.current.listChats({ page: 1, pageSize });
+            if (!mountedRef.current)
+                return;
+            setChats(res.chats);
+            setHasMore(res.hasMore);
+            pageRef.current = 1;
+            setError(null);
+        }
+        catch (err) {
+            if (mountedRef.current)
+                setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            if (mountedRef.current)
+                setLoading(false);
+        }
+    }, [pageSize]);
+    const refreshAgents = useCallback(async () => {
+        try {
+            const list = await transportRef.current.listAgents();
+            if (mountedRef.current)
+                setAgents(list);
+        }
+        catch (err) {
+            if (mountedRef.current)
+                setError(err instanceof Error ? err : new Error(String(err)));
+        }
+    }, []);
+    const loadMoreChats = useCallback(async () => {
+        if (!hasMoreChats || isLoadingMoreChats)
+            return;
+        setLoadingMore(true);
+        try {
+            const next = pageRef.current + 1;
+            const res = await transportRef.current.listChats({ page: next, pageSize });
+            if (!mountedRef.current)
+                return;
+            setChats((prev) => prev.concat(res.chats));
+            setHasMore(res.hasMore);
+            pageRef.current = next;
+        }
+        catch (err) {
+            if (mountedRef.current)
+                setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            if (mountedRef.current)
+                setLoadingMore(false);
+        }
+    }, [hasMoreChats, isLoadingMoreChats, pageSize]);
+    const createChat = useCallback(async (input) => {
+        const t = transportRef.current;
+        if (!t.createChat)
+            return null;
+        const created = await t.createChat({ agentId: input?.agentId ?? selectedAgentId ?? undefined });
+        // Either a chat object or a bare id.
+        const id = typeof created === 'string' ? created : t.getChatId(created);
+        await refreshChats();
+        return id;
+    }, [refreshChats, selectedAgentId]);
+    const deleteChat = useCallback(async (chatId) => {
+        const t = transportRef.current;
+        if (!t.deleteChat)
+            return false;
+        const ok = await t.deleteChat(chatId);
+        if (ok && mountedRef.current) {
+            setChats((prev) => prev.filter((c) => t.getChatId(c) !== chatId));
+        }
+        return ok;
+    }, []);
+    const patchChatTitle = useCallback((chatId, title) => {
+        const t = transportRef.current;
+        if (!t.setChatTitle)
+            return;
+        setChats((prev) => prev.map((c) => (t.getChatId(c) === chatId ? t.setChatTitle(c, title) : c)));
+    }, []);
+    useEffect(() => {
+        if (options.skipInitialLoad)
+            return;
+        void refreshChats();
+        void refreshAgents();
+        // Run once on mount; downstream callers use refresh* explicitly.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    return useMemo(() => ({
+        chats,
+        agents,
+        isLoading,
+        isLoadingMoreChats,
+        hasMoreChats,
+        error,
+        selectedAgentId,
+        setSelectedAgentId,
+        refreshChats,
+        refreshAgents,
+        loadMoreChats,
+        createChat,
+        deleteChat,
+        patchChatTitle,
+    }), [
+        chats,
+        agents,
+        isLoading,
+        isLoadingMoreChats,
+        hasMoreChats,
+        error,
+        selectedAgentId,
+        refreshChats,
+        refreshAgents,
+        loadMoreChats,
+        createChat,
+        deleteChat,
+        patchChatTitle,
+    ]);
+}
+//# sourceMappingURL=useChatList.js.map

package/dist/state/useChatList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatList.js","sourceRoot":"","sources":["../../src/state/useChatList.ts"],"names":[],"mappings":"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"}

package/dist/state/useChatSession.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `useChatSession` — convenience wrapper that combines `useChatStream` (turn
+ * lifecycle) with `useChatComposer` (draft + keys + send). Most consumers want
+ * this single hook so the wiring is identical across web-shell, deeppath, and
+ * deeppath-agent. Power users still reach for the underlying primitives.
+ *
+ *   const { messages, isStreaming, composer, cancel } = useChatSession({
+ *     transport,
+ *     initialMessages,
+ *   });
+ *
+ *   <ChatPanel>
+ *     <MessageList messages={messages} isStreaming={isStreaming} />
+ *     <ChatInput composer={composer} onCancel={cancel} />
+ *   </ChatPanel>
+ */
+import { type UseChatStreamOptions, type UseChatStreamReturn } from '../hooks/useChatStream.js';
+import { type UseChatComposerOptions, type UseChatComposerReturn } from './useChatComposer.js';
+export interface UseChatSessionOptions extends UseChatStreamOptions, Pick<UseChatComposerOptions, 'enterToSubmit' | 'initialValue'> {
+    /** Optional metadata callback when submitting a message (e.g. @mentions). */
+    buildMetadata?: (value: string) => Record<string, unknown> | undefined;
+    /** Force-disable the composer regardless of streaming state. */
+    composerDisabled?: boolean;
+}
+export interface UseChatSessionReturn extends UseChatStreamReturn {
+    composer: UseChatComposerReturn;
+}
+export declare function useChatSession(options: UseChatSessionOptions): UseChatSessionReturn;
+//# sourceMappingURL=useChatSession.d.ts.map

package/dist/state/useChatSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatSession.d.ts","sourceRoot":"","sources":["../../src/state/useChatSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,qBACf,SAAQ,oBAAoB,EAC1B,IAAI,CAAC,sBAAsB,EAAE,eAAe,GAAG,cAAc,CAAC;IAChE,6EAA6E;IAC7E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACvE,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,CAqBnF"}

package/dist/state/useChatSession.js

@@ -0,0 +1,37 @@
+/**
+ * `useChatSession` — convenience wrapper that combines `useChatStream` (turn
+ * lifecycle) with `useChatComposer` (draft + keys + send). Most consumers want
+ * this single hook so the wiring is identical across web-shell, deeppath, and
+ * deeppath-agent. Power users still reach for the underlying primitives.
+ *
+ *   const { messages, isStreaming, composer, cancel } = useChatSession({
+ *     transport,
+ *     initialMessages,
+ *   });
+ *
+ *   <ChatPanel>
+ *     <MessageList messages={messages} isStreaming={isStreaming} />
+ *     <ChatInput composer={composer} onCancel={cancel} />
+ *   </ChatPanel>
+ */
+import { useMemo } from 'react';
+import { useChatStream, } from '../hooks/useChatStream.js';
+import { useChatComposer, } from './useChatComposer.js';
+export function useChatSession(options) {
+    const stream = useChatStream(options);
+    const composer = useChatComposer({
+        initialValue: options.initialValue,
+        enterToSubmit: options.enterToSubmit,
+        isStreaming: stream.isStreaming,
+        disabled: options.composerDisabled,
+        onSend: async (value) => {
+            await stream.sendUserMessage({
+                content: value,
+                metadata: options.buildMetadata?.(value),
+            });
+        },
+        onCancel: stream.cancel,
+    });
+    return useMemo(() => ({ ...stream, composer }), [stream, composer]);
+}
+//# sourceMappingURL=useChatSession.js.map

package/dist/state/useChatSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatSession.js","sourceRoot":"","sources":["../../src/state/useChatSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EACL,aAAa,GAGd,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,eAAe,GAGhB,MAAM,sBAAsB,CAAC;AAe9B,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAEtC,MAAM,QAAQ,GAAG,eAAe,CAAC;QAC/B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,QAAQ,EAAE,OAAO,CAAC,gBAAgB;QAClC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACtB,MAAM,MAAM,CAAC,eAAe,CAAC;gBAC3B,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC;aACzC,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,EAAE,MAAM,CAAC,MAAM;KACxB,CAAC,CAAC;IAEH,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,EAC/B,CAAC,MAAM,EAAE,QAAQ,CAAC,CACnB,CAAC;AACJ,CAAC"}

package/dist/state/useScrollLock.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `useScrollLock` — sticky-bottom scrolling for streaming message lists.
+ *
+ * The hook returns a callback ref to attach to the scroll container and a
+ * `scrollToBottom` imperative API. Behaviour:
+ *   - When the container's scroll position is within `threshold` px of the
+ *     bottom, the hook treats the user as "anchored" and re-runs
+ *     `scrollToBottom` whenever the dependency array `revalidateKeys` changes.
+ *   - As soon as the user scrolls up past `threshold`, the lock releases —
+ *     the list will no longer auto-scroll until the user scrolls back to the
+ *     bottom (or `scrollToBottom` is called explicitly, e.g. on send).
+ *
+ * Uses a callback ref so the listener attaches the moment the element mounts,
+ * not after a second effect pass. Matches deeppath's MessageList scroll
+ * handling minus the inline MutationObserver+IntersectionObserver soup.
+ */
+export interface UseScrollLockOptions {
+    /** Px from the bottom that still counts as "anchored". Default 24. */
+    threshold?: number;
+    /**
+     * Dependencies that, when changed, will trigger an auto-scroll if the user
+     * is currently anchored. Pass e.g. `[messages.length, lastMessageContent]`.
+     */
+    revalidateKeys?: ReadonlyArray<unknown>;
+    /** Scroll smooth vs jump. Defaults to 'auto' (instant). */
+    behavior?: ScrollBehavior;
+}
+export interface UseScrollLockReturn<E extends HTMLElement = HTMLDivElement> {
+    /** Callback ref — pass directly to `ref={...}` on the scroll container. */
+    setRef: (el: E | null) => void;
+    isAnchored: boolean;
+    scrollToBottom: (behavior?: ScrollBehavior) => void;
+}
+export declare function useScrollLock<E extends HTMLElement = HTMLDivElement>(options?: UseScrollLockOptions): UseScrollLockReturn<E>;
+//# sourceMappingURL=useScrollLock.d.ts.map

package/dist/state/useScrollLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollLock.d.ts","sourceRoot":"","sources":["../../src/state/useScrollLock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,cAAc,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACxC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,WAAW,GAAG,cAAc;IACzE,2EAA2E;IAC3E,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,CAAC,QAAQ,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;CACrD;AAMD,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,cAAc,EAClE,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CAAC,CAAC,CAAC,CA4DxB"}