@openhands/agent-canvas 1.5.2 → 1.6.1

package/dist/services/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","names":[],"sources":["../../src/services/settings.ts"],"sourcesContent":["import { Settings } from \"#/types/settings\";\n\nexport const LATEST_SETTINGS_VERSION = 5;\n\nexport const DEFAULT_SETTINGS: Settings = {\n  llm_model: \"openhands/minimax-m2.7\",\n  llm_base_url: \"\",\n  agent: \"CodeActAgent\",\n  language: \"en\",\n  llm_api_key: null,\n  llm_api_key_set: false,\n  search_api_key_set: false,\n  confirmation_mode: false,\n  security_analyzer: \"llm\",\n  max_iterations: null,\n  remote_runtime_resource_factor: 1,\n  provider_tokens_set: {},\n  enable_default_condenser: true,\n  condenser_max_size: 240,\n  enable_sound_notifications: false,\n  user_consents_to_analytics: false,\n  enable_proactive_conversation_starters: false,\n  enable_solvability_analysis: false,\n  search_api_key: \"\",\n  is_new_user: true,\n  disabled_skills: [],\n  mcp_config: {\n    sse_servers: [],\n    stdio_servers: [],\n    shttp_servers: [],\n  },\n  max_budget_per_task: null,\n  email: \"\",\n  email_verified: true,\n  git_user_name: \"openhands\",\n  git_user_email: \"openhands@all-hands.dev\",\n  agent_settings_schema: null,\n  agent_settings: {\n    schema_version: 6,\n    agent_kind: \"openhands\",\n    agent: \"CodeActAgent\",\n    llm: {\n      model: \"openhands/minimax-m2.7\",\n    },\n    condenser: {\n      enabled: true,\n      max_size: 240,\n    },\n    verification: {\n      critic_enabled: false,\n      enable_iterative_refinement: false,\n    },\n    enable_sub_agents: false,\n    mcp_config: {},\n  },\n  conversation_settings_schema: null,\n  conversation_settings: {\n    schema_version: 1,\n    confirmation_mode: false,\n    security_analyzer: \"llm\",\n  },\n};\n\n/**\n * Get the default settings\n */\nexport const getDefaultSettings = (): Settings => DEFAULT_SETTINGS;\n"],"mappings":";AAIA,IAAa,IAA6B;CACxC,WAAW;CACX,cAAc;CACd,OAAO;CACP,UAAU;CACV,aAAa;CACb,iBAAiB;CACjB,oBAAoB;CACpB,mBAAmB;CACnB,mBAAmB;CACnB,gBAAgB;CAChB,gCAAgC;CAChC,qBAAqB,EAAE;CACvB,0BAA0B;CAC1B,oBAAoB;CACpB,4BAA4B;CAC5B,4BAA4B;CAC5B,wCAAwC;CACxC,6BAA6B;CAC7B,gBAAgB;CAChB,aAAa;CACb,iBAAiB,EAAE;CACnB,YAAY;EACV,aAAa,EAAE;EACf,eAAe,EAAE;EACjB,eAAe,EAAE;EAClB;CACD,qBAAqB;CACrB,OAAO;CACP,gBAAgB;CAChB,eAAe;CACf,gBAAgB;CAChB,uBAAuB;CACvB,gBAAgB;EACd,gBAAgB;EAChB,YAAY;EACZ,OAAO;EACP,KAAK,EACH,OAAO,0BACR;EACD,WAAW;GACT,SAAS;GACT,UAAU;GACX;EACD,cAAc;GACZ,gBAAgB;GAChB,6BAA6B;GAC9B;EACD,mBAAmB;EACnB,YAAY,EAAE;EACf;CACD,8BAA8B;CAC9B,uBAAuB;EACrB,gBAAgB;EAChB,mBAAmB;EACnB,mBAAmB;EACpB;CACF"}
+{"version":3,"file":"settings.js","names":[],"sources":["../../src/services/settings.ts"],"sourcesContent":["import { Settings } from \"#/types/settings\";\n\nexport const LATEST_SETTINGS_VERSION = 5;\n\nexport const DEFAULT_SETTINGS: Settings = {\n  llm_model: \"openhands/minimax-m2.7\",\n  llm_base_url: \"\",\n  agent: \"CodeActAgent\",\n  language: \"en\",\n  llm_api_key: null,\n  llm_api_key_set: false,\n  search_api_key_set: false,\n  confirmation_mode: false,\n  security_analyzer: \"llm\",\n  max_iterations: null,\n  remote_runtime_resource_factor: 1,\n  provider_tokens_set: {},\n  enable_default_condenser: true,\n  condenser_max_size: 240,\n  enable_sound_notifications: false,\n  user_consents_to_analytics: false,\n  enable_proactive_conversation_starters: false,\n  enable_solvability_analysis: false,\n  search_api_key: \"\",\n  is_new_user: true,\n  disabled_skills: [],\n  mcp_config: {\n    sse_servers: [],\n    stdio_servers: [],\n    shttp_servers: [],\n  },\n  max_budget_per_task: null,\n  email: \"\",\n  email_verified: true,\n  git_user_name: \"openhands\",\n  git_user_email: \"openhands@all-hands.dev\",\n  title_llm_profile: null,\n  agent_settings_schema: null,\n  agent_settings: {\n    schema_version: 6,\n    agent_kind: \"openhands\",\n    agent: \"CodeActAgent\",\n    llm: {\n      model: \"openhands/minimax-m2.7\",\n    },\n    condenser: {\n      enabled: true,\n      max_size: 240,\n    },\n    verification: {\n      critic_enabled: false,\n      enable_iterative_refinement: false,\n    },\n    enable_sub_agents: false,\n    mcp_config: {},\n  },\n  conversation_settings_schema: null,\n  conversation_settings: {\n    schema_version: 1,\n    confirmation_mode: false,\n    security_analyzer: \"llm\",\n  },\n};\n\n/**\n * Get the default settings\n */\nexport const getDefaultSettings = (): Settings => DEFAULT_SETTINGS;\n"],"mappings":";AAIA,IAAa,IAA6B;CACxC,WAAW;CACX,cAAc;CACd,OAAO;CACP,UAAU;CACV,aAAa;CACb,iBAAiB;CACjB,oBAAoB;CACpB,mBAAmB;CACnB,mBAAmB;CACnB,gBAAgB;CAChB,gCAAgC;CAChC,qBAAqB,EAAE;CACvB,0BAA0B;CAC1B,oBAAoB;CACpB,4BAA4B;CAC5B,4BAA4B;CAC5B,wCAAwC;CACxC,6BAA6B;CAC7B,gBAAgB;CAChB,aAAa;CACb,iBAAiB,EAAE;CACnB,YAAY;EACV,aAAa,EAAE;EACf,eAAe,EAAE;EACjB,eAAe,EAAE;EAClB;CACD,qBAAqB;CACrB,OAAO;CACP,gBAAgB;CAChB,eAAe;CACf,gBAAgB;CAChB,mBAAmB;CACnB,uBAAuB;CACvB,gBAAgB;EACd,gBAAgB;EAChB,YAAY;EACZ,OAAO;EACP,KAAK,EACH,OAAO,0BACR;EACD,WAAW;GACT,SAAS;GACT,UAAU;GACX;EACD,cAAc;GACZ,gBAAgB;GAChB,6BAA6B;GAC9B;EACD,mBAAmB;EACnB,YAAY,EAAE;EACf;CACD,8BAA8B;CAC9B,uBAAuB;EACrB,gBAAgB;EAChB,mBAAmB;EACnB,mBAAmB;EACpB;CACF"}

package/dist/services/telemetry-context.cjs

@@ -0,0 +1,2 @@
+require(`../_virtual/_rolldown/runtime.cjs`);function e(e){return e?.trim()||`unknown`}function t(e){return e?.trim()||null}function n({backendKind:t,agentServerVersion:n,automationSdkVersion:r,backendVersion:i,connectionMethod:a}){let o=e(n??i),s=e(r),c=e(i??n);return{backend_kind:t??null,agent_server_version:o,automation_sdk_version:s,backend_version:c,...a?{connection_method:a}:{}}}function r(e=null){return{cloud_user_id:t(e?.userId),cloud_user_email:t(e?.email),cloud_org_id:t(e?.orgId)}}exports.getBackendTelemetryProperties=n,exports.getCloudTelemetryProperties=r;
+//# sourceMappingURL=telemetry-context.cjs.map

package/dist/services/telemetry-context.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-context.cjs","names":[],"sources":["../../src/services/telemetry-context.ts"],"sourcesContent":["import type { BackendKind } from \"#/api/backend-registry/types\";\n\nexport const UNKNOWN_TELEMETRY_VERSION = \"unknown\";\n\nexport type BackendConnectionMethod = \"manual\" | \"cloud_login\";\n\nexport interface CloudTelemetryContextInput {\n  userId?: string | null;\n  email?: string | null;\n  orgId?: string | null;\n}\n\nexport interface BackendTelemetryContextInput {\n  backendKind?: BackendKind | null;\n  agentServerVersion?: string | null;\n  automationSdkVersion?: string | null;\n  backendVersion?: string | null;\n  connectionMethod?: BackendConnectionMethod;\n}\n\nfunction normalizeTelemetryVersion(version: string | null | undefined): string {\n  const trimmed = version?.trim();\n  return trimmed || UNKNOWN_TELEMETRY_VERSION;\n}\n\nfunction normalizeOptionalProperty(\n  value: string | null | undefined,\n): string | null {\n  const trimmed = value?.trim();\n  return trimmed || null;\n}\n\nexport function getBackendTelemetryProperties({\n  backendKind,\n  agentServerVersion,\n  automationSdkVersion,\n  backendVersion,\n  connectionMethod,\n}: BackendTelemetryContextInput): Record<string, unknown> {\n  const resolvedAgentServerVersion = normalizeTelemetryVersion(\n    agentServerVersion ?? backendVersion,\n  );\n  const resolvedAutomationSdkVersion =\n    normalizeTelemetryVersion(automationSdkVersion);\n  const resolvedBackendVersion = normalizeTelemetryVersion(\n    backendVersion ?? agentServerVersion,\n  );\n\n  return {\n    backend_kind: backendKind ?? null,\n    agent_server_version: resolvedAgentServerVersion,\n    automation_sdk_version: resolvedAutomationSdkVersion,\n    backend_version: resolvedBackendVersion,\n    ...(connectionMethod ? { connection_method: connectionMethod } : {}),\n  };\n}\n\nexport function getCloudTelemetryProperties(\n  context: CloudTelemetryContextInput | null = null,\n): Record<string, unknown> {\n  return {\n    cloud_user_id: normalizeOptionalProperty(context?.userId),\n    cloud_user_email: normalizeOptionalProperty(context?.email),\n    cloud_org_id: normalizeOptionalProperty(context?.orgId),\n  };\n}\n"],"mappings":"6CAoBA,SAAS,EAA0B,EAA4C,CAE7E,OADgB,GAAS,MAAM,EAAA,UAIjC,SAAS,EACP,EACe,CAEf,OADgB,GAAO,MAAM,EACX,KAGpB,SAAgB,EAA8B,CAC5C,cACA,qBACA,uBACA,iBACA,oBACwD,CACxD,IAAM,EAA6B,EACjC,GAAsB,EACvB,CACK,EACJ,EAA0B,EAAqB,CAC3C,EAAyB,EAC7B,GAAkB,EACnB,CAED,MAAO,CACL,aAAc,GAAe,KAC7B,qBAAsB,EACtB,uBAAwB,EACxB,gBAAiB,EACjB,GAAI,EAAmB,CAAE,kBAAmB,EAAkB,CAAG,EAAE,CACpE,CAGH,SAAgB,EACd,EAA6C,KACpB,CACzB,MAAO,CACL,cAAe,EAA0B,GAAS,OAAO,CACzD,iBAAkB,EAA0B,GAAS,MAAM,CAC3D,aAAc,EAA0B,GAAS,MAAM,CACxD"}

package/dist/services/telemetry-context.d.ts

@@ -0,0 +1,17 @@
+import type { BackendKind } from "#/api/backend-registry/types";
+export declare const UNKNOWN_TELEMETRY_VERSION = "unknown";
+export type BackendConnectionMethod = "manual" | "cloud_login";
+export interface CloudTelemetryContextInput {
+    userId?: string | null;
+    email?: string | null;
+    orgId?: string | null;
+}
+export interface BackendTelemetryContextInput {
+    backendKind?: BackendKind | null;
+    agentServerVersion?: string | null;
+    automationSdkVersion?: string | null;
+    backendVersion?: string | null;
+    connectionMethod?: BackendConnectionMethod;
+}
+export declare function getBackendTelemetryProperties({ backendKind, agentServerVersion, automationSdkVersion, backendVersion, connectionMethod, }: BackendTelemetryContextInput): Record<string, unknown>;
+export declare function getCloudTelemetryProperties(context?: CloudTelemetryContextInput | null): Record<string, unknown>;

package/dist/services/telemetry-context.js

@@ -0,0 +1,27 @@
+function e(e) {
+	return e?.trim() || "unknown";
+}
+function t(e) {
+	return e?.trim() || null;
+}
+function n({ backendKind: t, agentServerVersion: n, automationSdkVersion: r, backendVersion: i, connectionMethod: a }) {
+	let o = e(n ?? i), s = e(r), c = e(i ?? n);
+	return {
+		backend_kind: t ?? null,
+		agent_server_version: o,
+		automation_sdk_version: s,
+		backend_version: c,
+		...a ? { connection_method: a } : {}
+	};
+}
+function r(e = null) {
+	return {
+		cloud_user_id: t(e?.userId),
+		cloud_user_email: t(e?.email),
+		cloud_org_id: t(e?.orgId)
+	};
+}
+//#endregion
+export { n as getBackendTelemetryProperties, r as getCloudTelemetryProperties };
+
+//# sourceMappingURL=telemetry-context.js.map

package/dist/services/telemetry-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-context.js","names":[],"sources":["../../src/services/telemetry-context.ts"],"sourcesContent":["import type { BackendKind } from \"#/api/backend-registry/types\";\n\nexport const UNKNOWN_TELEMETRY_VERSION = \"unknown\";\n\nexport type BackendConnectionMethod = \"manual\" | \"cloud_login\";\n\nexport interface CloudTelemetryContextInput {\n  userId?: string | null;\n  email?: string | null;\n  orgId?: string | null;\n}\n\nexport interface BackendTelemetryContextInput {\n  backendKind?: BackendKind | null;\n  agentServerVersion?: string | null;\n  automationSdkVersion?: string | null;\n  backendVersion?: string | null;\n  connectionMethod?: BackendConnectionMethod;\n}\n\nfunction normalizeTelemetryVersion(version: string | null | undefined): string {\n  const trimmed = version?.trim();\n  return trimmed || UNKNOWN_TELEMETRY_VERSION;\n}\n\nfunction normalizeOptionalProperty(\n  value: string | null | undefined,\n): string | null {\n  const trimmed = value?.trim();\n  return trimmed || null;\n}\n\nexport function getBackendTelemetryProperties({\n  backendKind,\n  agentServerVersion,\n  automationSdkVersion,\n  backendVersion,\n  connectionMethod,\n}: BackendTelemetryContextInput): Record<string, unknown> {\n  const resolvedAgentServerVersion = normalizeTelemetryVersion(\n    agentServerVersion ?? backendVersion,\n  );\n  const resolvedAutomationSdkVersion =\n    normalizeTelemetryVersion(automationSdkVersion);\n  const resolvedBackendVersion = normalizeTelemetryVersion(\n    backendVersion ?? agentServerVersion,\n  );\n\n  return {\n    backend_kind: backendKind ?? null,\n    agent_server_version: resolvedAgentServerVersion,\n    automation_sdk_version: resolvedAutomationSdkVersion,\n    backend_version: resolvedBackendVersion,\n    ...(connectionMethod ? { connection_method: connectionMethod } : {}),\n  };\n}\n\nexport function getCloudTelemetryProperties(\n  context: CloudTelemetryContextInput | null = null,\n): Record<string, unknown> {\n  return {\n    cloud_user_id: normalizeOptionalProperty(context?.userId),\n    cloud_user_email: normalizeOptionalProperty(context?.email),\n    cloud_org_id: normalizeOptionalProperty(context?.orgId),\n  };\n}\n"],"mappings":"AAoBA,SAAS,EAA0B,GAA4C;AAE7E,QADgB,GAAS,MAAM,IAAA;;AAIjC,SAAS,EACP,GACe;AAEf,QADgB,GAAO,MAAM,IACX;;AAGpB,SAAgB,EAA8B,EAC5C,gBACA,uBACA,yBACA,mBACA,uBACwD;CACxD,IAAM,IAA6B,EACjC,KAAsB,EACvB,EACK,IACJ,EAA0B,EAAqB,EAC3C,IAAyB,EAC7B,KAAkB,EACnB;AAED,QAAO;EACL,cAAc,KAAe;EAC7B,sBAAsB;EACtB,wBAAwB;EACxB,iBAAiB;EACjB,GAAI,IAAmB,EAAE,mBAAmB,GAAkB,GAAG,EAAE;EACpE;;AAGH,SAAgB,EACd,IAA6C,MACpB;AACzB,QAAO;EACL,eAAe,EAA0B,GAAS,OAAO;EACzD,kBAAkB,EAA0B,GAAS,MAAM;EAC3D,cAAc,EAA0B,GAAS,MAAM;EACxD"}

package/dist/services/telemetry.cjs

@@ -1,2 +1,2 @@
-require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../package.cjs`),t=require(`../api/client-source.cjs`);var n=`openhands-telemetry-consent`,r=`openhands-telemetry-consent-pending-cloud-sync`,i=`openhands-telemetry-consent-change`,a=`openhands-telemetry-first-use`,o=`openhands-telemetry-session`,s=`agent-canvas`,c=`phc_BgzfxKdgsYMLFTmJqt424ZoyVHvKFfrwttLimzdYTKFK`,l=`https://z.openhands.dev`,u=`https://us.posthog.com`,d=null,f=null,p,m={},h=!1,g,_=0,v=-1,y=Object.freeze({client_source:t.AGENT_CANVAS_CLIENT_SOURCE,client_version:t.AGENT_CANVAS_CLIENT_VERSION,package_name:e.default.name,package_version:e.default.version});function b(e){return e?{...e,properties:{...e.properties,...y}}:null}function x(e){h||j()!==`granted`?e.opt_out_capturing():e.opt_in_capturing()}function S(e,t=!1){e.reset(t),v=-1,x(e)}function C(e){if(g===void 0||!L())return;let t=g?.distinctId,n=e.get_property(`$user_id`);if(n!=null&&n!==t&&S(e),g===null){v=_;return}(e.get_property(`$user_id`)!==g.distinctId||v!==_)&&(e.identify(g.distinctId,g.properties),v=_)}function w(e){if(e===!1){if(h)return;h=!0,d?.opt_out_capturing(),N();return}let t=h;if(h=!1,!d&&!f){let t=Object.fromEntries(Object.entries(e).filter(([,e])=>e!==void 0));m={...m,...t}}t&&(d&&(x(d),C(d)),N())}function T(){return h?null:{apiKey:m.apiKey||c,apiHost:m.apiHost||l,uiHost:m.uiHost||u}}function E(){return typeof window<`u`&&typeof localStorage<`u`}async function D(){if(!E())return null;if(d)return d;try{let{default:e}=await Promise.resolve().then(()=>require(`../node_modules/posthog-js/dist/module.cjs`));return e}catch{return null}}function O(){return!!(h||typeof process<`u`&&process.env?.DO_NOT_TRACK===`1`||typeof navigator<`u`&&(navigator.doNotTrack===`1`||typeof window<`u`&&window.doNotTrack===`1`))}function k(e){d||(p=e)}async function A(e=!1){if(d)return d;if(f)return f;f=(async()=>{let t=T();if(!t)return null;let n=await D();if(!n)return null;let r=n.init(t.apiKey,{api_host:t.apiHost,ui_host:t.uiHost,opt_out_capturing_by_default:!e,capture_pageview:!1,autocapture:!1,persistence:`localStorage`,persistence_name:s,consent_persistence_name:`${s}-consent`,person_profiles:`identified_only`,disable_session_recording:!0,bootstrap:p,before_send:b},s);return r?(d=r,p=void 0,h?d.opt_out_capturing():j()===`granted`?(d.opt_in_capturing(),C(d)):e||d.opt_out_capturing(),d):null})();try{return await f}finally{d||(f=null)}}function j(){if(!E())return`pending`;if(O())return`denied`;try{let e=localStorage.getItem(n);if(e===`granted`||e===`denied`)return e}catch{}return`pending`}function M(e){if(!E())return()=>{};let t=t=>{(t.key===n||t.key===r)&&e()};return window.addEventListener(i,e),window.addEventListener(`storage`,t),()=>{window.removeEventListener(i,e),window.removeEventListener(`storage`,t)}}function N(){E()&&window.dispatchEvent(new Event(i))}function P(e){if(E())try{localStorage.setItem(r,e)}catch{}}function F(e){if(E())try{if(e!==void 0&&localStorage.getItem(r)!==e)return;localStorage.removeItem(r),N()}catch{}}async function I(e,{syncToCloud:t=!0}={}){if(E())try{if(localStorage.setItem(n,e),h)return;let t=d??await A();if(!t)return;e===`granted`?(t.opt_in_capturing(),C(t)):t.get_property(`$user_id`)==null?t.opt_out_capturing():S(t)}catch{}finally{t&&P(e),N()}}function L(){return j()===`granted`}function R(){if(!E())return!1;try{return localStorage.getItem(a)===`true`}catch{return!1}}function z(){if(E())try{localStorage.setItem(a,`true`)}catch{}}async function B(){if(O()||R())return;let e=await A(!0);!e||O()||((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}),z(),j()!==`granted`&&e.opt_out_capturing())}function V(){if(!E())return!1;try{return sessionStorage.getItem(o)===`true`}catch{return!1}}function H(){if(E())try{sessionStorage.setItem(o,`true`)}catch{}}async function U(){if(!L())return null;let e=await A();return!e||!L()?null:(e.has_opted_out_capturing?.()&&e.opt_in_capturing(),C(e),e)}async function W(){if(V())return;let e=await U();e&&(e.capture(`canvas_new_session`,{is_first_use:!R()}),H())}async function G(e,t={}){let n=await U();n&&n.capture(e,t)}async function K(e,t={}){let n=await U();n&&n.captureException(e,t)}async function q(){if(E()){try{localStorage.removeItem(n),localStorage.removeItem(a)}catch{}F();try{sessionStorage.removeItem(o)}catch{}g=null,_+=1,v=-1;try{d&&S(d,!0)}catch{try{d?.opt_out_capturing()}catch{}}}}exports.clearTelemetryData=q,exports.configurePostHogBootstrap=k,exports.configureTelemetry=w,exports.getTelemetryConsent=j,exports.initializePostHogClient=A,exports.isTelemetryEnabled=L,exports.setTelemetryConsent=I,exports.subscribeTelemetryConsent=M,exports.trackEvent=G,exports.trackException=K,exports.trackInstall=B,exports.trackSessionStart=W;
+require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../api/agent-server-config.cjs`),t=require(`../package.cjs`),n=require(`../api/client-source.cjs`),r=require(`./telemetry-context.cjs`);var i=`openhands-telemetry-consent`,a=`openhands-telemetry-consent-pending-cloud-sync`,o=`openhands-telemetry-consent-change`,s=`openhands-telemetry-first-use`,c=`openhands-telemetry-session`,l=`agent-canvas`,u=`phc_BgzfxKdgsYMLFTmJqt424ZoyVHvKFfrwttLimzdYTKFK`,d=`https://z.openhands.dev`,f=`https://us.posthog.com`,p=null,m=null,h,g={},_=!1,v=Object.freeze({client_source:n.AGENT_CANVAS_CLIENT_SOURCE,client_version:n.AGENT_CANVAS_CLIENT_VERSION,package_name:t.default.name,package_version:t.default.version}),y=r.getBackendTelemetryProperties({}),b=r.getCloudTelemetryProperties();function x(e){y=r.getBackendTelemetryProperties(e)}function S(e){return e?{...e,properties:{...y,...b,...e.properties,...v}}:null}function C(e){_||N()!==`granted`?e.opt_out_capturing():e.opt_in_capturing()}function w(e,t=!1){e.reset(t),C(e)}function T(e){e.get_property?.(`$user_id`)!=null&&w(e)}function E(e){if(e===!1){if(_)return;_=!0,p?.opt_out_capturing(),F();return}let t=_;if(_=!1,!p&&!m){let t=Object.fromEntries(Object.entries(e).filter(([,e])=>e!==void 0));g={...g,...t}}t&&(p&&C(p),F())}function D(){return _?null:{apiKey:g.apiKey||u,apiHost:g.apiHost||d,uiHost:g.uiHost||f}}function O(){return typeof window<`u`&&typeof localStorage<`u`}async function k(){if(!O())return null;if(p)return p;try{let{default:e}=await Promise.resolve().then(()=>require(`../node_modules/posthog-js/dist/module.cjs`));return e}catch{return null}}function A(){return!!(_||typeof process<`u`&&process.env?.DO_NOT_TRACK===`1`||typeof navigator<`u`&&(navigator.doNotTrack===`1`||typeof window<`u`&&window.doNotTrack===`1`))}function j(e){p||(h=e)}async function M(e=!1){if(p)return p;if(m)return m;m=(async()=>{let t=D();if(!t)return null;let n=await k();if(!n)return null;let r=h,i=n.init(t.apiKey,{api_host:t.apiHost,ui_host:t.uiHost,opt_out_capturing_by_default:!e,capture_pageview:!1,autocapture:!1,persistence:`localStorage`,persistence_name:l,consent_persistence_name:`${l}-consent`,person_profiles:`always`,disable_session_recording:!0,bootstrap:r,before_send:S},l);return i?(p=i,h=void 0,r||T(p),_?p.opt_out_capturing():N()===`granted`?p.opt_in_capturing():e||p.opt_out_capturing(),p):null})();try{return await m}finally{p||(m=null)}}function N(){if(!O())return`pending`;if(A())return`denied`;if(e.getLockedCloudAuthMode()===`cookie`)return`granted`;try{let e=localStorage.getItem(i);if(e===`granted`||e===`denied`)return e}catch{}return`pending`}function P(e){if(!O())return()=>{};let t=t=>{(t.key===i||t.key===a)&&e()};return window.addEventListener(o,e),window.addEventListener(`storage`,t),()=>{window.removeEventListener(o,e),window.removeEventListener(`storage`,t)}}function F(){O()&&window.dispatchEvent(new Event(o))}function I(e){if(O())try{localStorage.setItem(a,e)}catch{}}function L(e){if(O())try{if(e!==void 0&&localStorage.getItem(a)!==e)return;localStorage.removeItem(a),F()}catch{}}async function R(e,{syncToCloud:t=!0}={}){if(O())try{let t=N()===e;if(localStorage.setItem(i,e),_||t)return;let n=p??await M();if(!n)return;e===`granted`?n.opt_in_capturing():n.get_property?.(`$user_id`)==null?n.opt_out_capturing():w(n)}catch{}finally{t&&I(e),F()}}function z(){return N()===`granted`}function B(){if(!O())return!1;try{return localStorage.getItem(s)===`true`}catch{return!1}}function V(){if(O())try{localStorage.setItem(s,`true`)}catch{}}async function H(){if(A()||B())return;let e=await M(!0);!e||A()||((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}),V(),N()!==`granted`&&e.opt_out_capturing())}function U(){if(!O())return!1;try{return sessionStorage.getItem(c)===`true`}catch{return!1}}function W(){if(O())try{sessionStorage.setItem(c,`true`)}catch{}}async function G(){if(!z()||N()!==`granted`)return null;let e=await M();return!e||!z()?null:(e.has_opted_out_capturing?.()&&e.opt_in_capturing(),e)}async function K(){if(U())return;let e=await G();e&&(e.capture(`canvas_new_session`,{is_first_use:!B()}),W())}async function q(){return(await G())?.get_distinct_id?.()??null}async function J(){return!O()||_||A()?null:(await M())?.get_distinct_id?.()??null}async function Y(e,t={}){let n=await G();n&&n.capture(e,t)}async function X(e,t={}){let n=await G();n&&n.captureException(e,t)}async function Z(){if(O()){try{localStorage.removeItem(i),localStorage.removeItem(s)}catch{}L();try{sessionStorage.removeItem(c)}catch{}y=r.getBackendTelemetryProperties({}),b=r.getCloudTelemetryProperties();try{p&&w(p,!0)}catch{try{p?.opt_out_capturing()}catch{}}}}exports.clearTelemetryData=Z,exports.configurePostHogBootstrap=j,exports.configureTelemetry=E,exports.getTelemetryConsent=N,exports.getTelemetryDistinctId=q,exports.getTelemetryDistinctIdForConsentSync=J,exports.initializePostHogClient=M,exports.isTelemetryEnabled=z,exports.setTelemetryBackendContext=x,exports.setTelemetryConsent=R,exports.subscribeTelemetryConsent=P,exports.trackEvent=Y,exports.trackException=X,exports.trackInstall=H,exports.trackSessionStart=K;
 //# sourceMappingURL=telemetry.cjs.map

package/dist/services/telemetry.cjs.map

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

package/dist/services/telemetry.d.ts

@@ -26,6 +26,7 @@
  * - Browser's Do Not Track setting
  */
 import type { BootstrapConfig, PostHog } from "posthog-js";
+import { type BackendTelemetryContextInput, type CloudTelemetryContextInput } from "#/services/telemetry-context";
 export interface TelemetryConfig {
     /** PostHog project key. Useful for precompiled library consumers. */
     apiKey?: string;
@@ -41,6 +42,8 @@ export interface SetTelemetryConsentOptions {
     /** Do not persist a value mirrored from backend settings back to Cloud. */
     syncToCloud?: boolean;
 }
+export declare function setTelemetryBackendContext(context: BackendTelemetryContextInput): void;
+export declare function setTelemetryCloudContext(context: CloudTelemetryContextInput | null): void;
 /**
  * Configure the single Canvas telemetry client before its first use.
  * Passing false disables telemetry and install tracking for embedded hosts.
@@ -70,11 +73,6 @@ export declare function clearPendingCloudTelemetryConsent(expected?: ResolvedTel
  * Set user's telemetry consent preference
  */
 export declare function setTelemetryConsent(consent: ResolvedTelemetryConsent, { syncToCloud }?: SetTelemetryConsentOptions): Promise<void>;
-/**
- * Declare the current Cloud identity. The telemetry service applies it only
- * after consent and owns all reset/account-switch semantics.
- */
-export declare function setTelemetryIdentity(distinctId: string | null, properties?: Record<string, unknown>): Promise<void>;
 /**
  * Check if telemetry is enabled (user has granted consent)
  */
@@ -101,6 +99,10 @@ export declare function trackInstall(): Promise<void>;
  * Uses sessionStorage for deduplication - only sends once per browser session.
  */
 export declare function trackSessionStart(): Promise<void>;
+/** Return the active PostHog distinct ID when consent allows capture. */
+export declare function getTelemetryDistinctId(): Promise<string | null>;
+/** Return the PostHog distinct ID for local consent sync without emitting capture. */
+export declare function getTelemetryDistinctIdForConsentSync(): Promise<string | null>;
 /**
  * Track a custom event (respects consent).
  */