@djangocfg/ui-tools 2.1.336 → 2.1.338

package/dist/{chunk-KRETIZU6.mjs → chunk-QE25H6DP.mjs}

@@ -1,7 +1,8 @@
 import { MarkdownMessage } from './chunk-2ZLKZ5VR.mjs';
 import { __name } from './chunk-N2XQF2OL.mjs';
 import { createContext, forwardRef, memo, useCallback, useReducer, useRef, useEffect, useState, useMemo, useSyncExternalStore, useContext } from 'react';
-import { cn } from '@djangocfg/ui-core/lib';
+import { cn, isDev } from '@djangocfg/ui-core/lib';
+import { consola } from 'consola';
 import { useLocalStorage, useMediaQuery } from '@djangocfg/ui-core/hooks';
 import { create } from 'zustand';
 import { persist, createJSONStorage } from 'zustand/middleware';
@@ -294,6 +295,32 @@ function createId(prefix = "m") {
   return `${prefix}_${Date.now().toString(36)}_${counter.toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
 }
 __name(createId, "createId");
+var SCOPES = ["bootstrap", "transport", "stream", "lifecycle", "tools", "error"];
+var cache = /* @__PURE__ */ new Map();
+function buildLogger(enabled) {
+  const root = consola.withTag("chat");
+  const subs = Object.fromEntries(
+    SCOPES.map((scope) => [scope, root.withTag(scope)])
+  );
+  if (!enabled) {
+    for (const scope of SCOPES) {
+      if (scope === "error") continue;
+      subs[scope].level = -999;
+    }
+  }
+  return { ...subs, enabled };
+}
+__name(buildLogger, "buildLogger");
+function getChatLogger(debug) {
+  const enabled = debug ?? isDev;
+  let logger = cache.get(enabled);
+  if (!logger) {
+    logger = buildLogger(enabled);
+    cache.set(enabled, logger);
+  }
+  return logger;
+}
+__name(getChatLogger, "getChatLogger");
 
 // src/tools/Chat/core/markdown.ts
 function createTokenBuffer(onFlush, windowMs = LIMITS.streamCoalesceMs) {
@@ -339,32 +366,53 @@ function useChat(config) {
   stateRef.current = state;
   const abortRef = useRef(null);
   const lastErrorRef = useRef(null);
-  const initRef = useRef(false);
   const streamingMsgIdRef = useRef(null);
+  const bootstrapRef = useRef(null);
   const { transport, autoCreateSession = true, streaming = true, pageSize = LIMITS.pageSize } = config;
+  const log = getChatLogger(config.debug);
   useEffect(() => {
-    if (initRef.current) return;
-    initRef.current = true;
     let cancelled = false;
+    if (stateRef.current.sessionId) {
+      return;
+    }
+    if (config.initialSessionId || autoCreateSession) {
+      dispatch({ type: "HISTORY_LOAD_START" });
+    }
+    log.bootstrap.info("start", {
+      mode: config.initialSessionId ? "resume" : autoCreateSession ? "create" : "idle",
+      initialSessionId: config.initialSessionId
+    });
     const run = /* @__PURE__ */ __name(async () => {
+      const t0 = performance.now();
       try {
         if (config.initialSessionId) {
-          dispatch({
-            type: "SESSION_SET",
-            sessionId: config.initialSessionId
-          });
-          dispatch({ type: "HISTORY_LOAD_START" });
+          if (!cancelled) {
+            dispatch({
+              type: "SESSION_SET",
+              sessionId: config.initialSessionId
+            });
+          }
           const page = await transport.loadHistory(config.initialSessionId, null, pageSize);
-          if (cancelled) return;
+          if (cancelled) {
+            log.bootstrap.debug("cancelled (post-loadHistory)");
+            return config.initialSessionId;
+          }
           dispatch({
             type: "HISTORY_LOAD_DONE",
             messages: page.messages,
             hasMore: page.hasMore,
             cursor: page.nextCursor
           });
-        } else if (autoCreateSession) {
+          log.bootstrap.success("resumed", {
+            sessionId: config.initialSessionId,
+            messages: page.messages.length,
+            hasMore: page.hasMore,
+            elapsedMs: Math.round(performance.now() - t0)
+          });
+          return config.initialSessionId;
+        }
+        if (autoCreateSession) {
           const info = await transport.createSession({ metadata: config.metadata });
-          if (cancelled) return;
           dispatch({
             type: "SESSION_SET",
             sessionId: info.sessionId,
@@ -372,19 +420,48 @@ function useChat(config) {
             hasMore: info.hasMore ?? false,
             cursor: info.cursor ?? null
           });
+          dispatch({
+            type: "HISTORY_LOAD_DONE",
+            messages: info.messages ?? [],
+            hasMore: info.hasMore ?? false,
+            cursor: info.cursor ?? null
+          });
+          log.bootstrap.success(cancelled ? "created (post-cancel)" : "created", {
+            sessionId: info.sessionId,
+            resumed: info.resumed ?? false,
+            cancelled,
+            elapsedMs: Math.round(performance.now() - t0)
+          });
+          return info.sessionId;
         }
+        log.bootstrap.debug("idle (no initialSessionId, autoCreateSession=false)");
+        return null;
       } catch (err) {
         const e = err instanceof Error ? err : new Error(String(err));
+        if (cancelled) {
+          log.bootstrap.debug("cancelled (in catch)", { message: e.message });
+          return null;
+        }
         lastErrorRef.current = e;
         dispatch({ type: "ERROR_SET", error: e.message });
         config.onError?.(e);
+        log.error.error("bootstrap failed", { message: e.message, elapsedMs: Math.round(performance.now() - t0) });
+        return null;
       }
     }, "run");
-    void run();
+    bootstrapRef.current = run();
     return () => {
       cancelled = true;
     };
   }, []);
+  const awaitSession = useCallback(async () => {
+    if (stateRef.current.sessionId) return stateRef.current.sessionId;
+    if (bootstrapRef.current) {
+      const id = await bootstrapRef.current;
+      if (id) return id;
+    }
+    return stateRef.current.sessionId;
+  }, []);
   const consumeStream = useCallback(
     async (sessionId, content, attachments) => {
       const ctrl = new AbortController();
@@ -393,9 +470,13 @@ function useChat(config) {
       streamingMsgIdRef.current = assistantId;
       dispatch({ type: "STREAM_START", id: assistantId });
       config.onStreamStart?.(assistantId);
+      log.stream.info("start", { sessionId, assistantId, chars: content.length });
       const tokenBuffer = createTokenBuffer(
         (delta) => dispatch({ type: "STREAM_CHUNK", delta })
       );
+      let chunkCount = 0;
+      let charsReceived = 0;
+      const t0 = performance.now();
       try {
         const iterator = transport.stream(sessionId, content, {
           signal: ctrl.signal,
@@ -412,17 +493,25 @@ function useChat(config) {
         }
         const finalMsg = stateRef.current.messages.find((m) => m.id === assistantId);
         if (finalMsg) config.onMessageEnd?.(finalMsg);
+        log.stream.success("done", {
+          assistantId,
+          chunks: chunkCount,
+          chars: charsReceived,
+          elapsedMs: Math.round(performance.now() - t0)
+        });
       } catch (err) {
         tokenBuffer.close();
         if (ctrl.signal.aborted) {
           const partial = stateRef.current.messages.find((m) => m.id === assistantId)?.content ?? "";
           dispatch({ type: "STREAM_CANCELLED", id: assistantId, partialText: partial });
+          log.stream.warn("cancelled", { assistantId, partialChars: partial.length });
           return;
         }
         const e = err instanceof Error ? err : new Error(String(err));
         lastErrorRef.current = e;
         dispatch({ type: "STREAM_ERROR", id: assistantId, message: e.message });
         config.onError?.(e);
+        log.error.error("stream failed", { assistantId, message: e.message });
       } finally {
         tokenBuffer.close();
         if (abortRef.current === ctrl) abortRef.current = null;
@@ -432,13 +521,17 @@ function useChat(config) {
         switch (ev.type) {
           case "message_start":
             ev.messageId;
+            log.stream.debug("message_start", { messageId: ev.messageId });
             return;
           case "chunk":
             tokenBuffer.push(ev.delta);
+            chunkCount += 1;
+            charsReceived += ev.delta.length;
             return;
           case "tool_activity":
             tokenBuffer.flush();
             dispatch({ type: "STREAM_TOOL_ACTIVITY", tool: ev.tool });
+            log.tools.debug("activity", { tool: ev.tool, status: ev.status });
             return;
           case "tool_call_start": {
             tokenBuffer.flush();
@@ -455,6 +548,7 @@ function useChat(config) {
               messageId: assistantId,
               toolCall
             });
+            log.tools.info("call_start", { toolId: ev.toolId, name: ev.name });
             return;
           }
           case "tool_call_delta":
@@ -473,6 +567,7 @@ function useChat(config) {
               output: ev.output,
               status: ev.status
             });
+            log.tools.info("call_end", { toolId: ev.toolId, status: ev.status });
             return;
           case "message_end":
             tokenBuffer.flush();
@@ -483,6 +578,11 @@ function useChat(config) {
               tokensOut: ev.tokensOut,
               sources: ev.sources
             });
+            log.stream.debug("message_end", {
+              tokensIn: ev.tokensIn,
+              tokensOut: ev.tokensOut,
+              sources: ev.sources?.length ?? 0
+            });
             return;
           case "error":
             tokenBuffer.flush();
@@ -491,6 +591,7 @@ function useChat(config) {
               id: assistantId,
               message: ev.message
             });
+            log.error.error("stream event error", { code: ev.code, message: ev.message });
             return;
         }
       }
@@ -527,16 +628,28 @@ function useChat(config) {
   );
   const sendMessage = useCallback(
     async (content, attachments) => {
-      const sessionId = stateRef.current.sessionId;
+      log.lifecycle.info("sendMessage", {
+        chars: content.length,
+        attachments: attachments?.length ?? 0,
+        hasSession: !!stateRef.current.sessionId
+      });
+      const sessionId = await awaitSession();
       if (!sessionId) {
         const e = new Error("No active session");
         lastErrorRef.current = e;
         dispatch({ type: "ERROR_SET", error: e.message });
         config.onError?.(e);
+        log.error.error("sendMessage aborted: no session");
+        return;
+      }
+      if (!content.trim() && !(attachments && attachments.length > 0)) {
+        log.lifecycle.debug("sendMessage skipped (empty)");
+        return;
+      }
+      if (stateRef.current.isStreaming) {
+        log.lifecycle.debug("sendMessage skipped (already streaming)");
         return;
       }
-      if (!content.trim() && !(attachments && attachments.length > 0)) return;
-      if (stateRef.current.isStreaming) return;
       const userMsg = {
         id: createId("u"),
         role: "user",
@@ -553,13 +666,14 @@ function useChat(config) {
         await consumeBuffered(sessionId, content, attachments);
       }
     },
-    [streaming, consumeStream, consumeBuffered, config]
+    [streaming, consumeStream, consumeBuffered, config, awaitSession]
   );
   const cancelStream = useCallback(() => {
     abortRef.current?.abort();
   }, []);
   const regenerate = useCallback(
     async (messageId) => {
+      log.lifecycle.info("regenerate", { messageId: messageId ?? "(last)" });
       const messages = stateRef.current.messages;
       let targetUserIdx = -1;
       if (messageId) {
@@ -575,7 +689,7 @@ function useChat(config) {
       for (let i = messages.length - 1; i > targetUserIdx; i -= 1) {
         dispatch({ type: "MESSAGE_DELETE", id: messages[i].id });
       }
-      const sessionId = stateRef.current.sessionId;
+      const sessionId = await awaitSession();
       if (!sessionId) return;
       if (streaming) {
         await consumeStream(sessionId, userMsg.content, userMsg.attachments);
@@ -583,7 +697,7 @@ function useChat(config) {
         await consumeBuffered(sessionId, userMsg.content, userMsg.attachments);
       }
     },
-    [streaming, consumeStream, consumeBuffered]
+    [streaming, consumeStream, consumeBuffered, awaitSession]
   );
   const editMessage = useCallback(
     async (id, content) => {
@@ -627,6 +741,7 @@ function useChat(config) {
     }
   }, [transport, pageSize, config]);
   const newSession = useCallback(async () => {
+    log.lifecycle.info("newSession", { previous: stateRef.current.sessionId });
     abortRef.current?.abort();
     const previous = stateRef.current.sessionId;
     if (previous) {
@@ -645,11 +760,13 @@ function useChat(config) {
         hasMore: info.hasMore ?? false,
         cursor: info.cursor ?? null
       });
+      log.lifecycle.success("newSession ok", { sessionId: info.sessionId });
     } catch (err) {
       const e = err instanceof Error ? err : new Error(String(err));
       lastErrorRef.current = e;
       dispatch({ type: "ERROR_SET", error: e.message });
       config.onError?.(e);
+      log.error.error("newSession failed", { message: e.message });
     }
   }, [transport, config]);
   return {
@@ -763,14 +880,14 @@ function createAudioBus(options) {
     return noopBus();
   }
   let sounds = options.sounds;
-  const cache = /* @__PURE__ */ new Map();
+  const cache2 = /* @__PURE__ */ new Map();
   const getOrCreate = /* @__PURE__ */ __name((url) => {
-    const hit = cache.get(url);
+    const hit = cache2.get(url);
     if (hit) return hit;
     const el = new Audio(url);
     el.preload = "auto";
     el.crossOrigin = "anonymous";
-    cache.set(url, el);
+    cache2.set(url, el);
     return el;
   }, "getOrCreate");
   const resolveUrl = /* @__PURE__ */ __name((event) => {
@@ -804,7 +921,7 @@ function createAudioBus(options) {
   }, "preload");
   const unlock = /* @__PURE__ */ __name(() => {
     if (unlocked) return;
-    for (const el of cache.values()) {
+    for (const el of cache2.values()) {
       const wasMuted = el.muted;
       el.muted = true;
       const p = el.play();
@@ -836,7 +953,7 @@ function createAudioBus(options) {
       sounds = next;
     },
     dispose() {
-      cache.clear();
+      cache2.clear();
     }
   };
 }
@@ -1048,6 +1165,7 @@ function ChatProvider({
   autoCreateSession,
   streaming,
   audio,
+  debug,
   children
 }) {
   const audioApi = useChatAudio(audio ?? {});
@@ -1062,6 +1180,7 @@ function ChatProvider({
     initialSessionId,
     autoCreateSession,
     streaming,
+    debug,
     metadata: {
       locale: config.locale ?? config.prefs?.locale,
       slug: config.slug
@@ -2093,7 +2212,7 @@ function copy(text) {
 }
 __name(copy, "copy");
 function ChatRoot(props) {
-  const { transport, config, initialSessionId, autoCreateSession, streaming, audio, className, ...slots } = props;
+  const { transport, config, initialSessionId, autoCreateSession, streaming, audio, debug, className, ...slots } = props;
   return /* @__PURE__ */ jsx(
     ChatProvider,
     {
@@ -2103,6 +2222,7 @@ function ChatRoot(props) {
       autoCreateSession,
       streaming,
       audio,
+      debug,
       children: /* @__PURE__ */ jsx(ChatRootShell, { className, slots })
     }
   );
@@ -2213,6 +2333,6 @@ function copy2(text) {
 }
 __name(copy2, "copy");
 
-export { Attachments, AttachmentsGrid, AttachmentsList, CHAT_EVENT_NAME, CSS_VARS, ChatProvider, ChatRoot, Composer, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, EmptyState, ErrorBanner, HOTKEYS, JumpToLatest, LIMITS, MessageActions, MessageBubble, MessageList, STORAGE_KEYS, Sources, StreamingIndicator, ToolCalls, createId, createTokenBuffer, deriveInitials, initialState, reducer, resolvePersona, useChat, useChatAudio, useChatAudioPrefs, useChatComposer, useChatContext, useChatContextOptional, useChatHistory, useChatLayout, useChatScroll };
-//# sourceMappingURL=chunk-KRETIZU6.mjs.map
-//# sourceMappingURL=chunk-KRETIZU6.mjs.map
+export { Attachments, AttachmentsGrid, AttachmentsList, CHAT_EVENT_NAME, CSS_VARS, ChatProvider, ChatRoot, Composer, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, EmptyState, ErrorBanner, HOTKEYS, JumpToLatest, LIMITS, MessageActions, MessageBubble, MessageList, STORAGE_KEYS, Sources, StreamingIndicator, ToolCalls, createId, createTokenBuffer, deriveInitials, getChatLogger, initialState, reducer, resolvePersona, useChat, useChatAudio, useChatAudioPrefs, useChatComposer, useChatContext, useChatContextOptional, useChatHistory, useChatLayout, useChatScroll };
+//# sourceMappingURL=chunk-QE25H6DP.mjs.map
+//# sourceMappingURL=chunk-QE25H6DP.mjs.map