@openhands/agent-canvas 1.4.0 → 1.5.0

package/dist/services/telemetry.js

@@ -1,32 +1,34 @@
 import e from "../package.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 t = "openhands-telemetry-consent", n = "openhands-telemetry-first-use", r = "openhands-telemetry-session", i = "agent-canvas", a = "phc_BgzfxKdgsYMLFTmJqt424ZoyVHvKFfrwttLimzdYTKFK", o = "https://z.openhands.dev", s = "https://us.posthog.com", c = !1, l = null;
+function u() {
 	return typeof window < "u" && typeof localStorage < "u";
 }
-async function u() {
-	if (!l()) return null;
-	if (c) return c;
+async function d() {
+	if (!u()) return null;
+	if (l) return l;
 	try {
 		let { default: e } = await import("../node_modules/posthog-js/dist/module.js");
-		return c = e, e;
+		return e;
 	} catch {
 		return null;
 	}
 }
-function d() {
+function f() {
 	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,
+async function p(t = !1) {
+	if (c) return l;
+	let n = await d();
+	return n ? (l = n.init(a, {
+		api_host: o,
+		ui_host: s,
 		opt_out_capturing_by_default: !t,
 		capture_pageview: !1,
 		autocapture: !1,
 		persistence: "localStorage",
+		persistence_name: i,
+		consent_persistence_name: `${i}-consent`,
 		disable_session_recording: !0,
 		loaded: (t) => {
 			t.register({
@@ -34,84 +36,84 @@ async function f(t = !1) {
 				package_version: e.version
 			});
 		}
-	}), s = !0, n) : null;
+	}, i), c = !0, l) : null;
 }
-function p() {
-	if (!l()) return "pending";
-	if (d()) return "denied";
+function m() {
+	if (!u()) return "pending";
+	if (f()) return "denied";
 	try {
 		let e = localStorage.getItem(t);
 		if (e === "granted" || e === "denied") return e;
 	} catch {}
 	return "pending";
 }
-async function m(e) {
-	if (l()) try {
+async function h(e) {
+	if (u()) try {
 		localStorage.setItem(t, e);
-		let n = await f();
+		let n = await p();
 		if (!n) return;
 		e === "granted" ? n.opt_in_capturing() : n.opt_out_capturing();
 	} catch {}
 }
-function h() {
-	return p() === "granted";
-}
 function g() {
-	if (!l()) return !1;
+	return m() === "granted";
+}
+function _() {
+	if (!u()) return !1;
 	try {
 		return localStorage.getItem(n) === "true";
 	} catch {
 		return !1;
 	}
 }
-function _() {
-	if (l()) try {
+function v() {
+	if (u()) try {
 		localStorage.setItem(n, "true");
 	} catch {}
 }
-async function v() {
-	if (d() || g()) return;
-	let e = await f(!0);
+async function y() {
+	if (f() || _()) return;
+	let e = await p(!0);
 	e && ((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());
+	}), v(), m() !== "granted" && e.opt_out_capturing());
 }
-function y() {
-	if (!l()) return !1;
+function b() {
+	if (!u()) return !1;
 	try {
 		return sessionStorage.getItem(r) === "true";
 	} catch {
 		return !1;
 	}
 }
-function b() {
-	if (l()) try {
+function x() {
+	if (u()) try {
 		sessionStorage.setItem(r, "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 S() {
+	if (!g() || b()) return;
+	let e = await p();
+	e && (e.capture("canvas_new_session", { is_first_use: !_() }), x());
 }
-async function S(e, t = {}) {
-	if (!h()) return;
-	let n = await f();
+async function C(e, t = {}) {
+	if (!g()) return;
+	let n = await p();
 	n && n.capture(e, t);
 }
-async function C() {
-	if (l()) try {
-		localStorage.removeItem(t), localStorage.removeItem(n), sessionStorage.removeItem(r), s && c && c.reset();
+async function w() {
+	if (u()) try {
+		localStorage.removeItem(t), localStorage.removeItem(n), sessionStorage.removeItem(r), c && l && l.reset();
 	} catch {}
 }
-async function w() {
-	return s ? c : null;
+async function T() {
+	return c ? l : null;
 }
 //#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 { w as clearTelemetryData, T as getPostHogInstance, m as getTelemetryConsent, g as isTelemetryEnabled, h as setTelemetryConsent, C as trackEvent, y as trackInstall, S 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 * 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\";\nconst POSTHOG_INSTANCE_NAME = \"agent-canvas\";\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    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  // Canvas telemetry must not share PostHog's default singleton with host-app\n  // analytics. A named instance gives it independent configuration, consent,\n  // persistence, and delivery state.\n  posthogInstance = posthog.init(\n    POSTHOG_API_KEY,\n    {\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      persistence_name: POSTHOG_INSTANCE_NAME,\n      consent_persistence_name: `${POSTHOG_INSTANCE_NAME}-consent`,\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    POSTHOG_INSTANCE_NAME,\n  );\n\n  isInitialized = true;\n  return posthogInstance;\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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"}

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;

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

@@ -1,8 +1,9 @@
+import { CANVAS_UI_CLIENT_ACTION_KIND } from "#/constants/canvas-ui";
 type EventType = "MCPTool" | "Finish" | "Think" | "ExecuteBash" | "Terminal" | "FileEditor" | "StrReplaceEditor" | "TaskTracker" | "PlanningFileEditor" | "InvokeSkill" | "SwitchLLM";
 type ActionOnlyType = "BrowserNavigate" | "BrowserClick" | "BrowserType" | "BrowserGetState" | "BrowserGetContent" | "BrowserScroll" | "BrowserGoBack" | "BrowserListTabs" | "BrowserSwitchTab" | "BrowserCloseTab" | "CanvasUI";
 type ObservationOnlyType = "Browser";
-type ActionEventType = `${ActionOnlyType}Action` | `${EventType}Action` | "GlobAction" | "GrepAction" | "TaskAction";
-type ObservationEventType = `${ObservationOnlyType}Observation` | `${EventType}Observation` | "TerminalObservation" | "GlobObservation" | "GrepObservation" | "TaskObservation" | "CanvasUIObservation";
+type ActionEventType = `${ActionOnlyType}Action` | `${EventType}Action` | "GlobAction" | "GrepAction" | "TaskAction" | typeof CANVAS_UI_CLIENT_ACTION_KIND;
+type ObservationEventType = `${ObservationOnlyType}Observation` | `${EventType}Observation` | "TerminalObservation" | "GlobObservation" | "GrepObservation" | "TaskObservation" | "CanvasUIObservation" | "ClientToolObservation";
 export interface ActionBase<T extends ActionEventType = ActionEventType> {
     kind: T;
 }

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

@@ -304,7 +304,7 @@ export interface TaskObservation extends ObservationBase<"TaskObservation"> {
      */
     status: string;
 }
-export interface CanvasUIObservation extends ObservationBase<"CanvasUIObservation"> {
+export interface CanvasUIObservation extends ObservationBase<"CanvasUIObservation" | "ClientToolObservation"> {
     /**
      * Acknowledgement text returned after the canvas UI command is dispatched.
      */

package/dist/types/agent-server/type-guards.cjs

@@ -1,2 +1,2 @@
-require(`../../_virtual/_rolldown/runtime.cjs`);function e(e){return typeof e==`object`&&!!e&&`id`in e&&`timestamp`in e&&`source`in e&&typeof e.id==`string`&&e.id.length>0&&typeof e.timestamp==`string`&&e.timestamp.length>0&&typeof e.source==`string`&&(e.source===`agent`||e.source===`user`||e.source===`environment`||e.source===`hook`)}var t=e=>e.source===`environment`&&`action_id`in e&&`observation`in e&&e.observation!==null&&typeof e.observation==`object`&&`kind`in e.observation,n=e=>e.source===`agent`&&`tool_name`in e&&`tool_call_id`in e&&`error`in e&&typeof e.tool_name==`string`&&typeof e.tool_call_id==`string`&&typeof e.error==`string`,r=e=>`llm_message`in e&&typeof e.llm_message==`object`&&e.llm_message!==null&&`role`in e.llm_message&&`content`in e.llm_message,i=e=>r(e)&&e.llm_message.role===`user`,a=e=>e.source===`agent`&&`action`in e&&e.action!==null&&typeof e.action==`object`&&`kind`in e.action&&`tool_name`in e&&`tool_call_id`in e&&typeof e.tool_name==`string`&&typeof e.tool_call_id==`string`,o=e=>a(e)&&(e.action.kind===`ExecuteBashAction`||e.action.kind===`TerminalAction`),s=e=>t(e)&&(e.observation.kind===`ExecuteBashObservation`||e.observation.kind===`TerminalObservation`),c=e=>t(e)&&e.observation.kind===`PlanningFileEditorObservation`,l=e=>t(e)&&e.observation.kind===`BrowserObservation`,u=e=>t(e)&&e.observation.kind===`SwitchLLMObservation`,d=e=>a(e)&&e.action.kind===`BrowserNavigateAction`,f=e=>a(e)&&e.tool_name===`canvas_ui`,p=e=>e.source===`agent`&&`system_prompt`in e&&`tools`in e&&typeof e.system_prompt==`object`&&Array.isArray(e.tools),m=e=>`kind`in e&&e.kind===`ConversationStateUpdateEvent`,h=e=>e.key===`full_state`,g=e=>e.key===`execution_status`,_=e=>e.key===`stats`,v=e=>e.key===`goal`,y=e=>`kind`in e&&e.kind===`ConversationErrorEvent`,b=e=>`kind`in e&&e.kind===`ServerErrorEvent`,x=e=>y(e)||b(e),S=e=>`kind`in e&&e.kind===`HookExecutionEvent`,C=e=>`kind`in e&&e.kind===`ACPToolCallEvent`,w=e=>`kind`in e&&e.kind===`StreamingDeltaEvent`;function T(t){return e(t)}exports.isACPToolCallEvent=C,exports.isActionEvent=a,exports.isAgentErrorEvent=n,exports.isAgentServerEvent=T,exports.isAgentStatusConversationStateUpdateEvent=g,exports.isBrowserNavigateActionEvent=d,exports.isBrowserObservationEvent=l,exports.isCanvasUIActionEvent=f,exports.isConversationStateUpdateEvent=m,exports.isDisplayableErrorEvent=x,exports.isExecuteBashActionEvent=o,exports.isExecuteBashObservationEvent=s,exports.isFullStateConversationStateUpdateEvent=h,exports.isGoalConversationStateUpdateEvent=v,exports.isHookExecutionEvent=S,exports.isMessageEvent=r,exports.isObservationEvent=t,exports.isPlanningFileEditorObservationEvent=c,exports.isStatsConversationStateUpdateEvent=_,exports.isStreamingDeltaEvent=w,exports.isSwitchLLMObservationEvent=u,exports.isSystemPromptEvent=p,exports.isUserMessageEvent=i;
+require(`../../_virtual/_rolldown/runtime.cjs`),require(`../../constants/canvas-ui.cjs`);function e(e){return typeof e==`object`&&!!e&&`id`in e&&`timestamp`in e&&`source`in e&&typeof e.id==`string`&&e.id.length>0&&typeof e.timestamp==`string`&&e.timestamp.length>0&&typeof e.source==`string`&&(e.source===`agent`||e.source===`user`||e.source===`environment`||e.source===`hook`)}var t=e=>e.source===`environment`&&`action_id`in e&&`observation`in e&&e.observation!==null&&typeof e.observation==`object`&&`kind`in e.observation,n=e=>e.source===`agent`&&`tool_name`in e&&`tool_call_id`in e&&`error`in e&&typeof e.tool_name==`string`&&typeof e.tool_call_id==`string`&&typeof e.error==`string`,r=e=>`llm_message`in e&&typeof e.llm_message==`object`&&e.llm_message!==null&&`role`in e.llm_message&&`content`in e.llm_message,i=e=>r(e)&&e.llm_message.role===`user`,a=e=>e.source===`agent`&&`action`in e&&e.action!==null&&typeof e.action==`object`&&`kind`in e.action&&`tool_name`in e&&`tool_call_id`in e&&typeof e.tool_name==`string`&&typeof e.tool_call_id==`string`,o=e=>a(e)&&(e.action.kind===`ExecuteBashAction`||e.action.kind===`TerminalAction`),s=e=>t(e)&&(e.observation.kind===`ExecuteBashObservation`||e.observation.kind===`TerminalObservation`),c=e=>t(e)&&e.observation.kind===`PlanningFileEditorObservation`,l=e=>t(e)&&e.observation.kind===`BrowserObservation`,u=e=>t(e)&&e.observation.kind===`SwitchLLMObservation`,d=e=>a(e)&&e.action.kind===`BrowserNavigateAction`,f=e=>a(e)&&(e.tool_name===`canvas_ui`||e.tool_name===`canvas_ui_control`),p=e=>e.source===`agent`&&`system_prompt`in e&&`tools`in e&&typeof e.system_prompt==`object`&&Array.isArray(e.tools),m=e=>`kind`in e&&e.kind===`ConversationStateUpdateEvent`,h=e=>e.key===`full_state`,g=e=>e.key===`execution_status`,_=e=>e.key===`stats`,v=e=>e.key===`goal`,y=e=>`kind`in e&&e.kind===`ConversationErrorEvent`,b=e=>`kind`in e&&e.kind===`ServerErrorEvent`,x=e=>y(e)||b(e),S=e=>`kind`in e&&e.kind===`HookExecutionEvent`,C=e=>`kind`in e&&e.kind===`ACPToolCallEvent`,w=e=>`kind`in e&&e.kind===`StreamingDeltaEvent`;function T(t){return e(t)}exports.isACPToolCallEvent=C,exports.isActionEvent=a,exports.isAgentErrorEvent=n,exports.isAgentServerEvent=T,exports.isAgentStatusConversationStateUpdateEvent=g,exports.isBrowserNavigateActionEvent=d,exports.isBrowserObservationEvent=l,exports.isCanvasUIActionEvent=f,exports.isConversationStateUpdateEvent=m,exports.isDisplayableErrorEvent=x,exports.isExecuteBashActionEvent=o,exports.isExecuteBashObservationEvent=s,exports.isFullStateConversationStateUpdateEvent=h,exports.isGoalConversationStateUpdateEvent=v,exports.isHookExecutionEvent=S,exports.isMessageEvent=r,exports.isObservationEvent=t,exports.isPlanningFileEditorObservationEvent=c,exports.isStatsConversationStateUpdateEvent=_,exports.isStreamingDeltaEvent=w,exports.isSwitchLLMObservationEvent=u,exports.isSystemPromptEvent=p,exports.isUserMessageEvent=i;
 //# sourceMappingURL=type-guards.cjs.map

package/dist/types/agent-server/type-guards.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"type-guards.cjs","names":[],"sources":["../../../src/types/agent-server/type-guards.ts"],"sourcesContent":["import {\n  OpenHandsEvent,\n  ObservationEvent,\n  BaseEvent,\n  ExecuteBashAction,\n  TerminalAction,\n  ExecuteBashObservation,\n  PlanningFileEditorObservation,\n  TerminalObservation,\n  BrowserObservation,\n  BrowserNavigateAction,\n  SwitchLLMObservation,\n  CanvasUIAction,\n} from \"./core\";\nimport { AgentErrorEvent } from \"./core/events/observation-event\";\nimport { MessageEvent } from \"./core/events/message-event\";\nimport { ActionEvent } from \"./core/events/action-event\";\nimport {\n  ConversationStateUpdateEvent,\n  ConversationStateUpdateEventAgentStatus,\n  ConversationStateUpdateEventFullState,\n  ConversationStateUpdateEventStats,\n  ConversationStateUpdateEventGoal,\n  ConversationErrorEvent,\n  ServerErrorEvent,\n} from \"./core/events/conversation-state-event\";\nimport { HookExecutionEvent } from \"./core/events/hook-execution-event\";\nimport { ACPToolCallEvent } from \"./core/events/acp-tool-call-event\";\nimport { StreamingDeltaEvent } from \"./core/events/streaming-delta-event\";\nimport { SystemPromptEvent } from \"./core/events/system-event\";\n\n/**\n * Type guard to check if an unknown value is a valid BaseEvent\n * @param value - The value to check\n * @returns true if the value is a valid BaseEvent\n */\nexport function isBaseEvent(value: unknown): value is BaseEvent {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    \"id\" in value &&\n    \"timestamp\" in value &&\n    \"source\" in value &&\n    typeof value.id === \"string\" &&\n    value.id.length > 0 &&\n    typeof value.timestamp === \"string\" &&\n    value.timestamp.length > 0 &&\n    typeof value.source === \"string\" &&\n    (value.source === \"agent\" ||\n      value.source === \"user\" ||\n      value.source === \"environment\" ||\n      value.source === \"hook\")\n  );\n}\n\n/**\n * Type guard function to check if an event is an observation event\n */\nexport const isObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent =>\n  event.source === \"environment\" &&\n  \"action_id\" in event &&\n  \"observation\" in event &&\n  event.observation !== null &&\n  typeof event.observation === \"object\" &&\n  \"kind\" in event.observation;\n\n/**\n * Type guard function to check if an event is an agent error event\n */\nexport const isAgentErrorEvent = (\n  event: OpenHandsEvent,\n): event is AgentErrorEvent =>\n  event.source === \"agent\" &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  \"error\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\" &&\n  typeof event.error === \"string\";\n\n/**\n * Type guard function to check if an event is a message event (user or assistant)\n */\nexport const isMessageEvent = (event: OpenHandsEvent): event is MessageEvent =>\n  \"llm_message\" in event &&\n  typeof event.llm_message === \"object\" &&\n  event.llm_message !== null &&\n  \"role\" in event.llm_message &&\n  \"content\" in event.llm_message;\n\n/**\n * Type guard function to check if an event is a user message event\n */\nexport const isUserMessageEvent = (\n  event: OpenHandsEvent,\n): event is MessageEvent =>\n  isMessageEvent(event) && event.llm_message.role === \"user\";\n\n/**\n * Type guard function to check if an event is an action event\n */\nexport const isActionEvent = (event: OpenHandsEvent): event is ActionEvent =>\n  event.source === \"agent\" &&\n  \"action\" in event &&\n  event.action !== null &&\n  typeof event.action === \"object\" &&\n  \"kind\" in event.action &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\";\n\n/**\n * Type guard function to check if an action event is an ExecuteBashAction\n */\nexport const isExecuteBashActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<ExecuteBashAction | TerminalAction> =>\n  isActionEvent(event) &&\n  (event.action.kind === \"ExecuteBashAction\" ||\n    event.action.kind === \"TerminalAction\");\n\n/**\n * Type guard function to check if an observation event contains terminal output\n */\nexport const isExecuteBashObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<ExecuteBashObservation | TerminalObservation> =>\n  isObservationEvent(event) &&\n  (event.observation.kind === \"ExecuteBashObservation\" ||\n    event.observation.kind === \"TerminalObservation\");\n\n/**\n * Type guard function to check if an observation event is a PlanningFileEditorObservation\n */\nexport const isPlanningFileEditorObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<PlanningFileEditorObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"PlanningFileEditorObservation\";\n\n/**\n * Type guard function to check if an observation event is a BrowserObservation\n */\nexport const isBrowserObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<BrowserObservation> =>\n  isObservationEvent(event) && event.observation.kind === \"BrowserObservation\";\n\n/**\n * Type guard function to check if an observation event is a SwitchLLMObservation\n */\nexport const isSwitchLLMObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<SwitchLLMObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"SwitchLLMObservation\";\n\n/**\n * Type guard function to check if an action event is a BrowserNavigateAction\n */\nexport const isBrowserNavigateActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<BrowserNavigateAction> =>\n  isActionEvent(event) && event.action.kind === \"BrowserNavigateAction\";\n\n/**\n * Type guard for the canvas_ui custom tool's ActionEvent.\n *\n * The tool is injected via tool_module_qualnames (see canvas_ui_tool.py and\n * agent-server-adapter.ts). We discriminate on tool_name (which we control\n * via register_tool(\"canvas_ui\", ...)). The predicate narrows the event so\n * the call site can read `event.action.command` etc. without further casts.\n */\nexport const isCanvasUIActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<CanvasUIAction> =>\n  isActionEvent(event) && event.tool_name === \"canvas_ui\";\n\n/**\n * Type guard function to check if an event is a system prompt event\n */\nexport const isSystemPromptEvent = (\n  event: OpenHandsEvent,\n): event is SystemPromptEvent =>\n  event.source === \"agent\" &&\n  \"system_prompt\" in event &&\n  \"tools\" in event &&\n  typeof event.system_prompt === \"object\" &&\n  Array.isArray(event.tools);\n\n/**\n * Type guard function to check if an event is a conversation state update event\n */\nexport const isConversationStateUpdateEvent = (\n  event: OpenHandsEvent,\n): event is ConversationStateUpdateEvent =>\n  \"kind\" in event && event.kind === \"ConversationStateUpdateEvent\";\n\nexport const isFullStateConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventFullState => event.key === \"full_state\";\n\nexport const isAgentStatusConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventAgentStatus =>\n  event.key === \"execution_status\";\n\nexport const isStatsConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventStats => event.key === \"stats\";\n\nexport const isGoalConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventGoal => event.key === \"goal\";\n\n/**\n * Type guard function to check if an event is a conversation error event\n */\nexport const isConversationErrorEvent = (\n  event: OpenHandsEvent,\n): event is ConversationErrorEvent =>\n  \"kind\" in event && event.kind === \"ConversationErrorEvent\";\n\n/**\n * Type guard function to check if an event is a server error event\n */\nexport const isServerErrorEvent = (\n  event: OpenHandsEvent,\n): event is ServerErrorEvent =>\n  \"kind\" in event && event.kind === \"ServerErrorEvent\";\n\n/**\n * Type guard function to check if an event is a displayable error event\n * (ConversationErrorEvent or ServerErrorEvent) - both should show as error banners\n */\nexport const isDisplayableErrorEvent = (event: OpenHandsEvent): boolean =>\n  isConversationErrorEvent(event) || isServerErrorEvent(event);\n\n/**\n * Type guard function to check if an event is a hook execution event\n */\nexport const isHookExecutionEvent = (\n  event: OpenHandsEvent,\n): event is HookExecutionEvent =>\n  \"kind\" in event && event.kind === \"HookExecutionEvent\";\n\n/**\n * Type guard function to check if an event is an ACP tool call event\n */\nexport const isACPToolCallEvent = (\n  event: OpenHandsEvent,\n): event is ACPToolCallEvent =>\n  \"kind\" in event && event.kind === \"ACPToolCallEvent\";\n\nexport const isStreamingDeltaEvent = (\n  event: OpenHandsEvent,\n): event is StreamingDeltaEvent =>\n  \"kind\" in event && event.kind === \"StreamingDeltaEvent\";\n\n// =============================================================================\n// COMPATIBILITY TYPE GUARDS\n// =============================================================================\n\n/**\n * Type guard to check if an event is an agent-server OpenHandsEvent.\n * Uses isBaseEvent to validate the complete event structure.\n */\nexport function isAgentServerEvent(event: unknown): event is OpenHandsEvent {\n  return isBaseEvent(event);\n}\n"],"mappings":"gDAoCA,SAAgB,EAAY,EAAoC,CAC9D,OAEE,OAAO,GAAU,YADjB,GAEA,OAAQ,GACR,cAAe,GACf,WAAY,GACZ,OAAO,EAAM,IAAO,UACpB,EAAM,GAAG,OAAS,GAClB,OAAO,EAAM,WAAc,UAC3B,EAAM,UAAU,OAAS,GACzB,OAAO,EAAM,QAAW,WACvB,EAAM,SAAW,SAChB,EAAM,SAAW,QACjB,EAAM,SAAW,eACjB,EAAM,SAAW,QAOvB,IAAa,EACX,GAEA,EAAM,SAAW,eACjB,cAAe,GACf,gBAAiB,GACjB,EAAM,cAAgB,MACtB,OAAO,EAAM,aAAgB,UAC7B,SAAU,EAAM,YAKL,EACX,GAEA,EAAM,SAAW,SACjB,cAAe,GACf,iBAAkB,GAClB,UAAW,GACX,OAAO,EAAM,WAAc,UAC3B,OAAO,EAAM,cAAiB,UAC9B,OAAO,EAAM,OAAU,SAKZ,EAAkB,GAC7B,gBAAiB,GACjB,OAAO,EAAM,aAAgB,UAC7B,EAAM,cAAgB,MACtB,SAAU,EAAM,aAChB,YAAa,EAAM,YAKR,EACX,GAEA,EAAe,EAAM,EAAI,EAAM,YAAY,OAAS,OAKzC,EAAiB,GAC5B,EAAM,SAAW,SACjB,WAAY,GACZ,EAAM,SAAW,MACjB,OAAO,EAAM,QAAW,UACxB,SAAU,EAAM,QAChB,cAAe,GACf,iBAAkB,GAClB,OAAO,EAAM,WAAc,UAC3B,OAAO,EAAM,cAAiB,SAKnB,EACX,GAEA,EAAc,EAAM,GACnB,EAAM,OAAO,OAAS,qBACrB,EAAM,OAAO,OAAS,kBAKb,EACX,GAEA,EAAmB,EAAM,GACxB,EAAM,YAAY,OAAS,0BAC1B,EAAM,YAAY,OAAS,uBAKlB,EACX,GAEA,EAAmB,EAAM,EACzB,EAAM,YAAY,OAAS,gCAKhB,EACX,GAEA,EAAmB,EAAM,EAAI,EAAM,YAAY,OAAS,qBAK7C,EACX,GAEA,EAAmB,EAAM,EACzB,EAAM,YAAY,OAAS,uBAKhB,EACX,GAEA,EAAc,EAAM,EAAI,EAAM,OAAO,OAAS,wBAUnC,EACX,GAEA,EAAc,EAAM,EAAI,EAAM,YAAc,YAKjC,EACX,GAEA,EAAM,SAAW,SACjB,kBAAmB,GACnB,UAAW,GACX,OAAO,EAAM,eAAkB,UAC/B,MAAM,QAAQ,EAAM,MAAM,CAKf,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,+BAEvB,EACX,GACmD,EAAM,MAAQ,aAEtD,EACX,GAEA,EAAM,MAAQ,mBAEH,EACX,GAC+C,EAAM,MAAQ,QAElD,EACX,GAC8C,EAAM,MAAQ,OAKjD,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,yBAKvB,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,mBAMvB,EAA2B,GACtC,EAAyB,EAAM,EAAI,EAAmB,EAAM,CAKjD,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,qBAKvB,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,mBAEvB,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,sBAUpC,SAAgB,EAAmB,EAAyC,CAC1E,OAAO,EAAY,EAAM"}
+{"version":3,"file":"type-guards.cjs","names":[],"sources":["../../../src/types/agent-server/type-guards.ts"],"sourcesContent":["import {\n  CANVAS_UI_CLIENT_TOOL_NAME,\n  LEGACY_CANVAS_UI_TOOL_NAME,\n} from \"#/constants/canvas-ui\";\n\nimport {\n  OpenHandsEvent,\n  ObservationEvent,\n  BaseEvent,\n  ExecuteBashAction,\n  TerminalAction,\n  ExecuteBashObservation,\n  PlanningFileEditorObservation,\n  TerminalObservation,\n  BrowserObservation,\n  BrowserNavigateAction,\n  SwitchLLMObservation,\n  CanvasUIAction,\n} from \"./core\";\nimport { AgentErrorEvent } from \"./core/events/observation-event\";\nimport { MessageEvent } from \"./core/events/message-event\";\nimport { ActionEvent } from \"./core/events/action-event\";\nimport {\n  ConversationStateUpdateEvent,\n  ConversationStateUpdateEventAgentStatus,\n  ConversationStateUpdateEventFullState,\n  ConversationStateUpdateEventStats,\n  ConversationStateUpdateEventGoal,\n  ConversationErrorEvent,\n  ServerErrorEvent,\n} from \"./core/events/conversation-state-event\";\nimport { HookExecutionEvent } from \"./core/events/hook-execution-event\";\nimport { ACPToolCallEvent } from \"./core/events/acp-tool-call-event\";\nimport { StreamingDeltaEvent } from \"./core/events/streaming-delta-event\";\nimport { SystemPromptEvent } from \"./core/events/system-event\";\n\n/**\n * Type guard to check if an unknown value is a valid BaseEvent\n * @param value - The value to check\n * @returns true if the value is a valid BaseEvent\n */\nexport function isBaseEvent(value: unknown): value is BaseEvent {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    \"id\" in value &&\n    \"timestamp\" in value &&\n    \"source\" in value &&\n    typeof value.id === \"string\" &&\n    value.id.length > 0 &&\n    typeof value.timestamp === \"string\" &&\n    value.timestamp.length > 0 &&\n    typeof value.source === \"string\" &&\n    (value.source === \"agent\" ||\n      value.source === \"user\" ||\n      value.source === \"environment\" ||\n      value.source === \"hook\")\n  );\n}\n\n/**\n * Type guard function to check if an event is an observation event\n */\nexport const isObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent =>\n  event.source === \"environment\" &&\n  \"action_id\" in event &&\n  \"observation\" in event &&\n  event.observation !== null &&\n  typeof event.observation === \"object\" &&\n  \"kind\" in event.observation;\n\n/**\n * Type guard function to check if an event is an agent error event\n */\nexport const isAgentErrorEvent = (\n  event: OpenHandsEvent,\n): event is AgentErrorEvent =>\n  event.source === \"agent\" &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  \"error\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\" &&\n  typeof event.error === \"string\";\n\n/**\n * Type guard function to check if an event is a message event (user or assistant)\n */\nexport const isMessageEvent = (event: OpenHandsEvent): event is MessageEvent =>\n  \"llm_message\" in event &&\n  typeof event.llm_message === \"object\" &&\n  event.llm_message !== null &&\n  \"role\" in event.llm_message &&\n  \"content\" in event.llm_message;\n\n/**\n * Type guard function to check if an event is a user message event\n */\nexport const isUserMessageEvent = (\n  event: OpenHandsEvent,\n): event is MessageEvent =>\n  isMessageEvent(event) && event.llm_message.role === \"user\";\n\n/**\n * Type guard function to check if an event is an action event\n */\nexport const isActionEvent = (event: OpenHandsEvent): event is ActionEvent =>\n  event.source === \"agent\" &&\n  \"action\" in event &&\n  event.action !== null &&\n  typeof event.action === \"object\" &&\n  \"kind\" in event.action &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\";\n\n/**\n * Type guard function to check if an action event is an ExecuteBashAction\n */\nexport const isExecuteBashActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<ExecuteBashAction | TerminalAction> =>\n  isActionEvent(event) &&\n  (event.action.kind === \"ExecuteBashAction\" ||\n    event.action.kind === \"TerminalAction\");\n\n/**\n * Type guard function to check if an observation event contains terminal output\n */\nexport const isExecuteBashObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<ExecuteBashObservation | TerminalObservation> =>\n  isObservationEvent(event) &&\n  (event.observation.kind === \"ExecuteBashObservation\" ||\n    event.observation.kind === \"TerminalObservation\");\n\n/**\n * Type guard function to check if an observation event is a PlanningFileEditorObservation\n */\nexport const isPlanningFileEditorObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<PlanningFileEditorObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"PlanningFileEditorObservation\";\n\n/**\n * Type guard function to check if an observation event is a BrowserObservation\n */\nexport const isBrowserObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<BrowserObservation> =>\n  isObservationEvent(event) && event.observation.kind === \"BrowserObservation\";\n\n/**\n * Type guard function to check if an observation event is a SwitchLLMObservation\n */\nexport const isSwitchLLMObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<SwitchLLMObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"SwitchLLMObservation\";\n\n/**\n * Type guard function to check if an action event is a BrowserNavigateAction\n */\nexport const isBrowserNavigateActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<BrowserNavigateAction> =>\n  isActionEvent(event) && event.action.kind === \"BrowserNavigateAction\";\n\n/**\n * Type guard for Canvas UI tool ActionEvents.\n *\n * Discriminating on tool_name supports legacy CanvasUIAction events and the\n * SDK-generated action kind without leaking that generated name here.\n */\nexport const isCanvasUIActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<CanvasUIAction> =>\n  isActionEvent(event) &&\n  (event.tool_name === LEGACY_CANVAS_UI_TOOL_NAME ||\n    event.tool_name === CANVAS_UI_CLIENT_TOOL_NAME);\n\n/**\n * Type guard function to check if an event is a system prompt event\n */\nexport const isSystemPromptEvent = (\n  event: OpenHandsEvent,\n): event is SystemPromptEvent =>\n  event.source === \"agent\" &&\n  \"system_prompt\" in event &&\n  \"tools\" in event &&\n  typeof event.system_prompt === \"object\" &&\n  Array.isArray(event.tools);\n\n/**\n * Type guard function to check if an event is a conversation state update event\n */\nexport const isConversationStateUpdateEvent = (\n  event: OpenHandsEvent,\n): event is ConversationStateUpdateEvent =>\n  \"kind\" in event && event.kind === \"ConversationStateUpdateEvent\";\n\nexport const isFullStateConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventFullState => event.key === \"full_state\";\n\nexport const isAgentStatusConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventAgentStatus =>\n  event.key === \"execution_status\";\n\nexport const isStatsConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventStats => event.key === \"stats\";\n\nexport const isGoalConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventGoal => event.key === \"goal\";\n\n/**\n * Type guard function to check if an event is a conversation error event\n */\nexport const isConversationErrorEvent = (\n  event: OpenHandsEvent,\n): event is ConversationErrorEvent =>\n  \"kind\" in event && event.kind === \"ConversationErrorEvent\";\n\n/**\n * Type guard function to check if an event is a server error event\n */\nexport const isServerErrorEvent = (\n  event: OpenHandsEvent,\n): event is ServerErrorEvent =>\n  \"kind\" in event && event.kind === \"ServerErrorEvent\";\n\n/**\n * Type guard function to check if an event is a displayable error event\n * (ConversationErrorEvent or ServerErrorEvent) - both should show as error banners\n */\nexport const isDisplayableErrorEvent = (event: OpenHandsEvent): boolean =>\n  isConversationErrorEvent(event) || isServerErrorEvent(event);\n\n/**\n * Type guard function to check if an event is a hook execution event\n */\nexport const isHookExecutionEvent = (\n  event: OpenHandsEvent,\n): event is HookExecutionEvent =>\n  \"kind\" in event && event.kind === \"HookExecutionEvent\";\n\n/**\n * Type guard function to check if an event is an ACP tool call event\n */\nexport const isACPToolCallEvent = (\n  event: OpenHandsEvent,\n): event is ACPToolCallEvent =>\n  \"kind\" in event && event.kind === \"ACPToolCallEvent\";\n\nexport const isStreamingDeltaEvent = (\n  event: OpenHandsEvent,\n): event is StreamingDeltaEvent =>\n  \"kind\" in event && event.kind === \"StreamingDeltaEvent\";\n\n// =============================================================================\n// COMPATIBILITY TYPE GUARDS\n// =============================================================================\n\n/**\n * Type guard to check if an event is an agent-server OpenHandsEvent.\n * Uses isBaseEvent to validate the complete event structure.\n */\nexport function isAgentServerEvent(event: unknown): event is OpenHandsEvent {\n  return isBaseEvent(event);\n}\n"],"mappings":"yFAyCA,SAAgB,EAAY,EAAoC,CAC9D,OAEE,OAAO,GAAU,YADjB,GAEA,OAAQ,GACR,cAAe,GACf,WAAY,GACZ,OAAO,EAAM,IAAO,UACpB,EAAM,GAAG,OAAS,GAClB,OAAO,EAAM,WAAc,UAC3B,EAAM,UAAU,OAAS,GACzB,OAAO,EAAM,QAAW,WACvB,EAAM,SAAW,SAChB,EAAM,SAAW,QACjB,EAAM,SAAW,eACjB,EAAM,SAAW,QAOvB,IAAa,EACX,GAEA,EAAM,SAAW,eACjB,cAAe,GACf,gBAAiB,GACjB,EAAM,cAAgB,MACtB,OAAO,EAAM,aAAgB,UAC7B,SAAU,EAAM,YAKL,EACX,GAEA,EAAM,SAAW,SACjB,cAAe,GACf,iBAAkB,GAClB,UAAW,GACX,OAAO,EAAM,WAAc,UAC3B,OAAO,EAAM,cAAiB,UAC9B,OAAO,EAAM,OAAU,SAKZ,EAAkB,GAC7B,gBAAiB,GACjB,OAAO,EAAM,aAAgB,UAC7B,EAAM,cAAgB,MACtB,SAAU,EAAM,aAChB,YAAa,EAAM,YAKR,EACX,GAEA,EAAe,EAAM,EAAI,EAAM,YAAY,OAAS,OAKzC,EAAiB,GAC5B,EAAM,SAAW,SACjB,WAAY,GACZ,EAAM,SAAW,MACjB,OAAO,EAAM,QAAW,UACxB,SAAU,EAAM,QAChB,cAAe,GACf,iBAAkB,GAClB,OAAO,EAAM,WAAc,UAC3B,OAAO,EAAM,cAAiB,SAKnB,EACX,GAEA,EAAc,EAAM,GACnB,EAAM,OAAO,OAAS,qBACrB,EAAM,OAAO,OAAS,kBAKb,EACX,GAEA,EAAmB,EAAM,GACxB,EAAM,YAAY,OAAS,0BAC1B,EAAM,YAAY,OAAS,uBAKlB,EACX,GAEA,EAAmB,EAAM,EACzB,EAAM,YAAY,OAAS,gCAKhB,EACX,GAEA,EAAmB,EAAM,EAAI,EAAM,YAAY,OAAS,qBAK7C,EACX,GAEA,EAAmB,EAAM,EACzB,EAAM,YAAY,OAAS,uBAKhB,EACX,GAEA,EAAc,EAAM,EAAI,EAAM,OAAO,OAAS,wBAQnC,EACX,GAEA,EAAc,EAAM,GACnB,EAAM,YAAA,aACL,EAAM,YAAA,qBAKG,EACX,GAEA,EAAM,SAAW,SACjB,kBAAmB,GACnB,UAAW,GACX,OAAO,EAAM,eAAkB,UAC/B,MAAM,QAAQ,EAAM,MAAM,CAKf,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,+BAEvB,EACX,GACmD,EAAM,MAAQ,aAEtD,EACX,GAEA,EAAM,MAAQ,mBAEH,EACX,GAC+C,EAAM,MAAQ,QAElD,EACX,GAC8C,EAAM,MAAQ,OAKjD,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,yBAKvB,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,mBAMvB,EAA2B,GACtC,EAAyB,EAAM,EAAI,EAAmB,EAAM,CAKjD,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,qBAKvB,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,mBAEvB,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,sBAUpC,SAAgB,EAAmB,EAAyC,CAC1E,OAAO,EAAY,EAAM"}

package/dist/types/agent-server/type-guards.d.ts

@@ -58,12 +58,10 @@ export declare const isSwitchLLMObservationEvent: (event: OpenHandsEvent) => eve
  */
 export declare const isBrowserNavigateActionEvent: (event: OpenHandsEvent) => event is ActionEvent<BrowserNavigateAction>;
 /**
- * Type guard for the canvas_ui custom tool's ActionEvent.
+ * Type guard for Canvas UI tool ActionEvents.
  *
- * The tool is injected via tool_module_qualnames (see canvas_ui_tool.py and
- * agent-server-adapter.ts). We discriminate on tool_name (which we control
- * via register_tool("canvas_ui", ...)). The predicate narrows the event so
- * the call site can read `event.action.command` etc. without further casts.
+ * Discriminating on tool_name supports legacy CanvasUIAction events and the
+ * SDK-generated action kind without leaking that generated name here.
  */
 export declare const isCanvasUIActionEvent: (event: OpenHandsEvent) => event is ActionEvent<CanvasUIAction>;
 /**

package/dist/types/agent-server/type-guards.js

@@ -1,8 +1,9 @@
+import "../../constants/canvas-ui.js";
 //#region src/types/agent-server/type-guards.ts
 function e(e) {
 	return typeof e == "object" && !!e && "id" in e && "timestamp" in e && "source" in e && typeof e.id == "string" && e.id.length > 0 && typeof e.timestamp == "string" && e.timestamp.length > 0 && typeof e.source == "string" && (e.source === "agent" || e.source === "user" || e.source === "environment" || e.source === "hook");
 }
-var t = (e) => e.source === "environment" && "action_id" in e && "observation" in e && e.observation !== null && typeof e.observation == "object" && "kind" in e.observation, n = (e) => e.source === "agent" && "tool_name" in e && "tool_call_id" in e && "error" in e && typeof e.tool_name == "string" && typeof e.tool_call_id == "string" && typeof e.error == "string", r = (e) => "llm_message" in e && typeof e.llm_message == "object" && e.llm_message !== null && "role" in e.llm_message && "content" in e.llm_message, i = (e) => r(e) && e.llm_message.role === "user", a = (e) => e.source === "agent" && "action" in e && e.action !== null && typeof e.action == "object" && "kind" in e.action && "tool_name" in e && "tool_call_id" in e && typeof e.tool_name == "string" && typeof e.tool_call_id == "string", o = (e) => a(e) && (e.action.kind === "ExecuteBashAction" || e.action.kind === "TerminalAction"), s = (e) => t(e) && (e.observation.kind === "ExecuteBashObservation" || e.observation.kind === "TerminalObservation"), c = (e) => t(e) && e.observation.kind === "PlanningFileEditorObservation", l = (e) => t(e) && e.observation.kind === "BrowserObservation", u = (e) => t(e) && e.observation.kind === "SwitchLLMObservation", d = (e) => a(e) && e.action.kind === "BrowserNavigateAction", f = (e) => a(e) && e.tool_name === "canvas_ui", p = (e) => e.source === "agent" && "system_prompt" in e && "tools" in e && typeof e.system_prompt == "object" && Array.isArray(e.tools), m = (e) => "kind" in e && e.kind === "ConversationStateUpdateEvent", h = (e) => e.key === "full_state", g = (e) => e.key === "execution_status", _ = (e) => e.key === "stats", v = (e) => e.key === "goal", y = (e) => "kind" in e && e.kind === "ConversationErrorEvent", b = (e) => "kind" in e && e.kind === "ServerErrorEvent", x = (e) => y(e) || b(e), S = (e) => "kind" in e && e.kind === "HookExecutionEvent", C = (e) => "kind" in e && e.kind === "ACPToolCallEvent", w = (e) => "kind" in e && e.kind === "StreamingDeltaEvent";
+var t = (e) => e.source === "environment" && "action_id" in e && "observation" in e && e.observation !== null && typeof e.observation == "object" && "kind" in e.observation, n = (e) => e.source === "agent" && "tool_name" in e && "tool_call_id" in e && "error" in e && typeof e.tool_name == "string" && typeof e.tool_call_id == "string" && typeof e.error == "string", r = (e) => "llm_message" in e && typeof e.llm_message == "object" && e.llm_message !== null && "role" in e.llm_message && "content" in e.llm_message, i = (e) => r(e) && e.llm_message.role === "user", a = (e) => e.source === "agent" && "action" in e && e.action !== null && typeof e.action == "object" && "kind" in e.action && "tool_name" in e && "tool_call_id" in e && typeof e.tool_name == "string" && typeof e.tool_call_id == "string", o = (e) => a(e) && (e.action.kind === "ExecuteBashAction" || e.action.kind === "TerminalAction"), s = (e) => t(e) && (e.observation.kind === "ExecuteBashObservation" || e.observation.kind === "TerminalObservation"), c = (e) => t(e) && e.observation.kind === "PlanningFileEditorObservation", l = (e) => t(e) && e.observation.kind === "BrowserObservation", u = (e) => t(e) && e.observation.kind === "SwitchLLMObservation", d = (e) => a(e) && e.action.kind === "BrowserNavigateAction", f = (e) => a(e) && (e.tool_name === "canvas_ui" || e.tool_name === "canvas_ui_control"), p = (e) => e.source === "agent" && "system_prompt" in e && "tools" in e && typeof e.system_prompt == "object" && Array.isArray(e.tools), m = (e) => "kind" in e && e.kind === "ConversationStateUpdateEvent", h = (e) => e.key === "full_state", g = (e) => e.key === "execution_status", _ = (e) => e.key === "stats", v = (e) => e.key === "goal", y = (e) => "kind" in e && e.kind === "ConversationErrorEvent", b = (e) => "kind" in e && e.kind === "ServerErrorEvent", x = (e) => y(e) || b(e), S = (e) => "kind" in e && e.kind === "HookExecutionEvent", C = (e) => "kind" in e && e.kind === "ACPToolCallEvent", w = (e) => "kind" in e && e.kind === "StreamingDeltaEvent";
 function T(t) {
 	return e(t);
 }

package/dist/types/agent-server/type-guards.js.map

@@ -1 +1 @@
-{"version":3,"file":"type-guards.js","names":[],"sources":["../../../src/types/agent-server/type-guards.ts"],"sourcesContent":["import {\n  OpenHandsEvent,\n  ObservationEvent,\n  BaseEvent,\n  ExecuteBashAction,\n  TerminalAction,\n  ExecuteBashObservation,\n  PlanningFileEditorObservation,\n  TerminalObservation,\n  BrowserObservation,\n  BrowserNavigateAction,\n  SwitchLLMObservation,\n  CanvasUIAction,\n} from \"./core\";\nimport { AgentErrorEvent } from \"./core/events/observation-event\";\nimport { MessageEvent } from \"./core/events/message-event\";\nimport { ActionEvent } from \"./core/events/action-event\";\nimport {\n  ConversationStateUpdateEvent,\n  ConversationStateUpdateEventAgentStatus,\n  ConversationStateUpdateEventFullState,\n  ConversationStateUpdateEventStats,\n  ConversationStateUpdateEventGoal,\n  ConversationErrorEvent,\n  ServerErrorEvent,\n} from \"./core/events/conversation-state-event\";\nimport { HookExecutionEvent } from \"./core/events/hook-execution-event\";\nimport { ACPToolCallEvent } from \"./core/events/acp-tool-call-event\";\nimport { StreamingDeltaEvent } from \"./core/events/streaming-delta-event\";\nimport { SystemPromptEvent } from \"./core/events/system-event\";\n\n/**\n * Type guard to check if an unknown value is a valid BaseEvent\n * @param value - The value to check\n * @returns true if the value is a valid BaseEvent\n */\nexport function isBaseEvent(value: unknown): value is BaseEvent {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    \"id\" in value &&\n    \"timestamp\" in value &&\n    \"source\" in value &&\n    typeof value.id === \"string\" &&\n    value.id.length > 0 &&\n    typeof value.timestamp === \"string\" &&\n    value.timestamp.length > 0 &&\n    typeof value.source === \"string\" &&\n    (value.source === \"agent\" ||\n      value.source === \"user\" ||\n      value.source === \"environment\" ||\n      value.source === \"hook\")\n  );\n}\n\n/**\n * Type guard function to check if an event is an observation event\n */\nexport const isObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent =>\n  event.source === \"environment\" &&\n  \"action_id\" in event &&\n  \"observation\" in event &&\n  event.observation !== null &&\n  typeof event.observation === \"object\" &&\n  \"kind\" in event.observation;\n\n/**\n * Type guard function to check if an event is an agent error event\n */\nexport const isAgentErrorEvent = (\n  event: OpenHandsEvent,\n): event is AgentErrorEvent =>\n  event.source === \"agent\" &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  \"error\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\" &&\n  typeof event.error === \"string\";\n\n/**\n * Type guard function to check if an event is a message event (user or assistant)\n */\nexport const isMessageEvent = (event: OpenHandsEvent): event is MessageEvent =>\n  \"llm_message\" in event &&\n  typeof event.llm_message === \"object\" &&\n  event.llm_message !== null &&\n  \"role\" in event.llm_message &&\n  \"content\" in event.llm_message;\n\n/**\n * Type guard function to check if an event is a user message event\n */\nexport const isUserMessageEvent = (\n  event: OpenHandsEvent,\n): event is MessageEvent =>\n  isMessageEvent(event) && event.llm_message.role === \"user\";\n\n/**\n * Type guard function to check if an event is an action event\n */\nexport const isActionEvent = (event: OpenHandsEvent): event is ActionEvent =>\n  event.source === \"agent\" &&\n  \"action\" in event &&\n  event.action !== null &&\n  typeof event.action === \"object\" &&\n  \"kind\" in event.action &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\";\n\n/**\n * Type guard function to check if an action event is an ExecuteBashAction\n */\nexport const isExecuteBashActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<ExecuteBashAction | TerminalAction> =>\n  isActionEvent(event) &&\n  (event.action.kind === \"ExecuteBashAction\" ||\n    event.action.kind === \"TerminalAction\");\n\n/**\n * Type guard function to check if an observation event contains terminal output\n */\nexport const isExecuteBashObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<ExecuteBashObservation | TerminalObservation> =>\n  isObservationEvent(event) &&\n  (event.observation.kind === \"ExecuteBashObservation\" ||\n    event.observation.kind === \"TerminalObservation\");\n\n/**\n * Type guard function to check if an observation event is a PlanningFileEditorObservation\n */\nexport const isPlanningFileEditorObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<PlanningFileEditorObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"PlanningFileEditorObservation\";\n\n/**\n * Type guard function to check if an observation event is a BrowserObservation\n */\nexport const isBrowserObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<BrowserObservation> =>\n  isObservationEvent(event) && event.observation.kind === \"BrowserObservation\";\n\n/**\n * Type guard function to check if an observation event is a SwitchLLMObservation\n */\nexport const isSwitchLLMObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<SwitchLLMObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"SwitchLLMObservation\";\n\n/**\n * Type guard function to check if an action event is a BrowserNavigateAction\n */\nexport const isBrowserNavigateActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<BrowserNavigateAction> =>\n  isActionEvent(event) && event.action.kind === \"BrowserNavigateAction\";\n\n/**\n * Type guard for the canvas_ui custom tool's ActionEvent.\n *\n * The tool is injected via tool_module_qualnames (see canvas_ui_tool.py and\n * agent-server-adapter.ts). We discriminate on tool_name (which we control\n * via register_tool(\"canvas_ui\", ...)). The predicate narrows the event so\n * the call site can read `event.action.command` etc. without further casts.\n */\nexport const isCanvasUIActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<CanvasUIAction> =>\n  isActionEvent(event) && event.tool_name === \"canvas_ui\";\n\n/**\n * Type guard function to check if an event is a system prompt event\n */\nexport const isSystemPromptEvent = (\n  event: OpenHandsEvent,\n): event is SystemPromptEvent =>\n  event.source === \"agent\" &&\n  \"system_prompt\" in event &&\n  \"tools\" in event &&\n  typeof event.system_prompt === \"object\" &&\n  Array.isArray(event.tools);\n\n/**\n * Type guard function to check if an event is a conversation state update event\n */\nexport const isConversationStateUpdateEvent = (\n  event: OpenHandsEvent,\n): event is ConversationStateUpdateEvent =>\n  \"kind\" in event && event.kind === \"ConversationStateUpdateEvent\";\n\nexport const isFullStateConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventFullState => event.key === \"full_state\";\n\nexport const isAgentStatusConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventAgentStatus =>\n  event.key === \"execution_status\";\n\nexport const isStatsConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventStats => event.key === \"stats\";\n\nexport const isGoalConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventGoal => event.key === \"goal\";\n\n/**\n * Type guard function to check if an event is a conversation error event\n */\nexport const isConversationErrorEvent = (\n  event: OpenHandsEvent,\n): event is ConversationErrorEvent =>\n  \"kind\" in event && event.kind === \"ConversationErrorEvent\";\n\n/**\n * Type guard function to check if an event is a server error event\n */\nexport const isServerErrorEvent = (\n  event: OpenHandsEvent,\n): event is ServerErrorEvent =>\n  \"kind\" in event && event.kind === \"ServerErrorEvent\";\n\n/**\n * Type guard function to check if an event is a displayable error event\n * (ConversationErrorEvent or ServerErrorEvent) - both should show as error banners\n */\nexport const isDisplayableErrorEvent = (event: OpenHandsEvent): boolean =>\n  isConversationErrorEvent(event) || isServerErrorEvent(event);\n\n/**\n * Type guard function to check if an event is a hook execution event\n */\nexport const isHookExecutionEvent = (\n  event: OpenHandsEvent,\n): event is HookExecutionEvent =>\n  \"kind\" in event && event.kind === \"HookExecutionEvent\";\n\n/**\n * Type guard function to check if an event is an ACP tool call event\n */\nexport const isACPToolCallEvent = (\n  event: OpenHandsEvent,\n): event is ACPToolCallEvent =>\n  \"kind\" in event && event.kind === \"ACPToolCallEvent\";\n\nexport const isStreamingDeltaEvent = (\n  event: OpenHandsEvent,\n): event is StreamingDeltaEvent =>\n  \"kind\" in event && event.kind === \"StreamingDeltaEvent\";\n\n// =============================================================================\n// COMPATIBILITY TYPE GUARDS\n// =============================================================================\n\n/**\n * Type guard to check if an event is an agent-server OpenHandsEvent.\n * Uses isBaseEvent to validate the complete event structure.\n */\nexport function isAgentServerEvent(event: unknown): event is OpenHandsEvent {\n  return isBaseEvent(event);\n}\n"],"mappings":";AAoCA,SAAgB,EAAY,GAAoC;AAC9D,QAEE,OAAO,KAAU,cADjB,KAEA,QAAQ,KACR,eAAe,KACf,YAAY,KACZ,OAAO,EAAM,MAAO,YACpB,EAAM,GAAG,SAAS,KAClB,OAAO,EAAM,aAAc,YAC3B,EAAM,UAAU,SAAS,KACzB,OAAO,EAAM,UAAW,aACvB,EAAM,WAAW,WAChB,EAAM,WAAW,UACjB,EAAM,WAAW,iBACjB,EAAM,WAAW;;AAOvB,IAAa,KACX,MAEA,EAAM,WAAW,iBACjB,eAAe,KACf,iBAAiB,KACjB,EAAM,gBAAgB,QACtB,OAAO,EAAM,eAAgB,YAC7B,UAAU,EAAM,aAKL,KACX,MAEA,EAAM,WAAW,WACjB,eAAe,KACf,kBAAkB,KAClB,WAAW,KACX,OAAO,EAAM,aAAc,YAC3B,OAAO,EAAM,gBAAiB,YAC9B,OAAO,EAAM,SAAU,UAKZ,KAAkB,MAC7B,iBAAiB,KACjB,OAAO,EAAM,eAAgB,YAC7B,EAAM,gBAAgB,QACtB,UAAU,EAAM,eAChB,aAAa,EAAM,aAKR,KACX,MAEA,EAAe,EAAM,IAAI,EAAM,YAAY,SAAS,QAKzC,KAAiB,MAC5B,EAAM,WAAW,WACjB,YAAY,KACZ,EAAM,WAAW,QACjB,OAAO,EAAM,UAAW,YACxB,UAAU,EAAM,UAChB,eAAe,KACf,kBAAkB,KAClB,OAAO,EAAM,aAAc,YAC3B,OAAO,EAAM,gBAAiB,UAKnB,KACX,MAEA,EAAc,EAAM,KACnB,EAAM,OAAO,SAAS,uBACrB,EAAM,OAAO,SAAS,mBAKb,KACX,MAEA,EAAmB,EAAM,KACxB,EAAM,YAAY,SAAS,4BAC1B,EAAM,YAAY,SAAS,wBAKlB,KACX,MAEA,EAAmB,EAAM,IACzB,EAAM,YAAY,SAAS,iCAKhB,KACX,MAEA,EAAmB,EAAM,IAAI,EAAM,YAAY,SAAS,sBAK7C,KACX,MAEA,EAAmB,EAAM,IACzB,EAAM,YAAY,SAAS,wBAKhB,KACX,MAEA,EAAc,EAAM,IAAI,EAAM,OAAO,SAAS,yBAUnC,KACX,MAEA,EAAc,EAAM,IAAI,EAAM,cAAc,aAKjC,KACX,MAEA,EAAM,WAAW,WACjB,mBAAmB,KACnB,WAAW,KACX,OAAO,EAAM,iBAAkB,YAC/B,MAAM,QAAQ,EAAM,MAAM,EAKf,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,gCAEvB,KACX,MACmD,EAAM,QAAQ,cAEtD,KACX,MAEA,EAAM,QAAQ,oBAEH,KACX,MAC+C,EAAM,QAAQ,SAElD,KACX,MAC8C,EAAM,QAAQ,QAKjD,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,0BAKvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,oBAMvB,KAA2B,MACtC,EAAyB,EAAM,IAAI,EAAmB,EAAM,EAKjD,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,sBAKvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,oBAEvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS;AAUpC,SAAgB,EAAmB,GAAyC;AAC1E,QAAO,EAAY,EAAM"}
+{"version":3,"file":"type-guards.js","names":[],"sources":["../../../src/types/agent-server/type-guards.ts"],"sourcesContent":["import {\n  CANVAS_UI_CLIENT_TOOL_NAME,\n  LEGACY_CANVAS_UI_TOOL_NAME,\n} from \"#/constants/canvas-ui\";\n\nimport {\n  OpenHandsEvent,\n  ObservationEvent,\n  BaseEvent,\n  ExecuteBashAction,\n  TerminalAction,\n  ExecuteBashObservation,\n  PlanningFileEditorObservation,\n  TerminalObservation,\n  BrowserObservation,\n  BrowserNavigateAction,\n  SwitchLLMObservation,\n  CanvasUIAction,\n} from \"./core\";\nimport { AgentErrorEvent } from \"./core/events/observation-event\";\nimport { MessageEvent } from \"./core/events/message-event\";\nimport { ActionEvent } from \"./core/events/action-event\";\nimport {\n  ConversationStateUpdateEvent,\n  ConversationStateUpdateEventAgentStatus,\n  ConversationStateUpdateEventFullState,\n  ConversationStateUpdateEventStats,\n  ConversationStateUpdateEventGoal,\n  ConversationErrorEvent,\n  ServerErrorEvent,\n} from \"./core/events/conversation-state-event\";\nimport { HookExecutionEvent } from \"./core/events/hook-execution-event\";\nimport { ACPToolCallEvent } from \"./core/events/acp-tool-call-event\";\nimport { StreamingDeltaEvent } from \"./core/events/streaming-delta-event\";\nimport { SystemPromptEvent } from \"./core/events/system-event\";\n\n/**\n * Type guard to check if an unknown value is a valid BaseEvent\n * @param value - The value to check\n * @returns true if the value is a valid BaseEvent\n */\nexport function isBaseEvent(value: unknown): value is BaseEvent {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    \"id\" in value &&\n    \"timestamp\" in value &&\n    \"source\" in value &&\n    typeof value.id === \"string\" &&\n    value.id.length > 0 &&\n    typeof value.timestamp === \"string\" &&\n    value.timestamp.length > 0 &&\n    typeof value.source === \"string\" &&\n    (value.source === \"agent\" ||\n      value.source === \"user\" ||\n      value.source === \"environment\" ||\n      value.source === \"hook\")\n  );\n}\n\n/**\n * Type guard function to check if an event is an observation event\n */\nexport const isObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent =>\n  event.source === \"environment\" &&\n  \"action_id\" in event &&\n  \"observation\" in event &&\n  event.observation !== null &&\n  typeof event.observation === \"object\" &&\n  \"kind\" in event.observation;\n\n/**\n * Type guard function to check if an event is an agent error event\n */\nexport const isAgentErrorEvent = (\n  event: OpenHandsEvent,\n): event is AgentErrorEvent =>\n  event.source === \"agent\" &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  \"error\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\" &&\n  typeof event.error === \"string\";\n\n/**\n * Type guard function to check if an event is a message event (user or assistant)\n */\nexport const isMessageEvent = (event: OpenHandsEvent): event is MessageEvent =>\n  \"llm_message\" in event &&\n  typeof event.llm_message === \"object\" &&\n  event.llm_message !== null &&\n  \"role\" in event.llm_message &&\n  \"content\" in event.llm_message;\n\n/**\n * Type guard function to check if an event is a user message event\n */\nexport const isUserMessageEvent = (\n  event: OpenHandsEvent,\n): event is MessageEvent =>\n  isMessageEvent(event) && event.llm_message.role === \"user\";\n\n/**\n * Type guard function to check if an event is an action event\n */\nexport const isActionEvent = (event: OpenHandsEvent): event is ActionEvent =>\n  event.source === \"agent\" &&\n  \"action\" in event &&\n  event.action !== null &&\n  typeof event.action === \"object\" &&\n  \"kind\" in event.action &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\";\n\n/**\n * Type guard function to check if an action event is an ExecuteBashAction\n */\nexport const isExecuteBashActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<ExecuteBashAction | TerminalAction> =>\n  isActionEvent(event) &&\n  (event.action.kind === \"ExecuteBashAction\" ||\n    event.action.kind === \"TerminalAction\");\n\n/**\n * Type guard function to check if an observation event contains terminal output\n */\nexport const isExecuteBashObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<ExecuteBashObservation | TerminalObservation> =>\n  isObservationEvent(event) &&\n  (event.observation.kind === \"ExecuteBashObservation\" ||\n    event.observation.kind === \"TerminalObservation\");\n\n/**\n * Type guard function to check if an observation event is a PlanningFileEditorObservation\n */\nexport const isPlanningFileEditorObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<PlanningFileEditorObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"PlanningFileEditorObservation\";\n\n/**\n * Type guard function to check if an observation event is a BrowserObservation\n */\nexport const isBrowserObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<BrowserObservation> =>\n  isObservationEvent(event) && event.observation.kind === \"BrowserObservation\";\n\n/**\n * Type guard function to check if an observation event is a SwitchLLMObservation\n */\nexport const isSwitchLLMObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<SwitchLLMObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"SwitchLLMObservation\";\n\n/**\n * Type guard function to check if an action event is a BrowserNavigateAction\n */\nexport const isBrowserNavigateActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<BrowserNavigateAction> =>\n  isActionEvent(event) && event.action.kind === \"BrowserNavigateAction\";\n\n/**\n * Type guard for Canvas UI tool ActionEvents.\n *\n * Discriminating on tool_name supports legacy CanvasUIAction events and the\n * SDK-generated action kind without leaking that generated name here.\n */\nexport const isCanvasUIActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<CanvasUIAction> =>\n  isActionEvent(event) &&\n  (event.tool_name === LEGACY_CANVAS_UI_TOOL_NAME ||\n    event.tool_name === CANVAS_UI_CLIENT_TOOL_NAME);\n\n/**\n * Type guard function to check if an event is a system prompt event\n */\nexport const isSystemPromptEvent = (\n  event: OpenHandsEvent,\n): event is SystemPromptEvent =>\n  event.source === \"agent\" &&\n  \"system_prompt\" in event &&\n  \"tools\" in event &&\n  typeof event.system_prompt === \"object\" &&\n  Array.isArray(event.tools);\n\n/**\n * Type guard function to check if an event is a conversation state update event\n */\nexport const isConversationStateUpdateEvent = (\n  event: OpenHandsEvent,\n): event is ConversationStateUpdateEvent =>\n  \"kind\" in event && event.kind === \"ConversationStateUpdateEvent\";\n\nexport const isFullStateConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventFullState => event.key === \"full_state\";\n\nexport const isAgentStatusConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventAgentStatus =>\n  event.key === \"execution_status\";\n\nexport const isStatsConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventStats => event.key === \"stats\";\n\nexport const isGoalConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventGoal => event.key === \"goal\";\n\n/**\n * Type guard function to check if an event is a conversation error event\n */\nexport const isConversationErrorEvent = (\n  event: OpenHandsEvent,\n): event is ConversationErrorEvent =>\n  \"kind\" in event && event.kind === \"ConversationErrorEvent\";\n\n/**\n * Type guard function to check if an event is a server error event\n */\nexport const isServerErrorEvent = (\n  event: OpenHandsEvent,\n): event is ServerErrorEvent =>\n  \"kind\" in event && event.kind === \"ServerErrorEvent\";\n\n/**\n * Type guard function to check if an event is a displayable error event\n * (ConversationErrorEvent or ServerErrorEvent) - both should show as error banners\n */\nexport const isDisplayableErrorEvent = (event: OpenHandsEvent): boolean =>\n  isConversationErrorEvent(event) || isServerErrorEvent(event);\n\n/**\n * Type guard function to check if an event is a hook execution event\n */\nexport const isHookExecutionEvent = (\n  event: OpenHandsEvent,\n): event is HookExecutionEvent =>\n  \"kind\" in event && event.kind === \"HookExecutionEvent\";\n\n/**\n * Type guard function to check if an event is an ACP tool call event\n */\nexport const isACPToolCallEvent = (\n  event: OpenHandsEvent,\n): event is ACPToolCallEvent =>\n  \"kind\" in event && event.kind === \"ACPToolCallEvent\";\n\nexport const isStreamingDeltaEvent = (\n  event: OpenHandsEvent,\n): event is StreamingDeltaEvent =>\n  \"kind\" in event && event.kind === \"StreamingDeltaEvent\";\n\n// =============================================================================\n// COMPATIBILITY TYPE GUARDS\n// =============================================================================\n\n/**\n * Type guard to check if an event is an agent-server OpenHandsEvent.\n * Uses isBaseEvent to validate the complete event structure.\n */\nexport function isAgentServerEvent(event: unknown): event is OpenHandsEvent {\n  return isBaseEvent(event);\n}\n"],"mappings":";;AAyCA,SAAgB,EAAY,GAAoC;AAC9D,QAEE,OAAO,KAAU,cADjB,KAEA,QAAQ,KACR,eAAe,KACf,YAAY,KACZ,OAAO,EAAM,MAAO,YACpB,EAAM,GAAG,SAAS,KAClB,OAAO,EAAM,aAAc,YAC3B,EAAM,UAAU,SAAS,KACzB,OAAO,EAAM,UAAW,aACvB,EAAM,WAAW,WAChB,EAAM,WAAW,UACjB,EAAM,WAAW,iBACjB,EAAM,WAAW;;AAOvB,IAAa,KACX,MAEA,EAAM,WAAW,iBACjB,eAAe,KACf,iBAAiB,KACjB,EAAM,gBAAgB,QACtB,OAAO,EAAM,eAAgB,YAC7B,UAAU,EAAM,aAKL,KACX,MAEA,EAAM,WAAW,WACjB,eAAe,KACf,kBAAkB,KAClB,WAAW,KACX,OAAO,EAAM,aAAc,YAC3B,OAAO,EAAM,gBAAiB,YAC9B,OAAO,EAAM,SAAU,UAKZ,KAAkB,MAC7B,iBAAiB,KACjB,OAAO,EAAM,eAAgB,YAC7B,EAAM,gBAAgB,QACtB,UAAU,EAAM,eAChB,aAAa,EAAM,aAKR,KACX,MAEA,EAAe,EAAM,IAAI,EAAM,YAAY,SAAS,QAKzC,KAAiB,MAC5B,EAAM,WAAW,WACjB,YAAY,KACZ,EAAM,WAAW,QACjB,OAAO,EAAM,UAAW,YACxB,UAAU,EAAM,UAChB,eAAe,KACf,kBAAkB,KAClB,OAAO,EAAM,aAAc,YAC3B,OAAO,EAAM,gBAAiB,UAKnB,KACX,MAEA,EAAc,EAAM,KACnB,EAAM,OAAO,SAAS,uBACrB,EAAM,OAAO,SAAS,mBAKb,KACX,MAEA,EAAmB,EAAM,KACxB,EAAM,YAAY,SAAS,4BAC1B,EAAM,YAAY,SAAS,wBAKlB,KACX,MAEA,EAAmB,EAAM,IACzB,EAAM,YAAY,SAAS,iCAKhB,KACX,MAEA,EAAmB,EAAM,IAAI,EAAM,YAAY,SAAS,sBAK7C,KACX,MAEA,EAAmB,EAAM,IACzB,EAAM,YAAY,SAAS,wBAKhB,KACX,MAEA,EAAc,EAAM,IAAI,EAAM,OAAO,SAAS,yBAQnC,KACX,MAEA,EAAc,EAAM,KACnB,EAAM,cAAA,eACL,EAAM,cAAA,sBAKG,KACX,MAEA,EAAM,WAAW,WACjB,mBAAmB,KACnB,WAAW,KACX,OAAO,EAAM,iBAAkB,YAC/B,MAAM,QAAQ,EAAM,MAAM,EAKf,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,gCAEvB,KACX,MACmD,EAAM,QAAQ,cAEtD,KACX,MAEA,EAAM,QAAQ,oBAEH,KACX,MAC+C,EAAM,QAAQ,SAElD,KACX,MAC8C,EAAM,QAAQ,QAKjD,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,0BAKvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,oBAMvB,KAA2B,MACtC,EAAyB,EAAM,IAAI,EAAmB,EAAM,EAKjD,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,sBAKvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,oBAEvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS;AAUpC,SAAgB,EAAmB,GAAyC;AAC1E,QAAO,EAAY,EAAM"}

package/dist/types/automation.d.ts

@@ -28,6 +28,11 @@ export interface Automation {
     repository?: string;
     /** LLM/model profile name used for automation runs. */
     model?: string | null;
+    /**
+     * Maximum run time in seconds. `null`/omitted uses the server default
+     * (600s, 10 min); the server caps it at 1800s (30 min).
+     */
+    timeout?: number | null;
     created_at: string;
     updated_at: string;
     prompt: string | null;

package/dist/utils/api-error-message.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Extract a human-readable message from a failed API call.
+ *
+ * Handles both transports the app uses: local agent-server calls that
+ * throw an `AxiosError` (body under `error.response.data`) and cloud
+ * calls through the shared TypeScript client that throw an `HttpError`
+ * (parsed body directly under `error.response`). Prefers the
+ * server-provided `message`/`detail` fields, then the `Error` message,
+ * then `fallback`.
+ */
+export declare function getApiErrorMessage(error: unknown, fallback: string): string;

package/dist/utils/automation-timeout.d.ts

@@ -0,0 +1,19 @@
+import { I18nKey } from "#/i18n/declaration";
+/**
+ * Per-automation run timeout bounds. These mirror the automation server
+ * (`openhands/automation/utils/timeout.py`): a `null`/omitted timeout falls back
+ * to the default, and the server rejects anything above the maximum.
+ */
+export declare const AUTOMATION_TIMEOUT_DEFAULT_SECONDS = 600;
+export declare const AUTOMATION_TIMEOUT_MAX_SECONDS = 1800;
+export type AutomationTimeoutValidation = {
+    value: number | null;
+} | {
+    errorKey: I18nKey;
+};
+/**
+ * Validate a raw timeout string from the edit form. A blank string means "use
+ * the server default" (resolved as `null`). Otherwise the value must be a
+ * positive integer no greater than {@link AUTOMATION_TIMEOUT_MAX_SECONDS}.
+ */
+export declare function validateAutomationTimeout(raw: string): AutomationTimeoutValidation;

package/dist/utils/base-path.cjs

@@ -0,0 +1,2 @@
+require(`../_virtual/_rolldown/runtime.cjs`);var e=`__AGENT_CANVAS_BASE_PATH__`;function t(e){let t=e?.trim();return!t||t===`/`?``:(t.startsWith(`/`)?t:`/${t}`).replace(/\/+$/,``)}function n(){let n=t(void 0);if(n)return n;if(typeof window<`u`){let n=window[e];if(typeof n==`string`)return t(n)}return``}function r(e){let t=n();return t?`${t}${e.startsWith(`/`)?e:`/${e}`}`:e.startsWith(`/`)?e:`/${e}`}exports.buildAgentCanvasPath=r;
+//# sourceMappingURL=base-path.cjs.map

package/dist/utils/base-path.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-path.cjs","names":[],"sources":["../../src/utils/base-path.ts"],"sourcesContent":["const BASE_PATH_WINDOW_KEY = \"__AGENT_CANVAS_BASE_PATH__\";\n\nfunction normalizeBasePath(value?: string | null): string {\n  const raw = value?.trim();\n  if (!raw || raw === \"/\") return \"\";\n\n  const withLeadingSlash = raw.startsWith(\"/\") ? raw : `/${raw}`;\n  return withLeadingSlash.replace(/\\/+$/, \"\");\n}\n\nexport function getAgentCanvasBasePath(): string {\n  const envPath = normalizeBasePath(import.meta.env.VITE_BASE_PATH);\n  if (envPath) return envPath;\n\n  if (typeof window !== \"undefined\") {\n    const injected = (window as unknown as Record<string, unknown>)[\n      BASE_PATH_WINDOW_KEY\n    ];\n    if (typeof injected === \"string\") {\n      return normalizeBasePath(injected);\n    }\n  }\n\n  return \"\";\n}\n\nexport function buildAgentCanvasPath(path: string): string {\n  const basePath = getAgentCanvasBasePath();\n  if (!basePath) return path.startsWith(\"/\") ? path : `/${path}`;\n\n  const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n  return `${basePath}${normalizedPath}`;\n}\n"],"mappings":"6CAAA,IAAM,EAAuB,6BAE7B,SAAS,EAAkB,EAA+B,CACxD,IAAM,EAAM,GAAO,MAAM,CAIzB,MAHI,CAAC,GAAO,IAAQ,IAAY,IAEP,EAAI,WAAW,IAAI,CAAG,EAAM,IAAI,KACjC,QAAQ,OAAQ,GAAG,CAG7C,SAAgB,GAAiC,CAC/C,IAAM,EAAU,EAAA,IAAA,GAAiD,CACjE,GAAI,EAAS,OAAO,EAEpB,GAAI,OAAO,OAAW,IAAa,CACjC,IAAM,EAAY,OAChB,GAEF,GAAI,OAAO,GAAa,SACtB,OAAO,EAAkB,EAAS,CAItC,MAAO,GAGT,SAAgB,EAAqB,EAAsB,CACzD,IAAM,EAAW,GAAwB,CAIzC,OAHK,EAGE,GAAG,IADa,EAAK,WAAW,IAAI,CAAG,EAAO,IAAI,MAFnC,EAAK,WAAW,IAAI,CAAG,EAAO,IAAI"}

package/dist/utils/base-path.d.ts

@@ -0,0 +1,2 @@
+export declare function getAgentCanvasBasePath(): string;
+export declare function buildAgentCanvasPath(path: string): string;

package/dist/utils/base-path.js

@@ -0,0 +1,23 @@
+//#region src/utils/base-path.ts
+var e = "__AGENT_CANVAS_BASE_PATH__";
+function t(e) {
+	let t = e?.trim();
+	return !t || t === "/" ? "" : (t.startsWith("/") ? t : `/${t}`).replace(/\/+$/, "");
+}
+function n() {
+	let n = t(void 0);
+	if (n) return n;
+	if (typeof window < "u") {
+		let n = window[e];
+		if (typeof n == "string") return t(n);
+	}
+	return "";
+}
+function r(e) {
+	let t = n();
+	return t ? `${t}${e.startsWith("/") ? e : `/${e}`}` : e.startsWith("/") ? e : `/${e}`;
+}
+//#endregion
+export { r as buildAgentCanvasPath };
+
+//# sourceMappingURL=base-path.js.map

package/dist/utils/base-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-path.js","names":[],"sources":["../../src/utils/base-path.ts"],"sourcesContent":["const BASE_PATH_WINDOW_KEY = \"__AGENT_CANVAS_BASE_PATH__\";\n\nfunction normalizeBasePath(value?: string | null): string {\n  const raw = value?.trim();\n  if (!raw || raw === \"/\") return \"\";\n\n  const withLeadingSlash = raw.startsWith(\"/\") ? raw : `/${raw}`;\n  return withLeadingSlash.replace(/\\/+$/, \"\");\n}\n\nexport function getAgentCanvasBasePath(): string {\n  const envPath = normalizeBasePath(import.meta.env.VITE_BASE_PATH);\n  if (envPath) return envPath;\n\n  if (typeof window !== \"undefined\") {\n    const injected = (window as unknown as Record<string, unknown>)[\n      BASE_PATH_WINDOW_KEY\n    ];\n    if (typeof injected === \"string\") {\n      return normalizeBasePath(injected);\n    }\n  }\n\n  return \"\";\n}\n\nexport function buildAgentCanvasPath(path: string): string {\n  const basePath = getAgentCanvasBasePath();\n  if (!basePath) return path.startsWith(\"/\") ? path : `/${path}`;\n\n  const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n  return `${basePath}${normalizedPath}`;\n}\n"],"mappings":";AAAA,IAAM,IAAuB;AAE7B,SAAS,EAAkB,GAA+B;CACxD,IAAM,IAAM,GAAO,MAAM;AAIzB,QAHI,CAAC,KAAO,MAAQ,MAAY,MAEP,EAAI,WAAW,IAAI,GAAG,IAAM,IAAI,KACjC,QAAQ,QAAQ,GAAG;;AAG7C,SAAgB,IAAiC;CAC/C,IAAM,IAAU,EAAA,KAAA,EAAiD;AACjE,KAAI,EAAS,QAAO;AAEpB,KAAI,OAAO,SAAW,KAAa;EACjC,IAAM,IAAY,OAChB;AAEF,MAAI,OAAO,KAAa,SACtB,QAAO,EAAkB,EAAS;;AAItC,QAAO;;AAGT,SAAgB,EAAqB,GAAsB;CACzD,IAAM,IAAW,GAAwB;AAIzC,QAHK,IAGE,GAAG,IADa,EAAK,WAAW,IAAI,GAAG,IAAO,IAAI,QAFnC,EAAK,WAAW,IAAI,GAAG,IAAO,IAAI"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openhands/agent-canvas",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Agent Canvas UI for OpenHands - run AI coding agents with a visual interface",
   "license": "MIT",
   "private": false,
@@ -24,7 +24,7 @@
     "@microlink/react-json-view": "1.31.20",
     "@monaco-editor/react": "4.7.0",
     "@openhands/extensions": "0.9.0",
-    "@openhands/typescript-client": "1.32.1",
+    "@openhands/typescript-client": "1.34.0",
     "@react-router/node": "7.17.0",
     "@react-router/serve": "7.17.0",
     "@tailwindcss/vite": "4.2.4",