@agent-native/core 0.14.7 → 0.15.0

package/dist/client/transcription/BuilderTranscriptionCta.js.map

@@ -1 +1 @@
-{"version":3,"file":"BuilderTranscriptionCta.js","sourceRoot":"","sources":["../../../src/client/transcription/BuilderTranscriptionCta.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Lightweight inline CTA that nudges users to connect Builder.io for\n * higher-quality transcription. Renders nothing when Builder is already\n * connected.\n *\n * Drop this next to transcript displays in any template.\n */\n\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport { IconBolt, IconExternalLink, IconLoader2 } from \"@tabler/icons-react\";\nimport { agentNativePath } from \"../api-path.js\";\nimport { getCallbackOrigin } from \"../frame.js\";\n\nexport function BuilderTranscriptionCta() {\n  const [configured, setConfigured] = useState<boolean | null>(null);\n  const [connecting, setConnecting] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n  const pollRef = useRef<ReturnType<typeof setInterval> | null>(null);\n  const mountedRef = useRef(true);\n\n  useEffect(() => {\n    mountedRef.current = true;\n    fetch(agentNativePath(\"/_agent-native/builder/status\"))\n      .then((r) =>\n        r.ok\n          ? (r.json() as Promise<{ configured: boolean; envManaged?: boolean }>)\n          : null,\n      )\n      .then((s) => {\n        if (!mountedRef.current) return;\n        // Env-managed mode counts as configured for the CTA — the deploy\n        // already routes transcription through Builder, no per-user prompt.\n        setConfigured(!!(s?.configured || s?.envManaged));\n      })\n      .catch(() => {\n        if (mountedRef.current) setConfigured(false);\n      });\n    return () => {\n      mountedRef.current = false;\n      if (pollRef.current) clearInterval(pollRef.current);\n    };\n  }, []);\n\n  const handleConnect = useCallback(() => {\n    if (pollRef.current) clearInterval(pollRef.current);\n    setConnecting(true);\n    setError(null);\n\n    const origin = getCallbackOrigin() || window.location.origin;\n    window.open(\n      new URL(agentNativePath(\"/_agent-native/builder/connect\"), origin).href,\n      \"_blank\",\n      \"noopener,noreferrer\",\n    );\n\n    const start = Date.now();\n    pollRef.current = setInterval(async () => {\n      try {\n        const r = await fetch(agentNativePath(\"/_agent-native/builder/status\"));\n        if (!r.ok) return;\n        const s = (await r.json()) as { configured: boolean };\n        if (!mountedRef.current) {\n          clearInterval(pollRef.current!);\n          return;\n        }\n        if (s.configured) {\n          clearInterval(pollRef.current!);\n          setConfigured(true);\n          setConnecting(false);\n        } else if (Date.now() - start > 5 * 60 * 1000) {\n          clearInterval(pollRef.current!);\n          setConnecting(false);\n          setError(\n            \"Didn't hear back from Builder. Allow popups and try again.\",\n          );\n        }\n      } catch {\n        // transient — keep polling\n      }\n    }, 2000);\n  }, []);\n\n  // Already connected or still loading — render nothing\n  if (configured === null || configured) return null;\n\n  return (\n    <div className=\"flex items-center gap-2 rounded-md border border-border/50 bg-muted/30 px-3 py-2 text-xs text-muted-foreground\">\n      <IconBolt\n        size={14}\n        className=\"shrink-0 text-muted-foreground/70\"\n        aria-hidden=\"true\"\n      />\n      <span className=\"flex-1\">\n        {connecting\n          ? \"Waiting for Builder.io…\"\n          : \"Connect Builder.io for higher-quality transcription — free credits, no API key needed.\"}\n      </span>\n      {error ? (\n        <span className=\"text-destructive text-[10px]\">{error}</span>\n      ) : connecting ? (\n        <IconLoader2 size={12} className=\"shrink-0 animate-spin\" />\n      ) : (\n        <button\n          type=\"button\"\n          onClick={handleConnect}\n          className=\"ml-auto shrink-0 inline-flex items-center gap-1 rounded bg-foreground px-2 py-1 text-[10px] font-semibold text-background hover:opacity-90 transition-opacity\"\n        >\n          Connect\n          <IconExternalLink size={10} />\n        </button>\n      )}\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"BuilderTranscriptionCta.js","sourceRoot":"","sources":["../../../src/client/transcription/BuilderTranscriptionCta.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Lightweight inline CTA that nudges users to connect Builder.io for\n * higher-quality transcription. Renders nothing when Builder is already\n * connected.\n *\n * Drop this next to transcript displays in any template.\n */\n\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport { IconBolt, IconExternalLink, IconLoader2 } from \"@tabler/icons-react\";\nimport { agentNativePath } from \"../api-path.js\";\nimport { openBuilderConnectPopup } from \"../settings/useBuilderStatus.js\";\n\nexport function BuilderTranscriptionCta() {\n  const [configured, setConfigured] = useState<boolean | null>(null);\n  const [connecting, setConnecting] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n  const pollRef = useRef<ReturnType<typeof setInterval> | null>(null);\n  const mountedRef = useRef(true);\n\n  useEffect(() => {\n    mountedRef.current = true;\n    fetch(agentNativePath(\"/_agent-native/builder/status\"))\n      .then((r) =>\n        r.ok\n          ? (r.json() as Promise<{ configured: boolean; envManaged?: boolean }>)\n          : null,\n      )\n      .then((s) => {\n        if (!mountedRef.current) return;\n        // Env-managed mode counts as configured for the CTA — the deploy\n        // already routes transcription through Builder, no per-user prompt.\n        setConfigured(!!(s?.configured || s?.envManaged));\n      })\n      .catch(() => {\n        if (mountedRef.current) setConfigured(false);\n      });\n    return () => {\n      mountedRef.current = false;\n      if (pollRef.current) clearInterval(pollRef.current);\n    };\n  }, []);\n\n  const handleConnect = useCallback(() => {\n    if (pollRef.current) clearInterval(pollRef.current);\n    setConnecting(true);\n    setError(null);\n\n    openBuilderConnectPopup({ source: \"builder_transcription_cta\" });\n\n    const start = Date.now();\n    pollRef.current = setInterval(async () => {\n      try {\n        const r = await fetch(agentNativePath(\"/_agent-native/builder/status\"));\n        if (!r.ok) return;\n        const s = (await r.json()) as { configured: boolean };\n        if (!mountedRef.current) {\n          clearInterval(pollRef.current!);\n          return;\n        }\n        if (s.configured) {\n          clearInterval(pollRef.current!);\n          setConfigured(true);\n          setConnecting(false);\n        } else if (Date.now() - start > 5 * 60 * 1000) {\n          clearInterval(pollRef.current!);\n          setConnecting(false);\n          setError(\n            \"Didn't hear back from Builder. Allow popups and try again.\",\n          );\n        }\n      } catch {\n        // transient — keep polling\n      }\n    }, 2000);\n  }, []);\n\n  // Already connected or still loading — render nothing\n  if (configured === null || configured) return null;\n\n  return (\n    <div className=\"flex items-center gap-2 rounded-md border border-border/50 bg-muted/30 px-3 py-2 text-xs text-muted-foreground\">\n      <IconBolt\n        size={14}\n        className=\"shrink-0 text-muted-foreground/70\"\n        aria-hidden=\"true\"\n      />\n      <span className=\"flex-1\">\n        {connecting\n          ? \"Waiting for Builder.io…\"\n          : \"Connect Builder.io for higher-quality transcription — free credits, no API key needed.\"}\n      </span>\n      {error ? (\n        <span className=\"text-destructive text-[10px]\">{error}</span>\n      ) : connecting ? (\n        <IconLoader2 size={12} className=\"shrink-0 animate-spin\" />\n      ) : (\n        <button\n          type=\"button\"\n          onClick={handleConnect}\n          className=\"ml-auto shrink-0 inline-flex items-center gap-1 rounded bg-foreground px-2 py-1 text-[10px] font-semibold text-background hover:opacity-90 transition-opacity\"\n        >\n          Connect\n          <IconExternalLink size={10} />\n        </button>\n      )}\n    </div>\n  );\n}\n"]}

package/dist/client/use-change-version.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Advance a source counter. Called by `useDbSync` for every change event;
+ * may also be called from templates that learn of a server-side change via
+ * a custom path (e.g. an in-process mutation that already happened — bump
+ * the counter so other components refetch without waiting for the poll
+ * cycle).
+ */
+export declare function bumpChangeVersion(source: string, version: number): boolean;
+/**
+ * Get the current counter for a source without subscribing. Use inside
+ * event handlers / callbacks; in render code use `useChangeVersion`.
+ */
+export declare function getChangeVersion(source: string): number;
+/**
+ * Subscribe to a source's change counter. Returns an integer that
+ * increments every time the server emits an event with `source === <source>`
+ * — including (by design) the agent's own action calls, since the agent
+ * runner emits `source: "action"` after every successful mutating action.
+ *
+ * Fold the return value into a React Query `queryKey` to make the query
+ * refetch whenever that source advances:
+ *
+ * ```ts
+ * const v = useChangeVersion("dashboards");
+ * useQuery({
+ *   queryKey: ["dashboard", id, v],
+ *   queryFn: () => fetchDashboard(id),
+ *   placeholderData: keepPreviousData,
+ * });
+ * ```
+ */
+export declare function useChangeVersion(source: string): number;
+/**
+ * Convenience for queries that should refetch on multiple sources — returns
+ * the sum of each source's counter so React Query treats every advance as a
+ * key change.
+ *
+ * ```ts
+ * const v = useChangeVersions(["dashboards", "action"]);
+ * useQuery({ queryKey: ["dashboard", id, v], ... });
+ * ```
+ */
+export declare function useChangeVersions(sources: readonly string[]): number;
+/** Internal test helper — reset all counters. Do not use in app code. */
+export declare function _resetChangeVersionStoreForTests(): void;
+//# sourceMappingURL=use-change-version.d.ts.map

package/dist/client/use-change-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-change-version.d.ts","sourceRoot":"","sources":["../../src/client/use-change-version.ts"],"names":[],"mappings":"AAgFA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAMpE;AAED,yEAAyE;AACzE,wBAAgB,gCAAgC,IAAI,IAAI,CAKvD"}

package/dist/client/use-change-version.js

@@ -0,0 +1,135 @@
+/**
+ * Per-source change counters — the framework's "agent writes show up
+ * immediately" primitive.
+ *
+ * Every server-side mutation emits a `recordChange({ source, ... })` event.
+ * `useDbSync` (in this folder) calls `bumpChangeVersion(source, version)` for
+ * each event it sees over SSE or `/poll`. Hooks `useChangeVersion(source)`
+ * and `useChangeVersions(sources)` expose a per-source integer that
+ * advances every time that source has new activity.
+ *
+ * Templates fold these counters into their React Query `queryKey` — when the
+ * counter advances, the key changes, and React Query refetches that one
+ * query. No template needs to enumerate query keys in `useDbSync`; no full
+ * cache invalidate is required.
+ *
+ * ```ts
+ * const v = useChangeVersion("dashboards");
+ * const dashboard = useQuery({
+ *   queryKey: ["dashboard", id, v],
+ *   queryFn: () => fetchDashboard(id),
+ *   placeholderData: keepPreviousData, // no flicker on refetch
+ * });
+ * ```
+ *
+ * The agent's `update-dashboard` action emits `{ source: "dashboards" }`
+ * (from `upsertDashboard`'s `recordChange` call) AND
+ * `{ source: "action" }` (from the agent runner's post-tool emit). Either
+ * triggers a refetch when the relevant counter is in the query key.
+ *
+ * **Cost is bounded:** only queries that opted into a specific source
+ * refetch when that source fires. A poll heartbeat with no event does
+ * nothing.
+ */
+import { useSyncExternalStore } from "react";
+class ChangeVersionStore {
+    versions = new Map();
+    listeners = new Set();
+    cachedSnapshots = new Map();
+    /**
+     * Advance the counter for `source` to at least `version`. Returns true if
+     * the counter actually moved (so callers can avoid spurious work).
+     */
+    bump(source, version) {
+        if (!source)
+            return false;
+        const current = this.versions.get(source) ?? 0;
+        if (version > current) {
+            this.versions.set(source, version);
+            this.cachedSnapshots.set(source, version);
+            this.notify();
+            return true;
+        }
+        return false;
+    }
+    get(source) {
+        // useSyncExternalStore requires reference-stable snapshots for unchanged
+        // values, so we serve from a cached map that we only update inside
+        // `bump`.
+        const cached = this.cachedSnapshots.get(source);
+        if (cached !== undefined)
+            return cached;
+        this.cachedSnapshots.set(source, 0);
+        return 0;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    notify() {
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+const store = new ChangeVersionStore();
+/**
+ * Advance a source counter. Called by `useDbSync` for every change event;
+ * may also be called from templates that learn of a server-side change via
+ * a custom path (e.g. an in-process mutation that already happened — bump
+ * the counter so other components refetch without waiting for the poll
+ * cycle).
+ */
+export function bumpChangeVersion(source, version) {
+    return store.bump(source, version);
+}
+/**
+ * Get the current counter for a source without subscribing. Use inside
+ * event handlers / callbacks; in render code use `useChangeVersion`.
+ */
+export function getChangeVersion(source) {
+    return store.get(source);
+}
+/**
+ * Subscribe to a source's change counter. Returns an integer that
+ * increments every time the server emits an event with `source === <source>`
+ * — including (by design) the agent's own action calls, since the agent
+ * runner emits `source: "action"` after every successful mutating action.
+ *
+ * Fold the return value into a React Query `queryKey` to make the query
+ * refetch whenever that source advances:
+ *
+ * ```ts
+ * const v = useChangeVersion("dashboards");
+ * useQuery({
+ *   queryKey: ["dashboard", id, v],
+ *   queryFn: () => fetchDashboard(id),
+ *   placeholderData: keepPreviousData,
+ * });
+ * ```
+ */
+export function useChangeVersion(source) {
+    return useSyncExternalStore((cb) => store.subscribe(cb), () => store.get(source), () => 0);
+}
+/**
+ * Convenience for queries that should refetch on multiple sources — returns
+ * the sum of each source's counter so React Query treats every advance as a
+ * key change.
+ *
+ * ```ts
+ * const v = useChangeVersions(["dashboards", "action"]);
+ * useQuery({ queryKey: ["dashboard", id, v], ... });
+ * ```
+ */
+export function useChangeVersions(sources) {
+    return useSyncExternalStore((cb) => store.subscribe(cb), () => sources.reduce((sum, src) => sum + store.get(src), 0), () => 0);
+}
+/** Internal test helper — reset all counters. Do not use in app code. */
+export function _resetChangeVersionStoreForTests() {
+    // @ts-expect-error reaching past private to clear state in tests
+    store.versions.clear();
+    // @ts-expect-error reaching past private to clear state in tests
+    store.cachedSnapshots.clear();
+}
+//# sourceMappingURL=use-change-version.js.map

package/dist/client/use-change-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-change-version.js","sourceRoot":"","sources":["../../src/client/use-change-version.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Per-source change counters — the framework's \"agent writes show up\n * immediately\" primitive.\n *\n * Every server-side mutation emits a `recordChange({ source, ... })` event.\n * `useDbSync` (in this folder) calls `bumpChangeVersion(source, version)` for\n * each event it sees over SSE or `/poll`. Hooks `useChangeVersion(source)`\n * and `useChangeVersions(sources)` expose a per-source integer that\n * advances every time that source has new activity.\n *\n * Templates fold these counters into their React Query `queryKey` — when the\n * counter advances, the key changes, and React Query refetches that one\n * query. No template needs to enumerate query keys in `useDbSync`; no full\n * cache invalidate is required.\n *\n * ```ts\n * const v = useChangeVersion(\"dashboards\");\n * const dashboard = useQuery({\n *   queryKey: [\"dashboard\", id, v],\n *   queryFn: () => fetchDashboard(id),\n *   placeholderData: keepPreviousData, // no flicker on refetch\n * });\n * ```\n *\n * The agent's `update-dashboard` action emits `{ source: \"dashboards\" }`\n * (from `upsertDashboard`'s `recordChange` call) AND\n * `{ source: \"action\" }` (from the agent runner's post-tool emit). Either\n * triggers a refetch when the relevant counter is in the query key.\n *\n * **Cost is bounded:** only queries that opted into a specific source\n * refetch when that source fires. A poll heartbeat with no event does\n * nothing.\n */\nimport { useSyncExternalStore } from \"react\";\n\nclass ChangeVersionStore {\n  private versions = new Map<string, number>();\n  private listeners = new Set<() => void>();\n  private cachedSnapshots = new Map<string, number>();\n\n  /**\n   * Advance the counter for `source` to at least `version`. Returns true if\n   * the counter actually moved (so callers can avoid spurious work).\n   */\n  bump(source: string, version: number): boolean {\n    if (!source) return false;\n    const current = this.versions.get(source) ?? 0;\n    if (version > current) {\n      this.versions.set(source, version);\n      this.cachedSnapshots.set(source, version);\n      this.notify();\n      return true;\n    }\n    return false;\n  }\n\n  get(source: string): number {\n    // useSyncExternalStore requires reference-stable snapshots for unchanged\n    // values, so we serve from a cached map that we only update inside\n    // `bump`.\n    const cached = this.cachedSnapshots.get(source);\n    if (cached !== undefined) return cached;\n    this.cachedSnapshots.set(source, 0);\n    return 0;\n  }\n\n  subscribe(listener: () => void): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  private notify() {\n    for (const listener of this.listeners) listener();\n  }\n}\n\nconst store = new ChangeVersionStore();\n\n/**\n * Advance a source counter. Called by `useDbSync` for every change event;\n * may also be called from templates that learn of a server-side change via\n * a custom path (e.g. an in-process mutation that already happened — bump\n * the counter so other components refetch without waiting for the poll\n * cycle).\n */\nexport function bumpChangeVersion(source: string, version: number): boolean {\n  return store.bump(source, version);\n}\n\n/**\n * Get the current counter for a source without subscribing. Use inside\n * event handlers / callbacks; in render code use `useChangeVersion`.\n */\nexport function getChangeVersion(source: string): number {\n  return store.get(source);\n}\n\n/**\n * Subscribe to a source's change counter. Returns an integer that\n * increments every time the server emits an event with `source === <source>`\n * — including (by design) the agent's own action calls, since the agent\n * runner emits `source: \"action\"` after every successful mutating action.\n *\n * Fold the return value into a React Query `queryKey` to make the query\n * refetch whenever that source advances:\n *\n * ```ts\n * const v = useChangeVersion(\"dashboards\");\n * useQuery({\n *   queryKey: [\"dashboard\", id, v],\n *   queryFn: () => fetchDashboard(id),\n *   placeholderData: keepPreviousData,\n * });\n * ```\n */\nexport function useChangeVersion(source: string): number {\n  return useSyncExternalStore(\n    (cb) => store.subscribe(cb),\n    () => store.get(source),\n    () => 0,\n  );\n}\n\n/**\n * Convenience for queries that should refetch on multiple sources — returns\n * the sum of each source's counter so React Query treats every advance as a\n * key change.\n *\n * ```ts\n * const v = useChangeVersions([\"dashboards\", \"action\"]);\n * useQuery({ queryKey: [\"dashboard\", id, v], ... });\n * ```\n */\nexport function useChangeVersions(sources: readonly string[]): number {\n  return useSyncExternalStore(\n    (cb) => store.subscribe(cb),\n    () => sources.reduce((sum, src) => sum + store.get(src), 0),\n    () => 0,\n  );\n}\n\n/** Internal test helper — reset all counters. Do not use in app code. */\nexport function _resetChangeVersionStoreForTests(): void {\n  // @ts-expect-error reaching past private to clear state in tests\n  store.versions.clear();\n  // @ts-expect-error reaching past private to clear state in tests\n  store.cachedSnapshots.clear();\n}\n"]}

package/dist/client/use-chat-threads.d.ts

@@ -1,3 +1,8 @@
+export interface ChatThreadScope {
+    type: string;
+    id: string;
+    label?: string;
+}
 export interface ChatThreadSummary {
     id: string;
     title: string;
@@ -5,6 +10,7 @@ export interface ChatThreadSummary {
     messageCount: number;
     createdAt: number;
     updatedAt: number;
+    scope: ChatThreadScope | null;
 }
 export interface ChatThreadData {
     id: string;
@@ -15,15 +21,23 @@ export interface ChatThreadData {
     messageCount: number;
     createdAt: number;
     updatedAt: number;
+    scope: ChatThreadScope | null;
+}
+export interface ChatThreadSnapshot {
+    threadData: string;
+    title: string;
+    preview: string;
+    messageCount: number;
 }
-export declare function useChatThreads(apiUrl?: string, storageKey?: string): {
+export declare function useChatThreads(apiUrl?: string, storageKey?: string, scope?: ChatThreadScope | null): {
     threads: ChatThreadSummary[];
     activeThreadId: string;
     isLoading: boolean;
     createThread: (preferredId?: string) => Promise<string | null>;
     switchThread: (id: string) => void;
     deleteThread: (id: string) => Promise<void>;
-    forkThread: (sourceId: string) => Promise<string | null>;
+    detachThread: (threadId: string) => Promise<void>;
+    forkThread: (sourceId: string, sourceSnapshot?: ChatThreadSnapshot | null) => Promise<string | null>;
     saveThreadData: (id: string, data: {
         threadData: string;
         title: string;

package/dist/client/use-chat-threads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-chat-threads.d.ts","sourceRoot":"","sources":["../../src/client/use-chat-threads.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,cAAc,CAC5B,MAAM,SAA+C,EACrD,UAAU,CAAC,EAAE,MAAM;;;;iCA+JF,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;uBAmBV,MAAM;uBAK/B,MAAM;2BAuGA,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;yBA9E1C,MAAM,QACJ;QACJ,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;8BAgDc,MAAM,WAAW,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;2BAiEnD,MAAM,KAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;;sBAzJ9C,MAAM;EA0Ld"}
+{"version":3,"file":"use-chat-threads.d.ts","sourceRoot":"","sources":["../../src/client/use-chat-threads.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AASD,wBAAgB,cAAc,CAC5B,MAAM,SAA+C,EACrD,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,eAAe,GAAG,IAAI;;;;iCAyMb,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;uBAuCV,MAAM;uBAK/B,MAAM;6BAzBA,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;2BA6I3B,MAAM,mBACC,kBAAkB,GAAG,IAAI,KACzC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;yBApFnB,MAAM,QACJ;QACJ,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;8BAmDc,MAAM,WAAW,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;2BA2EnD,MAAM,KAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;;sBA/K9C,MAAM;EAiNd"}

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

@@ -1,10 +1,22 @@
-import { useState, useEffect, useCallback, useRef } from "react";
+import { useState, useEffect, useCallback, useRef, useMemo } from "react";
 import { agentNativePath } from "./api-path.js";
 const ACTIVE_THREAD_KEY = "agent-chat-active-thread";
-export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-chat"), storageKey) {
-    const activeThreadKey = storageKey
-        ? `${ACTIVE_THREAD_KEY}:${storageKey}`
-        : ACTIVE_THREAD_KEY;
+function scopeKeySegment(scope) {
+    if (!scope)
+        return "";
+    return `:scope:${scope.type}:${scope.id}`;
+}
+export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-chat"), storageKey, scope) {
+    // Each (storageKey, scope) pair gets its own active-thread localStorage
+    // key, so navigating between decks/designs/dashboards lands on whatever
+    // thread the user had open last *for that resource* — not whichever
+    // thread was active globally.
+    const activeThreadKey = useMemo(() => {
+        const scopePart = scopeKeySegment(scope);
+        return storageKey
+            ? `${ACTIVE_THREAD_KEY}:${storageKey}${scopePart}`
+            : `${ACTIVE_THREAD_KEY}${scopePart}`;
+    }, [storageKey, scope?.type, scope?.id]);
     const [threads, setThreads] = useState([]);
     // IDs we generated client-side this session — consumers use this to know
     // whether to skip the per-thread restore skeleton, and we use it to
@@ -33,8 +45,24 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
     const fetchedRef = useRef(false);
     const activeThreadIdRef = useRef(activeThreadId);
     activeThreadIdRef.current = activeThreadId;
-    // Persist active thread ID
+    // Persist active thread ID — and rehydrate on scope flips. When the
+    // user navigates from deck A to deck B, `activeThreadKey` changes; we
+    // need to re-read whatever thread was last active for B *before*
+    // persisting back, otherwise we'd write A's id under B's key on the
+    // very next render. The ref-and-branch pattern below keeps the two
+    // concerns in one effect without racing them.
+    const persistedKeyRef = useRef(activeThreadKey);
     useEffect(() => {
+        if (persistedKeyRef.current !== activeThreadKey) {
+            persistedKeyRef.current = activeThreadKey;
+            try {
+                setActiveThreadId(localStorage.getItem(activeThreadKey));
+            }
+            catch {
+                setActiveThreadId(null);
+            }
+            return;
+        }
         try {
             if (activeThreadId) {
                 localStorage.setItem(activeThreadKey, activeThreadId);
@@ -79,6 +107,15 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
                         if (local.title)
                             next.title = local.title;
                     }
+                    // Preserve optimistic scope: when the server creates the row
+                    // on first message it does so without scope, and the next PUT
+                    // (saveThreadData) writes the local scope back. In the brief
+                    // window between those, the server list returns scope: null
+                    // while the user is clearly working inside a deck — keep the
+                    // local value so the tab bar doesn't blink unscoped.
+                    if (local.scope && !server.scope) {
+                        next.scope = local.scope;
+                    }
                     return next;
                 });
                 return [...optimisticOnly, ...merged];
@@ -89,6 +126,12 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
             return undefined;
         }
     }, [apiUrl]);
+    // Latest scope as a ref so `createThread` (a useCallback that we don't
+    // want to depend on scope identity) reads the current value at call
+    // time. The scope a new chat inherits is the one in effect when the +
+    // button is clicked, not when the hook first mounted.
+    const scopeRef = useRef(scope);
+    scopeRef.current = scope;
     // Add a client-generated thread to the local list optimistically.
     //
     // Critically, this does NOT `POST /threads` to the server — that path was
@@ -98,7 +141,7 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
     // sends their first message (`persistSubmittedUserMessage` →
     // `createThread`), so the client doesn't need to pre-create it. This
     // makes the threads table reflect real conversations only.
-    const addOptimisticThread = useCallback((id) => {
+    const addOptimisticThread = useCallback((id, threadScope) => {
         const now = Date.now();
         const optimistic = {
             id,
@@ -107,6 +150,7 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
             messageCount: 0,
             createdAt: now,
             updatedAt: now,
+            scope: threadScope,
         };
         setThreads((prev) => prev.some((t) => t.id === id) ? prev : [optimistic, ...prev]);
     }, []);
@@ -148,7 +192,7 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
                 if (typeof crypto !== "undefined" && crypto.randomUUID) {
                     const id = crypto.randomUUID();
                     newlyCreatedRef.current.add(id);
-                    addOptimisticThread(id);
+                    addOptimisticThread(id, scopeRef.current ?? null);
                     setActiveThreadId(id);
                 }
             }
@@ -162,10 +206,25 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
         // clicks "+" but never chats.
         const id = preferredId || crypto.randomUUID();
         newlyCreatedRef.current.add(id);
-        addOptimisticThread(id);
+        addOptimisticThread(id, scopeRef.current ?? null);
         setActiveThreadId(id);
         return Promise.resolve(id);
     }, [addOptimisticThread]);
+    // Drop a thread's scope so it becomes a general (cross-resource) chat.
+    // This is the "Detach from <deck>" escape hatch in the UI. The PUT
+    // also bumps the thread's updatedAt so it surfaces in the All Chats
+    // list right away.
+    const detachThread = useCallback(async (threadId) => {
+        try {
+            await fetch(`${apiUrl}/threads/${encodeURIComponent(threadId)}`, {
+                method: "PUT",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ scope: null }),
+            });
+            setThreads((prev) => prev.map((t) => (t.id === threadId ? { ...t, scope: null } : t)));
+        }
+        catch { }
+    }, [apiUrl]);
     const isNewThread = useCallback((id) => newlyCreatedRef.current.has(id), []);
     const switchThread = useCallback((id) => {
         setActiveThreadId(id);
@@ -192,12 +251,21 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
             return next;
         });
     }, [apiUrl, activeThreadId, createThread]);
+    // Ref to look up the latest scope of a known thread inside
+    // saveThreadData without making the callback re-create on every
+    // setThreads. The thread's scope is owned by createThread /
+    // detachThread / fetchThreads — saveThreadData just mirrors it on
+    // every save so the server eventually catches up after
+    // persistSubmittedUserMessage creates the row sans scope.
+    const threadsRef = useRef(threads);
+    threadsRef.current = threads;
     const saveThreadData = useCallback(async (id, data) => {
         try {
+            const localScope = threadsRef.current.find((t) => t.id === id)?.scope ?? null;
             await fetch(`${apiUrl}/threads/${encodeURIComponent(id)}`, {
                 method: "PUT",
                 headers: { "Content-Type": "application/json" },
-                body: JSON.stringify(data),
+                body: JSON.stringify({ ...data, scope: localScope }),
             });
             // Update local thread list metadata. If the thread isn't in our
             // local list yet (an optimistic-only thread that the server just
@@ -227,6 +295,7 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
                         messageCount: data.messageCount ?? 0,
                         createdAt: now,
                         updatedAt: now,
+                        scope: scopeRef.current ?? null,
                     },
                     ...prev,
                 ];
@@ -255,13 +324,17 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
             return null;
         }
     }, [apiUrl]);
-    const forkThread = useCallback(async (sourceId) => {
+    const forkThread = useCallback(async (sourceId, sourceSnapshot) => {
         const id = crypto.randomUUID();
         try {
+            const localScope = threadsRef.current.find((t) => t.id === sourceId)?.scope ?? null;
+            const source = sourceSnapshot && sourceSnapshot.messageCount > 0
+                ? { ...sourceSnapshot, scope: localScope }
+                : undefined;
             const res = await fetch(`${apiUrl}/threads/${encodeURIComponent(sourceId)}/fork`, {
                 method: "POST",
                 headers: { "Content-Type": "application/json" },
-                body: JSON.stringify({ id }),
+                body: JSON.stringify({ id, ...(source ? { source } : {}) }),
             });
             if (!res.ok) {
                 // Surface failures so a click on the Fork button isn't a silent
@@ -278,6 +351,7 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
                     messageCount: thread.messageCount,
                     createdAt: thread.createdAt,
                     updatedAt: thread.updatedAt,
+                    scope: thread.scope ?? null,
                 },
                 ...prev,
             ]);
@@ -310,6 +384,7 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
         createThread,
         switchThread,
         deleteThread: removeThread,
+        detachThread,
         forkThread,
         saveThreadData,
         generateTitle,

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\n  // IDs we generated client-side this session — consumers use this to know\n  // whether to skip the per-thread restore skeleton, and we use it to\n  // protect the optimistic-only thread from being yanked out of local\n  // state when the server's threads list (which never sees it) loads.\n  const newlyCreatedRef = useRef<Set<string>>(new Set());\n\n  // Restore the saved active thread synchronously on mount so the chat shell\n  // can paint immediately. We do NOT synthesize a fresh UUID here when no\n  // saved id exists — that flow was creating empty `chat_threads` rows on\n  // every page load via the optimistic POST, even if the user never chatted.\n  // (Steve's account had 127 threads; 112 had message_count=0 and zero\n  // agent_runs — pure ghosts.) When localStorage is empty, the initial\n  // useEffect picks the most-recent server thread, or synthesizes a brand\n  // new id only when there are no server threads at all.\n  const [activeThreadId, setActiveThreadId] = useState<string | null>(() => {\n    if (typeof window === \"undefined\") return 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  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        const loadedIds = new Set(loaded.map((t) => t.id));\n        // Preserve any optimistic threads we've created this session that\n        // haven't shown up in the server list yet — the server only learns\n        // about a thread when the user actually sends a message and the\n        // agent run's `persistSubmittedUserMessage` writes the row.\n        const optimisticOnly = prev.filter(\n          (t) => newlyCreatedRef.current.has(t.id) && !loadedIds.has(t.id),\n        );\n        // Reconcile each server thread against our local copy. If the local\n        // copy has a newer updatedAt or higher messageCount, keep those\n        // fields — the server probably hasn't observed the user's latest\n        // send yet, and naively replacing makes the recent-chats list\n        // visibly jump back to older timestamps right after a send.\n        const merged = loaded.map((server) => {\n          const local = prev.find((t) => t.id === server.id);\n          if (!local) return server;\n          const next = { ...server };\n          if (local.updatedAt > server.updatedAt) {\n            next.updatedAt = local.updatedAt;\n          }\n          if (local.messageCount > server.messageCount) {\n            next.messageCount = local.messageCount;\n            if (local.preview) next.preview = local.preview;\n            if (local.title) next.title = local.title;\n          }\n          return next;\n        });\n        return [...optimisticOnly, ...merged];\n      });\n      return data.threads as ChatThreadSummary[];\n    } catch {\n      return undefined;\n    }\n  }, [apiUrl]);\n\n  // Add a client-generated thread to the local list optimistically.\n  //\n  // Critically, this does NOT `POST /threads` to the server — that path was\n  // creating an empty row in `chat_threads` (message_count=0, no\n  // agent_runs) on every page mount and every \"+\" click. The server\n  // already creates the row idempotently the moment the user actually\n  // sends their first message (`persistSubmittedUserMessage` →\n  // `createThread`), so the client doesn't need to pre-create it. This\n  // makes the threads table reflect real conversations only.\n  const addOptimisticThread = useCallback((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  }, []);\n\n  // Initial load: load threads from server, then reconcile against the\n  // saved active thread.\n  //\n  // - savedId in loadedThreads → keep it (user's last conversation).\n  // - savedId in newlyCreatedRef (we just created it this session) → keep\n  //   it; the server hasn't seen it yet because there's no POST anymore,\n  //   the row gets written when the user sends a message.\n  // - savedId is set but neither on the server nor newly created here →\n  //   it's a stale id from a previous session whose row no longer exists\n  //   (was a ghost cleaned up, or the user emptied their account, etc.).\n  //   Drop them on the most-recent real thread instead of leaving them\n  //   staring at a 404'd composer.\n  // - No savedId, no server threads → synthesize a fresh local id (no\n  //   POST; server creates the row on first message).\n  useEffect(() => {\n    if (fetchedRef.current) return;\n    fetchedRef.current = true;\n\n    (async () => {\n      setIsLoading(true);\n      const loadedThreads = await fetchThreads();\n      const savedId = activeThreadIdRef.current;\n\n      if (loadedThreads && loadedThreads.length > 0) {\n        if (\n          savedId &&\n          !newlyCreatedRef.current.has(savedId) &&\n          !loadedThreads.find((t) => t.id === savedId)\n        ) {\n          setActiveThreadId(loadedThreads[0].id);\n        } else if (!savedId) {\n          setActiveThreadId(loadedThreads[0].id);\n        }\n      } else if (!savedId) {\n        // Brand new user — synthesize a local id so the composer has a\n        // target. No POST: the server creates the row on first send.\n        if (typeof crypto !== \"undefined\" && crypto.randomUUID) {\n          const id = crypto.randomUUID();\n          newlyCreatedRef.current.add(id);\n          addOptimisticThread(id);\n          setActiveThreadId(id);\n        }\n      }\n      setIsLoading(false);\n    })();\n  }, [fetchThreads, addOptimisticThread]);\n\n  const createThread = useCallback(\n    (preferredId?: string): Promise<string | null> => {\n      // Generate ID client-side for instant UI response. No POST — the\n      // server creates the row when the user actually sends a message,\n      // which prevents accumulation of empty thread rows when the user\n      // clicks \"+\" but never chats.\n      const id = preferredId || crypto.randomUUID();\n      newlyCreatedRef.current.add(id);\n      addOptimisticThread(id);\n      setActiveThreadId(id);\n      return Promise.resolve(id);\n    },\n    [addOptimisticThread],\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      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. If the thread isn't in our\n        // local list yet (an optimistic-only thread that the server just\n        // created via persistSubmittedUserMessage), add it so HistoryPopover\n        // can show it once it has messages.\n        setThreads((prev) => {\n          const exists = prev.some((t) => t.id === id);\n          if (exists) {\n            return 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          const now = Date.now();\n          return [\n            {\n              id,\n              title: data.title,\n              preview: data.preview,\n              messageCount: data.messageCount ?? 0,\n              createdAt: now,\n              updatedAt: now,\n            },\n            ...prev,\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"]}
+{"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, useMemo } from \"react\";\nimport { agentNativePath } from \"./api-path.js\";\n\nexport interface ChatThreadScope {\n  type: string;\n  id: string;\n  label?: string;\n}\n\nexport interface ChatThreadSummary {\n  id: string;\n  title: string;\n  preview: string;\n  messageCount: number;\n  createdAt: number;\n  updatedAt: number;\n  scope: ChatThreadScope | null;\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  scope: ChatThreadScope | null;\n}\n\nexport interface ChatThreadSnapshot {\n  threadData: string;\n  title: string;\n  preview: string;\n  messageCount: number;\n}\n\nconst ACTIVE_THREAD_KEY = \"agent-chat-active-thread\";\n\nfunction scopeKeySegment(scope?: ChatThreadScope | null): string {\n  if (!scope) return \"\";\n  return `:scope:${scope.type}:${scope.id}`;\n}\n\nexport function useChatThreads(\n  apiUrl = agentNativePath(\"/_agent-native/agent-chat\"),\n  storageKey?: string,\n  scope?: ChatThreadScope | null,\n) {\n  // Each (storageKey, scope) pair gets its own active-thread localStorage\n  // key, so navigating between decks/designs/dashboards lands on whatever\n  // thread the user had open last *for that resource* — not whichever\n  // thread was active globally.\n  const activeThreadKey = useMemo(() => {\n    const scopePart = scopeKeySegment(scope);\n    return storageKey\n      ? `${ACTIVE_THREAD_KEY}:${storageKey}${scopePart}`\n      : `${ACTIVE_THREAD_KEY}${scopePart}`;\n  }, [storageKey, scope?.type, scope?.id]);\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, and we use it to\n  // protect the optimistic-only thread from being yanked out of local\n  // state when the server's threads list (which never sees it) loads.\n  const newlyCreatedRef = useRef<Set<string>>(new Set());\n\n  // Restore the saved active thread synchronously on mount so the chat shell\n  // can paint immediately. We do NOT synthesize a fresh UUID here when no\n  // saved id exists — that flow was creating empty `chat_threads` rows on\n  // every page load via the optimistic POST, even if the user never chatted.\n  // (Steve's account had 127 threads; 112 had message_count=0 and zero\n  // agent_runs — pure ghosts.) When localStorage is empty, the initial\n  // useEffect picks the most-recent server thread, or synthesizes a brand\n  // new id only when there are no server threads at all.\n  const [activeThreadId, setActiveThreadId] = useState<string | null>(() => {\n    if (typeof window === \"undefined\") return 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  const activeThreadIdRef = useRef(activeThreadId);\n  activeThreadIdRef.current = activeThreadId;\n\n  // Persist active thread ID — and rehydrate on scope flips. When the\n  // user navigates from deck A to deck B, `activeThreadKey` changes; we\n  // need to re-read whatever thread was last active for B *before*\n  // persisting back, otherwise we'd write A's id under B's key on the\n  // very next render. The ref-and-branch pattern below keeps the two\n  // concerns in one effect without racing them.\n  const persistedKeyRef = useRef(activeThreadKey);\n  useEffect(() => {\n    if (persistedKeyRef.current !== activeThreadKey) {\n      persistedKeyRef.current = activeThreadKey;\n      try {\n        setActiveThreadId(localStorage.getItem(activeThreadKey));\n      } catch {\n        setActiveThreadId(null);\n      }\n      return;\n    }\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        const loadedIds = new Set(loaded.map((t) => t.id));\n        // Preserve any optimistic threads we've created this session that\n        // haven't shown up in the server list yet — the server only learns\n        // about a thread when the user actually sends a message and the\n        // agent run's `persistSubmittedUserMessage` writes the row.\n        const optimisticOnly = prev.filter(\n          (t) => newlyCreatedRef.current.has(t.id) && !loadedIds.has(t.id),\n        );\n        // Reconcile each server thread against our local copy. If the local\n        // copy has a newer updatedAt or higher messageCount, keep those\n        // fields — the server probably hasn't observed the user's latest\n        // send yet, and naively replacing makes the recent-chats list\n        // visibly jump back to older timestamps right after a send.\n        const merged = loaded.map((server) => {\n          const local = prev.find((t) => t.id === server.id);\n          if (!local) return server;\n          const next = { ...server };\n          if (local.updatedAt > server.updatedAt) {\n            next.updatedAt = local.updatedAt;\n          }\n          if (local.messageCount > server.messageCount) {\n            next.messageCount = local.messageCount;\n            if (local.preview) next.preview = local.preview;\n            if (local.title) next.title = local.title;\n          }\n          // Preserve optimistic scope: when the server creates the row\n          // on first message it does so without scope, and the next PUT\n          // (saveThreadData) writes the local scope back. In the brief\n          // window between those, the server list returns scope: null\n          // while the user is clearly working inside a deck — keep the\n          // local value so the tab bar doesn't blink unscoped.\n          if (local.scope && !server.scope) {\n            next.scope = local.scope;\n          }\n          return next;\n        });\n        return [...optimisticOnly, ...merged];\n      });\n      return data.threads as ChatThreadSummary[];\n    } catch {\n      return undefined;\n    }\n  }, [apiUrl]);\n\n  // Latest scope as a ref so `createThread` (a useCallback that we don't\n  // want to depend on scope identity) reads the current value at call\n  // time. The scope a new chat inherits is the one in effect when the +\n  // button is clicked, not when the hook first mounted.\n  const scopeRef = useRef<ChatThreadScope | null | undefined>(scope);\n  scopeRef.current = scope;\n\n  // Add a client-generated thread to the local list optimistically.\n  //\n  // Critically, this does NOT `POST /threads` to the server — that path was\n  // creating an empty row in `chat_threads` (message_count=0, no\n  // agent_runs) on every page mount and every \"+\" click. The server\n  // already creates the row idempotently the moment the user actually\n  // sends their first message (`persistSubmittedUserMessage` →\n  // `createThread`), so the client doesn't need to pre-create it. This\n  // makes the threads table reflect real conversations only.\n  const addOptimisticThread = useCallback(\n    (id: string, threadScope: ChatThreadScope | null) => {\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        scope: threadScope,\n      };\n      setThreads((prev) =>\n        prev.some((t) => t.id === id) ? prev : [optimistic, ...prev],\n      );\n    },\n    [],\n  );\n\n  // Initial load: load threads from server, then reconcile against the\n  // saved active thread.\n  //\n  // - savedId in loadedThreads → keep it (user's last conversation).\n  // - savedId in newlyCreatedRef (we just created it this session) → keep\n  //   it; the server hasn't seen it yet because there's no POST anymore,\n  //   the row gets written when the user sends a message.\n  // - savedId is set but neither on the server nor newly created here →\n  //   it's a stale id from a previous session whose row no longer exists\n  //   (was a ghost cleaned up, or the user emptied their account, etc.).\n  //   Drop them on the most-recent real thread instead of leaving them\n  //   staring at a 404'd composer.\n  // - No savedId, no server threads → synthesize a fresh local id (no\n  //   POST; server creates the row on first message).\n  useEffect(() => {\n    if (fetchedRef.current) return;\n    fetchedRef.current = true;\n\n    (async () => {\n      setIsLoading(true);\n      const loadedThreads = await fetchThreads();\n      const savedId = activeThreadIdRef.current;\n\n      if (loadedThreads && loadedThreads.length > 0) {\n        if (\n          savedId &&\n          !newlyCreatedRef.current.has(savedId) &&\n          !loadedThreads.find((t) => t.id === savedId)\n        ) {\n          setActiveThreadId(loadedThreads[0].id);\n        } else if (!savedId) {\n          setActiveThreadId(loadedThreads[0].id);\n        }\n      } else if (!savedId) {\n        // Brand new user — synthesize a local id so the composer has a\n        // target. No POST: the server creates the row on first send.\n        if (typeof crypto !== \"undefined\" && crypto.randomUUID) {\n          const id = crypto.randomUUID();\n          newlyCreatedRef.current.add(id);\n          addOptimisticThread(id, scopeRef.current ?? null);\n          setActiveThreadId(id);\n        }\n      }\n      setIsLoading(false);\n    })();\n  }, [fetchThreads, addOptimisticThread]);\n\n  const createThread = useCallback(\n    (preferredId?: string): Promise<string | null> => {\n      // Generate ID client-side for instant UI response. No POST — the\n      // server creates the row when the user actually sends a message,\n      // which prevents accumulation of empty thread rows when the user\n      // clicks \"+\" but never chats.\n      const id = preferredId || crypto.randomUUID();\n      newlyCreatedRef.current.add(id);\n      addOptimisticThread(id, scopeRef.current ?? null);\n      setActiveThreadId(id);\n      return Promise.resolve(id);\n    },\n    [addOptimisticThread],\n  );\n\n  // Drop a thread's scope so it becomes a general (cross-resource) chat.\n  // This is the \"Detach from <deck>\" escape hatch in the UI. The PUT\n  // also bumps the thread's updatedAt so it surfaces in the All Chats\n  // list right away.\n  const detachThread = useCallback(\n    async (threadId: string): Promise<void> => {\n      try {\n        await fetch(`${apiUrl}/threads/${encodeURIComponent(threadId)}`, {\n          method: \"PUT\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify({ scope: null }),\n        });\n        setThreads((prev) =>\n          prev.map((t) => (t.id === threadId ? { ...t, scope: null } : t)),\n        );\n      } catch {}\n    },\n    [apiUrl],\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      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  // Ref to look up the latest scope of a known thread inside\n  // saveThreadData without making the callback re-create on every\n  // setThreads. The thread's scope is owned by createThread /\n  // detachThread / fetchThreads — saveThreadData just mirrors it on\n  // every save so the server eventually catches up after\n  // persistSubmittedUserMessage creates the row sans scope.\n  const threadsRef = useRef<ChatThreadSummary[]>(threads);\n  threadsRef.current = threads;\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        const localScope =\n          threadsRef.current.find((t) => t.id === id)?.scope ?? null;\n        await fetch(`${apiUrl}/threads/${encodeURIComponent(id)}`, {\n          method: \"PUT\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify({ ...data, scope: localScope }),\n        });\n        // Update local thread list metadata. If the thread isn't in our\n        // local list yet (an optimistic-only thread that the server just\n        // created via persistSubmittedUserMessage), add it so HistoryPopover\n        // can show it once it has messages.\n        setThreads((prev) => {\n          const exists = prev.some((t) => t.id === id);\n          if (exists) {\n            return 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          const now = Date.now();\n          return [\n            {\n              id,\n              title: data.title,\n              preview: data.preview,\n              messageCount: data.messageCount ?? 0,\n              createdAt: now,\n              updatedAt: now,\n              scope: scopeRef.current ?? null,\n            },\n            ...prev,\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 (\n      sourceId: string,\n      sourceSnapshot?: ChatThreadSnapshot | null,\n    ): Promise<string | null> => {\n      const id = crypto.randomUUID();\n      try {\n        const localScope =\n          threadsRef.current.find((t) => t.id === sourceId)?.scope ?? null;\n        const source =\n          sourceSnapshot && sourceSnapshot.messageCount > 0\n            ? { ...sourceSnapshot, scope: localScope }\n            : undefined;\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, ...(source ? { source } : {}) }),\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            scope: thread.scope ?? null,\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    detachThread,\n    forkThread,\n    saveThreadData,\n    generateTitle,\n    searchThreads,\n    refreshThreads,\n    isNewThread,\n  };\n}\n"]}

package/dist/client/use-chat-threads.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-chat-threads.spec.d.ts.map

package/dist/client/use-chat-threads.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat-threads.spec.d.ts","sourceRoot":"","sources":["../../src/client/use-chat-threads.spec.tsx"],"names":[],"mappings":""}