@openhands/agent-canvas 1.9.0 → 1.10.0

package/dist/manifests/automation-insights.d.ts

@@ -0,0 +1,64 @@
+/**
+ * The dashboard's automation knowledge, and the only module beside
+ * `automation-setup.ts` that has any.
+ *
+ * The interface manifest's dashboard surface names metrics, filter predicates,
+ * and sort comparators from closed sets; the one implementation of each name
+ * is here, over the automation service's list and runs responses, so the rest
+ * of `src/manifests/` stays about composition rather than about automations.
+ *
+ * Summaries are derived from the newest page of runs (the sample the runs
+ * hook fetches); `total` alone is the response's lifetime count. Success rate
+ * and durations consider only COMPLETED and FAILED runs — a cancelled or
+ * skipped run says nothing about either.
+ */
+import { type Automation, type AutomationRun, type AutomationRunsResponse } from "#/types/automation";
+import type { DashboardSortValue, DashboardStatusValue, DashboardTriggerValue, InterfaceListInsights, OverviewMetric } from "./types";
+export type AutomationHealth = "healthy" | "failing" | "running" | "disabled" | "never-run" | "unknown";
+/** Which caption of the manifest's `insights.health` block names each state. */
+export declare const HEALTH_LABEL_KEYS: Record<AutomationHealth, keyof InterfaceListInsights["health"]>;
+export interface AutomationRunSummary {
+    /** Lifetime run count, from the response — not the sample's length. */
+    total: number;
+    latestRun: AutomationRun | null;
+    /** COMPLETED over COMPLETED+FAILED in the sample. Null with no terminal runs. */
+    recentSuccessRate: number | null;
+    /** Mean completed_at − started_at over the sample's terminal runs. */
+    averageDurationMs: number | null;
+}
+/** One automation's summary alongside its query state. */
+export interface RunSummaryState {
+    summary: AutomationRunSummary | null;
+    isLoading: boolean;
+    isError: boolean;
+}
+type Summaries = ReadonlyMap<string, RunSummaryState>;
+export declare function summarizeAutomationRuns(response: AutomationRunsResponse): AutomationRunSummary;
+/**
+ * A disabled automation is disabled no matter its history; while the summary
+ * is unsettled nothing is claimed; after that the latest run speaks.
+ */
+export declare function deriveAutomationHealth(automation: Automation, state: RunSummaryState | undefined): AutomationHealth;
+/** "—" unknown, seconds under a minute, minutes under an hour, else "1.5h". */
+export declare function formatCompactDuration(ms: number | null): string;
+/** The list page's search predicate: name, prompt, repository, or model. */
+export declare function matchesAutomationSearch(automation: Automation, query: string): boolean;
+export interface DashboardViewState {
+    search: string;
+    status: DashboardStatusValue;
+    trigger: DashboardTriggerValue;
+    sort: DashboardSortValue;
+}
+/** The automations the dashboard shows, filtered and ordered. */
+export declare function applyDashboardView(automations: readonly Automation[], view: DashboardViewState, byId: Summaries): Automation[];
+export interface OverviewTileValue {
+    /** The formatted value the tile displays. */
+    display: string;
+    /** True when the metric's value is zero, which swaps in `zeroDetail`. */
+    isZero: boolean;
+    /** Values the tile's copy may substitute via `{{name}}`. */
+    placeholderValues: Record<string, string | number>;
+}
+/** The value behind one manifest-declared tile. */
+export declare function computeOverviewTile(metric: OverviewMetric, automations: readonly Automation[], byId: Summaries): OverviewTileValue;
+export {};

package/dist/manifests/automation-interface.cjs

@@ -1,2 +1,2 @@
-require("../_virtual/_rolldown/runtime.cjs");const e=require("../node_modules/@openhands/extensions/automations/index.cjs"),t=require("./interface-validation.cjs"),n=require("./manifest-sources.cjs");var r={list:`/automations`,setup:`/automations/new/:automationId`,detail:`/automations/:automationId`},i={list:`/v1`,detail:`/v1/{id}`,dispatch:`/v1/{id}/dispatch`,runs:`/v1/{id}/runs`,tarball:`/v1/{id}/tarball`,health:`/health`,capabilities:`/v1/capabilities`,validate:`/v1/validate`,createPrompt:`/v1/preset/prompt`,createPlugin:`/v1/preset/plugin`},a={fileKind:`automation`,fileVersion:1,filenameSuffix:`.automation.json`,importDefaults:{repoProvider:`github`,placeholderEventSource:`agent-canvas-import`}};function o(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function s(){return new Set(e.default.flatMap(e=>o(e)&&typeof e.id==`string`?[e.id]:[]))}function c(e){if(e===void 0)return null;let n=t.validateInterfaceManifest(e,{catalogIds:s(),mountedRoutes:r});return n.valid?e:(console.warn(`Rejected the automation interface manifest:`,n.errors.join(`; `)),null)}var l=c(n.AUTOMATION_INTERFACE_CANDIDATE);function u(){return(l?.routes??r).list}function d(e){return(l?.endpoints??i)[e]}function f(e,t){return d(e).replace(`{id}`,encodeURIComponent(t))}var p={sidebarLabel:null,commandMenuTitle:null,commandMenuDescription:null,commandMenuKeywords:null,listTitle:null,listSubtitle:null,detailBackLabel:null,editTitle:null};function m(){return l?{sidebarLabel:l.navigation.sidebar.label,commandMenuTitle:l.navigation.commandMenu.title,commandMenuDescription:l.navigation.commandMenu.description,commandMenuKeywords:l.navigation.commandMenu.keywords,listTitle:l.pages.list.title,listSubtitle:l.pages.list.subtitle,detailBackLabel:l.pages.detail.backLabel,editTitle:l.pages.edit.title}:p}function h(){return l?.importExport??a}exports.automationListPath=u,exports.getAutomationEndpoint=d,exports.getAutomationIdEndpoint=f,exports.getImportExportSpec=h,exports.getInterfaceCopy=m;
+require("../_virtual/_rolldown/runtime.cjs");const e=require("../node_modules/@openhands/extensions/automations/index.cjs"),t=require("./interface-validation.cjs"),n=require("./manifest-sources.cjs");var r={list:`/automations`,setup:`/automations/new/:automationId`,detail:`/automations/:automationId`,templates:`/automations/templates`},i={list:`/v1`,detail:`/v1/{id}`,dispatch:`/v1/{id}/dispatch`,runs:`/v1/{id}/runs`,tarball:`/v1/{id}/tarball`,health:`/health`,capabilities:`/v1/capabilities`,validate:`/v1/validate`,createPrompt:`/v1/preset/prompt`,createPlugin:`/v1/preset/plugin`},a={fileKind:`automation`,fileVersion:1,filenameSuffix:`.automation.json`,importDefaults:{repoProvider:`github`,placeholderEventSource:`agent-canvas-import`}};function o(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function s(){return new Set(e.default.flatMap(e=>o(e)&&typeof e.id==`string`?[e.id]:[]))}function c(e){if(e===void 0)return null;let n=t.validateInterfaceManifest(e,{catalogIds:s(),mountedRoutes:r});return n.valid?e:(console.warn(`Rejected the automation interface manifest:`,n.errors.join(`; `)),null)}var l=c(n.AUTOMATION_INTERFACE_CANDIDATE);function u(){return(l?.routes??r).list}function d(e){return(l?.endpoints??i)[e]}function f(e,t){return d(e).replace(`{id}`,encodeURIComponent(t))}var p={sidebarLabel:null,commandMenuTitle:null,commandMenuDescription:null,commandMenuKeywords:null,listTitle:null,listSubtitle:null,detailBackLabel:null,editTitle:null};function m(){return l?{sidebarLabel:l.navigation.sidebar.label,commandMenuTitle:l.navigation.commandMenu.title,commandMenuDescription:l.navigation.commandMenu.description,commandMenuKeywords:l.navigation.commandMenu.keywords,listTitle:l.pages.list.title,listSubtitle:l.pages.list.subtitle,detailBackLabel:l.pages.detail.backLabel,editTitle:l.pages.edit.title}:p}function h(){return l?.importExport??a}exports.automationListPath=u,exports.getAutomationEndpoint=d,exports.getAutomationIdEndpoint=f,exports.getImportExportSpec=h,exports.getInterfaceCopy=m;
 //# sourceMappingURL=automation-interface.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"automation-interface.cjs","names":[],"sources":["../../src/manifests/automation-interface.ts"],"sourcesContent":["/**\n * The automation interface seam.\n *\n * Every automation-specific datum the host's surfaces render — routes,\n * navigation and page copy, the settable attributes, the import/export\n * envelope, endpoint paths, the featured and responder id lists — is served\n * from here.\n * The published interface manifest supplies it when the pinned\n * `@openhands/extensions` ships one and it passes admission; otherwise the\n * host's own defaults do, which reproduce today's behavior exactly. Copy\n * defaults are null, meaning \"render the host's own translation\".\n */\n\nimport { AUTOMATION_CATALOG } from \"@openhands/extensions/automations\";\nimport { AUTOMATION_TIMEOUT_MAX_SECONDS } from \"#/utils/automation-timeout\";\nimport { validateInterfaceManifest } from \"./interface-validation\";\nimport { AUTOMATION_INTERFACE_CANDIDATE } from \"./manifest-sources\";\nimport type {\n  AutomationAttributeName,\n  InterfaceEndpointName,\n  InterfaceImportExport,\n  InterfaceManifest,\n  InterfaceRoutes,\n} from \"./types\";\n\n/** The routes this host has registrations for, in `src/routes.ts`. */\nconst MOUNTED_ROUTES: InterfaceRoutes = {\n  list: \"/automations\",\n  setup: \"/automations/new/:automationId\",\n  detail: \"/automations/:automationId\",\n};\n\nconst DEFAULT_ENDPOINTS: InterfaceManifest[\"endpoints\"] = {\n  list: \"/v1\",\n  detail: \"/v1/{id}\",\n  dispatch: \"/v1/{id}/dispatch\",\n  runs: \"/v1/{id}/runs\",\n  tarball: \"/v1/{id}/tarball\",\n  health: \"/health\",\n  capabilities: \"/v1/capabilities\",\n  validate: \"/v1/validate\",\n  createPrompt: \"/v1/preset/prompt\",\n  createPlugin: \"/v1/preset/plugin\",\n};\n\nconst DEFAULT_IMPORT_EXPORT: InterfaceImportExport = {\n  fileKind: \"automation\",\n  fileVersion: 1,\n  filenameSuffix: \".automation.json\",\n  importDefaults: {\n    repoProvider: \"github\",\n    placeholderEventSource: \"agent-canvas-import\",\n  },\n};\n\nconst DEFAULT_DOCS_URL =\n  \"https://docs.openhands.dev/openhands/usage/automations/overview\";\n\n/**\n * Proven automations featured above the Beta group. NOT derived from\n * popularityRank (slack-standup-digest@94 outranks slack-channel-monitor@92\n * yet is Beta).\n */\nconst DEFAULT_FEATURED_AUTOMATION_IDS: readonly string[] = [\n  \"github-pr-reviewer\",\n  \"github-repo-monitor\",\n  \"slack-channel-monitor\",\n];\n\n/**\n * Integrations whose automations are treated as event responders that poll\n * continuously, and so get the deployment-choice dialog.\n */\nconst DEFAULT_RESPONDER_INTEGRATION_IDS: readonly string[] = [\n  \"github\",\n  \"slack\",\n];\n\nexport interface AttributeSpec {\n  present: boolean;\n  /** Null means \"render the host's own translation\". */\n  label: string | null;\n  help: string | null;\n  required: boolean;\n  min: number | null;\n  max: number | null;\n}\n\nconst ABSENT_ATTRIBUTE: AttributeSpec = {\n  present: false,\n  label: null,\n  help: null,\n  required: false,\n  min: null,\n  max: null,\n};\n\n/** Today's edit dialog, restated as specs so absence of a manifest changes nothing. */\nconst DEFAULT_ATTRIBUTES: Record<AutomationAttributeName, AttributeSpec> = {\n  name: {\n    present: true,\n    label: null,\n    help: null,\n    required: true,\n    min: null,\n    max: null,\n  },\n  prompt: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: null,\n    max: null,\n  },\n  model: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: null,\n    max: null,\n  },\n  timeout: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: 1,\n    max: AUTOMATION_TIMEOUT_MAX_SECONDS,\n  },\n  schedule: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: null,\n    max: null,\n  },\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction getCatalogIds(): ReadonlySet<string> {\n  return new Set(\n    (AUTOMATION_CATALOG as readonly unknown[]).flatMap((entry) =>\n      isRecord(entry) && typeof entry.id === \"string\" ? [entry.id] : [],\n    ),\n  );\n}\n\nfunction admitInterfaceManifest(candidate: unknown): InterfaceManifest | null {\n  if (candidate === undefined) return null;\n\n  const result = validateInterfaceManifest(candidate, {\n    catalogIds: getCatalogIds(),\n    mountedRoutes: MOUNTED_ROUTES,\n  });\n  if (!result.valid) {\n    // Mirrors the setup registry: a rejected manifest is skipped loudly, and\n    // the host's defaults stand.\n    console.warn(\n      \"Rejected the automation interface manifest:\",\n      result.errors.join(\"; \"),\n    );\n    return null;\n  }\n  return candidate as InterfaceManifest;\n}\n\nconst ADMITTED = admitInterfaceManifest(AUTOMATION_INTERFACE_CANDIDATE);\n\nfunction substituteRouteParam(pattern: string, id: string): string {\n  return pattern.replace(\":automationId\", encodeURIComponent(id));\n}\n\nexport function automationListPath(): string {\n  return (ADMITTED?.routes ?? MOUNTED_ROUTES).list;\n}\n\nexport function automationSetupPath(id: string): string {\n  return substituteRouteParam((ADMITTED?.routes ?? MOUNTED_ROUTES).setup, id);\n}\n\nexport function automationDetailPath(id: string): string {\n  return substituteRouteParam((ADMITTED?.routes ?? MOUNTED_ROUTES).detail, id);\n}\n\nexport function getAutomationEndpoint(name: InterfaceEndpointName): string {\n  return (ADMITTED?.endpoints ?? DEFAULT_ENDPOINTS)[name];\n}\n\n/** An id-parameterized endpoint with `{id}` substituted, encoded. */\nexport function getAutomationIdEndpoint(\n  name: \"detail\" | \"dispatch\" | \"runs\" | \"tarball\",\n  id: string,\n): string {\n  return getAutomationEndpoint(name).replace(\"{id}\", encodeURIComponent(id));\n}\n\nexport interface InterfaceCopy {\n  sidebarLabel: string | null;\n  commandMenuTitle: string | null;\n  commandMenuDescription: string | null;\n  commandMenuKeywords: string | null;\n  listTitle: string | null;\n  listSubtitle: string | null;\n  detailBackLabel: string | null;\n  editTitle: string | null;\n}\n\nconst HOST_COPY: InterfaceCopy = {\n  sidebarLabel: null,\n  commandMenuTitle: null,\n  commandMenuDescription: null,\n  commandMenuKeywords: null,\n  listTitle: null,\n  listSubtitle: null,\n  detailBackLabel: null,\n  editTitle: null,\n};\n\nexport function getInterfaceCopy(): InterfaceCopy {\n  if (!ADMITTED) return HOST_COPY;\n  return {\n    sidebarLabel: ADMITTED.navigation.sidebar.label,\n    commandMenuTitle: ADMITTED.navigation.commandMenu.title,\n    commandMenuDescription: ADMITTED.navigation.commandMenu.description,\n    commandMenuKeywords: ADMITTED.navigation.commandMenu.keywords,\n    listTitle: ADMITTED.pages.list.title,\n    listSubtitle: ADMITTED.pages.list.subtitle,\n    detailBackLabel: ADMITTED.pages.detail.backLabel,\n    editTitle: ADMITTED.pages.edit.title,\n  };\n}\n\nexport function getAttributeSpec(name: AutomationAttributeName): AttributeSpec {\n  if (!ADMITTED) return DEFAULT_ATTRIBUTES[name];\n\n  const attribute = ADMITTED.attributes[name];\n  if (!attribute) return ABSENT_ATTRIBUTE;\n  return {\n    present: true,\n    label: attribute.label,\n    help: attribute.help ?? null,\n    required: attribute.required,\n    min: attribute.constraints?.min ?? null,\n    max: attribute.constraints?.max ?? null,\n  };\n}\n\nexport function getImportExportSpec(): InterfaceImportExport {\n  return ADMITTED?.importExport ?? DEFAULT_IMPORT_EXPORT;\n}\n\nexport function getAutomationsDocsUrl(): string {\n  return ADMITTED?.docsUrl ?? DEFAULT_DOCS_URL;\n}\n\nexport function getFeaturedAutomationIds(): readonly string[] {\n  return ADMITTED?.featuredAutomationIds ?? DEFAULT_FEATURED_AUTOMATION_IDS;\n}\n\nexport function getResponderIntegrationIds(): readonly string[] {\n  return ADMITTED?.responderIntegrationIds ?? DEFAULT_RESPONDER_INTEGRATION_IDS;\n}\n"],"mappings":"wMA0BA,IAAM,EAAkC,CACtC,KAAM,eACN,MAAO,iCACP,OAAQ,4BACV,EAEM,EAAoD,CACxD,KAAM,MACN,OAAQ,WACR,SAAU,oBACV,KAAM,gBACN,QAAS,mBACT,OAAQ,UACR,aAAc,mBACd,SAAU,eACV,aAAc,oBACd,aAAc,mBAChB,EAEM,EAA+C,CACnD,SAAU,aACV,YAAa,EACb,eAAgB,mBAChB,eAAgB,CACd,aAAc,SACd,uBAAwB,qBAC1B,CACF,EAwFA,SAAS,EAAS,EAAkD,CAClE,OAAO,OAAO,GAAU,YAAY,GAAkB,CAAC,MAAM,QAAQ,CAAK,CAC5E,CAEA,SAAS,GAAqC,CAC5C,OAAO,IAAI,IACR,EAAA,QAA0C,QAAS,GAClD,EAAS,CAAK,GAAK,OAAO,EAAM,IAAO,SAAW,CAAC,EAAM,EAAE,EAAI,CAAC,CAClE,CACF,CACF,CAEA,SAAS,EAAuB,EAA8C,CAC5E,GAAI,IAAc,IAAA,GAAW,OAAO,KAEpC,IAAM,EAAS,EAAA,0BAA0B,EAAW,CAClD,WAAY,EAAc,EAC1B,cAAe,CACjB,CAAC,EAUD,OATK,EAAO,MASL,GANL,QAAQ,KACN,8CACA,EAAO,OAAO,KAAK,IAAI,CACzB,EACO,KAGX,CAEA,IAAM,EAAW,EAAuB,EAAA,8BAA8B,EAMtE,SAAgB,GAA6B,CAC3C,OAAQ,GAAU,QAAU,GAAgB,IAC9C,CAUA,SAAgB,EAAsB,EAAqC,CACzE,OAAQ,GAAU,WAAa,GAAmB,EACpD,CAGA,SAAgB,EACd,EACA,EACQ,CACR,OAAO,EAAsB,CAAI,EAAE,QAAQ,OAAQ,mBAAmB,CAAE,CAAC,CAC3E,CAaA,IAAM,EAA2B,CAC/B,aAAc,KACd,iBAAkB,KAClB,uBAAwB,KACxB,oBAAqB,KACrB,UAAW,KACX,aAAc,KACd,gBAAiB,KACjB,UAAW,IACb,EAEA,SAAgB,GAAkC,CAEhD,OADK,EACE,CACL,aAAc,EAAS,WAAW,QAAQ,MAC1C,iBAAkB,EAAS,WAAW,YAAY,MAClD,uBAAwB,EAAS,WAAW,YAAY,YACxD,oBAAqB,EAAS,WAAW,YAAY,SACrD,UAAW,EAAS,MAAM,KAAK,MAC/B,aAAc,EAAS,MAAM,KAAK,SAClC,gBAAiB,EAAS,MAAM,OAAO,UACvC,UAAW,EAAS,MAAM,KAAK,KACjC,EAVsB,CAWxB,CAiBA,SAAgB,GAA6C,CAC3D,OAAO,GAAU,cAAgB,CACnC"}
+{"version":3,"file":"automation-interface.cjs","names":[],"sources":["../../src/manifests/automation-interface.ts"],"sourcesContent":["/**\n * The automation interface seam.\n *\n * Every automation-specific datum the host's surfaces render — routes,\n * navigation and page copy, the settable attributes, the import/export\n * envelope, endpoint paths, the featured and responder id lists — is served\n * from here.\n * The published interface manifest supplies it when the pinned\n * `@openhands/extensions` ships one and it passes admission; otherwise the\n * host's own defaults do, which reproduce today's behavior exactly. Copy\n * defaults are null, meaning \"render the host's own translation\".\n *\n * The sub-page surface (navigation, overview tiles, filters, sort, run\n * insights, templates page) is the exception: the host holds no definitions\n * of its own, so its accessors return null until an admitted manifest\n * declares it, and the sub-pages simply do not render.\n */\n\nimport { AUTOMATION_CATALOG } from \"@openhands/extensions/automations\";\nimport { validateInterfaceManifest } from \"./interface-validation\";\nimport { AUTOMATION_INTERFACE_CANDIDATE } from \"./manifest-sources\";\nimport type {\n  AutomationAttributeName,\n  InterfaceDashboardFilter,\n  InterfaceDashboardSort,\n  InterfaceEndpointName,\n  InterfaceIconSlug,\n  InterfaceImportExport,\n  InterfaceListInsights,\n  InterfaceManifest,\n  InterfaceOverview,\n  InterfaceRoutes,\n  InterfaceSubPageId,\n  InterfaceTemplatesPage,\n} from \"./types\";\n\n/** The routes this host has registrations for, in `src/routes.ts`. */\nconst MOUNTED_ROUTES = {\n  list: \"/automations\",\n  setup: \"/automations/new/:automationId\",\n  detail: \"/automations/:automationId\",\n  templates: \"/automations/templates\",\n} satisfies InterfaceRoutes;\n\nconst DEFAULT_ENDPOINTS: InterfaceManifest[\"endpoints\"] = {\n  list: \"/v1\",\n  detail: \"/v1/{id}\",\n  dispatch: \"/v1/{id}/dispatch\",\n  runs: \"/v1/{id}/runs\",\n  tarball: \"/v1/{id}/tarball\",\n  health: \"/health\",\n  capabilities: \"/v1/capabilities\",\n  validate: \"/v1/validate\",\n  createPrompt: \"/v1/preset/prompt\",\n  createPlugin: \"/v1/preset/plugin\",\n};\n\nconst DEFAULT_IMPORT_EXPORT: InterfaceImportExport = {\n  fileKind: \"automation\",\n  fileVersion: 1,\n  filenameSuffix: \".automation.json\",\n  importDefaults: {\n    repoProvider: \"github\",\n    placeholderEventSource: \"agent-canvas-import\",\n  },\n};\n\nconst DEFAULT_DOCS_URL =\n  \"https://docs.openhands.dev/openhands/usage/automations/overview\";\n\n/**\n * Proven automations featured above the Beta group. NOT derived from\n * popularityRank (slack-standup-digest@94 outranks slack-channel-monitor@92\n * yet is Beta).\n */\nconst DEFAULT_FEATURED_AUTOMATION_IDS: readonly string[] = [\n  \"github-pr-reviewer\",\n  \"github-repo-monitor\",\n  \"slack-channel-monitor\",\n];\n\n/**\n * Integrations whose automations are treated as event responders that poll\n * continuously, and so get the deployment-choice dialog.\n */\nconst DEFAULT_RESPONDER_INTEGRATION_IDS: readonly string[] = [\n  \"github\",\n  \"slack\",\n];\n\nexport interface AttributeSpec {\n  present: boolean;\n  /** Null means \"render the host's own translation\". */\n  label: string | null;\n  help: string | null;\n  required: boolean;\n  min: number | null;\n  max: number | null;\n}\n\nconst ABSENT_ATTRIBUTE: AttributeSpec = {\n  present: false,\n  label: null,\n  help: null,\n  required: false,\n  min: null,\n  max: null,\n};\n\n/** Today's edit dialog, restated as specs so absence of a manifest changes nothing. */\nconst DEFAULT_ATTRIBUTES: Record<AutomationAttributeName, AttributeSpec> = {\n  name: {\n    present: true,\n    label: null,\n    help: null,\n    required: true,\n    min: null,\n    max: null,\n  },\n  prompt: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: null,\n    max: null,\n  },\n  model: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: null,\n    max: null,\n  },\n  timeout: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: 1,\n    max: null,\n  },\n  schedule: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: null,\n    max: null,\n  },\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction getCatalogIds(): ReadonlySet<string> {\n  return new Set(\n    (AUTOMATION_CATALOG as readonly unknown[]).flatMap((entry) =>\n      isRecord(entry) && typeof entry.id === \"string\" ? [entry.id] : [],\n    ),\n  );\n}\n\nfunction admitInterfaceManifest(candidate: unknown): InterfaceManifest | null {\n  if (candidate === undefined) return null;\n\n  const result = validateInterfaceManifest(candidate, {\n    catalogIds: getCatalogIds(),\n    mountedRoutes: MOUNTED_ROUTES,\n  });\n  if (!result.valid) {\n    // Mirrors the setup registry: a rejected manifest is skipped loudly, and\n    // the host's defaults stand.\n    console.warn(\n      \"Rejected the automation interface manifest:\",\n      result.errors.join(\"; \"),\n    );\n    return null;\n  }\n  return candidate as InterfaceManifest;\n}\n\nconst ADMITTED = admitInterfaceManifest(AUTOMATION_INTERFACE_CANDIDATE);\n\nfunction substituteRouteParam(pattern: string, id: string): string {\n  return pattern.replace(\":automationId\", encodeURIComponent(id));\n}\n\nexport function automationListPath(): string {\n  return (ADMITTED?.routes ?? MOUNTED_ROUTES).list;\n}\n\nexport function automationSetupPath(id: string): string {\n  return substituteRouteParam((ADMITTED?.routes ?? MOUNTED_ROUTES).setup, id);\n}\n\nexport function automationDetailPath(id: string): string {\n  return substituteRouteParam((ADMITTED?.routes ?? MOUNTED_ROUTES).detail, id);\n}\n\nexport function automationTemplatesPath(): string {\n  return ADMITTED?.routes.templates ?? MOUNTED_ROUTES.templates;\n}\n\nexport function getAutomationEndpoint(name: InterfaceEndpointName): string {\n  return (ADMITTED?.endpoints ?? DEFAULT_ENDPOINTS)[name];\n}\n\n/** An id-parameterized endpoint with `{id}` substituted, encoded. */\nexport function getAutomationIdEndpoint(\n  name: \"detail\" | \"dispatch\" | \"runs\" | \"tarball\",\n  id: string,\n): string {\n  return getAutomationEndpoint(name).replace(\"{id}\", encodeURIComponent(id));\n}\n\nexport interface InterfaceCopy {\n  sidebarLabel: string | null;\n  commandMenuTitle: string | null;\n  commandMenuDescription: string | null;\n  commandMenuKeywords: string | null;\n  listTitle: string | null;\n  listSubtitle: string | null;\n  detailBackLabel: string | null;\n  editTitle: string | null;\n}\n\nconst HOST_COPY: InterfaceCopy = {\n  sidebarLabel: null,\n  commandMenuTitle: null,\n  commandMenuDescription: null,\n  commandMenuKeywords: null,\n  listTitle: null,\n  listSubtitle: null,\n  detailBackLabel: null,\n  editTitle: null,\n};\n\nexport function getInterfaceCopy(): InterfaceCopy {\n  if (!ADMITTED) return HOST_COPY;\n  return {\n    sidebarLabel: ADMITTED.navigation.sidebar.label,\n    commandMenuTitle: ADMITTED.navigation.commandMenu.title,\n    commandMenuDescription: ADMITTED.navigation.commandMenu.description,\n    commandMenuKeywords: ADMITTED.navigation.commandMenu.keywords,\n    listTitle: ADMITTED.pages.list.title,\n    listSubtitle: ADMITTED.pages.list.subtitle,\n    detailBackLabel: ADMITTED.pages.detail.backLabel,\n    editTitle: ADMITTED.pages.edit.title,\n  };\n}\n\nexport function getAttributeSpec(name: AutomationAttributeName): AttributeSpec {\n  if (!ADMITTED) return DEFAULT_ATTRIBUTES[name];\n\n  const attribute = ADMITTED.attributes[name];\n  if (!attribute) return ABSENT_ATTRIBUTE;\n  return {\n    present: true,\n    label: attribute.label,\n    help: attribute.help ?? null,\n    required: attribute.required,\n    min: attribute.constraints?.min ?? null,\n    max: attribute.constraints?.max ?? null,\n  };\n}\n\nexport function getImportExportSpec(): InterfaceImportExport {\n  return ADMITTED?.importExport ?? DEFAULT_IMPORT_EXPORT;\n}\n\nexport function getAutomationsDocsUrl(): string {\n  return ADMITTED?.docsUrl ?? DEFAULT_DOCS_URL;\n}\n\nexport function getFeaturedAutomationIds(): readonly string[] {\n  return ADMITTED?.featuredAutomationIds ?? DEFAULT_FEATURED_AUTOMATION_IDS;\n}\n\nexport function getResponderIntegrationIds(): readonly string[] {\n  return ADMITTED?.responderIntegrationIds ?? DEFAULT_RESPONDER_INTEGRATION_IDS;\n}\n\nexport interface SubPageNavSpec {\n  page: InterfaceSubPageId;\n  /** The page's route, resolved through the manifest. */\n  to: string;\n  label: string;\n  icon: InterfaceIconSlug;\n}\n\n/**\n * The sub-page navigation, or null when the manifest does not declare the\n * sub-page surface. No manifest, no sub-pages — there is no host default.\n */\nexport function getSubPagesSpec(): SubPageNavSpec[] | null {\n  const subPages = ADMITTED?.navigation.subPages;\n  if (!subPages) return null;\n  return subPages.map((item) => ({\n    page: item.page,\n    to:\n      item.page === \"templates\"\n        ? automationTemplatesPath()\n        : automationListPath(),\n    label: item.label,\n    icon: item.icon,\n  }));\n}\n\nexport interface DashboardSpec {\n  overview: InterfaceOverview;\n  filters: InterfaceDashboardFilter[];\n  sort: InterfaceDashboardSort;\n  insights: InterfaceListInsights;\n}\n\n/**\n * The list page's dashboard composition, or null when the manifest does not\n * declare it. Admission accepts the sub-page surface whole or not at all, so\n * these four are present together.\n */\nexport function getDashboardSpec(): DashboardSpec | null {\n  const list = ADMITTED?.pages.list;\n  if (!list?.overview || !list.filters || !list.sort || !list.insights) {\n    return null;\n  }\n  return {\n    overview: list.overview,\n    filters: list.filters,\n    sort: list.sort,\n    insights: list.insights,\n  };\n}\n\n/** The templates page identity, or null when the manifest does not declare it. */\nexport function getTemplatesPageSpec(): InterfaceTemplatesPage | null {\n  return ADMITTED?.pages.templates ?? null;\n}\n"],"mappings":"wMAqCA,IAAM,EAAiB,CACrB,KAAM,eACN,MAAO,iCACP,OAAQ,6BACR,UAAW,wBACb,EAEM,EAAoD,CACxD,KAAM,MACN,OAAQ,WACR,SAAU,oBACV,KAAM,gBACN,QAAS,mBACT,OAAQ,UACR,aAAc,mBACd,SAAU,eACV,aAAc,oBACd,aAAc,mBAChB,EAEM,EAA+C,CACnD,SAAU,aACV,YAAa,EACb,eAAgB,mBAChB,eAAgB,CACd,aAAc,SACd,uBAAwB,qBAC1B,CACF,EAwFA,SAAS,EAAS,EAAkD,CAClE,OAAO,OAAO,GAAU,YAAY,GAAkB,CAAC,MAAM,QAAQ,CAAK,CAC5E,CAEA,SAAS,GAAqC,CAC5C,OAAO,IAAI,IACR,EAAA,QAA0C,QAAS,GAClD,EAAS,CAAK,GAAK,OAAO,EAAM,IAAO,SAAW,CAAC,EAAM,EAAE,EAAI,CAAC,CAClE,CACF,CACF,CAEA,SAAS,EAAuB,EAA8C,CAC5E,GAAI,IAAc,IAAA,GAAW,OAAO,KAEpC,IAAM,EAAS,EAAA,0BAA0B,EAAW,CAClD,WAAY,EAAc,EAC1B,cAAe,CACjB,CAAC,EAUD,OATK,EAAO,MASL,GANL,QAAQ,KACN,8CACA,EAAO,OAAO,KAAK,IAAI,CACzB,EACO,KAGX,CAEA,IAAM,EAAW,EAAuB,EAAA,8BAA8B,EAMtE,SAAgB,GAA6B,CAC3C,OAAQ,GAAU,QAAU,GAAgB,IAC9C,CAcA,SAAgB,EAAsB,EAAqC,CACzE,OAAQ,GAAU,WAAa,GAAmB,EACpD,CAGA,SAAgB,EACd,EACA,EACQ,CACR,OAAO,EAAsB,CAAI,EAAE,QAAQ,OAAQ,mBAAmB,CAAE,CAAC,CAC3E,CAaA,IAAM,EAA2B,CAC/B,aAAc,KACd,iBAAkB,KAClB,uBAAwB,KACxB,oBAAqB,KACrB,UAAW,KACX,aAAc,KACd,gBAAiB,KACjB,UAAW,IACb,EAEA,SAAgB,GAAkC,CAEhD,OADK,EACE,CACL,aAAc,EAAS,WAAW,QAAQ,MAC1C,iBAAkB,EAAS,WAAW,YAAY,MAClD,uBAAwB,EAAS,WAAW,YAAY,YACxD,oBAAqB,EAAS,WAAW,YAAY,SACrD,UAAW,EAAS,MAAM,KAAK,MAC/B,aAAc,EAAS,MAAM,KAAK,SAClC,gBAAiB,EAAS,MAAM,OAAO,UACvC,UAAW,EAAS,MAAM,KAAK,KACjC,EAVsB,CAWxB,CAiBA,SAAgB,GAA6C,CAC3D,OAAO,GAAU,cAAgB,CACnC"}

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

@@ -9,8 +9,13 @@
  * `@openhands/extensions` ships one and it passes admission; otherwise the
  * host's own defaults do, which reproduce today's behavior exactly. Copy
  * defaults are null, meaning "render the host's own translation".
+ *
+ * The sub-page surface (navigation, overview tiles, filters, sort, run
+ * insights, templates page) is the exception: the host holds no definitions
+ * of its own, so its accessors return null until an admitted manifest
+ * declares it, and the sub-pages simply do not render.
  */
-import type { AutomationAttributeName, InterfaceEndpointName, InterfaceImportExport } from "./types";
+import type { AutomationAttributeName, InterfaceDashboardFilter, InterfaceDashboardSort, InterfaceEndpointName, InterfaceIconSlug, InterfaceImportExport, InterfaceListInsights, InterfaceOverview, InterfaceSubPageId, InterfaceTemplatesPage } from "./types";
 export interface AttributeSpec {
     present: boolean;
     /** Null means "render the host's own translation". */
@@ -23,6 +28,7 @@ export interface AttributeSpec {
 export declare function automationListPath(): string;
 export declare function automationSetupPath(id: string): string;
 export declare function automationDetailPath(id: string): string;
+export declare function automationTemplatesPath(): string;
 export declare function getAutomationEndpoint(name: InterfaceEndpointName): string;
 /** An id-parameterized endpoint with `{id}` substituted, encoded. */
 export declare function getAutomationIdEndpoint(name: "detail" | "dispatch" | "runs" | "tarball", id: string): string;
@@ -42,3 +48,29 @@ export declare function getImportExportSpec(): InterfaceImportExport;
 export declare function getAutomationsDocsUrl(): string;
 export declare function getFeaturedAutomationIds(): readonly string[];
 export declare function getResponderIntegrationIds(): readonly string[];
+export interface SubPageNavSpec {
+    page: InterfaceSubPageId;
+    /** The page's route, resolved through the manifest. */
+    to: string;
+    label: string;
+    icon: InterfaceIconSlug;
+}
+/**
+ * The sub-page navigation, or null when the manifest does not declare the
+ * sub-page surface. No manifest, no sub-pages — there is no host default.
+ */
+export declare function getSubPagesSpec(): SubPageNavSpec[] | null;
+export interface DashboardSpec {
+    overview: InterfaceOverview;
+    filters: InterfaceDashboardFilter[];
+    sort: InterfaceDashboardSort;
+    insights: InterfaceListInsights;
+}
+/**
+ * The list page's dashboard composition, or null when the manifest does not
+ * declare it. Admission accepts the sub-page surface whole or not at all, so
+ * these four are present together.
+ */
+export declare function getDashboardSpec(): DashboardSpec | null;
+/** The templates page identity, or null when the manifest does not declare it. */
+export declare function getTemplatesPageSpec(): InterfaceTemplatesPage | null;

package/dist/manifests/automation-interface.js

@@ -5,7 +5,8 @@ import { AUTOMATION_INTERFACE_CANDIDATE as n } from "./manifest-sources.js";
 var r = {
 	list: "/automations",
 	setup: "/automations/new/:automationId",
-	detail: "/automations/:automationId"
+	detail: "/automations/:automationId",
+	templates: "/automations/templates"
 }, i = {
 	list: "/v1",
 	detail: "/v1/{id}",

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

@@ -1 +1 @@
-{"version":3,"file":"automation-interface.js","names":[],"sources":["../../src/manifests/automation-interface.ts"],"sourcesContent":["/**\n * The automation interface seam.\n *\n * Every automation-specific datum the host's surfaces render — routes,\n * navigation and page copy, the settable attributes, the import/export\n * envelope, endpoint paths, the featured and responder id lists — is served\n * from here.\n * The published interface manifest supplies it when the pinned\n * `@openhands/extensions` ships one and it passes admission; otherwise the\n * host's own defaults do, which reproduce today's behavior exactly. Copy\n * defaults are null, meaning \"render the host's own translation\".\n */\n\nimport { AUTOMATION_CATALOG } from \"@openhands/extensions/automations\";\nimport { AUTOMATION_TIMEOUT_MAX_SECONDS } from \"#/utils/automation-timeout\";\nimport { validateInterfaceManifest } from \"./interface-validation\";\nimport { AUTOMATION_INTERFACE_CANDIDATE } from \"./manifest-sources\";\nimport type {\n  AutomationAttributeName,\n  InterfaceEndpointName,\n  InterfaceImportExport,\n  InterfaceManifest,\n  InterfaceRoutes,\n} from \"./types\";\n\n/** The routes this host has registrations for, in `src/routes.ts`. */\nconst MOUNTED_ROUTES: InterfaceRoutes = {\n  list: \"/automations\",\n  setup: \"/automations/new/:automationId\",\n  detail: \"/automations/:automationId\",\n};\n\nconst DEFAULT_ENDPOINTS: InterfaceManifest[\"endpoints\"] = {\n  list: \"/v1\",\n  detail: \"/v1/{id}\",\n  dispatch: \"/v1/{id}/dispatch\",\n  runs: \"/v1/{id}/runs\",\n  tarball: \"/v1/{id}/tarball\",\n  health: \"/health\",\n  capabilities: \"/v1/capabilities\",\n  validate: \"/v1/validate\",\n  createPrompt: \"/v1/preset/prompt\",\n  createPlugin: \"/v1/preset/plugin\",\n};\n\nconst DEFAULT_IMPORT_EXPORT: InterfaceImportExport = {\n  fileKind: \"automation\",\n  fileVersion: 1,\n  filenameSuffix: \".automation.json\",\n  importDefaults: {\n    repoProvider: \"github\",\n    placeholderEventSource: \"agent-canvas-import\",\n  },\n};\n\nconst DEFAULT_DOCS_URL =\n  \"https://docs.openhands.dev/openhands/usage/automations/overview\";\n\n/**\n * Proven automations featured above the Beta group. NOT derived from\n * popularityRank (slack-standup-digest@94 outranks slack-channel-monitor@92\n * yet is Beta).\n */\nconst DEFAULT_FEATURED_AUTOMATION_IDS: readonly string[] = [\n  \"github-pr-reviewer\",\n  \"github-repo-monitor\",\n  \"slack-channel-monitor\",\n];\n\n/**\n * Integrations whose automations are treated as event responders that poll\n * continuously, and so get the deployment-choice dialog.\n */\nconst DEFAULT_RESPONDER_INTEGRATION_IDS: readonly string[] = [\n  \"github\",\n  \"slack\",\n];\n\nexport interface AttributeSpec {\n  present: boolean;\n  /** Null means \"render the host's own translation\". */\n  label: string | null;\n  help: string | null;\n  required: boolean;\n  min: number | null;\n  max: number | null;\n}\n\nconst ABSENT_ATTRIBUTE: AttributeSpec = {\n  present: false,\n  label: null,\n  help: null,\n  required: false,\n  min: null,\n  max: null,\n};\n\n/** Today's edit dialog, restated as specs so absence of a manifest changes nothing. */\nconst DEFAULT_ATTRIBUTES: Record<AutomationAttributeName, AttributeSpec> = {\n  name: {\n    present: true,\n    label: null,\n    help: null,\n    required: true,\n    min: null,\n    max: null,\n  },\n  prompt: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: null,\n    max: null,\n  },\n  model: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: null,\n    max: null,\n  },\n  timeout: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: 1,\n    max: AUTOMATION_TIMEOUT_MAX_SECONDS,\n  },\n  schedule: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: null,\n    max: null,\n  },\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction getCatalogIds(): ReadonlySet<string> {\n  return new Set(\n    (AUTOMATION_CATALOG as readonly unknown[]).flatMap((entry) =>\n      isRecord(entry) && typeof entry.id === \"string\" ? [entry.id] : [],\n    ),\n  );\n}\n\nfunction admitInterfaceManifest(candidate: unknown): InterfaceManifest | null {\n  if (candidate === undefined) return null;\n\n  const result = validateInterfaceManifest(candidate, {\n    catalogIds: getCatalogIds(),\n    mountedRoutes: MOUNTED_ROUTES,\n  });\n  if (!result.valid) {\n    // Mirrors the setup registry: a rejected manifest is skipped loudly, and\n    // the host's defaults stand.\n    console.warn(\n      \"Rejected the automation interface manifest:\",\n      result.errors.join(\"; \"),\n    );\n    return null;\n  }\n  return candidate as InterfaceManifest;\n}\n\nconst ADMITTED = admitInterfaceManifest(AUTOMATION_INTERFACE_CANDIDATE);\n\nfunction substituteRouteParam(pattern: string, id: string): string {\n  return pattern.replace(\":automationId\", encodeURIComponent(id));\n}\n\nexport function automationListPath(): string {\n  return (ADMITTED?.routes ?? MOUNTED_ROUTES).list;\n}\n\nexport function automationSetupPath(id: string): string {\n  return substituteRouteParam((ADMITTED?.routes ?? MOUNTED_ROUTES).setup, id);\n}\n\nexport function automationDetailPath(id: string): string {\n  return substituteRouteParam((ADMITTED?.routes ?? MOUNTED_ROUTES).detail, id);\n}\n\nexport function getAutomationEndpoint(name: InterfaceEndpointName): string {\n  return (ADMITTED?.endpoints ?? DEFAULT_ENDPOINTS)[name];\n}\n\n/** An id-parameterized endpoint with `{id}` substituted, encoded. */\nexport function getAutomationIdEndpoint(\n  name: \"detail\" | \"dispatch\" | \"runs\" | \"tarball\",\n  id: string,\n): string {\n  return getAutomationEndpoint(name).replace(\"{id}\", encodeURIComponent(id));\n}\n\nexport interface InterfaceCopy {\n  sidebarLabel: string | null;\n  commandMenuTitle: string | null;\n  commandMenuDescription: string | null;\n  commandMenuKeywords: string | null;\n  listTitle: string | null;\n  listSubtitle: string | null;\n  detailBackLabel: string | null;\n  editTitle: string | null;\n}\n\nconst HOST_COPY: InterfaceCopy = {\n  sidebarLabel: null,\n  commandMenuTitle: null,\n  commandMenuDescription: null,\n  commandMenuKeywords: null,\n  listTitle: null,\n  listSubtitle: null,\n  detailBackLabel: null,\n  editTitle: null,\n};\n\nexport function getInterfaceCopy(): InterfaceCopy {\n  if (!ADMITTED) return HOST_COPY;\n  return {\n    sidebarLabel: ADMITTED.navigation.sidebar.label,\n    commandMenuTitle: ADMITTED.navigation.commandMenu.title,\n    commandMenuDescription: ADMITTED.navigation.commandMenu.description,\n    commandMenuKeywords: ADMITTED.navigation.commandMenu.keywords,\n    listTitle: ADMITTED.pages.list.title,\n    listSubtitle: ADMITTED.pages.list.subtitle,\n    detailBackLabel: ADMITTED.pages.detail.backLabel,\n    editTitle: ADMITTED.pages.edit.title,\n  };\n}\n\nexport function getAttributeSpec(name: AutomationAttributeName): AttributeSpec {\n  if (!ADMITTED) return DEFAULT_ATTRIBUTES[name];\n\n  const attribute = ADMITTED.attributes[name];\n  if (!attribute) return ABSENT_ATTRIBUTE;\n  return {\n    present: true,\n    label: attribute.label,\n    help: attribute.help ?? null,\n    required: attribute.required,\n    min: attribute.constraints?.min ?? null,\n    max: attribute.constraints?.max ?? null,\n  };\n}\n\nexport function getImportExportSpec(): InterfaceImportExport {\n  return ADMITTED?.importExport ?? DEFAULT_IMPORT_EXPORT;\n}\n\nexport function getAutomationsDocsUrl(): string {\n  return ADMITTED?.docsUrl ?? DEFAULT_DOCS_URL;\n}\n\nexport function getFeaturedAutomationIds(): readonly string[] {\n  return ADMITTED?.featuredAutomationIds ?? DEFAULT_FEATURED_AUTOMATION_IDS;\n}\n\nexport function getResponderIntegrationIds(): readonly string[] {\n  return ADMITTED?.responderIntegrationIds ?? DEFAULT_RESPONDER_INTEGRATION_IDS;\n}\n"],"mappings":";;;;AA0BA,IAAM,IAAkC;CACtC,MAAM;CACN,OAAO;CACP,QAAQ;AACV,GAEM,IAAoD;CACxD,MAAM;CACN,QAAQ;CACR,UAAU;CACV,MAAM;CACN,SAAS;CACT,QAAQ;CACR,cAAc;CACd,UAAU;CACV,cAAc;CACd,cAAc;AAChB,GAEM,IAA+C;CACnD,UAAU;CACV,aAAa;CACb,gBAAgB;CAChB,gBAAgB;EACd,cAAc;EACd,wBAAwB;CAC1B;AACF;AAwFA,SAAS,EAAS,GAAkD;CAClE,OAAO,OAAO,KAAU,cAAY,KAAkB,CAAC,MAAM,QAAQ,CAAK;AAC5E;AAEA,SAAS,IAAqC;CAC5C,OAAO,IAAI,IACR,EAA0C,SAAS,MAClD,EAAS,CAAK,KAAK,OAAO,EAAM,MAAO,WAAW,CAAC,EAAM,EAAE,IAAI,CAAC,CAClE,CACF;AACF;AAEA,SAAS,EAAuB,GAA8C;CAC5E,IAAI,MAAc,KAAA,GAAW,OAAO;CAEpC,IAAM,IAAS,EAA0B,GAAW;EAClD,YAAY,EAAc;EAC1B,eAAe;CACjB,CAAC;CAUD,OATK,EAAO,QASL,KANL,QAAQ,KACN,+CACA,EAAO,OAAO,KAAK,IAAI,CACzB,GACO;AAGX;AAEA,IAAM,IAAW,EAAuB,CAA8B;AAMtE,SAAgB,IAA6B;CAC3C,QAAQ,GAAU,UAAU,GAAgB;AAC9C;AAUA,SAAgB,EAAsB,GAAqC;CACzE,QAAQ,GAAU,aAAa,GAAmB;AACpD;AAGA,SAAgB,EACd,GACA,GACQ;CACR,OAAO,EAAsB,CAAI,EAAE,QAAQ,QAAQ,mBAAmB,CAAE,CAAC;AAC3E;AAaA,IAAM,IAA2B;CAC/B,cAAc;CACd,kBAAkB;CAClB,wBAAwB;CACxB,qBAAqB;CACrB,WAAW;CACX,cAAc;CACd,iBAAiB;CACjB,WAAW;AACb;AAEA,SAAgB,IAAkC;CAEhD,OADK,IACE;EACL,cAAc,EAAS,WAAW,QAAQ;EAC1C,kBAAkB,EAAS,WAAW,YAAY;EAClD,wBAAwB,EAAS,WAAW,YAAY;EACxD,qBAAqB,EAAS,WAAW,YAAY;EACrD,WAAW,EAAS,MAAM,KAAK;EAC/B,cAAc,EAAS,MAAM,KAAK;EAClC,iBAAiB,EAAS,MAAM,OAAO;EACvC,WAAW,EAAS,MAAM,KAAK;CACjC,IAVsB;AAWxB;AAiBA,SAAgB,IAA6C;CAC3D,OAAO,GAAU,gBAAgB;AACnC"}
+{"version":3,"file":"automation-interface.js","names":[],"sources":["../../src/manifests/automation-interface.ts"],"sourcesContent":["/**\n * The automation interface seam.\n *\n * Every automation-specific datum the host's surfaces render — routes,\n * navigation and page copy, the settable attributes, the import/export\n * envelope, endpoint paths, the featured and responder id lists — is served\n * from here.\n * The published interface manifest supplies it when the pinned\n * `@openhands/extensions` ships one and it passes admission; otherwise the\n * host's own defaults do, which reproduce today's behavior exactly. Copy\n * defaults are null, meaning \"render the host's own translation\".\n *\n * The sub-page surface (navigation, overview tiles, filters, sort, run\n * insights, templates page) is the exception: the host holds no definitions\n * of its own, so its accessors return null until an admitted manifest\n * declares it, and the sub-pages simply do not render.\n */\n\nimport { AUTOMATION_CATALOG } from \"@openhands/extensions/automations\";\nimport { validateInterfaceManifest } from \"./interface-validation\";\nimport { AUTOMATION_INTERFACE_CANDIDATE } from \"./manifest-sources\";\nimport type {\n  AutomationAttributeName,\n  InterfaceDashboardFilter,\n  InterfaceDashboardSort,\n  InterfaceEndpointName,\n  InterfaceIconSlug,\n  InterfaceImportExport,\n  InterfaceListInsights,\n  InterfaceManifest,\n  InterfaceOverview,\n  InterfaceRoutes,\n  InterfaceSubPageId,\n  InterfaceTemplatesPage,\n} from \"./types\";\n\n/** The routes this host has registrations for, in `src/routes.ts`. */\nconst MOUNTED_ROUTES = {\n  list: \"/automations\",\n  setup: \"/automations/new/:automationId\",\n  detail: \"/automations/:automationId\",\n  templates: \"/automations/templates\",\n} satisfies InterfaceRoutes;\n\nconst DEFAULT_ENDPOINTS: InterfaceManifest[\"endpoints\"] = {\n  list: \"/v1\",\n  detail: \"/v1/{id}\",\n  dispatch: \"/v1/{id}/dispatch\",\n  runs: \"/v1/{id}/runs\",\n  tarball: \"/v1/{id}/tarball\",\n  health: \"/health\",\n  capabilities: \"/v1/capabilities\",\n  validate: \"/v1/validate\",\n  createPrompt: \"/v1/preset/prompt\",\n  createPlugin: \"/v1/preset/plugin\",\n};\n\nconst DEFAULT_IMPORT_EXPORT: InterfaceImportExport = {\n  fileKind: \"automation\",\n  fileVersion: 1,\n  filenameSuffix: \".automation.json\",\n  importDefaults: {\n    repoProvider: \"github\",\n    placeholderEventSource: \"agent-canvas-import\",\n  },\n};\n\nconst DEFAULT_DOCS_URL =\n  \"https://docs.openhands.dev/openhands/usage/automations/overview\";\n\n/**\n * Proven automations featured above the Beta group. NOT derived from\n * popularityRank (slack-standup-digest@94 outranks slack-channel-monitor@92\n * yet is Beta).\n */\nconst DEFAULT_FEATURED_AUTOMATION_IDS: readonly string[] = [\n  \"github-pr-reviewer\",\n  \"github-repo-monitor\",\n  \"slack-channel-monitor\",\n];\n\n/**\n * Integrations whose automations are treated as event responders that poll\n * continuously, and so get the deployment-choice dialog.\n */\nconst DEFAULT_RESPONDER_INTEGRATION_IDS: readonly string[] = [\n  \"github\",\n  \"slack\",\n];\n\nexport interface AttributeSpec {\n  present: boolean;\n  /** Null means \"render the host's own translation\". */\n  label: string | null;\n  help: string | null;\n  required: boolean;\n  min: number | null;\n  max: number | null;\n}\n\nconst ABSENT_ATTRIBUTE: AttributeSpec = {\n  present: false,\n  label: null,\n  help: null,\n  required: false,\n  min: null,\n  max: null,\n};\n\n/** Today's edit dialog, restated as specs so absence of a manifest changes nothing. */\nconst DEFAULT_ATTRIBUTES: Record<AutomationAttributeName, AttributeSpec> = {\n  name: {\n    present: true,\n    label: null,\n    help: null,\n    required: true,\n    min: null,\n    max: null,\n  },\n  prompt: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: null,\n    max: null,\n  },\n  model: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: null,\n    max: null,\n  },\n  timeout: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: 1,\n    max: null,\n  },\n  schedule: {\n    present: true,\n    label: null,\n    help: null,\n    required: false,\n    min: null,\n    max: null,\n  },\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction getCatalogIds(): ReadonlySet<string> {\n  return new Set(\n    (AUTOMATION_CATALOG as readonly unknown[]).flatMap((entry) =>\n      isRecord(entry) && typeof entry.id === \"string\" ? [entry.id] : [],\n    ),\n  );\n}\n\nfunction admitInterfaceManifest(candidate: unknown): InterfaceManifest | null {\n  if (candidate === undefined) return null;\n\n  const result = validateInterfaceManifest(candidate, {\n    catalogIds: getCatalogIds(),\n    mountedRoutes: MOUNTED_ROUTES,\n  });\n  if (!result.valid) {\n    // Mirrors the setup registry: a rejected manifest is skipped loudly, and\n    // the host's defaults stand.\n    console.warn(\n      \"Rejected the automation interface manifest:\",\n      result.errors.join(\"; \"),\n    );\n    return null;\n  }\n  return candidate as InterfaceManifest;\n}\n\nconst ADMITTED = admitInterfaceManifest(AUTOMATION_INTERFACE_CANDIDATE);\n\nfunction substituteRouteParam(pattern: string, id: string): string {\n  return pattern.replace(\":automationId\", encodeURIComponent(id));\n}\n\nexport function automationListPath(): string {\n  return (ADMITTED?.routes ?? MOUNTED_ROUTES).list;\n}\n\nexport function automationSetupPath(id: string): string {\n  return substituteRouteParam((ADMITTED?.routes ?? MOUNTED_ROUTES).setup, id);\n}\n\nexport function automationDetailPath(id: string): string {\n  return substituteRouteParam((ADMITTED?.routes ?? MOUNTED_ROUTES).detail, id);\n}\n\nexport function automationTemplatesPath(): string {\n  return ADMITTED?.routes.templates ?? MOUNTED_ROUTES.templates;\n}\n\nexport function getAutomationEndpoint(name: InterfaceEndpointName): string {\n  return (ADMITTED?.endpoints ?? DEFAULT_ENDPOINTS)[name];\n}\n\n/** An id-parameterized endpoint with `{id}` substituted, encoded. */\nexport function getAutomationIdEndpoint(\n  name: \"detail\" | \"dispatch\" | \"runs\" | \"tarball\",\n  id: string,\n): string {\n  return getAutomationEndpoint(name).replace(\"{id}\", encodeURIComponent(id));\n}\n\nexport interface InterfaceCopy {\n  sidebarLabel: string | null;\n  commandMenuTitle: string | null;\n  commandMenuDescription: string | null;\n  commandMenuKeywords: string | null;\n  listTitle: string | null;\n  listSubtitle: string | null;\n  detailBackLabel: string | null;\n  editTitle: string | null;\n}\n\nconst HOST_COPY: InterfaceCopy = {\n  sidebarLabel: null,\n  commandMenuTitle: null,\n  commandMenuDescription: null,\n  commandMenuKeywords: null,\n  listTitle: null,\n  listSubtitle: null,\n  detailBackLabel: null,\n  editTitle: null,\n};\n\nexport function getInterfaceCopy(): InterfaceCopy {\n  if (!ADMITTED) return HOST_COPY;\n  return {\n    sidebarLabel: ADMITTED.navigation.sidebar.label,\n    commandMenuTitle: ADMITTED.navigation.commandMenu.title,\n    commandMenuDescription: ADMITTED.navigation.commandMenu.description,\n    commandMenuKeywords: ADMITTED.navigation.commandMenu.keywords,\n    listTitle: ADMITTED.pages.list.title,\n    listSubtitle: ADMITTED.pages.list.subtitle,\n    detailBackLabel: ADMITTED.pages.detail.backLabel,\n    editTitle: ADMITTED.pages.edit.title,\n  };\n}\n\nexport function getAttributeSpec(name: AutomationAttributeName): AttributeSpec {\n  if (!ADMITTED) return DEFAULT_ATTRIBUTES[name];\n\n  const attribute = ADMITTED.attributes[name];\n  if (!attribute) return ABSENT_ATTRIBUTE;\n  return {\n    present: true,\n    label: attribute.label,\n    help: attribute.help ?? null,\n    required: attribute.required,\n    min: attribute.constraints?.min ?? null,\n    max: attribute.constraints?.max ?? null,\n  };\n}\n\nexport function getImportExportSpec(): InterfaceImportExport {\n  return ADMITTED?.importExport ?? DEFAULT_IMPORT_EXPORT;\n}\n\nexport function getAutomationsDocsUrl(): string {\n  return ADMITTED?.docsUrl ?? DEFAULT_DOCS_URL;\n}\n\nexport function getFeaturedAutomationIds(): readonly string[] {\n  return ADMITTED?.featuredAutomationIds ?? DEFAULT_FEATURED_AUTOMATION_IDS;\n}\n\nexport function getResponderIntegrationIds(): readonly string[] {\n  return ADMITTED?.responderIntegrationIds ?? DEFAULT_RESPONDER_INTEGRATION_IDS;\n}\n\nexport interface SubPageNavSpec {\n  page: InterfaceSubPageId;\n  /** The page's route, resolved through the manifest. */\n  to: string;\n  label: string;\n  icon: InterfaceIconSlug;\n}\n\n/**\n * The sub-page navigation, or null when the manifest does not declare the\n * sub-page surface. No manifest, no sub-pages — there is no host default.\n */\nexport function getSubPagesSpec(): SubPageNavSpec[] | null {\n  const subPages = ADMITTED?.navigation.subPages;\n  if (!subPages) return null;\n  return subPages.map((item) => ({\n    page: item.page,\n    to:\n      item.page === \"templates\"\n        ? automationTemplatesPath()\n        : automationListPath(),\n    label: item.label,\n    icon: item.icon,\n  }));\n}\n\nexport interface DashboardSpec {\n  overview: InterfaceOverview;\n  filters: InterfaceDashboardFilter[];\n  sort: InterfaceDashboardSort;\n  insights: InterfaceListInsights;\n}\n\n/**\n * The list page's dashboard composition, or null when the manifest does not\n * declare it. Admission accepts the sub-page surface whole or not at all, so\n * these four are present together.\n */\nexport function getDashboardSpec(): DashboardSpec | null {\n  const list = ADMITTED?.pages.list;\n  if (!list?.overview || !list.filters || !list.sort || !list.insights) {\n    return null;\n  }\n  return {\n    overview: list.overview,\n    filters: list.filters,\n    sort: list.sort,\n    insights: list.insights,\n  };\n}\n\n/** The templates page identity, or null when the manifest does not declare it. */\nexport function getTemplatesPageSpec(): InterfaceTemplatesPage | null {\n  return ADMITTED?.pages.templates ?? null;\n}\n"],"mappings":";;;;AAqCA,IAAM,IAAiB;CACrB,MAAM;CACN,OAAO;CACP,QAAQ;CACR,WAAW;AACb,GAEM,IAAoD;CACxD,MAAM;CACN,QAAQ;CACR,UAAU;CACV,MAAM;CACN,SAAS;CACT,QAAQ;CACR,cAAc;CACd,UAAU;CACV,cAAc;CACd,cAAc;AAChB,GAEM,IAA+C;CACnD,UAAU;CACV,aAAa;CACb,gBAAgB;CAChB,gBAAgB;EACd,cAAc;EACd,wBAAwB;CAC1B;AACF;AAwFA,SAAS,EAAS,GAAkD;CAClE,OAAO,OAAO,KAAU,cAAY,KAAkB,CAAC,MAAM,QAAQ,CAAK;AAC5E;AAEA,SAAS,IAAqC;CAC5C,OAAO,IAAI,IACR,EAA0C,SAAS,MAClD,EAAS,CAAK,KAAK,OAAO,EAAM,MAAO,WAAW,CAAC,EAAM,EAAE,IAAI,CAAC,CAClE,CACF;AACF;AAEA,SAAS,EAAuB,GAA8C;CAC5E,IAAI,MAAc,KAAA,GAAW,OAAO;CAEpC,IAAM,IAAS,EAA0B,GAAW;EAClD,YAAY,EAAc;EAC1B,eAAe;CACjB,CAAC;CAUD,OATK,EAAO,QASL,KANL,QAAQ,KACN,+CACA,EAAO,OAAO,KAAK,IAAI,CACzB,GACO;AAGX;AAEA,IAAM,IAAW,EAAuB,CAA8B;AAMtE,SAAgB,IAA6B;CAC3C,QAAQ,GAAU,UAAU,GAAgB;AAC9C;AAcA,SAAgB,EAAsB,GAAqC;CACzE,QAAQ,GAAU,aAAa,GAAmB;AACpD;AAGA,SAAgB,EACd,GACA,GACQ;CACR,OAAO,EAAsB,CAAI,EAAE,QAAQ,QAAQ,mBAAmB,CAAE,CAAC;AAC3E;AAaA,IAAM,IAA2B;CAC/B,cAAc;CACd,kBAAkB;CAClB,wBAAwB;CACxB,qBAAqB;CACrB,WAAW;CACX,cAAc;CACd,iBAAiB;CACjB,WAAW;AACb;AAEA,SAAgB,IAAkC;CAEhD,OADK,IACE;EACL,cAAc,EAAS,WAAW,QAAQ;EAC1C,kBAAkB,EAAS,WAAW,YAAY;EAClD,wBAAwB,EAAS,WAAW,YAAY;EACxD,qBAAqB,EAAS,WAAW,YAAY;EACrD,WAAW,EAAS,MAAM,KAAK;EAC/B,cAAc,EAAS,MAAM,KAAK;EAClC,iBAAiB,EAAS,MAAM,OAAO;EACvC,WAAW,EAAS,MAAM,KAAK;CACjC,IAVsB;AAWxB;AAiBA,SAAgB,IAA6C;CAC3D,OAAO,GAAU,gBAAgB;AACnC"}

package/dist/manifests/interface-validation.cjs

@@ -1,2 +1,2 @@
-require("../_virtual/_rolldown/runtime.cjs");var e=/<[A-Za-z/!]/,t=/^[a-z0-9]+(-[a-z0-9]+)*$/,n=`https://docs.openhands.dev/`,r=/^[a-z][a-z-]*$/,i=/^\.[a-z][a-z.]*json$/,a=/^[a-z0-9][a-z0-9.-]*$/,o=/^\/[A-Za-z0-9/{}_-]*$/,s=/^[^{}]*\{id\}[^{}]*$/,c=[`github`,`gitlab`,`bitbucket`],l={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}},u=Object.keys(l),d=[`list`,`health`,`capabilities`,`validate`,`createPrompt`,`createPlugin`],f=[`detail`,`dispatch`,`runs`,`tarball`];function p(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}var m=class{errors=[];fail(e,t){return this.errors.push(`${e}: ${t}`),!1}copy(t,n){return typeof t!=`string`||t.length===0?this.fail(n,`must be a non-empty string`):e.test(t)?this.fail(n,`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 p(e)?!0:(this.fail(t,`must be an object`),!1)}};function h(e,t,n){e.record(t,`routes`)&&(e.closed(t,[`list`,`setup`,`detail`],`routes`),[`list`,`setup`,`detail`].forEach(r=>{t[r]!==n[r]&&e.fail(`routes.${r}`,`must be "${n[r]}"`)}))}function g(e,t){if(e.record(t,`navigation`)&&(e.closed(t,[`sidebar`,`commandMenu`],`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`)}}function _(e,t){e.record(t,`pages`)&&(e.closed(t,[`list`,`detail`,`edit`],`pages`),e.record(t.list,`pages.list`)&&(e.closed(t.list,[`title`,`subtitle`],`pages.list`),e.copy(t.list.title,`pages.list.title`),e.copy(t.list.subtitle,`pages.list.subtitle`)),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`)))}function v(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 y(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(!u.includes(n)){e.fail(`attributes.${n}`,`is not a settable attribute`);return}v(e,l[n],t[n],`attributes.${n}`)})}function b(e,t){if(!e.record(t,`importExport`))return;e.closed(t,[`fileKind`,`fileVersion`,`filenameSuffix`,`importDefaults`],`importExport`);let{fileKind:n,fileVersion:o,filenameSuffix:s,importDefaults:l}=t;(typeof n!=`string`||!r.test(n))&&e.fail(`importExport.fileKind`,`must be a lowercase slug`),o!==1&&e.fail(`importExport.fileVersion`,`must be 1`),(typeof s!=`string`||!i.test(s))&&e.fail(`importExport.filenameSuffix`,`must be a .json suffix`),e.record(l,`importExport.importDefaults`)&&(e.closed(l,[`repoProvider`,`placeholderEventSource`],`importExport.importDefaults`),(typeof l.repoProvider!=`string`||!c.includes(l.repoProvider))&&e.fail(`importExport.importDefaults.repoProvider`,`is not a supported provider`),(typeof l.placeholderEventSource!=`string`||!a.test(l.placeholderEventSource))&&e.fail(`importExport.importDefaults.placeholderEventSource`,`must be a lowercase event source`))}function x(e,t){if(!e.record(t,`endpoints`))return;let n=[...d,...f];e.closed(t,n,`endpoints`);let r=n=>{let r=t[n];return typeof r!=`string`||!o.test(r)||r.includes(`//`)?(e.fail(`endpoints.${n}`,`must be a rooted service-relative path`),null):r};d.forEach(t=>{let n=r(t);n!==null&&/[{}]/.test(n)&&e.fail(`endpoints.${t}`,`must not carry a substitution`)}),f.forEach(t=>{let n=r(t);n!==null&&!s.test(n)&&e.fail(`endpoints.${t}`,`must carry exactly one {id}`)})}function S(e,n,r){if(!Array.isArray(n)||n.length===0)return e.fail(r,`must be a non-empty array`),[];let i=n.filter(n=>typeof n==`string`&&t.test(n)?!0:(e.fail(r,`must contain only lowercase slugs`),!1));return new Set(i).size!==i.length&&e.fail(r,`must not repeat an id`),i}var C=[`version`,`routes`,`navigation`,`pages`,`docsUrl`,`attributes`,`importExport`,`endpoints`,`featuredAutomationIds`,`responderIntegrationIds`];function w(e,t){if(!p(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 r=new m;return r.closed(e,C,`interface`),h(r,e.routes,t.mountedRoutes),g(r,e.navigation),_(r,e.pages),(typeof e.docsUrl!=`string`||!e.docsUrl.startsWith(n))&&r.fail(`docsUrl`,`must start with ${n}`),y(r,e.attributes),b(r,e.importExport),x(r,e.endpoints),S(r,e.featuredAutomationIds,`featuredAutomationIds`).forEach(e=>{t.catalogIds.has(e)||r.fail(`featuredAutomationIds`,`${e} is not a catalog entry`)}),S(r,e.responderIntegrationIds,`responderIntegrationIds`),{valid:r.errors.length===0,errors:r.errors}}exports.validateInterfaceManifest=w;
+require("../_virtual/_rolldown/runtime.cjs");const e=require("./types.cjs");var t=/<[A-Za-z/!]/,n=/^[a-z0-9]+(-[a-z0-9]+)*$/,r=`https://docs.openhands.dev/`,i=/^[a-z][a-z-]*$/,a=/^\.[a-z][a-z.]*json$/,o=/^[a-z0-9][a-z0-9.-]*$/,s=/^\/[A-Za-z0-9/{}_-]*$/,c=/^[^{}]*\{id\}[^{}]*$/,l=[`github`,`gitlab`,`bitbucket`],u={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}},d=Object.keys(u),f=[`list`,`health`,`capabilities`,`validate`,`createPrompt`,`createPlugin`],p=[`detail`,`dispatch`,`runs`,`tarball`];function m(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function h(e,t){return typeof e==`string`&&t.includes(e)}var g=class{errors=[];fail(e,t){return this.errors.push(`${e}: ${t}`),!1}copy(e,n){return typeof e!=`string`||e.length===0?this.fail(n,`must be a non-empty string`):t.test(e)?this.fail(n,`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 m(e)?!0:(this.fail(t,`must be an object`),!1)}};function _(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 v(t,n){if(!Array.isArray(n)||n.length===0){t.fail(`navigation.subPages`,`must be a non-empty array`);return}let r=new Set;n.forEach((n,i)=>{let a=`navigation.subPages[${i}]`;if(!t.record(n,a))return;t.closed(n,[`page`,`label`,`icon`],a);let{page:o,label:s,icon:c}=n;h(o,e.INTERFACE_SUB_PAGE_IDS)?r.has(o)?t.fail(`${a}.page`,`repeats a page`):r.add(o):t.fail(`${a}.page`,`is not a sub-page this host serves`),t.copy(s,`${a}.label`),y(t,c,`${a}.icon`)})}function y(t,n,r){h(n,e.INTERFACE_ICON_SLUGS)||t.fail(r,`is not an icon this host ships`)}function b(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&&v(e,t.subPages)}}function x(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&&S(e,t.list.overview),t.list.filters!==void 0&&T(e,t.list.filters),t.list.sort!==void 0&&O(e,t.list.sort),t.list.insights!==void 0&&A(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&&j(e,t.templates))}function S(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=new Set;r.forEach((t,r)=>{C(e,t,i,`${n}.tiles[${r}]`)})}function C(t,n,r,i){if(!t.record(n,i))return;t.closed(n,[`metric`,`label`,`detail`,`zeroDetail`,`icon`],i);let{metric:a,label:o,detail:s,zeroDetail:c,icon:l}=n;if(t.copy(o,`${i}.label`),y(t,l,`${i}.icon`),!h(a,e.OVERVIEW_METRICS)){t.fail(`${i}.metric`,`is not a metric this host computes`),t.copy(s,`${i}.detail`),c!==void 0&&t.copy(c,`${i}.zeroDetail`);return}r.has(a)?t.fail(`${i}.metric`,`repeats a metric`):r.add(a),w(t,s,a,`${i}.detail`),c!==void 0&&w(t,c,a,`${i}.zeroDetail`)}function w(t,n,r,i){if(!t.copy(n,i))return;let a=e.OVERVIEW_TILE_PLACEHOLDERS[r];(a.length===0?/\{\{/:RegExp(`\\{\\{(?!(?:${a.join(`|`)})\\}\\})`)).test(n)&&t.fail(i,`uses a placeholder this metric does not expose`)}function T(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=new Set;t.forEach((t,i)=>{E(e,t,r,`${n}[${i}]`)})}function E(t,n,r,i){if(!t.record(n,i))return;t.closed(n,[`id`,`label`,`options`],i);let{id:a,label:o,options:s}=n;if(t.copy(o,`${i}.label`),!h(a,e.DASHBOARD_FILTER_IDS)){t.fail(`${i}.id`,`is not a filter this host implements`);return}r.has(a)?t.fail(`${i}.id`,`repeats a filter`):r.add(a),D(t,s,e.DASHBOARD_FILTER_VALUES[a],`${i}.options`)}function D(e,t,n,r){if(!Array.isArray(t)||t.length<2){e.fail(r,`must offer at least two options`);return}let i=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;h(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 O(t,n){let r=`pages.list.sort`;if(!t.record(n,r))return;t.closed(n,[`label`,`options`,`default`],r);let{label:i,options:a,default:o}=n;t.copy(i,`${r}.label`);let s=new Set;!Array.isArray(a)||a.length===0?t.fail(`${r}.options`,`must be a non-empty array`):a.forEach((n,i)=>{let a=`${r}.options[${i}]`;t.record(n,a)&&(t.closed(n,[`value`,`label`],a),h(n.value,e.DASHBOARD_SORT_VALUES)?s.has(n.value)?t.fail(`${a}.value`,`repeats a value`):s.add(n.value):t.fail(`${a}.value`,`is not a sort this host implements`),t.copy(n.label,`${a}.label`))}),(typeof o!=`string`||!s.has(o))&&t.fail(`${r}.default`,`must be one of the declared option values`)}var k={health:[`healthy`,`failing`,`running`,`disabled`,`neverRun`,`checking`],lastRun:[`label`,`never`,`justNow`],stats:[`runs`,`recentSuccess`,`averageDuration`]};function A(e,t){let n=`pages.list.insights`;e.record(t,n)&&(e.closed(t,Object.keys(k),n),Object.keys(k).forEach(r=>{let i=`${n}.${r}`,a=t[r];if(!e.record(a,i))return;let o=k[r];e.closed(a,o,i),o.forEach(t=>{e.copy(a[t],`${i}.${t}`)})}))}function j(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 M(e,t){let n=m(t.routes)?t.routes:{},r=m(t.navigation)?t.navigation:{},i=m(t.pages)?t.pages:{},a=m(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 N(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 P(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(!d.includes(n)){e.fail(`attributes.${n}`,`is not a settable attribute`);return}N(e,u[n],t[n],`attributes.${n}`)})}function F(e,t){if(!e.record(t,`importExport`))return;e.closed(t,[`fileKind`,`fileVersion`,`filenameSuffix`,`importDefaults`],`importExport`);let{fileKind:n,fileVersion:r,filenameSuffix:s,importDefaults:c}=t;(typeof n!=`string`||!i.test(n))&&e.fail(`importExport.fileKind`,`must be a lowercase slug`),r!==1&&e.fail(`importExport.fileVersion`,`must be 1`),(typeof s!=`string`||!a.test(s))&&e.fail(`importExport.filenameSuffix`,`must be a .json suffix`),e.record(c,`importExport.importDefaults`)&&(e.closed(c,[`repoProvider`,`placeholderEventSource`],`importExport.importDefaults`),(typeof c.repoProvider!=`string`||!l.includes(c.repoProvider))&&e.fail(`importExport.importDefaults.repoProvider`,`is not a supported provider`),(typeof c.placeholderEventSource!=`string`||!o.test(c.placeholderEventSource))&&e.fail(`importExport.importDefaults.placeholderEventSource`,`must be a lowercase event source`))}function I(e,t){if(!e.record(t,`endpoints`))return;let n=[...f,...p];e.closed(t,n,`endpoints`);let r=n=>{let r=t[n];return typeof r!=`string`||!s.test(r)||r.includes(`//`)?(e.fail(`endpoints.${n}`,`must be a rooted service-relative path`),null):r};f.forEach(t=>{let n=r(t);n!==null&&/[{}]/.test(n)&&e.fail(`endpoints.${t}`,`must not carry a substitution`)}),p.forEach(t=>{let n=r(t);n!==null&&!c.test(n)&&e.fail(`endpoints.${t}`,`must carry exactly one {id}`)})}function L(e,t,r){if(!Array.isArray(t)||t.length===0)return e.fail(r,`must be a non-empty array`),[];let i=t.filter(t=>typeof t==`string`&&n.test(t)?!0:(e.fail(r,`must contain only lowercase slugs`),!1));return new Set(i).size!==i.length&&e.fail(r,`must not repeat an id`),i}var R=[`version`,`routes`,`navigation`,`pages`,`docsUrl`,`attributes`,`importExport`,`endpoints`,`featuredAutomationIds`,`responderIntegrationIds`];function z(e,t){if(!m(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 g;return n.closed(e,R,`interface`),_(n,e.routes,t.mountedRoutes),b(n,e.navigation),x(n,e.pages),(typeof e.docsUrl!=`string`||!e.docsUrl.startsWith(r))&&n.fail(`docsUrl`,`must start with ${r}`),P(n,e.attributes),F(n,e.importExport),I(n,e.endpoints),L(n,e.featuredAutomationIds,`featuredAutomationIds`).forEach(e=>{t.catalogIds.has(e)||n.fail(`featuredAutomationIds`,`${e} is not a catalog entry`)}),L(n,e.responderIntegrationIds,`responderIntegrationIds`),M(n,e),{valid:n.errors.length===0,errors:n.errors}}exports.validateInterfaceManifest=z;
 //# sourceMappingURL=interface-validation.cjs.map

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

@@ -1 +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} from \"./types\";\nimport { INTERFACE_VERSION } 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\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\"], \"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}\n\nfunction checkNavigation(check: InterfaceChecker, navigation: unknown): void {\n  if (!check.record(navigation, \"navigation\")) return;\n  check.closed(navigation, [\"sidebar\", \"commandMenu\"], \"navigation\");\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}\n\nfunction checkPages(check: InterfaceChecker, pages: unknown): void {\n  if (!check.record(pages, \"pages\")) return;\n  check.closed(pages, [\"list\", \"detail\", \"edit\"], \"pages\");\n\n  if (check.record(pages.list, \"pages.list\")) {\n    check.closed(pages.list, [\"title\", \"subtitle\"], \"pages.list\");\n    check.copy(pages.list.title, \"pages.list.title\");\n    check.copy(pages.list.subtitle, \"pages.list.subtitle\");\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}\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  return { valid: check.errors.length === 0, errors: check.errors };\n}\n"],"mappings":"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"}
+{"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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"}