@agent-native/core 0.12.39 → 0.13.0

package/dist/client/use-chat-threads.js

@@ -1,21 +1,47 @@
 import { useState, useEffect, useCallback, useRef } from "react";
 import { agentNativePath } from "./api-path.js";
 const ACTIVE_THREAD_KEY = "agent-chat-active-thread";
+const THREAD_DATA_CACHE_PREFIX = "agent-chat-thread-cache:";
+/**
+ * Key for the per-thread message cache in localStorage. AssistantChat reads
+ * this synchronously on mount so existing chats can hydrate from cache and
+ * paint immediately, then refreshes from the server in the background.
+ */
+export function getThreadCacheKey(threadId) {
+    return `${THREAD_DATA_CACHE_PREFIX}${threadId}`;
+}
 export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-chat"), storageKey) {
     const activeThreadKey = storageKey
         ? `${ACTIVE_THREAD_KEY}:${storageKey}`
         : ACTIVE_THREAD_KEY;
     const [threads, setThreads] = useState([]);
+    // IDs we generated client-side this session — consumers use this to know
+    // whether to skip the per-thread restore skeleton. Tracked by ref instead
+    // of state because the consumer reads it inside the render path and we
+    // never need to re-render when the set changes.
+    const newlyCreatedRef = useRef(new Set());
     const [activeThreadId, setActiveThreadId] = useState(() => {
+        if (typeof window === "undefined")
+            return null;
         try {
-            return localStorage.getItem(activeThreadKey);
+            const saved = localStorage.getItem(activeThreadKey);
+            if (saved)
+                return saved;
         }
-        catch {
-            return null;
+        catch { }
+        // No saved thread — generate one synchronously so the chat shell + composer
+        // can paint on first render instead of after a network round-trip.
+        if (typeof crypto !== "undefined" && crypto.randomUUID) {
+            const id = crypto.randomUUID();
+            newlyCreatedRef.current.add(id);
+            return id;
         }
+        return null;
     });
     const [isLoading, setIsLoading] = useState(true);
     const fetchedRef = useRef(false);
+    const activeThreadIdRef = useRef(activeThreadId);
+    activeThreadIdRef.current = activeThreadId;
     // Persist active thread ID
     useEffect(() => {
         try {
@@ -34,46 +60,24 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
             if (!res.ok)
                 return;
             const data = await res.json();
-            setThreads(data.threads ?? []);
+            setThreads((prev) => {
+                const loaded = (data.threads ?? []);
+                // Preserve any optimistic threads we've created this session that
+                // haven't shown up in the server list yet (POST still in-flight).
+                const loadedIds = new Set(loaded.map((t) => t.id));
+                const optimisticOnly = prev.filter((t) => newlyCreatedRef.current.has(t.id) && !loadedIds.has(t.id));
+                return [...optimisticOnly, ...loaded];
+            });
             return data.threads;
         }
         catch {
             return undefined;
         }
     }, [apiUrl]);
-    // Initial load
-    useEffect(() => {
-        if (fetchedRef.current)
-            return;
-        fetchedRef.current = true;
-        (async () => {
-            setIsLoading(true);
-            const loadedThreads = await fetchThreads();
-            if (loadedThreads && loadedThreads.length > 0) {
-                // If the saved active thread still exists, keep it. Otherwise use the most recent.
-                const savedId = activeThreadId;
-                if (!savedId || !loadedThreads.find((t) => t.id === savedId)) {
-                    setActiveThreadId(loadedThreads[0].id);
-                }
-            }
-            else {
-                // No threads — create the first one
-                try {
-                    const res = await fetch(`${apiUrl}/threads`, { method: "POST" });
-                    if (res.ok) {
-                        const thread = await res.json();
-                        setThreads([thread]);
-                        setActiveThreadId(thread.id);
-                    }
-                }
-                catch { }
-            }
-            setIsLoading(false);
-        })();
-    }, [fetchThreads, apiUrl, activeThreadId]);
-    const createThread = useCallback((preferredId) => {
-        // Generate ID client-side for instant UI response
-        const id = preferredId || crypto.randomUUID();
+    // Persist a client-generated thread to the server in the background.
+    // Optimistically adds it to the local thread list so callers can render
+    // immediately; rolls back on failure.
+    const persistNewThread = useCallback((id) => {
         const now = Date.now();
         const optimistic = {
             id,
@@ -83,9 +87,7 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
             createdAt: now,
             updatedAt: now,
         };
-        setThreads((prev) => [optimistic, ...prev]);
-        setActiveThreadId(id);
-        // Persist to server in the background
+        setThreads((prev) => prev.some((t) => t.id === id) ? prev : [optimistic, ...prev]);
         fetch(`${apiUrl}/threads`, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
@@ -103,13 +105,47 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
             setThreads((prev) => prev.map((thread) => (thread.id === id ? created : thread)));
         })
             .catch(() => {
-            // If server fails, remove the optimistic thread instead of leaving a
-            // phantom active tab that disappears on the next refresh.
             setThreads((prev) => prev.filter((t) => t.id !== id));
+            newlyCreatedRef.current.delete(id);
             setActiveThreadId((current) => (current === id ? null : current));
         });
-        return Promise.resolve(id);
     }, [apiUrl]);
+    // Initial load. Runs in the background — does NOT gate the consumer's
+    // first paint. The composer renders against the optimistic active thread
+    // we set up in useState above; this fetch just populates the history list
+    // and reconciles a stale saved active id.
+    useEffect(() => {
+        if (fetchedRef.current)
+            return;
+        fetchedRef.current = true;
+        // Persist any thread we optimistically created during the initial render.
+        for (const id of newlyCreatedRef.current) {
+            persistNewThread(id);
+        }
+        (async () => {
+            const loadedThreads = await fetchThreads();
+            if (loadedThreads && loadedThreads.length > 0) {
+                const savedId = activeThreadIdRef.current;
+                // If the saved active thread isn't on the server (and isn't one we
+                // just created client-side), fall back to the most recent.
+                if (savedId &&
+                    !newlyCreatedRef.current.has(savedId) &&
+                    !loadedThreads.find((t) => t.id === savedId)) {
+                    setActiveThreadId(loadedThreads[0].id);
+                }
+            }
+            setIsLoading(false);
+        })();
+    }, [fetchThreads, persistNewThread]);
+    const createThread = useCallback((preferredId) => {
+        // Generate ID client-side for instant UI response
+        const id = preferredId || crypto.randomUUID();
+        newlyCreatedRef.current.add(id);
+        setActiveThreadId(id);
+        persistNewThread(id);
+        return Promise.resolve(id);
+    }, [persistNewThread]);
+    const isNewThread = useCallback((id) => newlyCreatedRef.current.has(id), []);
     const switchThread = useCallback((id) => {
         setActiveThreadId(id);
     }, []);
@@ -120,6 +156,10 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
             });
         }
         catch { }
+        try {
+            localStorage.removeItem(getThreadCacheKey(id));
+        }
+        catch { }
         setThreads((prev) => {
             const next = prev.filter((t) => t.id !== id);
             if (id === activeThreadId) {
@@ -136,6 +176,13 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
         });
     }, [apiUrl, activeThreadId, createThread]);
     const saveThreadData = useCallback(async (id, data) => {
+        // Cache locally so the next mount of this thread can hydrate
+        // synchronously and skip the per-message restore skeleton. Quota errors
+        // (5–10MB cap) are swallowed — the thread just falls back to fetching.
+        try {
+            localStorage.setItem(getThreadCacheKey(id), data.threadData);
+        }
+        catch { }
         try {
             await fetch(`${apiUrl}/threads/${encodeURIComponent(id)}`, {
                 method: "PUT",
@@ -238,6 +285,7 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
         generateTitle,
         searchThreads,
         refreshThreads,
+        isNewThread,
     };
 }
 //# sourceMappingURL=use-chat-threads.js.map

package/dist/client/use-chat-threads.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-chat-threads.js","sourceRoot":"","sources":["../../src/client/use-chat-threads.ts"],"names":[],"mappings":"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","sourcesContent":["import { useState, useEffect, useCallback, useRef } from \"react\";\nimport { agentNativePath } from \"./api-path.js\";\n\nexport interface ChatThreadSummary {\n  id: string;\n  title: string;\n  preview: string;\n  messageCount: number;\n  createdAt: number;\n  updatedAt: number;\n}\n\nexport interface ChatThreadData {\n  id: string;\n  ownerEmail: string;\n  title: string;\n  preview: string;\n  threadData: string;\n  messageCount: number;\n  createdAt: number;\n  updatedAt: number;\n}\n\nconst ACTIVE_THREAD_KEY = \"agent-chat-active-thread\";\n\nexport function useChatThreads(\n  apiUrl = agentNativePath(\"/_agent-native/agent-chat\"),\n  storageKey?: string,\n) {\n  const activeThreadKey = storageKey\n    ? `${ACTIVE_THREAD_KEY}:${storageKey}`\n    : ACTIVE_THREAD_KEY;\n  const [threads, setThreads] = useState<ChatThreadSummary[]>([]);\n  const [activeThreadId, setActiveThreadId] = useState<string | null>(() => {\n    try {\n      return localStorage.getItem(activeThreadKey);\n    } catch {\n      return null;\n    }\n  });\n  const [isLoading, setIsLoading] = useState(true);\n  const fetchedRef = useRef(false);\n\n  // Persist active thread ID\n  useEffect(() => {\n    try {\n      if (activeThreadId) {\n        localStorage.setItem(activeThreadKey, activeThreadId);\n      } else {\n        localStorage.removeItem(activeThreadKey);\n      }\n    } catch {}\n  }, [activeThreadId, activeThreadKey]);\n\n  const fetchThreads = useCallback(async () => {\n    try {\n      const res = await fetch(`${apiUrl}/threads`);\n      if (!res.ok) return;\n      const data = await res.json();\n      setThreads(data.threads ?? []);\n      return data.threads as ChatThreadSummary[];\n    } catch {\n      return undefined;\n    }\n  }, [apiUrl]);\n\n  // Initial load\n  useEffect(() => {\n    if (fetchedRef.current) return;\n    fetchedRef.current = true;\n\n    (async () => {\n      setIsLoading(true);\n      const loadedThreads = await fetchThreads();\n\n      if (loadedThreads && loadedThreads.length > 0) {\n        // If the saved active thread still exists, keep it. Otherwise use the most recent.\n        const savedId = activeThreadId;\n        if (!savedId || !loadedThreads.find((t) => t.id === savedId)) {\n          setActiveThreadId(loadedThreads[0].id);\n        }\n      } else {\n        // No threads — create the first one\n        try {\n          const res = await fetch(`${apiUrl}/threads`, { method: \"POST\" });\n          if (res.ok) {\n            const thread = await res.json();\n            setThreads([thread]);\n            setActiveThreadId(thread.id);\n          }\n        } catch {}\n      }\n      setIsLoading(false);\n    })();\n  }, [fetchThreads, apiUrl, activeThreadId]);\n\n  const createThread = useCallback(\n    (preferredId?: string): Promise<string | null> => {\n      // Generate ID client-side for instant UI response\n      const id = preferredId || crypto.randomUUID();\n      const now = Date.now();\n      const optimistic: ChatThreadSummary = {\n        id,\n        title: \"\",\n        preview: \"\",\n        messageCount: 0,\n        createdAt: now,\n        updatedAt: now,\n      };\n      setThreads((prev) => [optimistic, ...prev]);\n      setActiveThreadId(id);\n\n      // Persist to server in the background\n      fetch(`${apiUrl}/threads`, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ id }),\n      })\n        .then(async (res) => {\n          if (!res.ok) {\n            throw new Error(`Thread create failed with ${res.status}`);\n          }\n          const created = (await res\n            .json()\n            .catch(() => null)) as ChatThreadSummary | null;\n          if (!created) return;\n          setThreads((prev) =>\n            prev.map((thread) => (thread.id === id ? created : thread)),\n          );\n        })\n        .catch(() => {\n          // If server fails, remove the optimistic thread instead of leaving a\n          // phantom active tab that disappears on the next refresh.\n          setThreads((prev) => prev.filter((t) => t.id !== id));\n          setActiveThreadId((current) => (current === id ? null : current));\n        });\n\n      return Promise.resolve(id);\n    },\n    [apiUrl],\n  );\n\n  const switchThread = useCallback((id: string) => {\n    setActiveThreadId(id);\n  }, []);\n\n  const removeThread = useCallback(\n    async (id: string) => {\n      try {\n        await fetch(`${apiUrl}/threads/${encodeURIComponent(id)}`, {\n          method: \"DELETE\",\n        });\n      } catch {}\n      setThreads((prev) => {\n        const next = prev.filter((t) => t.id !== id);\n        if (id === activeThreadId) {\n          // Switch to the next available thread, or create new if empty\n          if (next.length > 0) {\n            setActiveThreadId(next[0].id);\n          } else {\n            // Create a new thread\n            createThread();\n          }\n        }\n        return next;\n      });\n    },\n    [apiUrl, activeThreadId, createThread],\n  );\n\n  const saveThreadData = useCallback(\n    async (\n      id: string,\n      data: {\n        threadData: string;\n        title: string;\n        preview: string;\n        messageCount?: number;\n      },\n    ) => {\n      try {\n        await fetch(`${apiUrl}/threads/${encodeURIComponent(id)}`, {\n          method: \"PUT\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify(data),\n        });\n        // Update local thread list metadata\n        setThreads((prev) =>\n          prev.map((t) =>\n            t.id === id\n              ? {\n                  ...t,\n                  title: data.title,\n                  preview: data.preview,\n                  ...(data.messageCount != null && {\n                    messageCount: data.messageCount,\n                  }),\n                  updatedAt: Date.now(),\n                }\n              : t,\n          ),\n        );\n      } catch {}\n    },\n    [apiUrl],\n  );\n\n  const generateTitle = useCallback(\n    async (threadId: string, message: string): Promise<string | null> => {\n      try {\n        const res = await fetch(`${apiUrl}/generate-title`, {\n          method: \"POST\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify({ message }),\n        });\n        if (!res.ok) return null;\n        const data = await res.json();\n        const title = data.title;\n        if (!title) return null;\n        // Update the title in local state\n        setThreads((prev) =>\n          prev.map((t) => (t.id === threadId ? { ...t, title } : t)),\n        );\n        return title;\n      } catch {\n        return null;\n      }\n    },\n    [apiUrl],\n  );\n\n  const forkThread = useCallback(\n    async (sourceId: string): Promise<string | null> => {\n      const id = crypto.randomUUID();\n      try {\n        const res = await fetch(\n          `${apiUrl}/threads/${encodeURIComponent(sourceId)}/fork`,\n          {\n            method: \"POST\",\n            headers: { \"Content-Type\": \"application/json\" },\n            body: JSON.stringify({ id }),\n          },\n        );\n        if (!res.ok) {\n          // Surface failures so a click on the Fork button isn't a silent\n          // no-op when the source thread can't be found or auth has lapsed.\n          console.error(\n            `[chat] fork failed for ${sourceId}: ${res.status} ${res.statusText}`,\n          );\n          return null;\n        }\n        const thread = await res.json();\n        setThreads((prev) => [\n          {\n            id: thread.id,\n            title: thread.title,\n            preview: thread.preview,\n            messageCount: thread.messageCount,\n            createdAt: thread.createdAt,\n            updatedAt: thread.updatedAt,\n          },\n          ...prev,\n        ]);\n        return thread.id;\n      } catch (err) {\n        console.error(`[chat] fork threw for ${sourceId}:`, err);\n        return null;\n      }\n    },\n    [apiUrl],\n  );\n\n  const searchThreads = useCallback(\n    async (query: string): Promise<ChatThreadSummary[]> => {\n      try {\n        const res = await fetch(\n          `${apiUrl}/threads?q=${encodeURIComponent(query)}`,\n        );\n        if (!res.ok) return [];\n        const data = await res.json();\n        return data.threads ?? [];\n      } catch {\n        return [];\n      }\n    },\n    [apiUrl],\n  );\n\n  const refreshThreads = useCallback(() => {\n    fetchThreads();\n  }, [fetchThreads]);\n\n  return {\n    threads,\n    activeThreadId,\n    isLoading,\n    createThread,\n    switchThread,\n    deleteThread: removeThread,\n    forkThread,\n    saveThreadData,\n    generateTitle,\n    searchThreads,\n    refreshThreads,\n  };\n}\n"]}
+{"version":3,"file":"use-chat-threads.js","sourceRoot":"","sources":["../../src/client/use-chat-threads.ts"],"names":[],"mappings":"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","sourcesContent":["import { useState, useEffect, useCallback, useRef } from \"react\";\nimport { agentNativePath } from \"./api-path.js\";\n\nexport interface ChatThreadSummary {\n  id: string;\n  title: string;\n  preview: string;\n  messageCount: number;\n  createdAt: number;\n  updatedAt: number;\n}\n\nexport interface ChatThreadData {\n  id: string;\n  ownerEmail: string;\n  title: string;\n  preview: string;\n  threadData: string;\n  messageCount: number;\n  createdAt: number;\n  updatedAt: number;\n}\n\nconst ACTIVE_THREAD_KEY = \"agent-chat-active-thread\";\nconst THREAD_DATA_CACHE_PREFIX = \"agent-chat-thread-cache:\";\n\n/**\n * Key for the per-thread message cache in localStorage. AssistantChat reads\n * this synchronously on mount so existing chats can hydrate from cache and\n * paint immediately, then refreshes from the server in the background.\n */\nexport function getThreadCacheKey(threadId: string): string {\n  return `${THREAD_DATA_CACHE_PREFIX}${threadId}`;\n}\n\nexport function useChatThreads(\n  apiUrl = agentNativePath(\"/_agent-native/agent-chat\"),\n  storageKey?: string,\n) {\n  const activeThreadKey = storageKey\n    ? `${ACTIVE_THREAD_KEY}:${storageKey}`\n    : ACTIVE_THREAD_KEY;\n  const [threads, setThreads] = useState<ChatThreadSummary[]>([]);\n\n  // IDs we generated client-side this session — consumers use this to know\n  // whether to skip the per-thread restore skeleton. Tracked by ref instead\n  // of state because the consumer reads it inside the render path and we\n  // never need to re-render when the set changes.\n  const newlyCreatedRef = useRef<Set<string>>(new Set());\n\n  const [activeThreadId, setActiveThreadId] = useState<string | null>(() => {\n    if (typeof window === \"undefined\") return null;\n    try {\n      const saved = localStorage.getItem(activeThreadKey);\n      if (saved) return saved;\n    } catch {}\n    // No saved thread — generate one synchronously so the chat shell + composer\n    // can paint on first render instead of after a network round-trip.\n    if (typeof crypto !== \"undefined\" && crypto.randomUUID) {\n      const id = crypto.randomUUID();\n      newlyCreatedRef.current.add(id);\n      return id;\n    }\n    return null;\n  });\n  const [isLoading, setIsLoading] = useState(true);\n  const fetchedRef = useRef(false);\n  const activeThreadIdRef = useRef(activeThreadId);\n  activeThreadIdRef.current = activeThreadId;\n\n  // Persist active thread ID\n  useEffect(() => {\n    try {\n      if (activeThreadId) {\n        localStorage.setItem(activeThreadKey, activeThreadId);\n      } else {\n        localStorage.removeItem(activeThreadKey);\n      }\n    } catch {}\n  }, [activeThreadId, activeThreadKey]);\n\n  const fetchThreads = useCallback(async () => {\n    try {\n      const res = await fetch(`${apiUrl}/threads`);\n      if (!res.ok) return;\n      const data = await res.json();\n      setThreads((prev) => {\n        const loaded = (data.threads ?? []) as ChatThreadSummary[];\n        // Preserve any optimistic threads we've created this session that\n        // haven't shown up in the server list yet (POST still in-flight).\n        const loadedIds = new Set(loaded.map((t) => t.id));\n        const optimisticOnly = prev.filter(\n          (t) => newlyCreatedRef.current.has(t.id) && !loadedIds.has(t.id),\n        );\n        return [...optimisticOnly, ...loaded];\n      });\n      return data.threads as ChatThreadSummary[];\n    } catch {\n      return undefined;\n    }\n  }, [apiUrl]);\n\n  // Persist a client-generated thread to the server in the background.\n  // Optimistically adds it to the local thread list so callers can render\n  // immediately; rolls back on failure.\n  const persistNewThread = useCallback(\n    (id: string) => {\n      const now = Date.now();\n      const optimistic: ChatThreadSummary = {\n        id,\n        title: \"\",\n        preview: \"\",\n        messageCount: 0,\n        createdAt: now,\n        updatedAt: now,\n      };\n      setThreads((prev) =>\n        prev.some((t) => t.id === id) ? prev : [optimistic, ...prev],\n      );\n      fetch(`${apiUrl}/threads`, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ id }),\n      })\n        .then(async (res) => {\n          if (!res.ok) {\n            throw new Error(`Thread create failed with ${res.status}`);\n          }\n          const created = (await res\n            .json()\n            .catch(() => null)) as ChatThreadSummary | null;\n          if (!created) return;\n          setThreads((prev) =>\n            prev.map((thread) => (thread.id === id ? created : thread)),\n          );\n        })\n        .catch(() => {\n          setThreads((prev) => prev.filter((t) => t.id !== id));\n          newlyCreatedRef.current.delete(id);\n          setActiveThreadId((current) => (current === id ? null : current));\n        });\n    },\n    [apiUrl],\n  );\n\n  // Initial load. Runs in the background — does NOT gate the consumer's\n  // first paint. The composer renders against the optimistic active thread\n  // we set up in useState above; this fetch just populates the history list\n  // and reconciles a stale saved active id.\n  useEffect(() => {\n    if (fetchedRef.current) return;\n    fetchedRef.current = true;\n\n    // Persist any thread we optimistically created during the initial render.\n    for (const id of newlyCreatedRef.current) {\n      persistNewThread(id);\n    }\n\n    (async () => {\n      const loadedThreads = await fetchThreads();\n      if (loadedThreads && loadedThreads.length > 0) {\n        const savedId = activeThreadIdRef.current;\n        // If the saved active thread isn't on the server (and isn't one we\n        // just created client-side), fall back to the most recent.\n        if (\n          savedId &&\n          !newlyCreatedRef.current.has(savedId) &&\n          !loadedThreads.find((t) => t.id === savedId)\n        ) {\n          setActiveThreadId(loadedThreads[0].id);\n        }\n      }\n      setIsLoading(false);\n    })();\n  }, [fetchThreads, persistNewThread]);\n\n  const createThread = useCallback(\n    (preferredId?: string): Promise<string | null> => {\n      // Generate ID client-side for instant UI response\n      const id = preferredId || crypto.randomUUID();\n      newlyCreatedRef.current.add(id);\n      setActiveThreadId(id);\n      persistNewThread(id);\n      return Promise.resolve(id);\n    },\n    [persistNewThread],\n  );\n\n  const isNewThread = useCallback(\n    (id: string) => newlyCreatedRef.current.has(id),\n    [],\n  );\n\n  const switchThread = useCallback((id: string) => {\n    setActiveThreadId(id);\n  }, []);\n\n  const removeThread = useCallback(\n    async (id: string) => {\n      try {\n        await fetch(`${apiUrl}/threads/${encodeURIComponent(id)}`, {\n          method: \"DELETE\",\n        });\n      } catch {}\n      try {\n        localStorage.removeItem(getThreadCacheKey(id));\n      } catch {}\n      setThreads((prev) => {\n        const next = prev.filter((t) => t.id !== id);\n        if (id === activeThreadId) {\n          // Switch to the next available thread, or create new if empty\n          if (next.length > 0) {\n            setActiveThreadId(next[0].id);\n          } else {\n            // Create a new thread\n            createThread();\n          }\n        }\n        return next;\n      });\n    },\n    [apiUrl, activeThreadId, createThread],\n  );\n\n  const saveThreadData = useCallback(\n    async (\n      id: string,\n      data: {\n        threadData: string;\n        title: string;\n        preview: string;\n        messageCount?: number;\n      },\n    ) => {\n      // Cache locally so the next mount of this thread can hydrate\n      // synchronously and skip the per-message restore skeleton. Quota errors\n      // (5–10MB cap) are swallowed — the thread just falls back to fetching.\n      try {\n        localStorage.setItem(getThreadCacheKey(id), data.threadData);\n      } catch {}\n      try {\n        await fetch(`${apiUrl}/threads/${encodeURIComponent(id)}`, {\n          method: \"PUT\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify(data),\n        });\n        // Update local thread list metadata\n        setThreads((prev) =>\n          prev.map((t) =>\n            t.id === id\n              ? {\n                  ...t,\n                  title: data.title,\n                  preview: data.preview,\n                  ...(data.messageCount != null && {\n                    messageCount: data.messageCount,\n                  }),\n                  updatedAt: Date.now(),\n                }\n              : t,\n          ),\n        );\n      } catch {}\n    },\n    [apiUrl],\n  );\n\n  const generateTitle = useCallback(\n    async (threadId: string, message: string): Promise<string | null> => {\n      try {\n        const res = await fetch(`${apiUrl}/generate-title`, {\n          method: \"POST\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify({ message }),\n        });\n        if (!res.ok) return null;\n        const data = await res.json();\n        const title = data.title;\n        if (!title) return null;\n        // Update the title in local state\n        setThreads((prev) =>\n          prev.map((t) => (t.id === threadId ? { ...t, title } : t)),\n        );\n        return title;\n      } catch {\n        return null;\n      }\n    },\n    [apiUrl],\n  );\n\n  const forkThread = useCallback(\n    async (sourceId: string): Promise<string | null> => {\n      const id = crypto.randomUUID();\n      try {\n        const res = await fetch(\n          `${apiUrl}/threads/${encodeURIComponent(sourceId)}/fork`,\n          {\n            method: \"POST\",\n            headers: { \"Content-Type\": \"application/json\" },\n            body: JSON.stringify({ id }),\n          },\n        );\n        if (!res.ok) {\n          // Surface failures so a click on the Fork button isn't a silent\n          // no-op when the source thread can't be found or auth has lapsed.\n          console.error(\n            `[chat] fork failed for ${sourceId}: ${res.status} ${res.statusText}`,\n          );\n          return null;\n        }\n        const thread = await res.json();\n        setThreads((prev) => [\n          {\n            id: thread.id,\n            title: thread.title,\n            preview: thread.preview,\n            messageCount: thread.messageCount,\n            createdAt: thread.createdAt,\n            updatedAt: thread.updatedAt,\n          },\n          ...prev,\n        ]);\n        return thread.id;\n      } catch (err) {\n        console.error(`[chat] fork threw for ${sourceId}:`, err);\n        return null;\n      }\n    },\n    [apiUrl],\n  );\n\n  const searchThreads = useCallback(\n    async (query: string): Promise<ChatThreadSummary[]> => {\n      try {\n        const res = await fetch(\n          `${apiUrl}/threads?q=${encodeURIComponent(query)}`,\n        );\n        if (!res.ok) return [];\n        const data = await res.json();\n        return data.threads ?? [];\n      } catch {\n        return [];\n      }\n    },\n    [apiUrl],\n  );\n\n  const refreshThreads = useCallback(() => {\n    fetchThreads();\n  }, [fetchThreads]);\n\n  return {\n    threads,\n    activeThreadId,\n    isLoading,\n    createThread,\n    switchThread,\n    deleteThread: removeThread,\n    forkThread,\n    saveThreadData,\n    generateTitle,\n    searchThreads,\n    refreshThreads,\n    isNewThread,\n  };\n}\n"]}

package/dist/client/use-run-stuck-detection.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Per-thread chat run health, derived from the durable `last_progress_at`
+ * timestamp on the server. Drives the user-visible "this chat looks stuck"
+ * affordance — distinct from the silent reconnect logic in
+ * `agent-chat-adapter.ts`, which keeps trying in the background. When
+ * automatic recovery isn't making progress (for whatever reason), this
+ * hook surfaces a Retry / Cancel button to the user instead of leaving
+ * them staring at a frozen spinner.
+ */
+export interface RunStuckState {
+    /** True when an active run hasn't emitted an event for `stuckThresholdMs`. */
+    isStuck: boolean;
+    /** ID of the active run, or null when nothing is in flight. */
+    runId: string | null;
+    /** Server-side run status ("running" / "completed" / "errored" / etc.). */
+    status: string | null;
+    /** Server timestamp (ms) of the last emitted event, or null if none yet. */
+    lastProgressAt: number | null;
+    /** Milliseconds since `lastProgressAt`, or null. */
+    stuckSinceMs: number | null;
+    /** Server timestamp (ms) of the last process-alive heartbeat. */
+    heartbeatAt: number | null;
+}
+export interface UseRunStuckDetectionOptions {
+    /** The thread to monitor. Pass null/undefined to disable polling. */
+    threadId: string | null | undefined;
+    /**
+     * Threshold above which an in-flight run is considered stuck. The default
+     * sits comfortably above the adapter's 75s no-progress reconnect — by then
+     * automatic recovery has already had its chance.
+     */
+    stuckThresholdMs?: number;
+    /** Poll interval. Default 5_000ms. */
+    pollIntervalMs?: number;
+    /** API base path. Default `/_agent-native/agent-chat`. */
+    apiUrl?: string;
+}
+export declare function useRunStuckDetection({ threadId, stuckThresholdMs, pollIntervalMs, apiUrl, }: UseRunStuckDetectionOptions): RunStuckState;
+/**
+ * POST `/runs/:id/abort` so the server flips the run to "aborted" and the
+ * adapter's reconnect loop exits cleanly. Returns the run id that was
+ * aborted (or null on failure) so callers can correlate observability
+ * events. Best-effort — failures are swallowed, since the user's intent
+ * is already captured locally.
+ */
+export declare function useAbortRun(apiUrl?: string): (runId: string, reason?: string) => Promise<string | null>;
+//# sourceMappingURL=use-run-stuck-detection.d.ts.map

package/dist/client/use-run-stuck-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-run-stuck-detection.d.ts","sourceRoot":"","sources":["../../src/client/use-run-stuck-detection.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,oDAAoD;IACpD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iEAAiE;IACjE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,2BAA2B;IAC1C,qEAAqE;IACrE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuBD,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,gBAA6C,EAC7C,cAAyC,EACzC,MAAM,GACP,EAAE,2BAA2B,GAAG,aAAa,CAoE7C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,WAEzB,MAAM,WAAU,MAAM,KAAY,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBzE"}

package/dist/client/use-run-stuck-detection.js

@@ -0,0 +1,102 @@
+import { useEffect, useState, useCallback } from "react";
+import { agentNativePath } from "./api-path.js";
+const DEFAULT_STUCK_THRESHOLD_MS = 90_000;
+const DEFAULT_POLL_INTERVAL_MS = 5_000;
+const IDLE_BACKOFF_INTERVAL_MS = 15_000;
+const EMPTY_STATE = {
+    isStuck: false,
+    runId: null,
+    status: null,
+    lastProgressAt: null,
+    stuckSinceMs: null,
+    heartbeatAt: null,
+};
+export function useRunStuckDetection({ threadId, stuckThresholdMs = DEFAULT_STUCK_THRESHOLD_MS, pollIntervalMs = DEFAULT_POLL_INTERVAL_MS, apiUrl, }) {
+    const [state, setState] = useState(EMPTY_STATE);
+    useEffect(() => {
+        // Reset on every thread change so the previous thread's stuck banner
+        // doesn't bleed onto the new one before the first poll completes.
+        setState(EMPTY_STATE);
+        if (!threadId)
+            return;
+        const base = apiUrl ?? agentNativePath("/_agent-native/agent-chat");
+        let cancelled = false;
+        let timer = null;
+        const poll = async () => {
+            if (cancelled)
+                return;
+            let nextDelay = pollIntervalMs;
+            try {
+                const res = await fetch(`${base}/runs/active?threadId=${encodeURIComponent(threadId)}`, { credentials: "same-origin" });
+                if (cancelled)
+                    return;
+                if (res.ok) {
+                    const data = (await res.json());
+                    const lastProgressAt = data.lastProgressAt ?? null;
+                    const stuckSinceMs = lastProgressAt != null ? Date.now() - lastProgressAt : null;
+                    const isStuck = Boolean(data.active &&
+                        data.status === "running" &&
+                        stuckSinceMs != null &&
+                        stuckSinceMs > stuckThresholdMs);
+                    setState({
+                        isStuck,
+                        runId: data.runId ?? null,
+                        status: data.status ?? null,
+                        lastProgressAt,
+                        stuckSinceMs,
+                        heartbeatAt: data.heartbeatAt ?? null,
+                    });
+                    // Back off polling when nothing is in flight — there's no point
+                    // hammering the endpoint while the chat is idle. We still poll
+                    // occasionally so a fresh run started in another tab is picked up.
+                    if (!data.active || data.status !== "running") {
+                        nextDelay = IDLE_BACKOFF_INTERVAL_MS;
+                    }
+                }
+            }
+            catch {
+                // Network blip — leave previous state. Next tick will retry.
+            }
+            if (!cancelled) {
+                timer = setTimeout(poll, nextDelay);
+            }
+        };
+        // Stagger the first poll so a freshly-started run isn't immediately
+        // classified as stuck before the server has had a chance to record
+        // any progress events.
+        timer = setTimeout(poll, 2_000);
+        return () => {
+            cancelled = true;
+            if (timer)
+                clearTimeout(timer);
+        };
+    }, [threadId, stuckThresholdMs, pollIntervalMs, apiUrl]);
+    return state;
+}
+/**
+ * POST `/runs/:id/abort` so the server flips the run to "aborted" and the
+ * adapter's reconnect loop exits cleanly. Returns the run id that was
+ * aborted (or null on failure) so callers can correlate observability
+ * events. Best-effort — failures are swallowed, since the user's intent
+ * is already captured locally.
+ */
+export function useAbortRun(apiUrl) {
+    return useCallback(async (runId, reason = "user") => {
+        const base = apiUrl ?? agentNativePath("/_agent-native/agent-chat");
+        try {
+            const res = await fetch(`${base}/runs/${encodeURIComponent(runId)}/abort`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                credentials: "same-origin",
+                body: JSON.stringify({ reason }),
+            });
+            if (!res.ok)
+                return null;
+            return runId;
+        }
+        catch {
+            return null;
+        }
+    }, [apiUrl]);
+}
+//# sourceMappingURL=use-run-stuck-detection.js.map

package/dist/client/use-run-stuck-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-run-stuck-detection.js","sourceRoot":"","sources":["../../src/client/use-run-stuck-detection.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useState, useCallback } from \"react\";\nimport { agentNativePath } from \"./api-path.js\";\n\n/**\n * Per-thread chat run health, derived from the durable `last_progress_at`\n * timestamp on the server. Drives the user-visible \"this chat looks stuck\"\n * affordance — distinct from the silent reconnect logic in\n * `agent-chat-adapter.ts`, which keeps trying in the background. When\n * automatic recovery isn't making progress (for whatever reason), this\n * hook surfaces a Retry / Cancel button to the user instead of leaving\n * them staring at a frozen spinner.\n */\nexport interface RunStuckState {\n  /** True when an active run hasn't emitted an event for `stuckThresholdMs`. */\n  isStuck: boolean;\n  /** ID of the active run, or null when nothing is in flight. */\n  runId: string | null;\n  /** Server-side run status (\"running\" / \"completed\" / \"errored\" / etc.). */\n  status: string | null;\n  /** Server timestamp (ms) of the last emitted event, or null if none yet. */\n  lastProgressAt: number | null;\n  /** Milliseconds since `lastProgressAt`, or null. */\n  stuckSinceMs: number | null;\n  /** Server timestamp (ms) of the last process-alive heartbeat. */\n  heartbeatAt: number | null;\n}\n\nexport interface UseRunStuckDetectionOptions {\n  /** The thread to monitor. Pass null/undefined to disable polling. */\n  threadId: string | null | undefined;\n  /**\n   * Threshold above which an in-flight run is considered stuck. The default\n   * sits comfortably above the adapter's 75s no-progress reconnect — by then\n   * automatic recovery has already had its chance.\n   */\n  stuckThresholdMs?: number;\n  /** Poll interval. Default 5_000ms. */\n  pollIntervalMs?: number;\n  /** API base path. Default `/_agent-native/agent-chat`. */\n  apiUrl?: string;\n}\n\nconst DEFAULT_STUCK_THRESHOLD_MS = 90_000;\nconst DEFAULT_POLL_INTERVAL_MS = 5_000;\nconst IDLE_BACKOFF_INTERVAL_MS = 15_000;\n\ninterface ActiveRunResponse {\n  active: boolean;\n  runId?: string;\n  status?: string;\n  heartbeatAt: number | null;\n  lastProgressAt?: number | null;\n}\n\nconst EMPTY_STATE: RunStuckState = {\n  isStuck: false,\n  runId: null,\n  status: null,\n  lastProgressAt: null,\n  stuckSinceMs: null,\n  heartbeatAt: null,\n};\n\nexport function useRunStuckDetection({\n  threadId,\n  stuckThresholdMs = DEFAULT_STUCK_THRESHOLD_MS,\n  pollIntervalMs = DEFAULT_POLL_INTERVAL_MS,\n  apiUrl,\n}: UseRunStuckDetectionOptions): RunStuckState {\n  const [state, setState] = useState<RunStuckState>(EMPTY_STATE);\n\n  useEffect(() => {\n    // Reset on every thread change so the previous thread's stuck banner\n    // doesn't bleed onto the new one before the first poll completes.\n    setState(EMPTY_STATE);\n    if (!threadId) return;\n\n    const base = apiUrl ?? agentNativePath(\"/_agent-native/agent-chat\");\n    let cancelled = false;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n\n    const poll = async () => {\n      if (cancelled) return;\n      let nextDelay = pollIntervalMs;\n      try {\n        const res = await fetch(\n          `${base}/runs/active?threadId=${encodeURIComponent(threadId)}`,\n          { credentials: \"same-origin\" },\n        );\n        if (cancelled) return;\n        if (res.ok) {\n          const data = (await res.json()) as ActiveRunResponse;\n          const lastProgressAt = data.lastProgressAt ?? null;\n          const stuckSinceMs =\n            lastProgressAt != null ? Date.now() - lastProgressAt : null;\n          const isStuck = Boolean(\n            data.active &&\n            data.status === \"running\" &&\n            stuckSinceMs != null &&\n            stuckSinceMs > stuckThresholdMs,\n          );\n          setState({\n            isStuck,\n            runId: data.runId ?? null,\n            status: data.status ?? null,\n            lastProgressAt,\n            stuckSinceMs,\n            heartbeatAt: data.heartbeatAt ?? null,\n          });\n          // Back off polling when nothing is in flight — there's no point\n          // hammering the endpoint while the chat is idle. We still poll\n          // occasionally so a fresh run started in another tab is picked up.\n          if (!data.active || data.status !== \"running\") {\n            nextDelay = IDLE_BACKOFF_INTERVAL_MS;\n          }\n        }\n      } catch {\n        // Network blip — leave previous state. Next tick will retry.\n      }\n      if (!cancelled) {\n        timer = setTimeout(poll, nextDelay);\n      }\n    };\n\n    // Stagger the first poll so a freshly-started run isn't immediately\n    // classified as stuck before the server has had a chance to record\n    // any progress events.\n    timer = setTimeout(poll, 2_000);\n\n    return () => {\n      cancelled = true;\n      if (timer) clearTimeout(timer);\n    };\n  }, [threadId, stuckThresholdMs, pollIntervalMs, apiUrl]);\n\n  return state;\n}\n\n/**\n * POST `/runs/:id/abort` so the server flips the run to \"aborted\" and the\n * adapter's reconnect loop exits cleanly. Returns the run id that was\n * aborted (or null on failure) so callers can correlate observability\n * events. Best-effort — failures are swallowed, since the user's intent\n * is already captured locally.\n */\nexport function useAbortRun(apiUrl?: string) {\n  return useCallback(\n    async (runId: string, reason: string = \"user\"): Promise<string | null> => {\n      const base = apiUrl ?? agentNativePath(\"/_agent-native/agent-chat\");\n      try {\n        const res = await fetch(\n          `${base}/runs/${encodeURIComponent(runId)}/abort`,\n          {\n            method: \"POST\",\n            headers: { \"Content-Type\": \"application/json\" },\n            credentials: \"same-origin\",\n            body: JSON.stringify({ reason }),\n          },\n        );\n        if (!res.ok) return null;\n        return runId;\n      } catch {\n        return null;\n      }\n    },\n    [apiUrl],\n  );\n}\n"]}

package/dist/server/agent-chat-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-chat-plugin.d.ts","sourceRoot":"","sources":["../../src/server/agent-chat-plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-chat-plugin.d.ts","sourceRoot":"","sources":["../../src/server/agent-chat-plugin.ts"],"names":[],"mappings":"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"}

package/dist/server/agent-chat-plugin.js

@@ -2991,13 +2991,65 @@ export function createAgentChatPlugin(options) {
                     : undefined;
                 return buildRuntimeContextPrompt({ timezone });
             };
+            // Chat-in-browser-on-localdev is the one surface where the agent must
+            // not edit code: source-file edits trigger Vite HMR / page reloads and
+            // kill the chat session mid-run. The client sends an
+            // `x-agent-native-surface` header (desktop | frame | browser); we fall
+            // back to UA + Host inspection when the header is missing (older clients,
+            // server-to-server callers, etc.). Returning true forces the prod
+            // handler (no shell / no fs) AND injects a redirect-prompt block telling
+            // the agent to point users at Desktop / Claude Code / Codex / Builder.io.
+            const isChatInBrowserOnLocalDev = (event) => {
+                const surface = (getHeader(event, "x-agent-native-surface") || "").toLowerCase();
+                const ua = getHeader(event, "user-agent") || "";
+                const isDesktop = surface === "desktop" || /AgentNativeDesktop/i.test(ua);
+                if (isDesktop)
+                    return false;
+                if (surface === "frame")
+                    return false;
+                const host = (getHeader(event, "host") || "").toLowerCase();
+                const hostname = host.split(":")[0] ?? "";
+                const isLocal = hostname === "localhost" ||
+                    hostname === "127.0.0.1" ||
+                    hostname === "::1" ||
+                    hostname === "[::1]";
+                if (!isLocal)
+                    return false;
+                // No header from an older client + non-desktop UA: be conservative and
+                // only trip on plain browser UAs. Treat unknown clients as safe (frame
+                // / desktop / scripting) so we don't break their tool access.
+                if (!surface) {
+                    return /Mozilla\/|Chrome\/|Safari\/|Firefox\/|Edg\//i.test(ua);
+                }
+                return surface === "browser";
+            };
+            const CHAT_IN_BROWSER_LOCAL_DEV_PROMPT = `
+
+<chat-in-browser-on-localdev>
+This chat is running in a plain browser tab on localhost. Source-code edits would trigger Vite HMR or a full page reload, which kills the chat session mid-run, so source-code work cannot happen on this surface.
+
+When the user asks for ANY of the following — add a feature, edit a component, fix a bug in the app itself, change styles, add a route, scaffold a new app, run shell commands that modify code, or anything else that requires touching source files:
+
+1. Do NOT call \`connect-builder\`, \`scaffold-workspace-app\`, \`start-workspace-app-creation\`, or any other tool that creates or edits source.
+2. Do NOT write code, list files, propose patches, or describe what you would change.
+3. Reply with one short message saying chat-in-browser on localhost can't edit code (page reloads kill the session) and offer these alternatives, in this order:
+   - **Agent Native Desktop** — https://www.agent-native.com/download (recommended; same chat, no reload risk)
+   - **Claude Code** — \`claude\` in the project directory
+   - **Codex** — \`codex\` in the project directory
+   - **Builder.io** — open the project in Builder for cloud-based code changes
+
+Non-code requests are still fine on this surface — read data, navigate the UI, summarize, search, create/update extensions (sandboxed Alpine.js mini-apps stored in SQL), and call template actions. The restriction is specifically about editing the app's own source files.
+</chat-in-browser-on-localdev>`;
             const prodHandler = createProductionAgentHandler({
                 actions: leanPrompt ? leanActions : prodActions,
                 systemPrompt: async (event) => {
                     const { owner, extra } = await prepareRun(event);
                     const runtimeContext = runtimeContextForEvent(event);
+                    const browserLocalDev = isChatInBrowserOnLocalDev(event)
+                        ? CHAT_IN_BROWSER_LOCAL_DEV_PROMPT
+                        : "";
                     if (leanPrompt) {
-                        return setSystemPromptOnContext(leanBasePrompt + runtimeContext + extra);
+                        return setSystemPromptOnContext(leanBasePrompt + runtimeContext + browserLocalDev + extra);
                     }
                     const resources = await loadResourcesForPrompt(owner, lazyContext);
                     // In lazy context mode, skip embedding the full schema — the agent
@@ -3005,7 +3057,12 @@ export function createAgentChatPlugin(options) {
                     const schemaBlock = lazyContext
                         ? ""
                         : await buildSchemaBlock(owner, false);
-                    return setSystemPromptOnContext(basePrompt + runtimeContext + resources + schemaBlock + extra);
+                    return setSystemPromptOnContext(basePrompt +
+                        runtimeContext +
+                        resources +
+                        schemaBlock +
+                        browserLocalDev +
+                        extra);
                 },
                 model: options?.model,
                 apiKey: options?.apiKey,
@@ -3732,6 +3789,7 @@ export function createAgentChatPlugin(options) {
                             threadId,
                             status: "idle",
                             heartbeatAt: null,
+                            lastProgressAt: null,
                         };
                     }
                     return {
@@ -3740,6 +3798,7 @@ export function createAgentChatPlugin(options) {
                         threadId: run.threadId,
                         status: run.status,
                         heartbeatAt: run.heartbeatAt,
+                        lastProgressAt: run.lastProgressAt,
                     };
                 }
                 setResponseStatus(event, 405);
@@ -4022,9 +4081,15 @@ export function createAgentChatPlugin(options) {
                     orgId: resolvedOrgId,
                     timezone,
                 }, () => {
+                    // Chat-in-browser on localhost can't host code edits — Vite HMR
+                    // and full reloads would kill the chat mid-run. Force the prod
+                    // handler (no shell / no fs); the prompt block injected by
+                    // `prodHandler.systemPrompt` then steers the agent to suggest
+                    // Desktop / Claude Code / Codex / Builder.io instead.
+                    const browserLocalDev = isChatInBrowserOnLocalDev(event);
                     const handler = ownerContext.anonymous && anonymousHandler
                         ? anonymousHandler
-                        : currentDevMode && devHandler
+                        : !browserLocalDev && currentDevMode && devHandler
                             ? devHandler
                             : prodHandler;
                     return handler(event);