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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"sdk-section-page.js","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  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}\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 Anthropic/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  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\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    });\n  }, [isPending, saveControlIsDirty, values]);\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.js","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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"}

package/dist/constants/acp-providers.cjs

@@ -1,2 +1,2 @@
-require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../i18n/declaration.cjs`),t=require(`../node_modules/@openhands/typescript-client/dist/models/acp.cjs`);require(`../node_modules/@openhands/typescript-client/dist/index.cjs`);var n=new Set([`default`,`default (recommended)`]);function r(e){if(typeof e!=`string`)return null;let t=e.trim();return!t||n.has(t.toLowerCase())||t===`acp-managed`?null:t}function i(e){for(let t of[e.runtimeName,e.runtimeId,e.configured,e.sdkLlm]){let e=r(t);if(e)return e}return e.providerDefault??null}var a={"claude-code":{icon:`claude-code`,description_key:e.I18nKey.ONBOARDING$AGENT_CLAUDE_CODE_DESCRIPTION},codex:{icon:`codex`,description_key:e.I18nKey.ONBOARDING$AGENT_CODEX_DESCRIPTION},"gemini-cli":{icon:`gemini`,description_key:e.I18nKey.ONBOARDING$AGENT_GEMINI_CLI_DESCRIPTION}},o=Object.entries(a).map(([e,n])=>{let r=t.getAcpProvider(e);return{key:e,display_name:r?.display_name??e,default_command:r?[...r.default_command]:[],available_models:r?.available_models?.map(e=>({id:e.id,label:e.label})),default_model:r?.default_model??void 0,description_key:n.description_key,icon:n.icon}});function s(e){if(e)return o.find(t=>t.key===e)}function c(e){let t=s(e);return t?t.display_name:null}function l(e){return s(e)?.icon??`cli-generic`}function u(e,t){return t?s(e)?.available_models?.find(e=>e.id===t)?.label??t:null}exports.ACP_PROVIDERS=o,exports.getAcpProvider=s,exports.getAcpProviderDisplayName=c,exports.labelForAcpModel=u,exports.resolveAcpProviderIcon=l,exports.resolveEffectiveAcpModel=i;
+require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../i18n/declaration.cjs`),t=require(`../node_modules/@openhands/typescript-client/dist/models/acp.cjs`);require(`../node_modules/@openhands/typescript-client/dist/index.cjs`);var n=new Set([`default`,`default (recommended)`]);function r(e){if(typeof e!=`string`)return null;let t=e.trim();return!t||n.has(t.toLowerCase())||t===`acp-managed`?null:t}function i(e){for(let t of[e.runtimeName,e.runtimeId,e.configured,e.sdkLlm]){let e=r(t);if(e)return e}return e.providerDefault??null}var a={"claude-code":{icon:`claude-code`,description_key:e.I18nKey.ONBOARDING$AGENT_CLAUDE_CODE_DESCRIPTION},codex:{icon:`codex`,description_key:e.I18nKey.ONBOARDING$AGENT_CODEX_DESCRIPTION},"gemini-cli":{icon:`gemini`,description_key:e.I18nKey.ONBOARDING$AGENT_GEMINI_CLI_DESCRIPTION}},o=Object.entries(a).map(([e,n])=>{let r=t.getAcpProvider(e);return{key:e,display_name:r?.display_name??e,default_command:r?[...r.default_command]:[],available_models:r?.available_models?.map(e=>({id:e.id,label:e.label})),default_model:r?.default_model??void 0,description_key:n.description_key,icon:n.icon}});e.I18nKey.ONBOARDING$ACP_SECRET_API_KEY_HINT,e.I18nKey.ONBOARDING$ACP_SECRET_BASE_URL_HINT,e.I18nKey.ONBOARDING$ACP_SECRET_API_KEY_HINT,e.I18nKey.ONBOARDING$ACP_SECRET_BASE_URL_HINT;function s(e){if(e)return o.find(t=>t.key===e)}function c(e){let t=s(e);return t?t.display_name:null}function l(e){return s(e)?.icon??`cli-generic`}function u(e,t){return t?s(e)?.available_models?.find(e=>e.id===t)?.label??t:null}exports.ACP_PROVIDERS=o,exports.getAcpProvider=s,exports.getAcpProviderDisplayName=c,exports.labelForAcpModel=u,exports.resolveAcpProviderIcon=l,exports.resolveEffectiveAcpModel=i;
 //# sourceMappingURL=acp-providers.cjs.map

package/dist/constants/acp-providers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"acp-providers.cjs","names":[],"sources":["../../src/constants/acp-providers.ts"],"sourcesContent":["import { getAcpProvider as getClientAcpProvider } from \"@openhands/typescript-client\";\nimport { I18nKey } from \"#/i18n/declaration\";\n\nexport type ACPProviderIcon =\n  | \"claude-code\"\n  | \"codex\"\n  | \"gemini\"\n  | \"cli-generic\";\n\nexport const ACP_PROVIDER_FALLBACK_ICON: ACPProviderIcon = \"cli-generic\";\n\n// SDK placeholder strings the ACP wrapper returns before the user has\n// chosen a real model — surfacing either would lie about what's running.\nexport const ACP_DEFAULT_PLACEHOLDERS = new Set([\n  \"default\",\n  \"default (recommended)\",\n]);\n\n// Sentinel ``agent.llm.model`` returned by older SDKs for ACP conversations\n// in lieu of a real model. Suppressed at every consumer that resolves a\n// display string.\nexport const ACP_MANAGED_SENTINEL = \"acp-managed\";\n\n/**\n * Filter for \"real\" ACP model strings — non-empty, not the SDK's \"default\"\n * placeholder, not the legacy ``acp-managed`` sentinel. Returns the trimmed\n * value on success, ``null`` otherwise.\n */\nfunction realAcpModel(value: unknown): string | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  if (!trimmed) return null;\n  if (ACP_DEFAULT_PLACEHOLDERS.has(trimmed.toLowerCase())) return null;\n  if (trimmed === ACP_MANAGED_SENTINEL) return null;\n  return trimmed;\n}\n\n/**\n * Single source of truth for resolving the model string to surface for an\n * ACP conversation/settings context. Consumed by the conversation adapter\n * (chip text), the conversation-creation path (concrete ``acp_model``\n * payload), the Settings → Agent form (initial value), and the chat-input\n * model label.\n *\n * Precedence: SDK runtime fields → user-configured ``acp_model`` →\n * legacy ``agent.llm.model`` → provider default (when ``providerDefault``\n * is passed). Pass ``providerDefault`` only on surfaces that should\n * silently substitute the registry default; omit it for the conversation\n * chip, which must distinguish \"no concrete model\" from \"default\".\n */\nexport function resolveEffectiveAcpModel(inputs: {\n  runtimeName?: string | null;\n  runtimeId?: string | null;\n  configured?: string | null;\n  sdkLlm?: string | null;\n  providerDefault?: string | null;\n}): string | null {\n  for (const candidate of [\n    inputs.runtimeName,\n    inputs.runtimeId,\n    inputs.configured,\n    inputs.sdkLlm,\n  ]) {\n    const value = realAcpModel(candidate);\n    if (value) return value;\n  }\n  return inputs.providerDefault ?? null;\n}\n\n/**\n * Shape of a built-in ACP (Agent Client Protocol) provider as Canvas consumes\n * it. The data fields (display name, launch command, model picker + default)\n * are sourced at module load from ``@openhands/typescript-client``'s ACP\n * registry — the generated mirror of the Python source of truth\n * ``openhands.sdk.settings.acp_providers``. This config only adds the\n * Canvas-specific UI fields ({@link ACPProviderConfig.icon} +\n * {@link ACPProviderConfig.description_key}); see {@link ACP_PROVIDER_UI}.\n */\nexport interface ACPProviderConfig {\n  /** Stable registry key, also stored on conversations as ``tags.acpserver``. */\n  key: string;\n  /** Human-readable name shown in dropdowns and conversation chips. */\n  display_name: string;\n  /**\n   * Tokens passed to the agent-server as ``acp_command`` when this preset\n   * is picked. Each entry must be a real ACP-protocol stdio server — the\n   * SDK validates this against the {@link ACPProviderConfig.key}.\n   *\n   * NB: ``npx -y @openai/codex acp`` looks plausible but is **not** an\n   * ACP server — the codex CLI has no ``acp`` subcommand and exits with\n   * ``Error: stdin is not a terminal`` when spawned without a TTY, which\n   * silently deadlocks the agent-server's ACP handshake. Use\n   * ``@zed-industries/codex-acp`` (the Zed-shipped wrapper) instead.\n   */\n  default_command: string[];\n  /**\n   * Suggested ACP model IDs for the provider's picker, sourced from the\n   * typescript-client registry. Not authoritative access checks; users can\n   * still enter a custom override in Settings -> Agent.\n   */\n  available_models?: ACPModelOption[];\n  /** Model ID preselected for built-in providers so Canvas never saves blank. */\n  default_model?: string;\n  /**\n   * i18n key for the one-line provider description rendered under the\n   * onboarding tile. Stored on the registry so adding a new ACP\n   * provider only requires editing this file (not the onboarding tile\n   * list separately).\n   */\n  description_key: I18nKey;\n  /**\n   * Serializable icon key used by UI surfaces that render provider\n   * choices. Kept as a string so the SDK mirror check can continue to\n   * parse this registry without importing React components.\n   */\n  icon?: ACPProviderIcon;\n}\n\nexport interface ACPModelOption {\n  /** Exact model ID sent as ``acp_model``. */\n  id: string;\n  /** Human-readable label shown in Settings -> Agent. */\n  label: string;\n}\n\n// Canvas-only UI metadata per built-in provider, keyed by the ACP registry\n// key. Everything else — display name, launch command, model picker list and\n// default — comes from the typescript-client registry below. Adding a model\n// or a provider happens upstream in the SDK; Canvas only owns the brand icon\n// and the onboarding-tile description here. A provider with no entry here is\n// intentionally not surfaced in the UI.\nconst ACP_PROVIDER_UI: Record<\n  string,\n  { icon: ACPProviderIcon; description_key: I18nKey }\n> = {\n  \"claude-code\": {\n    icon: \"claude-code\",\n    description_key: I18nKey.ONBOARDING$AGENT_CLAUDE_CODE_DESCRIPTION,\n  },\n  codex: {\n    icon: \"codex\",\n    description_key: I18nKey.ONBOARDING$AGENT_CODEX_DESCRIPTION,\n  },\n  \"gemini-cli\": {\n    icon: \"gemini\",\n    description_key: I18nKey.ONBOARDING$AGENT_GEMINI_CLI_DESCRIPTION,\n  },\n};\n\n// Built-in ACP providers Canvas surfaces, built by enriching each upstream\n// registry record (``@openhands/typescript-client`` → Python SDK) with the\n// Canvas UI metadata above. Model lists + defaults are no longer hand-kept\n// here (closes agent-canvas#740) — they track the SDK via the pinned client.\nexport const ACP_PROVIDERS: ACPProviderConfig[] = Object.entries(\n  ACP_PROVIDER_UI,\n).map(([key, ui]) => {\n  const info = getClientAcpProvider(key);\n  return {\n    key,\n    display_name: info?.display_name ?? key,\n    default_command: info ? [...info.default_command] : [],\n    available_models: info?.available_models?.map((model) => ({\n      id: model.id,\n      label: model.label,\n    })),\n    default_model: info?.default_model ?? undefined,\n    description_key: ui.description_key,\n    icon: ui.icon,\n  };\n});\n\nexport const ACP_CUSTOM_PRESET_KEY = \"custom\";\n\n/**\n * Look up a built-in ACP provider config by its registry key.\n *\n * Returns ``undefined`` for an empty / null key, for the ``\"custom\"`` preset\n * (which has no registry entry), and for any forward-compatible key Canvas's\n * registry doesn't know about yet. Centralizes the ``ACP_PROVIDERS.find(...)``\n * lookup shared by the resolvers below and by the adapter / settings surfaces\n * so the key-comparison shape lives in one place.\n */\nexport function getAcpProvider(\n  key: string | null | undefined,\n): ACPProviderConfig | undefined {\n  if (!key) return undefined;\n  return ACP_PROVIDERS.find((provider) => provider.key === key);\n}\n\n/**\n * Resolve an ACP provider registry key (the value stored under\n * ``tags.acpserver`` on a conversation) to a human display name for the\n * sidebar chip.\n *\n * Returns ``null`` for an empty / null key and for keys not in\n * {@link ACP_PROVIDERS} — most notably ``\"custom\"`` (the user-supplied\n * command preset has no canonical brand name) and any forward-compatible\n * value Canvas's registry doesn't know about yet. Callers should fall\n * back to a generic ``\"ACP\"`` label in that case so the chip still\n * communicates \"this is an ACP conversation\".\n *\n * Kept separate from {@link buildAcpAgentSettingsDiff}'s lookup so the\n * conversation-card render path can resolve display names without\n * importing the settings-payload builder.\n */\nexport function getAcpProviderDisplayName(\n  key: string | null | undefined,\n): string | null {\n  const found = getAcpProvider(key);\n  return found ? found.display_name : null;\n}\n\n/**\n * Resolve an ACP provider registry key to the icon discriminator the\n * conversation chip should render alongside the model text.\n *\n * Falls back to {@link ACP_PROVIDER_FALLBACK_ICON} for ``\"custom\"``,\n * unknown keys, or a missing key — the chip then shows a neutral\n * terminal glyph that still communicates \"this is an ACP conversation\"\n * without claiming a brand identity we don't know.\n */\nexport function resolveAcpProviderIcon(\n  key: string | null | undefined,\n): ACPProviderIcon {\n  return getAcpProvider(key)?.icon ?? ACP_PROVIDER_FALLBACK_ICON;\n}\n\n/**\n * Resolve a raw ``acp_model`` ID to the human-readable label the provider's\n * picker shows for it (e.g. ``\"claude-opus-4-7\"`` → ``\"Claude Opus 4.7\"``).\n *\n * Falls back to the raw ID when the provider is unknown or the ID isn't one\n * of its registered {@link ACPModelOption}s — so a user's custom override\n * still renders something meaningful rather than nothing. Returns ``null``\n * only when there is no model to show, letting the conversation chip decide\n * to display the provider name instead.\n */\nexport function labelForAcpModel(\n  serverKey: string | null | undefined,\n  modelId: string | null | undefined,\n): string | null {\n  if (!modelId) return null;\n  const provider = getAcpProvider(serverKey);\n  const match = provider?.available_models?.find((m) => m.id === modelId);\n  return match?.label ?? modelId;\n}\n\n/**\n * Build the ``agent_settings_diff`` payload PATCH /api/settings expects\n * for the agent-kind/provider choice the user just made.\n *\n * Used by both the Settings → Agent page and the onboarding \"choose\n * agent\" step — keeping the shape in one helper means a future change\n * (e.g. always seeding ``acp_command`` from the registry instead of\n * sending ``[]``, or adding new ``acp_*`` reset fields) lands in both\n * surfaces atomically.\n *\n * Returns ``null`` for an unknown ACP provider key by default — the\n * caller can skip the save (the UI shouldn't surface unknown options,\n * but the defensive path keeps a buggy preset list from corrupting\n * settings).\n *\n * Pass ``allowUnknownServer: true`` to opt into pass-through for keys\n * that aren't in {@link ACP_PROVIDERS} or ``ACP_CUSTOM_PRESET_KEY``.\n * The Settings → Agent page uses this when the user opens settings\n * that already carry an ``acp_server`` value canvas's registry\n * doesn't know about (e.g. set out-of-band via the API for a provider\n * we haven't mirrored yet) and saves without changing the command —\n * otherwise the original key would be silently demoted to ``\"custom\"``.\n */\nexport function buildAcpAgentSettingsDiff(\n  providerKey: string,\n  options: {\n    command?: string[];\n    model?: string | null;\n    allowUnknownServer?: boolean;\n  } = {},\n): Record<string, unknown> | null {\n  if (providerKey === \"openhands\") {\n    // Switching back to OpenHands. The agent-server's ``Settings.update``\n    // applies a fresh ``{'agent_kind': ...}`` base whenever the kind\n    // flips, so any ``acp_*`` fields would be discarded before\n    // validation. Send the kind alone.\n    return { agent_kind: \"openhands\" };\n  }\n\n  const isCustom = providerKey === ACP_CUSTOM_PRESET_KEY;\n  const provider = isCustom ? undefined : getAcpProvider(providerKey);\n  if (!isCustom && !provider && !options.allowUnknownServer) {\n    return null;\n  }\n\n  const model =\n    options.model === undefined\n      ? (provider?.default_model ?? null)\n      : options.model;\n\n  // ``acp_args: []`` resets any API-set ``acp_args`` that would\n  // otherwise survive and concatenate to ``acp_command`` at spawn time\n  // (the agent-server merges the two before exec). Callers building the\n  // payload from a textarea that already shows the merged command\n  // (Settings → Agent) round-trip correctly — the merged tokens land in\n  // ``acp_command`` here, so no args are lost.\n  return {\n    agent_kind: \"acp\",\n    acp_server: providerKey,\n    acp_command: options.command ?? [],\n    acp_args: [],\n    acp_model: model ?? null,\n  };\n}\n"],"mappings":"6OAaA,IAAa,EAA2B,IAAI,IAAI,CAC9C,UACA,wBACD,CAAC,CAYF,SAAS,EAAa,EAA+B,CACnD,GAAI,OAAO,GAAU,SAAU,OAAO,KACtC,IAAM,EAAU,EAAM,MAAM,CAI5B,MAHI,CAAC,GACD,EAAyB,IAAI,EAAQ,aAAa,CAAC,EACnD,IAAA,cAAyC,KACtC,EAgBT,SAAgB,EAAyB,EAMvB,CAChB,IAAK,IAAM,IAAa,CACtB,EAAO,YACP,EAAO,UACP,EAAO,WACP,EAAO,OACR,CAAE,CACD,IAAM,EAAQ,EAAa,EAAU,CACrC,GAAI,EAAO,OAAO,EAEpB,OAAO,EAAO,iBAAmB,KAiEnC,IAAM,EAGF,CACF,cAAe,CACb,KAAM,cACN,gBAAiB,EAAA,QAAQ,yCAC1B,CACD,MAAO,CACL,KAAM,QACN,gBAAiB,EAAA,QAAQ,mCAC1B,CACD,aAAc,CACZ,KAAM,SACN,gBAAiB,EAAA,QAAQ,wCAC1B,CACF,CAMY,EAAqC,OAAO,QACvD,EACD,CAAC,KAAK,CAAC,EAAK,KAAQ,CACnB,IAAM,EAAO,EAAA,eAAqB,EAAI,CACtC,MAAO,CACL,MACA,aAAc,GAAM,cAAgB,EACpC,gBAAiB,EAAO,CAAC,GAAG,EAAK,gBAAgB,CAAG,EAAE,CACtD,iBAAkB,GAAM,kBAAkB,IAAK,IAAW,CACxD,GAAI,EAAM,GACV,MAAO,EAAM,MACd,EAAE,CACH,cAAe,GAAM,eAAiB,IAAA,GACtC,gBAAiB,EAAG,gBACpB,KAAM,EAAG,KACV,EACD,CAaF,SAAgB,EACd,EAC+B,CAC1B,KACL,OAAO,EAAc,KAAM,GAAa,EAAS,MAAQ,EAAI,CAmB/D,SAAgB,EACd,EACe,CACf,IAAM,EAAQ,EAAe,EAAI,CACjC,OAAO,EAAQ,EAAM,aAAe,KAYtC,SAAgB,EACd,EACiB,CACjB,OAAO,EAAe,EAAI,EAAE,MAAA,cAa9B,SAAgB,EACd,EACA,EACe,CAIf,OAHK,EACY,EAAe,EAClB,EAAU,kBAAkB,KAAM,GAAM,EAAE,KAAO,EAAQ,EACzD,OAAS,EAHF"}
+{"version":3,"file":"acp-providers.cjs","names":[],"sources":["../../src/constants/acp-providers.ts"],"sourcesContent":["import { getAcpProvider as getClientAcpProvider } from \"@openhands/typescript-client\";\nimport { I18nKey } from \"#/i18n/declaration\";\n\nexport type ACPProviderIcon =\n  | \"claude-code\"\n  | \"codex\"\n  | \"gemini\"\n  | \"cli-generic\";\n\nexport const ACP_PROVIDER_FALLBACK_ICON: ACPProviderIcon = \"cli-generic\";\n\n// SDK placeholder strings the ACP wrapper returns before the user has\n// chosen a real model — surfacing either would lie about what's running.\nexport const ACP_DEFAULT_PLACEHOLDERS = new Set([\n  \"default\",\n  \"default (recommended)\",\n]);\n\n// Sentinel ``agent.llm.model`` returned by older SDKs for ACP conversations\n// in lieu of a real model. Suppressed at every consumer that resolves a\n// display string.\nexport const ACP_MANAGED_SENTINEL = \"acp-managed\";\n\n/**\n * Filter for \"real\" ACP model strings — non-empty, not the SDK's \"default\"\n * placeholder, not the legacy ``acp-managed`` sentinel. Returns the trimmed\n * value on success, ``null`` otherwise.\n */\nfunction realAcpModel(value: unknown): string | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  if (!trimmed) return null;\n  if (ACP_DEFAULT_PLACEHOLDERS.has(trimmed.toLowerCase())) return null;\n  if (trimmed === ACP_MANAGED_SENTINEL) return null;\n  return trimmed;\n}\n\n/**\n * Single source of truth for resolving the model string to surface for an\n * ACP conversation/settings context. Consumed by the conversation adapter\n * (chip text), the conversation-creation path (concrete ``acp_model``\n * payload), the Settings → Agent form (initial value), and the chat-input\n * model label.\n *\n * Precedence: SDK runtime fields → user-configured ``acp_model`` →\n * legacy ``agent.llm.model`` → provider default (when ``providerDefault``\n * is passed). Pass ``providerDefault`` only on surfaces that should\n * silently substitute the registry default; omit it for the conversation\n * chip, which must distinguish \"no concrete model\" from \"default\".\n */\nexport function resolveEffectiveAcpModel(inputs: {\n  runtimeName?: string | null;\n  runtimeId?: string | null;\n  configured?: string | null;\n  sdkLlm?: string | null;\n  providerDefault?: string | null;\n}): string | null {\n  for (const candidate of [\n    inputs.runtimeName,\n    inputs.runtimeId,\n    inputs.configured,\n    inputs.sdkLlm,\n  ]) {\n    const value = realAcpModel(candidate);\n    if (value) return value;\n  }\n  return inputs.providerDefault ?? null;\n}\n\n/**\n * Shape of a built-in ACP (Agent Client Protocol) provider as Canvas consumes\n * it. The data fields (display name, launch command, model picker + default)\n * are sourced at module load from ``@openhands/typescript-client``'s ACP\n * registry — the generated mirror of the Python source of truth\n * ``openhands.sdk.settings.acp_providers``. This config only adds the\n * Canvas-specific UI fields ({@link ACPProviderConfig.icon} +\n * {@link ACPProviderConfig.description_key}); see {@link ACP_PROVIDER_UI}.\n */\nexport interface ACPProviderConfig {\n  /** Stable registry key, also stored on conversations as ``tags.acpserver``. */\n  key: string;\n  /** Human-readable name shown in dropdowns and conversation chips. */\n  display_name: string;\n  /**\n   * Tokens passed to the agent-server as ``acp_command`` when this preset\n   * is picked. Each entry must be a real ACP-protocol stdio server — the\n   * SDK validates this against the {@link ACPProviderConfig.key}.\n   *\n   * NB: ``npx -y @openai/codex acp`` looks plausible but is **not** an\n   * ACP server — the codex CLI has no ``acp`` subcommand and exits with\n   * ``Error: stdin is not a terminal`` when spawned without a TTY, which\n   * silently deadlocks the agent-server's ACP handshake. Use\n   * ``@zed-industries/codex-acp`` (the Zed-shipped wrapper) instead.\n   */\n  default_command: string[];\n  /**\n   * Suggested ACP model IDs for the provider's picker, sourced from the\n   * typescript-client registry. Not authoritative access checks; users can\n   * still enter a custom override in Settings -> Agent.\n   */\n  available_models?: ACPModelOption[];\n  /** Model ID preselected for built-in providers so Canvas never saves blank. */\n  default_model?: string;\n  /**\n   * i18n key for the one-line provider description rendered under the\n   * onboarding tile. Stored on the registry so adding a new ACP\n   * provider only requires editing this file (not the onboarding tile\n   * list separately).\n   */\n  description_key: I18nKey;\n  /**\n   * Serializable icon key used by UI surfaces that render provider\n   * choices. Kept as a string so the SDK mirror check can continue to\n   * parse this registry without importing React components.\n   */\n  icon?: ACPProviderIcon;\n}\n\nexport interface ACPModelOption {\n  /** Exact model ID sent as ``acp_model``. */\n  id: string;\n  /** Human-readable label shown in Settings -> Agent. */\n  label: string;\n}\n\n// Canvas-only UI metadata per built-in provider, keyed by the ACP registry\n// key. Everything else — display name, launch command, model picker list and\n// default — comes from the typescript-client registry below. Adding a model\n// or a provider happens upstream in the SDK; Canvas only owns the brand icon\n// and the onboarding-tile description here. A provider with no entry here is\n// intentionally not surfaced in the UI.\nconst ACP_PROVIDER_UI: Record<\n  string,\n  { icon: ACPProviderIcon; description_key: I18nKey }\n> = {\n  \"claude-code\": {\n    icon: \"claude-code\",\n    description_key: I18nKey.ONBOARDING$AGENT_CLAUDE_CODE_DESCRIPTION,\n  },\n  codex: {\n    icon: \"codex\",\n    description_key: I18nKey.ONBOARDING$AGENT_CODEX_DESCRIPTION,\n  },\n  \"gemini-cli\": {\n    icon: \"gemini\",\n    description_key: I18nKey.ONBOARDING$AGENT_GEMINI_CLI_DESCRIPTION,\n  },\n};\n\n// Built-in ACP providers Canvas surfaces, built by enriching each upstream\n// registry record (``@openhands/typescript-client`` → Python SDK) with the\n// Canvas UI metadata above. Model lists + defaults are no longer hand-kept\n// here (closes agent-canvas#740) — they track the SDK via the pinned client.\nexport const ACP_PROVIDERS: ACPProviderConfig[] = Object.entries(\n  ACP_PROVIDER_UI,\n).map(([key, ui]) => {\n  const info = getClientAcpProvider(key);\n  return {\n    key,\n    display_name: info?.display_name ?? key,\n    default_command: info ? [...info.default_command] : [],\n    available_models: info?.available_models?.map((model) => ({\n      id: model.id,\n      label: model.label,\n    })),\n    default_model: info?.default_model ?? undefined,\n    description_key: ui.description_key,\n    icon: ui.icon,\n  };\n});\n\nexport const ACP_CUSTOM_PRESET_KEY = \"custom\";\n\n/**\n * A credential an ACP provider authenticates with, surfaced during onboarding\n * so the user can populate it without leaving the flow. The {@link name} is\n * both the global-secret name and the environment variable the agent-server\n * exports into the ACP subprocess — keeping them identical is what makes a\n * saved secret actually reach the provider CLI.\n */\nexport interface ACPProviderSecretField {\n  /** Secret name and env var (e.g. ``\"ANTHROPIC_API_KEY\"``). Must satisfy the\n   * secret-name pattern ``^[a-zA-Z][a-zA-Z0-9_]{0,63}$``. */\n  name: string;\n  /** Render as a masked password input (API keys) rather than a plain-text\n   * input (base URLs). Every field is optional regardless — the whole step is\n   * skippable — so this only controls masking, not whether the field gates. */\n  secret?: boolean;\n  /** i18n key for the one-line helper text under the field. */\n  hint_key: I18nKey;\n}\n\n// Credentials Canvas prompts for during onboarding, keyed by ACP registry key.\n// Only providers that authenticate through an env-var API key appear here:\n// Claude Code (Anthropic) and Codex (OpenAI). Gemini CLI authenticates via an\n// interactive OAuth login rather than a static key, so it has no entry and its\n// onboarding credentials step is skipped. Every field is optional (the step is\n// skippable): the API keys render masked, the base-URL entries are plain-text\n// overrides for proxies/gateways. A provider with no entry simply shows no\n// credentials step.\nconst ACP_PROVIDER_SECRETS: Record<string, ACPProviderSecretField[]> = {\n  \"claude-code\": [\n    {\n      name: \"ANTHROPIC_API_KEY\",\n      secret: true,\n      hint_key: I18nKey.ONBOARDING$ACP_SECRET_API_KEY_HINT,\n    },\n    {\n      name: \"ANTHROPIC_BASE_URL\",\n      hint_key: I18nKey.ONBOARDING$ACP_SECRET_BASE_URL_HINT,\n    },\n  ],\n  codex: [\n    {\n      name: \"OPENAI_API_KEY\",\n      secret: true,\n      hint_key: I18nKey.ONBOARDING$ACP_SECRET_API_KEY_HINT,\n    },\n    {\n      name: \"OPENAI_BASE_URL\",\n      hint_key: I18nKey.ONBOARDING$ACP_SECRET_BASE_URL_HINT,\n    },\n  ],\n};\n\n/**\n * List the credentials Canvas should prompt for when onboarding the given ACP\n * provider. Returns ``[]`` for OpenHands, the ``\"custom\"`` preset, providers\n * that don't use a static API key (Gemini CLI), and any unknown key — callers\n * treat an empty list as \"no credentials step for this provider\".\n */\nexport function getAcpProviderSecrets(\n  key: string | null | undefined,\n): ACPProviderSecretField[] {\n  if (!key) return [];\n  return ACP_PROVIDER_SECRETS[key] ?? [];\n}\n\n/**\n * Look up a built-in ACP provider config by its registry key.\n *\n * Returns ``undefined`` for an empty / null key, for the ``\"custom\"`` preset\n * (which has no registry entry), and for any forward-compatible key Canvas's\n * registry doesn't know about yet. Centralizes the ``ACP_PROVIDERS.find(...)``\n * lookup shared by the resolvers below and by the adapter / settings surfaces\n * so the key-comparison shape lives in one place.\n */\nexport function getAcpProvider(\n  key: string | null | undefined,\n): ACPProviderConfig | undefined {\n  if (!key) return undefined;\n  return ACP_PROVIDERS.find((provider) => provider.key === key);\n}\n\n/**\n * Resolve an ACP provider registry key (the value stored under\n * ``tags.acpserver`` on a conversation) to a human display name for the\n * sidebar chip.\n *\n * Returns ``null`` for an empty / null key and for keys not in\n * {@link ACP_PROVIDERS} — most notably ``\"custom\"`` (the user-supplied\n * command preset has no canonical brand name) and any forward-compatible\n * value Canvas's registry doesn't know about yet. Callers should fall\n * back to a generic ``\"ACP\"`` label in that case so the chip still\n * communicates \"this is an ACP conversation\".\n *\n * Kept separate from {@link buildAcpAgentSettingsDiff}'s lookup so the\n * conversation-card render path can resolve display names without\n * importing the settings-payload builder.\n */\nexport function getAcpProviderDisplayName(\n  key: string | null | undefined,\n): string | null {\n  const found = getAcpProvider(key);\n  return found ? found.display_name : null;\n}\n\n/**\n * Resolve an ACP provider registry key to the icon discriminator the\n * conversation chip should render alongside the model text.\n *\n * Falls back to {@link ACP_PROVIDER_FALLBACK_ICON} for ``\"custom\"``,\n * unknown keys, or a missing key — the chip then shows a neutral\n * terminal glyph that still communicates \"this is an ACP conversation\"\n * without claiming a brand identity we don't know.\n */\nexport function resolveAcpProviderIcon(\n  key: string | null | undefined,\n): ACPProviderIcon {\n  return getAcpProvider(key)?.icon ?? ACP_PROVIDER_FALLBACK_ICON;\n}\n\n/**\n * Resolve a raw ``acp_model`` ID to the human-readable label the provider's\n * picker shows for it (e.g. ``\"claude-opus-4-7\"`` → ``\"Claude Opus 4.7\"``).\n *\n * Falls back to the raw ID when the provider is unknown or the ID isn't one\n * of its registered {@link ACPModelOption}s — so a user's custom override\n * still renders something meaningful rather than nothing. Returns ``null``\n * only when there is no model to show, letting the conversation chip decide\n * to display the provider name instead.\n */\nexport function labelForAcpModel(\n  serverKey: string | null | undefined,\n  modelId: string | null | undefined,\n): string | null {\n  if (!modelId) return null;\n  const provider = getAcpProvider(serverKey);\n  const match = provider?.available_models?.find((m) => m.id === modelId);\n  return match?.label ?? modelId;\n}\n\n/**\n * Build the ``agent_settings_diff`` payload PATCH /api/settings expects\n * for the agent-kind/provider choice the user just made.\n *\n * Used by both the Settings → Agent page and the onboarding \"choose\n * agent\" step — keeping the shape in one helper means a future change\n * (e.g. always seeding ``acp_command`` from the registry instead of\n * sending ``[]``, or adding new ``acp_*`` reset fields) lands in both\n * surfaces atomically.\n *\n * Returns ``null`` for an unknown ACP provider key by default — the\n * caller can skip the save (the UI shouldn't surface unknown options,\n * but the defensive path keeps a buggy preset list from corrupting\n * settings).\n *\n * Pass ``allowUnknownServer: true`` to opt into pass-through for keys\n * that aren't in {@link ACP_PROVIDERS} or ``ACP_CUSTOM_PRESET_KEY``.\n * The Settings → Agent page uses this when the user opens settings\n * that already carry an ``acp_server`` value canvas's registry\n * doesn't know about (e.g. set out-of-band via the API for a provider\n * we haven't mirrored yet) and saves without changing the command —\n * otherwise the original key would be silently demoted to ``\"custom\"``.\n */\nexport function buildAcpAgentSettingsDiff(\n  providerKey: string,\n  options: {\n    command?: string[];\n    model?: string | null;\n    allowUnknownServer?: boolean;\n  } = {},\n): Record<string, unknown> | null {\n  if (providerKey === \"openhands\") {\n    // Switching back to OpenHands. The agent-server's ``Settings.update``\n    // applies a fresh ``{'agent_kind': ...}`` base whenever the kind\n    // flips, so any ``acp_*`` fields would be discarded before\n    // validation. Send the kind alone.\n    return { agent_kind: \"openhands\" };\n  }\n\n  const isCustom = providerKey === ACP_CUSTOM_PRESET_KEY;\n  const provider = isCustom ? undefined : getAcpProvider(providerKey);\n  if (!isCustom && !provider && !options.allowUnknownServer) {\n    return null;\n  }\n\n  const model =\n    options.model === undefined\n      ? (provider?.default_model ?? null)\n      : options.model;\n\n  // ``acp_args: []`` resets any API-set ``acp_args`` that would\n  // otherwise survive and concatenate to ``acp_command`` at spawn time\n  // (the agent-server merges the two before exec). Callers building the\n  // payload from a textarea that already shows the merged command\n  // (Settings → Agent) round-trip correctly — the merged tokens land in\n  // ``acp_command`` here, so no args are lost.\n  return {\n    agent_kind: \"acp\",\n    acp_server: providerKey,\n    acp_command: options.command ?? [],\n    acp_args: [],\n    acp_model: model ?? null,\n  };\n}\n"],"mappings":"6OAaA,IAAa,EAA2B,IAAI,IAAI,CAC9C,UACA,wBACD,CAAC,CAYF,SAAS,EAAa,EAA+B,CACnD,GAAI,OAAO,GAAU,SAAU,OAAO,KACtC,IAAM,EAAU,EAAM,MAAM,CAI5B,MAHI,CAAC,GACD,EAAyB,IAAI,EAAQ,aAAa,CAAC,EACnD,IAAA,cAAyC,KACtC,EAgBT,SAAgB,EAAyB,EAMvB,CAChB,IAAK,IAAM,IAAa,CACtB,EAAO,YACP,EAAO,UACP,EAAO,WACP,EAAO,OACR,CAAE,CACD,IAAM,EAAQ,EAAa,EAAU,CACrC,GAAI,EAAO,OAAO,EAEpB,OAAO,EAAO,iBAAmB,KAiEnC,IAAM,EAGF,CACF,cAAe,CACb,KAAM,cACN,gBAAiB,EAAA,QAAQ,yCAC1B,CACD,MAAO,CACL,KAAM,QACN,gBAAiB,EAAA,QAAQ,mCAC1B,CACD,aAAc,CACZ,KAAM,SACN,gBAAiB,EAAA,QAAQ,wCAC1B,CACF,CAMY,EAAqC,OAAO,QACvD,EACD,CAAC,KAAK,CAAC,EAAK,KAAQ,CACnB,IAAM,EAAO,EAAA,eAAqB,EAAI,CACtC,MAAO,CACL,MACA,aAAc,GAAM,cAAgB,EACpC,gBAAiB,EAAO,CAAC,GAAG,EAAK,gBAAgB,CAAG,EAAE,CACtD,iBAAkB,GAAM,kBAAkB,IAAK,IAAW,CACxD,GAAI,EAAM,GACV,MAAO,EAAM,MACd,EAAE,CACH,cAAe,GAAM,eAAiB,IAAA,GACtC,gBAAiB,EAAG,gBACpB,KAAM,EAAG,KACV,EACD,CAoCc,EAAA,QAAQ,mCAIR,EAAA,QAAQ,oCAOR,EAAA,QAAQ,mCAIR,EAAA,QAAQ,oCA2BxB,SAAgB,EACd,EAC+B,CAC1B,KACL,OAAO,EAAc,KAAM,GAAa,EAAS,MAAQ,EAAI,CAmB/D,SAAgB,EACd,EACe,CACf,IAAM,EAAQ,EAAe,EAAI,CACjC,OAAO,EAAQ,EAAM,aAAe,KAYtC,SAAgB,EACd,EACiB,CACjB,OAAO,EAAe,EAAI,EAAE,MAAA,cAa9B,SAAgB,EACd,EACA,EACe,CAIf,OAHK,EACY,EAAe,EAClB,EAAU,kBAAkB,KAAM,GAAM,EAAE,KAAO,EAAQ,EACzD,OAAS,EAHF"}

package/dist/constants/acp-providers.d.ts

@@ -79,6 +79,31 @@ export interface ACPModelOption {
 }
 export declare const ACP_PROVIDERS: ACPProviderConfig[];
 export declare const ACP_CUSTOM_PRESET_KEY = "custom";
+/**
+ * A credential an ACP provider authenticates with, surfaced during onboarding
+ * so the user can populate it without leaving the flow. The {@link name} is
+ * both the global-secret name and the environment variable the agent-server
+ * exports into the ACP subprocess — keeping them identical is what makes a
+ * saved secret actually reach the provider CLI.
+ */
+export interface ACPProviderSecretField {
+    /** Secret name and env var (e.g. ``"ANTHROPIC_API_KEY"``). Must satisfy the
+     * secret-name pattern ``^[a-zA-Z][a-zA-Z0-9_]{0,63}$``. */
+    name: string;
+    /** Render as a masked password input (API keys) rather than a plain-text
+     * input (base URLs). Every field is optional regardless — the whole step is
+     * skippable — so this only controls masking, not whether the field gates. */
+    secret?: boolean;
+    /** i18n key for the one-line helper text under the field. */
+    hint_key: I18nKey;
+}
+/**
+ * List the credentials Canvas should prompt for when onboarding the given ACP
+ * provider. Returns ``[]`` for OpenHands, the ``"custom"`` preset, providers
+ * that don't use a static API key (Gemini CLI), and any unknown key — callers
+ * treat an empty list as "no credentials step for this provider".
+ */
+export declare function getAcpProviderSecrets(key: string | null | undefined): ACPProviderSecretField[];
 /**
  * Look up a built-in ACP provider config by its registry key.
  *

package/dist/constants/acp-providers.js

@@ -47,6 +47,7 @@ var a = {
 		icon: n.icon
 	};
 });
+e.ONBOARDING$ACP_SECRET_API_KEY_HINT, e.ONBOARDING$ACP_SECRET_BASE_URL_HINT, e.ONBOARDING$ACP_SECRET_API_KEY_HINT, e.ONBOARDING$ACP_SECRET_BASE_URL_HINT;
 function s(e) {
 	if (e) return o.find((t) => t.key === e);
 }

package/dist/constants/acp-providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"acp-providers.js","names":[],"sources":["../../src/constants/acp-providers.ts"],"sourcesContent":["import { getAcpProvider as getClientAcpProvider } from \"@openhands/typescript-client\";\nimport { I18nKey } from \"#/i18n/declaration\";\n\nexport type ACPProviderIcon =\n  | \"claude-code\"\n  | \"codex\"\n  | \"gemini\"\n  | \"cli-generic\";\n\nexport const ACP_PROVIDER_FALLBACK_ICON: ACPProviderIcon = \"cli-generic\";\n\n// SDK placeholder strings the ACP wrapper returns before the user has\n// chosen a real model — surfacing either would lie about what's running.\nexport const ACP_DEFAULT_PLACEHOLDERS = new Set([\n  \"default\",\n  \"default (recommended)\",\n]);\n\n// Sentinel ``agent.llm.model`` returned by older SDKs for ACP conversations\n// in lieu of a real model. Suppressed at every consumer that resolves a\n// display string.\nexport const ACP_MANAGED_SENTINEL = \"acp-managed\";\n\n/**\n * Filter for \"real\" ACP model strings — non-empty, not the SDK's \"default\"\n * placeholder, not the legacy ``acp-managed`` sentinel. Returns the trimmed\n * value on success, ``null`` otherwise.\n */\nfunction realAcpModel(value: unknown): string | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  if (!trimmed) return null;\n  if (ACP_DEFAULT_PLACEHOLDERS.has(trimmed.toLowerCase())) return null;\n  if (trimmed === ACP_MANAGED_SENTINEL) return null;\n  return trimmed;\n}\n\n/**\n * Single source of truth for resolving the model string to surface for an\n * ACP conversation/settings context. Consumed by the conversation adapter\n * (chip text), the conversation-creation path (concrete ``acp_model``\n * payload), the Settings → Agent form (initial value), and the chat-input\n * model label.\n *\n * Precedence: SDK runtime fields → user-configured ``acp_model`` →\n * legacy ``agent.llm.model`` → provider default (when ``providerDefault``\n * is passed). Pass ``providerDefault`` only on surfaces that should\n * silently substitute the registry default; omit it for the conversation\n * chip, which must distinguish \"no concrete model\" from \"default\".\n */\nexport function resolveEffectiveAcpModel(inputs: {\n  runtimeName?: string | null;\n  runtimeId?: string | null;\n  configured?: string | null;\n  sdkLlm?: string | null;\n  providerDefault?: string | null;\n}): string | null {\n  for (const candidate of [\n    inputs.runtimeName,\n    inputs.runtimeId,\n    inputs.configured,\n    inputs.sdkLlm,\n  ]) {\n    const value = realAcpModel(candidate);\n    if (value) return value;\n  }\n  return inputs.providerDefault ?? null;\n}\n\n/**\n * Shape of a built-in ACP (Agent Client Protocol) provider as Canvas consumes\n * it. The data fields (display name, launch command, model picker + default)\n * are sourced at module load from ``@openhands/typescript-client``'s ACP\n * registry — the generated mirror of the Python source of truth\n * ``openhands.sdk.settings.acp_providers``. This config only adds the\n * Canvas-specific UI fields ({@link ACPProviderConfig.icon} +\n * {@link ACPProviderConfig.description_key}); see {@link ACP_PROVIDER_UI}.\n */\nexport interface ACPProviderConfig {\n  /** Stable registry key, also stored on conversations as ``tags.acpserver``. */\n  key: string;\n  /** Human-readable name shown in dropdowns and conversation chips. */\n  display_name: string;\n  /**\n   * Tokens passed to the agent-server as ``acp_command`` when this preset\n   * is picked. Each entry must be a real ACP-protocol stdio server — the\n   * SDK validates this against the {@link ACPProviderConfig.key}.\n   *\n   * NB: ``npx -y @openai/codex acp`` looks plausible but is **not** an\n   * ACP server — the codex CLI has no ``acp`` subcommand and exits with\n   * ``Error: stdin is not a terminal`` when spawned without a TTY, which\n   * silently deadlocks the agent-server's ACP handshake. Use\n   * ``@zed-industries/codex-acp`` (the Zed-shipped wrapper) instead.\n   */\n  default_command: string[];\n  /**\n   * Suggested ACP model IDs for the provider's picker, sourced from the\n   * typescript-client registry. Not authoritative access checks; users can\n   * still enter a custom override in Settings -> Agent.\n   */\n  available_models?: ACPModelOption[];\n  /** Model ID preselected for built-in providers so Canvas never saves blank. */\n  default_model?: string;\n  /**\n   * i18n key for the one-line provider description rendered under the\n   * onboarding tile. Stored on the registry so adding a new ACP\n   * provider only requires editing this file (not the onboarding tile\n   * list separately).\n   */\n  description_key: I18nKey;\n  /**\n   * Serializable icon key used by UI surfaces that render provider\n   * choices. Kept as a string so the SDK mirror check can continue to\n   * parse this registry without importing React components.\n   */\n  icon?: ACPProviderIcon;\n}\n\nexport interface ACPModelOption {\n  /** Exact model ID sent as ``acp_model``. */\n  id: string;\n  /** Human-readable label shown in Settings -> Agent. */\n  label: string;\n}\n\n// Canvas-only UI metadata per built-in provider, keyed by the ACP registry\n// key. Everything else — display name, launch command, model picker list and\n// default — comes from the typescript-client registry below. Adding a model\n// or a provider happens upstream in the SDK; Canvas only owns the brand icon\n// and the onboarding-tile description here. A provider with no entry here is\n// intentionally not surfaced in the UI.\nconst ACP_PROVIDER_UI: Record<\n  string,\n  { icon: ACPProviderIcon; description_key: I18nKey }\n> = {\n  \"claude-code\": {\n    icon: \"claude-code\",\n    description_key: I18nKey.ONBOARDING$AGENT_CLAUDE_CODE_DESCRIPTION,\n  },\n  codex: {\n    icon: \"codex\",\n    description_key: I18nKey.ONBOARDING$AGENT_CODEX_DESCRIPTION,\n  },\n  \"gemini-cli\": {\n    icon: \"gemini\",\n    description_key: I18nKey.ONBOARDING$AGENT_GEMINI_CLI_DESCRIPTION,\n  },\n};\n\n// Built-in ACP providers Canvas surfaces, built by enriching each upstream\n// registry record (``@openhands/typescript-client`` → Python SDK) with the\n// Canvas UI metadata above. Model lists + defaults are no longer hand-kept\n// here (closes agent-canvas#740) — they track the SDK via the pinned client.\nexport const ACP_PROVIDERS: ACPProviderConfig[] = Object.entries(\n  ACP_PROVIDER_UI,\n).map(([key, ui]) => {\n  const info = getClientAcpProvider(key);\n  return {\n    key,\n    display_name: info?.display_name ?? key,\n    default_command: info ? [...info.default_command] : [],\n    available_models: info?.available_models?.map((model) => ({\n      id: model.id,\n      label: model.label,\n    })),\n    default_model: info?.default_model ?? undefined,\n    description_key: ui.description_key,\n    icon: ui.icon,\n  };\n});\n\nexport const ACP_CUSTOM_PRESET_KEY = \"custom\";\n\n/**\n * Look up a built-in ACP provider config by its registry key.\n *\n * Returns ``undefined`` for an empty / null key, for the ``\"custom\"`` preset\n * (which has no registry entry), and for any forward-compatible key Canvas's\n * registry doesn't know about yet. Centralizes the ``ACP_PROVIDERS.find(...)``\n * lookup shared by the resolvers below and by the adapter / settings surfaces\n * so the key-comparison shape lives in one place.\n */\nexport function getAcpProvider(\n  key: string | null | undefined,\n): ACPProviderConfig | undefined {\n  if (!key) return undefined;\n  return ACP_PROVIDERS.find((provider) => provider.key === key);\n}\n\n/**\n * Resolve an ACP provider registry key (the value stored under\n * ``tags.acpserver`` on a conversation) to a human display name for the\n * sidebar chip.\n *\n * Returns ``null`` for an empty / null key and for keys not in\n * {@link ACP_PROVIDERS} — most notably ``\"custom\"`` (the user-supplied\n * command preset has no canonical brand name) and any forward-compatible\n * value Canvas's registry doesn't know about yet. Callers should fall\n * back to a generic ``\"ACP\"`` label in that case so the chip still\n * communicates \"this is an ACP conversation\".\n *\n * Kept separate from {@link buildAcpAgentSettingsDiff}'s lookup so the\n * conversation-card render path can resolve display names without\n * importing the settings-payload builder.\n */\nexport function getAcpProviderDisplayName(\n  key: string | null | undefined,\n): string | null {\n  const found = getAcpProvider(key);\n  return found ? found.display_name : null;\n}\n\n/**\n * Resolve an ACP provider registry key to the icon discriminator the\n * conversation chip should render alongside the model text.\n *\n * Falls back to {@link ACP_PROVIDER_FALLBACK_ICON} for ``\"custom\"``,\n * unknown keys, or a missing key — the chip then shows a neutral\n * terminal glyph that still communicates \"this is an ACP conversation\"\n * without claiming a brand identity we don't know.\n */\nexport function resolveAcpProviderIcon(\n  key: string | null | undefined,\n): ACPProviderIcon {\n  return getAcpProvider(key)?.icon ?? ACP_PROVIDER_FALLBACK_ICON;\n}\n\n/**\n * Resolve a raw ``acp_model`` ID to the human-readable label the provider's\n * picker shows for it (e.g. ``\"claude-opus-4-7\"`` → ``\"Claude Opus 4.7\"``).\n *\n * Falls back to the raw ID when the provider is unknown or the ID isn't one\n * of its registered {@link ACPModelOption}s — so a user's custom override\n * still renders something meaningful rather than nothing. Returns ``null``\n * only when there is no model to show, letting the conversation chip decide\n * to display the provider name instead.\n */\nexport function labelForAcpModel(\n  serverKey: string | null | undefined,\n  modelId: string | null | undefined,\n): string | null {\n  if (!modelId) return null;\n  const provider = getAcpProvider(serverKey);\n  const match = provider?.available_models?.find((m) => m.id === modelId);\n  return match?.label ?? modelId;\n}\n\n/**\n * Build the ``agent_settings_diff`` payload PATCH /api/settings expects\n * for the agent-kind/provider choice the user just made.\n *\n * Used by both the Settings → Agent page and the onboarding \"choose\n * agent\" step — keeping the shape in one helper means a future change\n * (e.g. always seeding ``acp_command`` from the registry instead of\n * sending ``[]``, or adding new ``acp_*`` reset fields) lands in both\n * surfaces atomically.\n *\n * Returns ``null`` for an unknown ACP provider key by default — the\n * caller can skip the save (the UI shouldn't surface unknown options,\n * but the defensive path keeps a buggy preset list from corrupting\n * settings).\n *\n * Pass ``allowUnknownServer: true`` to opt into pass-through for keys\n * that aren't in {@link ACP_PROVIDERS} or ``ACP_CUSTOM_PRESET_KEY``.\n * The Settings → Agent page uses this when the user opens settings\n * that already carry an ``acp_server`` value canvas's registry\n * doesn't know about (e.g. set out-of-band via the API for a provider\n * we haven't mirrored yet) and saves without changing the command —\n * otherwise the original key would be silently demoted to ``\"custom\"``.\n */\nexport function buildAcpAgentSettingsDiff(\n  providerKey: string,\n  options: {\n    command?: string[];\n    model?: string | null;\n    allowUnknownServer?: boolean;\n  } = {},\n): Record<string, unknown> | null {\n  if (providerKey === \"openhands\") {\n    // Switching back to OpenHands. The agent-server's ``Settings.update``\n    // applies a fresh ``{'agent_kind': ...}`` base whenever the kind\n    // flips, so any ``acp_*`` fields would be discarded before\n    // validation. Send the kind alone.\n    return { agent_kind: \"openhands\" };\n  }\n\n  const isCustom = providerKey === ACP_CUSTOM_PRESET_KEY;\n  const provider = isCustom ? undefined : getAcpProvider(providerKey);\n  if (!isCustom && !provider && !options.allowUnknownServer) {\n    return null;\n  }\n\n  const model =\n    options.model === undefined\n      ? (provider?.default_model ?? null)\n      : options.model;\n\n  // ``acp_args: []`` resets any API-set ``acp_args`` that would\n  // otherwise survive and concatenate to ``acp_command`` at spawn time\n  // (the agent-server merges the two before exec). Callers building the\n  // payload from a textarea that already shows the merged command\n  // (Settings → Agent) round-trip correctly — the merged tokens land in\n  // ``acp_command`` here, so no args are lost.\n  return {\n    agent_kind: \"acp\",\n    acp_server: providerKey,\n    acp_command: options.command ?? [],\n    acp_args: [],\n    acp_model: model ?? null,\n  };\n}\n"],"mappings":";;;AAaA,IAAa,IAA2B,IAAI,IAAI,CAC9C,WACA,wBACD,CAAC;AAYF,SAAS,EAAa,GAA+B;AACnD,KAAI,OAAO,KAAU,SAAU,QAAO;CACtC,IAAM,IAAU,EAAM,MAAM;AAI5B,QAHI,CAAC,KACD,EAAyB,IAAI,EAAQ,aAAa,CAAC,IACnD,MAAA,gBAAyC,OACtC;;AAgBT,SAAgB,EAAyB,GAMvB;AAChB,MAAK,IAAM,KAAa;EACtB,EAAO;EACP,EAAO;EACP,EAAO;EACP,EAAO;EACR,EAAE;EACD,IAAM,IAAQ,EAAa,EAAU;AACrC,MAAI,EAAO,QAAO;;AAEpB,QAAO,EAAO,mBAAmB;;AAiEnC,IAAM,IAGF;CACF,eAAe;EACb,MAAM;EACN,iBAAiB,EAAQ;EAC1B;CACD,OAAO;EACL,MAAM;EACN,iBAAiB,EAAQ;EAC1B;CACD,cAAc;EACZ,MAAM;EACN,iBAAiB,EAAQ;EAC1B;CACF,EAMY,IAAqC,OAAO,QACvD,EACD,CAAC,KAAK,CAAC,GAAK,OAAQ;CACnB,IAAM,IAAO,EAAqB,EAAI;AACtC,QAAO;EACL;EACA,cAAc,GAAM,gBAAgB;EACpC,iBAAiB,IAAO,CAAC,GAAG,EAAK,gBAAgB,GAAG,EAAE;EACtD,kBAAkB,GAAM,kBAAkB,KAAK,OAAW;GACxD,IAAI,EAAM;GACV,OAAO,EAAM;GACd,EAAE;EACH,eAAe,GAAM,iBAAiB,KAAA;EACtC,iBAAiB,EAAG;EACpB,MAAM,EAAG;EACV;EACD;AAaF,SAAgB,EACd,GAC+B;AAC1B,OACL,QAAO,EAAc,MAAM,MAAa,EAAS,QAAQ,EAAI;;AAmB/D,SAAgB,EACd,GACe;CACf,IAAM,IAAQ,EAAe,EAAI;AACjC,QAAO,IAAQ,EAAM,eAAe;;AAYtC,SAAgB,EACd,GACiB;AACjB,QAAO,EAAe,EAAI,EAAE,QAAA;;AAa9B,SAAgB,EACd,GACA,GACe;AAIf,QAHK,IACY,EAAe,EAClB,EAAU,kBAAkB,MAAM,MAAM,EAAE,OAAO,EAAQ,EACzD,SAAS,IAHF"}
+{"version":3,"file":"acp-providers.js","names":[],"sources":["../../src/constants/acp-providers.ts"],"sourcesContent":["import { getAcpProvider as getClientAcpProvider } from \"@openhands/typescript-client\";\nimport { I18nKey } from \"#/i18n/declaration\";\n\nexport type ACPProviderIcon =\n  | \"claude-code\"\n  | \"codex\"\n  | \"gemini\"\n  | \"cli-generic\";\n\nexport const ACP_PROVIDER_FALLBACK_ICON: ACPProviderIcon = \"cli-generic\";\n\n// SDK placeholder strings the ACP wrapper returns before the user has\n// chosen a real model — surfacing either would lie about what's running.\nexport const ACP_DEFAULT_PLACEHOLDERS = new Set([\n  \"default\",\n  \"default (recommended)\",\n]);\n\n// Sentinel ``agent.llm.model`` returned by older SDKs for ACP conversations\n// in lieu of a real model. Suppressed at every consumer that resolves a\n// display string.\nexport const ACP_MANAGED_SENTINEL = \"acp-managed\";\n\n/**\n * Filter for \"real\" ACP model strings — non-empty, not the SDK's \"default\"\n * placeholder, not the legacy ``acp-managed`` sentinel. Returns the trimmed\n * value on success, ``null`` otherwise.\n */\nfunction realAcpModel(value: unknown): string | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  if (!trimmed) return null;\n  if (ACP_DEFAULT_PLACEHOLDERS.has(trimmed.toLowerCase())) return null;\n  if (trimmed === ACP_MANAGED_SENTINEL) return null;\n  return trimmed;\n}\n\n/**\n * Single source of truth for resolving the model string to surface for an\n * ACP conversation/settings context. Consumed by the conversation adapter\n * (chip text), the conversation-creation path (concrete ``acp_model``\n * payload), the Settings → Agent form (initial value), and the chat-input\n * model label.\n *\n * Precedence: SDK runtime fields → user-configured ``acp_model`` →\n * legacy ``agent.llm.model`` → provider default (when ``providerDefault``\n * is passed). Pass ``providerDefault`` only on surfaces that should\n * silently substitute the registry default; omit it for the conversation\n * chip, which must distinguish \"no concrete model\" from \"default\".\n */\nexport function resolveEffectiveAcpModel(inputs: {\n  runtimeName?: string | null;\n  runtimeId?: string | null;\n  configured?: string | null;\n  sdkLlm?: string | null;\n  providerDefault?: string | null;\n}): string | null {\n  for (const candidate of [\n    inputs.runtimeName,\n    inputs.runtimeId,\n    inputs.configured,\n    inputs.sdkLlm,\n  ]) {\n    const value = realAcpModel(candidate);\n    if (value) return value;\n  }\n  return inputs.providerDefault ?? null;\n}\n\n/**\n * Shape of a built-in ACP (Agent Client Protocol) provider as Canvas consumes\n * it. The data fields (display name, launch command, model picker + default)\n * are sourced at module load from ``@openhands/typescript-client``'s ACP\n * registry — the generated mirror of the Python source of truth\n * ``openhands.sdk.settings.acp_providers``. This config only adds the\n * Canvas-specific UI fields ({@link ACPProviderConfig.icon} +\n * {@link ACPProviderConfig.description_key}); see {@link ACP_PROVIDER_UI}.\n */\nexport interface ACPProviderConfig {\n  /** Stable registry key, also stored on conversations as ``tags.acpserver``. */\n  key: string;\n  /** Human-readable name shown in dropdowns and conversation chips. */\n  display_name: string;\n  /**\n   * Tokens passed to the agent-server as ``acp_command`` when this preset\n   * is picked. Each entry must be a real ACP-protocol stdio server — the\n   * SDK validates this against the {@link ACPProviderConfig.key}.\n   *\n   * NB: ``npx -y @openai/codex acp`` looks plausible but is **not** an\n   * ACP server — the codex CLI has no ``acp`` subcommand and exits with\n   * ``Error: stdin is not a terminal`` when spawned without a TTY, which\n   * silently deadlocks the agent-server's ACP handshake. Use\n   * ``@zed-industries/codex-acp`` (the Zed-shipped wrapper) instead.\n   */\n  default_command: string[];\n  /**\n   * Suggested ACP model IDs for the provider's picker, sourced from the\n   * typescript-client registry. Not authoritative access checks; users can\n   * still enter a custom override in Settings -> Agent.\n   */\n  available_models?: ACPModelOption[];\n  /** Model ID preselected for built-in providers so Canvas never saves blank. */\n  default_model?: string;\n  /**\n   * i18n key for the one-line provider description rendered under the\n   * onboarding tile. Stored on the registry so adding a new ACP\n   * provider only requires editing this file (not the onboarding tile\n   * list separately).\n   */\n  description_key: I18nKey;\n  /**\n   * Serializable icon key used by UI surfaces that render provider\n   * choices. Kept as a string so the SDK mirror check can continue to\n   * parse this registry without importing React components.\n   */\n  icon?: ACPProviderIcon;\n}\n\nexport interface ACPModelOption {\n  /** Exact model ID sent as ``acp_model``. */\n  id: string;\n  /** Human-readable label shown in Settings -> Agent. */\n  label: string;\n}\n\n// Canvas-only UI metadata per built-in provider, keyed by the ACP registry\n// key. Everything else — display name, launch command, model picker list and\n// default — comes from the typescript-client registry below. Adding a model\n// or a provider happens upstream in the SDK; Canvas only owns the brand icon\n// and the onboarding-tile description here. A provider with no entry here is\n// intentionally not surfaced in the UI.\nconst ACP_PROVIDER_UI: Record<\n  string,\n  { icon: ACPProviderIcon; description_key: I18nKey }\n> = {\n  \"claude-code\": {\n    icon: \"claude-code\",\n    description_key: I18nKey.ONBOARDING$AGENT_CLAUDE_CODE_DESCRIPTION,\n  },\n  codex: {\n    icon: \"codex\",\n    description_key: I18nKey.ONBOARDING$AGENT_CODEX_DESCRIPTION,\n  },\n  \"gemini-cli\": {\n    icon: \"gemini\",\n    description_key: I18nKey.ONBOARDING$AGENT_GEMINI_CLI_DESCRIPTION,\n  },\n};\n\n// Built-in ACP providers Canvas surfaces, built by enriching each upstream\n// registry record (``@openhands/typescript-client`` → Python SDK) with the\n// Canvas UI metadata above. Model lists + defaults are no longer hand-kept\n// here (closes agent-canvas#740) — they track the SDK via the pinned client.\nexport const ACP_PROVIDERS: ACPProviderConfig[] = Object.entries(\n  ACP_PROVIDER_UI,\n).map(([key, ui]) => {\n  const info = getClientAcpProvider(key);\n  return {\n    key,\n    display_name: info?.display_name ?? key,\n    default_command: info ? [...info.default_command] : [],\n    available_models: info?.available_models?.map((model) => ({\n      id: model.id,\n      label: model.label,\n    })),\n    default_model: info?.default_model ?? undefined,\n    description_key: ui.description_key,\n    icon: ui.icon,\n  };\n});\n\nexport const ACP_CUSTOM_PRESET_KEY = \"custom\";\n\n/**\n * A credential an ACP provider authenticates with, surfaced during onboarding\n * so the user can populate it without leaving the flow. The {@link name} is\n * both the global-secret name and the environment variable the agent-server\n * exports into the ACP subprocess — keeping them identical is what makes a\n * saved secret actually reach the provider CLI.\n */\nexport interface ACPProviderSecretField {\n  /** Secret name and env var (e.g. ``\"ANTHROPIC_API_KEY\"``). Must satisfy the\n   * secret-name pattern ``^[a-zA-Z][a-zA-Z0-9_]{0,63}$``. */\n  name: string;\n  /** Render as a masked password input (API keys) rather than a plain-text\n   * input (base URLs). Every field is optional regardless — the whole step is\n   * skippable — so this only controls masking, not whether the field gates. */\n  secret?: boolean;\n  /** i18n key for the one-line helper text under the field. */\n  hint_key: I18nKey;\n}\n\n// Credentials Canvas prompts for during onboarding, keyed by ACP registry key.\n// Only providers that authenticate through an env-var API key appear here:\n// Claude Code (Anthropic) and Codex (OpenAI). Gemini CLI authenticates via an\n// interactive OAuth login rather than a static key, so it has no entry and its\n// onboarding credentials step is skipped. Every field is optional (the step is\n// skippable): the API keys render masked, the base-URL entries are plain-text\n// overrides for proxies/gateways. A provider with no entry simply shows no\n// credentials step.\nconst ACP_PROVIDER_SECRETS: Record<string, ACPProviderSecretField[]> = {\n  \"claude-code\": [\n    {\n      name: \"ANTHROPIC_API_KEY\",\n      secret: true,\n      hint_key: I18nKey.ONBOARDING$ACP_SECRET_API_KEY_HINT,\n    },\n    {\n      name: \"ANTHROPIC_BASE_URL\",\n      hint_key: I18nKey.ONBOARDING$ACP_SECRET_BASE_URL_HINT,\n    },\n  ],\n  codex: [\n    {\n      name: \"OPENAI_API_KEY\",\n      secret: true,\n      hint_key: I18nKey.ONBOARDING$ACP_SECRET_API_KEY_HINT,\n    },\n    {\n      name: \"OPENAI_BASE_URL\",\n      hint_key: I18nKey.ONBOARDING$ACP_SECRET_BASE_URL_HINT,\n    },\n  ],\n};\n\n/**\n * List the credentials Canvas should prompt for when onboarding the given ACP\n * provider. Returns ``[]`` for OpenHands, the ``\"custom\"`` preset, providers\n * that don't use a static API key (Gemini CLI), and any unknown key — callers\n * treat an empty list as \"no credentials step for this provider\".\n */\nexport function getAcpProviderSecrets(\n  key: string | null | undefined,\n): ACPProviderSecretField[] {\n  if (!key) return [];\n  return ACP_PROVIDER_SECRETS[key] ?? [];\n}\n\n/**\n * Look up a built-in ACP provider config by its registry key.\n *\n * Returns ``undefined`` for an empty / null key, for the ``\"custom\"`` preset\n * (which has no registry entry), and for any forward-compatible key Canvas's\n * registry doesn't know about yet. Centralizes the ``ACP_PROVIDERS.find(...)``\n * lookup shared by the resolvers below and by the adapter / settings surfaces\n * so the key-comparison shape lives in one place.\n */\nexport function getAcpProvider(\n  key: string | null | undefined,\n): ACPProviderConfig | undefined {\n  if (!key) return undefined;\n  return ACP_PROVIDERS.find((provider) => provider.key === key);\n}\n\n/**\n * Resolve an ACP provider registry key (the value stored under\n * ``tags.acpserver`` on a conversation) to a human display name for the\n * sidebar chip.\n *\n * Returns ``null`` for an empty / null key and for keys not in\n * {@link ACP_PROVIDERS} — most notably ``\"custom\"`` (the user-supplied\n * command preset has no canonical brand name) and any forward-compatible\n * value Canvas's registry doesn't know about yet. Callers should fall\n * back to a generic ``\"ACP\"`` label in that case so the chip still\n * communicates \"this is an ACP conversation\".\n *\n * Kept separate from {@link buildAcpAgentSettingsDiff}'s lookup so the\n * conversation-card render path can resolve display names without\n * importing the settings-payload builder.\n */\nexport function getAcpProviderDisplayName(\n  key: string | null | undefined,\n): string | null {\n  const found = getAcpProvider(key);\n  return found ? found.display_name : null;\n}\n\n/**\n * Resolve an ACP provider registry key to the icon discriminator the\n * conversation chip should render alongside the model text.\n *\n * Falls back to {@link ACP_PROVIDER_FALLBACK_ICON} for ``\"custom\"``,\n * unknown keys, or a missing key — the chip then shows a neutral\n * terminal glyph that still communicates \"this is an ACP conversation\"\n * without claiming a brand identity we don't know.\n */\nexport function resolveAcpProviderIcon(\n  key: string | null | undefined,\n): ACPProviderIcon {\n  return getAcpProvider(key)?.icon ?? ACP_PROVIDER_FALLBACK_ICON;\n}\n\n/**\n * Resolve a raw ``acp_model`` ID to the human-readable label the provider's\n * picker shows for it (e.g. ``\"claude-opus-4-7\"`` → ``\"Claude Opus 4.7\"``).\n *\n * Falls back to the raw ID when the provider is unknown or the ID isn't one\n * of its registered {@link ACPModelOption}s — so a user's custom override\n * still renders something meaningful rather than nothing. Returns ``null``\n * only when there is no model to show, letting the conversation chip decide\n * to display the provider name instead.\n */\nexport function labelForAcpModel(\n  serverKey: string | null | undefined,\n  modelId: string | null | undefined,\n): string | null {\n  if (!modelId) return null;\n  const provider = getAcpProvider(serverKey);\n  const match = provider?.available_models?.find((m) => m.id === modelId);\n  return match?.label ?? modelId;\n}\n\n/**\n * Build the ``agent_settings_diff`` payload PATCH /api/settings expects\n * for the agent-kind/provider choice the user just made.\n *\n * Used by both the Settings → Agent page and the onboarding \"choose\n * agent\" step — keeping the shape in one helper means a future change\n * (e.g. always seeding ``acp_command`` from the registry instead of\n * sending ``[]``, or adding new ``acp_*`` reset fields) lands in both\n * surfaces atomically.\n *\n * Returns ``null`` for an unknown ACP provider key by default — the\n * caller can skip the save (the UI shouldn't surface unknown options,\n * but the defensive path keeps a buggy preset list from corrupting\n * settings).\n *\n * Pass ``allowUnknownServer: true`` to opt into pass-through for keys\n * that aren't in {@link ACP_PROVIDERS} or ``ACP_CUSTOM_PRESET_KEY``.\n * The Settings → Agent page uses this when the user opens settings\n * that already carry an ``acp_server`` value canvas's registry\n * doesn't know about (e.g. set out-of-band via the API for a provider\n * we haven't mirrored yet) and saves without changing the command —\n * otherwise the original key would be silently demoted to ``\"custom\"``.\n */\nexport function buildAcpAgentSettingsDiff(\n  providerKey: string,\n  options: {\n    command?: string[];\n    model?: string | null;\n    allowUnknownServer?: boolean;\n  } = {},\n): Record<string, unknown> | null {\n  if (providerKey === \"openhands\") {\n    // Switching back to OpenHands. The agent-server's ``Settings.update``\n    // applies a fresh ``{'agent_kind': ...}`` base whenever the kind\n    // flips, so any ``acp_*`` fields would be discarded before\n    // validation. Send the kind alone.\n    return { agent_kind: \"openhands\" };\n  }\n\n  const isCustom = providerKey === ACP_CUSTOM_PRESET_KEY;\n  const provider = isCustom ? undefined : getAcpProvider(providerKey);\n  if (!isCustom && !provider && !options.allowUnknownServer) {\n    return null;\n  }\n\n  const model =\n    options.model === undefined\n      ? (provider?.default_model ?? null)\n      : options.model;\n\n  // ``acp_args: []`` resets any API-set ``acp_args`` that would\n  // otherwise survive and concatenate to ``acp_command`` at spawn time\n  // (the agent-server merges the two before exec). Callers building the\n  // payload from a textarea that already shows the merged command\n  // (Settings → Agent) round-trip correctly — the merged tokens land in\n  // ``acp_command`` here, so no args are lost.\n  return {\n    agent_kind: \"acp\",\n    acp_server: providerKey,\n    acp_command: options.command ?? [],\n    acp_args: [],\n    acp_model: model ?? null,\n  };\n}\n"],"mappings":";;;AAaA,IAAa,IAA2B,IAAI,IAAI,CAC9C,WACA,wBACD,CAAC;AAYF,SAAS,EAAa,GAA+B;AACnD,KAAI,OAAO,KAAU,SAAU,QAAO;CACtC,IAAM,IAAU,EAAM,MAAM;AAI5B,QAHI,CAAC,KACD,EAAyB,IAAI,EAAQ,aAAa,CAAC,IACnD,MAAA,gBAAyC,OACtC;;AAgBT,SAAgB,EAAyB,GAMvB;AAChB,MAAK,IAAM,KAAa;EACtB,EAAO;EACP,EAAO;EACP,EAAO;EACP,EAAO;EACR,EAAE;EACD,IAAM,IAAQ,EAAa,EAAU;AACrC,MAAI,EAAO,QAAO;;AAEpB,QAAO,EAAO,mBAAmB;;AAiEnC,IAAM,IAGF;CACF,eAAe;EACb,MAAM;EACN,iBAAiB,EAAQ;EAC1B;CACD,OAAO;EACL,MAAM;EACN,iBAAiB,EAAQ;EAC1B;CACD,cAAc;EACZ,MAAM;EACN,iBAAiB,EAAQ;EAC1B;CACF,EAMY,IAAqC,OAAO,QACvD,EACD,CAAC,KAAK,CAAC,GAAK,OAAQ;CACnB,IAAM,IAAO,EAAqB,EAAI;AACtC,QAAO;EACL;EACA,cAAc,GAAM,gBAAgB;EACpC,iBAAiB,IAAO,CAAC,GAAG,EAAK,gBAAgB,GAAG,EAAE;EACtD,kBAAkB,GAAM,kBAAkB,KAAK,OAAW;GACxD,IAAI,EAAM;GACV,OAAO,EAAM;GACd,EAAE;EACH,eAAe,GAAM,iBAAiB,KAAA;EACtC,iBAAiB,EAAG;EACpB,MAAM,EAAG;EACV;EACD;AAoCc,EAAQ,oCAIR,EAAQ,qCAOR,EAAQ,oCAIR,EAAQ;AA2BxB,SAAgB,EACd,GAC+B;AAC1B,OACL,QAAO,EAAc,MAAM,MAAa,EAAS,QAAQ,EAAI;;AAmB/D,SAAgB,EACd,GACe;CACf,IAAM,IAAQ,EAAe,EAAI;AACjC,QAAO,IAAQ,EAAM,eAAe;;AAYtC,SAAgB,EACd,GACiB;AACjB,QAAO,EAAe,EAAI,EAAE,QAAA;;AAa9B,SAAgB,EACd,GACA,GACe;AAIf,QAHK,IACY,EAAe,EAClB,EAAU,kBAAkB,MAAM,MAAM,EAAE,OAAO,EAAQ,EACzD,SAAS,IAHF"}