@openhands/agent-canvas 1.4.0 → 1.5.1

package/dist/hooks/use-device-flow.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-device-flow.js","names":[],"sources":["../../src/hooks/use-device-flow.ts"],"sourcesContent":["import React from \"react\";\nimport {\n  startDeviceFlow,\n  pollForToken,\n  DeviceFlowError,\n  type DeviceAuthorizationResponse,\n} from \"#/api/device-flow-client\";\n\nexport type DeviceFlowStatus =\n  | \"idle\"\n  | \"starting\"\n  | \"awaiting_authorization\"\n  | \"success\"\n  | \"error\";\n\nexport interface DeviceFlowState {\n  status: DeviceFlowStatus;\n  /** The verification URL to show/open for the user */\n  verificationUrl: string | null;\n  /** User code to display as fallback */\n  userCode: string | null;\n  /** The resulting API key on success */\n  apiKey: string | null;\n  /** Error message if status is \"error\" */\n  error: string | null;\n  /** Error code for programmatic handling */\n  errorCode: string | null;\n}\n\nexport interface UseDeviceFlowReturn extends DeviceFlowState {\n  /** Start the device flow authentication */\n  start: (host: string) => void;\n  /** Cancel an in-progress flow */\n  cancel: () => void;\n  /** Reset state back to idle */\n  reset: () => void;\n}\n\nconst initialState: DeviceFlowState = {\n  status: \"idle\",\n  verificationUrl: null,\n  userCode: null,\n  apiKey: null,\n  error: null,\n  errorCode: null,\n};\n\n/**\n * React hook for managing OAuth 2.0 Device Flow authentication.\n *\n * Usage:\n * ```tsx\n * const { status, verificationUrl, apiKey, error, start, cancel, reset } = useDeviceFlow();\n *\n * // Start auth\n * start(\"https://app.all-hands.dev\");\n *\n * // Open browser when awaiting\n * if (status === \"awaiting_authorization\" && verificationUrl) {\n *   window.open(verificationUrl, \"_blank\");\n * }\n *\n * // Use API key on success\n * if (status === \"success\" && apiKey) {\n *   setApiKeyField(apiKey);\n * }\n * ```\n */\nexport function useDeviceFlow(): UseDeviceFlowReturn {\n  const [state, setState] = React.useState<DeviceFlowState>(initialState);\n  const abortControllerRef = React.useRef<AbortController | null>(null);\n\n  const start = React.useCallback((host: string) => {\n    // Cancel any existing flow\n    abortControllerRef.current?.abort();\n    const abortController = new AbortController();\n    abortControllerRef.current = abortController;\n\n    setState({\n      ...initialState,\n      status: \"starting\",\n    });\n\n    (async () => {\n      let authResponse: DeviceAuthorizationResponse;\n\n      try {\n        authResponse = await startDeviceFlow(host);\n      } catch (error) {\n        if (abortController.signal.aborted) return;\n\n        const message =\n          error instanceof Error\n            ? error.message\n            : \"Failed to start device flow\";\n        const code = error instanceof DeviceFlowError ? error.code : undefined;\n\n        setState({\n          ...initialState,\n          status: \"error\",\n          error: message,\n          errorCode: code ?? null,\n        });\n        return;\n      }\n\n      if (abortController.signal.aborted) return;\n\n      setState({\n        ...initialState,\n        status: \"awaiting_authorization\",\n        verificationUrl: authResponse.verification_uri_complete,\n        userCode: authResponse.user_code,\n      });\n\n      try {\n        const tokenResponse = await pollForToken(\n          host,\n          authResponse.device_code,\n          {\n            interval: authResponse.interval,\n            signal: abortController.signal,\n          },\n        );\n\n        if (abortController.signal.aborted) return;\n\n        setState({\n          ...initialState,\n          status: \"success\",\n          apiKey: tokenResponse.access_token,\n        });\n      } catch (error) {\n        // Early return if component unmounted or user cancelled\n        if (abortController.signal.aborted) return;\n\n        // Defensive: handle cancellation errors that may slip through\n        // (currently pollForToken only throws \"cancelled\" when signal.aborted,\n        // which is caught above, but this guards against future changes)\n        const isCancel =\n          error instanceof DeviceFlowError && error.code === \"cancelled\";\n        if (isCancel) {\n          setState(initialState);\n          return;\n        }\n\n        const message =\n          error instanceof Error ? error.message : \"Authorization failed\";\n        const code = error instanceof DeviceFlowError ? error.code : undefined;\n\n        setState({\n          ...initialState,\n          status: \"error\",\n          error: message,\n          errorCode: code ?? null,\n        });\n      }\n    })();\n  }, []);\n\n  const cancel = React.useCallback(() => {\n    abortControllerRef.current?.abort();\n    abortControllerRef.current = null;\n    setState(initialState);\n  }, []);\n\n  const reset = React.useCallback(() => {\n    abortControllerRef.current?.abort();\n    abortControllerRef.current = null;\n    setState(initialState);\n  }, []);\n\n  // Cleanup on unmount\n  React.useEffect(() => {\n    return () => {\n      abortControllerRef.current?.abort();\n    };\n  }, []);\n\n  return {\n    ...state,\n    start,\n    cancel,\n    reset,\n  };\n}\n"],"mappings":";;;AAsCA,IAAM,IAAgC;CACpC,QAAQ;CACR,iBAAiB;CACjB,UAAU;CACV,QAAQ;CACR,OAAO;CACP,WAAW;CACZ;AAuBD,SAAgB,IAAqC;CACnD,IAAM,CAAC,GAAO,KAAY,EAAM,SAA0B,EAAa,EACjE,IAAqB,EAAM,OAA+B,KAAK,EAE/D,IAAQ,EAAM,aAAa,MAAiB;AAEhD,IAAmB,SAAS,OAAO;EACnC,IAAM,IAAkB,IAAI,iBAAiB;AAQ7C,EAPA,EAAmB,UAAU,GAE7B,EAAS;GACP,GAAG;GACH,QAAQ;GACT,CAAC,GAED,YAAY;GACX,IAAI;AAEJ,OAAI;AACF,QAAe,MAAM,EAAgB,EAAK;YACnC,GAAO;AACd,QAAI,EAAgB,OAAO,QAAS;IAEpC,IAAM,IACJ,aAAiB,QACb,EAAM,UACN,+BACA,IAAO,aAAiB,IAAkB,EAAM,OAAO,KAAA;AAE7D,MAAS;KACP,GAAG;KACH,QAAQ;KACR,OAAO;KACP,WAAW,KAAQ;KACpB,CAAC;AACF;;AAGE,UAAgB,OAAO,SAE3B;MAAS;KACP,GAAG;KACH,QAAQ;KACR,iBAAiB,EAAa;KAC9B,UAAU,EAAa;KACxB,CAAC;AAEF,QAAI;KACF,IAAM,IAAgB,MAAM,EAC1B,GACA,EAAa,aACb;MACE,UAAU,EAAa;MACvB,QAAQ,EAAgB;MACzB,CACF;AAED,SAAI,EAAgB,OAAO,QAAS;AAEpC,OAAS;MACP,GAAG;MACH,QAAQ;MACR,QAAQ,EAAc;MACvB,CAAC;aACK,GAAO;AAEd,SAAI,EAAgB,OAAO,QAAS;AAOpC,SADE,aAAiB,KAAmB,EAAM,SAAS,aACvC;AACZ,QAAS,EAAa;AACtB;;KAGF,IAAM,IACJ,aAAiB,QAAQ,EAAM,UAAU,wBACrC,IAAO,aAAiB,IAAkB,EAAM,OAAO,KAAA;AAE7D,OAAS;MACP,GAAG;MACH,QAAQ;MACR,OAAO;MACP,WAAW,KAAQ;MACpB,CAAC;;;MAEF;IACH,EAAE,CAAC,EAEA,IAAS,EAAM,kBAAkB;AAGrC,EAFA,EAAmB,SAAS,OAAO,EACnC,EAAmB,UAAU,MAC7B,EAAS,EAAa;IACrB,EAAE,CAAC,EAEA,IAAQ,EAAM,kBAAkB;AAGpC,EAFA,EAAmB,SAAS,OAAO,EACnC,EAAmB,UAAU,MAC7B,EAAS,EAAa;IACrB,EAAE,CAAC;AASN,QANA,EAAM,sBACS;AACX,IAAmB,SAAS,OAAO;IAEpC,EAAE,CAAC,EAEC;EACL,GAAG;EACH;EACA;EACA;EACD"}
+{"version":3,"file":"use-device-flow.js","names":[],"sources":["../../src/hooks/use-device-flow.ts"],"sourcesContent":["import React from \"react\";\nimport {\n  startDeviceFlow,\n  pollForToken,\n  DeviceFlowError,\n  type DeviceAuthorizationResponse,\n} from \"#/api/device-flow-client\";\nimport {\n  trackCloudDeviceAuthorizationStarted,\n  trackCloudDeviceAuthorizationSucceeded,\n  type CloudConnectionSource,\n} from \"#/services/cloud-funnel-analytics\";\n\nexport type DeviceFlowStatus =\n  | \"idle\"\n  | \"starting\"\n  | \"awaiting_authorization\"\n  | \"success\"\n  | \"error\";\n\nexport interface DeviceFlowState {\n  status: DeviceFlowStatus;\n  /** The verification URL to show/open for the user */\n  verificationUrl: string | null;\n  /** User code to display as fallback */\n  userCode: string | null;\n  /** The resulting API key on success */\n  apiKey: string | null;\n  /** Error message if status is \"error\" */\n  error: string | null;\n  /** Error code for programmatic handling */\n  errorCode: string | null;\n}\n\nexport interface UseDeviceFlowReturn extends DeviceFlowState {\n  /** Start the device flow authentication */\n  start: StartDeviceFlow;\n  /** Cancel an in-progress flow */\n  cancel: () => void;\n  /** Reset state back to idle */\n  reset: () => void;\n}\n\ntype StartDeviceFlow = (\n  host: string,\n  analyticsSource?: CloudConnectionSource,\n) => void;\n\nconst initialState: DeviceFlowState = {\n  status: \"idle\",\n  verificationUrl: null,\n  userCode: null,\n  apiKey: null,\n  error: null,\n  errorCode: null,\n};\n\n/**\n * React hook for managing OAuth 2.0 Device Flow authentication.\n *\n * Usage:\n * ```tsx\n * const { status, verificationUrl, apiKey, error, start, cancel, reset } = useDeviceFlow();\n *\n * // Start auth\n * start(\"https://app.all-hands.dev\");\n *\n * // Open browser when awaiting\n * if (status === \"awaiting_authorization\" && verificationUrl) {\n *   window.open(verificationUrl, \"_blank\");\n * }\n *\n * // Use API key on success\n * if (status === \"success\" && apiKey) {\n *   setApiKeyField(apiKey);\n * }\n * ```\n */\nexport function useDeviceFlow(): UseDeviceFlowReturn {\n  const [state, setState] = React.useState<DeviceFlowState>(initialState);\n  const abortControllerRef = React.useRef<AbortController | null>(null);\n\n  const start: StartDeviceFlow = React.useCallback((host, analyticsSource) => {\n    // Cancel any existing flow\n    abortControllerRef.current?.abort();\n    const abortController = new AbortController();\n    abortControllerRef.current = abortController;\n\n    setState({\n      ...initialState,\n      status: \"starting\",\n    });\n\n    (async () => {\n      let authResponse: DeviceAuthorizationResponse;\n\n      try {\n        authResponse = await startDeviceFlow(host);\n      } catch (error) {\n        if (abortController.signal.aborted) return;\n\n        const message =\n          error instanceof Error\n            ? error.message\n            : \"Failed to start device flow\";\n        const code = error instanceof DeviceFlowError ? error.code : undefined;\n\n        setState({\n          ...initialState,\n          status: \"error\",\n          error: message,\n          errorCode: code ?? null,\n        });\n        return;\n      }\n\n      if (abortController.signal.aborted) return;\n\n      trackCloudDeviceAuthorizationStarted(host, analyticsSource);\n\n      setState({\n        ...initialState,\n        status: \"awaiting_authorization\",\n        verificationUrl: authResponse.verification_uri_complete,\n        userCode: authResponse.user_code,\n      });\n\n      try {\n        const tokenResponse = await pollForToken(\n          host,\n          authResponse.device_code,\n          {\n            interval: authResponse.interval,\n            signal: abortController.signal,\n          },\n        );\n\n        if (abortController.signal.aborted) return;\n\n        trackCloudDeviceAuthorizationSucceeded(host, analyticsSource);\n\n        setState({\n          ...initialState,\n          status: \"success\",\n          apiKey: tokenResponse.access_token,\n        });\n      } catch (error) {\n        // Early return if component unmounted or user cancelled\n        if (abortController.signal.aborted) return;\n\n        // Defensive: handle cancellation errors that may slip through\n        // (currently pollForToken only throws \"cancelled\" when signal.aborted,\n        // which is caught above, but this guards against future changes)\n        const isCancel =\n          error instanceof DeviceFlowError && error.code === \"cancelled\";\n        if (isCancel) {\n          setState(initialState);\n          return;\n        }\n\n        const message =\n          error instanceof Error ? error.message : \"Authorization failed\";\n        const code = error instanceof DeviceFlowError ? error.code : undefined;\n\n        setState({\n          ...initialState,\n          status: \"error\",\n          error: message,\n          errorCode: code ?? null,\n        });\n      }\n    })();\n  }, []);\n\n  const cancel = React.useCallback(() => {\n    abortControllerRef.current?.abort();\n    abortControllerRef.current = null;\n    setState(initialState);\n  }, []);\n\n  const reset = React.useCallback(() => {\n    abortControllerRef.current?.abort();\n    abortControllerRef.current = null;\n    setState(initialState);\n  }, []);\n\n  // Cleanup on unmount\n  React.useEffect(() => {\n    return () => {\n      abortControllerRef.current?.abort();\n    };\n  }, []);\n\n  return {\n    ...state,\n    start,\n    cancel,\n    reset,\n  };\n}\n"],"mappings":";;;;;AAgDA,IAAM,IAAgC;CACpC,QAAQ;CACR,iBAAiB;CACjB,UAAU;CACV,QAAQ;CACR,OAAO;CACP,WAAW;CACZ;AAuBD,SAAgB,IAAqC;CACnD,IAAM,CAAC,GAAO,KAAY,EAAM,SAA0B,EAAa,EACjE,IAAqB,EAAM,OAA+B,KAAK,EAE/D,IAAyB,EAAM,aAAa,GAAM,MAAoB;AAE1E,IAAmB,SAAS,OAAO;EACnC,IAAM,IAAkB,IAAI,iBAAiB;AAQ7C,EAPA,EAAmB,UAAU,GAE7B,EAAS;GACP,GAAG;GACH,QAAQ;GACT,CAAC,GAED,YAAY;GACX,IAAI;AAEJ,OAAI;AACF,QAAe,MAAM,EAAgB,EAAK;YACnC,GAAO;AACd,QAAI,EAAgB,OAAO,QAAS;IAEpC,IAAM,IACJ,aAAiB,QACb,EAAM,UACN,+BACA,IAAO,aAAiB,IAAkB,EAAM,OAAO,KAAA;AAE7D,MAAS;KACP,GAAG;KACH,QAAQ;KACR,OAAO;KACP,WAAW,KAAQ;KACpB,CAAC;AACF;;AAGE,UAAgB,OAAO,SAI3B;IAFA,EAAqC,GAAM,EAAgB,EAE3D,EAAS;KACP,GAAG;KACH,QAAQ;KACR,iBAAiB,EAAa;KAC9B,UAAU,EAAa;KACxB,CAAC;AAEF,QAAI;KACF,IAAM,IAAgB,MAAM,EAC1B,GACA,EAAa,aACb;MACE,UAAU,EAAa;MACvB,QAAQ,EAAgB;MACzB,CACF;AAED,SAAI,EAAgB,OAAO,QAAS;AAIpC,KAFA,EAAuC,GAAM,EAAgB,EAE7D,EAAS;MACP,GAAG;MACH,QAAQ;MACR,QAAQ,EAAc;MACvB,CAAC;aACK,GAAO;AAEd,SAAI,EAAgB,OAAO,QAAS;AAOpC,SADE,aAAiB,KAAmB,EAAM,SAAS,aACvC;AACZ,QAAS,EAAa;AACtB;;KAGF,IAAM,IACJ,aAAiB,QAAQ,EAAM,UAAU,wBACrC,IAAO,aAAiB,IAAkB,EAAM,OAAO,KAAA;AAE7D,OAAS;MACP,GAAG;MACH,QAAQ;MACR,OAAO;MACP,WAAW,KAAQ;MACpB,CAAC;;;MAEF;IACH,EAAE,CAAC,EAEA,IAAS,EAAM,kBAAkB;AAGrC,EAFA,EAAmB,SAAS,OAAO,EACnC,EAAmB,UAAU,MAC7B,EAAS,EAAa;IACrB,EAAE,CAAC,EAEA,IAAQ,EAAM,kBAAkB;AAGpC,EAFA,EAAmB,SAAS,OAAO,EACnC,EAAmB,UAAU,MAC7B,EAAS,EAAa;IACrB,EAAE,CAAC;AASN,QANA,EAAM,sBACS;AACX,IAAmB,SAAS,OAAO;IAEpC,EAAE,CAAC,EAEC;EACL,GAAG;EACH;EACA;EACA;EACD"}

package/dist/hooks/use-telemetry.cjs

@@ -1,2 +1,2 @@
-require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../services/telemetry.cjs`);let t=require(`react`);function n(){let[n,r]=(0,t.useState)(()=>e.getTelemetryConsent()),i=(0,t.useRef)(!1);(0,t.useEffect)(()=>{i.current||(i.current=!0,e.trackInstall())},[]),(0,t.useEffect)(()=>{n===`granted`&&e.trackSessionStart()},[n]);let a=(0,t.useCallback)(async()=>{await e.setTelemetryConsent(`granted`),r(`granted`)},[]),o=(0,t.useCallback)(async()=>{await e.setTelemetryConsent(`denied`),r(`denied`)},[]),s=(0,t.useCallback)((t,r)=>{n===`granted`&&e.trackEvent(t,r)},[n]),c=(0,t.useCallback)(()=>{e.clearTelemetryData(),r(`pending`)},[]);return{consent:n,isEnabled:n===`granted`,showConsentPrompt:n===`pending`,grantConsent:a,denyConsent:o,track:s,clearData:c}}exports.useTelemetry=n;
+require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../services/telemetry.cjs`);let t=require(`react`);function n(){let n=(0,t.useSyncExternalStore)(e.subscribeTelemetryConsent,e.getTelemetryConsent,()=>`pending`),r=(0,t.useRef)(!1);(0,t.useEffect)(()=>{r.current||(r.current=!0,e.trackInstall())},[]),(0,t.useEffect)(()=>{n===`granted`&&e.trackSessionStart()},[n]);let i=(0,t.useCallback)(()=>e.setTelemetryConsent(`granted`),[]),a=(0,t.useCallback)(()=>e.setTelemetryConsent(`denied`),[]),o=(0,t.useCallback)((t,n)=>{e.trackEvent(t,n)},[]),s=(0,t.useCallback)(()=>e.clearTelemetryData(),[]);return{consent:n,isEnabled:n===`granted`,showConsentPrompt:n===`pending`,grantConsent:i,denyConsent:a,track:o,clearData:s}}exports.useTelemetry=n;
 //# sourceMappingURL=use-telemetry.cjs.map

package/dist/hooks/use-telemetry.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-telemetry.cjs","names":[],"sources":["../../src/hooks/use-telemetry.ts"],"sourcesContent":["import { useEffect, useState, useCallback, useRef } from \"react\";\nimport {\n  getTelemetryConsent,\n  setTelemetryConsent,\n  trackInstall,\n  trackSessionStart,\n  trackEvent,\n  clearTelemetryData,\n  type TelemetryConsent,\n} from \"#/services/telemetry\";\n\nexport interface UseTelemetryReturn {\n  /** Current consent status */\n  consent: TelemetryConsent;\n  /** Whether telemetry is enabled (consent granted) */\n  isEnabled: boolean;\n  /** Whether consent prompt should be shown */\n  showConsentPrompt: boolean;\n  /** Grant consent and enable telemetry */\n  grantConsent: () => void;\n  /** Deny consent and disable telemetry */\n  denyConsent: () => void;\n  /** Track a custom event (only if consent granted) */\n  track: (eventName: string, properties?: Record<string, unknown>) => void;\n  /** Clear all telemetry data */\n  clearData: () => void;\n}\n\n/**\n * Hook for managing telemetry consent and tracking.\n *\n * TRACKING BEHAVIOR:\n * - Install event: Sent immediately on first mount, regardless of consent status.\n *   This is anonymous and allows us to track library adoption.\n * - Session/custom events: Only sent after user grants consent.\n *\n * This hook handles:\n * - Sending install event immediately on first use\n * - Showing consent prompt for ongoing tracking\n * - Tracking session start when consent is granted\n * - Providing a simple API for tracking custom events\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { consent, showConsentPrompt, grantConsent, denyConsent, track } = useTelemetry();\n *\n *   useEffect(() => {\n *     track('component_mounted', { component: 'MyComponent' });\n *   }, [track]);\n *\n *   if (showConsentPrompt) {\n *     return <ConsentBanner onAccept={grantConsent} onDecline={denyConsent} />;\n *   }\n *\n *   return <div>...</div>;\n * }\n * ```\n */\nexport function useTelemetry(): UseTelemetryReturn {\n  const [consent, setConsentState] = useState<TelemetryConsent>(() =>\n    getTelemetryConsent(),\n  );\n\n  // Track install immediately on first mount (regardless of consent)\n  // This only fires once per installation due to localStorage deduplication\n  //\n  // PRIVACY NOTE: This sends an anonymous install event before the user grants consent.\n  // Data collected: browser platform, user agent, referrer, origin URL, embedded status.\n  // A random PostHog distinct_id is generated (not tied to user identity).\n  // Users can prevent this by setting VITE_DO_NOT_TRACK=1 or browser's DNT setting.\n  // This approach uses \"legitimate interest\" under GDPR Article 6(1)(f) for basic\n  // aggregate analytics. No cross-site tracking, no advertising, no user profiles.\n  const hasTrackedInstall = useRef(false);\n  useEffect(() => {\n    if (!hasTrackedInstall.current) {\n      hasTrackedInstall.current = true;\n      trackInstall();\n    }\n  }, []);\n\n  // Track session start when consent is granted\n  useEffect(() => {\n    if (consent === \"granted\") {\n      trackSessionStart();\n    }\n  }, [consent]);\n\n  const grantConsent = useCallback(async () => {\n    // Must await to ensure PostHog is initialized and opt_in_capturing() is called\n    // before the useEffect triggers tracking calls\n    await setTelemetryConsent(\"granted\");\n    setConsentState(\"granted\");\n  }, []);\n\n  const denyConsent = useCallback(async () => {\n    await setTelemetryConsent(\"denied\");\n    setConsentState(\"denied\");\n  }, []);\n\n  const track = useCallback(\n    (eventName: string, properties?: Record<string, unknown>) => {\n      if (consent === \"granted\") {\n        trackEvent(eventName, properties);\n      }\n    },\n    [consent],\n  );\n\n  const clearData = useCallback(() => {\n    clearTelemetryData();\n    setConsentState(\"pending\");\n  }, []);\n\n  return {\n    consent,\n    isEnabled: consent === \"granted\",\n    showConsentPrompt: consent === \"pending\",\n    grantConsent,\n    denyConsent,\n    track,\n    clearData,\n  };\n}\n"],"mappings":"iHA2DA,SAAgB,GAAmC,CACjD,GAAM,CAAC,EAAS,IAAA,EAAA,EAAA,cACd,EAAA,qBAAqB,CACtB,CAWK,GAAA,EAAA,EAAA,QAA2B,GAAM,EACvC,EAAA,EAAA,eAAgB,CACT,EAAkB,UACrB,EAAkB,QAAU,GAC5B,EAAA,cAAc,GAEf,EAAE,CAAC,EAGN,EAAA,EAAA,eAAgB,CACV,IAAY,WACd,EAAA,mBAAmB,EAEpB,CAAC,EAAQ,CAAC,CAEb,IAAM,GAAA,EAAA,EAAA,aAA2B,SAAY,CAG3C,MAAM,EAAA,oBAAoB,UAAU,CACpC,EAAgB,UAAU,EACzB,EAAE,CAAC,CAEA,GAAA,EAAA,EAAA,aAA0B,SAAY,CAC1C,MAAM,EAAA,oBAAoB,SAAS,CACnC,EAAgB,SAAS,EACxB,EAAE,CAAC,CAEA,GAAA,EAAA,EAAA,cACH,EAAmB,IAAyC,CACvD,IAAY,WACd,EAAA,WAAW,EAAW,EAAW,EAGrC,CAAC,EAAQ,CACV,CAEK,GAAA,EAAA,EAAA,iBAA8B,CAClC,EAAA,oBAAoB,CACpB,EAAgB,UAAU,EACzB,EAAE,CAAC,CAEN,MAAO,CACL,UACA,UAAW,IAAY,UACvB,kBAAmB,IAAY,UAC/B,eACA,cACA,QACA,YACD"}
+{"version":3,"file":"use-telemetry.cjs","names":[],"sources":["../../src/hooks/use-telemetry.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useSyncExternalStore } from \"react\";\nimport {\n  getTelemetryConsent,\n  setTelemetryConsent,\n  trackInstall,\n  trackSessionStart,\n  trackEvent,\n  clearTelemetryData,\n  subscribeTelemetryConsent,\n  type TelemetryConsent,\n} from \"#/services/telemetry\";\n\nexport interface UseTelemetryReturn {\n  /** Current consent status */\n  consent: TelemetryConsent;\n  /** Whether telemetry is enabled (consent granted) */\n  isEnabled: boolean;\n  /** Whether consent prompt should be shown */\n  showConsentPrompt: boolean;\n  /** Grant consent and enable telemetry */\n  grantConsent: () => Promise<void>;\n  /** Deny consent and disable telemetry */\n  denyConsent: () => Promise<void>;\n  /** Track a custom event (only if consent granted) */\n  track: (eventName: string, properties?: Record<string, unknown>) => void;\n  /** Clear all telemetry data */\n  clearData: () => Promise<void>;\n}\n\n/**\n * Hook for managing telemetry consent and tracking.\n *\n * TRACKING BEHAVIOR:\n * - Install event: Sent immediately on first mount, regardless of consent status.\n *   This is anonymous and allows us to track library adoption.\n * - Session/custom events: Only sent after user grants consent.\n *\n * This hook handles:\n * - Sending install event immediately on first use\n * - Showing consent prompt for ongoing tracking\n * - Tracking session start when consent is granted\n * - Providing a simple API for tracking custom events\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { consent, showConsentPrompt, grantConsent, denyConsent, track } = useTelemetry();\n *\n *   useEffect(() => {\n *     track('component_mounted', { component: 'MyComponent' });\n *   }, [track]);\n *\n *   if (showConsentPrompt) {\n *     return <ConsentBanner onAccept={grantConsent} onDecline={denyConsent} />;\n *   }\n *\n *   return <div>...</div>;\n * }\n * ```\n */\nexport function useTelemetry(): UseTelemetryReturn {\n  const consent = useSyncExternalStore<TelemetryConsent>(\n    subscribeTelemetryConsent,\n    getTelemetryConsent,\n    () => \"pending\",\n  );\n\n  // Track install immediately on first mount (regardless of consent)\n  // This only fires once per installation due to localStorage deduplication\n  //\n  // PRIVACY NOTE: This sends an anonymous install event before the user grants consent.\n  // Data collected: browser platform, user agent, referrer, origin URL, embedded status.\n  // A random PostHog distinct_id is generated (not tied to user identity).\n  // Users can prevent this by setting VITE_DO_NOT_TRACK=1 or browser's DNT setting.\n  // This approach uses \"legitimate interest\" under GDPR Article 6(1)(f) for basic\n  // aggregate analytics. No cross-site tracking, no advertising, no user profiles.\n  const hasTrackedInstall = useRef(false);\n  useEffect(() => {\n    if (!hasTrackedInstall.current) {\n      hasTrackedInstall.current = true;\n      void trackInstall();\n    }\n  }, []);\n\n  // Track session start when consent is granted\n  useEffect(() => {\n    if (consent === \"granted\") {\n      void trackSessionStart();\n    }\n  }, [consent]);\n\n  const grantConsent = useCallback(() => setTelemetryConsent(\"granted\"), []);\n\n  const denyConsent = useCallback(() => setTelemetryConsent(\"denied\"), []);\n\n  const track = useCallback(\n    (eventName: string, properties?: Record<string, unknown>) => {\n      void trackEvent(eventName, properties);\n    },\n    [],\n  );\n\n  const clearData = useCallback(() => clearTelemetryData(), []);\n\n  return {\n    consent,\n    isEnabled: consent === \"granted\",\n    showConsentPrompt: consent === \"pending\",\n    grantConsent,\n    denyConsent,\n    track,\n    clearData,\n  };\n}\n"],"mappings":"iHA4DA,SAAgB,GAAmC,CACjD,IAAM,GAAA,EAAA,EAAA,sBACJ,EAAA,0BACA,EAAA,wBACM,UACP,CAWK,GAAA,EAAA,EAAA,QAA2B,GAAM,EACvC,EAAA,EAAA,eAAgB,CACT,EAAkB,UACrB,EAAkB,QAAU,GACvB,EAAA,cAAc,GAEpB,EAAE,CAAC,EAGN,EAAA,EAAA,eAAgB,CACV,IAAY,WACT,EAAA,mBAAmB,EAEzB,CAAC,EAAQ,CAAC,CAEb,IAAM,GAAA,EAAA,EAAA,iBAAiC,EAAA,oBAAoB,UAAU,CAAE,EAAE,CAAC,CAEpE,GAAA,EAAA,EAAA,iBAAgC,EAAA,oBAAoB,SAAS,CAAE,EAAE,CAAC,CAElE,GAAA,EAAA,EAAA,cACH,EAAmB,IAAyC,CACtD,EAAA,WAAW,EAAW,EAAW,EAExC,EAAE,CACH,CAEK,GAAA,EAAA,EAAA,iBAA8B,EAAA,oBAAoB,CAAE,EAAE,CAAC,CAE7D,MAAO,CACL,UACA,UAAW,IAAY,UACvB,kBAAmB,IAAY,UAC/B,eACA,cACA,QACA,YACD"}

package/dist/hooks/use-telemetry.d.ts

@@ -7,13 +7,13 @@ export interface UseTelemetryReturn {
     /** Whether consent prompt should be shown */
     showConsentPrompt: boolean;
     /** Grant consent and enable telemetry */
-    grantConsent: () => void;
+    grantConsent: () => Promise<void>;
     /** Deny consent and disable telemetry */
-    denyConsent: () => void;
+    denyConsent: () => Promise<void>;
     /** Track a custom event (only if consent granted) */
     track: (eventName: string, properties?: Record<string, unknown>) => void;
     /** Clear all telemetry data */
-    clearData: () => void;
+    clearData: () => Promise<void>;
 }
 /**
  * Hook for managing telemetry consent and tracking.

package/dist/hooks/use-telemetry.js

@@ -1,26 +1,20 @@
-import { clearTelemetryData as e, getTelemetryConsent as t, setTelemetryConsent as n, trackEvent as r, trackInstall as i, trackSessionStart as a } from "../services/telemetry.js";
-import { useCallback as o, useEffect as s, useRef as c, useState as l } from "react";
+import { clearTelemetryData as e, getTelemetryConsent as t, setTelemetryConsent as n, subscribeTelemetryConsent as r, trackEvent as i, trackInstall as a, trackSessionStart as o } from "../services/telemetry.js";
+import { useCallback as s, useEffect as c, useRef as l, useSyncExternalStore as u } from "react";
 //#region src/hooks/use-telemetry.ts
-function u() {
-	let [u, d] = l(() => t()), f = c(!1);
-	s(() => {
-		f.current || (f.current = !0, i());
-	}, []), s(() => {
-		u === "granted" && a();
-	}, [u]);
-	let p = o(async () => {
-		await n("granted"), d("granted");
-	}, []), m = o(async () => {
-		await n("denied"), d("denied");
-	}, []), h = o((e, t) => {
-		u === "granted" && r(e, t);
-	}, [u]), g = o(() => {
-		e(), d("pending");
-	}, []);
+function d() {
+	let d = u(r, t, () => "pending"), f = l(!1);
+	c(() => {
+		f.current || (f.current = !0, a());
+	}, []), c(() => {
+		d === "granted" && o();
+	}, [d]);
+	let p = s(() => n("granted"), []), m = s(() => n("denied"), []), h = s((e, t) => {
+		i(e, t);
+	}, []), g = s(() => e(), []);
 	return {
-		consent: u,
-		isEnabled: u === "granted",
-		showConsentPrompt: u === "pending",
+		consent: d,
+		isEnabled: d === "granted",
+		showConsentPrompt: d === "pending",
 		grantConsent: p,
 		denyConsent: m,
 		track: h,
@@ -28,6 +22,6 @@ function u() {
 	};
 }
 //#endregion
-export { u as useTelemetry };
+export { d as useTelemetry };
 
 //# sourceMappingURL=use-telemetry.js.map

package/dist/hooks/use-telemetry.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-telemetry.js","names":[],"sources":["../../src/hooks/use-telemetry.ts"],"sourcesContent":["import { useEffect, useState, useCallback, useRef } from \"react\";\nimport {\n  getTelemetryConsent,\n  setTelemetryConsent,\n  trackInstall,\n  trackSessionStart,\n  trackEvent,\n  clearTelemetryData,\n  type TelemetryConsent,\n} from \"#/services/telemetry\";\n\nexport interface UseTelemetryReturn {\n  /** Current consent status */\n  consent: TelemetryConsent;\n  /** Whether telemetry is enabled (consent granted) */\n  isEnabled: boolean;\n  /** Whether consent prompt should be shown */\n  showConsentPrompt: boolean;\n  /** Grant consent and enable telemetry */\n  grantConsent: () => void;\n  /** Deny consent and disable telemetry */\n  denyConsent: () => void;\n  /** Track a custom event (only if consent granted) */\n  track: (eventName: string, properties?: Record<string, unknown>) => void;\n  /** Clear all telemetry data */\n  clearData: () => void;\n}\n\n/**\n * Hook for managing telemetry consent and tracking.\n *\n * TRACKING BEHAVIOR:\n * - Install event: Sent immediately on first mount, regardless of consent status.\n *   This is anonymous and allows us to track library adoption.\n * - Session/custom events: Only sent after user grants consent.\n *\n * This hook handles:\n * - Sending install event immediately on first use\n * - Showing consent prompt for ongoing tracking\n * - Tracking session start when consent is granted\n * - Providing a simple API for tracking custom events\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { consent, showConsentPrompt, grantConsent, denyConsent, track } = useTelemetry();\n *\n *   useEffect(() => {\n *     track('component_mounted', { component: 'MyComponent' });\n *   }, [track]);\n *\n *   if (showConsentPrompt) {\n *     return <ConsentBanner onAccept={grantConsent} onDecline={denyConsent} />;\n *   }\n *\n *   return <div>...</div>;\n * }\n * ```\n */\nexport function useTelemetry(): UseTelemetryReturn {\n  const [consent, setConsentState] = useState<TelemetryConsent>(() =>\n    getTelemetryConsent(),\n  );\n\n  // Track install immediately on first mount (regardless of consent)\n  // This only fires once per installation due to localStorage deduplication\n  //\n  // PRIVACY NOTE: This sends an anonymous install event before the user grants consent.\n  // Data collected: browser platform, user agent, referrer, origin URL, embedded status.\n  // A random PostHog distinct_id is generated (not tied to user identity).\n  // Users can prevent this by setting VITE_DO_NOT_TRACK=1 or browser's DNT setting.\n  // This approach uses \"legitimate interest\" under GDPR Article 6(1)(f) for basic\n  // aggregate analytics. No cross-site tracking, no advertising, no user profiles.\n  const hasTrackedInstall = useRef(false);\n  useEffect(() => {\n    if (!hasTrackedInstall.current) {\n      hasTrackedInstall.current = true;\n      trackInstall();\n    }\n  }, []);\n\n  // Track session start when consent is granted\n  useEffect(() => {\n    if (consent === \"granted\") {\n      trackSessionStart();\n    }\n  }, [consent]);\n\n  const grantConsent = useCallback(async () => {\n    // Must await to ensure PostHog is initialized and opt_in_capturing() is called\n    // before the useEffect triggers tracking calls\n    await setTelemetryConsent(\"granted\");\n    setConsentState(\"granted\");\n  }, []);\n\n  const denyConsent = useCallback(async () => {\n    await setTelemetryConsent(\"denied\");\n    setConsentState(\"denied\");\n  }, []);\n\n  const track = useCallback(\n    (eventName: string, properties?: Record<string, unknown>) => {\n      if (consent === \"granted\") {\n        trackEvent(eventName, properties);\n      }\n    },\n    [consent],\n  );\n\n  const clearData = useCallback(() => {\n    clearTelemetryData();\n    setConsentState(\"pending\");\n  }, []);\n\n  return {\n    consent,\n    isEnabled: consent === \"granted\",\n    showConsentPrompt: consent === \"pending\",\n    grantConsent,\n    denyConsent,\n    track,\n    clearData,\n  };\n}\n"],"mappings":";;;AA2DA,SAAgB,IAAmC;CACjD,IAAM,CAAC,GAAS,KAAmB,QACjC,GAAqB,CACtB,EAWK,IAAoB,EAAO,GAAM;AASvC,CARA,QAAgB;AACd,EAAK,EAAkB,YACrB,EAAkB,UAAU,IAC5B,GAAc;IAEf,EAAE,CAAC,EAGN,QAAgB;AACd,EAAI,MAAY,aACd,GAAmB;IAEpB,CAAC,EAAQ,CAAC;CAEb,IAAM,IAAe,EAAY,YAAY;AAI3C,EADA,MAAM,EAAoB,UAAU,EACpC,EAAgB,UAAU;IACzB,EAAE,CAAC,EAEA,IAAc,EAAY,YAAY;AAE1C,EADA,MAAM,EAAoB,SAAS,EACnC,EAAgB,SAAS;IACxB,EAAE,CAAC,EAEA,IAAQ,GACX,GAAmB,MAAyC;AAC3D,EAAI,MAAY,aACd,EAAW,GAAW,EAAW;IAGrC,CAAC,EAAQ,CACV,EAEK,IAAY,QAAkB;AAElC,EADA,GAAoB,EACpB,EAAgB,UAAU;IACzB,EAAE,CAAC;AAEN,QAAO;EACL;EACA,WAAW,MAAY;EACvB,mBAAmB,MAAY;EAC/B;EACA;EACA;EACA;EACD"}
+{"version":3,"file":"use-telemetry.js","names":[],"sources":["../../src/hooks/use-telemetry.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useSyncExternalStore } from \"react\";\nimport {\n  getTelemetryConsent,\n  setTelemetryConsent,\n  trackInstall,\n  trackSessionStart,\n  trackEvent,\n  clearTelemetryData,\n  subscribeTelemetryConsent,\n  type TelemetryConsent,\n} from \"#/services/telemetry\";\n\nexport interface UseTelemetryReturn {\n  /** Current consent status */\n  consent: TelemetryConsent;\n  /** Whether telemetry is enabled (consent granted) */\n  isEnabled: boolean;\n  /** Whether consent prompt should be shown */\n  showConsentPrompt: boolean;\n  /** Grant consent and enable telemetry */\n  grantConsent: () => Promise<void>;\n  /** Deny consent and disable telemetry */\n  denyConsent: () => Promise<void>;\n  /** Track a custom event (only if consent granted) */\n  track: (eventName: string, properties?: Record<string, unknown>) => void;\n  /** Clear all telemetry data */\n  clearData: () => Promise<void>;\n}\n\n/**\n * Hook for managing telemetry consent and tracking.\n *\n * TRACKING BEHAVIOR:\n * - Install event: Sent immediately on first mount, regardless of consent status.\n *   This is anonymous and allows us to track library adoption.\n * - Session/custom events: Only sent after user grants consent.\n *\n * This hook handles:\n * - Sending install event immediately on first use\n * - Showing consent prompt for ongoing tracking\n * - Tracking session start when consent is granted\n * - Providing a simple API for tracking custom events\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { consent, showConsentPrompt, grantConsent, denyConsent, track } = useTelemetry();\n *\n *   useEffect(() => {\n *     track('component_mounted', { component: 'MyComponent' });\n *   }, [track]);\n *\n *   if (showConsentPrompt) {\n *     return <ConsentBanner onAccept={grantConsent} onDecline={denyConsent} />;\n *   }\n *\n *   return <div>...</div>;\n * }\n * ```\n */\nexport function useTelemetry(): UseTelemetryReturn {\n  const consent = useSyncExternalStore<TelemetryConsent>(\n    subscribeTelemetryConsent,\n    getTelemetryConsent,\n    () => \"pending\",\n  );\n\n  // Track install immediately on first mount (regardless of consent)\n  // This only fires once per installation due to localStorage deduplication\n  //\n  // PRIVACY NOTE: This sends an anonymous install event before the user grants consent.\n  // Data collected: browser platform, user agent, referrer, origin URL, embedded status.\n  // A random PostHog distinct_id is generated (not tied to user identity).\n  // Users can prevent this by setting VITE_DO_NOT_TRACK=1 or browser's DNT setting.\n  // This approach uses \"legitimate interest\" under GDPR Article 6(1)(f) for basic\n  // aggregate analytics. No cross-site tracking, no advertising, no user profiles.\n  const hasTrackedInstall = useRef(false);\n  useEffect(() => {\n    if (!hasTrackedInstall.current) {\n      hasTrackedInstall.current = true;\n      void trackInstall();\n    }\n  }, []);\n\n  // Track session start when consent is granted\n  useEffect(() => {\n    if (consent === \"granted\") {\n      void trackSessionStart();\n    }\n  }, [consent]);\n\n  const grantConsent = useCallback(() => setTelemetryConsent(\"granted\"), []);\n\n  const denyConsent = useCallback(() => setTelemetryConsent(\"denied\"), []);\n\n  const track = useCallback(\n    (eventName: string, properties?: Record<string, unknown>) => {\n      void trackEvent(eventName, properties);\n    },\n    [],\n  );\n\n  const clearData = useCallback(() => clearTelemetryData(), []);\n\n  return {\n    consent,\n    isEnabled: consent === \"granted\",\n    showConsentPrompt: consent === \"pending\",\n    grantConsent,\n    denyConsent,\n    track,\n    clearData,\n  };\n}\n"],"mappings":";;;AA4DA,SAAgB,IAAmC;CACjD,IAAM,IAAU,EACd,GACA,SACM,UACP,EAWK,IAAoB,EAAO,GAAM;AASvC,CARA,QAAgB;AACd,EAAK,EAAkB,YACrB,EAAkB,UAAU,IACvB,GAAc;IAEpB,EAAE,CAAC,EAGN,QAAgB;AACd,EAAI,MAAY,aACT,GAAmB;IAEzB,CAAC,EAAQ,CAAC;CAEb,IAAM,IAAe,QAAkB,EAAoB,UAAU,EAAE,EAAE,CAAC,EAEpE,IAAc,QAAkB,EAAoB,SAAS,EAAE,EAAE,CAAC,EAElE,IAAQ,GACX,GAAmB,MAAyC;AACtD,IAAW,GAAW,EAAW;IAExC,EAAE,CACH,EAEK,IAAY,QAAkB,GAAoB,EAAE,EAAE,CAAC;AAE7D,QAAO;EACL;EACA,WAAW,MAAY;EACvB,mBAAmB,MAAY;EAC/B;EACA;EACA;EACA;EACD"}

package/dist/hooks/use-tracking.cjs

@@ -1,2 +1,2 @@
-require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../node_modules/posthog-js/react/dist/esm/index.cjs`),t=require(`./query/use-settings.cjs`);var n=()=>{let n=e.usePostHog(),{data:r}=t.useSettings(),i={current_url:window.location.href,user_email:r?.email||r?.git_user_email||null},a=(e,t={})=>{!n||r?.user_consents_to_analytics!==!0||n.capture(e,{...t,...i})};return{trackLoginButtonClick:({provider:e})=>{a(`login_button_clicked`,{provider:e})},trackConversationCreated:({conversationId:e,taskId:t,hasRepository:n,gitProvider:r,hasWorkspace:i,workspaceMode:o,hasInitialQuery:s,agentType:c,hasParentConversation:l,entryPoint:u})=>{a(`conversation_created`,{conversation_id:e,task_id:t,is_start_task:e.startsWith(`task-`),has_repository:n,git_provider:r,has_workspace:i,workspace_mode:o,has_initial_query:s,agent_type:c,has_parent_conversation:l,entry_point:u})},trackPushButtonClick:()=>{a(`push_button_clicked`)},trackPullButtonClick:()=>{a(`pull_button_clicked`)},trackCreatePrButtonClick:()=>{a(`create_pr_button_clicked`)},trackUserSignupCompleted:()=>{a(`user_signup_completed`,{signup_timestamp:new Date().toISOString()})},trackPrebuiltAutomationEnabled:({automationId:e,automationName:t,automationCategory:n})=>{a(`prebuilt_automation_enabled`,{automation_id:e,automation_name:t,automation_category:n})},trackInitialQuerySubmitted:({entryPoint:e,queryCharacterLength:t,replayJsonSize:n})=>{a(`initial_query_submitted`,{entry_point:e,query_character_length:t,replay_json_size:n})},trackUserMessageSent:({sessionMessageCount:e,currentMessageLength:t})=>{a(`user_message_sent`,{session_message_count:e,current_message_length:t})},trackDownloadVsCodeButtonClicked:()=>{a(`download_via_vscode_button_clicked`)},trackSettingsSaved:({llmModel:e,llmApiKeySet:t,searchApiKeySet:n,remoteRuntimeResourceFactor:r})=>{a(`settings_saved`,{LLM_MODEL:e,LLM_API_KEY_SET:t,SEARCH_API_KEY_SET:n,REMOTE_RUNTIME_RESOURCE_FACTOR:r})},trackMcpConfigUpdated:({sseServersCount:e,stdioServersCount:t})=>{a(`mcp_config_updated`,{has_mcp_config:!0,sse_servers_count:e,stdio_servers_count:t})},trackDownloadTrajectoryButtonClicked:()=>{a(`download_trajectory_button_clicked`)},trackConversationExported:e=>{a(`conversation_exported`,{format:e})},trackAutomationCreated:({backendKind:e})=>{a(`automation_created`,{backend_kind:e})},trackAutomationExecuted:({backendKind:e})=>{a(`automation_executed`,{backend_kind:e})},trackAutomationDeleted:({backendKind:e})=>{a(`automation_deleted`,{backend_kind:e})},trackAutomationDeactivated:({backendKind:e})=>{a(`automation_deactivated`,{backend_kind:e})},trackAutomationEdited:({backendKind:e})=>{a(`automation_edited`,{backend_kind:e})},trackAutomationExported:({backendKind:e})=>{a(`automation_exported`,{backend_kind:e})},trackAutomationImported:({backendKind:e})=>{a(`automation_imported`,{backend_kind:e})},trackBackendAdded:({backendKind:e,connectionMethod:t,isOpenhandsCloud:n,isCustomHost:r,hasApiKey:i,source:o})=>{a(`backend_added`,{backend_kind:e,connection_method:t,is_openhands_cloud:n,is_custom_host:r,has_api_key:i,source:o})},trackOnboardingStarted:()=>{a(`onboarding_started`)},trackOnboardingStepViewed:({step:e,stepIndex:t,totalSteps:n,agent:r})=>{a(`onboarding_step_viewed`,{step:e,step_index:t,total_steps:n,agent:r})},trackOnboardingCompleted:({agent:e})=>{a(`onboarding_completed`,{agent:e})},trackOnboardingSkipped:({step:e,stepIndex:t,totalSteps:n,agent:r})=>{a(`onboarding_skipped`,{step:e,step_index:t,total_steps:n,agent:r})}}};exports.useTracking=n;
+require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../services/telemetry.cjs`),t=require(`./query/use-settings.cjs`);var n=()=>{let{data:n}=t.useSettings(),r={current_url:window.location.href,user_email:n?.email||n?.git_user_email||null},i=(t,n={})=>{e.trackEvent(t,{...n,...r})};return{trackLoginButtonClick:({provider:e})=>{i(`login_button_clicked`,{provider:e})},trackConversationCreated:({conversationId:e,taskId:t,hasRepository:n,gitProvider:r,hasWorkspace:a,workspaceMode:o,hasInitialQuery:s,agentType:c,hasParentConversation:l,entryPoint:u})=>{i(`conversation_created`,{conversation_id:e,task_id:t,is_start_task:e.startsWith(`task-`),has_repository:n,git_provider:r,has_workspace:a,workspace_mode:o,has_initial_query:s,agent_type:c,has_parent_conversation:l,entry_point:u})},trackPushButtonClick:()=>{i(`push_button_clicked`)},trackPullButtonClick:()=>{i(`pull_button_clicked`)},trackCreatePrButtonClick:()=>{i(`create_pr_button_clicked`)},trackUserSignupCompleted:()=>{i(`user_signup_completed`,{signup_timestamp:new Date().toISOString()})},trackPrebuiltAutomationEnabled:({automationId:e,automationName:t,automationCategory:n})=>{i(`prebuilt_automation_enabled`,{automation_id:e,automation_name:t,automation_category:n})},trackInitialQuerySubmitted:({entryPoint:e,queryCharacterLength:t,replayJsonSize:n})=>{i(`initial_query_submitted`,{entry_point:e,query_character_length:t,replay_json_size:n})},trackUserMessageSent:({sessionMessageCount:e,currentMessageLength:t})=>{i(`user_message_sent`,{session_message_count:e,current_message_length:t})},trackDownloadVsCodeButtonClicked:()=>{i(`download_via_vscode_button_clicked`)},trackSettingsSaved:({llmModel:e,llmApiKeySet:t,searchApiKeySet:n,remoteRuntimeResourceFactor:r})=>{i(`settings_saved`,{LLM_MODEL:e,LLM_API_KEY_SET:t,SEARCH_API_KEY_SET:n,REMOTE_RUNTIME_RESOURCE_FACTOR:r})},trackMcpConfigUpdated:({sseServersCount:e,stdioServersCount:t})=>{i(`mcp_config_updated`,{has_mcp_config:!0,sse_servers_count:e,stdio_servers_count:t})},trackDownloadTrajectoryButtonClicked:()=>{i(`download_trajectory_button_clicked`)},trackConversationExported:e=>{i(`conversation_exported`,{format:e})},trackAutomationCreated:({backendKind:e})=>{i(`automation_created`,{backend_kind:e})},trackAutomationExecuted:({backendKind:e})=>{i(`automation_executed`,{backend_kind:e})},trackAutomationDeleted:({backendKind:e})=>{i(`automation_deleted`,{backend_kind:e})},trackAutomationDeactivated:({backendKind:e})=>{i(`automation_deactivated`,{backend_kind:e})},trackAutomationEdited:({backendKind:e})=>{i(`automation_edited`,{backend_kind:e})},trackAutomationExported:({backendKind:e})=>{i(`automation_exported`,{backend_kind:e})},trackAutomationImported:({backendKind:e})=>{i(`automation_imported`,{backend_kind:e})},trackBackendAdded:({backendKind:e,connectionMethod:t,isOpenhandsCloud:n,isCustomHost:r,hasApiKey:a,source:o})=>{i(`backend_added`,{backend_kind:e,connection_method:t,is_openhands_cloud:n,is_custom_host:r,has_api_key:a,source:o})},trackOnboardingStarted:()=>{i(`onboarding_started`)},trackOnboardingStepViewed:({step:e,stepIndex:t,totalSteps:n,agent:r})=>{i(`onboarding_step_viewed`,{step:e,step_index:t,total_steps:n,agent:r})},trackOnboardingCompleted:({agent:e})=>{i(`onboarding_completed`,{agent:e})},trackOnboardingSkipped:({step:e,stepIndex:t,totalSteps:n,agent:r})=>{i(`onboarding_skipped`,{step:e,step_index:t,total_steps:n,agent:r})}}};exports.useTracking=n;
 //# sourceMappingURL=use-tracking.cjs.map

package/dist/hooks/use-tracking.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-tracking.cjs","names":[],"sources":["../../src/hooks/use-tracking.ts"],"sourcesContent":["import { usePostHog } from \"posthog-js/react\";\nimport { useSettings } from \"./query/use-settings\";\nimport { Provider } from \"#/types/settings\";\nimport type { BackendKind } from \"#/api/backend-registry/types\";\nimport type { WorkspaceMode } from \"#/api/conversation-metadata-store\";\n\n/**\n * Hook that provides tracking functions with automatic data collection\n * from available hooks (settings, etc.)\n *\n * All events require explicit user consent (user_consents_to_analytics === true).\n * Events are silently dropped when:\n *  - posthog is not initialized (VITE_POSTHOG_CLIENT_KEY not set)\n *  - user_consents_to_analytics is false or null (consent not yet collected)\n */\nexport const useTracking = () => {\n  const posthog = usePostHog();\n  const { data: settings } = useSettings();\n\n  // Common properties included in all tracking events\n  const commonProperties = {\n    current_url: window.location.href,\n    user_email: settings?.email || settings?.git_user_email || null,\n  };\n\n  /**\n   * Capture an event only when PostHog is available and the user has\n   * explicitly consented. null and false are both treated as \"not consented\".\n   */\n  const track = (event: string, properties: Record<string, unknown> = {}) => {\n    if (!posthog || settings?.user_consents_to_analytics !== true) return;\n    posthog.capture(event, { ...properties, ...commonProperties });\n  };\n\n  const trackLoginButtonClick = ({ provider }: { provider: Provider }) => {\n    track(\"login_button_clicked\", { provider });\n  };\n\n  const trackConversationCreated = ({\n    conversationId,\n    taskId,\n    hasRepository,\n    gitProvider,\n    hasWorkspace,\n    workspaceMode,\n    hasInitialQuery,\n    agentType,\n    hasParentConversation,\n    entryPoint,\n  }: {\n    conversationId: string;\n    taskId?: string;\n    hasRepository: boolean;\n    gitProvider?: Provider;\n    hasWorkspace: boolean;\n    workspaceMode?: WorkspaceMode;\n    hasInitialQuery: boolean;\n    agentType?: \"default\" | \"plan\";\n    hasParentConversation: boolean;\n    entryPoint?: string;\n  }) => {\n    track(\"conversation_created\", {\n      conversation_id: conversationId,\n      task_id: taskId,\n      is_start_task: conversationId.startsWith(\"task-\"),\n      has_repository: hasRepository,\n      git_provider: gitProvider,\n      has_workspace: hasWorkspace,\n      workspace_mode: workspaceMode,\n      has_initial_query: hasInitialQuery,\n      agent_type: agentType,\n      has_parent_conversation: hasParentConversation,\n      entry_point: entryPoint,\n    });\n  };\n\n  const trackPushButtonClick = () => {\n    track(\"push_button_clicked\");\n  };\n\n  const trackPullButtonClick = () => {\n    track(\"pull_button_clicked\");\n  };\n\n  const trackCreatePrButtonClick = () => {\n    track(\"create_pr_button_clicked\");\n  };\n\n  const trackUserSignupCompleted = () => {\n    track(\"user_signup_completed\", {\n      signup_timestamp: new Date().toISOString(),\n    });\n  };\n\n  const trackPrebuiltAutomationEnabled = ({\n    automationId,\n    automationName,\n    automationCategory,\n  }: {\n    automationId?: string;\n    automationName: string;\n    automationCategory?: string;\n  }) => {\n    track(\"prebuilt_automation_enabled\", {\n      automation_id: automationId,\n      automation_name: automationName,\n      automation_category: automationCategory,\n    });\n  };\n\n  const trackInitialQuerySubmitted = ({\n    entryPoint,\n    queryCharacterLength,\n    replayJsonSize,\n  }: {\n    entryPoint: string;\n    queryCharacterLength: number;\n    replayJsonSize?: number;\n  }) => {\n    track(\"initial_query_submitted\", {\n      entry_point: entryPoint,\n      query_character_length: queryCharacterLength,\n      replay_json_size: replayJsonSize,\n    });\n  };\n\n  const trackUserMessageSent = ({\n    sessionMessageCount,\n    currentMessageLength,\n  }: {\n    sessionMessageCount: number;\n    currentMessageLength: number;\n  }) => {\n    track(\"user_message_sent\", {\n      session_message_count: sessionMessageCount,\n      current_message_length: currentMessageLength,\n    });\n  };\n\n  const trackDownloadVsCodeButtonClicked = () => {\n    track(\"download_via_vscode_button_clicked\");\n  };\n\n  const trackSettingsSaved = ({\n    llmModel,\n    llmApiKeySet,\n    searchApiKeySet,\n    remoteRuntimeResourceFactor,\n  }: {\n    llmModel: unknown;\n    llmApiKeySet: \"SET\" | \"UNSET\";\n    searchApiKeySet: \"SET\" | \"UNSET\";\n    remoteRuntimeResourceFactor?: unknown;\n  }) => {\n    track(\"settings_saved\", {\n      LLM_MODEL: llmModel,\n      LLM_API_KEY_SET: llmApiKeySet,\n      SEARCH_API_KEY_SET: searchApiKeySet,\n      REMOTE_RUNTIME_RESOURCE_FACTOR: remoteRuntimeResourceFactor,\n    });\n  };\n\n  const trackMcpConfigUpdated = ({\n    sseServersCount,\n    stdioServersCount,\n  }: {\n    sseServersCount: number;\n    stdioServersCount: number;\n  }) => {\n    track(\"mcp_config_updated\", {\n      has_mcp_config: true,\n      sse_servers_count: sseServersCount,\n      stdio_servers_count: stdioServersCount,\n    });\n  };\n\n  const trackDownloadTrajectoryButtonClicked = () => {\n    track(\"download_trajectory_button_clicked\");\n  };\n\n  const trackConversationExported = (format: \"markdown\" | \"html\") => {\n    track(\"conversation_exported\", { format });\n  };\n\n  const trackAutomationCreated = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_created\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationExecuted = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_executed\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationDeleted = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_deleted\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationDeactivated = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_deactivated\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationEdited = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_edited\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationExported = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_exported\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationImported = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_imported\", { backend_kind: backendKind });\n  };\n\n  const trackBackendAdded = ({\n    backendKind,\n    connectionMethod,\n    isOpenhandsCloud,\n    isCustomHost,\n    hasApiKey,\n    source,\n  }: {\n    backendKind: BackendKind;\n    connectionMethod: \"manual\" | \"cloud_login\";\n    isOpenhandsCloud: boolean;\n    isCustomHost: boolean;\n    hasApiKey: boolean;\n    source?: \"add_backend_modal\" | \"manage_backends_modal\";\n  }) => {\n    track(\"backend_added\", {\n      backend_kind: backendKind,\n      connection_method: connectionMethod,\n      is_openhands_cloud: isOpenhandsCloud,\n      is_custom_host: isCustomHost,\n      has_api_key: hasApiKey,\n      source,\n    });\n  };\n\n  const trackOnboardingStarted = () => {\n    track(\"onboarding_started\");\n  };\n\n  const trackOnboardingStepViewed = ({\n    step,\n    stepIndex,\n    totalSteps,\n    agent,\n  }: {\n    step: string;\n    stepIndex: number;\n    totalSteps: number;\n    agent: string;\n  }) => {\n    track(\"onboarding_step_viewed\", {\n      step,\n      step_index: stepIndex,\n      total_steps: totalSteps,\n      agent,\n    });\n  };\n\n  const trackOnboardingCompleted = ({ agent }: { agent: string }) => {\n    track(\"onboarding_completed\", { agent });\n  };\n\n  const trackOnboardingSkipped = ({\n    step,\n    stepIndex,\n    totalSteps,\n    agent,\n  }: {\n    step: string;\n    stepIndex: number;\n    totalSteps: number;\n    agent: string;\n  }) => {\n    track(\"onboarding_skipped\", {\n      step,\n      step_index: stepIndex,\n      total_steps: totalSteps,\n      agent,\n    });\n  };\n\n  return {\n    trackLoginButtonClick,\n    trackConversationCreated,\n    trackPushButtonClick,\n    trackPullButtonClick,\n    trackCreatePrButtonClick,\n    trackUserSignupCompleted,\n    trackPrebuiltAutomationEnabled,\n    trackInitialQuerySubmitted,\n    trackUserMessageSent,\n    trackDownloadVsCodeButtonClicked,\n    trackSettingsSaved,\n    trackMcpConfigUpdated,\n    trackDownloadTrajectoryButtonClicked,\n    trackConversationExported,\n    trackAutomationCreated,\n    trackAutomationExecuted,\n    trackAutomationDeleted,\n    trackAutomationDeactivated,\n    trackAutomationEdited,\n    trackAutomationExported,\n    trackAutomationImported,\n    trackBackendAdded,\n    trackOnboardingStarted,\n    trackOnboardingStepViewed,\n    trackOnboardingCompleted,\n    trackOnboardingSkipped,\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"use-tracking.cjs","names":[],"sources":["../../src/hooks/use-tracking.ts"],"sourcesContent":["import { useSettings } from \"./query/use-settings\";\nimport { Provider } from \"#/types/settings\";\nimport type { BackendKind } from \"#/api/backend-registry/types\";\nimport type { WorkspaceMode } from \"#/api/conversation-metadata-store\";\nimport type { CloudConnectionSource } from \"#/services/cloud-funnel-analytics\";\nimport { trackEvent } from \"#/services/telemetry\";\n\n/**\n * Hook that provides tracking functions with automatic data collection\n * from available hooks (settings, etc.)\n *\n * All events require explicit user consent. The shared PostHog client enforces\n * the canonical consent configured by telemetry.ts; this hook must not gate on\n * backend settings because they can be stale while a backend changes.\n */\nexport const useTracking = () => {\n  const { data: settings } = useSettings();\n\n  // Common properties included in all tracking events\n  const commonProperties = {\n    current_url: window.location.href,\n    user_email: settings?.email || settings?.git_user_email || null,\n  };\n\n  /**\n   * PostHog enforces the canonical consent state configured by telemetry.ts.\n   * Backend settings are not a capture gate because they can be stale while a\n   * backend is being added or switched.\n   */\n  const track = (event: string, properties: Record<string, unknown> = {}) => {\n    void trackEvent(event, { ...properties, ...commonProperties });\n  };\n\n  const trackLoginButtonClick = ({ provider }: { provider: Provider }) => {\n    track(\"login_button_clicked\", { provider });\n  };\n\n  const trackConversationCreated = ({\n    conversationId,\n    taskId,\n    hasRepository,\n    gitProvider,\n    hasWorkspace,\n    workspaceMode,\n    hasInitialQuery,\n    agentType,\n    hasParentConversation,\n    entryPoint,\n  }: {\n    conversationId: string;\n    taskId?: string;\n    hasRepository: boolean;\n    gitProvider?: Provider;\n    hasWorkspace: boolean;\n    workspaceMode?: WorkspaceMode;\n    hasInitialQuery: boolean;\n    agentType?: \"default\" | \"plan\";\n    hasParentConversation: boolean;\n    entryPoint?: string;\n  }) => {\n    track(\"conversation_created\", {\n      conversation_id: conversationId,\n      task_id: taskId,\n      is_start_task: conversationId.startsWith(\"task-\"),\n      has_repository: hasRepository,\n      git_provider: gitProvider,\n      has_workspace: hasWorkspace,\n      workspace_mode: workspaceMode,\n      has_initial_query: hasInitialQuery,\n      agent_type: agentType,\n      has_parent_conversation: hasParentConversation,\n      entry_point: entryPoint,\n    });\n  };\n\n  const trackPushButtonClick = () => {\n    track(\"push_button_clicked\");\n  };\n\n  const trackPullButtonClick = () => {\n    track(\"pull_button_clicked\");\n  };\n\n  const trackCreatePrButtonClick = () => {\n    track(\"create_pr_button_clicked\");\n  };\n\n  const trackUserSignupCompleted = () => {\n    track(\"user_signup_completed\", {\n      signup_timestamp: new Date().toISOString(),\n    });\n  };\n\n  const trackPrebuiltAutomationEnabled = ({\n    automationId,\n    automationName,\n    automationCategory,\n  }: {\n    automationId?: string;\n    automationName: string;\n    automationCategory?: string;\n  }) => {\n    track(\"prebuilt_automation_enabled\", {\n      automation_id: automationId,\n      automation_name: automationName,\n      automation_category: automationCategory,\n    });\n  };\n\n  const trackInitialQuerySubmitted = ({\n    entryPoint,\n    queryCharacterLength,\n    replayJsonSize,\n  }: {\n    entryPoint: string;\n    queryCharacterLength: number;\n    replayJsonSize?: number;\n  }) => {\n    track(\"initial_query_submitted\", {\n      entry_point: entryPoint,\n      query_character_length: queryCharacterLength,\n      replay_json_size: replayJsonSize,\n    });\n  };\n\n  const trackUserMessageSent = ({\n    sessionMessageCount,\n    currentMessageLength,\n  }: {\n    sessionMessageCount: number;\n    currentMessageLength: number;\n  }) => {\n    track(\"user_message_sent\", {\n      session_message_count: sessionMessageCount,\n      current_message_length: currentMessageLength,\n    });\n  };\n\n  const trackDownloadVsCodeButtonClicked = () => {\n    track(\"download_via_vscode_button_clicked\");\n  };\n\n  const trackSettingsSaved = ({\n    llmModel,\n    llmApiKeySet,\n    searchApiKeySet,\n    remoteRuntimeResourceFactor,\n  }: {\n    llmModel: unknown;\n    llmApiKeySet: \"SET\" | \"UNSET\";\n    searchApiKeySet: \"SET\" | \"UNSET\";\n    remoteRuntimeResourceFactor?: unknown;\n  }) => {\n    track(\"settings_saved\", {\n      LLM_MODEL: llmModel,\n      LLM_API_KEY_SET: llmApiKeySet,\n      SEARCH_API_KEY_SET: searchApiKeySet,\n      REMOTE_RUNTIME_RESOURCE_FACTOR: remoteRuntimeResourceFactor,\n    });\n  };\n\n  const trackMcpConfigUpdated = ({\n    sseServersCount,\n    stdioServersCount,\n  }: {\n    sseServersCount: number;\n    stdioServersCount: number;\n  }) => {\n    track(\"mcp_config_updated\", {\n      has_mcp_config: true,\n      sse_servers_count: sseServersCount,\n      stdio_servers_count: stdioServersCount,\n    });\n  };\n\n  const trackDownloadTrajectoryButtonClicked = () => {\n    track(\"download_trajectory_button_clicked\");\n  };\n\n  const trackConversationExported = (format: \"markdown\" | \"html\") => {\n    track(\"conversation_exported\", { format });\n  };\n\n  const trackAutomationCreated = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_created\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationExecuted = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_executed\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationDeleted = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_deleted\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationDeactivated = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_deactivated\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationEdited = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_edited\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationExported = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_exported\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationImported = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_imported\", { backend_kind: backendKind });\n  };\n\n  const trackBackendAdded = ({\n    backendKind,\n    connectionMethod,\n    isOpenhandsCloud,\n    isCustomHost,\n    hasApiKey,\n    source,\n  }: {\n    backendKind: BackendKind;\n    connectionMethod: \"manual\" | \"cloud_login\";\n    isOpenhandsCloud: boolean;\n    isCustomHost: boolean;\n    hasApiKey: boolean;\n    source?: CloudConnectionSource;\n  }) => {\n    track(\"backend_added\", {\n      backend_kind: backendKind,\n      connection_method: connectionMethod,\n      is_openhands_cloud: isOpenhandsCloud,\n      is_custom_host: isCustomHost,\n      has_api_key: hasApiKey,\n      source,\n    });\n  };\n\n  const trackOnboardingStarted = () => {\n    track(\"onboarding_started\");\n  };\n\n  const trackOnboardingStepViewed = ({\n    step,\n    stepIndex,\n    totalSteps,\n    agent,\n  }: {\n    step: string;\n    stepIndex: number;\n    totalSteps: number;\n    agent: string;\n  }) => {\n    track(\"onboarding_step_viewed\", {\n      step,\n      step_index: stepIndex,\n      total_steps: totalSteps,\n      agent,\n    });\n  };\n\n  const trackOnboardingCompleted = ({ agent }: { agent: string }) => {\n    track(\"onboarding_completed\", { agent });\n  };\n\n  const trackOnboardingSkipped = ({\n    step,\n    stepIndex,\n    totalSteps,\n    agent,\n  }: {\n    step: string;\n    stepIndex: number;\n    totalSteps: number;\n    agent: string;\n  }) => {\n    track(\"onboarding_skipped\", {\n      step,\n      step_index: stepIndex,\n      total_steps: totalSteps,\n      agent,\n    });\n  };\n\n  return {\n    trackLoginButtonClick,\n    trackConversationCreated,\n    trackPushButtonClick,\n    trackPullButtonClick,\n    trackCreatePrButtonClick,\n    trackUserSignupCompleted,\n    trackPrebuiltAutomationEnabled,\n    trackInitialQuerySubmitted,\n    trackUserMessageSent,\n    trackDownloadVsCodeButtonClicked,\n    trackSettingsSaved,\n    trackMcpConfigUpdated,\n    trackDownloadTrajectoryButtonClicked,\n    trackConversationExported,\n    trackAutomationCreated,\n    trackAutomationExecuted,\n    trackAutomationDeleted,\n    trackAutomationDeactivated,\n    trackAutomationEdited,\n    trackAutomationExported,\n    trackAutomationImported,\n    trackBackendAdded,\n    trackOnboardingStarted,\n    trackOnboardingStepViewed,\n    trackOnboardingCompleted,\n    trackOnboardingSkipped,\n  };\n};\n"],"mappings":"gIAeA,IAAa,MAAoB,CAC/B,GAAM,CAAE,KAAM,GAAa,EAAA,aAAa,CAGlC,EAAmB,CACvB,YAAa,OAAO,SAAS,KAC7B,WAAY,GAAU,OAAS,GAAU,gBAAkB,KAC5D,CAOK,GAAS,EAAe,EAAsC,EAAE,GAAK,CACpE,EAAA,WAAW,EAAO,CAAE,GAAG,EAAY,GAAG,EAAkB,CAAC,EAwRhE,MAAO,CACL,uBAtR6B,CAAE,cAAuC,CACtE,EAAM,uBAAwB,CAAE,WAAU,CAAC,EAsR3C,0BAnRgC,CAChC,iBACA,SACA,gBACA,cACA,eACA,gBACA,kBACA,YACA,wBACA,gBAYI,CACJ,EAAM,uBAAwB,CAC5B,gBAAiB,EACjB,QAAS,EACT,cAAe,EAAe,WAAW,QAAQ,CACjD,eAAgB,EAChB,aAAc,EACd,cAAe,EACf,eAAgB,EAChB,kBAAmB,EACnB,WAAY,EACZ,wBAAyB,EACzB,YAAa,EACd,CAAC,EAiPF,yBA9OiC,CACjC,EAAM,sBAAsB,EA8O5B,yBA3OiC,CACjC,EAAM,sBAAsB,EA2O5B,6BAxOqC,CACrC,EAAM,2BAA2B,EAwOjC,6BArOqC,CACrC,EAAM,wBAAyB,CAC7B,iBAAkB,IAAI,MAAM,CAAC,aAAa,CAC3C,CAAC,EAmOF,gCAhOsC,CACtC,eACA,iBACA,wBAKI,CACJ,EAAM,8BAA+B,CACnC,cAAe,EACf,gBAAiB,EACjB,oBAAqB,EACtB,CAAC,EAoNF,4BAjNkC,CAClC,aACA,uBACA,oBAKI,CACJ,EAAM,0BAA2B,CAC/B,YAAa,EACb,uBAAwB,EACxB,iBAAkB,EACnB,CAAC,EAqMF,sBAlM4B,CAC5B,sBACA,0BAII,CACJ,EAAM,oBAAqB,CACzB,sBAAuB,EACvB,uBAAwB,EACzB,CAAC,EAyLF,qCAtL6C,CAC7C,EAAM,qCAAqC,EAsL3C,oBAnL0B,CAC1B,WACA,eACA,kBACA,iCAMI,CACJ,EAAM,iBAAkB,CACtB,UAAW,EACX,gBAAiB,EACjB,mBAAoB,EACpB,+BAAgC,EACjC,CAAC,EAoKF,uBAjK6B,CAC7B,kBACA,uBAII,CACJ,EAAM,qBAAsB,CAC1B,eAAgB,GAChB,kBAAmB,EACnB,oBAAqB,EACtB,CAAC,EAuJF,yCApJiD,CACjD,EAAM,qCAAqC,EAoJ3C,0BAjJiC,GAAgC,CACjE,EAAM,wBAAyB,CAAE,SAAQ,CAAC,EAiJ1C,wBA9I8B,CAC9B,iBAGI,CACJ,EAAM,qBAAsB,CAAE,aAAc,EAAa,CAAC,EA0I1D,yBAvI+B,CAC/B,iBAGI,CACJ,EAAM,sBAAuB,CAAE,aAAc,EAAa,CAAC,EAmI3D,wBAhI8B,CAC9B,iBAGI,CACJ,EAAM,qBAAsB,CAAE,aAAc,EAAa,CAAC,EA4H1D,4BAzHkC,CAClC,iBAGI,CACJ,EAAM,yBAA0B,CAAE,aAAc,EAAa,CAAC,EAqH9D,uBAlH6B,CAC7B,iBAGI,CACJ,EAAM,oBAAqB,CAAE,aAAc,EAAa,CAAC,EA8GzD,yBA3G+B,CAC/B,iBAGI,CACJ,EAAM,sBAAuB,CAAE,aAAc,EAAa,CAAC,EAuG3D,yBApG+B,CAC/B,iBAGI,CACJ,EAAM,sBAAuB,CAAE,aAAc,EAAa,CAAC,EAgG3D,mBA7FyB,CACzB,cACA,mBACA,mBACA,eACA,YACA,YAQI,CACJ,EAAM,gBAAiB,CACrB,aAAc,EACd,kBAAmB,EACnB,mBAAoB,EACpB,eAAgB,EAChB,YAAa,EACb,SACD,CAAC,EAwEF,2BArEmC,CACnC,EAAM,qBAAqB,EAqE3B,2BAlEiC,CACjC,OACA,YACA,aACA,WAMI,CACJ,EAAM,yBAA0B,CAC9B,OACA,WAAY,EACZ,YAAa,EACb,QACD,CAAC,EAmDF,0BAhDgC,CAAE,WAA+B,CACjE,EAAM,uBAAwB,CAAE,QAAO,CAAC,EAgDxC,wBA7C8B,CAC9B,OACA,YACA,aACA,WAMI,CACJ,EAAM,qBAAsB,CAC1B,OACA,WAAY,EACZ,YAAa,EACb,QACD,CAAC,EA8BH"}

package/dist/hooks/use-tracking.d.ts

@@ -1,14 +1,14 @@
 import { Provider } from "#/types/settings";
 import type { BackendKind } from "#/api/backend-registry/types";
 import type { WorkspaceMode } from "#/api/conversation-metadata-store";
+import type { CloudConnectionSource } from "#/services/cloud-funnel-analytics";
 /**
  * Hook that provides tracking functions with automatic data collection
  * from available hooks (settings, etc.)
  *
- * All events require explicit user consent (user_consents_to_analytics === true).
- * Events are silently dropped when:
- *  - posthog is not initialized (VITE_POSTHOG_CLIENT_KEY not set)
- *  - user_consents_to_analytics is false or null (consent not yet collected)
+ * All events require explicit user consent. The shared PostHog client enforces
+ * the canonical consent configured by telemetry.ts; this hook must not gate on
+ * backend settings because they can be stale while a backend changes.
  */
 export declare const useTracking: () => {
     trackLoginButtonClick: ({ provider }: {
@@ -84,7 +84,7 @@ export declare const useTracking: () => {
         isOpenhandsCloud: boolean;
         isCustomHost: boolean;
         hasApiKey: boolean;
-        source?: "add_backend_modal" | "manage_backends_modal";
+        source?: CloudConnectionSource;
     }) => void;
     trackOnboardingStarted: () => void;
     trackOnboardingStepViewed: ({ step, stepIndex, totalSteps, agent, }: {

package/dist/hooks/use-tracking.js

@@ -1,28 +1,28 @@
-import { usePostHog as e } from "../node_modules/posthog-js/react/dist/esm/index.js";
+import { trackEvent as e } from "../services/telemetry.js";
 import { useSettings as t } from "./query/use-settings.js";
 //#region src/hooks/use-tracking.ts
 var n = () => {
-	let n = e(), { data: r } = t(), i = {
+	let { data: n } = t(), r = {
 		current_url: window.location.href,
-		user_email: r?.email || r?.git_user_email || null
-	}, a = (e, t = {}) => {
-		!n || r?.user_consents_to_analytics !== !0 || n.capture(e, {
-			...t,
-			...i
+		user_email: n?.email || n?.git_user_email || null
+	}, i = (t, n = {}) => {
+		e(t, {
+			...n,
+			...r
 		});
 	};
 	return {
 		trackLoginButtonClick: ({ provider: e }) => {
-			a("login_button_clicked", { provider: e });
+			i("login_button_clicked", { provider: e });
 		},
-		trackConversationCreated: ({ conversationId: e, taskId: t, hasRepository: n, gitProvider: r, hasWorkspace: i, workspaceMode: o, hasInitialQuery: s, agentType: c, hasParentConversation: l, entryPoint: u }) => {
-			a("conversation_created", {
+		trackConversationCreated: ({ conversationId: e, taskId: t, hasRepository: n, gitProvider: r, hasWorkspace: a, workspaceMode: o, hasInitialQuery: s, agentType: c, hasParentConversation: l, entryPoint: u }) => {
+			i("conversation_created", {
 				conversation_id: e,
 				task_id: t,
 				is_start_task: e.startsWith("task-"),
 				has_repository: n,
 				git_provider: r,
-				has_workspace: i,
+				has_workspace: a,
 				workspace_mode: o,
 				has_initial_query: s,
 				agent_type: c,
@@ -31,42 +31,42 @@ var n = () => {
 			});
 		},
 		trackPushButtonClick: () => {
-			a("push_button_clicked");
+			i("push_button_clicked");
 		},
 		trackPullButtonClick: () => {
-			a("pull_button_clicked");
+			i("pull_button_clicked");
 		},
 		trackCreatePrButtonClick: () => {
-			a("create_pr_button_clicked");
+			i("create_pr_button_clicked");
 		},
 		trackUserSignupCompleted: () => {
-			a("user_signup_completed", { signup_timestamp: (/* @__PURE__ */ new Date()).toISOString() });
+			i("user_signup_completed", { signup_timestamp: (/* @__PURE__ */ new Date()).toISOString() });
 		},
 		trackPrebuiltAutomationEnabled: ({ automationId: e, automationName: t, automationCategory: n }) => {
-			a("prebuilt_automation_enabled", {
+			i("prebuilt_automation_enabled", {
 				automation_id: e,
 				automation_name: t,
 				automation_category: n
 			});
 		},
 		trackInitialQuerySubmitted: ({ entryPoint: e, queryCharacterLength: t, replayJsonSize: n }) => {
-			a("initial_query_submitted", {
+			i("initial_query_submitted", {
 				entry_point: e,
 				query_character_length: t,
 				replay_json_size: n
 			});
 		},
 		trackUserMessageSent: ({ sessionMessageCount: e, currentMessageLength: t }) => {
-			a("user_message_sent", {
+			i("user_message_sent", {
 				session_message_count: e,
 				current_message_length: t
 			});
 		},
 		trackDownloadVsCodeButtonClicked: () => {
-			a("download_via_vscode_button_clicked");
+			i("download_via_vscode_button_clicked");
 		},
 		trackSettingsSaved: ({ llmModel: e, llmApiKeySet: t, searchApiKeySet: n, remoteRuntimeResourceFactor: r }) => {
-			a("settings_saved", {
+			i("settings_saved", {
 				LLM_MODEL: e,
 				LLM_API_KEY_SET: t,
 				SEARCH_API_KEY_SET: n,
@@ -74,54 +74,54 @@ var n = () => {
 			});
 		},
 		trackMcpConfigUpdated: ({ sseServersCount: e, stdioServersCount: t }) => {
-			a("mcp_config_updated", {
+			i("mcp_config_updated", {
 				has_mcp_config: !0,
 				sse_servers_count: e,
 				stdio_servers_count: t
 			});
 		},
 		trackDownloadTrajectoryButtonClicked: () => {
-			a("download_trajectory_button_clicked");
+			i("download_trajectory_button_clicked");
 		},
 		trackConversationExported: (e) => {
-			a("conversation_exported", { format: e });
+			i("conversation_exported", { format: e });
 		},
 		trackAutomationCreated: ({ backendKind: e }) => {
-			a("automation_created", { backend_kind: e });
+			i("automation_created", { backend_kind: e });
 		},
 		trackAutomationExecuted: ({ backendKind: e }) => {
-			a("automation_executed", { backend_kind: e });
+			i("automation_executed", { backend_kind: e });
 		},
 		trackAutomationDeleted: ({ backendKind: e }) => {
-			a("automation_deleted", { backend_kind: e });
+			i("automation_deleted", { backend_kind: e });
 		},
 		trackAutomationDeactivated: ({ backendKind: e }) => {
-			a("automation_deactivated", { backend_kind: e });
+			i("automation_deactivated", { backend_kind: e });
 		},
 		trackAutomationEdited: ({ backendKind: e }) => {
-			a("automation_edited", { backend_kind: e });
+			i("automation_edited", { backend_kind: e });
 		},
 		trackAutomationExported: ({ backendKind: e }) => {
-			a("automation_exported", { backend_kind: e });
+			i("automation_exported", { backend_kind: e });
 		},
 		trackAutomationImported: ({ backendKind: e }) => {
-			a("automation_imported", { backend_kind: e });
+			i("automation_imported", { backend_kind: e });
 		},
-		trackBackendAdded: ({ backendKind: e, connectionMethod: t, isOpenhandsCloud: n, isCustomHost: r, hasApiKey: i, source: o }) => {
-			a("backend_added", {
+		trackBackendAdded: ({ backendKind: e, connectionMethod: t, isOpenhandsCloud: n, isCustomHost: r, hasApiKey: a, source: o }) => {
+			i("backend_added", {
 				backend_kind: e,
 				connection_method: t,
 				is_openhands_cloud: n,
 				is_custom_host: r,
-				has_api_key: i,
+				has_api_key: a,
 				source: o
 			});
 		},
 		trackOnboardingStarted: () => {
-			a("onboarding_started");
+			i("onboarding_started");
 		},
 		trackOnboardingStepViewed: ({ step: e, stepIndex: t, totalSteps: n, agent: r }) => {
-			a("onboarding_step_viewed", {
+			i("onboarding_step_viewed", {
 				step: e,
 				step_index: t,
 				total_steps: n,
@@ -129,10 +129,10 @@ var n = () => {
 			});
 		},
 		trackOnboardingCompleted: ({ agent: e }) => {
-			a("onboarding_completed", { agent: e });
+			i("onboarding_completed", { agent: e });
 		},
 		trackOnboardingSkipped: ({ step: e, stepIndex: t, totalSteps: n, agent: r }) => {
-			a("onboarding_skipped", {
+			i("onboarding_skipped", {
 				step: e,
 				step_index: t,
 				total_steps: n,

package/dist/hooks/use-tracking.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-tracking.js","names":[],"sources":["../../src/hooks/use-tracking.ts"],"sourcesContent":["import { usePostHog } from \"posthog-js/react\";\nimport { useSettings } from \"./query/use-settings\";\nimport { Provider } from \"#/types/settings\";\nimport type { BackendKind } from \"#/api/backend-registry/types\";\nimport type { WorkspaceMode } from \"#/api/conversation-metadata-store\";\n\n/**\n * Hook that provides tracking functions with automatic data collection\n * from available hooks (settings, etc.)\n *\n * All events require explicit user consent (user_consents_to_analytics === true).\n * Events are silently dropped when:\n *  - posthog is not initialized (VITE_POSTHOG_CLIENT_KEY not set)\n *  - user_consents_to_analytics is false or null (consent not yet collected)\n */\nexport const useTracking = () => {\n  const posthog = usePostHog();\n  const { data: settings } = useSettings();\n\n  // Common properties included in all tracking events\n  const commonProperties = {\n    current_url: window.location.href,\n    user_email: settings?.email || settings?.git_user_email || null,\n  };\n\n  /**\n   * Capture an event only when PostHog is available and the user has\n   * explicitly consented. null and false are both treated as \"not consented\".\n   */\n  const track = (event: string, properties: Record<string, unknown> = {}) => {\n    if (!posthog || settings?.user_consents_to_analytics !== true) return;\n    posthog.capture(event, { ...properties, ...commonProperties });\n  };\n\n  const trackLoginButtonClick = ({ provider }: { provider: Provider }) => {\n    track(\"login_button_clicked\", { provider });\n  };\n\n  const trackConversationCreated = ({\n    conversationId,\n    taskId,\n    hasRepository,\n    gitProvider,\n    hasWorkspace,\n    workspaceMode,\n    hasInitialQuery,\n    agentType,\n    hasParentConversation,\n    entryPoint,\n  }: {\n    conversationId: string;\n    taskId?: string;\n    hasRepository: boolean;\n    gitProvider?: Provider;\n    hasWorkspace: boolean;\n    workspaceMode?: WorkspaceMode;\n    hasInitialQuery: boolean;\n    agentType?: \"default\" | \"plan\";\n    hasParentConversation: boolean;\n    entryPoint?: string;\n  }) => {\n    track(\"conversation_created\", {\n      conversation_id: conversationId,\n      task_id: taskId,\n      is_start_task: conversationId.startsWith(\"task-\"),\n      has_repository: hasRepository,\n      git_provider: gitProvider,\n      has_workspace: hasWorkspace,\n      workspace_mode: workspaceMode,\n      has_initial_query: hasInitialQuery,\n      agent_type: agentType,\n      has_parent_conversation: hasParentConversation,\n      entry_point: entryPoint,\n    });\n  };\n\n  const trackPushButtonClick = () => {\n    track(\"push_button_clicked\");\n  };\n\n  const trackPullButtonClick = () => {\n    track(\"pull_button_clicked\");\n  };\n\n  const trackCreatePrButtonClick = () => {\n    track(\"create_pr_button_clicked\");\n  };\n\n  const trackUserSignupCompleted = () => {\n    track(\"user_signup_completed\", {\n      signup_timestamp: new Date().toISOString(),\n    });\n  };\n\n  const trackPrebuiltAutomationEnabled = ({\n    automationId,\n    automationName,\n    automationCategory,\n  }: {\n    automationId?: string;\n    automationName: string;\n    automationCategory?: string;\n  }) => {\n    track(\"prebuilt_automation_enabled\", {\n      automation_id: automationId,\n      automation_name: automationName,\n      automation_category: automationCategory,\n    });\n  };\n\n  const trackInitialQuerySubmitted = ({\n    entryPoint,\n    queryCharacterLength,\n    replayJsonSize,\n  }: {\n    entryPoint: string;\n    queryCharacterLength: number;\n    replayJsonSize?: number;\n  }) => {\n    track(\"initial_query_submitted\", {\n      entry_point: entryPoint,\n      query_character_length: queryCharacterLength,\n      replay_json_size: replayJsonSize,\n    });\n  };\n\n  const trackUserMessageSent = ({\n    sessionMessageCount,\n    currentMessageLength,\n  }: {\n    sessionMessageCount: number;\n    currentMessageLength: number;\n  }) => {\n    track(\"user_message_sent\", {\n      session_message_count: sessionMessageCount,\n      current_message_length: currentMessageLength,\n    });\n  };\n\n  const trackDownloadVsCodeButtonClicked = () => {\n    track(\"download_via_vscode_button_clicked\");\n  };\n\n  const trackSettingsSaved = ({\n    llmModel,\n    llmApiKeySet,\n    searchApiKeySet,\n    remoteRuntimeResourceFactor,\n  }: {\n    llmModel: unknown;\n    llmApiKeySet: \"SET\" | \"UNSET\";\n    searchApiKeySet: \"SET\" | \"UNSET\";\n    remoteRuntimeResourceFactor?: unknown;\n  }) => {\n    track(\"settings_saved\", {\n      LLM_MODEL: llmModel,\n      LLM_API_KEY_SET: llmApiKeySet,\n      SEARCH_API_KEY_SET: searchApiKeySet,\n      REMOTE_RUNTIME_RESOURCE_FACTOR: remoteRuntimeResourceFactor,\n    });\n  };\n\n  const trackMcpConfigUpdated = ({\n    sseServersCount,\n    stdioServersCount,\n  }: {\n    sseServersCount: number;\n    stdioServersCount: number;\n  }) => {\n    track(\"mcp_config_updated\", {\n      has_mcp_config: true,\n      sse_servers_count: sseServersCount,\n      stdio_servers_count: stdioServersCount,\n    });\n  };\n\n  const trackDownloadTrajectoryButtonClicked = () => {\n    track(\"download_trajectory_button_clicked\");\n  };\n\n  const trackConversationExported = (format: \"markdown\" | \"html\") => {\n    track(\"conversation_exported\", { format });\n  };\n\n  const trackAutomationCreated = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_created\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationExecuted = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_executed\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationDeleted = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_deleted\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationDeactivated = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_deactivated\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationEdited = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_edited\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationExported = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_exported\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationImported = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_imported\", { backend_kind: backendKind });\n  };\n\n  const trackBackendAdded = ({\n    backendKind,\n    connectionMethod,\n    isOpenhandsCloud,\n    isCustomHost,\n    hasApiKey,\n    source,\n  }: {\n    backendKind: BackendKind;\n    connectionMethod: \"manual\" | \"cloud_login\";\n    isOpenhandsCloud: boolean;\n    isCustomHost: boolean;\n    hasApiKey: boolean;\n    source?: \"add_backend_modal\" | \"manage_backends_modal\";\n  }) => {\n    track(\"backend_added\", {\n      backend_kind: backendKind,\n      connection_method: connectionMethod,\n      is_openhands_cloud: isOpenhandsCloud,\n      is_custom_host: isCustomHost,\n      has_api_key: hasApiKey,\n      source,\n    });\n  };\n\n  const trackOnboardingStarted = () => {\n    track(\"onboarding_started\");\n  };\n\n  const trackOnboardingStepViewed = ({\n    step,\n    stepIndex,\n    totalSteps,\n    agent,\n  }: {\n    step: string;\n    stepIndex: number;\n    totalSteps: number;\n    agent: string;\n  }) => {\n    track(\"onboarding_step_viewed\", {\n      step,\n      step_index: stepIndex,\n      total_steps: totalSteps,\n      agent,\n    });\n  };\n\n  const trackOnboardingCompleted = ({ agent }: { agent: string }) => {\n    track(\"onboarding_completed\", { agent });\n  };\n\n  const trackOnboardingSkipped = ({\n    step,\n    stepIndex,\n    totalSteps,\n    agent,\n  }: {\n    step: string;\n    stepIndex: number;\n    totalSteps: number;\n    agent: string;\n  }) => {\n    track(\"onboarding_skipped\", {\n      step,\n      step_index: stepIndex,\n      total_steps: totalSteps,\n      agent,\n    });\n  };\n\n  return {\n    trackLoginButtonClick,\n    trackConversationCreated,\n    trackPushButtonClick,\n    trackPullButtonClick,\n    trackCreatePrButtonClick,\n    trackUserSignupCompleted,\n    trackPrebuiltAutomationEnabled,\n    trackInitialQuerySubmitted,\n    trackUserMessageSent,\n    trackDownloadVsCodeButtonClicked,\n    trackSettingsSaved,\n    trackMcpConfigUpdated,\n    trackDownloadTrajectoryButtonClicked,\n    trackConversationExported,\n    trackAutomationCreated,\n    trackAutomationExecuted,\n    trackAutomationDeleted,\n    trackAutomationDeactivated,\n    trackAutomationEdited,\n    trackAutomationExported,\n    trackAutomationImported,\n    trackBackendAdded,\n    trackOnboardingStarted,\n    trackOnboardingStepViewed,\n    trackOnboardingCompleted,\n    trackOnboardingSkipped,\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"use-tracking.js","names":[],"sources":["../../src/hooks/use-tracking.ts"],"sourcesContent":["import { useSettings } from \"./query/use-settings\";\nimport { Provider } from \"#/types/settings\";\nimport type { BackendKind } from \"#/api/backend-registry/types\";\nimport type { WorkspaceMode } from \"#/api/conversation-metadata-store\";\nimport type { CloudConnectionSource } from \"#/services/cloud-funnel-analytics\";\nimport { trackEvent } from \"#/services/telemetry\";\n\n/**\n * Hook that provides tracking functions with automatic data collection\n * from available hooks (settings, etc.)\n *\n * All events require explicit user consent. The shared PostHog client enforces\n * the canonical consent configured by telemetry.ts; this hook must not gate on\n * backend settings because they can be stale while a backend changes.\n */\nexport const useTracking = () => {\n  const { data: settings } = useSettings();\n\n  // Common properties included in all tracking events\n  const commonProperties = {\n    current_url: window.location.href,\n    user_email: settings?.email || settings?.git_user_email || null,\n  };\n\n  /**\n   * PostHog enforces the canonical consent state configured by telemetry.ts.\n   * Backend settings are not a capture gate because they can be stale while a\n   * backend is being added or switched.\n   */\n  const track = (event: string, properties: Record<string, unknown> = {}) => {\n    void trackEvent(event, { ...properties, ...commonProperties });\n  };\n\n  const trackLoginButtonClick = ({ provider }: { provider: Provider }) => {\n    track(\"login_button_clicked\", { provider });\n  };\n\n  const trackConversationCreated = ({\n    conversationId,\n    taskId,\n    hasRepository,\n    gitProvider,\n    hasWorkspace,\n    workspaceMode,\n    hasInitialQuery,\n    agentType,\n    hasParentConversation,\n    entryPoint,\n  }: {\n    conversationId: string;\n    taskId?: string;\n    hasRepository: boolean;\n    gitProvider?: Provider;\n    hasWorkspace: boolean;\n    workspaceMode?: WorkspaceMode;\n    hasInitialQuery: boolean;\n    agentType?: \"default\" | \"plan\";\n    hasParentConversation: boolean;\n    entryPoint?: string;\n  }) => {\n    track(\"conversation_created\", {\n      conversation_id: conversationId,\n      task_id: taskId,\n      is_start_task: conversationId.startsWith(\"task-\"),\n      has_repository: hasRepository,\n      git_provider: gitProvider,\n      has_workspace: hasWorkspace,\n      workspace_mode: workspaceMode,\n      has_initial_query: hasInitialQuery,\n      agent_type: agentType,\n      has_parent_conversation: hasParentConversation,\n      entry_point: entryPoint,\n    });\n  };\n\n  const trackPushButtonClick = () => {\n    track(\"push_button_clicked\");\n  };\n\n  const trackPullButtonClick = () => {\n    track(\"pull_button_clicked\");\n  };\n\n  const trackCreatePrButtonClick = () => {\n    track(\"create_pr_button_clicked\");\n  };\n\n  const trackUserSignupCompleted = () => {\n    track(\"user_signup_completed\", {\n      signup_timestamp: new Date().toISOString(),\n    });\n  };\n\n  const trackPrebuiltAutomationEnabled = ({\n    automationId,\n    automationName,\n    automationCategory,\n  }: {\n    automationId?: string;\n    automationName: string;\n    automationCategory?: string;\n  }) => {\n    track(\"prebuilt_automation_enabled\", {\n      automation_id: automationId,\n      automation_name: automationName,\n      automation_category: automationCategory,\n    });\n  };\n\n  const trackInitialQuerySubmitted = ({\n    entryPoint,\n    queryCharacterLength,\n    replayJsonSize,\n  }: {\n    entryPoint: string;\n    queryCharacterLength: number;\n    replayJsonSize?: number;\n  }) => {\n    track(\"initial_query_submitted\", {\n      entry_point: entryPoint,\n      query_character_length: queryCharacterLength,\n      replay_json_size: replayJsonSize,\n    });\n  };\n\n  const trackUserMessageSent = ({\n    sessionMessageCount,\n    currentMessageLength,\n  }: {\n    sessionMessageCount: number;\n    currentMessageLength: number;\n  }) => {\n    track(\"user_message_sent\", {\n      session_message_count: sessionMessageCount,\n      current_message_length: currentMessageLength,\n    });\n  };\n\n  const trackDownloadVsCodeButtonClicked = () => {\n    track(\"download_via_vscode_button_clicked\");\n  };\n\n  const trackSettingsSaved = ({\n    llmModel,\n    llmApiKeySet,\n    searchApiKeySet,\n    remoteRuntimeResourceFactor,\n  }: {\n    llmModel: unknown;\n    llmApiKeySet: \"SET\" | \"UNSET\";\n    searchApiKeySet: \"SET\" | \"UNSET\";\n    remoteRuntimeResourceFactor?: unknown;\n  }) => {\n    track(\"settings_saved\", {\n      LLM_MODEL: llmModel,\n      LLM_API_KEY_SET: llmApiKeySet,\n      SEARCH_API_KEY_SET: searchApiKeySet,\n      REMOTE_RUNTIME_RESOURCE_FACTOR: remoteRuntimeResourceFactor,\n    });\n  };\n\n  const trackMcpConfigUpdated = ({\n    sseServersCount,\n    stdioServersCount,\n  }: {\n    sseServersCount: number;\n    stdioServersCount: number;\n  }) => {\n    track(\"mcp_config_updated\", {\n      has_mcp_config: true,\n      sse_servers_count: sseServersCount,\n      stdio_servers_count: stdioServersCount,\n    });\n  };\n\n  const trackDownloadTrajectoryButtonClicked = () => {\n    track(\"download_trajectory_button_clicked\");\n  };\n\n  const trackConversationExported = (format: \"markdown\" | \"html\") => {\n    track(\"conversation_exported\", { format });\n  };\n\n  const trackAutomationCreated = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_created\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationExecuted = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_executed\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationDeleted = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_deleted\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationDeactivated = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_deactivated\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationEdited = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_edited\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationExported = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_exported\", { backend_kind: backendKind });\n  };\n\n  const trackAutomationImported = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_imported\", { backend_kind: backendKind });\n  };\n\n  const trackBackendAdded = ({\n    backendKind,\n    connectionMethod,\n    isOpenhandsCloud,\n    isCustomHost,\n    hasApiKey,\n    source,\n  }: {\n    backendKind: BackendKind;\n    connectionMethod: \"manual\" | \"cloud_login\";\n    isOpenhandsCloud: boolean;\n    isCustomHost: boolean;\n    hasApiKey: boolean;\n    source?: CloudConnectionSource;\n  }) => {\n    track(\"backend_added\", {\n      backend_kind: backendKind,\n      connection_method: connectionMethod,\n      is_openhands_cloud: isOpenhandsCloud,\n      is_custom_host: isCustomHost,\n      has_api_key: hasApiKey,\n      source,\n    });\n  };\n\n  const trackOnboardingStarted = () => {\n    track(\"onboarding_started\");\n  };\n\n  const trackOnboardingStepViewed = ({\n    step,\n    stepIndex,\n    totalSteps,\n    agent,\n  }: {\n    step: string;\n    stepIndex: number;\n    totalSteps: number;\n    agent: string;\n  }) => {\n    track(\"onboarding_step_viewed\", {\n      step,\n      step_index: stepIndex,\n      total_steps: totalSteps,\n      agent,\n    });\n  };\n\n  const trackOnboardingCompleted = ({ agent }: { agent: string }) => {\n    track(\"onboarding_completed\", { agent });\n  };\n\n  const trackOnboardingSkipped = ({\n    step,\n    stepIndex,\n    totalSteps,\n    agent,\n  }: {\n    step: string;\n    stepIndex: number;\n    totalSteps: number;\n    agent: string;\n  }) => {\n    track(\"onboarding_skipped\", {\n      step,\n      step_index: stepIndex,\n      total_steps: totalSteps,\n      agent,\n    });\n  };\n\n  return {\n    trackLoginButtonClick,\n    trackConversationCreated,\n    trackPushButtonClick,\n    trackPullButtonClick,\n    trackCreatePrButtonClick,\n    trackUserSignupCompleted,\n    trackPrebuiltAutomationEnabled,\n    trackInitialQuerySubmitted,\n    trackUserMessageSent,\n    trackDownloadVsCodeButtonClicked,\n    trackSettingsSaved,\n    trackMcpConfigUpdated,\n    trackDownloadTrajectoryButtonClicked,\n    trackConversationExported,\n    trackAutomationCreated,\n    trackAutomationExecuted,\n    trackAutomationDeleted,\n    trackAutomationDeactivated,\n    trackAutomationEdited,\n    trackAutomationExported,\n    trackAutomationImported,\n    trackBackendAdded,\n    trackOnboardingStarted,\n    trackOnboardingStepViewed,\n    trackOnboardingCompleted,\n    trackOnboardingSkipped,\n  };\n};\n"],"mappings":"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"}