veryfront 0.1.997 → 0.1.998

package/esm/src/react/components/chat/chat/contexts/composer-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composer-context.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/contexts/composer-context.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,MAAM,kCAAkC,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IAEnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,gBAAgB,GAAG,mBAAmB,CAAC,KAAK,IAAI,CAAC;IAGjF,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACrC,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IAGnB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAGpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAID,gCAAgC;AAChC,wBAAgB,kBAAkB,IAAI,oBAAoB,CAQzD;AAED,gDAAgD;AAChD,wBAAgB,0BAA0B,IAAI,oBAAoB,GAAG,IAAI,CAExE;AAED,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,6CAA2B,CAAC"}
+{"version":3,"file":"composer-context.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/contexts/composer-context.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,MAAM,kCAAkC,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IAEnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,gBAAgB,GAAG,mBAAmB,CAAC,KAAK,IAAI,CAAC;IAGjF,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACrC,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IAGnB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAGpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAID,gCAAgC;AAChC,wBAAgB,kBAAkB,IAAI,oBAAoB,CAQzD;AAED,gDAAgD;AAChD,wBAAgB,0BAA0B,IAAI,oBAAoB,GAAG,IAAI,CAExE;AAED,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,6CAA2B,CAAC"}

package/esm/src/react/components/chat/chat/contexts/conversations-context.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ConversationsContext — the shared {@link useConversations} instance for a
+ * multi-conversation app. Put {@link ConversationsProvider} in your layout so
+ * the sidebar, the chat page, and `<Chat>` all read one source of truth; never
+ * call `useConversations()` again below it (a second call is a second,
+ * disconnected store).
+ *
+ * @module react/components/chat/contexts/conversations-context
+ */
+import * as React from "../../../../../../react/react.js";
+import { type UseConversationsOptions, type UseConversationsResult } from "../hooks/use-conversations.js";
+/** Read the shared conversations state. Throws when used outside a provider. */
+export declare function useConversationsContext(): UseConversationsResult;
+/** Read the shared conversations state, or `null` when there is no provider. */
+export declare function useConversationsContextOptional(): UseConversationsResult | null;
+/** Low-level context provider (value supplied by the caller). */
+export declare const ConversationsContextProvider: React.Provider<UseConversationsResult | null>;
+/** Props accepted by {@link ConversationsProvider}. */
+export interface ConversationsProviderProps extends UseConversationsOptions {
+    children: React.ReactNode;
+}
+/**
+ * ConversationsProvider — calls {@link useConversations} once with your
+ * `store` / `id` / `onSelect` and shares it via {@link ConversationsContext}.
+ * Declare persistence + router wiring here, once, at the app layout; children
+ * read it with {@link useConversationsContext}.
+ */
+export declare function ConversationsProvider({ children, ...options }: ConversationsProviderProps): React.ReactElement;
+//# sourceMappingURL=conversations-context.d.ts.map

package/esm/src/react/components/chat/chat/contexts/conversations-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations-context.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/contexts/conversations-context.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,KAAK,MAAM,kCAAkC,CAAC;AAE1D,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AAIvC,gFAAgF;AAChF,wBAAgB,uBAAuB,IAAI,sBAAsB,CAQhE;AAED,gFAAgF;AAChF,wBAAgB,+BAA+B,IAAI,sBAAsB,GAAG,IAAI,CAE/E;AAED,iEAAiE;AACjE,eAAO,MAAM,4BAA4B,+CAAgC,CAAC;AAE1E,uDAAuD;AACvD,MAAM,WAAW,0BAA2B,SAAQ,uBAAuB;IACzE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,0BAA0B,GACnD,KAAK,CAAC,YAAY,CAOpB"}

package/esm/src/react/components/chat/chat/contexts/conversations-context.js

@@ -0,0 +1,39 @@
+/**
+ * ConversationsContext — the shared {@link useConversations} instance for a
+ * multi-conversation app. Put {@link ConversationsProvider} in your layout so
+ * the sidebar, the chat page, and `<Chat>` all read one source of truth; never
+ * call `useConversations()` again below it (a second call is a second,
+ * disconnected store).
+ *
+ * @module react/components/chat/contexts/conversations-context
+ */
+import * as React from "../../../../../../react/react.js";
+import { COMPONENT_ERROR } from "../../../../../errors/error-registry.js";
+import { useConversations, } from "../hooks/use-conversations.js";
+const ConversationsContext = React.createContext(null);
+/** Read the shared conversations state. Throws when used outside a provider. */
+export function useConversationsContext() {
+    const context = React.useContext(ConversationsContext);
+    if (!context) {
+        throw COMPONENT_ERROR.create({
+            detail: "useConversationsContext must be used within a ConversationsProvider",
+        });
+    }
+    return context;
+}
+/** Read the shared conversations state, or `null` when there is no provider. */
+export function useConversationsContextOptional() {
+    return React.useContext(ConversationsContext);
+}
+/** Low-level context provider (value supplied by the caller). */
+export const ConversationsContextProvider = ConversationsContext.Provider;
+/**
+ * ConversationsProvider — calls {@link useConversations} once with your
+ * `store` / `id` / `onSelect` and shares it via {@link ConversationsContext}.
+ * Declare persistence + router wiring here, once, at the app layout; children
+ * read it with {@link useConversationsContext}.
+ */
+export function ConversationsProvider({ children, ...options }) {
+    const conversations = useConversations(options);
+    return (React.createElement(ConversationsContextProvider, { value: conversations }, children));
+}

package/esm/src/react/components/chat/chat/contexts/index.d.ts

@@ -9,5 +9,5 @@
 export { ChatContextProvider, type ChatContextValue, useChatContext, useChatContextOptional, } from "./chat-context.js";
 export { MessageContextProvider, type MessageContextValue, useMessageContext, useMessageContextOptional, } from "./message-context.js";
 export { ComposerContextProvider, type ComposerContextValue, useComposerContext, useComposerContextOptional, } from "./composer-context.js";
-export { ThreadListContextProvider, type ThreadListContextValue, useThreadListContext, useThreadListContextOptional, } from "./thread-list-context.js";
+export { ConversationsContextProvider, ConversationsProvider, type ConversationsProviderProps, useConversationsContext, useConversationsContextOptional, } from "./conversations-context.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/react/components/chat/chat/contexts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/contexts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,cAAc,EACd,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,yBAAyB,EACzB,KAAK,sBAAsB,EAC3B,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/contexts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,cAAc,EACd,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,KAAK,0BAA0B,EAC/B,uBAAuB,EACvB,+BAA+B,GAChC,MAAM,4BAA4B,CAAC"}

package/esm/src/react/components/chat/chat/contexts/index.js

@@ -9,4 +9,4 @@
 export { ChatContextProvider, useChatContext, useChatContextOptional, } from "./chat-context.js";
 export { MessageContextProvider, useMessageContext, useMessageContextOptional, } from "./message-context.js";
 export { ComposerContextProvider, useComposerContext, useComposerContextOptional, } from "./composer-context.js";
-export { ThreadListContextProvider, useThreadListContext, useThreadListContextOptional, } from "./thread-list-context.js";
+export { ConversationsContextProvider, ConversationsProvider, useConversationsContext, useConversationsContextOptional, } from "./conversations-context.js";

package/esm/src/react/components/chat/chat/contexts/message-context.d.ts

@@ -21,6 +21,8 @@ export interface MessageContextValue {
     onBranchPrev?: () => void;
     onBranchNext?: () => void;
     onCopy: () => Promise<void>;
+    /** True briefly after `onCopy` — lifted here so composed layouts keep the tick. */
+    copied: boolean;
     onEdit?: (content: string) => void;
     onRegenerate?: () => void;
     onFeedback?: (value: FeedbackValue) => void;

package/esm/src/react/components/chat/chat/contexts/message-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-context.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/contexts/message-context.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,MAAM,kCAAkC,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IAGpB,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAG1B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CACjC;AAID,+BAA+B;AAC/B,wBAAgB,iBAAiB,IAAI,mBAAmB,CAQvD;AAED,+CAA+C;AAC/C,wBAAgB,yBAAyB,IAAI,mBAAmB,GAAG,IAAI,CAEtE;AAED,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,4CAA0B,CAAC"}
+{"version":3,"file":"message-context.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/contexts/message-context.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,MAAM,kCAAkC,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IAGpB,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAG1B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,mFAAmF;IACnF,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CACjC;AAID,+BAA+B;AAC/B,wBAAgB,iBAAiB,IAAI,mBAAmB,CAQvD;AAED,+CAA+C;AAC/C,wBAAgB,yBAAyB,IAAI,mBAAmB,GAAG,IAAI,CAEtE;AAED,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,4CAA0B,CAAC"}

package/esm/src/react/components/chat/chat/hooks/use-clipboard.d.ts

@@ -0,0 +1,10 @@
+/** Result of {@link useClipboard}. */
+export interface UseClipboardResult {
+    /** True for `timeout` ms after a successful copy. */
+    copied: boolean;
+    /** Copy `text` to the clipboard (with a `document.execCommand` fallback). */
+    copy: (text: string) => Promise<void>;
+}
+/** Copy-to-clipboard with a transient `copied` flag. */
+export declare function useClipboard(timeout?: number): UseClipboardResult;
+//# sourceMappingURL=use-clipboard.d.ts.map

package/esm/src/react/components/chat/chat/hooks/use-clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-clipboard.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/hooks/use-clipboard.ts"],"names":[],"mappings":"AAcA,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,MAAM,EAAE,OAAO,CAAC;IAChB,6EAA6E;IAC7E,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,OAAO,SAAO,GAAG,kBAAkB,CAqB/D"}

package/esm/src/react/components/chat/chat/hooks/use-clipboard.js

@@ -0,0 +1,34 @@
+/**
+ * useClipboard — copy text with a transient "copied" flag and a legacy fallback.
+ *
+ * Extracted so both the message action bar and the code-block copy button share
+ * one implementation, and so the `copied` tick can be lifted into MessageContext
+ * (a composed layout keeps the affordance instead of losing it on eject).
+ *
+ * @module react/components/chat/chat/hooks/use-clipboard
+ */
+import * as dntShim from "../../../../../../_dnt.shims.js";
+import * as React from "../../../../../../react/react.js";
+/** Copy-to-clipboard with a transient `copied` flag. */
+export function useClipboard(timeout = 2000) {
+    const [copied, setCopied] = React.useState(false);
+    const copy = React.useCallback(async (text) => {
+        try {
+            await navigator.clipboard.writeText(text);
+        }
+        catch (_) {
+            /* expected: clipboard API unavailable in older/insecure contexts */
+            const textarea = document.createElement("textarea");
+            textarea.value = text;
+            document.body.appendChild(textarea);
+            textarea.select();
+            document.execCommand("copy");
+            document.body.removeChild(textarea);
+        }
+        finally {
+            setCopied(true);
+            dntShim.setTimeout(() => setCopied(false), timeout);
+        }
+    }, [timeout]);
+    return { copied, copy };
+}

package/esm/src/react/components/chat/chat/hooks/use-conversation.d.ts

@@ -0,0 +1,21 @@
+import type { Conversation, ConversationStore } from "../persistence/conversation-store.js";
+/** Options for {@link useConversation}. */
+export interface UseConversationOptions {
+    /** Async persistence adapter. Default: `localConversationStore(storageKey)`.
+     *  Ignored when a surrounding `ConversationsProvider` already holds the id. */
+    store?: ConversationStore;
+    /** Convenience storage key for the default localStorage adapter. */
+    storageKey?: string;
+}
+/** Result of {@link useConversation}. */
+export interface UseConversationResult {
+    /** The full conversation (with messages), or `null` while loading / not found. */
+    conversation: Conversation | null;
+    /** True while the conversation is loading from the store. */
+    isLoading: boolean;
+    /** Re-fetch from the store. */
+    reload: () => void;
+}
+/** Load one full conversation by id, over a swappable async store. */
+export declare function useConversation(id: string | null | undefined, options?: UseConversationOptions): UseConversationResult;
+//# sourceMappingURL=use-conversation.d.ts.map

package/esm/src/react/components/chat/chat/hooks/use-conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/hooks/use-conversation.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAI5F,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC;mFAC+E;IAC/E,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yCAAyC;AACzC,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC7B,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CA4CvB"}

package/esm/src/react/components/chat/chat/hooks/use-conversation.js

@@ -0,0 +1,54 @@
+/**
+ * useConversation — load a single full {@link Conversation} (with messages) by
+ * id, over the same swappable {@link ConversationStore} as {@link useConversations}.
+ * The singular companion to the list hook: use it to preview or open one
+ * conversation without mounting the whole list.
+ *
+ * Inside a {@link ConversationsProvider} it short-circuits when the requested id
+ * is already the active conversation (no redundant load); otherwise it fetches
+ * from the store. Pass your own `store` to point it anywhere, or omit it to use
+ * the default localStorage adapter.
+ *
+ * @module react/components/chat/hooks/use-conversation
+ */
+import * as React from "../../../../../../react/react.js";
+import { localConversationStore } from "../persistence/local-conversation-store.js";
+import { useConversationsContextOptional } from "../contexts/conversations-context.js";
+/** Load one full conversation by id, over a swappable async store. */
+export function useConversation(id, options = {}) {
+    const { storageKey } = options;
+    // Inside a provider, reuse its already-loaded active conversation when it
+    // matches — avoids a redundant round-trip and stays in sync with edits.
+    const context = useConversationsContextOptional();
+    const fromContext = context?.active && context.active.id === id ? context.active : null;
+    const store = React.useMemo(() => options.store ?? localConversationStore(storageKey), [options.store, storageKey]);
+    const [conversation, setConversation] = React.useState(fromContext);
+    const [isLoading, setIsLoading] = React.useState(false);
+    const [reloadToken, setReloadToken] = React.useState(0);
+    const reload = React.useCallback(() => setReloadToken((token) => token + 1), []);
+    React.useEffect(() => {
+        if (!id) {
+            setConversation(null);
+            setIsLoading(false);
+            return;
+        }
+        // The provider already has this conversation — mirror it, no fetch.
+        if (fromContext) {
+            setConversation(fromContext);
+            setIsLoading(false);
+            return;
+        }
+        let cancelled = false;
+        setIsLoading(true);
+        void store.load(id).then((loaded) => {
+            if (cancelled)
+                return;
+            setConversation(loaded);
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [id, store, fromContext, reloadToken]);
+    return { conversation, isLoading, reload };
+}

package/esm/src/react/components/chat/chat/hooks/use-conversations.d.ts

@@ -0,0 +1,67 @@
+import type { ChatMessage } from "../../../../../agent/react/index.js";
+import type { Conversation, ConversationStore, ConversationSummary } from "../persistence/conversation-store.js";
+/** Default title for a fresh, untitled conversation. */
+export declare const DEFAULT_CONVERSATION_TITLE = "New Chat";
+/** A fresh, empty conversation. `now`/`id` are injectable for tests. */
+export declare function createEmptyConversation(opts?: {
+    agentId?: string;
+    id?: string;
+    now?: number;
+}): Conversation;
+/** First user message text, trimmed to a title-sized slug. `""` if none. */
+export declare function deriveTitle(messages: ChatMessage[]): string;
+/** Derive a summary from a full conversation (mirrors the adapters). */
+export declare function conversationSummary(c: Conversation): ConversationSummary;
+/** Insert or replace a summary, newest (`updatedAt`) first. */
+export declare function upsertSummary(summaries: ConversationSummary[], summary: ConversationSummary): ConversationSummary[];
+/** The id to select after removing `removedId` — the newest remaining, or null. */
+export declare function nextActiveAfterRemove(summaries: ConversationSummary[], removedId: string): string | null;
+/** Fields a conversation can be patched with. */
+export interface ConversationPatch {
+    title?: string;
+    messages?: ChatMessage[];
+    agentId?: string;
+}
+/** Options for {@link useConversations}. */
+export interface UseConversationsOptions {
+    /** Controlled active id — YOU own the source (e.g. `router.query.thread`).
+     *  Omit to let the hook manage active internally (uncontrolled). */
+    id?: string | null;
+    /** Fired when active should change (select / after create / after remove).
+     *  Wire it to your router. Omit → internal active state. */
+    onSelect?: (id: string | null) => void;
+    /** Async persistence adapter. Default: `localConversationStore(storageKey)`.
+     *  Keep it referentially stable (module-level factory or `useMemo`). */
+    store?: ConversationStore;
+    /** Convenience storage key for the default localStorage adapter. */
+    storageKey?: string;
+}
+/** Result of {@link useConversations}. */
+export interface UseConversationsResult {
+    /** All conversations as summaries (no messages), newest first. */
+    conversations: ConversationSummary[];
+    /** The full active conversation (with messages), or `null`. */
+    active: Conversation | null;
+    activeId: string | null;
+    /** True while the initial list is loading from the store. */
+    isLoading: boolean;
+    select: (id?: string | null) => void;
+    create: (agentId?: string) => Conversation;
+    rename: (id: string, title: string) => void;
+    remove: (id: string) => void;
+    update: (id: string, patch: ConversationPatch) => void;
+    /**
+     * Upsert a whole conversation (create-or-update). The store default for
+     * `<Chat onUpdate>` — hand it the emitted `{ id, messages, title, updatedAt }`
+     * and it lands in the list + persists. The conversation arrives fully formed
+     * (title already derived by the emitter), so this stays dumb about titling.
+     */
+    save: (conversation: Conversation) => void;
+    /** Persist a live chat's messages + auto-title from the first user message. */
+    bind: (id: string, chat: {
+        messages: ChatMessage[];
+    }) => void;
+}
+/** List + active + persistence for conversations, over a swappable async store. */
+export declare function useConversations(options?: UseConversationsOptions): UseConversationsResult;
+//# sourceMappingURL=use-conversations.d.ts.map

package/esm/src/react/components/chat/chat/hooks/use-conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversations.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/hooks/use-conversations.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,sCAAsC,CAAC;AAG9C,wDAAwD;AACxD,eAAO,MAAM,0BAA0B,aAAa,CAAC;AAiBrD,wEAAwE;AACxE,wBAAgB,uBAAuB,CACrC,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GACzD,YAAY,CAUd;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAS3D;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,YAAY,GAAG,mBAAmB,CASxE;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAC3B,SAAS,EAAE,mBAAmB,EAAE,EAChC,OAAO,EAAE,mBAAmB,GAC3B,mBAAmB,EAAE,CAIvB;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,mBAAmB,EAAE,EAChC,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAGf;AAMD,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC;wEACoE;IACpE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB;gEAC4D;IAC5D,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACvC;4EACwE;IACxE,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,0CAA0C;AAC1C,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,+DAA+D;IAC/D,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACrC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,YAAY,CAAC;IAC3C,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACvD;;;;;OAKG;IACH,IAAI,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;IAC3C,+EAA+E;IAC/E,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,QAAQ,EAAE,WAAW,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;CAC/D;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,sBAAsB,CAyP9F"}

package/esm/src/react/components/chat/chat/hooks/use-conversations.js

@@ -0,0 +1,317 @@
+/**
+ * useConversations — the conversation list + active-thread hook, backed by a
+ * swappable async {@link ConversationStore}. Owns what the havana example used
+ * to hand-roll in userland: load/persist, auto-title, create/remove/select, and
+ * per-message binding.
+ *
+ * The active id is **controlled** — pass `id` (from your router) + `onSelect`
+ * and the hook stays router-agnostic; omit them and it manages active itself.
+ * Persistence is async and pluggable; batching (debounced saves) lives here so
+ * adapters stay dumb.
+ *
+ * @module react/components/chat/hooks/use-conversations
+ */
+import * as dntShim from "../../../../../../_dnt.shims.js";
+import * as React from "../../../../../../react/react.js";
+import { localConversationStore } from "../persistence/local-conversation-store.js";
+/** Default title for a fresh, untitled conversation. */
+export const DEFAULT_CONVERSATION_TITLE = "New Chat";
+const AUTOTITLE_MAX = 40;
+const SAVE_DEBOUNCE_MS = 300;
+// ---------------------------------------------------------------------------
+// Pure helpers — the state transitions, extracted so they're unit-testable
+// without a React renderer (the hook is a thin wrapper over these).
+// ---------------------------------------------------------------------------
+function randomId() {
+    const c = dntShim.dntGlobalThis.crypto;
+    const rand = c && "randomUUID" in c
+        ? c.randomUUID().slice(0, 8)
+        : Math.random().toString(36).slice(2, 10);
+    return `c_${rand}`;
+}
+/** A fresh, empty conversation. `now`/`id` are injectable for tests. */
+export function createEmptyConversation(opts = {}) {
+    const now = opts.now ?? Date.now();
+    return {
+        id: opts.id ?? randomId(),
+        title: DEFAULT_CONVERSATION_TITLE,
+        messages: [],
+        ...(opts.agentId ? { agentId: opts.agentId } : {}),
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+/** First user message text, trimmed to a title-sized slug. `""` if none. */
+export function deriveTitle(messages) {
+    const firstUser = messages.find((m) => m.role === "user");
+    if (!firstUser)
+        return "";
+    const text = firstUser.parts
+        .filter((p) => p.type === "text")
+        .map((p) => p.text)
+        .join("")
+        .trim();
+    return text.length > AUTOTITLE_MAX ? `${text.slice(0, AUTOTITLE_MAX).trimEnd()}…` : text;
+}
+/** Derive a summary from a full conversation (mirrors the adapters). */
+export function conversationSummary(c) {
+    return {
+        id: c.id,
+        title: c.title,
+        ...(c.agentId ? { agentId: c.agentId } : {}),
+        messageCount: c.messages.length,
+        createdAt: c.createdAt,
+        updatedAt: c.updatedAt,
+    };
+}
+/** Insert or replace a summary, newest (`updatedAt`) first. */
+export function upsertSummary(summaries, summary) {
+    return [...summaries.filter((s) => s.id !== summary.id), summary].sort((a, b) => b.updatedAt - a.updatedAt);
+}
+/** The id to select after removing `removedId` — the newest remaining, or null. */
+export function nextActiveAfterRemove(summaries, removedId) {
+    const remaining = summaries.filter((s) => s.id !== removedId);
+    return remaining[0]?.id ?? null;
+}
+/** List + active + persistence for conversations, over a swappable async store. */
+export function useConversations(options = {}) {
+    const { id: controlledId, onSelect, storageKey } = options;
+    const isControlled = controlledId !== undefined;
+    const store = React.useMemo(() => options.store ?? localConversationStore(storageKey), [options.store, storageKey]);
+    const [summaries, setSummaries] = React.useState([]);
+    const [isLoading, setIsLoading] = React.useState(true);
+    const [active, setActive] = React.useState(null);
+    const [internalActiveId, setInternalActiveId] = React.useState(null);
+    const activeId = isControlled ? (controlledId ?? null) : internalActiveId;
+    // Keep the latest values reachable from stable callbacks without re-creating them.
+    const summariesRef = React.useRef(summaries);
+    summariesRef.current = summaries;
+    const activeRef = React.useRef(active);
+    activeRef.current = active;
+    const select = React.useCallback((id) => {
+        const next = id ?? null;
+        if (isControlled)
+            onSelect?.(next);
+        else
+            setInternalActiveId(next);
+    }, [isControlled, onSelect]);
+    // Debounced persistence — a burst of streaming message updates collapses to
+    // one save. Flushed on unmount so nothing is lost.
+    const saveTimer = React.useRef(undefined);
+    const pendingSave = React.useRef(null);
+    const flushSave = React.useCallback(() => {
+        clearTimeout(saveTimer.current);
+        if (pendingSave.current) {
+            void store.save(pendingSave.current);
+            pendingSave.current = null;
+        }
+    }, [store]);
+    const discardPendingSave = React.useCallback((id) => {
+        if (pendingSave.current?.id !== id)
+            return;
+        clearTimeout(saveTimer.current);
+        pendingSave.current = null;
+    }, []);
+    const scheduleSave = React.useCallback((conversation) => {
+        // A pending save for a *different* conversation must be flushed, not
+        // clobbered: switching threads inside the debounce window would
+        // otherwise drop the previous thread's final messages.
+        if (pendingSave.current && pendingSave.current.id !== conversation.id) {
+            flushSave();
+        }
+        pendingSave.current = conversation;
+        clearTimeout(saveTimer.current);
+        saveTimer.current = dntShim.setTimeout(flushSave, SAVE_DEBOUNCE_MS);
+    }, [flushSave]);
+    React.useEffect(() => flushSave, [flushSave]);
+    const create = React.useCallback((agentId) => {
+        // Reuse an existing untouched draft instead of piling up "New Chat" rows —
+        // clicking "New chat" (or an auto-create) when a blank draft already exists
+        // just re-opens it.
+        const draft = summariesRef.current.find((s) => s.messageCount === 0 && s.title === DEFAULT_CONVERSATION_TITLE);
+        if (draft) {
+            const reused = activeRef.current?.id === draft.id ? activeRef.current : {
+                id: draft.id,
+                title: draft.title,
+                ...(draft.agentId ? { agentId: draft.agentId } : {}),
+                messages: [],
+                createdAt: draft.createdAt,
+                updatedAt: draft.updatedAt,
+            };
+            setActive(reused);
+            select(draft.id);
+            return reused;
+        }
+        const conversation = createEmptyConversation({ agentId });
+        void store.save(conversation);
+        setSummaries((prev) => upsertSummary(prev, conversationSummary(conversation)));
+        setActive(conversation);
+        select(conversation.id);
+        return conversation;
+    }, [store, select]);
+    // Initial load: pull the list; auto-create a draft only when there's nothing
+    // to open, otherwise land on the most-recent conversation (so a reload
+    // restores where you were instead of spawning a fresh "New Chat"). Runs once
+    // per store.
+    const didInit = React.useRef(false);
+    React.useEffect(() => {
+        didInit.current = false;
+        let cancelled = false;
+        setIsLoading(true);
+        void store.list().then((list) => {
+            if (cancelled)
+                return;
+            setSummaries(list);
+            setIsLoading(false);
+            if (!didInit.current) {
+                if (list.length === 0)
+                    create();
+                else if (!isControlled && activeRef.current == null) {
+                    const firstId = list[0]?.id ?? null;
+                    select(firstId);
+                    if (firstId) {
+                        void store.load(firstId).then((conversation) => {
+                            if (!cancelled)
+                                setActive(conversation);
+                        });
+                    }
+                }
+            }
+            didInit.current = true;
+        });
+        const unsubscribe = store.subscribe?.(() => {
+            void store.list().then((list) => !cancelled && setSummaries(list));
+        });
+        return () => {
+            cancelled = true;
+            unsubscribe?.();
+        };
+        // `create` is stable enough; intentionally keyed on the store only.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [store]);
+    // Load the full active conversation when the active id changes. Skip when we
+    // already hold it (optimistic create/update set `active` directly).
+    React.useEffect(() => {
+        if (!activeId) {
+            setActive(null);
+            return;
+        }
+        if (activeRef.current?.id === activeId)
+            return;
+        let cancelled = false;
+        void store.load(activeId).then((conversation) => {
+            if (!cancelled)
+                setActive(conversation);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [activeId, store]);
+    const update = React.useCallback((id, patch) => {
+        const now = Date.now();
+        setSummaries((prev) => {
+            const existing = prev.find((s) => s.id === id);
+            if (!existing)
+                return prev;
+            return upsertSummary(prev, {
+                ...existing,
+                ...(patch.title !== undefined ? { title: patch.title } : {}),
+                ...(patch.agentId !== undefined ? { agentId: patch.agentId } : {}),
+                ...(patch.messages ? { messageCount: patch.messages.length } : {}),
+                updatedAt: now,
+            });
+        });
+        if (activeRef.current?.id === id) {
+            const next = { ...activeRef.current, ...patch, updatedAt: now };
+            setActive(next);
+            scheduleSave(next);
+        }
+        else {
+            // Non-active edit (e.g. rename from the sidebar) — load, patch, save now.
+            void store.load(id).then((conversation) => {
+                if (conversation)
+                    void store.save({ ...conversation, ...patch, updatedAt: now });
+            });
+        }
+    }, [store, scheduleSave]);
+    const save = React.useCallback((conversation) => {
+        const summary = conversationSummary(conversation);
+        // Streaming emits once per token; the list (and everything reading this
+        // context) only cares when something it shows (title, count, order)
+        // actually changes. Returning `prev` bails out of the re-render.
+        setSummaries((prev) => {
+            const existing = prev.find((s) => s.id === summary.id);
+            if (existing && existing.title === summary.title &&
+                existing.messageCount === summary.messageCount)
+                return prev;
+            return upsertSummary(prev, summary);
+        });
+        // Keep the in-memory active thread in sync when it's the one being saved,
+        // so a re-open reads the just-saved messages instead of the loaded blob.
+        // Same churn gate: mid-stream token growth is captured by the debounced
+        // store write below; `active` consumers only read it on remount.
+        if (activeRef.current?.id === conversation.id) {
+            const current = activeRef.current;
+            if (current.title !== conversation.title ||
+                current.messages.length !== conversation.messages.length)
+                setActive(conversation);
+        }
+        scheduleSave(conversation);
+    }, [scheduleSave]);
+    const bind = React.useCallback((id, chat) => {
+        const current = activeRef.current?.id === id
+            ? activeRef.current
+            : summariesRef.current.find((s) => s.id === id);
+        const patch = { messages: chat.messages };
+        // Auto-title an untitled conversation from its first user message.
+        if (current && current.title === DEFAULT_CONVERSATION_TITLE) {
+            const title = deriveTitle(chat.messages);
+            if (title)
+                patch.title = title;
+        }
+        update(id, patch);
+    }, [update]);
+    const rename = React.useCallback((id, title) => {
+        update(id, { title });
+    }, [update]);
+    const remove = React.useCallback((id) => {
+        discardPendingSave(id);
+        void store.delete(id);
+        const next = nextActiveAfterRemove(summariesRef.current, id);
+        setSummaries((prev) => prev.filter((s) => s.id !== id));
+        if (id === activeId) {
+            if (next)
+                select(next);
+            else
+                create();
+        }
+    }, [store, activeId, select, create, discardPendingSave]);
+    // Memoized so `ConversationsProvider` can pass this straight through as a
+    // context value: consumers re-render only when the state above changes, not
+    // on every render of the provider.
+    return React.useMemo(() => ({
+        conversations: summaries,
+        active,
+        activeId,
+        isLoading,
+        select,
+        create,
+        rename,
+        remove,
+        update,
+        save,
+        bind,
+    }), [
+        summaries,
+        active,
+        activeId,
+        isLoading,
+        select,
+        create,
+        rename,
+        remove,
+        update,
+        save,
+        bind,
+    ]);
+}