@openhands/agent-canvas 1.0.0-rc.9 → 1.0.0

package/dist/utils/mcp-marketplace-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-marketplace-utils.js","names":[],"sources":["../../src/utils/mcp-marketplace-utils.ts"],"sourcesContent":["import { MCPServerConfig } from \"#/types/mcp-server\";\nimport type {\n  IntegrationCatalogEntry as MarketplaceEntry,\n  IntegrationConnectionOption,\n  IntegrationTransport,\n} from \"@openhands/extensions/integrations\";\nimport { getDeploymentMode } from \"#/api/agent-server-adapter\";\n\nexport type { MarketplaceEntry };\n\nexport type McpMarketplaceConnectionOption = IntegrationConnectionOption & {\n  provider: \"mcp\";\n  transport: IntegrationTransport;\n};\n\nexport function getMcpConnectionOptions(\n  entry: MarketplaceEntry,\n): McpMarketplaceConnectionOption[] {\n  return entry.connectionOptions.filter(\n    (option): option is McpMarketplaceConnectionOption =>\n      option.provider === \"mcp\" && !!option.transport,\n  );\n}\n\nexport function getDefaultMcpConnectionOption(\n  entry: MarketplaceEntry,\n): McpMarketplaceConnectionOption | undefined {\n  const options = getMcpConnectionOptions(entry);\n  return (\n    options.find((option) => option.id === entry.defaultConnectionOptionId) ??\n    options[0]\n  );\n}\n\nfunction isLocallyInstallableMcpOption(\n  option: McpMarketplaceConnectionOption,\n): boolean {\n  // The local install modal writes static MCP server config. OAuth options\n  // describe hosted redirect flows, so prefer an API/stdio fallback when one\n  // exists and leave OAuth as the default connection for hosted integrations.\n  return option.auth.strategy !== \"oauth2\";\n}\n\nexport function getInstallableMcpConnectionOption(\n  entry: MarketplaceEntry,\n): McpMarketplaceConnectionOption | undefined {\n  const options = getMcpConnectionOptions(entry);\n  const defaultOption = options.find(\n    (option) => option.id === entry.defaultConnectionOptionId,\n  );\n  if (defaultOption && isLocallyInstallableMcpOption(defaultOption)) {\n    return defaultOption;\n  }\n  return options.find(isLocallyInstallableMcpOption);\n}\n\nexport function getDefaultMcpTransport(\n  entry: MarketplaceEntry,\n): IntegrationTransport | undefined {\n  return getDefaultMcpConnectionOption(entry)?.transport;\n}\n\nconst LINEAR_DEPRECATED_SSE_URL = \"https://mcp.linear.app/sse\";\nconst LINEAR_SHTTP_URL = \"https://mcp.linear.app/mcp\";\nconst LINEAR_DOCS_URL = \"https://linear.app/docs/mcp\";\n\n/**\n * Upstream @openhands/extensions still ships Linear's deprecated SSE\n * transport (removed upstream on 2026-04-08; the /sse endpoint now\n * rejects every call). Rewrite the entry to streamable HTTP at the\n * /mcp replacement endpoint until the pinned dependency catches up.\n *\n * The /mcp endpoint authenticates via OAuth 2.1 or a Linear API key\n * sent as \"Authorization: Bearer <token>\". This client has no\n * interactive OAuth flow for MCP installs, so switch the auth\n * strategy from \"none\" to \"bearer\" — the install modal then offers\n * an (optional) API key field and the agent server forwards it as a\n * Bearer header.\n *\n * Patches immutably — the imported catalog JSON is shared module\n * state and must not be mutated.\n */\nfunction patchLinearEntry(entry: MarketplaceEntry): MarketplaceEntry {\n  if (entry.id !== \"linear\") return entry;\n  return {\n    ...entry,\n    docsUrl: LINEAR_DOCS_URL,\n    installHint:\n      \"Authenticate with a Linear API key (Linear → Settings → Security & access) — sent as a Bearer token. Optional when the endpoint accepts your OAuth session.\",\n    connectionOptions: entry.connectionOptions.map((option) =>\n      option.transport?.kind === \"sse\" &&\n      urlsMatch(option.transport.url, LINEAR_DEPRECATED_SSE_URL)\n        ? {\n            ...option,\n            auth: { ...option.auth, strategy: \"bearer\" as const },\n            transport: {\n              kind: \"shttp\" as const,\n              url: LINEAR_SHTTP_URL,\n              apiKeyOptional: option.transport.apiKeyOptional,\n            },\n          }\n        : option,\n    ),\n  };\n}\n\n/**\n * The upstream catalog ships the GitHub MCP server with `command: \"docker\"`\n * (`docker run … ghcr.io/github/github-mcp-server`). This requires Docker-\n * in-Docker when agent-canvas itself runs inside the Docker image, which\n * isn't available. The Docker image pre-installs the native Go binary at\n * `/usr/local/bin/github-mcp-server`, so we rewrite the transport to use\n * it directly.\n *\n * Only applied when `getDeploymentMode()` returns `\"docker\"`.\n */\nfunction patchGitHubEntry(entry: MarketplaceEntry): MarketplaceEntry {\n  if (entry.id !== \"github\") return entry;\n  if (getDeploymentMode() !== \"docker\") return entry;\n  return {\n    ...entry,\n    installHint:\n      \"Requires a GitHub Personal Access Token (classic or fine-grained).\",\n    // The upstream @openhands/extensions catalog defines the GitHub entry\n    // with `command: \"docker\"` (i.e. `docker run …`). We match on that\n    // exact value to replace it with the pre-installed native binary.\n    // If the upstream ever changes the command string, this patch becomes\n    // a no-op and the original transport is preserved — the worst case is\n    // the user falls back to the Docker-based transport (which still works\n    // outside the Docker image).\n    connectionOptions: entry.connectionOptions.map((option) =>\n      option.transport?.kind === \"stdio\" &&\n      option.transport.command === \"docker\"\n        ? {\n            ...option,\n            transport: {\n              ...option.transport,\n              command: \"github-mcp-server\",\n              args: [\"stdio\"],\n            },\n          }\n        : option,\n    ),\n  };\n}\n\nexport function getMcpMarketplaceCatalog(\n  catalog: MarketplaceEntry[],\n): MarketplaceEntry[] {\n  return catalog\n    .map(patchLinearEntry)\n    .map(patchGitHubEntry)\n    .filter((entry) => !!getDefaultMcpConnectionOption(entry));\n}\n\nconst tryUrl = (raw: string): URL | null => {\n  try {\n    return new URL(raw);\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Loose URL match that ignores query strings, trailing slashes, and\n * default ports. We want clicking \"Linear\" to flag the entry as\n * installed even if the user pasted the URL with extra trailing slash\n * or a different port-equivalent variant.\n *\n * Defensive against runtime data that doesn't match the static type:\n * if either input is not a string (e.g. parsed from an older settings\n * blob), we fall through the URL parsing path and the safe trim\n * fallback below, never calling `.replace` on undefined.\n */\nexport function urlsMatch(a: unknown, b: unknown): boolean {\n  const aStr = typeof a === \"string\" ? a : \"\";\n  const bStr = typeof b === \"string\" ? b : \"\";\n  if (!aStr || !bStr) return false;\n  const left = tryUrl(aStr);\n  const right = tryUrl(bStr);\n  if (!left || !right) {\n    return aStr.replace(/\\/+$/, \"\") === bStr.replace(/\\/+$/, \"\");\n  }\n  return (\n    left.protocol === right.protocol &&\n    left.host === right.host &&\n    left.pathname.replace(/\\/+$/, \"\") === right.pathname.replace(/\\/+$/, \"\")\n  );\n}\n\n/**\n * Decide whether a marketplace template is already represented by one\n * of the installed MCP servers. Used to render an \"Installed\" badge on\n * the marketplace tile. Returns the first matching server, or null.\n */\nexport function findInstalledMatch(\n  transport: IntegrationTransport,\n  servers: MCPServerConfig[],\n): MCPServerConfig | null {\n  return (\n    servers.find((server) => transportMatchesServer(transport, server)) ?? null\n  );\n}\n\nexport function findInstalledEntryMatch(\n  entry: MarketplaceEntry,\n  servers: MCPServerConfig[],\n): MCPServerConfig | null {\n  for (const option of getMcpConnectionOptions(entry)) {\n    const match = findInstalledMatch(option.transport, servers);\n    if (match) return match;\n  }\n  return null;\n}\n\nfunction transportMatchesServer(\n  transport: IntegrationTransport,\n  server: MCPServerConfig,\n): boolean {\n  if (transport.kind === \"shttp\") {\n    const tplUrl = transport.url;\n    return (\n      server.type === \"shttp\" && !!server.url && urlsMatch(server.url, tplUrl)\n    );\n  }\n\n  if (transport.kind === \"sse\") {\n    const tplUrl = transport.url;\n    return (\n      server.type === \"sse\" && !!server.url && urlsMatch(server.url, tplUrl)\n    );\n  }\n\n  // stdio: match on the registered server name.\n  return server.type === \"stdio\" && server.name === transport.serverName;\n}\n\nexport function isMarketplaceEntryAvailable(\n  entry: MarketplaceEntry,\n  backendKind: \"local\" | \"cloud\",\n): boolean {\n  if (!entry.runtimeAvailability || entry.runtimeAvailability === \"all\")\n    return true;\n  return entry.runtimeAvailability === backendKind;\n}\n\nfunction normalize(query: string): string {\n  return query.trim().toLowerCase();\n}\n\n/**\n * Case-insensitive substring match against the catalog entry's\n * user-visible identity (name, description, id, keywords). Empty\n * queries always match.\n */\nexport function getMarketplaceEntriesByPopularity(\n  catalog: MarketplaceEntry[],\n): MarketplaceEntry[] {\n  return catalog\n    .map((entry, index) => ({ entry, index }))\n    .sort((a, b) => {\n      const byPopularity =\n        (b.entry.popularityRank ?? 0) - (a.entry.popularityRank ?? 0);\n      return byPopularity || a.index - b.index;\n    })\n    .map(({ entry }) => entry);\n}\n\nexport function getMarketplaceEntryById(\n  id: string,\n  catalog: MarketplaceEntry[],\n): MarketplaceEntry | undefined {\n  return catalog.find((entry) => entry.id === id);\n}\n\nexport function marketplaceEntryMatchesQuery(\n  entry: MarketplaceEntry,\n  rawQuery: string,\n): boolean {\n  const q = normalize(rawQuery);\n  if (!q) return true;\n  const haystack = [\n    entry.name,\n    entry.description,\n    entry.id,\n    ...(entry.keywords ?? []),\n  ]\n    .join(\" \")\n    .toLowerCase();\n  return haystack.includes(q);\n}\n\n/**\n * Search match for an installed (already-configured) server. We\n * search the server's own identifying fields and — if it's a catalog\n * entry — its catalog name/keywords too, so typing \"Slack\" matches\n * the installed Slack tile even though the persisted server is just\n * `{ type: \"stdio\", name: \"slack\", ... }`.\n */\nexport function installedServerMatchesQuery(\n  server: MCPServerConfig,\n  catalogEntry: MarketplaceEntry | undefined,\n  rawQuery: string,\n): boolean {\n  const q = normalize(rawQuery);\n  if (!q) return true;\n  const haystack = [\n    server.type,\n    \"name\" in server ? server.name : undefined,\n    \"command\" in server ? server.command : undefined,\n    \"args\" in server ? server.args?.join(\" \") : undefined,\n    \"url\" in server ? server.url : undefined,\n    catalogEntry?.name,\n    catalogEntry?.description,\n    catalogEntry?.id,\n    ...(catalogEntry?.keywords ?? []),\n  ]\n    .filter(Boolean)\n    .join(\" \")\n    .toLowerCase();\n  return haystack.includes(q);\n}\n\n/**\n * Look up the catalog entry that best matches an installed server.\n * Mirrors the lookup used in `installed-server-card.tsx` for\n * rendering the friendly icon.\n */\nexport function findCatalogEntryForServer(\n  server: MCPServerConfig,\n  catalog: MarketplaceEntry[],\n): MarketplaceEntry | undefined {\n  return catalog.find((entry) => {\n    // Check every MCP option rather than only the default. Some unified\n    // integration entries default to OAuth-hosted MCP while still exposing\n    // an API/stdio option; existing installed servers should match either.\n    return getMcpConnectionOptions(entry).some((option) =>\n      transportMatchesServer(option.transport, server),\n    );\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"mcp-marketplace-utils.js","names":[],"sources":["../../src/utils/mcp-marketplace-utils.ts"],"sourcesContent":["import { MCPServerConfig } from \"#/types/mcp-server\";\nimport type {\n  IntegrationAuthConfig,\n  IntegrationCatalogEntry as MarketplaceEntry,\n  IntegrationConnectionOption,\n  IntegrationTransport,\n} from \"@openhands/extensions/integrations\";\n\nexport type { MarketplaceEntry };\n\ntype McpIntegrationAuthConfig = IntegrationAuthConfig & {\n  credentialSecretName?: string;\n  saveCredentialAsSecretByDefault?: boolean;\n};\n\nexport type McpMarketplaceConnectionOption = Omit<\n  IntegrationConnectionOption,\n  \"auth\" | \"provider\" | \"transport\"\n> & {\n  provider: \"mcp\";\n  transport: IntegrationTransport;\n  auth: McpIntegrationAuthConfig;\n};\n\nexport function getMcpConnectionOptions(\n  entry: MarketplaceEntry,\n): McpMarketplaceConnectionOption[] {\n  return entry.connectionOptions.filter(\n    (option): option is McpMarketplaceConnectionOption =>\n      option.provider === \"mcp\" && !!option.transport,\n  );\n}\n\nexport function getDefaultMcpConnectionOption(\n  entry: MarketplaceEntry,\n): McpMarketplaceConnectionOption | undefined {\n  const options = getMcpConnectionOptions(entry);\n  return (\n    options.find((option) => option.id === entry.defaultConnectionOptionId) ??\n    options[0]\n  );\n}\n\nfunction isLocallyInstallableMcpOption(\n  option: McpMarketplaceConnectionOption,\n): boolean {\n  // The local install modal writes static MCP server config. OAuth options\n  // describe hosted redirect flows, so prefer an API/stdio fallback when one\n  // exists and leave OAuth as the default connection for hosted integrations.\n  return option.auth.strategy !== \"oauth2\";\n}\n\nexport function getInstallableMcpConnectionOption(\n  entry: MarketplaceEntry,\n): McpMarketplaceConnectionOption | undefined {\n  const options = getMcpConnectionOptions(entry);\n  const defaultOption = options.find(\n    (option) => option.id === entry.defaultConnectionOptionId,\n  );\n  if (defaultOption && isLocallyInstallableMcpOption(defaultOption)) {\n    return defaultOption;\n  }\n  return options.find(isLocallyInstallableMcpOption);\n}\n\nexport function getDefaultMcpTransport(\n  entry: MarketplaceEntry,\n): IntegrationTransport | undefined {\n  return getDefaultMcpConnectionOption(entry)?.transport;\n}\n\nconst LINEAR_DEPRECATED_SSE_URL = \"https://mcp.linear.app/sse\";\nconst LINEAR_SHTTP_URL = \"https://mcp.linear.app/mcp\";\nconst LINEAR_DOCS_URL = \"https://linear.app/docs/mcp\";\n\n/**\n * Upstream @openhands/extensions still ships Linear's deprecated SSE\n * transport (removed upstream on 2026-04-08; the /sse endpoint now\n * rejects every call). Rewrite the entry to streamable HTTP at the\n * /mcp replacement endpoint until the pinned dependency catches up.\n *\n * The /mcp endpoint authenticates via OAuth 2.1 or a Linear API key\n * sent as \"Authorization: Bearer <token>\". This client has no\n * interactive OAuth flow for MCP installs, so switch the auth\n * strategy from \"none\" to \"bearer\" — the install modal then offers\n * an (optional) API key field and the agent server forwards it as a\n * Bearer header.\n *\n * Patches immutably — the imported catalog JSON is shared module\n * state and must not be mutated.\n */\nfunction patchLinearEntry(entry: MarketplaceEntry): MarketplaceEntry {\n  if (entry.id !== \"linear\") return entry;\n  return {\n    ...entry,\n    docsUrl: LINEAR_DOCS_URL,\n    installHint:\n      \"Authenticate with a Linear API key (Linear → Settings → Security & access) — sent as a Bearer token. Optional when the endpoint accepts your OAuth session.\",\n    connectionOptions: entry.connectionOptions.map((option) =>\n      option.transport?.kind === \"sse\" &&\n      urlsMatch(option.transport.url, LINEAR_DEPRECATED_SSE_URL)\n        ? {\n            ...option,\n            auth: { ...option.auth, strategy: \"bearer\" as const },\n            transport: {\n              kind: \"shttp\" as const,\n              url: LINEAR_SHTTP_URL,\n              apiKeyOptional: option.transport.apiKeyOptional,\n            },\n          }\n        : option,\n    ),\n  };\n}\n\nexport function getMcpMarketplaceCatalog(\n  catalog: MarketplaceEntry[],\n): MarketplaceEntry[] {\n  return catalog\n    .map(patchLinearEntry)\n    .filter((entry) => !!getDefaultMcpConnectionOption(entry));\n}\n\nconst tryUrl = (raw: string): URL | null => {\n  try {\n    return new URL(raw);\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Loose URL match that ignores query strings, trailing slashes, and\n * default ports. We want clicking \"Linear\" to flag the entry as\n * installed even if the user pasted the URL with extra trailing slash\n * or a different port-equivalent variant.\n *\n * Defensive against runtime data that doesn't match the static type:\n * if either input is not a string (e.g. parsed from an older settings\n * blob), we fall through the URL parsing path and the safe trim\n * fallback below, never calling `.replace` on undefined.\n */\nexport function urlsMatch(a: unknown, b: unknown): boolean {\n  const aStr = typeof a === \"string\" ? a : \"\";\n  const bStr = typeof b === \"string\" ? b : \"\";\n  if (!aStr || !bStr) return false;\n  const left = tryUrl(aStr);\n  const right = tryUrl(bStr);\n  if (!left || !right) {\n    return aStr.replace(/\\/+$/, \"\") === bStr.replace(/\\/+$/, \"\");\n  }\n  return (\n    left.protocol === right.protocol &&\n    left.host === right.host &&\n    left.pathname.replace(/\\/+$/, \"\") === right.pathname.replace(/\\/+$/, \"\")\n  );\n}\n\n/**\n * Decide whether a marketplace template is already represented by one\n * of the installed MCP servers. Used to render an \"Installed\" badge on\n * the marketplace tile. Returns the first matching server, or null.\n */\nexport function findInstalledMatch(\n  transport: IntegrationTransport,\n  servers: MCPServerConfig[],\n): MCPServerConfig | null {\n  return (\n    servers.find((server) => transportMatchesServer(transport, server)) ?? null\n  );\n}\n\nexport function findInstalledEntryMatch(\n  entry: MarketplaceEntry,\n  servers: MCPServerConfig[],\n): MCPServerConfig | null {\n  for (const option of getMcpConnectionOptions(entry)) {\n    const match = findInstalledMatch(option.transport, servers);\n    if (match) return match;\n  }\n  return null;\n}\n\nfunction transportMatchesServer(\n  transport: IntegrationTransport,\n  server: MCPServerConfig,\n): boolean {\n  if (transport.kind === \"shttp\") {\n    const tplUrl = transport.url;\n    return (\n      server.type === \"shttp\" && !!server.url && urlsMatch(server.url, tplUrl)\n    );\n  }\n\n  if (transport.kind === \"sse\") {\n    const tplUrl = transport.url;\n    return (\n      server.type === \"sse\" && !!server.url && urlsMatch(server.url, tplUrl)\n    );\n  }\n\n  // stdio: match on the registered server name.\n  return server.type === \"stdio\" && server.name === transport.serverName;\n}\n\nexport function isMarketplaceEntryAvailable(\n  entry: MarketplaceEntry,\n  backendKind: \"local\" | \"cloud\",\n): boolean {\n  if (!entry.runtimeAvailability || entry.runtimeAvailability === \"all\")\n    return true;\n  return entry.runtimeAvailability === backendKind;\n}\n\nfunction normalize(query: string): string {\n  return query.trim().toLowerCase();\n}\n\n/**\n * Case-insensitive substring match against the catalog entry's\n * user-visible identity (name, description, id, keywords). Empty\n * queries always match.\n */\nexport function getMarketplaceEntriesByPopularity(\n  catalog: MarketplaceEntry[],\n): MarketplaceEntry[] {\n  return catalog\n    .map((entry, index) => ({ entry, index }))\n    .sort((a, b) => {\n      const byPopularity =\n        (b.entry.popularityRank ?? 0) - (a.entry.popularityRank ?? 0);\n      return byPopularity || a.index - b.index;\n    })\n    .map(({ entry }) => entry);\n}\n\nexport function getMarketplaceEntryById(\n  id: string,\n  catalog: MarketplaceEntry[],\n): MarketplaceEntry | undefined {\n  return catalog.find((entry) => entry.id === id);\n}\n\nexport function marketplaceEntryMatchesQuery(\n  entry: MarketplaceEntry,\n  rawQuery: string,\n): boolean {\n  const q = normalize(rawQuery);\n  if (!q) return true;\n  const haystack = [\n    entry.name,\n    entry.description,\n    entry.id,\n    ...(entry.keywords ?? []),\n  ]\n    .join(\" \")\n    .toLowerCase();\n  return haystack.includes(q);\n}\n\n/**\n * Search match for an installed (already-configured) server. We\n * search the server's own identifying fields and — if it's a catalog\n * entry — its catalog name/keywords too, so typing \"Slack\" matches\n * the installed Slack tile even though the persisted server is just\n * `{ type: \"stdio\", name: \"slack\", ... }`.\n */\nexport function installedServerMatchesQuery(\n  server: MCPServerConfig,\n  catalogEntry: MarketplaceEntry | undefined,\n  rawQuery: string,\n): boolean {\n  const q = normalize(rawQuery);\n  if (!q) return true;\n  const haystack = [\n    server.type,\n    \"name\" in server ? server.name : undefined,\n    \"command\" in server ? server.command : undefined,\n    \"args\" in server ? server.args?.join(\" \") : undefined,\n    \"url\" in server ? server.url : undefined,\n    catalogEntry?.name,\n    catalogEntry?.description,\n    catalogEntry?.id,\n    ...(catalogEntry?.keywords ?? []),\n  ]\n    .filter(Boolean)\n    .join(\" \")\n    .toLowerCase();\n  return haystack.includes(q);\n}\n\n/**\n * Look up the catalog entry that best matches an installed server.\n * Mirrors the lookup used in `installed-server-card.tsx` for\n * rendering the friendly icon.\n */\nexport function findCatalogEntryForServer(\n  server: MCPServerConfig,\n  catalog: MarketplaceEntry[],\n): MarketplaceEntry | undefined {\n  return catalog.find((entry) => {\n    // Check every MCP option rather than only the default. Some unified\n    // integration entries default to OAuth-hosted MCP while still exposing\n    // an API/stdio option; existing installed servers should match either.\n    return getMcpConnectionOptions(entry).some((option) =>\n      transportMatchesServer(option.transport, server),\n    );\n  });\n}\n"],"mappings":"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"}

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

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

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

@@ -1,10 +1,13 @@
-import { getSettingsFieldConstraints as e } from "./sdk-settings-field-metadata.js";
+import { LLM_AUTH_TYPE_KEY as e, LLM_SUBSCRIPTION_VENDOR_KEY as t } from "../constants/llm-subscription.js";
+import { getSettingsFieldConstraints as n } from "./sdk-settings-field-metadata.js";
 //#region src/utils/sdk-settings-schema.ts
-var t = new Set([
+var r = new Set([
 	"llm.model",
 	"llm.api_key",
-	"llm.base_url"
-]), n = {
+	"llm.base_url",
+	e,
+	t
+]), i = {
 	basic: new Set(["critical"]),
 	advanced: new Set(["critical", "major"]),
 	all: new Set([
@@ -13,13 +16,13 @@ var t = new Set([
 		"minor"
 	])
 };
-function r(e) {
+function a(e) {
 	return !!e && Array.isArray(e.sections);
 }
-function i(e) {
-	return r(e) ? e.sections.flatMap((e) => e.fields) : [];
+function o(e) {
+	return a(e) ? e.sections.flatMap((e) => e.fields) : [];
 }
-function a(e, t) {
+function s(e, t) {
 	if (!e) return;
 	let n = t.split("."), r = e;
 	for (let e of n) {
@@ -28,7 +31,7 @@ function a(e, t) {
 	}
 	return r;
 }
-function o(e, t, n) {
+function c(e, t, n) {
 	let r = t.split("."), i = e;
 	for (let e = 0; e < r.length - 1; e += 1) {
 		let t = r[e];
@@ -36,26 +39,26 @@ function o(e, t, n) {
 	}
 	i[r[r.length - 1]] = n;
 }
-function s(e, t, n = "agent_settings") {
-	return a(e[n], t) ?? null;
+function l(e, t, n = "agent_settings") {
+	return s(e[n], t) ?? null;
 }
-function c(e, t) {
-	return s(e, t, "agent_settings");
+function u(e, t) {
+	return l(e, t, "agent_settings");
 }
-function l(e) {
+function d(e) {
 	return e.choices.length > 0;
 }
-function u(e) {
+function f(e) {
 	return e.prominence === "critical";
 }
-function d(e) {
+function p(e) {
 	return e.prominence === "minor";
 }
-function f(e, t) {
+function m(e, t) {
 	let n = t ?? e.default;
-	return l(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);
+	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 p(e, t) {
+function h(e, t) {
 	if (t === void 0) return null;
 	if (e.value_type === "boolean") {
 		if (typeof t == "string") {
@@ -85,21 +88,21 @@ function p(e, t) {
 	}
 	return t === null ? null : String(t);
 }
-function m(e, t, n = "agent_settings") {
+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(i(r).map((t) => [t.key, f(t, s(e, t.key, n))])) : {};
+	return r ? Object.fromEntries(o(r).map((t) => [t.key, m(t, l(e, t.key, n))])) : {};
 }
-function h(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);
 	if (!r) return "basic";
-	let a = !1, o = !1;
-	for (let t of i(r)) u(t) || p(t, s(e, t.key, n) ?? t.default ?? null) !== p(t, t.default ?? null) && (d(t) ? a = !0 : o = !0);
-	return a ? "all" : o ? "advanced" : "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);
+	return i ? "all" : a ? "advanced" : "basic";
 }
-function g(e, t) {
+function v(e, t) {
 	return e.depends_on.every((e) => t[e] === !0);
 }
-function _(e) {
+function y(e) {
 	if (typeof e == "boolean") return e;
 	let t = e.trim().toLowerCase();
 	if (!t) return null;
@@ -107,64 +110,64 @@ function _(e) {
 	if (t === "false") return !1;
 	throw Error(`Expected a boolean value, received: ${e}`);
 }
-function v(t, n) {
-	if (t.value_type === "boolean") return _(n);
-	if (t.value_type === "integer" || t.value_type === "number") {
-		let r = String(n).trim();
+function b(e, t) {
+	if (e.value_type === "boolean") return y(t);
+	if (e.value_type === "integer" || e.value_type === "number") {
+		let r = String(t).trim();
 		if (!r) return null;
 		let i = Number(r);
 		if (Number.isNaN(i)) throw Error(`Expected a numeric value, received: ${r}`);
-		if (t.value_type === "integer" && !Number.isInteger(i)) throw Error(`Expected an integer value, received: ${r}`);
-		let a = e(t.key);
-		if (a?.min != null && i < a.min) throw Error(`${t.label} must be at least ${a.min}`);
-		if (a?.max != null && i > a.max) throw Error(`${t.label} must be at most ${a.max}`);
+		if (e.value_type === "integer" && !Number.isInteger(i)) throw Error(`Expected an integer value, received: ${r}`);
+		let a = n(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 (t.value_type === "array" || t.value_type === "object") {
-		let e = String(n).trim();
-		if (!e) return null;
+	if (e.value_type === "array" || e.value_type === "object") {
+		let n = String(t).trim();
+		if (!n) return null;
 		let r;
 		try {
-			r = JSON.parse(e);
+			r = JSON.parse(n);
 		} catch {
-			throw Error(`Invalid JSON for ${t.label}`);
+			throw Error(`Invalid JSON for ${e.label}`);
 		}
-		if (t.value_type === "array") {
-			if (!Array.isArray(r)) throw Error(`${t.label} must be a JSON array`);
+		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(`${t.label} must be a JSON object`);
+		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 === "" && !t.secret ? null : r;
+	let r = String(t);
+	return r === "" && !e.secret ? null : r;
 }
-function y(e, t, n) {
+function x(e, t, n) {
 	let r = {};
-	for (let a of i(e)) n[a.key] && o(r, a.key, v(a, t[a.key]));
+	for (let i of o(e)) n[i.key] && c(r, i.key, b(i, t[i.key]));
 	return r;
 }
-function b(e, t) {
-	return n[t].has(e.prominence);
+function S(e, t) {
+	return i[t].has(e.prominence);
 }
-function x(e, t, n, r) {
-	let a = y(e, t, n);
-	for (let t of i(e)) b(t, r) || o(a, t.key, t.default ?? null);
-	return a;
+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);
+	return i;
 }
-function S(e, n, i, a = t) {
-	return r(e) ? e.sections.map((e) => ({
+function w(e, t, n, i = r) {
+	return a(e) ? e.sections.map((e) => ({
 		...e,
-		fields: e.fields.filter((e) => !a.has(e.key) && b(e, i) && g(e, n))
+		fields: e.fields.filter((e) => !i.has(e.key) && S(e, n) && v(e, t))
 	})).filter((e) => e.fields.length > 0) : [];
 }
-function C(e) {
-	return e ? i(e).some((e) => e.prominence === "major") : !1;
+function T(e) {
+	return e ? o(e).some((e) => e.prominence === "major") : !1;
 }
-function w(e) {
-	return e ? i(e).some((e) => e.prominence === "minor") : !1;
+function E(e) {
+	return e ? o(e).some((e) => e.prominence === "minor") : !1;
 }
 //#endregion
-export { m as buildInitialSettingsFormValues, y as buildSdkSettingsPayload, x as buildSdkSettingsPayloadForView, c as getAgentSettingValue, S as getVisibleSettingsSections, C as hasAdvancedSettings, w as hasMinorSettings, h as inferInitialView, r as isValidSettingsSchema };
+export { g as buildInitialSettingsFormValues, x as buildSdkSettingsPayload, C as buildSdkSettingsPayloadForView, u as getAgentSettingValue, w as getVisibleSettingsSections, T as hasAdvancedSettings, E as hasMinorSettings, _ as inferInitialView, a as isValidSettingsSchema };
 
 //# sourceMappingURL=sdk-settings-schema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"sdk-settings-schema.js","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\";\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]);\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\nfunction 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 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.js","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\nfunction 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 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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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openhands/agent-canvas",
-  "version": "1.0.0-rc.9",
+  "version": "1.0.0",
   "description": "Agent Canvas UI for OpenHands - run AI coding agents with a visual interface",
   "license": "MIT",
   "private": false,
@@ -23,7 +23,7 @@
     "@heroui/react": "2.8.10",
     "@microlink/react-json-view": "1.31.20",
     "@monaco-editor/react": "4.7.0",
-    "@openhands/extensions": "0.4.1",
+    "@openhands/extensions": "0.5.0",
     "@openhands/typescript-client": "1.24.3",
     "@react-router/node": "7.17.0",
     "@react-router/serve": "7.17.0",
@@ -84,8 +84,6 @@
     "test:e2e:live": "node --env-file-if-exists=.env tests/e2e/live/scripts/run-live-e2e.mjs",
     "test:e2e:mock-llm": "playwright test --config=playwright.mock-llm.config.ts",
     "test:e2e:mock-llm:docker": "playwright test --config=playwright.mock-llm-docker.config.ts",
-    "test:e2e:snapshots": "playwright test tests/e2e/snapshots --project=chromium --retries=0",
-    "test:e2e:snapshots:update": "playwright test tests/e2e/snapshots --project=chromium --update-snapshots",
     "test:coverage": "npm run make-i18n && vitest run --coverage",
     "dev_wsl": "VITE_WATCH_USE_POLLING=true vite",
     "preview": "vite preview",
@@ -107,7 +105,7 @@
       "prettier --write"
     ],
     "src/**/*.{ts,tsx}": [
-      "bash -c 'npm run typecheck:staged'"
+      "node scripts/run-staged-typecheck.mjs"
     ],
     "src/**/*": [
       "npm run check-translation-completeness"