@openhands/agent-canvas 1.8.0 → 1.10.0

package/dist/manifests/interface-validation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface-validation.cjs","names":[],"sources":["../../src/manifests/interface-validation.ts"],"sourcesContent":["/**\n * Admission policy for the extension-published Automation interface manifest.\n *\n * Like a setup entry, the interface manifest is data authored in a different\n * repository that instructs this host to render copy, build links, and address\n * requests, so the host decides what it is *permitted* to state. Admission is\n * all-or-nothing: one bad field rejects the whole manifest, and the host falls\n * back to its own defaults rather than rendering a partially-trusted mix.\n */\n\nimport type {\n  AutomationAttributeName,\n  InterfaceAttributeType,\n  InterfaceRoutes,\n  OverviewMetric,\n} from \"./types\";\nimport {\n  DASHBOARD_FILTER_IDS,\n  DASHBOARD_FILTER_VALUES,\n  DASHBOARD_SORT_VALUES,\n  INTERFACE_ICON_SLUGS,\n  INTERFACE_SUB_PAGE_IDS,\n  INTERFACE_VERSION,\n  OVERVIEW_METRICS,\n  OVERVIEW_TILE_PLACEHOLDERS,\n} from \"./types\";\n\n/** Copy must never be able to inject markup into the host. */\nconst MARKUP_PATTERN = /<[A-Za-z/!]/;\nconst SLUG_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;\n/** The one URL the manifest may state, pinned to the product documentation. */\nconst DOCS_URL_PREFIX = \"https://docs.openhands.dev/\";\nconst FILE_KIND_PATTERN = /^[a-z][a-z-]*$/;\nconst FILENAME_SUFFIX_PATTERN = /^\\.[a-z][a-z.]*json$/;\nconst EVENT_SOURCE_PATTERN = /^[a-z0-9][a-z0-9.-]*$/;\n/** Service-relative only: rooted, no traversal, no query, no fragment. */\nconst ENDPOINT_PATTERN = /^\\/[A-Za-z0-9/{}_-]*$/;\n/** Exactly one `{id}` substitution and no other braces. */\nconst ID_ENDPOINT_PATTERN = /^[^{}]*\\{id\\}[^{}]*$/;\n\nconst GIT_PROVIDERS = [\"github\", \"gitlab\", \"bitbucket\"] as const;\n/**\n * The attribute semantics this host's edit dialog implements: the control it\n * renders per property and the requiredness it enforces. Admission pins a\n * declared attribute to exactly these, so an admitted manifest can never\n * promise a control, a requiredness, or (below) a minimum the form would\n * silently ignore.\n */\nconst HOST_ATTRIBUTES: Record<\n  AutomationAttributeName,\n  { type: InterfaceAttributeType; required: boolean }\n> = {\n  name: { type: \"text\", required: true },\n  prompt: { type: \"textarea\", required: false },\n  model: { type: \"llm-profile\", required: false },\n  timeout: { type: \"number\", required: false },\n  schedule: { type: \"schedule\", required: false },\n};\nconst ATTRIBUTE_NAMES = Object.keys(HOST_ATTRIBUTES);\nconst PLAIN_ENDPOINT_NAMES = [\n  \"list\",\n  \"health\",\n  \"capabilities\",\n  \"validate\",\n  \"createPrompt\",\n  \"createPlugin\",\n] as const;\nconst ID_ENDPOINT_NAMES = [\"detail\", \"dispatch\", \"runs\", \"tarball\"] as const;\n\nexport interface InterfaceValidationContext {\n  /** Ids of the published automation catalog, for the featured-list check. */\n  catalogIds: ReadonlySet<string>;\n  /** The routes this host has registrations for. A manifest must match them. */\n  mountedRoutes: InterfaceRoutes;\n}\n\nexport interface InterfaceValidationResult {\n  valid: boolean;\n  errors: string[];\n}\n\ntype Rec = Record<string, unknown>;\n\nfunction isRecord(value: unknown): value is Rec {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isOneOf<T extends readonly string[]>(\n  value: unknown,\n  values: T,\n): value is T[number] {\n  return (\n    typeof value === \"string\" && (values as readonly string[]).includes(value)\n  );\n}\n\nclass InterfaceChecker {\n  readonly errors: string[] = [];\n\n  fail(path: string, reason: string): false {\n    this.errors.push(`${path}: ${reason}`);\n    return false;\n  }\n\n  /** Literal user-visible copy. Carries no markup. */\n  copy(value: unknown, path: string): boolean {\n    if (typeof value !== \"string\" || value.length === 0) {\n      return this.fail(path, \"must be a non-empty string\");\n    }\n    if (MARKUP_PATTERN.test(value)) {\n      return this.fail(path, \"must not contain markup\");\n    }\n    return true;\n  }\n\n  /** A closed object: every present key must be an expected one. */\n  closed(container: Rec, allowed: readonly string[], path: string): void {\n    Object.keys(container)\n      .filter((key) => !allowed.includes(key))\n      .forEach((key) => this.fail(`${path}.${key}`, \"is not allowed\"));\n  }\n\n  record(value: unknown, path: string): value is Rec {\n    if (isRecord(value)) return true;\n    this.fail(path, \"must be an object\");\n    return false;\n  }\n}\n\nfunction checkRoutes(\n  check: InterfaceChecker,\n  routes: unknown,\n  mounted: InterfaceRoutes,\n): void {\n  if (!check.record(routes, \"routes\")) return;\n  check.closed(routes, [\"list\", \"setup\", \"detail\", \"templates\"], \"routes\");\n\n  // The host serves what it has registrations for, so a declared route must be\n  // exactly the mounted shape — the manifest owns link construction, not the\n  // router table.\n  ([\"list\", \"setup\", \"detail\"] as const).forEach((name) => {\n    if (routes[name] !== mounted[name]) {\n      check.fail(`routes.${name}`, `must be \"${mounted[name]}\"`);\n    }\n  });\n  if (\n    routes.templates !== undefined &&\n    routes.templates !== mounted.templates\n  ) {\n    check.fail(\n      \"routes.templates\",\n      mounted.templates === undefined\n        ? \"is not a route this host mounts\"\n        : `must be \"${mounted.templates}\"`,\n    );\n  }\n}\n\nfunction checkSubPages(check: InterfaceChecker, subPages: unknown): void {\n  if (!Array.isArray(subPages) || subPages.length === 0) {\n    check.fail(\"navigation.subPages\", \"must be a non-empty array\");\n    return;\n  }\n  const seen = new Set<string>();\n  subPages.forEach((item: unknown, index) => {\n    const path = `navigation.subPages[${index}]`;\n    if (!check.record(item, path)) return;\n    check.closed(item, [\"page\", \"label\", \"icon\"], path);\n\n    const { page, label, icon } = item;\n    if (!isOneOf(page, INTERFACE_SUB_PAGE_IDS)) {\n      check.fail(`${path}.page`, \"is not a sub-page this host serves\");\n    } else if (seen.has(page)) {\n      check.fail(`${path}.page`, \"repeats a page\");\n    } else {\n      seen.add(page);\n    }\n    check.copy(label, `${path}.label`);\n    checkIconSlug(check, icon, `${path}.icon`);\n  });\n}\n\nfunction checkIconSlug(\n  check: InterfaceChecker,\n  icon: unknown,\n  path: string,\n): void {\n  if (!isOneOf(icon, INTERFACE_ICON_SLUGS)) {\n    check.fail(path, \"is not an icon this host ships\");\n  }\n}\n\nfunction checkNavigation(check: InterfaceChecker, navigation: unknown): void {\n  if (!check.record(navigation, \"navigation\")) return;\n  check.closed(\n    navigation,\n    [\"sidebar\", \"commandMenu\", \"subPages\"],\n    \"navigation\",\n  );\n\n  if (check.record(navigation.sidebar, \"navigation.sidebar\")) {\n    check.closed(navigation.sidebar, [\"label\"], \"navigation.sidebar\");\n    check.copy(navigation.sidebar.label, \"navigation.sidebar.label\");\n  }\n  if (check.record(navigation.commandMenu, \"navigation.commandMenu\")) {\n    const menu = navigation.commandMenu;\n    check.closed(\n      menu,\n      [\"title\", \"description\", \"keywords\"],\n      \"navigation.commandMenu\",\n    );\n    check.copy(menu.title, \"navigation.commandMenu.title\");\n    check.copy(menu.description, \"navigation.commandMenu.description\");\n    check.copy(menu.keywords, \"navigation.commandMenu.keywords\");\n  }\n  if (navigation.subPages !== undefined) {\n    checkSubPages(check, navigation.subPages);\n  }\n}\n\nfunction checkPages(check: InterfaceChecker, pages: unknown): void {\n  if (!check.record(pages, \"pages\")) return;\n  check.closed(pages, [\"list\", \"detail\", \"edit\", \"templates\"], \"pages\");\n\n  if (check.record(pages.list, \"pages.list\")) {\n    check.closed(\n      pages.list,\n      [\"title\", \"subtitle\", \"overview\", \"filters\", \"sort\", \"insights\"],\n      \"pages.list\",\n    );\n    check.copy(pages.list.title, \"pages.list.title\");\n    check.copy(pages.list.subtitle, \"pages.list.subtitle\");\n    if (pages.list.overview !== undefined) {\n      checkOverview(check, pages.list.overview);\n    }\n    if (pages.list.filters !== undefined) {\n      checkFilters(check, pages.list.filters);\n    }\n    if (pages.list.sort !== undefined) {\n      checkSort(check, pages.list.sort);\n    }\n    if (pages.list.insights !== undefined) {\n      checkInsights(check, pages.list.insights);\n    }\n  }\n  if (check.record(pages.detail, \"pages.detail\")) {\n    check.closed(pages.detail, [\"backLabel\"], \"pages.detail\");\n    check.copy(pages.detail.backLabel, \"pages.detail.backLabel\");\n  }\n  if (check.record(pages.edit, \"pages.edit\")) {\n    check.closed(pages.edit, [\"title\"], \"pages.edit\");\n    check.copy(pages.edit.title, \"pages.edit.title\");\n  }\n  if (pages.templates !== undefined) {\n    checkTemplatesPage(check, pages.templates);\n  }\n}\n\nfunction checkOverview(check: InterfaceChecker, overview: unknown): void {\n  const path = \"pages.list.overview\";\n  if (!check.record(overview, path)) return;\n  check.closed(overview, [\"label\", \"tiles\"], path);\n  check.copy(overview.label, `${path}.label`);\n\n  const { tiles } = overview;\n  if (!Array.isArray(tiles) || tiles.length === 0) {\n    check.fail(`${path}.tiles`, \"must be a non-empty array\");\n    return;\n  }\n  const seen = new Set<string>();\n  tiles.forEach((tile: unknown, index) => {\n    checkOverviewTile(check, tile, seen, `${path}.tiles[${index}]`);\n  });\n}\n\nfunction checkOverviewTile(\n  check: InterfaceChecker,\n  tile: unknown,\n  seen: Set<string>,\n  path: string,\n): void {\n  if (!check.record(tile, path)) return;\n  check.closed(tile, [\"metric\", \"label\", \"detail\", \"zeroDetail\", \"icon\"], path);\n\n  const { metric, label, detail, zeroDetail, icon } = tile;\n  check.copy(label, `${path}.label`);\n  checkIconSlug(check, icon, `${path}.icon`);\n  if (!isOneOf(metric, OVERVIEW_METRICS)) {\n    check.fail(`${path}.metric`, \"is not a metric this host computes\");\n    check.copy(detail, `${path}.detail`);\n    if (zeroDetail !== undefined) check.copy(zeroDetail, `${path}.zeroDetail`);\n    return;\n  }\n  if (seen.has(metric)) {\n    check.fail(`${path}.metric`, \"repeats a metric\");\n  } else {\n    seen.add(metric);\n  }\n  checkTileCopy(check, detail, metric, `${path}.detail`);\n  if (zeroDetail !== undefined) {\n    checkTileCopy(check, zeroDetail, metric, `${path}.zeroDetail`);\n  }\n}\n\n/**\n * Tile copy may embed `{{name}}` placeholders, but only the names the metric\n * exposes — plain substitution, never an expression.\n */\nfunction checkTileCopy(\n  check: InterfaceChecker,\n  value: unknown,\n  metric: OverviewMetric,\n  path: string,\n): void {\n  if (!check.copy(value, path)) return;\n  const exposed = OVERVIEW_TILE_PLACEHOLDERS[metric];\n  const unknownPlaceholder =\n    exposed.length === 0\n      ? /\\{\\{/\n      : new RegExp(`\\\\{\\\\{(?!(?:${exposed.join(\"|\")})\\\\}\\\\})`);\n  if (unknownPlaceholder.test(value as string)) {\n    check.fail(path, \"uses a placeholder this metric does not expose\");\n  }\n}\n\nfunction checkFilters(check: InterfaceChecker, filters: unknown): void {\n  const path = \"pages.list.filters\";\n  if (!Array.isArray(filters) || filters.length === 0) {\n    check.fail(path, \"must be a non-empty array\");\n    return;\n  }\n  const seen = new Set<string>();\n  filters.forEach((filter: unknown, index) => {\n    checkFilter(check, filter, seen, `${path}[${index}]`);\n  });\n}\n\nfunction checkFilter(\n  check: InterfaceChecker,\n  filter: unknown,\n  seen: Set<string>,\n  path: string,\n): void {\n  if (!check.record(filter, path)) return;\n  check.closed(filter, [\"id\", \"label\", \"options\"], path);\n\n  const { id, label, options } = filter;\n  check.copy(label, `${path}.label`);\n  if (!isOneOf(id, DASHBOARD_FILTER_IDS)) {\n    check.fail(`${path}.id`, \"is not a filter this host implements\");\n    return;\n  }\n  if (seen.has(id)) {\n    check.fail(`${path}.id`, \"repeats a filter\");\n  } else {\n    seen.add(id);\n  }\n  checkFilterOptions(\n    check,\n    options,\n    DASHBOARD_FILTER_VALUES[id],\n    `${path}.options`,\n  );\n}\n\nfunction checkFilterOptions(\n  check: InterfaceChecker,\n  options: unknown,\n  values: readonly string[],\n  path: string,\n): void {\n  if (!Array.isArray(options) || options.length < 2) {\n    check.fail(path, \"must offer at least two options\");\n    return;\n  }\n  const seen = new Set<string>();\n  options.forEach((option: unknown, index) => {\n    const optionPath = `${path}[${index}]`;\n    if (!check.record(option, optionPath)) return;\n    check.closed(option, [\"value\", \"label\"], optionPath);\n\n    const { value, label } = option;\n    if (!isOneOf(value, values)) {\n      check.fail(`${optionPath}.value`, \"is not a value this host implements\");\n    } else if (seen.has(value)) {\n      check.fail(`${optionPath}.value`, \"repeats a value\");\n    } else {\n      seen.add(value);\n    }\n    check.copy(label, `${optionPath}.label`);\n  });\n  // \"all\" is the host's initial selection and what Clear filters resets to,\n  // so a filter that does not offer it could never be neutral.\n  if (!seen.has(\"all\")) {\n    check.fail(path, 'must offer the \"all\" option');\n  }\n}\n\nfunction checkSort(check: InterfaceChecker, sort: unknown): void {\n  const path = \"pages.list.sort\";\n  if (!check.record(sort, path)) return;\n  check.closed(sort, [\"label\", \"options\", \"default\"], path);\n\n  const { label, options, default: defaultValue } = sort;\n  check.copy(label, `${path}.label`);\n  const declared = new Set<string>();\n  if (!Array.isArray(options) || options.length === 0) {\n    check.fail(`${path}.options`, \"must be a non-empty array\");\n  } else {\n    options.forEach((option: unknown, index) => {\n      const optionPath = `${path}.options[${index}]`;\n      if (!check.record(option, optionPath)) return;\n      check.closed(option, [\"value\", \"label\"], optionPath);\n\n      if (!isOneOf(option.value, DASHBOARD_SORT_VALUES)) {\n        check.fail(`${optionPath}.value`, \"is not a sort this host implements\");\n      } else if (declared.has(option.value)) {\n        check.fail(`${optionPath}.value`, \"repeats a value\");\n      } else {\n        declared.add(option.value);\n      }\n      check.copy(option.label, `${optionPath}.label`);\n    });\n  }\n  if (typeof defaultValue !== \"string\" || !declared.has(defaultValue)) {\n    check.fail(`${path}.default`, \"must be one of the declared option values\");\n  }\n}\n\n/** Every insight state and stat the host renders must have a caption. */\nconst INSIGHTS_SHAPE = {\n  health: [\"healthy\", \"failing\", \"running\", \"disabled\", \"neverRun\", \"checking\"],\n  lastRun: [\"label\", \"never\", \"justNow\"],\n  stats: [\"runs\", \"recentSuccess\", \"averageDuration\"],\n} as const;\n\nfunction checkInsights(check: InterfaceChecker, insights: unknown): void {\n  const path = \"pages.list.insights\";\n  if (!check.record(insights, path)) return;\n  check.closed(insights, Object.keys(INSIGHTS_SHAPE), path);\n\n  (Object.keys(INSIGHTS_SHAPE) as (keyof typeof INSIGHTS_SHAPE)[]).forEach(\n    (section) => {\n      const sectionPath = `${path}.${section}`;\n      const value = insights[section];\n      if (!check.record(value, sectionPath)) return;\n      const keys = INSIGHTS_SHAPE[section];\n      check.closed(value, keys, sectionPath);\n      keys.forEach((key) => {\n        check.copy(value[key], `${sectionPath}.${key}`);\n      });\n    },\n  );\n}\n\nfunction checkTemplatesPage(check: InterfaceChecker, templates: unknown): void {\n  const path = \"pages.templates\";\n  if (!check.record(templates, path)) return;\n  check.closed(templates, [\"title\", \"description\"], path);\n  check.copy(templates.title, `${path}.title`);\n  check.copy(templates.description, `${path}.description`);\n}\n\n/**\n * The sub-page surface is declared whole or not at all. Navigation that points\n * at an unrouted page, or a dashboard with filters but no insight captions,\n * would be a partially-trusted mix, and the host refuses those wholesale.\n */\nfunction checkSubPageGroup(check: InterfaceChecker, candidate: Rec): void {\n  const routes = isRecord(candidate.routes) ? candidate.routes : {};\n  const navigation = isRecord(candidate.navigation) ? candidate.navigation : {};\n  const pages = isRecord(candidate.pages) ? candidate.pages : {};\n  const list = isRecord(pages.list) ? pages.list : {};\n\n  const pieces: [string, unknown][] = [\n    [\"routes.templates\", routes.templates],\n    [\"navigation.subPages\", navigation.subPages],\n    [\"pages.templates\", pages.templates],\n    [\"pages.list.overview\", list.overview],\n    [\"pages.list.filters\", list.filters],\n    [\"pages.list.sort\", list.sort],\n    [\"pages.list.insights\", list.insights],\n  ];\n  const missing = pieces\n    .filter(([, value]) => value === undefined)\n    .map(([name]) => name);\n  if (missing.length === 0 || missing.length === pieces.length) return;\n  check.fail(\n    \"interface\",\n    `the sub-page surface must be declared whole; missing ${missing.join(\", \")}`,\n  );\n}\n\nfunction checkAttribute(\n  check: InterfaceChecker,\n  host: { type: InterfaceAttributeType; required: boolean },\n  attribute: unknown,\n  path: string,\n): void {\n  if (!check.record(attribute, path)) return;\n  check.closed(\n    attribute,\n    [\"type\", \"label\", \"help\", \"required\", \"constraints\"],\n    path,\n  );\n\n  const { type, label, help, required, constraints } = attribute;\n  if (type !== host.type) {\n    check.fail(\n      `${path}.type`,\n      `must be \"${host.type}\", the control this host renders`,\n    );\n  }\n  check.copy(label, `${path}.label`);\n  if (help !== undefined) check.copy(help, `${path}.help`);\n  if (required !== host.required) {\n    check.fail(\n      `${path}.required`,\n      `must be ${host.required}, what this host enforces`,\n    );\n  }\n\n  if (constraints !== undefined) {\n    if (host.type !== \"number\") {\n      check.fail(\n        `${path}.constraints`,\n        \"is only allowed on a number attribute\",\n      );\n    } else if (check.record(constraints, `${path}.constraints`)) {\n      check.closed(constraints, [\"min\", \"max\"], `${path}.constraints`);\n      const { min, max } = constraints;\n      // The form validates a positive integer, i.e. an effective minimum of 1;\n      // any other declared minimum would be a promise it does not keep.\n      if (min !== undefined && min !== 1) {\n        check.fail(\n          `${path}.constraints.min`,\n          \"must be the 1 this host enforces\",\n        );\n      }\n      if (\n        max !== undefined &&\n        (!Number.isInteger(max) || (max as number) < 1)\n      ) {\n        check.fail(`${path}.constraints.max`, \"must be a positive integer\");\n      }\n    }\n  }\n}\n\nfunction checkAttributes(check: InterfaceChecker, attributes: unknown): void {\n  if (!check.record(attributes, \"attributes\")) return;\n  const names = Object.keys(attributes);\n  if (names.length === 0) {\n    check.fail(\"attributes\", \"must declare at least one attribute\");\n  }\n  names.forEach((name) => {\n    if (!ATTRIBUTE_NAMES.includes(name)) {\n      check.fail(`attributes.${name}`, \"is not a settable attribute\");\n      return;\n    }\n    checkAttribute(\n      check,\n      HOST_ATTRIBUTES[name as AutomationAttributeName],\n      attributes[name],\n      `attributes.${name}`,\n    );\n  });\n}\n\nfunction checkImportExport(\n  check: InterfaceChecker,\n  importExport: unknown,\n): void {\n  if (!check.record(importExport, \"importExport\")) return;\n  check.closed(\n    importExport,\n    [\"fileKind\", \"fileVersion\", \"filenameSuffix\", \"importDefaults\"],\n    \"importExport\",\n  );\n\n  const { fileKind, fileVersion, filenameSuffix, importDefaults } =\n    importExport;\n  if (typeof fileKind !== \"string\" || !FILE_KIND_PATTERN.test(fileKind)) {\n    check.fail(\"importExport.fileKind\", \"must be a lowercase slug\");\n  }\n  if (fileVersion !== 1) {\n    check.fail(\"importExport.fileVersion\", \"must be 1\");\n  }\n  if (\n    typeof filenameSuffix !== \"string\" ||\n    !FILENAME_SUFFIX_PATTERN.test(filenameSuffix)\n  ) {\n    check.fail(\"importExport.filenameSuffix\", \"must be a .json suffix\");\n  }\n  if (check.record(importDefaults, \"importExport.importDefaults\")) {\n    check.closed(\n      importDefaults,\n      [\"repoProvider\", \"placeholderEventSource\"],\n      \"importExport.importDefaults\",\n    );\n    if (\n      typeof importDefaults.repoProvider !== \"string\" ||\n      !(GIT_PROVIDERS as readonly string[]).includes(\n        importDefaults.repoProvider,\n      )\n    ) {\n      check.fail(\n        \"importExport.importDefaults.repoProvider\",\n        \"is not a supported provider\",\n      );\n    }\n    if (\n      typeof importDefaults.placeholderEventSource !== \"string\" ||\n      !EVENT_SOURCE_PATTERN.test(importDefaults.placeholderEventSource)\n    ) {\n      check.fail(\n        \"importExport.importDefaults.placeholderEventSource\",\n        \"must be a lowercase event source\",\n      );\n    }\n  }\n}\n\nfunction checkEndpoints(check: InterfaceChecker, endpoints: unknown): void {\n  if (!check.record(endpoints, \"endpoints\")) return;\n  const allowed = [...PLAIN_ENDPOINT_NAMES, ...ID_ENDPOINT_NAMES];\n  check.closed(endpoints, allowed, \"endpoints\");\n\n  const endpointAt = (name: string): string | null => {\n    const value = endpoints[name];\n    if (\n      typeof value !== \"string\" ||\n      !ENDPOINT_PATTERN.test(value) ||\n      value.includes(\"//\")\n    ) {\n      check.fail(`endpoints.${name}`, \"must be a rooted service-relative path\");\n      return null;\n    }\n    return value;\n  };\n\n  PLAIN_ENDPOINT_NAMES.forEach((name) => {\n    const value = endpointAt(name);\n    if (value !== null && /[{}]/.test(value)) {\n      check.fail(`endpoints.${name}`, \"must not carry a substitution\");\n    }\n  });\n  ID_ENDPOINT_NAMES.forEach((name) => {\n    const value = endpointAt(name);\n    if (value !== null && !ID_ENDPOINT_PATTERN.test(value)) {\n      check.fail(`endpoints.${name}`, \"must carry exactly one {id}\");\n    }\n  });\n}\n\nfunction checkSlugList(\n  check: InterfaceChecker,\n  value: unknown,\n  path: string,\n): string[] {\n  if (!Array.isArray(value) || value.length === 0) {\n    check.fail(path, \"must be a non-empty array\");\n    return [];\n  }\n  const slugs = value.filter((item): item is string => {\n    if (typeof item === \"string\" && SLUG_PATTERN.test(item)) return true;\n    check.fail(path, \"must contain only lowercase slugs\");\n    return false;\n  });\n  if (new Set(slugs).size !== slugs.length) {\n    check.fail(path, \"must not repeat an id\");\n  }\n  return slugs;\n}\n\nconst TOP_LEVEL_KEYS = [\n  \"version\",\n  \"routes\",\n  \"navigation\",\n  \"pages\",\n  \"docsUrl\",\n  \"attributes\",\n  \"importExport\",\n  \"endpoints\",\n  \"featuredAutomationIds\",\n  \"responderIntegrationIds\",\n];\n\n/**\n * Decide whether this host will act on a published interface manifest.\n *\n * The version is checked first and fails closed: a format this host does not\n * recognise is refused rather than interpreted with today's rules.\n */\nexport function validateInterfaceManifest(\n  candidate: unknown,\n  context: InterfaceValidationContext,\n): InterfaceValidationResult {\n  if (!isRecord(candidate)) {\n    return { valid: false, errors: [\"interface: must be an object\"] };\n  }\n  if (candidate.version !== INTERFACE_VERSION) {\n    return {\n      valid: false,\n      errors: [`interface.version: must be \"${INTERFACE_VERSION}\"`],\n    };\n  }\n\n  const check = new InterfaceChecker();\n  check.closed(candidate, TOP_LEVEL_KEYS, \"interface\");\n\n  checkRoutes(check, candidate.routes, context.mountedRoutes);\n  checkNavigation(check, candidate.navigation);\n  checkPages(check, candidate.pages);\n  if (\n    typeof candidate.docsUrl !== \"string\" ||\n    !candidate.docsUrl.startsWith(DOCS_URL_PREFIX)\n  ) {\n    check.fail(\"docsUrl\", `must start with ${DOCS_URL_PREFIX}`);\n  }\n  checkAttributes(check, candidate.attributes);\n  checkImportExport(check, candidate.importExport);\n  checkEndpoints(check, candidate.endpoints);\n\n  checkSlugList(\n    check,\n    candidate.featuredAutomationIds,\n    \"featuredAutomationIds\",\n  ).forEach((id) => {\n    if (!context.catalogIds.has(id)) {\n      check.fail(\"featuredAutomationIds\", `${id} is not a catalog entry`);\n    }\n  });\n  checkSlugList(\n    check,\n    candidate.responderIntegrationIds,\n    \"responderIntegrationIds\",\n  );\n\n  checkSubPageGroup(check, candidate);\n\n  return { valid: check.errors.length === 0, errors: check.errors };\n}\n"],"mappings":"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"}

package/dist/manifests/interface-validation.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Admission policy for the extension-published Automation interface manifest.
+ *
+ * Like a setup entry, the interface manifest is data authored in a different
+ * repository that instructs this host to render copy, build links, and address
+ * requests, so the host decides what it is *permitted* to state. Admission is
+ * all-or-nothing: one bad field rejects the whole manifest, and the host falls
+ * back to its own defaults rather than rendering a partially-trusted mix.
+ */
+import type { InterfaceRoutes } from "./types";
+export interface InterfaceValidationContext {
+    /** Ids of the published automation catalog, for the featured-list check. */
+    catalogIds: ReadonlySet<string>;
+    /** The routes this host has registrations for. A manifest must match them. */
+    mountedRoutes: InterfaceRoutes;
+}
+export interface InterfaceValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Decide whether this host will act on a published interface manifest.
+ *
+ * The version is checked first and fails closed: a format this host does not
+ * recognise is refused rather than interpreted with today's rules.
+ */
+export declare function validateInterfaceManifest(candidate: unknown, context: InterfaceValidationContext): InterfaceValidationResult;

package/dist/manifests/interface-validation.js

@@ -0,0 +1,360 @@
+import { DASHBOARD_FILTER_IDS as e, DASHBOARD_FILTER_VALUES as t, DASHBOARD_SORT_VALUES as n, INTERFACE_ICON_SLUGS as r, INTERFACE_SUB_PAGE_IDS as i, OVERVIEW_METRICS as a, OVERVIEW_TILE_PLACEHOLDERS as o } from "./types.js";
+//#region src/manifests/interface-validation.ts
+var s = /<[A-Za-z/!]/, c = /^[a-z0-9]+(-[a-z0-9]+)*$/, l = "https://docs.openhands.dev/", u = /^[a-z][a-z-]*$/, d = /^\.[a-z][a-z.]*json$/, f = /^[a-z0-9][a-z0-9.-]*$/, p = /^\/[A-Za-z0-9/{}_-]*$/, m = /^[^{}]*\{id\}[^{}]*$/, h = [
+	"github",
+	"gitlab",
+	"bitbucket"
+], g = {
+	name: {
+		type: "text",
+		required: !0
+	},
+	prompt: {
+		type: "textarea",
+		required: !1
+	},
+	model: {
+		type: "llm-profile",
+		required: !1
+	},
+	timeout: {
+		type: "number",
+		required: !1
+	},
+	schedule: {
+		type: "schedule",
+		required: !1
+	}
+}, _ = Object.keys(g), v = [
+	"list",
+	"health",
+	"capabilities",
+	"validate",
+	"createPrompt",
+	"createPlugin"
+], y = [
+	"detail",
+	"dispatch",
+	"runs",
+	"tarball"
+];
+function b(e) {
+	return typeof e == "object" && !!e && !Array.isArray(e);
+}
+function x(e, t) {
+	return typeof e == "string" && t.includes(e);
+}
+var S = class {
+	errors = [];
+	fail(e, t) {
+		return this.errors.push(`${e}: ${t}`), !1;
+	}
+	copy(e, t) {
+		return typeof e != "string" || e.length === 0 ? this.fail(t, "must be a non-empty string") : s.test(e) ? this.fail(t, "must not contain markup") : !0;
+	}
+	closed(e, t, n) {
+		Object.keys(e).filter((e) => !t.includes(e)).forEach((e) => this.fail(`${n}.${e}`, "is not allowed"));
+	}
+	record(e, t) {
+		return b(e) ? !0 : (this.fail(t, "must be an object"), !1);
+	}
+};
+function C(e, t, n) {
+	e.record(t, "routes") && (e.closed(t, [
+		"list",
+		"setup",
+		"detail",
+		"templates"
+	], "routes"), [
+		"list",
+		"setup",
+		"detail"
+	].forEach((r) => {
+		t[r] !== n[r] && e.fail(`routes.${r}`, `must be "${n[r]}"`);
+	}), t.templates !== void 0 && t.templates !== n.templates && e.fail("routes.templates", n.templates === void 0 ? "is not a route this host mounts" : `must be "${n.templates}"`));
+}
+function w(e, t) {
+	if (!Array.isArray(t) || t.length === 0) {
+		e.fail("navigation.subPages", "must be a non-empty array");
+		return;
+	}
+	let n = /* @__PURE__ */ new Set();
+	t.forEach((t, r) => {
+		let a = `navigation.subPages[${r}]`;
+		if (!e.record(t, a)) return;
+		e.closed(t, [
+			"page",
+			"label",
+			"icon"
+		], a);
+		let { page: o, label: s, icon: c } = t;
+		x(o, i) ? n.has(o) ? e.fail(`${a}.page`, "repeats a page") : n.add(o) : e.fail(`${a}.page`, "is not a sub-page this host serves"), e.copy(s, `${a}.label`), T(e, c, `${a}.icon`);
+	});
+}
+function T(e, t, n) {
+	x(t, r) || e.fail(n, "is not an icon this host ships");
+}
+function E(e, t) {
+	if (e.record(t, "navigation")) {
+		if (e.closed(t, [
+			"sidebar",
+			"commandMenu",
+			"subPages"
+		], "navigation"), e.record(t.sidebar, "navigation.sidebar") && (e.closed(t.sidebar, ["label"], "navigation.sidebar"), e.copy(t.sidebar.label, "navigation.sidebar.label")), e.record(t.commandMenu, "navigation.commandMenu")) {
+			let n = t.commandMenu;
+			e.closed(n, [
+				"title",
+				"description",
+				"keywords"
+			], "navigation.commandMenu"), e.copy(n.title, "navigation.commandMenu.title"), e.copy(n.description, "navigation.commandMenu.description"), e.copy(n.keywords, "navigation.commandMenu.keywords");
+		}
+		t.subPages !== void 0 && w(e, t.subPages);
+	}
+}
+function D(e, t) {
+	e.record(t, "pages") && (e.closed(t, [
+		"list",
+		"detail",
+		"edit",
+		"templates"
+	], "pages"), e.record(t.list, "pages.list") && (e.closed(t.list, [
+		"title",
+		"subtitle",
+		"overview",
+		"filters",
+		"sort",
+		"insights"
+	], "pages.list"), e.copy(t.list.title, "pages.list.title"), e.copy(t.list.subtitle, "pages.list.subtitle"), t.list.overview !== void 0 && O(e, t.list.overview), t.list.filters !== void 0 && j(e, t.list.filters), t.list.sort !== void 0 && P(e, t.list.sort), t.list.insights !== void 0 && I(e, t.list.insights)), e.record(t.detail, "pages.detail") && (e.closed(t.detail, ["backLabel"], "pages.detail"), e.copy(t.detail.backLabel, "pages.detail.backLabel")), e.record(t.edit, "pages.edit") && (e.closed(t.edit, ["title"], "pages.edit"), e.copy(t.edit.title, "pages.edit.title")), t.templates !== void 0 && L(e, t.templates));
+}
+function O(e, t) {
+	let n = "pages.list.overview";
+	if (!e.record(t, n)) return;
+	e.closed(t, ["label", "tiles"], n), e.copy(t.label, `${n}.label`);
+	let { tiles: r } = t;
+	if (!Array.isArray(r) || r.length === 0) {
+		e.fail(`${n}.tiles`, "must be a non-empty array");
+		return;
+	}
+	let i = /* @__PURE__ */ new Set();
+	r.forEach((t, r) => {
+		k(e, t, i, `${n}.tiles[${r}]`);
+	});
+}
+function k(e, t, n, r) {
+	if (!e.record(t, r)) return;
+	e.closed(t, [
+		"metric",
+		"label",
+		"detail",
+		"zeroDetail",
+		"icon"
+	], r);
+	let { metric: i, label: o, detail: s, zeroDetail: c, icon: l } = t;
+	if (e.copy(o, `${r}.label`), T(e, l, `${r}.icon`), !x(i, a)) {
+		e.fail(`${r}.metric`, "is not a metric this host computes"), e.copy(s, `${r}.detail`), c !== void 0 && e.copy(c, `${r}.zeroDetail`);
+		return;
+	}
+	n.has(i) ? e.fail(`${r}.metric`, "repeats a metric") : n.add(i), A(e, s, i, `${r}.detail`), c !== void 0 && A(e, c, i, `${r}.zeroDetail`);
+}
+function A(e, t, n, r) {
+	if (!e.copy(t, r)) return;
+	let i = o[n];
+	(i.length === 0 ? /\{\{/ : RegExp(`\\{\\{(?!(?:${i.join("|")})\\}\\})`)).test(t) && e.fail(r, "uses a placeholder this metric does not expose");
+}
+function j(e, t) {
+	let n = "pages.list.filters";
+	if (!Array.isArray(t) || t.length === 0) {
+		e.fail(n, "must be a non-empty array");
+		return;
+	}
+	let r = /* @__PURE__ */ new Set();
+	t.forEach((t, i) => {
+		M(e, t, r, `${n}[${i}]`);
+	});
+}
+function M(n, r, i, a) {
+	if (!n.record(r, a)) return;
+	n.closed(r, [
+		"id",
+		"label",
+		"options"
+	], a);
+	let { id: o, label: s, options: c } = r;
+	if (n.copy(s, `${a}.label`), !x(o, e)) {
+		n.fail(`${a}.id`, "is not a filter this host implements");
+		return;
+	}
+	i.has(o) ? n.fail(`${a}.id`, "repeats a filter") : i.add(o), N(n, c, t[o], `${a}.options`);
+}
+function N(e, t, n, r) {
+	if (!Array.isArray(t) || t.length < 2) {
+		e.fail(r, "must offer at least two options");
+		return;
+	}
+	let i = /* @__PURE__ */ new Set();
+	t.forEach((t, a) => {
+		let o = `${r}[${a}]`;
+		if (!e.record(t, o)) return;
+		e.closed(t, ["value", "label"], o);
+		let { value: s, label: c } = t;
+		x(s, n) ? i.has(s) ? e.fail(`${o}.value`, "repeats a value") : i.add(s) : e.fail(`${o}.value`, "is not a value this host implements"), e.copy(c, `${o}.label`);
+	}), i.has("all") || e.fail(r, "must offer the \"all\" option");
+}
+function P(e, t) {
+	let r = "pages.list.sort";
+	if (!e.record(t, r)) return;
+	e.closed(t, [
+		"label",
+		"options",
+		"default"
+	], r);
+	let { label: i, options: a, default: o } = t;
+	e.copy(i, `${r}.label`);
+	let s = /* @__PURE__ */ new Set();
+	!Array.isArray(a) || a.length === 0 ? e.fail(`${r}.options`, "must be a non-empty array") : a.forEach((t, i) => {
+		let a = `${r}.options[${i}]`;
+		e.record(t, a) && (e.closed(t, ["value", "label"], a), x(t.value, n) ? s.has(t.value) ? e.fail(`${a}.value`, "repeats a value") : s.add(t.value) : e.fail(`${a}.value`, "is not a sort this host implements"), e.copy(t.label, `${a}.label`));
+	}), (typeof o != "string" || !s.has(o)) && e.fail(`${r}.default`, "must be one of the declared option values");
+}
+var F = {
+	health: [
+		"healthy",
+		"failing",
+		"running",
+		"disabled",
+		"neverRun",
+		"checking"
+	],
+	lastRun: [
+		"label",
+		"never",
+		"justNow"
+	],
+	stats: [
+		"runs",
+		"recentSuccess",
+		"averageDuration"
+	]
+};
+function I(e, t) {
+	let n = "pages.list.insights";
+	e.record(t, n) && (e.closed(t, Object.keys(F), n), Object.keys(F).forEach((r) => {
+		let i = `${n}.${r}`, a = t[r];
+		if (!e.record(a, i)) return;
+		let o = F[r];
+		e.closed(a, o, i), o.forEach((t) => {
+			e.copy(a[t], `${i}.${t}`);
+		});
+	}));
+}
+function L(e, t) {
+	let n = "pages.templates";
+	e.record(t, n) && (e.closed(t, ["title", "description"], n), e.copy(t.title, `${n}.title`), e.copy(t.description, `${n}.description`));
+}
+function R(e, t) {
+	let n = b(t.routes) ? t.routes : {}, r = b(t.navigation) ? t.navigation : {}, i = b(t.pages) ? t.pages : {}, a = b(i.list) ? i.list : {}, o = [
+		["routes.templates", n.templates],
+		["navigation.subPages", r.subPages],
+		["pages.templates", i.templates],
+		["pages.list.overview", a.overview],
+		["pages.list.filters", a.filters],
+		["pages.list.sort", a.sort],
+		["pages.list.insights", a.insights]
+	], s = o.filter(([, e]) => e === void 0).map(([e]) => e);
+	s.length === 0 || s.length === o.length || e.fail("interface", `the sub-page surface must be declared whole; missing ${s.join(", ")}`);
+}
+function z(e, t, n, r) {
+	if (!e.record(n, r)) return;
+	e.closed(n, [
+		"type",
+		"label",
+		"help",
+		"required",
+		"constraints"
+	], r);
+	let { type: i, label: a, help: o, required: s, constraints: c } = n;
+	if (i !== t.type && e.fail(`${r}.type`, `must be "${t.type}", the control this host renders`), e.copy(a, `${r}.label`), o !== void 0 && e.copy(o, `${r}.help`), s !== t.required && e.fail(`${r}.required`, `must be ${t.required}, what this host enforces`), c !== void 0) {
+		if (t.type !== "number") e.fail(`${r}.constraints`, "is only allowed on a number attribute");
+		else if (e.record(c, `${r}.constraints`)) {
+			e.closed(c, ["min", "max"], `${r}.constraints`);
+			let { min: t, max: n } = c;
+			t !== void 0 && t !== 1 && e.fail(`${r}.constraints.min`, "must be the 1 this host enforces"), n !== void 0 && (!Number.isInteger(n) || n < 1) && e.fail(`${r}.constraints.max`, "must be a positive integer");
+		}
+	}
+}
+function B(e, t) {
+	if (!e.record(t, "attributes")) return;
+	let n = Object.keys(t);
+	n.length === 0 && e.fail("attributes", "must declare at least one attribute"), n.forEach((n) => {
+		if (!_.includes(n)) {
+			e.fail(`attributes.${n}`, "is not a settable attribute");
+			return;
+		}
+		z(e, g[n], t[n], `attributes.${n}`);
+	});
+}
+function V(e, t) {
+	if (!e.record(t, "importExport")) return;
+	e.closed(t, [
+		"fileKind",
+		"fileVersion",
+		"filenameSuffix",
+		"importDefaults"
+	], "importExport");
+	let { fileKind: n, fileVersion: r, filenameSuffix: i, importDefaults: a } = t;
+	(typeof n != "string" || !u.test(n)) && e.fail("importExport.fileKind", "must be a lowercase slug"), r !== 1 && e.fail("importExport.fileVersion", "must be 1"), (typeof i != "string" || !d.test(i)) && e.fail("importExport.filenameSuffix", "must be a .json suffix"), e.record(a, "importExport.importDefaults") && (e.closed(a, ["repoProvider", "placeholderEventSource"], "importExport.importDefaults"), (typeof a.repoProvider != "string" || !h.includes(a.repoProvider)) && e.fail("importExport.importDefaults.repoProvider", "is not a supported provider"), (typeof a.placeholderEventSource != "string" || !f.test(a.placeholderEventSource)) && e.fail("importExport.importDefaults.placeholderEventSource", "must be a lowercase event source"));
+}
+function H(e, t) {
+	if (!e.record(t, "endpoints")) return;
+	let n = [...v, ...y];
+	e.closed(t, n, "endpoints");
+	let r = (n) => {
+		let r = t[n];
+		return typeof r != "string" || !p.test(r) || r.includes("//") ? (e.fail(`endpoints.${n}`, "must be a rooted service-relative path"), null) : r;
+	};
+	v.forEach((t) => {
+		let n = r(t);
+		n !== null && /[{}]/.test(n) && e.fail(`endpoints.${t}`, "must not carry a substitution");
+	}), y.forEach((t) => {
+		let n = r(t);
+		n !== null && !m.test(n) && e.fail(`endpoints.${t}`, "must carry exactly one {id}");
+	});
+}
+function U(e, t, n) {
+	if (!Array.isArray(t) || t.length === 0) return e.fail(n, "must be a non-empty array"), [];
+	let r = t.filter((t) => typeof t == "string" && c.test(t) ? !0 : (e.fail(n, "must contain only lowercase slugs"), !1));
+	return new Set(r).size !== r.length && e.fail(n, "must not repeat an id"), r;
+}
+var W = [
+	"version",
+	"routes",
+	"navigation",
+	"pages",
+	"docsUrl",
+	"attributes",
+	"importExport",
+	"endpoints",
+	"featuredAutomationIds",
+	"responderIntegrationIds"
+];
+function G(e, t) {
+	if (!b(e)) return {
+		valid: !1,
+		errors: ["interface: must be an object"]
+	};
+	if (e.version !== "1.0") return {
+		valid: !1,
+		errors: ["interface.version: must be \"1.0\""]
+	};
+	let n = new S();
+	return n.closed(e, W, "interface"), C(n, e.routes, t.mountedRoutes), E(n, e.navigation), D(n, e.pages), (typeof e.docsUrl != "string" || !e.docsUrl.startsWith(l)) && n.fail("docsUrl", `must start with ${l}`), B(n, e.attributes), V(n, e.importExport), H(n, e.endpoints), U(n, e.featuredAutomationIds, "featuredAutomationIds").forEach((e) => {
+		t.catalogIds.has(e) || n.fail("featuredAutomationIds", `${e} is not a catalog entry`);
+	}), U(n, e.responderIntegrationIds, "responderIntegrationIds"), R(n, e), {
+		valid: n.errors.length === 0,
+		errors: n.errors
+	};
+}
+//#endregion
+export { G as validateInterfaceManifest };
+
+//# sourceMappingURL=interface-validation.js.map

package/dist/manifests/interface-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface-validation.js","names":[],"sources":["../../src/manifests/interface-validation.ts"],"sourcesContent":["/**\n * Admission policy for the extension-published Automation interface manifest.\n *\n * Like a setup entry, the interface manifest is data authored in a different\n * repository that instructs this host to render copy, build links, and address\n * requests, so the host decides what it is *permitted* to state. Admission is\n * all-or-nothing: one bad field rejects the whole manifest, and the host falls\n * back to its own defaults rather than rendering a partially-trusted mix.\n */\n\nimport type {\n  AutomationAttributeName,\n  InterfaceAttributeType,\n  InterfaceRoutes,\n  OverviewMetric,\n} from \"./types\";\nimport {\n  DASHBOARD_FILTER_IDS,\n  DASHBOARD_FILTER_VALUES,\n  DASHBOARD_SORT_VALUES,\n  INTERFACE_ICON_SLUGS,\n  INTERFACE_SUB_PAGE_IDS,\n  INTERFACE_VERSION,\n  OVERVIEW_METRICS,\n  OVERVIEW_TILE_PLACEHOLDERS,\n} from \"./types\";\n\n/** Copy must never be able to inject markup into the host. */\nconst MARKUP_PATTERN = /<[A-Za-z/!]/;\nconst SLUG_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;\n/** The one URL the manifest may state, pinned to the product documentation. */\nconst DOCS_URL_PREFIX = \"https://docs.openhands.dev/\";\nconst FILE_KIND_PATTERN = /^[a-z][a-z-]*$/;\nconst FILENAME_SUFFIX_PATTERN = /^\\.[a-z][a-z.]*json$/;\nconst EVENT_SOURCE_PATTERN = /^[a-z0-9][a-z0-9.-]*$/;\n/** Service-relative only: rooted, no traversal, no query, no fragment. */\nconst ENDPOINT_PATTERN = /^\\/[A-Za-z0-9/{}_-]*$/;\n/** Exactly one `{id}` substitution and no other braces. */\nconst ID_ENDPOINT_PATTERN = /^[^{}]*\\{id\\}[^{}]*$/;\n\nconst GIT_PROVIDERS = [\"github\", \"gitlab\", \"bitbucket\"] as const;\n/**\n * The attribute semantics this host's edit dialog implements: the control it\n * renders per property and the requiredness it enforces. Admission pins a\n * declared attribute to exactly these, so an admitted manifest can never\n * promise a control, a requiredness, or (below) a minimum the form would\n * silently ignore.\n */\nconst HOST_ATTRIBUTES: Record<\n  AutomationAttributeName,\n  { type: InterfaceAttributeType; required: boolean }\n> = {\n  name: { type: \"text\", required: true },\n  prompt: { type: \"textarea\", required: false },\n  model: { type: \"llm-profile\", required: false },\n  timeout: { type: \"number\", required: false },\n  schedule: { type: \"schedule\", required: false },\n};\nconst ATTRIBUTE_NAMES = Object.keys(HOST_ATTRIBUTES);\nconst PLAIN_ENDPOINT_NAMES = [\n  \"list\",\n  \"health\",\n  \"capabilities\",\n  \"validate\",\n  \"createPrompt\",\n  \"createPlugin\",\n] as const;\nconst ID_ENDPOINT_NAMES = [\"detail\", \"dispatch\", \"runs\", \"tarball\"] as const;\n\nexport interface InterfaceValidationContext {\n  /** Ids of the published automation catalog, for the featured-list check. */\n  catalogIds: ReadonlySet<string>;\n  /** The routes this host has registrations for. A manifest must match them. */\n  mountedRoutes: InterfaceRoutes;\n}\n\nexport interface InterfaceValidationResult {\n  valid: boolean;\n  errors: string[];\n}\n\ntype Rec = Record<string, unknown>;\n\nfunction isRecord(value: unknown): value is Rec {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isOneOf<T extends readonly string[]>(\n  value: unknown,\n  values: T,\n): value is T[number] {\n  return (\n    typeof value === \"string\" && (values as readonly string[]).includes(value)\n  );\n}\n\nclass InterfaceChecker {\n  readonly errors: string[] = [];\n\n  fail(path: string, reason: string): false {\n    this.errors.push(`${path}: ${reason}`);\n    return false;\n  }\n\n  /** Literal user-visible copy. Carries no markup. */\n  copy(value: unknown, path: string): boolean {\n    if (typeof value !== \"string\" || value.length === 0) {\n      return this.fail(path, \"must be a non-empty string\");\n    }\n    if (MARKUP_PATTERN.test(value)) {\n      return this.fail(path, \"must not contain markup\");\n    }\n    return true;\n  }\n\n  /** A closed object: every present key must be an expected one. */\n  closed(container: Rec, allowed: readonly string[], path: string): void {\n    Object.keys(container)\n      .filter((key) => !allowed.includes(key))\n      .forEach((key) => this.fail(`${path}.${key}`, \"is not allowed\"));\n  }\n\n  record(value: unknown, path: string): value is Rec {\n    if (isRecord(value)) return true;\n    this.fail(path, \"must be an object\");\n    return false;\n  }\n}\n\nfunction checkRoutes(\n  check: InterfaceChecker,\n  routes: unknown,\n  mounted: InterfaceRoutes,\n): void {\n  if (!check.record(routes, \"routes\")) return;\n  check.closed(routes, [\"list\", \"setup\", \"detail\", \"templates\"], \"routes\");\n\n  // The host serves what it has registrations for, so a declared route must be\n  // exactly the mounted shape — the manifest owns link construction, not the\n  // router table.\n  ([\"list\", \"setup\", \"detail\"] as const).forEach((name) => {\n    if (routes[name] !== mounted[name]) {\n      check.fail(`routes.${name}`, `must be \"${mounted[name]}\"`);\n    }\n  });\n  if (\n    routes.templates !== undefined &&\n    routes.templates !== mounted.templates\n  ) {\n    check.fail(\n      \"routes.templates\",\n      mounted.templates === undefined\n        ? \"is not a route this host mounts\"\n        : `must be \"${mounted.templates}\"`,\n    );\n  }\n}\n\nfunction checkSubPages(check: InterfaceChecker, subPages: unknown): void {\n  if (!Array.isArray(subPages) || subPages.length === 0) {\n    check.fail(\"navigation.subPages\", \"must be a non-empty array\");\n    return;\n  }\n  const seen = new Set<string>();\n  subPages.forEach((item: unknown, index) => {\n    const path = `navigation.subPages[${index}]`;\n    if (!check.record(item, path)) return;\n    check.closed(item, [\"page\", \"label\", \"icon\"], path);\n\n    const { page, label, icon } = item;\n    if (!isOneOf(page, INTERFACE_SUB_PAGE_IDS)) {\n      check.fail(`${path}.page`, \"is not a sub-page this host serves\");\n    } else if (seen.has(page)) {\n      check.fail(`${path}.page`, \"repeats a page\");\n    } else {\n      seen.add(page);\n    }\n    check.copy(label, `${path}.label`);\n    checkIconSlug(check, icon, `${path}.icon`);\n  });\n}\n\nfunction checkIconSlug(\n  check: InterfaceChecker,\n  icon: unknown,\n  path: string,\n): void {\n  if (!isOneOf(icon, INTERFACE_ICON_SLUGS)) {\n    check.fail(path, \"is not an icon this host ships\");\n  }\n}\n\nfunction checkNavigation(check: InterfaceChecker, navigation: unknown): void {\n  if (!check.record(navigation, \"navigation\")) return;\n  check.closed(\n    navigation,\n    [\"sidebar\", \"commandMenu\", \"subPages\"],\n    \"navigation\",\n  );\n\n  if (check.record(navigation.sidebar, \"navigation.sidebar\")) {\n    check.closed(navigation.sidebar, [\"label\"], \"navigation.sidebar\");\n    check.copy(navigation.sidebar.label, \"navigation.sidebar.label\");\n  }\n  if (check.record(navigation.commandMenu, \"navigation.commandMenu\")) {\n    const menu = navigation.commandMenu;\n    check.closed(\n      menu,\n      [\"title\", \"description\", \"keywords\"],\n      \"navigation.commandMenu\",\n    );\n    check.copy(menu.title, \"navigation.commandMenu.title\");\n    check.copy(menu.description, \"navigation.commandMenu.description\");\n    check.copy(menu.keywords, \"navigation.commandMenu.keywords\");\n  }\n  if (navigation.subPages !== undefined) {\n    checkSubPages(check, navigation.subPages);\n  }\n}\n\nfunction checkPages(check: InterfaceChecker, pages: unknown): void {\n  if (!check.record(pages, \"pages\")) return;\n  check.closed(pages, [\"list\", \"detail\", \"edit\", \"templates\"], \"pages\");\n\n  if (check.record(pages.list, \"pages.list\")) {\n    check.closed(\n      pages.list,\n      [\"title\", \"subtitle\", \"overview\", \"filters\", \"sort\", \"insights\"],\n      \"pages.list\",\n    );\n    check.copy(pages.list.title, \"pages.list.title\");\n    check.copy(pages.list.subtitle, \"pages.list.subtitle\");\n    if (pages.list.overview !== undefined) {\n      checkOverview(check, pages.list.overview);\n    }\n    if (pages.list.filters !== undefined) {\n      checkFilters(check, pages.list.filters);\n    }\n    if (pages.list.sort !== undefined) {\n      checkSort(check, pages.list.sort);\n    }\n    if (pages.list.insights !== undefined) {\n      checkInsights(check, pages.list.insights);\n    }\n  }\n  if (check.record(pages.detail, \"pages.detail\")) {\n    check.closed(pages.detail, [\"backLabel\"], \"pages.detail\");\n    check.copy(pages.detail.backLabel, \"pages.detail.backLabel\");\n  }\n  if (check.record(pages.edit, \"pages.edit\")) {\n    check.closed(pages.edit, [\"title\"], \"pages.edit\");\n    check.copy(pages.edit.title, \"pages.edit.title\");\n  }\n  if (pages.templates !== undefined) {\n    checkTemplatesPage(check, pages.templates);\n  }\n}\n\nfunction checkOverview(check: InterfaceChecker, overview: unknown): void {\n  const path = \"pages.list.overview\";\n  if (!check.record(overview, path)) return;\n  check.closed(overview, [\"label\", \"tiles\"], path);\n  check.copy(overview.label, `${path}.label`);\n\n  const { tiles } = overview;\n  if (!Array.isArray(tiles) || tiles.length === 0) {\n    check.fail(`${path}.tiles`, \"must be a non-empty array\");\n    return;\n  }\n  const seen = new Set<string>();\n  tiles.forEach((tile: unknown, index) => {\n    checkOverviewTile(check, tile, seen, `${path}.tiles[${index}]`);\n  });\n}\n\nfunction checkOverviewTile(\n  check: InterfaceChecker,\n  tile: unknown,\n  seen: Set<string>,\n  path: string,\n): void {\n  if (!check.record(tile, path)) return;\n  check.closed(tile, [\"metric\", \"label\", \"detail\", \"zeroDetail\", \"icon\"], path);\n\n  const { metric, label, detail, zeroDetail, icon } = tile;\n  check.copy(label, `${path}.label`);\n  checkIconSlug(check, icon, `${path}.icon`);\n  if (!isOneOf(metric, OVERVIEW_METRICS)) {\n    check.fail(`${path}.metric`, \"is not a metric this host computes\");\n    check.copy(detail, `${path}.detail`);\n    if (zeroDetail !== undefined) check.copy(zeroDetail, `${path}.zeroDetail`);\n    return;\n  }\n  if (seen.has(metric)) {\n    check.fail(`${path}.metric`, \"repeats a metric\");\n  } else {\n    seen.add(metric);\n  }\n  checkTileCopy(check, detail, metric, `${path}.detail`);\n  if (zeroDetail !== undefined) {\n    checkTileCopy(check, zeroDetail, metric, `${path}.zeroDetail`);\n  }\n}\n\n/**\n * Tile copy may embed `{{name}}` placeholders, but only the names the metric\n * exposes — plain substitution, never an expression.\n */\nfunction checkTileCopy(\n  check: InterfaceChecker,\n  value: unknown,\n  metric: OverviewMetric,\n  path: string,\n): void {\n  if (!check.copy(value, path)) return;\n  const exposed = OVERVIEW_TILE_PLACEHOLDERS[metric];\n  const unknownPlaceholder =\n    exposed.length === 0\n      ? /\\{\\{/\n      : new RegExp(`\\\\{\\\\{(?!(?:${exposed.join(\"|\")})\\\\}\\\\})`);\n  if (unknownPlaceholder.test(value as string)) {\n    check.fail(path, \"uses a placeholder this metric does not expose\");\n  }\n}\n\nfunction checkFilters(check: InterfaceChecker, filters: unknown): void {\n  const path = \"pages.list.filters\";\n  if (!Array.isArray(filters) || filters.length === 0) {\n    check.fail(path, \"must be a non-empty array\");\n    return;\n  }\n  const seen = new Set<string>();\n  filters.forEach((filter: unknown, index) => {\n    checkFilter(check, filter, seen, `${path}[${index}]`);\n  });\n}\n\nfunction checkFilter(\n  check: InterfaceChecker,\n  filter: unknown,\n  seen: Set<string>,\n  path: string,\n): void {\n  if (!check.record(filter, path)) return;\n  check.closed(filter, [\"id\", \"label\", \"options\"], path);\n\n  const { id, label, options } = filter;\n  check.copy(label, `${path}.label`);\n  if (!isOneOf(id, DASHBOARD_FILTER_IDS)) {\n    check.fail(`${path}.id`, \"is not a filter this host implements\");\n    return;\n  }\n  if (seen.has(id)) {\n    check.fail(`${path}.id`, \"repeats a filter\");\n  } else {\n    seen.add(id);\n  }\n  checkFilterOptions(\n    check,\n    options,\n    DASHBOARD_FILTER_VALUES[id],\n    `${path}.options`,\n  );\n}\n\nfunction checkFilterOptions(\n  check: InterfaceChecker,\n  options: unknown,\n  values: readonly string[],\n  path: string,\n): void {\n  if (!Array.isArray(options) || options.length < 2) {\n    check.fail(path, \"must offer at least two options\");\n    return;\n  }\n  const seen = new Set<string>();\n  options.forEach((option: unknown, index) => {\n    const optionPath = `${path}[${index}]`;\n    if (!check.record(option, optionPath)) return;\n    check.closed(option, [\"value\", \"label\"], optionPath);\n\n    const { value, label } = option;\n    if (!isOneOf(value, values)) {\n      check.fail(`${optionPath}.value`, \"is not a value this host implements\");\n    } else if (seen.has(value)) {\n      check.fail(`${optionPath}.value`, \"repeats a value\");\n    } else {\n      seen.add(value);\n    }\n    check.copy(label, `${optionPath}.label`);\n  });\n  // \"all\" is the host's initial selection and what Clear filters resets to,\n  // so a filter that does not offer it could never be neutral.\n  if (!seen.has(\"all\")) {\n    check.fail(path, 'must offer the \"all\" option');\n  }\n}\n\nfunction checkSort(check: InterfaceChecker, sort: unknown): void {\n  const path = \"pages.list.sort\";\n  if (!check.record(sort, path)) return;\n  check.closed(sort, [\"label\", \"options\", \"default\"], path);\n\n  const { label, options, default: defaultValue } = sort;\n  check.copy(label, `${path}.label`);\n  const declared = new Set<string>();\n  if (!Array.isArray(options) || options.length === 0) {\n    check.fail(`${path}.options`, \"must be a non-empty array\");\n  } else {\n    options.forEach((option: unknown, index) => {\n      const optionPath = `${path}.options[${index}]`;\n      if (!check.record(option, optionPath)) return;\n      check.closed(option, [\"value\", \"label\"], optionPath);\n\n      if (!isOneOf(option.value, DASHBOARD_SORT_VALUES)) {\n        check.fail(`${optionPath}.value`, \"is not a sort this host implements\");\n      } else if (declared.has(option.value)) {\n        check.fail(`${optionPath}.value`, \"repeats a value\");\n      } else {\n        declared.add(option.value);\n      }\n      check.copy(option.label, `${optionPath}.label`);\n    });\n  }\n  if (typeof defaultValue !== \"string\" || !declared.has(defaultValue)) {\n    check.fail(`${path}.default`, \"must be one of the declared option values\");\n  }\n}\n\n/** Every insight state and stat the host renders must have a caption. */\nconst INSIGHTS_SHAPE = {\n  health: [\"healthy\", \"failing\", \"running\", \"disabled\", \"neverRun\", \"checking\"],\n  lastRun: [\"label\", \"never\", \"justNow\"],\n  stats: [\"runs\", \"recentSuccess\", \"averageDuration\"],\n} as const;\n\nfunction checkInsights(check: InterfaceChecker, insights: unknown): void {\n  const path = \"pages.list.insights\";\n  if (!check.record(insights, path)) return;\n  check.closed(insights, Object.keys(INSIGHTS_SHAPE), path);\n\n  (Object.keys(INSIGHTS_SHAPE) as (keyof typeof INSIGHTS_SHAPE)[]).forEach(\n    (section) => {\n      const sectionPath = `${path}.${section}`;\n      const value = insights[section];\n      if (!check.record(value, sectionPath)) return;\n      const keys = INSIGHTS_SHAPE[section];\n      check.closed(value, keys, sectionPath);\n      keys.forEach((key) => {\n        check.copy(value[key], `${sectionPath}.${key}`);\n      });\n    },\n  );\n}\n\nfunction checkTemplatesPage(check: InterfaceChecker, templates: unknown): void {\n  const path = \"pages.templates\";\n  if (!check.record(templates, path)) return;\n  check.closed(templates, [\"title\", \"description\"], path);\n  check.copy(templates.title, `${path}.title`);\n  check.copy(templates.description, `${path}.description`);\n}\n\n/**\n * The sub-page surface is declared whole or not at all. Navigation that points\n * at an unrouted page, or a dashboard with filters but no insight captions,\n * would be a partially-trusted mix, and the host refuses those wholesale.\n */\nfunction checkSubPageGroup(check: InterfaceChecker, candidate: Rec): void {\n  const routes = isRecord(candidate.routes) ? candidate.routes : {};\n  const navigation = isRecord(candidate.navigation) ? candidate.navigation : {};\n  const pages = isRecord(candidate.pages) ? candidate.pages : {};\n  const list = isRecord(pages.list) ? pages.list : {};\n\n  const pieces: [string, unknown][] = [\n    [\"routes.templates\", routes.templates],\n    [\"navigation.subPages\", navigation.subPages],\n    [\"pages.templates\", pages.templates],\n    [\"pages.list.overview\", list.overview],\n    [\"pages.list.filters\", list.filters],\n    [\"pages.list.sort\", list.sort],\n    [\"pages.list.insights\", list.insights],\n  ];\n  const missing = pieces\n    .filter(([, value]) => value === undefined)\n    .map(([name]) => name);\n  if (missing.length === 0 || missing.length === pieces.length) return;\n  check.fail(\n    \"interface\",\n    `the sub-page surface must be declared whole; missing ${missing.join(\", \")}`,\n  );\n}\n\nfunction checkAttribute(\n  check: InterfaceChecker,\n  host: { type: InterfaceAttributeType; required: boolean },\n  attribute: unknown,\n  path: string,\n): void {\n  if (!check.record(attribute, path)) return;\n  check.closed(\n    attribute,\n    [\"type\", \"label\", \"help\", \"required\", \"constraints\"],\n    path,\n  );\n\n  const { type, label, help, required, constraints } = attribute;\n  if (type !== host.type) {\n    check.fail(\n      `${path}.type`,\n      `must be \"${host.type}\", the control this host renders`,\n    );\n  }\n  check.copy(label, `${path}.label`);\n  if (help !== undefined) check.copy(help, `${path}.help`);\n  if (required !== host.required) {\n    check.fail(\n      `${path}.required`,\n      `must be ${host.required}, what this host enforces`,\n    );\n  }\n\n  if (constraints !== undefined) {\n    if (host.type !== \"number\") {\n      check.fail(\n        `${path}.constraints`,\n        \"is only allowed on a number attribute\",\n      );\n    } else if (check.record(constraints, `${path}.constraints`)) {\n      check.closed(constraints, [\"min\", \"max\"], `${path}.constraints`);\n      const { min, max } = constraints;\n      // The form validates a positive integer, i.e. an effective minimum of 1;\n      // any other declared minimum would be a promise it does not keep.\n      if (min !== undefined && min !== 1) {\n        check.fail(\n          `${path}.constraints.min`,\n          \"must be the 1 this host enforces\",\n        );\n      }\n      if (\n        max !== undefined &&\n        (!Number.isInteger(max) || (max as number) < 1)\n      ) {\n        check.fail(`${path}.constraints.max`, \"must be a positive integer\");\n      }\n    }\n  }\n}\n\nfunction checkAttributes(check: InterfaceChecker, attributes: unknown): void {\n  if (!check.record(attributes, \"attributes\")) return;\n  const names = Object.keys(attributes);\n  if (names.length === 0) {\n    check.fail(\"attributes\", \"must declare at least one attribute\");\n  }\n  names.forEach((name) => {\n    if (!ATTRIBUTE_NAMES.includes(name)) {\n      check.fail(`attributes.${name}`, \"is not a settable attribute\");\n      return;\n    }\n    checkAttribute(\n      check,\n      HOST_ATTRIBUTES[name as AutomationAttributeName],\n      attributes[name],\n      `attributes.${name}`,\n    );\n  });\n}\n\nfunction checkImportExport(\n  check: InterfaceChecker,\n  importExport: unknown,\n): void {\n  if (!check.record(importExport, \"importExport\")) return;\n  check.closed(\n    importExport,\n    [\"fileKind\", \"fileVersion\", \"filenameSuffix\", \"importDefaults\"],\n    \"importExport\",\n  );\n\n  const { fileKind, fileVersion, filenameSuffix, importDefaults } =\n    importExport;\n  if (typeof fileKind !== \"string\" || !FILE_KIND_PATTERN.test(fileKind)) {\n    check.fail(\"importExport.fileKind\", \"must be a lowercase slug\");\n  }\n  if (fileVersion !== 1) {\n    check.fail(\"importExport.fileVersion\", \"must be 1\");\n  }\n  if (\n    typeof filenameSuffix !== \"string\" ||\n    !FILENAME_SUFFIX_PATTERN.test(filenameSuffix)\n  ) {\n    check.fail(\"importExport.filenameSuffix\", \"must be a .json suffix\");\n  }\n  if (check.record(importDefaults, \"importExport.importDefaults\")) {\n    check.closed(\n      importDefaults,\n      [\"repoProvider\", \"placeholderEventSource\"],\n      \"importExport.importDefaults\",\n    );\n    if (\n      typeof importDefaults.repoProvider !== \"string\" ||\n      !(GIT_PROVIDERS as readonly string[]).includes(\n        importDefaults.repoProvider,\n      )\n    ) {\n      check.fail(\n        \"importExport.importDefaults.repoProvider\",\n        \"is not a supported provider\",\n      );\n    }\n    if (\n      typeof importDefaults.placeholderEventSource !== \"string\" ||\n      !EVENT_SOURCE_PATTERN.test(importDefaults.placeholderEventSource)\n    ) {\n      check.fail(\n        \"importExport.importDefaults.placeholderEventSource\",\n        \"must be a lowercase event source\",\n      );\n    }\n  }\n}\n\nfunction checkEndpoints(check: InterfaceChecker, endpoints: unknown): void {\n  if (!check.record(endpoints, \"endpoints\")) return;\n  const allowed = [...PLAIN_ENDPOINT_NAMES, ...ID_ENDPOINT_NAMES];\n  check.closed(endpoints, allowed, \"endpoints\");\n\n  const endpointAt = (name: string): string | null => {\n    const value = endpoints[name];\n    if (\n      typeof value !== \"string\" ||\n      !ENDPOINT_PATTERN.test(value) ||\n      value.includes(\"//\")\n    ) {\n      check.fail(`endpoints.${name}`, \"must be a rooted service-relative path\");\n      return null;\n    }\n    return value;\n  };\n\n  PLAIN_ENDPOINT_NAMES.forEach((name) => {\n    const value = endpointAt(name);\n    if (value !== null && /[{}]/.test(value)) {\n      check.fail(`endpoints.${name}`, \"must not carry a substitution\");\n    }\n  });\n  ID_ENDPOINT_NAMES.forEach((name) => {\n    const value = endpointAt(name);\n    if (value !== null && !ID_ENDPOINT_PATTERN.test(value)) {\n      check.fail(`endpoints.${name}`, \"must carry exactly one {id}\");\n    }\n  });\n}\n\nfunction checkSlugList(\n  check: InterfaceChecker,\n  value: unknown,\n  path: string,\n): string[] {\n  if (!Array.isArray(value) || value.length === 0) {\n    check.fail(path, \"must be a non-empty array\");\n    return [];\n  }\n  const slugs = value.filter((item): item is string => {\n    if (typeof item === \"string\" && SLUG_PATTERN.test(item)) return true;\n    check.fail(path, \"must contain only lowercase slugs\");\n    return false;\n  });\n  if (new Set(slugs).size !== slugs.length) {\n    check.fail(path, \"must not repeat an id\");\n  }\n  return slugs;\n}\n\nconst TOP_LEVEL_KEYS = [\n  \"version\",\n  \"routes\",\n  \"navigation\",\n  \"pages\",\n  \"docsUrl\",\n  \"attributes\",\n  \"importExport\",\n  \"endpoints\",\n  \"featuredAutomationIds\",\n  \"responderIntegrationIds\",\n];\n\n/**\n * Decide whether this host will act on a published interface manifest.\n *\n * The version is checked first and fails closed: a format this host does not\n * recognise is refused rather than interpreted with today's rules.\n */\nexport function validateInterfaceManifest(\n  candidate: unknown,\n  context: InterfaceValidationContext,\n): InterfaceValidationResult {\n  if (!isRecord(candidate)) {\n    return { valid: false, errors: [\"interface: must be an object\"] };\n  }\n  if (candidate.version !== INTERFACE_VERSION) {\n    return {\n      valid: false,\n      errors: [`interface.version: must be \"${INTERFACE_VERSION}\"`],\n    };\n  }\n\n  const check = new InterfaceChecker();\n  check.closed(candidate, TOP_LEVEL_KEYS, \"interface\");\n\n  checkRoutes(check, candidate.routes, context.mountedRoutes);\n  checkNavigation(check, candidate.navigation);\n  checkPages(check, candidate.pages);\n  if (\n    typeof candidate.docsUrl !== \"string\" ||\n    !candidate.docsUrl.startsWith(DOCS_URL_PREFIX)\n  ) {\n    check.fail(\"docsUrl\", `must start with ${DOCS_URL_PREFIX}`);\n  }\n  checkAttributes(check, candidate.attributes);\n  checkImportExport(check, candidate.importExport);\n  checkEndpoints(check, candidate.endpoints);\n\n  checkSlugList(\n    check,\n    candidate.featuredAutomationIds,\n    \"featuredAutomationIds\",\n  ).forEach((id) => {\n    if (!context.catalogIds.has(id)) {\n      check.fail(\"featuredAutomationIds\", `${id} is not a catalog entry`);\n    }\n  });\n  checkSlugList(\n    check,\n    candidate.responderIntegrationIds,\n    \"responderIntegrationIds\",\n  );\n\n  checkSubPageGroup(check, candidate);\n\n  return { valid: check.errors.length === 0, errors: check.errors };\n}\n"],"mappings":"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"}

package/dist/manifests/manifest-actions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The action bridge — the only channel through which a manifest can make this
+ * host *do* something.
+ *
+ * A manifest is data from another repository, so it never describes a request.
+ * It chooses between the two outcomes this host offers, and it chooses by
+ * declaring a `mode`: a direct entry produces a create request the host derives,
+ * an assisted entry hands setup to a conversation.
+ */
+import type { SetupEntry, SetupFormValues, SetupRequestBody } from "./types";
+export interface SetupActionResult {
+    /** The created resource, or the conversation that will finish setup. */
+    response: Record<string, unknown>;
+}
+export declare function useSetupAction(): (entry: SetupEntry, values: SetupFormValues, payload: SetupRequestBody | null) => Promise<SetupActionResult>;

package/dist/manifests/manifest-capabilities.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Stage 2 — decide whether a deployment can run what a manifest requires.
+ *
+ * The manifest states what it needs — the features under `requires.features`,
+ * and, implicitly, the trigger kinds its form declares. The deployment states
+ * what it supports. Neither side is interpreted here beyond set membership, so
+ * this stays neutral about what any particular capability means.
+ */
+import type { DeploymentCapabilities, SetupEntry } from "./types";
+/**
+ * "unknown" is a real outcome, not an error: a deployment that cannot be asked
+ * must not be treated as one that answered no.
+ */
+export type SetupCapabilitySupport = boolean | "unknown";
+export interface SetupCapabilityAssessment {
+    supported: boolean;
+    /**
+     * Requirement names the deployment did not report, so a block can say which
+     * ones rather than only that there were some. Empty when a deployment that
+     * reports it is not accepting work blocks the entry, because then no single
+     * requirement is the reason.
+     */
+    unmet: string[];
+}
+export declare function assessCapabilityRequirements(entry: SetupEntry, reported: DeploymentCapabilities): SetupCapabilityAssessment;

package/dist/manifests/manifest-error-map.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Translate service-reported errors back to the form field that produced them.
+ *
+ * The host validates and submits the *derived payload*, so errors come back
+ * addressed by payload path (`trigger.schedule`) rather than by form field
+ * (`schedule`). The reverse lookup is derived from the same builder that made
+ * the payload; the mapping is lossy by nature, since one payload value can be
+ * built from several fields.
+ */
+import type { SetupRequestBody } from "./types";
+/** An error the service reported, addressed by payload path where it gave one. */
+export interface ManifestServiceError {
+    path: string;
+    message: string;
+}
+export interface MappedManifestErrors {
+    /** Keyed by form field name. */
+    fieldErrors: Record<string, string>;
+    /** Errors with no field to attach to; shown against the form as a whole. */
+    formErrors: string[];
+}
+/**
+ * Turn a service `loc` array into a path into the payload actually sent.
+ *
+ * A validation framework may address a value through segments that are not keys
+ * of the request body — a discriminated union reports
+ * `["body","trigger","cron","schedule"]` for a body whose trigger has no `cron`
+ * key. Walking the payload and skipping segments that do not resolve reduces
+ * that to `trigger.schedule` without knowing anything about the payload's
+ * meaning.
+ */
+export declare function locToPayloadPath(loc: readonly (string | number)[], payload: unknown): string;
+/**
+ * Read errors out of a service response body, whichever of the two shapes it
+ * uses: a preflight result keyed by field, or a validation failure keyed by
+ * `loc`.
+ */
+export declare function normalizeServiceErrors(body: unknown, payload: SetupRequestBody | null): ManifestServiceError[];
+/** Apply the derived payload-path map, falling back to a form-level error. */
+export declare function mapServiceErrors(errors: readonly ManifestServiceError[], errorMap: Record<string, string[]>): MappedManifestErrors;