@copilotkit/web-inspector 1.64.2-canary.perfall1 → 1.64.2

package/dist/lib/telemetry.cjs

@@ -3,8 +3,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",
 	threadsTabClicked: "oss.inspector.threads_tab_clicked",
 	threadsLockedViewed: "oss.inspector.threads_locked_viewed",
 	threadsIntelligenceSignupClicked: "oss.inspector.threads_intelligence_signup_clicked",
@@ -26,8 +28,8 @@ 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 isThreadsTelemetryEvent(event) {
-	return 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;
+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;
 }
 function getRuntimeUrlType(runtimeUrl) {
 	if (!runtimeUrl) return "missing";
@@ -54,7 +56,7 @@ function getRuntimeUrlType(runtimeUrl) {
 function track(event, properties = {}) {
 	if (require_persistence.isTelemetryOptedOut()) return;
 	const distinctId = require_persistence.getOrCreateTelemetryDistinctId();
-	const threadsProperties = isThreadsTelemetryEvent(event) ? {
+	const enrichedProperties = isEnrichedTelemetryEvent(event) ? {
 		package_name: PACKAGE_NAME,
 		package_version: PACKAGE_VERSION,
 		inspector_distinct_id: distinctId
@@ -65,12 +67,12 @@ function track(event, properties = {}) {
 			event,
 			properties: {
 				...properties,
-				...threadsProperties,
+				...enrichedProperties,
 				distinct_id: distinctId
 			},
 			package: {
 				name: PACKAGE_NAME,
-				...isThreadsTelemetryEvent(event) ? { version: PACKAGE_VERSION } : {}
+				...isEnrichedTelemetryEvent(event) ? { version: PACKAGE_VERSION } : {}
 			},
 			ts: Math.floor(Date.now() / 1e3)
 		});
@@ -85,6 +87,25 @@ function trackBannerViewed(props) {
 function trackBannerClicked(props) {
 	track(TELEMETRY_EVENTS.bannerClicked, props);
 }
+/**
+* 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.
+*/
+function trackBannerDismissed(props) {
+	track(TELEMETRY_EVENTS.bannerDismissed, 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).
+*/
+function trackInspectorOpened(props) {
+	track(TELEMETRY_EVENTS.opened, props);
+}
 function trackThreadsTabClicked(props = {}) {
 	track(TELEMETRY_EVENTS.threadsTabClicked, props);
 }
@@ -199,7 +220,9 @@ exports.getRuntimeUrlType = getRuntimeUrlType;
 exports.getTelemetryDistinctIdForUrl = getTelemetryDistinctIdForUrl;
 exports.maybeShowDisclosure = maybeShowDisclosure;
 exports.trackBannerClicked = trackBannerClicked;
+exports.trackBannerDismissed = trackBannerDismissed;
 exports.trackBannerViewed = trackBannerViewed;
+exports.trackInspectorOpened = trackInspectorOpened;
 exports.trackMemoriesTabClicked = trackMemoriesTabClicked;
 exports.trackTalkToEngineerClicked = trackTalkToEngineerClicked;
 exports.trackThreadsEmptyEnabledViewed = trackThreadsEmptyEnabledViewed;

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. Properties are scoped to event metadata only\n//     (banner_id/timestamp, cta location). Reviewers should grep call\n//     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  bannerViewed: \"oss.inspector.banner_viewed\",\n  bannerClicked: \"oss.inspector.banner_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} 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 canonical telemetry docs page on main\n// (`docs/content/docs/(root)/(other)/telemetry/index.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\nfunction isThreadsTelemetryEvent(event: TelemetryEvent): boolean {\n  return (\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  );\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  const distinctId = getOrCreateTelemetryDistinctId();\n  const threadsProperties = isThreadsTelemetryEvent(event)\n    ? {\n        package_name: PACKAGE_NAME,\n        package_version: PACKAGE_VERSION,\n        inspector_distinct_id: distinctId,\n      }\n    : {};\n  let body: string;\n  try {\n    body = JSON.stringify({\n      event,\n      properties: {\n        ...properties,\n        ...threadsProperties,\n        distinct_id: distinctId,\n      },\n      package: {\n        name: PACKAGE_NAME,\n        ...(isThreadsTelemetryEvent(event) ? { version: PACKAGE_VERSION } : {}),\n      },\n      ts: Math.floor(Date.now() / 1000),\n    });\n  } catch {\n    return;\n  }\n\n  void postBestEffort(TELEMETRY_INGEST_URL, body, distinctId);\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\nexport function trackBannerViewed(props: {\n  banner_id: string;\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\nexport type InspectorThreadTelemetryProps = {\n  package_name?: typeof PACKAGE_NAME;\n  package_version?: string;\n  inspector_distinct_id?: string;\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  thread_count?: number;\n  example_thread_id?: string;\n  tour_step?: number;\n  tour_tab?: \"timeline\" | \"raw-events\" | \"state\";\n  dismiss_method?: \"skip\" | \"done\";\n};\n\nexport function trackThreadsTabClicked(\n  props: InspectorThreadTelemetryProps = {},\n): void {\n  track(TELEMETRY_EVENTS.threadsTabClicked, props);\n}\n\nexport function trackThreadsLockedViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsLockedViewed, props);\n}\n\nexport function trackThreadsIntelligenceSignupClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsIntelligenceSignupClicked, props);\n}\n\nexport function trackThreadsTalkToEngineerClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsTalkToEngineerClicked, props);\n}\n\nexport function trackTalkToEngineerClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.talkToEngineerClicked, props);\n}\n\nexport function trackThreadsEmptyEnabledViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsEmptyEnabledViewed, props);\n}\n\nexport function trackThreadsEnabledViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsEnabledViewed, props);\n}\n\nexport function trackThreadsExampleViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleViewed, props);\n}\n\nexport function trackThreadsExampleSelected(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleSelected, props);\n}\n\nexport function trackThreadsExampleTourStarted(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourStarted, props);\n}\n\nexport function trackThreadsExampleTourStepViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourStepViewed, props);\n}\n\nexport function trackThreadsExampleTourDismissed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourDismissed, props);\n}\n\nexport function trackThreadsExampleTourCompleted(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourCompleted, props);\n}\n\nexport function trackThreadsExampleTourReopened(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourReopened, props);\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\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  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n  try {\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    clearTimeout(timeoutId);\n  }\n}\n"],"mappings":"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"}
+{"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. Properties are scoped to event metadata only\n//     (banner_id/timestamp, cta location). Reviewers should grep call\n//     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} 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 canonical telemetry docs page on main\n// (`docs/content/docs/(root)/(other)/telemetry/index.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  );\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  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  let body: string;\n  try {\n    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  } catch {\n    return;\n  }\n\n  void postBestEffort(TELEMETRY_INGEST_URL, body, distinctId);\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 = \"floating_button\" | \"announcement_preview\";\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 InspectorThreadTelemetryProps = {\n  package_name?: typeof PACKAGE_NAME;\n  package_version?: string;\n  inspector_distinct_id?: string;\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  thread_count?: number;\n  example_thread_id?: string;\n  tour_step?: number;\n  tour_tab?: \"timeline\" | \"raw-events\" | \"state\";\n  dismiss_method?: \"skip\" | \"done\";\n};\n\nexport function trackThreadsTabClicked(\n  props: InspectorThreadTelemetryProps = {},\n): void {\n  track(TELEMETRY_EVENTS.threadsTabClicked, props);\n}\n\nexport function trackThreadsLockedViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsLockedViewed, props);\n}\n\nexport function trackThreadsIntelligenceSignupClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsIntelligenceSignupClicked, props);\n}\n\nexport function trackThreadsTalkToEngineerClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsTalkToEngineerClicked, props);\n}\n\nexport function trackTalkToEngineerClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.talkToEngineerClicked, props);\n}\n\nexport function trackThreadsEmptyEnabledViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsEmptyEnabledViewed, props);\n}\n\nexport function trackThreadsEnabledViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsEnabledViewed, props);\n}\n\nexport function trackThreadsExampleViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleViewed, props);\n}\n\nexport function trackThreadsExampleSelected(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleSelected, props);\n}\n\nexport function trackThreadsExampleTourStarted(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourStarted, props);\n}\n\nexport function trackThreadsExampleTourStepViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourStepViewed, props);\n}\n\nexport function trackThreadsExampleTourDismissed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourDismissed, props);\n}\n\nexport function trackThreadsExampleTourCompleted(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourCompleted, props);\n}\n\nexport function trackThreadsExampleTourReopened(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourReopened, props);\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\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  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n  try {\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    clearTimeout(timeoutId);\n  }\n}\n"],"mappings":"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"}

package/dist/lib/telemetry.mjs

@@ -3,8 +3,10 @@ import { version } from "../package.mjs";
 
 //#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",
 	threadsTabClicked: "oss.inspector.threads_tab_clicked",
 	threadsLockedViewed: "oss.inspector.threads_locked_viewed",
 	threadsIntelligenceSignupClicked: "oss.inspector.threads_intelligence_signup_clicked",
@@ -26,8 +28,8 @@ const TELEMETRY_DOCS_URL = "https://docs.copilotkit.ai/telemetry";
 const PACKAGE_NAME = "@copilotkit/web-inspector";
 const PACKAGE_VERSION = version;
 const FETCH_TIMEOUT_MS = 3e3;
-function isThreadsTelemetryEvent(event) {
-	return 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;
+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;
 }
 function getRuntimeUrlType(runtimeUrl) {
 	if (!runtimeUrl) return "missing";
@@ -54,7 +56,7 @@ function getRuntimeUrlType(runtimeUrl) {
 function track(event, properties = {}) {
 	if (isTelemetryOptedOut()) return;
 	const distinctId = getOrCreateTelemetryDistinctId();
-	const threadsProperties = isThreadsTelemetryEvent(event) ? {
+	const enrichedProperties = isEnrichedTelemetryEvent(event) ? {
 		package_name: PACKAGE_NAME,
 		package_version: PACKAGE_VERSION,
 		inspector_distinct_id: distinctId
@@ -65,12 +67,12 @@ function track(event, properties = {}) {
 			event,
 			properties: {
 				...properties,
-				...threadsProperties,
+				...enrichedProperties,
 				distinct_id: distinctId
 			},
 			package: {
 				name: PACKAGE_NAME,
-				...isThreadsTelemetryEvent(event) ? { version: PACKAGE_VERSION } : {}
+				...isEnrichedTelemetryEvent(event) ? { version: PACKAGE_VERSION } : {}
 			},
 			ts: Math.floor(Date.now() / 1e3)
 		});
@@ -85,6 +87,25 @@ function trackBannerViewed(props) {
 function trackBannerClicked(props) {
 	track(TELEMETRY_EVENTS.bannerClicked, props);
 }
+/**
+* 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.
+*/
+function trackBannerDismissed(props) {
+	track(TELEMETRY_EVENTS.bannerDismissed, 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).
+*/
+function trackInspectorOpened(props) {
+	track(TELEMETRY_EVENTS.opened, props);
+}
 function trackThreadsTabClicked(props = {}) {
 	track(TELEMETRY_EVENTS.threadsTabClicked, props);
 }
@@ -193,5 +214,5 @@ async function postBestEffort(url, body, distinctId) {
 }
 
 //#endregion
-export { TELEMETRY_DOCS_URL, ensureTelemetryDistinctId, getRuntimeUrlType, getTelemetryDistinctIdForUrl, maybeShowDisclosure, trackBannerClicked, trackBannerViewed, trackMemoriesTabClicked, trackTalkToEngineerClicked, trackThreadsEmptyEnabledViewed, trackThreadsEnabledViewed, trackThreadsExampleSelected, trackThreadsExampleTourCompleted, trackThreadsExampleTourDismissed, trackThreadsExampleTourReopened, trackThreadsExampleTourStarted, trackThreadsExampleTourStepViewed, trackThreadsExampleViewed, trackThreadsIntelligenceSignupClicked, trackThreadsLockedViewed, trackThreadsTabClicked, trackThreadsTalkToEngineerClicked };
+export { TELEMETRY_DOCS_URL, ensureTelemetryDistinctId, getRuntimeUrlType, getTelemetryDistinctIdForUrl, maybeShowDisclosure, trackBannerClicked, trackBannerDismissed, trackBannerViewed, trackInspectorOpened, trackMemoriesTabClicked, trackTalkToEngineerClicked, trackThreadsEmptyEnabledViewed, trackThreadsEnabledViewed, trackThreadsExampleSelected, trackThreadsExampleTourCompleted, trackThreadsExampleTourDismissed, trackThreadsExampleTourReopened, trackThreadsExampleTourStarted, trackThreadsExampleTourStepViewed, trackThreadsExampleViewed, trackThreadsIntelligenceSignupClicked, trackThreadsLockedViewed, trackThreadsTabClicked, trackThreadsTalkToEngineerClicked };
 //# sourceMappingURL=telemetry.mjs.map

package/dist/lib/telemetry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.mjs","names":["packageJson.version"],"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. Properties are scoped to event metadata only\n//     (banner_id/timestamp, cta location). Reviewers should grep call\n//     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  bannerViewed: \"oss.inspector.banner_viewed\",\n  bannerClicked: \"oss.inspector.banner_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} 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 canonical telemetry docs page on main\n// (`docs/content/docs/(root)/(other)/telemetry/index.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\nfunction isThreadsTelemetryEvent(event: TelemetryEvent): boolean {\n  return (\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  );\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  const distinctId = getOrCreateTelemetryDistinctId();\n  const threadsProperties = isThreadsTelemetryEvent(event)\n    ? {\n        package_name: PACKAGE_NAME,\n        package_version: PACKAGE_VERSION,\n        inspector_distinct_id: distinctId,\n      }\n    : {};\n  let body: string;\n  try {\n    body = JSON.stringify({\n      event,\n      properties: {\n        ...properties,\n        ...threadsProperties,\n        distinct_id: distinctId,\n      },\n      package: {\n        name: PACKAGE_NAME,\n        ...(isThreadsTelemetryEvent(event) ? { version: PACKAGE_VERSION } : {}),\n      },\n      ts: Math.floor(Date.now() / 1000),\n    });\n  } catch {\n    return;\n  }\n\n  void postBestEffort(TELEMETRY_INGEST_URL, body, distinctId);\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\nexport function trackBannerViewed(props: {\n  banner_id: string;\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\nexport type InspectorThreadTelemetryProps = {\n  package_name?: typeof PACKAGE_NAME;\n  package_version?: string;\n  inspector_distinct_id?: string;\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  thread_count?: number;\n  example_thread_id?: string;\n  tour_step?: number;\n  tour_tab?: \"timeline\" | \"raw-events\" | \"state\";\n  dismiss_method?: \"skip\" | \"done\";\n};\n\nexport function trackThreadsTabClicked(\n  props: InspectorThreadTelemetryProps = {},\n): void {\n  track(TELEMETRY_EVENTS.threadsTabClicked, props);\n}\n\nexport function trackThreadsLockedViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsLockedViewed, props);\n}\n\nexport function trackThreadsIntelligenceSignupClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsIntelligenceSignupClicked, props);\n}\n\nexport function trackThreadsTalkToEngineerClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsTalkToEngineerClicked, props);\n}\n\nexport function trackTalkToEngineerClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.talkToEngineerClicked, props);\n}\n\nexport function trackThreadsEmptyEnabledViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsEmptyEnabledViewed, props);\n}\n\nexport function trackThreadsEnabledViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsEnabledViewed, props);\n}\n\nexport function trackThreadsExampleViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleViewed, props);\n}\n\nexport function trackThreadsExampleSelected(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleSelected, props);\n}\n\nexport function trackThreadsExampleTourStarted(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourStarted, props);\n}\n\nexport function trackThreadsExampleTourStepViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourStepViewed, props);\n}\n\nexport function trackThreadsExampleTourDismissed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourDismissed, props);\n}\n\nexport function trackThreadsExampleTourCompleted(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourCompleted, props);\n}\n\nexport function trackThreadsExampleTourReopened(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourReopened, props);\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\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  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n  try {\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    clearTimeout(timeoutId);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"telemetry.mjs","names":["packageJson.version"],"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. Properties are scoped to event metadata only\n//     (banner_id/timestamp, cta location). Reviewers should grep call\n//     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} 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 canonical telemetry docs page on main\n// (`docs/content/docs/(root)/(other)/telemetry/index.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  );\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  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  let body: string;\n  try {\n    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  } catch {\n    return;\n  }\n\n  void postBestEffort(TELEMETRY_INGEST_URL, body, distinctId);\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 = \"floating_button\" | \"announcement_preview\";\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 InspectorThreadTelemetryProps = {\n  package_name?: typeof PACKAGE_NAME;\n  package_version?: string;\n  inspector_distinct_id?: string;\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  thread_count?: number;\n  example_thread_id?: string;\n  tour_step?: number;\n  tour_tab?: \"timeline\" | \"raw-events\" | \"state\";\n  dismiss_method?: \"skip\" | \"done\";\n};\n\nexport function trackThreadsTabClicked(\n  props: InspectorThreadTelemetryProps = {},\n): void {\n  track(TELEMETRY_EVENTS.threadsTabClicked, props);\n}\n\nexport function trackThreadsLockedViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsLockedViewed, props);\n}\n\nexport function trackThreadsIntelligenceSignupClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsIntelligenceSignupClicked, props);\n}\n\nexport function trackThreadsTalkToEngineerClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsTalkToEngineerClicked, props);\n}\n\nexport function trackTalkToEngineerClicked(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.talkToEngineerClicked, props);\n}\n\nexport function trackThreadsEmptyEnabledViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsEmptyEnabledViewed, props);\n}\n\nexport function trackThreadsEnabledViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsEnabledViewed, props);\n}\n\nexport function trackThreadsExampleViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleViewed, props);\n}\n\nexport function trackThreadsExampleSelected(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleSelected, props);\n}\n\nexport function trackThreadsExampleTourStarted(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourStarted, props);\n}\n\nexport function trackThreadsExampleTourStepViewed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourStepViewed, props);\n}\n\nexport function trackThreadsExampleTourDismissed(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourDismissed, props);\n}\n\nexport function trackThreadsExampleTourCompleted(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourCompleted, props);\n}\n\nexport function trackThreadsExampleTourReopened(\n  props: InspectorThreadTelemetryProps,\n): void {\n  track(TELEMETRY_EVENTS.threadsExampleTourReopened, props);\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\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  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n  try {\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    clearTimeout(timeoutId);\n  }\n}\n"],"mappings":"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"}

package/dist/package.cjs

@@ -1,6 +1,6 @@
 
 //#region package.json
-var version = "1.64.2-canary.perfall1";
+var version = "1.64.2";
 
 //#endregion
 Object.defineProperty(exports, 'version', {

package/dist/package.mjs

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "1.64.2-canary.perfall1";
+var version = "1.64.2";
 
 //#endregion
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@copilotkit/web-inspector",
-  "version": "1.64.2-canary.perfall1",
+  "version": "1.64.2",
   "description": "Lit-based web component for the CopilotKit web inspector",
   "repository": {
     "type": "git",
@@ -27,7 +27,7 @@
     "lit": "^3.2.0",
     "lucide": "^0.525.0",
     "marked": "^12.0.2",
-    "@copilotkit/core": "1.64.2-canary.perfall1"
+    "@copilotkit/core": "1.64.2"
   },
   "devDependencies": {
     "@tailwindcss/cli": "^4.1.11",

package/src/__tests__/telemetry-egress-guard.spec.ts

@@ -0,0 +1,41 @@
+import { describe, expect, it, vi } from "vitest";
+
+import { createTelemetryEgressGuard } from "../lib/testing/telemetry-egress-guard.js";
+
+// The inspector's telemetry is browser-side and fire-and-forget, and jsdom has a
+// real `fetch`. The setup-file guard is what keeps unit runs — local and CI —
+// from POSTing real `oss.inspector.*` events to the live sink.
+
+describe("telemetry egress guard", () => {
+  it("swallows requests to the telemetry sink without touching the network", async () => {
+    const realFetch = vi.fn(() =>
+      Promise.resolve(new Response(null, { status: 200 })),
+    ) as unknown as typeof fetch;
+
+    const guarded = createTelemetryEgressGuard(realFetch);
+    const response = await guarded("https://telemetry.copilotkit.ai/ingest", {
+      method: "POST",
+      body: "{}",
+    });
+
+    expect(response.status).toBe(204);
+    expect(realFetch).not.toHaveBeenCalled();
+  });
+
+  it("passes every other request through untouched", async () => {
+    const realFetch = vi.fn(() =>
+      Promise.resolve(new Response(null, { status: 200 })),
+    ) as unknown as typeof fetch;
+
+    const guarded = createTelemetryEgressGuard(realFetch);
+    await guarded("https://cdn.copilotkit.ai/announcements.json");
+    await guarded(new URL("http://localhost/api/threads"));
+
+    expect(realFetch).toHaveBeenCalledTimes(2);
+  });
+
+  it("is installed on the global fetch for every test in this package", () => {
+    // A raw platform fetch would stringify as native code; the guard doesn't.
+    expect(String(globalThis.fetch)).not.toContain("[native code]");
+  });
+});