@agent-native/core 0.14.8 → 0.15.1

package/dist/client/tools/index.d.ts

@@ -0,0 +1,8 @@
+export { ToolsSidebarSection } from "./ToolsSidebarSection.js";
+export { ToolViewer, type ToolViewerProps } from "./ToolViewer.js";
+export { ToolEditor, type ToolEditorProps } from "./ToolEditor.js";
+export { ToolsListPage } from "./ToolsListPage.js";
+export { ToolViewerPage } from "./ToolViewerPage.js";
+export { EmbeddedTool, type EmbeddedToolProps } from "./EmbeddedTool.js";
+export { ExtensionSlot, type ExtensionSlotProps } from "./ExtensionSlot.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/client/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/client/tools/index.js

@@ -0,0 +1,8 @@
+export { ToolsSidebarSection } from "./ToolsSidebarSection.js";
+export { ToolViewer } from "./ToolViewer.js";
+export { ToolEditor } from "./ToolEditor.js";
+export { ToolsListPage } from "./ToolsListPage.js";
+export { ToolViewerPage } from "./ToolViewerPage.js";
+export { EmbeddedTool } from "./EmbeddedTool.js";
+export { ExtensionSlot } from "./ExtensionSlot.js";
+//# sourceMappingURL=index.js.map

package/dist/client/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,aAAa,EAA2B,MAAM,oBAAoB,CAAC","sourcesContent":["export { ToolsSidebarSection } from \"./ToolsSidebarSection.js\";\nexport { ToolViewer, type ToolViewerProps } from \"./ToolViewer.js\";\nexport { ToolEditor, type ToolEditorProps } from \"./ToolEditor.js\";\nexport { ToolsListPage } from \"./ToolsListPage.js\";\nexport { ToolViewerPage } from \"./ToolViewerPage.js\";\nexport { EmbeddedTool, type EmbeddedToolProps } from \"./EmbeddedTool.js\";\nexport { ExtensionSlot, type ExtensionSlotProps } from \"./ExtensionSlot.js\";\n"]}

package/dist/client/tools/tool-order.d.ts

@@ -0,0 +1,7 @@
+export declare const TOOLS_ORDER_CHANGE_EVENT = "tools-order-change";
+export declare function getToolsOrder(): string[];
+export declare function setToolsOrder(order: string[]): void;
+export declare function applyToolsOrder<T extends {
+    id: string;
+}>(items: T[], savedOrder: string[]): T[];
+//# sourceMappingURL=tool-order.d.ts.map

package/dist/client/tools/tool-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-order.d.ts","sourceRoot":"","sources":["../../../src/client/tools/tool-order.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,uBAAuB,CAAC;AAI7D,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAYxC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAU5C;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACtD,KAAK,EAAE,CAAC,EAAE,EACV,UAAU,EAAE,MAAM,EAAE,GACnB,CAAC,EAAE,CAeL"}

package/dist/client/tools/tool-order.js

@@ -0,0 +1,47 @@
+export const TOOLS_ORDER_CHANGE_EVENT = "tools-order-change";
+const TOOLS_ORDER_KEY = "tools-order";
+export function getToolsOrder() {
+    if (typeof window === "undefined")
+        return [];
+    try {
+        const raw = window.localStorage.getItem(TOOLS_ORDER_KEY);
+        if (!raw)
+            return [];
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed)
+            ? parsed.filter((id) => typeof id === "string")
+            : [];
+    }
+    catch {
+        return [];
+    }
+}
+export function setToolsOrder(order) {
+    if (typeof window === "undefined")
+        return;
+    try {
+        window.localStorage.setItem(TOOLS_ORDER_KEY, JSON.stringify(order));
+        window.dispatchEvent(new CustomEvent(TOOLS_ORDER_CHANGE_EVENT, { detail: order }));
+    }
+    catch {
+        // localStorage unavailable / quota — ignore, order is best-effort
+    }
+}
+export function applyToolsOrder(items, savedOrder) {
+    if (savedOrder.length === 0)
+        return items;
+    const idToItem = new Map(items.map((item) => [item.id, item]));
+    const ordered = [];
+    for (const id of savedOrder) {
+        const item = idToItem.get(id);
+        if (item) {
+            ordered.push(item);
+            idToItem.delete(id);
+        }
+    }
+    for (const item of idToItem.values()) {
+        ordered.push(item);
+    }
+    return ordered;
+}
+//# sourceMappingURL=tool-order.js.map

package/dist/client/tools/tool-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-order.js","sourceRoot":"","sources":["../../../src/client/tools/tool-order.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,oBAAoB,CAAC;AAE7D,MAAM,eAAe,GAAG,aAAa,CAAC;AAEtC,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,EAAE,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACzD,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAC1B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC;YAC/C,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAe;IAC3C,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,CAAC;QACH,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,MAAM,CAAC,aAAa,CAClB,IAAI,WAAW,CAAC,wBAAwB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAC7D,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,kEAAkE;IACpE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAU,EACV,UAAoB;IAEpB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["export const TOOLS_ORDER_CHANGE_EVENT = \"tools-order-change\";\n\nconst TOOLS_ORDER_KEY = \"tools-order\";\n\nexport function getToolsOrder(): string[] {\n  if (typeof window === \"undefined\") return [];\n  try {\n    const raw = window.localStorage.getItem(TOOLS_ORDER_KEY);\n    if (!raw) return [];\n    const parsed = JSON.parse(raw);\n    return Array.isArray(parsed)\n      ? parsed.filter((id) => typeof id === \"string\")\n      : [];\n  } catch {\n    return [];\n  }\n}\n\nexport function setToolsOrder(order: string[]) {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(TOOLS_ORDER_KEY, JSON.stringify(order));\n    window.dispatchEvent(\n      new CustomEvent(TOOLS_ORDER_CHANGE_EVENT, { detail: order }),\n    );\n  } catch {\n    // localStorage unavailable / quota — ignore, order is best-effort\n  }\n}\n\nexport function applyToolsOrder<T extends { id: string }>(\n  items: T[],\n  savedOrder: string[],\n): T[] {\n  if (savedOrder.length === 0) return items;\n  const idToItem = new Map(items.map((item) => [item.id, item]));\n  const ordered: T[] = [];\n  for (const id of savedOrder) {\n    const item = idToItem.get(id);\n    if (item) {\n      ordered.push(item);\n      idToItem.delete(id);\n    }\n  }\n  for (const item of idToItem.values()) {\n    ordered.push(item);\n  }\n  return ordered;\n}\n"]}

package/dist/client/transcription/BuilderTranscriptionCta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BuilderTranscriptionCta.d.ts","sourceRoot":"","sources":["../../../src/client/transcription/BuilderTranscriptionCta.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,wBAAgB,uBAAuB,4CAoGtC"}
+{"version":3,"file":"BuilderTranscriptionCta.d.ts","sourceRoot":"","sources":["../../../src/client/transcription/BuilderTranscriptionCta.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,wBAAgB,uBAAuB,4CA+FtC"}

package/dist/client/transcription/BuilderTranscriptionCta.js

@@ -9,7 +9,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { IconBolt, IconExternalLink, IconLoader2 } from "@tabler/icons-react";
 import { agentNativePath } from "../api-path.js";
-import { getCallbackOrigin } from "../frame.js";
+import { openBuilderConnectPopup } from "../settings/useBuilderStatus.js";
 export function BuilderTranscriptionCta() {
     const [configured, setConfigured] = useState(null);
     const [connecting, setConnecting] = useState(false);
@@ -44,8 +44,7 @@ export function BuilderTranscriptionCta() {
             clearInterval(pollRef.current);
         setConnecting(true);
         setError(null);
-        const origin = getCallbackOrigin() || window.location.origin;
-        window.open(new URL(agentNativePath("/_agent-native/builder/connect"), origin).href, "_blank", "noopener,noreferrer");
+        openBuilderConnectPopup({ source: "builder_transcription_cta" });
         const start = Date.now();
         pollRef.current = setInterval(async () => {
             try {

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":";AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,MAAM,UAAU,uBAAuB;IACrC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAiB,IAAI,CAAC,CAAC;IACnE,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,CAAwC,IAAI,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAEhC,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,KAAK,CAAC,eAAe,CAAC,+BAA+B,CAAC,CAAC;aACpD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACV,CAAC,CAAC,EAAE;YACF,CAAC,CAAE,CAAC,CAAC,IAAI,EAA6D;YACtE,CAAC,CAAC,IAAI,CACT;aACA,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YACV,IAAI,CAAC,UAAU,CAAC,OAAO;gBAAE,OAAO;YAChC,iEAAiE;YACjE,oEAAoE;YACpE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QACpD,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,IAAI,UAAU,CAAC,OAAO;gBAAE,aAAa,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QACL,OAAO,GAAG,EAAE;YACV,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;YAC3B,IAAI,OAAO,CAAC,OAAO;gBAAE,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtD,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;QACrC,IAAI,OAAO,CAAC,OAAO;YAAE,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpD,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,uBAAuB,CAAC,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC,CAAC;QAEjE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,OAAO,CAAC,OAAO,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;YACvC,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC,+BAA+B,CAAC,CAAC,CAAC;gBACxE,IAAI,CAAC,CAAC,CAAC,EAAE;oBAAE,OAAO;gBAClB,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAA4B,CAAC;gBACtD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;oBACxB,aAAa,CAAC,OAAO,CAAC,OAAQ,CAAC,CAAC;oBAChC,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;oBACjB,aAAa,CAAC,OAAO,CAAC,OAAQ,CAAC,CAAC;oBAChC,aAAa,CAAC,IAAI,CAAC,CAAC;oBACpB,aAAa,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;qBAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;oBAC9C,aAAa,CAAC,OAAO,CAAC,OAAQ,CAAC,CAAC;oBAChC,aAAa,CAAC,KAAK,CAAC,CAAC;oBACrB,QAAQ,CACN,4DAA4D,CAC7D,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,CAAC;IACX,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,sDAAsD;IACtD,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU;QAAE,OAAO,IAAI,CAAC;IAEnD,OAAO,CACL,eAAK,SAAS,EAAC,gHAAgH,aAC7H,KAAC,QAAQ,IACP,IAAI,EAAE,EAAE,EACR,SAAS,EAAC,mCAAmC,iBACjC,MAAM,GAClB,EACF,eAAM,SAAS,EAAC,QAAQ,YACrB,UAAU;oBACT,CAAC,CAAC,yBAAyB;oBAC3B,CAAC,CAAC,wFAAwF,GACvF,EACN,KAAK,CAAC,CAAC,CAAC,CACP,eAAM,SAAS,EAAC,8BAA8B,YAAE,KAAK,GAAQ,CAC9D,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CACf,KAAC,WAAW,IAAC,IAAI,EAAE,EAAE,EAAE,SAAS,EAAC,uBAAuB,GAAG,CAC5D,CAAC,CAAC,CAAC,CACF,kBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,aAAa,EACtB,SAAS,EAAC,+JAA+J,wBAGzK,KAAC,gBAAgB,IAAC,IAAI,EAAE,EAAE,GAAI,IACvB,CACV,IACG,CACP,CAAC;AACJ,CAAC","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,