@agent-native/core 0.108.0 → 0.109.0

package/dist/client/agent-sidebar-state.d.ts

@@ -1,3 +1,4 @@
+export { hasChatThreadDeepLink } from "./chat-thread-url.js";
 export declare const SIDEBAR_OPEN_KEY = "agent-native-sidebar-open";
 export declare const SIDEBAR_STATE_CHANGE_EVENT = "agent-panel:state-change";
 export declare const SIDEBAR_URL_CHANGE_EVENT = "agent-panel:url-change";

package/dist/client/agent-sidebar-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-sidebar-state.d.ts","sourceRoot":"","sources":["../../src/client/agent-sidebar-state.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAC5D,eAAO,MAAM,0BAA0B,6BAA6B,CAAC;AACrE,eAAO,MAAM,wBAAwB,2BAA2B,CAAC;AAIjE,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,OAAO,CAAC;AACtD,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,6BAA6B;IAC5C,oDAAoD;IACpD,IAAI,EAAE,OAAO,CAAC;IACd,kDAAkD;IAClD,MAAM,EAAE,uBAAuB,CAAC;IAChC,uEAAuE;IACvE,IAAI,EAAE,qBAAqB,CAAC;CAC7B;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,MAAM,CAGR;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,6BAA6B,GACpC,IAAI,CAON;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,OAAO,EACb,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,IAAI,CAQN;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C;AAED,wBAAgB,8BAA8B,IAAI,OAAO,GAAG,IAAI,CAQ/D;AAED,wBAAgB,kCAAkC,CAChD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,GAAG,IAAI,CAiBhB;AA8BD,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,IAAI,GACnB,MAAM,IAAI,CAaZ;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,OAAO,EACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,CAuBT"}
+{"version":3,"file":"agent-sidebar-state.d.ts","sourceRoot":"","sources":["../../src/client/agent-sidebar-state.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAC5D,eAAO,MAAM,0BAA0B,6BAA6B,CAAC;AACrE,eAAO,MAAM,wBAAwB,2BAA2B,CAAC;AAIjE,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,OAAO,CAAC;AACtD,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,6BAA6B;IAC5C,oDAAoD;IACpD,IAAI,EAAE,OAAO,CAAC;IACd,kDAAkD;IAClD,MAAM,EAAE,uBAAuB,CAAC;IAChC,uEAAuE;IACvE,IAAI,EAAE,qBAAqB,CAAC;CAC7B;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,MAAM,CAGR;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,6BAA6B,GACpC,IAAI,CAON;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,OAAO,EACb,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,IAAI,CAQN;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C;AAED,wBAAgB,8BAA8B,IAAI,OAAO,GAAG,IAAI,CAQ/D;AAED,wBAAgB,kCAAkC,CAChD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,GAAG,IAAI,CAiBhB;AA8BD,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,IAAI,GACnB,MAAM,IAAI,CAaZ;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,OAAO,EACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,CAwBT"}

package/dist/client/agent-sidebar-state.js

@@ -1,4 +1,6 @@
 import { AGENT_SIDEBAR_QUERY_PARAM, AGENT_SIDEBAR_QUERY_VALUE_CLOSED, } from "../shared/agent-sidebar-url.js";
+import { hasChatThreadDeepLink } from "./chat-thread-url.js";
+export { hasChatThreadDeepLink } from "./chat-thread-url.js";
 export const SIDEBAR_OPEN_KEY = "agent-native-sidebar-open";
 export const SIDEBAR_STATE_CHANGE_EVENT = "agent-panel:state-change";
 export const SIDEBAR_URL_CHANGE_EVENT = "agent-panel:url-change";
@@ -94,6 +96,8 @@ export function getInitialAgentSidebarOpen(defaultOpen, storageKey) {
     const urlOverride = getAgentSidebarUrlOpenOverride();
     if (urlOverride !== null)
         return urlOverride;
+    if (hasChatThreadDeepLink())
+        return true;
     // On mobile viewports the sidebar would cover most of the screen, so
     // always start closed regardless of any persisted desktop preference.
     if (typeof window !== "undefined" &&

package/dist/client/agent-sidebar-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-sidebar-state.js","sourceRoot":"","sources":["../../src/client/agent-sidebar-state.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  AGENT_SIDEBAR_QUERY_PARAM,\n  AGENT_SIDEBAR_QUERY_VALUE_CLOSED,\n} from \"../shared/agent-sidebar-url.js\";\n\nexport const SIDEBAR_OPEN_KEY = \"agent-native-sidebar-open\";\nexport const SIDEBAR_STATE_CHANGE_EVENT = \"agent-panel:state-change\";\nexport const SIDEBAR_URL_CHANGE_EVENT = \"agent-panel:url-change\";\n\nconst HISTORY_PATCHED_KEY = \"__agentNativeSidebarHistoryPatched\";\n\nexport type AgentSidebarStateSource = \"app\" | \"frame\";\nexport type AgentSidebarStateMode = \"app\" | \"code\";\n\nexport interface AgentSidebarStateChangeDetail {\n  /** Whether the user-visible agent panel is open. */\n  open: boolean;\n  /** Which surface owns the visible agent panel. */\n  source: AgentSidebarStateSource;\n  /** Frame protocol mode: \"code\" is parent-owned, \"app\" is app-owned. */\n  mode: AgentSidebarStateMode;\n}\n\nexport function getAgentSidebarOpenPreferenceKey(\n  storageKey?: string | null,\n): string {\n  const suffix = storageKey?.trim();\n  return suffix ? `agent-native.${suffix}.sidebar-open` : SIDEBAR_OPEN_KEY;\n}\n\nexport function dispatchAgentSidebarStateChange(\n  detail: AgentSidebarStateChangeDetail,\n): void {\n  if (typeof window === \"undefined\") return;\n  window.dispatchEvent(\n    new CustomEvent<AgentSidebarStateChangeDetail>(SIDEBAR_STATE_CHANGE_EVENT, {\n      detail,\n    }),\n  );\n}\n\nexport function setAgentSidebarOpenPreference(\n  open: boolean,\n  storageKey?: string | null,\n): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    localStorage.setItem(\n      getAgentSidebarOpenPreferenceKey(storageKey),\n      String(open),\n    );\n  } catch {}\n}\n\nexport function requestAgentSidebarOpen(): void {\n  if (typeof window === \"undefined\") return;\n  window.dispatchEvent(new CustomEvent(\"agent-panel:open\"));\n}\n\nexport function getAgentSidebarUrlOpenOverride(): boolean | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    const url = new URL(window.location.href);\n    const value = url.searchParams.get(AGENT_SIDEBAR_QUERY_PARAM);\n    if (value === AGENT_SIDEBAR_QUERY_VALUE_CLOSED) return false;\n  } catch {}\n  return null;\n}\n\nexport function consumeAgentSidebarUrlOpenOverride(\n  storageKey?: string | null,\n): boolean | null {\n  const override = getAgentSidebarUrlOpenOverride();\n  if (override === null || typeof window === \"undefined\") return override;\n\n  setAgentSidebarOpenPreference(override, storageKey);\n\n  try {\n    const url = new URL(window.location.href);\n    url.searchParams.delete(AGENT_SIDEBAR_QUERY_PARAM);\n    window.history.replaceState(\n      window.history.state,\n      \"\",\n      `${url.pathname}${url.search}${url.hash}`,\n    );\n  } catch {}\n\n  return override;\n}\n\nfunction emitSidebarUrlChange(): void {\n  if (typeof window === \"undefined\") return;\n  window.dispatchEvent(new Event(SIDEBAR_URL_CHANGE_EVENT));\n}\n\nfunction installSidebarUrlChangeEvents(): void {\n  if (typeof window === \"undefined\") return;\n  const historyWithFlag = window.history as History & {\n    [HISTORY_PATCHED_KEY]?: boolean;\n  };\n  if (historyWithFlag[HISTORY_PATCHED_KEY]) return;\n\n  const pushState = window.history.pushState;\n  const replaceState = window.history.replaceState;\n\n  window.history.pushState = function pushStateWithSidebarEvent(...args) {\n    const result = pushState.apply(this, args);\n    emitSidebarUrlChange();\n    return result;\n  };\n  window.history.replaceState = function replaceStateWithSidebarEvent(...args) {\n    const result = replaceState.apply(this, args);\n    emitSidebarUrlChange();\n    return result;\n  };\n  historyWithFlag[HISTORY_PATCHED_KEY] = true;\n}\n\nexport function subscribeAgentSidebarUrlChanges(\n  listener: () => void,\n): () => void {\n  if (typeof window === \"undefined\") return () => {};\n\n  installSidebarUrlChangeEvents();\n  window.addEventListener(SIDEBAR_URL_CHANGE_EVENT, listener);\n  window.addEventListener(\"popstate\", listener);\n  window.addEventListener(\"hashchange\", listener);\n\n  return () => {\n    window.removeEventListener(SIDEBAR_URL_CHANGE_EVENT, listener);\n    window.removeEventListener(\"popstate\", listener);\n    window.removeEventListener(\"hashchange\", listener);\n  };\n}\n\nexport function getInitialAgentSidebarOpen(\n  defaultOpen: boolean,\n  storageKey?: string | null,\n): boolean {\n  const urlOverride = getAgentSidebarUrlOpenOverride();\n  if (urlOverride !== null) return urlOverride;\n\n  // On mobile viewports the sidebar would cover most of the screen, so\n  // always start closed regardless of any persisted desktop preference.\n  if (\n    typeof window !== \"undefined\" &&\n    window.matchMedia(\"(max-width: 767px)\").matches\n  ) {\n    return false;\n  }\n\n  try {\n    const saved = localStorage.getItem(\n      getAgentSidebarOpenPreferenceKey(storageKey),\n    );\n    if (saved === \"false\") return false;\n    // Never let durable storage turn on a sidebar that is default-closed.\n    // Programmatic chat handoffs open the current sidebar transiently instead.\n    if (defaultOpen && saved === \"true\") return true;\n  } catch {}\n  return defaultOpen;\n}\n"]}
+{"version":3,"file":"agent-sidebar-state.js","sourceRoot":"","sources":["../../src/client/agent-sidebar-state.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  AGENT_SIDEBAR_QUERY_PARAM,\n  AGENT_SIDEBAR_QUERY_VALUE_CLOSED,\n} from \"../shared/agent-sidebar-url.js\";\nimport { hasChatThreadDeepLink } from \"./chat-thread-url.js\";\n\nexport { hasChatThreadDeepLink } from \"./chat-thread-url.js\";\n\nexport const SIDEBAR_OPEN_KEY = \"agent-native-sidebar-open\";\nexport const SIDEBAR_STATE_CHANGE_EVENT = \"agent-panel:state-change\";\nexport const SIDEBAR_URL_CHANGE_EVENT = \"agent-panel:url-change\";\n\nconst HISTORY_PATCHED_KEY = \"__agentNativeSidebarHistoryPatched\";\n\nexport type AgentSidebarStateSource = \"app\" | \"frame\";\nexport type AgentSidebarStateMode = \"app\" | \"code\";\n\nexport interface AgentSidebarStateChangeDetail {\n  /** Whether the user-visible agent panel is open. */\n  open: boolean;\n  /** Which surface owns the visible agent panel. */\n  source: AgentSidebarStateSource;\n  /** Frame protocol mode: \"code\" is parent-owned, \"app\" is app-owned. */\n  mode: AgentSidebarStateMode;\n}\n\nexport function getAgentSidebarOpenPreferenceKey(\n  storageKey?: string | null,\n): string {\n  const suffix = storageKey?.trim();\n  return suffix ? `agent-native.${suffix}.sidebar-open` : SIDEBAR_OPEN_KEY;\n}\n\nexport function dispatchAgentSidebarStateChange(\n  detail: AgentSidebarStateChangeDetail,\n): void {\n  if (typeof window === \"undefined\") return;\n  window.dispatchEvent(\n    new CustomEvent<AgentSidebarStateChangeDetail>(SIDEBAR_STATE_CHANGE_EVENT, {\n      detail,\n    }),\n  );\n}\n\nexport function setAgentSidebarOpenPreference(\n  open: boolean,\n  storageKey?: string | null,\n): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    localStorage.setItem(\n      getAgentSidebarOpenPreferenceKey(storageKey),\n      String(open),\n    );\n  } catch {}\n}\n\nexport function requestAgentSidebarOpen(): void {\n  if (typeof window === \"undefined\") return;\n  window.dispatchEvent(new CustomEvent(\"agent-panel:open\"));\n}\n\nexport function getAgentSidebarUrlOpenOverride(): boolean | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    const url = new URL(window.location.href);\n    const value = url.searchParams.get(AGENT_SIDEBAR_QUERY_PARAM);\n    if (value === AGENT_SIDEBAR_QUERY_VALUE_CLOSED) return false;\n  } catch {}\n  return null;\n}\n\nexport function consumeAgentSidebarUrlOpenOverride(\n  storageKey?: string | null,\n): boolean | null {\n  const override = getAgentSidebarUrlOpenOverride();\n  if (override === null || typeof window === \"undefined\") return override;\n\n  setAgentSidebarOpenPreference(override, storageKey);\n\n  try {\n    const url = new URL(window.location.href);\n    url.searchParams.delete(AGENT_SIDEBAR_QUERY_PARAM);\n    window.history.replaceState(\n      window.history.state,\n      \"\",\n      `${url.pathname}${url.search}${url.hash}`,\n    );\n  } catch {}\n\n  return override;\n}\n\nfunction emitSidebarUrlChange(): void {\n  if (typeof window === \"undefined\") return;\n  window.dispatchEvent(new Event(SIDEBAR_URL_CHANGE_EVENT));\n}\n\nfunction installSidebarUrlChangeEvents(): void {\n  if (typeof window === \"undefined\") return;\n  const historyWithFlag = window.history as History & {\n    [HISTORY_PATCHED_KEY]?: boolean;\n  };\n  if (historyWithFlag[HISTORY_PATCHED_KEY]) return;\n\n  const pushState = window.history.pushState;\n  const replaceState = window.history.replaceState;\n\n  window.history.pushState = function pushStateWithSidebarEvent(...args) {\n    const result = pushState.apply(this, args);\n    emitSidebarUrlChange();\n    return result;\n  };\n  window.history.replaceState = function replaceStateWithSidebarEvent(...args) {\n    const result = replaceState.apply(this, args);\n    emitSidebarUrlChange();\n    return result;\n  };\n  historyWithFlag[HISTORY_PATCHED_KEY] = true;\n}\n\nexport function subscribeAgentSidebarUrlChanges(\n  listener: () => void,\n): () => void {\n  if (typeof window === \"undefined\") return () => {};\n\n  installSidebarUrlChangeEvents();\n  window.addEventListener(SIDEBAR_URL_CHANGE_EVENT, listener);\n  window.addEventListener(\"popstate\", listener);\n  window.addEventListener(\"hashchange\", listener);\n\n  return () => {\n    window.removeEventListener(SIDEBAR_URL_CHANGE_EVENT, listener);\n    window.removeEventListener(\"popstate\", listener);\n    window.removeEventListener(\"hashchange\", listener);\n  };\n}\n\nexport function getInitialAgentSidebarOpen(\n  defaultOpen: boolean,\n  storageKey?: string | null,\n): boolean {\n  const urlOverride = getAgentSidebarUrlOpenOverride();\n  if (urlOverride !== null) return urlOverride;\n  if (hasChatThreadDeepLink()) return true;\n\n  // On mobile viewports the sidebar would cover most of the screen, so\n  // always start closed regardless of any persisted desktop preference.\n  if (\n    typeof window !== \"undefined\" &&\n    window.matchMedia(\"(max-width: 767px)\").matches\n  ) {\n    return false;\n  }\n\n  try {\n    const saved = localStorage.getItem(\n      getAgentSidebarOpenPreferenceKey(storageKey),\n    );\n    if (saved === \"false\") return false;\n    // Never let durable storage turn on a sidebar that is default-closed.\n    // Programmatic chat handoffs open the current sidebar transiently instead.\n    if (defaultOpen && saved === \"true\") return true;\n  } catch {}\n  return defaultOpen;\n}\n"]}

package/dist/client/analytics.d.ts

@@ -142,6 +142,20 @@ export declare function captureClientException(error: unknown, context?: ClientC
  * is configured; otherwise this is a quiet no-op.
  */
 export declare function captureError(error: unknown, context?: ClientCaptureContext): string | undefined;
+export type AgentChatLifecycleEvent = {
+    phase: "surface-mounted" | "run-observed" | "run-stopped";
+    surface?: string;
+    threadId?: string;
+    runId?: string;
+    tabId?: string;
+};
+/**
+ * Record a content-free, browser-session-linked chat lifecycle marker and add
+ * the same marker to session replay when replay is configured. The bounded
+ * global de-dupe survives React Strict Mode remounts without retaining keys
+ * forever.
+ */
+export declare function trackAgentChatLifecycle(input: AgentChatLifecycleEvent): void;
 export declare function configureTracking(options: ConfigureTrackingOptions): void;
 export declare function setTrackingContentCaptureEnabled(enabled: boolean): void;
 export declare function startSessionReplay(options?: SessionReplayOptions): Promise<SessionReplayStartResult>;

package/dist/client/analytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/client/analytics.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;QAChC,uBAAuB,CAAC,EAAE;YACxB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B,CAAC;KACH;CACF;AAED,KAAK,eAAe,GAAG,CACrB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAO7B;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,2DAA2D;IAC3D,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uEAAuE;IACvE,qBAAqB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IACtD;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAAC;IAC/C;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,yBAAyB,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAuCF;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,eAAe,CAAC;AAiC9D,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuND,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,SAAS,CAE5D;AAMD,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAE1D;AA4HD;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,GAAG,IAAI,CAavE;AAsUD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,oBAAoB,GAAG,IAAI,EACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,IAAI,CAqCN;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,oBAAoB,GAAG,IAAI,EACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,IAAI,CAEN;AAED,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1C;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,oBAAyB,GACjC,MAAM,GAAG,SAAS,CAyBpB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,oBAAyB,GACjC,MAAM,GAAG,SAAS,CAEpB;AAeD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAuCzE;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUvE;AA0TD,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAenC;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAcnC;AAED,wBAAsB,iBAAiB,CAAC,MAAM,SAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxE;AA4MD,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CASN;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAE1D"}
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/client/analytics.ts"],"names":[],"mappings":"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"}

package/dist/client/analytics.js

@@ -41,6 +41,9 @@ const AGENT_NATIVE_ANALYTICS_DEFAULT_ENDPOINT = "https://analytics.agent-native.
  */
 export const AGENT_NATIVE_EXCEPTION_EVENT_NAME = "$exception";
 const PAGEVIEW_TRACKING_STATE_KEY = Symbol.for("agent-native.client.pageviewTracking");
+const AGENT_CHAT_TRACKING_STATE_KEY = Symbol.for("agent-native.client.agentChatTracking");
+const AGENT_CHAT_LIFECYCLE_DEDUPE_TTL_MS = 10 * 60 * 1_000;
+const MAX_AGENT_CHAT_LIFECYCLE_DEDUPE_KEYS = 1_000;
 const LLM_CONNECTION_STORAGE_KEY = "agent-native.llm_connection_status";
 const LLM_CONNECTION_CACHE_TTL_MS = 5 * 60 * 1000;
 // First-touch referral attribution (viral attribution). Captured once on the
@@ -807,6 +810,70 @@ function getPageviewTrackingState() {
     }
     return g[PAGEVIEW_TRACKING_STATE_KEY];
 }
+function getAgentChatTrackingState() {
+    const g = globalThis;
+    if (!g[AGENT_CHAT_TRACKING_STATE_KEY]) {
+        g[AGENT_CHAT_TRACKING_STATE_KEY] = { seen: new Map() };
+    }
+    return g[AGENT_CHAT_TRACKING_STATE_KEY];
+}
+/**
+ * Record a content-free, browser-session-linked chat lifecycle marker and add
+ * the same marker to session replay when replay is configured. The bounded
+ * global de-dupe survives React Strict Mode remounts without retaining keys
+ * forever.
+ */
+export function trackAgentChatLifecycle(input) {
+    if (typeof window === "undefined")
+        return;
+    const surface = input.surface?.trim() || "app";
+    const dedupeKey = [
+        input.phase,
+        surface,
+        input.threadId ?? "",
+        input.runId ?? "",
+        input.tabId ?? "",
+    ].join(":");
+    const state = getAgentChatTrackingState();
+    const now = Date.now();
+    for (const [key, seenAt] of state.seen) {
+        if (now - seenAt >= AGENT_CHAT_LIFECYCLE_DEDUPE_TTL_MS) {
+            state.seen.delete(key);
+        }
+    }
+    if (state.seen.has(dedupeKey))
+        return;
+    state.seen.set(dedupeKey, now);
+    while (state.seen.size > MAX_AGENT_CHAT_LIFECYCLE_DEDUPE_KEYS) {
+        const oldestKey = state.seen.keys().next().value;
+        if (oldestKey === undefined)
+            break;
+        state.seen.delete(oldestKey);
+    }
+    void (async () => {
+        const replayResult = _sessionReplayOptions && _trackingContentCaptureEnabled
+            ? await startConfiguredSessionReplay(_sessionReplayOptions)
+            : null;
+        const properties = {
+            phase: input.phase,
+            chat_surface: surface,
+            ...(input.threadId ? { thread_id: input.threadId } : {}),
+            ...(input.runId ? { run_id: input.runId } : {}),
+            ...(input.tabId ? { chat_tab_id: input.tabId } : {}),
+            replay_status: replayResult?.started
+                ? "active"
+                : (replayResult?.reason ?? "not-configured"),
+        };
+        trackEvent("agent_chat_lifecycle", properties);
+        _sessionReplayModuleForCapture?.emitSessionReplayAgentChatEvent?.({
+            phase: input.phase,
+            surface,
+            ...(input.threadId ? { threadId: input.threadId } : {}),
+            ...(input.runId ? { runId: input.runId } : {}),
+            ...(input.tabId ? { tabId: input.tabId } : {}),
+        });
+    })();
+}
 export function configureTracking(options) {
     const publicKey = options.key || options.publicKey;
     if (publicKey) {