@djangocfg/ui-tools 2.1.336 → 2.1.337

package/dist/{chunk-NRXYYO5V.cjs → chunk-ZWPBBAR2.cjs}

@@ -4,6 +4,7 @@ var chunkB5AWZOHJ_cjs = require('./chunk-B5AWZOHJ.cjs');
 var chunkOLISEQHS_cjs = require('./chunk-OLISEQHS.cjs');
 var react = require('react');
 var lib = require('@djangocfg/ui-core/lib');
+var consola = require('consola');
 var hooks = require('@djangocfg/ui-core/hooks');
 var zustand = require('zustand');
 var middleware = require('zustand/middleware');
@@ -296,6 +297,32 @@ function createId(prefix = "m") {
   return `${prefix}_${Date.now().toString(36)}_${counter.toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
 }
 chunkOLISEQHS_cjs.__name(createId, "createId");
+var SCOPES = ["bootstrap", "transport", "stream", "lifecycle", "tools", "error"];
+var cache = /* @__PURE__ */ new Map();
+function buildLogger(enabled) {
+  const root = consola.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 };
+}
+chunkOLISEQHS_cjs.__name(buildLogger, "buildLogger");
+function getChatLogger(debug) {
+  const enabled = debug ?? lib.isDev;
+  let logger = cache.get(enabled);
+  if (!logger) {
+    logger = buildLogger(enabled);
+    cache.set(enabled, logger);
+  }
+  return logger;
+}
+chunkOLISEQHS_cjs.__name(getChatLogger, "getChatLogger");
 
 // src/tools/Chat/core/markdown.ts
 function createTokenBuffer(onFlush, windowMs = LIMITS.streamCoalesceMs) {
@@ -343,30 +370,53 @@ function useChat(config) {
   const lastErrorRef = react.useRef(null);
   const initRef = react.useRef(false);
   const streamingMsgIdRef = react.useRef(null);
+  const bootstrapRef = react.useRef(null);
   const { transport, autoCreateSession = true, streaming = true, pageSize = LIMITS.pageSize } = config;
+  const log = getChatLogger(config.debug);
   react.useEffect(() => {
     if (initRef.current) return;
     initRef.current = true;
     let cancelled = false;
+    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__ */ chunkOLISEQHS_cjs.__name(async () => {
+      const t0 = performance.now();
       try {
         if (config.initialSessionId) {
           dispatch({
             type: "SESSION_SET",
             sessionId: config.initialSessionId
           });
-          dispatch({ type: "HISTORY_LOAD_START" });
           const page = await transport.loadHistory(config.initialSessionId, null, pageSize);
-          if (cancelled) return;
+          if (cancelled) {
+            log.bootstrap.debug("cancelled (post-loadHistory)");
+            return null;
+          }
           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;
+          if (cancelled) {
+            log.bootstrap.debug("cancelled (post-createSession)");
+            return null;
+          }
           dispatch({
             type: "SESSION_SET",
             sessionId: info.sessionId,
@@ -374,19 +424,47 @@ 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("created", {
+            sessionId: info.sessionId,
+            resumed: info.resumed ?? false,
+            elapsedMs: Math.round(performance.now() - t0)
+          });
+          return info.sessionId;
         }
+        log.bootstrap.debug("idle (no initialSessionId, autoCreateSession=false)");
+        return null;
       } catch (err) {
+        if (cancelled) {
+          log.bootstrap.debug("cancelled (in catch)");
+          return null;
+        }
         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("bootstrap failed", { message: e.message, elapsedMs: Math.round(performance.now() - t0) });
+        return null;
       }
     }, "run");
-    void run();
+    bootstrapRef.current = run();
     return () => {
       cancelled = true;
     };
   }, []);
+  const awaitSession = react.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 = react.useCallback(
     async (sessionId, content, attachments) => {
       const ctrl = new AbortController();
@@ -395,9 +473,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,
@@ -414,17 +496,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;
@@ -434,13 +524,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();
@@ -457,6 +551,7 @@ function useChat(config) {
               messageId: assistantId,
               toolCall
             });
+            log.tools.info("call_start", { toolId: ev.toolId, name: ev.name });
             return;
           }
           case "tool_call_delta":
@@ -475,6 +570,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();
@@ -485,6 +581,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();
@@ -493,6 +594,7 @@ function useChat(config) {
               id: assistantId,
               message: ev.message
             });
+            log.error.error("stream event error", { code: ev.code, message: ev.message });
             return;
         }
       }
@@ -529,16 +631,28 @@ function useChat(config) {
   );
   const sendMessage = react.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",
@@ -555,13 +669,14 @@ function useChat(config) {
         await consumeBuffered(sessionId, content, attachments);
       }
     },
-    [streaming, consumeStream, consumeBuffered, config]
+    [streaming, consumeStream, consumeBuffered, config, awaitSession]
   );
   const cancelStream = react.useCallback(() => {
     abortRef.current?.abort();
   }, []);
   const regenerate = react.useCallback(
     async (messageId) => {
+      log.lifecycle.info("regenerate", { messageId: messageId ?? "(last)" });
       const messages = stateRef.current.messages;
       let targetUserIdx = -1;
       if (messageId) {
@@ -577,7 +692,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);
@@ -585,7 +700,7 @@ function useChat(config) {
         await consumeBuffered(sessionId, userMsg.content, userMsg.attachments);
       }
     },
-    [streaming, consumeStream, consumeBuffered]
+    [streaming, consumeStream, consumeBuffered, awaitSession]
   );
   const editMessage = react.useCallback(
     async (id, content) => {
@@ -629,6 +744,7 @@ function useChat(config) {
     }
   }, [transport, pageSize, config]);
   const newSession = react.useCallback(async () => {
+    log.lifecycle.info("newSession", { previous: stateRef.current.sessionId });
     abortRef.current?.abort();
     const previous = stateRef.current.sessionId;
     if (previous) {
@@ -647,11 +763,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 {
@@ -765,14 +883,14 @@ function createAudioBus(options) {
     return noopBus();
   }
   let sounds = options.sounds;
-  const cache = /* @__PURE__ */ new Map();
+  const cache2 = /* @__PURE__ */ new Map();
   const getOrCreate = /* @__PURE__ */ chunkOLISEQHS_cjs.__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__ */ chunkOLISEQHS_cjs.__name((event) => {
@@ -806,7 +924,7 @@ function createAudioBus(options) {
   }, "preload");
   const unlock = /* @__PURE__ */ chunkOLISEQHS_cjs.__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();
@@ -838,7 +956,7 @@ function createAudioBus(options) {
       sounds = next;
     },
     dispose() {
-      cache.clear();
+      cache2.clear();
     }
   };
 }
@@ -1050,6 +1168,7 @@ function ChatProvider({
   autoCreateSession,
   streaming,
   audio,
+  debug,
   children
 }) {
   const audioApi = useChatAudio(audio ?? {});
@@ -1064,6 +1183,7 @@ function ChatProvider({
     initialSessionId,
     autoCreateSession,
     streaming,
+    debug,
     metadata: {
       locale: config.locale ?? config.prefs?.locale,
       slug: config.slug
@@ -2095,7 +2215,7 @@ function copy(text) {
 }
 chunkOLISEQHS_cjs.__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__ */ jsxRuntime.jsx(
     ChatProvider,
     {
@@ -2105,6 +2225,7 @@ function ChatRoot(props) {
       autoCreateSession,
       streaming,
       audio,
+      debug,
       children: /* @__PURE__ */ jsxRuntime.jsx(ChatRootShell, { className, slots })
     }
   );
@@ -2241,6 +2362,7 @@ exports.ToolCalls = ToolCalls;
 exports.createId = createId;
 exports.createTokenBuffer = createTokenBuffer;
 exports.deriveInitials = deriveInitials;
+exports.getChatLogger = getChatLogger;
 exports.initialState = initialState;
 exports.reducer = reducer;
 exports.resolvePersona = resolvePersona;
@@ -2253,5 +2375,5 @@ exports.useChatContextOptional = useChatContextOptional;
 exports.useChatHistory = useChatHistory;
 exports.useChatLayout = useChatLayout;
 exports.useChatScroll = useChatScroll;
-//# sourceMappingURL=chunk-NRXYYO5V.cjs.map
-//# sourceMappingURL=chunk-NRXYYO5V.cjs.map
+//# sourceMappingURL=chunk-ZWPBBAR2.cjs.map
+//# sourceMappingURL=chunk-ZWPBBAR2.cjs.map