@openhands/agent-canvas 1.16.0 → 1.18.0

package/dist/components/features/settings/sdk-settings/sdk-section-page.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-section-page.cjs","names":[],"sources":["../../../../../src/components/features/settings/sdk-settings/sdk-section-page.tsx"],"sourcesContent":["import React from \"react\";\nimport { AxiosError } from \"axios\";\nimport { useTranslation } from \"react-i18next\";\nimport { BrandButton } from \"#/components/features/settings/brand-button\";\nimport { LlmSettingsInputsSkeleton } from \"#/components/features/settings/llm-settings/llm-settings-inputs-skeleton\";\nimport { useSaveSettings } from \"#/hooks/mutation/use-save-settings\";\nimport {\n  useAgentSettingsSchema,\n  useConversationSettingsSchema,\n} from \"#/hooks/query/use-agent-settings-schema\";\nimport { useSettings } from \"#/hooks/query/use-settings\";\nimport { I18nKey } from \"#/i18n/declaration\";\nimport { Settings, SettingsSchema, SettingsScope } from \"#/types/settings\";\nimport { extensionModuleEmptyStateClassName } from \"#/utils/extension-module-card-classes\";\nimport {\n  displayErrorToast,\n  displaySuccessToast,\n} from \"#/utils/custom-toast-handlers\";\nimport { retrieveAxiosErrorMessage } from \"#/utils/retrieve-axios-error-message\";\nimport {\n  buildInitialSettingsFormValues,\n  buildSdkSettingsPayload,\n  buildSdkSettingsPayloadForView,\n  getVisibleSettingsSections,\n  hasAdvancedSettings,\n  hasCriticalSettings,\n  hasMinorSettings,\n  inferInitialView,\n  isValidSettingsSchema,\n  SettingsDirtyState,\n  SettingsFormValues,\n  type SettingsValueSource,\n  type SettingsView,\n} from \"#/utils/sdk-settings-schema\";\nimport { FIELD_FULL_WIDTH_KEYS, SchemaField } from \"./schema-field\";\nimport { ViewToggle } from \"./view-toggle\";\n\nconst EMPTY_EXCLUDE_KEYS = new Set<string>();\n\nconst VIEW_ORDER: Record<SettingsView, number> = {\n  basic: 0,\n  advanced: 1,\n  all: 2,\n};\n\nconst getLessDetailedView = (\n  currentView: SettingsView,\n  nextView: SettingsView,\n): SettingsView =>\n  VIEW_ORDER[nextView] < VIEW_ORDER[currentView] ? nextView : currentView;\n\nconst getMoreDetailedView = (\n  currentView: SettingsView,\n  nextView: SettingsView,\n): SettingsView =>\n  VIEW_ORDER[nextView] > VIEW_ORDER[currentView] ? nextView : currentView;\n\nconst normalizeView = (\n  view: SettingsView,\n  {\n    showBasic,\n    showAdvanced,\n    showAll,\n  }: {\n    showBasic: boolean;\n    showAdvanced: boolean;\n    showAll: boolean;\n  },\n): SettingsView => {\n  if (view === \"all\") {\n    if (showAll) {\n      return \"all\";\n    }\n\n    return showAdvanced ? \"advanced\" : \"basic\";\n  }\n\n  if (view === \"advanced\") {\n    if (showAdvanced) {\n      return \"advanced\";\n    }\n\n    return showAll ? \"all\" : \"basic\";\n  }\n\n  // A critical-less page has nothing to render in the basic tier; bump up.\n  if (!showBasic) {\n    if (showAdvanced) return \"advanced\";\n    if (showAll) return \"all\";\n  }\n  return \"basic\";\n};\n\nconst PAYLOAD_DIFF_KEY: Record<SettingsValueSource, string> = {\n  agent_settings: \"agent_settings_diff\",\n  conversation_settings: \"conversation_settings_diff\",\n};\n\nconst getSchemaUnavailableMessage = (\n  error: unknown,\n  fallbackMessage: string,\n): string => {\n  if (!(error instanceof AxiosError)) {\n    return fallbackMessage;\n  }\n\n  if (error.response?.status === 401) {\n    return `${fallbackMessage} This agent server requires X-Session-API-Key. Set VITE_SESSION_API_KEY in the frontend to the same value used by the backend SESSION_API_KEY or OH_SESSION_API_KEYS_0.`;\n  }\n\n  if (error.response?.status === 404) {\n    return `${fallbackMessage} This backend does not expose /api/settings/* schema endpoints. Upgrade to a recent openhands-agent-server release.`;\n  }\n\n  return fallbackMessage;\n};\n\nexport interface SettingsSourceConfig {\n  /** Which schema/values bucket on `settings` this source pulls from. */\n  settingsSource: SettingsValueSource;\n  /** Section keys (e.g. [\"llm\"]) within that schema to render. */\n  sectionKeys: string[];\n  /** Field keys to skip (rendered elsewhere by the caller). */\n  excludeKeys?: Set<string>;\n}\n\nexport interface SdkSectionHeaderProps {\n  values: SettingsFormValues;\n  isDisabled: boolean;\n  view: SettingsView;\n  onChange: (key: string, value: string | boolean) => void;\n}\n\ninterface ResolvedSource extends SettingsSourceConfig {\n  filteredSchema: SettingsSchema | null;\n}\n\n/**\n * Snapshot of the page's save state, surfaced to the parent so it can\n * render its own Save/Next button (e.g. in onboarding) when\n * {@link SdkSectionPage}'s built-in button is hidden via\n * `hideSaveButton`.\n */\nexport interface SdkSectionSaveControl {\n  /** Trigger a save of the currently-dirty fields. No-op while `isSaving` or `!isDirty`. */\n  save: () => void;\n  /** A save mutation is in flight. */\n  isSaving: boolean;\n  /** At least one field is dirty (or `extraDirty` was passed in). */\n  isDirty: boolean;\n  /** Current form values (for custom save flows). */\n  values: SettingsFormValues;\n  /** The active view tier (basic/advanced/all) the form is rendering. */\n  view: SettingsView;\n  /**\n   * Returns the coerced, dirty-only payload as a nested object\n   * (e.g. `{ llm: { temperature: 0.7 } }`). Lets a custom save flow persist\n   * exactly the fields the user changed, with proper types, without\n   * re-implementing schema-driven coercion. Throws if a field fails coercion.\n   */\n  getDirtyPayload: () => Record<string, unknown>;\n}\n\n/**\n * A generic SDK-schema-driven settings page that renders fields from one or\n * more schema sections.\n *\n * The `settingsSources` array specifies which schema(s)/section(s) the page\n * owns. The page tracks values/dirty state per source, renders sections from\n * each source in order (filtered by the schema's `prominence` field for the\n * selected view), and emits a combined save payload like\n * `{ conversation_settings_diff: {...}, agent_settings_diff: {...} }` ---\n * including only the keys for sources that actually have dirty changes.\n *\n * @param settingsSources  one or more schemas to render fields from\n * @param header           render prop above the fields (receives unified state)\n * @param buildPayload     customize the save payload before submission\n * @param testId           data-testid on the page wrapper\n */\nexport function SdkSectionPage({\n  settingsSources,\n  scope = \"personal\",\n  header,\n  extraDirty = false,\n  buildPayload,\n  onSaveSuccess,\n  getInitialView,\n  forceShowAdvancedView = false,\n  allowAllView = true,\n  initialValueOverrides,\n  embedded = false,\n  hideSaveButton = false,\n  suppressSuccessToast = false,\n  onSaveControlChange,\n  testId = \"sdk-section-settings-screen\",\n}: {\n  settingsSources: SettingsSourceConfig[];\n  scope?: SettingsScope;\n\n  header?: (props: SdkSectionHeaderProps) => React.ReactNode;\n  extraDirty?: boolean;\n  /**\n   * Customize the save payload. Receives the wrapped default payload (e.g.\n   * `{ agent_settings_diff: { llm: { model: \"gpt-4\" } } }`) plus the unified\n   * form context. Return the payload to actually send.\n   */\n  buildPayload?: (\n    defaultPayload: Record<string, unknown>,\n    context: {\n      values: SettingsFormValues;\n      dirty: SettingsDirtyState;\n      view: SettingsView;\n    },\n  ) => Record<string, unknown>;\n  onSaveSuccess?: () => void;\n  getInitialView?: (\n    settings: Settings,\n    filteredSchema: SettingsSchema,\n  ) => SettingsView;\n  forceShowAdvancedView?: boolean;\n  allowAllView?: boolean;\n  /**\n   * Per-field initial value overrides that win over the values\n   * derived from `useSettings`. The keys of each override are also\n   * marked dirty on hydration so the user can save the form without\n   * having to touch the prefilled fields. Useful when the page is\n   * embedded in a flow that wants to nudge brand-new users toward a\n   * particular default (e.g. onboarding pre-filling OpenHands/Opus).\n   */\n  initialValueOverrides?: SettingsFormValues;\n  embedded?: boolean;\n  hideSaveButton?: boolean;\n  /** Suppress the default success toast after save completes. */\n  suppressSuccessToast?: boolean;\n  /**\n   * Fires whenever the save state changes (a mutation starts/finishes,\n   * dirty status flips). Provides a stable `save()` callback the\n   * parent can wire to its own button. Useful when the form is\n   * embedded in a custom flow and the built-in Save button is hidden.\n   */\n  onSaveControlChange?: (control: SdkSectionSaveControl) => void;\n  testId?: string;\n}) {\n  const { t } = useTranslation(\"openhands\");\n  const { mutate: saveSettings, isPending } = useSaveSettings(scope);\n  const { data: settings, isLoading, isFetching } = useSettings(scope);\n  const agentSchemaQuery = useAgentSettingsSchema(\n    settings?.agent_settings_schema,\n  );\n  const conversationSchemaQuery = useConversationSettingsSchema(\n    settings?.conversation_settings_schema,\n  );\n  const isReadOnly = false;\n\n  const sourcesSignature = React.useMemo(\n    () =>\n      JSON.stringify(\n        settingsSources.map((s) => ({\n          source: s.settingsSource,\n          sectionKeys: s.sectionKeys,\n          excludeKeys: s.excludeKeys ? Array.from(s.excludeKeys).sort() : null,\n        })),\n      ),\n    [settingsSources],\n  );\n\n  const resolvedSourceConfigs = React.useMemo<SettingsSourceConfig[]>(() => {\n    const parsed = JSON.parse(sourcesSignature) as Array<{\n      source: SettingsValueSource;\n      sectionKeys: string[];\n      excludeKeys: string[] | null;\n    }>;\n    return parsed.map((p) => ({\n      settingsSource: p.source,\n      sectionKeys: p.sectionKeys,\n      excludeKeys: p.excludeKeys ? new Set(p.excludeKeys) : undefined,\n    }));\n  }, [sourcesSignature]);\n\n  const getSchemaForSource = React.useCallback(\n    (source: SettingsValueSource) =>\n      source === \"conversation_settings\"\n        ? conversationSchemaQuery.data\n        : agentSchemaQuery.data,\n    [agentSchemaQuery.data, conversationSchemaQuery.data],\n  );\n\n  const isSchemaLoading = resolvedSourceConfigs.some((src) =>\n    src.settingsSource === \"conversation_settings\"\n      ? conversationSchemaQuery.isLoading\n      : agentSchemaQuery.isLoading,\n  );\n\n  const resolvedSources = React.useMemo<ResolvedSource[]>(\n    () =>\n      resolvedSourceConfigs.map((src) => {\n        const schema = getSchemaForSource(src.settingsSource);\n        if (!isValidSettingsSchema(schema)) {\n          return { ...src, filteredSchema: null };\n        }\n        const sectionSet = new Set(src.sectionKeys);\n        // The agent schema can carry more than one section per key — e.g. the\n        // combined AgentSettings schema emits an \"llm\" section for both the\n        // \"openhands\" and \"acp\" variants. Only the first (openhands) is used,\n        // so keep the first section per key; otherwise every field renders\n        // twice and React sees duplicate section keys.\n        const seenKeys = new Set<string>();\n        const filteredSchema: SettingsSchema = {\n          ...schema,\n          sections: schema.sections.filter((s) => {\n            if (!sectionSet.has(s.key) || seenKeys.has(s.key)) return false;\n            seenKeys.add(s.key);\n            return true;\n          }),\n        };\n        return { ...src, filteredSchema };\n      }),\n    [resolvedSourceConfigs, getSchemaForSource],\n  );\n\n  // The basic tier only exists when some field renders in it; a critical-less\n  // page (e.g. Memory, whose only field is major) hides the Basic tab and\n  // floors its view at \"advanced\".\n  const showBasic = resolvedSources.some((src) =>\n    hasCriticalSettings(src.filteredSchema),\n  );\n  const showAdvanced =\n    forceShowAdvancedView ||\n    resolvedSources.some((src) => hasAdvancedSettings(src.filteredSchema));\n  const showAll =\n    allowAllView &&\n    resolvedSources.some((src) => hasMinorSettings(src.filteredSchema));\n\n  const schemaUnavailableMessage = React.useMemo(() => {\n    const firstError = resolvedSourceConfigs.reduce<unknown>(\n      (err, src) =>\n        err ??\n        (src.settingsSource === \"conversation_settings\"\n          ? conversationSchemaQuery.error\n          : agentSchemaQuery.error),\n      null,\n    );\n    return getSchemaUnavailableMessage(\n      firstError,\n      t(I18nKey.SETTINGS$SDK_SCHEMA_UNAVAILABLE),\n    );\n  }, [\n    resolvedSourceConfigs,\n    agentSchemaQuery.error,\n    conversationSchemaQuery.error,\n    t,\n  ]);\n\n  const overridesSignature = React.useMemo(\n    () => (initialValueOverrides ? JSON.stringify(initialValueOverrides) : \"\"),\n    [initialValueOverrides],\n  );\n\n  const [view, setView] = React.useState<SettingsView>(\"basic\");\n  const [valuesBySource, setValuesBySource] = React.useState<\n    Partial<Record<SettingsValueSource, SettingsFormValues>>\n  >({});\n  const [dirtyBySource, setDirtyBySource] = React.useState<\n    Partial<Record<SettingsValueSource, SettingsDirtyState>>\n  >({});\n  const hasHydratedViewRef = React.useRef(false);\n\n  const initialValuesBySource = React.useMemo<Partial<\n    Record<SettingsValueSource, SettingsFormValues>\n  > | null>(() => {\n    if (!settings) return null;\n    const result: Partial<Record<SettingsValueSource, SettingsFormValues>> = {};\n    for (const src of resolvedSources) {\n      if (!src.filteredSchema) return null;\n      result[src.settingsSource] = {\n        ...(result[src.settingsSource] ?? {}),\n        ...buildInitialSettingsFormValues(\n          settings,\n          src.filteredSchema,\n          src.settingsSource,\n        ),\n      };\n    }\n    if (initialValueOverrides) {\n      const firstSource = resolvedSources[0]?.settingsSource;\n      if (firstSource && result[firstSource]) {\n        result[firstSource] = {\n          ...result[firstSource],\n          ...initialValueOverrides,\n        };\n      }\n    }\n    return result;\n  }, [settings, resolvedSources, overridesSignature]);\n\n  const initialView = React.useMemo(() => {\n    if (!settings) return null;\n    let result: SettingsView | null = null;\n    for (const src of resolvedSources) {\n      if (!src.filteredSchema) return null;\n      const perSource = getInitialView\n        ? getInitialView(settings, src.filteredSchema)\n        : inferInitialView(settings, src.filteredSchema, src.settingsSource);\n      result = result ? getMoreDetailedView(result, perSource) : perSource;\n    }\n    if (!result) return null;\n    return normalizeView(result, { showBasic, showAdvanced, showAll });\n  }, [\n    settings,\n    resolvedSources,\n    getInitialView,\n    showBasic,\n    showAdvanced,\n    showAll,\n  ]);\n\n  React.useEffect(() => {\n    hasHydratedViewRef.current = false;\n    setView(\"basic\");\n    setValuesBySource({});\n    setDirtyBySource({});\n  }, [scope, sourcesSignature]);\n\n  React.useEffect(() => {\n    if (!initialValuesBySource || !initialView) return;\n\n    setValuesBySource(initialValuesBySource);\n    if (initialValueOverrides) {\n      const firstSource = resolvedSources[0]?.settingsSource;\n      if (firstSource) {\n        const overrideDirty: SettingsDirtyState = Object.fromEntries(\n          Object.keys(initialValueOverrides).map((key) => [key, true]),\n        );\n        setDirtyBySource({ [firstSource]: overrideDirty });\n      } else {\n        setDirtyBySource({});\n      }\n    } else {\n      setDirtyBySource({});\n    }\n    // The ref flip stays outside the updater: React double-invokes state\n    // updaters in StrictMode, so mutating it in there makes the second\n    // (kept) call take the already-hydrated branch and pin the view.\n    if (!hasHydratedViewRef.current) {\n      hasHydratedViewRef.current = true;\n      setView(initialView);\n    } else {\n      setView((currentView) => getLessDetailedView(currentView, initialView));\n    }\n  }, [initialValuesBySource, initialView]);\n\n  const fieldKeyToSource = React.useMemo(() => {\n    const map = new Map<string, SettingsValueSource>();\n    for (const src of resolvedSources) {\n      if (src.filteredSchema) {\n        for (const section of src.filteredSchema.sections) {\n          for (const field of section.fields) {\n            if (!map.has(field.key)) {\n              map.set(field.key, src.settingsSource);\n            }\n          }\n        }\n      }\n    }\n    return map;\n  }, [resolvedSources]);\n\n  const flatValues = React.useMemo<SettingsFormValues>(() => {\n    const merged: SettingsFormValues = {};\n    for (const src of resolvedSources) {\n      Object.assign(merged, valuesBySource[src.settingsSource] ?? {});\n    }\n    return merged;\n  }, [resolvedSources, valuesBySource]);\n\n  const flatDirty = React.useMemo<SettingsDirtyState>(() => {\n    const merged: SettingsDirtyState = {};\n    for (const src of resolvedSources) {\n      Object.assign(merged, dirtyBySource[src.settingsSource] ?? {});\n    }\n    return merged;\n  }, [resolvedSources, dirtyBySource]);\n\n  const handleFieldChange = React.useCallback(\n    (fieldKey: string, nextValue: string | boolean) => {\n      const sourceKey = fieldKeyToSource.get(fieldKey);\n      if (!sourceKey) return;\n      setValuesBySource((prev) => ({\n        ...prev,\n        [sourceKey]: {\n          ...(prev[sourceKey] ?? {}),\n          [fieldKey]: nextValue,\n        },\n      }));\n      setDirtyBySource((prev) => ({\n        ...prev,\n        [sourceKey]: {\n          ...(prev[sourceKey] ?? {}),\n          [fieldKey]: true,\n        },\n      }));\n    },\n    [fieldKeyToSource],\n  );\n\n  const handleError = React.useCallback(\n    (error: AxiosError) => {\n      const msg = retrieveAxiosErrorMessage(error);\n      displayErrorToast(msg || t(I18nKey.ERROR$GENERIC));\n    },\n    [t],\n  );\n\n  const handleSaveRef = React.useRef<() => void>(() => {});\n  const stableSave = React.useCallback(() => {\n    handleSaveRef.current();\n  }, []);\n\n  // Stable accessor for the coerced, dirty-only payload. Mirrors the\n  // `handleSaveRef` pattern so the exposed function reference stays stable\n  // across renders while always reading the latest closure at call time.\n  const buildDirtyPayloadRef = React.useRef<() => Record<string, unknown>>(\n    () => ({}),\n  );\n  const stableGetDirtyPayload = React.useCallback(\n    () => buildDirtyPayloadRef.current(),\n    [],\n  );\n\n  const handleSave = () => {\n    if (isReadOnly) return;\n    if (resolvedSources.some((src) => !src.filteredSchema)) return;\n\n    let payload: Record<string, unknown>;\n    try {\n      const defaultPayload: Record<string, unknown> = {};\n      for (const src of resolvedSources) {\n        const schema = src.filteredSchema!;\n        const sourceValues = valuesBySource[src.settingsSource] ?? {};\n        const sourceDirty = dirtyBySource[src.settingsSource] ?? {};\n        const diff = buildSdkSettingsPayloadForView(\n          schema,\n          sourceValues,\n          sourceDirty,\n          view,\n        );\n        if (Object.keys(diff).length > 0) {\n          const diffKey = PAYLOAD_DIFF_KEY[src.settingsSource];\n          defaultPayload[diffKey] = {\n            ...((defaultPayload[diffKey] as\n              | Record<string, unknown>\n              | undefined) ?? {}),\n            ...diff,\n          };\n        }\n      }\n\n      payload = buildPayload\n        ? buildPayload(defaultPayload, {\n            values: flatValues,\n            dirty: flatDirty,\n            view,\n          })\n        : defaultPayload;\n    } catch (error) {\n      displayErrorToast(\n        error instanceof Error ? error.message : t(I18nKey.ERROR$GENERIC),\n      );\n      return;\n    }\n\n    if (Object.keys(payload).length === 0) return;\n\n    saveSettings(payload, {\n      onError: handleError,\n      onSuccess: () => {\n        if (!suppressSuccessToast) {\n          displaySuccessToast(t(I18nKey.SETTINGS$SAVED_WARNING));\n        }\n        setDirtyBySource({});\n        onSaveSuccess?.();\n      },\n    });\n  };\n\n  handleSaveRef.current = handleSave;\n  // Dirty-only (NOT view-filtered): we must never inject defaults for\n  // non-visible fields here, or a custom save flow would reset fields the\n  // user never touched. `buildSdkSettingsPayloadForView` is reserved for the\n  // built-in full-replace save above. With multiple sources, we merge each\n  // source's nested payload at the top level so single-source consumers\n  // (e.g. `LlmSettingsLocalView`) keep reading `.llm` etc. unchanged.\n  buildDirtyPayloadRef.current = () => {\n    const merged: Record<string, unknown> = {};\n    for (const src of resolvedSources) {\n      if (!src.filteredSchema) continue;\n      const sourceValues = valuesBySource[src.settingsSource] ?? {};\n      const sourceDirty = dirtyBySource[src.settingsSource] ?? {};\n      Object.assign(\n        merged,\n        buildSdkSettingsPayload(src.filteredSchema, sourceValues, sourceDirty),\n      );\n    }\n    return merged;\n  };\n\n  const isDirty = Object.keys(flatDirty).length > 0;\n  const saveControlIsDirty = isDirty || extraDirty;\n  React.useEffect(() => {\n    if (!onSaveControlChange) return;\n    onSaveControlChange({\n      save: stableSave,\n      isSaving: isPending,\n      isDirty: saveControlIsDirty,\n      values: flatValues,\n      view,\n      getDirtyPayload: stableGetDirtyPayload,\n    });\n  }, [isPending, saveControlIsDirty, flatValues, view]);\n\n  // Keep existing form content visible during background refetches to avoid\n  // flashing the full skeleton (notably during onboarding Next transitions).\n  const isInitialSettingsLoad = (isLoading || isFetching) && !settings;\n  if (isInitialSettingsLoad || isSchemaLoading) {\n    return <LlmSettingsInputsSkeleton />;\n  }\n\n  const hasAnyVisibleSection = resolvedSources.some(\n    (src) => src.filteredSchema && src.filteredSchema.sections.length > 0,\n  );\n\n  if (!hasAnyVisibleSection) {\n    return (\n      <div\n        data-testid=\"sdk-schema-unavailable\"\n        className={extensionModuleEmptyStateClassName}\n      >\n        <p className=\"text-sm text-[var(--oh-muted)]\">\n          {schemaUnavailableMessage}\n        </p>\n      </div>\n    );\n  }\n\n  if (Object.keys(flatValues).length === 0) {\n    return <LlmSettingsInputsSkeleton />;\n  }\n\n  // Scrolling is owned by the settings shell (or onboarding wrapper), not a\n  // nested scroll region. Save actions are inline after the last field.\n  const bodyClassName = \"flex flex-col gap-8\";\n\n  return (\n    <div\n      data-testid={testId}\n      className={\n        embedded\n          ? \"relative flex min-h-0 w-full flex-1 flex-col\"\n          : \"relative w-full min-h-0\"\n      }\n    >\n      <ViewToggle\n        view={view}\n        setView={setView}\n        showBasic={showBasic}\n        showAdvanced={showAdvanced}\n        showAll={showAll}\n        isDisabled={isReadOnly}\n      />\n\n      <div className={bodyClassName}>\n        {header?.({\n          values: flatValues,\n          isDisabled: isReadOnly,\n          view,\n          onChange: handleFieldChange,\n        })}\n\n        {resolvedSources.map((src) => {\n          if (!src.filteredSchema) return null;\n          const sourceValues = valuesBySource[src.settingsSource] ?? {};\n          const visibleSections = getVisibleSettingsSections(\n            src.filteredSchema,\n            { ...flatValues, ...sourceValues },\n            view,\n            src.excludeKeys ?? EMPTY_EXCLUDE_KEYS,\n          );\n          return visibleSections.map((section) => (\n            <section\n              key={`${src.settingsSource}:${section.key}`}\n              className=\"flex flex-col gap-4\"\n            >\n              <div className=\"grid gap-4 xl:grid-cols-2\">\n                {section.fields.map((field) => (\n                  <div\n                    key={field.key}\n                    className={\n                      FIELD_FULL_WIDTH_KEYS.has(field.key)\n                        ? \"xl:col-span-2\"\n                        : undefined\n                    }\n                  >\n                    <SchemaField\n                      field={field}\n                      value={sourceValues[field.key]}\n                      isDisabled={isReadOnly}\n                      onChange={(nextValue) =>\n                        handleFieldChange(field.key, nextValue)\n                      }\n                    />\n                  </div>\n                ))}\n              </div>\n            </section>\n          ));\n        })}\n\n        {!isReadOnly && !hideSaveButton ? (\n          <div className=\"flex justify-start pt-2\">\n            <BrandButton\n              testId=\"save-button\"\n              type=\"button\"\n              variant=\"primary\"\n              isDisabled={isPending || (!isDirty && !extraDirty)}\n              onClick={handleSave}\n            >\n              {isPending\n                ? t(I18nKey.SETTINGS$SAVING)\n                : t(I18nKey.SETTINGS$SAVE_CHANGES)}\n            </BrandButton>\n          </div>\n        ) : null}\n      </div>\n    </div>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"sdk-section-page.cjs","names":[],"sources":["../../../../../src/components/features/settings/sdk-settings/sdk-section-page.tsx"],"sourcesContent":["import React from \"react\";\nimport { AxiosError } from \"axios\";\nimport { useTranslation } from \"react-i18next\";\nimport { BrandButton } from \"#/components/features/settings/brand-button\";\nimport { LlmSettingsInputsSkeleton } from \"#/components/features/settings/llm-settings/llm-settings-inputs-skeleton\";\nimport { useSaveSettings } from \"#/hooks/mutation/use-save-settings\";\nimport {\n  useAgentSettingsSchema,\n  useConversationSettingsSchema,\n} from \"#/hooks/query/use-agent-settings-schema\";\nimport { useSettings } from \"#/hooks/query/use-settings\";\nimport { I18nKey } from \"#/i18n/declaration\";\nimport {\n  Settings,\n  SettingsFieldSchema,\n  SettingsSchema,\n  SettingsScope,\n} from \"#/types/settings\";\nimport { extensionModuleEmptyStateClassName } from \"#/utils/extension-module-card-classes\";\nimport {\n  displayErrorToast,\n  displaySuccessToast,\n} from \"#/utils/custom-toast-handlers\";\nimport { retrieveAxiosErrorMessage } from \"#/utils/retrieve-axios-error-message\";\nimport {\n  buildInitialSettingsFormValues,\n  buildSdkSettingsPayload,\n  buildSdkSettingsPayloadForView,\n  getVisibleSettingsSections,\n  hasAdvancedSettings,\n  hasCriticalSettings,\n  hasMinorSettings,\n  inferInitialView,\n  isValidSettingsSchema,\n  normalizeComparableValue,\n  SettingsDirtyState,\n  SettingsFormValues,\n  type SettingsValueSource,\n  type SettingsView,\n} from \"#/utils/sdk-settings-schema\";\nimport { FIELD_FULL_WIDTH_KEYS, SchemaField } from \"./schema-field\";\nimport { ViewToggle } from \"./view-toggle\";\n\nconst EMPTY_EXCLUDE_KEYS = new Set<string>();\n\nconst VIEW_ORDER: Record<SettingsView, number> = {\n  basic: 0,\n  advanced: 1,\n  all: 2,\n};\n\nconst getLessDetailedView = (\n  currentView: SettingsView,\n  nextView: SettingsView,\n): SettingsView =>\n  VIEW_ORDER[nextView] < VIEW_ORDER[currentView] ? nextView : currentView;\n\nconst getMoreDetailedView = (\n  currentView: SettingsView,\n  nextView: SettingsView,\n): SettingsView =>\n  VIEW_ORDER[nextView] > VIEW_ORDER[currentView] ? nextView : currentView;\n\nconst normalizeView = (\n  view: SettingsView,\n  {\n    showBasic,\n    showAdvanced,\n    showAll,\n  }: {\n    showBasic: boolean;\n    showAdvanced: boolean;\n    showAll: boolean;\n  },\n): SettingsView => {\n  if (view === \"all\") {\n    if (showAll) {\n      return \"all\";\n    }\n\n    return showAdvanced ? \"advanced\" : \"basic\";\n  }\n\n  if (view === \"advanced\") {\n    if (showAdvanced) {\n      return \"advanced\";\n    }\n\n    return showAll ? \"all\" : \"basic\";\n  }\n\n  // A critical-less page has nothing to render in the basic tier; bump up.\n  if (!showBasic) {\n    if (showAdvanced) return \"advanced\";\n    if (showAll) return \"all\";\n  }\n  return \"basic\";\n};\n\nconst PAYLOAD_DIFF_KEY: Record<SettingsValueSource, string> = {\n  agent_settings: \"agent_settings_diff\",\n  conversation_settings: \"conversation_settings_diff\",\n};\n\nconst getSchemaUnavailableMessage = (\n  error: unknown,\n  fallbackMessage: string,\n): string => {\n  if (!(error instanceof AxiosError)) {\n    return fallbackMessage;\n  }\n\n  if (error.response?.status === 401) {\n    return `${fallbackMessage} This agent server requires X-Session-API-Key. Set VITE_SESSION_API_KEY in the frontend to the same value used by the backend SESSION_API_KEY or OH_SESSION_API_KEYS_0.`;\n  }\n\n  if (error.response?.status === 404) {\n    return `${fallbackMessage} This backend does not expose /api/settings/* schema endpoints. Upgrade to a recent openhands-agent-server release.`;\n  }\n\n  return fallbackMessage;\n};\n\nexport interface SettingsSourceConfig {\n  /** Which schema/values bucket on `settings` this source pulls from. */\n  settingsSource: SettingsValueSource;\n  /** Section keys (e.g. [\"llm\"]) within that schema to render. */\n  sectionKeys: string[];\n  /** Field keys to skip (rendered elsewhere by the caller). */\n  excludeKeys?: Set<string>;\n}\n\nexport interface SdkSectionHeaderProps {\n  values: SettingsFormValues;\n  isDisabled: boolean;\n  view: SettingsView;\n  onChange: (key: string, value: string | boolean) => void;\n}\n\ninterface ResolvedSource extends SettingsSourceConfig {\n  filteredSchema: SettingsSchema | null;\n}\n\n/**\n * Snapshot of the page's save state, surfaced to the parent so it can\n * render its own Save/Next button (e.g. in onboarding) when\n * {@link SdkSectionPage}'s built-in button is hidden via\n * `hideSaveButton`.\n */\nexport interface SdkSectionSaveControl {\n  /** Trigger a save of the currently-dirty fields. No-op while `isSaving` or `!isDirty`. */\n  save: () => void;\n  /** A save mutation is in flight. */\n  isSaving: boolean;\n  /** At least one field is dirty (or `extraDirty` was passed in). */\n  isDirty: boolean;\n  /** Current form values (for custom save flows). */\n  values: SettingsFormValues;\n  /** The active view tier (basic/advanced/all) the form is rendering. */\n  view: SettingsView;\n  /**\n   * Returns the coerced, dirty-only payload as a nested object\n   * (e.g. `{ llm: { temperature: 0.7 } }`). Lets a custom save flow persist\n   * exactly the fields the user changed, with proper types, without\n   * re-implementing schema-driven coercion. Throws if a field fails coercion.\n   */\n  getDirtyPayload: () => Record<string, unknown>;\n}\n\n/**\n * A generic SDK-schema-driven settings page that renders fields from one or\n * more schema sections.\n *\n * The `settingsSources` array specifies which schema(s)/section(s) the page\n * owns. The page tracks values/dirty state per source, renders sections from\n * each source in order (filtered by the schema's `prominence` field for the\n * selected view), and emits a combined save payload like\n * `{ conversation_settings_diff: {...}, agent_settings_diff: {...} }` ---\n * including only the keys for sources that actually have dirty changes.\n *\n * @param settingsSources  one or more schemas to render fields from\n * @param header           render prop above the fields (receives unified state)\n * @param buildPayload     customize the save payload before submission\n * @param testId           data-testid on the page wrapper\n */\nexport function SdkSectionPage({\n  settingsSources,\n  scope = \"personal\",\n  header,\n  extraDirty = false,\n  buildPayload,\n  onSaveSuccess,\n  getInitialView,\n  forceShowAdvancedView = false,\n  allowAllView = true,\n  initialValueOverrides,\n  markInitialOverridesDirty = true,\n  embedded = false,\n  hideSaveButton = false,\n  suppressSuccessToast = false,\n  onSaveControlChange,\n  testId = \"sdk-section-settings-screen\",\n}: {\n  settingsSources: SettingsSourceConfig[];\n  scope?: SettingsScope;\n\n  header?: (props: SdkSectionHeaderProps) => React.ReactNode;\n  extraDirty?: boolean;\n  /**\n   * Customize the save payload. Receives the wrapped default payload (e.g.\n   * `{ agent_settings_diff: { llm: { model: \"gpt-4\" } } }`) plus the unified\n   * form context. Return the payload to actually send.\n   */\n  buildPayload?: (\n    defaultPayload: Record<string, unknown>,\n    context: {\n      values: SettingsFormValues;\n      dirty: SettingsDirtyState;\n      view: SettingsView;\n    },\n  ) => Record<string, unknown>;\n  onSaveSuccess?: () => void;\n  getInitialView?: (\n    settings: Settings,\n    filteredSchema: SettingsSchema,\n  ) => SettingsView;\n  forceShowAdvancedView?: boolean;\n  allowAllView?: boolean;\n  /**\n   * Per-field initial value overrides that win over the values derived from\n   * `useSettings`. When {@link markInitialOverridesDirty} is true (default),\n   * override keys also start dirty so onboarding can save a prefill without\n   * a touch. Profile editors should pass `false` so Save stays off until the\n   * user changes something.\n   */\n  initialValueOverrides?: SettingsFormValues;\n  /** @default true */\n  markInitialOverridesDirty?: boolean;\n  embedded?: boolean;\n  hideSaveButton?: boolean;\n  /** Suppress the default success toast after save completes. */\n  suppressSuccessToast?: boolean;\n  /**\n   * Fires whenever the save state changes (a mutation starts/finishes,\n   * dirty status flips). Provides a stable `save()` callback the\n   * parent can wire to its own button. Useful when the form is\n   * embedded in a custom flow and the built-in Save button is hidden.\n   */\n  onSaveControlChange?: (control: SdkSectionSaveControl) => void;\n  testId?: string;\n}) {\n  const { t } = useTranslation(\"openhands\");\n  const { mutate: saveSettings, isPending } = useSaveSettings(scope);\n  const { data: settings, isLoading, isFetching } = useSettings(scope);\n  const agentSchemaQuery = useAgentSettingsSchema(\n    settings?.agent_settings_schema,\n  );\n  const conversationSchemaQuery = useConversationSettingsSchema(\n    settings?.conversation_settings_schema,\n  );\n  const isReadOnly = false;\n\n  const sourcesSignature = React.useMemo(\n    () =>\n      JSON.stringify(\n        settingsSources.map((s) => ({\n          source: s.settingsSource,\n          sectionKeys: s.sectionKeys,\n          excludeKeys: s.excludeKeys ? Array.from(s.excludeKeys).sort() : null,\n        })),\n      ),\n    [settingsSources],\n  );\n\n  const resolvedSourceConfigs = React.useMemo<SettingsSourceConfig[]>(() => {\n    const parsed = JSON.parse(sourcesSignature) as Array<{\n      source: SettingsValueSource;\n      sectionKeys: string[];\n      excludeKeys: string[] | null;\n    }>;\n    return parsed.map((p) => ({\n      settingsSource: p.source,\n      sectionKeys: p.sectionKeys,\n      excludeKeys: p.excludeKeys ? new Set(p.excludeKeys) : undefined,\n    }));\n  }, [sourcesSignature]);\n\n  const getSchemaForSource = React.useCallback(\n    (source: SettingsValueSource) =>\n      source === \"conversation_settings\"\n        ? conversationSchemaQuery.data\n        : agentSchemaQuery.data,\n    [agentSchemaQuery.data, conversationSchemaQuery.data],\n  );\n\n  const isSchemaLoading = resolvedSourceConfigs.some((src) =>\n    src.settingsSource === \"conversation_settings\"\n      ? conversationSchemaQuery.isLoading\n      : agentSchemaQuery.isLoading,\n  );\n\n  const resolvedSources = React.useMemo<ResolvedSource[]>(\n    () =>\n      resolvedSourceConfigs.map((src) => {\n        const schema = getSchemaForSource(src.settingsSource);\n        if (!isValidSettingsSchema(schema)) {\n          return { ...src, filteredSchema: null };\n        }\n        const sectionSet = new Set(src.sectionKeys);\n        // The agent schema can carry more than one section per key — e.g. the\n        // combined AgentSettings schema emits an \"llm\" section for both the\n        // \"openhands\" and \"acp\" variants. Only the first (openhands) is used,\n        // so keep the first section per key; otherwise every field renders\n        // twice and React sees duplicate section keys.\n        const seenKeys = new Set<string>();\n        const filteredSchema: SettingsSchema = {\n          ...schema,\n          sections: schema.sections.filter((s) => {\n            if (!sectionSet.has(s.key) || seenKeys.has(s.key)) return false;\n            seenKeys.add(s.key);\n            return true;\n          }),\n        };\n        return { ...src, filteredSchema };\n      }),\n    [resolvedSourceConfigs, getSchemaForSource],\n  );\n\n  // The basic tier only exists when some field renders in it; a critical-less\n  // page (e.g. Memory, whose only field is major) hides the Basic tab and\n  // floors its view at \"advanced\".\n  const showBasic = resolvedSources.some((src) =>\n    hasCriticalSettings(src.filteredSchema),\n  );\n  const showAdvanced =\n    forceShowAdvancedView ||\n    resolvedSources.some((src) => hasAdvancedSettings(src.filteredSchema));\n  const showAll =\n    allowAllView &&\n    resolvedSources.some((src) => hasMinorSettings(src.filteredSchema));\n\n  const schemaUnavailableMessage = React.useMemo(() => {\n    const firstError = resolvedSourceConfigs.reduce<unknown>(\n      (err, src) =>\n        err ??\n        (src.settingsSource === \"conversation_settings\"\n          ? conversationSchemaQuery.error\n          : agentSchemaQuery.error),\n      null,\n    );\n    return getSchemaUnavailableMessage(\n      firstError,\n      t(I18nKey.SETTINGS$SDK_SCHEMA_UNAVAILABLE),\n    );\n  }, [\n    resolvedSourceConfigs,\n    agentSchemaQuery.error,\n    conversationSchemaQuery.error,\n    t,\n  ]);\n\n  const overridesSignature = React.useMemo(\n    () => (initialValueOverrides ? JSON.stringify(initialValueOverrides) : \"\"),\n    [initialValueOverrides],\n  );\n  const firstSettingsSource = resolvedSources[0]?.settingsSource;\n\n  const [view, setView] = React.useState<SettingsView>(\"basic\");\n  const [valuesBySource, setValuesBySource] = React.useState<\n    Partial<Record<SettingsValueSource, SettingsFormValues>>\n  >({});\n  const [dirtyBySource, setDirtyBySource] = React.useState<\n    Partial<Record<SettingsValueSource, SettingsDirtyState>>\n  >({});\n  const hasHydratedViewRef = React.useRef(false);\n\n  const initialValuesBySource = React.useMemo<Partial<\n    Record<SettingsValueSource, SettingsFormValues>\n  > | null>(() => {\n    if (!settings) return null;\n    const result: Partial<Record<SettingsValueSource, SettingsFormValues>> = {};\n    for (const src of resolvedSources) {\n      if (!src.filteredSchema) return null;\n      result[src.settingsSource] = {\n        ...(result[src.settingsSource] ?? {}),\n        ...buildInitialSettingsFormValues(\n          settings,\n          src.filteredSchema,\n          src.settingsSource,\n        ),\n      };\n    }\n    if (initialValueOverrides) {\n      const firstSource = resolvedSources[0]?.settingsSource;\n      if (firstSource && result[firstSource]) {\n        result[firstSource] = {\n          ...result[firstSource],\n          ...initialValueOverrides,\n        };\n      }\n    }\n    return result;\n  }, [settings, resolvedSources, overridesSignature]);\n\n  const initialView = React.useMemo(() => {\n    if (!settings) return null;\n    let result: SettingsView | null = null;\n    for (const src of resolvedSources) {\n      if (!src.filteredSchema) return null;\n      const perSource = getInitialView\n        ? getInitialView(settings, src.filteredSchema)\n        : inferInitialView(settings, src.filteredSchema, src.settingsSource);\n      result = result ? getMoreDetailedView(result, perSource) : perSource;\n    }\n    if (!result) return null;\n    return normalizeView(result, { showBasic, showAdvanced, showAll });\n  }, [\n    settings,\n    resolvedSources,\n    getInitialView,\n    showBasic,\n    showAdvanced,\n    showAll,\n  ]);\n\n  React.useEffect(() => {\n    hasHydratedViewRef.current = false;\n    setView(\"basic\");\n    setValuesBySource({});\n    setDirtyBySource({});\n  }, [scope, sourcesSignature]);\n\n  React.useEffect(() => {\n    if (!initialValuesBySource || !initialView) return;\n    if (hideSaveButton && hasHydratedViewRef.current) {\n      return;\n    }\n\n    setValuesBySource(initialValuesBySource);\n    if (initialValueOverrides && markInitialOverridesDirty) {\n      const firstSource = firstSettingsSource;\n      if (firstSource) {\n        const overrideDirty: SettingsDirtyState = Object.fromEntries(\n          Object.keys(initialValueOverrides).map((key) => [key, true]),\n        );\n        setDirtyBySource({ [firstSource]: overrideDirty });\n      } else {\n        setDirtyBySource({});\n      }\n    } else {\n      setDirtyBySource({});\n    }\n    // The ref flip stays outside the updater: React double-invokes state\n    // updaters in StrictMode, so mutating it in there makes the second\n    // (kept) call take the already-hydrated branch and pin the view.\n    if (!hasHydratedViewRef.current) {\n      hasHydratedViewRef.current = true;\n      setView(initialView);\n    } else {\n      setView((currentView) => getLessDetailedView(currentView, initialView));\n    }\n  }, [\n    initialValuesBySource,\n    initialView,\n    overridesSignature,\n    markInitialOverridesDirty,\n    firstSettingsSource,\n    hideSaveButton,\n  ]);\n\n  const fieldKeyToSource = React.useMemo(() => {\n    const map = new Map<string, SettingsValueSource>();\n    for (const src of resolvedSources) {\n      if (src.filteredSchema) {\n        for (const section of src.filteredSchema.sections) {\n          for (const field of section.fields) {\n            if (!map.has(field.key)) {\n              map.set(field.key, src.settingsSource);\n            }\n          }\n        }\n      }\n    }\n    return map;\n  }, [resolvedSources]);\n\n  const flatValues = React.useMemo<SettingsFormValues>(() => {\n    const merged: SettingsFormValues = {};\n    for (const src of resolvedSources) {\n      Object.assign(merged, valuesBySource[src.settingsSource] ?? {});\n    }\n    return merged;\n  }, [resolvedSources, valuesBySource]);\n\n  const flatDirty = React.useMemo<SettingsDirtyState>(() => {\n    const merged: SettingsDirtyState = {};\n    for (const src of resolvedSources) {\n      Object.assign(merged, dirtyBySource[src.settingsSource] ?? {});\n    }\n    return merged;\n  }, [resolvedSources, dirtyBySource]);\n\n  const fieldsByKey = React.useMemo(() => {\n    const map = new Map<string, SettingsFieldSchema>();\n    for (const src of resolvedSources) {\n      if (!src.filteredSchema) continue;\n      for (const section of src.filteredSchema.sections) {\n        for (const field of section.fields) {\n          if (!map.has(field.key)) {\n            map.set(field.key, field);\n          }\n        }\n      }\n    }\n    return map;\n  }, [resolvedSources]);\n\n  const initialValuesBySourceRef = React.useRef(initialValuesBySource);\n  initialValuesBySourceRef.current = initialValuesBySource;\n  const initialValueOverridesRef = React.useRef(initialValueOverrides);\n  initialValueOverridesRef.current = initialValueOverrides;\n  const markInitialOverridesDirtyRef = React.useRef(markInitialOverridesDirty);\n  markInitialOverridesDirtyRef.current = markInitialOverridesDirty;\n  const fieldsByKeyRef = React.useRef(fieldsByKey);\n  fieldsByKeyRef.current = fieldsByKey;\n\n  const handleFieldChange = React.useCallback(\n    (fieldKey: string, nextValue: string | boolean) => {\n      const sourceKey =\n        fieldKeyToSource.get(fieldKey) ?? resolvedSources[0]?.settingsSource;\n      if (!sourceKey) return;\n      setValuesBySource((prev) => ({\n        ...prev,\n        [sourceKey]: {\n          ...(prev[sourceKey] ?? {}),\n          [fieldKey]: nextValue,\n        },\n      }));\n      setDirtyBySource((prev) => {\n        const initialVal =\n          initialValuesBySourceRef.current?.[sourceKey]?.[fieldKey];\n        const stickyOverride =\n          markInitialOverridesDirtyRef.current &&\n          !!initialValueOverridesRef.current &&\n          fieldKey in initialValueOverridesRef.current;\n        const field = fieldsByKeyRef.current.get(fieldKey);\n        const valuesMatch = field\n          ? normalizeComparableValue(field, nextValue) ===\n            normalizeComparableValue(field, initialVal)\n          : nextValue === initialVal;\n\n        if (valuesMatch && !stickyOverride) {\n          if (!prev[sourceKey]?.[fieldKey]) return prev;\n          const sourceDirty = { ...(prev[sourceKey] ?? {}) };\n          delete sourceDirty[fieldKey];\n          return { ...prev, [sourceKey]: sourceDirty };\n        }\n\n        if (prev[sourceKey]?.[fieldKey]) return prev;\n        return {\n          ...prev,\n          [sourceKey]: { ...(prev[sourceKey] ?? {}), [fieldKey]: true },\n        };\n      });\n    },\n    [fieldKeyToSource, resolvedSources],\n  );\n\n  const handleError = React.useCallback(\n    (error: AxiosError) => {\n      const msg = retrieveAxiosErrorMessage(error);\n      displayErrorToast(msg || t(I18nKey.ERROR$GENERIC));\n    },\n    [t],\n  );\n\n  const handleSaveRef = React.useRef<() => void>(() => {});\n  const stableSave = React.useCallback(() => {\n    handleSaveRef.current();\n  }, []);\n\n  // Stable accessor for the coerced, dirty-only payload. Mirrors the\n  // `handleSaveRef` pattern so the exposed function reference stays stable\n  // across renders while always reading the latest closure at call time.\n  const buildDirtyPayloadRef = React.useRef<() => Record<string, unknown>>(\n    () => ({}),\n  );\n  const stableGetDirtyPayload = React.useCallback(\n    () => buildDirtyPayloadRef.current(),\n    [],\n  );\n\n  const handleSave = () => {\n    if (isReadOnly) return;\n    if (resolvedSources.some((src) => !src.filteredSchema)) return;\n\n    let payload: Record<string, unknown>;\n    try {\n      const defaultPayload: Record<string, unknown> = {};\n      for (const src of resolvedSources) {\n        const schema = src.filteredSchema!;\n        const sourceValues = valuesBySource[src.settingsSource] ?? {};\n        const sourceDirty = dirtyBySource[src.settingsSource] ?? {};\n        const diff = buildSdkSettingsPayloadForView(\n          schema,\n          sourceValues,\n          sourceDirty,\n          view,\n        );\n        if (Object.keys(diff).length > 0) {\n          const diffKey = PAYLOAD_DIFF_KEY[src.settingsSource];\n          defaultPayload[diffKey] = {\n            ...((defaultPayload[diffKey] as\n              | Record<string, unknown>\n              | undefined) ?? {}),\n            ...diff,\n          };\n        }\n      }\n\n      payload = buildPayload\n        ? buildPayload(defaultPayload, {\n            values: flatValues,\n            dirty: flatDirty,\n            view,\n          })\n        : defaultPayload;\n    } catch (error) {\n      displayErrorToast(\n        error instanceof Error ? error.message : t(I18nKey.ERROR$GENERIC),\n      );\n      return;\n    }\n\n    if (Object.keys(payload).length === 0) return;\n\n    saveSettings(payload, {\n      onError: handleError,\n      onSuccess: () => {\n        if (!suppressSuccessToast) {\n          displaySuccessToast(t(I18nKey.SETTINGS$SAVED_WARNING));\n        }\n        setDirtyBySource({});\n        onSaveSuccess?.();\n      },\n    });\n  };\n\n  handleSaveRef.current = handleSave;\n  // Dirty-only (NOT view-filtered): we must never inject defaults for\n  // non-visible fields here, or a custom save flow would reset fields the\n  // user never touched. `buildSdkSettingsPayloadForView` is reserved for the\n  // built-in full-replace save above. With multiple sources, we merge each\n  // source's nested payload at the top level so single-source consumers\n  // (e.g. `LlmSettingsLocalView`) keep reading `.llm` etc. unchanged.\n  buildDirtyPayloadRef.current = () => {\n    const merged: Record<string, unknown> = {};\n    for (const src of resolvedSources) {\n      if (!src.filteredSchema) continue;\n      const sourceValues = valuesBySource[src.settingsSource] ?? {};\n      const sourceDirty = dirtyBySource[src.settingsSource] ?? {};\n      Object.assign(\n        merged,\n        buildSdkSettingsPayload(src.filteredSchema, sourceValues, sourceDirty),\n      );\n    }\n    return merged;\n  };\n\n  const isDirty = Object.keys(flatDirty).length > 0;\n  const saveControlIsDirty = isDirty || extraDirty;\n  React.useEffect(() => {\n    if (!onSaveControlChange) return;\n    onSaveControlChange({\n      save: stableSave,\n      isSaving: isPending,\n      isDirty: saveControlIsDirty,\n      values: flatValues,\n      view,\n      getDirtyPayload: stableGetDirtyPayload,\n    });\n  }, [isPending, saveControlIsDirty, flatValues, view]);\n\n  // Keep existing form content visible during background refetches to avoid\n  // flashing the full skeleton (notably during onboarding Next transitions).\n  const isInitialSettingsLoad = (isLoading || isFetching) && !settings;\n  if (isInitialSettingsLoad || isSchemaLoading) {\n    return <LlmSettingsInputsSkeleton />;\n  }\n\n  const hasAnyVisibleSection = resolvedSources.some(\n    (src) => src.filteredSchema && src.filteredSchema.sections.length > 0,\n  );\n\n  if (!hasAnyVisibleSection) {\n    return (\n      <div\n        data-testid=\"sdk-schema-unavailable\"\n        className={extensionModuleEmptyStateClassName}\n      >\n        <p className=\"text-sm text-[var(--oh-muted)]\">\n          {schemaUnavailableMessage}\n        </p>\n      </div>\n    );\n  }\n\n  if (Object.keys(flatValues).length === 0) {\n    return <LlmSettingsInputsSkeleton />;\n  }\n\n  // Scrolling is owned by the settings shell (or onboarding wrapper), not a\n  // nested scroll region. Save actions are inline after the last field.\n  const bodyClassName = \"flex flex-col gap-8\";\n\n  return (\n    <div\n      data-testid={testId}\n      className={\n        embedded\n          ? \"relative flex min-h-0 w-full flex-1 flex-col\"\n          : \"relative w-full min-h-0\"\n      }\n    >\n      <ViewToggle\n        view={view}\n        setView={setView}\n        showBasic={showBasic}\n        showAdvanced={showAdvanced}\n        showAll={showAll}\n        isDisabled={isReadOnly}\n      />\n\n      <div className={bodyClassName}>\n        {header?.({\n          values: flatValues,\n          isDisabled: isReadOnly,\n          view,\n          onChange: handleFieldChange,\n        })}\n\n        {resolvedSources.map((src) => {\n          if (!src.filteredSchema) return null;\n          const sourceValues = valuesBySource[src.settingsSource] ?? {};\n          const visibleSections = getVisibleSettingsSections(\n            src.filteredSchema,\n            { ...flatValues, ...sourceValues },\n            view,\n            src.excludeKeys ?? EMPTY_EXCLUDE_KEYS,\n          );\n          return visibleSections.map((section) => (\n            <section\n              key={`${src.settingsSource}:${section.key}`}\n              className=\"flex flex-col gap-4\"\n            >\n              <div className=\"grid gap-4 xl:grid-cols-2\">\n                {section.fields.map((field) => (\n                  <div\n                    key={field.key}\n                    className={\n                      FIELD_FULL_WIDTH_KEYS.has(field.key)\n                        ? \"xl:col-span-2\"\n                        : undefined\n                    }\n                  >\n                    <SchemaField\n                      field={field}\n                      value={sourceValues[field.key]}\n                      isDisabled={isReadOnly}\n                      onChange={(nextValue) =>\n                        handleFieldChange(field.key, nextValue)\n                      }\n                    />\n                  </div>\n                ))}\n              </div>\n            </section>\n          ));\n        })}\n\n        {!isReadOnly && !hideSaveButton ? (\n          <div className=\"flex justify-start pt-2\">\n            <BrandButton\n              testId=\"save-button\"\n              type=\"button\"\n              variant=\"primary\"\n              isDisabled={isPending || (!isDirty && !extraDirty)}\n              onClick={handleSave}\n            >\n              {isPending\n                ? t(I18nKey.SETTINGS$SAVING)\n                : t(I18nKey.SETTINGS$SAVE_CHANGES)}\n            </BrandButton>\n          </div>\n        ) : null}\n      </div>\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/components/features/settings/sdk-settings/sdk-section-page.d.ts

@@ -56,7 +56,7 @@ export interface SdkSectionSaveControl {
  * @param buildPayload     customize the save payload before submission
  * @param testId           data-testid on the page wrapper
  */
-export declare function SdkSectionPage({ settingsSources, scope, header, extraDirty, buildPayload, onSaveSuccess, getInitialView, forceShowAdvancedView, allowAllView, initialValueOverrides, embedded, hideSaveButton, suppressSuccessToast, onSaveControlChange, testId, }: {
+export declare function SdkSectionPage({ settingsSources, scope, header, extraDirty, buildPayload, onSaveSuccess, getInitialView, forceShowAdvancedView, allowAllView, initialValueOverrides, markInitialOverridesDirty, embedded, hideSaveButton, suppressSuccessToast, onSaveControlChange, testId, }: {
     settingsSources: SettingsSourceConfig[];
     scope?: SettingsScope;
     header?: (props: SdkSectionHeaderProps) => React.ReactNode;
@@ -76,14 +76,15 @@ export declare function SdkSectionPage({ settingsSources, scope, header, extraDi
     forceShowAdvancedView?: boolean;
     allowAllView?: boolean;
     /**
-     * Per-field initial value overrides that win over the values
-     * derived from `useSettings`. The keys of each override are also
-     * marked dirty on hydration so the user can save the form without
-     * having to touch the prefilled fields. Useful when the page is
-     * embedded in a flow that wants to nudge brand-new users toward a
-     * particular default (e.g. onboarding pre-filling OpenHands/Opus).
+     * Per-field initial value overrides that win over the values derived from
+     * `useSettings`. When {@link markInitialOverridesDirty} is true (default),
+     * override keys also start dirty so onboarding can save a prefill without
+     * a touch. Profile editors should pass `false` so Save stays off until the
+     * user changes something.
      */
     initialValueOverrides?: SettingsFormValues;
+    /** @default true */
+    markInitialOverridesDirty?: boolean;
     embedded?: boolean;
     hideSaveButton?: boolean;
     /** Suppress the default success toast after save completes. */