@openhands/agent-canvas 1.15.0 → 1.16.0

package/dist/hooks/use-pinned-home-route.js

@@ -0,0 +1,34 @@
+import "../api/backend-registry/active-store.js";
+import { useActiveBackend as e } from "../contexts/active-backend-context.js";
+import { automationListPath as t, hasAutomationInterface as n } from "../manifests/automation-interface.js";
+import { useLocalStorage as r } from "../node_modules/@uidotdev/usehooks/index.js";
+import { useCallback as i, useMemo as a } from "react";
+//#region src/hooks/use-pinned-home-route.ts
+var o = "oh:pinned-home-route", s = "/customize";
+function c(e, t) {
+	return `${o}:${e}:${t ?? "-"}`;
+}
+function l(e) {
+	return e === "/customize" ? !0 : e === t() ? n() : !1;
+}
+function u(e) {
+	return typeof e != "string" || !e ? null : l(e) ? e : null;
+}
+function d() {
+	let t = e(), [n, o] = r(c(t.backend.id, t.orgId), null), s = a(() => u(n), [n]);
+	return {
+		pinnedRoute: s,
+		isPinnedRoute: i((e) => s === e, [s]),
+		togglePinnedRoute: i((e) => {
+			if (s === e) {
+				o(null);
+				return;
+			}
+			l(e) && o(e);
+		}, [s, o])
+	};
+}
+//#endregion
+export { s as CUSTOMIZE_PATH, d as usePinnedHomeRoute };
+
+//# sourceMappingURL=use-pinned-home-route.js.map

package/dist/hooks/use-pinned-home-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-pinned-home-route.js","names":[],"sources":["../../src/hooks/use-pinned-home-route.ts"],"sourcesContent":["import { useLocalStorage } from \"@uidotdev/usehooks\";\nimport { useCallback, useMemo } from \"react\";\nimport {\n  getActiveBackend,\n  isNoBackend,\n} from \"#/api/backend-registry/active-store\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport {\n  automationListPath,\n  hasAutomationInterface,\n} from \"#/manifests/automation-interface\";\n\nexport const PINNED_HOME_ROUTE_KEY = \"oh:pinned-home-route\";\n\n/** Sidebar Customize entry; also the pin target, so the two cannot drift. */\nexport const CUSTOMIZE_PATH = \"/customize\";\n\n/**\n * The pin is stored per backend + org: it may reference a surface that only\n * exists on the backend that set it (e.g. /automations requires that\n * deployment's interface manifest) — a shared key would let one backend\n * redirect `/` on another.\n */\nexport function getPinnedHomeRouteKey(\n  backendId: string,\n  orgId: string | null,\n): string {\n  return `${PINNED_HOME_ROUTE_KEY}:${backendId}:${orgId ?? \"-\"}`;\n}\n\n/**\n * Whether `path` may serve as the home route right now. Shared by the\n * sidebar pin affordance and the `/` loader, so a stored pin that stops\n * resolving (backend switch, manifest absent) is ignored rather than an\n * error. `/` is never pinnable, which makes a redirect loop impossible.\n * Canvas Extensions pages can later add an `/extensions/…` branch here\n * without any storage or loader change.\n */\nexport function isPinnableRoute(path: string): boolean {\n  if (path === CUSTOMIZE_PATH) return true;\n  if (path === automationListPath()) return hasAutomationInterface();\n  return false;\n}\n\nfunction sanitizePinnedRoute(value: unknown): string | null {\n  if (typeof value !== \"string\" || !value) return null;\n  return isPinnableRoute(value) ? value : null;\n}\n\n/**\n * Synchronous pin read for route loaders (no React context). Reads the key\n * `usePinnedHomeRoute` writes; `useLocalStorage` JSON-serializes values, so\n * parse defensively and treat anything unreadable as \"no pin\". An invalid\n * pin is ignored, not cleared — it may become valid again (e.g. the\n * automations interface returning after a backend switch back).\n */\nexport function readPinnedHomeRoute(): string | null {\n  const active = getActiveBackend();\n  if (isNoBackend(active.backend)) return null;\n\n  let raw: string | null = null;\n  try {\n    raw = window.localStorage.getItem(\n      getPinnedHomeRouteKey(active.backend.id, active.orgId),\n    );\n  } catch {\n    return null;\n  }\n  if (raw === null) return null;\n\n  try {\n    return sanitizePinnedRoute(JSON.parse(raw));\n  } catch {\n    return null;\n  }\n}\n\n/** Pin state for the home route: `/` redirects to the pinned sidebar page. */\nexport function usePinnedHomeRoute() {\n  const active = useActiveBackend();\n  const [rawPinnedRoute, setRawPinnedRoute] = useLocalStorage<string | null>(\n    getPinnedHomeRouteKey(active.backend.id, active.orgId),\n    null,\n  );\n\n  const pinnedRoute = useMemo(\n    () => sanitizePinnedRoute(rawPinnedRoute),\n    [rawPinnedRoute],\n  );\n\n  const isPinnedRoute = useCallback(\n    (path: string) => pinnedRoute === path,\n    [pinnedRoute],\n  );\n\n  const togglePinnedRoute = useCallback(\n    (path: string) => {\n      if (pinnedRoute === path) {\n        setRawPinnedRoute(null);\n        return;\n      }\n      if (!isPinnableRoute(path)) return;\n      setRawPinnedRoute(path);\n    },\n    [pinnedRoute, setRawPinnedRoute],\n  );\n\n  return {\n    pinnedRoute,\n    isPinnedRoute,\n    togglePinnedRoute,\n  };\n}\n"],"mappings":";;;;;;AAYA,IAAa,IAAwB,wBAGxB,IAAiB;AAQ9B,SAAgB,EACd,GACA,GACQ;CACR,OAAO,GAAG,EAAsB,GAAG,EAAU,GAAG,KAAS;AAC3D;AAUA,SAAgB,EAAgB,GAAuB;CAGrD,OAFI,MAAA,eAAgC,KAChC,MAAS,EAAmB,IAAU,EAAuB,IAC1D;AACT;AAEA,SAAS,EAAoB,GAA+B;CAE1D,OADI,OAAO,KAAU,YAAY,CAAC,IAAc,OACzC,EAAgB,CAAK,IAAI,IAAQ;AAC1C;AA+BA,SAAgB,IAAqB;CACnC,IAAM,IAAS,EAAiB,GAC1B,CAAC,GAAgB,KAAqB,EAC1C,EAAsB,EAAO,QAAQ,IAAI,EAAO,KAAK,GACrD,IACF,GAEM,IAAc,QACZ,EAAoB,CAAc,GACxC,CAAC,CAAc,CACjB;CAmBA,OAAO;EACL;EACA,eAnBoB,GACnB,MAAiB,MAAgB,GAClC,CAAC,CAAW,CAiBZ;EACA,mBAfwB,GACvB,MAAiB;GAChB,IAAI,MAAgB,GAAM;IACxB,EAAkB,IAAI;IACtB;GACF;GACK,EAAgB,CAAI,KACzB,EAAkB,CAAI;EACxB,GACA,CAAC,GAAa,CAAiB,CAM/B;CACF;AACF"}

package/dist/hooks/use-skill-enablement.cjs

@@ -0,0 +1,2 @@
+const e=require("../_virtual/_rolldown/runtime.cjs"),t=require("../node_modules/react-i18next/dist/es/useTranslation.cjs"),n=require("../i18n/declaration.cjs"),r=require("../utils/retrieve-axios-error-message.cjs"),i=require("../utils/custom-toast-handlers.cjs"),a=require("../contexts/active-backend-context.cjs"),o=require("../utils/skill-enablement.cjs"),s=require("./query/use-settings.cjs"),c=require("./mutation/use-save-settings.cjs");let l=require("react");l=e.__toESM(l,1);function u(e,t){return{enabledSkills:t?e?.enabled_skills:[...o.CATALOG_SKILL_NAMES],disabledSkills:e?.disabled_skills??[]}}function d(){let{backend:e}=a.useActiveBackend(),{data:t}=s.useSettings(),n=e.kind!==`cloud`;return l.default.useMemo(()=>{let e=o.buildSkillEnablementFilter(u(t,n));return t=>e(t.name)},[t?.enabled_skills,t?.disabled_skills,n])}function f(e){return JSON.stringify([[...o.resolveEnabledCatalogSkills(e)].sort(),[...e.disabledSkills??[]].sort()])}function p(e,t,n){return e.includes(t)===n?e:n?[...e,t]:e.filter(e=>e!==t)}function m(){let{t:e}=t.useTranslation(`openhands`),{backend:d}=a.useActiveBackend(),m=d.kind!==`cloud`,{data:h,isLoading:g}=s.useSettings(),{mutate:_}=c.useSaveSettings(),[v,y]=l.default.useState({}),b=l.default.useRef(null);return l.default.useEffect(()=>{if(g||!h)return;let e=u(h,m);b.current=f(e),y(e)},[g,h?.enabled_skills,h?.disabled_skills,m]),l.default.useEffect(()=>{let t=f(v);if(b.current===null||b.current===t)return;b.current=t;let a=v.disabledSkills??[];_(m?{enabled_skills:o.resolveEnabledCatalogSkills(v),disabled_skills:a}:{disabled_skills:a},{onError:t=>{i.displayErrorToast(r.retrieveAxiosErrorMessage(t)||e(n.I18nKey.ERROR$GENERIC))}})},[v,m,_,e]),{isEnabled:l.default.useMemo(()=>{let e=o.buildSkillEnablementFilter(v);return t=>e(t.name)},[v]),setEnabled:l.default.useCallback((e,t)=>{y(n=>{let r=m&&o.isCatalogSkill(e);return{enabledSkills:r?p(o.resolveEnabledCatalogSkills(n),e,t):n.enabledSkills,disabledSkills:p(n.disabledSkills??[],e,!t&&!r)}})},[m])}}exports.useSkillEnabledFilter=d,exports.useSkillEnablement=m;
+//# sourceMappingURL=use-skill-enablement.cjs.map

package/dist/hooks/use-skill-enablement.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-skill-enablement.cjs","names":[],"sources":["../../src/hooks/use-skill-enablement.ts"],"sourcesContent":["import React from \"react\";\nimport { useTranslation } from \"react-i18next\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { useSaveSettings } from \"#/hooks/mutation/use-save-settings\";\nimport { useSettings } from \"#/hooks/query/use-settings\";\nimport { I18nKey } from \"#/i18n/declaration\";\nimport type { Settings, SkillInfo } from \"#/types/settings\";\nimport { displayErrorToast } from \"#/utils/custom-toast-handlers\";\nimport { retrieveAxiosErrorMessage } from \"#/utils/retrieve-axios-error-message\";\nimport {\n  buildSkillEnablementFilter,\n  CATALOG_SKILL_NAMES,\n  isCatalogSkill,\n  resolveEnabledCatalogSkills,\n  type SkillEnablement,\n} from \"#/utils/skill-enablement\";\n\n/**\n * Settings → the two lists. Cloud creates conversations from its own\n * server-side catalog and never reads `enabled_skills`, so the catalog stays\n * deny-list governed there.\n */\nfunction readSkillEnablement(\n  settings: Settings | undefined,\n  usesCatalogAllowList: boolean,\n): SkillEnablement {\n  return {\n    enabledSkills: usesCatalogAllowList\n      ? settings?.enabled_skills\n      : [...CATALOG_SKILL_NAMES],\n    disabledSkills: settings?.disabled_skills ?? [],\n  };\n}\n\n/** Read-only view of the rule, for surfaces that list skills without toggling. */\nexport function useSkillEnabledFilter(): (skill: SkillInfo) => boolean {\n  const { backend } = useActiveBackend();\n  const { data: settings } = useSettings();\n  const usesCatalogAllowList = backend.kind !== \"cloud\";\n\n  return React.useMemo(() => {\n    const isEnabled = buildSkillEnablementFilter(\n      readSkillEnablement(settings, usesCatalogAllowList),\n    );\n    return (skill: SkillInfo) => isEnabled(skill.name);\n  }, [\n    settings?.enabled_skills,\n    settings?.disabled_skills,\n    usesCatalogAllowList,\n  ]);\n}\n\nexport interface SkillEnablementController {\n  isEnabled: (skill: SkillInfo) => boolean;\n  setEnabled: (skillName: string, enabled: boolean) => void;\n}\n\n/** Stable form of both lists, so an unchanged set can skip the save. */\nfunction snapshot(enablement: SkillEnablement): string {\n  return JSON.stringify([\n    [...resolveEnabledCatalogSkills(enablement)].sort(),\n    [...(enablement.disabledSkills ?? [])].sort(),\n  ]);\n}\n\n/** Same array reference when the membership already matches, to skip a save. */\nfunction withMembership(\n  list: string[],\n  name: string,\n  present: boolean,\n): string[] {\n  if (list.includes(name) === present) return list;\n  return present ? [...list, name] : list.filter((entry) => entry !== name);\n}\n\n/**\n * Shared toggle state for every surface that switches skills on and off.\n *\n * Which of the two lists a skill belongs to is decided here alone, so one\n * surface cannot write a preference another cannot see.\n */\nexport function useSkillEnablement(): SkillEnablementController {\n  const { t } = useTranslation(\"openhands\");\n  const { backend } = useActiveBackend();\n  const usesCatalogAllowList = backend.kind !== \"cloud\";\n  const { data: settings, isLoading: settingsLoading } = useSettings();\n  const { mutate: saveSettings } = useSaveSettings();\n\n  const [enablement, setEnablement] = React.useState<SkillEnablement>({});\n  const savedRef = React.useRef<string | null>(null);\n\n  React.useEffect(() => {\n    if (settingsLoading || !settings) return;\n    const hydrated = readSkillEnablement(settings, usesCatalogAllowList);\n    savedRef.current = snapshot(hydrated);\n    setEnablement(hydrated);\n  }, [\n    settingsLoading,\n    settings?.enabled_skills,\n    settings?.disabled_skills,\n    usesCatalogAllowList,\n  ]);\n\n  React.useEffect(() => {\n    // Writing the hydrated value straight back would race the one-shot\n    // migration and could narrow a workspace it had just preserved.\n    const next = snapshot(enablement);\n    if (savedRef.current === null || savedRef.current === next) return;\n    savedRef.current = next;\n\n    const disabledSkills = enablement.disabledSkills ?? [];\n    saveSettings(\n      usesCatalogAllowList\n        ? {\n            enabled_skills: resolveEnabledCatalogSkills(enablement),\n            disabled_skills: disabledSkills,\n          }\n        : { disabled_skills: disabledSkills },\n      {\n        onError: (error) => {\n          displayErrorToast(\n            retrieveAxiosErrorMessage(error) || t(I18nKey.ERROR$GENERIC),\n          );\n        },\n      },\n    );\n  }, [enablement, usesCatalogAllowList, saveSettings, t]);\n\n  const isEnabled = React.useMemo(() => {\n    const enabled = buildSkillEnablementFilter(enablement);\n    return (skill: SkillInfo) => enabled(skill.name);\n  }, [enablement]);\n\n  const setEnabled = React.useCallback(\n    (skillName: string, enabled: boolean) => {\n      setEnablement((previous) => {\n        const allowListed = usesCatalogAllowList && isCatalogSkill(skillName);\n        return {\n          enabledSkills: allowListed\n            ? withMembership(\n                resolveEnabledCatalogSkills(previous),\n                skillName,\n                enabled,\n              )\n            : previous.enabledSkills,\n          // A catalog skill switched back on also leaves the deny-list, where\n          // an unmigrated workspace may still hold it.\n          disabledSkills: withMembership(\n            previous.disabledSkills ?? [],\n            skillName,\n            !enabled && !allowListed,\n          ),\n        };\n      });\n    },\n    [usesCatalogAllowList],\n  );\n\n  return { isEnabled, setEnabled };\n}\n"],"mappings":"keAsBA,SAAS,EACP,EACA,EACiB,CACjB,MAAO,CACL,cAAe,EACX,GAAU,eACV,CAAC,GAAG,EAAA,mBAAmB,EAC3B,eAAgB,GAAU,iBAAmB,CAAC,CAChD,CACF,CAGA,SAAgB,GAAuD,CACrE,GAAM,CAAE,WAAY,EAAA,iBAAiB,EAC/B,CAAE,KAAM,GAAa,EAAA,YAAY,EACjC,EAAuB,EAAQ,OAAS,QAE9C,OAAO,EAAA,QAAM,YAAc,CACzB,IAAM,EAAY,EAAA,2BAChB,EAAoB,EAAU,CAAoB,CACpD,EACA,MAAQ,IAAqB,EAAU,EAAM,IAAI,CACnD,EAAG,CACD,GAAU,eACV,GAAU,gBACV,CACF,CAAC,CACH,CAQA,SAAS,EAAS,EAAqC,CACrD,OAAO,KAAK,UAAU,CACpB,CAAC,GAAG,EAAA,4BAA4B,CAAU,CAAC,EAAE,KAAK,EAClD,CAAC,GAAI,EAAW,gBAAkB,CAAC,CAAE,EAAE,KAAK,CAC9C,CAAC,CACH,CAGA,SAAS,EACP,EACA,EACA,EACU,CAEV,OADI,EAAK,SAAS,CAAI,IAAM,EAAgB,EACrC,EAAU,CAAC,GAAG,EAAM,CAAI,EAAI,EAAK,OAAQ,GAAU,IAAU,CAAI,CAC1E,CAQA,SAAgB,GAAgD,CAC9D,GAAM,CAAE,KAAM,EAAA,eAAe,WAAW,EAClC,CAAE,WAAY,EAAA,iBAAiB,EAC/B,EAAuB,EAAQ,OAAS,QACxC,CAAE,KAAM,EAAU,UAAW,GAAoB,EAAA,YAAY,EAC7D,CAAE,OAAQ,GAAiB,EAAA,gBAAgB,EAE3C,CAAC,EAAY,GAAiB,EAAA,QAAM,SAA0B,CAAC,CAAC,EAChE,EAAW,EAAA,QAAM,OAAsB,IAAI,EAqEjD,OAnEA,EAAA,QAAM,cAAgB,CACpB,GAAI,GAAmB,CAAC,EAAU,OAClC,IAAM,EAAW,EAAoB,EAAU,CAAoB,EACnE,EAAS,QAAU,EAAS,CAAQ,EACpC,EAAc,CAAQ,CACxB,EAAG,CACD,EACA,GAAU,eACV,GAAU,gBACV,CACF,CAAC,EAED,EAAA,QAAM,cAAgB,CAGpB,IAAM,EAAO,EAAS,CAAU,EAChC,GAAI,EAAS,UAAY,MAAQ,EAAS,UAAY,EAAM,OAC5D,EAAS,QAAU,EAEnB,IAAM,EAAiB,EAAW,gBAAkB,CAAC,EACrD,EACE,EACI,CACE,eAAgB,EAAA,4BAA4B,CAAU,EACtD,gBAAiB,CACnB,EACA,CAAE,gBAAiB,CAAe,EACtC,CACE,QAAU,GAAU,CAClB,EAAA,kBACE,EAAA,0BAA0B,CAAK,GAAK,EAAE,EAAA,QAAQ,aAAa,CAC7D,CACF,CACF,CACF,CACF,EAAG,CAAC,EAAY,EAAsB,EAAc,CAAC,CAAC,EAgC/C,CAAE,UA9BS,EAAA,QAAM,YAAc,CACpC,IAAM,EAAU,EAAA,2BAA2B,CAAU,EACrD,MAAQ,IAAqB,EAAQ,EAAM,IAAI,CACjD,EAAG,CAAC,CAAU,CA2BL,EAAW,WAzBD,EAAA,QAAM,aACtB,EAAmB,IAAqB,CACvC,EAAe,GAAa,CAC1B,IAAM,EAAc,GAAwB,EAAA,eAAe,CAAS,EACpE,MAAO,CACL,cAAe,EACX,EACE,EAAA,4BAA4B,CAAQ,EACpC,EACA,CACF,EACA,EAAS,cAGb,eAAgB,EACd,EAAS,gBAAkB,CAAC,EAC5B,EACA,CAAC,GAAW,CAAC,CACf,CACF,CACF,CAAC,CACH,EACA,CAAC,CAAoB,CAGH,CAAW,CACjC"}

package/dist/hooks/use-skill-enablement.d.ts

@@ -0,0 +1,14 @@
+import type { SkillInfo } from "#/types/settings";
+/** Read-only view of the rule, for surfaces that list skills without toggling. */
+export declare function useSkillEnabledFilter(): (skill: SkillInfo) => boolean;
+export interface SkillEnablementController {
+    isEnabled: (skill: SkillInfo) => boolean;
+    setEnabled: (skillName: string, enabled: boolean) => void;
+}
+/**
+ * Shared toggle state for every surface that switches skills on and off.
+ *
+ * Which of the two lists a skill belongs to is decided here alone, so one
+ * surface cannot write a preference another cannot see.
+ */
+export declare function useSkillEnablement(): SkillEnablementController;

package/dist/hooks/use-skill-enablement.js

@@ -0,0 +1,80 @@
+import { useTranslation as e } from "../node_modules/react-i18next/dist/es/useTranslation.js";
+import { I18nKey as t } from "../i18n/declaration.js";
+import { retrieveAxiosErrorMessage as n } from "../utils/retrieve-axios-error-message.js";
+import { displayErrorToast as r } from "../utils/custom-toast-handlers.js";
+import { useActiveBackend as i } from "../contexts/active-backend-context.js";
+import { CATALOG_SKILL_NAMES as a, buildSkillEnablementFilter as o, isCatalogSkill as s, resolveEnabledCatalogSkills as c } from "../utils/skill-enablement.js";
+import { useSettings as l } from "./query/use-settings.js";
+import { useSaveSettings as u } from "./mutation/use-save-settings.js";
+import d from "react";
+//#region src/hooks/use-skill-enablement.ts
+function f(e, t) {
+	return {
+		enabledSkills: t ? e?.enabled_skills : [...a],
+		disabledSkills: e?.disabled_skills ?? []
+	};
+}
+function p() {
+	let { backend: e } = i(), { data: t } = l(), n = e.kind !== "cloud";
+	return d.useMemo(() => {
+		let e = o(f(t, n));
+		return (t) => e(t.name);
+	}, [
+		t?.enabled_skills,
+		t?.disabled_skills,
+		n
+	]);
+}
+function m(e) {
+	return JSON.stringify([[...c(e)].sort(), [...e.disabledSkills ?? []].sort()]);
+}
+function h(e, t, n) {
+	return e.includes(t) === n ? e : n ? [...e, t] : e.filter((e) => e !== t);
+}
+function g() {
+	let { t: a } = e("openhands"), { backend: p } = i(), g = p.kind !== "cloud", { data: _, isLoading: v } = l(), { mutate: y } = u(), [b, x] = d.useState({}), S = d.useRef(null);
+	return d.useEffect(() => {
+		if (v || !_) return;
+		let e = f(_, g);
+		S.current = m(e), x(e);
+	}, [
+		v,
+		_?.enabled_skills,
+		_?.disabled_skills,
+		g
+	]), d.useEffect(() => {
+		let e = m(b);
+		if (S.current === null || S.current === e) return;
+		S.current = e;
+		let i = b.disabledSkills ?? [];
+		y(g ? {
+			enabled_skills: c(b),
+			disabled_skills: i
+		} : { disabled_skills: i }, { onError: (e) => {
+			r(n(e) || a(t.ERROR$GENERIC));
+		} });
+	}, [
+		b,
+		g,
+		y,
+		a
+	]), {
+		isEnabled: d.useMemo(() => {
+			let e = o(b);
+			return (t) => e(t.name);
+		}, [b]),
+		setEnabled: d.useCallback((e, t) => {
+			x((n) => {
+				let r = g && s(e);
+				return {
+					enabledSkills: r ? h(c(n), e, t) : n.enabledSkills,
+					disabledSkills: h(n.disabledSkills ?? [], e, !t && !r)
+				};
+			});
+		}, [g])
+	};
+}
+//#endregion
+export { p as useSkillEnabledFilter, g as useSkillEnablement };
+
+//# sourceMappingURL=use-skill-enablement.js.map

package/dist/hooks/use-skill-enablement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-skill-enablement.js","names":[],"sources":["../../src/hooks/use-skill-enablement.ts"],"sourcesContent":["import React from \"react\";\nimport { useTranslation } from \"react-i18next\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { useSaveSettings } from \"#/hooks/mutation/use-save-settings\";\nimport { useSettings } from \"#/hooks/query/use-settings\";\nimport { I18nKey } from \"#/i18n/declaration\";\nimport type { Settings, SkillInfo } from \"#/types/settings\";\nimport { displayErrorToast } from \"#/utils/custom-toast-handlers\";\nimport { retrieveAxiosErrorMessage } from \"#/utils/retrieve-axios-error-message\";\nimport {\n  buildSkillEnablementFilter,\n  CATALOG_SKILL_NAMES,\n  isCatalogSkill,\n  resolveEnabledCatalogSkills,\n  type SkillEnablement,\n} from \"#/utils/skill-enablement\";\n\n/**\n * Settings → the two lists. Cloud creates conversations from its own\n * server-side catalog and never reads `enabled_skills`, so the catalog stays\n * deny-list governed there.\n */\nfunction readSkillEnablement(\n  settings: Settings | undefined,\n  usesCatalogAllowList: boolean,\n): SkillEnablement {\n  return {\n    enabledSkills: usesCatalogAllowList\n      ? settings?.enabled_skills\n      : [...CATALOG_SKILL_NAMES],\n    disabledSkills: settings?.disabled_skills ?? [],\n  };\n}\n\n/** Read-only view of the rule, for surfaces that list skills without toggling. */\nexport function useSkillEnabledFilter(): (skill: SkillInfo) => boolean {\n  const { backend } = useActiveBackend();\n  const { data: settings } = useSettings();\n  const usesCatalogAllowList = backend.kind !== \"cloud\";\n\n  return React.useMemo(() => {\n    const isEnabled = buildSkillEnablementFilter(\n      readSkillEnablement(settings, usesCatalogAllowList),\n    );\n    return (skill: SkillInfo) => isEnabled(skill.name);\n  }, [\n    settings?.enabled_skills,\n    settings?.disabled_skills,\n    usesCatalogAllowList,\n  ]);\n}\n\nexport interface SkillEnablementController {\n  isEnabled: (skill: SkillInfo) => boolean;\n  setEnabled: (skillName: string, enabled: boolean) => void;\n}\n\n/** Stable form of both lists, so an unchanged set can skip the save. */\nfunction snapshot(enablement: SkillEnablement): string {\n  return JSON.stringify([\n    [...resolveEnabledCatalogSkills(enablement)].sort(),\n    [...(enablement.disabledSkills ?? [])].sort(),\n  ]);\n}\n\n/** Same array reference when the membership already matches, to skip a save. */\nfunction withMembership(\n  list: string[],\n  name: string,\n  present: boolean,\n): string[] {\n  if (list.includes(name) === present) return list;\n  return present ? [...list, name] : list.filter((entry) => entry !== name);\n}\n\n/**\n * Shared toggle state for every surface that switches skills on and off.\n *\n * Which of the two lists a skill belongs to is decided here alone, so one\n * surface cannot write a preference another cannot see.\n */\nexport function useSkillEnablement(): SkillEnablementController {\n  const { t } = useTranslation(\"openhands\");\n  const { backend } = useActiveBackend();\n  const usesCatalogAllowList = backend.kind !== \"cloud\";\n  const { data: settings, isLoading: settingsLoading } = useSettings();\n  const { mutate: saveSettings } = useSaveSettings();\n\n  const [enablement, setEnablement] = React.useState<SkillEnablement>({});\n  const savedRef = React.useRef<string | null>(null);\n\n  React.useEffect(() => {\n    if (settingsLoading || !settings) return;\n    const hydrated = readSkillEnablement(settings, usesCatalogAllowList);\n    savedRef.current = snapshot(hydrated);\n    setEnablement(hydrated);\n  }, [\n    settingsLoading,\n    settings?.enabled_skills,\n    settings?.disabled_skills,\n    usesCatalogAllowList,\n  ]);\n\n  React.useEffect(() => {\n    // Writing the hydrated value straight back would race the one-shot\n    // migration and could narrow a workspace it had just preserved.\n    const next = snapshot(enablement);\n    if (savedRef.current === null || savedRef.current === next) return;\n    savedRef.current = next;\n\n    const disabledSkills = enablement.disabledSkills ?? [];\n    saveSettings(\n      usesCatalogAllowList\n        ? {\n            enabled_skills: resolveEnabledCatalogSkills(enablement),\n            disabled_skills: disabledSkills,\n          }\n        : { disabled_skills: disabledSkills },\n      {\n        onError: (error) => {\n          displayErrorToast(\n            retrieveAxiosErrorMessage(error) || t(I18nKey.ERROR$GENERIC),\n          );\n        },\n      },\n    );\n  }, [enablement, usesCatalogAllowList, saveSettings, t]);\n\n  const isEnabled = React.useMemo(() => {\n    const enabled = buildSkillEnablementFilter(enablement);\n    return (skill: SkillInfo) => enabled(skill.name);\n  }, [enablement]);\n\n  const setEnabled = React.useCallback(\n    (skillName: string, enabled: boolean) => {\n      setEnablement((previous) => {\n        const allowListed = usesCatalogAllowList && isCatalogSkill(skillName);\n        return {\n          enabledSkills: allowListed\n            ? withMembership(\n                resolveEnabledCatalogSkills(previous),\n                skillName,\n                enabled,\n              )\n            : previous.enabledSkills,\n          // A catalog skill switched back on also leaves the deny-list, where\n          // an unmigrated workspace may still hold it.\n          disabledSkills: withMembership(\n            previous.disabledSkills ?? [],\n            skillName,\n            !enabled && !allowListed,\n          ),\n        };\n      });\n    },\n    [usesCatalogAllowList],\n  );\n\n  return { isEnabled, setEnabled };\n}\n"],"mappings":";;;;;;;;;;AAsBA,SAAS,EACP,GACA,GACiB;CACjB,OAAO;EACL,eAAe,IACX,GAAU,iBACV,CAAC,GAAG,CAAmB;EAC3B,gBAAgB,GAAU,mBAAmB,CAAC;CAChD;AACF;AAGA,SAAgB,IAAuD;CACrE,IAAM,EAAE,eAAY,EAAiB,GAC/B,EAAE,MAAM,MAAa,EAAY,GACjC,IAAuB,EAAQ,SAAS;CAE9C,OAAO,EAAM,cAAc;EACzB,IAAM,IAAY,EAChB,EAAoB,GAAU,CAAoB,CACpD;EACA,QAAQ,MAAqB,EAAU,EAAM,IAAI;CACnD,GAAG;EACD,GAAU;EACV,GAAU;EACV;CACF,CAAC;AACH;AAQA,SAAS,EAAS,GAAqC;CACrD,OAAO,KAAK,UAAU,CACpB,CAAC,GAAG,EAA4B,CAAU,CAAC,EAAE,KAAK,GAClD,CAAC,GAAI,EAAW,kBAAkB,CAAC,CAAE,EAAE,KAAK,CAC9C,CAAC;AACH;AAGA,SAAS,EACP,GACA,GACA,GACU;CAEV,OADI,EAAK,SAAS,CAAI,MAAM,IAAgB,IACrC,IAAU,CAAC,GAAG,GAAM,CAAI,IAAI,EAAK,QAAQ,MAAU,MAAU,CAAI;AAC1E;AAQA,SAAgB,IAAgD;CAC9D,IAAM,EAAE,SAAM,EAAe,WAAW,GAClC,EAAE,eAAY,EAAiB,GAC/B,IAAuB,EAAQ,SAAS,SACxC,EAAE,MAAM,GAAU,WAAW,MAAoB,EAAY,GAC7D,EAAE,QAAQ,MAAiB,EAAgB,GAE3C,CAAC,GAAY,KAAiB,EAAM,SAA0B,CAAC,CAAC,GAChE,IAAW,EAAM,OAAsB,IAAI;CAqEjD,OAnEA,EAAM,gBAAgB;EACpB,IAAI,KAAmB,CAAC,GAAU;EAClC,IAAM,IAAW,EAAoB,GAAU,CAAoB;EAEnE,AADA,EAAS,UAAU,EAAS,CAAQ,GACpC,EAAc,CAAQ;CACxB,GAAG;EACD;EACA,GAAU;EACV,GAAU;EACV;CACF,CAAC,GAED,EAAM,gBAAgB;EAGpB,IAAM,IAAO,EAAS,CAAU;EAChC,IAAI,EAAS,YAAY,QAAQ,EAAS,YAAY,GAAM;EAC5D,EAAS,UAAU;EAEnB,IAAM,IAAiB,EAAW,kBAAkB,CAAC;EACrD,EACE,IACI;GACE,gBAAgB,EAA4B,CAAU;GACtD,iBAAiB;EACnB,IACA,EAAE,iBAAiB,EAAe,GACtC,EACE,UAAU,MAAU;GAClB,EACE,EAA0B,CAAK,KAAK,EAAE,EAAQ,aAAa,CAC7D;EACF,EACF,CACF;CACF,GAAG;EAAC;EAAY;EAAsB;EAAc;CAAC,CAAC,GAgC/C;EAAE,WA9BS,EAAM,cAAc;GACpC,IAAM,IAAU,EAA2B,CAAU;GACrD,QAAQ,MAAqB,EAAQ,EAAM,IAAI;EACjD,GAAG,CAAC,CAAU,CA2BL;EAAW,YAzBD,EAAM,aACtB,GAAmB,MAAqB;GACvC,GAAe,MAAa;IAC1B,IAAM,IAAc,KAAwB,EAAe,CAAS;IACpE,OAAO;KACL,eAAe,IACX,EACE,EAA4B,CAAQ,GACpC,GACA,CACF,IACA,EAAS;KAGb,gBAAgB,EACd,EAAS,kBAAkB,CAAC,GAC5B,GACA,CAAC,KAAW,CAAC,CACf;IACF;GACF,CAAC;EACH,GACA,CAAC,CAAoB,CAGH;CAAW;AACjC"}