@openhands/agent-canvas 1.0.0-beta.8 → 1.0.0-rc.1

package/dist/components/features/conversation-panel/conversation-card/conversation-card.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-card.js","names":[],"sources":["../../../../../src/components/features/conversation-panel/conversation-card/conversation-card.tsx"],"sourcesContent":["import React from \"react\";\nimport { usePostHog } from \"posthog-js/react\";\nimport { cn } from \"#/utils/utils\";\nimport { transformVSCodeUrl } from \"#/utils/vscode-url-helper\";\nimport ConversationService from \"#/api/conversation-service/conversation-service.api\";\nimport { ExecutionStatus } from \"#/types/agent-server/core/base/common\";\nimport { SandboxStatus } from \"#/api/conversation-service/agent-server-conversation-service.types\";\nimport { RepositorySelection } from \"#/api/open-hands.types\";\nimport { formatTimeDelta } from \"#/utils/format-time-delta\";\nimport { ConversationCardHeader } from \"./conversation-card-header\";\nimport { ConversationCardActions } from \"./conversation-card-actions\";\nimport { ConversationCardFooter } from \"./conversation-card-footer\";\nimport { ConversationStatusBadges } from \"./conversation-status-badges\";\nimport { useDownloadConversation } from \"#/hooks/use-download-conversation\";\n\ninterface ConversationCardProps {\n  onClick?: () => void;\n  onDelete?: () => void;\n  onStop?: () => void;\n  onChangeTitle?: (title: string) => void;\n  showOptions?: boolean;\n  title: string;\n  selectedRepository: RepositorySelection | null;\n  lastUpdatedAt: string;\n  createdAt?: string;\n  executionStatus?: ExecutionStatus | null;\n  sandboxStatus?: SandboxStatus | null;\n  conversationId?: string;\n  contextMenuOpen?: boolean;\n  onContextMenuToggle?: (isOpen: boolean) => void;\n  isActive?: boolean;\n  workspaceWorkingDir?: string | null;\n  showRepositoryMetadata?: boolean;\n  llmModel?: string | null;\n  showLlmProfiles?: boolean;\n  agentKind?: \"openhands\" | \"acp\" | null;\n  acpServer?: string | null;\n}\n\nexport function ConversationCard({\n  onClick,\n  onDelete,\n  onStop,\n  onChangeTitle,\n  showOptions,\n  title,\n  selectedRepository,\n  lastUpdatedAt,\n  createdAt,\n  conversationId,\n  executionStatus,\n  sandboxStatus,\n  contextMenuOpen = false,\n  onContextMenuToggle,\n  isActive = false,\n  workspaceWorkingDir,\n  showRepositoryMetadata = true,\n  llmModel = null,\n  showLlmProfiles = false,\n  agentKind = null,\n  acpServer = null,\n}: ConversationCardProps) {\n  const posthog = usePostHog();\n  const [titleMode, setTitleMode] = React.useState<\"view\" | \"edit\">(\"view\");\n  const { mutateAsync: downloadConversation } = useDownloadConversation();\n\n  const onTitleSave = (newTitle: string) => {\n    if (newTitle !== \"\" && newTitle !== title) {\n      onChangeTitle?.(newTitle);\n    }\n    setTitleMode(\"view\");\n  };\n\n  const handleDelete = (event: React.MouseEvent<HTMLButtonElement>) => {\n    event.preventDefault();\n    event.stopPropagation();\n    onDelete?.();\n    onContextMenuToggle?.(false);\n  };\n\n  const handleStop = (event: React.MouseEvent<HTMLButtonElement>) => {\n    event.preventDefault();\n    event.stopPropagation();\n    onStop?.();\n    onContextMenuToggle?.(false);\n  };\n\n  const handleEdit = (event: React.MouseEvent<HTMLButtonElement>) => {\n    event.preventDefault();\n    event.stopPropagation();\n    setTitleMode(\"edit\");\n    onContextMenuToggle?.(false);\n  };\n\n  const handleDownloadViaVSCode = async (\n    event: React.MouseEvent<HTMLButtonElement>,\n  ) => {\n    event.preventDefault();\n    event.stopPropagation();\n    posthog.capture(\"download_via_vscode_button_clicked\");\n\n    // Fetch the VS Code URL from the API\n    if (conversationId) {\n      try {\n        const data = await ConversationService.getVSCodeUrl(conversationId);\n        if (data.vscode_url) {\n          const transformedUrl = transformVSCodeUrl(data.vscode_url);\n          if (transformedUrl) {\n            window.open(transformedUrl, \"_blank\");\n          }\n        }\n        // VS Code URL not available\n      } catch {\n        // Failed to fetch VS Code URL\n      }\n    }\n\n    onContextMenuToggle?.(false);\n  };\n\n  const handleDownloadConversation = async (\n    event: React.MouseEvent<HTMLButtonElement>,\n  ) => {\n    event.preventDefault();\n    event.stopPropagation();\n\n    if (conversationId) {\n      await downloadConversation(conversationId);\n    }\n    onContextMenuToggle?.(false);\n  };\n\n  const hasContextMenu = !!(onDelete || onChangeTitle || showOptions);\n  const shouldRenderFooter =\n    showRepositoryMetadata ||\n    (showLlmProfiles && (agentKind === \"acp\" || !!llmModel));\n\n  return (\n    <div\n      data-testid=\"conversation-card\"\n      data-context-menu-open={contextMenuOpen.toString()}\n      data-active={isActive ? \"true\" : \"false\"}\n      onClick={onClick}\n      className={cn(\n        \"group relative h-auto w-full cursor-pointer rounded-md py-1 pl-2 pr-1 transition-colors\",\n        \"data-[context-menu-open=false]:hover:bg-[var(--oh-surface)]\",\n        \"data-[active=true]:bg-[var(--oh-surface)]\",\n      )}\n    >\n      <div className=\"flex items-center w-full min-w-0\">\n        <div className=\"flex items-center gap-2 flex-1 min-w-0 overflow-hidden\">\n          <ConversationCardHeader\n            title={title}\n            titleMode={titleMode}\n            onTitleSave={onTitleSave}\n            executionStatus={executionStatus}\n            sandboxStatus={sandboxStatus}\n          />\n          {sandboxStatus === \"ERROR\" && <ConversationStatusBadges />}\n        </div>\n\n        <div className=\"relative ml-auto pl-2 flex items-center justify-end shrink-0\">\n          {(createdAt ?? lastUpdatedAt) && (\n            <p\n              className={cn(\n                \"text-xs text-[var(--oh-muted)] text-right whitespace-nowrap transition-opacity -translate-x-1.5\",\n                hasContextMenu &&\n                  \"group-hover:opacity-0 group-focus-within:opacity-0\",\n                contextMenuOpen && \"opacity-0\",\n              )}\n            >\n              <time>{formatTimeDelta(lastUpdatedAt ?? createdAt)}</time>\n            </p>\n          )}\n\n          {hasContextMenu && (\n            <div\n              className={cn(\n                \"absolute right-0 top-1/2 -translate-y-1/2 transition-opacity\",\n                \"opacity-0 invisible group-hover:opacity-100 group-hover:visible\",\n                contextMenuOpen && \"visible opacity-100\",\n              )}\n            >\n              <ConversationCardActions\n                contextMenuOpen={contextMenuOpen}\n                onContextMenuToggle={onContextMenuToggle || (() => {})}\n                onDelete={onDelete && handleDelete}\n                onStop={onStop && handleStop}\n                onEdit={onChangeTitle && handleEdit}\n                onDownloadViaVSCode={handleDownloadViaVSCode}\n                onDownloadConversation={handleDownloadConversation}\n                executionStatus={executionStatus}\n                conversationId={conversationId}\n                showOptions={showOptions}\n              />\n            </div>\n          )}\n        </div>\n      </div>\n\n      {shouldRenderFooter && (\n        <ConversationCardFooter\n          selectedRepository={selectedRepository}\n          lastUpdatedAt={lastUpdatedAt}\n          createdAt={createdAt}\n          executionStatus={executionStatus}\n          workspaceWorkingDir={workspaceWorkingDir}\n          showRepositoryMetadata={showRepositoryMetadata}\n          showTimestamp={false}\n          llmModel={llmModel}\n          showAgentChip={showLlmProfiles}\n          agentKind={agentKind}\n          acpServer={acpServer}\n        />\n      )}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAuCA,SAAgB,EAAiB,EAC/B,YACA,aACA,WACA,kBACA,gBACA,UACA,uBACA,kBACA,cACA,mBACA,oBACA,kBACA,qBAAkB,IAClB,wBACA,cAAW,IACX,wBACA,4BAAyB,IACzB,cAAW,MACX,qBAAkB,IAClB,eAAY,MACZ,eAAY,QACY;CACxB,IAAM,IAAU,GAAY,EACtB,CAAC,GAAW,KAAgB,EAAM,SAA0B,OAAO,EACnE,EAAE,aAAa,MAAyB,GAAyB,EAEjE,KAAe,MAAqB;AAIxC,EAHI,MAAa,MAAM,MAAa,KAClC,IAAgB,EAAS,EAE3B,EAAa,OAAO;IAGhB,KAAgB,MAA+C;AAInE,EAHA,EAAM,gBAAgB,EACtB,EAAM,iBAAiB,EACvB,KAAY,EACZ,IAAsB,GAAM;IAGxB,KAAc,MAA+C;AAIjE,EAHA,EAAM,gBAAgB,EACtB,EAAM,iBAAiB,EACvB,KAAU,EACV,IAAsB,GAAM;IAGxB,KAAc,MAA+C;AAIjE,EAHA,EAAM,gBAAgB,EACtB,EAAM,iBAAiB,EACvB,EAAa,OAAO,EACpB,IAAsB,GAAM;IAGxB,IAA0B,OAC9B,MACG;AAMH,MALA,EAAM,gBAAgB,EACtB,EAAM,iBAAiB,EACvB,EAAQ,QAAQ,qCAAqC,EAGjD,EACF,KAAI;GACF,IAAM,IAAO,MAAM,EAAoB,aAAa,EAAe;AACnE,OAAI,EAAK,YAAY;IACnB,IAAM,IAAiB,EAAmB,EAAK,WAAW;AAC1D,IAAI,KACF,OAAO,KAAK,GAAgB,SAAS;;UAInC;AAKV,MAAsB,GAAM;IAGxB,IAA6B,OACjC,MACG;AAOH,EANA,EAAM,gBAAgB,EACtB,EAAM,iBAAiB,EAEnB,KACF,MAAM,EAAqB,EAAe,EAE5C,IAAsB,GAAM;IAGxB,IAAiB,CAAC,EAAE,KAAY,KAAiB,IACjD,IACJ,KACC,MAAoB,MAAc,SAAS,CAAC,CAAC;AAEhD,QACE,kBAAC,OAAD;EACE,eAAY;EACZ,0BAAwB,EAAgB,UAAU;EAClD,eAAa,IAAW,SAAS;EACxB;EACT,WAAW,EACT,2FACA,+DACA,4CACD;YATH,CAWE,kBAAC,OAAD;GAAK,WAAU;aAAf,CACE,kBAAC,OAAD;IAAK,WAAU;cAAf,CACE,kBAAC,GAAD;KACS;KACI;KACE;KACI;KACF;KACf,CAAA,EACD,MAAkB,WAAW,kBAAC,GAAD,EAA4B,CAAA,CACtD;OAEN,kBAAC,OAAD;IAAK,WAAU;cAAf,EACI,KAAa,MACb,kBAAC,KAAD;KACE,WAAW,EACT,mGACA,KACE,sDACF,KAAmB,YACpB;eAED,kBAAC,QAAD,EAAA,UAAO,EAAgB,KAAiB,EAAU,EAAQ,CAAA;KACxD,CAAA,EAGL,KACC,kBAAC,OAAD;KACE,WAAW,EACT,gEACA,mEACA,KAAmB,sBACpB;eAED,kBAAC,GAAD;MACmB;MACjB,qBAAqB,YAA8B;MACnD,UAAU,KAAY;MACtB,QAAQ,KAAU;MAClB,QAAQ,KAAiB;MACzB,qBAAqB;MACrB,wBAAwB;MACP;MACD;MACH;MACb,CAAA;KACE,CAAA,CAEJ;MACF;MAEL,KACC,kBAAC,GAAD;GACsB;GACL;GACJ;GACM;GACI;GACG;GACxB,eAAe;GACL;GACV,eAAe;GACJ;GACA;GACX,CAAA,CAEA"}
+{"version":3,"file":"conversation-card.js","names":[],"sources":["../../../../../src/components/features/conversation-panel/conversation-card/conversation-card.tsx"],"sourcesContent":["import React from \"react\";\nimport { useTracking } from \"#/hooks/use-tracking\";\nimport { cn } from \"#/utils/utils\";\nimport { transformVSCodeUrl } from \"#/utils/vscode-url-helper\";\nimport ConversationService from \"#/api/conversation-service/conversation-service.api\";\nimport { ExecutionStatus } from \"#/types/agent-server/core/base/common\";\nimport { SandboxStatus } from \"#/api/conversation-service/agent-server-conversation-service.types\";\nimport { RepositorySelection } from \"#/api/open-hands.types\";\nimport { formatTimeDelta } from \"#/utils/format-time-delta\";\nimport { ConversationCardHeader } from \"./conversation-card-header\";\nimport { ConversationCardActions } from \"./conversation-card-actions\";\nimport { ConversationCardFooter } from \"./conversation-card-footer\";\nimport { ConversationStatusBadges } from \"./conversation-status-badges\";\nimport { useDownloadConversation } from \"#/hooks/use-download-conversation\";\n\ninterface ConversationCardProps {\n  onClick?: () => void;\n  onDelete?: () => void;\n  onStop?: () => void;\n  onChangeTitle?: (title: string) => void;\n  showOptions?: boolean;\n  title: string;\n  selectedRepository: RepositorySelection | null;\n  lastUpdatedAt: string;\n  createdAt?: string;\n  executionStatus?: ExecutionStatus | null;\n  sandboxStatus?: SandboxStatus | null;\n  conversationId?: string;\n  contextMenuOpen?: boolean;\n  onContextMenuToggle?: (isOpen: boolean) => void;\n  isActive?: boolean;\n  workspaceWorkingDir?: string | null;\n  showRepositoryMetadata?: boolean;\n  llmModel?: string | null;\n  showLlmProfiles?: boolean;\n  agentKind?: \"openhands\" | \"acp\" | null;\n  acpServer?: string | null;\n}\n\nexport function ConversationCard({\n  onClick,\n  onDelete,\n  onStop,\n  onChangeTitle,\n  showOptions,\n  title,\n  selectedRepository,\n  lastUpdatedAt,\n  createdAt,\n  conversationId,\n  executionStatus,\n  sandboxStatus,\n  contextMenuOpen = false,\n  onContextMenuToggle,\n  isActive = false,\n  workspaceWorkingDir,\n  showRepositoryMetadata = true,\n  llmModel = null,\n  showLlmProfiles = false,\n  agentKind = null,\n  acpServer = null,\n}: ConversationCardProps) {\n  const { trackDownloadVsCodeButtonClicked } = useTracking();\n  const [titleMode, setTitleMode] = React.useState<\"view\" | \"edit\">(\"view\");\n  const { mutateAsync: downloadConversation } = useDownloadConversation();\n\n  const onTitleSave = (newTitle: string) => {\n    if (newTitle !== \"\" && newTitle !== title) {\n      onChangeTitle?.(newTitle);\n    }\n    setTitleMode(\"view\");\n  };\n\n  const handleDelete = (event: React.MouseEvent<HTMLButtonElement>) => {\n    event.preventDefault();\n    event.stopPropagation();\n    onDelete?.();\n    onContextMenuToggle?.(false);\n  };\n\n  const handleStop = (event: React.MouseEvent<HTMLButtonElement>) => {\n    event.preventDefault();\n    event.stopPropagation();\n    onStop?.();\n    onContextMenuToggle?.(false);\n  };\n\n  const handleEdit = (event: React.MouseEvent<HTMLButtonElement>) => {\n    event.preventDefault();\n    event.stopPropagation();\n    setTitleMode(\"edit\");\n    onContextMenuToggle?.(false);\n  };\n\n  const handleDownloadViaVSCode = async (\n    event: React.MouseEvent<HTMLButtonElement>,\n  ) => {\n    event.preventDefault();\n    event.stopPropagation();\n    trackDownloadVsCodeButtonClicked();\n\n    // Fetch the VS Code URL from the API\n    if (conversationId) {\n      try {\n        const data = await ConversationService.getVSCodeUrl(conversationId);\n        if (data.vscode_url) {\n          const transformedUrl = transformVSCodeUrl(data.vscode_url);\n          if (transformedUrl) {\n            window.open(transformedUrl, \"_blank\");\n          }\n        }\n        // VS Code URL not available\n      } catch {\n        // Failed to fetch VS Code URL\n      }\n    }\n\n    onContextMenuToggle?.(false);\n  };\n\n  const handleDownloadConversation = async (\n    event: React.MouseEvent<HTMLButtonElement>,\n  ) => {\n    event.preventDefault();\n    event.stopPropagation();\n\n    if (conversationId) {\n      await downloadConversation(conversationId);\n    }\n    onContextMenuToggle?.(false);\n  };\n\n  const hasContextMenu = !!(onDelete || onChangeTitle || showOptions);\n  const shouldRenderFooter =\n    showRepositoryMetadata ||\n    (showLlmProfiles && (agentKind === \"acp\" || !!llmModel));\n\n  return (\n    <div\n      data-testid=\"conversation-card\"\n      data-context-menu-open={contextMenuOpen.toString()}\n      data-active={isActive ? \"true\" : \"false\"}\n      onClick={onClick}\n      className={cn(\n        \"group relative h-auto w-full cursor-pointer rounded-md py-1 pl-2 pr-1 transition-colors\",\n        \"data-[context-menu-open=false]:hover:bg-[var(--oh-surface)]\",\n        \"data-[active=true]:bg-[var(--oh-surface)]\",\n      )}\n    >\n      <div className=\"flex items-center w-full min-w-0\">\n        <div className=\"flex items-center gap-2 flex-1 min-w-0 overflow-hidden\">\n          <ConversationCardHeader\n            title={title}\n            titleMode={titleMode}\n            onTitleSave={onTitleSave}\n            executionStatus={executionStatus}\n            sandboxStatus={sandboxStatus}\n          />\n          {sandboxStatus === \"ERROR\" && <ConversationStatusBadges />}\n        </div>\n\n        <div className=\"relative ml-auto pl-2 flex items-center justify-end shrink-0\">\n          {(createdAt ?? lastUpdatedAt) && (\n            <p\n              className={cn(\n                \"text-xs text-[var(--oh-muted)] text-right whitespace-nowrap transition-opacity -translate-x-1.5\",\n                hasContextMenu &&\n                  \"group-hover:opacity-0 group-focus-within:opacity-0\",\n                contextMenuOpen && \"opacity-0\",\n              )}\n            >\n              <time>{formatTimeDelta(lastUpdatedAt ?? createdAt)}</time>\n            </p>\n          )}\n\n          {hasContextMenu && (\n            <div\n              className={cn(\n                \"absolute right-0 top-1/2 -translate-y-1/2 transition-opacity\",\n                \"opacity-0 invisible group-hover:opacity-100 group-hover:visible\",\n                contextMenuOpen && \"visible opacity-100\",\n              )}\n            >\n              <ConversationCardActions\n                contextMenuOpen={contextMenuOpen}\n                onContextMenuToggle={onContextMenuToggle || (() => {})}\n                onDelete={onDelete && handleDelete}\n                onStop={onStop && handleStop}\n                onEdit={onChangeTitle && handleEdit}\n                onDownloadViaVSCode={handleDownloadViaVSCode}\n                onDownloadConversation={handleDownloadConversation}\n                executionStatus={executionStatus}\n                conversationId={conversationId}\n                showOptions={showOptions}\n              />\n            </div>\n          )}\n        </div>\n      </div>\n\n      {shouldRenderFooter && (\n        <ConversationCardFooter\n          selectedRepository={selectedRepository}\n          lastUpdatedAt={lastUpdatedAt}\n          createdAt={createdAt}\n          executionStatus={executionStatus}\n          workspaceWorkingDir={workspaceWorkingDir}\n          showRepositoryMetadata={showRepositoryMetadata}\n          showTimestamp={false}\n          llmModel={llmModel}\n          showAgentChip={showLlmProfiles}\n          agentKind={agentKind}\n          acpServer={acpServer}\n        />\n      )}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAuCA,SAAgB,EAAiB,EAC/B,YACA,aACA,WACA,kBACA,gBACA,UACA,uBACA,kBACA,cACA,mBACA,oBACA,kBACA,qBAAkB,IAClB,wBACA,cAAW,IACX,wBACA,4BAAyB,IACzB,cAAW,MACX,qBAAkB,IAClB,eAAY,MACZ,eAAY,QACY;CACxB,IAAM,EAAE,wCAAqC,GAAa,EACpD,CAAC,GAAW,KAAgB,EAAM,SAA0B,OAAO,EACnE,EAAE,aAAa,MAAyB,GAAyB,EAEjE,KAAe,MAAqB;AAIxC,EAHI,MAAa,MAAM,MAAa,KAClC,IAAgB,EAAS,EAE3B,EAAa,OAAO;IAGhB,KAAgB,MAA+C;AAInE,EAHA,EAAM,gBAAgB,EACtB,EAAM,iBAAiB,EACvB,KAAY,EACZ,IAAsB,GAAM;IAGxB,KAAc,MAA+C;AAIjE,EAHA,EAAM,gBAAgB,EACtB,EAAM,iBAAiB,EACvB,KAAU,EACV,IAAsB,GAAM;IAGxB,KAAc,MAA+C;AAIjE,EAHA,EAAM,gBAAgB,EACtB,EAAM,iBAAiB,EACvB,EAAa,OAAO,EACpB,IAAsB,GAAM;IAGxB,IAA0B,OAC9B,MACG;AAMH,MALA,EAAM,gBAAgB,EACtB,EAAM,iBAAiB,EACvB,GAAkC,EAG9B,EACF,KAAI;GACF,IAAM,IAAO,MAAM,EAAoB,aAAa,EAAe;AACnE,OAAI,EAAK,YAAY;IACnB,IAAM,IAAiB,EAAmB,EAAK,WAAW;AAC1D,IAAI,KACF,OAAO,KAAK,GAAgB,SAAS;;UAInC;AAKV,MAAsB,GAAM;IAGxB,IAA6B,OACjC,MACG;AAOH,EANA,EAAM,gBAAgB,EACtB,EAAM,iBAAiB,EAEnB,KACF,MAAM,EAAqB,EAAe,EAE5C,IAAsB,GAAM;IAGxB,IAAiB,CAAC,EAAE,KAAY,KAAiB,IACjD,IACJ,KACC,MAAoB,MAAc,SAAS,CAAC,CAAC;AAEhD,QACE,kBAAC,OAAD;EACE,eAAY;EACZ,0BAAwB,EAAgB,UAAU;EAClD,eAAa,IAAW,SAAS;EACxB;EACT,WAAW,EACT,2FACA,+DACA,4CACD;YATH,CAWE,kBAAC,OAAD;GAAK,WAAU;aAAf,CACE,kBAAC,OAAD;IAAK,WAAU;cAAf,CACE,kBAAC,GAAD;KACS;KACI;KACE;KACI;KACF;KACf,CAAA,EACD,MAAkB,WAAW,kBAAC,GAAD,EAA4B,CAAA,CACtD;OAEN,kBAAC,OAAD;IAAK,WAAU;cAAf,EACI,KAAa,MACb,kBAAC,KAAD;KACE,WAAW,EACT,mGACA,KACE,sDACF,KAAmB,YACpB;eAED,kBAAC,QAAD,EAAA,UAAO,EAAgB,KAAiB,EAAU,EAAQ,CAAA;KACxD,CAAA,EAGL,KACC,kBAAC,OAAD;KACE,WAAW,EACT,gEACA,mEACA,KAAmB,sBACpB;eAED,kBAAC,GAAD;MACmB;MACjB,qBAAqB,YAA8B;MACnD,UAAU,KAAY;MACtB,QAAQ,KAAU;MAClB,QAAQ,KAAiB;MACzB,qBAAqB;MACrB,wBAAwB;MACP;MACD;MACH;MACb,CAAA;KACE,CAAA,CAEJ;MACF;MAEL,KACC,kBAAC,GAAD;GACsB;GACL;GACJ;GACM;GACI;GACG;GACxB,eAAe;GACL;GACV,eAAe;GACJ;GACA;GACX,CAAA,CAEA"}

package/dist/components/features/onboarding/index.d.ts

@@ -2,3 +2,4 @@ export { OnboardingModal } from "./onboarding-modal";
 export { OnboardingHost } from "./onboarding-host";
 export { OnboardingProgressBar } from "./onboarding-progress-bar";
 export { useOnboardingCompletion, ONBOARDING_COMPLETED_STORAGE_KEY, } from "./use-onboarding-completion";
+export { ONBOARDING_PREVIEW_STEP_QUERY_PARAM, isOnboardingPreviewActive, readOnboardingPreviewStep, } from "./onboarding-preview";

package/dist/components/features/onboarding/onboarding-host.d.ts

@@ -4,6 +4,8 @@
  * isn't set yet). Closing or completing the flow marks it done so the
  * modal won't re-appear on subsequent visits.
  *
- * Renders nothing once onboarding has been completed.
+ * With `?previewOnboardingStep=<0-3>` the modal opens on that slide for
+ * design review without persisting completion (works on any route when
+ * mounted from the root layout).
  */
 export declare function OnboardingHost(): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/features/onboarding/onboarding-modal.d.ts

@@ -1,13 +1,17 @@
 interface OnboardingModalProps {
     /** Called when the user dismisses the modal (skip / X / launch). */
     onClose: () => void;
+    /** Optional slide index for dev preview (`?previewOnboardingStep=`). */
+    initialStep?: number;
+    /** When true, skip/close does not persist onboarding completion. */
+    isPreview?: boolean;
 }
 /**
  * Top-level onboarding modal for first-time users.
  *
  * The flow is a fixed sequence of four steps:
- *   0. Check backend
- *   1. Choose agent
+ *   0. Choose agent
+ *   1. Check backend
  *   2. Set up LLM
  *   3. Say hello (creates a fresh conversation, then closes)
  *
@@ -15,5 +19,5 @@ interface OnboardingModalProps {
  * the rail is translated horizontally by step index, so transitioning
  * between steps animates the new step in from the right.
  */
-export declare function OnboardingModal({ onClose }: OnboardingModalProps): import("react/jsx-runtime").JSX.Element;
+export declare function OnboardingModal({ onClose, initialStep, isPreview, }: OnboardingModalProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/features/onboarding/onboarding-preview.d.ts

@@ -0,0 +1,4 @@
+export declare const ONBOARDING_PREVIEW_STEP_QUERY_PARAM = "previewOnboardingStep";
+/** Reads `?previewOnboardingStep=<0-3>` for dev/design review of a single slide. */
+export declare function readOnboardingPreviewStep(search?: string): number | null;
+export declare function isOnboardingPreviewActive(search?: string): boolean;

package/dist/components/features/onboarding/steps/say-hello-step.d.ts

@@ -1,5 +1,7 @@
 interface SayHelloStepProps {
     onBack: () => void;
+    /** Dismisses onboarding without launching a conversation. */
+    onClose: () => void;
     /** Called once the conversation has been created — used by the parent
      * modal to mark the onboarding as complete before unmounting. */
     onLaunched: () => void;
@@ -9,5 +11,5 @@ interface SayHelloStepProps {
  * launches a brand-new conversation with no workspace and navigates
  * to it. Completing this step finishes the onboarding flow.
  */
-export declare function SayHelloStep({ onBack, onLaunched }: SayHelloStepProps): import("react/jsx-runtime").JSX.Element;
+export declare function SayHelloStep({ onBack, onClose, onLaunched, }: SayHelloStepProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/features/settings/llm-profiles/llm-settings-local-view.cjs

@@ -1 +1 @@
-const e=require(`../../../../_virtual/_rolldown/runtime.cjs`);require(`../../../../utils/custom-toast-handlers.cjs`),require(`../../../../api/profiles-service/profiles-service.api.cjs`),require(`../../../../hooks/query/use-llm-profiles.cjs`),require(`../../../../hooks/query/use-settings.cjs`),require(`../../../../ui/typography.cjs`),require(`../brand-button.cjs`),require(`../../../../hooks/query/use-agent-settings-schema.cjs`),require(`./profile-name-input.cjs`),require(`../../../../hooks/mutation/use-activate-llm-profile.cjs`),require(`./llm-profiles-manager.cjs`),require(`../../../../hooks/mutation/use-save-llm-profile.cjs`),require(`../../../shared/buttons/back-nav-button.cjs`),require(`../../../../contexts/settings-section-header-context.cjs`),require(`../../../../routes/llm-settings.cjs`);let t=require(`react`);t=e.__toESM(t,1),require(`react/jsx-runtime`);
+const e=require(`../../../../_virtual/_rolldown/runtime.cjs`);require(`../../../../utils/custom-toast-handlers.cjs`),require(`../../../../hooks/query/use-settings.cjs`),require(`../../../../api/profiles-service/profiles-service.api.cjs`),require(`../../../../hooks/query/use-llm-profiles.cjs`),require(`../../../../ui/typography.cjs`),require(`../brand-button.cjs`),require(`../../../../hooks/query/use-agent-settings-schema.cjs`),require(`./profile-name-input.cjs`),require(`../../../../hooks/mutation/use-activate-llm-profile.cjs`),require(`./llm-profiles-manager.cjs`),require(`../../../../hooks/mutation/use-save-llm-profile.cjs`),require(`../../../shared/buttons/back-nav-button.cjs`),require(`../../../../contexts/settings-section-header-context.cjs`),require(`../../../../routes/llm-settings.cjs`);let t=require(`react`);t=e.__toESM(t,1),require(`react/jsx-runtime`);

package/dist/components/features/settings/llm-profiles/llm-settings-local-view.js

@@ -1,7 +1,7 @@
 import "../../../../utils/custom-toast-handlers.js";
+import "../../../../hooks/query/use-settings.js";
 import "../../../../api/profiles-service/profiles-service.api.js";
 import "../../../../hooks/query/use-llm-profiles.js";
-import "../../../../hooks/query/use-settings.js";
 import "../../../../ui/typography.js";
 import "../brand-button.js";
 import "../../../../hooks/query/use-agent-settings-schema.js";

package/dist/components/features/settings/sdk-settings/sdk-section-page.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(`../../../../utils/custom-toast-handlers.cjs`),i=require(`../../../../node_modules/axios/index.cjs`),a=require(`../../../../hooks/query/use-settings.cjs`),o=require(`../../../../ui/typography.cjs`),s=require(`../brand-button.cjs`),c=require(`../../../../hooks/mutation/use-save-settings.cjs`),l=require(`../../../../utils/retrieve-axios-error-message.cjs`),u=require(`../../../../hooks/query/use-agent-settings-schema.cjs`),d=require(`../llm-settings/llm-settings-inputs-skeleton.cjs`),f=require(`../../../../utils/sdk-settings-schema.cjs`),p=require(`./schema-field.cjs`),m=require(`./view-toggle.cjs`);let h=require(`react`);h=e.__toESM(h,1);let g=require(`react/jsx-runtime`);var _=new Set,v={basic:0,advanced:1,all:2},ee=(e,t)=>v[t]<v[e]?t:e,te=(e,{showAdvanced:t,showAll:n})=>e===`all`?n?`all`:t?`advanced`:`basic`:e===`advanced`?t?`advanced`:n?`all`:`basic`:`basic`,y=(e,t)=>e instanceof i.AxiosError?e.response?.status===401?`${t} 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.`:e.response?.status===404?`${t} This backend does not expose /api/settings/* schema endpoints. Upgrade to a recent openhands-agent-server release.`:t:t;function b({sectionKeys:e,excludeKeys:i=_,scope:v=`personal`,settingsSource:b=`agent_settings`,header:ne,extraDirty:x=!1,buildPayload:S,onSaveSuccess:C,getInitialView:w,forceShowAdvancedView:re=!1,allowAllView:ie=!0,initialValueOverrides:T,embedded:E=!1,hideSaveButton:D=!1,onSaveControlChange:O,testId:ae=`sdk-section-settings-screen`}){let{t:k}=t.useTranslation(`openhands`),{mutate:oe,isPending:A}=c.useSaveSettings(v),{data:j,isLoading:se,isFetching:ce}=a.useSettings(v),le=u.useAgentSettingsSchema(j?.agent_settings_schema),ue=u.useConversationSettingsSchema(j?.conversation_settings_schema),M=b===`conversation_settings`?ue:le,N=M.data,P=M.isLoading,[F,I]=h.default.useState(`basic`),[L,R]=h.default.useState({}),[z,B]=h.default.useState({}),V=h.default.useRef(!1),H=h.default.useMemo(()=>JSON.stringify(e),[e]),U=h.default.useMemo(()=>JSON.parse(H),[H]),W=h.default.useMemo(()=>{if(!f.isValidSettingsSchema(N))return null;let e=new Set(U);return{...N,sections:N.sections.filter(t=>e.has(t.key))}},[N,U]),G=re||f.hasAdvancedSettings(W),K=ie&&f.hasMinorSettings(W),de=h.default.useMemo(()=>y(M.error,k(n.I18nKey.SETTINGS$SDK_SCHEMA_UNAVAILABLE)),[M.error,k]),fe=h.default.useMemo(()=>T?JSON.stringify(T):``,[T]),q=h.default.useMemo(()=>{if(!j||!W)return null;let e=f.buildInitialSettingsFormValues(j,W,b);return T?{...e,...T}:e},[j,W,b,fe]),J=h.default.useMemo(()=>!j||!W?null:te(w?w(j,W):f.inferInitialView(j,W,b),{showAdvanced:G,showAll:K}),[j,W,w,b,G,K]);h.default.useEffect(()=>{V.current=!1,I(`basic`),R({}),B({})},[v,b,H]),h.default.useEffect(()=>{!q||!J||(R(q),B(T?Object.fromEntries(Object.keys(T).map(e=>[e,!0])):{}),I(e=>V.current?ee(e,J):(V.current=!0,J)))},[q,J]);let pe=h.default.useMemo(()=>W?f.getVisibleSettingsSections(W,L,F,i):[],[W,L,F,i]),Y=h.default.useCallback((e,t)=>{R(n=>({...n,[e]:t})),B(t=>({...t,[e]:!0}))},[]),me=h.default.useCallback(e=>{r.displayErrorToast(l.retrieveAxiosErrorMessage(e)||k(n.I18nKey.ERROR$GENERIC))},[k]),X=h.default.useRef(()=>{}),he=h.default.useCallback(()=>{X.current()},[]),Z=h.default.useRef(()=>({})),ge=h.default.useCallback(()=>Z.current(),[]),Q=()=>{if(!W)return;let e;try{let t=f.buildSdkSettingsPayloadForView(W,L,z,F),n;n=b===`conversation_settings`?{conversation_settings_diff:t}:{agent_settings_diff:t},e=S?S(t,{values:L,dirty:z,view:F}):n}catch(e){r.displayErrorToast(e instanceof Error?e.message:k(n.I18nKey.ERROR$GENERIC));return}Object.keys(e).length!==0&&oe(e,{onError:me,onSuccess:()=>{r.displaySuccessToast(k(n.I18nKey.SETTINGS$SAVED_WARNING)),B({}),C?.()}})};X.current=Q,Z.current=()=>W?f.buildSdkSettingsPayload(W,L,z):{};let $=Object.keys(z).length>0||x;return h.default.useEffect(()=>{O&&O({save:he,isSaving:A,isDirty:$,values:L,view:F,getDirtyPayload:ge})},[A,$,L,F]),se||ce||P?(0,g.jsx)(d.LlmSettingsInputsSkeleton,{}):!W||W.sections.length===0?(0,g.jsx)(o.Typography.Paragraph,{className:`text-tertiary-alt`,children:de}):Object.keys(L).length===0?(0,g.jsx)(d.LlmSettingsInputsSkeleton,{}):(0,g.jsxs)(`div`,{"data-testid":ae,className:E?`relative flex min-h-0 w-full flex-1 flex-col`:`relative w-full min-h-0`,children:[(0,g.jsx)(m.ViewToggle,{view:F,setView:I,showAdvanced:G,showAll:K,isDisabled:!1}),(0,g.jsxs)(`div`,{className:`flex flex-col gap-8`,children:[ne?.({values:L,isDisabled:!1,view:F,onChange:Y}),pe.map((e,t)=>(0,g.jsx)(`section`,{className:`flex flex-col gap-4`,children:(0,g.jsx)(`div`,{className:`flex flex-col gap-4`,children:e.fields.map(e=>(0,g.jsx)(p.SchemaField,{field:e,value:L[e.key],isDisabled:!1,onChange:t=>Y(e.key,t)},e.key))})},`${e.key}-${t}`)),D?null:(0,g.jsx)(`div`,{className:`flex justify-start pt-2`,children:(0,g.jsx)(s.BrandButton,{testId:`save-button`,type:`button`,variant:`primary`,isDisabled:A||Object.keys(z).length===0&&!x,onClick:Q,children:k(A?n.I18nKey.SETTINGS$SAVING:n.I18nKey.SETTINGS$SAVE_CHANGES)})})]})]})}exports.SdkSectionPage=b;
+const e=require(`../../../../_virtual/_rolldown/runtime.cjs`),t=require(`../../../../node_modules/react-i18next/dist/es/useTranslation.cjs`),n=require(`../../../../i18n/declaration.cjs`),r=require(`../../../../utils/custom-toast-handlers.cjs`),i=require(`../../../../node_modules/axios/index.cjs`),ee=require(`../../../../hooks/query/use-settings.cjs`),a=require(`../../../../ui/typography.cjs`),o=require(`../brand-button.cjs`),te=require(`../../../../hooks/mutation/use-save-settings.cjs`),ne=require(`../../../../utils/retrieve-axios-error-message.cjs`),s=require(`../../../../hooks/query/use-agent-settings-schema.cjs`),c=require(`../llm-settings/llm-settings-inputs-skeleton.cjs`),l=require(`../../../../utils/sdk-settings-schema.cjs`),u=require(`./schema-field.cjs`),d=require(`./view-toggle.cjs`);let f=require(`react`);f=e.__toESM(f,1);let p=require(`react/jsx-runtime`);var re=new Set,m={basic:0,advanced:1,all:2},ie=(e,t)=>m[t]<m[e]?t:e,h=(e,{showAdvanced:t,showAll:n})=>e===`all`?n?`all`:t?`advanced`:`basic`:e===`advanced`?t?`advanced`:n?`all`:`basic`:`basic`,g=(e,t)=>e instanceof i.AxiosError?e.response?.status===401?`${t} 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.`:e.response?.status===404?`${t} This backend does not expose /api/settings/* schema endpoints. Upgrade to a recent openhands-agent-server release.`:t:t;function _({sectionKeys:e,excludeKeys:i=re,scope:m=`personal`,settingsSource:_=`agent_settings`,header:v,extraDirty:y=!1,buildPayload:b,onSaveSuccess:x,getInitialView:S,forceShowAdvancedView:C=!1,allowAllView:ae=!0,initialValueOverrides:w,embedded:oe=!1,hideSaveButton:se=!1,suppressSuccessToast:ce=!1,onSaveControlChange:T,testId:le=`sdk-section-settings-screen`}){let{t:E}=t.useTranslation(`openhands`),{mutate:ue,isPending:D}=te.useSaveSettings(m),{data:O,isLoading:de,isFetching:fe}=ee.useSettings(m),k=s.useAgentSettingsSchema(O?.agent_settings_schema),A=s.useConversationSettingsSchema(O?.conversation_settings_schema),j=_===`conversation_settings`?A:k,M=j.data,N=j.isLoading,[P,F]=f.default.useState(`basic`),[I,L]=f.default.useState({}),[R,z]=f.default.useState({}),B=f.default.useRef(!1),V=f.default.useMemo(()=>JSON.stringify(e),[e]),H=f.default.useMemo(()=>JSON.parse(V),[V]),U=f.default.useMemo(()=>{if(!l.isValidSettingsSchema(M))return null;let e=new Set(H);return{...M,sections:M.sections.filter(t=>e.has(t.key))}},[M,H]),W=C||l.hasAdvancedSettings(U),G=ae&&l.hasMinorSettings(U),pe=f.default.useMemo(()=>g(j.error,E(n.I18nKey.SETTINGS$SDK_SCHEMA_UNAVAILABLE)),[j.error,E]),me=f.default.useMemo(()=>w?JSON.stringify(w):``,[w]),K=f.default.useMemo(()=>{if(!O||!U)return null;let e=l.buildInitialSettingsFormValues(O,U,_);return w?{...e,...w}:e},[O,U,_,me]),q=f.default.useMemo(()=>!O||!U?null:h(S?S(O,U):l.inferInitialView(O,U,_),{showAdvanced:W,showAll:G}),[O,U,S,_,W,G]);f.default.useEffect(()=>{B.current=!1,F(`basic`),L({}),z({})},[m,_,V]),f.default.useEffect(()=>{!K||!q||(L(K),z(w?Object.fromEntries(Object.keys(w).map(e=>[e,!0])):{}),F(e=>B.current?ie(e,q):(B.current=!0,q)))},[K,q]);let he=f.default.useMemo(()=>U?l.getVisibleSettingsSections(U,I,P,i):[],[U,I,P,i]),J=f.default.useCallback((e,t)=>{L(n=>({...n,[e]:t})),z(t=>({...t,[e]:!0}))},[]),ge=f.default.useCallback(e=>{r.displayErrorToast(ne.retrieveAxiosErrorMessage(e)||E(n.I18nKey.ERROR$GENERIC))},[E]),Y=f.default.useRef(()=>{}),X=f.default.useCallback(()=>{Y.current()},[]),Z=f.default.useRef(()=>({})),_e=f.default.useCallback(()=>Z.current(),[]),Q=()=>{if(!U)return;let e;try{let t=l.buildSdkSettingsPayloadForView(U,I,R,P),n;n=_===`conversation_settings`?{conversation_settings_diff:t}:{agent_settings_diff:t},e=b?b(t,{values:I,dirty:R,view:P}):n}catch(e){r.displayErrorToast(e instanceof Error?e.message:E(n.I18nKey.ERROR$GENERIC));return}Object.keys(e).length!==0&&ue(e,{onError:ge,onSuccess:()=>{ce||r.displaySuccessToast(E(n.I18nKey.SETTINGS$SAVED_WARNING)),z({}),x?.()}})};Y.current=Q,Z.current=()=>U?l.buildSdkSettingsPayload(U,I,R):{};let $=Object.keys(R).length>0||y;return f.default.useEffect(()=>{T&&T({save:X,isSaving:D,isDirty:$,values:I,view:P,getDirtyPayload:_e})},[D,$,I,P]),(de||fe)&&!O||N?(0,p.jsx)(c.LlmSettingsInputsSkeleton,{}):!U||U.sections.length===0?(0,p.jsx)(a.Typography.Paragraph,{className:`text-tertiary-alt`,children:pe}):Object.keys(I).length===0?(0,p.jsx)(c.LlmSettingsInputsSkeleton,{}):(0,p.jsxs)(`div`,{"data-testid":le,className:oe?`relative flex min-h-0 w-full flex-1 flex-col`:`relative w-full min-h-0`,children:[(0,p.jsx)(d.ViewToggle,{view:P,setView:F,showAdvanced:W,showAll:G,isDisabled:!1}),(0,p.jsxs)(`div`,{className:`flex flex-col gap-8`,children:[v?.({values:I,isDisabled:!1,view:P,onChange:J}),he.map((e,t)=>(0,p.jsx)(`section`,{className:`flex flex-col gap-4`,children:(0,p.jsx)(`div`,{className:`flex flex-col gap-4`,children:e.fields.map(e=>(0,p.jsx)(u.SchemaField,{field:e,value:I[e.key],isDisabled:!1,onChange:t=>J(e.key,t)},e.key))})},`${e.key}-${t}`)),se?null:(0,p.jsx)(`div`,{className:`flex justify-start pt-2`,children:(0,p.jsx)(o.BrandButton,{testId:`save-button`,type:`button`,variant:`primary`,isDisabled:D||Object.keys(R).length===0&&!y,onClick:Q,children:E(D?n.I18nKey.SETTINGS$SAVING:n.I18nKey.SETTINGS$SAVE_CHANGES)})})]})]})}exports.SdkSectionPage=_;
 //# sourceMappingURL=sdk-section-page.cjs.map

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 { Typography } from \"#/ui/typography\";\nimport { Settings, SettingsSchema, SettingsScope } from \"#/types/settings\";\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  hasMinorSettings,\n  inferInitialView,\n  isValidSettingsSchema,\n  SettingsDirtyState,\n  SettingsFormValues,\n  type SettingsValueSource,\n  type SettingsView,\n} from \"#/utils/sdk-settings-schema\";\nimport { 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 normalizeView = (\n  view: SettingsView,\n  {\n    showAdvanced,\n    showAll,\n  }: {\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  return \"basic\";\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 SdkSectionHeaderProps {\n  values: SettingsFormValues;\n  isDisabled: boolean;\n  view: SettingsView;\n  onChange: (key: string, value: string | boolean) => void;\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\n * from one or more schema sections.\n *\n * @param sectionKeys - which schema section(s) this page owns (e.g. [\"condenser\"])\n * @param excludeKeys - field keys to skip (rendered elsewhere by the caller)\n * @param header      - optional render prop receiving shared state to render above fields\n * @param testId      - data-testid for the page wrapper\n */\nexport function SdkSectionPage({\n  sectionKeys,\n  excludeKeys = EMPTY_EXCLUDE_KEYS,\n  scope = \"personal\",\n  settingsSource = \"agent_settings\",\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  onSaveControlChange,\n  testId = \"sdk-section-settings-screen\",\n}: {\n  sectionKeys: string[];\n  excludeKeys?: Set<string>;\n  scope?: SettingsScope;\n  settingsSource?: SettingsValueSource;\n\n  header?: (props: SdkSectionHeaderProps) => React.ReactNode;\n  extraDirty?: boolean;\n  buildPayload?: (\n    payload: ReturnType<typeof buildSdkSettingsPayloadForView>,\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  /**\n   * When true, the Save button container is rendered inline (no\n   * sticky positioning, no contrasting `bg-base` band) so the page\n   * can be dropped into a modal/card without a hard footer break.\n   */\n  embedded?: boolean;\n  /**\n   * Suppress the built-in Save Changes button entirely. Pair with\n   * {@link onSaveControlChange} to drive saving from a parent-rendered\n   * action (e.g. an onboarding \"Next\" button).\n   */\n  hideSaveButton?: 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 activeSchemaQuery =\n    settingsSource === \"conversation_settings\"\n      ? conversationSchemaQuery\n      : agentSchemaQuery;\n  const schema = activeSchemaQuery.data;\n  const isSchemaLoading = activeSchemaQuery.isLoading;\n  const isReadOnly = false;\n\n  const [view, setView] = React.useState<SettingsView>(\"basic\");\n  const [values, setValues] = React.useState<SettingsFormValues>({});\n  const [dirty, setDirty] = React.useState<SettingsDirtyState>({});\n  const hasHydratedViewRef = React.useRef(false);\n\n  const sectionKeysSignature = React.useMemo(\n    () => JSON.stringify(sectionKeys),\n    [sectionKeys],\n  );\n  const stableSectionKeys = React.useMemo(\n    () => JSON.parse(sectionKeysSignature) as string[],\n    [sectionKeysSignature],\n  );\n\n  // Build a filtered schema containing only the requested sections.\n  // `isValidSettingsSchema` guards against truthy-but-malformed schema\n  // responses (e.g. when the deployment is pointed at a host that does\n  // not serve `/api/settings/agent-schema` and returns an SPA shell\n  // that parses into an object without a `sections` array). Without\n  // the guard, `schema.sections.filter(...)` would throw and React\n  // Router would escalate the crash to a full-screen error.\n  const filteredSchema = React.useMemo(() => {\n    if (!isValidSettingsSchema(schema)) return null;\n    const sectionSet = new Set(stableSectionKeys);\n    return {\n      ...schema,\n      sections: schema.sections.filter((s) => sectionSet.has(s.key)),\n    };\n  }, [schema, stableSectionKeys]);\n\n  const showAdvanced =\n    forceShowAdvancedView || hasAdvancedSettings(filteredSchema);\n  const showAll = allowAllView && hasMinorSettings(filteredSchema);\n  const schemaUnavailableMessage = React.useMemo(\n    () =>\n      getSchemaUnavailableMessage(\n        activeSchemaQuery.error,\n        t(I18nKey.SETTINGS$SDK_SCHEMA_UNAVAILABLE),\n      ),\n    [activeSchemaQuery.error, t],\n  );\n\n  const overridesSignature = React.useMemo(\n    () => (initialValueOverrides ? JSON.stringify(initialValueOverrides) : \"\"),\n    [initialValueOverrides],\n  );\n\n  const initialValues = React.useMemo(() => {\n    if (!settings || !filteredSchema) return null;\n    const base = buildInitialSettingsFormValues(\n      settings,\n      filteredSchema,\n      settingsSource,\n    );\n    if (!initialValueOverrides) return base;\n    return { ...base, ...initialValueOverrides };\n    // overridesSignature keeps the memo reactive without depending on\n    // a (potentially recreated) object reference each render.\n  }, [settings, filteredSchema, settingsSource, overridesSignature]);\n\n  const initialView = React.useMemo(() => {\n    if (!settings || !filteredSchema) return null;\n\n    const resolvedInitialView = getInitialView\n      ? getInitialView(settings, filteredSchema)\n      : inferInitialView(settings, filteredSchema, settingsSource);\n\n    return normalizeView(resolvedInitialView, { showAdvanced, showAll });\n  }, [\n    settings,\n    filteredSchema,\n    getInitialView,\n    settingsSource,\n    showAdvanced,\n    showAll,\n  ]);\n\n  React.useEffect(() => {\n    hasHydratedViewRef.current = false;\n    setView(\"basic\");\n    setValues({});\n    setDirty({});\n  }, [scope, settingsSource, sectionKeysSignature]);\n\n  React.useEffect(() => {\n    if (!initialValues || !initialView) return;\n\n    setValues(initialValues);\n    // Override-supplied keys are pre-populated for the user, so mark\n    // them dirty up-front; otherwise the Save button stays disabled\n    // until the user touches a field, defeating the point of the\n    // override.\n    const overrideDirty: SettingsDirtyState = initialValueOverrides\n      ? Object.fromEntries(\n          Object.keys(initialValueOverrides).map((key) => [key, true]),\n        )\n      : {};\n    setDirty(overrideDirty);\n    setView((currentView) => {\n      if (!hasHydratedViewRef.current) {\n        hasHydratedViewRef.current = true;\n        return initialView;\n      }\n\n      return getLessDetailedView(currentView, initialView);\n    });\n    // initialValueOverrides is intentionally tracked via\n    // overridesSignature on initialValues; including the object ref\n    // here would re-fire the effect every render.\n  }, [initialValues, initialView]);\n\n  const visibleSections = React.useMemo(() => {\n    if (!filteredSchema) return [];\n    return getVisibleSettingsSections(\n      filteredSchema,\n      values,\n      view,\n      excludeKeys,\n    );\n  }, [filteredSchema, values, view, excludeKeys]);\n\n  const handleFieldChange = React.useCallback(\n    (fieldKey: string, nextValue: string | boolean) => {\n      setValues((prev) => ({ ...prev, [fieldKey]: nextValue }));\n      setDirty((prev) => ({ ...prev, [fieldKey]: true }));\n    },\n    [],\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  // Stable save callback so `onSaveControlChange` can hand a single\n  // function reference to the parent across renders. The latest\n  // closure is kept up to date via `handleSaveRef`.\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 (!filteredSchema || isReadOnly) return;\n\n    let payload: Record<string, unknown>;\n    try {\n      const basePayload = buildSdkSettingsPayloadForView(\n        filteredSchema,\n        values,\n        dirty,\n        view,\n      );\n      let defaultPayload: Record<string, unknown>;\n      if (settingsSource === \"conversation_settings\") {\n        defaultPayload = { conversation_settings_diff: basePayload };\n      } else {\n        defaultPayload = { agent_settings_diff: basePayload };\n      }\n      payload = buildPayload\n        ? buildPayload(basePayload, { values, dirty, view })\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        displaySuccessToast(t(I18nKey.SETTINGS$SAVED_WARNING));\n        setDirty({});\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.\n  buildDirtyPayloadRef.current = () =>\n    filteredSchema\n      ? buildSdkSettingsPayload(filteredSchema, values, dirty)\n      : {};\n\n  // Surface save state to the parent. Hooks must run before any\n  // conditional early-returns below, so this lives here rather than\n  // alongside the JSX. The dependency list deliberately excludes\n  // `stableSave` (it never changes) and `onSaveControlChange` (we\n  // tolerate ref-instability of the callback to avoid spamming the\n  // parent on every render).\n  const saveControlIsDirty = Object.keys(dirty).length > 0 || extraDirty;\n  React.useEffect(() => {\n    if (!onSaveControlChange) return;\n    onSaveControlChange({\n      save: stableSave,\n      isSaving: isPending,\n      isDirty: saveControlIsDirty,\n      values,\n      view,\n      getDirtyPayload: stableGetDirtyPayload,\n    });\n  }, [isPending, saveControlIsDirty, values, view]);\n\n  if (isLoading || isFetching || isSchemaLoading) {\n    return <LlmSettingsInputsSkeleton />;\n  }\n\n  if (!filteredSchema || filteredSchema.sections.length === 0) {\n    return (\n      <Typography.Paragraph className=\"text-tertiary-alt\">\n        {schemaUnavailableMessage}\n      </Typography.Paragraph>\n    );\n  }\n\n  if (Object.keys(values).length === 0) return <LlmSettingsInputsSkeleton />;\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        showAdvanced={showAdvanced}\n        showAll={showAll}\n        isDisabled={isReadOnly}\n      />\n\n      <div className={bodyClassName}>\n        {header?.({\n          values,\n          isDisabled: isReadOnly,\n          view,\n          onChange: handleFieldChange,\n        })}\n\n        {visibleSections.map((section, sectionIndex) => (\n          <section\n            key={`${section.key}-${sectionIndex}`}\n            className=\"flex flex-col gap-4\"\n          >\n            <div className=\"flex flex-col gap-4\">\n              {section.fields.map((field) => (\n                <SchemaField\n                  key={field.key}\n                  field={field}\n                  value={values[field.key]}\n                  isDisabled={isReadOnly}\n                  onChange={(nextValue) =>\n                    handleFieldChange(field.key, nextValue)\n                  }\n                />\n              ))}\n            </div>\n          </section>\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={\n                isPending || (Object.keys(dirty).length === 0 && !extraDirty)\n              }\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 { Typography } from \"#/ui/typography\";\nimport { Settings, SettingsSchema, SettingsScope } from \"#/types/settings\";\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  hasMinorSettings,\n  inferInitialView,\n  isValidSettingsSchema,\n  SettingsDirtyState,\n  SettingsFormValues,\n  type SettingsValueSource,\n  type SettingsView,\n} from \"#/utils/sdk-settings-schema\";\nimport { 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 normalizeView = (\n  view: SettingsView,\n  {\n    showAdvanced,\n    showAll,\n  }: {\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  return \"basic\";\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 SdkSectionHeaderProps {\n  values: SettingsFormValues;\n  isDisabled: boolean;\n  view: SettingsView;\n  onChange: (key: string, value: string | boolean) => void;\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\n * from one or more schema sections.\n *\n * @param sectionKeys - which schema section(s) this page owns (e.g. [\"condenser\"])\n * @param excludeKeys - field keys to skip (rendered elsewhere by the caller)\n * @param header      - optional render prop receiving shared state to render above fields\n * @param testId      - data-testid for the page wrapper\n */\nexport function SdkSectionPage({\n  sectionKeys,\n  excludeKeys = EMPTY_EXCLUDE_KEYS,\n  scope = \"personal\",\n  settingsSource = \"agent_settings\",\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  sectionKeys: string[];\n  excludeKeys?: Set<string>;\n  scope?: SettingsScope;\n  settingsSource?: SettingsValueSource;\n\n  header?: (props: SdkSectionHeaderProps) => React.ReactNode;\n  extraDirty?: boolean;\n  buildPayload?: (\n    payload: ReturnType<typeof buildSdkSettingsPayloadForView>,\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  /**\n   * When true, the Save button container is rendered inline (no\n   * sticky positioning, no contrasting `bg-base` band) so the page\n   * can be dropped into a modal/card without a hard footer break.\n   */\n  embedded?: boolean;\n  /**\n   * Suppress the built-in Save Changes button entirely. Pair with\n   * {@link onSaveControlChange} to drive saving from a parent-rendered\n   * action (e.g. an onboarding \"Next\" button).\n   */\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 activeSchemaQuery =\n    settingsSource === \"conversation_settings\"\n      ? conversationSchemaQuery\n      : agentSchemaQuery;\n  const schema = activeSchemaQuery.data;\n  const isSchemaLoading = activeSchemaQuery.isLoading;\n  const isReadOnly = false;\n\n  const [view, setView] = React.useState<SettingsView>(\"basic\");\n  const [values, setValues] = React.useState<SettingsFormValues>({});\n  const [dirty, setDirty] = React.useState<SettingsDirtyState>({});\n  const hasHydratedViewRef = React.useRef(false);\n\n  const sectionKeysSignature = React.useMemo(\n    () => JSON.stringify(sectionKeys),\n    [sectionKeys],\n  );\n  const stableSectionKeys = React.useMemo(\n    () => JSON.parse(sectionKeysSignature) as string[],\n    [sectionKeysSignature],\n  );\n\n  // Build a filtered schema containing only the requested sections.\n  // `isValidSettingsSchema` guards against truthy-but-malformed schema\n  // responses (e.g. when the deployment is pointed at a host that does\n  // not serve `/api/settings/agent-schema` and returns an SPA shell\n  // that parses into an object without a `sections` array). Without\n  // the guard, `schema.sections.filter(...)` would throw and React\n  // Router would escalate the crash to a full-screen error.\n  const filteredSchema = React.useMemo(() => {\n    if (!isValidSettingsSchema(schema)) return null;\n    const sectionSet = new Set(stableSectionKeys);\n    return {\n      ...schema,\n      sections: schema.sections.filter((s) => sectionSet.has(s.key)),\n    };\n  }, [schema, stableSectionKeys]);\n\n  const showAdvanced =\n    forceShowAdvancedView || hasAdvancedSettings(filteredSchema);\n  const showAll = allowAllView && hasMinorSettings(filteredSchema);\n  const schemaUnavailableMessage = React.useMemo(\n    () =>\n      getSchemaUnavailableMessage(\n        activeSchemaQuery.error,\n        t(I18nKey.SETTINGS$SDK_SCHEMA_UNAVAILABLE),\n      ),\n    [activeSchemaQuery.error, t],\n  );\n\n  const overridesSignature = React.useMemo(\n    () => (initialValueOverrides ? JSON.stringify(initialValueOverrides) : \"\"),\n    [initialValueOverrides],\n  );\n\n  const initialValues = React.useMemo(() => {\n    if (!settings || !filteredSchema) return null;\n    const base = buildInitialSettingsFormValues(\n      settings,\n      filteredSchema,\n      settingsSource,\n    );\n    if (!initialValueOverrides) return base;\n    return { ...base, ...initialValueOverrides };\n    // overridesSignature keeps the memo reactive without depending on\n    // a (potentially recreated) object reference each render.\n  }, [settings, filteredSchema, settingsSource, overridesSignature]);\n\n  const initialView = React.useMemo(() => {\n    if (!settings || !filteredSchema) return null;\n\n    const resolvedInitialView = getInitialView\n      ? getInitialView(settings, filteredSchema)\n      : inferInitialView(settings, filteredSchema, settingsSource);\n\n    return normalizeView(resolvedInitialView, { showAdvanced, showAll });\n  }, [\n    settings,\n    filteredSchema,\n    getInitialView,\n    settingsSource,\n    showAdvanced,\n    showAll,\n  ]);\n\n  React.useEffect(() => {\n    hasHydratedViewRef.current = false;\n    setView(\"basic\");\n    setValues({});\n    setDirty({});\n  }, [scope, settingsSource, sectionKeysSignature]);\n\n  React.useEffect(() => {\n    if (!initialValues || !initialView) return;\n\n    setValues(initialValues);\n    // Override-supplied keys are pre-populated for the user, so mark\n    // them dirty up-front; otherwise the Save button stays disabled\n    // until the user touches a field, defeating the point of the\n    // override.\n    const overrideDirty: SettingsDirtyState = initialValueOverrides\n      ? Object.fromEntries(\n          Object.keys(initialValueOverrides).map((key) => [key, true]),\n        )\n      : {};\n    setDirty(overrideDirty);\n    setView((currentView) => {\n      if (!hasHydratedViewRef.current) {\n        hasHydratedViewRef.current = true;\n        return initialView;\n      }\n\n      return getLessDetailedView(currentView, initialView);\n    });\n    // initialValueOverrides is intentionally tracked via\n    // overridesSignature on initialValues; including the object ref\n    // here would re-fire the effect every render.\n  }, [initialValues, initialView]);\n\n  const visibleSections = React.useMemo(() => {\n    if (!filteredSchema) return [];\n    return getVisibleSettingsSections(\n      filteredSchema,\n      values,\n      view,\n      excludeKeys,\n    );\n  }, [filteredSchema, values, view, excludeKeys]);\n\n  const handleFieldChange = React.useCallback(\n    (fieldKey: string, nextValue: string | boolean) => {\n      setValues((prev) => ({ ...prev, [fieldKey]: nextValue }));\n      setDirty((prev) => ({ ...prev, [fieldKey]: true }));\n    },\n    [],\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  // Stable save callback so `onSaveControlChange` can hand a single\n  // function reference to the parent across renders. The latest\n  // closure is kept up to date via `handleSaveRef`.\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 (!filteredSchema || isReadOnly) return;\n\n    let payload: Record<string, unknown>;\n    try {\n      const basePayload = buildSdkSettingsPayloadForView(\n        filteredSchema,\n        values,\n        dirty,\n        view,\n      );\n      let defaultPayload: Record<string, unknown>;\n      if (settingsSource === \"conversation_settings\") {\n        defaultPayload = { conversation_settings_diff: basePayload };\n      } else {\n        defaultPayload = { agent_settings_diff: basePayload };\n      }\n      payload = buildPayload\n        ? buildPayload(basePayload, { values, dirty, view })\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        setDirty({});\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.\n  buildDirtyPayloadRef.current = () =>\n    filteredSchema\n      ? buildSdkSettingsPayload(filteredSchema, values, dirty)\n      : {};\n\n  // Surface save state to the parent. Hooks must run before any\n  // conditional early-returns below, so this lives here rather than\n  // alongside the JSX. The dependency list deliberately excludes\n  // `stableSave` (it never changes) and `onSaveControlChange` (we\n  // tolerate ref-instability of the callback to avoid spamming the\n  // parent on every render).\n  const saveControlIsDirty = Object.keys(dirty).length > 0 || extraDirty;\n  React.useEffect(() => {\n    if (!onSaveControlChange) return;\n    onSaveControlChange({\n      save: stableSave,\n      isSaving: isPending,\n      isDirty: saveControlIsDirty,\n      values,\n      view,\n      getDirtyPayload: stableGetDirtyPayload,\n    });\n  }, [isPending, saveControlIsDirty, values, 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  if (!filteredSchema || filteredSchema.sections.length === 0) {\n    return (\n      <Typography.Paragraph className=\"text-tertiary-alt\">\n        {schemaUnavailableMessage}\n      </Typography.Paragraph>\n    );\n  }\n\n  if (Object.keys(values).length === 0) return <LlmSettingsInputsSkeleton />;\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        showAdvanced={showAdvanced}\n        showAll={showAll}\n        isDisabled={isReadOnly}\n      />\n\n      <div className={bodyClassName}>\n        {header?.({\n          values,\n          isDisabled: isReadOnly,\n          view,\n          onChange: handleFieldChange,\n        })}\n\n        {visibleSections.map((section, sectionIndex) => (\n          <section\n            key={`${section.key}-${sectionIndex}`}\n            className=\"flex flex-col gap-4\"\n          >\n            <div className=\"flex flex-col gap-4\">\n              {section.fields.map((field) => (\n                <SchemaField\n                  key={field.key}\n                  field={field}\n                  value={values[field.key]}\n                  isDisabled={isReadOnly}\n                  onChange={(nextValue) =>\n                    handleFieldChange(field.key, nextValue)\n                  }\n                />\n              ))}\n            </div>\n          </section>\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={\n                isPending || (Object.keys(dirty).length === 0 && !extraDirty)\n              }\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

@@ -41,7 +41,7 @@ export interface SdkSectionSaveControl {
  * @param header      - optional render prop receiving shared state to render above fields
  * @param testId      - data-testid for the page wrapper
  */
-export declare function SdkSectionPage({ sectionKeys, excludeKeys, scope, settingsSource, header, extraDirty, buildPayload, onSaveSuccess, getInitialView, forceShowAdvancedView, allowAllView, initialValueOverrides, embedded, hideSaveButton, onSaveControlChange, testId, }: {
+export declare function SdkSectionPage({ sectionKeys, excludeKeys, scope, settingsSource, header, extraDirty, buildPayload, onSaveSuccess, getInitialView, forceShowAdvancedView, allowAllView, initialValueOverrides, embedded, hideSaveButton, suppressSuccessToast, onSaveControlChange, testId, }: {
     sectionKeys: string[];
     excludeKeys?: Set<string>;
     scope?: SettingsScope;
@@ -78,6 +78,8 @@ export declare function SdkSectionPage({ sectionKeys, excludeKeys, scope, settin
      * action (e.g. an onboarding "Next" button).
      */
     hideSaveButton?: boolean;
+    /** Suppress the default success toast after save completes. */
+    suppressSuccessToast?: boolean;
     /**
      * Fires whenever the save state changes (a mutation starts/finishes,
      * dirty status flips). Provides a stable `save()` callback the

package/dist/components/features/settings/sdk-settings/sdk-section-page.js

@@ -3,69 +3,69 @@ import { I18nKey as t } from "../../../../i18n/declaration.js";
 import { displayErrorToast as n, displaySuccessToast as ee } from "../../../../utils/custom-toast-handlers.js";
 import { AxiosError as r } from "../../../../node_modules/axios/index.js";
 import { useSettings as te } from "../../../../hooks/query/use-settings.js";
-import { Typography as i } from "../../../../ui/typography.js";
-import { BrandButton as ne } from "../brand-button.js";
-import { useSaveSettings as re } from "../../../../hooks/mutation/use-save-settings.js";
+import { Typography as ne } from "../../../../ui/typography.js";
+import { BrandButton as re } from "../brand-button.js";
+import { useSaveSettings as i } from "../../../../hooks/mutation/use-save-settings.js";
 import { retrieveAxiosErrorMessage as ie } from "../../../../utils/retrieve-axios-error-message.js";
-import { useAgentSettingsSchema as a, useConversationSettingsSchema as o } from "../../../../hooks/query/use-agent-settings-schema.js";
-import { LlmSettingsInputsSkeleton as s } from "../llm-settings/llm-settings-inputs-skeleton.js";
-import { buildInitialSettingsFormValues as c, buildSdkSettingsPayload as l, buildSdkSettingsPayloadForView as ae, getVisibleSettingsSections as oe, hasAdvancedSettings as se, hasMinorSettings as ce, inferInitialView as le, isValidSettingsSchema as ue } from "../../../../utils/sdk-settings-schema.js";
-import { SchemaField as u } from "./schema-field.js";
-import { ViewToggle as de } from "./view-toggle.js";
-import d from "react";
-import { jsx as f, jsxs as p } from "react/jsx-runtime";
+import { useAgentSettingsSchema as ae, useConversationSettingsSchema as a } from "../../../../hooks/query/use-agent-settings-schema.js";
+import { LlmSettingsInputsSkeleton as o } from "../llm-settings/llm-settings-inputs-skeleton.js";
+import { buildInitialSettingsFormValues as s, buildSdkSettingsPayload as c, buildSdkSettingsPayloadForView as l, getVisibleSettingsSections as oe, hasAdvancedSettings as se, hasMinorSettings as ce, inferInitialView as le, isValidSettingsSchema as ue } from "../../../../utils/sdk-settings-schema.js";
+import { SchemaField as de } from "./schema-field.js";
+import { ViewToggle as fe } from "./view-toggle.js";
+import u from "react";
+import { jsx as d, jsxs as f } from "react/jsx-runtime";
 //#region src/components/features/settings/sdk-settings/sdk-section-page.tsx
-var fe = /* @__PURE__ */ new Set(), m = {
+var pe = /* @__PURE__ */ new Set(), p = {
 	basic: 0,
 	advanced: 1,
 	all: 2
-}, h = (e, t) => m[t] < m[e] ? t : e, pe = (e, { showAdvanced: t, showAll: n }) => e === "all" ? n ? "all" : t ? "advanced" : "basic" : e === "advanced" ? t ? "advanced" : n ? "all" : "basic" : "basic", me = (e, t) => e instanceof r ? e.response?.status === 401 ? `${t} 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.` : e.response?.status === 404 ? `${t} This backend does not expose /api/settings/* schema endpoints. Upgrade to a recent openhands-agent-server release.` : t : t;
-function g({ sectionKeys: r, excludeKeys: m = fe, scope: g = "personal", settingsSource: _ = "agent_settings", header: he, extraDirty: v = !1, buildPayload: y, onSaveSuccess: ge, getInitialView: b, forceShowAdvancedView: _e = !1, allowAllView: ve = !0, initialValueOverrides: x, embedded: ye = !1, hideSaveButton: S = !1, onSaveControlChange: C, testId: w = "sdk-section-settings-screen" }) {
-	let { t: T } = e("openhands"), { mutate: E, isPending: D } = re(g), { data: O, isLoading: k, isFetching: A } = te(g), j = a(O?.agent_settings_schema), M = o(O?.conversation_settings_schema), N = _ === "conversation_settings" ? M : j, P = N.data, be = N.isLoading, [F, I] = d.useState("basic"), [L, R] = d.useState({}), [z, B] = d.useState({}), V = d.useRef(!1), H = d.useMemo(() => JSON.stringify(r), [r]), U = d.useMemo(() => JSON.parse(H), [H]), W = d.useMemo(() => {
+}, me = (e, t) => p[t] < p[e] ? t : e, he = (e, { showAdvanced: t, showAll: n }) => e === "all" ? n ? "all" : t ? "advanced" : "basic" : e === "advanced" ? t ? "advanced" : n ? "all" : "basic" : "basic", m = (e, t) => e instanceof r ? e.response?.status === 401 ? `${t} 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.` : e.response?.status === 404 ? `${t} This backend does not expose /api/settings/* schema endpoints. Upgrade to a recent openhands-agent-server release.` : t : t;
+function h({ sectionKeys: r, excludeKeys: p = pe, scope: h = "personal", settingsSource: g = "agent_settings", header: ge, extraDirty: _ = !1, buildPayload: v, onSaveSuccess: _e, getInitialView: y, forceShowAdvancedView: ve = !1, allowAllView: ye = !0, initialValueOverrides: b, embedded: be = !1, hideSaveButton: x = !1, suppressSuccessToast: S = !1, onSaveControlChange: C, testId: w = "sdk-section-settings-screen" }) {
+	let { t: T } = e("openhands"), { mutate: E, isPending: D } = i(h), { data: O, isLoading: k, isFetching: A } = te(h), j = ae(O?.agent_settings_schema), M = a(O?.conversation_settings_schema), N = g === "conversation_settings" ? M : j, P = N.data, xe = N.isLoading, [F, I] = u.useState("basic"), [L, R] = u.useState({}), [z, B] = u.useState({}), V = u.useRef(!1), H = u.useMemo(() => JSON.stringify(r), [r]), U = u.useMemo(() => JSON.parse(H), [H]), W = u.useMemo(() => {
 		if (!ue(P)) return null;
 		let e = new Set(U);
 		return {
 			...P,
 			sections: P.sections.filter((t) => e.has(t.key))
 		};
-	}, [P, U]), G = _e || se(W), K = ve && ce(W), xe = d.useMemo(() => me(N.error, T(t.SETTINGS$SDK_SCHEMA_UNAVAILABLE)), [N.error, T]), Se = d.useMemo(() => x ? JSON.stringify(x) : "", [x]), q = d.useMemo(() => {
+	}, [P, U]), G = ve || se(W), K = ye && ce(W), Se = u.useMemo(() => m(N.error, T(t.SETTINGS$SDK_SCHEMA_UNAVAILABLE)), [N.error, T]), Ce = u.useMemo(() => b ? JSON.stringify(b) : "", [b]), q = u.useMemo(() => {
 		if (!O || !W) return null;
-		let e = c(O, W, _);
-		return x ? {
+		let e = s(O, W, g);
+		return b ? {
 			...e,
-			...x
+			...b
 		} : e;
 	}, [
 		O,
 		W,
-		_,
-		Se
-	]), J = d.useMemo(() => !O || !W ? null : pe(b ? b(O, W) : le(O, W, _), {
+		g,
+		Ce
+	]), J = u.useMemo(() => !O || !W ? null : he(y ? y(O, W) : le(O, W, g), {
 		showAdvanced: G,
 		showAll: K
 	}), [
 		O,
 		W,
-		b,
-		_,
+		y,
+		g,
 		G,
 		K
 	]);
-	d.useEffect(() => {
+	u.useEffect(() => {
 		V.current = !1, I("basic"), R({}), B({});
 	}, [
+		h,
 		g,
-		_,
 		H
-	]), d.useEffect(() => {
-		!q || !J || (R(q), B(x ? Object.fromEntries(Object.keys(x).map((e) => [e, !0])) : {}), I((e) => V.current ? h(e, J) : (V.current = !0, J)));
+	]), u.useEffect(() => {
+		!q || !J || (R(q), B(b ? Object.fromEntries(Object.keys(b).map((e) => [e, !0])) : {}), I((e) => V.current ? me(e, J) : (V.current = !0, J)));
 	}, [q, J]);
-	let Ce = d.useMemo(() => W ? oe(W, L, F, m) : [], [
+	let we = u.useMemo(() => W ? oe(W, L, F, p) : [], [
 		W,
 		L,
 		F,
-		m
-	]), Y = d.useCallback((e, t) => {
+		p
+	]), Y = u.useCallback((e, t) => {
 		R((n) => ({
 			...n,
 			[e]: t
@@ -73,16 +73,16 @@ function g({ sectionKeys: r, excludeKeys: m = fe, scope: g = "personal", setting
 			...t,
 			[e]: !0
 		}));
-	}, []), we = d.useCallback((e) => {
+	}, []), Te = u.useCallback((e) => {
 		n(ie(e) || T(t.ERROR$GENERIC));
-	}, [T]), X = d.useRef(() => {}), Te = d.useCallback(() => {
+	}, [T]), X = u.useRef(() => {}), Ee = u.useCallback(() => {
 		X.current();
-	}, []), Z = d.useRef(() => ({})), Ee = d.useCallback(() => Z.current(), []), Q = () => {
+	}, []), Z = u.useRef(() => ({})), De = u.useCallback(() => Z.current(), []), Q = () => {
 		if (!W) return;
 		let e;
 		try {
-			let t = ae(W, L, z, F), n;
-			n = _ === "conversation_settings" ? { conversation_settings_diff: t } : { agent_settings_diff: t }, e = y ? y(t, {
+			let t = l(W, L, z, F), n;
+			n = g === "conversation_settings" ? { conversation_settings_diff: t } : { agent_settings_diff: t }, e = v ? v(t, {
 				values: L,
 				dirty: z,
 				view: F
@@ -92,54 +92,54 @@ function g({ sectionKeys: r, excludeKeys: m = fe, scope: g = "personal", setting
 			return;
 		}
 		Object.keys(e).length !== 0 && E(e, {
-			onError: we,
+			onError: Te,
 			onSuccess: () => {
-				ee(T(t.SETTINGS$SAVED_WARNING)), B({}), ge?.();
+				S || ee(T(t.SETTINGS$SAVED_WARNING)), B({}), _e?.();
 			}
 		});
 	};
-	X.current = Q, Z.current = () => W ? l(W, L, z) : {};
-	let $ = Object.keys(z).length > 0 || v;
-	return d.useEffect(() => {
+	X.current = Q, Z.current = () => W ? c(W, L, z) : {};
+	let $ = Object.keys(z).length > 0 || _;
+	return u.useEffect(() => {
 		C && C({
-			save: Te,
+			save: Ee,
 			isSaving: D,
 			isDirty: $,
 			values: L,
 			view: F,
-			getDirtyPayload: Ee
+			getDirtyPayload: De
 		});
 	}, [
 		D,
 		$,
 		L,
 		F
-	]), k || A || be ? /* @__PURE__ */ f(s, {}) : !W || W.sections.length === 0 ? /* @__PURE__ */ f(i.Paragraph, {
+	]), (k || A) && !O || xe ? /* @__PURE__ */ d(o, {}) : !W || W.sections.length === 0 ? /* @__PURE__ */ d(ne.Paragraph, {
 		className: "text-tertiary-alt",
-		children: xe
-	}) : Object.keys(L).length === 0 ? /* @__PURE__ */ f(s, {}) : /* @__PURE__ */ p("div", {
+		children: Se
+	}) : Object.keys(L).length === 0 ? /* @__PURE__ */ d(o, {}) : /* @__PURE__ */ f("div", {
 		"data-testid": w,
-		className: ye ? "relative flex min-h-0 w-full flex-1 flex-col" : "relative w-full min-h-0",
-		children: [/* @__PURE__ */ f(de, {
+		className: be ? "relative flex min-h-0 w-full flex-1 flex-col" : "relative w-full min-h-0",
+		children: [/* @__PURE__ */ d(fe, {
 			view: F,
 			setView: I,
 			showAdvanced: G,
 			showAll: K,
 			isDisabled: !1
-		}), /* @__PURE__ */ p("div", {
+		}), /* @__PURE__ */ f("div", {
 			className: "flex flex-col gap-8",
 			children: [
-				he?.({
+				ge?.({
 					values: L,
 					isDisabled: !1,
 					view: F,
 					onChange: Y
 				}),
-				Ce.map((e, t) => /* @__PURE__ */ f("section", {
+				we.map((e, t) => /* @__PURE__ */ d("section", {
 					className: "flex flex-col gap-4",
-					children: /* @__PURE__ */ f("div", {
+					children: /* @__PURE__ */ d("div", {
 						className: "flex flex-col gap-4",
-						children: e.fields.map((e) => /* @__PURE__ */ f(u, {
+						children: e.fields.map((e) => /* @__PURE__ */ d(de, {
 							field: e,
 							value: L[e.key],
 							isDisabled: !1,
@@ -147,13 +147,13 @@ function g({ sectionKeys: r, excludeKeys: m = fe, scope: g = "personal", setting
 						}, e.key))
 					})
 				}, `${e.key}-${t}`)),
-				S ? null : /* @__PURE__ */ f("div", {
+				x ? null : /* @__PURE__ */ d("div", {
 					className: "flex justify-start pt-2",
-					children: /* @__PURE__ */ f(ne, {
+					children: /* @__PURE__ */ d(re, {
 						testId: "save-button",
 						type: "button",
 						variant: "primary",
-						isDisabled: D || Object.keys(z).length === 0 && !v,
+						isDisabled: D || Object.keys(z).length === 0 && !_,
 						onClick: Q,
 						children: T(D ? t.SETTINGS$SAVING : t.SETTINGS$SAVE_CHANGES)
 					})
@@ -163,6 +163,6 @@ function g({ sectionKeys: r, excludeKeys: m = fe, scope: g = "personal", setting
 	});
 }
 //#endregion
-export { g as SdkSectionPage };
+export { h as SdkSectionPage };
 
 //# sourceMappingURL=sdk-section-page.js.map