@openhands/agent-canvas 1.4.0 → 1.5.1

package/dist/services/telemetry.js

@@ -1,117 +1,228 @@
 import e from "../package.js";
+import { AGENT_CANVAS_CLIENT_SOURCE as t, AGENT_CANVAS_CLIENT_VERSION as n } from "../api/client-source.js";
 //#region src/services/telemetry.ts
-var t = "openhands-telemetry-consent", n = "openhands-telemetry-first-use", r = "openhands-telemetry-session", i = "phc_BgzfxKdgsYMLFTmJqt424ZoyVHvKFfrwttLimzdYTKFK", a = "https://z.openhands.dev", o = "https://us.posthog.com", s = !1, c = null;
-function l() {
+var r = "openhands-telemetry-consent", i = "openhands-telemetry-consent-pending-cloud-sync", a = "openhands-telemetry-consent-change", o = "openhands-telemetry-first-use", s = "openhands-telemetry-session", c = "agent-canvas", l = "phc_BgzfxKdgsYMLFTmJqt424ZoyVHvKFfrwttLimzdYTKFK", u = "https://z.openhands.dev", d = "https://us.posthog.com", f = null, p = null, m, h = {}, g = !1, _, v = 0, y = -1, b = Object.freeze({
+	client_source: t,
+	client_version: n,
+	package_name: e.name,
+	package_version: e.version
+});
+function x(e) {
+	return e ? {
+		...e,
+		properties: {
+			...e.properties,
+			...b
+		}
+	} : null;
+}
+function S(e) {
+	g || M() !== "granted" ? e.opt_out_capturing() : e.opt_in_capturing();
+}
+function C(e, t = !1) {
+	e.reset(t), y = -1, S(e);
+}
+function w(e) {
+	if (_ === void 0 || !R()) return;
+	let t = _?.distinctId, n = e.get_property("$user_id");
+	if (n != null && n !== t && C(e), _ === null) {
+		y = v;
+		return;
+	}
+	(e.get_property("$user_id") !== _.distinctId || y !== v) && (e.identify(_.distinctId, _.properties), y = v);
+}
+function T(e) {
+	if (e === !1) {
+		if (g) return;
+		g = !0, f?.opt_out_capturing(), P();
+		return;
+	}
+	let t = g;
+	if (g = !1, !f && !p) {
+		let t = Object.fromEntries(Object.entries(e).filter(([, e]) => e !== void 0));
+		h = {
+			...h,
+			...t
+		};
+	}
+	t && (f && (S(f), w(f)), P());
+}
+function E() {
+	return g ? null : {
+		apiKey: h.apiKey || l,
+		apiHost: h.apiHost || u,
+		uiHost: h.uiHost || d
+	};
+}
+function D() {
 	return typeof window < "u" && typeof localStorage < "u";
 }
-async function u() {
-	if (!l()) return null;
-	if (c) return c;
+async function O() {
+	if (!D()) return null;
+	if (f) return f;
 	try {
 		let { default: e } = await import("../node_modules/posthog-js/dist/module.js");
-		return c = e, e;
+		return e;
 	} catch {
 		return null;
 	}
 }
-function d() {
-	return typeof process < "u" && process.env?.DO_NOT_TRACK === "1" || typeof navigator < "u" && (navigator.doNotTrack === "1" || typeof window < "u" && window.doNotTrack === "1");
-}
-async function f(t = !1) {
-	if (s) return c;
-	let n = await u();
-	return n ? (n.init(i, {
-		api_host: a,
-		ui_host: o,
-		opt_out_capturing_by_default: !t,
-		capture_pageview: !1,
-		autocapture: !1,
-		persistence: "localStorage",
-		disable_session_recording: !0,
-		loaded: (t) => {
-			t.register({
-				package_name: e.name,
-				package_version: e.version
-			});
-		}
-	}), s = !0, n) : null;
+function k() {
+	return !!(g || typeof process < "u" && process.env?.DO_NOT_TRACK === "1" || typeof navigator < "u" && (navigator.doNotTrack === "1" || typeof window < "u" && window.doNotTrack === "1"));
+}
+function A(e) {
+	f || (m = e);
+}
+async function j(e = !1) {
+	if (f) return f;
+	if (p) return p;
+	p = (async () => {
+		let t = E();
+		if (!t) return null;
+		let n = await O();
+		if (!n) return null;
+		let r = n.init(t.apiKey, {
+			api_host: t.apiHost,
+			ui_host: t.uiHost,
+			opt_out_capturing_by_default: !e,
+			capture_pageview: !1,
+			autocapture: !1,
+			persistence: "localStorage",
+			persistence_name: c,
+			consent_persistence_name: `${c}-consent`,
+			person_profiles: "identified_only",
+			disable_session_recording: !0,
+			bootstrap: m,
+			before_send: x
+		}, c);
+		return r ? (f = r, m = void 0, g ? f.opt_out_capturing() : M() === "granted" ? (f.opt_in_capturing(), w(f)) : e || f.opt_out_capturing(), f) : null;
+	})();
+	try {
+		return await p;
+	} finally {
+		f || (p = null);
+	}
 }
-function p() {
-	if (!l()) return "pending";
-	if (d()) return "denied";
+function M() {
+	if (!D()) return "pending";
+	if (k()) return "denied";
 	try {
-		let e = localStorage.getItem(t);
+		let e = localStorage.getItem(r);
 		if (e === "granted" || e === "denied") return e;
 	} catch {}
 	return "pending";
 }
-async function m(e) {
-	if (l()) try {
-		localStorage.setItem(t, e);
-		let n = await f();
-		if (!n) return;
-		e === "granted" ? n.opt_in_capturing() : n.opt_out_capturing();
+function N(e) {
+	if (!D()) return () => {};
+	let t = (t) => {
+		(t.key === r || t.key === i) && e();
+	};
+	return window.addEventListener(a, e), window.addEventListener("storage", t), () => {
+		window.removeEventListener(a, e), window.removeEventListener("storage", t);
+	};
+}
+function P() {
+	D() && window.dispatchEvent(new Event(a));
+}
+function F(e) {
+	if (D()) try {
+		localStorage.setItem(i, e);
+	} catch {}
+}
+function I(e) {
+	if (D()) try {
+		if (e !== void 0 && localStorage.getItem(i) !== e) return;
+		localStorage.removeItem(i), P();
 	} catch {}
 }
-function h() {
-	return p() === "granted";
+async function L(e, { syncToCloud: t = !0 } = {}) {
+	if (D()) try {
+		if (localStorage.setItem(r, e), g) return;
+		let t = f ?? await j();
+		if (!t) return;
+		e === "granted" ? (t.opt_in_capturing(), w(t)) : t.get_property("$user_id") == null ? t.opt_out_capturing() : C(t);
+	} catch {} finally {
+		t && F(e), P();
+	}
+}
+function R() {
+	return M() === "granted";
 }
-function g() {
-	if (!l()) return !1;
+function z() {
+	if (!D()) return !1;
 	try {
-		return localStorage.getItem(n) === "true";
+		return localStorage.getItem(o) === "true";
 	} catch {
 		return !1;
 	}
 }
-function _() {
-	if (l()) try {
-		localStorage.setItem(n, "true");
+function B() {
+	if (D()) try {
+		localStorage.setItem(o, "true");
 	} catch {}
 }
-async function v() {
-	if (d() || g()) return;
-	let e = await f(!0);
-	e && ((e.has_opted_out_capturing?.() ?? !1) && e.opt_in_capturing(), e.capture("canvas_install", {
+async function V() {
+	if (k() || z()) return;
+	let e = await j(!0);
+	!e || k() || ((e.has_opted_out_capturing?.() ?? !1) && e.opt_in_capturing(), e.capture("canvas_install", {
 		platform: typeof navigator < "u" ? navigator.platform : "unknown",
 		user_agent: typeof navigator < "u" ? navigator.userAgent : "unknown",
 		referrer: typeof document < "u" ? document.referrer : "",
 		url_origin: typeof window < "u" ? window.location.origin : "",
 		embedded: typeof window < "u" && window.self !== window.top
-	}), _(), p() !== "granted" && e.opt_out_capturing());
+	}), B(), M() !== "granted" && e.opt_out_capturing());
 }
-function y() {
-	if (!l()) return !1;
+function H() {
+	if (!D()) return !1;
 	try {
-		return sessionStorage.getItem(r) === "true";
+		return sessionStorage.getItem(s) === "true";
 	} catch {
 		return !1;
 	}
 }
-function b() {
-	if (l()) try {
-		sessionStorage.setItem(r, "true");
+function U() {
+	if (D()) try {
+		sessionStorage.setItem(s, "true");
 	} catch {}
 }
-async function x() {
-	if (!h() || y()) return;
-	let e = await f();
-	e && (e.capture("canvas_new_session", { is_first_use: !g() }), b());
+async function W() {
+	if (!R()) return null;
+	let e = await j();
+	return !e || !R() ? null : (e.has_opted_out_capturing?.() && e.opt_in_capturing(), w(e), e);
 }
-async function S(e, t = {}) {
-	if (!h()) return;
-	let n = await f();
-	n && n.capture(e, t);
+async function G() {
+	if (H()) return;
+	let e = await W();
+	e && (e.capture("canvas_new_session", { is_first_use: !z() }), U());
 }
-async function C() {
-	if (l()) try {
-		localStorage.removeItem(t), localStorage.removeItem(n), sessionStorage.removeItem(r), s && c && c.reset();
-	} catch {}
+async function K(e, t = {}) {
+	let n = await W();
+	n && n.capture(e, t);
 }
-async function w() {
-	return s ? c : null;
+async function q(e, t = {}) {
+	let n = await W();
+	n && n.captureException(e, t);
+}
+async function J() {
+	if (D()) {
+		try {
+			localStorage.removeItem(r), localStorage.removeItem(o);
+		} catch {}
+		I();
+		try {
+			sessionStorage.removeItem(s);
+		} catch {}
+		_ = null, v += 1, y = -1;
+		try {
+			f && C(f, !0);
+		} catch {
+			try {
+				f?.opt_out_capturing();
+			} catch {}
+		}
+	}
 }
 //#endregion
-export { C as clearTelemetryData, w as getPostHogInstance, p as getTelemetryConsent, h as isTelemetryEnabled, m as setTelemetryConsent, S as trackEvent, v as trackInstall, x as trackSessionStart };
+export { J as clearTelemetryData, A as configurePostHogBootstrap, T as configureTelemetry, M as getTelemetryConsent, j as initializePostHogClient, R as isTelemetryEnabled, L as setTelemetryConsent, N as subscribeTelemetryConsent, K as trackEvent, q as trackException, V as trackInstall, G as trackSessionStart };
 
 //# sourceMappingURL=telemetry.js.map

package/dist/services/telemetry.js.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.js","names":[],"sources":["../../src/services/telemetry.ts"],"sourcesContent":["/**\n * Telemetry service for tracking library usage.\n *\n * This module handles anonymous telemetry for the @openhands/agent-canvas package\n * using the PostHog SDK for reliable event delivery with batching, retry logic,\n * and offline support.\n *\n * TRACKING PHILOSOPHY:\n * - Install event (canvas_install): Sent immediately on first use, regardless of consent.\n *   This is anonymous and contains no PII - just basic browser info and a random ID.\n * - Session/custom events: Only sent after user grants consent via the consent modal.\n * - Users can opt out of all future tracking by declining consent.\n *\n * AD BLOCKER BYPASS:\n * By default, telemetry is routed through OpenHands' reverse proxy (z.openhands.dev)\n * to avoid being blocked by ad blockers. Library consumers can override this with:\n * - VITE_POSTHOG_HOST: Custom proxy URL or direct PostHog URL\n * - VITE_POSTHOG_UI_HOST: PostHog UI host (defaults to https://us.posthog.com)\n *\n * IMPORTANT: By default, telemetry is sent to the OpenHands PostHog project.\n * Library consumers can override this by setting VITE_POSTHOG_API_KEY.\n *\n * Users can disable all telemetry (including install tracking) via:\n * - Setting VITE_DO_NOT_TRACK=1 environment variable\n * - Browser's Do Not Track setting\n */\n\nimport type { PostHog } from \"posthog-js\";\nimport packageJson from \"../../package.json\";\n\nconst TELEMETRY_CONSENT_KEY = \"openhands-telemetry-consent\";\nconst TELEMETRY_FIRST_USE_KEY = \"openhands-telemetry-first-use\";\nconst TELEMETRY_SESSION_KEY = \"openhands-telemetry-session\";\n\n// PostHog project keys — one per deployment environment, hardcoded so they\n// are baked into the static bundle at build time and cannot drift at runtime.\n// Replace POSTHOG_STAGING_KEY with a dedicated project key once provisioned.\nconst POSTHOG_PROD_KEY = \"phc_BgzfxKdgsYMLFTmJqt424ZoyVHvKFfrwttLimzdYTKFK\";\nconst POSTHOG_STAGING_KEY = \"phc_kBtz5nKmxVRRQ7HtPwr2QX9eMC5j65zE86QKocVNwb4U\";\n\n// Always use the staging key unless VITE_APP_ENV is explicitly set to\n// \"production\" at bundle time (hardcoded in build:lib and production CI).\n// Library consumers can always override with VITE_POSTHOG_API_KEY.\nconst POSTHOG_API_KEY: string =\n  (import.meta.env.VITE_POSTHOG_API_KEY as string | undefined) ||\n  (import.meta.env.VITE_APP_ENV === \"production\"\n    ? POSTHOG_PROD_KEY\n    : POSTHOG_STAGING_KEY);\n\n// Default to OpenHands' reverse proxy to bypass ad blockers.\n// The proxy at z.openhands.dev routes to PostHog's US region.\n// Library consumers can override this with their own proxy or direct PostHog URL.\nconst POSTHOG_HOST =\n  import.meta.env.VITE_POSTHOG_HOST || \"https://z.openhands.dev\";\n\n// UI host is needed for PostHog features like toolbar to work correctly\n// when using a reverse proxy. Defaults to US region.\nconst POSTHOG_UI_HOST =\n  import.meta.env.VITE_POSTHOG_UI_HOST || \"https://us.posthog.com\";\n\nexport type TelemetryConsent = \"granted\" | \"denied\" | \"pending\";\n\nlet isInitialized = false;\nlet posthogInstance: PostHog | null = null;\n\n/**\n * Check if we're in a browser environment\n */\nfunction isBrowser(): boolean {\n  return typeof window !== \"undefined\" && typeof localStorage !== \"undefined\";\n}\n\n/**\n * Lazily load PostHog to avoid SSR/Node.js issues.\n * PostHog is a browser-only library, so we dynamically import it only when needed.\n */\nasync function getPostHog(): Promise<PostHog | null> {\n  if (!isBrowser()) {\n    return null;\n  }\n\n  if (posthogInstance) {\n    return posthogInstance;\n  }\n\n  try {\n    const { default: posthog } = await import(\"posthog-js\");\n    posthogInstance = posthog;\n    return posthog;\n  } catch {\n    // Failed to load PostHog - telemetry will be disabled\n    return null;\n  }\n}\n\n/**\n * Check if telemetry is disabled via environment variable or browser setting.\n * Works in both Node.js and browser (Vite) environments.\n */\nfunction isDoNotTrackEnabled(): boolean {\n  // Check Vite environment variable (browser)\n  if (\n    typeof import.meta !== \"undefined\" &&\n    import.meta.env?.VITE_DO_NOT_TRACK === \"1\"\n  ) {\n    return true;\n  }\n\n  // Check Node.js environment variable (SSR/testing)\n  if (typeof process !== \"undefined\" && process.env?.DO_NOT_TRACK === \"1\") {\n    return true;\n  }\n\n  // Check browser's navigator.doNotTrack standard\n  if (\n    typeof navigator !== \"undefined\" &&\n    (navigator.doNotTrack === \"1\" ||\n      // @ts-expect-error - Some browsers use window.doNotTrack\n      (typeof window !== \"undefined\" && window.doNotTrack === \"1\"))\n  ) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Initialize PostHog SDK.\n *\n * @param enableCapturing - If true, enable capturing immediately (for install tracking).\n *                          If false, start with capturing disabled (for consent-gated tracking).\n */\nasync function initializePostHog(\n  enableCapturing = false,\n): Promise<PostHog | null> {\n  if (isInitialized) {\n    return posthogInstance;\n  }\n\n  const posthog = await getPostHog();\n  if (!posthog) {\n    return null;\n  }\n\n  posthog.init(POSTHOG_API_KEY, {\n    api_host: POSTHOG_HOST,\n    // UI host is required when using a reverse proxy so PostHog features work correctly\n    ui_host: POSTHOG_UI_HOST,\n    // Start with capturing disabled by default - we enable it explicitly when needed\n    opt_out_capturing_by_default: !enableCapturing,\n    // Don't auto-capture page views - we control when to track\n    capture_pageview: false,\n    // Don't auto-capture clicks etc.\n    autocapture: false,\n    // Use localStorage for persistence\n    persistence: \"localStorage\",\n    // Disable session recording\n    disable_session_recording: true,\n    // Set default properties for all events\n    loaded: (ph) => {\n      ph.register({\n        package_name: packageJson.name,\n        package_version: packageJson.version,\n      });\n    },\n  });\n\n  isInitialized = true;\n  return posthog;\n}\n\n/**\n * Get user's telemetry consent preference\n */\nexport function getTelemetryConsent(): TelemetryConsent {\n  if (!isBrowser()) {\n    return \"pending\";\n  }\n\n  // Check environment variable for opt-out\n  if (isDoNotTrackEnabled()) {\n    return \"denied\";\n  }\n\n  try {\n    const consent = localStorage.getItem(TELEMETRY_CONSENT_KEY);\n    if (consent === \"granted\" || consent === \"denied\") {\n      return consent;\n    }\n  } catch {\n    // Ignore storage errors\n  }\n\n  return \"pending\";\n}\n\n/**\n * Set user's telemetry consent preference\n */\nexport async function setTelemetryConsent(\n  consent: \"granted\" | \"denied\",\n): Promise<void> {\n  if (!isBrowser()) {\n    return;\n  }\n\n  try {\n    localStorage.setItem(TELEMETRY_CONSENT_KEY, consent);\n\n    // Initialize PostHog if not already done\n    const posthog = await initializePostHog();\n    if (!posthog) {\n      return;\n    }\n\n    if (consent === \"granted\") {\n      // Enable capturing\n      posthog.opt_in_capturing();\n    } else {\n      // Disable capturing and clear any queued events\n      posthog.opt_out_capturing();\n    }\n  } catch {\n    // Ignore storage errors\n  }\n}\n\n/**\n * Check if telemetry is enabled (user has granted consent)\n */\nexport function isTelemetryEnabled(): boolean {\n  return getTelemetryConsent() === \"granted\";\n}\n\n/**\n * Check if first use event has already been sent\n */\nfunction hasFirstUseSent(): boolean {\n  if (!isBrowser()) {\n    return false;\n  }\n\n  try {\n    return localStorage.getItem(TELEMETRY_FIRST_USE_KEY) === \"true\";\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Mark first use event as sent\n */\nfunction markFirstUseSent(): void {\n  if (!isBrowser()) {\n    return;\n  }\n\n  try {\n    localStorage.setItem(TELEMETRY_FIRST_USE_KEY, \"true\");\n  } catch {\n    // Ignore storage errors\n  }\n}\n\n/**\n * Track the initial install of the library.\n *\n * IMPORTANT: This is sent immediately on first use, regardless of consent status.\n * This allows us to track library adoption even if users haven't made a consent choice yet.\n *\n * The event is:\n * - Completely anonymous (no PII, just a random PostHog distinct_id)\n * - Sent only once per installation (tracked via localStorage, persists across sessions)\n * - Still respects DO_NOT_TRACK environment variable and browser setting\n *\n * Users who want complete privacy can:\n * - Set VITE_DO_NOT_TRACK=1 or browser's Do Not Track\n * - Later deny consent to prevent all future tracking\n */\nexport async function trackInstall(): Promise<void> {\n  // Respect hard opt-out via environment variable or browser setting\n  if (isDoNotTrackEnabled()) {\n    return;\n  }\n\n  // Already sent install event (persisted in localStorage - survives app relaunches)\n  if (hasFirstUseSent()) {\n    return;\n  }\n\n  // Initialize PostHog with capturing enabled (for this one event)\n  const posthog = await initializePostHog(true);\n  if (!posthog) {\n    return;\n  }\n\n  // Temporarily enable capturing if it was disabled\n  const wasOptedOut = posthog.has_opted_out_capturing?.() ?? false;\n  if (wasOptedOut) {\n    posthog.opt_in_capturing();\n  }\n\n  // Capture the install event\n  posthog.capture(\"canvas_install\", {\n    platform: typeof navigator !== \"undefined\" ? navigator.platform : \"unknown\",\n    user_agent:\n      typeof navigator !== \"undefined\" ? navigator.userAgent : \"unknown\",\n    referrer: typeof document !== \"undefined\" ? document.referrer : \"\",\n    url_origin: typeof window !== \"undefined\" ? window.location.origin : \"\",\n    embedded: typeof window !== \"undefined\" && window.self !== window.top,\n  });\n\n  // Mark as sent (stored in localStorage - persists across browser sessions)\n  markFirstUseSent();\n\n  // Restore opt-out state if user hasn't granted consent yet\n  // This ensures we only send the install event, not subsequent events\n  const currentConsent = getTelemetryConsent();\n  if (currentConsent !== \"granted\") {\n    posthog.opt_out_capturing();\n  }\n}\n\n/**\n * Check if session start event has already been sent (this browser session)\n */\nfunction hasSessionSent(): boolean {\n  if (!isBrowser()) {\n    return false;\n  }\n\n  try {\n    return sessionStorage.getItem(TELEMETRY_SESSION_KEY) === \"true\";\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Mark session start event as sent (uses sessionStorage so it resets on new tabs/sessions)\n */\nfunction markSessionSent(): void {\n  if (!isBrowser()) {\n    return;\n  }\n\n  try {\n    sessionStorage.setItem(TELEMETRY_SESSION_KEY, \"true\");\n  } catch {\n    // Ignore storage errors\n  }\n}\n\n/**\n * Track a session start event.\n * Called each time a new browser session starts (respects consent).\n * Uses sessionStorage for deduplication - only sends once per browser session.\n */\nexport async function trackSessionStart(): Promise<void> {\n  if (!isTelemetryEnabled()) {\n    return;\n  }\n\n  // Already sent session event this browser session\n  if (hasSessionSent()) {\n    return;\n  }\n\n  // Initialize PostHog if needed\n  const posthog = await initializePostHog();\n  if (!posthog) {\n    return;\n  }\n\n  posthog.capture(\"canvas_new_session\", {\n    is_first_use: !hasFirstUseSent(),\n  });\n\n  // Mark as sent for this session\n  markSessionSent();\n}\n\n/**\n * Track a custom event (respects consent).\n */\nexport async function trackEvent(\n  eventName: string,\n  properties: Record<string, unknown> = {},\n): Promise<void> {\n  if (!isTelemetryEnabled()) {\n    return;\n  }\n\n  // Initialize PostHog if needed\n  const posthog = await initializePostHog();\n  if (!posthog) {\n    return;\n  }\n\n  posthog.capture(eventName, properties);\n}\n\n/**\n * Clear all telemetry data (for privacy/GDPR requests)\n */\nexport async function clearTelemetryData(): Promise<void> {\n  if (!isBrowser()) {\n    return;\n  }\n\n  try {\n    localStorage.removeItem(TELEMETRY_CONSENT_KEY);\n    localStorage.removeItem(TELEMETRY_FIRST_USE_KEY);\n    sessionStorage.removeItem(TELEMETRY_SESSION_KEY);\n\n    // Reset PostHog if initialized\n    if (isInitialized && posthogInstance) {\n      posthogInstance.reset();\n    }\n  } catch {\n    // Ignore storage errors\n  }\n}\n\n/**\n * Get the PostHog instance for advanced usage (if needed).\n * Returns the instance if initialized, otherwise null.\n * Note: This is async because PostHog is lazily loaded.\n */\nexport async function getPostHogInstance(): Promise<PostHog | null> {\n  if (!isInitialized) {\n    return null;\n  }\n  return posthogInstance;\n}\n"],"mappings":"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"}
+{"version":3,"file":"telemetry.js","names":[],"sources":["../../src/services/telemetry.ts"],"sourcesContent":["/**\n * Telemetry service for tracking library usage.\n *\n * This module handles anonymous telemetry for the @openhands/agent-canvas package\n * using the PostHog SDK for reliable event delivery with batching, retry logic,\n * and offline support.\n *\n * TRACKING PHILOSOPHY:\n * - Install event (canvas_install): Sent immediately on first use, regardless of consent.\n *   This is anonymous and contains no PII - just basic browser info and a random ID.\n * - Session/custom events: Only sent after user grants consent via the consent modal.\n * - Users can opt out of all future tracking by declining consent.\n *\n * AD BLOCKER BYPASS:\n * By default, telemetry is routed through OpenHands' reverse proxy (z.openhands.dev)\n * to avoid being blocked by ad blockers. Library consumers can override this with:\n * - VITE_POSTHOG_HOST: Custom proxy URL or direct PostHog URL\n * - VITE_POSTHOG_UI_HOST: PostHog UI host (defaults to https://us.posthog.com)\n *\n * IMPORTANT: By default, telemetry is sent to the OpenHands PostHog project.\n * Source builds can override this with VITE_POSTHOG_API_KEY. Precompiled\n * library consumers can pass the same settings to configureTelemetry().\n *\n * Users can disable all telemetry (including install tracking) via:\n * - Setting VITE_DO_NOT_TRACK=1 environment variable\n * - Browser's Do Not Track setting\n */\n\nimport type { BootstrapConfig, CaptureResult, PostHog } from \"posthog-js\";\nimport packageJson from \"../../package.json\";\nimport {\n  AGENT_CANVAS_CLIENT_SOURCE,\n  AGENT_CANVAS_CLIENT_VERSION,\n} from \"#/api/client-source\";\n\nconst TELEMETRY_CONSENT_KEY = \"openhands-telemetry-consent\";\nconst TELEMETRY_CONSENT_PENDING_CLOUD_SYNC_KEY =\n  \"openhands-telemetry-consent-pending-cloud-sync\";\nconst TELEMETRY_CONSENT_CHANGE_EVENT = \"openhands-telemetry-consent-change\";\nconst TELEMETRY_FIRST_USE_KEY = \"openhands-telemetry-first-use\";\nconst TELEMETRY_SESSION_KEY = \"openhands-telemetry-session\";\nconst POSTHOG_INSTANCE_NAME = \"agent-canvas\";\n\n// Unconfigured source builds use staging. Production release workflows pass\n// VITE_POSTHOG_API_KEY explicitly for both the app and library artifacts.\nconst POSTHOG_STAGING_KEY = \"phc_kBtz5nKmxVRRQ7HtPwr2QX9eMC5j65zE86QKocVNwb4U\";\nconst DEFAULT_POSTHOG_API_KEY: string =\n  (import.meta.env.VITE_POSTHOG_API_KEY as string | undefined) ||\n  POSTHOG_STAGING_KEY;\n\n// Default to OpenHands' reverse proxy to bypass ad blockers.\n// The proxy at z.openhands.dev routes to PostHog's US region.\n// Library consumers can override this with their own proxy or direct PostHog URL.\nconst DEFAULT_POSTHOG_HOST =\n  import.meta.env.VITE_POSTHOG_HOST || \"https://z.openhands.dev\";\n\n// UI host is needed for PostHog features like toolbar to work correctly\n// when using a reverse proxy. Defaults to US region.\nconst DEFAULT_POSTHOG_UI_HOST =\n  import.meta.env.VITE_POSTHOG_UI_HOST || \"https://us.posthog.com\";\n\nexport interface TelemetryConfig {\n  /** PostHog project key. Useful for precompiled library consumers. */\n  apiKey?: string;\n  /** Event ingestion host or reverse proxy. */\n  apiHost?: string;\n  /** PostHog UI host used by toolbar links and other UI features. */\n  uiHost?: string;\n}\n\nexport type TelemetryConfiguration = TelemetryConfig | false;\n\nexport type TelemetryConsent = \"granted\" | \"denied\" | \"pending\";\nexport type ResolvedTelemetryConsent = Exclude<TelemetryConsent, \"pending\">;\n\nexport interface SetTelemetryConsentOptions {\n  /** Do not persist a value mirrored from backend settings back to Cloud. */\n  syncToCloud?: boolean;\n}\n\nlet posthogInstance: PostHog | null = null;\nlet initializationPromise: Promise<PostHog | null> | null = null;\nlet pendingBootstrap: BootstrapConfig | undefined;\nlet telemetryConfig: TelemetryConfig = {};\nlet telemetryDisabled = false;\n\ninterface TelemetryIdentity {\n  distinctId: string;\n  properties: Record<string, unknown>;\n}\n\n// undefined means that Cloud identity has not resolved yet; null means that it\n// resolved without a user. This distinction prevents startup from resetting a\n// persisted identity while the current account is still loading.\nlet desiredTelemetryIdentity: TelemetryIdentity | null | undefined;\nlet desiredIdentityRevision = 0;\nlet appliedIdentityRevision = -1;\n\nconst CANVAS_EVENT_PROPERTIES = Object.freeze({\n  client_source: AGENT_CANVAS_CLIENT_SOURCE,\n  client_version: AGENT_CANVAS_CLIENT_VERSION,\n  package_name: packageJson.name,\n  package_version: packageJson.version,\n});\n\nfunction addCanvasEventProperties(\n  event: CaptureResult | null,\n): CaptureResult | null {\n  if (!event) return null;\n\n  return {\n    ...event,\n    properties: {\n      ...event.properties,\n      ...CANVAS_EVENT_PROPERTIES,\n    },\n  };\n}\n\nfunction restorePostHogConsent(posthog: PostHog): void {\n  if (telemetryDisabled || getTelemetryConsent() !== \"granted\") {\n    posthog.opt_out_capturing();\n  } else {\n    posthog.opt_in_capturing();\n  }\n}\n\nfunction resetPostHogIdentity(posthog: PostHog, resetDeviceId = false): void {\n  posthog.reset(resetDeviceId);\n  appliedIdentityRevision = -1;\n  // PostHog reset clears its own consent persistence, so immediately restore\n  // the canonical Canvas decision kept in localStorage.\n  restorePostHogConsent(posthog);\n}\n\nfunction applyDesiredTelemetryIdentity(posthog: PostHog): void {\n  if (desiredTelemetryIdentity === undefined || !isTelemetryEnabled()) return;\n\n  const desiredId = desiredTelemetryIdentity?.distinctId;\n  const currentId = posthog.get_property(\"$user_id\");\n  if (currentId != null && currentId !== desiredId) {\n    resetPostHogIdentity(posthog);\n  }\n\n  if (desiredTelemetryIdentity === null) {\n    appliedIdentityRevision = desiredIdentityRevision;\n    return;\n  }\n\n  if (\n    posthog.get_property(\"$user_id\") !== desiredTelemetryIdentity.distinctId ||\n    appliedIdentityRevision !== desiredIdentityRevision\n  ) {\n    posthog.identify(\n      desiredTelemetryIdentity.distinctId,\n      desiredTelemetryIdentity.properties,\n    );\n    appliedIdentityRevision = desiredIdentityRevision;\n  }\n}\n\nfunction propertiesEqual(\n  left: Record<string, unknown>,\n  right: Record<string, unknown>,\n): boolean {\n  const keys = Object.keys(left);\n  return (\n    keys.length === Object.keys(right).length &&\n    keys.every((key) => left[key] === right[key])\n  );\n}\n\n/**\n * Configure the single Canvas telemetry client before its first use.\n * Passing false disables telemetry and install tracking for embedded hosts.\n */\nexport function configureTelemetry(config: TelemetryConfiguration): void {\n  if (config === false) {\n    if (telemetryDisabled) return;\n    telemetryDisabled = true;\n    posthogInstance?.opt_out_capturing();\n    notifyTelemetryConsentListeners();\n    return;\n  }\n\n  const wasDisabled = telemetryDisabled;\n  telemetryDisabled = false;\n\n  if (!posthogInstance && !initializationPromise) {\n    const definedConfig = Object.fromEntries(\n      Object.entries(config).filter(([, value]) => value !== undefined),\n    ) as TelemetryConfig;\n    telemetryConfig = { ...telemetryConfig, ...definedConfig };\n  }\n\n  if (wasDisabled) {\n    if (posthogInstance) {\n      restorePostHogConsent(posthogInstance);\n      applyDesiredTelemetryIdentity(posthogInstance);\n    }\n    notifyTelemetryConsentListeners();\n  }\n}\n\nfunction getResolvedTelemetryConfig(): Required<TelemetryConfig> | null {\n  if (telemetryDisabled) return null;\n\n  return {\n    apiKey: telemetryConfig.apiKey || DEFAULT_POSTHOG_API_KEY,\n    apiHost: telemetryConfig.apiHost || DEFAULT_POSTHOG_HOST,\n    uiHost: telemetryConfig.uiHost || DEFAULT_POSTHOG_UI_HOST,\n  };\n}\n\n/**\n * Check if we're in a browser environment\n */\nfunction isBrowser(): boolean {\n  return typeof window !== \"undefined\" && typeof localStorage !== \"undefined\";\n}\n\n/**\n * Lazily load PostHog to avoid SSR/Node.js issues.\n * PostHog is a browser-only library, so we dynamically import it only when needed.\n */\nasync function getPostHog(): Promise<PostHog | null> {\n  if (!isBrowser()) {\n    return null;\n  }\n\n  if (posthogInstance) {\n    return posthogInstance;\n  }\n\n  try {\n    const { default: posthog } = await import(\"posthog-js\");\n    return posthog;\n  } catch {\n    // Failed to load PostHog - telemetry will be disabled\n    return null;\n  }\n}\n\n/**\n * Check if telemetry is disabled via environment variable or browser setting.\n * Works in both Node.js and browser (Vite) environments.\n */\nfunction isDoNotTrackEnabled(): boolean {\n  if (telemetryDisabled) {\n    return true;\n  }\n\n  // Check Vite environment variable (browser)\n  if (\n    typeof import.meta !== \"undefined\" &&\n    import.meta.env?.VITE_DO_NOT_TRACK === \"1\"\n  ) {\n    return true;\n  }\n\n  // Check Node.js environment variable (SSR/testing)\n  if (typeof process !== \"undefined\" && process.env?.DO_NOT_TRACK === \"1\") {\n    return true;\n  }\n\n  // Check browser's navigator.doNotTrack standard\n  if (\n    typeof navigator !== \"undefined\" &&\n    (navigator.doNotTrack === \"1\" ||\n      // @ts-expect-error - Some browsers use window.doNotTrack\n      (typeof window !== \"undefined\" && window.doNotTrack === \"1\"))\n  ) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Initialize PostHog SDK.\n *\n * @param enableCapturing - If true, enable capturing immediately (for install tracking).\n *                          If false, start with capturing disabled (for consent-gated tracking).\n */\nexport function configurePostHogBootstrap(\n  bootstrap: BootstrapConfig | undefined,\n): void {\n  if (!posthogInstance) {\n    pendingBootstrap = bootstrap;\n  }\n}\n\nexport async function initializePostHogClient(\n  enableCapturing = false,\n): Promise<PostHog | null> {\n  if (posthogInstance) {\n    return posthogInstance;\n  }\n\n  if (initializationPromise) {\n    return initializationPromise;\n  }\n\n  initializationPromise = (async () => {\n    const config = getResolvedTelemetryConfig();\n    if (!config) {\n      return null;\n    }\n\n    const posthog = await getPostHog();\n    if (!posthog) {\n      return null;\n    }\n\n    // A named instance isolates Canvas configuration, consent, identity, and\n    // persistence from a host application's default PostHog singleton.\n    const initializedPostHog = posthog.init(\n      config.apiKey,\n      {\n        api_host: config.apiHost,\n        ui_host: config.uiHost,\n        opt_out_capturing_by_default: !enableCapturing,\n        capture_pageview: false,\n        autocapture: false,\n        persistence: \"localStorage\",\n        persistence_name: POSTHOG_INSTANCE_NAME,\n        consent_persistence_name: `${POSTHOG_INSTANCE_NAME}-consent`,\n        person_profiles: \"identified_only\",\n        disable_session_recording: true,\n        bootstrap: pendingBootstrap,\n        before_send: addCanvasEventProperties,\n      },\n      POSTHOG_INSTANCE_NAME,\n    );\n    if (!initializedPostHog) return null;\n\n    posthogInstance = initializedPostHog;\n    pendingBootstrap = undefined;\n\n    if (telemetryDisabled) {\n      posthogInstance.opt_out_capturing();\n    } else if (getTelemetryConsent() === \"granted\") {\n      posthogInstance.opt_in_capturing();\n      applyDesiredTelemetryIdentity(posthogInstance);\n    } else if (!enableCapturing) {\n      posthogInstance.opt_out_capturing();\n    }\n\n    return posthogInstance;\n  })();\n\n  try {\n    return await initializationPromise;\n  } finally {\n    if (!posthogInstance) {\n      initializationPromise = null;\n    }\n  }\n}\n\n/**\n * Get user's telemetry consent preference\n */\nexport function getTelemetryConsent(): TelemetryConsent {\n  if (!isBrowser()) {\n    return \"pending\";\n  }\n\n  // Check environment variable for opt-out\n  if (isDoNotTrackEnabled()) {\n    return \"denied\";\n  }\n\n  try {\n    const consent = localStorage.getItem(TELEMETRY_CONSENT_KEY);\n    if (consent === \"granted\" || consent === \"denied\") {\n      return consent;\n    }\n  } catch {\n    // Ignore storage errors\n  }\n\n  return \"pending\";\n}\n\n/**\n * Return an explicit browser choice that still needs to survive a Cloud login.\n * It remains pending across local backends so their settings cannot consume a\n * decision that must still be applied after the user connects to Cloud.\n */\nexport function getPendingCloudTelemetryConsent(): ResolvedTelemetryConsent | null {\n  if (!isBrowser()) return null;\n\n  try {\n    const consent = localStorage.getItem(\n      TELEMETRY_CONSENT_PENDING_CLOUD_SYNC_KEY,\n    );\n    return consent === \"granted\" || consent === \"denied\" ? consent : null;\n  } catch {\n    return null;\n  }\n}\n\nexport function subscribeTelemetryConsent(listener: () => void): () => void {\n  if (!isBrowser()) return () => {};\n  const handleStorage = (event: StorageEvent) => {\n    if (\n      event.key === TELEMETRY_CONSENT_KEY ||\n      event.key === TELEMETRY_CONSENT_PENDING_CLOUD_SYNC_KEY\n    ) {\n      listener();\n    }\n  };\n  window.addEventListener(TELEMETRY_CONSENT_CHANGE_EVENT, listener);\n  window.addEventListener(\"storage\", handleStorage);\n\n  return () => {\n    window.removeEventListener(TELEMETRY_CONSENT_CHANGE_EVENT, listener);\n    window.removeEventListener(\"storage\", handleStorage);\n  };\n}\n\nfunction notifyTelemetryConsentListeners(): void {\n  if (isBrowser())\n    window.dispatchEvent(new Event(TELEMETRY_CONSENT_CHANGE_EVENT));\n}\n\nfunction markTelemetryConsentForCloudSync(\n  consent: ResolvedTelemetryConsent,\n): void {\n  if (!isBrowser()) return;\n\n  try {\n    localStorage.setItem(TELEMETRY_CONSENT_PENDING_CLOUD_SYNC_KEY, consent);\n  } catch {\n    // Ignore storage errors; the in-browser consent decision still applies.\n  }\n}\n\nexport function clearPendingCloudTelemetryConsent(\n  expected?: ResolvedTelemetryConsent,\n): void {\n  if (!isBrowser()) return;\n\n  try {\n    if (\n      expected !== undefined &&\n      localStorage.getItem(TELEMETRY_CONSENT_PENDING_CLOUD_SYNC_KEY) !==\n        expected\n    ) {\n      return;\n    }\n    localStorage.removeItem(TELEMETRY_CONSENT_PENDING_CLOUD_SYNC_KEY);\n    notifyTelemetryConsentListeners();\n  } catch {\n    // Ignore storage errors.\n  }\n}\n\n/**\n * Set user's telemetry consent preference\n */\nexport async function setTelemetryConsent(\n  consent: ResolvedTelemetryConsent,\n  { syncToCloud = true }: SetTelemetryConsentOptions = {},\n): Promise<void> {\n  if (!isBrowser()) {\n    return;\n  }\n\n  try {\n    localStorage.setItem(TELEMETRY_CONSENT_KEY, consent);\n    if (telemetryDisabled) return;\n\n    // Reuse an initialized client synchronously so a same-flush identify()\n    // cannot run before consent is applied. Only the cold path awaits import.\n    const posthog = posthogInstance ?? (await initializePostHogClient());\n    if (!posthog) {\n      return;\n    }\n\n    if (consent === \"granted\") {\n      posthog.opt_in_capturing();\n      applyDesiredTelemetryIdentity(posthog);\n    } else {\n      if (posthog.get_property(\"$user_id\") != null) {\n        resetPostHogIdentity(posthog);\n      } else {\n        posthog.opt_out_capturing();\n      }\n    }\n  } catch {\n    // Ignore storage errors\n  } finally {\n    // Notify UI/backend/identity reconcilers only after the browser capture state\n    // reflects this decision. Otherwise a pre-login grant can trigger an\n    // identify while PostHog is still opted out and lose funnel continuity.\n    if (syncToCloud) {\n      markTelemetryConsentForCloudSync(consent);\n    }\n    notifyTelemetryConsentListeners();\n  }\n}\n\n/**\n * Declare the current Cloud identity. The telemetry service applies it only\n * after consent and owns all reset/account-switch semantics.\n */\nexport async function setTelemetryIdentity(\n  distinctId: string | null,\n  properties: Record<string, unknown> = {},\n): Promise<void> {\n  const nextIdentity = distinctId === null ? null : { distinctId, properties };\n  const unchanged =\n    desiredTelemetryIdentity === nextIdentity ||\n    (desiredTelemetryIdentity !== undefined &&\n      desiredTelemetryIdentity !== null &&\n      nextIdentity !== null &&\n      desiredTelemetryIdentity.distinctId === nextIdentity.distinctId &&\n      propertiesEqual(desiredTelemetryIdentity.properties, properties));\n  if (unchanged) return;\n\n  desiredTelemetryIdentity = nextIdentity;\n  desiredIdentityRevision += 1;\n  appliedIdentityRevision = -1;\n\n  if (!isTelemetryEnabled()) return;\n  const posthog = posthogInstance ?? (await initializePostHogClient());\n  if (posthog && isTelemetryEnabled()) {\n    // Read the desired identity after the await so a newer account always wins\n    // if identity changes while the SDK is loading.\n    applyDesiredTelemetryIdentity(posthog);\n  }\n}\n\n/**\n * Check if telemetry is enabled (user has granted consent)\n */\nexport function isTelemetryEnabled(): boolean {\n  return getTelemetryConsent() === \"granted\";\n}\n\n/**\n * Check if first use event has already been sent\n */\nfunction hasFirstUseSent(): boolean {\n  if (!isBrowser()) {\n    return false;\n  }\n\n  try {\n    return localStorage.getItem(TELEMETRY_FIRST_USE_KEY) === \"true\";\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Mark first use event as sent\n */\nfunction markFirstUseSent(): void {\n  if (!isBrowser()) {\n    return;\n  }\n\n  try {\n    localStorage.setItem(TELEMETRY_FIRST_USE_KEY, \"true\");\n  } catch {\n    // Ignore storage errors\n  }\n}\n\n/**\n * Track the initial install of the library.\n *\n * IMPORTANT: This is sent immediately on first use, regardless of consent status.\n * This allows us to track library adoption even if users haven't made a consent choice yet.\n *\n * The event is:\n * - Completely anonymous (no PII, just a random PostHog distinct_id)\n * - Sent only once per installation (tracked via localStorage, persists across sessions)\n * - Still respects DO_NOT_TRACK environment variable and browser setting\n *\n * Users who want complete privacy can:\n * - Set VITE_DO_NOT_TRACK=1 or browser's Do Not Track\n * - Later deny consent to prevent all future tracking\n */\nexport async function trackInstall(): Promise<void> {\n  // Respect hard opt-out via environment variable or browser setting\n  if (isDoNotTrackEnabled()) {\n    return;\n  }\n\n  // Already sent install event (persisted in localStorage - survives app relaunches)\n  if (hasFirstUseSent()) {\n    return;\n  }\n\n  // Initialize PostHog with capturing enabled (for this one event)\n  const posthog = await initializePostHogClient(true);\n  if (!posthog || isDoNotTrackEnabled()) {\n    return;\n  }\n\n  // Temporarily enable capturing if it was disabled\n  const wasOptedOut = posthog.has_opted_out_capturing?.() ?? false;\n  if (wasOptedOut) {\n    posthog.opt_in_capturing();\n  }\n\n  // Capture the install event\n  posthog.capture(\"canvas_install\", {\n    platform: typeof navigator !== \"undefined\" ? navigator.platform : \"unknown\",\n    user_agent:\n      typeof navigator !== \"undefined\" ? navigator.userAgent : \"unknown\",\n    referrer: typeof document !== \"undefined\" ? document.referrer : \"\",\n    url_origin: typeof window !== \"undefined\" ? window.location.origin : \"\",\n    embedded: typeof window !== \"undefined\" && window.self !== window.top,\n  });\n\n  // Mark as sent (stored in localStorage - persists across browser sessions)\n  markFirstUseSent();\n\n  // Restore opt-out state if user hasn't granted consent yet\n  // This ensures we only send the install event, not subsequent events\n  const currentConsent = getTelemetryConsent();\n  if (currentConsent !== \"granted\") {\n    posthog.opt_out_capturing();\n  }\n}\n\n/**\n * Check if session start event has already been sent (this browser session)\n */\nfunction hasSessionSent(): boolean {\n  if (!isBrowser()) {\n    return false;\n  }\n\n  try {\n    return sessionStorage.getItem(TELEMETRY_SESSION_KEY) === \"true\";\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Mark session start event as sent (uses sessionStorage so it resets on new tabs/sessions)\n */\nfunction markSessionSent(): void {\n  if (!isBrowser()) {\n    return;\n  }\n\n  try {\n    sessionStorage.setItem(TELEMETRY_SESSION_KEY, \"true\");\n  } catch {\n    // Ignore storage errors\n  }\n}\n\n/** Return the shared client only when a consented capture is safe to emit. */\nasync function getPostHogForConsentedCapture(): Promise<PostHog | null> {\n  if (!isTelemetryEnabled()) return null;\n\n  const posthog = await initializePostHogClient();\n  if (!posthog || !isTelemetryEnabled()) return null;\n\n  // The browser preference is the canonical capture decision. PostHog may\n  // still carry an older opt-out marker while backend consent is loading or\n  // after a previous backend temporarily reported a stale value. Heal that\n  // drift at the event boundary so capture() cannot silently discard an event\n  // that the user has explicitly allowed.\n  if (posthog.has_opted_out_capturing?.()) {\n    posthog.opt_in_capturing();\n  }\n\n  applyDesiredTelemetryIdentity(posthog);\n\n  return posthog;\n}\n\n/**\n * Track a session start event.\n * Called each time a new browser session starts (respects consent).\n * Uses sessionStorage for deduplication - only sends once per browser session.\n */\nexport async function trackSessionStart(): Promise<void> {\n  // Already sent session event this browser session\n  if (hasSessionSent()) {\n    return;\n  }\n\n  const posthog = await getPostHogForConsentedCapture();\n  if (!posthog) return;\n\n  posthog.capture(\"canvas_new_session\", {\n    is_first_use: !hasFirstUseSent(),\n  });\n\n  // Mark as sent for this session\n  markSessionSent();\n}\n\n/**\n * Track a custom event (respects consent).\n */\nexport async function trackEvent(\n  eventName: string,\n  properties: Record<string, unknown> = {},\n): Promise<void> {\n  const posthog = await getPostHogForConsentedCapture();\n  if (!posthog) return;\n\n  posthog.capture(eventName, properties);\n}\n\n/** Track an exception through the same consent-aware client as custom events. */\nexport async function trackException(\n  error: unknown,\n  properties: Record<string, unknown> = {},\n): Promise<void> {\n  const posthog = await getPostHogForConsentedCapture();\n  if (!posthog) return;\n\n  posthog.captureException(error, properties);\n}\n\n/**\n * Clear all telemetry data (for privacy/GDPR requests)\n */\nexport async function clearTelemetryData(): Promise<void> {\n  if (!isBrowser()) {\n    return;\n  }\n\n  try {\n    localStorage.removeItem(TELEMETRY_CONSENT_KEY);\n    localStorage.removeItem(TELEMETRY_FIRST_USE_KEY);\n  } catch {\n    // Continue clearing the in-memory and SDK identity if storage is blocked.\n  }\n  clearPendingCloudTelemetryConsent();\n  try {\n    sessionStorage.removeItem(TELEMETRY_SESSION_KEY);\n  } catch {\n    // Continue clearing the in-memory and SDK identity if storage is blocked.\n  }\n\n  desiredTelemetryIdentity = null;\n  desiredIdentityRevision += 1;\n  appliedIdentityRevision = -1;\n\n  try {\n    if (posthogInstance) {\n      resetPostHogIdentity(posthogInstance, true);\n    }\n  } catch {\n    // A reset failure must not leave capture enabled after a privacy clear.\n    try {\n      posthogInstance?.opt_out_capturing();\n    } catch {\n      // Telemetry failures must not break the application.\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/themes/color-themes.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"color-themes.cjs","names":[],"sources":["../../src/themes/color-themes.ts"],"sourcesContent":["export type ColorThemeKey =\n  | \"openhands-deepsea\"\n  | \"openhands-neutral\"\n  | \"openhands-neo\";\n\nexport interface ColorThemeDefinition {\n  label: string;\n  /** Overrides for --cool-grey-* CSS custom properties (our semantic scale) */\n  scale: Record<string, string>;\n  /**\n   * Overrides for --heroui-* CSS custom properties.\n   * HeroUI stores colors as space-separated HSL channels (\"H S% L%\") so Tailwind\n   * utilities like bg-default-200 resolve to hsl(var(--heroui-default-200)).\n   * These vars are set by the heroui() plugin on :root, [data-theme=dark] at\n   * build time, so they must be overridden at the same or lower specificity\n   * from a later stylesheet to pick up theme changes at runtime.\n   */\n  heroui: Record<string, string>;\n  /** Overrides for --oh-* semantic tokens such as brand / button colors. */\n  tokens?: Record<string, string>;\n}\n\n// HSL channel strings for the neutral grey palette (H=0, S=0%, L=hex/255*100)\n// prettier-ignore\nconst NEUTRAL_HSL = {\n  50:  \"0 0% 96.86%\", // #F7F7F7\n  100: \"0 0% 92.55%\", // #ECECEC\n  200: \"0 0% 86.27%\", // #DCDCDC\n  300: \"0 0% 74.51%\", // #BEBEBE\n  400: \"0 0% 59.22%\", // #979797\n  500: \"0 0% 45.1%\",  // #737373\n  600: \"0 0% 33.73%\", // #565656\n  700: \"0 0% 25.1%\",  // #404040\n  800: \"0 0% 19.22%\", // #313131\n  850: \"0 0% 15.69%\", // #282828\n  900: \"0 0% 12.55%\", // #202020\n  950: \"0 0% 9.41%\",  // #181818\n  975: \"0 0% 6.27%\",  // #101010\n};\n\nconst NEUTRAL_SCALE = {\n  \"--cool-grey-50\": \"#F7F7F7\",\n  \"--cool-grey-100\": \"#ECECEC\",\n  \"--cool-grey-200\": \"#DCDCDC\",\n  \"--cool-grey-300\": \"#BEBEBE\",\n  \"--cool-grey-400\": \"#979797\",\n  \"--cool-grey-500\": \"#737373\",\n  \"--cool-grey-600\": \"#565656\",\n  \"--cool-grey-700\": \"#404040\",\n  \"--cool-grey-800\": \"#313131\",\n  \"--cool-grey-900\": \"#282828\",\n  \"--cool-grey-925\": \"#202020\",\n  \"--cool-grey-950\": \"#181818\",\n  \"--cool-grey-975\": \"#101010\",\n};\n\nconst NEUTRAL_HEROUI = {\n  \"--heroui-background\": NEUTRAL_HSL[950],\n  \"--heroui-background-foreground\": NEUTRAL_HSL[50],\n  \"--heroui-foreground-50\": NEUTRAL_HSL[975],\n  \"--heroui-foreground-100\": NEUTRAL_HSL[950],\n  \"--heroui-foreground-200\": NEUTRAL_HSL[900],\n  \"--heroui-foreground-300\": NEUTRAL_HSL[850],\n  \"--heroui-foreground-400\": NEUTRAL_HSL[800],\n  \"--heroui-foreground-500\": NEUTRAL_HSL[700],\n  \"--heroui-foreground-600\": NEUTRAL_HSL[600],\n  \"--heroui-foreground-700\": NEUTRAL_HSL[500],\n  \"--heroui-foreground-800\": NEUTRAL_HSL[400],\n  \"--heroui-foreground-900\": NEUTRAL_HSL[300],\n  \"--heroui-foreground\": NEUTRAL_HSL[300],\n  \"--heroui-content1\": NEUTRAL_HSL[900],\n  \"--heroui-content1-foreground\": NEUTRAL_HSL[100],\n  \"--heroui-content2\": NEUTRAL_HSL[850],\n  \"--heroui-content2-foreground\": NEUTRAL_HSL[200],\n  \"--heroui-content3\": NEUTRAL_HSL[800],\n  \"--heroui-content3-foreground\": NEUTRAL_HSL[300],\n  \"--heroui-content4\": NEUTRAL_HSL[700],\n  \"--heroui-content4-foreground\": NEUTRAL_HSL[400],\n  \"--heroui-default-50\": NEUTRAL_HSL[975],\n  \"--heroui-default-100\": NEUTRAL_HSL[950],\n  \"--heroui-default-200\": NEUTRAL_HSL[900],\n  \"--heroui-default-300\": NEUTRAL_HSL[850],\n  \"--heroui-default-400\": NEUTRAL_HSL[800],\n  \"--heroui-default-500\": NEUTRAL_HSL[700],\n  \"--heroui-default-600\": NEUTRAL_HSL[600],\n  \"--heroui-default-700\": NEUTRAL_HSL[500],\n  \"--heroui-default-800\": NEUTRAL_HSL[400],\n  \"--heroui-default-900\": NEUTRAL_HSL[300],\n  \"--heroui-default-foreground\": NEUTRAL_HSL[50],\n  \"--heroui-default\": NEUTRAL_HSL[800],\n};\n\nimport { AGENT_SERVER_UI_THEMEABLE_BRAND_VARIABLES } from \"#/styles/agent-server-ui-style-scope\";\n\n/** CSS custom properties overridden by color themes (see applyColorTheme). */\nexport const COLOR_THEME_TOKEN_KEYS = AGENT_SERVER_UI_THEMEABLE_BRAND_VARIABLES;\n\n/** White primary/accent tokens — used by OpenHands-Neo for button surfaces. */\nconst NEO_WHITE_BUTTON_TOKENS: Record<\n  (typeof COLOR_THEME_TOKEN_KEYS)[number],\n  string\n> = {\n  \"--oh-color-primary\": \"#ffffff\",\n  \"--oh-accent\": \"#ffffff\",\n  \"--oh-warning\": \"#ffffff\",\n};\n\nexport const COLOR_THEMES: Record<ColorThemeKey, ColorThemeDefinition> = {\n  \"openhands-deepsea\": {\n    label: \"OpenHands-DeepSea\",\n    // Matches the values already set by index.css; included so switching back\n    // from another theme restores the original palette explicitly.\n    scale: {\n      \"--cool-grey-50\": \"#F7F9FC\",\n      \"--cool-grey-100\": \"#EEF2F7\",\n      \"--cool-grey-200\": \"#DCE3EE\",\n      \"--cool-grey-300\": \"#C3CDDC\",\n      \"--cool-grey-400\": \"#A3B0C4\",\n      \"--cool-grey-500\": \"#7E8A9E\",\n      \"--cool-grey-600\": \"#626D82\",\n      \"--cool-grey-700\": \"#4B5468\",\n      \"--cool-grey-800\": \"#383F50\",\n      \"--cool-grey-900\": \"#2C313F\",\n      \"--cool-grey-925\": \"#21252F\",\n      \"--cool-grey-950\": \"#0B0E14\",\n      \"--cool-grey-975\": \"#05070A\",\n    },\n    // Values generated by heroui() from hero.ts — restore them explicitly when\n    // switching back from another theme.\n    heroui: {\n      \"--heroui-background\": \"220 29.03% 6.08%\",\n      \"--heroui-background-foreground\": \"216 45.45% 97.84%\",\n      \"--heroui-foreground-50\": \"216 33.33% 2.94%\",\n      \"--heroui-foreground-100\": \"220 29.03% 6.08%\",\n      \"--heroui-foreground-200\": \"222.86 17.5% 15.69%\",\n      \"--heroui-foreground-300\": \"224.21 17.76% 20.98%\",\n      \"--heroui-foreground-400\": \"222.5 17.65% 26.67%\",\n      \"--heroui-foreground-500\": \"221.38 16.2% 35.1%\",\n      \"--heroui-foreground-600\": \"219.38 14.04% 44.71%\",\n      \"--heroui-foreground-700\": \"217.5 14.16% 55.69%\",\n      \"--heroui-foreground-800\": \"216.36 21.85% 70.39%\",\n      \"--heroui-foreground-900\": \"216 26.32% 81.37%\",\n      \"--heroui-foreground\": \"216 26.32% 81.37%\",\n      \"--heroui-content1\": \"222.86 17.5% 15.69%\",\n      \"--heroui-content1-foreground\": \"213.33 36% 95.1%\",\n      \"--heroui-content2\": \"224.21 17.76% 20.98%\",\n      \"--heroui-content2-foreground\": \"216.67 34.62% 89.8%\",\n      \"--heroui-content3\": \"222.5 17.65% 26.67%\",\n      \"--heroui-content3-foreground\": \"216 26.32% 81.37%\",\n      \"--heroui-content4\": \"221.38 16.2% 35.1%\",\n      \"--heroui-content4-foreground\": \"216.36 21.85% 70.39%\",\n      \"--heroui-default-50\": \"216 33.33% 2.94%\",\n      \"--heroui-default-100\": \"220 29.03% 6.08%\",\n      \"--heroui-default-200\": \"222.86 17.5% 15.69%\",\n      \"--heroui-default-300\": \"224.21 17.76% 20.98%\",\n      \"--heroui-default-400\": \"222.5 17.65% 26.67%\",\n      \"--heroui-default-500\": \"221.38 16.2% 35.1%\",\n      \"--heroui-default-600\": \"219.38 14.04% 44.71%\",\n      \"--heroui-default-700\": \"217.5 14.16% 55.69%\",\n      \"--heroui-default-800\": \"216.36 21.85% 70.39%\",\n      \"--heroui-default-900\": \"216 26.32% 81.37%\",\n      \"--heroui-default-foreground\": \"216 45.45% 97.84%\",\n      \"--heroui-default\": \"222.5 17.65% 26.67%\",\n    },\n  },\n\n  \"openhands-neutral\": {\n    label: \"OpenHands-Neutral\",\n    scale: NEUTRAL_SCALE,\n    // Each stop follows the same positional mapping as hero.ts:\n    //   heroui-default-100 ← cool-grey-950 position ← neutral-950 (#181818)\n    //   heroui-default-200 ← cool-grey-925 position ← neutral-900 (#202020)\n    //   ...etc.\n    heroui: NEUTRAL_HEROUI,\n  },\n\n  \"openhands-neo\": {\n    label: \"OpenHands-Neo\",\n    scale: NEUTRAL_SCALE,\n    heroui: NEUTRAL_HEROUI,\n    tokens: NEO_WHITE_BUTTON_TOKENS,\n  },\n};\n\nexport const DEFAULT_COLOR_THEME: ColorThemeKey = \"openhands-neutral\";\n\nexport const AVAILABLE_COLOR_THEMES = Object.entries(COLOR_THEMES).map(\n  ([key, def]) => ({ key: key as ColorThemeKey, label: def.label }),\n);\n\nconst STORAGE_KEY = \"openhands-color-theme\";\n\n/** Read the persisted theme key from localStorage, falling back to the default. */\nexport function readPersistedColorTheme(): ColorThemeKey {\n  if (typeof window === \"undefined\") return DEFAULT_COLOR_THEME;\n  try {\n    const stored = window.localStorage.getItem(STORAGE_KEY);\n    if (stored && stored in COLOR_THEMES) return stored as ColorThemeKey;\n  } catch {\n    // ignore quota / privacy-mode failures\n  }\n  return DEFAULT_COLOR_THEME;\n}\n\n/** Persist the theme key to localStorage. */\nexport function persistColorTheme(key: ColorThemeKey): void {\n  try {\n    window.localStorage.setItem(STORAGE_KEY, key);\n  } catch {\n    // ignore\n  }\n}\n\nconst THEME_STYLE_TAG_ID = \"oh-color-theme-override\";\n\n/**\n * Apply a theme by injecting (or replacing) a <style> tag that overrides\n * both our custom --cool-grey-* primitives and HeroUI's --heroui-* tokens.\n *\n * Why a <style> tag:\n *   PostCSS transforms :root / body to [data-agent-server-ui], so --cool-grey-*\n *   is set on EVERY element carrying that attribute. A body inline-style only\n *   overrides body itself — inner matching elements keep the stylesheet value.\n *\n * Why heroui variables:\n *   HeroUI stores colors as HSL channels in --heroui-* vars on [data-theme=dark].\n *   They reference their own token system and are unaffected by --cool-grey-*\n *   changes, so we override them from the same injected sheet.\n *\n * Why doubled selectors + re-append on every call:\n *   \"Later sheet wins the tie\" cannot be relied on: in the built SPA\n *   (ssr:false, prerendered shell) React 19 re-creates the <head> elements it\n *   manages (<Meta/>/<Links/>) whenever the tree above the router remounts —\n *   e.g. PostHogWrapper swapping in <PostHogProvider> once the analytics key\n *   resolves, which only happens in builds with VITE_POSTHOG_CLIENT_KEY baked\n *   (the published npm package / tagged Docker images). That re-inserts the\n *   base stylesheet <link> AFTER this tag, which would let the base sheet's\n *   unlayered [data-agent-server-ui] variable rules (0,1,0) win every tie.\n *   Doubling the attribute selectors ([x][x], 0,2,0) beats them from any\n *   position in <head>; re-appending on each apply keeps document order\n *   favorable as well.\n */\nexport function applyColorTheme(key: ColorThemeKey): void {\n  if (typeof document === \"undefined\") return;\n  const { scale, heroui, tokens = {} } = COLOR_THEMES[key];\n\n  const scaleDecls = Object.entries(scale)\n    .map(([p, v]) => `  ${p}: ${v};`)\n    .join(\"\\n\");\n\n  const herouiDecls = Object.entries(heroui)\n    .map(([p, v]) => `  ${p}: ${v};`)\n    .join(\"\\n\");\n\n  const tokenDecls = Object.entries(tokens)\n    .map(([p, v]) => `  ${p}: ${v};`)\n    .join(\"\\n\");\n\n  // Target both selectors for heroui vars:\n  //   [data-agent-server-ui] — covers document.body (portal destination) so\n  //     portalled popover/listbox content inherits the overridden values.\n  //   [data-theme=dark]      — covers the inner AgentServerUIRoot wrapper so\n  //     components scoped inside the dark theme wrapper also pick them up.\n  // Both are doubled to out-specify the base sheet regardless of stylesheet\n  // order (see the doc comment above).\n  const css = [\n    `[data-agent-server-ui][data-agent-server-ui] {\\n${scaleDecls}\\n${herouiDecls}\\n${tokenDecls}\\n}`,\n    `[data-theme=dark][data-theme=dark] {\\n${herouiDecls}\\n}`,\n  ].join(\"\\n\");\n\n  let styleEl = document.getElementById(\n    THEME_STYLE_TAG_ID,\n  ) as HTMLStyleElement | null;\n  if (!styleEl) {\n    styleEl = document.createElement(\"style\");\n    styleEl.id = THEME_STYLE_TAG_ID;\n  }\n  styleEl.textContent = css;\n  // Re-append even when the tag already exists (appendChild relocates a\n  // connected node) so the override also stays after any re-inserted <link>.\n  document.head.appendChild(styleEl);\n\n  syncColorThemeTokensOnScopeRoots(tokens);\n}\n\nfunction syncColorThemeTokensOnScopeRoots(\n  tokens: Record<string, string>,\n): void {\n  const roots = document.querySelectorAll(\"[data-agent-server-ui]\");\n  for (const root of roots) {\n    if (!(root instanceof HTMLElement)) continue;\n\n    for (const key of COLOR_THEME_TOKEN_KEYS) {\n      const value = tokens[key];\n      if (value) {\n        root.style.setProperty(key, value);\n      } else {\n        root.style.removeProperty(key);\n      }\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"color-themes.cjs","names":[],"sources":["../../src/themes/color-themes.ts"],"sourcesContent":["export type ColorThemeKey =\n  | \"openhands-deepsea\"\n  | \"openhands-neutral\"\n  | \"openhands-neo\";\n\nexport interface ColorThemeDefinition {\n  label: string;\n  /** Overrides for --cool-grey-* CSS custom properties (our semantic scale) */\n  scale: Record<string, string>;\n  /**\n   * Overrides for --heroui-* CSS custom properties.\n   * HeroUI stores colors as space-separated HSL channels (\"H S% L%\") so Tailwind\n   * utilities like bg-default-200 resolve to hsl(var(--heroui-default-200)).\n   * These vars are set by the heroui() plugin on :root, [data-theme=dark] at\n   * build time, so they must be overridden at the same or lower specificity\n   * from a later stylesheet to pick up theme changes at runtime.\n   */\n  heroui: Record<string, string>;\n  /** Overrides for --oh-* semantic tokens such as brand / button colors. */\n  tokens?: Record<string, string>;\n}\n\n// HSL channel strings for the neutral grey palette (H=0, S=0%, L=hex/255*100)\n// prettier-ignore\nconst NEUTRAL_HSL = {\n  50:  \"0 0% 96.86%\", // #F7F7F7\n  100: \"0 0% 92.55%\", // #ECECEC\n  200: \"0 0% 86.27%\", // #DCDCDC\n  300: \"0 0% 74.51%\", // #BEBEBE\n  400: \"0 0% 59.22%\", // #979797\n  500: \"0 0% 45.1%\",  // #737373\n  600: \"0 0% 33.73%\", // #565656\n  700: \"0 0% 25.1%\",  // #404040\n  800: \"0 0% 19.22%\", // #313131\n  850: \"0 0% 15.69%\", // #282828\n  900: \"0 0% 12.55%\", // #202020\n  950: \"0 0% 9.41%\",  // #181818\n  975: \"0 0% 6.27%\",  // #101010\n};\n\nconst NEUTRAL_SCALE = {\n  \"--cool-grey-50\": \"#F7F7F7\",\n  \"--cool-grey-100\": \"#ECECEC\",\n  \"--cool-grey-200\": \"#DCDCDC\",\n  \"--cool-grey-300\": \"#BEBEBE\",\n  \"--cool-grey-400\": \"#979797\",\n  \"--cool-grey-500\": \"#737373\",\n  \"--cool-grey-600\": \"#565656\",\n  \"--cool-grey-700\": \"#404040\",\n  \"--cool-grey-800\": \"#313131\",\n  \"--cool-grey-900\": \"#282828\",\n  \"--cool-grey-925\": \"#202020\",\n  \"--cool-grey-950\": \"#181818\",\n  \"--cool-grey-975\": \"#101010\",\n};\n\nconst NEUTRAL_HEROUI = {\n  \"--heroui-background\": NEUTRAL_HSL[950],\n  \"--heroui-background-foreground\": NEUTRAL_HSL[50],\n  \"--heroui-foreground-50\": NEUTRAL_HSL[975],\n  \"--heroui-foreground-100\": NEUTRAL_HSL[950],\n  \"--heroui-foreground-200\": NEUTRAL_HSL[900],\n  \"--heroui-foreground-300\": NEUTRAL_HSL[850],\n  \"--heroui-foreground-400\": NEUTRAL_HSL[800],\n  \"--heroui-foreground-500\": NEUTRAL_HSL[700],\n  \"--heroui-foreground-600\": NEUTRAL_HSL[600],\n  \"--heroui-foreground-700\": NEUTRAL_HSL[500],\n  \"--heroui-foreground-800\": NEUTRAL_HSL[400],\n  \"--heroui-foreground-900\": NEUTRAL_HSL[300],\n  \"--heroui-foreground\": NEUTRAL_HSL[300],\n  \"--heroui-content1\": NEUTRAL_HSL[900],\n  \"--heroui-content1-foreground\": NEUTRAL_HSL[100],\n  \"--heroui-content2\": NEUTRAL_HSL[850],\n  \"--heroui-content2-foreground\": NEUTRAL_HSL[200],\n  \"--heroui-content3\": NEUTRAL_HSL[800],\n  \"--heroui-content3-foreground\": NEUTRAL_HSL[300],\n  \"--heroui-content4\": NEUTRAL_HSL[700],\n  \"--heroui-content4-foreground\": NEUTRAL_HSL[400],\n  \"--heroui-default-50\": NEUTRAL_HSL[975],\n  \"--heroui-default-100\": NEUTRAL_HSL[950],\n  \"--heroui-default-200\": NEUTRAL_HSL[900],\n  \"--heroui-default-300\": NEUTRAL_HSL[850],\n  \"--heroui-default-400\": NEUTRAL_HSL[800],\n  \"--heroui-default-500\": NEUTRAL_HSL[700],\n  \"--heroui-default-600\": NEUTRAL_HSL[600],\n  \"--heroui-default-700\": NEUTRAL_HSL[500],\n  \"--heroui-default-800\": NEUTRAL_HSL[400],\n  \"--heroui-default-900\": NEUTRAL_HSL[300],\n  \"--heroui-default-foreground\": NEUTRAL_HSL[50],\n  \"--heroui-default\": NEUTRAL_HSL[800],\n};\n\nimport { AGENT_SERVER_UI_THEMEABLE_BRAND_VARIABLES } from \"#/styles/agent-server-ui-style-scope\";\n\n/** CSS custom properties overridden by color themes (see applyColorTheme). */\nexport const COLOR_THEME_TOKEN_KEYS = AGENT_SERVER_UI_THEMEABLE_BRAND_VARIABLES;\n\n/** White primary/accent tokens — used by OpenHands-Neo for button surfaces. */\nconst NEO_WHITE_BUTTON_TOKENS: Record<\n  (typeof COLOR_THEME_TOKEN_KEYS)[number],\n  string\n> = {\n  \"--oh-color-primary\": \"#ffffff\",\n  \"--oh-accent\": \"#ffffff\",\n  \"--oh-warning\": \"#ffffff\",\n};\n\nexport const COLOR_THEMES: Record<ColorThemeKey, ColorThemeDefinition> = {\n  \"openhands-deepsea\": {\n    label: \"OpenHands-DeepSea\",\n    // Matches the values already set by index.css; included so switching back\n    // from another theme restores the original palette explicitly.\n    scale: {\n      \"--cool-grey-50\": \"#F7F9FC\",\n      \"--cool-grey-100\": \"#EEF2F7\",\n      \"--cool-grey-200\": \"#DCE3EE\",\n      \"--cool-grey-300\": \"#C3CDDC\",\n      \"--cool-grey-400\": \"#A3B0C4\",\n      \"--cool-grey-500\": \"#7E8A9E\",\n      \"--cool-grey-600\": \"#626D82\",\n      \"--cool-grey-700\": \"#4B5468\",\n      \"--cool-grey-800\": \"#383F50\",\n      \"--cool-grey-900\": \"#2C313F\",\n      \"--cool-grey-925\": \"#21252F\",\n      \"--cool-grey-950\": \"#0B0E14\",\n      \"--cool-grey-975\": \"#05070A\",\n    },\n    // Values generated by heroui() from hero.ts — restore them explicitly when\n    // switching back from another theme.\n    heroui: {\n      \"--heroui-background\": \"220 29.03% 6.08%\",\n      \"--heroui-background-foreground\": \"216 45.45% 97.84%\",\n      \"--heroui-foreground-50\": \"216 33.33% 2.94%\",\n      \"--heroui-foreground-100\": \"220 29.03% 6.08%\",\n      \"--heroui-foreground-200\": \"222.86 17.5% 15.69%\",\n      \"--heroui-foreground-300\": \"224.21 17.76% 20.98%\",\n      \"--heroui-foreground-400\": \"222.5 17.65% 26.67%\",\n      \"--heroui-foreground-500\": \"221.38 16.2% 35.1%\",\n      \"--heroui-foreground-600\": \"219.38 14.04% 44.71%\",\n      \"--heroui-foreground-700\": \"217.5 14.16% 55.69%\",\n      \"--heroui-foreground-800\": \"216.36 21.85% 70.39%\",\n      \"--heroui-foreground-900\": \"216 26.32% 81.37%\",\n      \"--heroui-foreground\": \"216 26.32% 81.37%\",\n      \"--heroui-content1\": \"222.86 17.5% 15.69%\",\n      \"--heroui-content1-foreground\": \"213.33 36% 95.1%\",\n      \"--heroui-content2\": \"224.21 17.76% 20.98%\",\n      \"--heroui-content2-foreground\": \"216.67 34.62% 89.8%\",\n      \"--heroui-content3\": \"222.5 17.65% 26.67%\",\n      \"--heroui-content3-foreground\": \"216 26.32% 81.37%\",\n      \"--heroui-content4\": \"221.38 16.2% 35.1%\",\n      \"--heroui-content4-foreground\": \"216.36 21.85% 70.39%\",\n      \"--heroui-default-50\": \"216 33.33% 2.94%\",\n      \"--heroui-default-100\": \"220 29.03% 6.08%\",\n      \"--heroui-default-200\": \"222.86 17.5% 15.69%\",\n      \"--heroui-default-300\": \"224.21 17.76% 20.98%\",\n      \"--heroui-default-400\": \"222.5 17.65% 26.67%\",\n      \"--heroui-default-500\": \"221.38 16.2% 35.1%\",\n      \"--heroui-default-600\": \"219.38 14.04% 44.71%\",\n      \"--heroui-default-700\": \"217.5 14.16% 55.69%\",\n      \"--heroui-default-800\": \"216.36 21.85% 70.39%\",\n      \"--heroui-default-900\": \"216 26.32% 81.37%\",\n      \"--heroui-default-foreground\": \"216 45.45% 97.84%\",\n      \"--heroui-default\": \"222.5 17.65% 26.67%\",\n    },\n  },\n\n  \"openhands-neutral\": {\n    label: \"OpenHands-Neutral\",\n    scale: NEUTRAL_SCALE,\n    // Each stop follows the same positional mapping as hero.ts:\n    //   heroui-default-100 ← cool-grey-950 position ← neutral-950 (#181818)\n    //   heroui-default-200 ← cool-grey-925 position ← neutral-900 (#202020)\n    //   ...etc.\n    heroui: NEUTRAL_HEROUI,\n  },\n\n  \"openhands-neo\": {\n    label: \"OpenHands-Neo\",\n    scale: NEUTRAL_SCALE,\n    heroui: NEUTRAL_HEROUI,\n    tokens: NEO_WHITE_BUTTON_TOKENS,\n  },\n};\n\nexport const DEFAULT_COLOR_THEME: ColorThemeKey = \"openhands-neutral\";\n\nexport const AVAILABLE_COLOR_THEMES = Object.entries(COLOR_THEMES).map(\n  ([key, def]) => ({ key: key as ColorThemeKey, label: def.label }),\n);\n\nconst STORAGE_KEY = \"openhands-color-theme\";\n\n/** Read the persisted theme key from localStorage, falling back to the default. */\nexport function readPersistedColorTheme(): ColorThemeKey {\n  if (typeof window === \"undefined\") return DEFAULT_COLOR_THEME;\n  try {\n    const stored = window.localStorage.getItem(STORAGE_KEY);\n    if (stored && stored in COLOR_THEMES) return stored as ColorThemeKey;\n  } catch {\n    // ignore quota / privacy-mode failures\n  }\n  return DEFAULT_COLOR_THEME;\n}\n\n/** Persist the theme key to localStorage. */\nexport function persistColorTheme(key: ColorThemeKey): void {\n  try {\n    window.localStorage.setItem(STORAGE_KEY, key);\n  } catch {\n    // ignore\n  }\n}\n\nconst THEME_STYLE_TAG_ID = \"oh-color-theme-override\";\n\n/**\n * Apply a theme by injecting (or replacing) a <style> tag that overrides\n * both our custom --cool-grey-* primitives and HeroUI's --heroui-* tokens.\n *\n * Why a <style> tag:\n *   PostCSS transforms :root / body to [data-agent-server-ui], so --cool-grey-*\n *   is set on EVERY element carrying that attribute. A body inline-style only\n *   overrides body itself — inner matching elements keep the stylesheet value.\n *\n * Why heroui variables:\n *   HeroUI stores colors as HSL channels in --heroui-* vars on [data-theme=dark].\n *   They reference their own token system and are unaffected by --cool-grey-*\n *   changes, so we override them from the same injected sheet.\n *\n * Why doubled selectors + re-append on every call:\n *   \"Later sheet wins the tie\" cannot be relied on: in the built SPA\n *   (ssr:false, prerendered shell) React 19 re-creates the <head> elements it\n *   manages (<Meta/>/<Links/>) whenever the tree above the router remounts.\n *   That can re-insert the base stylesheet <link> AFTER this tag, allowing its\n *   unlayered [data-agent-server-ui] variable rules (0,1,0) to win every tie.\n *   Doubling the attribute selectors ([x][x], 0,2,0) beats them from any\n *   position in <head>; re-appending on each apply keeps document order\n *   favorable as well.\n */\nexport function applyColorTheme(key: ColorThemeKey): void {\n  if (typeof document === \"undefined\") return;\n  const { scale, heroui, tokens = {} } = COLOR_THEMES[key];\n\n  const scaleDecls = Object.entries(scale)\n    .map(([p, v]) => `  ${p}: ${v};`)\n    .join(\"\\n\");\n\n  const herouiDecls = Object.entries(heroui)\n    .map(([p, v]) => `  ${p}: ${v};`)\n    .join(\"\\n\");\n\n  const tokenDecls = Object.entries(tokens)\n    .map(([p, v]) => `  ${p}: ${v};`)\n    .join(\"\\n\");\n\n  // Target both selectors for heroui vars:\n  //   [data-agent-server-ui] — covers document.body (portal destination) so\n  //     portalled popover/listbox content inherits the overridden values.\n  //   [data-theme=dark]      — covers the inner AgentServerUIRoot wrapper so\n  //     components scoped inside the dark theme wrapper also pick them up.\n  // Both are doubled to out-specify the base sheet regardless of stylesheet\n  // order (see the doc comment above).\n  const css = [\n    `[data-agent-server-ui][data-agent-server-ui] {\\n${scaleDecls}\\n${herouiDecls}\\n${tokenDecls}\\n}`,\n    `[data-theme=dark][data-theme=dark] {\\n${herouiDecls}\\n}`,\n  ].join(\"\\n\");\n\n  let styleEl = document.getElementById(\n    THEME_STYLE_TAG_ID,\n  ) as HTMLStyleElement | null;\n  if (!styleEl) {\n    styleEl = document.createElement(\"style\");\n    styleEl.id = THEME_STYLE_TAG_ID;\n  }\n  styleEl.textContent = css;\n  // Re-append even when the tag already exists (appendChild relocates a\n  // connected node) so the override also stays after any re-inserted <link>.\n  document.head.appendChild(styleEl);\n\n  syncColorThemeTokensOnScopeRoots(tokens);\n}\n\nfunction syncColorThemeTokensOnScopeRoots(\n  tokens: Record<string, string>,\n): void {\n  const roots = document.querySelectorAll(\"[data-agent-server-ui]\");\n  for (const root of roots) {\n    if (!(root instanceof HTMLElement)) continue;\n\n    for (const key of COLOR_THEME_TOKEN_KEYS) {\n      const value = tokens[key];\n      if (value) {\n        root.style.setProperty(key, value);\n      } else {\n        root.style.removeProperty(key);\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/themes/color-themes.d.ts

@@ -44,12 +44,9 @@ export declare function persistColorTheme(key: ColorThemeKey): void;
  * Why doubled selectors + re-append on every call:
  *   "Later sheet wins the tie" cannot be relied on: in the built SPA
  *   (ssr:false, prerendered shell) React 19 re-creates the <head> elements it
- *   manages (<Meta/>/<Links/>) whenever the tree above the router remounts —
- *   e.g. PostHogWrapper swapping in <PostHogProvider> once the analytics key
- *   resolves, which only happens in builds with VITE_POSTHOG_CLIENT_KEY baked
- *   (the published npm package / tagged Docker images). That re-inserts the
- *   base stylesheet <link> AFTER this tag, which would let the base sheet's
- *   unlayered [data-agent-server-ui] variable rules (0,1,0) win every tie.
+ *   manages (<Meta/>/<Links/>) whenever the tree above the router remounts.
+ *   That can re-insert the base stylesheet <link> AFTER this tag, allowing its
+ *   unlayered [data-agent-server-ui] variable rules (0,1,0) to win every tie.
  *   Doubling the attribute selectors ([x][x], 0,2,0) beats them from any
  *   position in <head>; re-appending on each apply keeps document order
  *   favorable as well.

package/dist/themes/color-themes.js.map

@@ -1 +1 @@
-{"version":3,"file":"color-themes.js","names":[],"sources":["../../src/themes/color-themes.ts"],"sourcesContent":["export type ColorThemeKey =\n  | \"openhands-deepsea\"\n  | \"openhands-neutral\"\n  | \"openhands-neo\";\n\nexport interface ColorThemeDefinition {\n  label: string;\n  /** Overrides for --cool-grey-* CSS custom properties (our semantic scale) */\n  scale: Record<string, string>;\n  /**\n   * Overrides for --heroui-* CSS custom properties.\n   * HeroUI stores colors as space-separated HSL channels (\"H S% L%\") so Tailwind\n   * utilities like bg-default-200 resolve to hsl(var(--heroui-default-200)).\n   * These vars are set by the heroui() plugin on :root, [data-theme=dark] at\n   * build time, so they must be overridden at the same or lower specificity\n   * from a later stylesheet to pick up theme changes at runtime.\n   */\n  heroui: Record<string, string>;\n  /** Overrides for --oh-* semantic tokens such as brand / button colors. */\n  tokens?: Record<string, string>;\n}\n\n// HSL channel strings for the neutral grey palette (H=0, S=0%, L=hex/255*100)\n// prettier-ignore\nconst NEUTRAL_HSL = {\n  50:  \"0 0% 96.86%\", // #F7F7F7\n  100: \"0 0% 92.55%\", // #ECECEC\n  200: \"0 0% 86.27%\", // #DCDCDC\n  300: \"0 0% 74.51%\", // #BEBEBE\n  400: \"0 0% 59.22%\", // #979797\n  500: \"0 0% 45.1%\",  // #737373\n  600: \"0 0% 33.73%\", // #565656\n  700: \"0 0% 25.1%\",  // #404040\n  800: \"0 0% 19.22%\", // #313131\n  850: \"0 0% 15.69%\", // #282828\n  900: \"0 0% 12.55%\", // #202020\n  950: \"0 0% 9.41%\",  // #181818\n  975: \"0 0% 6.27%\",  // #101010\n};\n\nconst NEUTRAL_SCALE = {\n  \"--cool-grey-50\": \"#F7F7F7\",\n  \"--cool-grey-100\": \"#ECECEC\",\n  \"--cool-grey-200\": \"#DCDCDC\",\n  \"--cool-grey-300\": \"#BEBEBE\",\n  \"--cool-grey-400\": \"#979797\",\n  \"--cool-grey-500\": \"#737373\",\n  \"--cool-grey-600\": \"#565656\",\n  \"--cool-grey-700\": \"#404040\",\n  \"--cool-grey-800\": \"#313131\",\n  \"--cool-grey-900\": \"#282828\",\n  \"--cool-grey-925\": \"#202020\",\n  \"--cool-grey-950\": \"#181818\",\n  \"--cool-grey-975\": \"#101010\",\n};\n\nconst NEUTRAL_HEROUI = {\n  \"--heroui-background\": NEUTRAL_HSL[950],\n  \"--heroui-background-foreground\": NEUTRAL_HSL[50],\n  \"--heroui-foreground-50\": NEUTRAL_HSL[975],\n  \"--heroui-foreground-100\": NEUTRAL_HSL[950],\n  \"--heroui-foreground-200\": NEUTRAL_HSL[900],\n  \"--heroui-foreground-300\": NEUTRAL_HSL[850],\n  \"--heroui-foreground-400\": NEUTRAL_HSL[800],\n  \"--heroui-foreground-500\": NEUTRAL_HSL[700],\n  \"--heroui-foreground-600\": NEUTRAL_HSL[600],\n  \"--heroui-foreground-700\": NEUTRAL_HSL[500],\n  \"--heroui-foreground-800\": NEUTRAL_HSL[400],\n  \"--heroui-foreground-900\": NEUTRAL_HSL[300],\n  \"--heroui-foreground\": NEUTRAL_HSL[300],\n  \"--heroui-content1\": NEUTRAL_HSL[900],\n  \"--heroui-content1-foreground\": NEUTRAL_HSL[100],\n  \"--heroui-content2\": NEUTRAL_HSL[850],\n  \"--heroui-content2-foreground\": NEUTRAL_HSL[200],\n  \"--heroui-content3\": NEUTRAL_HSL[800],\n  \"--heroui-content3-foreground\": NEUTRAL_HSL[300],\n  \"--heroui-content4\": NEUTRAL_HSL[700],\n  \"--heroui-content4-foreground\": NEUTRAL_HSL[400],\n  \"--heroui-default-50\": NEUTRAL_HSL[975],\n  \"--heroui-default-100\": NEUTRAL_HSL[950],\n  \"--heroui-default-200\": NEUTRAL_HSL[900],\n  \"--heroui-default-300\": NEUTRAL_HSL[850],\n  \"--heroui-default-400\": NEUTRAL_HSL[800],\n  \"--heroui-default-500\": NEUTRAL_HSL[700],\n  \"--heroui-default-600\": NEUTRAL_HSL[600],\n  \"--heroui-default-700\": NEUTRAL_HSL[500],\n  \"--heroui-default-800\": NEUTRAL_HSL[400],\n  \"--heroui-default-900\": NEUTRAL_HSL[300],\n  \"--heroui-default-foreground\": NEUTRAL_HSL[50],\n  \"--heroui-default\": NEUTRAL_HSL[800],\n};\n\nimport { AGENT_SERVER_UI_THEMEABLE_BRAND_VARIABLES } from \"#/styles/agent-server-ui-style-scope\";\n\n/** CSS custom properties overridden by color themes (see applyColorTheme). */\nexport const COLOR_THEME_TOKEN_KEYS = AGENT_SERVER_UI_THEMEABLE_BRAND_VARIABLES;\n\n/** White primary/accent tokens — used by OpenHands-Neo for button surfaces. */\nconst NEO_WHITE_BUTTON_TOKENS: Record<\n  (typeof COLOR_THEME_TOKEN_KEYS)[number],\n  string\n> = {\n  \"--oh-color-primary\": \"#ffffff\",\n  \"--oh-accent\": \"#ffffff\",\n  \"--oh-warning\": \"#ffffff\",\n};\n\nexport const COLOR_THEMES: Record<ColorThemeKey, ColorThemeDefinition> = {\n  \"openhands-deepsea\": {\n    label: \"OpenHands-DeepSea\",\n    // Matches the values already set by index.css; included so switching back\n    // from another theme restores the original palette explicitly.\n    scale: {\n      \"--cool-grey-50\": \"#F7F9FC\",\n      \"--cool-grey-100\": \"#EEF2F7\",\n      \"--cool-grey-200\": \"#DCE3EE\",\n      \"--cool-grey-300\": \"#C3CDDC\",\n      \"--cool-grey-400\": \"#A3B0C4\",\n      \"--cool-grey-500\": \"#7E8A9E\",\n      \"--cool-grey-600\": \"#626D82\",\n      \"--cool-grey-700\": \"#4B5468\",\n      \"--cool-grey-800\": \"#383F50\",\n      \"--cool-grey-900\": \"#2C313F\",\n      \"--cool-grey-925\": \"#21252F\",\n      \"--cool-grey-950\": \"#0B0E14\",\n      \"--cool-grey-975\": \"#05070A\",\n    },\n    // Values generated by heroui() from hero.ts — restore them explicitly when\n    // switching back from another theme.\n    heroui: {\n      \"--heroui-background\": \"220 29.03% 6.08%\",\n      \"--heroui-background-foreground\": \"216 45.45% 97.84%\",\n      \"--heroui-foreground-50\": \"216 33.33% 2.94%\",\n      \"--heroui-foreground-100\": \"220 29.03% 6.08%\",\n      \"--heroui-foreground-200\": \"222.86 17.5% 15.69%\",\n      \"--heroui-foreground-300\": \"224.21 17.76% 20.98%\",\n      \"--heroui-foreground-400\": \"222.5 17.65% 26.67%\",\n      \"--heroui-foreground-500\": \"221.38 16.2% 35.1%\",\n      \"--heroui-foreground-600\": \"219.38 14.04% 44.71%\",\n      \"--heroui-foreground-700\": \"217.5 14.16% 55.69%\",\n      \"--heroui-foreground-800\": \"216.36 21.85% 70.39%\",\n      \"--heroui-foreground-900\": \"216 26.32% 81.37%\",\n      \"--heroui-foreground\": \"216 26.32% 81.37%\",\n      \"--heroui-content1\": \"222.86 17.5% 15.69%\",\n      \"--heroui-content1-foreground\": \"213.33 36% 95.1%\",\n      \"--heroui-content2\": \"224.21 17.76% 20.98%\",\n      \"--heroui-content2-foreground\": \"216.67 34.62% 89.8%\",\n      \"--heroui-content3\": \"222.5 17.65% 26.67%\",\n      \"--heroui-content3-foreground\": \"216 26.32% 81.37%\",\n      \"--heroui-content4\": \"221.38 16.2% 35.1%\",\n      \"--heroui-content4-foreground\": \"216.36 21.85% 70.39%\",\n      \"--heroui-default-50\": \"216 33.33% 2.94%\",\n      \"--heroui-default-100\": \"220 29.03% 6.08%\",\n      \"--heroui-default-200\": \"222.86 17.5% 15.69%\",\n      \"--heroui-default-300\": \"224.21 17.76% 20.98%\",\n      \"--heroui-default-400\": \"222.5 17.65% 26.67%\",\n      \"--heroui-default-500\": \"221.38 16.2% 35.1%\",\n      \"--heroui-default-600\": \"219.38 14.04% 44.71%\",\n      \"--heroui-default-700\": \"217.5 14.16% 55.69%\",\n      \"--heroui-default-800\": \"216.36 21.85% 70.39%\",\n      \"--heroui-default-900\": \"216 26.32% 81.37%\",\n      \"--heroui-default-foreground\": \"216 45.45% 97.84%\",\n      \"--heroui-default\": \"222.5 17.65% 26.67%\",\n    },\n  },\n\n  \"openhands-neutral\": {\n    label: \"OpenHands-Neutral\",\n    scale: NEUTRAL_SCALE,\n    // Each stop follows the same positional mapping as hero.ts:\n    //   heroui-default-100 ← cool-grey-950 position ← neutral-950 (#181818)\n    //   heroui-default-200 ← cool-grey-925 position ← neutral-900 (#202020)\n    //   ...etc.\n    heroui: NEUTRAL_HEROUI,\n  },\n\n  \"openhands-neo\": {\n    label: \"OpenHands-Neo\",\n    scale: NEUTRAL_SCALE,\n    heroui: NEUTRAL_HEROUI,\n    tokens: NEO_WHITE_BUTTON_TOKENS,\n  },\n};\n\nexport const DEFAULT_COLOR_THEME: ColorThemeKey = \"openhands-neutral\";\n\nexport const AVAILABLE_COLOR_THEMES = Object.entries(COLOR_THEMES).map(\n  ([key, def]) => ({ key: key as ColorThemeKey, label: def.label }),\n);\n\nconst STORAGE_KEY = \"openhands-color-theme\";\n\n/** Read the persisted theme key from localStorage, falling back to the default. */\nexport function readPersistedColorTheme(): ColorThemeKey {\n  if (typeof window === \"undefined\") return DEFAULT_COLOR_THEME;\n  try {\n    const stored = window.localStorage.getItem(STORAGE_KEY);\n    if (stored && stored in COLOR_THEMES) return stored as ColorThemeKey;\n  } catch {\n    // ignore quota / privacy-mode failures\n  }\n  return DEFAULT_COLOR_THEME;\n}\n\n/** Persist the theme key to localStorage. */\nexport function persistColorTheme(key: ColorThemeKey): void {\n  try {\n    window.localStorage.setItem(STORAGE_KEY, key);\n  } catch {\n    // ignore\n  }\n}\n\nconst THEME_STYLE_TAG_ID = \"oh-color-theme-override\";\n\n/**\n * Apply a theme by injecting (or replacing) a <style> tag that overrides\n * both our custom --cool-grey-* primitives and HeroUI's --heroui-* tokens.\n *\n * Why a <style> tag:\n *   PostCSS transforms :root / body to [data-agent-server-ui], so --cool-grey-*\n *   is set on EVERY element carrying that attribute. A body inline-style only\n *   overrides body itself — inner matching elements keep the stylesheet value.\n *\n * Why heroui variables:\n *   HeroUI stores colors as HSL channels in --heroui-* vars on [data-theme=dark].\n *   They reference their own token system and are unaffected by --cool-grey-*\n *   changes, so we override them from the same injected sheet.\n *\n * Why doubled selectors + re-append on every call:\n *   \"Later sheet wins the tie\" cannot be relied on: in the built SPA\n *   (ssr:false, prerendered shell) React 19 re-creates the <head> elements it\n *   manages (<Meta/>/<Links/>) whenever the tree above the router remounts —\n *   e.g. PostHogWrapper swapping in <PostHogProvider> once the analytics key\n *   resolves, which only happens in builds with VITE_POSTHOG_CLIENT_KEY baked\n *   (the published npm package / tagged Docker images). That re-inserts the\n *   base stylesheet <link> AFTER this tag, which would let the base sheet's\n *   unlayered [data-agent-server-ui] variable rules (0,1,0) win every tie.\n *   Doubling the attribute selectors ([x][x], 0,2,0) beats them from any\n *   position in <head>; re-appending on each apply keeps document order\n *   favorable as well.\n */\nexport function applyColorTheme(key: ColorThemeKey): void {\n  if (typeof document === \"undefined\") return;\n  const { scale, heroui, tokens = {} } = COLOR_THEMES[key];\n\n  const scaleDecls = Object.entries(scale)\n    .map(([p, v]) => `  ${p}: ${v};`)\n    .join(\"\\n\");\n\n  const herouiDecls = Object.entries(heroui)\n    .map(([p, v]) => `  ${p}: ${v};`)\n    .join(\"\\n\");\n\n  const tokenDecls = Object.entries(tokens)\n    .map(([p, v]) => `  ${p}: ${v};`)\n    .join(\"\\n\");\n\n  // Target both selectors for heroui vars:\n  //   [data-agent-server-ui] — covers document.body (portal destination) so\n  //     portalled popover/listbox content inherits the overridden values.\n  //   [data-theme=dark]      — covers the inner AgentServerUIRoot wrapper so\n  //     components scoped inside the dark theme wrapper also pick them up.\n  // Both are doubled to out-specify the base sheet regardless of stylesheet\n  // order (see the doc comment above).\n  const css = [\n    `[data-agent-server-ui][data-agent-server-ui] {\\n${scaleDecls}\\n${herouiDecls}\\n${tokenDecls}\\n}`,\n    `[data-theme=dark][data-theme=dark] {\\n${herouiDecls}\\n}`,\n  ].join(\"\\n\");\n\n  let styleEl = document.getElementById(\n    THEME_STYLE_TAG_ID,\n  ) as HTMLStyleElement | null;\n  if (!styleEl) {\n    styleEl = document.createElement(\"style\");\n    styleEl.id = THEME_STYLE_TAG_ID;\n  }\n  styleEl.textContent = css;\n  // Re-append even when the tag already exists (appendChild relocates a\n  // connected node) so the override also stays after any re-inserted <link>.\n  document.head.appendChild(styleEl);\n\n  syncColorThemeTokensOnScopeRoots(tokens);\n}\n\nfunction syncColorThemeTokensOnScopeRoots(\n  tokens: Record<string, string>,\n): void {\n  const roots = document.querySelectorAll(\"[data-agent-server-ui]\");\n  for (const root of roots) {\n    if (!(root instanceof HTMLElement)) continue;\n\n    for (const key of COLOR_THEME_TOKEN_KEYS) {\n      const value = tokens[key];\n      if (value) {\n        root.style.setProperty(key, value);\n      } else {\n        root.style.removeProperty(key);\n      }\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"color-themes.js","names":[],"sources":["../../src/themes/color-themes.ts"],"sourcesContent":["export type ColorThemeKey =\n  | \"openhands-deepsea\"\n  | \"openhands-neutral\"\n  | \"openhands-neo\";\n\nexport interface ColorThemeDefinition {\n  label: string;\n  /** Overrides for --cool-grey-* CSS custom properties (our semantic scale) */\n  scale: Record<string, string>;\n  /**\n   * Overrides for --heroui-* CSS custom properties.\n   * HeroUI stores colors as space-separated HSL channels (\"H S% L%\") so Tailwind\n   * utilities like bg-default-200 resolve to hsl(var(--heroui-default-200)).\n   * These vars are set by the heroui() plugin on :root, [data-theme=dark] at\n   * build time, so they must be overridden at the same or lower specificity\n   * from a later stylesheet to pick up theme changes at runtime.\n   */\n  heroui: Record<string, string>;\n  /** Overrides for --oh-* semantic tokens such as brand / button colors. */\n  tokens?: Record<string, string>;\n}\n\n// HSL channel strings for the neutral grey palette (H=0, S=0%, L=hex/255*100)\n// prettier-ignore\nconst NEUTRAL_HSL = {\n  50:  \"0 0% 96.86%\", // #F7F7F7\n  100: \"0 0% 92.55%\", // #ECECEC\n  200: \"0 0% 86.27%\", // #DCDCDC\n  300: \"0 0% 74.51%\", // #BEBEBE\n  400: \"0 0% 59.22%\", // #979797\n  500: \"0 0% 45.1%\",  // #737373\n  600: \"0 0% 33.73%\", // #565656\n  700: \"0 0% 25.1%\",  // #404040\n  800: \"0 0% 19.22%\", // #313131\n  850: \"0 0% 15.69%\", // #282828\n  900: \"0 0% 12.55%\", // #202020\n  950: \"0 0% 9.41%\",  // #181818\n  975: \"0 0% 6.27%\",  // #101010\n};\n\nconst NEUTRAL_SCALE = {\n  \"--cool-grey-50\": \"#F7F7F7\",\n  \"--cool-grey-100\": \"#ECECEC\",\n  \"--cool-grey-200\": \"#DCDCDC\",\n  \"--cool-grey-300\": \"#BEBEBE\",\n  \"--cool-grey-400\": \"#979797\",\n  \"--cool-grey-500\": \"#737373\",\n  \"--cool-grey-600\": \"#565656\",\n  \"--cool-grey-700\": \"#404040\",\n  \"--cool-grey-800\": \"#313131\",\n  \"--cool-grey-900\": \"#282828\",\n  \"--cool-grey-925\": \"#202020\",\n  \"--cool-grey-950\": \"#181818\",\n  \"--cool-grey-975\": \"#101010\",\n};\n\nconst NEUTRAL_HEROUI = {\n  \"--heroui-background\": NEUTRAL_HSL[950],\n  \"--heroui-background-foreground\": NEUTRAL_HSL[50],\n  \"--heroui-foreground-50\": NEUTRAL_HSL[975],\n  \"--heroui-foreground-100\": NEUTRAL_HSL[950],\n  \"--heroui-foreground-200\": NEUTRAL_HSL[900],\n  \"--heroui-foreground-300\": NEUTRAL_HSL[850],\n  \"--heroui-foreground-400\": NEUTRAL_HSL[800],\n  \"--heroui-foreground-500\": NEUTRAL_HSL[700],\n  \"--heroui-foreground-600\": NEUTRAL_HSL[600],\n  \"--heroui-foreground-700\": NEUTRAL_HSL[500],\n  \"--heroui-foreground-800\": NEUTRAL_HSL[400],\n  \"--heroui-foreground-900\": NEUTRAL_HSL[300],\n  \"--heroui-foreground\": NEUTRAL_HSL[300],\n  \"--heroui-content1\": NEUTRAL_HSL[900],\n  \"--heroui-content1-foreground\": NEUTRAL_HSL[100],\n  \"--heroui-content2\": NEUTRAL_HSL[850],\n  \"--heroui-content2-foreground\": NEUTRAL_HSL[200],\n  \"--heroui-content3\": NEUTRAL_HSL[800],\n  \"--heroui-content3-foreground\": NEUTRAL_HSL[300],\n  \"--heroui-content4\": NEUTRAL_HSL[700],\n  \"--heroui-content4-foreground\": NEUTRAL_HSL[400],\n  \"--heroui-default-50\": NEUTRAL_HSL[975],\n  \"--heroui-default-100\": NEUTRAL_HSL[950],\n  \"--heroui-default-200\": NEUTRAL_HSL[900],\n  \"--heroui-default-300\": NEUTRAL_HSL[850],\n  \"--heroui-default-400\": NEUTRAL_HSL[800],\n  \"--heroui-default-500\": NEUTRAL_HSL[700],\n  \"--heroui-default-600\": NEUTRAL_HSL[600],\n  \"--heroui-default-700\": NEUTRAL_HSL[500],\n  \"--heroui-default-800\": NEUTRAL_HSL[400],\n  \"--heroui-default-900\": NEUTRAL_HSL[300],\n  \"--heroui-default-foreground\": NEUTRAL_HSL[50],\n  \"--heroui-default\": NEUTRAL_HSL[800],\n};\n\nimport { AGENT_SERVER_UI_THEMEABLE_BRAND_VARIABLES } from \"#/styles/agent-server-ui-style-scope\";\n\n/** CSS custom properties overridden by color themes (see applyColorTheme). */\nexport const COLOR_THEME_TOKEN_KEYS = AGENT_SERVER_UI_THEMEABLE_BRAND_VARIABLES;\n\n/** White primary/accent tokens — used by OpenHands-Neo for button surfaces. */\nconst NEO_WHITE_BUTTON_TOKENS: Record<\n  (typeof COLOR_THEME_TOKEN_KEYS)[number],\n  string\n> = {\n  \"--oh-color-primary\": \"#ffffff\",\n  \"--oh-accent\": \"#ffffff\",\n  \"--oh-warning\": \"#ffffff\",\n};\n\nexport const COLOR_THEMES: Record<ColorThemeKey, ColorThemeDefinition> = {\n  \"openhands-deepsea\": {\n    label: \"OpenHands-DeepSea\",\n    // Matches the values already set by index.css; included so switching back\n    // from another theme restores the original palette explicitly.\n    scale: {\n      \"--cool-grey-50\": \"#F7F9FC\",\n      \"--cool-grey-100\": \"#EEF2F7\",\n      \"--cool-grey-200\": \"#DCE3EE\",\n      \"--cool-grey-300\": \"#C3CDDC\",\n      \"--cool-grey-400\": \"#A3B0C4\",\n      \"--cool-grey-500\": \"#7E8A9E\",\n      \"--cool-grey-600\": \"#626D82\",\n      \"--cool-grey-700\": \"#4B5468\",\n      \"--cool-grey-800\": \"#383F50\",\n      \"--cool-grey-900\": \"#2C313F\",\n      \"--cool-grey-925\": \"#21252F\",\n      \"--cool-grey-950\": \"#0B0E14\",\n      \"--cool-grey-975\": \"#05070A\",\n    },\n    // Values generated by heroui() from hero.ts — restore them explicitly when\n    // switching back from another theme.\n    heroui: {\n      \"--heroui-background\": \"220 29.03% 6.08%\",\n      \"--heroui-background-foreground\": \"216 45.45% 97.84%\",\n      \"--heroui-foreground-50\": \"216 33.33% 2.94%\",\n      \"--heroui-foreground-100\": \"220 29.03% 6.08%\",\n      \"--heroui-foreground-200\": \"222.86 17.5% 15.69%\",\n      \"--heroui-foreground-300\": \"224.21 17.76% 20.98%\",\n      \"--heroui-foreground-400\": \"222.5 17.65% 26.67%\",\n      \"--heroui-foreground-500\": \"221.38 16.2% 35.1%\",\n      \"--heroui-foreground-600\": \"219.38 14.04% 44.71%\",\n      \"--heroui-foreground-700\": \"217.5 14.16% 55.69%\",\n      \"--heroui-foreground-800\": \"216.36 21.85% 70.39%\",\n      \"--heroui-foreground-900\": \"216 26.32% 81.37%\",\n      \"--heroui-foreground\": \"216 26.32% 81.37%\",\n      \"--heroui-content1\": \"222.86 17.5% 15.69%\",\n      \"--heroui-content1-foreground\": \"213.33 36% 95.1%\",\n      \"--heroui-content2\": \"224.21 17.76% 20.98%\",\n      \"--heroui-content2-foreground\": \"216.67 34.62% 89.8%\",\n      \"--heroui-content3\": \"222.5 17.65% 26.67%\",\n      \"--heroui-content3-foreground\": \"216 26.32% 81.37%\",\n      \"--heroui-content4\": \"221.38 16.2% 35.1%\",\n      \"--heroui-content4-foreground\": \"216.36 21.85% 70.39%\",\n      \"--heroui-default-50\": \"216 33.33% 2.94%\",\n      \"--heroui-default-100\": \"220 29.03% 6.08%\",\n      \"--heroui-default-200\": \"222.86 17.5% 15.69%\",\n      \"--heroui-default-300\": \"224.21 17.76% 20.98%\",\n      \"--heroui-default-400\": \"222.5 17.65% 26.67%\",\n      \"--heroui-default-500\": \"221.38 16.2% 35.1%\",\n      \"--heroui-default-600\": \"219.38 14.04% 44.71%\",\n      \"--heroui-default-700\": \"217.5 14.16% 55.69%\",\n      \"--heroui-default-800\": \"216.36 21.85% 70.39%\",\n      \"--heroui-default-900\": \"216 26.32% 81.37%\",\n      \"--heroui-default-foreground\": \"216 45.45% 97.84%\",\n      \"--heroui-default\": \"222.5 17.65% 26.67%\",\n    },\n  },\n\n  \"openhands-neutral\": {\n    label: \"OpenHands-Neutral\",\n    scale: NEUTRAL_SCALE,\n    // Each stop follows the same positional mapping as hero.ts:\n    //   heroui-default-100 ← cool-grey-950 position ← neutral-950 (#181818)\n    //   heroui-default-200 ← cool-grey-925 position ← neutral-900 (#202020)\n    //   ...etc.\n    heroui: NEUTRAL_HEROUI,\n  },\n\n  \"openhands-neo\": {\n    label: \"OpenHands-Neo\",\n    scale: NEUTRAL_SCALE,\n    heroui: NEUTRAL_HEROUI,\n    tokens: NEO_WHITE_BUTTON_TOKENS,\n  },\n};\n\nexport const DEFAULT_COLOR_THEME: ColorThemeKey = \"openhands-neutral\";\n\nexport const AVAILABLE_COLOR_THEMES = Object.entries(COLOR_THEMES).map(\n  ([key, def]) => ({ key: key as ColorThemeKey, label: def.label }),\n);\n\nconst STORAGE_KEY = \"openhands-color-theme\";\n\n/** Read the persisted theme key from localStorage, falling back to the default. */\nexport function readPersistedColorTheme(): ColorThemeKey {\n  if (typeof window === \"undefined\") return DEFAULT_COLOR_THEME;\n  try {\n    const stored = window.localStorage.getItem(STORAGE_KEY);\n    if (stored && stored in COLOR_THEMES) return stored as ColorThemeKey;\n  } catch {\n    // ignore quota / privacy-mode failures\n  }\n  return DEFAULT_COLOR_THEME;\n}\n\n/** Persist the theme key to localStorage. */\nexport function persistColorTheme(key: ColorThemeKey): void {\n  try {\n    window.localStorage.setItem(STORAGE_KEY, key);\n  } catch {\n    // ignore\n  }\n}\n\nconst THEME_STYLE_TAG_ID = \"oh-color-theme-override\";\n\n/**\n * Apply a theme by injecting (or replacing) a <style> tag that overrides\n * both our custom --cool-grey-* primitives and HeroUI's --heroui-* tokens.\n *\n * Why a <style> tag:\n *   PostCSS transforms :root / body to [data-agent-server-ui], so --cool-grey-*\n *   is set on EVERY element carrying that attribute. A body inline-style only\n *   overrides body itself — inner matching elements keep the stylesheet value.\n *\n * Why heroui variables:\n *   HeroUI stores colors as HSL channels in --heroui-* vars on [data-theme=dark].\n *   They reference their own token system and are unaffected by --cool-grey-*\n *   changes, so we override them from the same injected sheet.\n *\n * Why doubled selectors + re-append on every call:\n *   \"Later sheet wins the tie\" cannot be relied on: in the built SPA\n *   (ssr:false, prerendered shell) React 19 re-creates the <head> elements it\n *   manages (<Meta/>/<Links/>) whenever the tree above the router remounts.\n *   That can re-insert the base stylesheet <link> AFTER this tag, allowing its\n *   unlayered [data-agent-server-ui] variable rules (0,1,0) to win every tie.\n *   Doubling the attribute selectors ([x][x], 0,2,0) beats them from any\n *   position in <head>; re-appending on each apply keeps document order\n *   favorable as well.\n */\nexport function applyColorTheme(key: ColorThemeKey): void {\n  if (typeof document === \"undefined\") return;\n  const { scale, heroui, tokens = {} } = COLOR_THEMES[key];\n\n  const scaleDecls = Object.entries(scale)\n    .map(([p, v]) => `  ${p}: ${v};`)\n    .join(\"\\n\");\n\n  const herouiDecls = Object.entries(heroui)\n    .map(([p, v]) => `  ${p}: ${v};`)\n    .join(\"\\n\");\n\n  const tokenDecls = Object.entries(tokens)\n    .map(([p, v]) => `  ${p}: ${v};`)\n    .join(\"\\n\");\n\n  // Target both selectors for heroui vars:\n  //   [data-agent-server-ui] — covers document.body (portal destination) so\n  //     portalled popover/listbox content inherits the overridden values.\n  //   [data-theme=dark]      — covers the inner AgentServerUIRoot wrapper so\n  //     components scoped inside the dark theme wrapper also pick them up.\n  // Both are doubled to out-specify the base sheet regardless of stylesheet\n  // order (see the doc comment above).\n  const css = [\n    `[data-agent-server-ui][data-agent-server-ui] {\\n${scaleDecls}\\n${herouiDecls}\\n${tokenDecls}\\n}`,\n    `[data-theme=dark][data-theme=dark] {\\n${herouiDecls}\\n}`,\n  ].join(\"\\n\");\n\n  let styleEl = document.getElementById(\n    THEME_STYLE_TAG_ID,\n  ) as HTMLStyleElement | null;\n  if (!styleEl) {\n    styleEl = document.createElement(\"style\");\n    styleEl.id = THEME_STYLE_TAG_ID;\n  }\n  styleEl.textContent = css;\n  // Re-append even when the tag already exists (appendChild relocates a\n  // connected node) so the override also stays after any re-inserted <link>.\n  document.head.appendChild(styleEl);\n\n  syncColorThemeTokensOnScopeRoots(tokens);\n}\n\nfunction syncColorThemeTokensOnScopeRoots(\n  tokens: Record<string, string>,\n): void {\n  const roots = document.querySelectorAll(\"[data-agent-server-ui]\");\n  for (const root of roots) {\n    if (!(root instanceof HTMLElement)) continue;\n\n    for (const key of COLOR_THEME_TOKEN_KEYS) {\n      const value = tokens[key];\n      if (value) {\n        root.style.setProperty(key, value);\n      } else {\n        root.style.removeProperty(key);\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/types/agent-server/core/base/action.d.ts

@@ -1,3 +1,4 @@
+import { CANVAS_UI_CLIENT_ACTION_KIND } from "#/constants/canvas-ui";
 import { ActionBase } from "./base";
 import { TaskItem } from "./common";
 export interface MCPToolAction extends ActionBase<"MCPToolAction"> {
@@ -281,11 +282,11 @@ export interface SwitchLLMAction extends ActionBase<"SwitchLLMAction"> {
     reason: string;
 }
 /**
- * Frontend-injected custom tool. Emitted over the existing WebSocket as a
- * regular ActionEvent; intercepted client-side by handleCanvasUIAction.
- * The Python definition lives in tools/canvas_ui_tool.py.
+ * Canvas UI action emitted over the existing WebSocket and intercepted by
+ * handleCanvasUIAction. Legacy conversations use CanvasUIAction; new
+ * conversations use the SDK-generated client action kind.
  */
-export interface CanvasUIAction extends ActionBase<"CanvasUIAction"> {
+export interface CanvasUIAction extends ActionBase<"CanvasUIAction" | typeof CANVAS_UI_CLIENT_ACTION_KIND> {
     command: "navigate_to_file" | "open_tab" | "show_preview";
     path?: string | null;
     tab?: string | null;