@copilotkit/web-inspector 1.68.3 → 1.69.1

package/dist/lib/persistence.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.cjs","names":[],"sources":["../../src/lib/persistence.ts"],"sourcesContent":["import type { Anchor, DockMode, Position, Size } from \"./types.js\";\n\nexport type PersistedContextState = {\n  anchor?: Anchor;\n  anchorOffset?: Position;\n  size?: Size;\n  hasCustomPosition?: boolean;\n};\n\nexport type PersistedState = {\n  button?: Omit<PersistedContextState, \"size\">;\n  window?: PersistedContextState;\n  isOpen?: boolean;\n  dockMode?: DockMode;\n  selectedMenu?: string;\n  selectedContext?: string;\n};\n\nexport function loadInspectorState(storageKey: string): PersistedState | null {\n  if (typeof window === \"undefined\") {\n    return null;\n  }\n\n  const raw = window.localStorage.getItem(storageKey);\n  if (raw) {\n    try {\n      const parsed = JSON.parse(raw);\n      if (parsed && typeof parsed === \"object\") {\n        return parsed as PersistedState;\n      }\n    } catch {\n      // Fall through to cookie migration path\n    }\n  }\n\n  // Backwards compatibility: try to read the legacy cookie and migrate it\n  if (typeof document !== \"undefined\") {\n    const prefix = `${storageKey}=`;\n    const entry = document.cookie\n      .split(\"; \")\n      .find((cookie) => cookie.startsWith(prefix));\n    if (entry) {\n      const legacyRaw = entry.substring(prefix.length);\n      try {\n        const parsed = JSON.parse(decodeURIComponent(legacyRaw));\n        if (parsed && typeof parsed === \"object\") {\n          return parsed as PersistedState;\n        }\n      } catch {\n        return null;\n      }\n    }\n  }\n\n  return null;\n}\n\nexport function saveInspectorState(\n  storageKey: string,\n  state: PersistedState,\n): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  try {\n    window.localStorage.setItem(storageKey, JSON.stringify(state));\n  } catch (error) {\n    console.warn(\"Failed to persist inspector state\", error);\n  }\n}\n\nexport function isValidAnchor(value: unknown): value is Anchor {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Anchor;\n  return (\n    (candidate.horizontal === \"left\" || candidate.horizontal === \"right\") &&\n    (candidate.vertical === \"top\" || candidate.vertical === \"bottom\")\n  );\n}\n\nexport function isValidPosition(value: unknown): value is Position {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Position;\n  return isFiniteNumber(candidate.x) && isFiniteNumber(candidate.y);\n}\n\nexport function isValidSize(value: unknown): value is Size {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Size;\n  return isFiniteNumber(candidate.width) && isFiniteNumber(candidate.height);\n}\n\nexport function isFiniteNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n\nexport function isValidDockMode(value: unknown): value is DockMode {\n  return value === \"floating\" || value === \"docked-left\";\n}\n\n// Telemetry persistence — flat per-key localStorage rather than the\n// JSON-blob shape used for window/dock state, because each value is\n// independent and we want to read/write them without round-tripping\n// the whole inspector state object.\nconst TELEMETRY_DISTINCT_ID_KEY = \"cpk:inspector:telemetry:distinct_id\";\nconst TELEMETRY_OPT_OUT_KEY = \"cpk:inspector:telemetry:opt_out\";\nconst TELEMETRY_DISCLOSURE_SHOWN_KEY =\n  \"cpk:inspector:telemetry:disclosure_shown\";\n\n// Module-level fallback for when localStorage is unavailable (private mode,\n// quota exceeded, etc.). Cached so that banner_viewed and banner_clicked from\n// the same page-load share one distinct_id even without persistent storage —\n// funnel coherence within a session is preserved even when storage fails.\nlet inMemoryFallbackId: string | null = null;\n\nexport function getOrCreateTelemetryDistinctId(): string {\n  if (typeof window === \"undefined\") {\n    // SSR / test fallback. A non-persistent ID is preferable to throwing\n    // because telemetry must never break the host application.\n    return generateUuidV4();\n  }\n\n  try {\n    const existing = window.localStorage.getItem(TELEMETRY_DISTINCT_ID_KEY);\n    if (existing && existing.length > 0) return existing;\n    const fresh = generateUuidV4();\n    window.localStorage.setItem(TELEMETRY_DISTINCT_ID_KEY, fresh);\n    return fresh;\n  } catch {\n    return (inMemoryFallbackId ??= generateUuidV4());\n  }\n}\n\n// Test-only reset so the in-memory fallback doesn't leak between test cases.\nexport function _resetTelemetryPersistenceForTesting(): void {\n  inMemoryFallbackId = null;\n}\n\nexport function isTelemetryOptedOut(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return window.localStorage.getItem(TELEMETRY_OPT_OUT_KEY) === \"true\";\n  } catch {\n    return false;\n  }\n}\n\nexport function setTelemetryOptOut(optedOut: boolean): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    if (optedOut) {\n      window.localStorage.setItem(TELEMETRY_OPT_OUT_KEY, \"true\");\n    } else {\n      window.localStorage.removeItem(TELEMETRY_OPT_OUT_KEY);\n    }\n  } catch {\n    // No-op — see getOrCreateTelemetryDistinctId.\n  }\n}\n\nexport function hasTelemetryDisclosureBeenShown(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return (\n      window.localStorage.getItem(TELEMETRY_DISCLOSURE_SHOWN_KEY) === \"true\"\n    );\n  } catch {\n    return false;\n  }\n}\n\nexport function markTelemetryDisclosureShown(): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(TELEMETRY_DISCLOSURE_SHOWN_KEY, \"true\");\n  } catch {\n    // No-op.\n  }\n}\n\nfunction generateUuidV4(): string {\n  if (\n    typeof globalThis.crypto !== \"undefined\" &&\n    typeof globalThis.crypto.randomUUID === \"function\"\n  ) {\n    return globalThis.crypto.randomUUID();\n  }\n  // Fallback for environments without crypto.randomUUID (older browsers,\n  // some test runners). Not cryptographically strong; acceptable because\n  // the value is just an anonymous correlation ID.\n  return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === \"x\" ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"persistence.cjs","names":[],"sources":["../../src/lib/persistence.ts"],"sourcesContent":["import type { Anchor, DockMode, Position, Size } from \"./types.js\";\n\nexport type PersistedContextState = {\n  anchor?: Anchor;\n  anchorOffset?: Position;\n  size?: Size;\n  hasCustomPosition?: boolean;\n};\n\nexport type PersistedState = {\n  button?: Omit<PersistedContextState, \"size\">;\n  window?: PersistedContextState;\n  isOpen?: boolean;\n  dockMode?: DockMode;\n  selectedMenu?: string;\n  selectedContext?: string;\n  hasOpenedInspector?: boolean;\n  sidebarCollapsed?: boolean;\n  /** @deprecated Replaced by colorSchemePreference to distinguish a user choice from the old light default. */\n  colorScheme?: \"light\" | \"dark\";\n  colorSchemePreference?: \"light\" | \"dark\";\n};\n\nexport const HOME_NEWS_READ_STORAGE_KEY = \"cpk:inspector:home-news-read\";\n\n/** Return story ids the user has already opened or hovered on Home. */\nexport function loadHomeNewsReadIds(storageKey: string): string[] {\n  if (typeof window === \"undefined\") {\n    return [];\n  }\n\n  try {\n    const raw = window.localStorage.getItem(storageKey);\n    if (!raw) {\n      return [];\n    }\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) {\n      return [];\n    }\n    return parsed.filter((id): id is string => typeof id === \"string\");\n  } catch {\n    return [];\n  }\n}\n\n/** Persist Home news story ids that the user has already seen. */\nexport function saveHomeNewsReadIds(storageKey: string, ids: string[]): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  try {\n    window.localStorage.setItem(storageKey, JSON.stringify(ids));\n  } catch (error) {\n    console.warn(\"Failed to persist Home news read state\", error);\n  }\n}\n\nexport function loadInspectorState(storageKey: string): PersistedState | null {\n  if (typeof window === \"undefined\") {\n    return null;\n  }\n\n  const raw = window.localStorage.getItem(storageKey);\n  if (raw) {\n    try {\n      const parsed = JSON.parse(raw);\n      if (parsed && typeof parsed === \"object\") {\n        return parsed as PersistedState;\n      }\n    } catch {\n      // Fall through to cookie migration path\n    }\n  }\n\n  // Backwards compatibility: try to read the legacy cookie and migrate it\n  if (typeof document !== \"undefined\") {\n    const prefix = `${storageKey}=`;\n    const entry = document.cookie\n      .split(\"; \")\n      .find((cookie) => cookie.startsWith(prefix));\n    if (entry) {\n      const legacyRaw = entry.substring(prefix.length);\n      try {\n        const parsed = JSON.parse(decodeURIComponent(legacyRaw));\n        if (parsed && typeof parsed === \"object\") {\n          return parsed as PersistedState;\n        }\n      } catch {\n        return null;\n      }\n    }\n  }\n\n  return null;\n}\n\nexport function saveInspectorState(\n  storageKey: string,\n  state: PersistedState,\n): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  try {\n    window.localStorage.setItem(storageKey, JSON.stringify(state));\n  } catch (error) {\n    console.warn(\"Failed to persist inspector state\", error);\n  }\n}\n\nexport function isValidAnchor(value: unknown): value is Anchor {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Anchor;\n  return (\n    (candidate.horizontal === \"left\" || candidate.horizontal === \"right\") &&\n    (candidate.vertical === \"top\" || candidate.vertical === \"bottom\")\n  );\n}\n\nexport function isValidPosition(value: unknown): value is Position {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Position;\n  return isFiniteNumber(candidate.x) && isFiniteNumber(candidate.y);\n}\n\nexport function isValidSize(value: unknown): value is Size {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Size;\n  return isFiniteNumber(candidate.width) && isFiniteNumber(candidate.height);\n}\n\nexport function isFiniteNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n\nexport function isValidDockMode(value: unknown): value is DockMode {\n  return value === \"floating\" || value === \"docked-left\";\n}\n\n// Announcement read state — \"have I read this announcement\" is a property of\n// the person, not of the project, so it must survive a change of localhost\n// port. localStorage cannot express that: it is partitioned by origin and\n// origin includes the port, so :3000 and :5173 are separate stores. Cookies\n// are partitioned by host, so a cookie set on `localhost` without a `domain`\n// attribute is shared by every port on that host.\n//\n// Underscores, not colons: `:` is a separator in RFC 6265 and is not valid in\n// a cookie name. Browsers are lenient about it; we don't rely on that.\nconst ANNOUNCEMENT_READ_COOKIE_NAME = \"cpk_inspector_announcements\";\n\n// localStorage mirror of the cookie, so a browser that blocks cookies\n// degrades to per-port behaviour instead of losing the read state entirely.\n// A NEW key on purpose — the legacy one is abandoned, not migrated.\nconst ANNOUNCEMENT_READ_MIRROR_KEY = \"cpk:inspector:announcement_read\";\n\n// The superseded key. Every existing user is re-armed exactly once so they\n// discover the surface that replaced the announcement bubble, and the key is\n// deleted rather than left in place so nothing can fall back to it later.\nconst LEGACY_ANNOUNCEMENT_READ_KEY = \"cpk:inspector:announcements\";\n\n// Pulse suppression is per browser tab, and stores the announcement timestamp\n// rather than a boolean: a boolean would swallow a newly published\n// announcement for the rest of that tab's life, and the feed is fetched once\n// per mount with no polling.\nconst ANNOUNCEMENT_PULSED_SESSION_KEY = \"cpk:inspector:pulsed\";\n\n// Roughly one year. No `Secure` — local development is served over plain\n// HTTP — and no `HttpOnly`, because the component reads the value from\n// script. `Path=/` and `SameSite=Lax` keep it host-wide and same-site only.\nconst ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS = 60 * 60 * 24 * 365;\n\n/**\n * The announcement timestamp the user has already read, or `null` when\n * nothing has been read yet. Prefers the host-scoped cookie and falls back to\n * the origin-scoped mirror, so cookie-blocking browsers still remember the\n * read within the port they are on.\n */\nexport function loadAnnouncementReadTimestamp(): string | null {\n  return (\n    parseTimestampPayload(readAnnouncementCookie()) ??\n    parseTimestampPayload(readLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY))\n  );\n}\n\n/**\n * Records an announcement as read in both the host-scoped cookie and the\n * origin-scoped mirror. The stored value is `{\"timestamp\":\"…\"}` — the same\n * shape the announcement state has always used.\n */\nexport function saveAnnouncementReadTimestamp(timestamp: string): void {\n  const payload = JSON.stringify({ timestamp });\n  writeAnnouncementCookie(payload);\n  writeLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY, payload);\n}\n\n/**\n * Deletes the superseded origin-scoped read state. Safe to call on every\n * startup: nothing writes that key any more, so the value cannot come back.\n */\nexport function clearLegacyAnnouncementReadState(): void {\n  removeLocalStorageItem(LEGACY_ANNOUNCEMENT_READ_KEY);\n}\n\n/**\n * The announcement timestamp this browser tab has already pulsed for, or\n * `null` when it hasn't pulsed yet.\n */\nexport function loadAnnouncementPulsedTimestamp(): string | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    return window.sessionStorage.getItem(ANNOUNCEMENT_PULSED_SESSION_KEY);\n  } catch {\n    return null;\n  }\n}\n\n/** Suppresses further pulses for this announcement in this browser tab. */\nexport function saveAnnouncementPulsedTimestamp(timestamp: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.sessionStorage.setItem(ANNOUNCEMENT_PULSED_SESSION_KEY, timestamp);\n  } catch {\n    // No-op — a lost suppression costs one extra pulse, never correctness.\n  }\n}\n\nfunction parseTimestampPayload(raw: string | null): string | null {\n  if (!raw) return null;\n  try {\n    const parsed = JSON.parse(raw) as { timestamp?: unknown };\n    return typeof parsed?.timestamp === \"string\" ? parsed.timestamp : null;\n  } catch {\n    return null;\n  }\n}\n\nfunction readAnnouncementCookie(): string | null {\n  if (typeof document === \"undefined\") return null;\n  try {\n    for (const entry of document.cookie.split(\";\")) {\n      const separator = entry.indexOf(\"=\");\n      if (separator === -1) continue;\n      if (entry.slice(0, separator).trim() !== ANNOUNCEMENT_READ_COOKIE_NAME) {\n        continue;\n      }\n      return decodeURIComponent(entry.slice(separator + 1).trim());\n    }\n  } catch {\n    // Cookie access throws in sandboxed documents — fall through to the\n    // mirror rather than breaking the host app.\n  }\n  return null;\n}\n\nfunction writeAnnouncementCookie(value: string): void {\n  if (typeof document === \"undefined\") return;\n  try {\n    document.cookie = `${ANNOUNCEMENT_READ_COOKIE_NAME}=${encodeURIComponent(\n      value,\n    )}; Path=/; Max-Age=${ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS}; SameSite=Lax`;\n  } catch {\n    // No-op — the mirror below is what a cookie-blocking browser falls back\n    // to, and neither may break the host app.\n  }\n}\n\nfunction readLocalStorageItem(key: string): string | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    return window.localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nfunction writeLocalStorageItem(key: string, value: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(key, value);\n  } catch {\n    // No-op — see getOrCreateTelemetryDistinctId.\n  }\n}\n\nfunction removeLocalStorageItem(key: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.removeItem(key);\n  } catch {\n    // No-op.\n  }\n}\n\n// Telemetry persistence — flat per-key localStorage rather than the\n// JSON-blob shape used for window/dock state, because each value is\n// independent and we want to read/write them without round-tripping\n// the whole inspector state object.\nconst TELEMETRY_DISTINCT_ID_KEY = \"cpk:inspector:telemetry:distinct_id\";\nconst TELEMETRY_OPT_OUT_KEY = \"cpk:inspector:telemetry:opt_out\";\nconst TELEMETRY_DISCLOSURE_SHOWN_KEY =\n  \"cpk:inspector:telemetry:disclosure_shown\";\n\n// Module-level fallback for when localStorage is unavailable (private mode,\n// quota exceeded, etc.). Cached so that whats_new_viewed and\n// whats_new_clicked from the same page-load share one distinct_id even\n// without persistent storage —\n// funnel coherence within a session is preserved even when storage fails.\nlet inMemoryFallbackId: string | null = null;\n\nexport function getOrCreateTelemetryDistinctId(): string {\n  if (typeof window === \"undefined\") {\n    // SSR / test fallback. A non-persistent ID is preferable to throwing\n    // because telemetry must never break the host application.\n    return generateUuidV4();\n  }\n\n  try {\n    const existing = window.localStorage.getItem(TELEMETRY_DISTINCT_ID_KEY);\n    if (existing && existing.length > 0) return existing;\n    const fresh = generateUuidV4();\n    window.localStorage.setItem(TELEMETRY_DISTINCT_ID_KEY, fresh);\n    return fresh;\n  } catch {\n    return (inMemoryFallbackId ??= generateUuidV4());\n  }\n}\n\n// Test-only reset so the in-memory fallback doesn't leak between test cases.\nexport function _resetTelemetryPersistenceForTesting(): void {\n  inMemoryFallbackId = null;\n}\n\nexport function isTelemetryOptedOut(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return window.localStorage.getItem(TELEMETRY_OPT_OUT_KEY) === \"true\";\n  } catch {\n    return false;\n  }\n}\n\nexport function setTelemetryOptOut(optedOut: boolean): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    if (optedOut) {\n      window.localStorage.setItem(TELEMETRY_OPT_OUT_KEY, \"true\");\n    } else {\n      window.localStorage.removeItem(TELEMETRY_OPT_OUT_KEY);\n    }\n  } catch {\n    // No-op — see getOrCreateTelemetryDistinctId.\n  }\n}\n\nexport function hasTelemetryDisclosureBeenShown(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return (\n      window.localStorage.getItem(TELEMETRY_DISCLOSURE_SHOWN_KEY) === \"true\"\n    );\n  } catch {\n    return false;\n  }\n}\n\nexport function markTelemetryDisclosureShown(): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(TELEMETRY_DISCLOSURE_SHOWN_KEY, \"true\");\n  } catch {\n    // No-op.\n  }\n}\n\nfunction generateUuidV4(): string {\n  if (\n    typeof globalThis.crypto !== \"undefined\" &&\n    typeof globalThis.crypto.randomUUID === \"function\"\n  ) {\n    return globalThis.crypto.randomUUID();\n  }\n  // Fallback for environments without crypto.randomUUID (older browsers,\n  // some test runners). Not cryptographically strong; acceptable because\n  // the value is just an anonymous correlation ID.\n  return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === \"x\" ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n"],"mappings":"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"}

package/dist/lib/persistence.mjs

@@ -50,6 +50,103 @@ function isFiniteNumber(value) {
 function isValidDockMode(value) {
 	return value === "floating" || value === "docked-left";
 }
+const ANNOUNCEMENT_READ_COOKIE_NAME = "cpk_inspector_announcements";
+const ANNOUNCEMENT_READ_MIRROR_KEY = "cpk:inspector:announcement_read";
+const LEGACY_ANNOUNCEMENT_READ_KEY = "cpk:inspector:announcements";
+const ANNOUNCEMENT_PULSED_SESSION_KEY = "cpk:inspector:pulsed";
+const ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS = 3600 * 24 * 365;
+/**
+* The announcement timestamp the user has already read, or `null` when
+* nothing has been read yet. Prefers the host-scoped cookie and falls back to
+* the origin-scoped mirror, so cookie-blocking browsers still remember the
+* read within the port they are on.
+*/
+function loadAnnouncementReadTimestamp() {
+	return parseTimestampPayload(readAnnouncementCookie()) ?? parseTimestampPayload(readLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY));
+}
+/**
+* Records an announcement as read in both the host-scoped cookie and the
+* origin-scoped mirror. The stored value is `{"timestamp":"…"}` — the same
+* shape the announcement state has always used.
+*/
+function saveAnnouncementReadTimestamp(timestamp) {
+	const payload = JSON.stringify({ timestamp });
+	writeAnnouncementCookie(payload);
+	writeLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY, payload);
+}
+/**
+* Deletes the superseded origin-scoped read state. Safe to call on every
+* startup: nothing writes that key any more, so the value cannot come back.
+*/
+function clearLegacyAnnouncementReadState() {
+	removeLocalStorageItem(LEGACY_ANNOUNCEMENT_READ_KEY);
+}
+/**
+* The announcement timestamp this browser tab has already pulsed for, or
+* `null` when it hasn't pulsed yet.
+*/
+function loadAnnouncementPulsedTimestamp() {
+	if (typeof window === "undefined") return null;
+	try {
+		return window.sessionStorage.getItem(ANNOUNCEMENT_PULSED_SESSION_KEY);
+	} catch {
+		return null;
+	}
+}
+/** Suppresses further pulses for this announcement in this browser tab. */
+function saveAnnouncementPulsedTimestamp(timestamp) {
+	if (typeof window === "undefined") return;
+	try {
+		window.sessionStorage.setItem(ANNOUNCEMENT_PULSED_SESSION_KEY, timestamp);
+	} catch {}
+}
+function parseTimestampPayload(raw) {
+	if (!raw) return null;
+	try {
+		const parsed = JSON.parse(raw);
+		return typeof parsed?.timestamp === "string" ? parsed.timestamp : null;
+	} catch {
+		return null;
+	}
+}
+function readAnnouncementCookie() {
+	if (typeof document === "undefined") return null;
+	try {
+		for (const entry of document.cookie.split(";")) {
+			const separator = entry.indexOf("=");
+			if (separator === -1) continue;
+			if (entry.slice(0, separator).trim() !== ANNOUNCEMENT_READ_COOKIE_NAME) continue;
+			return decodeURIComponent(entry.slice(separator + 1).trim());
+		}
+	} catch {}
+	return null;
+}
+function writeAnnouncementCookie(value) {
+	if (typeof document === "undefined") return;
+	try {
+		document.cookie = `${ANNOUNCEMENT_READ_COOKIE_NAME}=${encodeURIComponent(value)}; Path=/; Max-Age=${ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS}; SameSite=Lax`;
+	} catch {}
+}
+function readLocalStorageItem(key) {
+	if (typeof window === "undefined") return null;
+	try {
+		return window.localStorage.getItem(key);
+	} catch {
+		return null;
+	}
+}
+function writeLocalStorageItem(key, value) {
+	if (typeof window === "undefined") return;
+	try {
+		window.localStorage.setItem(key, value);
+	} catch {}
+}
+function removeLocalStorageItem(key) {
+	if (typeof window === "undefined") return;
+	try {
+		window.localStorage.removeItem(key);
+	} catch {}
+}
 const TELEMETRY_DISTINCT_ID_KEY = "cpk:inspector:telemetry:distinct_id";
 const TELEMETRY_OPT_OUT_KEY = "cpk:inspector:telemetry:opt_out";
 const TELEMETRY_DISCLOSURE_SHOWN_KEY = "cpk:inspector:telemetry:disclosure_shown";
@@ -97,5 +194,5 @@ function generateUuidV4() {
 }
 
 //#endregion
-export { getOrCreateTelemetryDistinctId, hasTelemetryDisclosureBeenShown, isTelemetryOptedOut, isValidAnchor, isValidDockMode, isValidPosition, isValidSize, loadInspectorState, markTelemetryDisclosureShown, saveInspectorState };
+export { clearLegacyAnnouncementReadState, getOrCreateTelemetryDistinctId, hasTelemetryDisclosureBeenShown, isTelemetryOptedOut, isValidAnchor, isValidDockMode, isValidPosition, isValidSize, loadAnnouncementPulsedTimestamp, loadAnnouncementReadTimestamp, loadInspectorState, markTelemetryDisclosureShown, saveAnnouncementPulsedTimestamp, saveAnnouncementReadTimestamp, saveInspectorState };
 //# sourceMappingURL=persistence.mjs.map

package/dist/lib/persistence.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.mjs","names":[],"sources":["../../src/lib/persistence.ts"],"sourcesContent":["import type { Anchor, DockMode, Position, Size } from \"./types.js\";\n\nexport type PersistedContextState = {\n  anchor?: Anchor;\n  anchorOffset?: Position;\n  size?: Size;\n  hasCustomPosition?: boolean;\n};\n\nexport type PersistedState = {\n  button?: Omit<PersistedContextState, \"size\">;\n  window?: PersistedContextState;\n  isOpen?: boolean;\n  dockMode?: DockMode;\n  selectedMenu?: string;\n  selectedContext?: string;\n};\n\nexport function loadInspectorState(storageKey: string): PersistedState | null {\n  if (typeof window === \"undefined\") {\n    return null;\n  }\n\n  const raw = window.localStorage.getItem(storageKey);\n  if (raw) {\n    try {\n      const parsed = JSON.parse(raw);\n      if (parsed && typeof parsed === \"object\") {\n        return parsed as PersistedState;\n      }\n    } catch {\n      // Fall through to cookie migration path\n    }\n  }\n\n  // Backwards compatibility: try to read the legacy cookie and migrate it\n  if (typeof document !== \"undefined\") {\n    const prefix = `${storageKey}=`;\n    const entry = document.cookie\n      .split(\"; \")\n      .find((cookie) => cookie.startsWith(prefix));\n    if (entry) {\n      const legacyRaw = entry.substring(prefix.length);\n      try {\n        const parsed = JSON.parse(decodeURIComponent(legacyRaw));\n        if (parsed && typeof parsed === \"object\") {\n          return parsed as PersistedState;\n        }\n      } catch {\n        return null;\n      }\n    }\n  }\n\n  return null;\n}\n\nexport function saveInspectorState(\n  storageKey: string,\n  state: PersistedState,\n): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  try {\n    window.localStorage.setItem(storageKey, JSON.stringify(state));\n  } catch (error) {\n    console.warn(\"Failed to persist inspector state\", error);\n  }\n}\n\nexport function isValidAnchor(value: unknown): value is Anchor {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Anchor;\n  return (\n    (candidate.horizontal === \"left\" || candidate.horizontal === \"right\") &&\n    (candidate.vertical === \"top\" || candidate.vertical === \"bottom\")\n  );\n}\n\nexport function isValidPosition(value: unknown): value is Position {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Position;\n  return isFiniteNumber(candidate.x) && isFiniteNumber(candidate.y);\n}\n\nexport function isValidSize(value: unknown): value is Size {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Size;\n  return isFiniteNumber(candidate.width) && isFiniteNumber(candidate.height);\n}\n\nexport function isFiniteNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n\nexport function isValidDockMode(value: unknown): value is DockMode {\n  return value === \"floating\" || value === \"docked-left\";\n}\n\n// Telemetry persistence — flat per-key localStorage rather than the\n// JSON-blob shape used for window/dock state, because each value is\n// independent and we want to read/write them without round-tripping\n// the whole inspector state object.\nconst TELEMETRY_DISTINCT_ID_KEY = \"cpk:inspector:telemetry:distinct_id\";\nconst TELEMETRY_OPT_OUT_KEY = \"cpk:inspector:telemetry:opt_out\";\nconst TELEMETRY_DISCLOSURE_SHOWN_KEY =\n  \"cpk:inspector:telemetry:disclosure_shown\";\n\n// Module-level fallback for when localStorage is unavailable (private mode,\n// quota exceeded, etc.). Cached so that banner_viewed and banner_clicked from\n// the same page-load share one distinct_id even without persistent storage —\n// funnel coherence within a session is preserved even when storage fails.\nlet inMemoryFallbackId: string | null = null;\n\nexport function getOrCreateTelemetryDistinctId(): string {\n  if (typeof window === \"undefined\") {\n    // SSR / test fallback. A non-persistent ID is preferable to throwing\n    // because telemetry must never break the host application.\n    return generateUuidV4();\n  }\n\n  try {\n    const existing = window.localStorage.getItem(TELEMETRY_DISTINCT_ID_KEY);\n    if (existing && existing.length > 0) return existing;\n    const fresh = generateUuidV4();\n    window.localStorage.setItem(TELEMETRY_DISTINCT_ID_KEY, fresh);\n    return fresh;\n  } catch {\n    return (inMemoryFallbackId ??= generateUuidV4());\n  }\n}\n\n// Test-only reset so the in-memory fallback doesn't leak between test cases.\nexport function _resetTelemetryPersistenceForTesting(): void {\n  inMemoryFallbackId = null;\n}\n\nexport function isTelemetryOptedOut(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return window.localStorage.getItem(TELEMETRY_OPT_OUT_KEY) === \"true\";\n  } catch {\n    return false;\n  }\n}\n\nexport function setTelemetryOptOut(optedOut: boolean): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    if (optedOut) {\n      window.localStorage.setItem(TELEMETRY_OPT_OUT_KEY, \"true\");\n    } else {\n      window.localStorage.removeItem(TELEMETRY_OPT_OUT_KEY);\n    }\n  } catch {\n    // No-op — see getOrCreateTelemetryDistinctId.\n  }\n}\n\nexport function hasTelemetryDisclosureBeenShown(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return (\n      window.localStorage.getItem(TELEMETRY_DISCLOSURE_SHOWN_KEY) === \"true\"\n    );\n  } catch {\n    return false;\n  }\n}\n\nexport function markTelemetryDisclosureShown(): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(TELEMETRY_DISCLOSURE_SHOWN_KEY, \"true\");\n  } catch {\n    // No-op.\n  }\n}\n\nfunction generateUuidV4(): string {\n  if (\n    typeof globalThis.crypto !== \"undefined\" &&\n    typeof globalThis.crypto.randomUUID === \"function\"\n  ) {\n    return globalThis.crypto.randomUUID();\n  }\n  // Fallback for environments without crypto.randomUUID (older browsers,\n  // some test runners). Not cryptographically strong; acceptable because\n  // the value is just an anonymous correlation ID.\n  return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === \"x\" ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"persistence.mjs","names":[],"sources":["../../src/lib/persistence.ts"],"sourcesContent":["import type { Anchor, DockMode, Position, Size } from \"./types.js\";\n\nexport type PersistedContextState = {\n  anchor?: Anchor;\n  anchorOffset?: Position;\n  size?: Size;\n  hasCustomPosition?: boolean;\n};\n\nexport type PersistedState = {\n  button?: Omit<PersistedContextState, \"size\">;\n  window?: PersistedContextState;\n  isOpen?: boolean;\n  dockMode?: DockMode;\n  selectedMenu?: string;\n  selectedContext?: string;\n  hasOpenedInspector?: boolean;\n  sidebarCollapsed?: boolean;\n  /** @deprecated Replaced by colorSchemePreference to distinguish a user choice from the old light default. */\n  colorScheme?: \"light\" | \"dark\";\n  colorSchemePreference?: \"light\" | \"dark\";\n};\n\nexport const HOME_NEWS_READ_STORAGE_KEY = \"cpk:inspector:home-news-read\";\n\n/** Return story ids the user has already opened or hovered on Home. */\nexport function loadHomeNewsReadIds(storageKey: string): string[] {\n  if (typeof window === \"undefined\") {\n    return [];\n  }\n\n  try {\n    const raw = window.localStorage.getItem(storageKey);\n    if (!raw) {\n      return [];\n    }\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) {\n      return [];\n    }\n    return parsed.filter((id): id is string => typeof id === \"string\");\n  } catch {\n    return [];\n  }\n}\n\n/** Persist Home news story ids that the user has already seen. */\nexport function saveHomeNewsReadIds(storageKey: string, ids: string[]): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  try {\n    window.localStorage.setItem(storageKey, JSON.stringify(ids));\n  } catch (error) {\n    console.warn(\"Failed to persist Home news read state\", error);\n  }\n}\n\nexport function loadInspectorState(storageKey: string): PersistedState | null {\n  if (typeof window === \"undefined\") {\n    return null;\n  }\n\n  const raw = window.localStorage.getItem(storageKey);\n  if (raw) {\n    try {\n      const parsed = JSON.parse(raw);\n      if (parsed && typeof parsed === \"object\") {\n        return parsed as PersistedState;\n      }\n    } catch {\n      // Fall through to cookie migration path\n    }\n  }\n\n  // Backwards compatibility: try to read the legacy cookie and migrate it\n  if (typeof document !== \"undefined\") {\n    const prefix = `${storageKey}=`;\n    const entry = document.cookie\n      .split(\"; \")\n      .find((cookie) => cookie.startsWith(prefix));\n    if (entry) {\n      const legacyRaw = entry.substring(prefix.length);\n      try {\n        const parsed = JSON.parse(decodeURIComponent(legacyRaw));\n        if (parsed && typeof parsed === \"object\") {\n          return parsed as PersistedState;\n        }\n      } catch {\n        return null;\n      }\n    }\n  }\n\n  return null;\n}\n\nexport function saveInspectorState(\n  storageKey: string,\n  state: PersistedState,\n): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  try {\n    window.localStorage.setItem(storageKey, JSON.stringify(state));\n  } catch (error) {\n    console.warn(\"Failed to persist inspector state\", error);\n  }\n}\n\nexport function isValidAnchor(value: unknown): value is Anchor {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Anchor;\n  return (\n    (candidate.horizontal === \"left\" || candidate.horizontal === \"right\") &&\n    (candidate.vertical === \"top\" || candidate.vertical === \"bottom\")\n  );\n}\n\nexport function isValidPosition(value: unknown): value is Position {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Position;\n  return isFiniteNumber(candidate.x) && isFiniteNumber(candidate.y);\n}\n\nexport function isValidSize(value: unknown): value is Size {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Size;\n  return isFiniteNumber(candidate.width) && isFiniteNumber(candidate.height);\n}\n\nexport function isFiniteNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n\nexport function isValidDockMode(value: unknown): value is DockMode {\n  return value === \"floating\" || value === \"docked-left\";\n}\n\n// Announcement read state — \"have I read this announcement\" is a property of\n// the person, not of the project, so it must survive a change of localhost\n// port. localStorage cannot express that: it is partitioned by origin and\n// origin includes the port, so :3000 and :5173 are separate stores. Cookies\n// are partitioned by host, so a cookie set on `localhost` without a `domain`\n// attribute is shared by every port on that host.\n//\n// Underscores, not colons: `:` is a separator in RFC 6265 and is not valid in\n// a cookie name. Browsers are lenient about it; we don't rely on that.\nconst ANNOUNCEMENT_READ_COOKIE_NAME = \"cpk_inspector_announcements\";\n\n// localStorage mirror of the cookie, so a browser that blocks cookies\n// degrades to per-port behaviour instead of losing the read state entirely.\n// A NEW key on purpose — the legacy one is abandoned, not migrated.\nconst ANNOUNCEMENT_READ_MIRROR_KEY = \"cpk:inspector:announcement_read\";\n\n// The superseded key. Every existing user is re-armed exactly once so they\n// discover the surface that replaced the announcement bubble, and the key is\n// deleted rather than left in place so nothing can fall back to it later.\nconst LEGACY_ANNOUNCEMENT_READ_KEY = \"cpk:inspector:announcements\";\n\n// Pulse suppression is per browser tab, and stores the announcement timestamp\n// rather than a boolean: a boolean would swallow a newly published\n// announcement for the rest of that tab's life, and the feed is fetched once\n// per mount with no polling.\nconst ANNOUNCEMENT_PULSED_SESSION_KEY = \"cpk:inspector:pulsed\";\n\n// Roughly one year. No `Secure` — local development is served over plain\n// HTTP — and no `HttpOnly`, because the component reads the value from\n// script. `Path=/` and `SameSite=Lax` keep it host-wide and same-site only.\nconst ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS = 60 * 60 * 24 * 365;\n\n/**\n * The announcement timestamp the user has already read, or `null` when\n * nothing has been read yet. Prefers the host-scoped cookie and falls back to\n * the origin-scoped mirror, so cookie-blocking browsers still remember the\n * read within the port they are on.\n */\nexport function loadAnnouncementReadTimestamp(): string | null {\n  return (\n    parseTimestampPayload(readAnnouncementCookie()) ??\n    parseTimestampPayload(readLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY))\n  );\n}\n\n/**\n * Records an announcement as read in both the host-scoped cookie and the\n * origin-scoped mirror. The stored value is `{\"timestamp\":\"…\"}` — the same\n * shape the announcement state has always used.\n */\nexport function saveAnnouncementReadTimestamp(timestamp: string): void {\n  const payload = JSON.stringify({ timestamp });\n  writeAnnouncementCookie(payload);\n  writeLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY, payload);\n}\n\n/**\n * Deletes the superseded origin-scoped read state. Safe to call on every\n * startup: nothing writes that key any more, so the value cannot come back.\n */\nexport function clearLegacyAnnouncementReadState(): void {\n  removeLocalStorageItem(LEGACY_ANNOUNCEMENT_READ_KEY);\n}\n\n/**\n * The announcement timestamp this browser tab has already pulsed for, or\n * `null` when it hasn't pulsed yet.\n */\nexport function loadAnnouncementPulsedTimestamp(): string | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    return window.sessionStorage.getItem(ANNOUNCEMENT_PULSED_SESSION_KEY);\n  } catch {\n    return null;\n  }\n}\n\n/** Suppresses further pulses for this announcement in this browser tab. */\nexport function saveAnnouncementPulsedTimestamp(timestamp: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.sessionStorage.setItem(ANNOUNCEMENT_PULSED_SESSION_KEY, timestamp);\n  } catch {\n    // No-op — a lost suppression costs one extra pulse, never correctness.\n  }\n}\n\nfunction parseTimestampPayload(raw: string | null): string | null {\n  if (!raw) return null;\n  try {\n    const parsed = JSON.parse(raw) as { timestamp?: unknown };\n    return typeof parsed?.timestamp === \"string\" ? parsed.timestamp : null;\n  } catch {\n    return null;\n  }\n}\n\nfunction readAnnouncementCookie(): string | null {\n  if (typeof document === \"undefined\") return null;\n  try {\n    for (const entry of document.cookie.split(\";\")) {\n      const separator = entry.indexOf(\"=\");\n      if (separator === -1) continue;\n      if (entry.slice(0, separator).trim() !== ANNOUNCEMENT_READ_COOKIE_NAME) {\n        continue;\n      }\n      return decodeURIComponent(entry.slice(separator + 1).trim());\n    }\n  } catch {\n    // Cookie access throws in sandboxed documents — fall through to the\n    // mirror rather than breaking the host app.\n  }\n  return null;\n}\n\nfunction writeAnnouncementCookie(value: string): void {\n  if (typeof document === \"undefined\") return;\n  try {\n    document.cookie = `${ANNOUNCEMENT_READ_COOKIE_NAME}=${encodeURIComponent(\n      value,\n    )}; Path=/; Max-Age=${ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS}; SameSite=Lax`;\n  } catch {\n    // No-op — the mirror below is what a cookie-blocking browser falls back\n    // to, and neither may break the host app.\n  }\n}\n\nfunction readLocalStorageItem(key: string): string | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    return window.localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nfunction writeLocalStorageItem(key: string, value: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(key, value);\n  } catch {\n    // No-op — see getOrCreateTelemetryDistinctId.\n  }\n}\n\nfunction removeLocalStorageItem(key: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.removeItem(key);\n  } catch {\n    // No-op.\n  }\n}\n\n// Telemetry persistence — flat per-key localStorage rather than the\n// JSON-blob shape used for window/dock state, because each value is\n// independent and we want to read/write them without round-tripping\n// the whole inspector state object.\nconst TELEMETRY_DISTINCT_ID_KEY = \"cpk:inspector:telemetry:distinct_id\";\nconst TELEMETRY_OPT_OUT_KEY = \"cpk:inspector:telemetry:opt_out\";\nconst TELEMETRY_DISCLOSURE_SHOWN_KEY =\n  \"cpk:inspector:telemetry:disclosure_shown\";\n\n// Module-level fallback for when localStorage is unavailable (private mode,\n// quota exceeded, etc.). Cached so that whats_new_viewed and\n// whats_new_clicked from the same page-load share one distinct_id even\n// without persistent storage —\n// funnel coherence within a session is preserved even when storage fails.\nlet inMemoryFallbackId: string | null = null;\n\nexport function getOrCreateTelemetryDistinctId(): string {\n  if (typeof window === \"undefined\") {\n    // SSR / test fallback. A non-persistent ID is preferable to throwing\n    // because telemetry must never break the host application.\n    return generateUuidV4();\n  }\n\n  try {\n    const existing = window.localStorage.getItem(TELEMETRY_DISTINCT_ID_KEY);\n    if (existing && existing.length > 0) return existing;\n    const fresh = generateUuidV4();\n    window.localStorage.setItem(TELEMETRY_DISTINCT_ID_KEY, fresh);\n    return fresh;\n  } catch {\n    return (inMemoryFallbackId ??= generateUuidV4());\n  }\n}\n\n// Test-only reset so the in-memory fallback doesn't leak between test cases.\nexport function _resetTelemetryPersistenceForTesting(): void {\n  inMemoryFallbackId = null;\n}\n\nexport function isTelemetryOptedOut(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return window.localStorage.getItem(TELEMETRY_OPT_OUT_KEY) === \"true\";\n  } catch {\n    return false;\n  }\n}\n\nexport function setTelemetryOptOut(optedOut: boolean): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    if (optedOut) {\n      window.localStorage.setItem(TELEMETRY_OPT_OUT_KEY, \"true\");\n    } else {\n      window.localStorage.removeItem(TELEMETRY_OPT_OUT_KEY);\n    }\n  } catch {\n    // No-op — see getOrCreateTelemetryDistinctId.\n  }\n}\n\nexport function hasTelemetryDisclosureBeenShown(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return (\n      window.localStorage.getItem(TELEMETRY_DISCLOSURE_SHOWN_KEY) === \"true\"\n    );\n  } catch {\n    return false;\n  }\n}\n\nexport function markTelemetryDisclosureShown(): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(TELEMETRY_DISCLOSURE_SHOWN_KEY, \"true\");\n  } catch {\n    // No-op.\n  }\n}\n\nfunction generateUuidV4(): string {\n  if (\n    typeof globalThis.crypto !== \"undefined\" &&\n    typeof globalThis.crypto.randomUUID === \"function\"\n  ) {\n    return globalThis.crypto.randomUUID();\n  }\n  // Fallback for environments without crypto.randomUUID (older browsers,\n  // some test runners). Not cryptographically strong; acceptable because\n  // the value is just an anonymous correlation ID.\n  return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === \"x\" ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n"],"mappings":"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"}

package/dist/lib/telemetry.cjs

@@ -4,9 +4,10 @@ const require_package = require('../package.cjs');
 //#region src/lib/telemetry.ts
 const TELEMETRY_EVENTS = {
 	opened: "oss.inspector.opened",
-	bannerViewed: "oss.inspector.banner_viewed",
-	bannerClicked: "oss.inspector.banner_clicked",
-	bannerDismissed: "oss.inspector.banner_dismissed",
+	whatsNewViewed: "oss.inspector.whats_new_viewed",
+	whatsNewSignalViewed: "oss.inspector.whats_new_signal_viewed",
+	errorSignalViewed: "oss.inspector.error_signal_viewed",
+	whatsNewClicked: "oss.inspector.whats_new_clicked",
 	threadsTabClicked: "oss.inspector.threads_tab_clicked",
 	threadsLockedViewed: "oss.inspector.threads_locked_viewed",
 	threadsIntelligenceSignupClicked: "oss.inspector.threads_intelligence_signup_clicked",
@@ -22,17 +23,18 @@ const TELEMETRY_EVENTS = {
 	threadsExampleTourCompleted: "oss.inspector.threads_example_tour_completed",
 	threadsExampleTourReopened: "oss.inspector.threads_example_tour_reopened",
 	memoriesTabClicked: "oss.inspector.memories_tab_clicked",
+	homeViewed: "oss.inspector.home_viewed",
+	homeCtaClicked: "oss.inspector.home_cta_clicked",
 	metadataModuleViewed: "oss.inspector.metadata_module_viewed",
-	metadataActionClicked: "oss.inspector.metadata_action_clicked"
+	metadataActionClicked: "oss.inspector.metadata_action_clicked",
+	eventSnippetsRun: "oss.inspector.event_snippets_run",
+	eventSnippetsSaved: "oss.inspector.event_snippets_saved"
 };
 const TELEMETRY_INGEST_URL = "https://telemetry.copilotkit.ai/ingest";
 const TELEMETRY_DOCS_URL = "https://docs.copilotkit.ai/telemetry";
 const PACKAGE_NAME = "@copilotkit/web-inspector";
 const PACKAGE_VERSION = require_package.version;
 const FETCH_TIMEOUT_MS = 3e3;
-function isEnrichedTelemetryEvent(event) {
-	return event === TELEMETRY_EVENTS.opened || event === TELEMETRY_EVENTS.threadsTabClicked || event === TELEMETRY_EVENTS.threadsLockedViewed || event === TELEMETRY_EVENTS.threadsIntelligenceSignupClicked || event === TELEMETRY_EVENTS.threadsTalkToEngineerClicked || event === TELEMETRY_EVENTS.talkToEngineerClicked || event === TELEMETRY_EVENTS.threadsEmptyEnabledViewed || event === TELEMETRY_EVENTS.threadsEnabledViewed || event === TELEMETRY_EVENTS.threadsExampleViewed || event === TELEMETRY_EVENTS.threadsExampleSelected || event === TELEMETRY_EVENTS.threadsExampleTourStarted || event === TELEMETRY_EVENTS.threadsExampleTourStepViewed || event === TELEMETRY_EVENTS.threadsExampleTourDismissed || event === TELEMETRY_EVENTS.threadsExampleTourCompleted || event === TELEMETRY_EVENTS.threadsExampleTourReopened || event === TELEMETRY_EVENTS.memoriesTabClicked || event === TELEMETRY_EVENTS.metadataModuleViewed || event === TELEMETRY_EVENTS.metadataActionClicked;
-}
 function getRuntimeUrlType(runtimeUrl) {
 	if (!runtimeUrl) return "missing";
 	if (runtimeUrl.startsWith("/") && !runtimeUrl.startsWith("//")) return "relative";
@@ -59,47 +61,72 @@ function track(event, properties = {}) {
 	if (require_persistence.isTelemetryOptedOut()) return;
 	try {
 		const distinctId = require_persistence.getOrCreateTelemetryDistinctId();
-		const enrichedProperties = isEnrichedTelemetryEvent(event) ? {
-			package_name: PACKAGE_NAME,
-			package_version: PACKAGE_VERSION,
-			inspector_distinct_id: distinctId
-		} : {};
 		postBestEffort(TELEMETRY_INGEST_URL, JSON.stringify({
 			event,
 			properties: {
 				...properties,
-				...enrichedProperties,
+				package_name: PACKAGE_NAME,
+				package_version: PACKAGE_VERSION,
+				inspector_distinct_id: distinctId,
 				distinct_id: distinctId
 			},
 			package: {
 				name: PACKAGE_NAME,
-				...isEnrichedTelemetryEvent(event) ? { version: PACKAGE_VERSION } : {}
+				version: PACKAGE_VERSION
 			},
 			ts: Math.floor(Date.now() / 1e3)
 		}), distinctId);
 	} catch {}
 }
-function trackBannerViewed(props) {
-	track(TELEMETRY_EVENTS.bannerViewed, props);
+/**
+* Fires when What's new has rendered *with content*. A loading state is not
+* an impression, so the metric cannot inflate itself by counting readers who
+* arrived before the feed resolved.
+*/
+function trackWhatsNewViewed(props) {
+	track(TELEMETRY_EVENTS.whatsNewViewed, props);
 }
-function trackBannerClicked(props) {
-	track(TELEMETRY_EVENTS.bannerClicked, props);
+/** Fires when the unread launcher signal is presented in a visible tab. */
+function trackWhatsNewSignalViewed(props) {
+	track(TELEMETRY_EVENTS.whatsNewSignalViewed, props);
+}
+/**
+* Fires when the launcher's error signal becomes *visible* — not when it arms.
+* Arming can happen with the panel open or the tab hidden, where there is no
+* launcher to look at, so counting arms would inflate the denominator this
+* event exists to provide.
+*
+* Deliberately carries three fixed enum values and nothing else. This is the
+* one place a later change could casually attach a free-text field, and the
+* failure message must never be transmitted.
+*
+* `label` is deliberately not a new event: the catalogue's size is asserted
+* and spelled out in a test title, and a property answers the one open
+* question — how often the no-room fallback fires — without touching either.
+*
+* The pill's own marginal effect cannot be measured here and must not be
+* reverse-engineered from this data: it ships together with the dot and the
+* beat, so there is no period with one and not the other.
+*/
+function trackErrorSignalViewed(props) {
+	track(TELEMETRY_EVENTS.errorSignalViewed, {
+		source: props.source,
+		presentation: props.presentation,
+		label: props.label
+	});
 }
 /**
-* First-class dismissal signal. Emitted *in addition to*
-* `banner_clicked { cta: "dismiss" }` rather than replacing it — the
-* existing dashboards read the `cta` value, so removing it would silently
-* zero them out. New reporting should prefer this event, whose `surface`
-* says whether the user swatted the bubble away or dismissed the card
-* after opening the panel.
+* Fires for links followed inside the announcement body. `body` is the only
+* call-to-action left: dismissal no longer exists, so there is nothing else a
+* click on this surface can mean.
 */
-function trackBannerDismissed(props) {
-	track(TELEMETRY_EVENTS.bannerDismissed, props);
+function trackWhatsNewClicked(props) {
+	track(TELEMETRY_EVENTS.whatsNewClicked, props);
 }
 /**
 * Panel-open signal (OSS-566). Before this event, opens could only be
-* inferred from in-panel activity (a floor) or from `banner_clicked`
-* cta=`body` (which misses the floating-button path entirely).
+* inferred from in-panel activity (a floor) or from the announcement's own
+* click event (which misses the floating-button path entirely).
 */
 function trackInspectorOpened(props) {
 	track(TELEMETRY_EVENTS.opened, props);
@@ -196,6 +223,19 @@ function trackThreadsExampleTourReopened(props) {
 function trackMemoriesTabClicked(props = {}) {
 	track(TELEMETRY_EVENTS.memoriesTabClicked, props);
 }
+function trackHomeViewed(props = {}) {
+	track(TELEMETRY_EVENTS.homeViewed, {
+		group_key: props.group_key ?? "home",
+		leaf_key: props.leaf_key ?? "home"
+	});
+}
+function trackHomeCtaClicked(props) {
+	track(TELEMETRY_EVENTS.homeCtaClicked, {
+		action_kind: props.action_kind,
+		group_key: props.group_key ?? "home",
+		leaf_key: props.leaf_key ?? "home"
+	});
+}
 function metadataCoarseProperties(props) {
 	const navigation = props.group_key === void 0 || props.leaf_key === void 0 ? {} : {
 		group_key: props.group_key,
@@ -233,15 +273,29 @@ function trackMetadataActionClicked(props) {
 		...metadataCoarseProperties(props)
 	});
 }
+function trackEventSnippetsRun(props) {
+	track(TELEMETRY_EVENTS.eventSnippetsRun, {
+		recipe: props.recipe,
+		source: props.source,
+		success: props.success
+	});
+}
+function trackEventSnippetsSaved(props) {
+	track(TELEMETRY_EVENTS.eventSnippetsSaved, {
+		recipe: props.recipe,
+		source: props.source,
+		success: props.success
+	});
+}
 /**
 * Returns the inspector's anonymous distinct-ID for cross-domain
-* propagation onto outbound banner-CTA links, or `null` when the user
+* propagation onto outbound announcement-CTA links, or `null` when the user
 * is opted out.
 *
 * The website / Ops API reads this query param on signup-flow landing
 * pages and calls `posthog.alias(...)` to merge the inspector's anon
 * ID with the website's anon ID, enabling the
-* `banner_viewed → banner_clicked → signup_attributed` funnel.
+* `whats_new_viewed → whats_new_clicked → signup_attributed` funnel.
 * `identify()` itself is out of scope here (it happens on signup, in
 * the website / Ops API).
 *
@@ -254,7 +308,7 @@ function getTelemetryDistinctIdForUrl() {
 }
 /**
 * Seeds the anonymous distinct-ID into localStorage on inspector mount
-* so it is ready for cross-domain propagation onto banner-CTA links
+* so it is ready for cross-domain propagation onto announcement-CTA links
 * even before the first event fires. No-op when the user has opted out.
 */
 function ensureTelemetryDistinctId() {
@@ -302,9 +356,11 @@ exports.ensureTelemetryDistinctId = ensureTelemetryDistinctId;
 exports.getRuntimeUrlType = getRuntimeUrlType;
 exports.getTelemetryDistinctIdForUrl = getTelemetryDistinctIdForUrl;
 exports.maybeShowDisclosure = maybeShowDisclosure;
-exports.trackBannerClicked = trackBannerClicked;
-exports.trackBannerDismissed = trackBannerDismissed;
-exports.trackBannerViewed = trackBannerViewed;
+exports.trackErrorSignalViewed = trackErrorSignalViewed;
+exports.trackEventSnippetsRun = trackEventSnippetsRun;
+exports.trackEventSnippetsSaved = trackEventSnippetsSaved;
+exports.trackHomeCtaClicked = trackHomeCtaClicked;
+exports.trackHomeViewed = trackHomeViewed;
 exports.trackInspectorOpened = trackInspectorOpened;
 exports.trackMemoriesTabClicked = trackMemoriesTabClicked;
 exports.trackMetadataActionClicked = trackMetadataActionClicked;
@@ -323,4 +379,7 @@ exports.trackThreadsIntelligenceSignupClicked = trackThreadsIntelligenceSignupCl
 exports.trackThreadsLockedViewed = trackThreadsLockedViewed;
 exports.trackThreadsTabClicked = trackThreadsTabClicked;
 exports.trackThreadsTalkToEngineerClicked = trackThreadsTalkToEngineerClicked;
+exports.trackWhatsNewClicked = trackWhatsNewClicked;
+exports.trackWhatsNewSignalViewed = trackWhatsNewSignalViewed;
+exports.trackWhatsNewViewed = trackWhatsNewViewed;
 //# sourceMappingURL=telemetry.cjs.map

package/dist/lib/telemetry.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.cjs","names":["isTelemetryOptedOut","getOrCreateTelemetryDistinctId","hasTelemetryDisclosureBeenShown"],"sources":["../../src/lib/telemetry.ts"],"sourcesContent":["// Inspector-side anonymous telemetry. V1 events fire from index.ts for\n// banner and thread-inspection interactions. POSTs directly from the browser\n// to the CopilotKit telemetry sink at `telemetry.copilotkit.ai/ingest`,\n// where a Lambda fan-out forwards events to PostHog / Reo / Scarf.\n//\n// The endpoint URL is intentionally clearly named so it's obvious in\n// DevTools / Network tab — transparency for opt-in users.\n//\n// Privacy invariants enforced here:\n//   - We never send message content, agent state, prompts, completions,\n//     or banner markdown. Feature-specific properties are scoped to event\n//     metadata only (banner_id/timestamp, cta location). Reviewers should grep\n//     call sites for any unintended payload.\n//   - The opt-out short-circuits before any network call. There is no\n//     buffer, no retry queue.\n//   - All errors are swallowed; telemetry must never break the host app.\n\nimport {\n  getOrCreateTelemetryDistinctId,\n  hasTelemetryDisclosureBeenShown,\n  isTelemetryOptedOut,\n  markTelemetryDisclosureShown,\n} from \"./persistence.js\";\nimport packageJson from \"../../package.json\" with { type: \"json\" };\n\n// V1 funnel events. Namespaced `oss.inspector.*` so the lambda's\n// owned-prefix gate (oss-path-to-production) can accept them server-side\n// without a per-event sink deploy.\nexport const TELEMETRY_EVENTS = {\n  opened: \"oss.inspector.opened\",\n  bannerViewed: \"oss.inspector.banner_viewed\",\n  bannerClicked: \"oss.inspector.banner_clicked\",\n  bannerDismissed: \"oss.inspector.banner_dismissed\",\n  threadsTabClicked: \"oss.inspector.threads_tab_clicked\",\n  threadsLockedViewed: \"oss.inspector.threads_locked_viewed\",\n  threadsIntelligenceSignupClicked:\n    \"oss.inspector.threads_intelligence_signup_clicked\",\n  threadsTalkToEngineerClicked:\n    \"oss.inspector.threads_talk_to_engineer_clicked\",\n  talkToEngineerClicked: \"oss.inspector.talk_to_engineer_clicked\",\n  threadsEmptyEnabledViewed: \"oss.inspector.threads_empty_enabled_viewed\",\n  threadsEnabledViewed: \"oss.inspector.threads_enabled_viewed\",\n  threadsExampleViewed: \"oss.inspector.threads_example_viewed\",\n  threadsExampleSelected: \"oss.inspector.threads_example_selected\",\n  threadsExampleTourStarted: \"oss.inspector.threads_example_tour_started\",\n  threadsExampleTourStepViewed:\n    \"oss.inspector.threads_example_tour_step_viewed\",\n  threadsExampleTourDismissed: \"oss.inspector.threads_example_tour_dismissed\",\n  threadsExampleTourCompleted: \"oss.inspector.threads_example_tour_completed\",\n  threadsExampleTourReopened: \"oss.inspector.threads_example_tour_reopened\",\n  memoriesTabClicked: \"oss.inspector.memories_tab_clicked\",\n  metadataModuleViewed: \"oss.inspector.metadata_module_viewed\",\n  metadataActionClicked: \"oss.inspector.metadata_action_clicked\",\n} as const;\n\nexport type TelemetryEvent =\n  (typeof TELEMETRY_EVENTS)[keyof typeof TELEMETRY_EVENTS];\n\n// Per the OSS-96 ticket — the URL is intentionally clearly named for\n// transparency in the network tab.\nexport const TELEMETRY_INGEST_URL = \"https://telemetry.copilotkit.ai/ingest\";\n\n// Surfaced in console disclosure and the in-product opt-out panel.\n// Keep in sync with the live shell-docs telemetry page\n// (`showcase/shell-docs/src/content/docs/integrations/built-in-agent/telemetry.mdx`).\n// Mirror constant: packages/runtime/src/lib/telemetry-disclosure.ts\nexport const TELEMETRY_DOCS_URL = \"https://docs.copilotkit.ai/telemetry\";\n\nconst PACKAGE_NAME = \"@copilotkit/web-inspector\";\nconst PACKAGE_VERSION = packageJson.version;\n\n// 3-second cap so a slow gateway can't hang the host app. Matches the\n// runtime's existing scarf-client convention.\nconst FETCH_TIMEOUT_MS = 3000;\n\n// Events that carry package identity (`package_name` / `package_version`) and\n// the inspector's anonymous distinct-ID alongside their own properties.\n// Threads / memories events have always been enriched this way; `opened`\n// joins them so panel-open volume can be segmented by inspector version.\n// Banner events deliberately keep the flat shape their existing dashboards\n// read.\nfunction isEnrichedTelemetryEvent(event: TelemetryEvent): boolean {\n  return (\n    event === TELEMETRY_EVENTS.opened ||\n    event === TELEMETRY_EVENTS.threadsTabClicked ||\n    event === TELEMETRY_EVENTS.threadsLockedViewed ||\n    event === TELEMETRY_EVENTS.threadsIntelligenceSignupClicked ||\n    event === TELEMETRY_EVENTS.threadsTalkToEngineerClicked ||\n    event === TELEMETRY_EVENTS.talkToEngineerClicked ||\n    event === TELEMETRY_EVENTS.threadsEmptyEnabledViewed ||\n    event === TELEMETRY_EVENTS.threadsEnabledViewed ||\n    event === TELEMETRY_EVENTS.threadsExampleViewed ||\n    event === TELEMETRY_EVENTS.threadsExampleSelected ||\n    event === TELEMETRY_EVENTS.threadsExampleTourStarted ||\n    event === TELEMETRY_EVENTS.threadsExampleTourStepViewed ||\n    event === TELEMETRY_EVENTS.threadsExampleTourDismissed ||\n    event === TELEMETRY_EVENTS.threadsExampleTourCompleted ||\n    event === TELEMETRY_EVENTS.threadsExampleTourReopened ||\n    event === TELEMETRY_EVENTS.memoriesTabClicked ||\n    event === TELEMETRY_EVENTS.metadataModuleViewed ||\n    event === TELEMETRY_EVENTS.metadataActionClicked\n  );\n}\n\nexport type RuntimeUrlType =\n  | \"missing\"\n  | \"relative\"\n  | \"localhost\"\n  | \"same_origin\"\n  | \"remote\"\n  | \"invalid\";\n\nexport function getRuntimeUrlType(\n  runtimeUrl: string | undefined,\n): RuntimeUrlType {\n  if (!runtimeUrl) return \"missing\";\n  if (runtimeUrl.startsWith(\"/\") && !runtimeUrl.startsWith(\"//\")) {\n    return \"relative\";\n  }\n\n  try {\n    const baseHref =\n      typeof window !== \"undefined\"\n        ? window.location.href\n        : \"https://copilotkit.ai\";\n    const url = new URL(runtimeUrl, baseHref);\n    const baseUrl = new URL(baseHref);\n    const hostname = url.hostname.toLowerCase();\n\n    if (\n      hostname === \"localhost\" ||\n      hostname === \"127.0.0.1\" ||\n      hostname === \"[::1]\"\n    ) {\n      return \"localhost\";\n    }\n\n    return url.origin === baseUrl.origin ? \"same_origin\" : \"remote\";\n  } catch {\n    return \"invalid\";\n  }\n}\n\n/**\n * Fire-and-forget telemetry send. Returns synchronously; the network\n * call is dispatched in the background and any failure is swallowed.\n *\n * Short-circuits when the user has opted out. Does NOT itself trigger\n * the first-run disclosure — call `maybeShowDisclosure()` from the\n * inspector's mount lifecycle instead.\n */\nexport function track(\n  event: TelemetryEvent,\n  properties: Record<string, unknown> = {},\n): void {\n  if (isTelemetryOptedOut()) return;\n\n  try {\n    const distinctId = getOrCreateTelemetryDistinctId();\n    const enrichedProperties = isEnrichedTelemetryEvent(event)\n      ? {\n          package_name: PACKAGE_NAME,\n          package_version: PACKAGE_VERSION,\n          inspector_distinct_id: distinctId,\n        }\n      : {};\n    const body = JSON.stringify({\n      event,\n      properties: {\n        ...properties,\n        ...enrichedProperties,\n        distinct_id: distinctId,\n      },\n      package: {\n        name: PACKAGE_NAME,\n        ...(isEnrichedTelemetryEvent(event)\n          ? { version: PACKAGE_VERSION }\n          : {}),\n      },\n      ts: Math.floor(Date.now() / 1000),\n    });\n    void postBestEffort(TELEMETRY_INGEST_URL, body, distinctId);\n  } catch {\n    // Identity and serialization failures are best-effort too.\n  }\n}\n\n// --- Typed per-event helpers ---\n// These enforce the known property shape for each V1 event at the call\n// site, so callers can't accidentally include PII under a wrong key.\n\n/**\n * Where an announcement was rendered when the event fired. The announcement\n * has two surfaces — the preview bubble beside the *collapsed* floating\n * button, and the card *inside* the opened panel — and reach on one says\n * nothing about attention on the other. Always stamped at fire time, never\n * inferred at fetch time.\n */\nexport type BannerSurface = \"collapsed_preview\" | \"expanded_card\";\n\nexport function trackBannerViewed(props: {\n  banner_id: string;\n  surface: BannerSurface;\n  cta_label?: string;\n}): void {\n  track(TELEMETRY_EVENTS.bannerViewed, props);\n}\n\nexport function trackBannerClicked(props: {\n  banner_id: string;\n  cta: \"body\" | \"dismiss\";\n  cta_label?: string;\n}): void {\n  track(TELEMETRY_EVENTS.bannerClicked, props);\n}\n\n/**\n * First-class dismissal signal. Emitted *in addition to*\n * `banner_clicked { cta: \"dismiss\" }` rather than replacing it — the\n * existing dashboards read the `cta` value, so removing it would silently\n * zero them out. New reporting should prefer this event, whose `surface`\n * says whether the user swatted the bubble away or dismissed the card\n * after opening the panel.\n */\nexport function trackBannerDismissed(props: {\n  banner_id: string;\n  surface: BannerSurface;\n  cta_label?: string;\n}): void {\n  track(TELEMETRY_EVENTS.bannerDismissed, props);\n}\n\n/**\n * How the panel was opened. Restoring a persisted-open panel on mount is\n * deliberately NOT a source: it is not an open *intent*, and counting it\n * would turn every dev-server hot reload into an \"open\".\n */\nexport type InspectorOpenSource =\n  | \"floating_button\"\n  | \"announcement_preview\"\n  | \"message_toolbar\";\n\nexport type InspectorOpenedTelemetryProps = {\n  open_source: InspectorOpenSource;\n  package_name?: typeof PACKAGE_NAME;\n  package_version?: string;\n  inspector_distinct_id?: string;\n  license_status?:\n    | \"valid\"\n    | \"none\"\n    | \"expired\"\n    | \"expiring\"\n    | \"invalid\"\n    | \"unknown\";\n  runtime_mode?: \"sse\" | \"intelligence\";\n  runtime_url_type?: RuntimeUrlType;\n  /** True when an unseen announcement was on screen at open time. */\n  has_unseen_announcement?: boolean;\n};\n\n/**\n * Panel-open signal (OSS-566). Before this event, opens could only be\n * inferred from in-panel activity (a floor) or from `banner_clicked`\n * cta=`body` (which misses the floating-button path entirely).\n */\nexport function trackInspectorOpened(\n  props: InspectorOpenedTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.opened, props);\n}\n\nexport type ExampleKind = \"realtime_sync\" | \"manage_history\" | \"inspect_runs\";\nexport type ThreadsUsageBucket =\n  | \"absent\"\n  | \"empty\"\n  | \"within_limit\"\n  | \"at_or_over_limit\"\n  | \"unlimited\"\n  | \"unknown_limit\";\nexport type ThreadsExpiryBucket = \"unavailable\" | \"zero\" | \"positive\";\nexport type InspectorGroupKey = \"threads\" | \"agents\" | \"learning\";\nexport type InspectorLeafKey =\n  | \"threads\"\n  | \"ag-ui-events\"\n  | \"agents\"\n  | \"frontend-tools\"\n  | \"capabilities\"\n  | \"agent-context\"\n  | \"memories\";\nexport type MetadataActionPlacement = \"threads_footer\" | \"threads_locked\";\nexport type ExampleTourStep = 1 | 2 | 3;\nexport type ExampleTourTab = \"timeline\" | \"raw-events\" | \"state\";\n\nexport type InspectorThreadTelemetryProps = Readonly<{\n  posthog_distinct_id?: string;\n  intelligence_status?:\n    | \"intelligence_not_enabled\"\n    | \"intelligence_enabled\"\n    | \"unknown\";\n  thread_service_status?: \"unavailable\" | \"available\" | \"unknown\" | \"error\";\n  license_status?:\n    | \"valid\"\n    | \"none\"\n    | \"expired\"\n    | \"expiring\"\n    | \"invalid\"\n    | \"unknown\";\n  runtime_mode?: \"sse\" | \"intelligence\";\n  runtime_url_type?: RuntimeUrlType;\n  cta_surface?:\n    | \"threads_locked\"\n    | \"threads_header\"\n    | \"threads_empty\"\n    | \"threads_populated\";\n  cta?: \"signup\" | \"talk_to_engineer\";\n  telemetry_disabled?: boolean;\n  has_threads?: boolean;\n  usage_bucket?: ThreadsUsageBucket;\n  expiry_bucket?: ThreadsExpiryBucket;\n  group_key?: InspectorGroupKey;\n  leaf_key?: InspectorLeafKey;\n  example_kind?: ExampleKind;\n  tour_step?: ExampleTourStep;\n  tour_tab?: ExampleTourTab;\n  dismiss_method?: \"skip\" | \"done\";\n}>;\n\n/** Rebuild the common Thread payload from its closed coarse allowlist. */\nfunction threadCommonProperties(props: InspectorThreadTelemetryProps) {\n  return {\n    ...(props.intelligence_status === undefined\n      ? {}\n      : { intelligence_status: props.intelligence_status }),\n    ...(props.thread_service_status === undefined\n      ? {}\n      : { thread_service_status: props.thread_service_status }),\n    ...(props.license_status === undefined\n      ? {}\n      : { license_status: props.license_status }),\n    ...(props.runtime_mode === undefined\n      ? {}\n      : { runtime_mode: props.runtime_mode }),\n    ...(props.runtime_url_type === undefined\n      ? {}\n      : { runtime_url_type: props.runtime_url_type }),\n    ...(props.telemetry_disabled === undefined\n      ? {}\n      : { telemetry_disabled: props.telemetry_disabled }),\n    ...(props.has_threads === undefined\n      ? {}\n      : { has_threads: props.has_threads }),\n    ...(props.usage_bucket === undefined\n      ? {}\n      : { usage_bucket: props.usage_bucket }),\n    ...(props.expiry_bucket === undefined\n      ? {}\n      : { expiry_bucket: props.expiry_bucket }),\n    ...(props.group_key === undefined ? {} : { group_key: props.group_key }),\n    ...(props.leaf_key === undefined ? {} : { leaf_key: props.leaf_key }),\n  };\n}\n\n/** Add only the fields used by the three Thread CTA funnels. */\nfunction threadCtaProperties(props: InspectorThreadTelemetryProps) {\n  return {\n    ...threadCommonProperties(props),\n    ...(props.cta === undefined ? {} : { cta: props.cta }),\n    ...(props.cta_surface === undefined\n      ? {}\n      : { cta_surface: props.cta_surface }),\n    ...(props.posthog_distinct_id === undefined\n      ? {}\n      : { posthog_distinct_id: props.posthog_distinct_id }),\n  };\n}\n\n/** Add only the closed example kind used by example impressions/selections. */\nfunction threadExampleProperties(props: InspectorThreadTelemetryProps) {\n  return {\n    ...threadCommonProperties(props),\n    ...(props.example_kind === undefined\n      ? {}\n      : { example_kind: props.example_kind }),\n  };\n}\n\n/** Add only a bounded example kind and tour step/tab pair. */\nfunction threadTourProperties(props: InspectorThreadTelemetryProps) {\n  return {\n    ...threadExampleProperties(props),\n    ...(props.tour_step === undefined ? {} : { tour_step: props.tour_step }),\n    ...(props.tour_tab === undefined ? {} : { tour_tab: props.tour_tab }),\n  };\n}\n\n/** Add the bounded dismissal leaf used only by terminal tour events. */\nfunction threadTourTerminalProperties(props: InspectorThreadTelemetryProps) {\n  return {\n    ...threadTourProperties(props),\n    ...(props.dismiss_method === undefined\n      ? {}\n      : { dismiss_method: props.dismiss_method }),\n  };\n}\n\nexport function trackThreadsTabClicked(\n  props: InspectorThreadTelemetryProps = {},\n): void {\n  track(TELEMETRY_EVENTS.threadsTabClicked, threadCommonProperties(props));\n}\n\nexport function trackThreadsLockedViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsLockedViewed, threadCommonProperties(props));\n}\n\nexport function trackThreadsIntelligenceSignupClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsIntelligenceSignupClicked,\n    threadCtaProperties(props),\n  );\n}\n\nexport function trackThreadsTalkToEngineerClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsTalkToEngineerClicked,\n    threadCtaProperties(props),\n  );\n}\n\nexport function trackTalkToEngineerClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.talkToEngineerClicked, threadCtaProperties(props));\n}\n\nexport function trackThreadsEmptyEnabledViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsEmptyEnabledViewed,\n    threadCommonProperties(props),\n  );\n}\n\nexport function trackThreadsEnabledViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsEnabledViewed, threadCommonProperties(props));\n}\n\nexport function trackThreadsExampleViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleViewed, threadExampleProperties(props));\n}\n\nexport function trackThreadsExampleSelected(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsExampleSelected,\n    threadExampleProperties(props),\n  );\n}\n\nexport function trackThreadsExampleTourStarted(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsExampleTourStarted,\n    threadTourProperties(props),\n  );\n}\n\nexport function trackThreadsExampleTourStepViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsExampleTourStepViewed,\n    threadTourProperties(props),\n  );\n}\n\nexport function trackThreadsExampleTourDismissed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsExampleTourDismissed,\n    threadTourTerminalProperties(props),\n  );\n}\n\nexport function trackThreadsExampleTourCompleted(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsExampleTourCompleted,\n    threadTourTerminalProperties(props),\n  );\n}\n\nexport function trackThreadsExampleTourReopened(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsExampleTourReopened,\n    threadTourProperties(props),\n  );\n}\n\nexport type InspectorMemoryTelemetryProps = {\n  package_name?: typeof PACKAGE_NAME;\n  package_version?: string;\n  inspector_distinct_id?: string;\n  posthog_distinct_id?: string;\n  memory_count?: number;\n  available?: boolean;\n};\n\nexport function trackMemoriesTabClicked(\n  props: InspectorMemoryTelemetryProps = {},\n): void {\n  track(TELEMETRY_EVENTS.memoriesTabClicked, props);\n}\n\nexport type InspectorMetadataTelemetryModule = \"identity\" | \"plan\" | \"action\";\nexport type InspectorMetadataLicenseBucket =\n  | \"valid\"\n  | \"none\"\n  | \"expired\"\n  | \"unknown\";\nexport type InspectorMetadataActionKind =\n  | \"manage_plan\"\n  | \"renew\"\n  | \"enable_intelligence\";\n\nexport type InspectorMetadataModuleViewedTelemetryProps = Readonly<{\n  module: InspectorMetadataTelemetryModule;\n  license_bucket: InspectorMetadataLicenseBucket;\n  action_kind?: InspectorMetadataActionKind;\n  usage_bucket: ThreadsUsageBucket;\n  expiry_bucket: ThreadsExpiryBucket;\n  group_key?: InspectorGroupKey;\n  leaf_key?: InspectorLeafKey;\n  action_placement?: MetadataActionPlacement;\n}>;\n\nexport type InspectorMetadataActionClickedTelemetryProps = Readonly<{\n  action_kind: Exclude<InspectorMetadataActionKind, \"enable_intelligence\">;\n  license_bucket: InspectorMetadataLicenseBucket;\n  usage_bucket: ThreadsUsageBucket;\n  expiry_bucket: ThreadsExpiryBucket;\n  group_key?: InspectorGroupKey;\n  leaf_key?: InspectorLeafKey;\n  action_placement?: MetadataActionPlacement;\n}>;\n\nfunction metadataCoarseProperties(\n  props:\n    | InspectorMetadataModuleViewedTelemetryProps\n    | InspectorMetadataActionClickedTelemetryProps,\n) {\n  const navigation =\n    props.group_key === undefined || props.leaf_key === undefined\n      ? {}\n      : { group_key: props.group_key, leaf_key: props.leaf_key };\n  return {\n    license_bucket: props.license_bucket,\n    usage_bucket: props.usage_bucket,\n    expiry_bucket: props.expiry_bucket,\n    ...navigation,\n    ...(props.action_placement === undefined\n      ? {}\n      : { action_placement: props.action_placement }),\n  };\n}\n\n/**\n * Tracks one visible Inspector metadata module using coarse fields only.\n * Rebuilding the payload here prevents local labels, IDs, URLs, and usage\n * values from crossing the telemetry boundary through extra object fields.\n */\nexport function trackMetadataModuleViewed(\n  props: InspectorMetadataModuleViewedTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.metadataModuleViewed, {\n    module: props.module,\n    ...(props.action_kind === undefined\n      ? {}\n      : { action_kind: props.action_kind }),\n    ...metadataCoarseProperties(props),\n  });\n}\n\n/**\n * Tracks clicks for managed plan and renewal actions. The existing\n * Intelligence-enable funnel keeps its original event and never calls this\n * helper, which prevents a single click from producing two wire events.\n */\nexport function trackMetadataActionClicked(\n  props: InspectorMetadataActionClickedTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.metadataActionClicked, {\n    module: \"action\",\n    action_kind: props.action_kind,\n    ...metadataCoarseProperties(props),\n  });\n}\n\n/**\n * Returns the inspector's anonymous distinct-ID for cross-domain\n * propagation onto outbound banner-CTA links, or `null` when the user\n * is opted out.\n *\n * The website / Ops API reads this query param on signup-flow landing\n * pages and calls `posthog.alias(...)` to merge the inspector's anon\n * ID with the website's anon ID, enabling the\n * `banner_viewed → banner_clicked → signup_attributed` funnel.\n * `identify()` itself is out of scope here (it happens on signup, in\n * the website / Ops API).\n *\n * Opt-out short-circuits this too: if the user has opted out, we do\n * NOT leak an anon ID across domains.\n */\nexport function getTelemetryDistinctIdForUrl(): string | null {\n  if (isTelemetryOptedOut()) return null;\n  return getOrCreateTelemetryDistinctId();\n}\n\n/**\n * Seeds the anonymous distinct-ID into localStorage on inspector mount\n * so it is ready for cross-domain propagation onto banner-CTA links\n * even before the first event fires. No-op when the user has opted out.\n */\nexport function ensureTelemetryDistinctId(): void {\n  if (isTelemetryOptedOut()) return;\n  getOrCreateTelemetryDistinctId();\n}\n\n/**\n * Fires the one-time console disclosure on inspector mount, when the\n * user is not opted out and hasn't seen it before. Idempotent across\n * calls within a single session because `markTelemetryDisclosureShown`\n * persists to localStorage.\n *\n * If the user is opted out, we deliberately do nothing and do NOT mark\n * the flag — so a future opt-in flips back to \"first run\" behavior.\n */\nexport function maybeShowDisclosure(): void {\n  if (isTelemetryOptedOut()) return;\n  if (hasTelemetryDisclosureBeenShown()) return;\n  // eslint-disable-next-line no-console\n  console.info(\n    `[CopilotKit Inspector] anonymous interaction telemetry enabled — see ${TELEMETRY_DOCS_URL} to opt out.`,\n  );\n  markTelemetryDisclosureShown();\n}\n\nexport { isTelemetryOptedOut };\n\nasync function postBestEffort(\n  url: string,\n  body: string,\n  distinctId: string,\n): Promise<void> {\n  if (typeof fetch === \"undefined\") return;\n  let timeoutId: ReturnType<typeof setTimeout> | undefined;\n  try {\n    const controller = new AbortController();\n    timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n    await fetch(url, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-CopilotKit-Telemetry-Id\": distinctId,\n      },\n      body,\n      signal: controller.signal,\n      // No credentials / no Authorization header — anonymous endpoint.\n    });\n  } catch {\n    // Silent failure — telemetry must not break the application.\n  } finally {\n    if (timeoutId !== undefined) clearTimeout(timeoutId);\n  }\n}\n"],"mappings":";;;;AA4BA,MAAa,mBAAmB;CAC9B,QAAQ;CACR,cAAc;CACd,eAAe;CACf,iBAAiB;CACjB,mBAAmB;CACnB,qBAAqB;CACrB,kCACE;CACF,8BACE;CACF,uBAAuB;CACvB,2BAA2B;CAC3B,sBAAsB;CACtB,sBAAsB;CACtB,wBAAwB;CACxB,2BAA2B;CAC3B,8BACE;CACF,6BAA6B;CAC7B,6BAA6B;CAC7B,4BAA4B;CAC5B,oBAAoB;CACpB,sBAAsB;CACtB,uBAAuB;CACxB;AAOD,MAAa,uBAAuB;AAMpC,MAAa,qBAAqB;AAElC,MAAM,eAAe;AACrB,MAAM;AAIN,MAAM,mBAAmB;AAQzB,SAAS,yBAAyB,OAAgC;AAChE,QACE,UAAU,iBAAiB,UAC3B,UAAU,iBAAiB,qBAC3B,UAAU,iBAAiB,uBAC3B,UAAU,iBAAiB,oCAC3B,UAAU,iBAAiB,gCAC3B,UAAU,iBAAiB,yBAC3B,UAAU,iBAAiB,6BAC3B,UAAU,iBAAiB,wBAC3B,UAAU,iBAAiB,wBAC3B,UAAU,iBAAiB,0BAC3B,UAAU,iBAAiB,6BAC3B,UAAU,iBAAiB,gCAC3B,UAAU,iBAAiB,+BAC3B,UAAU,iBAAiB,+BAC3B,UAAU,iBAAiB,8BAC3B,UAAU,iBAAiB,sBAC3B,UAAU,iBAAiB,wBAC3B,UAAU,iBAAiB;;AAY/B,SAAgB,kBACd,YACgB;AAChB,KAAI,CAAC,WAAY,QAAO;AACxB,KAAI,WAAW,WAAW,IAAI,IAAI,CAAC,WAAW,WAAW,KAAK,CAC5D,QAAO;AAGT,KAAI;EACF,MAAM,WACJ,OAAO,WAAW,cACd,OAAO,SAAS,OAChB;EACN,MAAM,MAAM,IAAI,IAAI,YAAY,SAAS;EACzC,MAAM,UAAU,IAAI,IAAI,SAAS;EACjC,MAAM,WAAW,IAAI,SAAS,aAAa;AAE3C,MACE,aAAa,eACb,aAAa,eACb,aAAa,QAEb,QAAO;AAGT,SAAO,IAAI,WAAW,QAAQ,SAAS,gBAAgB;SACjD;AACN,SAAO;;;;;;;;;;;AAYX,SAAgB,MACd,OACA,aAAsC,EAAE,EAClC;AACN,KAAIA,yCAAqB,CAAE;AAE3B,KAAI;EACF,MAAM,aAAaC,oDAAgC;EACnD,MAAM,qBAAqB,yBAAyB,MAAM,GACtD;GACE,cAAc;GACd,iBAAiB;GACjB,uBAAuB;GACxB,GACD,EAAE;AAgBN,EAAK,eAAe,sBAfP,KAAK,UAAU;GAC1B;GACA,YAAY;IACV,GAAG;IACH,GAAG;IACH,aAAa;IACd;GACD,SAAS;IACP,MAAM;IACN,GAAI,yBAAyB,MAAM,GAC/B,EAAE,SAAS,iBAAiB,GAC5B,EAAE;IACP;GACD,IAAI,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK;GAClC,CAAC,EAC8C,WAAW;SACrD;;AAkBV,SAAgB,kBAAkB,OAIzB;AACP,OAAM,iBAAiB,cAAc,MAAM;;AAG7C,SAAgB,mBAAmB,OAI1B;AACP,OAAM,iBAAiB,eAAe,MAAM;;;;;;;;;;AAW9C,SAAgB,qBAAqB,OAI5B;AACP,OAAM,iBAAiB,iBAAiB,MAAM;;;;;;;AAoChD,SAAgB,qBACd,OACM;AACN,OAAM,iBAAiB,QAAQ,MAAM;;;AA4DvC,SAAS,uBAAuB,OAAsC;AACpE,QAAO;EACL,GAAI,MAAM,wBAAwB,SAC9B,EAAE,GACF,EAAE,qBAAqB,MAAM,qBAAqB;EACtD,GAAI,MAAM,0BAA0B,SAChC,EAAE,GACF,EAAE,uBAAuB,MAAM,uBAAuB;EAC1D,GAAI,MAAM,mBAAmB,SACzB,EAAE,GACF,EAAE,gBAAgB,MAAM,gBAAgB;EAC5C,GAAI,MAAM,iBAAiB,SACvB,EAAE,GACF,EAAE,cAAc,MAAM,cAAc;EACxC,GAAI,MAAM,qBAAqB,SAC3B,EAAE,GACF,EAAE,kBAAkB,MAAM,kBAAkB;EAChD,GAAI,MAAM,uBAAuB,SAC7B,EAAE,GACF,EAAE,oBAAoB,MAAM,oBAAoB;EACpD,GAAI,MAAM,gBAAgB,SACtB,EAAE,GACF,EAAE,aAAa,MAAM,aAAa;EACtC,GAAI,MAAM,iBAAiB,SACvB,EAAE,GACF,EAAE,cAAc,MAAM,cAAc;EACxC,GAAI,MAAM,kBAAkB,SACxB,EAAE,GACF,EAAE,eAAe,MAAM,eAAe;EAC1C,GAAI,MAAM,cAAc,SAAY,EAAE,GAAG,EAAE,WAAW,MAAM,WAAW;EACvE,GAAI,MAAM,aAAa,SAAY,EAAE,GAAG,EAAE,UAAU,MAAM,UAAU;EACrE;;;AAIH,SAAS,oBAAoB,OAAsC;AACjE,QAAO;EACL,GAAG,uBAAuB,MAAM;EAChC,GAAI,MAAM,QAAQ,SAAY,EAAE,GAAG,EAAE,KAAK,MAAM,KAAK;EACrD,GAAI,MAAM,gBAAgB,SACtB,EAAE,GACF,EAAE,aAAa,MAAM,aAAa;EACtC,GAAI,MAAM,wBAAwB,SAC9B,EAAE,GACF,EAAE,qBAAqB,MAAM,qBAAqB;EACvD;;;AAIH,SAAS,wBAAwB,OAAsC;AACrE,QAAO;EACL,GAAG,uBAAuB,MAAM;EAChC,GAAI,MAAM,iBAAiB,SACvB,EAAE,GACF,EAAE,cAAc,MAAM,cAAc;EACzC;;;AAIH,SAAS,qBAAqB,OAAsC;AAClE,QAAO;EACL,GAAG,wBAAwB,MAAM;EACjC,GAAI,MAAM,cAAc,SAAY,EAAE,GAAG,EAAE,WAAW,MAAM,WAAW;EACvE,GAAI,MAAM,aAAa,SAAY,EAAE,GAAG,EAAE,UAAU,MAAM,UAAU;EACrE;;;AAIH,SAAS,6BAA6B,OAAsC;AAC1E,QAAO;EACL,GAAG,qBAAqB,MAAM;EAC9B,GAAI,MAAM,mBAAmB,SACzB,EAAE,GACF,EAAE,gBAAgB,MAAM,gBAAgB;EAC7C;;AAGH,SAAgB,uBACd,QAAuC,EAAE,EACnC;AACN,OAAM,iBAAiB,mBAAmB,uBAAuB,MAAM,CAAC;;AAG1E,SAAgB,yBACd,OACM;AACN,OAAM,iBAAiB,qBAAqB,uBAAuB,MAAM,CAAC;;AAG5E,SAAgB,sCACd,OACM;AACN,OACE,iBAAiB,kCACjB,oBAAoB,MAAM,CAC3B;;AAGH,SAAgB,kCACd,OACM;AACN,OACE,iBAAiB,8BACjB,oBAAoB,MAAM,CAC3B;;AAGH,SAAgB,2BACd,OACM;AACN,OAAM,iBAAiB,uBAAuB,oBAAoB,MAAM,CAAC;;AAG3E,SAAgB,+BACd,OACM;AACN,OACE,iBAAiB,2BACjB,uBAAuB,MAAM,CAC9B;;AAGH,SAAgB,0BACd,OACM;AACN,OAAM,iBAAiB,sBAAsB,uBAAuB,MAAM,CAAC;;AAG7E,SAAgB,0BACd,OACM;AACN,OAAM,iBAAiB,sBAAsB,wBAAwB,MAAM,CAAC;;AAG9E,SAAgB,4BACd,OACM;AACN,OACE,iBAAiB,wBACjB,wBAAwB,MAAM,CAC/B;;AAGH,SAAgB,+BACd,OACM;AACN,OACE,iBAAiB,2BACjB,qBAAqB,MAAM,CAC5B;;AAGH,SAAgB,kCACd,OACM;AACN,OACE,iBAAiB,8BACjB,qBAAqB,MAAM,CAC5B;;AAGH,SAAgB,iCACd,OACM;AACN,OACE,iBAAiB,6BACjB,6BAA6B,MAAM,CACpC;;AAGH,SAAgB,iCACd,OACM;AACN,OACE,iBAAiB,6BACjB,6BAA6B,MAAM,CACpC;;AAGH,SAAgB,gCACd,OACM;AACN,OACE,iBAAiB,4BACjB,qBAAqB,MAAM,CAC5B;;AAYH,SAAgB,wBACd,QAAuC,EAAE,EACnC;AACN,OAAM,iBAAiB,oBAAoB,MAAM;;AAmCnD,SAAS,yBACP,OAGA;CACA,MAAM,aACJ,MAAM,cAAc,UAAa,MAAM,aAAa,SAChD,EAAE,GACF;EAAE,WAAW,MAAM;EAAW,UAAU,MAAM;EAAU;AAC9D,QAAO;EACL,gBAAgB,MAAM;EACtB,cAAc,MAAM;EACpB,eAAe,MAAM;EACrB,GAAG;EACH,GAAI,MAAM,qBAAqB,SAC3B,EAAE,GACF,EAAE,kBAAkB,MAAM,kBAAkB;EACjD;;;;;;;AAQH,SAAgB,0BACd,OACM;AACN,OAAM,iBAAiB,sBAAsB;EAC3C,QAAQ,MAAM;EACd,GAAI,MAAM,gBAAgB,SACtB,EAAE,GACF,EAAE,aAAa,MAAM,aAAa;EACtC,GAAG,yBAAyB,MAAM;EACnC,CAAC;;;;;;;AAQJ,SAAgB,2BACd,OACM;AACN,OAAM,iBAAiB,uBAAuB;EAC5C,QAAQ;EACR,aAAa,MAAM;EACnB,GAAG,yBAAyB,MAAM;EACnC,CAAC;;;;;;;;;;;;;;;;;AAkBJ,SAAgB,+BAA8C;AAC5D,KAAID,yCAAqB,CAAE,QAAO;AAClC,QAAOC,oDAAgC;;;;;;;AAQzC,SAAgB,4BAAkC;AAChD,KAAID,yCAAqB,CAAE;AAC3B,qDAAgC;;;;;;;;;;;AAYlC,SAAgB,sBAA4B;AAC1C,KAAIA,yCAAqB,CAAE;AAC3B,KAAIE,qDAAiC,CAAE;AAEvC,SAAQ,KACN,wEAAwE,mBAAmB,cAC5F;AACD,mDAA8B;;AAKhC,eAAe,eACb,KACA,MACA,YACe;AACf,KAAI,OAAO,UAAU,YAAa;CAClC,IAAI;AACJ,KAAI;EACF,MAAM,aAAa,IAAI,iBAAiB;AACxC,cAAY,iBAAiB,WAAW,OAAO,EAAE,iBAAiB;AAClE,QAAM,MAAM,KAAK;GACf,QAAQ;GACR,SAAS;IACP,gBAAgB;IAChB,6BAA6B;IAC9B;GACD;GACA,QAAQ,WAAW;GAEpB,CAAC;SACI,WAEE;AACR,MAAI,cAAc,OAAW,cAAa,UAAU"}
+{"version":3,"file":"telemetry.cjs","names":["isTelemetryOptedOut","getOrCreateTelemetryDistinctId","hasTelemetryDisclosureBeenShown"],"sources":["../../src/lib/telemetry.ts"],"sourcesContent":["// Inspector-side anonymous telemetry. V1 events fire from index.ts for\n// What's new and thread-inspection interactions. POSTs directly from the\n// browser to the CopilotKit telemetry sink at\n// `telemetry.copilotkit.ai/ingest`, where a Lambda fan-out forwards events to\n// PostHog / Reo / Scarf.\n//\n// The endpoint URL is intentionally clearly named so it's obvious in\n// DevTools / Network tab — transparency for opt-in users.\n//\n// Privacy invariants enforced here:\n//   - We never send message content, agent state, prompts, completions,\n//     or announcement markdown. Feature-specific properties are scoped to\n//     event metadata only (banner_id/timestamp, cta location). Reviewers\n//     should grep call sites for any unintended payload.\n//   - The opt-out short-circuits before any network call. There is no\n//     buffer, no retry queue.\n//   - All errors are swallowed; telemetry must never break the host app.\n\nimport {\n  getOrCreateTelemetryDistinctId,\n  hasTelemetryDisclosureBeenShown,\n  isTelemetryOptedOut,\n  markTelemetryDisclosureShown,\n} from \"./persistence.js\";\nimport packageJson from \"../../package.json\" with { type: \"json\" };\n\n// V1 funnel events. Namespaced `oss.inspector.*` so the lambda's\n// owned-prefix gate (oss-path-to-production) can accept them server-side\n// without a per-event sink deploy.\nexport const TELEMETRY_EVENTS = {\n  opened: \"oss.inspector.opened\",\n  whatsNewViewed: \"oss.inspector.whats_new_viewed\",\n  whatsNewSignalViewed: \"oss.inspector.whats_new_signal_viewed\",\n  errorSignalViewed: \"oss.inspector.error_signal_viewed\",\n  whatsNewClicked: \"oss.inspector.whats_new_clicked\",\n  threadsTabClicked: \"oss.inspector.threads_tab_clicked\",\n  threadsLockedViewed: \"oss.inspector.threads_locked_viewed\",\n  threadsIntelligenceSignupClicked:\n    \"oss.inspector.threads_intelligence_signup_clicked\",\n  threadsTalkToEngineerClicked:\n    \"oss.inspector.threads_talk_to_engineer_clicked\",\n  talkToEngineerClicked: \"oss.inspector.talk_to_engineer_clicked\",\n  threadsEmptyEnabledViewed: \"oss.inspector.threads_empty_enabled_viewed\",\n  threadsEnabledViewed: \"oss.inspector.threads_enabled_viewed\",\n  threadsExampleViewed: \"oss.inspector.threads_example_viewed\",\n  threadsExampleSelected: \"oss.inspector.threads_example_selected\",\n  threadsExampleTourStarted: \"oss.inspector.threads_example_tour_started\",\n  threadsExampleTourStepViewed:\n    \"oss.inspector.threads_example_tour_step_viewed\",\n  threadsExampleTourDismissed: \"oss.inspector.threads_example_tour_dismissed\",\n  threadsExampleTourCompleted: \"oss.inspector.threads_example_tour_completed\",\n  threadsExampleTourReopened: \"oss.inspector.threads_example_tour_reopened\",\n  memoriesTabClicked: \"oss.inspector.memories_tab_clicked\",\n  homeViewed: \"oss.inspector.home_viewed\",\n  homeCtaClicked: \"oss.inspector.home_cta_clicked\",\n  metadataModuleViewed: \"oss.inspector.metadata_module_viewed\",\n  metadataActionClicked: \"oss.inspector.metadata_action_clicked\",\n  eventSnippetsRun: \"oss.inspector.event_snippets_run\",\n  eventSnippetsSaved: \"oss.inspector.event_snippets_saved\",\n} as const;\n\nexport type TelemetryEvent =\n  (typeof TELEMETRY_EVENTS)[keyof typeof TELEMETRY_EVENTS];\n\n// Per the OSS-96 ticket — the URL is intentionally clearly named for\n// transparency in the network tab.\nexport const TELEMETRY_INGEST_URL = \"https://telemetry.copilotkit.ai/ingest\";\n\n// Surfaced in console disclosure and the in-product opt-out panel.\n// Keep in sync with the live shell-docs telemetry page\n// (`showcase/shell-docs/src/content/docs/integrations/built-in-agent/telemetry.mdx`).\n// Mirror constant: packages/runtime/src/v1-deprecated/lib/telemetry-disclosure.ts\nexport const TELEMETRY_DOCS_URL = \"https://docs.copilotkit.ai/telemetry\";\n\nconst PACKAGE_NAME = \"@copilotkit/web-inspector\";\nconst PACKAGE_VERSION = packageJson.version;\n\n// 3-second cap so a slow gateway can't hang the host app. Matches the\n// runtime's existing scarf-client convention.\nconst FETCH_TIMEOUT_MS = 3000;\n\nexport type RuntimeUrlType =\n  | \"missing\"\n  | \"relative\"\n  | \"localhost\"\n  | \"same_origin\"\n  | \"remote\"\n  | \"invalid\";\n\nexport function getRuntimeUrlType(\n  runtimeUrl: string | undefined,\n): RuntimeUrlType {\n  if (!runtimeUrl) return \"missing\";\n  if (runtimeUrl.startsWith(\"/\") && !runtimeUrl.startsWith(\"//\")) {\n    return \"relative\";\n  }\n\n  try {\n    const baseHref =\n      typeof window !== \"undefined\"\n        ? window.location.href\n        : \"https://copilotkit.ai\";\n    const url = new URL(runtimeUrl, baseHref);\n    const baseUrl = new URL(baseHref);\n    const hostname = url.hostname.toLowerCase();\n\n    if (\n      hostname === \"localhost\" ||\n      hostname === \"127.0.0.1\" ||\n      hostname === \"[::1]\"\n    ) {\n      return \"localhost\";\n    }\n\n    return url.origin === baseUrl.origin ? \"same_origin\" : \"remote\";\n  } catch {\n    return \"invalid\";\n  }\n}\n\n/**\n * Fire-and-forget telemetry send. Returns synchronously; the network\n * call is dispatched in the background and any failure is swallowed.\n *\n * Short-circuits when the user has opted out. Does NOT itself trigger\n * the first-run disclosure — call `maybeShowDisclosure()` from the\n * inspector's mount lifecycle instead.\n */\nexport function track(\n  event: TelemetryEvent,\n  properties: Record<string, unknown> = {},\n): void {\n  if (isTelemetryOptedOut()) return;\n\n  try {\n    const distinctId = getOrCreateTelemetryDistinctId();\n    // Every event carries package identity and the inspector's anonymous\n    // distinct-ID, so any of them can be segmented by inspector version.\n    const body = JSON.stringify({\n      event,\n      properties: {\n        ...properties,\n        package_name: PACKAGE_NAME,\n        package_version: PACKAGE_VERSION,\n        inspector_distinct_id: distinctId,\n        distinct_id: distinctId,\n      },\n      package: {\n        name: PACKAGE_NAME,\n        version: PACKAGE_VERSION,\n      },\n      ts: Math.floor(Date.now() / 1000),\n    });\n    void postBestEffort(TELEMETRY_INGEST_URL, body, distinctId);\n  } catch {\n    // Identity and serialization failures are best-effort too.\n  }\n}\n\n// --- Typed per-event helpers ---\n// These enforce the known property shape for each V1 event at the call\n// site, so callers can't accidentally include PII under a wrong key.\n\n/**\n * Where an announcement was rendered when the event fired. What's new is the\n * only surface that carries one, so the value is currently a constant — it\n * stays a stamped property rather than an inferred one so a second surface\n * can be added without changing the event's shape.\n */\nexport type WhatsNewSurface = \"whats_new\";\n\n/**\n * Whether a launcher signal was animated, or held static because the reader\n * asked for reduced motion. Shared by every launcher signal so an\n * accessibility setting is never mistaken for disinterest.\n */\nexport type LauncherSignalPresentation = \"animated\" | \"reduced_motion\";\n\nexport type WhatsNewSignalPresentation = LauncherSignalPresentation;\n\n/**\n * Which failure class raised the launcher's error signal. A closed enum: the\n * failure *message* is never transmitted, so prompts, URLs and identifiers\n * embedded in an error cannot leave the browser.\n *\n * `connection` and `threads` are wiring *state*. `run`, `tool` and `memory`\n * are unread *events* that clear when their landing view is read.\n */\nexport type InspectorWiringErrorSource = \"connection\" | \"threads\";\nexport type InspectorEventErrorSource = \"run\" | \"tool\" | \"memory\";\nexport type InspectorErrorSignalSource =\n  | InspectorWiringErrorSource\n  | InspectorEventErrorSource;\n\n/**\n * Fires when What's new has rendered *with content*. A loading state is not\n * an impression, so the metric cannot inflate itself by counting readers who\n * arrived before the feed resolved.\n */\nexport function trackWhatsNewViewed(props: {\n  banner_id: string;\n  surface: WhatsNewSurface;\n  cta_label?: string;\n}): void {\n  track(TELEMETRY_EVENTS.whatsNewViewed, props);\n}\n\n/** Fires when the unread launcher signal is presented in a visible tab. */\nexport function trackWhatsNewSignalViewed(props: {\n  banner_id: string;\n  surface: \"launcher\";\n  presentation: WhatsNewSignalPresentation;\n  cta_label?: string;\n}): void {\n  track(TELEMETRY_EVENTS.whatsNewSignalViewed, props);\n}\n\n/**\n * Whether the launcher opened its pill for this outage, or suppressed it.\n *\n * `suppressed` means no pill was shown. In practice that is the no-room\n * fallback — neither side of the launcher had space for the label — because\n * every other path to a visible error signal opens one.\n */\nexport type InspectorErrorSignalLabel = \"shown\" | \"suppressed\";\n\n/**\n * Fires when the launcher's error signal becomes *visible* — not when it arms.\n * Arming can happen with the panel open or the tab hidden, where there is no\n * launcher to look at, so counting arms would inflate the denominator this\n * event exists to provide.\n *\n * Deliberately carries three fixed enum values and nothing else. This is the\n * one place a later change could casually attach a free-text field, and the\n * failure message must never be transmitted.\n *\n * `label` is deliberately not a new event: the catalogue's size is asserted\n * and spelled out in a test title, and a property answers the one open\n * question — how often the no-room fallback fires — without touching either.\n *\n * The pill's own marginal effect cannot be measured here and must not be\n * reverse-engineered from this data: it ships together with the dot and the\n * beat, so there is no period with one and not the other.\n */\nexport function trackErrorSignalViewed(props: {\n  source: InspectorErrorSignalSource;\n  presentation: LauncherSignalPresentation;\n  label: InspectorErrorSignalLabel;\n}): void {\n  track(TELEMETRY_EVENTS.errorSignalViewed, {\n    source: props.source,\n    presentation: props.presentation,\n    label: props.label,\n  });\n}\n\n/**\n * Fires for links followed inside the announcement body. `body` is the only\n * call-to-action left: dismissal no longer exists, so there is nothing else a\n * click on this surface can mean.\n */\nexport function trackWhatsNewClicked(props: {\n  banner_id: string;\n  cta: \"body\";\n  cta_label?: string;\n}): void {\n  track(TELEMETRY_EVENTS.whatsNewClicked, props);\n}\n\n/**\n * How the panel was opened. Restoring a persisted-open panel on mount is\n * deliberately NOT a source: it is not an open *intent*, and counting it\n * would turn every dev-server hot reload into an \"open\".\n */\nexport type InspectorOpenSource = \"floating_button\" | \"message_toolbar\";\n\nexport type InspectorOpenedTelemetryProps = {\n  open_source: InspectorOpenSource;\n  package_name?: typeof PACKAGE_NAME;\n  package_version?: string;\n  inspector_distinct_id?: string;\n  license_status?:\n    | \"valid\"\n    | \"none\"\n    | \"expired\"\n    | \"expiring\"\n    | \"invalid\"\n    | \"unknown\";\n  runtime_mode?: \"sse\" | \"intelligence\";\n  runtime_url_type?: RuntimeUrlType;\n  /** True when an unseen announcement was on screen at open time. */\n  has_unseen_announcement?: boolean;\n  /** True when an error signal was on the launcher at open time. */\n  has_error_signal?: boolean;\n  /** Which failure class was signalling at open time, when one was. */\n  error_signal_source?: InspectorErrorSignalSource;\n  /** True when this is the first Inspector open after install or upgrade. */\n  first_open?: boolean;\n};\n\n/**\n * Panel-open signal (OSS-566). Before this event, opens could only be\n * inferred from in-panel activity (a floor) or from the announcement's own\n * click event (which misses the floating-button path entirely).\n */\nexport function trackInspectorOpened(\n  props: InspectorOpenedTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.opened, props);\n}\n\nexport type ExampleKind = \"realtime_sync\" | \"manage_history\" | \"inspect_runs\";\nexport type ThreadsUsageBucket =\n  | \"absent\"\n  | \"empty\"\n  | \"within_limit\"\n  | \"at_or_over_limit\"\n  | \"unlimited\"\n  | \"unknown_limit\";\nexport type ThreadsExpiryBucket = \"unavailable\" | \"zero\" | \"positive\";\nexport type InspectorGroupKey = \"home\" | \"workbench\" | \"inspect\";\nexport type InspectorLeafKey =\n  | \"home\"\n  | \"whats-new\"\n  | \"playground\"\n  | \"threads\"\n  | \"ag-ui-events\"\n  | \"event-snippets\"\n  | \"agents\"\n  | \"frontend-tools\"\n  | \"capabilities\"\n  | \"agent-context\"\n  | \"memories\";\nexport type MetadataActionPlacement = \"threads_footer\" | \"threads_locked\";\nexport type ExampleTourStep = 1 | 2 | 3;\nexport type ExampleTourTab = \"timeline\" | \"raw-events\" | \"state\";\n\nexport type InspectorThreadTelemetryProps = Readonly<{\n  posthog_distinct_id?: string;\n  intelligence_status?:\n    | \"intelligence_not_enabled\"\n    | \"intelligence_enabled\"\n    | \"unknown\";\n  thread_service_status?: \"unavailable\" | \"available\" | \"unknown\" | \"error\";\n  license_status?:\n    | \"valid\"\n    | \"none\"\n    | \"expired\"\n    | \"expiring\"\n    | \"invalid\"\n    | \"unknown\";\n  runtime_mode?: \"sse\" | \"intelligence\";\n  runtime_url_type?: RuntimeUrlType;\n  cta_surface?:\n    | \"threads_locked\"\n    | \"threads_header\"\n    | \"threads_empty\"\n    | \"threads_populated\"\n    | \"sidebar_footer\";\n  cta?: \"signup\" | \"talk_to_engineer\";\n  telemetry_disabled?: boolean;\n  has_threads?: boolean;\n  usage_bucket?: ThreadsUsageBucket;\n  expiry_bucket?: ThreadsExpiryBucket;\n  group_key?: InspectorGroupKey;\n  leaf_key?: InspectorLeafKey;\n  example_kind?: ExampleKind;\n  tour_step?: ExampleTourStep;\n  tour_tab?: ExampleTourTab;\n  dismiss_method?: \"skip\" | \"done\";\n}>;\n\n/** Rebuild the common Thread payload from its closed coarse allowlist. */\nfunction threadCommonProperties(props: InspectorThreadTelemetryProps) {\n  return {\n    ...(props.intelligence_status === undefined\n      ? {}\n      : { intelligence_status: props.intelligence_status }),\n    ...(props.thread_service_status === undefined\n      ? {}\n      : { thread_service_status: props.thread_service_status }),\n    ...(props.license_status === undefined\n      ? {}\n      : { license_status: props.license_status }),\n    ...(props.runtime_mode === undefined\n      ? {}\n      : { runtime_mode: props.runtime_mode }),\n    ...(props.runtime_url_type === undefined\n      ? {}\n      : { runtime_url_type: props.runtime_url_type }),\n    ...(props.telemetry_disabled === undefined\n      ? {}\n      : { telemetry_disabled: props.telemetry_disabled }),\n    ...(props.has_threads === undefined\n      ? {}\n      : { has_threads: props.has_threads }),\n    ...(props.usage_bucket === undefined\n      ? {}\n      : { usage_bucket: props.usage_bucket }),\n    ...(props.expiry_bucket === undefined\n      ? {}\n      : { expiry_bucket: props.expiry_bucket }),\n    ...(props.group_key === undefined ? {} : { group_key: props.group_key }),\n    ...(props.leaf_key === undefined ? {} : { leaf_key: props.leaf_key }),\n  };\n}\n\n/** Add only the fields used by the three Thread CTA funnels. */\nfunction threadCtaProperties(props: InspectorThreadTelemetryProps) {\n  return {\n    ...threadCommonProperties(props),\n    ...(props.cta === undefined ? {} : { cta: props.cta }),\n    ...(props.cta_surface === undefined\n      ? {}\n      : { cta_surface: props.cta_surface }),\n    ...(props.posthog_distinct_id === undefined\n      ? {}\n      : { posthog_distinct_id: props.posthog_distinct_id }),\n  };\n}\n\n/** Add only the closed example kind used by example impressions/selections. */\nfunction threadExampleProperties(props: InspectorThreadTelemetryProps) {\n  return {\n    ...threadCommonProperties(props),\n    ...(props.example_kind === undefined\n      ? {}\n      : { example_kind: props.example_kind }),\n  };\n}\n\n/** Add only a bounded example kind and tour step/tab pair. */\nfunction threadTourProperties(props: InspectorThreadTelemetryProps) {\n  return {\n    ...threadExampleProperties(props),\n    ...(props.tour_step === undefined ? {} : { tour_step: props.tour_step }),\n    ...(props.tour_tab === undefined ? {} : { tour_tab: props.tour_tab }),\n  };\n}\n\n/** Add the bounded dismissal leaf used only by terminal tour events. */\nfunction threadTourTerminalProperties(props: InspectorThreadTelemetryProps) {\n  return {\n    ...threadTourProperties(props),\n    ...(props.dismiss_method === undefined\n      ? {}\n      : { dismiss_method: props.dismiss_method }),\n  };\n}\n\nexport function trackThreadsTabClicked(\n  props: InspectorThreadTelemetryProps = {},\n): void {\n  track(TELEMETRY_EVENTS.threadsTabClicked, threadCommonProperties(props));\n}\n\nexport function trackThreadsLockedViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsLockedViewed, threadCommonProperties(props));\n}\n\nexport function trackThreadsIntelligenceSignupClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsIntelligenceSignupClicked,\n    threadCtaProperties(props),\n  );\n}\n\nexport function trackThreadsTalkToEngineerClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsTalkToEngineerClicked,\n    threadCtaProperties(props),\n  );\n}\n\nexport function trackTalkToEngineerClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.talkToEngineerClicked, threadCtaProperties(props));\n}\n\nexport function trackThreadsEmptyEnabledViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsEmptyEnabledViewed,\n    threadCommonProperties(props),\n  );\n}\n\nexport function trackThreadsEnabledViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsEnabledViewed, threadCommonProperties(props));\n}\n\nexport function trackThreadsExampleViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleViewed, threadExampleProperties(props));\n}\n\nexport function trackThreadsExampleSelected(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsExampleSelected,\n    threadExampleProperties(props),\n  );\n}\n\nexport function trackThreadsExampleTourStarted(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsExampleTourStarted,\n    threadTourProperties(props),\n  );\n}\n\nexport function trackThreadsExampleTourStepViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsExampleTourStepViewed,\n    threadTourProperties(props),\n  );\n}\n\nexport function trackThreadsExampleTourDismissed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsExampleTourDismissed,\n    threadTourTerminalProperties(props),\n  );\n}\n\nexport function trackThreadsExampleTourCompleted(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsExampleTourCompleted,\n    threadTourTerminalProperties(props),\n  );\n}\n\nexport function trackThreadsExampleTourReopened(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(\n    TELEMETRY_EVENTS.threadsExampleTourReopened,\n    threadTourProperties(props),\n  );\n}\n\nexport type InspectorMemoryTelemetryProps = {\n  package_name?: typeof PACKAGE_NAME;\n  package_version?: string;\n  inspector_distinct_id?: string;\n  posthog_distinct_id?: string;\n  memory_count?: number;\n  available?: boolean;\n};\n\nexport function trackMemoriesTabClicked(\n  props: InspectorMemoryTelemetryProps = {},\n): void {\n  track(TELEMETRY_EVENTS.memoriesTabClicked, props);\n}\n\nexport type InspectorMetadataTelemetryModule = \"identity\" | \"plan\" | \"action\";\nexport type InspectorMetadataLicenseBucket =\n  | \"valid\"\n  | \"none\"\n  | \"expired\"\n  | \"unknown\";\nexport type InspectorMetadataActionKind =\n  | \"manage_plan\"\n  | \"renew\"\n  | \"enable_intelligence\";\n\nexport type InspectorHomeTelemetryProps = Readonly<{\n  action_kind?: InspectorMetadataActionKind;\n  group_key?: InspectorGroupKey;\n  leaf_key?: InspectorLeafKey;\n}>;\n\nexport function trackHomeViewed(props: InspectorHomeTelemetryProps = {}): void {\n  track(TELEMETRY_EVENTS.homeViewed, {\n    group_key: props.group_key ?? \"home\",\n    leaf_key: props.leaf_key ?? \"home\",\n  });\n}\n\nexport function trackHomeCtaClicked(props: InspectorHomeTelemetryProps): void {\n  track(TELEMETRY_EVENTS.homeCtaClicked, {\n    action_kind: props.action_kind,\n    group_key: props.group_key ?? \"home\",\n    leaf_key: props.leaf_key ?? \"home\",\n  });\n}\n\nexport type InspectorMetadataModuleViewedTelemetryProps = Readonly<{\n  module: InspectorMetadataTelemetryModule;\n  license_bucket: InspectorMetadataLicenseBucket;\n  action_kind?: InspectorMetadataActionKind;\n  usage_bucket: ThreadsUsageBucket;\n  expiry_bucket: ThreadsExpiryBucket;\n  group_key?: InspectorGroupKey;\n  leaf_key?: InspectorLeafKey;\n  action_placement?: MetadataActionPlacement;\n}>;\n\nexport type InspectorMetadataActionClickedTelemetryProps = Readonly<{\n  action_kind: Exclude<InspectorMetadataActionKind, \"enable_intelligence\">;\n  license_bucket: InspectorMetadataLicenseBucket;\n  usage_bucket: ThreadsUsageBucket;\n  expiry_bucket: ThreadsExpiryBucket;\n  group_key?: InspectorGroupKey;\n  leaf_key?: InspectorLeafKey;\n  action_placement?: MetadataActionPlacement;\n}>;\n\nfunction metadataCoarseProperties(\n  props:\n    | InspectorMetadataModuleViewedTelemetryProps\n    | InspectorMetadataActionClickedTelemetryProps,\n) {\n  const navigation =\n    props.group_key === undefined || props.leaf_key === undefined\n      ? {}\n      : { group_key: props.group_key, leaf_key: props.leaf_key };\n  return {\n    license_bucket: props.license_bucket,\n    usage_bucket: props.usage_bucket,\n    expiry_bucket: props.expiry_bucket,\n    ...navigation,\n    ...(props.action_placement === undefined\n      ? {}\n      : { action_placement: props.action_placement }),\n  };\n}\n\n/**\n * Tracks one visible Inspector metadata module using coarse fields only.\n * Rebuilding the payload here prevents local labels, IDs, URLs, and usage\n * values from crossing the telemetry boundary through extra object fields.\n */\nexport function trackMetadataModuleViewed(\n  props: InspectorMetadataModuleViewedTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.metadataModuleViewed, {\n    module: props.module,\n    ...(props.action_kind === undefined\n      ? {}\n      : { action_kind: props.action_kind }),\n    ...metadataCoarseProperties(props),\n  });\n}\n\n/**\n * Tracks clicks for managed plan and renewal actions. The existing\n * Intelligence-enable funnel keeps its original event and never calls this\n * helper, which prevents a single click from producing two wire events.\n */\nexport function trackMetadataActionClicked(\n  props: InspectorMetadataActionClickedTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.metadataActionClicked, {\n    module: \"action\",\n    action_kind: props.action_kind,\n    ...metadataCoarseProperties(props),\n  });\n}\n\nexport type EventSnippetRecipeKind =\n  | \"tool-call\"\n  | \"reasoning\"\n  | \"text\"\n  | \"activity\"\n  | \"raw\";\n\nexport type EventSnippetSource = \"chat\" | \"pane\";\n\nexport function trackEventSnippetsRun(props: {\n  recipe: EventSnippetRecipeKind;\n  source: EventSnippetSource;\n  success: boolean;\n}): void {\n  track(TELEMETRY_EVENTS.eventSnippetsRun, {\n    recipe: props.recipe,\n    source: props.source,\n    success: props.success,\n  });\n}\n\nexport function trackEventSnippetsSaved(props: {\n  recipe: EventSnippetRecipeKind;\n  source: EventSnippetSource;\n  success: boolean;\n}): void {\n  track(TELEMETRY_EVENTS.eventSnippetsSaved, {\n    recipe: props.recipe,\n    source: props.source,\n    success: props.success,\n  });\n}\n\n/**\n * Returns the inspector's anonymous distinct-ID for cross-domain\n * propagation onto outbound announcement-CTA links, or `null` when the user\n * is opted out.\n *\n * The website / Ops API reads this query param on signup-flow landing\n * pages and calls `posthog.alias(...)` to merge the inspector's anon\n * ID with the website's anon ID, enabling the\n * `whats_new_viewed → whats_new_clicked → signup_attributed` funnel.\n * `identify()` itself is out of scope here (it happens on signup, in\n * the website / Ops API).\n *\n * Opt-out short-circuits this too: if the user has opted out, we do\n * NOT leak an anon ID across domains.\n */\nexport function getTelemetryDistinctIdForUrl(): string | null {\n  if (isTelemetryOptedOut()) return null;\n  return getOrCreateTelemetryDistinctId();\n}\n\n/**\n * Seeds the anonymous distinct-ID into localStorage on inspector mount\n * so it is ready for cross-domain propagation onto announcement-CTA links\n * even before the first event fires. No-op when the user has opted out.\n */\nexport function ensureTelemetryDistinctId(): void {\n  if (isTelemetryOptedOut()) return;\n  getOrCreateTelemetryDistinctId();\n}\n\n/**\n * Fires the one-time console disclosure on inspector mount, when the\n * user is not opted out and hasn't seen it before. Idempotent across\n * calls within a single session because `markTelemetryDisclosureShown`\n * persists to localStorage.\n *\n * If the user is opted out, we deliberately do nothing and do NOT mark\n * the flag — so a future opt-in flips back to \"first run\" behavior.\n */\nexport function maybeShowDisclosure(): void {\n  if (isTelemetryOptedOut()) return;\n  if (hasTelemetryDisclosureBeenShown()) return;\n  // eslint-disable-next-line no-console\n  console.info(\n    `[CopilotKit Inspector] anonymous interaction telemetry enabled — see ${TELEMETRY_DOCS_URL} to opt out.`,\n  );\n  markTelemetryDisclosureShown();\n}\n\nexport { isTelemetryOptedOut };\n\nasync function postBestEffort(\n  url: string,\n  body: string,\n  distinctId: string,\n): Promise<void> {\n  if (typeof fetch === \"undefined\") return;\n  let timeoutId: ReturnType<typeof setTimeout> | undefined;\n  try {\n    const controller = new AbortController();\n    timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n    await fetch(url, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-CopilotKit-Telemetry-Id\": distinctId,\n      },\n      body,\n      signal: controller.signal,\n      // No credentials / no Authorization header — anonymous endpoint.\n    });\n  } catch {\n    // Silent failure — telemetry must not break the application.\n  } finally {\n    if (timeoutId !== undefined) clearTimeout(timeoutId);\n  }\n}\n"],"mappings":"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"}

package/dist/lib/telemetry.d.cts

@@ -4,7 +4,7 @@
  * deliberately NOT a source: it is not an open *intent*, and counting it
  * would turn every dev-server hot reload into an "open".
  */
-type InspectorOpenSource = "floating_button" | "announcement_preview" | "message_toolbar";
+type InspectorOpenSource = "floating_button" | "message_toolbar";
 //#endregion
 export { InspectorOpenSource };
 //# sourceMappingURL=telemetry.d.cts.map

package/dist/lib/telemetry.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.cts","names":[],"sources":["../../src/lib/telemetry.ts"],"mappings":";;;;;;KA6OY,mBAAA"}
+{"version":3,"file":"telemetry.d.cts","names":[],"sources":["../../src/lib/telemetry.ts"],"mappings":";;;;;;KAkRY,mBAAA"}