npm - @openhands/agent-canvas - Versions diffs - 1.0.0-beta.8 → 1.0.0-beta.9 - Mend

@openhands/agent-canvas 1.0.0-beta.8 → 1.0.0-beta.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (372) hide show

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

	@@ -1 +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"}
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 { 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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 ADDED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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`);
1	+ 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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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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"}
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 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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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