@openhands/agent-canvas 1.14.0 → 1.16.0

package/dist/api/settings-service/settings-service.api.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"settings-service.api.cjs","names":[],"sources":["../../../src/api/settings-service/settings-service.api.ts"],"sourcesContent":["import { SettingsClient } from \"@openhands/typescript-client/clients\";\nimport type {\n  MCPConfigPatch,\n  MCPServer,\n  MCPServerPatch,\n} from \"@openhands/typescript-client\";\nimport { DEFAULT_SETTINGS } from \"#/services/settings\";\nimport { Settings, SettingsSchema, SettingsValue } from \"#/types/settings\";\nimport { stringRecord } from \"#/utils/mcp-config\";\nimport { getActiveBackend } from \"../backend-registry/active-store\";\nimport {\n  fetchCloudConversationSettingsSchema,\n  fetchCloudSettings,\n  fetchCloudSettingsSchema,\n  saveCloudSettings,\n} from \"../cloud/settings-service.api\";\nimport { getAgentServerClientOptions } from \"../agent-server-client-options\";\n\n/**\n * Fields the agent-server stores under `misc_settings.app_preferences` (see\n * SDK `openhands.sdk.settings.AppPreferences`). Mirrored here as a flat\n * partial of Settings so the rest of the frontend can keep treating them as\n * top-level keys (`settings.language`, `settings.disabled_skills`, …).\n */\nexport const APP_PREFERENCE_FIELDS = [\n  \"language\",\n  \"user_consents_to_analytics\",\n  \"enable_sound_notifications\",\n  \"git_user_name\",\n  \"git_user_email\",\n  \"title_llm_profile\",\n  \"disabled_skills\",\n] as const;\n\nexport type AppPreferenceField = (typeof APP_PREFERENCE_FIELDS)[number];\n\nexport type AppPreferences = Partial<Pick<Settings, AppPreferenceField>>;\n\n/**\n * Container for frontend-owned settings the agent doesn't interpret.\n * Mirrors the SDK `MiscSettings` model introduced in agent-server 1.27.\n *\n * Single nested category today (`app_preferences`). Adding a future\n * category (e.g. `ui_preferences`) is a non-breaking change for the wire\n * shape — it just adds another optional sibling here.\n */\nexport interface MiscSettings {\n  app_preferences?: AppPreferences;\n}\n\n/**\n * Response from GET /api/settings\n * Mirrors the SettingsResponse model in the agent server.\n */\nexport interface SettingsApiResponse {\n  agent_settings: Record<string, SettingsValue>;\n  conversation_settings: Record<string, SettingsValue>;\n  llm_api_key_is_set: boolean;\n  /**\n   * Frontend-owned settings the agent does not interpret (currently just\n   * `app_preferences`). Added in agent-server 1.27; earlier servers omit\n   * the field entirely, in which case the frontend falls back to defaults.\n   */\n  misc_settings?: MiscSettings;\n}\n\n/**\n * Request payload for PATCH /api/settings.\n *\n * `misc_settings_diff` is deep-merged into the persisted `misc_settings`\n * block, matching the semantics of `agent_settings_diff` /\n * `conversation_settings_diff`. A partial diff like\n * `{ app_preferences: { language: \"fr\" } }` updates only `language` and\n * leaves every other `app_preferences` field alone. Lists\n * (`disabled_skills`) are replaced wholesale rather than merged.\n */\nexport interface SettingsUpdateRequest {\n  agent_settings_diff?: Record<string, SettingsValue>;\n  conversation_settings_diff?: Record<string, SettingsValue>;\n  misc_settings_diff?: MiscSettings;\n  // Permit additional keys so this stays assignable to the underlying\n  // typescript-client SDK type, which uses `[key: string]: unknown` for\n  // forward compatibility.\n  [key: string]: unknown;\n}\n\nconst APP_PREFERENCE_FIELD_SET: ReadonlySet<string> = new Set(\n  APP_PREFERENCE_FIELDS,\n);\n\nconst isAppPreferenceField = (key: string): key is AppPreferenceField =>\n  APP_PREFERENCE_FIELD_SET.has(key);\n\n/**\n * Split known app-preference keys out of a save payload so callers can\n * route them through `misc_settings_diff.app_preferences` (local) or as\n * flat top-level keys (cloud), while the remaining fields flow into the\n * `agent_settings_diff` / `conversation_settings_diff` branches.\n */\nconst extractAppPreferences = (\n  input: Record<string, unknown>,\n): { extracted: AppPreferences; rest: Record<string, unknown> } => {\n  const extracted: AppPreferences = {};\n  const rest: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(input)) {\n    if (isAppPreferenceField(key)) {\n      (extracted as Record<string, unknown>)[key] = value;\n    } else {\n      rest[key] = value;\n    }\n  }\n  return { extracted, rest };\n};\n\n/**\n * Secret exposure mode for X-Expose-Secrets header.\n *\n * - undefined: Returns redacted secrets (\"**********\")\n * - \"encrypted\": Returns cipher-encrypted values (safe for frontend to round-trip)\n * - \"plaintext\": Returns raw secret values (backend use only!)\n */\nexport type ExposeSecretsMode = \"encrypted\" | \"plaintext\" | undefined;\n\nconst deepClone = <T>(value: T): T => JSON.parse(JSON.stringify(value)) as T;\n\nconst mergeRecords = (\n  base: Record<string, SettingsValue> | null | undefined,\n  next: Record<string, SettingsValue> | null | undefined,\n) => ({ ...(base ?? {}), ...(next ?? {}) });\n\n/**\n * Retry helper for API calls with exponential backoff.\n */\nasync function withRetry<T>(\n  fn: () => Promise<T>,\n  maxRetries: number = 3,\n  baseDelayMs: number = 500,\n): Promise<T> {\n  for (let attempt = 0; attempt < maxRetries; attempt += 1) {\n    try {\n      return await fn();\n    } catch (error) {\n      if (attempt >= maxRetries - 1) {\n        throw error;\n      }\n\n      const delay = baseDelayMs * 2 ** attempt;\n\n      await new Promise<void>((resolve) => {\n        setTimeout(resolve, delay);\n      });\n    }\n  }\n\n  throw new Error(\"Retry attempts exhausted\");\n}\n\n/**\n * In-memory cache for settings to avoid repeated network calls.\n * The cache is invalidated on save operations.\n */\nlet settingsCache: {\n  /** Settings with redacted secrets for display */\n  redacted: SettingsApiResponse | null;\n  /** Settings with encrypted secrets for conversation start */\n  encrypted: SettingsApiResponse | null;\n  /** Timestamp when the cache was last populated */\n  timestamp: number;\n} = {\n  redacted: null,\n  encrypted: null,\n  timestamp: 0,\n};\n\nconst CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes\n\nconst isCacheValid = () => Date.now() - settingsCache.timestamp < CACHE_TTL_MS;\n\nconst clearCache = () => {\n  settingsCache = { redacted: null, encrypted: null, timestamp: 0 };\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  !!value && typeof value === \"object\" && !Array.isArray(value);\n\nconst basicAuthHeader = (username: string, password: string): string => {\n  const token = btoa(`${username}:${password}`);\n  return `Basic ${token}`;\n};\n\nconst headersFromMcpAuth = (\n  auth: Record<string, unknown>,\n): Record<string, string> | null => {\n  switch (auth.strategy) {\n    case \"none\":\n      return {};\n    case \"api_key\": {\n      if (typeof auth.value !== \"string\" || !auth.value) return null;\n      const header =\n        typeof auth.header_name === \"string\" && auth.header_name\n          ? auth.header_name\n          : \"Authorization\";\n      const value =\n        header === \"Authorization\" ? `Bearer ${auth.value}` : auth.value;\n      return { [header]: value };\n    }\n    case \"bearer\":\n      if (typeof auth.value !== \"string\" || !auth.value) return null;\n      return { Authorization: `Bearer ${auth.value}` };\n    case \"basic\":\n      if (\n        typeof auth.username !== \"string\" ||\n        typeof auth.password !== \"string\"\n      ) {\n        return null;\n      }\n      return { Authorization: basicAuthHeader(auth.username, auth.password) };\n    case \"header\":\n      return stringRecord(auth.headers) ?? {};\n    case \"oauth2\": {\n      const tokens = isRecord(auth.state) ? auth.state.tokens : undefined;\n      if (!isRecord(tokens) || typeof tokens.access_token !== \"string\") {\n        return null;\n      }\n      return { Authorization: `Bearer ${tokens.access_token}` };\n    }\n    default:\n      return null;\n  }\n};\n\n/**\n * Convert SDK `auth` credentials to the cloud's header-only storage shape.\n *\n * The cloud settings endpoint applies `mcp_config` as a merge patch, so a\n * credential change must also tombstone the headers the previous credential\n * produced — otherwise stale secrets survive a strategy switch (e.g. an\n * api_key's custom header after moving to bearer). Stored headers that the\n * new credential still produces (via the patch's carried `headers` or the\n * converted auth) are left untouched; any other stored header is cleared.\n */\nconst cloudCompatibleMcpConfig = async (value: unknown): Promise<unknown> => {\n  if (!isRecord(value)) return value;\n\n  const hasWrapper = isRecord(value.mcpServers);\n  const serverMap: Record<string, unknown> = hasWrapper\n    ? (value.mcpServers as Record<string, unknown>)\n    : value;\n\n  const needsStoredCredential =\n    Object.values(serverMap).some(\n      (server) =>\n        isRecord(server) && isRecord(server.auth) && server.auth !== null,\n    ) && getActiveBackend().backend.kind === \"cloud\";\n\n  const storedHeadersByServer = new Map<string, Record<string, string>>();\n  if (needsStoredCredential) {\n    try {\n      const stored = await fetchCloudSettings();\n      const storedMcp = isRecord(stored.mcp_config) ? stored.mcp_config : {};\n      for (const [name, server] of Object.entries(storedMcp)) {\n        if (isRecord(server)) {\n          const headers = stringRecord(\n            (server as Record<string, unknown>).headers,\n          );\n          if (headers) storedHeadersByServer.set(name, headers);\n        }\n      }\n    } catch {\n      // Fall back to the patch-only conversion; a transient fetch failure\n      // must not block saving the user's explicit edits.\n    }\n  }\n\n  const converted = Object.fromEntries(\n    Object.entries(serverMap).map(([name, server]) => {\n      if (!isRecord(server)) return [name, server];\n      if (server.auth === null) {\n        const nextServer: Record<string, unknown> = {\n          ...server,\n          headers: null,\n        };\n        delete nextServer.auth;\n        return [name, nextServer];\n      }\n      if (!isRecord(server.auth)) return [name, server];\n\n      const authHeaders = headersFromMcpAuth(server.auth);\n      if (authHeaders === null) return [name, server];\n\n      const nextServer = { ...server };\n      const existingHeaders = stringRecord(server.headers) ?? {};\n      const mergedHeaders: Record<string, string | null> = {\n        ...existingHeaders,\n        ...authHeaders,\n      };\n\n      const storedHeaders = storedHeadersByServer.get(name);\n      if (storedHeaders) {\n        for (const key of Object.keys(storedHeaders)) {\n          if (!(key in mergedHeaders)) mergedHeaders[key] = null;\n        }\n      }\n\n      delete nextServer.auth;\n      if (Object.keys(mergedHeaders).length > 0) {\n        nextServer.headers = mergedHeaders;\n      } else {\n        delete nextServer.headers;\n      }\n      return [name, nextServer];\n    }),\n  );\n\n  return hasWrapper ? { ...value, mcpServers: converted } : converted;\n};\n\n/**\n * Transform API response into Settings object with derived fields.\n */\nconst transformApiResponse = (\n  response: SettingsApiResponse,\n): Partial<Settings> => {\n  const agentSettings = response.agent_settings ?? {};\n  const conversationSettings = response.conversation_settings ?? {};\n\n  const partial: Partial<Settings> = {\n    agent_settings: agentSettings,\n    conversation_settings: conversationSettings,\n    llm_api_key_set: response.llm_api_key_is_set,\n  };\n\n  // App-level user preferences come back nested under\n  // `misc_settings.app_preferences` from the local agent-server (added in\n  // 1.27, restructured into the `misc_settings` container in the follow-up\n  // refactor). Hoist them onto the flat Settings shape the rest of the\n  // frontend already speaks. Older servers omit the `misc_settings` field\n  // entirely; the migration helper invoked from `getSettings` promotes any\n  // leftover localStorage values to the server on first run, so the omitted\n  // case just falls back to defaults.\n  const prefs = response.misc_settings?.app_preferences;\n  if (prefs) {\n    for (const key of APP_PREFERENCE_FIELDS) {\n      const value = prefs[key];\n      if (value !== undefined) {\n        (partial as Record<string, unknown>)[key] = value;\n      }\n    }\n  }\n\n  return partial;\n};\n\n/**\n * Sync derived settings fields from agent_settings and conversation_settings.\n * This ensures backward compatibility with code that reads top-level fields.\n */\nconst syncDerivedSettings = (settings: Partial<Settings>): Settings => {\n  const agentSettings = mergeRecords(\n    DEFAULT_SETTINGS.agent_settings ?? {},\n    settings.agent_settings ?? {},\n  );\n  const conversationSettings = mergeRecords(\n    DEFAULT_SETTINGS.conversation_settings ?? {},\n    settings.conversation_settings ?? {},\n  );\n\n  const merged = {\n    ...deepClone(DEFAULT_SETTINGS),\n    ...settings,\n    provider_tokens_set: {\n      ...(DEFAULT_SETTINGS.provider_tokens_set ?? {}),\n      ...(settings.provider_tokens_set ?? {}),\n    },\n    agent_settings: agentSettings,\n    conversation_settings: conversationSettings,\n  } as Settings;\n\n  const llm = agentSettings.llm as Record<string, SettingsValue> | undefined;\n  const condenser = agentSettings.condenser as\n    | Record<string, SettingsValue>\n    | undefined;\n\n  if (typeof agentSettings.agent === \"string\") {\n    merged.agent = agentSettings.agent;\n  }\n  if (typeof llm?.model === \"string\" && llm.model.length > 0) {\n    merged.llm_model = llm.model;\n  }\n  if (typeof llm?.base_url === \"string\") {\n    merged.llm_base_url = llm.base_url;\n  }\n  // Note: api_key may be redacted (\"**********\") when fetched without expose header\n  // We don't sync it to top-level llm_api_key to avoid overwriting with redacted value\n  if (typeof condenser?.enabled === \"boolean\") {\n    merged.enable_default_condenser = condenser.enabled;\n  }\n  if (typeof condenser?.max_size === \"number\") {\n    merged.condenser_max_size = condenser.max_size;\n  }\n  if (typeof conversationSettings.confirmation_mode === \"boolean\") {\n    merged.confirmation_mode = conversationSettings.confirmation_mode;\n  }\n  if (\n    typeof conversationSettings.security_analyzer === \"string\" ||\n    conversationSettings.security_analyzer === null\n  ) {\n    merged.security_analyzer = conversationSettings.security_analyzer as\n      | string\n      | null;\n  }\n  if (typeof conversationSettings.max_iterations === \"number\") {\n    merged.max_iterations = conversationSettings.max_iterations;\n  }\n\n  merged.search_api_key_set = !!merged.search_api_key;\n\n  return merged;\n};\n\nclass SettingsService {\n  /**\n   * Fetch settings from the agent server API with retry logic.\n   *\n   * @param exposeSecrets - Controls how secrets are returned:\n   *   - undefined: Secrets are redacted (\"**********\") - safe for display\n   *   - \"encrypted\": Secrets are cipher-encrypted - safe for round-trip to start conversation\n   *   - \"plaintext\": Raw secrets - DO NOT USE from frontend\n   */\n  static async fetchSettingsFromApi(\n    exposeSecrets?: ExposeSecretsMode,\n  ): Promise<SettingsApiResponse> {\n    return withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).getSettings({\n        exposeSecrets,\n      }),\n    ) as Promise<SettingsApiResponse>;\n  }\n\n  /**\n   * Get settings for display (secrets are redacted).\n   * Uses in-memory cache for performance.\n   */\n  static async getSettings(): Promise<Settings> {\n    // Cloud uses a different settings shape (flat top-level fields\n    // including provider_tokens_set, llm_model, etc.). Branch out before\n    // touching the local-only cache: cloud responses bypass the local\n    // SettingsApiResponse shape and feed straight into syncDerivedSettings\n    // so cloud-native fields like provider_tokens_set reach the GUI's\n    // useUserProviders → useAppInstallations → useGitRepositories chain.\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      try {\n        const cloud = await withRetry(() => fetchCloudSettings());\n        return syncDerivedSettings(cloud);\n      } catch (error) {\n        console.warn(\"Failed to fetch cloud settings, using defaults:\", error);\n        return syncDerivedSettings({});\n      }\n    }\n\n    // Check cache first\n    if (isCacheValid() && settingsCache.redacted) {\n      return syncDerivedSettings(transformApiResponse(settingsCache.redacted));\n    }\n\n    try {\n      const response = await this.fetchSettingsFromApi();\n      settingsCache.redacted = response;\n      settingsCache.timestamp = Date.now();\n      return syncDerivedSettings(transformApiResponse(response));\n    } catch (error) {\n      // If API fails, return defaults\n      console.warn(\"Failed to fetch settings from API, using defaults:\", error);\n      return syncDerivedSettings({});\n    }\n  }\n\n  /**\n   * Get settings with encrypted secrets for starting conversations.\n   * The encrypted secrets can be passed to the start conversation API\n   * with secrets_encrypted=true for server-side decryption.\n   *\n   * @throws Error if encrypted settings cannot be fetched - conversations\n   *   should not start with broken/redacted credentials.\n   */\n  static async getSettingsForConversation(): Promise<{\n    agentSettings: Record<string, SettingsValue>;\n    conversationSettings: Record<string, SettingsValue>;\n    secretsEncrypted: boolean;\n  }> {\n    // Check cache first\n    if (isCacheValid() && settingsCache.encrypted) {\n      return {\n        agentSettings: settingsCache.encrypted.agent_settings,\n        conversationSettings: settingsCache.encrypted.conversation_settings,\n        secretsEncrypted: true,\n      };\n    }\n\n    // Fetch encrypted settings - this MUST succeed for conversations to work.\n    // Do not fall back to redacted settings as that would cause auth failures.\n    const response = await this.fetchSettingsFromApi(\"encrypted\");\n    settingsCache.encrypted = response;\n    if (!settingsCache.timestamp) {\n      settingsCache.timestamp = Date.now();\n    }\n    return {\n      agentSettings: response.agent_settings,\n      conversationSettings: response.conversation_settings,\n      secretsEncrypted: true,\n    };\n  }\n\n  static async getSettingsSchema(): Promise<SettingsSchema> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return (await fetchCloudSettingsSchema()) as SettingsSchema;\n    }\n    return (await new SettingsClient(\n      getAgentServerClientOptions(),\n    ).getAgentSchema()) as SettingsSchema;\n  }\n\n  static async getConversationSettingsSchema(): Promise<SettingsSchema> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return (await fetchCloudConversationSettingsSchema()) as SettingsSchema;\n    }\n    return (await new SettingsClient(\n      getAgentServerClientOptions(),\n    ).getConversationSchema()) as SettingsSchema;\n  }\n\n  /**\n   * Apply one name-keyed MCP merge patch in exactly one request. The server\n   * owns the stored catalog and secret preservation; Canvas never rebuilds\n   * the catalog from redacted display settings.\n   */\n  static async patchMcpConfig(patch: MCPConfigPatch): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      const mcpConfig = await cloudCompatibleMcpConfig(patch);\n      await withRetry(() =>\n        saveCloudSettings({\n          agent_settings_diff: { mcp_config: mcpConfig as SettingsValue },\n        }),\n      );\n    } else {\n      await withRetry(() =>\n        new SettingsClient(getAgentServerClientOptions()).updateSettings({\n          agent_settings_diff: { mcp_config: patch },\n        }),\n      );\n    }\n    clearCache();\n    return true;\n  }\n\n  static async patchMcpServer(\n    settingsKey: string,\n    patch: MCPServerPatch,\n  ): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return SettingsService.patchMcpConfig({ [settingsKey]: patch });\n    }\n    await withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).patchMcpServer(\n        settingsKey,\n        patch,\n      ),\n    );\n    clearCache();\n    return true;\n  }\n\n  static async createMcpServer(\n    settingsKey: string,\n    server: MCPServer,\n  ): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return SettingsService.patchMcpConfig({ [settingsKey]: server });\n    }\n    await withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).createMcpServer(\n        settingsKey,\n        server,\n      ),\n    );\n    clearCache();\n    return true;\n  }\n\n  static async deleteMcpServer(settingsKey: string): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return SettingsService.patchMcpConfig({ [settingsKey]: null });\n    }\n    await withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).deleteMcpServer(\n        settingsKey,\n      ),\n    );\n    clearCache();\n    return true;\n  }\n\n  /**\n   * Save settings to the agent server API.\n   * Uses PATCH for incremental updates.\n   */\n  static async saveSettings(\n    settings: Partial<Settings> & Record<string, unknown>,\n  ): Promise<boolean> {\n    // Split app-level user-preference fields (language, git identity, sound\n    // notifications, analytics consent, disabled_skills) off and route them\n    // through `misc_settings_diff.app_preferences` (local) or as flat\n    // top-level keys (cloud). The local agent-server stores them under\n    // `PersistedSettings.misc_settings.app_preferences`; the cloud accepts\n    // them as flat keys on `POST /api/v1/settings`.\n    const { extracted: appPreferences, rest } = extractAppPreferences(\n      settings as Record<string, unknown>,\n    );\n    const hasAppPreferences = Object.keys(appPreferences).length > 0;\n\n    const payload: SettingsUpdateRequest = {};\n\n    // Extract agent_settings_diff\n    const agentSettingsDiff = rest.agent_settings_diff as\n      | Record<string, SettingsValue>\n      | undefined;\n    if (agentSettingsDiff && Object.keys(agentSettingsDiff).length > 0) {\n      payload.agent_settings_diff = agentSettingsDiff;\n    }\n\n    // Extract conversation_settings_diff\n    const conversationSettingsDiff = rest.conversation_settings_diff as\n      | Record<string, SettingsValue>\n      | undefined;\n    if (\n      conversationSettingsDiff &&\n      Object.keys(conversationSettingsDiff).length > 0\n    ) {\n      payload.conversation_settings_diff = conversationSettingsDiff;\n    }\n\n    if (hasAppPreferences) {\n      payload.misc_settings_diff = { app_preferences: appPreferences };\n    }\n\n    const isCloud = getActiveBackend().backend.kind === \"cloud\";\n    if (isCloud) {\n      const hasCloudWork =\n        !!payload.agent_settings_diff ||\n        !!payload.conversation_settings_diff ||\n        hasAppPreferences;\n      if (!hasCloudWork) {\n        return true;\n      }\n      // Build the cloud payload from the same diffs, but as a separate\n      // object so undefined keys don't appear in the call (saveCloudSettings\n      // is called from tests with an exact-shape assertion).\n      const cloudPayload: Parameters<typeof saveCloudSettings>[0] = {};\n      if (payload.agent_settings_diff) {\n        cloudPayload.agent_settings_diff = { ...payload.agent_settings_diff };\n        if (\"mcp_config\" in cloudPayload.agent_settings_diff) {\n          cloudPayload.agent_settings_diff.mcp_config =\n            (await cloudCompatibleMcpConfig(\n              cloudPayload.agent_settings_diff.mcp_config,\n            )) as SettingsValue;\n        }\n      }\n      if (payload.conversation_settings_diff) {\n        cloudPayload.conversation_settings_diff =\n          payload.conversation_settings_diff;\n      }\n      if (hasAppPreferences) {\n        // The cloud `POST /api/v1/settings` takes app-preference fields as\n        // flat top-level keys (not under `app_preferences_diff`).\n        // `saveCloudSettings` re-flattens them onto the request body.\n        cloudPayload.app_preferences = appPreferences;\n      }\n      await withRetry(() => saveCloudSettings(cloudPayload));\n    } else {\n      // The local agent-server PATCH /api/settings requires at least one of\n      // the three diff fields. Skip the request entirely if nothing changed.\n      const hasLocalDiffs =\n        !!payload.agent_settings_diff ||\n        !!payload.conversation_settings_diff ||\n        !!payload.misc_settings_diff;\n      if (!hasLocalDiffs) {\n        return true;\n      }\n      await withRetry(() =>\n        new SettingsClient(getAgentServerClientOptions()).updateSettings(\n          payload,\n        ),\n      );\n    }\n\n    // Invalidate cache after successful save\n    clearCache();\n\n    return true;\n  }\n\n  /**\n   * Invalidate the settings cache.\n   * Call this when settings may have changed externally.\n   */\n  static invalidateCache(): void {\n    clearCache();\n  }\n}\n\nexport default SettingsService;\n"],"mappings":"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"}
+{"version":3,"file":"settings-service.api.cjs","names":[],"sources":["../../../src/api/settings-service/settings-service.api.ts"],"sourcesContent":["import { SettingsClient } from \"@openhands/typescript-client/clients\";\nimport type {\n  MCPConfigPatch,\n  MCPServer,\n  MCPServerPatch,\n} from \"@openhands/typescript-client\";\nimport { DEFAULT_SETTINGS } from \"#/services/settings\";\nimport { Settings, SettingsSchema, SettingsValue } from \"#/types/settings\";\nimport { stringRecord } from \"#/utils/mcp-config\";\nimport { getActiveBackend } from \"../backend-registry/active-store\";\nimport {\n  fetchCloudConversationSettingsSchema,\n  fetchCloudSettings,\n  fetchCloudSettingsSchema,\n  saveCloudSettings,\n} from \"../cloud/settings-service.api\";\nimport { getAgentServerClientOptions } from \"../agent-server-client-options\";\n\n/**\n * Fields the agent-server stores under `misc_settings.app_preferences` (see\n * SDK `openhands.sdk.settings.AppPreferences`). Mirrored here as a flat\n * partial of Settings so the rest of the frontend can keep treating them as\n * top-level keys (`settings.language`, `settings.disabled_skills`, …).\n */\nexport const APP_PREFERENCE_FIELDS = [\n  \"language\",\n  \"user_consents_to_analytics\",\n  \"enable_sound_notifications\",\n  \"git_user_name\",\n  \"git_user_email\",\n  \"title_llm_profile\",\n  \"disabled_skills\",\n  \"enabled_skills\",\n] as const;\n\nexport type AppPreferenceField = (typeof APP_PREFERENCE_FIELDS)[number];\n\nexport type AppPreferences = Partial<Pick<Settings, AppPreferenceField>>;\n\n/**\n * Container for frontend-owned settings the agent doesn't interpret.\n * Mirrors the SDK `MiscSettings` model introduced in agent-server 1.27.\n *\n * Single nested category today (`app_preferences`). Adding a future\n * category (e.g. `ui_preferences`) is a non-breaking change for the wire\n * shape — it just adds another optional sibling here.\n */\nexport interface MiscSettings {\n  app_preferences?: AppPreferences;\n}\n\n/**\n * Response from GET /api/settings\n * Mirrors the SettingsResponse model in the agent server.\n */\nexport interface SettingsApiResponse {\n  agent_settings: Record<string, SettingsValue>;\n  conversation_settings: Record<string, SettingsValue>;\n  llm_api_key_is_set: boolean;\n  /**\n   * Frontend-owned settings the agent does not interpret (currently just\n   * `app_preferences`). Added in agent-server 1.27; earlier servers omit\n   * the field entirely, in which case the frontend falls back to defaults.\n   */\n  misc_settings?: MiscSettings;\n}\n\n/**\n * Request payload for PATCH /api/settings.\n *\n * `misc_settings_diff` is deep-merged into the persisted `misc_settings`\n * block, matching the semantics of `agent_settings_diff` /\n * `conversation_settings_diff`. A partial diff like\n * `{ app_preferences: { language: \"fr\" } }` updates only `language` and\n * leaves every other `app_preferences` field alone. Lists\n * (`disabled_skills`, `enabled_skills`) are replaced wholesale rather than\n * merged.\n */\nexport interface SettingsUpdateRequest {\n  agent_settings_diff?: Record<string, SettingsValue>;\n  conversation_settings_diff?: Record<string, SettingsValue>;\n  misc_settings_diff?: MiscSettings;\n  // Permit additional keys so this stays assignable to the underlying\n  // typescript-client SDK type, which uses `[key: string]: unknown` for\n  // forward compatibility.\n  [key: string]: unknown;\n}\n\nconst APP_PREFERENCE_FIELD_SET: ReadonlySet<string> = new Set(\n  APP_PREFERENCE_FIELDS,\n);\n\nconst isAppPreferenceField = (key: string): key is AppPreferenceField =>\n  APP_PREFERENCE_FIELD_SET.has(key);\n\n/**\n * Split known app-preference keys out of a save payload so callers can\n * route them through `misc_settings_diff.app_preferences` (local) or as\n * flat top-level keys (cloud), while the remaining fields flow into the\n * `agent_settings_diff` / `conversation_settings_diff` branches.\n */\nconst extractAppPreferences = (\n  input: Record<string, unknown>,\n): { extracted: AppPreferences; rest: Record<string, unknown> } => {\n  const extracted: AppPreferences = {};\n  const rest: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(input)) {\n    if (isAppPreferenceField(key)) {\n      (extracted as Record<string, unknown>)[key] = value;\n    } else {\n      rest[key] = value;\n    }\n  }\n  return { extracted, rest };\n};\n\n/**\n * Secret exposure mode for X-Expose-Secrets header.\n *\n * - undefined: Returns redacted secrets (\"**********\")\n * - \"encrypted\": Returns cipher-encrypted values (safe for frontend to round-trip)\n * - \"plaintext\": Returns raw secret values (backend use only!)\n */\nexport type ExposeSecretsMode = \"encrypted\" | \"plaintext\" | undefined;\n\nconst deepClone = <T>(value: T): T => JSON.parse(JSON.stringify(value)) as T;\n\nconst mergeRecords = (\n  base: Record<string, SettingsValue> | null | undefined,\n  next: Record<string, SettingsValue> | null | undefined,\n) => ({ ...(base ?? {}), ...(next ?? {}) });\n\n/**\n * Retry helper for API calls with exponential backoff.\n */\nasync function withRetry<T>(\n  fn: () => Promise<T>,\n  maxRetries: number = 3,\n  baseDelayMs: number = 500,\n): Promise<T> {\n  for (let attempt = 0; attempt < maxRetries; attempt += 1) {\n    try {\n      return await fn();\n    } catch (error) {\n      if (attempt >= maxRetries - 1) {\n        throw error;\n      }\n\n      const delay = baseDelayMs * 2 ** attempt;\n\n      await new Promise<void>((resolve) => {\n        setTimeout(resolve, delay);\n      });\n    }\n  }\n\n  throw new Error(\"Retry attempts exhausted\");\n}\n\n/**\n * In-memory cache for settings to avoid repeated network calls.\n * The cache is invalidated on save operations.\n */\nlet settingsCache: {\n  /** Settings with redacted secrets for display */\n  redacted: SettingsApiResponse | null;\n  /** Settings with encrypted secrets for conversation start */\n  encrypted: SettingsApiResponse | null;\n  /** Timestamp when the cache was last populated */\n  timestamp: number;\n} = {\n  redacted: null,\n  encrypted: null,\n  timestamp: 0,\n};\n\nconst CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes\n\nconst isCacheValid = () => Date.now() - settingsCache.timestamp < CACHE_TTL_MS;\n\nconst clearCache = () => {\n  settingsCache = { redacted: null, encrypted: null, timestamp: 0 };\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  !!value && typeof value === \"object\" && !Array.isArray(value);\n\nconst basicAuthHeader = (username: string, password: string): string => {\n  const token = btoa(`${username}:${password}`);\n  return `Basic ${token}`;\n};\n\nconst headersFromMcpAuth = (\n  auth: Record<string, unknown>,\n): Record<string, string> | null => {\n  switch (auth.strategy) {\n    case \"none\":\n      return {};\n    case \"api_key\": {\n      if (typeof auth.value !== \"string\" || !auth.value) return null;\n      const header =\n        typeof auth.header_name === \"string\" && auth.header_name\n          ? auth.header_name\n          : \"Authorization\";\n      const value =\n        header === \"Authorization\" ? `Bearer ${auth.value}` : auth.value;\n      return { [header]: value };\n    }\n    case \"bearer\":\n      if (typeof auth.value !== \"string\" || !auth.value) return null;\n      return { Authorization: `Bearer ${auth.value}` };\n    case \"basic\":\n      if (\n        typeof auth.username !== \"string\" ||\n        typeof auth.password !== \"string\"\n      ) {\n        return null;\n      }\n      return { Authorization: basicAuthHeader(auth.username, auth.password) };\n    case \"header\":\n      return stringRecord(auth.headers) ?? {};\n    case \"oauth2\": {\n      const tokens = isRecord(auth.state) ? auth.state.tokens : undefined;\n      if (!isRecord(tokens) || typeof tokens.access_token !== \"string\") {\n        return null;\n      }\n      return { Authorization: `Bearer ${tokens.access_token}` };\n    }\n    default:\n      return null;\n  }\n};\n\n/**\n * Convert SDK `auth` credentials to the cloud's header-only storage shape.\n *\n * The cloud settings endpoint applies `mcp_config` as a merge patch, so a\n * credential change must also tombstone the headers the previous credential\n * produced — otherwise stale secrets survive a strategy switch (e.g. an\n * api_key's custom header after moving to bearer). Stored headers that the\n * new credential still produces (via the patch's carried `headers` or the\n * converted auth) are left untouched; any other stored header is cleared.\n */\nconst cloudCompatibleMcpConfig = async (value: unknown): Promise<unknown> => {\n  if (!isRecord(value)) return value;\n\n  const hasWrapper = isRecord(value.mcpServers);\n  const serverMap: Record<string, unknown> = hasWrapper\n    ? (value.mcpServers as Record<string, unknown>)\n    : value;\n\n  const needsStoredCredential =\n    Object.values(serverMap).some(\n      (server) =>\n        isRecord(server) && isRecord(server.auth) && server.auth !== null,\n    ) && getActiveBackend().backend.kind === \"cloud\";\n\n  const storedHeadersByServer = new Map<string, Record<string, string>>();\n  if (needsStoredCredential) {\n    try {\n      const stored = await fetchCloudSettings();\n      const storedMcp = isRecord(stored.mcp_config) ? stored.mcp_config : {};\n      for (const [name, server] of Object.entries(storedMcp)) {\n        if (isRecord(server)) {\n          const headers = stringRecord(\n            (server as Record<string, unknown>).headers,\n          );\n          if (headers) storedHeadersByServer.set(name, headers);\n        }\n      }\n    } catch {\n      // Fall back to the patch-only conversion; a transient fetch failure\n      // must not block saving the user's explicit edits.\n    }\n  }\n\n  const converted = Object.fromEntries(\n    Object.entries(serverMap).map(([name, server]) => {\n      if (!isRecord(server)) return [name, server];\n      if (server.auth === null) {\n        const nextServer: Record<string, unknown> = {\n          ...server,\n          headers: null,\n        };\n        delete nextServer.auth;\n        return [name, nextServer];\n      }\n      if (!isRecord(server.auth)) return [name, server];\n\n      const authHeaders = headersFromMcpAuth(server.auth);\n      if (authHeaders === null) return [name, server];\n\n      const nextServer = { ...server };\n      const existingHeaders = stringRecord(server.headers) ?? {};\n      const mergedHeaders: Record<string, string | null> = {\n        ...existingHeaders,\n        ...authHeaders,\n      };\n\n      const storedHeaders = storedHeadersByServer.get(name);\n      if (storedHeaders) {\n        for (const key of Object.keys(storedHeaders)) {\n          if (!(key in mergedHeaders)) mergedHeaders[key] = null;\n        }\n      }\n\n      delete nextServer.auth;\n      if (Object.keys(mergedHeaders).length > 0) {\n        nextServer.headers = mergedHeaders;\n      } else {\n        delete nextServer.headers;\n      }\n      return [name, nextServer];\n    }),\n  );\n\n  return hasWrapper ? { ...value, mcpServers: converted } : converted;\n};\n\n/**\n * Transform API response into Settings object with derived fields.\n */\nconst transformApiResponse = (\n  response: SettingsApiResponse,\n): Partial<Settings> => {\n  const agentSettings = response.agent_settings ?? {};\n  const conversationSettings = response.conversation_settings ?? {};\n\n  const partial: Partial<Settings> = {\n    agent_settings: agentSettings,\n    conversation_settings: conversationSettings,\n    llm_api_key_set: response.llm_api_key_is_set,\n  };\n\n  // App-level user preferences come back nested under\n  // `misc_settings.app_preferences` from the local agent-server (added in\n  // 1.27, restructured into the `misc_settings` container in the follow-up\n  // refactor). Hoist them onto the flat Settings shape the rest of the\n  // frontend already speaks. Older servers omit the `misc_settings` field\n  // entirely; the migration helper invoked from `getSettings` promotes any\n  // leftover localStorage values to the server on first run, so the omitted\n  // case just falls back to defaults.\n  const prefs = response.misc_settings?.app_preferences;\n  if (prefs) {\n    for (const key of APP_PREFERENCE_FIELDS) {\n      const value = prefs[key];\n      if (value !== undefined) {\n        (partial as Record<string, unknown>)[key] = value;\n      }\n    }\n  }\n\n  return partial;\n};\n\n/**\n * Sync derived settings fields from agent_settings and conversation_settings.\n * This ensures backward compatibility with code that reads top-level fields.\n */\nconst syncDerivedSettings = (settings: Partial<Settings>): Settings => {\n  const agentSettings = mergeRecords(\n    DEFAULT_SETTINGS.agent_settings ?? {},\n    settings.agent_settings ?? {},\n  );\n  const conversationSettings = mergeRecords(\n    DEFAULT_SETTINGS.conversation_settings ?? {},\n    settings.conversation_settings ?? {},\n  );\n\n  const merged = {\n    ...deepClone(DEFAULT_SETTINGS),\n    ...settings,\n    provider_tokens_set: {\n      ...(DEFAULT_SETTINGS.provider_tokens_set ?? {}),\n      ...(settings.provider_tokens_set ?? {}),\n    },\n    agent_settings: agentSettings,\n    conversation_settings: conversationSettings,\n  } as Settings;\n\n  const llm = agentSettings.llm as Record<string, SettingsValue> | undefined;\n  const condenser = agentSettings.condenser as\n    | Record<string, SettingsValue>\n    | undefined;\n\n  if (typeof agentSettings.agent === \"string\") {\n    merged.agent = agentSettings.agent;\n  }\n  if (typeof llm?.model === \"string\" && llm.model.length > 0) {\n    merged.llm_model = llm.model;\n  }\n  if (typeof llm?.base_url === \"string\") {\n    merged.llm_base_url = llm.base_url;\n  }\n  // Note: api_key may be redacted (\"**********\") when fetched without expose header\n  // We don't sync it to top-level llm_api_key to avoid overwriting with redacted value\n  if (typeof condenser?.enabled === \"boolean\") {\n    merged.enable_default_condenser = condenser.enabled;\n  }\n  if (typeof condenser?.max_size === \"number\") {\n    merged.condenser_max_size = condenser.max_size;\n  }\n  if (typeof conversationSettings.confirmation_mode === \"boolean\") {\n    merged.confirmation_mode = conversationSettings.confirmation_mode;\n  }\n  if (\n    typeof conversationSettings.security_analyzer === \"string\" ||\n    conversationSettings.security_analyzer === null\n  ) {\n    merged.security_analyzer = conversationSettings.security_analyzer as\n      | string\n      | null;\n  }\n  if (typeof conversationSettings.max_iterations === \"number\") {\n    merged.max_iterations = conversationSettings.max_iterations;\n  }\n\n  merged.search_api_key_set = !!merged.search_api_key;\n\n  return merged;\n};\n\nclass SettingsService {\n  /**\n   * Fetch settings from the agent server API with retry logic.\n   *\n   * @param exposeSecrets - Controls how secrets are returned:\n   *   - undefined: Secrets are redacted (\"**********\") - safe for display\n   *   - \"encrypted\": Secrets are cipher-encrypted - safe for round-trip to start conversation\n   *   - \"plaintext\": Raw secrets - DO NOT USE from frontend\n   */\n  static async fetchSettingsFromApi(\n    exposeSecrets?: ExposeSecretsMode,\n  ): Promise<SettingsApiResponse> {\n    return withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).getSettings({\n        exposeSecrets,\n      }),\n    ) as Promise<SettingsApiResponse>;\n  }\n\n  /**\n   * Get settings for display (secrets are redacted).\n   * Uses in-memory cache for performance.\n   */\n  static async getSettings(): Promise<Settings> {\n    // Cloud uses a different settings shape (flat top-level fields\n    // including provider_tokens_set, llm_model, etc.). Branch out before\n    // touching the local-only cache: cloud responses bypass the local\n    // SettingsApiResponse shape and feed straight into syncDerivedSettings\n    // so cloud-native fields like provider_tokens_set reach the GUI's\n    // useUserProviders → useAppInstallations → useGitRepositories chain.\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      try {\n        const cloud = await withRetry(() => fetchCloudSettings());\n        return syncDerivedSettings(cloud);\n      } catch (error) {\n        console.warn(\"Failed to fetch cloud settings, using defaults:\", error);\n        return syncDerivedSettings({});\n      }\n    }\n\n    // Check cache first\n    if (isCacheValid() && settingsCache.redacted) {\n      return syncDerivedSettings(transformApiResponse(settingsCache.redacted));\n    }\n\n    try {\n      const response = await this.fetchSettingsFromApi();\n      settingsCache.redacted = response;\n      settingsCache.timestamp = Date.now();\n      return syncDerivedSettings(transformApiResponse(response));\n    } catch (error) {\n      // If API fails, return defaults\n      console.warn(\"Failed to fetch settings from API, using defaults:\", error);\n      return syncDerivedSettings({});\n    }\n  }\n\n  /**\n   * Get settings with encrypted secrets for starting conversations.\n   * The encrypted secrets can be passed to the start conversation API\n   * with secrets_encrypted=true for server-side decryption.\n   *\n   * @throws Error if encrypted settings cannot be fetched - conversations\n   *   should not start with broken/redacted credentials.\n   */\n  static async getSettingsForConversation(): Promise<{\n    agentSettings: Record<string, SettingsValue>;\n    conversationSettings: Record<string, SettingsValue>;\n    secretsEncrypted: boolean;\n  }> {\n    // Check cache first\n    if (isCacheValid() && settingsCache.encrypted) {\n      return {\n        agentSettings: settingsCache.encrypted.agent_settings,\n        conversationSettings: settingsCache.encrypted.conversation_settings,\n        secretsEncrypted: true,\n      };\n    }\n\n    // Fetch encrypted settings - this MUST succeed for conversations to work.\n    // Do not fall back to redacted settings as that would cause auth failures.\n    const response = await this.fetchSettingsFromApi(\"encrypted\");\n    settingsCache.encrypted = response;\n    if (!settingsCache.timestamp) {\n      settingsCache.timestamp = Date.now();\n    }\n    return {\n      agentSettings: response.agent_settings,\n      conversationSettings: response.conversation_settings,\n      secretsEncrypted: true,\n    };\n  }\n\n  static async getSettingsSchema(): Promise<SettingsSchema> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return (await fetchCloudSettingsSchema()) as SettingsSchema;\n    }\n    return (await new SettingsClient(\n      getAgentServerClientOptions(),\n    ).getAgentSchema()) as SettingsSchema;\n  }\n\n  static async getConversationSettingsSchema(): Promise<SettingsSchema> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return (await fetchCloudConversationSettingsSchema()) as SettingsSchema;\n    }\n    return (await new SettingsClient(\n      getAgentServerClientOptions(),\n    ).getConversationSchema()) as SettingsSchema;\n  }\n\n  /**\n   * Apply one name-keyed MCP merge patch in exactly one request. The server\n   * owns the stored catalog and secret preservation; Canvas never rebuilds\n   * the catalog from redacted display settings.\n   */\n  static async patchMcpConfig(patch: MCPConfigPatch): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      const mcpConfig = await cloudCompatibleMcpConfig(patch);\n      await withRetry(() =>\n        saveCloudSettings({\n          agent_settings_diff: { mcp_config: mcpConfig as SettingsValue },\n        }),\n      );\n    } else {\n      await withRetry(() =>\n        new SettingsClient(getAgentServerClientOptions()).updateSettings({\n          agent_settings_diff: { mcp_config: patch },\n        }),\n      );\n    }\n    clearCache();\n    return true;\n  }\n\n  static async patchMcpServer(\n    settingsKey: string,\n    patch: MCPServerPatch,\n  ): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return SettingsService.patchMcpConfig({ [settingsKey]: patch });\n    }\n    await withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).patchMcpServer(\n        settingsKey,\n        patch,\n      ),\n    );\n    clearCache();\n    return true;\n  }\n\n  static async createMcpServer(\n    settingsKey: string,\n    server: MCPServer,\n  ): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return SettingsService.patchMcpConfig({ [settingsKey]: server });\n    }\n    await withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).createMcpServer(\n        settingsKey,\n        server,\n      ),\n    );\n    clearCache();\n    return true;\n  }\n\n  static async deleteMcpServer(settingsKey: string): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return SettingsService.patchMcpConfig({ [settingsKey]: null });\n    }\n    await withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).deleteMcpServer(\n        settingsKey,\n      ),\n    );\n    clearCache();\n    return true;\n  }\n\n  /**\n   * Save settings to the agent server API.\n   * Uses PATCH for incremental updates.\n   */\n  static async saveSettings(\n    settings: Partial<Settings> & Record<string, unknown>,\n  ): Promise<boolean> {\n    // Split app-level user-preference fields (language, git identity, sound\n    // notifications, analytics consent, disabled_skills) off and route them\n    // through `misc_settings_diff.app_preferences` (local) or as flat\n    // top-level keys (cloud). The local agent-server stores them under\n    // `PersistedSettings.misc_settings.app_preferences`; the cloud accepts\n    // them as flat keys on `POST /api/v1/settings`.\n    const { extracted: appPreferences, rest } = extractAppPreferences(\n      settings as Record<string, unknown>,\n    );\n    const hasAppPreferences = Object.keys(appPreferences).length > 0;\n\n    const payload: SettingsUpdateRequest = {};\n\n    // Extract agent_settings_diff\n    const agentSettingsDiff = rest.agent_settings_diff as\n      | Record<string, SettingsValue>\n      | undefined;\n    if (agentSettingsDiff && Object.keys(agentSettingsDiff).length > 0) {\n      payload.agent_settings_diff = agentSettingsDiff;\n    }\n\n    // Extract conversation_settings_diff\n    const conversationSettingsDiff = rest.conversation_settings_diff as\n      | Record<string, SettingsValue>\n      | undefined;\n    if (\n      conversationSettingsDiff &&\n      Object.keys(conversationSettingsDiff).length > 0\n    ) {\n      payload.conversation_settings_diff = conversationSettingsDiff;\n    }\n\n    if (hasAppPreferences) {\n      payload.misc_settings_diff = { app_preferences: appPreferences };\n    }\n\n    const isCloud = getActiveBackend().backend.kind === \"cloud\";\n    if (isCloud) {\n      const hasCloudWork =\n        !!payload.agent_settings_diff ||\n        !!payload.conversation_settings_diff ||\n        hasAppPreferences;\n      if (!hasCloudWork) {\n        return true;\n      }\n      // Build the cloud payload from the same diffs, but as a separate\n      // object so undefined keys don't appear in the call (saveCloudSettings\n      // is called from tests with an exact-shape assertion).\n      const cloudPayload: Parameters<typeof saveCloudSettings>[0] = {};\n      if (payload.agent_settings_diff) {\n        cloudPayload.agent_settings_diff = { ...payload.agent_settings_diff };\n        if (\"mcp_config\" in cloudPayload.agent_settings_diff) {\n          cloudPayload.agent_settings_diff.mcp_config =\n            (await cloudCompatibleMcpConfig(\n              cloudPayload.agent_settings_diff.mcp_config,\n            )) as SettingsValue;\n        }\n      }\n      if (payload.conversation_settings_diff) {\n        cloudPayload.conversation_settings_diff =\n          payload.conversation_settings_diff;\n      }\n      if (hasAppPreferences) {\n        // The cloud `POST /api/v1/settings` takes app-preference fields as\n        // flat top-level keys (not under `app_preferences_diff`).\n        // `saveCloudSettings` re-flattens them onto the request body.\n        cloudPayload.app_preferences = appPreferences;\n      }\n      await withRetry(() => saveCloudSettings(cloudPayload));\n    } else {\n      // The local agent-server PATCH /api/settings requires at least one of\n      // the three diff fields. Skip the request entirely if nothing changed.\n      const hasLocalDiffs =\n        !!payload.agent_settings_diff ||\n        !!payload.conversation_settings_diff ||\n        !!payload.misc_settings_diff;\n      if (!hasLocalDiffs) {\n        return true;\n      }\n      await withRetry(() =>\n        new SettingsClient(getAgentServerClientOptions()).updateSettings(\n          payload,\n        ),\n      );\n    }\n\n    // Invalidate cache after successful save\n    clearCache();\n\n    return true;\n  }\n\n  /**\n   * Invalidate the settings cache.\n   * Call this when settings may have changed externally.\n   */\n  static invalidateCache(): void {\n    clearCache();\n  }\n}\n\nexport default SettingsService;\n"],"mappings":"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"}

package/dist/api/settings-service/settings-service.api.d.ts

@@ -6,7 +6,7 @@ import { Settings, SettingsSchema, SettingsValue } from "#/types/settings";
  * partial of Settings so the rest of the frontend can keep treating them as
  * top-level keys (`settings.language`, `settings.disabled_skills`, …).
  */
-export declare const APP_PREFERENCE_FIELDS: readonly ["language", "user_consents_to_analytics", "enable_sound_notifications", "git_user_name", "git_user_email", "title_llm_profile", "disabled_skills"];
+export declare const APP_PREFERENCE_FIELDS: readonly ["language", "user_consents_to_analytics", "enable_sound_notifications", "git_user_name", "git_user_email", "title_llm_profile", "disabled_skills", "enabled_skills"];
 export type AppPreferenceField = (typeof APP_PREFERENCE_FIELDS)[number];
 export type AppPreferences = Partial<Pick<Settings, AppPreferenceField>>;
 /**
@@ -43,7 +43,8 @@ export interface SettingsApiResponse {
  * `conversation_settings_diff`. A partial diff like
  * `{ app_preferences: { language: "fr" } }` updates only `language` and
  * leaves every other `app_preferences` field alone. Lists
- * (`disabled_skills`) are replaced wholesale rather than merged.
+ * (`disabled_skills`, `enabled_skills`) are replaced wholesale rather than
+ * merged.
  */
 export interface SettingsUpdateRequest {
     agent_settings_diff?: Record<string, SettingsValue>;

package/dist/api/settings-service/settings-service.api.js

@@ -13,7 +13,8 @@ var l = [
 	"git_user_name",
 	"git_user_email",
 	"title_llm_profile",
-	"disabled_skills"
+	"disabled_skills",
+	"enabled_skills"
 ], u = new Set(l), d = (e) => u.has(e), f = (e) => {
 	let t = {}, n = {};
 	for (let [r, i] of Object.entries(e)) d(r) ? t[r] = i : n[r] = i;

package/dist/api/settings-service/settings-service.api.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings-service.api.js","names":[],"sources":["../../../src/api/settings-service/settings-service.api.ts"],"sourcesContent":["import { SettingsClient } from \"@openhands/typescript-client/clients\";\nimport type {\n  MCPConfigPatch,\n  MCPServer,\n  MCPServerPatch,\n} from \"@openhands/typescript-client\";\nimport { DEFAULT_SETTINGS } from \"#/services/settings\";\nimport { Settings, SettingsSchema, SettingsValue } from \"#/types/settings\";\nimport { stringRecord } from \"#/utils/mcp-config\";\nimport { getActiveBackend } from \"../backend-registry/active-store\";\nimport {\n  fetchCloudConversationSettingsSchema,\n  fetchCloudSettings,\n  fetchCloudSettingsSchema,\n  saveCloudSettings,\n} from \"../cloud/settings-service.api\";\nimport { getAgentServerClientOptions } from \"../agent-server-client-options\";\n\n/**\n * Fields the agent-server stores under `misc_settings.app_preferences` (see\n * SDK `openhands.sdk.settings.AppPreferences`). Mirrored here as a flat\n * partial of Settings so the rest of the frontend can keep treating them as\n * top-level keys (`settings.language`, `settings.disabled_skills`, …).\n */\nexport const APP_PREFERENCE_FIELDS = [\n  \"language\",\n  \"user_consents_to_analytics\",\n  \"enable_sound_notifications\",\n  \"git_user_name\",\n  \"git_user_email\",\n  \"title_llm_profile\",\n  \"disabled_skills\",\n] as const;\n\nexport type AppPreferenceField = (typeof APP_PREFERENCE_FIELDS)[number];\n\nexport type AppPreferences = Partial<Pick<Settings, AppPreferenceField>>;\n\n/**\n * Container for frontend-owned settings the agent doesn't interpret.\n * Mirrors the SDK `MiscSettings` model introduced in agent-server 1.27.\n *\n * Single nested category today (`app_preferences`). Adding a future\n * category (e.g. `ui_preferences`) is a non-breaking change for the wire\n * shape — it just adds another optional sibling here.\n */\nexport interface MiscSettings {\n  app_preferences?: AppPreferences;\n}\n\n/**\n * Response from GET /api/settings\n * Mirrors the SettingsResponse model in the agent server.\n */\nexport interface SettingsApiResponse {\n  agent_settings: Record<string, SettingsValue>;\n  conversation_settings: Record<string, SettingsValue>;\n  llm_api_key_is_set: boolean;\n  /**\n   * Frontend-owned settings the agent does not interpret (currently just\n   * `app_preferences`). Added in agent-server 1.27; earlier servers omit\n   * the field entirely, in which case the frontend falls back to defaults.\n   */\n  misc_settings?: MiscSettings;\n}\n\n/**\n * Request payload for PATCH /api/settings.\n *\n * `misc_settings_diff` is deep-merged into the persisted `misc_settings`\n * block, matching the semantics of `agent_settings_diff` /\n * `conversation_settings_diff`. A partial diff like\n * `{ app_preferences: { language: \"fr\" } }` updates only `language` and\n * leaves every other `app_preferences` field alone. Lists\n * (`disabled_skills`) are replaced wholesale rather than merged.\n */\nexport interface SettingsUpdateRequest {\n  agent_settings_diff?: Record<string, SettingsValue>;\n  conversation_settings_diff?: Record<string, SettingsValue>;\n  misc_settings_diff?: MiscSettings;\n  // Permit additional keys so this stays assignable to the underlying\n  // typescript-client SDK type, which uses `[key: string]: unknown` for\n  // forward compatibility.\n  [key: string]: unknown;\n}\n\nconst APP_PREFERENCE_FIELD_SET: ReadonlySet<string> = new Set(\n  APP_PREFERENCE_FIELDS,\n);\n\nconst isAppPreferenceField = (key: string): key is AppPreferenceField =>\n  APP_PREFERENCE_FIELD_SET.has(key);\n\n/**\n * Split known app-preference keys out of a save payload so callers can\n * route them through `misc_settings_diff.app_preferences` (local) or as\n * flat top-level keys (cloud), while the remaining fields flow into the\n * `agent_settings_diff` / `conversation_settings_diff` branches.\n */\nconst extractAppPreferences = (\n  input: Record<string, unknown>,\n): { extracted: AppPreferences; rest: Record<string, unknown> } => {\n  const extracted: AppPreferences = {};\n  const rest: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(input)) {\n    if (isAppPreferenceField(key)) {\n      (extracted as Record<string, unknown>)[key] = value;\n    } else {\n      rest[key] = value;\n    }\n  }\n  return { extracted, rest };\n};\n\n/**\n * Secret exposure mode for X-Expose-Secrets header.\n *\n * - undefined: Returns redacted secrets (\"**********\")\n * - \"encrypted\": Returns cipher-encrypted values (safe for frontend to round-trip)\n * - \"plaintext\": Returns raw secret values (backend use only!)\n */\nexport type ExposeSecretsMode = \"encrypted\" | \"plaintext\" | undefined;\n\nconst deepClone = <T>(value: T): T => JSON.parse(JSON.stringify(value)) as T;\n\nconst mergeRecords = (\n  base: Record<string, SettingsValue> | null | undefined,\n  next: Record<string, SettingsValue> | null | undefined,\n) => ({ ...(base ?? {}), ...(next ?? {}) });\n\n/**\n * Retry helper for API calls with exponential backoff.\n */\nasync function withRetry<T>(\n  fn: () => Promise<T>,\n  maxRetries: number = 3,\n  baseDelayMs: number = 500,\n): Promise<T> {\n  for (let attempt = 0; attempt < maxRetries; attempt += 1) {\n    try {\n      return await fn();\n    } catch (error) {\n      if (attempt >= maxRetries - 1) {\n        throw error;\n      }\n\n      const delay = baseDelayMs * 2 ** attempt;\n\n      await new Promise<void>((resolve) => {\n        setTimeout(resolve, delay);\n      });\n    }\n  }\n\n  throw new Error(\"Retry attempts exhausted\");\n}\n\n/**\n * In-memory cache for settings to avoid repeated network calls.\n * The cache is invalidated on save operations.\n */\nlet settingsCache: {\n  /** Settings with redacted secrets for display */\n  redacted: SettingsApiResponse | null;\n  /** Settings with encrypted secrets for conversation start */\n  encrypted: SettingsApiResponse | null;\n  /** Timestamp when the cache was last populated */\n  timestamp: number;\n} = {\n  redacted: null,\n  encrypted: null,\n  timestamp: 0,\n};\n\nconst CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes\n\nconst isCacheValid = () => Date.now() - settingsCache.timestamp < CACHE_TTL_MS;\n\nconst clearCache = () => {\n  settingsCache = { redacted: null, encrypted: null, timestamp: 0 };\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  !!value && typeof value === \"object\" && !Array.isArray(value);\n\nconst basicAuthHeader = (username: string, password: string): string => {\n  const token = btoa(`${username}:${password}`);\n  return `Basic ${token}`;\n};\n\nconst headersFromMcpAuth = (\n  auth: Record<string, unknown>,\n): Record<string, string> | null => {\n  switch (auth.strategy) {\n    case \"none\":\n      return {};\n    case \"api_key\": {\n      if (typeof auth.value !== \"string\" || !auth.value) return null;\n      const header =\n        typeof auth.header_name === \"string\" && auth.header_name\n          ? auth.header_name\n          : \"Authorization\";\n      const value =\n        header === \"Authorization\" ? `Bearer ${auth.value}` : auth.value;\n      return { [header]: value };\n    }\n    case \"bearer\":\n      if (typeof auth.value !== \"string\" || !auth.value) return null;\n      return { Authorization: `Bearer ${auth.value}` };\n    case \"basic\":\n      if (\n        typeof auth.username !== \"string\" ||\n        typeof auth.password !== \"string\"\n      ) {\n        return null;\n      }\n      return { Authorization: basicAuthHeader(auth.username, auth.password) };\n    case \"header\":\n      return stringRecord(auth.headers) ?? {};\n    case \"oauth2\": {\n      const tokens = isRecord(auth.state) ? auth.state.tokens : undefined;\n      if (!isRecord(tokens) || typeof tokens.access_token !== \"string\") {\n        return null;\n      }\n      return { Authorization: `Bearer ${tokens.access_token}` };\n    }\n    default:\n      return null;\n  }\n};\n\n/**\n * Convert SDK `auth` credentials to the cloud's header-only storage shape.\n *\n * The cloud settings endpoint applies `mcp_config` as a merge patch, so a\n * credential change must also tombstone the headers the previous credential\n * produced — otherwise stale secrets survive a strategy switch (e.g. an\n * api_key's custom header after moving to bearer). Stored headers that the\n * new credential still produces (via the patch's carried `headers` or the\n * converted auth) are left untouched; any other stored header is cleared.\n */\nconst cloudCompatibleMcpConfig = async (value: unknown): Promise<unknown> => {\n  if (!isRecord(value)) return value;\n\n  const hasWrapper = isRecord(value.mcpServers);\n  const serverMap: Record<string, unknown> = hasWrapper\n    ? (value.mcpServers as Record<string, unknown>)\n    : value;\n\n  const needsStoredCredential =\n    Object.values(serverMap).some(\n      (server) =>\n        isRecord(server) && isRecord(server.auth) && server.auth !== null,\n    ) && getActiveBackend().backend.kind === \"cloud\";\n\n  const storedHeadersByServer = new Map<string, Record<string, string>>();\n  if (needsStoredCredential) {\n    try {\n      const stored = await fetchCloudSettings();\n      const storedMcp = isRecord(stored.mcp_config) ? stored.mcp_config : {};\n      for (const [name, server] of Object.entries(storedMcp)) {\n        if (isRecord(server)) {\n          const headers = stringRecord(\n            (server as Record<string, unknown>).headers,\n          );\n          if (headers) storedHeadersByServer.set(name, headers);\n        }\n      }\n    } catch {\n      // Fall back to the patch-only conversion; a transient fetch failure\n      // must not block saving the user's explicit edits.\n    }\n  }\n\n  const converted = Object.fromEntries(\n    Object.entries(serverMap).map(([name, server]) => {\n      if (!isRecord(server)) return [name, server];\n      if (server.auth === null) {\n        const nextServer: Record<string, unknown> = {\n          ...server,\n          headers: null,\n        };\n        delete nextServer.auth;\n        return [name, nextServer];\n      }\n      if (!isRecord(server.auth)) return [name, server];\n\n      const authHeaders = headersFromMcpAuth(server.auth);\n      if (authHeaders === null) return [name, server];\n\n      const nextServer = { ...server };\n      const existingHeaders = stringRecord(server.headers) ?? {};\n      const mergedHeaders: Record<string, string | null> = {\n        ...existingHeaders,\n        ...authHeaders,\n      };\n\n      const storedHeaders = storedHeadersByServer.get(name);\n      if (storedHeaders) {\n        for (const key of Object.keys(storedHeaders)) {\n          if (!(key in mergedHeaders)) mergedHeaders[key] = null;\n        }\n      }\n\n      delete nextServer.auth;\n      if (Object.keys(mergedHeaders).length > 0) {\n        nextServer.headers = mergedHeaders;\n      } else {\n        delete nextServer.headers;\n      }\n      return [name, nextServer];\n    }),\n  );\n\n  return hasWrapper ? { ...value, mcpServers: converted } : converted;\n};\n\n/**\n * Transform API response into Settings object with derived fields.\n */\nconst transformApiResponse = (\n  response: SettingsApiResponse,\n): Partial<Settings> => {\n  const agentSettings = response.agent_settings ?? {};\n  const conversationSettings = response.conversation_settings ?? {};\n\n  const partial: Partial<Settings> = {\n    agent_settings: agentSettings,\n    conversation_settings: conversationSettings,\n    llm_api_key_set: response.llm_api_key_is_set,\n  };\n\n  // App-level user preferences come back nested under\n  // `misc_settings.app_preferences` from the local agent-server (added in\n  // 1.27, restructured into the `misc_settings` container in the follow-up\n  // refactor). Hoist them onto the flat Settings shape the rest of the\n  // frontend already speaks. Older servers omit the `misc_settings` field\n  // entirely; the migration helper invoked from `getSettings` promotes any\n  // leftover localStorage values to the server on first run, so the omitted\n  // case just falls back to defaults.\n  const prefs = response.misc_settings?.app_preferences;\n  if (prefs) {\n    for (const key of APP_PREFERENCE_FIELDS) {\n      const value = prefs[key];\n      if (value !== undefined) {\n        (partial as Record<string, unknown>)[key] = value;\n      }\n    }\n  }\n\n  return partial;\n};\n\n/**\n * Sync derived settings fields from agent_settings and conversation_settings.\n * This ensures backward compatibility with code that reads top-level fields.\n */\nconst syncDerivedSettings = (settings: Partial<Settings>): Settings => {\n  const agentSettings = mergeRecords(\n    DEFAULT_SETTINGS.agent_settings ?? {},\n    settings.agent_settings ?? {},\n  );\n  const conversationSettings = mergeRecords(\n    DEFAULT_SETTINGS.conversation_settings ?? {},\n    settings.conversation_settings ?? {},\n  );\n\n  const merged = {\n    ...deepClone(DEFAULT_SETTINGS),\n    ...settings,\n    provider_tokens_set: {\n      ...(DEFAULT_SETTINGS.provider_tokens_set ?? {}),\n      ...(settings.provider_tokens_set ?? {}),\n    },\n    agent_settings: agentSettings,\n    conversation_settings: conversationSettings,\n  } as Settings;\n\n  const llm = agentSettings.llm as Record<string, SettingsValue> | undefined;\n  const condenser = agentSettings.condenser as\n    | Record<string, SettingsValue>\n    | undefined;\n\n  if (typeof agentSettings.agent === \"string\") {\n    merged.agent = agentSettings.agent;\n  }\n  if (typeof llm?.model === \"string\" && llm.model.length > 0) {\n    merged.llm_model = llm.model;\n  }\n  if (typeof llm?.base_url === \"string\") {\n    merged.llm_base_url = llm.base_url;\n  }\n  // Note: api_key may be redacted (\"**********\") when fetched without expose header\n  // We don't sync it to top-level llm_api_key to avoid overwriting with redacted value\n  if (typeof condenser?.enabled === \"boolean\") {\n    merged.enable_default_condenser = condenser.enabled;\n  }\n  if (typeof condenser?.max_size === \"number\") {\n    merged.condenser_max_size = condenser.max_size;\n  }\n  if (typeof conversationSettings.confirmation_mode === \"boolean\") {\n    merged.confirmation_mode = conversationSettings.confirmation_mode;\n  }\n  if (\n    typeof conversationSettings.security_analyzer === \"string\" ||\n    conversationSettings.security_analyzer === null\n  ) {\n    merged.security_analyzer = conversationSettings.security_analyzer as\n      | string\n      | null;\n  }\n  if (typeof conversationSettings.max_iterations === \"number\") {\n    merged.max_iterations = conversationSettings.max_iterations;\n  }\n\n  merged.search_api_key_set = !!merged.search_api_key;\n\n  return merged;\n};\n\nclass SettingsService {\n  /**\n   * Fetch settings from the agent server API with retry logic.\n   *\n   * @param exposeSecrets - Controls how secrets are returned:\n   *   - undefined: Secrets are redacted (\"**********\") - safe for display\n   *   - \"encrypted\": Secrets are cipher-encrypted - safe for round-trip to start conversation\n   *   - \"plaintext\": Raw secrets - DO NOT USE from frontend\n   */\n  static async fetchSettingsFromApi(\n    exposeSecrets?: ExposeSecretsMode,\n  ): Promise<SettingsApiResponse> {\n    return withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).getSettings({\n        exposeSecrets,\n      }),\n    ) as Promise<SettingsApiResponse>;\n  }\n\n  /**\n   * Get settings for display (secrets are redacted).\n   * Uses in-memory cache for performance.\n   */\n  static async getSettings(): Promise<Settings> {\n    // Cloud uses a different settings shape (flat top-level fields\n    // including provider_tokens_set, llm_model, etc.). Branch out before\n    // touching the local-only cache: cloud responses bypass the local\n    // SettingsApiResponse shape and feed straight into syncDerivedSettings\n    // so cloud-native fields like provider_tokens_set reach the GUI's\n    // useUserProviders → useAppInstallations → useGitRepositories chain.\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      try {\n        const cloud = await withRetry(() => fetchCloudSettings());\n        return syncDerivedSettings(cloud);\n      } catch (error) {\n        console.warn(\"Failed to fetch cloud settings, using defaults:\", error);\n        return syncDerivedSettings({});\n      }\n    }\n\n    // Check cache first\n    if (isCacheValid() && settingsCache.redacted) {\n      return syncDerivedSettings(transformApiResponse(settingsCache.redacted));\n    }\n\n    try {\n      const response = await this.fetchSettingsFromApi();\n      settingsCache.redacted = response;\n      settingsCache.timestamp = Date.now();\n      return syncDerivedSettings(transformApiResponse(response));\n    } catch (error) {\n      // If API fails, return defaults\n      console.warn(\"Failed to fetch settings from API, using defaults:\", error);\n      return syncDerivedSettings({});\n    }\n  }\n\n  /**\n   * Get settings with encrypted secrets for starting conversations.\n   * The encrypted secrets can be passed to the start conversation API\n   * with secrets_encrypted=true for server-side decryption.\n   *\n   * @throws Error if encrypted settings cannot be fetched - conversations\n   *   should not start with broken/redacted credentials.\n   */\n  static async getSettingsForConversation(): Promise<{\n    agentSettings: Record<string, SettingsValue>;\n    conversationSettings: Record<string, SettingsValue>;\n    secretsEncrypted: boolean;\n  }> {\n    // Check cache first\n    if (isCacheValid() && settingsCache.encrypted) {\n      return {\n        agentSettings: settingsCache.encrypted.agent_settings,\n        conversationSettings: settingsCache.encrypted.conversation_settings,\n        secretsEncrypted: true,\n      };\n    }\n\n    // Fetch encrypted settings - this MUST succeed for conversations to work.\n    // Do not fall back to redacted settings as that would cause auth failures.\n    const response = await this.fetchSettingsFromApi(\"encrypted\");\n    settingsCache.encrypted = response;\n    if (!settingsCache.timestamp) {\n      settingsCache.timestamp = Date.now();\n    }\n    return {\n      agentSettings: response.agent_settings,\n      conversationSettings: response.conversation_settings,\n      secretsEncrypted: true,\n    };\n  }\n\n  static async getSettingsSchema(): Promise<SettingsSchema> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return (await fetchCloudSettingsSchema()) as SettingsSchema;\n    }\n    return (await new SettingsClient(\n      getAgentServerClientOptions(),\n    ).getAgentSchema()) as SettingsSchema;\n  }\n\n  static async getConversationSettingsSchema(): Promise<SettingsSchema> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return (await fetchCloudConversationSettingsSchema()) as SettingsSchema;\n    }\n    return (await new SettingsClient(\n      getAgentServerClientOptions(),\n    ).getConversationSchema()) as SettingsSchema;\n  }\n\n  /**\n   * Apply one name-keyed MCP merge patch in exactly one request. The server\n   * owns the stored catalog and secret preservation; Canvas never rebuilds\n   * the catalog from redacted display settings.\n   */\n  static async patchMcpConfig(patch: MCPConfigPatch): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      const mcpConfig = await cloudCompatibleMcpConfig(patch);\n      await withRetry(() =>\n        saveCloudSettings({\n          agent_settings_diff: { mcp_config: mcpConfig as SettingsValue },\n        }),\n      );\n    } else {\n      await withRetry(() =>\n        new SettingsClient(getAgentServerClientOptions()).updateSettings({\n          agent_settings_diff: { mcp_config: patch },\n        }),\n      );\n    }\n    clearCache();\n    return true;\n  }\n\n  static async patchMcpServer(\n    settingsKey: string,\n    patch: MCPServerPatch,\n  ): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return SettingsService.patchMcpConfig({ [settingsKey]: patch });\n    }\n    await withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).patchMcpServer(\n        settingsKey,\n        patch,\n      ),\n    );\n    clearCache();\n    return true;\n  }\n\n  static async createMcpServer(\n    settingsKey: string,\n    server: MCPServer,\n  ): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return SettingsService.patchMcpConfig({ [settingsKey]: server });\n    }\n    await withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).createMcpServer(\n        settingsKey,\n        server,\n      ),\n    );\n    clearCache();\n    return true;\n  }\n\n  static async deleteMcpServer(settingsKey: string): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return SettingsService.patchMcpConfig({ [settingsKey]: null });\n    }\n    await withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).deleteMcpServer(\n        settingsKey,\n      ),\n    );\n    clearCache();\n    return true;\n  }\n\n  /**\n   * Save settings to the agent server API.\n   * Uses PATCH for incremental updates.\n   */\n  static async saveSettings(\n    settings: Partial<Settings> & Record<string, unknown>,\n  ): Promise<boolean> {\n    // Split app-level user-preference fields (language, git identity, sound\n    // notifications, analytics consent, disabled_skills) off and route them\n    // through `misc_settings_diff.app_preferences` (local) or as flat\n    // top-level keys (cloud). The local agent-server stores them under\n    // `PersistedSettings.misc_settings.app_preferences`; the cloud accepts\n    // them as flat keys on `POST /api/v1/settings`.\n    const { extracted: appPreferences, rest } = extractAppPreferences(\n      settings as Record<string, unknown>,\n    );\n    const hasAppPreferences = Object.keys(appPreferences).length > 0;\n\n    const payload: SettingsUpdateRequest = {};\n\n    // Extract agent_settings_diff\n    const agentSettingsDiff = rest.agent_settings_diff as\n      | Record<string, SettingsValue>\n      | undefined;\n    if (agentSettingsDiff && Object.keys(agentSettingsDiff).length > 0) {\n      payload.agent_settings_diff = agentSettingsDiff;\n    }\n\n    // Extract conversation_settings_diff\n    const conversationSettingsDiff = rest.conversation_settings_diff as\n      | Record<string, SettingsValue>\n      | undefined;\n    if (\n      conversationSettingsDiff &&\n      Object.keys(conversationSettingsDiff).length > 0\n    ) {\n      payload.conversation_settings_diff = conversationSettingsDiff;\n    }\n\n    if (hasAppPreferences) {\n      payload.misc_settings_diff = { app_preferences: appPreferences };\n    }\n\n    const isCloud = getActiveBackend().backend.kind === \"cloud\";\n    if (isCloud) {\n      const hasCloudWork =\n        !!payload.agent_settings_diff ||\n        !!payload.conversation_settings_diff ||\n        hasAppPreferences;\n      if (!hasCloudWork) {\n        return true;\n      }\n      // Build the cloud payload from the same diffs, but as a separate\n      // object so undefined keys don't appear in the call (saveCloudSettings\n      // is called from tests with an exact-shape assertion).\n      const cloudPayload: Parameters<typeof saveCloudSettings>[0] = {};\n      if (payload.agent_settings_diff) {\n        cloudPayload.agent_settings_diff = { ...payload.agent_settings_diff };\n        if (\"mcp_config\" in cloudPayload.agent_settings_diff) {\n          cloudPayload.agent_settings_diff.mcp_config =\n            (await cloudCompatibleMcpConfig(\n              cloudPayload.agent_settings_diff.mcp_config,\n            )) as SettingsValue;\n        }\n      }\n      if (payload.conversation_settings_diff) {\n        cloudPayload.conversation_settings_diff =\n          payload.conversation_settings_diff;\n      }\n      if (hasAppPreferences) {\n        // The cloud `POST /api/v1/settings` takes app-preference fields as\n        // flat top-level keys (not under `app_preferences_diff`).\n        // `saveCloudSettings` re-flattens them onto the request body.\n        cloudPayload.app_preferences = appPreferences;\n      }\n      await withRetry(() => saveCloudSettings(cloudPayload));\n    } else {\n      // The local agent-server PATCH /api/settings requires at least one of\n      // the three diff fields. Skip the request entirely if nothing changed.\n      const hasLocalDiffs =\n        !!payload.agent_settings_diff ||\n        !!payload.conversation_settings_diff ||\n        !!payload.misc_settings_diff;\n      if (!hasLocalDiffs) {\n        return true;\n      }\n      await withRetry(() =>\n        new SettingsClient(getAgentServerClientOptions()).updateSettings(\n          payload,\n        ),\n      );\n    }\n\n    // Invalidate cache after successful save\n    clearCache();\n\n    return true;\n  }\n\n  /**\n   * Invalidate the settings cache.\n   * Call this when settings may have changed externally.\n   */\n  static invalidateCache(): void {\n    clearCache();\n  }\n}\n\nexport default SettingsService;\n"],"mappings":"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"}
+{"version":3,"file":"settings-service.api.js","names":[],"sources":["../../../src/api/settings-service/settings-service.api.ts"],"sourcesContent":["import { SettingsClient } from \"@openhands/typescript-client/clients\";\nimport type {\n  MCPConfigPatch,\n  MCPServer,\n  MCPServerPatch,\n} from \"@openhands/typescript-client\";\nimport { DEFAULT_SETTINGS } from \"#/services/settings\";\nimport { Settings, SettingsSchema, SettingsValue } from \"#/types/settings\";\nimport { stringRecord } from \"#/utils/mcp-config\";\nimport { getActiveBackend } from \"../backend-registry/active-store\";\nimport {\n  fetchCloudConversationSettingsSchema,\n  fetchCloudSettings,\n  fetchCloudSettingsSchema,\n  saveCloudSettings,\n} from \"../cloud/settings-service.api\";\nimport { getAgentServerClientOptions } from \"../agent-server-client-options\";\n\n/**\n * Fields the agent-server stores under `misc_settings.app_preferences` (see\n * SDK `openhands.sdk.settings.AppPreferences`). Mirrored here as a flat\n * partial of Settings so the rest of the frontend can keep treating them as\n * top-level keys (`settings.language`, `settings.disabled_skills`, …).\n */\nexport const APP_PREFERENCE_FIELDS = [\n  \"language\",\n  \"user_consents_to_analytics\",\n  \"enable_sound_notifications\",\n  \"git_user_name\",\n  \"git_user_email\",\n  \"title_llm_profile\",\n  \"disabled_skills\",\n  \"enabled_skills\",\n] as const;\n\nexport type AppPreferenceField = (typeof APP_PREFERENCE_FIELDS)[number];\n\nexport type AppPreferences = Partial<Pick<Settings, AppPreferenceField>>;\n\n/**\n * Container for frontend-owned settings the agent doesn't interpret.\n * Mirrors the SDK `MiscSettings` model introduced in agent-server 1.27.\n *\n * Single nested category today (`app_preferences`). Adding a future\n * category (e.g. `ui_preferences`) is a non-breaking change for the wire\n * shape — it just adds another optional sibling here.\n */\nexport interface MiscSettings {\n  app_preferences?: AppPreferences;\n}\n\n/**\n * Response from GET /api/settings\n * Mirrors the SettingsResponse model in the agent server.\n */\nexport interface SettingsApiResponse {\n  agent_settings: Record<string, SettingsValue>;\n  conversation_settings: Record<string, SettingsValue>;\n  llm_api_key_is_set: boolean;\n  /**\n   * Frontend-owned settings the agent does not interpret (currently just\n   * `app_preferences`). Added in agent-server 1.27; earlier servers omit\n   * the field entirely, in which case the frontend falls back to defaults.\n   */\n  misc_settings?: MiscSettings;\n}\n\n/**\n * Request payload for PATCH /api/settings.\n *\n * `misc_settings_diff` is deep-merged into the persisted `misc_settings`\n * block, matching the semantics of `agent_settings_diff` /\n * `conversation_settings_diff`. A partial diff like\n * `{ app_preferences: { language: \"fr\" } }` updates only `language` and\n * leaves every other `app_preferences` field alone. Lists\n * (`disabled_skills`, `enabled_skills`) are replaced wholesale rather than\n * merged.\n */\nexport interface SettingsUpdateRequest {\n  agent_settings_diff?: Record<string, SettingsValue>;\n  conversation_settings_diff?: Record<string, SettingsValue>;\n  misc_settings_diff?: MiscSettings;\n  // Permit additional keys so this stays assignable to the underlying\n  // typescript-client SDK type, which uses `[key: string]: unknown` for\n  // forward compatibility.\n  [key: string]: unknown;\n}\n\nconst APP_PREFERENCE_FIELD_SET: ReadonlySet<string> = new Set(\n  APP_PREFERENCE_FIELDS,\n);\n\nconst isAppPreferenceField = (key: string): key is AppPreferenceField =>\n  APP_PREFERENCE_FIELD_SET.has(key);\n\n/**\n * Split known app-preference keys out of a save payload so callers can\n * route them through `misc_settings_diff.app_preferences` (local) or as\n * flat top-level keys (cloud), while the remaining fields flow into the\n * `agent_settings_diff` / `conversation_settings_diff` branches.\n */\nconst extractAppPreferences = (\n  input: Record<string, unknown>,\n): { extracted: AppPreferences; rest: Record<string, unknown> } => {\n  const extracted: AppPreferences = {};\n  const rest: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(input)) {\n    if (isAppPreferenceField(key)) {\n      (extracted as Record<string, unknown>)[key] = value;\n    } else {\n      rest[key] = value;\n    }\n  }\n  return { extracted, rest };\n};\n\n/**\n * Secret exposure mode for X-Expose-Secrets header.\n *\n * - undefined: Returns redacted secrets (\"**********\")\n * - \"encrypted\": Returns cipher-encrypted values (safe for frontend to round-trip)\n * - \"plaintext\": Returns raw secret values (backend use only!)\n */\nexport type ExposeSecretsMode = \"encrypted\" | \"plaintext\" | undefined;\n\nconst deepClone = <T>(value: T): T => JSON.parse(JSON.stringify(value)) as T;\n\nconst mergeRecords = (\n  base: Record<string, SettingsValue> | null | undefined,\n  next: Record<string, SettingsValue> | null | undefined,\n) => ({ ...(base ?? {}), ...(next ?? {}) });\n\n/**\n * Retry helper for API calls with exponential backoff.\n */\nasync function withRetry<T>(\n  fn: () => Promise<T>,\n  maxRetries: number = 3,\n  baseDelayMs: number = 500,\n): Promise<T> {\n  for (let attempt = 0; attempt < maxRetries; attempt += 1) {\n    try {\n      return await fn();\n    } catch (error) {\n      if (attempt >= maxRetries - 1) {\n        throw error;\n      }\n\n      const delay = baseDelayMs * 2 ** attempt;\n\n      await new Promise<void>((resolve) => {\n        setTimeout(resolve, delay);\n      });\n    }\n  }\n\n  throw new Error(\"Retry attempts exhausted\");\n}\n\n/**\n * In-memory cache for settings to avoid repeated network calls.\n * The cache is invalidated on save operations.\n */\nlet settingsCache: {\n  /** Settings with redacted secrets for display */\n  redacted: SettingsApiResponse | null;\n  /** Settings with encrypted secrets for conversation start */\n  encrypted: SettingsApiResponse | null;\n  /** Timestamp when the cache was last populated */\n  timestamp: number;\n} = {\n  redacted: null,\n  encrypted: null,\n  timestamp: 0,\n};\n\nconst CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes\n\nconst isCacheValid = () => Date.now() - settingsCache.timestamp < CACHE_TTL_MS;\n\nconst clearCache = () => {\n  settingsCache = { redacted: null, encrypted: null, timestamp: 0 };\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  !!value && typeof value === \"object\" && !Array.isArray(value);\n\nconst basicAuthHeader = (username: string, password: string): string => {\n  const token = btoa(`${username}:${password}`);\n  return `Basic ${token}`;\n};\n\nconst headersFromMcpAuth = (\n  auth: Record<string, unknown>,\n): Record<string, string> | null => {\n  switch (auth.strategy) {\n    case \"none\":\n      return {};\n    case \"api_key\": {\n      if (typeof auth.value !== \"string\" || !auth.value) return null;\n      const header =\n        typeof auth.header_name === \"string\" && auth.header_name\n          ? auth.header_name\n          : \"Authorization\";\n      const value =\n        header === \"Authorization\" ? `Bearer ${auth.value}` : auth.value;\n      return { [header]: value };\n    }\n    case \"bearer\":\n      if (typeof auth.value !== \"string\" || !auth.value) return null;\n      return { Authorization: `Bearer ${auth.value}` };\n    case \"basic\":\n      if (\n        typeof auth.username !== \"string\" ||\n        typeof auth.password !== \"string\"\n      ) {\n        return null;\n      }\n      return { Authorization: basicAuthHeader(auth.username, auth.password) };\n    case \"header\":\n      return stringRecord(auth.headers) ?? {};\n    case \"oauth2\": {\n      const tokens = isRecord(auth.state) ? auth.state.tokens : undefined;\n      if (!isRecord(tokens) || typeof tokens.access_token !== \"string\") {\n        return null;\n      }\n      return { Authorization: `Bearer ${tokens.access_token}` };\n    }\n    default:\n      return null;\n  }\n};\n\n/**\n * Convert SDK `auth` credentials to the cloud's header-only storage shape.\n *\n * The cloud settings endpoint applies `mcp_config` as a merge patch, so a\n * credential change must also tombstone the headers the previous credential\n * produced — otherwise stale secrets survive a strategy switch (e.g. an\n * api_key's custom header after moving to bearer). Stored headers that the\n * new credential still produces (via the patch's carried `headers` or the\n * converted auth) are left untouched; any other stored header is cleared.\n */\nconst cloudCompatibleMcpConfig = async (value: unknown): Promise<unknown> => {\n  if (!isRecord(value)) return value;\n\n  const hasWrapper = isRecord(value.mcpServers);\n  const serverMap: Record<string, unknown> = hasWrapper\n    ? (value.mcpServers as Record<string, unknown>)\n    : value;\n\n  const needsStoredCredential =\n    Object.values(serverMap).some(\n      (server) =>\n        isRecord(server) && isRecord(server.auth) && server.auth !== null,\n    ) && getActiveBackend().backend.kind === \"cloud\";\n\n  const storedHeadersByServer = new Map<string, Record<string, string>>();\n  if (needsStoredCredential) {\n    try {\n      const stored = await fetchCloudSettings();\n      const storedMcp = isRecord(stored.mcp_config) ? stored.mcp_config : {};\n      for (const [name, server] of Object.entries(storedMcp)) {\n        if (isRecord(server)) {\n          const headers = stringRecord(\n            (server as Record<string, unknown>).headers,\n          );\n          if (headers) storedHeadersByServer.set(name, headers);\n        }\n      }\n    } catch {\n      // Fall back to the patch-only conversion; a transient fetch failure\n      // must not block saving the user's explicit edits.\n    }\n  }\n\n  const converted = Object.fromEntries(\n    Object.entries(serverMap).map(([name, server]) => {\n      if (!isRecord(server)) return [name, server];\n      if (server.auth === null) {\n        const nextServer: Record<string, unknown> = {\n          ...server,\n          headers: null,\n        };\n        delete nextServer.auth;\n        return [name, nextServer];\n      }\n      if (!isRecord(server.auth)) return [name, server];\n\n      const authHeaders = headersFromMcpAuth(server.auth);\n      if (authHeaders === null) return [name, server];\n\n      const nextServer = { ...server };\n      const existingHeaders = stringRecord(server.headers) ?? {};\n      const mergedHeaders: Record<string, string | null> = {\n        ...existingHeaders,\n        ...authHeaders,\n      };\n\n      const storedHeaders = storedHeadersByServer.get(name);\n      if (storedHeaders) {\n        for (const key of Object.keys(storedHeaders)) {\n          if (!(key in mergedHeaders)) mergedHeaders[key] = null;\n        }\n      }\n\n      delete nextServer.auth;\n      if (Object.keys(mergedHeaders).length > 0) {\n        nextServer.headers = mergedHeaders;\n      } else {\n        delete nextServer.headers;\n      }\n      return [name, nextServer];\n    }),\n  );\n\n  return hasWrapper ? { ...value, mcpServers: converted } : converted;\n};\n\n/**\n * Transform API response into Settings object with derived fields.\n */\nconst transformApiResponse = (\n  response: SettingsApiResponse,\n): Partial<Settings> => {\n  const agentSettings = response.agent_settings ?? {};\n  const conversationSettings = response.conversation_settings ?? {};\n\n  const partial: Partial<Settings> = {\n    agent_settings: agentSettings,\n    conversation_settings: conversationSettings,\n    llm_api_key_set: response.llm_api_key_is_set,\n  };\n\n  // App-level user preferences come back nested under\n  // `misc_settings.app_preferences` from the local agent-server (added in\n  // 1.27, restructured into the `misc_settings` container in the follow-up\n  // refactor). Hoist them onto the flat Settings shape the rest of the\n  // frontend already speaks. Older servers omit the `misc_settings` field\n  // entirely; the migration helper invoked from `getSettings` promotes any\n  // leftover localStorage values to the server on first run, so the omitted\n  // case just falls back to defaults.\n  const prefs = response.misc_settings?.app_preferences;\n  if (prefs) {\n    for (const key of APP_PREFERENCE_FIELDS) {\n      const value = prefs[key];\n      if (value !== undefined) {\n        (partial as Record<string, unknown>)[key] = value;\n      }\n    }\n  }\n\n  return partial;\n};\n\n/**\n * Sync derived settings fields from agent_settings and conversation_settings.\n * This ensures backward compatibility with code that reads top-level fields.\n */\nconst syncDerivedSettings = (settings: Partial<Settings>): Settings => {\n  const agentSettings = mergeRecords(\n    DEFAULT_SETTINGS.agent_settings ?? {},\n    settings.agent_settings ?? {},\n  );\n  const conversationSettings = mergeRecords(\n    DEFAULT_SETTINGS.conversation_settings ?? {},\n    settings.conversation_settings ?? {},\n  );\n\n  const merged = {\n    ...deepClone(DEFAULT_SETTINGS),\n    ...settings,\n    provider_tokens_set: {\n      ...(DEFAULT_SETTINGS.provider_tokens_set ?? {}),\n      ...(settings.provider_tokens_set ?? {}),\n    },\n    agent_settings: agentSettings,\n    conversation_settings: conversationSettings,\n  } as Settings;\n\n  const llm = agentSettings.llm as Record<string, SettingsValue> | undefined;\n  const condenser = agentSettings.condenser as\n    | Record<string, SettingsValue>\n    | undefined;\n\n  if (typeof agentSettings.agent === \"string\") {\n    merged.agent = agentSettings.agent;\n  }\n  if (typeof llm?.model === \"string\" && llm.model.length > 0) {\n    merged.llm_model = llm.model;\n  }\n  if (typeof llm?.base_url === \"string\") {\n    merged.llm_base_url = llm.base_url;\n  }\n  // Note: api_key may be redacted (\"**********\") when fetched without expose header\n  // We don't sync it to top-level llm_api_key to avoid overwriting with redacted value\n  if (typeof condenser?.enabled === \"boolean\") {\n    merged.enable_default_condenser = condenser.enabled;\n  }\n  if (typeof condenser?.max_size === \"number\") {\n    merged.condenser_max_size = condenser.max_size;\n  }\n  if (typeof conversationSettings.confirmation_mode === \"boolean\") {\n    merged.confirmation_mode = conversationSettings.confirmation_mode;\n  }\n  if (\n    typeof conversationSettings.security_analyzer === \"string\" ||\n    conversationSettings.security_analyzer === null\n  ) {\n    merged.security_analyzer = conversationSettings.security_analyzer as\n      | string\n      | null;\n  }\n  if (typeof conversationSettings.max_iterations === \"number\") {\n    merged.max_iterations = conversationSettings.max_iterations;\n  }\n\n  merged.search_api_key_set = !!merged.search_api_key;\n\n  return merged;\n};\n\nclass SettingsService {\n  /**\n   * Fetch settings from the agent server API with retry logic.\n   *\n   * @param exposeSecrets - Controls how secrets are returned:\n   *   - undefined: Secrets are redacted (\"**********\") - safe for display\n   *   - \"encrypted\": Secrets are cipher-encrypted - safe for round-trip to start conversation\n   *   - \"plaintext\": Raw secrets - DO NOT USE from frontend\n   */\n  static async fetchSettingsFromApi(\n    exposeSecrets?: ExposeSecretsMode,\n  ): Promise<SettingsApiResponse> {\n    return withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).getSettings({\n        exposeSecrets,\n      }),\n    ) as Promise<SettingsApiResponse>;\n  }\n\n  /**\n   * Get settings for display (secrets are redacted).\n   * Uses in-memory cache for performance.\n   */\n  static async getSettings(): Promise<Settings> {\n    // Cloud uses a different settings shape (flat top-level fields\n    // including provider_tokens_set, llm_model, etc.). Branch out before\n    // touching the local-only cache: cloud responses bypass the local\n    // SettingsApiResponse shape and feed straight into syncDerivedSettings\n    // so cloud-native fields like provider_tokens_set reach the GUI's\n    // useUserProviders → useAppInstallations → useGitRepositories chain.\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      try {\n        const cloud = await withRetry(() => fetchCloudSettings());\n        return syncDerivedSettings(cloud);\n      } catch (error) {\n        console.warn(\"Failed to fetch cloud settings, using defaults:\", error);\n        return syncDerivedSettings({});\n      }\n    }\n\n    // Check cache first\n    if (isCacheValid() && settingsCache.redacted) {\n      return syncDerivedSettings(transformApiResponse(settingsCache.redacted));\n    }\n\n    try {\n      const response = await this.fetchSettingsFromApi();\n      settingsCache.redacted = response;\n      settingsCache.timestamp = Date.now();\n      return syncDerivedSettings(transformApiResponse(response));\n    } catch (error) {\n      // If API fails, return defaults\n      console.warn(\"Failed to fetch settings from API, using defaults:\", error);\n      return syncDerivedSettings({});\n    }\n  }\n\n  /**\n   * Get settings with encrypted secrets for starting conversations.\n   * The encrypted secrets can be passed to the start conversation API\n   * with secrets_encrypted=true for server-side decryption.\n   *\n   * @throws Error if encrypted settings cannot be fetched - conversations\n   *   should not start with broken/redacted credentials.\n   */\n  static async getSettingsForConversation(): Promise<{\n    agentSettings: Record<string, SettingsValue>;\n    conversationSettings: Record<string, SettingsValue>;\n    secretsEncrypted: boolean;\n  }> {\n    // Check cache first\n    if (isCacheValid() && settingsCache.encrypted) {\n      return {\n        agentSettings: settingsCache.encrypted.agent_settings,\n        conversationSettings: settingsCache.encrypted.conversation_settings,\n        secretsEncrypted: true,\n      };\n    }\n\n    // Fetch encrypted settings - this MUST succeed for conversations to work.\n    // Do not fall back to redacted settings as that would cause auth failures.\n    const response = await this.fetchSettingsFromApi(\"encrypted\");\n    settingsCache.encrypted = response;\n    if (!settingsCache.timestamp) {\n      settingsCache.timestamp = Date.now();\n    }\n    return {\n      agentSettings: response.agent_settings,\n      conversationSettings: response.conversation_settings,\n      secretsEncrypted: true,\n    };\n  }\n\n  static async getSettingsSchema(): Promise<SettingsSchema> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return (await fetchCloudSettingsSchema()) as SettingsSchema;\n    }\n    return (await new SettingsClient(\n      getAgentServerClientOptions(),\n    ).getAgentSchema()) as SettingsSchema;\n  }\n\n  static async getConversationSettingsSchema(): Promise<SettingsSchema> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return (await fetchCloudConversationSettingsSchema()) as SettingsSchema;\n    }\n    return (await new SettingsClient(\n      getAgentServerClientOptions(),\n    ).getConversationSchema()) as SettingsSchema;\n  }\n\n  /**\n   * Apply one name-keyed MCP merge patch in exactly one request. The server\n   * owns the stored catalog and secret preservation; Canvas never rebuilds\n   * the catalog from redacted display settings.\n   */\n  static async patchMcpConfig(patch: MCPConfigPatch): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      const mcpConfig = await cloudCompatibleMcpConfig(patch);\n      await withRetry(() =>\n        saveCloudSettings({\n          agent_settings_diff: { mcp_config: mcpConfig as SettingsValue },\n        }),\n      );\n    } else {\n      await withRetry(() =>\n        new SettingsClient(getAgentServerClientOptions()).updateSettings({\n          agent_settings_diff: { mcp_config: patch },\n        }),\n      );\n    }\n    clearCache();\n    return true;\n  }\n\n  static async patchMcpServer(\n    settingsKey: string,\n    patch: MCPServerPatch,\n  ): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return SettingsService.patchMcpConfig({ [settingsKey]: patch });\n    }\n    await withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).patchMcpServer(\n        settingsKey,\n        patch,\n      ),\n    );\n    clearCache();\n    return true;\n  }\n\n  static async createMcpServer(\n    settingsKey: string,\n    server: MCPServer,\n  ): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return SettingsService.patchMcpConfig({ [settingsKey]: server });\n    }\n    await withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).createMcpServer(\n        settingsKey,\n        server,\n      ),\n    );\n    clearCache();\n    return true;\n  }\n\n  static async deleteMcpServer(settingsKey: string): Promise<boolean> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return SettingsService.patchMcpConfig({ [settingsKey]: null });\n    }\n    await withRetry(() =>\n      new SettingsClient(getAgentServerClientOptions()).deleteMcpServer(\n        settingsKey,\n      ),\n    );\n    clearCache();\n    return true;\n  }\n\n  /**\n   * Save settings to the agent server API.\n   * Uses PATCH for incremental updates.\n   */\n  static async saveSettings(\n    settings: Partial<Settings> & Record<string, unknown>,\n  ): Promise<boolean> {\n    // Split app-level user-preference fields (language, git identity, sound\n    // notifications, analytics consent, disabled_skills) off and route them\n    // through `misc_settings_diff.app_preferences` (local) or as flat\n    // top-level keys (cloud). The local agent-server stores them under\n    // `PersistedSettings.misc_settings.app_preferences`; the cloud accepts\n    // them as flat keys on `POST /api/v1/settings`.\n    const { extracted: appPreferences, rest } = extractAppPreferences(\n      settings as Record<string, unknown>,\n    );\n    const hasAppPreferences = Object.keys(appPreferences).length > 0;\n\n    const payload: SettingsUpdateRequest = {};\n\n    // Extract agent_settings_diff\n    const agentSettingsDiff = rest.agent_settings_diff as\n      | Record<string, SettingsValue>\n      | undefined;\n    if (agentSettingsDiff && Object.keys(agentSettingsDiff).length > 0) {\n      payload.agent_settings_diff = agentSettingsDiff;\n    }\n\n    // Extract conversation_settings_diff\n    const conversationSettingsDiff = rest.conversation_settings_diff as\n      | Record<string, SettingsValue>\n      | undefined;\n    if (\n      conversationSettingsDiff &&\n      Object.keys(conversationSettingsDiff).length > 0\n    ) {\n      payload.conversation_settings_diff = conversationSettingsDiff;\n    }\n\n    if (hasAppPreferences) {\n      payload.misc_settings_diff = { app_preferences: appPreferences };\n    }\n\n    const isCloud = getActiveBackend().backend.kind === \"cloud\";\n    if (isCloud) {\n      const hasCloudWork =\n        !!payload.agent_settings_diff ||\n        !!payload.conversation_settings_diff ||\n        hasAppPreferences;\n      if (!hasCloudWork) {\n        return true;\n      }\n      // Build the cloud payload from the same diffs, but as a separate\n      // object so undefined keys don't appear in the call (saveCloudSettings\n      // is called from tests with an exact-shape assertion).\n      const cloudPayload: Parameters<typeof saveCloudSettings>[0] = {};\n      if (payload.agent_settings_diff) {\n        cloudPayload.agent_settings_diff = { ...payload.agent_settings_diff };\n        if (\"mcp_config\" in cloudPayload.agent_settings_diff) {\n          cloudPayload.agent_settings_diff.mcp_config =\n            (await cloudCompatibleMcpConfig(\n              cloudPayload.agent_settings_diff.mcp_config,\n            )) as SettingsValue;\n        }\n      }\n      if (payload.conversation_settings_diff) {\n        cloudPayload.conversation_settings_diff =\n          payload.conversation_settings_diff;\n      }\n      if (hasAppPreferences) {\n        // The cloud `POST /api/v1/settings` takes app-preference fields as\n        // flat top-level keys (not under `app_preferences_diff`).\n        // `saveCloudSettings` re-flattens them onto the request body.\n        cloudPayload.app_preferences = appPreferences;\n      }\n      await withRetry(() => saveCloudSettings(cloudPayload));\n    } else {\n      // The local agent-server PATCH /api/settings requires at least one of\n      // the three diff fields. Skip the request entirely if nothing changed.\n      const hasLocalDiffs =\n        !!payload.agent_settings_diff ||\n        !!payload.conversation_settings_diff ||\n        !!payload.misc_settings_diff;\n      if (!hasLocalDiffs) {\n        return true;\n      }\n      await withRetry(() =>\n        new SettingsClient(getAgentServerClientOptions()).updateSettings(\n          payload,\n        ),\n      );\n    }\n\n    // Invalidate cache after successful save\n    clearCache();\n\n    return true;\n  }\n\n  /**\n   * Invalidate the settings cache.\n   * Call this when settings may have changed externally.\n   */\n  static invalidateCache(): void {\n    clearCache();\n  }\n}\n\nexport default SettingsService;\n"],"mappings":"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"}

package/dist/components/conversation-events/chat/event-content-helpers/create-skill-ready-event.cjs

@@ -1,2 +1,2 @@
-require("../../../../_virtual/_rolldown/runtime.cjs");const e=require("./get-skill-ready-content.cjs");var t=e=>typeof e==`object`&&!!e&&`_isSkillReadyEvent`in e&&e._isSkillReadyEvent===!0,n=t=>{let n=t.activated_skills||t.activated_microagents||[],r=t.extended_content||[];if(n.length===0&&r.length===0)throw Error(`Cannot create skill ready event without activated skills or extended content`);let i=e.getSkillReadyContent(n,r),a=e.getSkillReadyItems(n,r);return{id:`${t.id}-skill-ready`,timestamp:t.timestamp,source:`agent`,_isSkillReadyEvent:!0,_skillReadyContent:i,_skillReadyItems:a}};exports.createSkillReadyEvent=n,exports.isSkillReadyEvent=t;
+require("../../../../_virtual/_rolldown/runtime.cjs");const e=require("./get-skill-ready-content.cjs");var t=e=>typeof e==`object`&&!!e&&`_isSkillReadyEvent`in e&&e._isSkillReadyEvent===!0,n=t=>{let n=t.activated_skills||[],r=t.extended_content||[];if(n.length===0&&r.length===0)throw Error(`Cannot create skill ready event without activated skills or extended content`);let i=e.getSkillReadyContent(n,r),a=e.getSkillReadyItems(n,r);return{id:`${t.id}-skill-ready`,timestamp:t.timestamp,source:`agent`,_isSkillReadyEvent:!0,_skillReadyContent:i,_skillReadyItems:a}};exports.createSkillReadyEvent=n,exports.isSkillReadyEvent=t;
 //# sourceMappingURL=create-skill-ready-event.cjs.map

package/dist/components/conversation-events/chat/event-content-helpers/create-skill-ready-event.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-skill-ready-event.cjs","names":[],"sources":["../../../../../src/components/conversation-events/chat/event-content-helpers/create-skill-ready-event.ts"],"sourcesContent":["import { MessageEvent } from \"#/types/agent-server/core\";\nimport { BaseEvent } from \"#/types/agent-server/core/base/event\";\nimport {\n  getSkillReadyContent,\n  getSkillReadyItems,\n  SkillReadyItem,\n} from \"./get-skill-ready-content\";\n\nexport type { SkillReadyItem };\n\n/**\n * Synthetic event type for Skill Ready events.\n * This extends BaseEvent and includes a marker to identify it as a skill ready event.\n */\nexport interface SkillReadyEvent extends BaseEvent {\n  _isSkillReadyEvent: true;\n  _skillReadyContent: string;\n  _skillReadyItems: SkillReadyItem[];\n}\n\n/**\n * Type guard for Skill Ready events.\n */\nexport const isSkillReadyEvent = (event: unknown): event is SkillReadyEvent =>\n  typeof event === \"object\" &&\n  event !== null &&\n  \"_isSkillReadyEvent\" in event &&\n  event._isSkillReadyEvent === true;\n\n/**\n * Creates a synthetic \"Skill Ready\" event from a user MessageEvent.\n * This event appears as originating from the agent and contains formatted\n * information about activated skills and extended content.\n */\nexport const createSkillReadyEvent = (\n  userEvent: MessageEvent,\n): SkillReadyEvent => {\n  // Support both activated_skills and activated_microagents field names\n  const activatedSkills =\n    (userEvent as unknown as { activated_skills?: string[] })\n      .activated_skills ||\n    userEvent.activated_microagents ||\n    [];\n\n  const extendedContent = userEvent.extended_content || [];\n\n  // Only create event if we have skills or extended content\n  if (activatedSkills.length === 0 && extendedContent.length === 0) {\n    throw new Error(\n      \"Cannot create skill ready event without activated skills or extended content\",\n    );\n  }\n\n  const content = getSkillReadyContent(activatedSkills, extendedContent);\n  const items = getSkillReadyItems(activatedSkills, extendedContent);\n\n  return {\n    id: `${userEvent.id}-skill-ready`,\n    timestamp: userEvent.timestamp,\n    source: \"agent\",\n    _isSkillReadyEvent: true,\n    _skillReadyContent: content,\n    _skillReadyItems: items,\n  };\n};\n"],"mappings":"uGAuBA,IAAa,EAAqB,GAChC,OAAO,GAAU,YACjB,GACA,uBAAwB,GACxB,EAAM,qBAAuB,GAOlB,EACX,GACoB,CAEpB,IAAM,EACH,EACE,kBACH,EAAU,uBACV,CAAC,EAEG,EAAkB,EAAU,kBAAoB,CAAC,EAGvD,GAAI,EAAgB,SAAW,GAAK,EAAgB,SAAW,EAC7D,MAAU,MACR,8EACF,EAGF,IAAM,EAAU,EAAA,qBAAqB,EAAiB,CAAe,EAC/D,EAAQ,EAAA,mBAAmB,EAAiB,CAAe,EAEjE,MAAO,CACL,GAAI,GAAG,EAAU,GAAG,cACpB,UAAW,EAAU,UACrB,OAAQ,QACR,mBAAoB,GACpB,mBAAoB,EACpB,iBAAkB,CACpB,CACF"}
+{"version":3,"file":"create-skill-ready-event.cjs","names":[],"sources":["../../../../../src/components/conversation-events/chat/event-content-helpers/create-skill-ready-event.ts"],"sourcesContent":["import { MessageEvent } from \"#/types/agent-server/core\";\nimport { BaseEvent } from \"#/types/agent-server/core/base/event\";\nimport {\n  getSkillReadyContent,\n  getSkillReadyItems,\n  SkillReadyItem,\n} from \"./get-skill-ready-content\";\n\nexport type { SkillReadyItem };\n\n/**\n * Synthetic event type for Skill Ready events.\n * This extends BaseEvent and includes a marker to identify it as a skill ready event.\n */\nexport interface SkillReadyEvent extends BaseEvent {\n  _isSkillReadyEvent: true;\n  _skillReadyContent: string;\n  _skillReadyItems: SkillReadyItem[];\n}\n\n/**\n * Type guard for Skill Ready events.\n */\nexport const isSkillReadyEvent = (event: unknown): event is SkillReadyEvent =>\n  typeof event === \"object\" &&\n  event !== null &&\n  \"_isSkillReadyEvent\" in event &&\n  event._isSkillReadyEvent === true;\n\n/**\n * Creates a synthetic \"Skill Ready\" event from a user MessageEvent.\n * This event appears as originating from the agent and contains formatted\n * information about activated skills and extended content.\n */\nexport const createSkillReadyEvent = (\n  userEvent: MessageEvent,\n): SkillReadyEvent => {\n  const activatedSkills = userEvent.activated_skills || [];\n\n  const extendedContent = userEvent.extended_content || [];\n\n  // Only create event if we have skills or extended content\n  if (activatedSkills.length === 0 && extendedContent.length === 0) {\n    throw new Error(\n      \"Cannot create skill ready event without activated skills or extended content\",\n    );\n  }\n\n  const content = getSkillReadyContent(activatedSkills, extendedContent);\n  const items = getSkillReadyItems(activatedSkills, extendedContent);\n\n  return {\n    id: `${userEvent.id}-skill-ready`,\n    timestamp: userEvent.timestamp,\n    source: \"agent\",\n    _isSkillReadyEvent: true,\n    _skillReadyContent: content,\n    _skillReadyItems: items,\n  };\n};\n"],"mappings":"uGAuBA,IAAa,EAAqB,GAChC,OAAO,GAAU,YACjB,GACA,uBAAwB,GACxB,EAAM,qBAAuB,GAOlB,EACX,GACoB,CACpB,IAAM,EAAkB,EAAU,kBAAoB,CAAC,EAEjD,EAAkB,EAAU,kBAAoB,CAAC,EAGvD,GAAI,EAAgB,SAAW,GAAK,EAAgB,SAAW,EAC7D,MAAU,MACR,8EACF,EAGF,IAAM,EAAU,EAAA,qBAAqB,EAAiB,CAAe,EAC/D,EAAQ,EAAA,mBAAmB,EAAiB,CAAe,EAEjE,MAAO,CACL,GAAI,GAAG,EAAU,GAAG,cACpB,UAAW,EAAU,UACrB,OAAQ,QACR,mBAAoB,GACpB,mBAAoB,EACpB,iBAAkB,CACpB,CACF"}

package/dist/components/conversation-events/chat/event-content-helpers/create-skill-ready-event.js

@@ -1,7 +1,7 @@
 import { getSkillReadyContent as e, getSkillReadyItems as t } from "./get-skill-ready-content.js";
 //#region src/components/conversation-events/chat/event-content-helpers/create-skill-ready-event.ts
 var n = (e) => typeof e == "object" && !!e && "_isSkillReadyEvent" in e && e._isSkillReadyEvent === !0, r = (n) => {
-	let r = n.activated_skills || n.activated_microagents || [], i = n.extended_content || [];
+	let r = n.activated_skills || [], i = n.extended_content || [];
 	if (r.length === 0 && i.length === 0) throw Error("Cannot create skill ready event without activated skills or extended content");
 	let a = e(r, i), o = t(r, i);
 	return {

package/dist/components/conversation-events/chat/event-content-helpers/create-skill-ready-event.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-skill-ready-event.js","names":[],"sources":["../../../../../src/components/conversation-events/chat/event-content-helpers/create-skill-ready-event.ts"],"sourcesContent":["import { MessageEvent } from \"#/types/agent-server/core\";\nimport { BaseEvent } from \"#/types/agent-server/core/base/event\";\nimport {\n  getSkillReadyContent,\n  getSkillReadyItems,\n  SkillReadyItem,\n} from \"./get-skill-ready-content\";\n\nexport type { SkillReadyItem };\n\n/**\n * Synthetic event type for Skill Ready events.\n * This extends BaseEvent and includes a marker to identify it as a skill ready event.\n */\nexport interface SkillReadyEvent extends BaseEvent {\n  _isSkillReadyEvent: true;\n  _skillReadyContent: string;\n  _skillReadyItems: SkillReadyItem[];\n}\n\n/**\n * Type guard for Skill Ready events.\n */\nexport const isSkillReadyEvent = (event: unknown): event is SkillReadyEvent =>\n  typeof event === \"object\" &&\n  event !== null &&\n  \"_isSkillReadyEvent\" in event &&\n  event._isSkillReadyEvent === true;\n\n/**\n * Creates a synthetic \"Skill Ready\" event from a user MessageEvent.\n * This event appears as originating from the agent and contains formatted\n * information about activated skills and extended content.\n */\nexport const createSkillReadyEvent = (\n  userEvent: MessageEvent,\n): SkillReadyEvent => {\n  // Support both activated_skills and activated_microagents field names\n  const activatedSkills =\n    (userEvent as unknown as { activated_skills?: string[] })\n      .activated_skills ||\n    userEvent.activated_microagents ||\n    [];\n\n  const extendedContent = userEvent.extended_content || [];\n\n  // Only create event if we have skills or extended content\n  if (activatedSkills.length === 0 && extendedContent.length === 0) {\n    throw new Error(\n      \"Cannot create skill ready event without activated skills or extended content\",\n    );\n  }\n\n  const content = getSkillReadyContent(activatedSkills, extendedContent);\n  const items = getSkillReadyItems(activatedSkills, extendedContent);\n\n  return {\n    id: `${userEvent.id}-skill-ready`,\n    timestamp: userEvent.timestamp,\n    source: \"agent\",\n    _isSkillReadyEvent: true,\n    _skillReadyContent: content,\n    _skillReadyItems: items,\n  };\n};\n"],"mappings":";;AAuBA,IAAa,KAAqB,MAChC,OAAO,KAAU,cACjB,KACA,wBAAwB,KACxB,EAAM,uBAAuB,IAOlB,KACX,MACoB;CAEpB,IAAM,IACH,EACE,oBACH,EAAU,yBACV,CAAC,GAEG,IAAkB,EAAU,oBAAoB,CAAC;CAGvD,IAAI,EAAgB,WAAW,KAAK,EAAgB,WAAW,GAC7D,MAAU,MACR,8EACF;CAGF,IAAM,IAAU,EAAqB,GAAiB,CAAe,GAC/D,IAAQ,EAAmB,GAAiB,CAAe;CAEjE,OAAO;EACL,IAAI,GAAG,EAAU,GAAG;EACpB,WAAW,EAAU;EACrB,QAAQ;EACR,oBAAoB;EACpB,oBAAoB;EACpB,kBAAkB;CACpB;AACF"}
+{"version":3,"file":"create-skill-ready-event.js","names":[],"sources":["../../../../../src/components/conversation-events/chat/event-content-helpers/create-skill-ready-event.ts"],"sourcesContent":["import { MessageEvent } from \"#/types/agent-server/core\";\nimport { BaseEvent } from \"#/types/agent-server/core/base/event\";\nimport {\n  getSkillReadyContent,\n  getSkillReadyItems,\n  SkillReadyItem,\n} from \"./get-skill-ready-content\";\n\nexport type { SkillReadyItem };\n\n/**\n * Synthetic event type for Skill Ready events.\n * This extends BaseEvent and includes a marker to identify it as a skill ready event.\n */\nexport interface SkillReadyEvent extends BaseEvent {\n  _isSkillReadyEvent: true;\n  _skillReadyContent: string;\n  _skillReadyItems: SkillReadyItem[];\n}\n\n/**\n * Type guard for Skill Ready events.\n */\nexport const isSkillReadyEvent = (event: unknown): event is SkillReadyEvent =>\n  typeof event === \"object\" &&\n  event !== null &&\n  \"_isSkillReadyEvent\" in event &&\n  event._isSkillReadyEvent === true;\n\n/**\n * Creates a synthetic \"Skill Ready\" event from a user MessageEvent.\n * This event appears as originating from the agent and contains formatted\n * information about activated skills and extended content.\n */\nexport const createSkillReadyEvent = (\n  userEvent: MessageEvent,\n): SkillReadyEvent => {\n  const activatedSkills = userEvent.activated_skills || [];\n\n  const extendedContent = userEvent.extended_content || [];\n\n  // Only create event if we have skills or extended content\n  if (activatedSkills.length === 0 && extendedContent.length === 0) {\n    throw new Error(\n      \"Cannot create skill ready event without activated skills or extended content\",\n    );\n  }\n\n  const content = getSkillReadyContent(activatedSkills, extendedContent);\n  const items = getSkillReadyItems(activatedSkills, extendedContent);\n\n  return {\n    id: `${userEvent.id}-skill-ready`,\n    timestamp: userEvent.timestamp,\n    source: \"agent\",\n    _isSkillReadyEvent: true,\n    _skillReadyContent: content,\n    _skillReadyItems: items,\n  };\n};\n"],"mappings":";;AAuBA,IAAa,KAAqB,MAChC,OAAO,KAAU,cACjB,KACA,wBAAwB,KACxB,EAAM,uBAAuB,IAOlB,KACX,MACoB;CACpB,IAAM,IAAkB,EAAU,oBAAoB,CAAC,GAEjD,IAAkB,EAAU,oBAAoB,CAAC;CAGvD,IAAI,EAAgB,WAAW,KAAK,EAAgB,WAAW,GAC7D,MAAU,MACR,8EACF;CAGF,IAAM,IAAU,EAAqB,GAAiB,CAAe,GAC/D,IAAQ,EAAmB,GAAiB,CAAe;CAEjE,OAAO;EACL,IAAI,GAAG,EAAU,GAAG;EACpB,WAAW,EAAU;EACrB,QAAQ;EACR,oBAAoB;EACpB,oBAAoB;EACpB,kBAAkB;CACpB;AACF"}

package/dist/components/conversation-events/chat/event-message-components/event-group.cjs

@@ -1,2 +1,2 @@
-const e=require("../../../../_virtual/_rolldown/runtime.cjs"),t=require("../../../../node_modules/react-i18next/dist/es/useTranslation.cjs"),n=require("../../../../i18n/declaration.cjs"),r=require("../../../../node_modules/lucide-react/dist/esm/icons/loader-circle.cjs"),i=require("../../../../types/agent-server/type-guards.cjs"),a=require("../../../../icons/angle-down-solid.cjs"),o=require("../../../../icons/angle-up-solid.cjs"),s=require("../event-content-helpers/get-event-content.cjs"),c=require("../../../features/chat/is-in-event-group-context.cjs");let l=require("react");l=e.__toESM(l,1);let u=require("react/jsx-runtime");function d({events:e,allEvents:d,isFinalized:f=!1,children:p}){let{t:m}=t.useTranslation(`openhands`),[h,g]=l.default.useState(!1),_=l.default.useId(),v=`${_}-toggle`;if(e.length===0)return null;let y=e.find(e=>i.isActionEvent(e)),b=e.filter(i.isObservationEvent).length,x=e.length,S=!!y,C=e[e.length-1],w=null;C&&(i.isActionEvent(C)?w=s.getEventContent(C).title:i.isObservationEvent(C)&&(w=s.getEventContent(C,(d??e).find(e=>i.isActionEvent(e)&&e.id===C.action_id)).title));let T=S?m(n.I18nKey.EVENT_GROUP$ACTIONS_PROGRESS,{completed:b,total:x}):m(n.I18nKey.EVENT_GROUP$ACTIONS_COMPLETED,{count:x}),E=h?o.default:a.default;return(0,u.jsxs)(`div`,{className:`my-1 w-full py-1 text-sm`,"data-testid":`event-group`,children:[(0,u.jsx)(`button`,{id:v,type:`button`,onClick:()=>g(e=>!e),"aria-controls":_,"aria-expanded":h,"aria-label":m(h?n.I18nKey.EVENT_GROUP$COLLAPSE:n.I18nKey.EVENT_GROUP$EXPAND),"data-testid":`event-group-toggle`,className:`w-full flex items-center justify-between gap-2 text-left cursor-pointer`,children:f?(0,u.jsxs)(`span`,{className:`flex items-center gap-2 min-w-0 font-normal text-[var(--oh-muted)]`,children:[(0,u.jsx)(E,{className:`h-4 w-4 fill-[var(--oh-muted)] flex-shrink-0`}),(0,u.jsx)(`span`,{className:`truncate`,children:T})]}):(0,u.jsxs)(u.Fragment,{children:[(0,u.jsxs)(`span`,{className:`flex items-center gap-2 min-w-0 font-normal text-[var(--oh-muted)]`,children:[(0,u.jsx)(E,{className:`h-4 w-4 fill-[var(--oh-muted)] flex-shrink-0`}),(0,u.jsx)(`span`,{className:`truncate`,children:w??T})]}),(0,u.jsxs)(`span`,{className:`flex items-center flex-shrink-0 font-normal text-[var(--oh-muted)]`,children:[(0,u.jsx)(`span`,{className:`truncate`,children:T}),S?(0,u.jsx)(r.LoaderCircle,{"data-testid":`spinner-icon`,className:`h-4 w-4 ml-2 inline animate-spin text-[var(--oh-muted)]`}):null]})]})}),h&&(0,u.jsx)(`div`,{id:_,role:`region`,"aria-labelledby":v,className:`mt-1.5 flex flex-col`,"data-testid":`event-group-content`,children:(0,u.jsx)(c.IsInEventGroupContext.Provider,{value:!0,children:p})})]})}exports.EventGroup=d;
+const e=require("../../../../_virtual/_rolldown/runtime.cjs"),t=require("../../../../node_modules/react-i18next/dist/es/useTranslation.cjs"),n=require("../../../../i18n/declaration.cjs"),r=require("../../../../node_modules/lucide-react/dist/esm/icons/loader-circle.cjs"),i=require("../../../../types/agent-server/type-guards.cjs"),a=require("../../../../icons/angle-down-solid.cjs"),o=require("../../../../icons/angle-up-solid.cjs"),s=require("../../../features/chat/path-component.cjs"),c=require("../event-content-helpers/get-event-content.cjs"),l=require("../../../features/chat/is-in-event-group-context.cjs");let u=require("react");u=e.__toESM(u,1);let d=require("react/jsx-runtime");function f({events:e,allEvents:f,isFinalized:p=!1,children:m}){let{t:h}=t.useTranslation(`openhands`),[g,_]=u.default.useState(!1),v=u.default.useId(),y=`${v}-toggle`;if(e.length===0)return null;let b=e.find(e=>i.isActionEvent(e)),x=e.filter(i.isObservationEvent).length,S=e.length,C=!!b,w=e[e.length-1],T=null;w&&(i.isActionEvent(w)?T=c.getEventContent(w).title:i.isObservationEvent(w)&&(T=c.getEventContent(w,(f??e).find(e=>i.isActionEvent(e)&&e.id===w.action_id)).title));let E=C?h(n.I18nKey.EVENT_GROUP$ACTIONS_PROGRESS,{completed:x,total:S}):h(n.I18nKey.EVENT_GROUP$ACTIONS_COMPLETED,{count:S}),D=g?o.default:a.default;return(0,d.jsxs)(`div`,{className:`my-1 w-full py-1 text-sm`,"data-testid":`event-group`,children:[(0,d.jsx)(`button`,{id:y,type:`button`,onClick:()=>_(e=>!e),"aria-controls":v,"aria-expanded":g,"aria-label":h(g?n.I18nKey.EVENT_GROUP$COLLAPSE:n.I18nKey.EVENT_GROUP$EXPAND),"data-testid":`event-group-toggle`,className:`w-full flex items-center justify-between gap-2 text-left cursor-pointer`,children:p?(0,d.jsxs)(`span`,{className:`flex items-center gap-2 min-w-0 font-normal text-[var(--oh-muted)]`,children:[(0,d.jsx)(D,{className:`h-4 w-4 fill-[var(--oh-muted)] flex-shrink-0`}),(0,d.jsx)(`span`,{className:`truncate`,children:E})]}):(0,d.jsxs)(d.Fragment,{children:[(0,d.jsxs)(`span`,{className:`flex items-center gap-2 min-w-0 font-normal text-[var(--oh-muted)]`,children:[(0,d.jsx)(D,{className:`h-4 w-4 fill-[var(--oh-muted)] flex-shrink-0`}),(0,d.jsx)(`span`,{className:`truncate`,children:(0,d.jsx)(s.PathInteractiveContext.Provider,{value:!1,children:T??E})})]}),(0,d.jsxs)(`span`,{className:`flex items-center flex-shrink-0 font-normal text-[var(--oh-muted)]`,children:[(0,d.jsx)(`span`,{className:`truncate`,children:E}),C?(0,d.jsx)(r.LoaderCircle,{"data-testid":`spinner-icon`,className:`h-4 w-4 ml-2 inline animate-spin text-[var(--oh-muted)]`}):null]})]})}),g&&(0,d.jsx)(`div`,{id:v,role:`region`,"aria-labelledby":y,className:`mt-1.5 flex flex-col`,"data-testid":`event-group-content`,children:(0,d.jsx)(l.IsInEventGroupContext.Provider,{value:!0,children:m})})]})}exports.EventGroup=f;
 //# sourceMappingURL=event-group.cjs.map

package/dist/components/conversation-events/chat/event-message-components/event-group.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"event-group.cjs","names":[],"sources":["../../../../../src/components/conversation-events/chat/event-message-components/event-group.tsx"],"sourcesContent":["import React from \"react\";\nimport { useTranslation } from \"react-i18next\";\nimport { LoaderCircle } from \"lucide-react\";\nimport ArrowDown from \"#/icons/angle-down-solid.svg?react\";\nimport ArrowUp from \"#/icons/angle-up-solid.svg?react\";\nimport { OpenHandsEvent, ActionEvent } from \"#/types/agent-server/core\";\nimport {\n  isActionEvent,\n  isObservationEvent,\n} from \"#/types/agent-server/type-guards\";\nimport { I18nKey } from \"#/i18n/declaration\";\nimport { getEventContent } from \"../event-content-helpers/get-event-content\";\nimport { IsInEventGroupContext } from \"../../../features/chat/is-in-event-group-context\";\n\ninterface EventGroupProps {\n  /** The events represented by this group. Used to compute the summary. */\n  events: OpenHandsEvent[];\n  /**\n   * Full event history. Used to resolve the action that produced the latest\n   * observation in the group so the summary title matches what the individual\n   * card would show (e.g. \"Editing path/to/file\"). Falls back to `events` when\n   * omitted.\n   */\n  allEvents?: OpenHandsEvent[];\n  /**\n   * `true` once an event outside this group has been emitted after it, so the\n   * group is no longer the \"live\" tail of the chat. While `false` (the\n   * default), the group keeps showing the most recent action's title as its\n   * prominent summary, with the count of completed actions shown subtly on\n   * the right.\n   */\n  isFinalized?: boolean;\n  /** The fully-rendered event messages to show when the group is expanded. */\n  children: React.ReactNode;\n}\n\n/**\n * Collapsible container that wraps a run of consecutive agent action/observation\n * events into a single summary card.\n *\n * Collapsed, while the group is still the live tail of the chat\n * (`isFinalized=false`):\n *   - Left (prominent): the title of the most recent action/observation in\n *     the group — i.e. either the action currently in flight, or the latest\n *     completed step.\n *   - Right (subdued):  \"{completed}/{total} actions completed\" while at\n *     least one action is still pending (with a spinner), otherwise\n *     \"{count} actions completed\" followed by a success check.\n *\n * Collapsed, after the group has been \"moved past\" (`isFinalized=true`):\n *   - \"{count} actions completed\" is promoted to the prominent foreground\n *     style and the count is the only thing shown next to the chevron.\n *\n * Expanded:\n *   - Renders the children verbatim, so each individual action/observation can\n *     still be expanded the way it was before grouping.\n */\nexport function EventGroup({\n  events,\n  allEvents,\n  isFinalized = false,\n  children,\n}: EventGroupProps) {\n  const { t } = useTranslation(\"openhands\");\n  const [expanded, setExpanded] = React.useState(false);\n  const contentId = React.useId();\n  const buttonId = `${contentId}-toggle`;\n\n  if (events.length === 0) {\n    return null;\n  }\n\n  // Each ObservationEvent in the group is a completed action. An ActionEvent\n  // that's still here (i.e. not yet replaced by its observation in the UI\n  // events array) is an action currently in flight.\n  const pendingAction = events.find((e): e is ActionEvent => isActionEvent(e));\n  const completedCount = events.filter(isObservationEvent).length;\n  const totalCount = events.length;\n  const isRunning = !!pendingAction;\n\n  // Title of the most recent groupable event. While running this is the\n  // pending action; otherwise it's the latest observation, with its\n  // originating action looked up so the title can be the action-style summary\n  // (\"Editing path/to/file\") instead of the observation default.\n  const latestEvent = events[events.length - 1];\n  let latestTitle: React.ReactNode = null;\n  if (latestEvent) {\n    if (isActionEvent(latestEvent)) {\n      latestTitle = getEventContent(latestEvent).title;\n    } else if (isObservationEvent(latestEvent)) {\n      const lookupSource = allEvents ?? events;\n      const correspondingAction = lookupSource.find(\n        (e): e is ActionEvent =>\n          isActionEvent(e) && e.id === latestEvent.action_id,\n      );\n      latestTitle = getEventContent(latestEvent, correspondingAction).title;\n    }\n  }\n\n  const countSummary = isRunning\n    ? t(I18nKey.EVENT_GROUP$ACTIONS_PROGRESS, {\n        completed: completedCount,\n        total: totalCount,\n      })\n    : t(I18nKey.EVENT_GROUP$ACTIONS_COMPLETED, { count: totalCount });\n\n  const Chevron = expanded ? ArrowUp : ArrowDown;\n\n  return (\n    <div className=\"my-1 w-full py-1 text-sm\" data-testid=\"event-group\">\n      <button\n        id={buttonId}\n        type=\"button\"\n        onClick={() => setExpanded((prev) => !prev)}\n        aria-controls={contentId}\n        aria-expanded={expanded}\n        aria-label={\n          expanded\n            ? t(I18nKey.EVENT_GROUP$COLLAPSE)\n            : t(I18nKey.EVENT_GROUP$EXPAND)\n        }\n        data-testid=\"event-group-toggle\"\n        className=\"w-full flex items-center justify-between gap-2 text-left cursor-pointer\"\n      >\n        {isFinalized ? (\n          <span className=\"flex items-center gap-2 min-w-0 font-normal text-[var(--oh-muted)]\">\n            <Chevron className=\"h-4 w-4 fill-[var(--oh-muted)] flex-shrink-0\" />\n            <span className=\"truncate\">{countSummary}</span>\n          </span>\n        ) : (\n          <>\n            <span className=\"flex items-center gap-2 min-w-0 font-normal text-[var(--oh-muted)]\">\n              <Chevron className=\"h-4 w-4 fill-[var(--oh-muted)] flex-shrink-0\" />\n              <span className=\"truncate\">{latestTitle ?? countSummary}</span>\n            </span>\n            <span className=\"flex items-center flex-shrink-0 font-normal text-[var(--oh-muted)]\">\n              <span className=\"truncate\">{countSummary}</span>\n              {isRunning ? (\n                <LoaderCircle\n                  data-testid=\"spinner-icon\"\n                  className=\"h-4 w-4 ml-2 inline animate-spin text-[var(--oh-muted)]\"\n                />\n              ) : null}\n            </span>\n          </>\n        )}\n      </button>\n\n      {expanded && (\n        <div\n          id={contentId}\n          role=\"region\"\n          aria-labelledby={buttonId}\n          className=\"mt-1.5 flex flex-col\"\n          data-testid=\"event-group-content\"\n        >\n          <IsInEventGroupContext.Provider value>\n            {children}\n          </IsInEventGroupContext.Provider>\n        </div>\n      )}\n    </div>\n  );\n}\n"],"mappings":"0nBAyDA,SAAgB,EAAW,CACzB,SACA,YACA,cAAc,GACd,YACkB,CAClB,GAAM,CAAE,KAAM,EAAA,eAAe,WAAW,EAClC,CAAC,EAAU,GAAe,EAAA,QAAM,SAAS,EAAK,EAC9C,EAAY,EAAA,QAAM,MAAM,EACxB,EAAW,GAAG,EAAU,SAE9B,GAAI,EAAO,SAAW,EACpB,OAAO,KAMT,IAAM,EAAgB,EAAO,KAAM,GAAwB,EAAA,cAAc,CAAC,CAAC,EACrE,EAAiB,EAAO,OAAO,EAAA,kBAAkB,EAAE,OACnD,EAAa,EAAO,OACpB,EAAY,CAAC,CAAC,EAMd,EAAc,EAAO,EAAO,OAAS,GACvC,EAA+B,KAC/B,IACE,EAAA,cAAc,CAAW,EAC3B,EAAc,EAAA,gBAAgB,CAAW,EAAE,MAClC,EAAA,mBAAmB,CAAW,IAMvC,EAAc,EAAA,gBAAgB,GALT,GAAa,GACO,KACtC,GACC,EAAA,cAAc,CAAC,GAAK,EAAE,KAAO,EAAY,SAEF,CAAmB,EAAE,QAIpE,IAAM,EAAe,EACjB,EAAE,EAAA,QAAQ,6BAA8B,CACtC,UAAW,EACX,MAAO,CACT,CAAC,EACD,EAAE,EAAA,QAAQ,8BAA+B,CAAE,MAAO,CAAW,CAAC,EAE5D,EAAU,EAAW,EAAA,QAAU,EAAA,QAErC,OACE,EAAA,EAAA,MAAC,MAAD,CAAK,UAAU,2BAA2B,cAAY,uBAAtD,EACE,EAAA,EAAA,KAAC,SAAD,CACE,GAAI,EACJ,KAAK,SACL,YAAe,EAAa,GAAS,CAAC,CAAI,EAC1C,gBAAe,EACf,gBAAe,EACf,aAEM,EADJ,EACM,EAAA,QAAQ,qBACR,EAAA,QAAQ,kBAAkB,EAElC,cAAY,qBACZ,UAAU,mFAET,GACC,EAAA,EAAA,MAAC,OAAD,CAAM,UAAU,8EAAhB,EACE,EAAA,EAAA,KAAC,EAAD,CAAS,UAAU,8CAAgD,CAAA,GACnE,EAAA,EAAA,KAAC,OAAD,CAAM,UAAU,oBAAY,CAAmB,CAAA,CAC3C,KAEN,EAAA,EAAA,MAAA,EAAA,SAAA,CAAA,SAAA,EACE,EAAA,EAAA,MAAC,OAAD,CAAM,UAAU,8EAAhB,EACE,EAAA,EAAA,KAAC,EAAD,CAAS,UAAU,8CAAgD,CAAA,GACnE,EAAA,EAAA,KAAC,OAAD,CAAM,UAAU,oBAAY,GAAe,CAAmB,CAAA,CAC1D,KACN,EAAA,EAAA,MAAC,OAAD,CAAM,UAAU,8EAAhB,EACE,EAAA,EAAA,KAAC,OAAD,CAAM,UAAU,oBAAY,CAAmB,CAAA,EAC9C,GACC,EAAA,EAAA,KAAC,EAAA,aAAD,CACE,cAAY,eACZ,UAAU,yDACX,CAAA,EACC,IACA,GACN,CAAA,CAAA,CAEE,CAAA,EAEP,IACC,EAAA,EAAA,KAAC,MAAD,CACE,GAAI,EACJ,KAAK,SACL,kBAAiB,EACjB,UAAU,uBACV,cAAY,gCAEZ,EAAA,EAAA,KAAC,EAAA,sBAAsB,SAAvB,CAAgC,MAAA,GAC7B,UAC6B,CAAA,CAC7B,CAAA,CAEJ,GAET"}
+{"version":3,"file":"event-group.cjs","names":[],"sources":["../../../../../src/components/conversation-events/chat/event-message-components/event-group.tsx"],"sourcesContent":["import React from \"react\";\nimport { useTranslation } from \"react-i18next\";\nimport { LoaderCircle } from \"lucide-react\";\nimport ArrowDown from \"#/icons/angle-down-solid.svg?react\";\nimport ArrowUp from \"#/icons/angle-up-solid.svg?react\";\nimport { OpenHandsEvent, ActionEvent } from \"#/types/agent-server/core\";\nimport {\n  isActionEvent,\n  isObservationEvent,\n} from \"#/types/agent-server/type-guards\";\nimport { I18nKey } from \"#/i18n/declaration\";\nimport { getEventContent } from \"../event-content-helpers/get-event-content\";\nimport { IsInEventGroupContext } from \"../../../features/chat/is-in-event-group-context\";\nimport { PathInteractiveContext } from \"../../../features/chat/path-component\";\n\ninterface EventGroupProps {\n  /** The events represented by this group. Used to compute the summary. */\n  events: OpenHandsEvent[];\n  /**\n   * Full event history. Used to resolve the action that produced the latest\n   * observation in the group so the summary title matches what the individual\n   * card would show (e.g. \"Editing path/to/file\"). Falls back to `events` when\n   * omitted.\n   */\n  allEvents?: OpenHandsEvent[];\n  /**\n   * `true` once an event outside this group has been emitted after it, so the\n   * group is no longer the \"live\" tail of the chat. While `false` (the\n   * default), the group keeps showing the most recent action's title as its\n   * prominent summary, with the count of completed actions shown subtly on\n   * the right.\n   */\n  isFinalized?: boolean;\n  /** The fully-rendered event messages to show when the group is expanded. */\n  children: React.ReactNode;\n}\n\n/**\n * Collapsible container that wraps a run of consecutive agent action/observation\n * events into a single summary card.\n *\n * Collapsed, while the group is still the live tail of the chat\n * (`isFinalized=false`):\n *   - Left (prominent): the title of the most recent action/observation in\n *     the group — i.e. either the action currently in flight, or the latest\n *     completed step.\n *   - Right (subdued):  \"{completed}/{total} actions completed\" while at\n *     least one action is still pending (with a spinner), otherwise\n *     \"{count} actions completed\" followed by a success check.\n *\n * Collapsed, after the group has been \"moved past\" (`isFinalized=true`):\n *   - \"{count} actions completed\" is promoted to the prominent foreground\n *     style and the count is the only thing shown next to the chevron.\n *\n * Expanded:\n *   - Renders the children verbatim, so each individual action/observation can\n *     still be expanded the way it was before grouping.\n */\nexport function EventGroup({\n  events,\n  allEvents,\n  isFinalized = false,\n  children,\n}: EventGroupProps) {\n  const { t } = useTranslation(\"openhands\");\n  const [expanded, setExpanded] = React.useState(false);\n  const contentId = React.useId();\n  const buttonId = `${contentId}-toggle`;\n\n  if (events.length === 0) {\n    return null;\n  }\n\n  // Each ObservationEvent in the group is a completed action. An ActionEvent\n  // that's still here (i.e. not yet replaced by its observation in the UI\n  // events array) is an action currently in flight.\n  const pendingAction = events.find((e): e is ActionEvent => isActionEvent(e));\n  const completedCount = events.filter(isObservationEvent).length;\n  const totalCount = events.length;\n  const isRunning = !!pendingAction;\n\n  // Title of the most recent groupable event. While running this is the\n  // pending action; otherwise it's the latest observation, with its\n  // originating action looked up so the title can be the action-style summary\n  // (\"Editing path/to/file\") instead of the observation default.\n  const latestEvent = events[events.length - 1];\n  let latestTitle: React.ReactNode = null;\n  if (latestEvent) {\n    if (isActionEvent(latestEvent)) {\n      latestTitle = getEventContent(latestEvent).title;\n    } else if (isObservationEvent(latestEvent)) {\n      const lookupSource = allEvents ?? events;\n      const correspondingAction = lookupSource.find(\n        (e): e is ActionEvent =>\n          isActionEvent(e) && e.id === latestEvent.action_id,\n      );\n      latestTitle = getEventContent(latestEvent, correspondingAction).title;\n    }\n  }\n\n  const countSummary = isRunning\n    ? t(I18nKey.EVENT_GROUP$ACTIONS_PROGRESS, {\n        completed: completedCount,\n        total: totalCount,\n      })\n    : t(I18nKey.EVENT_GROUP$ACTIONS_COMPLETED, { count: totalCount });\n\n  const Chevron = expanded ? ArrowUp : ArrowDown;\n\n  return (\n    <div className=\"my-1 w-full py-1 text-sm\" data-testid=\"event-group\">\n      <button\n        id={buttonId}\n        type=\"button\"\n        onClick={() => setExpanded((prev) => !prev)}\n        aria-controls={contentId}\n        aria-expanded={expanded}\n        aria-label={\n          expanded\n            ? t(I18nKey.EVENT_GROUP$COLLAPSE)\n            : t(I18nKey.EVENT_GROUP$EXPAND)\n        }\n        data-testid=\"event-group-toggle\"\n        className=\"w-full flex items-center justify-between gap-2 text-left cursor-pointer\"\n      >\n        {isFinalized ? (\n          <span className=\"flex items-center gap-2 min-w-0 font-normal text-[var(--oh-muted)]\">\n            <Chevron className=\"h-4 w-4 fill-[var(--oh-muted)] flex-shrink-0\" />\n            <span className=\"truncate\">{countSummary}</span>\n          </span>\n        ) : (\n          <>\n            <span className=\"flex items-center gap-2 min-w-0 font-normal text-[var(--oh-muted)]\">\n              <Chevron className=\"h-4 w-4 fill-[var(--oh-muted)] flex-shrink-0\" />\n              <span className=\"truncate\">\n                <PathInteractiveContext.Provider value={false}>\n                  {latestTitle ?? countSummary}\n                </PathInteractiveContext.Provider>\n              </span>\n            </span>\n            <span className=\"flex items-center flex-shrink-0 font-normal text-[var(--oh-muted)]\">\n              <span className=\"truncate\">{countSummary}</span>\n              {isRunning ? (\n                <LoaderCircle\n                  data-testid=\"spinner-icon\"\n                  className=\"h-4 w-4 ml-2 inline animate-spin text-[var(--oh-muted)]\"\n                />\n              ) : null}\n            </span>\n          </>\n        )}\n      </button>\n\n      {expanded && (\n        <div\n          id={contentId}\n          role=\"region\"\n          aria-labelledby={buttonId}\n          className=\"mt-1.5 flex flex-col\"\n          data-testid=\"event-group-content\"\n        >\n          <IsInEventGroupContext.Provider value>\n            {children}\n          </IsInEventGroupContext.Provider>\n        </div>\n      )}\n    </div>\n  );\n}\n"],"mappings":"irBA0DA,SAAgB,EAAW,CACzB,SACA,YACA,cAAc,GACd,YACkB,CAClB,GAAM,CAAE,KAAM,EAAA,eAAe,WAAW,EAClC,CAAC,EAAU,GAAe,EAAA,QAAM,SAAS,EAAK,EAC9C,EAAY,EAAA,QAAM,MAAM,EACxB,EAAW,GAAG,EAAU,SAE9B,GAAI,EAAO,SAAW,EACpB,OAAO,KAMT,IAAM,EAAgB,EAAO,KAAM,GAAwB,EAAA,cAAc,CAAC,CAAC,EACrE,EAAiB,EAAO,OAAO,EAAA,kBAAkB,EAAE,OACnD,EAAa,EAAO,OACpB,EAAY,CAAC,CAAC,EAMd,EAAc,EAAO,EAAO,OAAS,GACvC,EAA+B,KAC/B,IACE,EAAA,cAAc,CAAW,EAC3B,EAAc,EAAA,gBAAgB,CAAW,EAAE,MAClC,EAAA,mBAAmB,CAAW,IAMvC,EAAc,EAAA,gBAAgB,GALT,GAAa,GACO,KACtC,GACC,EAAA,cAAc,CAAC,GAAK,EAAE,KAAO,EAAY,SAEF,CAAmB,EAAE,QAIpE,IAAM,EAAe,EACjB,EAAE,EAAA,QAAQ,6BAA8B,CACtC,UAAW,EACX,MAAO,CACT,CAAC,EACD,EAAE,EAAA,QAAQ,8BAA+B,CAAE,MAAO,CAAW,CAAC,EAE5D,EAAU,EAAW,EAAA,QAAU,EAAA,QAErC,OACE,EAAA,EAAA,MAAC,MAAD,CAAK,UAAU,2BAA2B,cAAY,uBAAtD,EACE,EAAA,EAAA,KAAC,SAAD,CACE,GAAI,EACJ,KAAK,SACL,YAAe,EAAa,GAAS,CAAC,CAAI,EAC1C,gBAAe,EACf,gBAAe,EACf,aAEM,EADJ,EACM,EAAA,QAAQ,qBACR,EAAA,QAAQ,kBAAkB,EAElC,cAAY,qBACZ,UAAU,mFAET,GACC,EAAA,EAAA,MAAC,OAAD,CAAM,UAAU,8EAAhB,EACE,EAAA,EAAA,KAAC,EAAD,CAAS,UAAU,8CAAgD,CAAA,GACnE,EAAA,EAAA,KAAC,OAAD,CAAM,UAAU,oBAAY,CAAmB,CAAA,CAC3C,KAEN,EAAA,EAAA,MAAA,EAAA,SAAA,CAAA,SAAA,EACE,EAAA,EAAA,MAAC,OAAD,CAAM,UAAU,8EAAhB,EACE,EAAA,EAAA,KAAC,EAAD,CAAS,UAAU,8CAAgD,CAAA,GACnE,EAAA,EAAA,KAAC,OAAD,CAAM,UAAU,qBACd,EAAA,EAAA,KAAC,EAAA,uBAAuB,SAAxB,CAAiC,MAAO,YACrC,GAAe,CACe,CAAA,CAC7B,CAAA,CACF,KACN,EAAA,EAAA,MAAC,OAAD,CAAM,UAAU,8EAAhB,EACE,EAAA,EAAA,KAAC,OAAD,CAAM,UAAU,oBAAY,CAAmB,CAAA,EAC9C,GACC,EAAA,EAAA,KAAC,EAAA,aAAD,CACE,cAAY,eACZ,UAAU,yDACX,CAAA,EACC,IACA,GACN,CAAA,CAAA,CAEE,CAAA,EAEP,IACC,EAAA,EAAA,KAAC,MAAD,CACE,GAAI,EACJ,KAAK,SACL,kBAAiB,EACjB,UAAU,uBACV,cAAY,gCAEZ,EAAA,EAAA,KAAC,EAAA,sBAAsB,SAAvB,CAAgC,MAAA,GAC7B,UAC6B,CAAA,CAC7B,CAAA,CAEJ,GAET"}

package/dist/components/conversation-events/chat/event-message-components/event-group.js

@@ -4,68 +4,72 @@ import { LoaderCircle as n } from "../../../../node_modules/lucide-react/dist/es
 import { isActionEvent as r, isObservationEvent as i } from "../../../../types/agent-server/type-guards.js";
 import a from "../../../../icons/angle-down-solid.js";
 import o from "../../../../icons/angle-up-solid.js";
-import { getEventContent as s } from "../event-content-helpers/get-event-content.js";
-import { IsInEventGroupContext as c } from "../../../features/chat/is-in-event-group-context.js";
-import l from "react";
-import { Fragment as u, jsx as d, jsxs as f } from "react/jsx-runtime";
+import { PathInteractiveContext as s } from "../../../features/chat/path-component.js";
+import { getEventContent as c } from "../event-content-helpers/get-event-content.js";
+import { IsInEventGroupContext as l } from "../../../features/chat/is-in-event-group-context.js";
+import u from "react";
+import { Fragment as d, jsx as f, jsxs as p } from "react/jsx-runtime";
 //#region src/components/conversation-events/chat/event-message-components/event-group.tsx
-function p({ events: p, allEvents: m, isFinalized: h = !1, children: g }) {
-	let { t: _ } = e("openhands"), [v, y] = l.useState(!1), b = l.useId(), x = `${b}-toggle`;
-	if (p.length === 0) return null;
-	let S = p.find((e) => r(e)), C = p.filter(i).length, w = p.length, T = !!S, E = p[p.length - 1], D = null;
-	E && (r(E) ? D = s(E).title : i(E) && (D = s(E, (m ?? p).find((e) => r(e) && e.id === E.action_id)).title));
-	let O = T ? _(t.EVENT_GROUP$ACTIONS_PROGRESS, {
-		completed: C,
-		total: w
-	}) : _(t.EVENT_GROUP$ACTIONS_COMPLETED, { count: w }), k = v ? o : a;
-	return /* @__PURE__ */ f("div", {
+function m({ events: m, allEvents: h, isFinalized: g = !1, children: _ }) {
+	let { t: v } = e("openhands"), [y, b] = u.useState(!1), x = u.useId(), S = `${x}-toggle`;
+	if (m.length === 0) return null;
+	let C = m.find((e) => r(e)), w = m.filter(i).length, T = m.length, E = !!C, D = m[m.length - 1], O = null;
+	D && (r(D) ? O = c(D).title : i(D) && (O = c(D, (h ?? m).find((e) => r(e) && e.id === D.action_id)).title));
+	let k = E ? v(t.EVENT_GROUP$ACTIONS_PROGRESS, {
+		completed: w,
+		total: T
+	}) : v(t.EVENT_GROUP$ACTIONS_COMPLETED, { count: T }), A = y ? o : a;
+	return /* @__PURE__ */ p("div", {
 		className: "my-1 w-full py-1 text-sm",
 		"data-testid": "event-group",
-		children: [/* @__PURE__ */ d("button", {
-			id: x,
+		children: [/* @__PURE__ */ f("button", {
+			id: S,
 			type: "button",
-			onClick: () => y((e) => !e),
-			"aria-controls": b,
-			"aria-expanded": v,
-			"aria-label": _(v ? t.EVENT_GROUP$COLLAPSE : t.EVENT_GROUP$EXPAND),
+			onClick: () => b((e) => !e),
+			"aria-controls": x,
+			"aria-expanded": y,
+			"aria-label": v(y ? t.EVENT_GROUP$COLLAPSE : t.EVENT_GROUP$EXPAND),
 			"data-testid": "event-group-toggle",
 			className: "w-full flex items-center justify-between gap-2 text-left cursor-pointer",
-			children: h ? /* @__PURE__ */ f("span", {
+			children: g ? /* @__PURE__ */ p("span", {
 				className: "flex items-center gap-2 min-w-0 font-normal text-[var(--oh-muted)]",
-				children: [/* @__PURE__ */ d(k, { className: "h-4 w-4 fill-[var(--oh-muted)] flex-shrink-0" }), /* @__PURE__ */ d("span", {
+				children: [/* @__PURE__ */ f(A, { className: "h-4 w-4 fill-[var(--oh-muted)] flex-shrink-0" }), /* @__PURE__ */ f("span", {
 					className: "truncate",
-					children: O
+					children: k
 				})]
-			}) : /* @__PURE__ */ f(u, { children: [/* @__PURE__ */ f("span", {
+			}) : /* @__PURE__ */ p(d, { children: [/* @__PURE__ */ p("span", {
 				className: "flex items-center gap-2 min-w-0 font-normal text-[var(--oh-muted)]",
-				children: [/* @__PURE__ */ d(k, { className: "h-4 w-4 fill-[var(--oh-muted)] flex-shrink-0" }), /* @__PURE__ */ d("span", {
+				children: [/* @__PURE__ */ f(A, { className: "h-4 w-4 fill-[var(--oh-muted)] flex-shrink-0" }), /* @__PURE__ */ f("span", {
 					className: "truncate",
-					children: D ?? O
+					children: /* @__PURE__ */ f(s.Provider, {
+						value: !1,
+						children: O ?? k
+					})
 				})]
-			}), /* @__PURE__ */ f("span", {
+			}), /* @__PURE__ */ p("span", {
 				className: "flex items-center flex-shrink-0 font-normal text-[var(--oh-muted)]",
-				children: [/* @__PURE__ */ d("span", {
+				children: [/* @__PURE__ */ f("span", {
 					className: "truncate",
-					children: O
-				}), T ? /* @__PURE__ */ d(n, {
+					children: k
+				}), E ? /* @__PURE__ */ f(n, {
 					"data-testid": "spinner-icon",
 					className: "h-4 w-4 ml-2 inline animate-spin text-[var(--oh-muted)]"
 				}) : null]
 			})] })
-		}), v && /* @__PURE__ */ d("div", {
-			id: b,
+		}), y && /* @__PURE__ */ f("div", {
+			id: x,
 			role: "region",
-			"aria-labelledby": x,
+			"aria-labelledby": S,
 			className: "mt-1.5 flex flex-col",
 			"data-testid": "event-group-content",
-			children: /* @__PURE__ */ d(c.Provider, {
+			children: /* @__PURE__ */ f(l.Provider, {
 				value: !0,
-				children: g
+				children: _
 			})
 		})]
 	});
 }
 //#endregion
-export { p as EventGroup };
+export { m as EventGroup };
 
 //# sourceMappingURL=event-group.js.map