@openhands/agent-canvas 1.16.0 → 1.18.0

package/dist/utils/git-diff-stats.js.map

@@ -1 +1 @@
-{"version":3,"file":"git-diff-stats.js","names":[],"sources":["../../src/utils/git-diff-stats.ts"],"sourcesContent":["import type { GitChangeDiff } from \"#/api/open-hands.types\";\n\nexport interface GitDiffLineStats {\n  additions: number;\n  deletions: number;\n}\n\nfunction countUnifiedDiffStats(diff: string): GitDiffLineStats {\n  let additions = 0;\n  let deletions = 0;\n\n  for (const line of diff.split(\"\\n\")) {\n    if (\n      line.startsWith(\"+++\") ||\n      line.startsWith(\"---\") ||\n      line.startsWith(\"@@\")\n    ) {\n      continue;\n    }\n    if (line.startsWith(\"+\")) {\n      additions += 1;\n    } else if (line.startsWith(\"-\")) {\n      deletions += 1;\n    }\n  }\n\n  return { additions, deletions };\n}\n\nfunction countTextDiffStats(\n  original: string,\n  modified: string,\n): GitDiffLineStats {\n  const originalLines = original.length === 0 ? [] : original.split(\"\\n\");\n  const modifiedLines = modified.length === 0 ? [] : modified.split(\"\\n\");\n\n  if (originalLines.length === 0) {\n    return { additions: modifiedLines.length, deletions: 0 };\n  }\n\n  if (modifiedLines.length === 0) {\n    return { additions: 0, deletions: originalLines.length };\n  }\n\n  let additions = 0;\n  let deletions = 0;\n  let originalIndex = 0;\n  let modifiedIndex = 0;\n\n  while (\n    originalIndex < originalLines.length ||\n    modifiedIndex < modifiedLines.length\n  ) {\n    const originalLine = originalLines[originalIndex];\n    const modifiedLine = modifiedLines[modifiedIndex];\n\n    if (\n      originalIndex < originalLines.length &&\n      modifiedIndex < modifiedLines.length &&\n      originalLine === modifiedLine\n    ) {\n      originalIndex += 1;\n      modifiedIndex += 1;\n      continue;\n    }\n\n    if (\n      modifiedIndex < modifiedLines.length &&\n      (originalIndex >= originalLines.length ||\n        !originalLines.slice(originalIndex).includes(modifiedLine))\n    ) {\n      additions += 1;\n      modifiedIndex += 1;\n      continue;\n    }\n\n    if (originalIndex < originalLines.length) {\n      deletions += 1;\n      originalIndex += 1;\n    }\n  }\n\n  return { additions, deletions };\n}\n\nexport function countGitChangeDiffStats(\n  diff: GitChangeDiff & { diff?: string },\n): GitDiffLineStats {\n  if (typeof diff.diff === \"string\" && diff.diff.length > 0) {\n    return countUnifiedDiffStats(diff.diff);\n  }\n\n  return countTextDiffStats(diff.original ?? \"\", diff.modified ?? \"\");\n}\n\nexport function sumGitDiffLineStats(\n  stats: GitDiffLineStats[],\n): GitDiffLineStats {\n  return stats.reduce(\n    (totals, stat) => ({\n      additions: totals.additions + stat.additions,\n      deletions: totals.deletions + stat.deletions,\n    }),\n    { additions: 0, deletions: 0 },\n  );\n}\n"],"mappings":";AAOA,SAAS,EAAsB,GAAgC;CAC7D,IAAI,IAAY,GACZ,IAAY;CAEhB,KAAK,IAAM,KAAQ,EAAK,MAAM,IAAI,GAE9B,EAAK,WAAW,KAAK,KACrB,EAAK,WAAW,KAAK,KACrB,EAAK,WAAW,IAAI,MAIlB,EAAK,WAAW,GAAG,IACrB,KAAa,IACJ,EAAK,WAAW,GAAG,MAC5B,KAAa;CAIjB,OAAO;EAAE;EAAW;CAAU;AAChC;AAEA,SAAS,EACP,GACA,GACkB;CAClB,IAAM,IAAgB,EAAS,WAAW,IAAI,CAAC,IAAI,EAAS,MAAM,IAAI,GAChE,IAAgB,EAAS,WAAW,IAAI,CAAC,IAAI,EAAS,MAAM,IAAI;CAEtE,IAAI,EAAc,WAAW,GAC3B,OAAO;EAAE,WAAW,EAAc;EAAQ,WAAW;CAAE;CAGzD,IAAI,EAAc,WAAW,GAC3B,OAAO;EAAE,WAAW;EAAG,WAAW,EAAc;CAAO;CAGzD,IAAI,IAAY,GACZ,IAAY,GACZ,IAAgB,GAChB,IAAgB;CAEpB,OACE,IAAgB,EAAc,UAC9B,IAAgB,EAAc,SAC9B;EACA,IAAM,IAAe,EAAc,IAC7B,IAAe,EAAc;EAEnC,IACE,IAAgB,EAAc,UAC9B,IAAgB,EAAc,UAC9B,MAAiB,GACjB;GAEA,AADA,KAAiB,GACjB,KAAiB;GACjB;EACF;EAEA,IACE,IAAgB,EAAc,WAC7B,KAAiB,EAAc,UAC9B,CAAC,EAAc,MAAM,CAAa,EAAE,SAAS,CAAY,IAC3D;GAEA,AADA,KAAa,GACb,KAAiB;GACjB;EACF;EAEA,AAAI,IAAgB,EAAc,WAChC,KAAa,GACb,KAAiB;CAErB;CAEA,OAAO;EAAE;EAAW;CAAU;AAChC;AAEA,SAAgB,EACd,GACkB;CAKlB,OAJI,OAAO,EAAK,QAAS,YAAY,EAAK,KAAK,SAAS,IAC/C,EAAsB,EAAK,IAAI,IAGjC,EAAmB,EAAK,YAAY,IAAI,EAAK,YAAY,EAAE;AACpE;AAEA,SAAgB,EACd,GACkB;CAClB,OAAO,EAAM,QACV,GAAQ,OAAU;EACjB,WAAW,EAAO,YAAY,EAAK;EACnC,WAAW,EAAO,YAAY,EAAK;CACrC,IACA;EAAE,WAAW;EAAG,WAAW;CAAE,CAC/B;AACF"}
+{"version":3,"file":"git-diff-stats.js","names":[],"sources":["../../src/utils/git-diff-stats.ts"],"sourcesContent":["import type { GitChangeDiff } from \"#/api/open-hands.types\";\n\nexport interface GitDiffLineStats {\n  additions: number;\n  deletions: number;\n}\n\nexport function countUnifiedDiffStats(diff: string): {\n  additions: number;\n  deletions: number;\n} {\n  let additions = 0;\n  let deletions = 0;\n  let inHunk = false;\n\n  for (const line of diff.split(\"\\n\")) {\n    if (line.startsWith(\"diff --git\") || line.startsWith(\"index \")) {\n      inHunk = false;\n      continue;\n    }\n\n    if (line.startsWith(\"@@\")) {\n      inHunk = true;\n      continue;\n    }\n\n    if (!inHunk) {\n      if (line.startsWith(\"---\") || line.startsWith(\"+++\")) {\n        continue;\n      }\n    }\n\n    if (inHunk) {\n      if (line.startsWith(\"+\")) {\n        additions += 1;\n      } else if (line.startsWith(\"-\")) {\n        deletions += 1;\n      }\n    }\n  }\n\n  return { additions, deletions };\n}\n\nfunction countTextDiffStats(\n  original: string,\n  modified: string,\n): GitDiffLineStats {\n  const originalLines = original.length === 0 ? [] : original.split(\"\\n\");\n  const modifiedLines = modified.length === 0 ? [] : modified.split(\"\\n\");\n\n  if (originalLines.length === 0) {\n    return { additions: modifiedLines.length, deletions: 0 };\n  }\n\n  if (modifiedLines.length === 0) {\n    return { additions: 0, deletions: originalLines.length };\n  }\n\n  let additions = 0;\n  let deletions = 0;\n  let originalIndex = 0;\n  let modifiedIndex = 0;\n\n  while (\n    originalIndex < originalLines.length ||\n    modifiedIndex < modifiedLines.length\n  ) {\n    const originalLine = originalLines[originalIndex];\n    const modifiedLine = modifiedLines[modifiedIndex];\n\n    if (\n      originalIndex < originalLines.length &&\n      modifiedIndex < modifiedLines.length &&\n      originalLine === modifiedLine\n    ) {\n      originalIndex += 1;\n      modifiedIndex += 1;\n      continue;\n    }\n\n    if (\n      modifiedIndex < modifiedLines.length &&\n      (originalIndex >= originalLines.length ||\n        !originalLines.slice(originalIndex).includes(modifiedLine))\n    ) {\n      additions += 1;\n      modifiedIndex += 1;\n      continue;\n    }\n\n    if (originalIndex < originalLines.length) {\n      deletions += 1;\n      originalIndex += 1;\n    }\n  }\n\n  return { additions, deletions };\n}\n\nexport function countGitChangeDiffStats(\n  diff: GitChangeDiff & { diff?: string },\n): GitDiffLineStats {\n  if (typeof diff.diff === \"string\" && diff.diff.length > 0) {\n    return countUnifiedDiffStats(diff.diff);\n  }\n\n  return countTextDiffStats(diff.original ?? \"\", diff.modified ?? \"\");\n}\n\nexport function sumGitDiffLineStats(\n  stats: GitDiffLineStats[],\n): GitDiffLineStats {\n  return stats.reduce(\n    (totals, stat) => ({\n      additions: totals.additions + stat.additions,\n      deletions: totals.deletions + stat.deletions,\n    }),\n    { additions: 0, deletions: 0 },\n  );\n}\n"],"mappings":";AAOA,SAAgB,EAAsB,GAGpC;CACA,IAAI,IAAY,GACZ,IAAY,GACZ,IAAS;CAEb,KAAK,IAAM,KAAQ,EAAK,MAAM,IAAI,GAAG;EACnC,IAAI,EAAK,WAAW,YAAY,KAAK,EAAK,WAAW,QAAQ,GAAG;GAC9D,IAAS;GACT;EACF;EAEA,IAAI,EAAK,WAAW,IAAI,GAAG;GACzB,IAAS;GACT;EACF;EAEI,CAAC,MACC,EAAK,WAAW,KAAK,KAAK,EAAK,WAAW,KAAK,MAKjD,MACE,EAAK,WAAW,GAAG,IACrB,KAAa,IACJ,EAAK,WAAW,GAAG,MAC5B,KAAa;CAGnB;CAEA,OAAO;EAAE;EAAW;CAAU;AAChC;AAEA,SAAS,EACP,GACA,GACkB;CAClB,IAAM,IAAgB,EAAS,WAAW,IAAI,CAAC,IAAI,EAAS,MAAM,IAAI,GAChE,IAAgB,EAAS,WAAW,IAAI,CAAC,IAAI,EAAS,MAAM,IAAI;CAEtE,IAAI,EAAc,WAAW,GAC3B,OAAO;EAAE,WAAW,EAAc;EAAQ,WAAW;CAAE;CAGzD,IAAI,EAAc,WAAW,GAC3B,OAAO;EAAE,WAAW;EAAG,WAAW,EAAc;CAAO;CAGzD,IAAI,IAAY,GACZ,IAAY,GACZ,IAAgB,GAChB,IAAgB;CAEpB,OACE,IAAgB,EAAc,UAC9B,IAAgB,EAAc,SAC9B;EACA,IAAM,IAAe,EAAc,IAC7B,IAAe,EAAc;EAEnC,IACE,IAAgB,EAAc,UAC9B,IAAgB,EAAc,UAC9B,MAAiB,GACjB;GAEA,AADA,KAAiB,GACjB,KAAiB;GACjB;EACF;EAEA,IACE,IAAgB,EAAc,WAC7B,KAAiB,EAAc,UAC9B,CAAC,EAAc,MAAM,CAAa,EAAE,SAAS,CAAY,IAC3D;GAEA,AADA,KAAa,GACb,KAAiB;GACjB;EACF;EAEA,AAAI,IAAgB,EAAc,WAChC,KAAa,GACb,KAAiB;CAErB;CAEA,OAAO;EAAE;EAAW;CAAU;AAChC;AAEA,SAAgB,EACd,GACkB;CAKlB,OAJI,OAAO,EAAK,QAAS,YAAY,EAAK,KAAK,SAAS,IAC/C,EAAsB,EAAK,IAAI,IAGjC,EAAmB,EAAK,YAAY,IAAI,EAAK,YAAY,EAAE;AACpE;AAEA,SAAgB,EACd,GACkB;CAClB,OAAO,EAAM,QACV,GAAQ,OAAU;EACjB,WAAW,EAAO,YAAY,EAAK;EACnC,WAAW,EAAO,YAAY,EAAK;CACrC,IACA;EAAE,WAAW;EAAG,WAAW;CAAE,CAC/B;AACF"}

package/dist/utils/plan-file.cjs

@@ -0,0 +1,4 @@
+require("../_virtual/_rolldown/runtime.cjs");var e=`.agents_tmp/PLAN.md`,t=`system_prompt_planning.j2`,n=`planning_file_editor`,r=`plannerparent`,i=`PLAN.MD`,a=[`The plan must follow this structure exactly:`,``,`1. OBJECTIVE`,`   * Summarize the goal of the plan in one or two sentences.`,`   * Restate the problem in clear operational terms.`,``,`2. CONTEXT SUMMARY`,`   * Briefly describe the relevant system components, files, or data involved.`,`   * Mention any dependencies or constraints (technical, organizational, or external).`,``,`3. APPROACH OVERVIEW`,`   * Outline the chosen approach at a high level.`,`   * Mention why it was selected (short rationale) if alternatives were considered.`,``,`4. IMPLEMENTATION STEPS`,`   * Provide a step-by-step plan for execution.`,`   * Each step should include:`,`     - a **goal** (what this step accomplishes),`,`     - a **method** (how to do it, briefly),`,`     - and optionally a **reference** (file, module, or function impacted).`,``,`5. TESTING AND VALIDATION`,`   * Describe how the implementation can be verified or validated.`,`   * This section should describe what success looks like — expected outputs, behaviors, or conditions.`].join(`
+`),o=[`<IMPORTANT_PLANNING_BOUNDARIES>`,`You are a Planning Agent that can ONLY create plans - you CANNOT execute code or make changes.`,``,`Create or update the plan for the current task in the configured PLAN.md file.`,``,`After you finalize the plan in PLAN.md:`,`- Do NOT ask "Ready to proceed?" or offer to execute the plan`,`- Do NOT attempt to run any implementation commands`,`- Instead, tell the user they can click the **Build** button below the plan preview to switch to the code agent and execute the plan.`,``,`Your role ends when the plan is finalized. Implementation is handled by the code agent.`,`</IMPORTANT_PLANNING_BOUNDARIES>`].join(`
+`);function s(t){return`${t.replace(/\/+$/,``)}/${e}`}function c(e){if(!e)return!1;let t=e.replace(/\\/g,`/`).toUpperCase();return t===i||t.endsWith(`/${i}`)}function l(e,t){return e?.tags?.[r]===t}function u(e,t){return t?e?.find(e=>l(e,t))?.id??null:null}exports.LOCAL_PLANNER_PARENT_TAG_KEY=r,exports.PLANNING_AGENT_INSTRUCTION=o,exports.PLANNING_FILE_EDITOR_TOOL_NAME=n,exports.PLANNING_SYSTEM_PROMPT_FILENAME=t,exports.PLAN_STRUCTURE_TEXT=a,exports.buildPlanPath=s,exports.findPlannerConversationId=u,exports.isPlanFilePath=c,exports.isPlannerConversationOf=l;
+//# sourceMappingURL=plan-file.cjs.map

package/dist/utils/plan-file.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-file.cjs","names":[],"sources":["../../src/utils/plan-file.ts"],"sourcesContent":["import type { AppConversation } from \"#/api/conversation-service/agent-server-conversation-service.types\";\n\nexport const PLAN_RELATIVE_PATH = \".agents_tmp/PLAN.md\";\nexport const PLANNING_SYSTEM_PROMPT_FILENAME = \"system_prompt_planning.j2\";\nexport const PLANNING_FILE_EDITOR_TOOL_NAME = \"planning_file_editor\";\nexport const LOCAL_PLANNER_PARENT_TAG_KEY = \"plannerparent\";\n\nconst PLAN_FILENAME_UPPER = \"PLAN.MD\";\n\n// Mirrors the SDK planning preset's `format_plan_structure()` output\n// (software-agent-sdk openhands-tools/openhands/tools/preset/planning.py,\n// `PLAN_STRUCTURE`). The planning agent loads `system_prompt_planning.j2` with\n// this injected as `{{plan_structure}}`; keep it byte-identical to that SDK\n// output so the local planner matches the canonical planning agent.\nexport const PLAN_STRUCTURE_TEXT = [\n  \"The plan must follow this structure exactly:\",\n  \"\",\n  \"1. OBJECTIVE\",\n  \"   * Summarize the goal of the plan in one or two sentences.\",\n  \"   * Restate the problem in clear operational terms.\",\n  \"\",\n  \"2. CONTEXT SUMMARY\",\n  \"   * Briefly describe the relevant system components, files, or data involved.\",\n  \"   * Mention any dependencies or constraints (technical, organizational, or external).\",\n  \"\",\n  \"3. APPROACH OVERVIEW\",\n  \"   * Outline the chosen approach at a high level.\",\n  \"   * Mention why it was selected (short rationale) if alternatives were considered.\",\n  \"\",\n  \"4. IMPLEMENTATION STEPS\",\n  \"   * Provide a step-by-step plan for execution.\",\n  \"   * Each step should include:\",\n  \"     - a **goal** (what this step accomplishes),\",\n  \"     - a **method** (how to do it, briefly),\",\n  \"     - and optionally a **reference** (file, module, or function impacted).\",\n  \"\",\n  \"5. TESTING AND VALIDATION\",\n  \"   * Describe how the implementation can be verified or validated.\",\n  \"   * This section should describe what success looks like — expected outputs, behaviors, or conditions.\",\n].join(\"\\n\");\n\n// System-prompt suffix for the local planning agent (mirrors the OpenHands\n// app-server's PLANNING_AGENT_INSTRUCTION). The planner's directive + boundaries\n// live in the system prompt; the planning conversation is created idle, so the\n// user types the first message themselves and nothing is injected into the chat.\nexport const PLANNING_AGENT_INSTRUCTION = [\n  \"<IMPORTANT_PLANNING_BOUNDARIES>\",\n  \"You are a Planning Agent that can ONLY create plans - you CANNOT execute code or make changes.\",\n  \"\",\n  \"Create or update the plan for the current task in the configured PLAN.md file.\",\n  \"\",\n  \"After you finalize the plan in PLAN.md:\",\n  '- Do NOT ask \"Ready to proceed?\" or offer to execute the plan',\n  \"- Do NOT attempt to run any implementation commands\",\n  \"- Instead, tell the user they can click the **Build** button below the plan preview to switch to the code agent and execute the plan.\",\n  \"\",\n  \"Your role ends when the plan is finalized. Implementation is handled by the code agent.\",\n  \"</IMPORTANT_PLANNING_BOUNDARIES>\",\n].join(\"\\n\");\n\nexport function buildPlanPath(workingDir: string): string {\n  const normalized = workingDir.replace(/\\/+$/, \"\");\n  return `${normalized}/${PLAN_RELATIVE_PATH}`;\n}\n\nexport function isPlanFilePath(path: string | null | undefined): boolean {\n  if (!path) return false;\n  const normalized = path.replace(/\\\\/g, \"/\").toUpperCase();\n  return (\n    normalized === PLAN_FILENAME_UPPER ||\n    normalized.endsWith(`/${PLAN_FILENAME_UPPER}`)\n  );\n}\n\n/**\n * Whether `conversation` is the local planner helper for `parentConversationId`\n * — identity comes from the `plannerparent` tag `createLocalPlanningConversation`\n * stamps on creation, never from list position (`sub_conversation_ids` is the\n * generic, untyped child list).\n */\nexport function isPlannerConversationOf(\n  conversation: Pick<AppConversation, \"tags\"> | null | undefined,\n  parentConversationId: string,\n): boolean {\n  return (\n    conversation?.tags?.[LOCAL_PLANNER_PARENT_TAG_KEY] === parentConversationId\n  );\n}\n\n/** Finds the planner helper among a conversation's fetched sub-conversations. */\nexport function findPlannerConversationId(\n  subConversations: (AppConversation | null)[] | null | undefined,\n  parentConversationId: string | null | undefined,\n): string | null {\n  if (!parentConversationId) return null;\n  return (\n    subConversations?.find((sub) =>\n      isPlannerConversationOf(sub, parentConversationId),\n    )?.id ?? null\n  );\n}\n"],"mappings":"6CAEA,IAAa,EAAqB,sBACrB,EAAkC,4BAClC,EAAiC,uBACjC,EAA+B,gBAEtC,EAAsB,UAOf,EAAsB,CACjC,+CACA,GACA,eACA,+DACA,uDACA,GACA,qBACA,iFACA,yFACA,GACA,uBACA,oDACA,sFACA,GACA,0BACA,kDACA,iCACA,mDACA,+CACA,8EACA,GACA,4BACA,qEACA,yGACF,EAAE,KAAK;CAAI,EAME,EAA6B,CACxC,kCACA,iGACA,GACA,iFACA,GACA,0CACA,gEACA,sDACA,wIACA,GACA,0FACA,kCACF,EAAE,KAAK;CAAI,EAEX,SAAgB,EAAc,EAA4B,CAExD,MAAO,GADY,EAAW,QAAQ,OAAQ,EACpC,EAAW,GAAG,GAC1B,CAEA,SAAgB,EAAe,EAA0C,CACvE,GAAI,CAAC,EAAM,MAAO,GAClB,IAAM,EAAa,EAAK,QAAQ,MAAO,GAAG,EAAE,YAAY,EACxD,OACE,IAAe,GACf,EAAW,SAAS,IAAI,GAAqB,CAEjD,CAQA,SAAgB,EACd,EACA,EACS,CACT,OACE,GAAc,OAAO,KAAkC,CAE3D,CAGA,SAAgB,EACd,EACA,EACe,CAEf,OADK,EAEH,GAAkB,KAAM,GACtB,EAAwB,EAAK,CAAoB,CACnD,GAAG,IAAM,KAJuB,IAMpC"}

package/dist/utils/plan-file.d.ts

@@ -0,0 +1,18 @@
+import type { AppConversation } from "#/api/conversation-service/agent-server-conversation-service.types";
+export declare const PLAN_RELATIVE_PATH = ".agents_tmp/PLAN.md";
+export declare const PLANNING_SYSTEM_PROMPT_FILENAME = "system_prompt_planning.j2";
+export declare const PLANNING_FILE_EDITOR_TOOL_NAME = "planning_file_editor";
+export declare const LOCAL_PLANNER_PARENT_TAG_KEY = "plannerparent";
+export declare const PLAN_STRUCTURE_TEXT: string;
+export declare const PLANNING_AGENT_INSTRUCTION: string;
+export declare function buildPlanPath(workingDir: string): string;
+export declare function isPlanFilePath(path: string | null | undefined): boolean;
+/**
+ * Whether `conversation` is the local planner helper for `parentConversationId`
+ * — identity comes from the `plannerparent` tag `createLocalPlanningConversation`
+ * stamps on creation, never from list position (`sub_conversation_ids` is the
+ * generic, untyped child list).
+ */
+export declare function isPlannerConversationOf(conversation: Pick<AppConversation, "tags"> | null | undefined, parentConversationId: string): boolean;
+/** Finds the planner helper among a conversation's fetched sub-conversations. */
+export declare function findPlannerConversationId(subConversations: (AppConversation | null)[] | null | undefined, parentConversationId: string | null | undefined): string | null;

package/dist/utils/plan-file.js

@@ -0,0 +1,58 @@
+//#region src/utils/plan-file.ts
+var e = ".agents_tmp/PLAN.md", t = "system_prompt_planning.j2", n = "planning_file_editor", r = "plannerparent", i = "PLAN.MD", a = [
+	"The plan must follow this structure exactly:",
+	"",
+	"1. OBJECTIVE",
+	"   * Summarize the goal of the plan in one or two sentences.",
+	"   * Restate the problem in clear operational terms.",
+	"",
+	"2. CONTEXT SUMMARY",
+	"   * Briefly describe the relevant system components, files, or data involved.",
+	"   * Mention any dependencies or constraints (technical, organizational, or external).",
+	"",
+	"3. APPROACH OVERVIEW",
+	"   * Outline the chosen approach at a high level.",
+	"   * Mention why it was selected (short rationale) if alternatives were considered.",
+	"",
+	"4. IMPLEMENTATION STEPS",
+	"   * Provide a step-by-step plan for execution.",
+	"   * Each step should include:",
+	"     - a **goal** (what this step accomplishes),",
+	"     - a **method** (how to do it, briefly),",
+	"     - and optionally a **reference** (file, module, or function impacted).",
+	"",
+	"5. TESTING AND VALIDATION",
+	"   * Describe how the implementation can be verified or validated.",
+	"   * This section should describe what success looks like — expected outputs, behaviors, or conditions."
+].join("\n"), o = [
+	"<IMPORTANT_PLANNING_BOUNDARIES>",
+	"You are a Planning Agent that can ONLY create plans - you CANNOT execute code or make changes.",
+	"",
+	"Create or update the plan for the current task in the configured PLAN.md file.",
+	"",
+	"After you finalize the plan in PLAN.md:",
+	"- Do NOT ask \"Ready to proceed?\" or offer to execute the plan",
+	"- Do NOT attempt to run any implementation commands",
+	"- Instead, tell the user they can click the **Build** button below the plan preview to switch to the code agent and execute the plan.",
+	"",
+	"Your role ends when the plan is finalized. Implementation is handled by the code agent.",
+	"</IMPORTANT_PLANNING_BOUNDARIES>"
+].join("\n");
+function s(t) {
+	return `${t.replace(/\/+$/, "")}/${e}`;
+}
+function c(e) {
+	if (!e) return !1;
+	let t = e.replace(/\\/g, "/").toUpperCase();
+	return t === i || t.endsWith(`/${i}`);
+}
+function l(e, t) {
+	return e?.tags?.[r] === t;
+}
+function u(e, t) {
+	return t ? e?.find((e) => l(e, t))?.id ?? null : null;
+}
+//#endregion
+export { r as LOCAL_PLANNER_PARENT_TAG_KEY, o as PLANNING_AGENT_INSTRUCTION, n as PLANNING_FILE_EDITOR_TOOL_NAME, t as PLANNING_SYSTEM_PROMPT_FILENAME, a as PLAN_STRUCTURE_TEXT, s as buildPlanPath, u as findPlannerConversationId, c as isPlanFilePath, l as isPlannerConversationOf };
+
+//# sourceMappingURL=plan-file.js.map

package/dist/utils/plan-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-file.js","names":[],"sources":["../../src/utils/plan-file.ts"],"sourcesContent":["import type { AppConversation } from \"#/api/conversation-service/agent-server-conversation-service.types\";\n\nexport const PLAN_RELATIVE_PATH = \".agents_tmp/PLAN.md\";\nexport const PLANNING_SYSTEM_PROMPT_FILENAME = \"system_prompt_planning.j2\";\nexport const PLANNING_FILE_EDITOR_TOOL_NAME = \"planning_file_editor\";\nexport const LOCAL_PLANNER_PARENT_TAG_KEY = \"plannerparent\";\n\nconst PLAN_FILENAME_UPPER = \"PLAN.MD\";\n\n// Mirrors the SDK planning preset's `format_plan_structure()` output\n// (software-agent-sdk openhands-tools/openhands/tools/preset/planning.py,\n// `PLAN_STRUCTURE`). The planning agent loads `system_prompt_planning.j2` with\n// this injected as `{{plan_structure}}`; keep it byte-identical to that SDK\n// output so the local planner matches the canonical planning agent.\nexport const PLAN_STRUCTURE_TEXT = [\n  \"The plan must follow this structure exactly:\",\n  \"\",\n  \"1. OBJECTIVE\",\n  \"   * Summarize the goal of the plan in one or two sentences.\",\n  \"   * Restate the problem in clear operational terms.\",\n  \"\",\n  \"2. CONTEXT SUMMARY\",\n  \"   * Briefly describe the relevant system components, files, or data involved.\",\n  \"   * Mention any dependencies or constraints (technical, organizational, or external).\",\n  \"\",\n  \"3. APPROACH OVERVIEW\",\n  \"   * Outline the chosen approach at a high level.\",\n  \"   * Mention why it was selected (short rationale) if alternatives were considered.\",\n  \"\",\n  \"4. IMPLEMENTATION STEPS\",\n  \"   * Provide a step-by-step plan for execution.\",\n  \"   * Each step should include:\",\n  \"     - a **goal** (what this step accomplishes),\",\n  \"     - a **method** (how to do it, briefly),\",\n  \"     - and optionally a **reference** (file, module, or function impacted).\",\n  \"\",\n  \"5. TESTING AND VALIDATION\",\n  \"   * Describe how the implementation can be verified or validated.\",\n  \"   * This section should describe what success looks like — expected outputs, behaviors, or conditions.\",\n].join(\"\\n\");\n\n// System-prompt suffix for the local planning agent (mirrors the OpenHands\n// app-server's PLANNING_AGENT_INSTRUCTION). The planner's directive + boundaries\n// live in the system prompt; the planning conversation is created idle, so the\n// user types the first message themselves and nothing is injected into the chat.\nexport const PLANNING_AGENT_INSTRUCTION = [\n  \"<IMPORTANT_PLANNING_BOUNDARIES>\",\n  \"You are a Planning Agent that can ONLY create plans - you CANNOT execute code or make changes.\",\n  \"\",\n  \"Create or update the plan for the current task in the configured PLAN.md file.\",\n  \"\",\n  \"After you finalize the plan in PLAN.md:\",\n  '- Do NOT ask \"Ready to proceed?\" or offer to execute the plan',\n  \"- Do NOT attempt to run any implementation commands\",\n  \"- Instead, tell the user they can click the **Build** button below the plan preview to switch to the code agent and execute the plan.\",\n  \"\",\n  \"Your role ends when the plan is finalized. Implementation is handled by the code agent.\",\n  \"</IMPORTANT_PLANNING_BOUNDARIES>\",\n].join(\"\\n\");\n\nexport function buildPlanPath(workingDir: string): string {\n  const normalized = workingDir.replace(/\\/+$/, \"\");\n  return `${normalized}/${PLAN_RELATIVE_PATH}`;\n}\n\nexport function isPlanFilePath(path: string | null | undefined): boolean {\n  if (!path) return false;\n  const normalized = path.replace(/\\\\/g, \"/\").toUpperCase();\n  return (\n    normalized === PLAN_FILENAME_UPPER ||\n    normalized.endsWith(`/${PLAN_FILENAME_UPPER}`)\n  );\n}\n\n/**\n * Whether `conversation` is the local planner helper for `parentConversationId`\n * — identity comes from the `plannerparent` tag `createLocalPlanningConversation`\n * stamps on creation, never from list position (`sub_conversation_ids` is the\n * generic, untyped child list).\n */\nexport function isPlannerConversationOf(\n  conversation: Pick<AppConversation, \"tags\"> | null | undefined,\n  parentConversationId: string,\n): boolean {\n  return (\n    conversation?.tags?.[LOCAL_PLANNER_PARENT_TAG_KEY] === parentConversationId\n  );\n}\n\n/** Finds the planner helper among a conversation's fetched sub-conversations. */\nexport function findPlannerConversationId(\n  subConversations: (AppConversation | null)[] | null | undefined,\n  parentConversationId: string | null | undefined,\n): string | null {\n  if (!parentConversationId) return null;\n  return (\n    subConversations?.find((sub) =>\n      isPlannerConversationOf(sub, parentConversationId),\n    )?.id ?? null\n  );\n}\n"],"mappings":";AAEA,IAAa,IAAqB,uBACrB,IAAkC,6BAClC,IAAiC,wBACjC,IAA+B,iBAEtC,IAAsB,WAOf,IAAsB;CACjC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,EAAE,KAAK,IAAI,GAME,IAA6B;CACxC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,EAAE,KAAK,IAAI;AAEX,SAAgB,EAAc,GAA4B;CAExD,OAAO,GADY,EAAW,QAAQ,QAAQ,EACpC,EAAW,GAAG;AAC1B;AAEA,SAAgB,EAAe,GAA0C;CACvE,IAAI,CAAC,GAAM,OAAO;CAClB,IAAM,IAAa,EAAK,QAAQ,OAAO,GAAG,EAAE,YAAY;CACxD,OACE,MAAe,KACf,EAAW,SAAS,IAAI,GAAqB;AAEjD;AAQA,SAAgB,EACd,GACA,GACS;CACT,OACE,GAAc,OAAO,OAAkC;AAE3D;AAGA,SAAgB,EACd,GACA,GACe;CAEf,OADK,IAEH,GAAkB,MAAM,MACtB,EAAwB,GAAK,CAAoB,CACnD,GAAG,MAAM,OAJuB;AAMpC"}

package/dist/utils/recommended-automation-rail.cjs

@@ -1,2 +1,2 @@
-require("../_virtual/_rolldown/runtime.cjs");const e=require("../node_modules/@openhands/extensions/automations/index.cjs"),t=require("../manifests/manifest-sources.cjs"),n=require("../manifests/automation-interface.cjs");function r(e){return e.map((e,t)=>({automation:e,index:t})).sort((e,t)=>(t.automation.popularityRank??0)-(e.automation.popularityRank??0)||e.index-t.index).map(({automation:e})=>e)}function i(e){return e.trim().toLowerCase().replace(/&/g,`and`).replace(/[^a-z0-9]+/g,`-`).replace(/^-+|-+$/g,``)}function a(e){return[e.id,e.name,e.skill].filter(e=>!!e).map(i)}function o(e,t){let n=new Set(t.map(e=>i(e.name)));return a(e).some(e=>n.has(e))}function s(e){return n.getFeaturedAutomationIds().includes(e.id)}function c(e){return t.SETUP_REGISTRY.findById(e.id)==null}function l(t){let n=r(e.default).filter(e=>!o(e,t));return{proven:n.filter(s),conversation:n.filter(e=>!s(e)&&c(e))}}function u(e){return[...e.proven,...e.conversation]}exports.flattenRecommendedRailGroups=u,exports.getAutomationsByPopularity=r,exports.getRecommendedRailGroups=l;
+require("../_virtual/_rolldown/runtime.cjs");const e=require("../node_modules/@openhands/extensions/automations/index.cjs"),t=require("../manifests/manifest-sources.cjs"),n=require("../manifests/automation-interface.cjs");function r(e){return e.map((e,t)=>({automation:e,index:t})).sort((e,t)=>(t.automation.popularityRank??0)-(e.automation.popularityRank??0)||e.index-t.index).map(({automation:e})=>e)}function i(e){return e.trim().toLowerCase().replace(/&/g,`and`).replace(/[^a-z0-9]+/g,`-`).replace(/^-+|-+$/g,``)}function a(e){return[e.id,e.name,e.name?`${e.name} Agent`:void 0,e.skill].filter(e=>!!e).map(i)}function o(e,t){let n=new Set(t.map(e=>i(e.name)));return a(e).some(e=>n.has(e))}function s(e){return n.getFeaturedAutomationIds().includes(e.id)}function c(e){return t.SETUP_REGISTRY.findById(e.id)==null}function l(t){let n=r(e.default).filter(e=>!o(e,t));return{proven:n.filter(s),conversation:n.filter(e=>!s(e)&&c(e))}}function u(e){return[...e.proven,...e.conversation]}exports.flattenRecommendedRailGroups=u,exports.getAutomationsByPopularity=r,exports.getRecommendedRailGroups=l;
 //# sourceMappingURL=recommended-automation-rail.cjs.map

package/dist/utils/recommended-automation-rail.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"recommended-automation-rail.cjs","names":[],"sources":["../../src/utils/recommended-automation-rail.ts"],"sourcesContent":["import {\n  AUTOMATION_CATALOG,\n  type RecommendedAutomation,\n} from \"@openhands/extensions/automations\";\nimport { getFeaturedAutomationIds } from \"#/manifests/automation-interface\";\nimport { SETUP_REGISTRY } from \"#/manifests/manifest-sources\";\nimport type { Automation } from \"#/types/automation\";\n\nexport function getAutomationsByPopularity(\n  catalog: RecommendedAutomation[],\n): RecommendedAutomation[] {\n  return catalog\n    .map((automation, index) => ({ automation, index }))\n    .sort((a, b) => {\n      const byPopularity =\n        (b.automation.popularityRank ?? 0) - (a.automation.popularityRank ?? 0);\n      return byPopularity || a.index - b.index;\n    })\n    .map(({ automation }) => automation);\n}\n\n/**\n * Slug used to match a catalog entry against an installed automation name.\n * Catalog ids are already kebab-case; installed names are human titles.\n */\nexport function normalizeAutomationKey(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/&/g, \"and\")\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n\nfunction catalogMatchKeys(entry: RecommendedAutomation): string[] {\n  return [entry.id, entry.name, entry.skill]\n    .filter((value): value is string => Boolean(value))\n    .map(normalizeAutomationKey);\n}\n\nexport function isCatalogAutomationAdded(\n  entry: RecommendedAutomation,\n  installed: readonly Pick<Automation, \"name\">[],\n): boolean {\n  const installedKeys = new Set(\n    installed.map((automation) => normalizeAutomationKey(automation.name)),\n  );\n  return catalogMatchKeys(entry).some((key) => installedKeys.has(key));\n}\n\nfunction isProvenAutomation(entry: RecommendedAutomation): boolean {\n  return getFeaturedAutomationIds().includes(entry.id);\n}\n\n/** Catalog cards that launch a conversation instead of a host setup form. */\nexport function isConversationLaunchAutomation(\n  entry: RecommendedAutomation,\n): boolean {\n  return SETUP_REGISTRY.findById(entry.id) == null;\n}\n\nexport interface RecommendedRailGroups {\n  proven: RecommendedAutomation[];\n  conversation: RecommendedAutomation[];\n}\n\n/**\n * Home / dashboard rail: remaining proven workflows, then other useful\n * automations that open in a new conversation. Already-created automations\n * are dropped from both groups.\n */\nexport function getRecommendedRailGroups(\n  installed: readonly Pick<Automation, \"name\">[],\n): RecommendedRailGroups {\n  // Every catalog entry is offerable: one that declares no integration needs\n  // nothing connected, and one that names an integration this host cannot\n  // resolve stays visible so the drift is actionable rather than hidden.\n  const available = getAutomationsByPopularity(AUTOMATION_CATALOG).filter(\n    (entry) => !isCatalogAutomationAdded(entry, installed),\n  );\n\n  return {\n    proven: available.filter(isProvenAutomation),\n    conversation: available.filter(\n      (entry) =>\n        !isProvenAutomation(entry) && isConversationLaunchAutomation(entry),\n    ),\n  };\n}\n\nexport function flattenRecommendedRailGroups(\n  groups: RecommendedRailGroups,\n): RecommendedAutomation[] {\n  return [...groups.proven, ...groups.conversation];\n}\n"],"mappings":"8NAQA,SAAgB,EACd,EACyB,CACzB,OAAO,EACJ,KAAK,EAAY,KAAW,CAAE,aAAY,OAAM,EAAE,EAClD,MAAM,EAAG,KAEL,EAAE,WAAW,gBAAkB,IAAM,EAAE,WAAW,gBAAkB,IAChD,EAAE,MAAQ,EAAE,KACpC,EACA,KAAK,CAAE,gBAAiB,CAAU,CACvC,CAMA,SAAgB,EAAuB,EAAuB,CAC5D,OAAO,EACJ,KAAK,EACL,YAAY,EACZ,QAAQ,KAAM,KAAK,EACnB,QAAQ,cAAe,GAAG,EAC1B,QAAQ,WAAY,EAAE,CAC3B,CAEA,SAAS,EAAiB,EAAwC,CAChE,MAAO,CAAC,EAAM,GAAI,EAAM,KAAM,EAAM,KAAK,EACtC,OAAQ,GAA2B,EAAQ,CAAM,EACjD,IAAI,CAAsB,CAC/B,CAEA,SAAgB,EACd,EACA,EACS,CACT,IAAM,EAAgB,IAAI,IACxB,EAAU,IAAK,GAAe,EAAuB,EAAW,IAAI,CAAC,CACvE,EACA,OAAO,EAAiB,CAAK,EAAE,KAAM,GAAQ,EAAc,IAAI,CAAG,CAAC,CACrE,CAEA,SAAS,EAAmB,EAAuC,CACjE,OAAO,EAAA,yBAAyB,EAAE,SAAS,EAAM,EAAE,CACrD,CAGA,SAAgB,EACd,EACS,CACT,OAAO,EAAA,eAAe,SAAS,EAAM,EAAE,GAAK,IAC9C,CAYA,SAAgB,EACd,EACuB,CAIvB,IAAM,EAAY,EAA2B,EAAA,OAAkB,EAAE,OAC9D,GAAU,CAAC,EAAyB,EAAO,CAAS,CACvD,EAEA,MAAO,CACL,OAAQ,EAAU,OAAO,CAAkB,EAC3C,aAAc,EAAU,OACrB,GACC,CAAC,EAAmB,CAAK,GAAK,EAA+B,CAAK,CACtE,CACF,CACF,CAEA,SAAgB,EACd,EACyB,CACzB,MAAO,CAAC,GAAG,EAAO,OAAQ,GAAG,EAAO,YAAY,CAClD"}
+{"version":3,"file":"recommended-automation-rail.cjs","names":[],"sources":["../../src/utils/recommended-automation-rail.ts"],"sourcesContent":["import {\n  AUTOMATION_CATALOG,\n  type RecommendedAutomation,\n} from \"@openhands/extensions/automations\";\nimport { getFeaturedAutomationIds } from \"#/manifests/automation-interface\";\nimport { SETUP_REGISTRY } from \"#/manifests/manifest-sources\";\nimport type { Automation } from \"#/types/automation\";\n\nexport function getAutomationsByPopularity(\n  catalog: RecommendedAutomation[],\n): RecommendedAutomation[] {\n  return catalog\n    .map((automation, index) => ({ automation, index }))\n    .sort((a, b) => {\n      const byPopularity =\n        (b.automation.popularityRank ?? 0) - (a.automation.popularityRank ?? 0);\n      return byPopularity || a.index - b.index;\n    })\n    .map(({ automation }) => automation);\n}\n\n/**\n * Slug used to match a catalog entry against an installed automation name.\n * Catalog ids are already kebab-case; installed names are human titles.\n */\nexport function normalizeAutomationKey(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/&/g, \"and\")\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n\nfunction catalogMatchKeys(entry: RecommendedAutomation): string[] {\n  return [\n    entry.id,\n    entry.name,\n    entry.name ? `${entry.name} Agent` : undefined,\n    entry.skill,\n  ]\n    .filter((value): value is string => Boolean(value))\n    .map(normalizeAutomationKey);\n}\n\nexport function isCatalogAutomationAdded(\n  entry: RecommendedAutomation,\n  installed: readonly Pick<Automation, \"name\">[],\n): boolean {\n  const installedKeys = new Set(\n    installed.map((automation) => normalizeAutomationKey(automation.name)),\n  );\n  return catalogMatchKeys(entry).some((key) => installedKeys.has(key));\n}\n\nfunction isProvenAutomation(entry: RecommendedAutomation): boolean {\n  return getFeaturedAutomationIds().includes(entry.id);\n}\n\n/** Catalog cards that launch a conversation instead of a host setup form. */\nexport function isConversationLaunchAutomation(\n  entry: RecommendedAutomation,\n): boolean {\n  return SETUP_REGISTRY.findById(entry.id) == null;\n}\n\nexport interface RecommendedRailGroups {\n  proven: RecommendedAutomation[];\n  conversation: RecommendedAutomation[];\n}\n\n/**\n * Home / dashboard rail: remaining proven workflows, then other useful\n * automations that open in a new conversation. Already-created automations\n * are dropped from both groups.\n */\nexport function getRecommendedRailGroups(\n  installed: readonly Pick<Automation, \"name\">[],\n): RecommendedRailGroups {\n  // Every catalog entry is offerable: one that declares no integration needs\n  // nothing connected, and one that names an integration this host cannot\n  // resolve stays visible so the drift is actionable rather than hidden.\n  const available = getAutomationsByPopularity(AUTOMATION_CATALOG).filter(\n    (entry) => !isCatalogAutomationAdded(entry, installed),\n  );\n\n  return {\n    proven: available.filter(isProvenAutomation),\n    conversation: available.filter(\n      (entry) =>\n        !isProvenAutomation(entry) && isConversationLaunchAutomation(entry),\n    ),\n  };\n}\n\nexport function flattenRecommendedRailGroups(\n  groups: RecommendedRailGroups,\n): RecommendedAutomation[] {\n  return [...groups.proven, ...groups.conversation];\n}\n"],"mappings":"8NAQA,SAAgB,EACd,EACyB,CACzB,OAAO,EACJ,KAAK,EAAY,KAAW,CAAE,aAAY,OAAM,EAAE,EAClD,MAAM,EAAG,KAEL,EAAE,WAAW,gBAAkB,IAAM,EAAE,WAAW,gBAAkB,IAChD,EAAE,MAAQ,EAAE,KACpC,EACA,KAAK,CAAE,gBAAiB,CAAU,CACvC,CAMA,SAAgB,EAAuB,EAAuB,CAC5D,OAAO,EACJ,KAAK,EACL,YAAY,EACZ,QAAQ,KAAM,KAAK,EACnB,QAAQ,cAAe,GAAG,EAC1B,QAAQ,WAAY,EAAE,CAC3B,CAEA,SAAS,EAAiB,EAAwC,CAChE,MAAO,CACL,EAAM,GACN,EAAM,KACN,EAAM,KAAO,GAAG,EAAM,KAAK,QAAU,IAAA,GACrC,EAAM,KACR,EACG,OAAQ,GAA2B,EAAQ,CAAM,EACjD,IAAI,CAAsB,CAC/B,CAEA,SAAgB,EACd,EACA,EACS,CACT,IAAM,EAAgB,IAAI,IACxB,EAAU,IAAK,GAAe,EAAuB,EAAW,IAAI,CAAC,CACvE,EACA,OAAO,EAAiB,CAAK,EAAE,KAAM,GAAQ,EAAc,IAAI,CAAG,CAAC,CACrE,CAEA,SAAS,EAAmB,EAAuC,CACjE,OAAO,EAAA,yBAAyB,EAAE,SAAS,EAAM,EAAE,CACrD,CAGA,SAAgB,EACd,EACS,CACT,OAAO,EAAA,eAAe,SAAS,EAAM,EAAE,GAAK,IAC9C,CAYA,SAAgB,EACd,EACuB,CAIvB,IAAM,EAAY,EAA2B,EAAA,OAAkB,EAAE,OAC9D,GAAU,CAAC,EAAyB,EAAO,CAAS,CACvD,EAEA,MAAO,CACL,OAAQ,EAAU,OAAO,CAAkB,EAC3C,aAAc,EAAU,OACrB,GACC,CAAC,EAAmB,CAAK,GAAK,EAA+B,CAAK,CACtE,CACF,CACF,CAEA,SAAgB,EACd,EACyB,CACzB,MAAO,CAAC,GAAG,EAAO,OAAQ,GAAG,EAAO,YAAY,CAClD"}

package/dist/utils/recommended-automation-rail.js

@@ -15,6 +15,7 @@ function a(e) {
 	return [
 		e.id,
 		e.name,
+		e.name ? `${e.name} Agent` : void 0,
 		e.skill
 	].filter((e) => !!e).map(i);
 }

package/dist/utils/recommended-automation-rail.js.map

@@ -1 +1 @@
-{"version":3,"file":"recommended-automation-rail.js","names":[],"sources":["../../src/utils/recommended-automation-rail.ts"],"sourcesContent":["import {\n  AUTOMATION_CATALOG,\n  type RecommendedAutomation,\n} from \"@openhands/extensions/automations\";\nimport { getFeaturedAutomationIds } from \"#/manifests/automation-interface\";\nimport { SETUP_REGISTRY } from \"#/manifests/manifest-sources\";\nimport type { Automation } from \"#/types/automation\";\n\nexport function getAutomationsByPopularity(\n  catalog: RecommendedAutomation[],\n): RecommendedAutomation[] {\n  return catalog\n    .map((automation, index) => ({ automation, index }))\n    .sort((a, b) => {\n      const byPopularity =\n        (b.automation.popularityRank ?? 0) - (a.automation.popularityRank ?? 0);\n      return byPopularity || a.index - b.index;\n    })\n    .map(({ automation }) => automation);\n}\n\n/**\n * Slug used to match a catalog entry against an installed automation name.\n * Catalog ids are already kebab-case; installed names are human titles.\n */\nexport function normalizeAutomationKey(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/&/g, \"and\")\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n\nfunction catalogMatchKeys(entry: RecommendedAutomation): string[] {\n  return [entry.id, entry.name, entry.skill]\n    .filter((value): value is string => Boolean(value))\n    .map(normalizeAutomationKey);\n}\n\nexport function isCatalogAutomationAdded(\n  entry: RecommendedAutomation,\n  installed: readonly Pick<Automation, \"name\">[],\n): boolean {\n  const installedKeys = new Set(\n    installed.map((automation) => normalizeAutomationKey(automation.name)),\n  );\n  return catalogMatchKeys(entry).some((key) => installedKeys.has(key));\n}\n\nfunction isProvenAutomation(entry: RecommendedAutomation): boolean {\n  return getFeaturedAutomationIds().includes(entry.id);\n}\n\n/** Catalog cards that launch a conversation instead of a host setup form. */\nexport function isConversationLaunchAutomation(\n  entry: RecommendedAutomation,\n): boolean {\n  return SETUP_REGISTRY.findById(entry.id) == null;\n}\n\nexport interface RecommendedRailGroups {\n  proven: RecommendedAutomation[];\n  conversation: RecommendedAutomation[];\n}\n\n/**\n * Home / dashboard rail: remaining proven workflows, then other useful\n * automations that open in a new conversation. Already-created automations\n * are dropped from both groups.\n */\nexport function getRecommendedRailGroups(\n  installed: readonly Pick<Automation, \"name\">[],\n): RecommendedRailGroups {\n  // Every catalog entry is offerable: one that declares no integration needs\n  // nothing connected, and one that names an integration this host cannot\n  // resolve stays visible so the drift is actionable rather than hidden.\n  const available = getAutomationsByPopularity(AUTOMATION_CATALOG).filter(\n    (entry) => !isCatalogAutomationAdded(entry, installed),\n  );\n\n  return {\n    proven: available.filter(isProvenAutomation),\n    conversation: available.filter(\n      (entry) =>\n        !isProvenAutomation(entry) && isConversationLaunchAutomation(entry),\n    ),\n  };\n}\n\nexport function flattenRecommendedRailGroups(\n  groups: RecommendedRailGroups,\n): RecommendedAutomation[] {\n  return [...groups.proven, ...groups.conversation];\n}\n"],"mappings":";;;;AAQA,SAAgB,EACd,GACyB;CACzB,OAAO,EACJ,KAAK,GAAY,OAAW;EAAE;EAAY;CAAM,EAAE,EAClD,MAAM,GAAG,OAEL,EAAE,WAAW,kBAAkB,MAAM,EAAE,WAAW,kBAAkB,MAChD,EAAE,QAAQ,EAAE,KACpC,EACA,KAAK,EAAE,oBAAiB,CAAU;AACvC;AAMA,SAAgB,EAAuB,GAAuB;CAC5D,OAAO,EACJ,KAAK,EACL,YAAY,EACZ,QAAQ,MAAM,KAAK,EACnB,QAAQ,eAAe,GAAG,EAC1B,QAAQ,YAAY,EAAE;AAC3B;AAEA,SAAS,EAAiB,GAAwC;CAChE,OAAO;EAAC,EAAM;EAAI,EAAM;EAAM,EAAM;CAAK,EACtC,QAAQ,MAA2B,EAAQ,CAAM,EACjD,IAAI,CAAsB;AAC/B;AAEA,SAAgB,EACd,GACA,GACS;CACT,IAAM,IAAgB,IAAI,IACxB,EAAU,KAAK,MAAe,EAAuB,EAAW,IAAI,CAAC,CACvE;CACA,OAAO,EAAiB,CAAK,EAAE,MAAM,MAAQ,EAAc,IAAI,CAAG,CAAC;AACrE;AAEA,SAAS,EAAmB,GAAuC;CACjE,OAAO,EAAyB,EAAE,SAAS,EAAM,EAAE;AACrD;AAGA,SAAgB,EACd,GACS;CACT,OAAO,EAAe,SAAS,EAAM,EAAE,KAAK;AAC9C;AAYA,SAAgB,EACd,GACuB;CAIvB,IAAM,IAAY,EAA2B,CAAkB,EAAE,QAC9D,MAAU,CAAC,EAAyB,GAAO,CAAS,CACvD;CAEA,OAAO;EACL,QAAQ,EAAU,OAAO,CAAkB;EAC3C,cAAc,EAAU,QACrB,MACC,CAAC,EAAmB,CAAK,KAAK,EAA+B,CAAK,CACtE;CACF;AACF;AAEA,SAAgB,EACd,GACyB;CACzB,OAAO,CAAC,GAAG,EAAO,QAAQ,GAAG,EAAO,YAAY;AAClD"}
+{"version":3,"file":"recommended-automation-rail.js","names":[],"sources":["../../src/utils/recommended-automation-rail.ts"],"sourcesContent":["import {\n  AUTOMATION_CATALOG,\n  type RecommendedAutomation,\n} from \"@openhands/extensions/automations\";\nimport { getFeaturedAutomationIds } from \"#/manifests/automation-interface\";\nimport { SETUP_REGISTRY } from \"#/manifests/manifest-sources\";\nimport type { Automation } from \"#/types/automation\";\n\nexport function getAutomationsByPopularity(\n  catalog: RecommendedAutomation[],\n): RecommendedAutomation[] {\n  return catalog\n    .map((automation, index) => ({ automation, index }))\n    .sort((a, b) => {\n      const byPopularity =\n        (b.automation.popularityRank ?? 0) - (a.automation.popularityRank ?? 0);\n      return byPopularity || a.index - b.index;\n    })\n    .map(({ automation }) => automation);\n}\n\n/**\n * Slug used to match a catalog entry against an installed automation name.\n * Catalog ids are already kebab-case; installed names are human titles.\n */\nexport function normalizeAutomationKey(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/&/g, \"and\")\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n\nfunction catalogMatchKeys(entry: RecommendedAutomation): string[] {\n  return [\n    entry.id,\n    entry.name,\n    entry.name ? `${entry.name} Agent` : undefined,\n    entry.skill,\n  ]\n    .filter((value): value is string => Boolean(value))\n    .map(normalizeAutomationKey);\n}\n\nexport function isCatalogAutomationAdded(\n  entry: RecommendedAutomation,\n  installed: readonly Pick<Automation, \"name\">[],\n): boolean {\n  const installedKeys = new Set(\n    installed.map((automation) => normalizeAutomationKey(automation.name)),\n  );\n  return catalogMatchKeys(entry).some((key) => installedKeys.has(key));\n}\n\nfunction isProvenAutomation(entry: RecommendedAutomation): boolean {\n  return getFeaturedAutomationIds().includes(entry.id);\n}\n\n/** Catalog cards that launch a conversation instead of a host setup form. */\nexport function isConversationLaunchAutomation(\n  entry: RecommendedAutomation,\n): boolean {\n  return SETUP_REGISTRY.findById(entry.id) == null;\n}\n\nexport interface RecommendedRailGroups {\n  proven: RecommendedAutomation[];\n  conversation: RecommendedAutomation[];\n}\n\n/**\n * Home / dashboard rail: remaining proven workflows, then other useful\n * automations that open in a new conversation. Already-created automations\n * are dropped from both groups.\n */\nexport function getRecommendedRailGroups(\n  installed: readonly Pick<Automation, \"name\">[],\n): RecommendedRailGroups {\n  // Every catalog entry is offerable: one that declares no integration needs\n  // nothing connected, and one that names an integration this host cannot\n  // resolve stays visible so the drift is actionable rather than hidden.\n  const available = getAutomationsByPopularity(AUTOMATION_CATALOG).filter(\n    (entry) => !isCatalogAutomationAdded(entry, installed),\n  );\n\n  return {\n    proven: available.filter(isProvenAutomation),\n    conversation: available.filter(\n      (entry) =>\n        !isProvenAutomation(entry) && isConversationLaunchAutomation(entry),\n    ),\n  };\n}\n\nexport function flattenRecommendedRailGroups(\n  groups: RecommendedRailGroups,\n): RecommendedAutomation[] {\n  return [...groups.proven, ...groups.conversation];\n}\n"],"mappings":";;;;AAQA,SAAgB,EACd,GACyB;CACzB,OAAO,EACJ,KAAK,GAAY,OAAW;EAAE;EAAY;CAAM,EAAE,EAClD,MAAM,GAAG,OAEL,EAAE,WAAW,kBAAkB,MAAM,EAAE,WAAW,kBAAkB,MAChD,EAAE,QAAQ,EAAE,KACpC,EACA,KAAK,EAAE,oBAAiB,CAAU;AACvC;AAMA,SAAgB,EAAuB,GAAuB;CAC5D,OAAO,EACJ,KAAK,EACL,YAAY,EACZ,QAAQ,MAAM,KAAK,EACnB,QAAQ,eAAe,GAAG,EAC1B,QAAQ,YAAY,EAAE;AAC3B;AAEA,SAAS,EAAiB,GAAwC;CAChE,OAAO;EACL,EAAM;EACN,EAAM;EACN,EAAM,OAAO,GAAG,EAAM,KAAK,UAAU,KAAA;EACrC,EAAM;CACR,EACG,QAAQ,MAA2B,EAAQ,CAAM,EACjD,IAAI,CAAsB;AAC/B;AAEA,SAAgB,EACd,GACA,GACS;CACT,IAAM,IAAgB,IAAI,IACxB,EAAU,KAAK,MAAe,EAAuB,EAAW,IAAI,CAAC,CACvE;CACA,OAAO,EAAiB,CAAK,EAAE,MAAM,MAAQ,EAAc,IAAI,CAAG,CAAC;AACrE;AAEA,SAAS,EAAmB,GAAuC;CACjE,OAAO,EAAyB,EAAE,SAAS,EAAM,EAAE;AACrD;AAGA,SAAgB,EACd,GACS;CACT,OAAO,EAAe,SAAS,EAAM,EAAE,KAAK;AAC9C;AAYA,SAAgB,EACd,GACuB;CAIvB,IAAM,IAAY,EAA2B,CAAkB,EAAE,QAC9D,MAAU,CAAC,EAAyB,GAAO,CAAS,CACvD;CAEA,OAAO;EACL,QAAQ,EAAU,OAAO,CAAkB;EAC3C,cAAc,EAAU,QACrB,MACC,CAAC,EAAmB,CAAK,KAAK,EAA+B,CAAK,CACtE;CACF;AACF;AAEA,SAAgB,EACd,GACyB;CACzB,OAAO,CAAC,GAAG,EAAO,QAAQ,GAAG,EAAO,YAAY;AAClD"}

package/dist/utils/scroll-fade-state.cjs

@@ -1,2 +1,2 @@
-require("../_virtual/_rolldown/runtime.cjs");var e=1;function t(t){let{scrollLeft:n,scrollWidth:r,clientWidth:i}=t,a=r-i,o=a>e;return{left:o&&n>e,right:o&&n<a-e}}exports.readScrollFadeState=t;
+require("../_virtual/_rolldown/runtime.cjs");var e=1;function t(t){let{scrollLeft:n,scrollWidth:r,clientWidth:i}=t,a=r-i,o=a>e;return{left:o&&n>e,right:o&&n<a-e}}function n(t){let{scrollTop:n,scrollHeight:r,clientHeight:i}=t,a=r-i,o=a>e;return{top:o&&n>e,bottom:o&&n<a-e}}exports.readScrollFadeState=t,exports.readVerticalScrollEdgeState=n;
 //# sourceMappingURL=scroll-fade-state.cjs.map

package/dist/utils/scroll-fade-state.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-fade-state.cjs","names":[],"sources":["../../src/utils/scroll-fade-state.ts"],"sourcesContent":["const SCROLL_EDGE_THRESHOLD_PX = 1;\n\nexport interface ScrollFadeState {\n  left: boolean;\n  right: boolean;\n}\n\n/** Whether a horizontal scroller is clipped on each edge. */\nexport function readScrollFadeState(element: HTMLElement): ScrollFadeState {\n  const { scrollLeft, scrollWidth, clientWidth } = element;\n  const maxScroll = scrollWidth - clientWidth;\n  const hasOverflow = maxScroll > SCROLL_EDGE_THRESHOLD_PX;\n\n  return {\n    left: hasOverflow && scrollLeft > SCROLL_EDGE_THRESHOLD_PX,\n    right: hasOverflow && scrollLeft < maxScroll - SCROLL_EDGE_THRESHOLD_PX,\n  };\n}\n"],"mappings":"6CAAA,IAAM,EAA2B,EAQjC,SAAgB,EAAoB,EAAuC,CACzE,GAAM,CAAE,aAAY,cAAa,eAAgB,EAC3C,EAAY,EAAc,EAC1B,EAAc,EAAY,EAEhC,MAAO,CACL,KAAM,GAAe,EAAa,EAClC,MAAO,GAAe,EAAa,EAAY,CACjD,CACF"}
+{"version":3,"file":"scroll-fade-state.cjs","names":[],"sources":["../../src/utils/scroll-fade-state.ts"],"sourcesContent":["const SCROLL_EDGE_THRESHOLD_PX = 1;\n\nexport interface ScrollFadeState {\n  left: boolean;\n  right: boolean;\n}\n\nexport interface VerticalScrollEdgeState {\n  top: boolean;\n  bottom: boolean;\n}\n\n/** Whether a horizontal scroller is clipped on each edge. */\nexport function readScrollFadeState(element: HTMLElement): ScrollFadeState {\n  const { scrollLeft, scrollWidth, clientWidth } = element;\n  const maxScroll = scrollWidth - clientWidth;\n  const hasOverflow = maxScroll > SCROLL_EDGE_THRESHOLD_PX;\n\n  return {\n    left: hasOverflow && scrollLeft > SCROLL_EDGE_THRESHOLD_PX,\n    right: hasOverflow && scrollLeft < maxScroll - SCROLL_EDGE_THRESHOLD_PX,\n  };\n}\n\n/** Whether a vertical scroller is clipped on each edge. */\nexport function readVerticalScrollEdgeState(\n  element: HTMLElement,\n): VerticalScrollEdgeState {\n  const { scrollTop, scrollHeight, clientHeight } = element;\n  const maxScroll = scrollHeight - clientHeight;\n  const hasOverflow = maxScroll > SCROLL_EDGE_THRESHOLD_PX;\n\n  return {\n    top: hasOverflow && scrollTop > SCROLL_EDGE_THRESHOLD_PX,\n    bottom: hasOverflow && scrollTop < maxScroll - SCROLL_EDGE_THRESHOLD_PX,\n  };\n}\n"],"mappings":"6CAAA,IAAM,EAA2B,EAajC,SAAgB,EAAoB,EAAuC,CACzE,GAAM,CAAE,aAAY,cAAa,eAAgB,EAC3C,EAAY,EAAc,EAC1B,EAAc,EAAY,EAEhC,MAAO,CACL,KAAM,GAAe,EAAa,EAClC,MAAO,GAAe,EAAa,EAAY,CACjD,CACF,CAGA,SAAgB,EACd,EACyB,CACzB,GAAM,CAAE,YAAW,eAAc,gBAAiB,EAC5C,EAAY,EAAe,EAC3B,EAAc,EAAY,EAEhC,MAAO,CACL,IAAK,GAAe,EAAY,EAChC,OAAQ,GAAe,EAAY,EAAY,CACjD,CACF"}

package/dist/utils/scroll-fade-state.d.ts

@@ -2,5 +2,11 @@ export interface ScrollFadeState {
     left: boolean;
     right: boolean;
 }
+export interface VerticalScrollEdgeState {
+    top: boolean;
+    bottom: boolean;
+}
 /** Whether a horizontal scroller is clipped on each edge. */
 export declare function readScrollFadeState(element: HTMLElement): ScrollFadeState;
+/** Whether a vertical scroller is clipped on each edge. */
+export declare function readVerticalScrollEdgeState(element: HTMLElement): VerticalScrollEdgeState;

package/dist/utils/scroll-fade-state.js

@@ -7,7 +7,14 @@ function t(t) {
 		right: o && n < a - e
 	};
 }
+function n(t) {
+	let { scrollTop: n, scrollHeight: r, clientHeight: i } = t, a = r - i, o = a > e;
+	return {
+		top: o && n > e,
+		bottom: o && n < a - e
+	};
+}
 //#endregion
-export { t as readScrollFadeState };
+export { t as readScrollFadeState, n as readVerticalScrollEdgeState };
 
 //# sourceMappingURL=scroll-fade-state.js.map

package/dist/utils/scroll-fade-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-fade-state.js","names":[],"sources":["../../src/utils/scroll-fade-state.ts"],"sourcesContent":["const SCROLL_EDGE_THRESHOLD_PX = 1;\n\nexport interface ScrollFadeState {\n  left: boolean;\n  right: boolean;\n}\n\n/** Whether a horizontal scroller is clipped on each edge. */\nexport function readScrollFadeState(element: HTMLElement): ScrollFadeState {\n  const { scrollLeft, scrollWidth, clientWidth } = element;\n  const maxScroll = scrollWidth - clientWidth;\n  const hasOverflow = maxScroll > SCROLL_EDGE_THRESHOLD_PX;\n\n  return {\n    left: hasOverflow && scrollLeft > SCROLL_EDGE_THRESHOLD_PX,\n    right: hasOverflow && scrollLeft < maxScroll - SCROLL_EDGE_THRESHOLD_PX,\n  };\n}\n"],"mappings":";AAAA,IAAM,IAA2B;AAQjC,SAAgB,EAAoB,GAAuC;CACzE,IAAM,EAAE,eAAY,gBAAa,mBAAgB,GAC3C,IAAY,IAAc,GAC1B,IAAc,IAAY;CAEhC,OAAO;EACL,MAAM,KAAe,IAAa;EAClC,OAAO,KAAe,IAAa,IAAY;CACjD;AACF"}
+{"version":3,"file":"scroll-fade-state.js","names":[],"sources":["../../src/utils/scroll-fade-state.ts"],"sourcesContent":["const SCROLL_EDGE_THRESHOLD_PX = 1;\n\nexport interface ScrollFadeState {\n  left: boolean;\n  right: boolean;\n}\n\nexport interface VerticalScrollEdgeState {\n  top: boolean;\n  bottom: boolean;\n}\n\n/** Whether a horizontal scroller is clipped on each edge. */\nexport function readScrollFadeState(element: HTMLElement): ScrollFadeState {\n  const { scrollLeft, scrollWidth, clientWidth } = element;\n  const maxScroll = scrollWidth - clientWidth;\n  const hasOverflow = maxScroll > SCROLL_EDGE_THRESHOLD_PX;\n\n  return {\n    left: hasOverflow && scrollLeft > SCROLL_EDGE_THRESHOLD_PX,\n    right: hasOverflow && scrollLeft < maxScroll - SCROLL_EDGE_THRESHOLD_PX,\n  };\n}\n\n/** Whether a vertical scroller is clipped on each edge. */\nexport function readVerticalScrollEdgeState(\n  element: HTMLElement,\n): VerticalScrollEdgeState {\n  const { scrollTop, scrollHeight, clientHeight } = element;\n  const maxScroll = scrollHeight - clientHeight;\n  const hasOverflow = maxScroll > SCROLL_EDGE_THRESHOLD_PX;\n\n  return {\n    top: hasOverflow && scrollTop > SCROLL_EDGE_THRESHOLD_PX,\n    bottom: hasOverflow && scrollTop < maxScroll - SCROLL_EDGE_THRESHOLD_PX,\n  };\n}\n"],"mappings":";AAAA,IAAM,IAA2B;AAajC,SAAgB,EAAoB,GAAuC;CACzE,IAAM,EAAE,eAAY,gBAAa,mBAAgB,GAC3C,IAAY,IAAc,GAC1B,IAAc,IAAY;CAEhC,OAAO;EACL,MAAM,KAAe,IAAa;EAClC,OAAO,KAAe,IAAa,IAAY;CACjD;AACF;AAGA,SAAgB,EACd,GACyB;CACzB,IAAM,EAAE,cAAW,iBAAc,oBAAiB,GAC5C,IAAY,IAAe,GAC3B,IAAc,IAAY;CAEhC,OAAO;EACL,KAAK,KAAe,IAAY;EAChC,QAAQ,KAAe,IAAY,IAAY;CACjD;AACF"}

package/dist/utils/sdk-settings-schema.cjs

@@ -1,2 +1,2 @@
-require("../_virtual/_rolldown/runtime.cjs");const e=require("../constants/llm-subscription.cjs"),t=require("./sdk-settings-field-metadata.cjs");var n=new Set([`llm.model`,`llm.api_key`,`llm.base_url`,e.LLM_AUTH_TYPE_KEY,e.LLM_SUBSCRIPTION_VENDOR_KEY]),r={basic:new Set([`critical`]),advanced:new Set([`critical`,`major`]),all:new Set([`critical`,`major`,`minor`])};function i(e){return!!e&&Array.isArray(e.sections)}function a(e){return i(e)?e.sections.flatMap(e=>e.fields):[]}function o(e,t){if(!e)return;let n=t.split(`.`),r=e;for(let e of n){if(typeof r!=`object`||!r)return;r=r[e]}return r}function s(e,t,n){let r=t.split(`.`),i=e;for(let e=0;e<r.length-1;e+=1){let t=r[e];(i[t]==null||typeof i[t]!=`object`||Array.isArray(i[t]))&&(i[t]={}),i=i[t]}i[r[r.length-1]]=n}function c(e,t,n=`agent_settings`){return o(e[n],t)??null}function l(e,t){return c(e,t,`agent_settings`)}function u(e){return e.choices.length>0}function d(e){return e.prominence===`critical`}function f(e){return e.prominence===`minor`}function p(e,t){let n=t??e.default;return u(e)?n==null?``:String(n):e.value_type===`boolean`?!!(n??!1):n==null?``:e.value_type===`array`||e.value_type===`object`?JSON.stringify(n,null,2):String(n)}function m(e,t){if(t===void 0)return null;if(e.value_type===`boolean`){if(typeof t==`string`){if(t===`true`)return!0;if(t===`false`)return!1}return t===null?null:!!t}if(e.value_type===`integer`||e.value_type===`number`){if(t===``||t===null)return null;let e=typeof t==`number`?t:Number(String(t));return Number.isNaN(e)?null:e}if(e.value_type===`array`||e.value_type===`object`){if(t===null||e.value_type===`object`&&typeof t==`object`&&!Array.isArray(t)&&Object.keys(t).length===0)return null;if(typeof t==`string`){let n=t.trim();if(!n)return null;try{let t=JSON.parse(n);return e.value_type===`object`&&typeof t==`object`&&t&&!Array.isArray(t)&&Object.keys(t).length===0?null:JSON.stringify(t)}catch{return n}}return JSON.stringify(t)}return t===null?null:String(t)}function h(e,t,n=`agent_settings`){let r=t??(n===`conversation_settings`?e.conversation_settings_schema:e.agent_settings_schema);return r?Object.fromEntries(a(r).map(t=>[t.key,p(t,c(e,t.key,n))])):{}}function g(e,t,n=`agent_settings`){let r=t??(n===`conversation_settings`?e.conversation_settings_schema:e.agent_settings_schema);if(!r)return`basic`;let i=!1,o=!1;for(let t of a(r))d(t)||m(t,c(e,t.key,n)??t.default??null)!==m(t,t.default??null)&&(f(t)?i=!0:o=!0);return i?`all`:o?`advanced`:`basic`}function _(e,t){return e.depends_on.every(e=>t[e]===!0)}function v(e){if(typeof e==`boolean`)return e;let t=e.trim().toLowerCase();if(!t)return null;if(t===`true`)return!0;if(t===`false`)return!1;throw Error(`Expected a boolean value, received: ${e}`)}function y(e,n){if(e.value_type===`boolean`)return v(n);if(e.value_type===`integer`||e.value_type===`number`){let r=String(n).trim();if(!r)return null;let i=Number(r);if(Number.isNaN(i))throw Error(`Expected a numeric value, received: ${r}`);if(e.value_type===`integer`&&!Number.isInteger(i))throw Error(`Expected an integer value, received: ${r}`);let a=t.getSettingsFieldConstraints(e.key);if(a?.min!=null&&i<a.min)throw Error(`${e.label} must be at least ${a.min}`);if(a?.max!=null&&i>a.max)throw Error(`${e.label} must be at most ${a.max}`);return i}if(e.value_type===`array`||e.value_type===`object`){let t=String(n).trim();if(!t)return null;let r;try{r=JSON.parse(t)}catch{throw Error(`Invalid JSON for ${e.label}`)}if(e.value_type===`array`){if(!Array.isArray(r))throw Error(`${e.label} must be a JSON array`);return r}if(r===null||Array.isArray(r)||typeof r!=`object`)throw Error(`${e.label} must be a JSON object`);return r}let r=String(n);return r===``&&!e.secret?null:r}function b(e,t,n){let r={};for(let i of a(e))n[i.key]&&s(r,i.key,y(i,t[i.key]));return r}function x(e,t){return r[t].has(e.prominence)}function S(e,t,n,r){let i=b(e,t,n);for(let t of a(e))x(t,r)||s(i,t.key,t.default??null);return i}function C(e,t,r,a=n){return i(e)?e.sections.map(e=>({...e,fields:e.fields.filter(e=>!a.has(e.key)&&x(e,r)&&_(e,t))})).filter(e=>e.fields.length>0):[]}function w(e){return e?a(e).some(e=>e.prominence===`critical`):!1}function T(e){return e?a(e).some(e=>e.prominence===`major`):!1}function E(e){return e?a(e).some(e=>e.prominence===`minor`):!1}exports.buildInitialSettingsFormValues=h,exports.buildSdkSettingsPayload=b,exports.buildSdkSettingsPayloadForView=S,exports.getAgentSettingValue=l,exports.getVisibleSettingsSections=C,exports.hasAdvancedSettings=T,exports.hasCriticalSettings=w,exports.hasMinorSettings=E,exports.inferInitialView=g,exports.isValidSettingsSchema=i;
+require("../_virtual/_rolldown/runtime.cjs");const e=require("../constants/llm-subscription.cjs"),t=require("./sdk-settings-field-metadata.cjs");var n=new Set([`llm.model`,`llm.api_key`,`llm.base_url`,e.LLM_AUTH_TYPE_KEY,e.LLM_SUBSCRIPTION_VENDOR_KEY]),r={basic:new Set([`critical`]),advanced:new Set([`critical`,`major`]),all:new Set([`critical`,`major`,`minor`])};function i(e){return!!e&&Array.isArray(e.sections)}function a(e){return i(e)?e.sections.flatMap(e=>e.fields):[]}function o(e,t){if(!e)return;let n=t.split(`.`),r=e;for(let e of n){if(typeof r!=`object`||!r)return;r=r[e]}return r}function s(e,t,n){let r=t.split(`.`),i=e;for(let e=0;e<r.length-1;e+=1){let t=r[e];(i[t]==null||typeof i[t]!=`object`||Array.isArray(i[t]))&&(i[t]={}),i=i[t]}i[r[r.length-1]]=n}function c(e,t,n=`agent_settings`){return o(e[n],t)??null}function l(e,t){return c(e,t,`agent_settings`)}function u(e){return e.choices.length>0}function d(e){return e.prominence===`critical`}function f(e){return e.prominence===`minor`}function p(e,t){let n=t??e.default;return u(e)?n==null?``:String(n):e.value_type===`boolean`?!!(n??!1):n==null?``:e.value_type===`array`||e.value_type===`object`?JSON.stringify(n,null,2):String(n)}function m(e){return typeof e!=`object`||!e?JSON.stringify(e):Array.isArray(e)?`[${e.map(m).join(`,`)}]`:`{${Object.entries(e).sort(([e],[t])=>e.localeCompare(t)).map(([e,t])=>`${JSON.stringify(e)}:${m(t)}`).join(`,`)}}`}function h(e,t){if(t===void 0)return null;if(e.value_type===`boolean`){if(typeof t==`string`){if(t===`true`)return!0;if(t===`false`)return!1}return t===null?null:!!t}if(e.value_type===`integer`||e.value_type===`number`){if(t===``||t===null)return null;let e=typeof t==`number`?t:Number(String(t));return Number.isNaN(e)?null:e}if(e.value_type===`array`||e.value_type===`object`){if(t===null||e.value_type===`object`&&typeof t==`object`&&!Array.isArray(t)&&Object.keys(t).length===0)return null;if(typeof t==`string`){let n=t.trim();if(!n)return null;try{let t=JSON.parse(n);return e.value_type===`object`&&typeof t==`object`&&t&&!Array.isArray(t)&&Object.keys(t).length===0?null:m(t)}catch{return n}}return m(t)}return t===null?null:String(t)}function g(e,t,n=`agent_settings`){let r=t??(n===`conversation_settings`?e.conversation_settings_schema:e.agent_settings_schema);return r?Object.fromEntries(a(r).map(t=>[t.key,p(t,c(e,t.key,n))])):{}}function _(e,t,n=`agent_settings`){let r=t??(n===`conversation_settings`?e.conversation_settings_schema:e.agent_settings_schema);if(!r)return`basic`;let i=!1,o=!1;for(let t of a(r))d(t)||h(t,c(e,t.key,n)??t.default??null)!==h(t,t.default??null)&&(f(t)?i=!0:o=!0);return i?`all`:o?`advanced`:`basic`}function v(e,t){return e.depends_on.every(e=>t[e]===!0)}function y(e){if(typeof e==`boolean`)return e;let t=e.trim().toLowerCase();if(!t)return null;if(t===`true`)return!0;if(t===`false`)return!1;throw Error(`Expected a boolean value, received: ${e}`)}function b(e,n){if(e.value_type===`boolean`)return y(n);if(e.value_type===`integer`||e.value_type===`number`){let r=String(n).trim();if(!r)return null;let i=Number(r);if(Number.isNaN(i))throw Error(`Expected a numeric value, received: ${r}`);if(e.value_type===`integer`&&!Number.isInteger(i))throw Error(`Expected an integer value, received: ${r}`);let a=t.getSettingsFieldConstraints(e.key);if(a?.min!=null&&i<a.min)throw Error(`${e.label} must be at least ${a.min}`);if(a?.max!=null&&i>a.max)throw Error(`${e.label} must be at most ${a.max}`);return i}if(e.value_type===`array`||e.value_type===`object`){let t=String(n).trim();if(!t)return null;let r;try{r=JSON.parse(t)}catch{throw Error(`Invalid JSON for ${e.label}`)}if(e.value_type===`array`){if(!Array.isArray(r))throw Error(`${e.label} must be a JSON array`);return r}if(r===null||Array.isArray(r)||typeof r!=`object`)throw Error(`${e.label} must be a JSON object`);return r}let r=String(n);return r===``&&!e.secret?null:r}function x(e,t,n){let r={};for(let i of a(e))n[i.key]&&s(r,i.key,b(i,t[i.key]));return r}function S(e,t){return r[t].has(e.prominence)}function C(e,t,n,r){let i=x(e,t,n);for(let t of a(e))S(t,r)||s(i,t.key,t.default??null);return i}function w(e,t,r,a=n){return i(e)?e.sections.map(e=>({...e,fields:e.fields.filter(e=>!a.has(e.key)&&S(e,r)&&v(e,t))})).filter(e=>e.fields.length>0):[]}function T(e){return e?a(e).some(e=>e.prominence===`critical`):!1}function E(e){return e?a(e).some(e=>e.prominence===`major`):!1}function D(e){return e?a(e).some(e=>e.prominence===`minor`):!1}exports.buildInitialSettingsFormValues=g,exports.buildSdkSettingsPayload=x,exports.buildSdkSettingsPayloadForView=C,exports.getAgentSettingValue=l,exports.getVisibleSettingsSections=w,exports.hasAdvancedSettings=E,exports.hasCriticalSettings=T,exports.hasMinorSettings=D,exports.inferInitialView=_,exports.isValidSettingsSchema=i,exports.normalizeComparableValue=h;
 //# sourceMappingURL=sdk-settings-schema.cjs.map

package/dist/utils/sdk-settings-schema.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-settings-schema.cjs","names":[],"sources":["../../src/utils/sdk-settings-schema.ts"],"sourcesContent":["import {\n  SettingProminence,\n  Settings,\n  SettingsFieldSchema,\n  SettingsSchema,\n  SettingsSectionSchema,\n  SettingsValue,\n} from \"#/types/settings\";\nimport { getSettingsFieldConstraints } from \"#/utils/sdk-settings-field-metadata\";\nimport {\n  LLM_AUTH_TYPE_KEY,\n  LLM_SUBSCRIPTION_VENDOR_KEY,\n} from \"#/constants/llm-subscription\";\n\nexport type SettingsFormValues = Record<string, string | boolean>;\nexport type SettingsDirtyState = Record<string, boolean>;\nexport type SdkSettingsPayload = Record<string, SettingsValue>;\nexport type SettingsValueSource = \"agent_settings\" | \"conversation_settings\";\n\nexport type SettingsView = \"basic\" | \"advanced\" | \"all\";\n\n/** Fields that are rendered by purpose-built components instead of the\n *  generic `SchemaField` renderer. */\nexport const SPECIALLY_RENDERED_KEYS = new Set([\n  \"llm.model\",\n  \"llm.api_key\",\n  \"llm.base_url\",\n  LLM_AUTH_TYPE_KEY,\n  LLM_SUBSCRIPTION_VENDOR_KEY,\n]);\n\n/** Prominence tiers visible at each view level. */\nconst VIEW_PROMINENCES: Record<SettingsView, Set<SettingProminence>> = {\n  basic: new Set<SettingProminence>([\"critical\"]),\n  advanced: new Set<SettingProminence>([\"critical\", \"major\"]),\n  all: new Set<SettingProminence>([\"critical\", \"major\", \"minor\"]),\n};\n\n/**\n * True when `schema` looks like a usable `SettingsSchema` — i.e. an\n * object with an array `sections` field. Guards every helper in this\n * module against malformed/empty schema responses (e.g. when the\n * frontend ends up pointing at a host that does not actually serve\n * `/api/settings/agent-schema`, such as an unconfigured Vercel preview\n * origin that returns the React Router SPA shell for arbitrary\n * `/api/*` paths). Without this check, `schema.sections.filter(...)`\n * inside `SdkSectionPage` blows up with\n * `Cannot read properties of undefined (reading 'filter')` and React\n * Router escalates to a full-screen error page.\n */\nexport function isValidSettingsSchema(\n  schema: SettingsSchema | null | undefined,\n): schema is SettingsSchema {\n  return !!schema && Array.isArray((schema as SettingsSchema).sections);\n}\n\nfunction getSchemaFields(schema: SettingsSchema): SettingsFieldSchema[] {\n  if (!isValidSettingsSchema(schema)) return [];\n  return schema.sections.flatMap((section) => section.fields);\n}\n\n/** Traverse a nested object using a dotted key path (e.g. \"llm.model\"). */\nfunction lookupDotted(\n  obj: Record<string, unknown> | null | undefined,\n  key: string,\n): unknown {\n  if (!obj) return undefined;\n  const parts = key.split(\".\");\n  let current: unknown = obj;\n  for (const part of parts) {\n    if (current == null || typeof current !== \"object\") return undefined;\n    current = (current as Record<string, unknown>)[part];\n  }\n  return current;\n}\n\n/** Set a value in a nested object at a dotted key path (e.g. \"llm.model\"). */\nfunction setDotted(\n  obj: Record<string, unknown>,\n  key: string,\n  value: unknown,\n): void {\n  const parts = key.split(\".\");\n  let current: Record<string, unknown> = obj;\n  for (let i = 0; i < parts.length - 1; i += 1) {\n    const part = parts[i];\n    if (\n      current[part] == null ||\n      typeof current[part] !== \"object\" ||\n      Array.isArray(current[part])\n    ) {\n      current[part] = {};\n    }\n    current = current[part] as Record<string, unknown>;\n  }\n  current[parts[parts.length - 1]] = value;\n}\n\nexport function getSettingValue(\n  settings: Settings,\n  key: string,\n  source: SettingsValueSource = \"agent_settings\",\n): SettingsValue {\n  return (lookupDotted(settings[source] as Record<string, unknown>, key) ??\n    null) as SettingsValue;\n}\n\nexport function getAgentSettingValue(\n  settings: Settings,\n  key: string,\n): SettingsValue {\n  return getSettingValue(settings, key, \"agent_settings\");\n}\n\nexport function getConversationSettingValue(\n  settings: Settings,\n  key: string,\n): SettingsValue {\n  return getSettingValue(settings, key, \"conversation_settings\");\n}\n\nfunction isChoiceField(field: SettingsFieldSchema): boolean {\n  return field.choices.length > 0;\n}\n\nfunction isCriticalField(field: SettingsFieldSchema): boolean {\n  return field.prominence === \"critical\";\n}\n\nfunction isMinorField(field: SettingsFieldSchema): boolean {\n  return field.prominence === \"minor\";\n}\n\nexport function normalizeFieldValue(\n  field: SettingsFieldSchema,\n  rawValue: unknown,\n): string | boolean {\n  const resolvedValue = rawValue ?? field.default;\n\n  if (isChoiceField(field)) {\n    return resolvedValue === null || resolvedValue === undefined\n      ? \"\"\n      : String(resolvedValue);\n  }\n\n  if (field.value_type === \"boolean\") {\n    return Boolean(resolvedValue ?? false);\n  }\n\n  if (resolvedValue === null || resolvedValue === undefined) {\n    return \"\";\n  }\n\n  if (field.value_type === \"array\" || field.value_type === \"object\") {\n    return JSON.stringify(resolvedValue, null, 2);\n  }\n\n  return String(resolvedValue);\n}\n\nfunction normalizeComparableValue(\n  field: SettingsFieldSchema,\n  rawValue: unknown,\n): boolean | number | string | null {\n  if (rawValue === undefined) {\n    return null;\n  }\n\n  if (field.value_type === \"boolean\") {\n    if (typeof rawValue === \"string\") {\n      if (rawValue === \"true\") {\n        return true;\n      }\n      if (rawValue === \"false\") {\n        return false;\n      }\n    }\n    if (rawValue === null) {\n      return null;\n    }\n    return Boolean(rawValue);\n  }\n\n  if (field.value_type === \"integer\" || field.value_type === \"number\") {\n    if (rawValue === \"\" || rawValue === null) {\n      return null;\n    }\n\n    const parsedValue =\n      typeof rawValue === \"number\" ? rawValue : Number(String(rawValue));\n    return Number.isNaN(parsedValue) ? null : parsedValue;\n  }\n\n  if (field.value_type === \"array\" || field.value_type === \"object\") {\n    if (rawValue === null) {\n      return null;\n    }\n\n    // Treat empty objects as null so that serializer artifacts\n    // (e.g. mcp_config: {} vs schema default null) don't trigger\n    // a spurious view escalation in inferInitialView.\n    if (\n      field.value_type === \"object\" &&\n      typeof rawValue === \"object\" &&\n      !Array.isArray(rawValue) &&\n      Object.keys(rawValue as Record<string, unknown>).length === 0\n    ) {\n      return null;\n    }\n\n    if (typeof rawValue === \"string\") {\n      const trimmedValue = rawValue.trim();\n      if (!trimmedValue) {\n        return null;\n      }\n      try {\n        const parsed: unknown = JSON.parse(trimmedValue);\n        // Also normalise stringified empty objects\n        if (\n          field.value_type === \"object\" &&\n          parsed !== null &&\n          typeof parsed === \"object\" &&\n          !Array.isArray(parsed) &&\n          Object.keys(parsed as Record<string, unknown>).length === 0\n        ) {\n          return null;\n        }\n        return JSON.stringify(parsed);\n      } catch {\n        return trimmedValue;\n      }\n    }\n\n    return JSON.stringify(rawValue);\n  }\n\n  if (rawValue === null) {\n    return null;\n  }\n\n  return String(rawValue);\n}\n\nexport function buildInitialSettingsFormValues(\n  settings: Settings,\n  schemaOverride?: SettingsSchema | null,\n  source: SettingsValueSource = \"agent_settings\",\n): SettingsFormValues {\n  const schema =\n    schemaOverride ??\n    (source === \"conversation_settings\"\n      ? settings.conversation_settings_schema\n      : settings.agent_settings_schema);\n  if (!schema) {\n    return {};\n  }\n\n  return Object.fromEntries(\n    getSchemaFields(schema).map((field) => [\n      field.key,\n      normalizeFieldValue(field, getSettingValue(settings, field.key, source)),\n    ]),\n  );\n}\n\nexport function inferInitialView(\n  settings: Settings,\n  schemaOverride?: SettingsSchema | null,\n  source: SettingsValueSource = \"agent_settings\",\n): SettingsView {\n  const schema =\n    schemaOverride ??\n    (source === \"conversation_settings\"\n      ? settings.conversation_settings_schema\n      : settings.agent_settings_schema);\n  if (!schema) {\n    return \"basic\";\n  }\n\n  let hasMinorOverride = false;\n  let hasMajorOverride = false;\n\n  for (const field of getSchemaFields(schema)) {\n    if (!isCriticalField(field)) {\n      const currentValue = getSettingValue(settings, field.key, source);\n      const isDifferent =\n        normalizeComparableValue(\n          field,\n          currentValue ?? field.default ?? null,\n        ) !== normalizeComparableValue(field, field.default ?? null);\n\n      if (isDifferent) {\n        if (isMinorField(field)) {\n          hasMinorOverride = true;\n        } else {\n          hasMajorOverride = true;\n        }\n      }\n    }\n  }\n\n  if (hasMinorOverride) return \"all\";\n  if (hasMajorOverride) return \"advanced\";\n  return \"basic\";\n}\n\n/** Determine which view tier to default to based on whether the user has\n *  overridden any non-critical settings. */\nexport function hasAdvancedSettingsOverrides(settings: Settings): boolean {\n  return inferInitialView(settings) !== \"basic\";\n}\n\nexport function isSettingsFieldVisible(\n  field: SettingsFieldSchema,\n  values: SettingsFormValues,\n): boolean {\n  return field.depends_on.every((dependency) => values[dependency] === true);\n}\n\nfunction parseBooleanFieldValue(rawValue: string | boolean): boolean | null {\n  if (typeof rawValue === \"boolean\") {\n    return rawValue;\n  }\n\n  const normalizedValue = rawValue.trim().toLowerCase();\n  if (!normalizedValue) {\n    return null;\n  }\n  if (normalizedValue === \"true\") {\n    return true;\n  }\n  if (normalizedValue === \"false\") {\n    return false;\n  }\n\n  throw new Error(`Expected a boolean value, received: ${rawValue}`);\n}\n\nexport function coerceFieldValue(\n  field: SettingsFieldSchema,\n  rawValue: string | boolean,\n): SettingsValue {\n  if (field.value_type === \"boolean\") {\n    return parseBooleanFieldValue(rawValue);\n  }\n\n  if (field.value_type === \"integer\" || field.value_type === \"number\") {\n    const stringValue = String(rawValue).trim();\n    if (!stringValue) {\n      return null;\n    }\n\n    const parsedValue = Number(stringValue);\n    if (Number.isNaN(parsedValue)) {\n      throw new Error(`Expected a numeric value, received: ${stringValue}`);\n    }\n    if (field.value_type === \"integer\" && !Number.isInteger(parsedValue)) {\n      throw new Error(`Expected an integer value, received: ${stringValue}`);\n    }\n\n    const constraints = getSettingsFieldConstraints(field.key);\n    if (constraints?.min != null && parsedValue < constraints.min) {\n      throw new Error(`${field.label} must be at least ${constraints.min}`);\n    }\n    if (constraints?.max != null && parsedValue > constraints.max) {\n      throw new Error(`${field.label} must be at most ${constraints.max}`);\n    }\n\n    return parsedValue;\n  }\n\n  if (field.value_type === \"array\" || field.value_type === \"object\") {\n    const stringValue = String(rawValue).trim();\n    if (!stringValue) {\n      return null;\n    }\n\n    let parsedValue: unknown;\n    try {\n      parsedValue = JSON.parse(stringValue);\n    } catch {\n      throw new Error(`Invalid JSON for ${field.label}`);\n    }\n\n    if (field.value_type === \"array\") {\n      if (!Array.isArray(parsedValue)) {\n        throw new Error(`${field.label} must be a JSON array`);\n      }\n      return parsedValue as SettingsValue[];\n    }\n\n    if (\n      parsedValue === null ||\n      Array.isArray(parsedValue) ||\n      typeof parsedValue !== \"object\"\n    ) {\n      throw new Error(`${field.label} must be a JSON object`);\n    }\n\n    return parsedValue as { [key: string]: SettingsValue };\n  }\n\n  const stringValue = String(rawValue);\n  if (stringValue === \"\" && !field.secret) {\n    return null;\n  }\n\n  return stringValue;\n}\n\nexport function buildSdkSettingsPayload(\n  schema: SettingsSchema,\n  values: SettingsFormValues,\n  dirty: SettingsDirtyState,\n): SdkSettingsPayload {\n  const payload: Record<string, unknown> = {};\n\n  for (const field of getSchemaFields(schema)) {\n    if (dirty[field.key]) {\n      setDotted(payload, field.key, coerceFieldValue(field, values[field.key]));\n    }\n  }\n\n  return payload as SdkSettingsPayload;\n}\n\nfunction isFieldVisibleInView(\n  field: SettingsFieldSchema,\n  view: SettingsView,\n): boolean {\n  return VIEW_PROMINENCES[view].has(field.prominence);\n}\n\nexport function buildSdkSettingsPayloadForView(\n  schema: SettingsSchema,\n  values: SettingsFormValues,\n  dirty: SettingsDirtyState,\n  view: SettingsView,\n): SdkSettingsPayload {\n  const payload = buildSdkSettingsPayload(schema, values, dirty) as Record<\n    string,\n    unknown\n  >;\n\n  for (const field of getSchemaFields(schema)) {\n    if (!isFieldVisibleInView(field, view)) {\n      setDotted(payload, field.key, field.default ?? null);\n    }\n  }\n\n  return payload as SdkSettingsPayload;\n}\n\n/** Return sections with fields filtered for the current view tier.\n *  Specially-rendered fields are excluded from the generic list. */\nexport function getVisibleSettingsSections(\n  schema: SettingsSchema,\n  values: SettingsFormValues,\n  view: SettingsView,\n  excludeKeys: Set<string> = SPECIALLY_RENDERED_KEYS,\n): SettingsSectionSchema[] {\n  if (!isValidSettingsSchema(schema)) return [];\n  return schema.sections\n    .map((section) => ({\n      ...section,\n      fields: section.fields.filter(\n        (field) =>\n          !excludeKeys.has(field.key) &&\n          isFieldVisibleInView(field, view) &&\n          isSettingsFieldVisible(field, values),\n      ),\n    }))\n    .filter((section) => section.fields.length > 0);\n}\n\n/** Whether the schema has any \"critical\" prominence fields (the basic tier). */\nexport function hasCriticalSettings(schema: SettingsSchema | null): boolean {\n  if (!schema) return false;\n  return getSchemaFields(schema).some((f) => f.prominence === \"critical\");\n}\n\n/** Whether the schema has any fields visible in the \"advanced\" tier. */\nexport function hasAdvancedSettings(schema: SettingsSchema | null): boolean {\n  if (!schema) return false;\n  return getSchemaFields(schema).some((f) => f.prominence === \"major\");\n}\n\n/** Whether the schema has any \"minor\" prominence fields. */\nexport function hasMinorSettings(schema: SettingsSchema | null): boolean {\n  if (!schema) return false;\n  return getSchemaFields(schema).some((f) => f.prominence === \"minor\");\n}\n"],"mappings":"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"}
+{"version":3,"file":"sdk-settings-schema.cjs","names":[],"sources":["../../src/utils/sdk-settings-schema.ts"],"sourcesContent":["import {\n  SettingProminence,\n  Settings,\n  SettingsFieldSchema,\n  SettingsSchema,\n  SettingsSectionSchema,\n  SettingsValue,\n} from \"#/types/settings\";\nimport { getSettingsFieldConstraints } from \"#/utils/sdk-settings-field-metadata\";\nimport {\n  LLM_AUTH_TYPE_KEY,\n  LLM_SUBSCRIPTION_VENDOR_KEY,\n} from \"#/constants/llm-subscription\";\n\nexport type SettingsFormValues = Record<string, string | boolean>;\nexport type SettingsDirtyState = Record<string, boolean>;\nexport type SdkSettingsPayload = Record<string, SettingsValue>;\nexport type SettingsValueSource = \"agent_settings\" | \"conversation_settings\";\n\nexport type SettingsView = \"basic\" | \"advanced\" | \"all\";\n\n/** Fields that are rendered by purpose-built components instead of the\n *  generic `SchemaField` renderer. */\nexport const SPECIALLY_RENDERED_KEYS = new Set([\n  \"llm.model\",\n  \"llm.api_key\",\n  \"llm.base_url\",\n  LLM_AUTH_TYPE_KEY,\n  LLM_SUBSCRIPTION_VENDOR_KEY,\n]);\n\n/** Prominence tiers visible at each view level. */\nconst VIEW_PROMINENCES: Record<SettingsView, Set<SettingProminence>> = {\n  basic: new Set<SettingProminence>([\"critical\"]),\n  advanced: new Set<SettingProminence>([\"critical\", \"major\"]),\n  all: new Set<SettingProminence>([\"critical\", \"major\", \"minor\"]),\n};\n\n/**\n * True when `schema` looks like a usable `SettingsSchema` — i.e. an\n * object with an array `sections` field. Guards every helper in this\n * module against malformed/empty schema responses (e.g. when the\n * frontend ends up pointing at a host that does not actually serve\n * `/api/settings/agent-schema`, such as an unconfigured Vercel preview\n * origin that returns the React Router SPA shell for arbitrary\n * `/api/*` paths). Without this check, `schema.sections.filter(...)`\n * inside `SdkSectionPage` blows up with\n * `Cannot read properties of undefined (reading 'filter')` and React\n * Router escalates to a full-screen error page.\n */\nexport function isValidSettingsSchema(\n  schema: SettingsSchema | null | undefined,\n): schema is SettingsSchema {\n  return !!schema && Array.isArray((schema as SettingsSchema).sections);\n}\n\nfunction getSchemaFields(schema: SettingsSchema): SettingsFieldSchema[] {\n  if (!isValidSettingsSchema(schema)) return [];\n  return schema.sections.flatMap((section) => section.fields);\n}\n\n/** Traverse a nested object using a dotted key path (e.g. \"llm.model\"). */\nfunction lookupDotted(\n  obj: Record<string, unknown> | null | undefined,\n  key: string,\n): unknown {\n  if (!obj) return undefined;\n  const parts = key.split(\".\");\n  let current: unknown = obj;\n  for (const part of parts) {\n    if (current == null || typeof current !== \"object\") return undefined;\n    current = (current as Record<string, unknown>)[part];\n  }\n  return current;\n}\n\n/** Set a value in a nested object at a dotted key path (e.g. \"llm.model\"). */\nfunction setDotted(\n  obj: Record<string, unknown>,\n  key: string,\n  value: unknown,\n): void {\n  const parts = key.split(\".\");\n  let current: Record<string, unknown> = obj;\n  for (let i = 0; i < parts.length - 1; i += 1) {\n    const part = parts[i];\n    if (\n      current[part] == null ||\n      typeof current[part] !== \"object\" ||\n      Array.isArray(current[part])\n    ) {\n      current[part] = {};\n    }\n    current = current[part] as Record<string, unknown>;\n  }\n  current[parts[parts.length - 1]] = value;\n}\n\nexport function getSettingValue(\n  settings: Settings,\n  key: string,\n  source: SettingsValueSource = \"agent_settings\",\n): SettingsValue {\n  return (lookupDotted(settings[source] as Record<string, unknown>, key) ??\n    null) as SettingsValue;\n}\n\nexport function getAgentSettingValue(\n  settings: Settings,\n  key: string,\n): SettingsValue {\n  return getSettingValue(settings, key, \"agent_settings\");\n}\n\nexport function getConversationSettingValue(\n  settings: Settings,\n  key: string,\n): SettingsValue {\n  return getSettingValue(settings, key, \"conversation_settings\");\n}\n\nfunction isChoiceField(field: SettingsFieldSchema): boolean {\n  return field.choices.length > 0;\n}\n\nfunction isCriticalField(field: SettingsFieldSchema): boolean {\n  return field.prominence === \"critical\";\n}\n\nfunction isMinorField(field: SettingsFieldSchema): boolean {\n  return field.prominence === \"minor\";\n}\n\nexport function normalizeFieldValue(\n  field: SettingsFieldSchema,\n  rawValue: unknown,\n): string | boolean {\n  const resolvedValue = rawValue ?? field.default;\n\n  if (isChoiceField(field)) {\n    return resolvedValue === null || resolvedValue === undefined\n      ? \"\"\n      : String(resolvedValue);\n  }\n\n  if (field.value_type === \"boolean\") {\n    return Boolean(resolvedValue ?? false);\n  }\n\n  if (resolvedValue === null || resolvedValue === undefined) {\n    return \"\";\n  }\n\n  if (field.value_type === \"array\" || field.value_type === \"object\") {\n    return JSON.stringify(resolvedValue, null, 2);\n  }\n\n  return String(resolvedValue);\n}\n\nfunction stableJsonStringify(value: unknown): string {\n  if (value === null || typeof value !== \"object\") {\n    return JSON.stringify(value);\n  }\n\n  if (Array.isArray(value)) {\n    return `[${value.map(stableJsonStringify).join(\",\")}]`;\n  }\n\n  const sortedEntries = Object.entries(value as Record<string, unknown>).sort(\n    ([leftKey], [rightKey]) => leftKey.localeCompare(rightKey),\n  );\n\n  return `{${sortedEntries\n    .map(\n      ([key, entryValue]) =>\n        `${JSON.stringify(key)}:${stableJsonStringify(entryValue)}`,\n    )\n    .join(\",\")}}`;\n}\n\nexport function normalizeComparableValue(\n  field: SettingsFieldSchema,\n  rawValue: unknown,\n): boolean | number | string | null {\n  if (rawValue === undefined) {\n    return null;\n  }\n\n  if (field.value_type === \"boolean\") {\n    if (typeof rawValue === \"string\") {\n      if (rawValue === \"true\") {\n        return true;\n      }\n      if (rawValue === \"false\") {\n        return false;\n      }\n    }\n    if (rawValue === null) {\n      return null;\n    }\n    return Boolean(rawValue);\n  }\n\n  if (field.value_type === \"integer\" || field.value_type === \"number\") {\n    if (rawValue === \"\" || rawValue === null) {\n      return null;\n    }\n\n    const parsedValue =\n      typeof rawValue === \"number\" ? rawValue : Number(String(rawValue));\n    return Number.isNaN(parsedValue) ? null : parsedValue;\n  }\n\n  if (field.value_type === \"array\" || field.value_type === \"object\") {\n    if (rawValue === null) {\n      return null;\n    }\n\n    // Treat empty objects as null so that serializer artifacts\n    // (e.g. mcp_config: {} vs schema default null) don't trigger\n    // a spurious view escalation in inferInitialView.\n    if (\n      field.value_type === \"object\" &&\n      typeof rawValue === \"object\" &&\n      !Array.isArray(rawValue) &&\n      Object.keys(rawValue as Record<string, unknown>).length === 0\n    ) {\n      return null;\n    }\n\n    if (typeof rawValue === \"string\") {\n      const trimmedValue = rawValue.trim();\n      if (!trimmedValue) {\n        return null;\n      }\n      try {\n        const parsed: unknown = JSON.parse(trimmedValue);\n        // Also normalise stringified empty objects\n        if (\n          field.value_type === \"object\" &&\n          parsed !== null &&\n          typeof parsed === \"object\" &&\n          !Array.isArray(parsed) &&\n          Object.keys(parsed as Record<string, unknown>).length === 0\n        ) {\n          return null;\n        }\n        return stableJsonStringify(parsed);\n      } catch {\n        return trimmedValue;\n      }\n    }\n\n    return stableJsonStringify(rawValue);\n  }\n\n  if (rawValue === null) {\n    return null;\n  }\n\n  return String(rawValue);\n}\n\nexport function buildInitialSettingsFormValues(\n  settings: Settings,\n  schemaOverride?: SettingsSchema | null,\n  source: SettingsValueSource = \"agent_settings\",\n): SettingsFormValues {\n  const schema =\n    schemaOverride ??\n    (source === \"conversation_settings\"\n      ? settings.conversation_settings_schema\n      : settings.agent_settings_schema);\n  if (!schema) {\n    return {};\n  }\n\n  return Object.fromEntries(\n    getSchemaFields(schema).map((field) => [\n      field.key,\n      normalizeFieldValue(field, getSettingValue(settings, field.key, source)),\n    ]),\n  );\n}\n\nexport function inferInitialView(\n  settings: Settings,\n  schemaOverride?: SettingsSchema | null,\n  source: SettingsValueSource = \"agent_settings\",\n): SettingsView {\n  const schema =\n    schemaOverride ??\n    (source === \"conversation_settings\"\n      ? settings.conversation_settings_schema\n      : settings.agent_settings_schema);\n  if (!schema) {\n    return \"basic\";\n  }\n\n  let hasMinorOverride = false;\n  let hasMajorOverride = false;\n\n  for (const field of getSchemaFields(schema)) {\n    if (!isCriticalField(field)) {\n      const currentValue = getSettingValue(settings, field.key, source);\n      const isDifferent =\n        normalizeComparableValue(\n          field,\n          currentValue ?? field.default ?? null,\n        ) !== normalizeComparableValue(field, field.default ?? null);\n\n      if (isDifferent) {\n        if (isMinorField(field)) {\n          hasMinorOverride = true;\n        } else {\n          hasMajorOverride = true;\n        }\n      }\n    }\n  }\n\n  if (hasMinorOverride) return \"all\";\n  if (hasMajorOverride) return \"advanced\";\n  return \"basic\";\n}\n\n/** Determine which view tier to default to based on whether the user has\n *  overridden any non-critical settings. */\nexport function hasAdvancedSettingsOverrides(settings: Settings): boolean {\n  return inferInitialView(settings) !== \"basic\";\n}\n\nexport function isSettingsFieldVisible(\n  field: SettingsFieldSchema,\n  values: SettingsFormValues,\n): boolean {\n  return field.depends_on.every((dependency) => values[dependency] === true);\n}\n\nfunction parseBooleanFieldValue(rawValue: string | boolean): boolean | null {\n  if (typeof rawValue === \"boolean\") {\n    return rawValue;\n  }\n\n  const normalizedValue = rawValue.trim().toLowerCase();\n  if (!normalizedValue) {\n    return null;\n  }\n  if (normalizedValue === \"true\") {\n    return true;\n  }\n  if (normalizedValue === \"false\") {\n    return false;\n  }\n\n  throw new Error(`Expected a boolean value, received: ${rawValue}`);\n}\n\nexport function coerceFieldValue(\n  field: SettingsFieldSchema,\n  rawValue: string | boolean,\n): SettingsValue {\n  if (field.value_type === \"boolean\") {\n    return parseBooleanFieldValue(rawValue);\n  }\n\n  if (field.value_type === \"integer\" || field.value_type === \"number\") {\n    const stringValue = String(rawValue).trim();\n    if (!stringValue) {\n      return null;\n    }\n\n    const parsedValue = Number(stringValue);\n    if (Number.isNaN(parsedValue)) {\n      throw new Error(`Expected a numeric value, received: ${stringValue}`);\n    }\n    if (field.value_type === \"integer\" && !Number.isInteger(parsedValue)) {\n      throw new Error(`Expected an integer value, received: ${stringValue}`);\n    }\n\n    const constraints = getSettingsFieldConstraints(field.key);\n    if (constraints?.min != null && parsedValue < constraints.min) {\n      throw new Error(`${field.label} must be at least ${constraints.min}`);\n    }\n    if (constraints?.max != null && parsedValue > constraints.max) {\n      throw new Error(`${field.label} must be at most ${constraints.max}`);\n    }\n\n    return parsedValue;\n  }\n\n  if (field.value_type === \"array\" || field.value_type === \"object\") {\n    const stringValue = String(rawValue).trim();\n    if (!stringValue) {\n      return null;\n    }\n\n    let parsedValue: unknown;\n    try {\n      parsedValue = JSON.parse(stringValue);\n    } catch {\n      throw new Error(`Invalid JSON for ${field.label}`);\n    }\n\n    if (field.value_type === \"array\") {\n      if (!Array.isArray(parsedValue)) {\n        throw new Error(`${field.label} must be a JSON array`);\n      }\n      return parsedValue as SettingsValue[];\n    }\n\n    if (\n      parsedValue === null ||\n      Array.isArray(parsedValue) ||\n      typeof parsedValue !== \"object\"\n    ) {\n      throw new Error(`${field.label} must be a JSON object`);\n    }\n\n    return parsedValue as { [key: string]: SettingsValue };\n  }\n\n  const stringValue = String(rawValue);\n  if (stringValue === \"\" && !field.secret) {\n    return null;\n  }\n\n  return stringValue;\n}\n\nexport function buildSdkSettingsPayload(\n  schema: SettingsSchema,\n  values: SettingsFormValues,\n  dirty: SettingsDirtyState,\n): SdkSettingsPayload {\n  const payload: Record<string, unknown> = {};\n\n  for (const field of getSchemaFields(schema)) {\n    if (dirty[field.key]) {\n      setDotted(payload, field.key, coerceFieldValue(field, values[field.key]));\n    }\n  }\n\n  return payload as SdkSettingsPayload;\n}\n\nfunction isFieldVisibleInView(\n  field: SettingsFieldSchema,\n  view: SettingsView,\n): boolean {\n  return VIEW_PROMINENCES[view].has(field.prominence);\n}\n\nexport function buildSdkSettingsPayloadForView(\n  schema: SettingsSchema,\n  values: SettingsFormValues,\n  dirty: SettingsDirtyState,\n  view: SettingsView,\n): SdkSettingsPayload {\n  const payload = buildSdkSettingsPayload(schema, values, dirty) as Record<\n    string,\n    unknown\n  >;\n\n  for (const field of getSchemaFields(schema)) {\n    if (!isFieldVisibleInView(field, view)) {\n      setDotted(payload, field.key, field.default ?? null);\n    }\n  }\n\n  return payload as SdkSettingsPayload;\n}\n\n/** Return sections with fields filtered for the current view tier.\n *  Specially-rendered fields are excluded from the generic list. */\nexport function getVisibleSettingsSections(\n  schema: SettingsSchema,\n  values: SettingsFormValues,\n  view: SettingsView,\n  excludeKeys: Set<string> = SPECIALLY_RENDERED_KEYS,\n): SettingsSectionSchema[] {\n  if (!isValidSettingsSchema(schema)) return [];\n  return schema.sections\n    .map((section) => ({\n      ...section,\n      fields: section.fields.filter(\n        (field) =>\n          !excludeKeys.has(field.key) &&\n          isFieldVisibleInView(field, view) &&\n          isSettingsFieldVisible(field, values),\n      ),\n    }))\n    .filter((section) => section.fields.length > 0);\n}\n\n/** Whether the schema has any \"critical\" prominence fields (the basic tier). */\nexport function hasCriticalSettings(schema: SettingsSchema | null): boolean {\n  if (!schema) return false;\n  return getSchemaFields(schema).some((f) => f.prominence === \"critical\");\n}\n\n/** Whether the schema has any fields visible in the \"advanced\" tier. */\nexport function hasAdvancedSettings(schema: SettingsSchema | null): boolean {\n  if (!schema) return false;\n  return getSchemaFields(schema).some((f) => f.prominence === \"major\");\n}\n\n/** Whether the schema has any \"minor\" prominence fields. */\nexport function hasMinorSettings(schema: SettingsSchema | null): boolean {\n  if (!schema) return false;\n  return getSchemaFields(schema).some((f) => f.prominence === \"minor\");\n}\n"],"mappings":"iJAuBA,IAAa,EAA0B,IAAI,IAAI,CAC7C,YACA,cACA,eACA,EAAA,kBACA,EAAA,2BACF,CAAC,EAGK,EAAiE,CACrE,MAAO,IAAI,IAAuB,CAAC,UAAU,CAAC,EAC9C,SAAU,IAAI,IAAuB,CAAC,WAAY,OAAO,CAAC,EAC1D,IAAK,IAAI,IAAuB,CAAC,WAAY,QAAS,OAAO,CAAC,CAChE,EAcA,SAAgB,EACd,EAC0B,CAC1B,MAAO,CAAC,CAAC,GAAU,MAAM,QAAS,EAA0B,QAAQ,CACtE,CAEA,SAAS,EAAgB,EAA+C,CAEtE,OADK,EAAsB,CAAM,EAC1B,EAAO,SAAS,QAAS,GAAY,EAAQ,MAAM,EADf,CAAC,CAE9C,CAGA,SAAS,EACP,EACA,EACS,CACT,GAAI,CAAC,EAAK,OACV,IAAM,EAAQ,EAAI,MAAM,GAAG,EACvB,EAAmB,EACvB,IAAK,IAAM,KAAQ,EAAO,CACxB,GAAuB,OAAO,GAAY,WAAtC,EAAgD,OACpD,EAAW,EAAoC,EACjD,CACA,OAAO,CACT,CAGA,SAAS,EACP,EACA,EACA,EACM,CACN,IAAM,EAAQ,EAAI,MAAM,GAAG,EACvB,EAAmC,EACvC,IAAK,IAAI,EAAI,EAAG,EAAI,EAAM,OAAS,EAAG,GAAK,EAAG,CAC5C,IAAM,EAAO,EAAM,IAEjB,EAAQ,IAAS,MACjB,OAAO,EAAQ,IAAU,UACzB,MAAM,QAAQ,EAAQ,EAAK,KAE3B,EAAQ,GAAQ,CAAC,GAEnB,EAAU,EAAQ,EACpB,CACA,EAAQ,EAAM,EAAM,OAAS,IAAM,CACrC,CAEA,SAAgB,EACd,EACA,EACA,EAA8B,iBACf,CACf,OAAQ,EAAa,EAAS,GAAoC,CAAG,GACnE,IACJ,CAEA,SAAgB,EACd,EACA,EACe,CACf,OAAO,EAAgB,EAAU,EAAK,gBAAgB,CACxD,CASA,SAAS,EAAc,EAAqC,CAC1D,OAAO,EAAM,QAAQ,OAAS,CAChC,CAEA,SAAS,EAAgB,EAAqC,CAC5D,OAAO,EAAM,aAAe,UAC9B,CAEA,SAAS,EAAa,EAAqC,CACzD,OAAO,EAAM,aAAe,OAC9B,CAEA,SAAgB,EACd,EACA,EACkB,CAClB,IAAM,EAAgB,GAAY,EAAM,QAoBxC,OAlBI,EAAc,CAAK,EACd,GAAkB,KACrB,GACA,OAAO,CAAa,EAGtB,EAAM,aAAe,UAChB,GAAQ,GAAiB,IAG9B,GAAkB,KACb,GAGL,EAAM,aAAe,SAAW,EAAM,aAAe,SAChD,KAAK,UAAU,EAAe,KAAM,CAAC,EAGvC,OAAO,CAAa,CAC7B,CAEA,SAAS,EAAoB,EAAwB,CAanD,OAZsB,OAAO,GAAU,WAAnC,EACK,KAAK,UAAU,CAAK,EAGzB,MAAM,QAAQ,CAAK,EACd,IAAI,EAAM,IAAI,CAAmB,EAAE,KAAK,GAAG,EAAE,GAO/C,IAJe,OAAO,QAAQ,CAAgC,EAAE,MACpE,CAAC,GAAU,CAAC,KAAc,EAAQ,cAAc,CAAQ,CAGhD,EACR,KACE,CAAC,EAAK,KACL,GAAG,KAAK,UAAU,CAAG,EAAE,GAAG,EAAoB,CAAU,GAC5D,EACC,KAAK,GAAG,EAAE,EACf,CAEA,SAAgB,EACd,EACA,EACkC,CAClC,GAAI,IAAa,IAAA,GACf,OAAO,KAGT,GAAI,EAAM,aAAe,UAAW,CAClC,GAAI,OAAO,GAAa,SAAU,CAChC,GAAI,IAAa,OACf,MAAO,GAET,GAAI,IAAa,QACf,MAAO,EAEX,CAIA,OAHI,IAAa,KACR,KAEF,EAAQ,CACjB,CAEA,GAAI,EAAM,aAAe,WAAa,EAAM,aAAe,SAAU,CACnE,GAAI,IAAa,IAAM,IAAa,KAClC,OAAO,KAGT,IAAM,EACJ,OAAO,GAAa,SAAW,EAAW,OAAO,OAAO,CAAQ,CAAC,EACnE,OAAO,OAAO,MAAM,CAAW,EAAI,KAAO,CAC5C,CAEA,GAAI,EAAM,aAAe,SAAW,EAAM,aAAe,SAAU,CAQjE,GAPI,IAAa,MAQf,EAAM,aAAe,UACrB,OAAO,GAAa,UACpB,CAAC,MAAM,QAAQ,CAAQ,GACvB,OAAO,KAAK,CAAmC,EAAE,SAAW,EAE5D,OAAO,KAGT,GAAI,OAAO,GAAa,SAAU,CAChC,IAAM,EAAe,EAAS,KAAK,EACnC,GAAI,CAAC,EACH,OAAO,KAET,GAAI,CACF,IAAM,EAAkB,KAAK,MAAM,CAAY,EAW/C,OARE,EAAM,aAAe,UAErB,OAAO,GAAW,UADlB,GAEA,CAAC,MAAM,QAAQ,CAAM,GACrB,OAAO,KAAK,CAAiC,EAAE,SAAW,EAEnD,KAEF,EAAoB,CAAM,CACnC,MAAQ,CACN,OAAO,CACT,CACF,CAEA,OAAO,EAAoB,CAAQ,CACrC,CAMA,OAJI,IAAa,KACR,KAGF,OAAO,CAAQ,CACxB,CAEA,SAAgB,EACd,EACA,EACA,EAA8B,iBACV,CACpB,IAAM,EACJ,IACC,IAAW,wBACR,EAAS,6BACT,EAAS,uBAKf,OAJK,EAIE,OAAO,YACZ,EAAgB,CAAM,EAAE,IAAK,GAAU,CACrC,EAAM,IACN,EAAoB,EAAO,EAAgB,EAAU,EAAM,IAAK,CAAM,CAAC,CACzE,CAAC,CACH,EARS,CAAC,CASZ,CAEA,SAAgB,EACd,EACA,EACA,EAA8B,iBAChB,CACd,IAAM,EACJ,IACC,IAAW,wBACR,EAAS,6BACT,EAAS,uBACf,GAAI,CAAC,EACH,MAAO,QAGT,IAAI,EAAmB,GACnB,EAAmB,GAEvB,IAAK,IAAM,KAAS,EAAgB,CAAM,EACnC,EAAgB,CAAK,GAGtB,EACE,EAHiB,EAAgB,EAAU,EAAM,IAAK,CAItD,GAAgB,EAAM,SAAW,IACnC,IAAM,EAAyB,EAAO,EAAM,SAAW,IAAI,IAGvD,EAAa,CAAK,EACpB,EAAmB,GAEnB,EAAmB,IAQ3B,OAFI,EAAyB,MACzB,EAAyB,WACtB,OACT,CAQA,SAAgB,EACd,EACA,EACS,CACT,OAAO,EAAM,WAAW,MAAO,GAAe,EAAO,KAAgB,EAAI,CAC3E,CAEA,SAAS,EAAuB,EAA4C,CAC1E,GAAI,OAAO,GAAa,UACtB,OAAO,EAGT,IAAM,EAAkB,EAAS,KAAK,EAAE,YAAY,EACpD,GAAI,CAAC,EACH,OAAO,KAET,GAAI,IAAoB,OACtB,MAAO,GAET,GAAI,IAAoB,QACtB,MAAO,GAGT,MAAU,MAAM,uCAAuC,GAAU,CACnE,CAEA,SAAgB,EACd,EACA,EACe,CACf,GAAI,EAAM,aAAe,UACvB,OAAO,EAAuB,CAAQ,EAGxC,GAAI,EAAM,aAAe,WAAa,EAAM,aAAe,SAAU,CACnE,IAAM,EAAc,OAAO,CAAQ,EAAE,KAAK,EAC1C,GAAI,CAAC,EACH,OAAO,KAGT,IAAM,EAAc,OAAO,CAAW,EACtC,GAAI,OAAO,MAAM,CAAW,EAC1B,MAAU,MAAM,uCAAuC,GAAa,EAEtE,GAAI,EAAM,aAAe,WAAa,CAAC,OAAO,UAAU,CAAW,EACjE,MAAU,MAAM,wCAAwC,GAAa,EAGvE,IAAM,EAAc,EAAA,4BAA4B,EAAM,GAAG,EACzD,GAAI,GAAa,KAAO,MAAQ,EAAc,EAAY,IACxD,MAAU,MAAM,GAAG,EAAM,MAAM,oBAAoB,EAAY,KAAK,EAEtE,GAAI,GAAa,KAAO,MAAQ,EAAc,EAAY,IACxD,MAAU,MAAM,GAAG,EAAM,MAAM,mBAAmB,EAAY,KAAK,EAGrE,OAAO,CACT,CAEA,GAAI,EAAM,aAAe,SAAW,EAAM,aAAe,SAAU,CACjE,IAAM,EAAc,OAAO,CAAQ,EAAE,KAAK,EAC1C,GAAI,CAAC,EACH,OAAO,KAGT,IAAI,EACJ,GAAI,CACF,EAAc,KAAK,MAAM,CAAW,CACtC,MAAQ,CACN,MAAU,MAAM,oBAAoB,EAAM,OAAO,CACnD,CAEA,GAAI,EAAM,aAAe,QAAS,CAChC,GAAI,CAAC,MAAM,QAAQ,CAAW,EAC5B,MAAU,MAAM,GAAG,EAAM,MAAM,sBAAsB,EAEvD,OAAO,CACT,CAEA,GACE,IAAgB,MAChB,MAAM,QAAQ,CAAW,GACzB,OAAO,GAAgB,SAEvB,MAAU,MAAM,GAAG,EAAM,MAAM,uBAAuB,EAGxD,OAAO,CACT,CAEA,IAAM,EAAc,OAAO,CAAQ,EAKnC,OAJI,IAAgB,IAAM,CAAC,EAAM,OACxB,KAGF,CACT,CAEA,SAAgB,EACd,EACA,EACA,EACoB,CACpB,IAAM,EAAmC,CAAC,EAE1C,IAAK,IAAM,KAAS,EAAgB,CAAM,EACpC,EAAM,EAAM,MACd,EAAU,EAAS,EAAM,IAAK,EAAiB,EAAO,EAAO,EAAM,IAAI,CAAC,EAI5E,OAAO,CACT,CAEA,SAAS,EACP,EACA,EACS,CACT,OAAO,EAAiB,GAAM,IAAI,EAAM,UAAU,CACpD,CAEA,SAAgB,EACd,EACA,EACA,EACA,EACoB,CACpB,IAAM,EAAU,EAAwB,EAAQ,EAAQ,CAAK,EAK7D,IAAK,IAAM,KAAS,EAAgB,CAAM,EACnC,EAAqB,EAAO,CAAI,GACnC,EAAU,EAAS,EAAM,IAAK,EAAM,SAAW,IAAI,EAIvD,OAAO,CACT,CAIA,SAAgB,EACd,EACA,EACA,EACA,EAA2B,EACF,CAEzB,OADK,EAAsB,CAAM,EAC1B,EAAO,SACX,IAAK,IAAa,CACjB,GAAG,EACH,OAAQ,EAAQ,OAAO,OACpB,GACC,CAAC,EAAY,IAAI,EAAM,GAAG,GAC1B,EAAqB,EAAO,CAAI,GAChC,EAAuB,EAAO,CAAM,CACxC,CACF,EAAE,EACD,OAAQ,GAAY,EAAQ,OAAO,OAAS,CAAC,EAXL,CAAC,CAY9C,CAGA,SAAgB,EAAoB,EAAwC,CAE1E,OADK,EACE,EAAgB,CAAM,EAAE,KAAM,GAAM,EAAE,aAAe,UAAU,EADlD,EAEtB,CAGA,SAAgB,EAAoB,EAAwC,CAE1E,OADK,EACE,EAAgB,CAAM,EAAE,KAAM,GAAM,EAAE,aAAe,OAAO,EAD/C,EAEtB,CAGA,SAAgB,EAAiB,EAAwC,CAEvE,OADK,EACE,EAAgB,CAAM,EAAE,KAAM,GAAM,EAAE,aAAe,OAAO,EAD/C,EAEtB"}

package/dist/utils/sdk-settings-schema.d.ts

@@ -24,6 +24,7 @@ export declare function getSettingValue(settings: Settings, key: string, source?
 export declare function getAgentSettingValue(settings: Settings, key: string): SettingsValue;
 export declare function getConversationSettingValue(settings: Settings, key: string): SettingsValue;
 export declare function normalizeFieldValue(field: SettingsFieldSchema, rawValue: unknown): string | boolean;
+export declare function normalizeComparableValue(field: SettingsFieldSchema, rawValue: unknown): boolean | number | string | null;
 export declare function buildInitialSettingsFormValues(settings: Settings, schemaOverride?: SettingsSchema | null, source?: SettingsValueSource): SettingsFormValues;
 export declare function inferInitialView(settings: Settings, schemaOverride?: SettingsSchema | null, source?: SettingsValueSource): SettingsView;
 /** Determine which view tier to default to based on whether the user has

package/dist/utils/sdk-settings-schema.js

@@ -58,7 +58,10 @@ function m(e, t) {
 	let n = t ?? e.default;
 	return d(e) ? n == null ? "" : String(n) : e.value_type === "boolean" ? !!(n ?? !1) : n == null ? "" : e.value_type === "array" || e.value_type === "object" ? JSON.stringify(n, null, 2) : String(n);
 }
-function h(e, t) {
+function h(e) {
+	return typeof e != "object" || !e ? JSON.stringify(e) : Array.isArray(e) ? `[${e.map(h).join(",")}]` : `{${Object.entries(e).sort(([e], [t]) => e.localeCompare(t)).map(([e, t]) => `${JSON.stringify(e)}:${h(t)}`).join(",")}}`;
+}
+function g(e, t) {
 	if (t === void 0) return null;
 	if (e.value_type === "boolean") {
 		if (typeof t == "string") {
@@ -79,30 +82,30 @@ function h(e, t) {
 			if (!n) return null;
 			try {
 				let t = JSON.parse(n);
-				return e.value_type === "object" && typeof t == "object" && t && !Array.isArray(t) && Object.keys(t).length === 0 ? null : JSON.stringify(t);
+				return e.value_type === "object" && typeof t == "object" && t && !Array.isArray(t) && Object.keys(t).length === 0 ? null : h(t);
 			} catch {
 				return n;
 			}
 		}
-		return JSON.stringify(t);
+		return h(t);
 	}
 	return t === null ? null : String(t);
 }
-function g(e, t, n = "agent_settings") {
+function _(e, t, n = "agent_settings") {
 	let r = t ?? (n === "conversation_settings" ? e.conversation_settings_schema : e.agent_settings_schema);
 	return r ? Object.fromEntries(o(r).map((t) => [t.key, m(t, l(e, t.key, n))])) : {};
 }
-function _(e, t, n = "agent_settings") {
+function v(e, t, n = "agent_settings") {
 	let r = t ?? (n === "conversation_settings" ? e.conversation_settings_schema : e.agent_settings_schema);
 	if (!r) return "basic";
 	let i = !1, a = !1;
-	for (let t of o(r)) f(t) || h(t, l(e, t.key, n) ?? t.default ?? null) !== h(t, t.default ?? null) && (p(t) ? i = !0 : a = !0);
+	for (let t of o(r)) f(t) || g(t, l(e, t.key, n) ?? t.default ?? null) !== g(t, t.default ?? null) && (p(t) ? i = !0 : a = !0);
 	return i ? "all" : a ? "advanced" : "basic";
 }
-function v(e, t) {
+function y(e, t) {
 	return e.depends_on.every((e) => t[e] === !0);
 }
-function y(e) {
+function b(e) {
 	if (typeof e == "boolean") return e;
 	let t = e.trim().toLowerCase();
 	if (!t) return null;
@@ -110,8 +113,8 @@ function y(e) {
 	if (t === "false") return !1;
 	throw Error(`Expected a boolean value, received: ${e}`);
 }
-function b(e, t) {
-	if (e.value_type === "boolean") return y(t);
+function x(e, t) {
+	if (e.value_type === "boolean") return b(t);
 	if (e.value_type === "integer" || e.value_type === "number") {
 		let r = String(t).trim();
 		if (!r) return null;
@@ -142,35 +145,35 @@ function b(e, t) {
 	let r = String(t);
 	return r === "" && !e.secret ? null : r;
 }
-function x(e, t, n) {
+function S(e, t, n) {
 	let r = {};
-	for (let i of o(e)) n[i.key] && c(r, i.key, b(i, t[i.key]));
+	for (let i of o(e)) n[i.key] && c(r, i.key, x(i, t[i.key]));
 	return r;
 }
-function S(e, t) {
+function C(e, t) {
 	return i[t].has(e.prominence);
 }
-function C(e, t, n, r) {
-	let i = x(e, t, n);
-	for (let t of o(e)) S(t, r) || c(i, t.key, t.default ?? null);
+function w(e, t, n, r) {
+	let i = S(e, t, n);
+	for (let t of o(e)) C(t, r) || c(i, t.key, t.default ?? null);
 	return i;
 }
-function w(e, t, n, i = r) {
+function T(e, t, n, i = r) {
 	return a(e) ? e.sections.map((e) => ({
 		...e,
-		fields: e.fields.filter((e) => !i.has(e.key) && S(e, n) && v(e, t))
+		fields: e.fields.filter((e) => !i.has(e.key) && C(e, n) && y(e, t))
 	})).filter((e) => e.fields.length > 0) : [];
 }
-function T(e) {
+function E(e) {
 	return e ? o(e).some((e) => e.prominence === "critical") : !1;
 }
-function E(e) {
+function D(e) {
 	return e ? o(e).some((e) => e.prominence === "major") : !1;
 }
-function D(e) {
+function O(e) {
 	return e ? o(e).some((e) => e.prominence === "minor") : !1;
 }
 //#endregion
-export { g as buildInitialSettingsFormValues, x as buildSdkSettingsPayload, C as buildSdkSettingsPayloadForView, u as getAgentSettingValue, w as getVisibleSettingsSections, E as hasAdvancedSettings, T as hasCriticalSettings, D as hasMinorSettings, _ as inferInitialView, a as isValidSettingsSchema };
+export { _ as buildInitialSettingsFormValues, S as buildSdkSettingsPayload, w as buildSdkSettingsPayloadForView, u as getAgentSettingValue, T as getVisibleSettingsSections, D as hasAdvancedSettings, E as hasCriticalSettings, O as hasMinorSettings, v as inferInitialView, a as isValidSettingsSchema, g as normalizeComparableValue };
 
 //# sourceMappingURL=sdk-settings-schema.js.map