@copilotkit/web-inspector 1.68.3 → 1.69.1

package/dist/lib/telemetry.d.mts

@@ -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.mts.map

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

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

package/dist/lib/telemetry.mjs

@@ -4,9 +4,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",
+	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 = 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 (isTelemetryOptedOut()) return;
 	try {
 		const distinctId = 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() {
@@ -297,5 +351,5 @@ async function postBestEffort(url, body, distinctId) {
 }
 
 //#endregion
-export { TELEMETRY_DOCS_URL, ensureTelemetryDistinctId, getRuntimeUrlType, getTelemetryDistinctIdForUrl, maybeShowDisclosure, trackBannerClicked, trackBannerDismissed, trackBannerViewed, trackInspectorOpened, trackMemoriesTabClicked, trackMetadataActionClicked, trackMetadataModuleViewed, trackTalkToEngineerClicked, trackThreadsEmptyEnabledViewed, trackThreadsEnabledViewed, trackThreadsExampleSelected, trackThreadsExampleTourCompleted, trackThreadsExampleTourDismissed, trackThreadsExampleTourReopened, trackThreadsExampleTourStarted, trackThreadsExampleTourStepViewed, trackThreadsExampleViewed, trackThreadsIntelligenceSignupClicked, trackThreadsLockedViewed, trackThreadsTabClicked, trackThreadsTalkToEngineerClicked };
+export { TELEMETRY_DOCS_URL, ensureTelemetryDistinctId, getRuntimeUrlType, getTelemetryDistinctIdForUrl, maybeShowDisclosure, trackErrorSignalViewed, trackEventSnippetsRun, trackEventSnippetsSaved, trackHomeCtaClicked, trackHomeViewed, trackInspectorOpened, trackMemoriesTabClicked, trackMetadataActionClicked, trackMetadataModuleViewed, trackTalkToEngineerClicked, trackThreadsEmptyEnabledViewed, trackThreadsEnabledViewed, trackThreadsExampleSelected, trackThreadsExampleTourCompleted, trackThreadsExampleTourDismissed, trackThreadsExampleTourReopened, trackThreadsExampleTourStarted, trackThreadsExampleTourStepViewed, trackThreadsExampleViewed, trackThreadsIntelligenceSignupClicked, trackThreadsLockedViewed, trackThreadsTabClicked, trackThreadsTalkToEngineerClicked, trackWhatsNewClicked, trackWhatsNewSignalViewed, trackWhatsNewViewed };
 //# 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. 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":"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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// 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":";;;;AA6BA,MAAa,mBAAmB;CAC9B,QAAQ;CACR,gBAAgB;CAChB,sBAAsB;CACtB,mBAAmB;CACnB,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,YAAY;CACZ,gBAAgB;CAChB,sBAAsB;CACtB,uBAAuB;CACvB,kBAAkB;CAClB,oBAAoB;CACrB;AAOD,MAAa,uBAAuB;AAMpC,MAAa,qBAAqB;AAElC,MAAM,eAAe;AACrB,MAAM,kBAAkBA;AAIxB,MAAM,mBAAmB;AAUzB,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,KAAI,qBAAqB,CAAE;AAE3B,KAAI;EACF,MAAM,aAAa,gCAAgC;AAkBnD,EAAK,eAAe,sBAfP,KAAK,UAAU;GAC1B;GACA,YAAY;IACV,GAAG;IACH,cAAc;IACd,iBAAiB;IACjB,uBAAuB;IACvB,aAAa;IACd;GACD,SAAS;IACP,MAAM;IACN,SAAS;IACV;GACD,IAAI,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK;GAClC,CAAC,EAC8C,WAAW;SACrD;;;;;;;AA6CV,SAAgB,oBAAoB,OAI3B;AACP,OAAM,iBAAiB,gBAAgB,MAAM;;;AAI/C,SAAgB,0BAA0B,OAKjC;AACP,OAAM,iBAAiB,sBAAsB,MAAM;;;;;;;;;;;;;;;;;;;;AA8BrD,SAAgB,uBAAuB,OAI9B;AACP,OAAM,iBAAiB,mBAAmB;EACxC,QAAQ,MAAM;EACd,cAAc,MAAM;EACpB,OAAO,MAAM;EACd,CAAC;;;;;;;AAQJ,SAAgB,qBAAqB,OAI5B;AACP,OAAM,iBAAiB,iBAAiB,MAAM;;;;;;;AAuChD,SAAgB,qBACd,OACM;AACN,OAAM,iBAAiB,QAAQ,MAAM;;;AAiEvC,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;;AAoBnD,SAAgB,gBAAgB,QAAqC,EAAE,EAAQ;AAC7E,OAAM,iBAAiB,YAAY;EACjC,WAAW,MAAM,aAAa;EAC9B,UAAU,MAAM,YAAY;EAC7B,CAAC;;AAGJ,SAAgB,oBAAoB,OAA0C;AAC5E,OAAM,iBAAiB,gBAAgB;EACrC,aAAa,MAAM;EACnB,WAAW,MAAM,aAAa;EAC9B,UAAU,MAAM,YAAY;EAC7B,CAAC;;AAwBJ,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;;AAYJ,SAAgB,sBAAsB,OAI7B;AACP,OAAM,iBAAiB,kBAAkB;EACvC,QAAQ,MAAM;EACd,QAAQ,MAAM;EACd,SAAS,MAAM;EAChB,CAAC;;AAGJ,SAAgB,wBAAwB,OAI/B;AACP,OAAM,iBAAiB,oBAAoB;EACzC,QAAQ,MAAM;EACd,QAAQ,MAAM;EACd,SAAS,MAAM;EAChB,CAAC;;;;;;;;;;;;;;;;;AAkBJ,SAAgB,+BAA8C;AAC5D,KAAI,qBAAqB,CAAE,QAAO;AAClC,QAAO,gCAAgC;;;;;;;AAQzC,SAAgB,4BAAkC;AAChD,KAAI,qBAAqB,CAAE;AAC3B,iCAAgC;;;;;;;;;;;AAYlC,SAAgB,sBAA4B;AAC1C,KAAI,qBAAqB,CAAE;AAC3B,KAAI,iCAAiC,CAAE;AAEvC,SAAQ,KACN,wEAAwE,mBAAmB,cAC5F;AACD,+BAA8B;;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"}

package/dist/package.cjs

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

package/dist/package.mjs

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