@agent-native/core 0.72.2 → 0.72.4

package/dist/client/settings/DemoModeSection.js.map

@@ -1 +1 @@
-{"version":3,"file":"DemoModeSection.js","sourceRoot":"","sources":["../../../src/client/settings/DemoModeSection.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * <DemoModeSection /> — toggle that replaces names, emails, and numbers with\n * realistic fake data everywhere (UI + what the agent sees) while preserving\n * IDs and structure so the app keeps working.\n *\n * The toggle is stored in application_state under `demo-mode`\n * (`{ enabled: boolean }`) and written via `PUT\n * /_agent-native/application-state/demo-mode` (optimistic — flip first,\n * write in the background). It READS from `/_agent-native/demo/status`\n * instead, which ORs the per-user toggle with the `DEMO_MODE` env: a hosted\n * demo deployment is forced on and the switch is locked so it can't be\n * accidentally turned off on stage.\n */\n\nimport { useEffect, useState } from \"react\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport { agentNativePath } from \"../api-path.js\";\nimport { IconEyeOff } from \"@tabler/icons-react\";\n\ninterface DemoStatus {\n  enabled?: boolean;\n  forced?: boolean;\n}\n\nconst DEMO_STATUS_URL = agentNativePath(\"/_agent-native/demo/status\");\nconst DEMO_MODE_WRITE_URL = agentNativePath(\n  \"/_agent-native/application-state/demo-mode\",\n);\n\nexport function DemoModeSection() {\n  const [enabled, setEnabled] = useState<boolean | null>(null);\n\n  const { data } = useQuery({\n    queryKey: [\"agent-native\", \"demo-mode\"],\n    queryFn: async () => {\n      const res = await fetch(DEMO_STATUS_URL, { credentials: \"include\" });\n      if (!res.ok) return null;\n      return (await res.json()) as DemoStatus | null;\n    },\n    refetchInterval: 4_000,\n    staleTime: 2_000,\n  });\n\n  const serverEnabled = data?.enabled;\n  const forced = data?.forced === true;\n\n  // Surface the server value once it arrives (and on subsequent polls), but\n  // never clobber an in-flight optimistic toggle with a stale read. When\n  // forced by env, always reflect the locked-on state.\n  useEffect(() => {\n    if (forced) {\n      setEnabled(true);\n    } else if (typeof serverEnabled === \"boolean\") {\n      setEnabled((prev) => (prev === null ? serverEnabled : prev));\n    } else if (serverEnabled === undefined && data !== undefined) {\n      setEnabled((prev) => (prev === null ? false : prev));\n    }\n  }, [serverEnabled, forced, data]);\n\n  const toggle = async (next: boolean) => {\n    if (forced) return;\n    const previous = enabled;\n    // Optimistic: flip immediately, write in the background.\n    setEnabled(next);\n    try {\n      const res = await fetch(DEMO_MODE_WRITE_URL, {\n        method: \"PUT\",\n        headers: { \"Content-Type\": \"application/json\" },\n        credentials: \"include\",\n        body: JSON.stringify({ enabled: next }),\n      });\n      if (!res.ok) {\n        throw new Error(`HTTP ${res.status}`);\n      }\n    } catch {\n      setEnabled(previous);\n    }\n  };\n\n  return (\n    <div className=\"flex items-start justify-between gap-3 rounded-md border border-border bg-accent/30 px-2.5 py-2\">\n      <div className=\"min-w-0\">\n        <div className=\"text-[11px] font-medium text-foreground\">\n          Enable demo mode\n        </div>\n        <p className=\"text-[10px] text-muted-foreground mt-0.5\">\n          Replace names, emails, and numbers with realistic fake data everywhere\n          — in the UI and what the agent sees. IDs and structure are preserved\n          so the app keeps working.\n        </p>\n        {forced && (\n          <p className=\"text-[10px] text-muted-foreground mt-0.5\">\n            Enforced by the <code>DEMO_MODE</code> environment variable — can't\n            be turned off here.\n          </p>\n        )}\n      </div>\n      <button\n        type=\"button\"\n        role=\"switch\"\n        aria-checked={!!enabled}\n        aria-label=\"Enable demo mode\"\n        disabled={enabled === null || forced}\n        onClick={() => toggle(!enabled)}\n        // Theme tokens; streaming agent owns layout.\n        className={`relative inline-flex h-4 w-7 shrink-0 cursor-pointer items-center rounded-full transition-colors ${\n          enabled\n            ? \"bg-primary\"\n            : \"bg-muted-foreground/30 hover:bg-muted-foreground/50\"\n        } ${enabled === null || forced ? \"opacity-60\" : \"\"}`}\n      >\n        <span\n          className={`inline-block h-3 w-3 transform rounded-full bg-background transition-transform ${\n            enabled ? \"translate-x-3.5\" : \"translate-x-0.5\"\n          }`}\n        />\n      </button>\n    </div>\n  );\n}\n\nexport function DemoModeIcon() {\n  return <IconEyeOff size={14} />;\n}\n"]}
+{"version":3,"file":"DemoModeSection.js","sourceRoot":"","sources":["../../../src/client/settings/DemoModeSection.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * <DemoModeSection /> — toggle that replaces names, emails, and numbers with\n * realistic fake data everywhere (UI + what the agent sees) while preserving\n * IDs and structure so the app keeps working.\n *\n * The toggle is stored in application_state under `demo-mode`\n * (`{ enabled: boolean }`) and written via `PUT\n * /_agent-native/application-state/demo-mode` (optimistic — flip first,\n * write in the background). It READS from `/_agent-native/demo/status`\n * instead, which ORs the per-user toggle with the `DEMO_MODE` env: a hosted\n * demo deployment is forced on and the switch is locked so it can't be\n * accidentally turned off on stage.\n */\n\nimport { useEffect, useState } from \"react\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport { agentNativePath } from \"../api-path.js\";\nimport { IconEyeOff } from \"@tabler/icons-react\";\n\ninterface DemoStatus {\n  enabled?: boolean;\n  forced?: boolean;\n}\n\nconst DEMO_STATUS_URL = agentNativePath(\"/_agent-native/demo/status\");\nconst DEMO_MODE_WRITE_URL = agentNativePath(\n  \"/_agent-native/application-state/demo-mode\",\n);\n\nexport function DemoModeSection() {\n  const [enabled, setEnabled] = useState<boolean | null>(null);\n\n  const { data } = useQuery({\n    queryKey: [\"agent-native\", \"demo-mode\"],\n    queryFn: async () => {\n      const res = await fetch(DEMO_STATUS_URL, {\n        credentials: \"same-origin\",\n      });\n      if (!res.ok) return null;\n      return (await res.json()) as DemoStatus | null;\n    },\n    refetchInterval: 4_000,\n    staleTime: 2_000,\n  });\n\n  const serverEnabled = data?.enabled;\n  const forced = data?.forced === true;\n\n  // Surface the server value once it arrives (and on subsequent polls), but\n  // never clobber an in-flight optimistic toggle with a stale read. When\n  // forced by env, always reflect the locked-on state.\n  useEffect(() => {\n    if (forced) {\n      setEnabled(true);\n    } else if (typeof serverEnabled === \"boolean\") {\n      setEnabled((prev) => (prev === null ? serverEnabled : prev));\n    } else if (serverEnabled === undefined && data !== undefined) {\n      setEnabled((prev) => (prev === null ? false : prev));\n    }\n  }, [serverEnabled, forced, data]);\n\n  const toggle = async (next: boolean) => {\n    if (forced) return;\n    const previous = enabled;\n    // Optimistic: flip immediately, write in the background.\n    setEnabled(next);\n    try {\n      const res = await fetch(DEMO_MODE_WRITE_URL, {\n        method: \"PUT\",\n        headers: { \"Content-Type\": \"application/json\" },\n        credentials: \"include\",\n        body: JSON.stringify({ enabled: next }),\n      });\n      if (!res.ok) {\n        throw new Error(`HTTP ${res.status}`);\n      }\n    } catch {\n      setEnabled(previous);\n    }\n  };\n\n  return (\n    <div className=\"flex items-start justify-between gap-3 rounded-md border border-border bg-accent/30 px-2.5 py-2\">\n      <div className=\"min-w-0\">\n        <div className=\"text-[11px] font-medium text-foreground\">\n          Enable demo mode\n        </div>\n        <p className=\"text-[10px] text-muted-foreground mt-0.5\">\n          Replace names, emails, and numbers with realistic fake data everywhere\n          — in the UI and what the agent sees. IDs and structure are preserved\n          so the app keeps working.\n        </p>\n        {forced && (\n          <p className=\"text-[10px] text-muted-foreground mt-0.5\">\n            Enforced by the <code>DEMO_MODE</code> environment variable — can't\n            be turned off here.\n          </p>\n        )}\n      </div>\n      <button\n        type=\"button\"\n        role=\"switch\"\n        aria-checked={!!enabled}\n        aria-label=\"Enable demo mode\"\n        disabled={enabled === null || forced}\n        onClick={() => toggle(!enabled)}\n        // Theme tokens; streaming agent owns layout.\n        className={`relative inline-flex h-4 w-7 shrink-0 cursor-pointer items-center rounded-full transition-colors ${\n          enabled\n            ? \"bg-primary\"\n            : \"bg-muted-foreground/30 hover:bg-muted-foreground/50\"\n        } ${enabled === null || forced ? \"opacity-60\" : \"\"}`}\n      >\n        <span\n          className={`inline-block h-3 w-3 transform rounded-full bg-background transition-transform ${\n            enabled ? \"translate-x-3.5\" : \"translate-x-0.5\"\n          }`}\n        />\n      </button>\n    </div>\n  );\n}\n\nexport function DemoModeIcon() {\n  return <IconEyeOff size={14} />;\n}\n"]}

package/dist/client/use-agent-chat-home-handoff.d.ts

@@ -11,6 +11,12 @@ export interface UseAgentChatHomeHandoffLinksOptions {
     storageKey?: string | null;
     /** Router-local path for the full-page chat route. Defaults to "/". */
     chatPath?: string;
+    /**
+     * Matches every router-local pathname owned by the full-page chat surface.
+     * Defaults to an exact match against `chatPath`. Pass this to cover deep
+     * links such as `/chat/:threadId`.
+     */
+    isChatPath?: (pathname: string) => boolean;
     /** Disable link interception without changing hook call order. */
     enabled?: boolean;
 }
@@ -23,5 +29,5 @@ export declare function useAgentChatHomeHandoff({ storageKey, activePath, enable
  * Intercepts ordinary in-app links clicked from a full-page chat route so the
  * page chat can morph into the destination AgentSidebar and keep its thread.
  */
-export declare function useAgentChatHomeHandoffLinks({ storageKey, chatPath, enabled, }: UseAgentChatHomeHandoffLinksOptions): void;
+export declare function useAgentChatHomeHandoffLinks({ storageKey, chatPath, isChatPath, enabled, }: UseAgentChatHomeHandoffLinksOptions): void;
 //# sourceMappingURL=use-agent-chat-home-handoff.d.ts.map

package/dist/client/use-agent-chat-home-handoff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-agent-chat-home-handoff.d.ts","sourceRoot":"","sources":["../../src/client/use-agent-chat-home-handoff.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,8BAA8B;IAC7C,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mCAAmC;IAClD,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAkED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,UAAU,EACV,UAAU,EACV,OAAc,GACf,EAAE,8BAA8B,GAAG,OAAO,CAc1C;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,UAAU,EACV,QAAc,EACd,OAAc,GACf,EAAE,mCAAmC,GAAG,IAAI,CAmC5C"}
+{"version":3,"file":"use-agent-chat-home-handoff.d.ts","sourceRoot":"","sources":["../../src/client/use-agent-chat-home-handoff.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,8BAA8B;IAC7C,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mCAAmC;IAClD,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAkED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,UAAU,EACV,UAAU,EACV,OAAc,GACf,EAAE,8BAA8B,GAAG,OAAO,CAc1C;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,UAAU,EACV,QAAc,EACd,UAAU,EACV,OAAc,GACf,EAAE,mCAAmC,GAAG,IAAI,CAwC5C"}

package/dist/client/use-agent-chat-home-handoff.js

@@ -1,4 +1,4 @@
-import { useEffect, useState } from "react";
+import { useEffect, useRef, useState } from "react";
 import { useLocation, useNavigate } from "react-router";
 import { appBasePath } from "./api-path.js";
 import { consumeAgentChatHomeHandoff, markAgentChatHomeHandoff, navigateWithAgentChatViewTransition, } from "./chat-view-transition.js";
@@ -82,11 +82,15 @@ export function useAgentChatHomeHandoff({ storageKey, activePath, enabled = true
  * Intercepts ordinary in-app links clicked from a full-page chat route so the
  * page chat can morph into the destination AgentSidebar and keep its thread.
  */
-export function useAgentChatHomeHandoffLinks({ storageKey, chatPath = "/", enabled = true, }) {
+export function useAgentChatHomeHandoffLinks({ storageKey, chatPath = "/", isChatPath, enabled = true, }) {
     const location = useLocation();
     const navigate = useNavigate();
+    const matchesChatPathRef = useRef(() => false);
+    matchesChatPathRef.current =
+        isChatPath ?? ((pathname) => pathname === chatPath);
     useEffect(() => {
-        if (!enabled || stripBasePath(location.pathname) !== chatPath)
+        const matchesChatPath = (pathname) => matchesChatPathRef.current(pathname);
+        if (!enabled || !matchesChatPath(stripBasePath(location.pathname)))
             return;
         if (typeof document === "undefined")
             return;
@@ -104,7 +108,7 @@ export function useAgentChatHomeHandoffLinks({ storageKey, chatPath = "/", enabl
             const path = localPathFromAnchor(anchor);
             const pathname = path ? pathnameFromLocalPath(path) : "";
             if (!path ||
-                pathname === chatPath ||
+                matchesChatPath(pathname) ||
                 isFrameworkOrApiPath(pathname) ||
                 isStaticAssetPath(pathname)) {
                 return;
@@ -115,6 +119,6 @@ export function useAgentChatHomeHandoffLinks({ storageKey, chatPath = "/", enabl
         }
         document.addEventListener("click", handleClick, true);
         return () => document.removeEventListener("click", handleClick, true);
-    }, [chatPath, enabled, location.pathname, navigate, storageKey]);
+    }, [enabled, location.pathname, navigate, storageKey]);
 }
 //# sourceMappingURL=use-agent-chat-home-handoff.js.map

package/dist/client/use-agent-chat-home-handoff.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-agent-chat-home-handoff.js","sourceRoot":"","sources":["../../src/client/use-agent-chat-home-handoff.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useState } from \"react\";\nimport { useLocation, useNavigate } from \"react-router\";\nimport { appBasePath } from \"./api-path.js\";\nimport {\n  consumeAgentChatHomeHandoff,\n  markAgentChatHomeHandoff,\n  navigateWithAgentChatViewTransition,\n} from \"./chat-view-transition.js\";\n\nexport interface UseAgentChatHomeHandoffOptions {\n  /** Namespace shared by the full-page chat and AgentSidebar surfaces. */\n  storageKey?: string | null;\n  /** The current destination path that receives the sidebar handoff. */\n  activePath: string;\n  /** Disable consumption without changing hook call order. */\n  enabled?: boolean;\n}\n\nexport interface UseAgentChatHomeHandoffLinksOptions {\n  /** Namespace shared by the full-page chat and AgentSidebar surfaces. */\n  storageKey?: string | null;\n  /** Router-local path for the full-page chat route. Defaults to \"/\". */\n  chatPath?: string;\n  /** Disable link interception without changing hook call order. */\n  enabled?: boolean;\n}\n\nfunction stripBasePath(path: string): string {\n  const basePath = appBasePath();\n  if (!basePath) return path;\n  let result = path;\n  for (let i = 0; i < 4; i += 1) {\n    if (result === basePath) return \"/\";\n    if (result.startsWith(`${basePath}/`)) {\n      result = result.slice(basePath.length) || \"/\";\n      continue;\n    }\n    if (\n      result.startsWith(`${basePath}?`) ||\n      result.startsWith(`${basePath}#`)\n    ) {\n      result = `/${result.slice(basePath.length)}`;\n      continue;\n    }\n    break;\n  }\n  return result;\n}\n\nfunction pathnameFromLocalPath(path: string): string {\n  return path.split(/[?#]/, 1)[0] || \"/\";\n}\n\nfunction isFrameworkOrApiPath(pathname: string): boolean {\n  return (\n    pathname === \"/_agent-native\" ||\n    pathname.startsWith(\"/_agent-native/\") ||\n    pathname === \"/api\" ||\n    pathname.startsWith(\"/api/\")\n  );\n}\n\nfunction isStaticAssetPath(pathname: string): boolean {\n  const lastSegment = pathname.split(\"/\").pop() ?? \"\";\n  return /\\.[A-Za-z0-9]{1,12}$/.test(lastSegment);\n}\n\nfunction localPathFromAnchor(anchor: HTMLAnchorElement): string | null {\n  if (!anchor.href) return null;\n  try {\n    const url = new URL(anchor.href);\n    if (url.origin !== window.location.origin) return null;\n    return stripBasePath(`${url.pathname}${url.search}${url.hash}`);\n  } catch {\n    return null;\n  }\n}\n\nfunction shouldHandleAnchorClick(\n  event: MouseEvent,\n  anchor: HTMLAnchorElement,\n): boolean {\n  if (event.defaultPrevented || event.button !== 0) return false;\n  if (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) {\n    return false;\n  }\n  if (anchor.target && anchor.target !== \"_self\") return false;\n  if (anchor.hasAttribute(\"download\")) return false;\n  return true;\n}\n\n/**\n * Returns true for the route that has just received a full-page-chat handoff.\n * Pass the result to `AgentSidebar openOnChatRunning`.\n */\nexport function useAgentChatHomeHandoff({\n  storageKey,\n  activePath,\n  enabled = true,\n}: UseAgentChatHomeHandoffOptions): boolean {\n  const [handoffPath, setHandoffPath] = useState<string | null>(null);\n\n  useEffect(() => {\n    if (!enabled) {\n      setHandoffPath(null);\n      return;\n    }\n    if (consumeAgentChatHomeHandoff(storageKey)) {\n      setHandoffPath(activePath);\n    }\n  }, [activePath, enabled, storageKey]);\n\n  return enabled && handoffPath === activePath;\n}\n\n/**\n * Intercepts ordinary in-app links clicked from a full-page chat route so the\n * page chat can morph into the destination AgentSidebar and keep its thread.\n */\nexport function useAgentChatHomeHandoffLinks({\n  storageKey,\n  chatPath = \"/\",\n  enabled = true,\n}: UseAgentChatHomeHandoffLinksOptions): void {\n  const location = useLocation();\n  const navigate = useNavigate();\n\n  useEffect(() => {\n    if (!enabled || stripBasePath(location.pathname) !== chatPath) return;\n    if (typeof document === \"undefined\") return;\n\n    function handleClick(event: MouseEvent) {\n      const target = event.target;\n      if (!(target instanceof Element)) return;\n      const anchor = target.closest(\"a[href]\");\n      if (!(anchor instanceof HTMLAnchorElement)) return;\n      if (!shouldHandleAnchorClick(event, anchor)) return;\n      if (anchor.closest(\".agent-panel-root\")) return;\n\n      const path = localPathFromAnchor(anchor);\n      const pathname = path ? pathnameFromLocalPath(path) : \"\";\n      if (\n        !path ||\n        pathname === chatPath ||\n        isFrameworkOrApiPath(pathname) ||\n        isStaticAssetPath(pathname)\n      ) {\n        return;\n      }\n\n      event.preventDefault();\n      markAgentChatHomeHandoff(storageKey);\n      navigateWithAgentChatViewTransition(navigate, path);\n    }\n\n    document.addEventListener(\"click\", handleClick, true);\n    return () => document.removeEventListener(\"click\", handleClick, true);\n  }, [chatPath, enabled, location.pathname, navigate, storageKey]);\n}\n"]}
+{"version":3,"file":"use-agent-chat-home-handoff.js","sourceRoot":"","sources":["../../src/client/use-agent-chat-home-handoff.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport { useLocation, useNavigate } from \"react-router\";\nimport { appBasePath } from \"./api-path.js\";\nimport {\n  consumeAgentChatHomeHandoff,\n  markAgentChatHomeHandoff,\n  navigateWithAgentChatViewTransition,\n} from \"./chat-view-transition.js\";\n\nexport interface UseAgentChatHomeHandoffOptions {\n  /** Namespace shared by the full-page chat and AgentSidebar surfaces. */\n  storageKey?: string | null;\n  /** The current destination path that receives the sidebar handoff. */\n  activePath: string;\n  /** Disable consumption without changing hook call order. */\n  enabled?: boolean;\n}\n\nexport interface UseAgentChatHomeHandoffLinksOptions {\n  /** Namespace shared by the full-page chat and AgentSidebar surfaces. */\n  storageKey?: string | null;\n  /** Router-local path for the full-page chat route. Defaults to \"/\". */\n  chatPath?: string;\n  /**\n   * Matches every router-local pathname owned by the full-page chat surface.\n   * Defaults to an exact match against `chatPath`. Pass this to cover deep\n   * links such as `/chat/:threadId`.\n   */\n  isChatPath?: (pathname: string) => boolean;\n  /** Disable link interception without changing hook call order. */\n  enabled?: boolean;\n}\n\nfunction stripBasePath(path: string): string {\n  const basePath = appBasePath();\n  if (!basePath) return path;\n  let result = path;\n  for (let i = 0; i < 4; i += 1) {\n    if (result === basePath) return \"/\";\n    if (result.startsWith(`${basePath}/`)) {\n      result = result.slice(basePath.length) || \"/\";\n      continue;\n    }\n    if (\n      result.startsWith(`${basePath}?`) ||\n      result.startsWith(`${basePath}#`)\n    ) {\n      result = `/${result.slice(basePath.length)}`;\n      continue;\n    }\n    break;\n  }\n  return result;\n}\n\nfunction pathnameFromLocalPath(path: string): string {\n  return path.split(/[?#]/, 1)[0] || \"/\";\n}\n\nfunction isFrameworkOrApiPath(pathname: string): boolean {\n  return (\n    pathname === \"/_agent-native\" ||\n    pathname.startsWith(\"/_agent-native/\") ||\n    pathname === \"/api\" ||\n    pathname.startsWith(\"/api/\")\n  );\n}\n\nfunction isStaticAssetPath(pathname: string): boolean {\n  const lastSegment = pathname.split(\"/\").pop() ?? \"\";\n  return /\\.[A-Za-z0-9]{1,12}$/.test(lastSegment);\n}\n\nfunction localPathFromAnchor(anchor: HTMLAnchorElement): string | null {\n  if (!anchor.href) return null;\n  try {\n    const url = new URL(anchor.href);\n    if (url.origin !== window.location.origin) return null;\n    return stripBasePath(`${url.pathname}${url.search}${url.hash}`);\n  } catch {\n    return null;\n  }\n}\n\nfunction shouldHandleAnchorClick(\n  event: MouseEvent,\n  anchor: HTMLAnchorElement,\n): boolean {\n  if (event.defaultPrevented || event.button !== 0) return false;\n  if (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) {\n    return false;\n  }\n  if (anchor.target && anchor.target !== \"_self\") return false;\n  if (anchor.hasAttribute(\"download\")) return false;\n  return true;\n}\n\n/**\n * Returns true for the route that has just received a full-page-chat handoff.\n * Pass the result to `AgentSidebar openOnChatRunning`.\n */\nexport function useAgentChatHomeHandoff({\n  storageKey,\n  activePath,\n  enabled = true,\n}: UseAgentChatHomeHandoffOptions): boolean {\n  const [handoffPath, setHandoffPath] = useState<string | null>(null);\n\n  useEffect(() => {\n    if (!enabled) {\n      setHandoffPath(null);\n      return;\n    }\n    if (consumeAgentChatHomeHandoff(storageKey)) {\n      setHandoffPath(activePath);\n    }\n  }, [activePath, enabled, storageKey]);\n\n  return enabled && handoffPath === activePath;\n}\n\n/**\n * Intercepts ordinary in-app links clicked from a full-page chat route so the\n * page chat can morph into the destination AgentSidebar and keep its thread.\n */\nexport function useAgentChatHomeHandoffLinks({\n  storageKey,\n  chatPath = \"/\",\n  isChatPath,\n  enabled = true,\n}: UseAgentChatHomeHandoffLinksOptions): void {\n  const location = useLocation();\n  const navigate = useNavigate();\n  const matchesChatPathRef = useRef<(pathname: string) => boolean>(() => false);\n  matchesChatPathRef.current =\n    isChatPath ?? ((pathname: string) => pathname === chatPath);\n\n  useEffect(() => {\n    const matchesChatPath = (pathname: string) =>\n      matchesChatPathRef.current(pathname);\n    if (!enabled || !matchesChatPath(stripBasePath(location.pathname))) return;\n    if (typeof document === \"undefined\") return;\n\n    function handleClick(event: MouseEvent) {\n      const target = event.target;\n      if (!(target instanceof Element)) return;\n      const anchor = target.closest(\"a[href]\");\n      if (!(anchor instanceof HTMLAnchorElement)) return;\n      if (!shouldHandleAnchorClick(event, anchor)) return;\n      if (anchor.closest(\".agent-panel-root\")) return;\n\n      const path = localPathFromAnchor(anchor);\n      const pathname = path ? pathnameFromLocalPath(path) : \"\";\n      if (\n        !path ||\n        matchesChatPath(pathname) ||\n        isFrameworkOrApiPath(pathname) ||\n        isStaticAssetPath(pathname)\n      ) {\n        return;\n      }\n\n      event.preventDefault();\n      markAgentChatHomeHandoff(storageKey);\n      navigateWithAgentChatViewTransition(navigate, path);\n    }\n\n    document.addEventListener(\"click\", handleClick, true);\n    return () => document.removeEventListener(\"click\", handleClick, true);\n  }, [enabled, location.pathname, navigate, storageKey]);\n}\n"]}

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

@@ -49,6 +49,12 @@ export interface UseChatThreadsOptions {
     autoCreate?: boolean;
     /** Restore the active thread from localStorage. Defaults to true. */
     restoreActiveThread?: boolean;
+    /**
+     * Route-owned active thread. `undefined` preserves the legacy localStorage
+     * source of truth; a string opens that thread; `null` means the URL is in
+     * create/new-chat mode.
+     */
+    routeThreadId?: string | null;
 }
 export declare function useChatThreads(apiUrl?: string, storageKey?: string, scope?: ChatThreadScope | null, options?: UseChatThreadsOptions): {
     threads: ChatThreadSummary[];

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":"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"}
+{"version":3,"file":"use-chat-threads.d.ts","sourceRoot":"","sources":["../../src/client/use-chat-threads.ts"],"names":[],"mappings":"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"}

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

@@ -42,6 +42,12 @@ function createLocalThreadId() {
     }
     return `thread-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
 }
+function normalizeThreadId(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed || null;
+}
 function scopesMatch(a, b) {
     if (!a || !b)
         return false;
@@ -69,6 +75,8 @@ function nextThreadTitle(currentTitle, incomingTitle, incomingPreview, source =
 export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-chat"), storageKey, scope, options) {
     const autoCreate = options?.autoCreate !== false;
     const restoreActiveThread = options?.restoreActiveThread !== false;
+    const routeControlsActiveThread = options?.routeThreadId !== undefined;
+    const routeThreadId = normalizeThreadId(options?.routeThreadId);
     // Each (storageKey, scope) pair gets its own active-thread localStorage key
     // for chats that belong to a resource. General chats keep using the unscoped
     // key even while the user is looking at a resource, so clicking into a deck,
@@ -88,11 +96,18 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
         let id = null;
         let isNew = false;
         if (typeof window !== "undefined") {
-            try {
-                id = restoreActiveThread ? localStorage.getItem(activeThreadKey) : null;
+            if (routeControlsActiveThread) {
+                id = routeThreadId;
             }
-            catch {
-                id = null;
+            else {
+                try {
+                    id = restoreActiveThread
+                        ? localStorage.getItem(activeThreadKey)
+                        : null;
+                }
+                catch {
+                    id = null;
+                }
             }
             if (!id && autoCreate) {
                 id = createLocalThreadId();
@@ -204,6 +219,10 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
     const persistedKeyRef = useRef(activeThreadKey);
     useEffect(() => {
         if (persistedKeyRef.current !== activeThreadKey) {
+            if (routeControlsActiveThread) {
+                persistedKeyRef.current = activeThreadKey;
+                return;
+            }
             const currentId = activeThreadIdRef.current;
             if (currentId) {
                 const currentThreadScope = readKnownThreadScope(currentId);
@@ -239,6 +258,11 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
             return;
         }
         try {
+            if (routeControlsActiveThread && !routeThreadId) {
+                localStorage.removeItem(activeThreadKey);
+                localStorage.removeItem(activeThreadSeenKey);
+                return;
+            }
             if (activeThreadId) {
                 const threadScope = readKnownThreadScope(activeThreadId);
                 if (threadScope === undefined)
@@ -260,6 +284,8 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
         addOptimisticThread,
         autoCreate,
         readKnownThreadScope,
+        routeControlsActiveThread,
+        routeThreadId,
         storageKey,
         threads,
     ]);
@@ -365,11 +391,20 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
                 return;
             }
             const loadedHasSavedId = Boolean(savedId && loadedThreads.some((t) => t.id === savedId));
+            const savedIdCameFromRoute = Boolean(savedId) &&
+                routeControlsActiveThread &&
+                routeThreadId === savedId;
             if (savedId &&
                 newlyCreatedRef.current.has(savedId) &&
                 !loadedHasSavedId) {
                 addOptimisticThread(savedId, scopeRef.current ?? null);
             }
+            else if (savedId && savedIdCameFromRoute && !loadedHasSavedId) {
+                // A deep link may point to a thread that is not in the current list
+                // response. Keep it route-owned so AssistantChat can restore it via
+                // /threads/:id instead of reclassifying it as a new empty tab.
+                setActiveThreadId(savedId);
+            }
             else if (savedId &&
                 !newlyCreatedRef.current.has(savedId) &&
                 !loadedHasSavedId) {
@@ -406,7 +441,13 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
             }
             setIsLoading(false);
         })();
-    }, [fetchThreads, addOptimisticThread, autoCreate]);
+    }, [
+        fetchThreads,
+        addOptimisticThread,
+        autoCreate,
+        routeControlsActiveThread,
+        routeThreadId,
+    ]);
     const createThread = useCallback((preferredId) => {
         // Generate ID client-side for instant UI response. No POST — the
         // server creates the row when the user actually sends a message,
@@ -418,6 +459,39 @@ export function useChatThreads(apiUrl = agentNativePath("/_agent-native/agent-ch
         setActiveThreadId(id);
         return Promise.resolve(id);
     }, [addOptimisticThread]);
+    useEffect(() => {
+        if (!routeControlsActiveThread)
+            return;
+        if (routeThreadId) {
+            if (activeThreadIdRef.current !== routeThreadId) {
+                setActiveThreadId(routeThreadId);
+            }
+            return;
+        }
+        const currentId = activeThreadIdRef.current;
+        const currentThread = currentId
+            ? threadsRef.current.find((thread) => thread.id === currentId)
+            : undefined;
+        const currentIsUnsavedNewThread = currentId !== null &&
+            newlyCreatedRef.current.has(currentId) &&
+            (currentThread?.messageCount ?? 0) === 0;
+        if (currentIsUnsavedNewThread)
+            return;
+        if (!autoCreate) {
+            if (currentId !== null)
+                setActiveThreadId(null);
+            return;
+        }
+        const id = createLocalThreadId();
+        newlyCreatedRef.current.add(id);
+        addOptimisticThread(id, scopeRef.current ?? null);
+        setActiveThreadId(id);
+    }, [
+        addOptimisticThread,
+        autoCreate,
+        routeControlsActiveThread,
+        routeThreadId,
+    ]);
     // 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