@openhands/agent-canvas 1.8.0 → 1.9.0

package/dist/hooks/query/query-keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-keys.js","names":[],"sources":["../../../src/hooks/query/query-keys.ts"],"sourcesContent":["/**\n * Centralized query keys and cache configuration for TanStack Query.\n * Using constants ensures type safety and prevents typos.\n */\n\nimport { SettingsScope } from \"#/types/settings\";\n\nexport const QUERY_KEYS = {\n  /** Web client configuration from the server */\n  WEB_CLIENT_CONFIG: [\"web-client-config\"] as const,\n  /** Same-origin OpenHands app cookie authentication status */\n  MAIN_APP_COOKIE_AUTH: [\"main-app-cookie-auth\"] as const,\n} as const;\n\nexport const SETTINGS_QUERY_KEYS = {\n  all: [\"settings\"] as const,\n  byScope: (scope: SettingsScope) => [\"settings\", scope] as const,\n  personal: () => [\"settings\", \"personal\"] as const,\n} as const;\n\nexport const LLM_PROFILES_QUERY_KEYS = {\n  all: [\"llm-profiles\"] as const,\n} as const;\n\nexport const AGENT_PROFILES_QUERY_KEYS = {\n  all: [\"agent-profiles\"] as const,\n} as const;\n\n/** Fail fast when older backends lack the profile endpoint. */\nexport const AGENT_PROFILES_RETRY_OPTIONS = {\n  retry: false,\n} as const;\n\nexport const LLM_SUBSCRIPTION_QUERY_KEYS = {\n  all: [\"llm-subscription\"] as const,\n  openaiStatus: [\"llm-subscription\", \"openai\", \"status\"] as const,\n  openaiModels: [\"llm-subscription\", \"openai\", \"models\"] as const,\n} as const;\n\nexport const LOCAL_WORKSPACES_QUERY_KEYS = {\n  all: [\"local-workspaces\"] as const,\n} as const;\n\nexport const PLUGINS_QUERY_KEYS = {\n  /** Dynamic marketplace catalog (used by `use-plugins-marketplace`). */\n  marketplace: [\"plugins-marketplace\"] as const,\n  /** Installed plugins from the local agent-server. */\n  installed: [\"plugins-installed\"] as const,\n  /** Locally-discovered ambient plugins (used by `use-local-plugins`). */\n  local: [\"plugins-local\"] as const,\n} as const;\n\nexport const APP_UPDATE_QUERY_KEYS = {\n  /** Latest published @openhands/agent-canvas version (npm `latest` dist-tag). */\n  latestVersion: [\"agent-canvas-latest-version\"] as const,\n} as const;\n\n/** Cache configuration shared across all config-related queries */\nexport const CONFIG_CACHE_OPTIONS = {\n  staleTime: 1000 * 60 * 5, // 5 minutes\n  gcTime: 1000 * 60 * 15, // 15 minutes\n} as const;\n\nexport type QueryKeys = (typeof QUERY_KEYS)[keyof typeof QUERY_KEYS];\n"],"mappings":";AAOA,IAAa,IAAa;CAExB,mBAAmB,CAAC,mBAAmB;CAEvC,sBAAsB,CAAC,sBAAsB;AAC/C,GAEa,IAAsB;CACjC,KAAK,CAAC,UAAU;CAChB,UAAU,MAAyB,CAAC,YAAY,CAAK;CACrD,gBAAgB,CAAC,YAAY,UAAU;AACzC,GAEa,IAA0B,EACrC,KAAK,CAAC,cAAc,EACtB,GAEa,IAA4B,EACvC,KAAK,CAAC,gBAAgB,EACxB,GAGa,IAA+B,EAC1C,OAAO,GACT,GAEa,IAA8B;CACzC,KAAK,CAAC,kBAAkB;CACxB,cAAc;EAAC;EAAoB;EAAU;CAAQ;CACrD,cAAc;EAAC;EAAoB;EAAU;CAAQ;AACvD,GAEa,IAA8B,EACzC,KAAK,CAAC,kBAAkB,EAC1B,GAEa,IAAqB;CAEhC,aAAa,CAAC,qBAAqB;CAEnC,WAAW,CAAC,mBAAmB;CAE/B,OAAO,CAAC,eAAe;AACzB,GAEa,IAAwB,EAEnC,eAAe,CAAC,6BAA6B,EAC/C,GAGa,IAAuB;CAClC,WAAW,MAAO,KAAK;CACvB,QAAQ,MAAO,KAAK;AACtB"}
+{"version":3,"file":"query-keys.js","names":[],"sources":["../../../src/hooks/query/query-keys.ts"],"sourcesContent":["/**\n * Centralized query keys and cache configuration for TanStack Query.\n * Using constants ensures type safety and prevents typos.\n */\n\nimport { SettingsScope } from \"#/types/settings\";\n\nexport const QUERY_KEYS = {\n  /** Web client configuration from the server */\n  WEB_CLIENT_CONFIG: [\"web-client-config\"] as const,\n  /** Same-origin OpenHands app cookie authentication status */\n  MAIN_APP_COOKIE_AUTH: [\"main-app-cookie-auth\"] as const,\n} as const;\n\nexport const SETTINGS_QUERY_KEYS = {\n  all: [\"settings\"] as const,\n  byScope: (scope: SettingsScope) => [\"settings\", scope] as const,\n  personal: () => [\"settings\", \"personal\"] as const,\n} as const;\n\nexport const LLM_PROFILES_QUERY_KEYS = {\n  all: [\"llm-profiles\"] as const,\n} as const;\n\nexport const AGENT_PROFILES_QUERY_KEYS = {\n  all: [\"agent-profiles\"] as const,\n} as const;\n\n/** Fail fast when older backends lack the profile endpoint. */\nexport const AGENT_PROFILES_RETRY_OPTIONS = {\n  retry: false,\n} as const;\n\nexport const LLM_SUBSCRIPTION_QUERY_KEYS = {\n  all: [\"llm-subscription\"] as const,\n  openaiStatus: [\"llm-subscription\", \"openai\", \"status\"] as const,\n  openaiModels: [\"llm-subscription\", \"openai\", \"models\"] as const,\n} as const;\n\nexport const LOCAL_WORKSPACES_QUERY_KEYS = {\n  all: [\"local-workspaces\"] as const,\n} as const;\n\nexport const PLUGINS_QUERY_KEYS = {\n  /** Dynamic marketplace catalog (used by `use-plugins-marketplace`). */\n  marketplace: [\"plugins-marketplace\"] as const,\n  /** Installed plugins from the local agent-server. */\n  installed: [\"plugins-installed\"] as const,\n  /** Locally-discovered ambient plugins (used by `use-local-plugins`). */\n  local: [\"plugins-local\"] as const,\n} as const;\n\nexport const SETUP_QUERY_KEYS = {\n  /** What the deployment supports. The same answer for every setup entry. */\n  capabilities: () => [\"setup-capabilities\"] as const,\n} as const;\n\nexport const APP_UPDATE_QUERY_KEYS = {\n  /** Latest published @openhands/agent-canvas version (npm `latest` dist-tag). */\n  latestVersion: [\"agent-canvas-latest-version\"] as const,\n} as const;\n\n/** Cache configuration shared across all config-related queries */\nexport const CONFIG_CACHE_OPTIONS = {\n  staleTime: 1000 * 60 * 5, // 5 minutes\n  gcTime: 1000 * 60 * 15, // 15 minutes\n} as const;\n\nexport type QueryKeys = (typeof QUERY_KEYS)[keyof typeof QUERY_KEYS];\n"],"mappings":";AAOA,IAAa,IAAa;CAExB,mBAAmB,CAAC,mBAAmB;CAEvC,sBAAsB,CAAC,sBAAsB;AAC/C,GAEa,IAAsB;CACjC,KAAK,CAAC,UAAU;CAChB,UAAU,MAAyB,CAAC,YAAY,CAAK;CACrD,gBAAgB,CAAC,YAAY,UAAU;AACzC,GAEa,IAA0B,EACrC,KAAK,CAAC,cAAc,EACtB,GAEa,IAA4B,EACvC,KAAK,CAAC,gBAAgB,EACxB,GAGa,IAA+B,EAC1C,OAAO,GACT,GAEa,IAA8B;CACzC,KAAK,CAAC,kBAAkB;CACxB,cAAc;EAAC;EAAoB;EAAU;CAAQ;CACrD,cAAc;EAAC;EAAoB;EAAU;CAAQ;AACvD,GAEa,IAA8B,EACzC,KAAK,CAAC,kBAAkB,EAC1B,GAEa,IAAqB;CAEhC,aAAa,CAAC,qBAAqB;CAEnC,WAAW,CAAC,mBAAmB;CAE/B,OAAO,CAAC,eAAe;AACzB,GAOa,IAAwB,EAEnC,eAAe,CAAC,6BAA6B,EAC/C,GAGa,IAAuB;CAClC,WAAW,MAAO,KAAK;CACvB,QAAQ,MAAO,KAAK;AACtB"}

package/dist/hooks/query/use-manifest-capabilities.d.ts

@@ -0,0 +1,21 @@
+import { type SetupCapabilitySupport } from "#/manifests/manifest-capabilities";
+import type { DeploymentCapabilities, SetupEntry } from "#/manifests/types";
+export interface SetupCapabilitiesResult {
+    /** The discovery response, or null when there is nothing to report. */
+    capabilities: DeploymentCapabilities | null;
+    supported: SetupCapabilitySupport;
+    /** Which requirements a `false` verdict came from; empty otherwise. */
+    unmet: string[];
+    isLoading: boolean;
+}
+/**
+ * Ask the deployment what it supports, then compare that against what the
+ * manifest requires.
+ *
+ * A deployment that does not answer resolves to "unknown" rather than
+ * unsupported. Discovery is not implemented on every deployment yet, and
+ * refusing to render on a failed probe would block every manifest on the ones
+ * that simply cannot be asked. Nothing is resolved into the form in that case
+ * either, so the manifest's own defaults stand.
+ */
+export declare function useSetupCapabilities(entry: SetupEntry): SetupCapabilitiesResult;

package/dist/hooks/query/use-manifest-prerequisites.d.ts

@@ -0,0 +1,24 @@
+import { type IntegrationCatalogEntry as MarketplaceEntry } from "@openhands/extensions/integrations";
+import type { SetupEntry, SetupIntegrationRequirement } from "#/manifests/types";
+export interface MissingSetupIntegration {
+    id: string;
+    requirement: SetupIntegrationRequirement;
+    /** The catalog entry, when the id resolves to one. */
+    entry: MarketplaceEntry | null;
+}
+export interface SetupPrerequisitesResult {
+    /** Unconnected integrations the manifest declares as required. */
+    blockingIntegrations: MissingSetupIntegration[];
+    /** Unconnected integrations the manifest is willing to proceed without. */
+    warningIntegrations: MissingSetupIntegration[];
+    isBlocked: boolean;
+    isLoading: boolean;
+}
+/**
+ * Stage 3 — which of the accounts this manifest needs are already connected.
+ *
+ * A requirement is blocking unless it opts out with `required: false`, which is
+ * the manifest's way of saying the integration can be connected later, during
+ * setup itself.
+ */
+export declare function useSetupPrerequisites(entry: SetupEntry): SetupPrerequisitesResult;

package/dist/hooks/use-llm-configured.cjs

@@ -1,2 +1,2 @@
-require("../_virtual/_rolldown/runtime.cjs");const e=require("./query/query-keys.cjs"),t=require("../node_modules/@tanstack/react-query/build/modern/useQuery.cjs"),n=require("../contexts/active-backend-context.cjs"),r=require("../api/profiles-service/profiles-service.api.cjs"),i=require("../constants/llm-subscription.cjs"),a=require("./query/use-llm-profiles.cjs"),o=require("./query/use-settings.cjs"),s=require("./use-active-agent-profile.cjs"),c=require("./query/use-config.cjs"),l=require("../utils/settings-utils.cjs");function u(){let{data:u,isLoading:d,isError:f}=o.useSettings(),{data:p,isLoading:m,isError:h}=c.useConfig(),{data:g,isLoading:_,isError:v}=a.useLlmProfiles(),{backend:y,orgId:b}=n.useActiveBackend(),x=y.kind===`local`,{activeProfile:S,isLoading:C}=s.useActiveAgentProfile(),w=(S?.agent_kind??u?.agent_settings?.agent_kind)===`acp`,T=u?.llm_api_key_set===!0,E=S?.agent_kind===`openhands`?S.llm_profile_ref:void 0,D=(E?g?.profiles.find(e=>e.name===E):void 0)??g?.profiles.find(e=>e.name===g?.active_profile),O=D?.api_key_set===!0,k=x&&!!D&&!O,{data:A,isLoading:j,isError:M}=t.useQuery({queryKey:[...e.LLM_PROFILES_QUERY_KEYS.all,y.id,b,`detail`,D?.name],queryFn:()=>r.default.getProfile(D.name),...e.CONFIG_CACHE_OPTIONS,enabled:k,meta:{disableToast:!0}}),N=k&&i.isSubscriptionLlmConfig(A?.config),P=l.isSettingsPageHidden(`/settings/llm`,p?.feature_flags);return{isConfigured:w||P||(x?O||N:T),isLoading:d||f&&!u||m||h&&!p||_||v&&!g||C||k&&(j||M&&!A)}}exports.useLlmConfigured=u;
+require("../_virtual/_rolldown/runtime.cjs");const e=require("./query/query-keys.cjs"),t=require("../node_modules/@tanstack/react-query/build/modern/useQuery.cjs"),n=require("../contexts/active-backend-context.cjs"),r=require("../api/profiles-service/profiles-service.api.cjs"),i=require("../constants/llm-subscription.cjs"),a=require("./query/use-llm-profiles.cjs"),o=require("./query/use-settings.cjs");require("../api/agent-profiles-service/agent-profiles-service.api.cjs");const s=require("./use-active-agent-profile.cjs"),c=require("./query/use-config.cjs"),l=require("../utils/settings-utils.cjs");function u(){let{data:u,isLoading:d,isError:f}=o.useSettings(),{data:p,isLoading:m,isError:h}=c.useConfig(),{data:g,isLoading:_,isError:v}=a.useLlmProfiles(),{backend:y,orgId:b}=n.useActiveBackend(),x=y.kind===`local`,{activeProfile:S,isLoading:C}=s.useActiveAgentProfile(),w=(S?.agent_kind??u?.agent_settings?.agent_kind)===`acp`,T=u?.llm_api_key_set===!0,E=S?.agent_kind===`openhands`&&!(x&&S.name==="default")?S.llm_profile_ref:void 0,D=(E?g?.profiles.find(e=>e.name===E):void 0)??g?.profiles.find(e=>e.name===g?.active_profile),O=D?.api_key_set===!0,k=x&&!!D&&!O,{data:A,isLoading:j,isError:M}=t.useQuery({queryKey:[...e.LLM_PROFILES_QUERY_KEYS.all,y.id,b,`detail`,D?.name],queryFn:()=>r.default.getProfile(D.name),...e.CONFIG_CACHE_OPTIONS,enabled:k,meta:{disableToast:!0}}),N=k&&i.isSubscriptionLlmConfig(A?.config),P=l.isSettingsPageHidden(`/settings/llm`,p?.feature_flags);return{isConfigured:w||P||(x?O||N:T),isLoading:d||f&&!u||m||h&&!p||_||v&&!g||C||k&&(j||M&&!A)}}exports.useLlmConfigured=u;
 //# sourceMappingURL=use-llm-configured.cjs.map

package/dist/hooks/use-llm-configured.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-llm-configured.cjs","names":[],"sources":["../../src/hooks/use-llm-configured.ts"],"sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport { useSettings } from \"#/hooks/query/use-settings\";\nimport { useConfig } from \"#/hooks/query/use-config\";\nimport { useLlmProfiles } from \"#/hooks/query/use-llm-profiles\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { useActiveAgentProfile } from \"#/hooks/use-active-agent-profile\";\nimport { isSettingsPageHidden } from \"#/utils/settings-utils\";\nimport ProfilesService from \"#/api/profiles-service/profiles-service.api\";\nimport {\n  CONFIG_CACHE_OPTIONS,\n  LLM_PROFILES_QUERY_KEYS,\n} from \"#/hooks/query/query-keys\";\nimport { isSubscriptionLlmConfig } from \"#/constants/llm-subscription\";\n\ninterface LlmConfiguredResult {\n  /**\n   * True when the active backend's agent has a usable LLM:\n   * - ACP agents own their LLM via a subprocess, so they never need a key.\n   * - OpenHands agents are ready only once an LLM API key has been saved.\n   * - When the LLM settings page is hidden by a feature flag there is no\n   *   place to finish setup, so we treat the LLM as configured to avoid\n   *   surfacing an actionless warning.\n   */\n  isConfigured: boolean;\n  /**\n   * True while the configured/unconfigured state is indeterminate — either\n   * settings/config are still resolving, or a fetch failed and left us with no\n   * data to decide from. Consumers should render nothing in this state so a\n   * warning doesn't flash before data loads or on a transient network error.\n   */\n  isLoading: boolean;\n}\n\n/**\n * Reports whether the active backend's agent has an LLM ready to run\n * conversations. Surfaces the gap left by the onboarding \"Skip for now\" path,\n * which persists no settings — leaving an OpenHands agent without an API key.\n */\nexport function useLlmConfigured(): LlmConfiguredResult {\n  const {\n    data: settings,\n    isLoading: settingsLoading,\n    isError: settingsError,\n  } = useSettings();\n  const {\n    data: config,\n    isLoading: configLoading,\n    isError: configError,\n  } = useConfig();\n  const {\n    data: profilesData,\n    isLoading: profilesLoading,\n    isError: profilesError,\n  } = useLlmProfiles();\n  const { backend, orgId } = useActiveBackend();\n  const isLocal = backend.kind === \"local\";\n\n  // The active AgentProfile is the current agent — an ACP profile owns its LLM\n  // via the subprocess and never needs an API key. Fall back to the global\n  // agent settings only while the profile list loads.\n  const {\n    activeProfile: activeAgentProfile,\n    isLoading: activeAgentProfileLoading,\n  } = useActiveAgentProfile();\n  const activeAgentKind = activeAgentProfile?.agent_kind;\n  const isAcpAgent =\n    (activeAgentKind ?? settings?.agent_settings?.agent_kind) === \"acp\";\n  const hasApiKey = settings?.llm_api_key_set === true;\n  // The LLM that will actually power the next conversation is the profile the\n  // active AGENT profile references (`llm_profile_ref`) — conversations launch\n  // from the agent profile, not the standalone \"active LLM profile\".\n  const referencedLlmProfileName =\n    activeAgentProfile?.agent_kind === \"openhands\"\n      ? activeAgentProfile.llm_profile_ref\n      : undefined;\n  const referencedProfile = referencedLlmProfileName\n    ? profilesData?.profiles.find(\n        (profile) => profile.name === referencedLlmProfileName,\n      )\n    : undefined;\n  // Fall back to the active LLM profile when the ref is absent (list loading,\n  // or an agent profile without a ref) OR stale (names a profile that no longer\n  // exists). This mirrors the launch-time fallback in `useCreateConversation`,\n  // which drops a stale-ref profile launch to an `agent_settings` launch on the\n  // active LLM. Without this fallback the two contradict each other: launch\n  // succeeds via the fallback, but this hook reports `isConfigured: false` and\n  // spuriously disables the composer + shows the banner — even inside a running\n  // conversation (VascoSch92 review, #1571).\n  const activeProfile =\n    referencedProfile ??\n    profilesData?.profiles.find(\n      (profile) => profile.name === profilesData?.active_profile,\n    );\n  const hasActiveProfileApiKey = activeProfile?.api_key_set === true;\n  const shouldLoadActiveProfileDetail =\n    isLocal && !!activeProfile && !hasActiveProfileApiKey;\n  const {\n    data: activeProfileDetail,\n    isLoading: activeProfileDetailLoading,\n    isError: activeProfileDetailError,\n  } = useQuery({\n    queryKey: [\n      ...LLM_PROFILES_QUERY_KEYS.all,\n      backend.id,\n      orgId,\n      \"detail\",\n      activeProfile?.name,\n    ],\n    queryFn: () => ProfilesService.getProfile(activeProfile!.name),\n    ...CONFIG_CACHE_OPTIONS,\n    enabled: shouldLoadActiveProfileDetail,\n    meta: { disableToast: true },\n  });\n  const hasActiveProfileSubscription =\n    shouldLoadActiveProfileDetail &&\n    isSubscriptionLlmConfig(\n      activeProfileDetail?.config as Record<string, unknown> | undefined,\n    );\n  const llmSettingsHidden = isSettingsPageHidden(\n    \"/settings/llm\",\n    config?.feature_flags,\n  );\n\n  // In local mode, profiles are the source of truth: a usable LLM must be\n  // backed by an active profile that still exists and is authenticated. API-key\n  // profiles use the list endpoint's api_key_set flag; subscription profiles\n  // intentionally have no key, so we inspect the active profile detail config.\n  // The raw settings key can be a stale copy left behind by a deleted profile\n  // (settings are not cleared on delete), so we don't count it here. Cloud\n  // backends don't use profiles and keep the settings-key signal.\n  const hasUsableActiveProfile =\n    hasActiveProfileApiKey || hasActiveProfileSubscription;\n  const hasUsableLlm = isLocal ? hasUsableActiveProfile : hasApiKey;\n\n  // Treat a fetch failure as indeterminate (same as loading) only when it\n  // leaves us with no data to decide from — otherwise a transient network\n  // error would surface the banner with the same urgency as a genuinely\n  // missing API key. A settings 404 is deliberately not covered here:\n  // `useSettings` maps it to DEFAULT_SETTINGS (no key, OpenHands agent) while\n  // keeping `isError` set, and that is exactly the new-user / \"Skip for now\"\n  // state the banner exists to catch — so we keep deciding from that data.\n  const settingsIndeterminate = settingsLoading || (settingsError && !settings);\n  const configIndeterminate = configLoading || (configError && !config);\n  // The active agent profile decides `isAcpAgent` and which LLM profile the\n  // next conversation runs; on a cold cache it's still loading, so decide\n  // nothing yet — otherwise an ACP agent (which needs no key) briefly reads as\n  // an unconfigured OpenHands agent and flashes the \"LLM not set up\" banner.\n  const agentProfileIndeterminate = activeAgentProfileLoading;\n  const profilesIndeterminate =\n    profilesLoading || (profilesError && !profilesData);\n  const activeProfileDetailIndeterminate =\n    shouldLoadActiveProfileDetail &&\n    (activeProfileDetailLoading ||\n      (activeProfileDetailError && !activeProfileDetail));\n\n  return {\n    isConfigured: isAcpAgent || llmSettingsHidden || hasUsableLlm,\n    isLoading:\n      settingsIndeterminate ||\n      configIndeterminate ||\n      profilesIndeterminate ||\n      agentProfileIndeterminate ||\n      activeProfileDetailIndeterminate,\n  };\n}\n"],"mappings":"8gBAsCA,SAAgB,GAAwC,CACtD,GAAM,CACJ,KAAM,EACN,UAAW,EACX,QAAS,GACP,EAAA,YAAY,EACV,CACJ,KAAM,EACN,UAAW,EACX,QAAS,GACP,EAAA,UAAU,EACR,CACJ,KAAM,EACN,UAAW,EACX,QAAS,GACP,EAAA,eAAe,EACb,CAAE,UAAS,SAAU,EAAA,iBAAiB,EACtC,EAAU,EAAQ,OAAS,QAK3B,CACJ,cAAe,EACf,UAAW,GACT,EAAA,sBAAsB,EAEpB,GADkB,GAAoB,YAEtB,GAAU,gBAAgB,cAAgB,MAC1D,EAAY,GAAU,kBAAoB,GAI1C,EACJ,GAAoB,aAAe,YAC/B,EAAmB,gBACnB,IAAA,GAcA,GAboB,EACtB,GAAc,SAAS,KACpB,GAAY,EAAQ,OAAS,CAChC,EACA,IAAA,KAWF,GAAc,SAAS,KACpB,GAAY,EAAQ,OAAS,GAAc,cAC9C,EACI,EAAyB,GAAe,cAAgB,GACxD,EACJ,GAAW,CAAC,CAAC,GAAiB,CAAC,EAC3B,CACJ,KAAM,EACN,UAAW,EACX,QAAS,GACP,EAAA,SAAS,CACX,SAAU,CACR,GAAG,EAAA,wBAAwB,IAC3B,EAAQ,GACR,EACA,SACA,GAAe,IACjB,EACA,YAAe,EAAA,QAAgB,WAAW,EAAe,IAAI,EAC7D,GAAG,EAAA,qBACH,QAAS,EACT,KAAM,CAAE,aAAc,EAAK,CAC7B,CAAC,EACK,EACJ,GACA,EAAA,wBACE,GAAqB,MACvB,EACI,EAAoB,EAAA,qBACxB,gBACA,GAAQ,aACV,EAkCA,MAAO,CACL,aAAc,GAAc,IAxBT,EADnB,GAA0B,EAC4B,GAyBtD,UAhB4B,GAAoB,GAAiB,CAAC,GACxC,GAAkB,GAAe,CAAC,GAO5D,GAAoB,GAAiB,CAAC,GAYpC,GAVF,IACC,GACE,GAA4B,CAAC,EAUlC,CACF"}
+{"version":3,"file":"use-llm-configured.cjs","names":[],"sources":["../../src/hooks/use-llm-configured.ts"],"sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport { useSettings } from \"#/hooks/query/use-settings\";\nimport { useConfig } from \"#/hooks/query/use-config\";\nimport { useLlmProfiles } from \"#/hooks/query/use-llm-profiles\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { useActiveAgentProfile } from \"#/hooks/use-active-agent-profile\";\nimport { isSettingsPageHidden } from \"#/utils/settings-utils\";\nimport ProfilesService from \"#/api/profiles-service/profiles-service.api\";\nimport { WELL_KNOWN_DEFAULT_AGENT_PROFILE_NAME } from \"#/api/agent-profiles-service/agent-profiles-service.api\";\nimport {\n  CONFIG_CACHE_OPTIONS,\n  LLM_PROFILES_QUERY_KEYS,\n} from \"#/hooks/query/query-keys\";\nimport { isSubscriptionLlmConfig } from \"#/constants/llm-subscription\";\n\ninterface LlmConfiguredResult {\n  /**\n   * True when the active backend's agent has a usable LLM:\n   * - ACP agents own their LLM via a subprocess, so they never need a key.\n   * - OpenHands agents are ready only once an LLM API key has been saved.\n   * - When the LLM settings page is hidden by a feature flag there is no\n   *   place to finish setup, so we treat the LLM as configured to avoid\n   *   surfacing an actionless warning.\n   */\n  isConfigured: boolean;\n  /**\n   * True while the configured/unconfigured state is indeterminate — either\n   * settings/config are still resolving, or a fetch failed and left us with no\n   * data to decide from. Consumers should render nothing in this state so a\n   * warning doesn't flash before data loads or on a transient network error.\n   */\n  isLoading: boolean;\n}\n\n/**\n * Reports whether the active backend's agent has an LLM ready to run\n * conversations. Surfaces the gap left by the onboarding \"Skip for now\" path,\n * which persists no settings — leaving an OpenHands agent without an API key.\n */\nexport function useLlmConfigured(): LlmConfiguredResult {\n  const {\n    data: settings,\n    isLoading: settingsLoading,\n    isError: settingsError,\n  } = useSettings();\n  const {\n    data: config,\n    isLoading: configLoading,\n    isError: configError,\n  } = useConfig();\n  const {\n    data: profilesData,\n    isLoading: profilesLoading,\n    isError: profilesError,\n  } = useLlmProfiles();\n  const { backend, orgId } = useActiveBackend();\n  const isLocal = backend.kind === \"local\";\n\n  // The active AgentProfile is the current agent — an ACP profile owns its LLM\n  // via the subprocess and never needs an API key. Fall back to the global\n  // agent settings only while the profile list loads.\n  const {\n    activeProfile: activeAgentProfile,\n    isLoading: activeAgentProfileLoading,\n  } = useActiveAgentProfile();\n  const activeAgentKind = activeAgentProfile?.agent_kind;\n  const isAcpAgent =\n    (activeAgentKind ?? settings?.agent_settings?.agent_kind) === \"acp\";\n  const hasApiKey = settings?.llm_api_key_set === true;\n  // The LLM that will actually power the next conversation is the profile the\n  // active AGENT profile references (`llm_profile_ref`) — conversations launch\n  // from the agent profile, not the standalone \"active LLM profile\".\n  // Except the local seeded `default` profile: `useCreateConversation` launches\n  // it via `agent_settings` on the ACTIVE LLM, not the seed's ref, so gating on\n  // that ref blocks launches that would have succeeded (#16193).\n  const referencedLlmProfileName =\n    activeAgentProfile?.agent_kind === \"openhands\" &&\n    !(\n      isLocal &&\n      activeAgentProfile.name === WELL_KNOWN_DEFAULT_AGENT_PROFILE_NAME\n    )\n      ? activeAgentProfile.llm_profile_ref\n      : undefined;\n  const referencedProfile = referencedLlmProfileName\n    ? profilesData?.profiles.find(\n        (profile) => profile.name === referencedLlmProfileName,\n      )\n    : undefined;\n  // Fall back to the active LLM profile when the ref is absent (list loading,\n  // or an agent profile without a ref) OR stale (names a profile that no longer\n  // exists). This mirrors the launch-time fallback in `useCreateConversation`,\n  // which drops a stale-ref profile launch to an `agent_settings` launch on the\n  // active LLM. Without this fallback the two contradict each other: launch\n  // succeeds via the fallback, but this hook reports `isConfigured: false` and\n  // spuriously disables the composer + shows the banner — even inside a running\n  // conversation (VascoSch92 review, #1571).\n  const activeProfile =\n    referencedProfile ??\n    profilesData?.profiles.find(\n      (profile) => profile.name === profilesData?.active_profile,\n    );\n  const hasActiveProfileApiKey = activeProfile?.api_key_set === true;\n  const shouldLoadActiveProfileDetail =\n    isLocal && !!activeProfile && !hasActiveProfileApiKey;\n  const {\n    data: activeProfileDetail,\n    isLoading: activeProfileDetailLoading,\n    isError: activeProfileDetailError,\n  } = useQuery({\n    queryKey: [\n      ...LLM_PROFILES_QUERY_KEYS.all,\n      backend.id,\n      orgId,\n      \"detail\",\n      activeProfile?.name,\n    ],\n    queryFn: () => ProfilesService.getProfile(activeProfile!.name),\n    ...CONFIG_CACHE_OPTIONS,\n    enabled: shouldLoadActiveProfileDetail,\n    meta: { disableToast: true },\n  });\n  const hasActiveProfileSubscription =\n    shouldLoadActiveProfileDetail &&\n    isSubscriptionLlmConfig(\n      activeProfileDetail?.config as Record<string, unknown> | undefined,\n    );\n  const llmSettingsHidden = isSettingsPageHidden(\n    \"/settings/llm\",\n    config?.feature_flags,\n  );\n\n  // In local mode, profiles are the source of truth: a usable LLM must be\n  // backed by an active profile that still exists and is authenticated. API-key\n  // profiles use the list endpoint's api_key_set flag; subscription profiles\n  // intentionally have no key, so we inspect the active profile detail config.\n  // The raw settings key can be a stale copy left behind by a deleted profile\n  // (settings are not cleared on delete), so we don't count it here. Cloud\n  // backends don't use profiles and keep the settings-key signal.\n  const hasUsableActiveProfile =\n    hasActiveProfileApiKey || hasActiveProfileSubscription;\n  const hasUsableLlm = isLocal ? hasUsableActiveProfile : hasApiKey;\n\n  // Treat a fetch failure as indeterminate (same as loading) only when it\n  // leaves us with no data to decide from — otherwise a transient network\n  // error would surface the banner with the same urgency as a genuinely\n  // missing API key. A settings 404 is deliberately not covered here:\n  // `useSettings` maps it to DEFAULT_SETTINGS (no key, OpenHands agent) while\n  // keeping `isError` set, and that is exactly the new-user / \"Skip for now\"\n  // state the banner exists to catch — so we keep deciding from that data.\n  const settingsIndeterminate = settingsLoading || (settingsError && !settings);\n  const configIndeterminate = configLoading || (configError && !config);\n  // The active agent profile decides `isAcpAgent` and which LLM profile the\n  // next conversation runs; on a cold cache it's still loading, so decide\n  // nothing yet — otherwise an ACP agent (which needs no key) briefly reads as\n  // an unconfigured OpenHands agent and flashes the \"LLM not set up\" banner.\n  const agentProfileIndeterminate = activeAgentProfileLoading;\n  const profilesIndeterminate =\n    profilesLoading || (profilesError && !profilesData);\n  const activeProfileDetailIndeterminate =\n    shouldLoadActiveProfileDetail &&\n    (activeProfileDetailLoading ||\n      (activeProfileDetailError && !activeProfileDetail));\n\n  return {\n    isConfigured: isAcpAgent || llmSettingsHidden || hasUsableLlm,\n    isLoading:\n      settingsIndeterminate ||\n      configIndeterminate ||\n      profilesIndeterminate ||\n      agentProfileIndeterminate ||\n      activeProfileDetailIndeterminate,\n  };\n}\n"],"mappings":"4lBAuCA,SAAgB,GAAwC,CACtD,GAAM,CACJ,KAAM,EACN,UAAW,EACX,QAAS,GACP,EAAA,YAAY,EACV,CACJ,KAAM,EACN,UAAW,EACX,QAAS,GACP,EAAA,UAAU,EACR,CACJ,KAAM,EACN,UAAW,EACX,QAAS,GACP,EAAA,eAAe,EACb,CAAE,UAAS,SAAU,EAAA,iBAAiB,EACtC,EAAU,EAAQ,OAAS,QAK3B,CACJ,cAAe,EACf,UAAW,GACT,EAAA,sBAAsB,EAEpB,GADkB,GAAoB,YAEtB,GAAU,gBAAgB,cAAgB,MAC1D,EAAY,GAAU,kBAAoB,GAO1C,EACJ,GAAoB,aAAe,aACnC,EACE,GACA,EAAmB,OAAA,WAEjB,EAAmB,gBACnB,IAAA,GAcA,GAboB,EACtB,GAAc,SAAS,KACpB,GAAY,EAAQ,OAAS,CAChC,EACA,IAAA,KAWF,GAAc,SAAS,KACpB,GAAY,EAAQ,OAAS,GAAc,cAC9C,EACI,EAAyB,GAAe,cAAgB,GACxD,EACJ,GAAW,CAAC,CAAC,GAAiB,CAAC,EAC3B,CACJ,KAAM,EACN,UAAW,EACX,QAAS,GACP,EAAA,SAAS,CACX,SAAU,CACR,GAAG,EAAA,wBAAwB,IAC3B,EAAQ,GACR,EACA,SACA,GAAe,IACjB,EACA,YAAe,EAAA,QAAgB,WAAW,EAAe,IAAI,EAC7D,GAAG,EAAA,qBACH,QAAS,EACT,KAAM,CAAE,aAAc,EAAK,CAC7B,CAAC,EACK,EACJ,GACA,EAAA,wBACE,GAAqB,MACvB,EACI,EAAoB,EAAA,qBACxB,gBACA,GAAQ,aACV,EAkCA,MAAO,CACL,aAAc,GAAc,IAxBT,EADnB,GAA0B,EAC4B,GAyBtD,UAhB4B,GAAoB,GAAiB,CAAC,GACxC,GAAkB,GAAe,CAAC,GAO5D,GAAoB,GAAiB,CAAC,GAYpC,GAVF,IACC,GACE,GAA4B,CAAC,EAUlC,CACF"}

package/dist/hooks/use-llm-configured.js

@@ -5,12 +5,13 @@ import i from "../api/profiles-service/profiles-service.api.js";
 import { isSubscriptionLlmConfig as a } from "../constants/llm-subscription.js";
 import { useLlmProfiles as o } from "./query/use-llm-profiles.js";
 import { useSettings as s } from "./query/use-settings.js";
+import "../api/agent-profiles-service/agent-profiles-service.api.js";
 import { useActiveAgentProfile as c } from "./use-active-agent-profile.js";
 import { useConfig as l } from "./query/use-config.js";
 import { isSettingsPageHidden as u } from "../utils/settings-utils.js";
 //#region src/hooks/use-llm-configured.ts
 function d() {
-	let { data: d, isLoading: f, isError: p } = s(), { data: m, isLoading: h, isError: g } = l(), { data: _, isLoading: v, isError: y } = o(), { backend: b, orgId: x } = r(), S = b.kind === "local", { activeProfile: C, isLoading: w } = c(), T = (C?.agent_kind ?? d?.agent_settings?.agent_kind) === "acp", E = d?.llm_api_key_set === !0, D = C?.agent_kind === "openhands" ? C.llm_profile_ref : void 0, O = (D ? _?.profiles.find((e) => e.name === D) : void 0) ?? _?.profiles.find((e) => e.name === _?.active_profile), k = O?.api_key_set === !0, A = S && !!O && !k, { data: j, isLoading: M, isError: N } = n({
+	let { data: d, isLoading: f, isError: p } = s(), { data: m, isLoading: h, isError: g } = l(), { data: _, isLoading: v, isError: y } = o(), { backend: b, orgId: x } = r(), S = b.kind === "local", { activeProfile: C, isLoading: w } = c(), T = (C?.agent_kind ?? d?.agent_settings?.agent_kind) === "acp", E = d?.llm_api_key_set === !0, D = C?.agent_kind === "openhands" && !(S && C.name === "default") ? C.llm_profile_ref : void 0, O = (D ? _?.profiles.find((e) => e.name === D) : void 0) ?? _?.profiles.find((e) => e.name === _?.active_profile), k = O?.api_key_set === !0, A = S && !!O && !k, { data: j, isLoading: M, isError: N } = n({
 		queryKey: [
 			...t.all,
 			b.id,

package/dist/hooks/use-llm-configured.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-llm-configured.js","names":[],"sources":["../../src/hooks/use-llm-configured.ts"],"sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport { useSettings } from \"#/hooks/query/use-settings\";\nimport { useConfig } from \"#/hooks/query/use-config\";\nimport { useLlmProfiles } from \"#/hooks/query/use-llm-profiles\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { useActiveAgentProfile } from \"#/hooks/use-active-agent-profile\";\nimport { isSettingsPageHidden } from \"#/utils/settings-utils\";\nimport ProfilesService from \"#/api/profiles-service/profiles-service.api\";\nimport {\n  CONFIG_CACHE_OPTIONS,\n  LLM_PROFILES_QUERY_KEYS,\n} from \"#/hooks/query/query-keys\";\nimport { isSubscriptionLlmConfig } from \"#/constants/llm-subscription\";\n\ninterface LlmConfiguredResult {\n  /**\n   * True when the active backend's agent has a usable LLM:\n   * - ACP agents own their LLM via a subprocess, so they never need a key.\n   * - OpenHands agents are ready only once an LLM API key has been saved.\n   * - When the LLM settings page is hidden by a feature flag there is no\n   *   place to finish setup, so we treat the LLM as configured to avoid\n   *   surfacing an actionless warning.\n   */\n  isConfigured: boolean;\n  /**\n   * True while the configured/unconfigured state is indeterminate — either\n   * settings/config are still resolving, or a fetch failed and left us with no\n   * data to decide from. Consumers should render nothing in this state so a\n   * warning doesn't flash before data loads or on a transient network error.\n   */\n  isLoading: boolean;\n}\n\n/**\n * Reports whether the active backend's agent has an LLM ready to run\n * conversations. Surfaces the gap left by the onboarding \"Skip for now\" path,\n * which persists no settings — leaving an OpenHands agent without an API key.\n */\nexport function useLlmConfigured(): LlmConfiguredResult {\n  const {\n    data: settings,\n    isLoading: settingsLoading,\n    isError: settingsError,\n  } = useSettings();\n  const {\n    data: config,\n    isLoading: configLoading,\n    isError: configError,\n  } = useConfig();\n  const {\n    data: profilesData,\n    isLoading: profilesLoading,\n    isError: profilesError,\n  } = useLlmProfiles();\n  const { backend, orgId } = useActiveBackend();\n  const isLocal = backend.kind === \"local\";\n\n  // The active AgentProfile is the current agent — an ACP profile owns its LLM\n  // via the subprocess and never needs an API key. Fall back to the global\n  // agent settings only while the profile list loads.\n  const {\n    activeProfile: activeAgentProfile,\n    isLoading: activeAgentProfileLoading,\n  } = useActiveAgentProfile();\n  const activeAgentKind = activeAgentProfile?.agent_kind;\n  const isAcpAgent =\n    (activeAgentKind ?? settings?.agent_settings?.agent_kind) === \"acp\";\n  const hasApiKey = settings?.llm_api_key_set === true;\n  // The LLM that will actually power the next conversation is the profile the\n  // active AGENT profile references (`llm_profile_ref`) — conversations launch\n  // from the agent profile, not the standalone \"active LLM profile\".\n  const referencedLlmProfileName =\n    activeAgentProfile?.agent_kind === \"openhands\"\n      ? activeAgentProfile.llm_profile_ref\n      : undefined;\n  const referencedProfile = referencedLlmProfileName\n    ? profilesData?.profiles.find(\n        (profile) => profile.name === referencedLlmProfileName,\n      )\n    : undefined;\n  // Fall back to the active LLM profile when the ref is absent (list loading,\n  // or an agent profile without a ref) OR stale (names a profile that no longer\n  // exists). This mirrors the launch-time fallback in `useCreateConversation`,\n  // which drops a stale-ref profile launch to an `agent_settings` launch on the\n  // active LLM. Without this fallback the two contradict each other: launch\n  // succeeds via the fallback, but this hook reports `isConfigured: false` and\n  // spuriously disables the composer + shows the banner — even inside a running\n  // conversation (VascoSch92 review, #1571).\n  const activeProfile =\n    referencedProfile ??\n    profilesData?.profiles.find(\n      (profile) => profile.name === profilesData?.active_profile,\n    );\n  const hasActiveProfileApiKey = activeProfile?.api_key_set === true;\n  const shouldLoadActiveProfileDetail =\n    isLocal && !!activeProfile && !hasActiveProfileApiKey;\n  const {\n    data: activeProfileDetail,\n    isLoading: activeProfileDetailLoading,\n    isError: activeProfileDetailError,\n  } = useQuery({\n    queryKey: [\n      ...LLM_PROFILES_QUERY_KEYS.all,\n      backend.id,\n      orgId,\n      \"detail\",\n      activeProfile?.name,\n    ],\n    queryFn: () => ProfilesService.getProfile(activeProfile!.name),\n    ...CONFIG_CACHE_OPTIONS,\n    enabled: shouldLoadActiveProfileDetail,\n    meta: { disableToast: true },\n  });\n  const hasActiveProfileSubscription =\n    shouldLoadActiveProfileDetail &&\n    isSubscriptionLlmConfig(\n      activeProfileDetail?.config as Record<string, unknown> | undefined,\n    );\n  const llmSettingsHidden = isSettingsPageHidden(\n    \"/settings/llm\",\n    config?.feature_flags,\n  );\n\n  // In local mode, profiles are the source of truth: a usable LLM must be\n  // backed by an active profile that still exists and is authenticated. API-key\n  // profiles use the list endpoint's api_key_set flag; subscription profiles\n  // intentionally have no key, so we inspect the active profile detail config.\n  // The raw settings key can be a stale copy left behind by a deleted profile\n  // (settings are not cleared on delete), so we don't count it here. Cloud\n  // backends don't use profiles and keep the settings-key signal.\n  const hasUsableActiveProfile =\n    hasActiveProfileApiKey || hasActiveProfileSubscription;\n  const hasUsableLlm = isLocal ? hasUsableActiveProfile : hasApiKey;\n\n  // Treat a fetch failure as indeterminate (same as loading) only when it\n  // leaves us with no data to decide from — otherwise a transient network\n  // error would surface the banner with the same urgency as a genuinely\n  // missing API key. A settings 404 is deliberately not covered here:\n  // `useSettings` maps it to DEFAULT_SETTINGS (no key, OpenHands agent) while\n  // keeping `isError` set, and that is exactly the new-user / \"Skip for now\"\n  // state the banner exists to catch — so we keep deciding from that data.\n  const settingsIndeterminate = settingsLoading || (settingsError && !settings);\n  const configIndeterminate = configLoading || (configError && !config);\n  // The active agent profile decides `isAcpAgent` and which LLM profile the\n  // next conversation runs; on a cold cache it's still loading, so decide\n  // nothing yet — otherwise an ACP agent (which needs no key) briefly reads as\n  // an unconfigured OpenHands agent and flashes the \"LLM not set up\" banner.\n  const agentProfileIndeterminate = activeAgentProfileLoading;\n  const profilesIndeterminate =\n    profilesLoading || (profilesError && !profilesData);\n  const activeProfileDetailIndeterminate =\n    shouldLoadActiveProfileDetail &&\n    (activeProfileDetailLoading ||\n      (activeProfileDetailError && !activeProfileDetail));\n\n  return {\n    isConfigured: isAcpAgent || llmSettingsHidden || hasUsableLlm,\n    isLoading:\n      settingsIndeterminate ||\n      configIndeterminate ||\n      profilesIndeterminate ||\n      agentProfileIndeterminate ||\n      activeProfileDetailIndeterminate,\n  };\n}\n"],"mappings":";;;;;;;;;;;AAsCA,SAAgB,IAAwC;CACtD,IAAM,EACJ,MAAM,GACN,WAAW,GACX,SAAS,MACP,EAAY,GACV,EACJ,MAAM,GACN,WAAW,GACX,SAAS,MACP,EAAU,GACR,EACJ,MAAM,GACN,WAAW,GACX,SAAS,MACP,EAAe,GACb,EAAE,YAAS,aAAU,EAAiB,GACtC,IAAU,EAAQ,SAAS,SAK3B,EACJ,eAAe,GACf,WAAW,MACT,EAAsB,GAEpB,KADkB,GAAoB,cAEtB,GAAU,gBAAgB,gBAAgB,OAC1D,IAAY,GAAU,oBAAoB,IAI1C,IACJ,GAAoB,eAAe,cAC/B,EAAmB,kBACnB,KAAA,GAcA,KAboB,IACtB,GAAc,SAAS,MACpB,MAAY,EAAQ,SAAS,CAChC,IACA,KAAA,MAWF,GAAc,SAAS,MACpB,MAAY,EAAQ,SAAS,GAAc,cAC9C,GACI,IAAyB,GAAe,gBAAgB,IACxD,IACJ,KAAW,CAAC,CAAC,KAAiB,CAAC,GAC3B,EACJ,MAAM,GACN,WAAW,GACX,SAAS,MACP,EAAS;EACX,UAAU;GACR,GAAG,EAAwB;GAC3B,EAAQ;GACR;GACA;GACA,GAAe;EACjB;EACA,eAAe,EAAgB,WAAW,EAAe,IAAI;EAC7D,GAAG;EACH,SAAS;EACT,MAAM,EAAE,cAAc,GAAK;CAC7B,CAAC,GACK,IACJ,KACA,EACE,GAAqB,MACvB,GACI,IAAoB,EACxB,iBACA,GAAQ,aACV;CAkCA,OAAO;EACL,cAAc,KAAc,MAxBT,IADnB,KAA0B,IAC4B;EAyBtD,WAhB4B,KAAoB,KAAiB,CAAC,KACxC,KAAkB,KAAe,CAAC,KAO5D,KAAoB,KAAiB,CAAC,KAYpC,KAVF,MACC,KACE,KAA4B,CAAC;CAUlC;AACF"}
+{"version":3,"file":"use-llm-configured.js","names":[],"sources":["../../src/hooks/use-llm-configured.ts"],"sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport { useSettings } from \"#/hooks/query/use-settings\";\nimport { useConfig } from \"#/hooks/query/use-config\";\nimport { useLlmProfiles } from \"#/hooks/query/use-llm-profiles\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { useActiveAgentProfile } from \"#/hooks/use-active-agent-profile\";\nimport { isSettingsPageHidden } from \"#/utils/settings-utils\";\nimport ProfilesService from \"#/api/profiles-service/profiles-service.api\";\nimport { WELL_KNOWN_DEFAULT_AGENT_PROFILE_NAME } from \"#/api/agent-profiles-service/agent-profiles-service.api\";\nimport {\n  CONFIG_CACHE_OPTIONS,\n  LLM_PROFILES_QUERY_KEYS,\n} from \"#/hooks/query/query-keys\";\nimport { isSubscriptionLlmConfig } from \"#/constants/llm-subscription\";\n\ninterface LlmConfiguredResult {\n  /**\n   * True when the active backend's agent has a usable LLM:\n   * - ACP agents own their LLM via a subprocess, so they never need a key.\n   * - OpenHands agents are ready only once an LLM API key has been saved.\n   * - When the LLM settings page is hidden by a feature flag there is no\n   *   place to finish setup, so we treat the LLM as configured to avoid\n   *   surfacing an actionless warning.\n   */\n  isConfigured: boolean;\n  /**\n   * True while the configured/unconfigured state is indeterminate — either\n   * settings/config are still resolving, or a fetch failed and left us with no\n   * data to decide from. Consumers should render nothing in this state so a\n   * warning doesn't flash before data loads or on a transient network error.\n   */\n  isLoading: boolean;\n}\n\n/**\n * Reports whether the active backend's agent has an LLM ready to run\n * conversations. Surfaces the gap left by the onboarding \"Skip for now\" path,\n * which persists no settings — leaving an OpenHands agent without an API key.\n */\nexport function useLlmConfigured(): LlmConfiguredResult {\n  const {\n    data: settings,\n    isLoading: settingsLoading,\n    isError: settingsError,\n  } = useSettings();\n  const {\n    data: config,\n    isLoading: configLoading,\n    isError: configError,\n  } = useConfig();\n  const {\n    data: profilesData,\n    isLoading: profilesLoading,\n    isError: profilesError,\n  } = useLlmProfiles();\n  const { backend, orgId } = useActiveBackend();\n  const isLocal = backend.kind === \"local\";\n\n  // The active AgentProfile is the current agent — an ACP profile owns its LLM\n  // via the subprocess and never needs an API key. Fall back to the global\n  // agent settings only while the profile list loads.\n  const {\n    activeProfile: activeAgentProfile,\n    isLoading: activeAgentProfileLoading,\n  } = useActiveAgentProfile();\n  const activeAgentKind = activeAgentProfile?.agent_kind;\n  const isAcpAgent =\n    (activeAgentKind ?? settings?.agent_settings?.agent_kind) === \"acp\";\n  const hasApiKey = settings?.llm_api_key_set === true;\n  // The LLM that will actually power the next conversation is the profile the\n  // active AGENT profile references (`llm_profile_ref`) — conversations launch\n  // from the agent profile, not the standalone \"active LLM profile\".\n  // Except the local seeded `default` profile: `useCreateConversation` launches\n  // it via `agent_settings` on the ACTIVE LLM, not the seed's ref, so gating on\n  // that ref blocks launches that would have succeeded (#16193).\n  const referencedLlmProfileName =\n    activeAgentProfile?.agent_kind === \"openhands\" &&\n    !(\n      isLocal &&\n      activeAgentProfile.name === WELL_KNOWN_DEFAULT_AGENT_PROFILE_NAME\n    )\n      ? activeAgentProfile.llm_profile_ref\n      : undefined;\n  const referencedProfile = referencedLlmProfileName\n    ? profilesData?.profiles.find(\n        (profile) => profile.name === referencedLlmProfileName,\n      )\n    : undefined;\n  // Fall back to the active LLM profile when the ref is absent (list loading,\n  // or an agent profile without a ref) OR stale (names a profile that no longer\n  // exists). This mirrors the launch-time fallback in `useCreateConversation`,\n  // which drops a stale-ref profile launch to an `agent_settings` launch on the\n  // active LLM. Without this fallback the two contradict each other: launch\n  // succeeds via the fallback, but this hook reports `isConfigured: false` and\n  // spuriously disables the composer + shows the banner — even inside a running\n  // conversation (VascoSch92 review, #1571).\n  const activeProfile =\n    referencedProfile ??\n    profilesData?.profiles.find(\n      (profile) => profile.name === profilesData?.active_profile,\n    );\n  const hasActiveProfileApiKey = activeProfile?.api_key_set === true;\n  const shouldLoadActiveProfileDetail =\n    isLocal && !!activeProfile && !hasActiveProfileApiKey;\n  const {\n    data: activeProfileDetail,\n    isLoading: activeProfileDetailLoading,\n    isError: activeProfileDetailError,\n  } = useQuery({\n    queryKey: [\n      ...LLM_PROFILES_QUERY_KEYS.all,\n      backend.id,\n      orgId,\n      \"detail\",\n      activeProfile?.name,\n    ],\n    queryFn: () => ProfilesService.getProfile(activeProfile!.name),\n    ...CONFIG_CACHE_OPTIONS,\n    enabled: shouldLoadActiveProfileDetail,\n    meta: { disableToast: true },\n  });\n  const hasActiveProfileSubscription =\n    shouldLoadActiveProfileDetail &&\n    isSubscriptionLlmConfig(\n      activeProfileDetail?.config as Record<string, unknown> | undefined,\n    );\n  const llmSettingsHidden = isSettingsPageHidden(\n    \"/settings/llm\",\n    config?.feature_flags,\n  );\n\n  // In local mode, profiles are the source of truth: a usable LLM must be\n  // backed by an active profile that still exists and is authenticated. API-key\n  // profiles use the list endpoint's api_key_set flag; subscription profiles\n  // intentionally have no key, so we inspect the active profile detail config.\n  // The raw settings key can be a stale copy left behind by a deleted profile\n  // (settings are not cleared on delete), so we don't count it here. Cloud\n  // backends don't use profiles and keep the settings-key signal.\n  const hasUsableActiveProfile =\n    hasActiveProfileApiKey || hasActiveProfileSubscription;\n  const hasUsableLlm = isLocal ? hasUsableActiveProfile : hasApiKey;\n\n  // Treat a fetch failure as indeterminate (same as loading) only when it\n  // leaves us with no data to decide from — otherwise a transient network\n  // error would surface the banner with the same urgency as a genuinely\n  // missing API key. A settings 404 is deliberately not covered here:\n  // `useSettings` maps it to DEFAULT_SETTINGS (no key, OpenHands agent) while\n  // keeping `isError` set, and that is exactly the new-user / \"Skip for now\"\n  // state the banner exists to catch — so we keep deciding from that data.\n  const settingsIndeterminate = settingsLoading || (settingsError && !settings);\n  const configIndeterminate = configLoading || (configError && !config);\n  // The active agent profile decides `isAcpAgent` and which LLM profile the\n  // next conversation runs; on a cold cache it's still loading, so decide\n  // nothing yet — otherwise an ACP agent (which needs no key) briefly reads as\n  // an unconfigured OpenHands agent and flashes the \"LLM not set up\" banner.\n  const agentProfileIndeterminate = activeAgentProfileLoading;\n  const profilesIndeterminate =\n    profilesLoading || (profilesError && !profilesData);\n  const activeProfileDetailIndeterminate =\n    shouldLoadActiveProfileDetail &&\n    (activeProfileDetailLoading ||\n      (activeProfileDetailError && !activeProfileDetail));\n\n  return {\n    isConfigured: isAcpAgent || llmSettingsHidden || hasUsableLlm,\n    isLoading:\n      settingsIndeterminate ||\n      configIndeterminate ||\n      profilesIndeterminate ||\n      agentProfileIndeterminate ||\n      activeProfileDetailIndeterminate,\n  };\n}\n"],"mappings":";;;;;;;;;;;;AAuCA,SAAgB,IAAwC;CACtD,IAAM,EACJ,MAAM,GACN,WAAW,GACX,SAAS,MACP,EAAY,GACV,EACJ,MAAM,GACN,WAAW,GACX,SAAS,MACP,EAAU,GACR,EACJ,MAAM,GACN,WAAW,GACX,SAAS,MACP,EAAe,GACb,EAAE,YAAS,aAAU,EAAiB,GACtC,IAAU,EAAQ,SAAS,SAK3B,EACJ,eAAe,GACf,WAAW,MACT,EAAsB,GAEpB,KADkB,GAAoB,cAEtB,GAAU,gBAAgB,gBAAgB,OAC1D,IAAY,GAAU,oBAAoB,IAO1C,IACJ,GAAoB,eAAe,eACnC,EACE,KACA,EAAmB,SAAA,aAEjB,EAAmB,kBACnB,KAAA,GAcA,KAboB,IACtB,GAAc,SAAS,MACpB,MAAY,EAAQ,SAAS,CAChC,IACA,KAAA,MAWF,GAAc,SAAS,MACpB,MAAY,EAAQ,SAAS,GAAc,cAC9C,GACI,IAAyB,GAAe,gBAAgB,IACxD,IACJ,KAAW,CAAC,CAAC,KAAiB,CAAC,GAC3B,EACJ,MAAM,GACN,WAAW,GACX,SAAS,MACP,EAAS;EACX,UAAU;GACR,GAAG,EAAwB;GAC3B,EAAQ;GACR;GACA;GACA,GAAe;EACjB;EACA,eAAe,EAAgB,WAAW,EAAe,IAAI;EAC7D,GAAG;EACH,SAAS;EACT,MAAM,EAAE,cAAc,GAAK;CAC7B,CAAC,GACK,IACJ,KACA,EACE,GAAqB,MACvB,GACI,IAAoB,EACxB,iBACA,GAAQ,aACV;CAkCA,OAAO;EACL,cAAc,KAAc,MAxBT,IADnB,KAA0B,IAC4B;EAyBtD,WAhB4B,KAAoB,KAAiB,CAAC,KACxC,KAAkB,KAAe,CAAC,KAO5D,KAAoB,KAAiB,CAAC,KAYpC,KAVF,MACC,KACE,KAA4B,CAAC;CAUlC;AACF"}

package/dist/hooks/use-manifest-preflight.d.ts

@@ -0,0 +1,18 @@
+import { type MappedManifestErrors } from "#/manifests/manifest-error-map";
+import type { SetupEntry, SetupFormValues } from "#/manifests/types";
+/**
+ * Stage 6 — ask the service whether a draft is valid before anything is created.
+ *
+ * The service is the authoritative validator, so what it receives is the derived
+ * payload rather than the raw form values: what is checked is exactly what would
+ * be sent. Errors come back addressed by payload path and are translated back to
+ * fields through the map derived from that same builder.
+ *
+ * Resolves to null when there is no verdict — the entry has no draft to check,
+ * the deployment does not implement preflight, a newer run has already
+ * superseded this one, or the request failed. A missing preflight is not a
+ * failure: local checks and the create response still stand between the user
+ * and a bad configuration. Only a deployment without the endpoint is an
+ * expected failure though, so any other one is reported.
+ */
+export declare function useSetupPreflight(entry: SetupEntry): (formValues: SetupFormValues) => Promise<MappedManifestErrors | null>;

package/dist/hooks/use-tracking.cjs

@@ -1,2 +1,2 @@
-const e=require("../_virtual/_rolldown/runtime.cjs"),t=require("../api/agent-server-compatibility.cjs"),n=require("../services/telemetry-context.cjs"),r=require("../services/telemetry.cjs"),i=require("../contexts/active-backend-context.cjs"),a=require("./query/use-automation-sdk-version.cjs");let o=require("react");o=e.__toESM(o,1);var s=()=>{let{backend:e}=i.useActiveBackend(),s=a.useAutomationSdkVersion(),c=o.default.useCallback(()=>({backendKind:e.kind,agentServerVersion:e.kind===`local`?t.getCachedAgentServerVersion(e.host):null,automationSdkVersion:s??null}),[s,e.host,e.kind]);o.default.useEffect(()=>{r.setTelemetryBackendContext(c())},[c]);let l={current_url:window.location.href},u=(e,t={})=>{r.setTelemetryBackendContext(c()),r.trackEvent(e,{...l,...t})};return{trackLoginButtonClick:({provider:e})=>{u(`login_button_clicked`,{provider:e})},trackConversationCreated:({conversationId:e,taskId:t,hasRepository:n,gitProvider:r,hasWorkspace:i,workspaceMode:a,hasInitialQuery:o,agentType:s,hasParentConversation:c,entryPoint:l})=>{u(`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:a,has_initial_query:o,agent_type:s,has_parent_conversation:c,entry_point:l})},trackPushButtonClick:()=>{u(`push_button_clicked`)},trackPullButtonClick:()=>{u(`pull_button_clicked`)},trackCreatePrButtonClick:()=>{u(`create_pr_button_clicked`)},trackUserSignupCompleted:()=>{u(`user_signup_completed`,{signup_timestamp:new Date().toISOString()})},trackPrebuiltAutomationEnabled:({automationId:e,automationName:t,automationCategory:n})=>{u(`prebuilt_automation_enabled`,{automation_id:e,automation_name:t,automation_category:n})},trackInitialQuerySubmitted:({entryPoint:e,queryCharacterLength:t,replayJsonSize:n})=>{u(`initial_query_submitted`,{entry_point:e,query_character_length:t,replay_json_size:n})},trackUserMessageSent:({sessionMessageCount:e,currentMessageLength:t})=>{u(`user_message_sent`,{session_message_count:e,current_message_length:t})},trackDownloadVsCodeButtonClicked:()=>{u(`download_via_vscode_button_clicked`)},trackSettingsSaved:({llmModel:e,llmApiKeySet:t,searchApiKeySet:n,remoteRuntimeResourceFactor:r})=>{u(`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})=>{u(`mcp_config_updated`,{has_mcp_config:!0,sse_servers_count:e,stdio_servers_count:t})},trackDownloadTrajectoryButtonClicked:()=>{u(`download_trajectory_button_clicked`)},trackConversationExported:e=>{u(`conversation_exported`,{format:e})},trackAutomationCreatedButton:({backendKind:e})=>{u(`automation_created_button`,{backend_kind:e})},trackAutomationExecuted:({backendKind:e})=>{u(`automation_executed`,{backend_kind:e})},trackAutomationDeleted:({backendKind:e})=>{u(`automation_deleted`,{backend_kind:e})},trackAutomationDisableButton:({backendKind:e})=>{u(`automation_disable_button`,{backend_kind:e})},trackAutomationEdited:({backendKind:e})=>{u(`automation_edited`,{backend_kind:e})},trackAutomationExported:({backendKind:e})=>{u(`automation_exported`,{backend_kind:e})},trackAutomationImported:({backendKind:e})=>{u(`automation_imported`,{backend_kind:e})},trackBackendAdded:({backendKind:e,connectionMethod:t,hasApiKey:r,source:i,agentServerVersion:a,backendVersion:o})=>{u(`backend_added`,{...n.getBackendTelemetryProperties({backendKind:e,agentServerVersion:a,backendVersion:o,connectionMethod:t}),has_api_key:r,source:i})},trackOnboardingStarted:()=>{u(`onboarding_started`)},trackOnboardingStepViewed:({step:e,stepIndex:t,totalSteps:n,agent:r})=>{u(`onboarding_step_viewed`,{step:e,step_index:t,total_steps:n,agent:r})},trackOnboardingCompleted:({agent:e})=>{u(`onboarding_completed`,{agent:e})},trackOnboardingSkipped:({step:e,stepIndex:t,totalSteps:n,agent:r})=>{u(`onboarding_skipped`,{step:e,step_index:t,total_steps:n,agent:r})}}};exports.useTracking=s;
+const e=require("../_virtual/_rolldown/runtime.cjs"),t=require("../api/agent-server-compatibility.cjs"),n=require("../services/telemetry-context.cjs"),r=require("../services/telemetry.cjs"),i=require("../contexts/active-backend-context.cjs"),a=require("./query/use-automation-sdk-version.cjs");let o=require("react");o=e.__toESM(o,1);var s=()=>{let{backend:e}=i.useActiveBackend(),s=a.useAutomationSdkVersion(),c=o.default.useCallback(()=>({backendKind:e.kind,agentServerVersion:e.kind===`local`?t.getCachedAgentServerVersion(e.host):null,automationSdkVersion:s??null}),[s,e.host,e.kind]);o.default.useEffect(()=>{r.setTelemetryBackendContext(c())},[c]);let l={current_url:window.location.href},u=(e,t={})=>{r.setTelemetryBackendContext(c()),r.trackEvent(e,{...l,...t})};return{trackLoginButtonClick:({provider:e})=>{u(`login_button_clicked`,{provider:e})},trackConversationCreated:({conversationId:e,taskId:t,hasRepository:n,gitProvider:r,hasWorkspace:i,workspaceMode:a,hasInitialQuery:o,agentType:s,hasParentConversation:c,entryPoint:l})=>{u(`conversation_start_requested`,{conversation_id:e,task_id:t,is_start_task:e.startsWith(`task-`),has_repository:n,git_provider:r,has_workspace:i,workspace_mode:a,has_initial_query:o,agent_type:s,has_parent_conversation:c,entry_point:l})},trackPushButtonClick:()=>{u(`push_button_clicked`)},trackPullButtonClick:()=>{u(`pull_button_clicked`)},trackCreatePrButtonClick:()=>{u(`create_pr_button_clicked`)},trackUserSignupCompleted:()=>{u(`user_signup_completed`,{signup_timestamp:new Date().toISOString()})},trackPrebuiltAutomationEnabled:({automationId:e,automationName:t,automationCategory:n})=>{u(`prebuilt_automation_enabled`,{automation_id:e,automation_name:t,automation_category:n})},trackAutomationSetupOpened:({automationId:e})=>{u(`automation_setup_opened`,{automation_id:e})},trackAutomationSetupValidated:({automationId:e})=>{u(`automation_setup_validated`,{automation_id:e})},trackAutomationSetupCreated:({automationId:e,setupMode:t})=>{u(`automation_setup_created`,{automation_id:e,setup_mode:t})},trackAutomationSetupFailed:({automationId:e,setupMode:t})=>{u(`automation_setup_failed`,{automation_id:e,setup_mode:t})},trackInitialQuerySubmitted:({entryPoint:e,queryCharacterLength:t,replayJsonSize:n})=>{u(`initial_query_submitted`,{entry_point:e,query_character_length:t,replay_json_size:n})},trackUserMessageSent:({sessionMessageCount:e,currentMessageLength:t})=>{u(`user_message_sent`,{session_message_count:e,current_message_length:t})},trackDownloadVsCodeButtonClicked:()=>{u(`download_via_vscode_button_clicked`)},trackSettingsSaved:({llmModel:e,llmApiKeySet:t,searchApiKeySet:n,remoteRuntimeResourceFactor:r})=>{u(`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})=>{u(`mcp_config_updated`,{has_mcp_config:!0,sse_servers_count:e,stdio_servers_count:t})},trackDownloadTrajectoryButtonClicked:()=>{u(`download_trajectory_button_clicked`)},trackConversationExported:e=>{u(`conversation_exported`,{format:e})},trackAutomationCreatedButton:({backendKind:e})=>{u(`automation_created_button`,{backend_kind:e})},trackAutomationExecuted:({backendKind:e})=>{u(`automation_executed`,{backend_kind:e})},trackAutomationDeleted:({backendKind:e})=>{u(`automation_deleted`,{backend_kind:e})},trackAutomationDisableButton:({backendKind:e})=>{u(`automation_disable_button`,{backend_kind:e})},trackAutomationEdited:({backendKind:e})=>{u(`automation_edited`,{backend_kind:e})},trackAutomationExported:({backendKind:e})=>{u(`automation_exported`,{backend_kind:e})},trackAutomationImported:({backendKind:e})=>{u(`automation_imported`,{backend_kind:e})},trackBackendAdded:({backendKind:e,connectionMethod:t,hasApiKey:r,source:i,agentServerVersion:a,backendVersion:o})=>{u(`backend_added`,{...n.getBackendTelemetryProperties({backendKind:e,agentServerVersion:a,backendVersion:o,connectionMethod:t}),has_api_key:r,source:i})},trackOnboardingStarted:()=>{u(`onboarding_started`)},trackOnboardingStepViewed:({step:e,stepIndex:t,totalSteps:n,agent:r})=>{u(`onboarding_step_viewed`,{step:e,step_index:t,total_steps:n,agent:r})},trackOnboardingCompleted:({agent:e})=>{u(`onboarding_completed`,{agent:e})},trackOnboardingSkipped:({step:e,stepIndex:t,totalSteps:n,agent:r})=>{u(`onboarding_skipped`,{step:e,step_index:t,total_steps:n,agent:r})}}};exports.useTracking=s;
 //# 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 React from \"react\";\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 { getCachedAgentServerVersion } from \"#/api/agent-server-compatibility\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { useAutomationSdkVersion } from \"#/hooks/query/use-automation-sdk-version\";\nimport {\n  type BackendConnectionMethod,\n  getBackendTelemetryProperties,\n} from \"#/services/telemetry-context\";\nimport { setTelemetryBackendContext, 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 { backend } = useActiveBackend();\n  const automationSdkVersion = useAutomationSdkVersion();\n\n  const getBackendTelemetryContext = React.useCallback(\n    () => ({\n      backendKind: backend.kind,\n      agentServerVersion:\n        backend.kind === \"local\"\n          ? getCachedAgentServerVersion(backend.host)\n          : null,\n      automationSdkVersion: automationSdkVersion ?? null,\n    }),\n    [automationSdkVersion, backend.host, backend.kind],\n  );\n\n  React.useEffect(() => {\n    setTelemetryBackendContext(getBackendTelemetryContext());\n  }, [getBackendTelemetryContext]);\n\n  // Common properties included in all tracking events\n  const commonProperties = {\n    current_url: window.location.href,\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    setTelemetryBackendContext(getBackendTelemetryContext());\n    void trackEvent(event, { ...commonProperties, ...properties });\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 trackAutomationCreatedButton = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_created_button\", { 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 trackAutomationDisableButton = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_disable_button\", { 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    hasApiKey,\n    source,\n    agentServerVersion,\n    backendVersion,\n  }: {\n    backendKind: BackendKind;\n    connectionMethod: BackendConnectionMethod;\n    hasApiKey: boolean;\n    source?: CloudConnectionSource;\n    agentServerVersion?: string | null;\n    backendVersion?: string | null;\n  }) => {\n    track(\"backend_added\", {\n      ...getBackendTelemetryProperties({\n        backendKind,\n        agentServerVersion,\n        backendVersion,\n        connectionMethod,\n      }),\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    trackAutomationCreatedButton,\n    trackAutomationExecuted,\n    trackAutomationDeleted,\n    trackAutomationDisableButton,\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 React from \"react\";\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 { getCachedAgentServerVersion } from \"#/api/agent-server-compatibility\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { useAutomationSdkVersion } from \"#/hooks/query/use-automation-sdk-version\";\nimport {\n  type BackendConnectionMethod,\n  getBackendTelemetryProperties,\n} from \"#/services/telemetry-context\";\nimport { setTelemetryBackendContext, 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 { backend } = useActiveBackend();\n  const automationSdkVersion = useAutomationSdkVersion();\n\n  const getBackendTelemetryContext = React.useCallback(\n    () => ({\n      backendKind: backend.kind,\n      agentServerVersion:\n        backend.kind === \"local\"\n          ? getCachedAgentServerVersion(backend.host)\n          : null,\n      automationSdkVersion: automationSdkVersion ?? null,\n    }),\n    [automationSdkVersion, backend.host, backend.kind],\n  );\n\n  React.useEffect(() => {\n    setTelemetryBackendContext(getBackendTelemetryContext());\n  }, [getBackendTelemetryContext]);\n\n  // Common properties included in all tracking events\n  const commonProperties = {\n    current_url: window.location.href,\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    setTelemetryBackendContext(getBackendTelemetryContext());\n    void trackEvent(event, { ...commonProperties, ...properties });\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_start_requested\", {\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  /**\n   * The setup funnel: opened → validated → created, or failed.\n   *\n   * A manifest declares no analytics of its own, so the stages are the same for\n   * every entry and only the id it carries varies.\n   */\n  const trackAutomationSetupOpened = ({\n    automationId,\n  }: {\n    automationId: string;\n  }) => {\n    track(\"automation_setup_opened\", { automation_id: automationId });\n  };\n\n  const trackAutomationSetupValidated = ({\n    automationId,\n  }: {\n    automationId: string;\n  }) => {\n    track(\"automation_setup_validated\", { automation_id: automationId });\n  };\n\n  const trackAutomationSetupCreated = ({\n    automationId,\n    setupMode,\n  }: {\n    automationId: string;\n    setupMode: string;\n  }) => {\n    track(\"automation_setup_created\", {\n      automation_id: automationId,\n      setup_mode: setupMode,\n    });\n  };\n\n  const trackAutomationSetupFailed = ({\n    automationId,\n    setupMode,\n  }: {\n    automationId: string;\n    setupMode: string;\n  }) => {\n    track(\"automation_setup_failed\", {\n      automation_id: automationId,\n      setup_mode: setupMode,\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 trackAutomationCreatedButton = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_created_button\", { 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 trackAutomationDisableButton = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_disable_button\", { 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    hasApiKey,\n    source,\n    agentServerVersion,\n    backendVersion,\n  }: {\n    backendKind: BackendKind;\n    connectionMethod: BackendConnectionMethod;\n    hasApiKey: boolean;\n    source?: CloudConnectionSource;\n    agentServerVersion?: string | null;\n    backendVersion?: string | null;\n  }) => {\n    track(\"backend_added\", {\n      ...getBackendTelemetryProperties({\n        backendKind,\n        agentServerVersion,\n        backendVersion,\n        connectionMethod,\n      }),\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    trackAutomationSetupOpened,\n    trackAutomationSetupValidated,\n    trackAutomationSetupCreated,\n    trackAutomationSetupFailed,\n    trackInitialQuerySubmitted,\n    trackUserMessageSent,\n    trackDownloadVsCodeButtonClicked,\n    trackSettingsSaved,\n    trackMcpConfigUpdated,\n    trackDownloadTrajectoryButtonClicked,\n    trackConversationExported,\n    trackAutomationCreatedButton,\n    trackAutomationExecuted,\n    trackAutomationDeleted,\n    trackAutomationDisableButton,\n    trackAutomationEdited,\n    trackAutomationExported,\n    trackAutomationImported,\n    trackBackendAdded,\n    trackOnboardingStarted,\n    trackOnboardingStepViewed,\n    trackOnboardingCompleted,\n    trackOnboardingSkipped,\n  };\n};\n"],"mappings":"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"}

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

@@ -36,6 +36,20 @@ export declare const useTracking: () => {
         automationName: string;
         automationCategory?: string;
     }) => void;
+    trackAutomationSetupOpened: ({ automationId, }: {
+        automationId: string;
+    }) => void;
+    trackAutomationSetupValidated: ({ automationId, }: {
+        automationId: string;
+    }) => void;
+    trackAutomationSetupCreated: ({ automationId, setupMode, }: {
+        automationId: string;
+        setupMode: string;
+    }) => void;
+    trackAutomationSetupFailed: ({ automationId, setupMode, }: {
+        automationId: string;
+        setupMode: string;
+    }) => void;
     trackInitialQuerySubmitted: ({ entryPoint, queryCharacterLength, replayJsonSize, }: {
         entryPoint: string;
         queryCharacterLength: number;

package/dist/hooks/use-tracking.js

@@ -29,7 +29,7 @@ var s = () => {
 			d("login_button_clicked", { provider: e });
 		},
 		trackConversationCreated: ({ conversationId: e, taskId: t, hasRepository: n, gitProvider: r, hasWorkspace: i, workspaceMode: a, hasInitialQuery: o, agentType: s, hasParentConversation: c, entryPoint: l }) => {
-			d("conversation_created", {
+			d("conversation_start_requested", {
 				conversation_id: e,
 				task_id: t,
 				is_start_task: e.startsWith("task-"),
@@ -62,6 +62,24 @@ var s = () => {
 				automation_category: n
 			});
 		},
+		trackAutomationSetupOpened: ({ automationId: e }) => {
+			d("automation_setup_opened", { automation_id: e });
+		},
+		trackAutomationSetupValidated: ({ automationId: e }) => {
+			d("automation_setup_validated", { automation_id: e });
+		},
+		trackAutomationSetupCreated: ({ automationId: e, setupMode: t }) => {
+			d("automation_setup_created", {
+				automation_id: e,
+				setup_mode: t
+			});
+		},
+		trackAutomationSetupFailed: ({ automationId: e, setupMode: t }) => {
+			d("automation_setup_failed", {
+				automation_id: e,
+				setup_mode: t
+			});
+		},
 		trackInitialQuerySubmitted: ({ entryPoint: e, queryCharacterLength: t, replayJsonSize: n }) => {
 			d("initial_query_submitted", {
 				entry_point: e,

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

@@ -1 +1 @@
-{"version":3,"file":"use-tracking.js","names":[],"sources":["../../src/hooks/use-tracking.ts"],"sourcesContent":["import React from \"react\";\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 { getCachedAgentServerVersion } from \"#/api/agent-server-compatibility\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { useAutomationSdkVersion } from \"#/hooks/query/use-automation-sdk-version\";\nimport {\n  type BackendConnectionMethod,\n  getBackendTelemetryProperties,\n} from \"#/services/telemetry-context\";\nimport { setTelemetryBackendContext, 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 { backend } = useActiveBackend();\n  const automationSdkVersion = useAutomationSdkVersion();\n\n  const getBackendTelemetryContext = React.useCallback(\n    () => ({\n      backendKind: backend.kind,\n      agentServerVersion:\n        backend.kind === \"local\"\n          ? getCachedAgentServerVersion(backend.host)\n          : null,\n      automationSdkVersion: automationSdkVersion ?? null,\n    }),\n    [automationSdkVersion, backend.host, backend.kind],\n  );\n\n  React.useEffect(() => {\n    setTelemetryBackendContext(getBackendTelemetryContext());\n  }, [getBackendTelemetryContext]);\n\n  // Common properties included in all tracking events\n  const commonProperties = {\n    current_url: window.location.href,\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    setTelemetryBackendContext(getBackendTelemetryContext());\n    void trackEvent(event, { ...commonProperties, ...properties });\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 trackAutomationCreatedButton = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_created_button\", { 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 trackAutomationDisableButton = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_disable_button\", { 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    hasApiKey,\n    source,\n    agentServerVersion,\n    backendVersion,\n  }: {\n    backendKind: BackendKind;\n    connectionMethod: BackendConnectionMethod;\n    hasApiKey: boolean;\n    source?: CloudConnectionSource;\n    agentServerVersion?: string | null;\n    backendVersion?: string | null;\n  }) => {\n    track(\"backend_added\", {\n      ...getBackendTelemetryProperties({\n        backendKind,\n        agentServerVersion,\n        backendVersion,\n        connectionMethod,\n      }),\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    trackAutomationCreatedButton,\n    trackAutomationExecuted,\n    trackAutomationDeleted,\n    trackAutomationDisableButton,\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 React from \"react\";\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 { getCachedAgentServerVersion } from \"#/api/agent-server-compatibility\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { useAutomationSdkVersion } from \"#/hooks/query/use-automation-sdk-version\";\nimport {\n  type BackendConnectionMethod,\n  getBackendTelemetryProperties,\n} from \"#/services/telemetry-context\";\nimport { setTelemetryBackendContext, 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 { backend } = useActiveBackend();\n  const automationSdkVersion = useAutomationSdkVersion();\n\n  const getBackendTelemetryContext = React.useCallback(\n    () => ({\n      backendKind: backend.kind,\n      agentServerVersion:\n        backend.kind === \"local\"\n          ? getCachedAgentServerVersion(backend.host)\n          : null,\n      automationSdkVersion: automationSdkVersion ?? null,\n    }),\n    [automationSdkVersion, backend.host, backend.kind],\n  );\n\n  React.useEffect(() => {\n    setTelemetryBackendContext(getBackendTelemetryContext());\n  }, [getBackendTelemetryContext]);\n\n  // Common properties included in all tracking events\n  const commonProperties = {\n    current_url: window.location.href,\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    setTelemetryBackendContext(getBackendTelemetryContext());\n    void trackEvent(event, { ...commonProperties, ...properties });\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_start_requested\", {\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  /**\n   * The setup funnel: opened → validated → created, or failed.\n   *\n   * A manifest declares no analytics of its own, so the stages are the same for\n   * every entry and only the id it carries varies.\n   */\n  const trackAutomationSetupOpened = ({\n    automationId,\n  }: {\n    automationId: string;\n  }) => {\n    track(\"automation_setup_opened\", { automation_id: automationId });\n  };\n\n  const trackAutomationSetupValidated = ({\n    automationId,\n  }: {\n    automationId: string;\n  }) => {\n    track(\"automation_setup_validated\", { automation_id: automationId });\n  };\n\n  const trackAutomationSetupCreated = ({\n    automationId,\n    setupMode,\n  }: {\n    automationId: string;\n    setupMode: string;\n  }) => {\n    track(\"automation_setup_created\", {\n      automation_id: automationId,\n      setup_mode: setupMode,\n    });\n  };\n\n  const trackAutomationSetupFailed = ({\n    automationId,\n    setupMode,\n  }: {\n    automationId: string;\n    setupMode: string;\n  }) => {\n    track(\"automation_setup_failed\", {\n      automation_id: automationId,\n      setup_mode: setupMode,\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 trackAutomationCreatedButton = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_created_button\", { 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 trackAutomationDisableButton = ({\n    backendKind,\n  }: {\n    backendKind: BackendKind;\n  }) => {\n    track(\"automation_disable_button\", { 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    hasApiKey,\n    source,\n    agentServerVersion,\n    backendVersion,\n  }: {\n    backendKind: BackendKind;\n    connectionMethod: BackendConnectionMethod;\n    hasApiKey: boolean;\n    source?: CloudConnectionSource;\n    agentServerVersion?: string | null;\n    backendVersion?: string | null;\n  }) => {\n    track(\"backend_added\", {\n      ...getBackendTelemetryProperties({\n        backendKind,\n        agentServerVersion,\n        backendVersion,\n        connectionMethod,\n      }),\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    trackAutomationSetupOpened,\n    trackAutomationSetupValidated,\n    trackAutomationSetupCreated,\n    trackAutomationSetupFailed,\n    trackInitialQuerySubmitted,\n    trackUserMessageSent,\n    trackDownloadVsCodeButtonClicked,\n    trackSettingsSaved,\n    trackMcpConfigUpdated,\n    trackDownloadTrajectoryButtonClicked,\n    trackConversationExported,\n    trackAutomationCreatedButton,\n    trackAutomationExecuted,\n    trackAutomationDeleted,\n    trackAutomationDisableButton,\n    trackAutomationEdited,\n    trackAutomationExported,\n    trackAutomationImported,\n    trackBackendAdded,\n    trackOnboardingStarted,\n    trackOnboardingStepViewed,\n    trackOnboardingCompleted,\n    trackOnboardingSkipped,\n  };\n};\n"],"mappings":"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"}