@openhands/agent-canvas 1.15.0 → 1.17.0

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

@@ -1 +1 @@
-{"version":3,"file":"automation-insights.js","names":[],"sources":["../../src/manifests/automation-insights.ts"],"sourcesContent":["/**\n * The dashboard's automation knowledge, and the only module beside\n * `automation-setup.ts` that has any.\n *\n * The interface manifest's dashboard surface names metrics, filter predicates,\n * and sort comparators from closed sets; the one implementation of each name\n * is here, over the automation service's list and runs responses, so the rest\n * of `src/manifests/` stays about composition rather than about automations.\n *\n * Summaries are derived from the newest page of runs (the sample the runs\n * hook fetches); `total` alone is the response's lifetime count. Success rate\n * and durations consider only COMPLETED and FAILED runs — a cancelled or\n * skipped run says nothing about either.\n */\n\nimport {\n  AutomationRunStatus,\n  type Automation,\n  type AutomationRun,\n  type AutomationRunsResponse,\n} from \"#/types/automation\";\nimport type {\n  DashboardSortValue,\n  DashboardStatusValue,\n  DashboardTriggerValue,\n  InterfaceListInsights,\n  OverviewMetric,\n} from \"./types\";\n\nexport type AutomationHealth =\n  | \"healthy\"\n  | \"failing\"\n  | \"running\"\n  | \"disabled\"\n  | \"never-run\"\n  | \"unknown\";\n\n/** Which caption of the manifest's `insights.health` block names each state. */\nexport const HEALTH_LABEL_KEYS: Record<\n  AutomationHealth,\n  keyof InterfaceListInsights[\"health\"]\n> = {\n  healthy: \"healthy\",\n  failing: \"failing\",\n  running: \"running\",\n  disabled: \"disabled\",\n  \"never-run\": \"neverRun\",\n  unknown: \"checking\",\n};\n\nexport interface AutomationRunSummary {\n  /** Lifetime run count, from the response — not the sample's length. */\n  total: number;\n  latestRun: AutomationRun | null;\n  /** Newest-first sample used by the list sparkline (same page as the summary). */\n  recentRuns: AutomationRun[];\n  /** COMPLETED over COMPLETED+FAILED in the sample. Null with no terminal runs. */\n  recentSuccessRate: number | null;\n  /** Mean completed_at − started_at over the sample's terminal runs. */\n  averageDurationMs: number | null;\n}\n\n/** One automation's summary alongside its query state. */\nexport interface RunSummaryState {\n  summary: AutomationRunSummary | null;\n  isLoading: boolean;\n  isError: boolean;\n}\n\ntype Summaries = ReadonlyMap<string, RunSummaryState>;\n\nconst TERMINAL_STATUSES = new Set<AutomationRunStatus>([\n  AutomationRunStatus.COMPLETED,\n  AutomationRunStatus.FAILED,\n]);\n\nexport function summarizeAutomationRuns(\n  response: AutomationRunsResponse,\n): AutomationRunSummary {\n  const terminal = response.runs.filter((run) =>\n    TERMINAL_STATUSES.has(run.status),\n  );\n  const completed = terminal.filter(\n    (run) => run.status === AutomationRunStatus.COMPLETED,\n  ).length;\n\n  const durations = terminal.flatMap((run) => {\n    if (!run.completed_at) return [];\n    const ms =\n      new Date(run.completed_at).getTime() - new Date(run.started_at).getTime();\n    return Number.isFinite(ms) && ms >= 0 ? [ms] : [];\n  });\n\n  return {\n    total: response.total,\n    latestRun: response.runs[0] ?? null,\n    recentRuns: response.runs,\n    recentSuccessRate:\n      terminal.length === 0 ? null : completed / terminal.length,\n    averageDurationMs:\n      durations.length === 0\n        ? null\n        : durations.reduce((sum, ms) => sum + ms, 0) / durations.length,\n  };\n}\n\n/**\n * A disabled automation is disabled no matter its history; while the summary\n * is unsettled nothing is claimed; after that the latest run speaks.\n */\nexport function deriveAutomationHealth(\n  automation: Automation,\n  state: RunSummaryState | undefined,\n): AutomationHealth {\n  if (!automation.enabled) return \"disabled\";\n  if (!state || state.isError || state.isLoading || !state.summary) {\n    return \"unknown\";\n  }\n  const latest = state.summary.latestRun;\n  if (!latest) return \"never-run\";\n  if (latest.status === AutomationRunStatus.FAILED) return \"failing\";\n  if (\n    latest.status === AutomationRunStatus.PENDING ||\n    latest.status === AutomationRunStatus.RUNNING\n  ) {\n    return \"running\";\n  }\n  return \"healthy\";\n}\n\n/** \"—\" unknown, seconds under a minute, minutes under an hour, else \"1.5h\". */\nexport function formatCompactDuration(ms: number | null): string {\n  if (ms === null || !Number.isFinite(ms)) return \"—\";\n  if (ms < 60_000) return `${Math.max(1, Math.round(ms / 1000))}s`;\n  if (ms < 3_600_000) return `${Math.max(1, Math.round(ms / 60_000))}m`;\n  return `${(ms / 3_600_000).toFixed(1)}h`;\n}\n\n/** The list page's search predicate: name, prompt, repository, or model. */\nexport function matchesAutomationSearch(\n  automation: Automation,\n  query: string,\n): boolean {\n  const q = query.toLowerCase();\n  if (!q) return true;\n  return (\n    automation.name.toLowerCase().includes(q) ||\n    (automation.prompt ?? \"\").toLowerCase().includes(q) ||\n    automation.repository?.toLowerCase().includes(q) === true ||\n    automation.model?.toLowerCase().includes(q) === true\n  );\n}\n\nconst STATUS_PREDICATES: Record<\n  Exclude<DashboardStatusValue, \"all\">,\n  (automation: Automation, health: AutomationHealth) => boolean\n> = {\n  active: (automation) => automation.enabled,\n  failing: (_automation, health) => health === \"failing\",\n  disabled: (automation) => !automation.enabled,\n};\n\nconst TRIGGER_PREDICATES: Record<\n  Exclude<DashboardTriggerValue, \"all\">,\n  (automation: Automation) => boolean\n> = {\n  // The backend emits several scheduled-trigger aliases, so \"event\" is the\n  // one exact kind and everything else is a schedule.\n  event: (automation) => automation.trigger.type === \"event\",\n  schedule: (automation) => automation.trigger.type !== \"event\",\n};\n\nfunction runCount(automation: Automation, byId: Summaries): number {\n  return byId.get(automation.id)?.summary?.total ?? 0;\n}\n\nfunction lastRunTime(automation: Automation, byId: Summaries): number {\n  const startedAt =\n    byId.get(automation.id)?.summary?.latestRun?.started_at ??\n    automation.last_triggered_at;\n  if (!startedAt) return 0;\n  const time = new Date(startedAt).getTime();\n  return Number.isFinite(time) ? time : 0;\n}\n\nconst SORT_COMPARATORS: Record<\n  DashboardSortValue,\n  (a: Automation, b: Automation, byId: Summaries) => number\n> = {\n  \"last-run\": (a, b, byId) => lastRunTime(b, byId) - lastRunTime(a, byId),\n  runs: (a, b, byId) => runCount(b, byId) - runCount(a, byId),\n  name: (a, b) => a.name.localeCompare(b.name),\n};\n\nexport interface DashboardViewState {\n  search: string;\n  status: DashboardStatusValue;\n  trigger: DashboardTriggerValue;\n  sort: DashboardSortValue;\n}\n\n/** The automations the dashboard shows, filtered and ordered. */\nexport function applyDashboardView(\n  automations: readonly Automation[],\n  view: DashboardViewState,\n  byId: Summaries,\n): Automation[] {\n  return automations\n    .filter((automation) => {\n      if (!matchesAutomationSearch(automation, view.search)) return false;\n      if (\n        view.status !== \"all\" &&\n        !STATUS_PREDICATES[view.status](\n          automation,\n          deriveAutomationHealth(automation, byId.get(automation.id)),\n        )\n      ) {\n        return false;\n      }\n      if (\n        view.trigger !== \"all\" &&\n        !TRIGGER_PREDICATES[view.trigger](automation)\n      ) {\n        return false;\n      }\n      return true;\n    })\n    .sort((a, b) => SORT_COMPARATORS[view.sort](a, b, byId));\n}\n\nexport interface OverviewTileValue {\n  /** The formatted value the tile displays. */\n  display: string;\n  /** True when the metric's value is zero, which swaps in `zeroDetail`. */\n  isZero: boolean;\n  /** Values the tile's copy may substitute via `{{name}}`. */\n  placeholderValues: Record<string, string | number>;\n}\n\nfunction loadedSummaries(\n  automations: readonly Automation[],\n  byId: Summaries,\n): AutomationRunSummary[] {\n  return automations.flatMap((automation) => {\n    const state = byId.get(automation.id);\n    return state?.summary && !state.isLoading && !state.isError\n      ? [state.summary]\n      : [];\n  });\n}\n\nconst TILE_COMPUTATIONS: Record<\n  OverviewMetric,\n  (automations: readonly Automation[], byId: Summaries) => OverviewTileValue\n> = {\n  automations: (automations) => ({\n    display: automations.length.toLocaleString(),\n    isZero: automations.length === 0,\n    placeholderValues: {\n      active: automations.filter((automation) => automation.enabled).length,\n    },\n  }),\n  \"needs-attention\": (automations, byId) => {\n    const failing = automations.filter(\n      (automation) =>\n        deriveAutomationHealth(automation, byId.get(automation.id)) ===\n        \"failing\",\n    ).length;\n    return {\n      display: failing.toLocaleString(),\n      isZero: failing === 0,\n      placeholderValues: {},\n    };\n  },\n  \"total-runs\": (automations, byId) => {\n    const loaded = loadedSummaries(automations, byId);\n    if (loaded.length === 0 && automations.length > 0) {\n      return { display: \"—\", isZero: false, placeholderValues: {} };\n    }\n    const total = loaded.reduce((sum, summary) => sum + summary.total, 0);\n    return {\n      display: total.toLocaleString(),\n      isZero: total === 0,\n      placeholderValues: {},\n    };\n  },\n  \"average-duration\": (automations, byId) => {\n    const durations = loadedSummaries(automations, byId).flatMap((summary) =>\n      summary.averageDurationMs === null ? [] : [summary.averageDurationMs],\n    );\n    const mean =\n      durations.length === 0\n        ? null\n        : durations.reduce((sum, ms) => sum + ms, 0) / durations.length;\n    return {\n      display: formatCompactDuration(mean),\n      isZero: false,\n      placeholderValues: {},\n    };\n  },\n};\n\n/** The value behind one manifest-declared tile. */\nexport function computeOverviewTile(\n  metric: OverviewMetric,\n  automations: readonly Automation[],\n  byId: Summaries,\n): OverviewTileValue {\n  return TILE_COMPUTATIONS[metric](automations, byId);\n}\n"],"mappings":";AAuE0B,IAAI,IAAyB,CACrD,EAAoB,WACpB,EAAoB,MACtB,CAAC;AAyDD,SAAgB,EAAsB,GAA2B;CAI/D,OAHI,MAAO,QAAQ,CAAC,OAAO,SAAS,CAAE,IAAU,MAC5C,IAAK,MAAe,GAAG,KAAK,IAAI,GAAG,KAAK,MAAM,IAAK,GAAI,CAAC,EAAE,KAC1D,IAAK,OAAkB,GAAG,KAAK,IAAI,GAAG,KAAK,MAAM,IAAK,GAAM,CAAC,EAAE,KAC5D,IAAI,IAAK,MAAW,QAAQ,CAAC,EAAE;AACxC"}
+{"version":3,"file":"automation-insights.js","names":[],"sources":["../../src/manifests/automation-insights.ts"],"sourcesContent":["/**\n * The dashboard's automation knowledge, and the only module beside\n * `automation-setup.ts` that has any.\n *\n * The interface manifest's dashboard surface names metrics, filter predicates,\n * and sort comparators from closed sets; the one implementation of each name\n * is here, over the automation service's list and runs responses, so the rest\n * of `src/manifests/` stays about composition rather than about automations.\n *\n * Summaries are derived from the newest page of runs (the sample the runs\n * hook fetches); `total` alone is the response's lifetime count. Success rate\n * and durations consider only terminal lifecycle runs; the success numerator\n * uses task-aware display status so completed-but-blocked work is not counted\n * as successful.\n */\n\nimport {\n  AutomationRunStatus,\n  type Automation,\n  type AutomationRun,\n  type AutomationRunsResponse,\n} from \"#/types/automation\";\nimport { getAutomationRunDisplay } from \"#/utils/automation-run-display\";\nimport type {\n  DashboardSortValue,\n  DashboardStatusValue,\n  DashboardTriggerValue,\n  InterfaceListInsights,\n  OverviewMetric,\n} from \"./types\";\n\nexport type AutomationHealth =\n  | \"healthy\"\n  | \"failing\"\n  | \"running\"\n  | \"disabled\"\n  | \"never-run\"\n  | \"unknown\";\n\n/** Which caption of the manifest's `insights.health` block names each state. */\nexport const HEALTH_LABEL_KEYS: Record<\n  AutomationHealth,\n  keyof InterfaceListInsights[\"health\"]\n> = {\n  healthy: \"healthy\",\n  failing: \"failing\",\n  running: \"running\",\n  disabled: \"disabled\",\n  \"never-run\": \"neverRun\",\n  unknown: \"checking\",\n};\n\nexport interface AutomationRunSummary {\n  /** Lifetime run count, from the response — not the sample's length. */\n  total: number;\n  /**\n   * Lifetime COMPLETED-run count. From the response's `status_counts` when\n   * the service reports it; an older service leaves that out, so the sample\n   * stands in exactly when it holds the whole history (`total` ≤ its length)\n   * and the count is null — unknowable, never guessed — otherwise.\n   */\n  completedTotal: number | null;\n  latestRun: AutomationRun | null;\n  /** Newest-first sample used by the list sparkline (same page as the summary). */\n  recentRuns: AutomationRun[];\n  /** COMPLETED over COMPLETED+FAILED in the sample. Null with no terminal runs. */\n  recentSuccessRate: number | null;\n  /** Mean completed_at − started_at over the sample's terminal runs. */\n  averageDurationMs: number | null;\n}\n\n/** One automation's summary alongside its query state. */\nexport interface RunSummaryState {\n  summary: AutomationRunSummary | null;\n  isLoading: boolean;\n  isError: boolean;\n}\n\ntype Summaries = ReadonlyMap<string, RunSummaryState>;\n\nconst TERMINAL_STATUSES = new Set<AutomationRunStatus>([\n  AutomationRunStatus.COMPLETED,\n  AutomationRunStatus.FAILED,\n]);\n\nfunction isTaskSuccessful(run: AutomationRun): boolean {\n  const { badgeStatus } = getAutomationRunDisplay(run);\n  return (\n    badgeStatus === AutomationRunStatus.COMPLETED || badgeStatus === \"success\"\n  );\n}\n\nfunction isTaskFailing(run: AutomationRun): boolean {\n  const { badgeStatus } = getAutomationRunDisplay(run);\n  return (\n    badgeStatus === AutomationRunStatus.FAILED ||\n    badgeStatus === \"failed\" ||\n    badgeStatus === \"blocked\"\n  );\n}\n\nexport function summarizeAutomationRuns(\n  response: AutomationRunsResponse,\n): AutomationRunSummary {\n  const terminal = response.runs.filter((run) =>\n    TERMINAL_STATUSES.has(run.status),\n  );\n  const completed = terminal.filter(isTaskSuccessful).length;\n\n  let completedTotal: number | null;\n  if (response.status_counts) {\n    completedTotal = response.status_counts[AutomationRunStatus.COMPLETED] ?? 0;\n  } else if (response.total <= response.runs.length) {\n    completedTotal = completed;\n  } else {\n    completedTotal = null;\n  }\n\n  const durations = terminal.flatMap((run) => {\n    if (!run.completed_at) return [];\n    const ms =\n      new Date(run.completed_at).getTime() - new Date(run.started_at).getTime();\n    return Number.isFinite(ms) && ms >= 0 ? [ms] : [];\n  });\n\n  return {\n    total: response.total,\n    completedTotal,\n    latestRun: response.runs[0] ?? null,\n    recentRuns: response.runs,\n    recentSuccessRate:\n      terminal.length === 0 ? null : completed / terminal.length,\n    averageDurationMs:\n      durations.length === 0\n        ? null\n        : durations.reduce((sum, ms) => sum + ms, 0) / durations.length,\n  };\n}\n\n/**\n * A disabled automation is disabled no matter its history; while the summary\n * is unsettled nothing is claimed; after that the latest run speaks.\n */\nexport function deriveAutomationHealth(\n  automation: Automation,\n  state: RunSummaryState | undefined,\n): AutomationHealth {\n  if (!automation.enabled) return \"disabled\";\n  if (!state || state.isError || state.isLoading || !state.summary) {\n    return \"unknown\";\n  }\n  const latest = state.summary.latestRun;\n  if (!latest) return \"never-run\";\n  if (isTaskFailing(latest)) return \"failing\";\n  if (\n    latest.status === AutomationRunStatus.PENDING ||\n    latest.status === AutomationRunStatus.RUNNING\n  ) {\n    return \"running\";\n  }\n  return isTaskSuccessful(latest) ? \"healthy\" : \"unknown\";\n}\n\n/** \"—\" unknown, seconds under a minute, minutes under an hour, else \"1.5h\". */\nexport function formatCompactDuration(ms: number | null): string {\n  if (ms === null || !Number.isFinite(ms)) return \"—\";\n  if (ms < 60_000) return `${Math.max(1, Math.round(ms / 1000))}s`;\n  if (ms < 3_600_000) return `${Math.max(1, Math.round(ms / 60_000))}m`;\n  return `${(ms / 3_600_000).toFixed(1)}h`;\n}\n\n/** The list page's search predicate: name, prompt, repository, or model. */\nexport function matchesAutomationSearch(\n  automation: Automation,\n  query: string,\n): boolean {\n  const q = query.toLowerCase();\n  if (!q) return true;\n  return (\n    automation.name.toLowerCase().includes(q) ||\n    (automation.prompt ?? \"\").toLowerCase().includes(q) ||\n    automation.repository?.toLowerCase().includes(q) === true ||\n    automation.model?.toLowerCase().includes(q) === true\n  );\n}\n\nconst STATUS_PREDICATES: Record<\n  Exclude<DashboardStatusValue, \"all\">,\n  (automation: Automation, health: AutomationHealth) => boolean\n> = {\n  active: (automation) => automation.enabled,\n  failing: (_automation, health) => health === \"failing\",\n  disabled: (automation) => !automation.enabled,\n};\n\nconst TRIGGER_PREDICATES: Record<\n  Exclude<DashboardTriggerValue, \"all\">,\n  (automation: Automation) => boolean\n> = {\n  // The backend emits several scheduled-trigger aliases, so \"event\" is the\n  // one exact kind and everything else is a schedule.\n  event: (automation) => automation.trigger.type === \"event\",\n  schedule: (automation) => automation.trigger.type !== \"event\",\n};\n\nfunction runCount(automation: Automation, byId: Summaries): number {\n  return byId.get(automation.id)?.summary?.total ?? 0;\n}\n\nfunction lastRunTime(automation: Automation, byId: Summaries): number {\n  const startedAt =\n    byId.get(automation.id)?.summary?.latestRun?.started_at ??\n    automation.last_triggered_at;\n  if (!startedAt) return 0;\n  const time = new Date(startedAt).getTime();\n  return Number.isFinite(time) ? time : 0;\n}\n\nconst SORT_COMPARATORS: Record<\n  DashboardSortValue,\n  (a: Automation, b: Automation, byId: Summaries) => number\n> = {\n  \"last-run\": (a, b, byId) => lastRunTime(b, byId) - lastRunTime(a, byId),\n  runs: (a, b, byId) => runCount(b, byId) - runCount(a, byId),\n  name: (a, b) => a.name.localeCompare(b.name),\n};\n\nexport interface DashboardViewState {\n  search: string;\n  status: DashboardStatusValue;\n  trigger: DashboardTriggerValue;\n  sort: DashboardSortValue;\n}\n\n/** The automations the dashboard shows, filtered and ordered. */\nexport function applyDashboardView(\n  automations: readonly Automation[],\n  view: DashboardViewState,\n  byId: Summaries,\n): Automation[] {\n  return automations\n    .filter((automation) => {\n      if (!matchesAutomationSearch(automation, view.search)) return false;\n      if (\n        view.status !== \"all\" &&\n        !STATUS_PREDICATES[view.status](\n          automation,\n          deriveAutomationHealth(automation, byId.get(automation.id)),\n        )\n      ) {\n        return false;\n      }\n      if (\n        view.trigger !== \"all\" &&\n        !TRIGGER_PREDICATES[view.trigger](automation)\n      ) {\n        return false;\n      }\n      return true;\n    })\n    .sort((a, b) => SORT_COMPARATORS[view.sort](a, b, byId));\n}\n\nexport interface OverviewTileValue {\n  /** The formatted value the tile displays. */\n  display: string;\n  /** True when the metric's value is zero, which swaps in `zeroDetail`. */\n  isZero: boolean;\n  /** Values the tile's copy may substitute via `{{name}}`. */\n  placeholderValues: Record<string, string | number>;\n}\n\nfunction loadedSummaries(\n  automations: readonly Automation[],\n  byId: Summaries,\n): AutomationRunSummary[] {\n  return automations.flatMap((automation) => {\n    const state = byId.get(automation.id);\n    return state?.summary && !state.isLoading && !state.isError\n      ? [state.summary]\n      : [];\n  });\n}\n\nconst TILE_COMPUTATIONS: Record<\n  OverviewMetric,\n  (automations: readonly Automation[], byId: Summaries) => OverviewTileValue\n> = {\n  automations: (automations) => ({\n    display: automations.length.toLocaleString(),\n    isZero: automations.length === 0,\n    placeholderValues: {\n      active: automations.filter((automation) => automation.enabled).length,\n    },\n  }),\n  \"needs-attention\": (automations, byId) => {\n    const failing = automations.filter(\n      (automation) =>\n        deriveAutomationHealth(automation, byId.get(automation.id)) ===\n        \"failing\",\n    ).length;\n    return {\n      display: failing.toLocaleString(),\n      isZero: failing === 0,\n      placeholderValues: {},\n    };\n  },\n  \"total-runs\": (automations, byId) => {\n    const loaded = loadedSummaries(automations, byId);\n    if (loaded.length === 0 && automations.length > 0) {\n      return { display: \"—\", isZero: false, placeholderValues: {} };\n    }\n    const total = loaded.reduce((sum, summary) => sum + summary.total, 0);\n    return {\n      display: total.toLocaleString(),\n      isZero: total === 0,\n      placeholderValues: {},\n    };\n  },\n  \"average-duration\": (automations, byId) => {\n    const durations = loadedSummaries(automations, byId).flatMap((summary) =>\n      summary.averageDurationMs === null ? [] : [summary.averageDurationMs],\n    );\n    const mean =\n      durations.length === 0\n        ? null\n        : durations.reduce((sum, ms) => sum + ms, 0) / durations.length;\n    return {\n      display: formatCompactDuration(mean),\n      isZero: false,\n      placeholderValues: {},\n    };\n  },\n};\n\n/** The value behind one manifest-declared tile. */\nexport function computeOverviewTile(\n  metric: OverviewMetric,\n  automations: readonly Automation[],\n  byId: Summaries,\n): OverviewTileValue {\n  return TILE_COMPUTATIONS[metric](automations, byId);\n}\n"],"mappings":";AAgF0B,IAAI,IAAyB,CACrD,EAAoB,WACpB,EAAoB,MACtB,CAAC;AAiFD,SAAgB,EAAsB,GAA2B;CAI/D,OAHI,MAAO,QAAQ,CAAC,OAAO,SAAS,CAAE,IAAU,MAC5C,IAAK,MAAe,GAAG,KAAK,IAAI,GAAG,KAAK,MAAM,IAAK,GAAI,CAAC,EAAE,KAC1D,IAAK,OAAkB,GAAG,KAAK,IAAI,GAAG,KAAK,MAAM,IAAK,GAAM,CAAC,EAAE,KAC5D,IAAI,IAAK,MAAW,QAAQ,CAAC,EAAE;AACxC"}

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`,templates:`/automations/templates`};function i(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function a(){return new Set(e.default.flatMap(e=>i(e)&&typeof e.id==`string`?[e.id]:[]))}function o(e){if(e===void 0)return null;let n=t.validateInterfaceManifest(e,{catalogIds:a(),mountedRoutes:r});return n.valid?e:(console.warn(`Rejected the automation interface manifest:`,n.errors.join(`; `)),null)}var s=o(n.AUTOMATION_INTERFACE_CANDIDATE);function c(){return s!==null}function l(){if(!s)throw Error(`No automation interface manifest is admitted, so this surface should not have rendered.`);return s}function u(e,t){return e.replace(`:automationId`,encodeURIComponent(t))}function d(){return r.list}function f(e){return u(r.setup,e)}function p(e){return l().endpoints[e]??``}function m(e,t){return p(e).replace(`{id}`,encodeURIComponent(t))}function h(){let e=l();return{sidebarLabel:e.navigation.sidebar.label,commandMenuTitle:e.navigation.commandMenu.title,commandMenuDescription:e.navigation.commandMenu.description,commandMenuKeywords:e.navigation.commandMenu.keywords,listTitle:e.pages.list.title,listSubtitle:e.pages.list.subtitle,detailBackLabel:e.pages.detail.backLabel,editTitle:e.pages.edit.title}}function g(){return l().importExport}function _(){return l().docsUrl}function v(){return l().featuredAutomationIds}function y(){return l().responderIntegrationIds}exports.automationListPath=d,exports.automationSetupPath=f,exports.getAutomationEndpoint=p,exports.getAutomationIdEndpoint=m,exports.getAutomationsDocsUrl=_,exports.getFeaturedAutomationIds=v,exports.getImportExportSpec=g,exports.getInterfaceCopy=h,exports.getResponderIntegrationIds=y,exports.hasAutomationInterface=c;
+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`};function i(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function a(){return new Set(e.default.flatMap(e=>i(e)&&typeof e.id==`string`?[e.id]:[]))}function o(e){if(e===void 0)return null;let n=t.validateInterfaceManifest(e,{catalogIds:a(),mountedRoutes:r});return n.valid?e:(console.warn(`Rejected the automation interface manifest:`,n.errors.join(`; `)),null)}var s=o(n.AUTOMATION_INTERFACE_CANDIDATE);function c(){return s!==null}function l(){if(!s)throw Error(`No automation interface manifest is admitted, so this surface should not have rendered.`);return s}function u(e,t){return e.replace(`:automationId`,encodeURIComponent(t))}function d(){return r.list}function f(e){return u(r.setup,e)}function p(e){return e===r.list||e.startsWith(`${r.list}/`)}function m(e){return l().endpoints[e]??``}function h(e,t){return m(e).replace(`{id}`,encodeURIComponent(t))}function g(){let e=l();return{sidebarLabel:e.navigation.sidebar.label,commandMenuTitle:e.navigation.commandMenu.title,commandMenuDescription:e.navigation.commandMenu.description,commandMenuKeywords:e.navigation.commandMenu.keywords,listTitle:e.pages.list.title,listSubtitle:e.pages.list.subtitle,detailBackLabel:e.pages.detail.backLabel,editTitle:e.pages.edit.title}}function _(){return l().importExport}function v(){return l().docsUrl}function y(){return l().featuredAutomationIds}function b(){return l().responderIntegrationIds}exports.automationListPath=d,exports.automationSetupPath=f,exports.getAutomationEndpoint=m,exports.getAutomationIdEndpoint=h,exports.getAutomationsDocsUrl=v,exports.getFeaturedAutomationIds=y,exports.getImportExportSpec=_,exports.getInterfaceCopy=g,exports.getResponderIntegrationIds=b,exports.hasAutomationInterface=c,exports.isAutomationsRoute=p;
 //# 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 — navigation and\n * page copy, the settable attributes, the import/export envelope, endpoint\n * paths, the featured and responder id lists, the sub-page surface — is served\n * from the interface manifest the pinned `@openhands/extensions` publishes.\n * The host holds none of it. When the package publishes no manifest, or the\n * published one fails admission, there is nothing to serve: the nav entries do\n * not render and the routes 404. `hasAutomationInterface()` is that gate, and\n * every accessor that needs the manifest is reachable only from behind it.\n *\n * Routes are the exception, and they are not a definition: `src/routes.ts`\n * mounts them, so the host states them here and admission checks a manifest's\n * routes against them. That check is what keeps a published deep link\n * resolving to the page it named.\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\n/**\n * File-format section for portable `.automation.json` export/import. A docs\n * pointer for the host's import picker, not interface data — the manifest's\n * `importExport` block has no docs field.\n */\nexport const AUTOMATION_FILE_FORMAT_DOCS_URL =\n  \"https://docs.openhands.dev/openhands/usage/agent-canvas/managing-automations#exported-file-format\";\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 surfaces it would have described stay unrendered.\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\n/**\n * Whether this deployment has an automation interface at all. The nav entries\n * and the route loaders ask before rendering; nothing else has to.\n */\nexport function hasAutomationInterface(): boolean {\n  return ADMITTED !== null;\n}\n\n/**\n * The admitted manifest, for the accessors that cannot answer without one.\n * Reaching one of those without a manifest means a surface rendered past its\n * gate — a wiring mistake, not a state to render.\n */\nfunction requireInterface(): InterfaceManifest {\n  if (!ADMITTED) {\n    throw new Error(\n      \"No automation interface manifest is admitted, so this surface should not have rendered.\",\n    );\n  }\n  return ADMITTED;\n}\n\nfunction substituteRouteParam(pattern: string, id: string): string {\n  return pattern.replace(\":automationId\", encodeURIComponent(id));\n}\n\nexport function automationListPath(): string {\n  return MOUNTED_ROUTES.list;\n}\n\nexport function automationSetupPath(id: string): string {\n  return substituteRouteParam(MOUNTED_ROUTES.setup, id);\n}\n\nexport function automationDetailPath(id: string): string {\n  return substituteRouteParam(MOUNTED_ROUTES.detail, id);\n}\n\nexport function automationTemplatesPath(): string {\n  return MOUNTED_ROUTES.templates;\n}\n\n/**\n * A declared endpoint path. Empty for one the manifest may omit - the two a\n * bundle needs were added after the block shipped - so a caller that needs one\n * says so rather than reading a host-held default that does not exist.\n */\nexport function getAutomationEndpoint(name: InterfaceEndpointName): string {\n  return requireInterface().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;\n  commandMenuTitle: string;\n  commandMenuDescription: string;\n  commandMenuKeywords: string;\n  listTitle: string;\n  listSubtitle: string;\n  detailBackLabel: string;\n  editTitle: string;\n}\n\nexport function getInterfaceCopy(): InterfaceCopy {\n  const manifest = requireInterface();\n  return {\n    sidebarLabel: manifest.navigation.sidebar.label,\n    commandMenuTitle: manifest.navigation.commandMenu.title,\n    commandMenuDescription: manifest.navigation.commandMenu.description,\n    commandMenuKeywords: manifest.navigation.commandMenu.keywords,\n    listTitle: manifest.pages.list.title,\n    listSubtitle: manifest.pages.list.subtitle,\n    detailBackLabel: manifest.pages.detail.backLabel,\n    editTitle: manifest.pages.edit.title,\n  };\n}\n\nexport interface AttributeSpec {\n  present: boolean;\n  label: string;\n  /** Null when the manifest states no help text for the attribute. */\n  help: string | null;\n  required: boolean;\n  min: number | null;\n  max: number | null;\n}\n\n/** An attribute the manifest does not declare is not offered at all. */\nconst ABSENT_ATTRIBUTE: AttributeSpec = {\n  present: false,\n  label: \"\",\n  help: null,\n  required: false,\n  min: null,\n  max: null,\n};\n\nexport function getAttributeSpec(name: AutomationAttributeName): AttributeSpec {\n  const attribute = requireInterface().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 requireInterface().importExport;\n}\n\nexport function getAutomationsDocsUrl(): string {\n  return requireInterface().docsUrl;\n}\n\nexport function getFeaturedAutomationIds(): readonly string[] {\n  return requireInterface().featuredAutomationIds;\n}\n\nexport function getResponderIntegrationIds(): readonly string[] {\n  return requireInterface().responderIntegrationIds;\n}\n\nexport interface SubPageNavSpec {\n  page: InterfaceSubPageId;\n  /** The page's route, resolved through the host's route table. */\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.\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,EAUA,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,GAAkC,CAChD,OAAO,IAAa,IACtB,CAOA,SAAS,GAAsC,CAC7C,GAAI,CAAC,EACH,MAAU,MACR,yFACF,EAEF,OAAO,CACT,CAEA,SAAS,EAAqB,EAAiB,EAAoB,CACjE,OAAO,EAAQ,QAAQ,gBAAiB,mBAAmB,CAAE,CAAC,CAChE,CAEA,SAAgB,GAA6B,CAC3C,OAAO,EAAe,IACxB,CAEA,SAAgB,EAAoB,EAAoB,CACtD,OAAO,EAAqB,EAAe,MAAO,CAAE,CACtD,CAeA,SAAgB,EAAsB,EAAqC,CACzE,OAAO,EAAiB,EAAE,UAAU,IAAS,EAC/C,CAGA,SAAgB,EACd,EACA,EACQ,CACR,OAAO,EAAsB,CAAI,EAAE,QAAQ,OAAQ,mBAAmB,CAAE,CAAC,CAC3E,CAaA,SAAgB,GAAkC,CAChD,IAAM,EAAW,EAAiB,EAClC,MAAO,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,CACF,CAmCA,SAAgB,GAA6C,CAC3D,OAAO,EAAiB,EAAE,YAC5B,CAEA,SAAgB,GAAgC,CAC9C,OAAO,EAAiB,EAAE,OAC5B,CAEA,SAAgB,GAA8C,CAC5D,OAAO,EAAiB,EAAE,qBAC5B,CAEA,SAAgB,GAAgD,CAC9D,OAAO,EAAiB,EAAE,uBAC5B"}
+{"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 — navigation and\n * page copy, the settable attributes, the import/export envelope, endpoint\n * paths, the featured and responder id lists, the sub-page surface — is served\n * from the interface manifest the pinned `@openhands/extensions` publishes.\n * The host holds none of it. When the package publishes no manifest, or the\n * published one fails admission, there is nothing to serve: the nav entries do\n * not render and the routes 404. `hasAutomationInterface()` is that gate, and\n * every accessor that needs the manifest is reachable only from behind it.\n *\n * Routes are the exception, and they are not a definition: `src/routes.ts`\n * mounts them, so the host states them here and admission checks a manifest's\n * routes against them. That check is what keeps a published deep link\n * resolving to the page it named.\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\n/**\n * File-format section for portable `.automation.json` export/import. A docs\n * pointer for the host's import picker, not interface data — the manifest's\n * `importExport` block has no docs field.\n */\nexport const AUTOMATION_FILE_FORMAT_DOCS_URL =\n  \"https://docs.openhands.dev/openhands/usage/agent-canvas/managing-automations#exported-file-format\";\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 surfaces it would have described stay unrendered.\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\n/**\n * Whether this deployment has an automation interface at all. The nav entries\n * and the route loaders ask before rendering; nothing else has to.\n */\nexport function hasAutomationInterface(): boolean {\n  return ADMITTED !== null;\n}\n\n/**\n * The admitted manifest, for the accessors that cannot answer without one.\n * Reaching one of those without a manifest means a surface rendered past its\n * gate — a wiring mistake, not a state to render.\n */\nfunction requireInterface(): InterfaceManifest {\n  if (!ADMITTED) {\n    throw new Error(\n      \"No automation interface manifest is admitted, so this surface should not have rendered.\",\n    );\n  }\n  return ADMITTED;\n}\n\nfunction substituteRouteParam(pattern: string, id: string): string {\n  return pattern.replace(\":automationId\", encodeURIComponent(id));\n}\n\nexport function automationListPath(): string {\n  return MOUNTED_ROUTES.list;\n}\n\nexport function automationSetupPath(id: string): string {\n  return substituteRouteParam(MOUNTED_ROUTES.setup, id);\n}\n\nexport function automationDetailPath(id: string): string {\n  return substituteRouteParam(MOUNTED_ROUTES.detail, id);\n}\n\nexport function automationTemplatesPath(): string {\n  return MOUNTED_ROUTES.templates;\n}\n\n/**\n * Whether `path` (a location pathname) is inside the automation surface: the\n * list route itself or anything nested under it (detail, setup, templates,\n * git-sync). Prefix-safe: \"/automations-foo\" does not match.\n */\nexport function isAutomationsRoute(path: string): boolean {\n  return (\n    path === MOUNTED_ROUTES.list || path.startsWith(`${MOUNTED_ROUTES.list}/`)\n  );\n}\n\n/**\n * A declared endpoint path. Empty for one the manifest may omit - the two a\n * bundle needs were added after the block shipped - so a caller that needs one\n * says so rather than reading a host-held default that does not exist.\n */\nexport function getAutomationEndpoint(name: InterfaceEndpointName): string {\n  return requireInterface().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;\n  commandMenuTitle: string;\n  commandMenuDescription: string;\n  commandMenuKeywords: string;\n  listTitle: string;\n  listSubtitle: string;\n  detailBackLabel: string;\n  editTitle: string;\n}\n\nexport function getInterfaceCopy(): InterfaceCopy {\n  const manifest = requireInterface();\n  return {\n    sidebarLabel: manifest.navigation.sidebar.label,\n    commandMenuTitle: manifest.navigation.commandMenu.title,\n    commandMenuDescription: manifest.navigation.commandMenu.description,\n    commandMenuKeywords: manifest.navigation.commandMenu.keywords,\n    listTitle: manifest.pages.list.title,\n    listSubtitle: manifest.pages.list.subtitle,\n    detailBackLabel: manifest.pages.detail.backLabel,\n    editTitle: manifest.pages.edit.title,\n  };\n}\n\nexport interface AttributeSpec {\n  present: boolean;\n  label: string;\n  /** Null when the manifest states no help text for the attribute. */\n  help: string | null;\n  required: boolean;\n  min: number | null;\n  max: number | null;\n}\n\n/** An attribute the manifest does not declare is not offered at all. */\nconst ABSENT_ATTRIBUTE: AttributeSpec = {\n  present: false,\n  label: \"\",\n  help: null,\n  required: false,\n  min: null,\n  max: null,\n};\n\nexport function getAttributeSpec(name: AutomationAttributeName): AttributeSpec {\n  const attribute = requireInterface().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 requireInterface().importExport;\n}\n\nexport function getAutomationsDocsUrl(): string {\n  return requireInterface().docsUrl;\n}\n\nexport function getFeaturedAutomationIds(): readonly string[] {\n  return requireInterface().featuredAutomationIds;\n}\n\nexport function getResponderIntegrationIds(): readonly string[] {\n  return requireInterface().responderIntegrationIds;\n}\n\nexport interface SubPageNavSpec {\n  page: InterfaceSubPageId;\n  /** The page's route, resolved through the host's route table. */\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.\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,EAUA,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,GAAkC,CAChD,OAAO,IAAa,IACtB,CAOA,SAAS,GAAsC,CAC7C,GAAI,CAAC,EACH,MAAU,MACR,yFACF,EAEF,OAAO,CACT,CAEA,SAAS,EAAqB,EAAiB,EAAoB,CACjE,OAAO,EAAQ,QAAQ,gBAAiB,mBAAmB,CAAE,CAAC,CAChE,CAEA,SAAgB,GAA6B,CAC3C,OAAO,EAAe,IACxB,CAEA,SAAgB,EAAoB,EAAoB,CACtD,OAAO,EAAqB,EAAe,MAAO,CAAE,CACtD,CAeA,SAAgB,EAAmB,EAAuB,CACxD,OACE,IAAS,EAAe,MAAQ,EAAK,WAAW,GAAG,EAAe,KAAK,EAAE,CAE7E,CAOA,SAAgB,EAAsB,EAAqC,CACzE,OAAO,EAAiB,EAAE,UAAU,IAAS,EAC/C,CAGA,SAAgB,EACd,EACA,EACQ,CACR,OAAO,EAAsB,CAAI,EAAE,QAAQ,OAAQ,mBAAmB,CAAE,CAAC,CAC3E,CAaA,SAAgB,GAAkC,CAChD,IAAM,EAAW,EAAiB,EAClC,MAAO,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,CACF,CAmCA,SAAgB,GAA6C,CAC3D,OAAO,EAAiB,EAAE,YAC5B,CAEA,SAAgB,GAAgC,CAC9C,OAAO,EAAiB,EAAE,OAC5B,CAEA,SAAgB,GAA8C,CAC5D,OAAO,EAAiB,EAAE,qBAC5B,CAEA,SAAgB,GAAgD,CAC9D,OAAO,EAAiB,EAAE,uBAC5B"}

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

@@ -31,6 +31,12 @@ export declare function automationListPath(): string;
 export declare function automationSetupPath(id: string): string;
 export declare function automationDetailPath(id: string): string;
 export declare function automationTemplatesPath(): string;
+/**
+ * Whether `path` (a location pathname) is inside the automation surface: the
+ * list route itself or anything nested under it (detail, setup, templates,
+ * git-sync). Prefix-safe: "/automations-foo" does not match.
+ */
+export declare function isAutomationsRoute(path: string): boolean;
 /**
  * A declared endpoint path. Empty for one the manifest may omit - the two a
  * bundle needs were added after the block shipped - so a caller that needs one

package/dist/manifests/automation-interface.js

@@ -40,12 +40,15 @@ function f(e) {
 	return u(r.setup, e);
 }
 function p(e) {
+	return e === r.list || e.startsWith(`${r.list}/`);
+}
+function m(e) {
 	return l().endpoints[e] ?? "";
 }
-function m(e, t) {
-	return p(e).replace("{id}", encodeURIComponent(t));
+function h(e, t) {
+	return m(e).replace("{id}", encodeURIComponent(t));
 }
-function h() {
+function g() {
 	let e = l();
 	return {
 		sidebarLabel: e.navigation.sidebar.label,
@@ -58,19 +61,19 @@ function h() {
 		editTitle: e.pages.edit.title
 	};
 }
-function g() {
+function _() {
 	return l().importExport;
 }
-function _() {
+function v() {
 	return l().docsUrl;
 }
-function v() {
+function y() {
 	return l().featuredAutomationIds;
 }
-function y() {
+function b() {
 	return l().responderIntegrationIds;
 }
 //#endregion
-export { d as automationListPath, f as automationSetupPath, p as getAutomationEndpoint, m as getAutomationIdEndpoint, _ as getAutomationsDocsUrl, v as getFeaturedAutomationIds, g as getImportExportSpec, h as getInterfaceCopy, y as getResponderIntegrationIds, c as hasAutomationInterface };
+export { d as automationListPath, f as automationSetupPath, m as getAutomationEndpoint, h as getAutomationIdEndpoint, v as getAutomationsDocsUrl, y as getFeaturedAutomationIds, _ as getImportExportSpec, g as getInterfaceCopy, b as getResponderIntegrationIds, c as hasAutomationInterface, p as isAutomationsRoute };
 
 //# sourceMappingURL=automation-interface.js.map

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 — navigation and\n * page copy, the settable attributes, the import/export envelope, endpoint\n * paths, the featured and responder id lists, the sub-page surface — is served\n * from the interface manifest the pinned `@openhands/extensions` publishes.\n * The host holds none of it. When the package publishes no manifest, or the\n * published one fails admission, there is nothing to serve: the nav entries do\n * not render and the routes 404. `hasAutomationInterface()` is that gate, and\n * every accessor that needs the manifest is reachable only from behind it.\n *\n * Routes are the exception, and they are not a definition: `src/routes.ts`\n * mounts them, so the host states them here and admission checks a manifest's\n * routes against them. That check is what keeps a published deep link\n * resolving to the page it named.\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\n/**\n * File-format section for portable `.automation.json` export/import. A docs\n * pointer for the host's import picker, not interface data — the manifest's\n * `importExport` block has no docs field.\n */\nexport const AUTOMATION_FILE_FORMAT_DOCS_URL =\n  \"https://docs.openhands.dev/openhands/usage/agent-canvas/managing-automations#exported-file-format\";\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 surfaces it would have described stay unrendered.\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\n/**\n * Whether this deployment has an automation interface at all. The nav entries\n * and the route loaders ask before rendering; nothing else has to.\n */\nexport function hasAutomationInterface(): boolean {\n  return ADMITTED !== null;\n}\n\n/**\n * The admitted manifest, for the accessors that cannot answer without one.\n * Reaching one of those without a manifest means a surface rendered past its\n * gate — a wiring mistake, not a state to render.\n */\nfunction requireInterface(): InterfaceManifest {\n  if (!ADMITTED) {\n    throw new Error(\n      \"No automation interface manifest is admitted, so this surface should not have rendered.\",\n    );\n  }\n  return ADMITTED;\n}\n\nfunction substituteRouteParam(pattern: string, id: string): string {\n  return pattern.replace(\":automationId\", encodeURIComponent(id));\n}\n\nexport function automationListPath(): string {\n  return MOUNTED_ROUTES.list;\n}\n\nexport function automationSetupPath(id: string): string {\n  return substituteRouteParam(MOUNTED_ROUTES.setup, id);\n}\n\nexport function automationDetailPath(id: string): string {\n  return substituteRouteParam(MOUNTED_ROUTES.detail, id);\n}\n\nexport function automationTemplatesPath(): string {\n  return MOUNTED_ROUTES.templates;\n}\n\n/**\n * A declared endpoint path. Empty for one the manifest may omit - the two a\n * bundle needs were added after the block shipped - so a caller that needs one\n * says so rather than reading a host-held default that does not exist.\n */\nexport function getAutomationEndpoint(name: InterfaceEndpointName): string {\n  return requireInterface().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;\n  commandMenuTitle: string;\n  commandMenuDescription: string;\n  commandMenuKeywords: string;\n  listTitle: string;\n  listSubtitle: string;\n  detailBackLabel: string;\n  editTitle: string;\n}\n\nexport function getInterfaceCopy(): InterfaceCopy {\n  const manifest = requireInterface();\n  return {\n    sidebarLabel: manifest.navigation.sidebar.label,\n    commandMenuTitle: manifest.navigation.commandMenu.title,\n    commandMenuDescription: manifest.navigation.commandMenu.description,\n    commandMenuKeywords: manifest.navigation.commandMenu.keywords,\n    listTitle: manifest.pages.list.title,\n    listSubtitle: manifest.pages.list.subtitle,\n    detailBackLabel: manifest.pages.detail.backLabel,\n    editTitle: manifest.pages.edit.title,\n  };\n}\n\nexport interface AttributeSpec {\n  present: boolean;\n  label: string;\n  /** Null when the manifest states no help text for the attribute. */\n  help: string | null;\n  required: boolean;\n  min: number | null;\n  max: number | null;\n}\n\n/** An attribute the manifest does not declare is not offered at all. */\nconst ABSENT_ATTRIBUTE: AttributeSpec = {\n  present: false,\n  label: \"\",\n  help: null,\n  required: false,\n  min: null,\n  max: null,\n};\n\nexport function getAttributeSpec(name: AutomationAttributeName): AttributeSpec {\n  const attribute = requireInterface().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 requireInterface().importExport;\n}\n\nexport function getAutomationsDocsUrl(): string {\n  return requireInterface().docsUrl;\n}\n\nexport function getFeaturedAutomationIds(): readonly string[] {\n  return requireInterface().featuredAutomationIds;\n}\n\nexport function getResponderIntegrationIds(): readonly string[] {\n  return requireInterface().responderIntegrationIds;\n}\n\nexport interface SubPageNavSpec {\n  page: InterfaceSubPageId;\n  /** The page's route, resolved through the host's route table. */\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.\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;AAUA,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,IAAkC;CAChD,OAAO,MAAa;AACtB;AAOA,SAAS,IAAsC;CAC7C,IAAI,CAAC,GACH,MAAU,MACR,yFACF;CAEF,OAAO;AACT;AAEA,SAAS,EAAqB,GAAiB,GAAoB;CACjE,OAAO,EAAQ,QAAQ,iBAAiB,mBAAmB,CAAE,CAAC;AAChE;AAEA,SAAgB,IAA6B;CAC3C,OAAO,EAAe;AACxB;AAEA,SAAgB,EAAoB,GAAoB;CACtD,OAAO,EAAqB,EAAe,OAAO,CAAE;AACtD;AAeA,SAAgB,EAAsB,GAAqC;CACzE,OAAO,EAAiB,EAAE,UAAU,MAAS;AAC/C;AAGA,SAAgB,EACd,GACA,GACQ;CACR,OAAO,EAAsB,CAAI,EAAE,QAAQ,QAAQ,mBAAmB,CAAE,CAAC;AAC3E;AAaA,SAAgB,IAAkC;CAChD,IAAM,IAAW,EAAiB;CAClC,OAAO;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;AACF;AAmCA,SAAgB,IAA6C;CAC3D,OAAO,EAAiB,EAAE;AAC5B;AAEA,SAAgB,IAAgC;CAC9C,OAAO,EAAiB,EAAE;AAC5B;AAEA,SAAgB,IAA8C;CAC5D,OAAO,EAAiB,EAAE;AAC5B;AAEA,SAAgB,IAAgD;CAC9D,OAAO,EAAiB,EAAE;AAC5B"}
+{"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 — navigation and\n * page copy, the settable attributes, the import/export envelope, endpoint\n * paths, the featured and responder id lists, the sub-page surface — is served\n * from the interface manifest the pinned `@openhands/extensions` publishes.\n * The host holds none of it. When the package publishes no manifest, or the\n * published one fails admission, there is nothing to serve: the nav entries do\n * not render and the routes 404. `hasAutomationInterface()` is that gate, and\n * every accessor that needs the manifest is reachable only from behind it.\n *\n * Routes are the exception, and they are not a definition: `src/routes.ts`\n * mounts them, so the host states them here and admission checks a manifest's\n * routes against them. That check is what keeps a published deep link\n * resolving to the page it named.\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\n/**\n * File-format section for portable `.automation.json` export/import. A docs\n * pointer for the host's import picker, not interface data — the manifest's\n * `importExport` block has no docs field.\n */\nexport const AUTOMATION_FILE_FORMAT_DOCS_URL =\n  \"https://docs.openhands.dev/openhands/usage/agent-canvas/managing-automations#exported-file-format\";\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 surfaces it would have described stay unrendered.\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\n/**\n * Whether this deployment has an automation interface at all. The nav entries\n * and the route loaders ask before rendering; nothing else has to.\n */\nexport function hasAutomationInterface(): boolean {\n  return ADMITTED !== null;\n}\n\n/**\n * The admitted manifest, for the accessors that cannot answer without one.\n * Reaching one of those without a manifest means a surface rendered past its\n * gate — a wiring mistake, not a state to render.\n */\nfunction requireInterface(): InterfaceManifest {\n  if (!ADMITTED) {\n    throw new Error(\n      \"No automation interface manifest is admitted, so this surface should not have rendered.\",\n    );\n  }\n  return ADMITTED;\n}\n\nfunction substituteRouteParam(pattern: string, id: string): string {\n  return pattern.replace(\":automationId\", encodeURIComponent(id));\n}\n\nexport function automationListPath(): string {\n  return MOUNTED_ROUTES.list;\n}\n\nexport function automationSetupPath(id: string): string {\n  return substituteRouteParam(MOUNTED_ROUTES.setup, id);\n}\n\nexport function automationDetailPath(id: string): string {\n  return substituteRouteParam(MOUNTED_ROUTES.detail, id);\n}\n\nexport function automationTemplatesPath(): string {\n  return MOUNTED_ROUTES.templates;\n}\n\n/**\n * Whether `path` (a location pathname) is inside the automation surface: the\n * list route itself or anything nested under it (detail, setup, templates,\n * git-sync). Prefix-safe: \"/automations-foo\" does not match.\n */\nexport function isAutomationsRoute(path: string): boolean {\n  return (\n    path === MOUNTED_ROUTES.list || path.startsWith(`${MOUNTED_ROUTES.list}/`)\n  );\n}\n\n/**\n * A declared endpoint path. Empty for one the manifest may omit - the two a\n * bundle needs were added after the block shipped - so a caller that needs one\n * says so rather than reading a host-held default that does not exist.\n */\nexport function getAutomationEndpoint(name: InterfaceEndpointName): string {\n  return requireInterface().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;\n  commandMenuTitle: string;\n  commandMenuDescription: string;\n  commandMenuKeywords: string;\n  listTitle: string;\n  listSubtitle: string;\n  detailBackLabel: string;\n  editTitle: string;\n}\n\nexport function getInterfaceCopy(): InterfaceCopy {\n  const manifest = requireInterface();\n  return {\n    sidebarLabel: manifest.navigation.sidebar.label,\n    commandMenuTitle: manifest.navigation.commandMenu.title,\n    commandMenuDescription: manifest.navigation.commandMenu.description,\n    commandMenuKeywords: manifest.navigation.commandMenu.keywords,\n    listTitle: manifest.pages.list.title,\n    listSubtitle: manifest.pages.list.subtitle,\n    detailBackLabel: manifest.pages.detail.backLabel,\n    editTitle: manifest.pages.edit.title,\n  };\n}\n\nexport interface AttributeSpec {\n  present: boolean;\n  label: string;\n  /** Null when the manifest states no help text for the attribute. */\n  help: string | null;\n  required: boolean;\n  min: number | null;\n  max: number | null;\n}\n\n/** An attribute the manifest does not declare is not offered at all. */\nconst ABSENT_ATTRIBUTE: AttributeSpec = {\n  present: false,\n  label: \"\",\n  help: null,\n  required: false,\n  min: null,\n  max: null,\n};\n\nexport function getAttributeSpec(name: AutomationAttributeName): AttributeSpec {\n  const attribute = requireInterface().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 requireInterface().importExport;\n}\n\nexport function getAutomationsDocsUrl(): string {\n  return requireInterface().docsUrl;\n}\n\nexport function getFeaturedAutomationIds(): readonly string[] {\n  return requireInterface().featuredAutomationIds;\n}\n\nexport function getResponderIntegrationIds(): readonly string[] {\n  return requireInterface().responderIntegrationIds;\n}\n\nexport interface SubPageNavSpec {\n  page: InterfaceSubPageId;\n  /** The page's route, resolved through the host's route table. */\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.\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;AAUA,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,IAAkC;CAChD,OAAO,MAAa;AACtB;AAOA,SAAS,IAAsC;CAC7C,IAAI,CAAC,GACH,MAAU,MACR,yFACF;CAEF,OAAO;AACT;AAEA,SAAS,EAAqB,GAAiB,GAAoB;CACjE,OAAO,EAAQ,QAAQ,iBAAiB,mBAAmB,CAAE,CAAC;AAChE;AAEA,SAAgB,IAA6B;CAC3C,OAAO,EAAe;AACxB;AAEA,SAAgB,EAAoB,GAAoB;CACtD,OAAO,EAAqB,EAAe,OAAO,CAAE;AACtD;AAeA,SAAgB,EAAmB,GAAuB;CACxD,OACE,MAAS,EAAe,QAAQ,EAAK,WAAW,GAAG,EAAe,KAAK,EAAE;AAE7E;AAOA,SAAgB,EAAsB,GAAqC;CACzE,OAAO,EAAiB,EAAE,UAAU,MAAS;AAC/C;AAGA,SAAgB,EACd,GACA,GACQ;CACR,OAAO,EAAsB,CAAI,EAAE,QAAQ,QAAQ,mBAAmB,CAAE,CAAC;AAC3E;AAaA,SAAgB,IAAkC;CAChD,IAAM,IAAW,EAAiB;CAClC,OAAO;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;AACF;AAmCA,SAAgB,IAA6C;CAC3D,OAAO,EAAiB,EAAE;AAC5B;AAEA,SAAgB,IAAgC;CAC9C,OAAO,EAAiB,EAAE;AAC5B;AAEA,SAAgB,IAA8C;CAC5D,OAAO,EAAiB,EAAE;AAC5B;AAEA,SAAgB,IAAgD;CAC9D,OAAO,EAAiB,EAAE;AAC5B"}

package/dist/manifests/automation-setup.cjs

@@ -1,2 +1,2 @@
-require("../_virtual/_rolldown/runtime.cjs"),require("../i18n/index.cjs"),require("../utils/automation-catalog.cjs");const e=require("./automation-interface.cjs");function t(t){return t&&i(t)?r(`createBundle`):e.getAutomationEndpoint(`createPrompt`)}function n(){return r(`uploads`)}function r(t){let n=e.getAutomationEndpoint(t);if(!n)throw Error(`The published automation interface declares no '${t}' endpoint, so this deployment cannot create an automation from a script bundle.`);return n}function i(e){return e.setup.mode===`direct`&&e.setup.bundle!==void 0}exports.automationCreateEndpoint=t,exports.automationUploadEndpoint=n;
+require("../_virtual/_rolldown/runtime.cjs"),require("../i18n/index.cjs"),require("../utils/automation-catalog.cjs");const e=require("./automation-interface.cjs"),t=require("./manifest-local-validation.cjs");function n(t,n){let r=o(t,n);return r===`plugin`?e.getAutomationEndpoint(`createPlugin`):r===`upload`||r===`bundle`?i(`createBundle`):e.getAutomationEndpoint(`createPrompt`)}function r(){return i(`uploads`)}function i(t){let n=e.getAutomationEndpoint(t);if(!n)throw Error(`The published automation interface declares no '${t}' endpoint, so this deployment cannot create an automation from a script bundle.`);return n}function a(e){return e.setup.mode===`direct`&&e.setup.bundle!==void 0}function o(e,n){if(!e)return`prompt`;if(a(e))return`bundle`;let r=e.setup.actions??{};if(n&&n in r)return n;let i=t.actionKinds(e.setup);return i.length===1?i[0]:`prompt`}exports.automationCreateEndpoint=n,exports.automationUploadEndpoint=r;
 //# sourceMappingURL=automation-setup.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"automation-setup.cjs","names":[],"sources":["../../src/manifests/automation-setup.ts"],"sourcesContent":["/**\n * The only module that knows a setup entry configures an *automation*.\n *\n * The published contract states just what varies between entries; everything\n * derivable is the host's to generate. That derivation is here, and nowhere\n * else, so the rest of `src/manifests/` stays about forms rather than about\n * automations.\n *\n * The algorithm mirrors `tests/test_automation_setup.py::_render_payload` in\n * `OpenHands/extensions`, which is the authoritative reference: it produces the\n * request bodies published in that repository's contract fixtures, and those\n * were verified against the live service. The create model is `extra=\"forbid\"`,\n * so any divergence is a hard 422 rather than a dropped field.\n */\n\nimport i18n from \"#/i18n\";\nimport { I18nKey } from \"#/i18n/declaration\";\nimport { findAutomationCommand } from \"#/utils/automation-catalog\";\nimport { getAutomationEndpoint } from \"./automation-interface\";\nimport {\n  collectFields,\n  fieldText,\n  fieldValues,\n} from \"./manifest-local-validation\";\nimport { interpolateText, interpolateValue } from \"./manifest-template\";\nimport type {\n  SetupBlock,\n  SetupBundleConfigValue,\n  SetupEntry,\n  SetupFormValues,\n  SetupRequestBody,\n  SetupTriggerKind,\n} from \"./types\";\n\n/**\n * The creation endpoint a derived draft would be posted to. Resolved on call\n * rather than at import, because the endpoint is the interface manifest's and\n * this module loads whether or not one was admitted.\n *\n * A bundle entry is created through the raw endpoint, because what it sends is\n * a tarball it uploaded rather than arguments to a preset. Called without an\n * entry - as the import path does - it answers for a prompt.\n */\nexport function automationCreateEndpoint(entry?: SetupEntry): string {\n  if (entry && isBundleEntry(entry)) {\n    return requireBundleEndpoint(\"createBundle\");\n  }\n  return getAutomationEndpoint(\"createPrompt\");\n}\n\n/** Where a bundle's tarball is uploaded, before the create call. */\nexport function automationUploadEndpoint(): string {\n  return requireBundleEndpoint(\"uploads\");\n}\n\n/** The endpoints a bundle entry cannot be created without. */\nconst BUNDLE_ENDPOINTS = [\"createBundle\", \"uploads\"] as const;\n\n/**\n * An endpoint only a bundle needs. The interface manifest may predate bundles,\n * and the host holds no path of its own to fall back to, so this is where that\n * runs out rather than somewhere deep in a request.\n */\nfunction requireBundleEndpoint(\n  name: (typeof BUNDLE_ENDPOINTS)[number],\n): string {\n  const path = getAutomationEndpoint(name);\n  if (!path) {\n    throw new Error(\n      `The published automation interface declares no '${name}' endpoint, ` +\n        \"so this deployment cannot create an automation from a script bundle.\",\n    );\n  }\n  return path;\n}\n\n/**\n * The endpoints this entry needs that the published interface does not declare.\n *\n * Asked before the form renders rather than discovered at the moment of\n * creating: a pinned package that predates bundles can never answer, and the\n * dialog can say so while nothing has been filled in yet. Empty for every\n * entry that is not a bundle, which needs nothing beyond what the block has\n * always declared.\n */\nexport function missingCreateEndpoints(entry: SetupEntry): string[] {\n  if (!isBundleEntry(entry)) return [];\n  return BUNDLE_ENDPOINTS.filter((name) => !getAutomationEndpoint(name));\n}\n\n/** Whether this entry ships a script tarball instead of a prompt. */\nexport function isBundleEntry(entry: SetupEntry): boolean {\n  return entry.setup.mode === \"direct\" && entry.setup.bundle !== undefined;\n}\n\n/**\n * The `tarball_path` a preflight draft carries.\n *\n * Preflight runs on every field blur and the upload happens once, at submit,\n * so there is no real path to send yet. The service checks this field's scheme\n * at preflight and its ownership only at creation, so a well-formed stand-in\n * validates exactly what preflight is for - the rest of the body - without\n * uploading an archive per keystroke.\n */\nexport const PREFLIGHT_TARBALL_PATH =\n  \"oh-internal://uploads/00000000-0000-0000-0000-000000000000\";\n\n/**\n * Trigger properties a form field may fill, per trigger kind. A field under a\n * trigger kind whose name is listed here fills the trigger property of the same\n * name; anything else there, such as a phrase to match, is an input to `filter`.\n */\nconst TRIGGER_PROPERTIES: Record<SetupTriggerKind, readonly string[]> = {\n  cron: [\"schedule\", \"timezone\"],\n  event: [\"on\"],\n};\n\n/**\n * Repository properties a form field may fill, read the same way\n * {@link TRIGGER_PROPERTIES} is: a field whose name is listed here fills the\n * `repos[]` property of the same name. `url` and `provider` are absent because\n * neither is answered by a field of its own — they come from the repo-picker's\n * value and from its declared provider.\n *\n * These two lists are the only field names the derivation knows; everything\n * else it reads it finds by field type. An entry that wants a base branch in\n * its request therefore has to name that field `ref`.\n */\nconst REPO_PROPERTIES: readonly string[] = [\"ref\"];\n\nconst FORM_PLACEHOLDER_PATTERN = /\\{\\{form\\.([A-Za-z0-9_.]+)\\}\\}/g;\n\n/** The repository input, which supplies `repos` and an event trigger's source. */\nfunction findRepoPickerField(setup: SetupBlock) {\n  const match = Object.entries(collectFields(setup)).find(\n    ([, field]) => field.type === \"repo-picker\",\n  );\n  return match ? { name: match[0], field: match[1] } : null;\n}\n\n/** Every repository the form collected, whether the picker takes one or many. */\nfunction repositories(setup: SetupBlock, values: SetupFormValues): string[] {\n  const picker = findRepoPickerField(setup);\n  return picker ? fieldValues(values[picker.name]) : [];\n}\n\n/**\n * The created automation's name.\n *\n * One repository is worth naming; several are not, so the count stands in\n * rather than a list of names that would not fit.\n */\nfunction deriveName(entry: SetupEntry, values: SetupFormValues): string {\n  const repos = repositories(entry.setup, values);\n  if (repos.length === 0) return entry.name;\n  if (repos.length === 1) return `${entry.name} - ${repos[0]}`;\n  // The count is the one word here the host writes rather than reads off the\n  // entry, so it is translated. There is no translator to pass in: the\n  // derivation runs from a memo, an upload and a test alike.\n  const count = i18n.t(I18nKey.SETUP$REPOSITORY_COUNT, {\n    total: repos.length,\n  });\n  return `${entry.name} - ${count}`;\n}\n\n/** The single trigger kind a direct entry declares, with its fields. */\nfunction getTrigger(setup: SetupBlock) {\n  const entries = Object.entries(setup.form.triggers ?? {});\n  if (entries.length === 0) return null;\n  const [kind, fields] = entries[0];\n  return { kind: kind as SetupTriggerKind, fields: fields ?? {} };\n}\n\n/**\n * The create request body these form values produce.\n *\n * No entry declares it: `name` comes from the entry, `repos` from the\n * repo-picker field and its declared provider, and `trigger` from the key and\n * fields under `form.triggers`. Only `prompt` and an event `filter` are\n * declared, because only they cannot be read off the form.\n *\n * Returns null for an assisted entry, which hands setup to a conversation\n * instead of sending a body.\n */\nexport function buildCreatePayload(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  /** Bundle entries only: what the upload returned. */\n  tarballPath: string = PREFLIGHT_TARBALL_PATH,\n): SetupRequestBody | null {\n  const { setup } = entry;\n  if (setup.mode !== \"direct\") return null;\n  if (setup.bundle) return buildBundlePayload(entry, values, tarballPath);\n  if (!setup.prompt) return null;\n\n  const scope = { form: values, automation: entry };\n  const repoPicker = findRepoPickerField(setup);\n  const repos = repositories(setup, values);\n\n  const payload: SetupRequestBody = {\n    name: deriveName(entry, values),\n    prompt: interpolateText(setup.prompt, scope),\n  };\n\n  if (repos.length > 0 && repoPicker?.field.provider) {\n    const declared = REPO_PROPERTIES.filter((name) => name in values);\n    payload.repos = repos.map((url) => ({\n      url,\n      ...Object.fromEntries(\n        declared.map((name) => [name, fieldText(values[name])]),\n      ),\n      provider: repoPicker.field.provider as string,\n    }));\n  }\n\n  // A filter is optional: an entry that declares none accepts every delivered\n  // event, so the key is left off rather than sent empty.\n  const trigger = buildTrigger(entry, values);\n  if (trigger) payload.trigger = trigger;\n\n  const template = buildTemplate(entry, values);\n  if (template) payload.template = template;\n\n  return payload;\n}\n\n/**\n * The `template` provenance a prompt entry sends, or undefined for one that\n * publishes no version.\n *\n * It is what lets the service recognise a second setup of the same entry as\n * the automation it already holds. The bundle path derives the same block from\n * the config the bundle declares; a prompt entry declares none, so the answer\n * to \"what was this created from\" is the form as submitted.\n */\nfunction buildTemplate(\n  entry: SetupEntry,\n  values: SetupFormValues,\n): SetupRequestBody | undefined {\n  if (!entry.version) return undefined;\n  return {\n    id: entry.id,\n    version: entry.version,\n    config: { ...values },\n  };\n}\n\n/**\n * The `trigger` object, read off the key and fields under `form.triggers`.\n *\n * Identical for both kinds of direct entry: only the create endpoint and what\n * the automation is told to do differ between a prompt and a bundle.\n */\nfunction buildTrigger(\n  entry: SetupEntry,\n  values: SetupFormValues,\n): SetupRequestBody | undefined {\n  const trigger = getTrigger(entry.setup);\n  if (!trigger) return undefined;\n\n  const properties = TRIGGER_PROPERTIES[trigger.kind];\n  const declared = Object.keys(trigger.fields).filter((name) =>\n    properties.includes(name),\n  );\n  const repoPicker = findRepoPickerField(entry.setup);\n\n  return {\n    type: trigger.kind,\n    ...Object.fromEntries(\n      declared.map((name) => [name, fieldText(values[name])]),\n    ),\n    ...(trigger.kind === \"event\" && {\n      source: repoPicker?.field.provider ?? \"\",\n      ...(entry.setup.filter && {\n        filter: interpolateText(entry.setup.filter, {\n          form: values,\n          automation: entry,\n        }),\n      }),\n    }),\n  };\n}\n\n/**\n * The raw create body a bundle entry produces.\n *\n * `tarball_path` is the one value neither declared nor derived: the host packs\n * and uploads the bundle first, and creates from what came back. `template` is\n * the provenance that makes enabling the same entry twice return the\n * automation that already exists rather than a second one.\n *\n * There is no `repos`: the raw endpoint has no such field, and a bundle's\n * script fetches what it needs itself.\n */\nfunction buildBundlePayload(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  tarballPath: string,\n): SetupRequestBody {\n  const bundle = entry.setup.bundle!;\n  const scope = { form: values, automation: entry };\n\n  const payload: SetupRequestBody = {\n    name: deriveName(entry, values),\n  };\n\n  const trigger = buildTrigger(entry, values);\n  if (trigger) payload.trigger = trigger;\n\n  payload.tarball_path = tarballPath;\n  payload.entrypoint = bundle.entrypoint;\n  if (bundle.setupScript) payload.setup_script_path = bundle.setupScript;\n  if (bundle.timeout !== undefined) payload.timeout = bundle.timeout;\n  payload.template = {\n    id: entry.id,\n    version: bundle.version,\n    config: interpolateConfig(bundle.config, scope) as SetupRequestBody,\n  };\n\n  return payload;\n}\n\n/**\n * Placeholder substitution over the config tree. Only string leaves are\n * templated; a number, a boolean or a null is written through as itself, so an\n * entry can state a value the script reads as the type it expects.\n */\nfunction interpolateConfig(\n  node: SetupBundleConfigValue,\n  scope: Parameters<typeof interpolateText>[1],\n): SetupBundleConfigValue {\n  if (typeof node === \"string\") {\n    return interpolateValue(node, scope);\n  }\n  if (Array.isArray(node)) {\n    return node.map((item) => interpolateConfig(item, scope));\n  }\n  if (typeof node === \"object\" && node !== null) {\n    return Object.fromEntries(\n      Object.entries(node).map(([key, value]) => [\n        key,\n        interpolateConfig(value, scope),\n      ]),\n    );\n  }\n  return node;\n}\n\n/**\n * The preflight body the host sends. The same shape for every entry, so no\n * entry declares it.\n */\nexport function buildPreflightBody(\n  entry: SetupEntry,\n  values: SetupFormValues,\n): SetupRequestBody | null {\n  const draft = buildCreatePayload(entry, values);\n  if (!draft) return null;\n\n  return {\n    automationId: entry.id,\n    endpoint: automationCreateEndpoint(entry),\n    draft,\n  };\n}\n\n/**\n * What an assisted entry sends into the conversation that finishes setup.\n *\n * The command is not declared either: it lives once, in the owning skill's own\n * `triggers` frontmatter, and the skill defaults to the entry's id. An entry\n * whose skill is invoked by description rather than by command contributes\n * nothing here, and the answers alone open the conversation.\n */\nexport function buildAssistedMessage(\n  entry: SetupEntry,\n  values: SetupFormValues,\n): string {\n  const command = findAutomationCommand(entry);\n  const message = entry.setup.message\n    ? interpolateText(entry.setup.message, { form: values, automation: entry })\n    : \"\";\n\n  return [command, message].filter(Boolean).join(\"\\n\\n\");\n}\n\nfunction collectPlaceholderFields(value: string): string[] {\n  const names = Array.from(\n    value.matchAll(FORM_PLACEHOLDER_PATTERN),\n    (match) => match[1],\n  );\n  return Array.from(new Set(names));\n}\n\n/**\n * Which form fields built each payload path.\n *\n * Preflight and the create endpoint reject a draft by payload path, and the\n * host has to turn that back into a highlighted input. Building the body with\n * each field standing in for its own value recovers the mapping exactly, so an\n * entry does not declare it.\n */\nexport function deriveErrorMap(entry: SetupEntry): Record<string, string[]> {\n  const mapping: Record<string, string[]> = {};\n\n  const standIns = Object.fromEntries(\n    Object.keys(collectFields(entry.setup)).map((name) => [\n      name,\n      `{{form.${name}}}`,\n    ]),\n  );\n  const template = buildCreatePayload(entry, standIns);\n  if (!template) return mapping;\n\n  const walk = (node: unknown, path: string): void => {\n    if (Array.isArray(node)) {\n      node.forEach((item, index) => walk(item, `${path}[${index}]`));\n      return;\n    }\n    if (typeof node === \"object\" && node !== null) {\n      Object.entries(node).forEach(([key, item]) =>\n        walk(item, path ? `${path}.${key}` : key),\n      );\n      return;\n    }\n    if (typeof node === \"string\") {\n      const names = collectPlaceholderFields(node);\n      if (names.length > 0) mapping[path] = names;\n    }\n  };\n\n  walk(template, \"\");\n  return mapping;\n}\n"],"mappings":"mKA2CA,SAAgB,EAAyB,EAA4B,CAInE,OAHI,GAAS,EAAc,CAAK,EACvB,EAAsB,cAAc,EAEtC,EAAA,sBAAsB,cAAc,CAC7C,CAGA,SAAgB,GAAmC,CACjD,OAAO,EAAsB,SAAS,CACxC,CAUA,SAAS,EACP,EACQ,CACR,IAAM,EAAO,EAAA,sBAAsB,CAAI,EACvC,GAAI,CAAC,EACH,MAAU,MACR,mDAAmD,EAAK,iFAE1D,EAEF,OAAO,CACT,CAiBA,SAAgB,EAAc,EAA4B,CACxD,OAAO,EAAM,MAAM,OAAS,UAAY,EAAM,MAAM,SAAW,IAAA,EACjE"}
+{"version":3,"file":"automation-setup.cjs","names":[],"sources":["../../src/manifests/automation-setup.ts"],"sourcesContent":["/**\n * The only module that knows a setup entry configures an *automation*.\n *\n * The published contract states just what varies between entries; everything\n * derivable is the host's to generate. That derivation is here, and nowhere\n * else, so the rest of `src/manifests/` stays about forms rather than about\n * automations.\n *\n * The algorithm mirrors `tests/test_automation_setup.py::_render_payload` in\n * `OpenHands/extensions`, which is the authoritative reference: it produces the\n * request bodies published in that repository's contract fixtures, and those\n * were verified against the live service. The create model is `extra=\"forbid\"`,\n * so any divergence is a hard 422 rather than a dropped field.\n */\n\nimport i18n from \"#/i18n\";\nimport { I18nKey } from \"#/i18n/declaration\";\nimport { findAutomationCommand } from \"#/utils/automation-catalog\";\nimport { getAutomationEndpoint } from \"./automation-interface\";\nimport {\n  actionKinds,\n  collectFields,\n  fieldText,\n  fieldValues,\n} from \"./manifest-local-validation\";\nimport { interpolateText, interpolateValue } from \"./manifest-template\";\nimport type {\n  SetupActionKind,\n  SetupBlock,\n  SetupBundleConfigValue,\n  SetupEntry,\n  SetupFormValues,\n  SetupRequestBody,\n  SetupTriggerKind,\n} from \"./types\";\n\n/**\n * The creation endpoint a derived draft would be posted to. Resolved on call\n * rather than at import, because the endpoint is the interface manifest's and\n * this module loads whether or not one was admitted.\n *\n * A bundle entry is created through the raw endpoint, because what it sends is\n * a tarball it uploaded rather than arguments to a preset. Called without an\n * entry - as the import path does - it answers for a prompt.\n */\nexport function automationCreateEndpoint(\n  entry?: SetupEntry,\n  selectedAction?: string | null,\n): string {\n  const kind = selectedActionKind(entry, selectedAction);\n  if (kind === \"plugin\") return getAutomationEndpoint(\"createPlugin\");\n  if (kind === \"upload\" || kind === \"bundle\") {\n    return requireBundleEndpoint(\"createBundle\");\n  }\n  return getAutomationEndpoint(\"createPrompt\");\n}\n\n/** Where a bundle's tarball is uploaded, before the create call. */\nexport function automationUploadEndpoint(): string {\n  return requireBundleEndpoint(\"uploads\");\n}\n\n/** The endpoints a bundle entry cannot be created without. */\nconst BUNDLE_ENDPOINTS = [\"createBundle\", \"uploads\"] as const;\n\n/**\n * An endpoint only a bundle needs. The interface manifest may predate bundles,\n * and the host holds no path of its own to fall back to, so this is where that\n * runs out rather than somewhere deep in a request.\n */\nfunction requireBundleEndpoint(\n  name: (typeof BUNDLE_ENDPOINTS)[number],\n): string {\n  const path = getAutomationEndpoint(name);\n  if (!path) {\n    throw new Error(\n      `The published automation interface declares no '${name}' endpoint, ` +\n        \"so this deployment cannot create an automation from a script bundle.\",\n    );\n  }\n  return path;\n}\n\n/**\n * The endpoints this entry needs that the published interface does not declare.\n *\n * Asked before the form renders rather than discovered at the moment of\n * creating: a pinned package that predates bundles can never answer, and the\n * dialog can say so while nothing has been filled in yet. Empty for every\n * entry that is not a bundle, which needs nothing beyond what the block has\n * always declared.\n */\nfunction missingEndpointsForAction(kind: SetupActionKind | \"bundle\"): string[] {\n  return kind === \"upload\" || kind === \"bundle\"\n    ? BUNDLE_ENDPOINTS.filter((name) => !getAutomationEndpoint(name))\n    : [];\n}\n\nexport function missingCreateEndpoints(\n  entry: SetupEntry,\n  selectedAction?: string | null,\n): string[] {\n  if (isBundleEntry(entry)) return missingEndpointsForAction(\"bundle\");\n  if (!entry.setup.actions) return [];\n\n  if (selectedAction && selectedAction in entry.setup.actions) {\n    return missingEndpointsForAction(selectedAction as SetupActionKind);\n  }\n\n  const missingByAction = actionKinds(entry.setup).map(\n    missingEndpointsForAction,\n  );\n  if (missingByAction.some((missing) => missing.length === 0)) return [];\n  return Array.from(new Set(missingByAction.flat()));\n}\n\n/** Whether this entry ships a script tarball instead of a prompt. */\nexport function isBundleEntry(entry: SetupEntry): boolean {\n  return entry.setup.mode === \"direct\" && entry.setup.bundle !== undefined;\n}\n\nexport function isUploadAction(\n  entry: SetupEntry,\n  selectedAction?: string | null,\n): boolean {\n  return selectedActionKind(entry, selectedAction) === \"upload\";\n}\n\nexport function selectedActionKind(\n  entry: SetupEntry | undefined,\n  selectedAction?: string | null,\n): SetupActionKind | \"bundle\" | \"prompt\" {\n  if (!entry) return \"prompt\";\n  if (isBundleEntry(entry)) return \"bundle\";\n  const actions = entry.setup.actions ?? {};\n  if (selectedAction && selectedAction in actions) {\n    return selectedAction as SetupActionKind;\n  }\n  const keys = actionKinds(entry.setup);\n  if (keys.length === 1) return keys[0];\n  return \"prompt\";\n}\n\n/**\n * The `tarball_path` a preflight draft carries.\n *\n * Preflight runs on every field blur and the upload happens once, at submit,\n * so there is no real path to send yet. The service checks this field's scheme\n * at preflight and its ownership only at creation, so a well-formed stand-in\n * validates exactly what preflight is for - the rest of the body - without\n * uploading an archive per keystroke.\n */\nexport const PREFLIGHT_TARBALL_PATH =\n  \"oh-internal://uploads/00000000-0000-0000-0000-000000000000\";\n\n/**\n * Trigger properties a form field may fill, per trigger kind. A field under a\n * trigger kind whose name is listed here fills the trigger property of the same\n * name; anything else there, such as a phrase to match, is an input to `filter`.\n */\nconst TRIGGER_PROPERTIES: Record<SetupTriggerKind, readonly string[]> = {\n  cron: [\"schedule\", \"timezone\"],\n  event: [\"source\", \"on\"],\n};\n\nconst OPTIONAL_CREATE_PROPERTIES = [\"model\", \"timeout\"] as const;\n\n/**\n * Repository properties a form field may fill, read the same way\n * {@link TRIGGER_PROPERTIES} is: a field whose name is listed here fills the\n * `repos[]` property of the same name. `url` and `provider` are absent because\n * neither is answered by a field of its own — they come from the repo-picker's\n * value and from its declared provider.\n *\n * These two lists are the only field names the derivation knows; everything\n * else it reads it finds by field type. An entry that wants a base branch in\n * its request therefore has to name that field `ref`.\n */\nconst REPO_PROPERTIES: readonly string[] = [\"ref\"];\n\nconst FORM_PLACEHOLDER_PATTERN = /\\{\\{form\\.([A-Za-z0-9_.]+)\\}\\}/g;\n\n/** The repository input, which supplies `repos` and an event trigger's source. */\nfunction findRepoPickerField(\n  setup: SetupBlock,\n  selectedAction?: string | null,\n) {\n  const match = Object.entries(collectFields(setup, null, selectedAction)).find(\n    ([, field]) => field.type === \"repo-picker\",\n  );\n  return match ? { name: match[0], field: match[1] } : null;\n}\n\n/** Every repository the form collected, whether the picker takes one or many. */\nfunction repositories(\n  setup: SetupBlock,\n  values: SetupFormValues,\n  selectedAction?: string | null,\n): string[] {\n  const picker = findRepoPickerField(setup, selectedAction);\n  return picker ? fieldValues(values[picker.name]) : [];\n}\n\n/**\n * The created automation's name.\n *\n * One repository is worth naming; several are not, so the count stands in\n * rather than a list of names that would not fit.\n */\nfunction deriveName(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  selectedAction?: string | null,\n): string {\n  if (\n    \"name\" in collectFields(entry.setup, null, selectedAction) &&\n    \"name\" in values\n  ) {\n    return fieldText(values.name);\n  }\n\n  const repos = repositories(entry.setup, values, selectedAction);\n  if (repos.length === 0) return entry.name;\n  if (repos.length === 1) return `${entry.name} - ${repos[0]}`;\n  // The count is the one word here the host writes rather than reads off the\n  // entry, so it is translated. There is no translator to pass in: the\n  // derivation runs from a memo, an upload and a test alike.\n  const count = i18n.t(I18nKey.SETUP$REPOSITORY_COUNT, {\n    total: repos.length,\n  });\n  return `${entry.name} - ${count}`;\n}\n\n/** The active trigger kind for a direct entry, with its fields. */\nfunction getTrigger(setup: SetupBlock, selectedTrigger?: string | null) {\n  const triggers = setup.form.triggers ?? {};\n  const entries = Object.entries(triggers);\n  if (entries.length === 0) return null;\n  const match =\n    selectedTrigger && selectedTrigger in triggers\n      ? [selectedTrigger, triggers[selectedTrigger as SetupTriggerKind]]\n      : entries.length === 1\n        ? entries[0]\n        : null;\n  if (!match) return null;\n  const [kind, fields] = match;\n  return { kind: kind as SetupTriggerKind, fields: fields ?? {} };\n}\n\nfunction hasPayloadValue(\n  value: SetupRequestBody[string] | undefined,\n): value is SetupRequestBody[string] {\n  return value !== undefined && value !== null && value !== \"\";\n}\n\nfunction fieldPayloadValue(\n  fieldType: string | undefined,\n  value: SetupFormValues[string],\n) {\n  if (fieldType === \"number\") {\n    const text = fieldText(value);\n    return text === \"\" ? undefined : Number(text);\n  }\n  return fieldText(value);\n}\n\nfunction optionalCreateProperties(\n  setup: SetupBlock,\n  values: SetupFormValues,\n  selectedAction?: string | null,\n): SetupRequestBody {\n  return Object.fromEntries(\n    OPTIONAL_CREATE_PROPERTIES.flatMap((name) => {\n      const field = collectFields(setup, null, selectedAction)[name];\n      const value = fieldPayloadValue(field?.type, values[name]);\n      return hasPayloadValue(value) ? [[name, value]] : [];\n    }),\n  ) as SetupRequestBody;\n}\n\nfunction repositoryProperty(\n  setup: SetupBlock,\n  values: SetupFormValues,\n  selectedAction?: string | null,\n): SetupRequestBody {\n  const repoPicker = findRepoPickerField(setup, selectedAction);\n  const repos = repositories(setup, values, selectedAction);\n  if (repos.length === 0 || !repoPicker?.field.provider) return {};\n\n  const declared = REPO_PROPERTIES.filter((name) =>\n    hasPayloadValue(fieldText(values[name])),\n  );\n  return {\n    repos: repos.map((url) => ({\n      url,\n      ...Object.fromEntries(\n        declared.map((name) => [name, fieldText(values[name])]),\n      ),\n      provider: repoPicker.field.provider as string,\n    })),\n  };\n}\n\nfunction parsePluginSources(\n  value: SetupRequestBody[string],\n): SetupRequestBody[string] {\n  if (!hasPayloadValue(value) || typeof value !== \"string\") return value;\n  const trimmed = value.trim();\n  if (!trimmed) return [];\n  if (trimmed.startsWith(\"[\")) {\n    try {\n      return JSON.parse(trimmed) as SetupRequestBody[string];\n    } catch {\n      return [{ source: trimmed }];\n    }\n  }\n  return trimmed\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter(Boolean)\n    .map((line) => {\n      const [source, ...parts] = line.split(/\\s+/);\n      const plugin: Record<string, string> = { source };\n      parts.forEach((part) => {\n        const [key, ...raw] = part.split(\"=\");\n        const valuePart = raw.join(\"=\");\n        if ((key === \"ref\" || key === \"repo_path\") && valuePart) {\n          plugin[key] = valuePart;\n        }\n      });\n      return plugin;\n    });\n}\n\n/**\n * The create request body these form values produce.\n *\n * No entry declares it: `name` comes from the entry, `repos` from the\n * repo-picker field and its declared provider, and `trigger` from the key and\n * fields under `form.triggers`. Only `prompt` and an event `filter` are\n * declared, because only they cannot be read off the form.\n *\n * Returns null for an assisted entry, which hands setup to a conversation\n * instead of sending a body.\n */\nexport function buildCreatePayload(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  /** Bundle/upload entries only: what the upload returned. */\n  tarballPath: string = PREFLIGHT_TARBALL_PATH,\n  selectedTrigger?: string | null,\n  selectedActionKey?: string | null,\n): SetupRequestBody | null {\n  const { setup } = entry;\n  if (setup.mode !== \"direct\") return null;\n  if (setup.bundle) {\n    return buildBundlePayload(entry, values, tarballPath, selectedTrigger);\n  }\n  if (setup.actions) {\n    return buildActionPayload(\n      entry,\n      values,\n      tarballPath,\n      selectedTrigger,\n      selectedActionKey,\n    );\n  }\n  if (!setup.prompt) return null;\n\n  const scope = { form: values, automation: entry };\n\n  const payload: SetupRequestBody = {\n    name: deriveName(entry, values),\n    prompt: interpolateText(setup.prompt, scope),\n    ...optionalCreateProperties(setup, values),\n    ...repositoryProperty(setup, values),\n  };\n\n  const trigger = buildTrigger(entry, values, selectedTrigger);\n  if (trigger) payload.trigger = trigger;\n\n  const template = buildTemplate(entry, values);\n  if (template) payload.template = template;\n\n  return payload;\n}\n\nfunction buildActionPayload(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  tarballPath: string,\n  selectedTrigger?: string | null,\n  selectedActionKey?: string | null,\n): SetupRequestBody | null {\n  const kind = selectedActionKind(entry, selectedActionKey);\n  if (kind === \"bundle\") return null;\n\n  const setup = entry.setup;\n  const scope = { form: values, automation: entry };\n  const payload: SetupRequestBody = {\n    name: deriveName(entry, values, selectedActionKey),\n  };\n\n  const trigger = buildTrigger(\n    entry,\n    values,\n    selectedTrigger,\n    selectedActionKey,\n  );\n  if (trigger) payload.trigger = trigger;\n\n  Object.assign(\n    payload,\n    optionalCreateProperties(setup, values, selectedActionKey),\n  );\n\n  if (kind === \"upload\") {\n    const action = setup.actions?.upload;\n    if (!action) return null;\n    payload.tarball_path =\n      tarballPath || interpolateText(action.tarballPath, scope);\n    payload.entrypoint = interpolateText(action.entrypoint, scope);\n    if (action.setupScript) {\n      const setupScript = interpolateText(action.setupScript, scope);\n      if (hasPayloadValue(setupScript)) payload.setup_script_path = setupScript;\n    }\n    return payload;\n  }\n\n  const action =\n    kind === \"plugin\" ? setup.actions?.plugin : setup.actions?.prompt;\n  if (!action) return null;\n  payload.prompt = interpolateText(action.prompt, scope);\n  Object.assign(payload, repositoryProperty(setup, values, selectedActionKey));\n\n  if (kind === \"plugin\") {\n    const pluginAction = setup.actions?.plugin;\n    if (!pluginAction) return null;\n    payload.plugins = parsePluginSources(\n      interpolateValue(pluginAction.plugins, scope),\n    );\n  }\n\n  const template = buildTemplate(entry, values);\n  if (template) payload.template = template;\n\n  return payload;\n}\n\n/**\n * The `template` provenance a prompt entry sends, or undefined for one that\n * publishes no version.\n *\n * It is what lets the service recognise a second setup of the same entry as\n * the automation it already holds. The bundle path derives the same block from\n * the config the bundle declares; a prompt entry declares none, so the answer\n * to \"what was this created from\" is the form as submitted.\n */\nfunction buildTemplate(\n  entry: SetupEntry,\n  values: SetupFormValues,\n): SetupRequestBody | undefined {\n  if (!entry.version) return undefined;\n  return {\n    id: entry.id,\n    version: entry.version,\n    config: { ...values } as SetupRequestBody,\n  };\n}\n\n/**\n * The `trigger` object, read off the key and fields under `form.triggers`.\n *\n * Identical for both kinds of direct entry: only the create endpoint and what\n * the automation is told to do differ between a prompt and a bundle.\n */\nfunction buildTrigger(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupRequestBody | undefined {\n  const trigger = getTrigger(entry.setup, selectedTrigger);\n  if (!trigger) return undefined;\n\n  const properties = TRIGGER_PROPERTIES[trigger.kind];\n  const declared = Object.keys(trigger.fields).filter((name) =>\n    properties.includes(name),\n  );\n  const repoPicker = findRepoPickerField(entry.setup, selectedAction);\n  const derived = Object.fromEntries(\n    declared\n      .map((name) => [name, fieldText(values[name])])\n      .filter(([, value]) => hasPayloadValue(value)),\n  );\n\n  const filter = entry.setup.filter\n    ? interpolateText(entry.setup.filter, {\n        form: values,\n        automation: entry,\n      })\n    : undefined;\n\n  return {\n    type: trigger.kind,\n    ...derived,\n    ...(trigger.kind === \"event\" && {\n      ...(!(\"source\" in derived) && {\n        source: repoPicker?.field.provider ?? \"\",\n      }),\n      ...(hasPayloadValue(filter) && { filter }),\n    }),\n  };\n}\n\n/**\n * The raw create body a bundle entry produces.\n *\n * `tarball_path` is the one value neither declared nor derived: the host packs\n * and uploads the bundle first, and creates from what came back. `template` is\n * the provenance that makes enabling the same entry twice return the\n * automation that already exists rather than a second one.\n *\n * There is no `repos`: the raw endpoint has no such field, and a bundle's\n * script fetches what it needs itself.\n */\nfunction buildBundlePayload(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  tarballPath: string,\n  selectedTrigger?: string | null,\n): SetupRequestBody {\n  const bundle = entry.setup.bundle!;\n  const scope = { form: values, automation: entry };\n\n  const payload: SetupRequestBody = {\n    name: deriveName(entry, values),\n  };\n\n  const trigger = buildTrigger(entry, values, selectedTrigger);\n  if (trigger) payload.trigger = trigger;\n\n  payload.tarball_path = tarballPath;\n  payload.entrypoint = bundle.entrypoint;\n  if (bundle.setupScript) payload.setup_script_path = bundle.setupScript;\n  if (bundle.timeout !== undefined) payload.timeout = bundle.timeout;\n  payload.template = {\n    id: entry.id,\n    version: bundle.version,\n    config: interpolateConfig(bundle.config, scope) as SetupRequestBody,\n  };\n\n  return payload;\n}\n\n/**\n * Placeholder substitution over the config tree. Only string leaves are\n * templated; a number, a boolean or a null is written through as itself, so an\n * entry can state a value the script reads as the type it expects.\n */\nfunction interpolateConfig(\n  node: SetupBundleConfigValue,\n  scope: Parameters<typeof interpolateText>[1],\n): SetupBundleConfigValue {\n  if (typeof node === \"string\") {\n    return interpolateValue(node, scope);\n  }\n  if (Array.isArray(node)) {\n    return node.map((item) => interpolateConfig(item, scope));\n  }\n  if (typeof node === \"object\" && node !== null) {\n    return Object.fromEntries(\n      Object.entries(node).map(([key, value]) => [\n        key,\n        interpolateConfig(value, scope),\n      ]),\n    );\n  }\n  return node;\n}\n\n/**\n * The preflight body the host sends. The same shape for every entry, so no\n * entry declares it.\n */\nexport function buildPreflightBody(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupRequestBody | null {\n  const draft = buildCreatePayload(\n    entry,\n    values,\n    PREFLIGHT_TARBALL_PATH,\n    selectedTrigger,\n    selectedAction,\n  );\n  if (!draft) return null;\n\n  return {\n    automationId: entry.id,\n    endpoint: automationCreateEndpoint(entry, selectedAction),\n    draft,\n  };\n}\n\n/**\n * What an assisted entry sends into the conversation that finishes setup.\n *\n * The command is not declared either: it lives once, in the owning skill's own\n * `triggers` frontmatter, and the skill defaults to the entry's id. An entry\n * whose skill is invoked by description rather than by command contributes\n * nothing here, and the answers alone open the conversation.\n */\nexport function buildAssistedMessage(\n  entry: SetupEntry,\n  values: SetupFormValues,\n): string {\n  const command = findAutomationCommand(entry);\n  const message = entry.setup.message\n    ? interpolateText(entry.setup.message, { form: values, automation: entry })\n    : \"\";\n\n  return [command, message].filter(Boolean).join(\"\\n\\n\");\n}\n\nfunction collectPlaceholderFields(value: string): string[] {\n  const names = Array.from(\n    value.matchAll(FORM_PLACEHOLDER_PATTERN),\n    (match) => match[1],\n  );\n  return Array.from(new Set(names));\n}\n\n/**\n * Which form fields built each payload path.\n *\n * Preflight and the create endpoint reject a draft by payload path, and the\n * host has to turn that back into a highlighted input. Building the body with\n * each field standing in for its own value recovers the mapping exactly, so an\n * entry does not declare it.\n */\nexport function deriveErrorMap(\n  entry: SetupEntry,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): Record<string, string[]> {\n  const mapping: Record<string, string[]> = {};\n\n  const triggerEntries = Object.keys(entry.setup.form.triggers ?? {});\n  const triggerVariants = selectedTrigger\n    ? [selectedTrigger]\n    : triggerEntries.length > 1\n      ? triggerEntries\n      : [null];\n\n  const actionEntries = actionKinds(entry.setup);\n  const actionVariants = selectedAction\n    ? [selectedAction]\n    : actionEntries.length > 1\n      ? actionEntries\n      : [null];\n\n  const walk = (node: unknown, path: string): void => {\n    if (Array.isArray(node)) {\n      node.forEach((item, index) => walk(item, `${path}[${index}]`));\n      return;\n    }\n    if (typeof node === \"object\" && node !== null) {\n      Object.entries(node).forEach(([key, item]) =>\n        walk(item, path ? `${path}.${key}` : key),\n      );\n      return;\n    }\n    if (typeof node === \"string\") {\n      const names = collectPlaceholderFields(node);\n      if (names.length > 0) {\n        mapping[path] = Array.from(\n          new Set([...(mapping[path] ?? []), ...names]),\n        );\n      }\n    }\n  };\n\n  actionVariants.forEach((actionVariant) => {\n    triggerVariants.forEach((triggerVariant) => {\n      const names = Object.keys(\n        collectFields(entry.setup, triggerVariant, actionVariant),\n      );\n      const variantStandIns = Object.fromEntries(\n        names.map((name) => [name, `{{form.${name}}}`]),\n      );\n      const template = buildCreatePayload(\n        entry,\n        variantStandIns,\n        actionVariant === \"upload\" ? \"\" : PREFLIGHT_TARBALL_PATH,\n        triggerVariant,\n        actionVariant,\n      );\n      if (template) walk(template, \"\");\n    });\n  });\n  return mapping;\n}\n"],"mappings":"gNA6CA,SAAgB,EACd,EACA,EACQ,CACR,IAAM,EAAO,EAAmB,EAAO,CAAc,EAKrD,OAJI,IAAS,SAAiB,EAAA,sBAAsB,cAAc,EAC9D,IAAS,UAAY,IAAS,SACzB,EAAsB,cAAc,EAEtC,EAAA,sBAAsB,cAAc,CAC7C,CAGA,SAAgB,GAAmC,CACjD,OAAO,EAAsB,SAAS,CACxC,CAUA,SAAS,EACP,EACQ,CACR,IAAM,EAAO,EAAA,sBAAsB,CAAI,EACvC,GAAI,CAAC,EACH,MAAU,MACR,mDAAmD,EAAK,iFAE1D,EAEF,OAAO,CACT,CAoCA,SAAgB,EAAc,EAA4B,CACxD,OAAO,EAAM,MAAM,OAAS,UAAY,EAAM,MAAM,SAAW,IAAA,EACjE,CASA,SAAgB,EACd,EACA,EACuC,CACvC,GAAI,CAAC,EAAO,MAAO,SACnB,GAAI,EAAc,CAAK,EAAG,MAAO,SACjC,IAAM,EAAU,EAAM,MAAM,SAAW,CAAC,EACxC,GAAI,GAAkB,KAAkB,EACtC,OAAO,EAET,IAAM,EAAO,EAAA,YAAY,EAAM,KAAK,EAEpC,OADI,EAAK,SAAW,EAAU,EAAK,GAC5B,QACT"}

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

@@ -12,7 +12,7 @@
  * were verified against the live service. The create model is `extra="forbid"`,
  * so any divergence is a hard 422 rather than a dropped field.
  */
-import type { SetupEntry, SetupFormValues, SetupRequestBody } from "./types";
+import type { SetupActionKind, SetupEntry, SetupFormValues, SetupRequestBody } from "./types";
 /**
  * The creation endpoint a derived draft would be posted to. Resolved on call
  * rather than at import, because the endpoint is the interface manifest's and
@@ -22,21 +22,14 @@ import type { SetupEntry, SetupFormValues, SetupRequestBody } from "./types";
  * a tarball it uploaded rather than arguments to a preset. Called without an
  * entry - as the import path does - it answers for a prompt.
  */
-export declare function automationCreateEndpoint(entry?: SetupEntry): string;
+export declare function automationCreateEndpoint(entry?: SetupEntry, selectedAction?: string | null): string;
 /** Where a bundle's tarball is uploaded, before the create call. */
 export declare function automationUploadEndpoint(): string;
-/**
- * The endpoints this entry needs that the published interface does not declare.
- *
- * Asked before the form renders rather than discovered at the moment of
- * creating: a pinned package that predates bundles can never answer, and the
- * dialog can say so while nothing has been filled in yet. Empty for every
- * entry that is not a bundle, which needs nothing beyond what the block has
- * always declared.
- */
-export declare function missingCreateEndpoints(entry: SetupEntry): string[];
+export declare function missingCreateEndpoints(entry: SetupEntry, selectedAction?: string | null): string[];
 /** Whether this entry ships a script tarball instead of a prompt. */
 export declare function isBundleEntry(entry: SetupEntry): boolean;
+export declare function isUploadAction(entry: SetupEntry, selectedAction?: string | null): boolean;
+export declare function selectedActionKind(entry: SetupEntry | undefined, selectedAction?: string | null): SetupActionKind | "bundle" | "prompt";
 /**
  * The `tarball_path` a preflight draft carries.
  *
@@ -59,13 +52,13 @@ export declare const PREFLIGHT_TARBALL_PATH = "oh-internal://uploads/00000000-00
  * instead of sending a body.
  */
 export declare function buildCreatePayload(entry: SetupEntry, values: SetupFormValues, 
-/** Bundle entries only: what the upload returned. */
-tarballPath?: string): SetupRequestBody | null;
+/** Bundle/upload entries only: what the upload returned. */
+tarballPath?: string, selectedTrigger?: string | null, selectedActionKey?: string | null): SetupRequestBody | null;
 /**
  * The preflight body the host sends. The same shape for every entry, so no
  * entry declares it.
  */
-export declare function buildPreflightBody(entry: SetupEntry, values: SetupFormValues): SetupRequestBody | null;
+export declare function buildPreflightBody(entry: SetupEntry, values: SetupFormValues, selectedTrigger?: string | null, selectedAction?: string | null): SetupRequestBody | null;
 /**
  * What an assisted entry sends into the conversation that finishes setup.
  *
@@ -83,4 +76,4 @@ export declare function buildAssistedMessage(entry: SetupEntry, values: SetupFor
  * each field standing in for its own value recovers the mapping exactly, so an
  * entry does not declare it.
  */
-export declare function deriveErrorMap(entry: SetupEntry): Record<string, string[]>;
+export declare function deriveErrorMap(entry: SetupEntry, selectedTrigger?: string | null, selectedAction?: string | null): Record<string, string[]>;

package/dist/manifests/automation-setup.js

@@ -1,22 +1,32 @@
 import "../i18n/index.js";
 import "../utils/automation-catalog.js";
 import { getAutomationEndpoint as e } from "./automation-interface.js";
+import { actionKinds as t } from "./manifest-local-validation.js";
 //#region src/manifests/automation-setup.ts
-function t(t) {
-	return t && i(t) ? r("createBundle") : e("createPrompt");
+function n(t, n) {
+	let r = o(t, n);
+	return r === "plugin" ? e("createPlugin") : r === "upload" || r === "bundle" ? i("createBundle") : e("createPrompt");
 }
-function n() {
-	return r("uploads");
+function r() {
+	return i("uploads");
 }
-function r(t) {
+function i(t) {
 	let n = e(t);
 	if (!n) throw Error(`The published automation interface declares no '${t}' endpoint, so this deployment cannot create an automation from a script bundle.`);
 	return n;
 }
-function i(e) {
+function a(e) {
 	return e.setup.mode === "direct" && e.setup.bundle !== void 0;
 }
+function o(e, n) {
+	if (!e) return "prompt";
+	if (a(e)) return "bundle";
+	let r = e.setup.actions ?? {};
+	if (n && n in r) return n;
+	let i = t(e.setup);
+	return i.length === 1 ? i[0] : "prompt";
+}
 //#endregion
-export { t as automationCreateEndpoint, n as automationUploadEndpoint };
+export { n as automationCreateEndpoint, r as automationUploadEndpoint };
 
 //# sourceMappingURL=automation-setup.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"automation-setup.js","names":[],"sources":["../../src/manifests/automation-setup.ts"],"sourcesContent":["/**\n * The only module that knows a setup entry configures an *automation*.\n *\n * The published contract states just what varies between entries; everything\n * derivable is the host's to generate. That derivation is here, and nowhere\n * else, so the rest of `src/manifests/` stays about forms rather than about\n * automations.\n *\n * The algorithm mirrors `tests/test_automation_setup.py::_render_payload` in\n * `OpenHands/extensions`, which is the authoritative reference: it produces the\n * request bodies published in that repository's contract fixtures, and those\n * were verified against the live service. The create model is `extra=\"forbid\"`,\n * so any divergence is a hard 422 rather than a dropped field.\n */\n\nimport i18n from \"#/i18n\";\nimport { I18nKey } from \"#/i18n/declaration\";\nimport { findAutomationCommand } from \"#/utils/automation-catalog\";\nimport { getAutomationEndpoint } from \"./automation-interface\";\nimport {\n  collectFields,\n  fieldText,\n  fieldValues,\n} from \"./manifest-local-validation\";\nimport { interpolateText, interpolateValue } from \"./manifest-template\";\nimport type {\n  SetupBlock,\n  SetupBundleConfigValue,\n  SetupEntry,\n  SetupFormValues,\n  SetupRequestBody,\n  SetupTriggerKind,\n} from \"./types\";\n\n/**\n * The creation endpoint a derived draft would be posted to. Resolved on call\n * rather than at import, because the endpoint is the interface manifest's and\n * this module loads whether or not one was admitted.\n *\n * A bundle entry is created through the raw endpoint, because what it sends is\n * a tarball it uploaded rather than arguments to a preset. Called without an\n * entry - as the import path does - it answers for a prompt.\n */\nexport function automationCreateEndpoint(entry?: SetupEntry): string {\n  if (entry && isBundleEntry(entry)) {\n    return requireBundleEndpoint(\"createBundle\");\n  }\n  return getAutomationEndpoint(\"createPrompt\");\n}\n\n/** Where a bundle's tarball is uploaded, before the create call. */\nexport function automationUploadEndpoint(): string {\n  return requireBundleEndpoint(\"uploads\");\n}\n\n/** The endpoints a bundle entry cannot be created without. */\nconst BUNDLE_ENDPOINTS = [\"createBundle\", \"uploads\"] as const;\n\n/**\n * An endpoint only a bundle needs. The interface manifest may predate bundles,\n * and the host holds no path of its own to fall back to, so this is where that\n * runs out rather than somewhere deep in a request.\n */\nfunction requireBundleEndpoint(\n  name: (typeof BUNDLE_ENDPOINTS)[number],\n): string {\n  const path = getAutomationEndpoint(name);\n  if (!path) {\n    throw new Error(\n      `The published automation interface declares no '${name}' endpoint, ` +\n        \"so this deployment cannot create an automation from a script bundle.\",\n    );\n  }\n  return path;\n}\n\n/**\n * The endpoints this entry needs that the published interface does not declare.\n *\n * Asked before the form renders rather than discovered at the moment of\n * creating: a pinned package that predates bundles can never answer, and the\n * dialog can say so while nothing has been filled in yet. Empty for every\n * entry that is not a bundle, which needs nothing beyond what the block has\n * always declared.\n */\nexport function missingCreateEndpoints(entry: SetupEntry): string[] {\n  if (!isBundleEntry(entry)) return [];\n  return BUNDLE_ENDPOINTS.filter((name) => !getAutomationEndpoint(name));\n}\n\n/** Whether this entry ships a script tarball instead of a prompt. */\nexport function isBundleEntry(entry: SetupEntry): boolean {\n  return entry.setup.mode === \"direct\" && entry.setup.bundle !== undefined;\n}\n\n/**\n * The `tarball_path` a preflight draft carries.\n *\n * Preflight runs on every field blur and the upload happens once, at submit,\n * so there is no real path to send yet. The service checks this field's scheme\n * at preflight and its ownership only at creation, so a well-formed stand-in\n * validates exactly what preflight is for - the rest of the body - without\n * uploading an archive per keystroke.\n */\nexport const PREFLIGHT_TARBALL_PATH =\n  \"oh-internal://uploads/00000000-0000-0000-0000-000000000000\";\n\n/**\n * Trigger properties a form field may fill, per trigger kind. A field under a\n * trigger kind whose name is listed here fills the trigger property of the same\n * name; anything else there, such as a phrase to match, is an input to `filter`.\n */\nconst TRIGGER_PROPERTIES: Record<SetupTriggerKind, readonly string[]> = {\n  cron: [\"schedule\", \"timezone\"],\n  event: [\"on\"],\n};\n\n/**\n * Repository properties a form field may fill, read the same way\n * {@link TRIGGER_PROPERTIES} is: a field whose name is listed here fills the\n * `repos[]` property of the same name. `url` and `provider` are absent because\n * neither is answered by a field of its own — they come from the repo-picker's\n * value and from its declared provider.\n *\n * These two lists are the only field names the derivation knows; everything\n * else it reads it finds by field type. An entry that wants a base branch in\n * its request therefore has to name that field `ref`.\n */\nconst REPO_PROPERTIES: readonly string[] = [\"ref\"];\n\nconst FORM_PLACEHOLDER_PATTERN = /\\{\\{form\\.([A-Za-z0-9_.]+)\\}\\}/g;\n\n/** The repository input, which supplies `repos` and an event trigger's source. */\nfunction findRepoPickerField(setup: SetupBlock) {\n  const match = Object.entries(collectFields(setup)).find(\n    ([, field]) => field.type === \"repo-picker\",\n  );\n  return match ? { name: match[0], field: match[1] } : null;\n}\n\n/** Every repository the form collected, whether the picker takes one or many. */\nfunction repositories(setup: SetupBlock, values: SetupFormValues): string[] {\n  const picker = findRepoPickerField(setup);\n  return picker ? fieldValues(values[picker.name]) : [];\n}\n\n/**\n * The created automation's name.\n *\n * One repository is worth naming; several are not, so the count stands in\n * rather than a list of names that would not fit.\n */\nfunction deriveName(entry: SetupEntry, values: SetupFormValues): string {\n  const repos = repositories(entry.setup, values);\n  if (repos.length === 0) return entry.name;\n  if (repos.length === 1) return `${entry.name} - ${repos[0]}`;\n  // The count is the one word here the host writes rather than reads off the\n  // entry, so it is translated. There is no translator to pass in: the\n  // derivation runs from a memo, an upload and a test alike.\n  const count = i18n.t(I18nKey.SETUP$REPOSITORY_COUNT, {\n    total: repos.length,\n  });\n  return `${entry.name} - ${count}`;\n}\n\n/** The single trigger kind a direct entry declares, with its fields. */\nfunction getTrigger(setup: SetupBlock) {\n  const entries = Object.entries(setup.form.triggers ?? {});\n  if (entries.length === 0) return null;\n  const [kind, fields] = entries[0];\n  return { kind: kind as SetupTriggerKind, fields: fields ?? {} };\n}\n\n/**\n * The create request body these form values produce.\n *\n * No entry declares it: `name` comes from the entry, `repos` from the\n * repo-picker field and its declared provider, and `trigger` from the key and\n * fields under `form.triggers`. Only `prompt` and an event `filter` are\n * declared, because only they cannot be read off the form.\n *\n * Returns null for an assisted entry, which hands setup to a conversation\n * instead of sending a body.\n */\nexport function buildCreatePayload(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  /** Bundle entries only: what the upload returned. */\n  tarballPath: string = PREFLIGHT_TARBALL_PATH,\n): SetupRequestBody | null {\n  const { setup } = entry;\n  if (setup.mode !== \"direct\") return null;\n  if (setup.bundle) return buildBundlePayload(entry, values, tarballPath);\n  if (!setup.prompt) return null;\n\n  const scope = { form: values, automation: entry };\n  const repoPicker = findRepoPickerField(setup);\n  const repos = repositories(setup, values);\n\n  const payload: SetupRequestBody = {\n    name: deriveName(entry, values),\n    prompt: interpolateText(setup.prompt, scope),\n  };\n\n  if (repos.length > 0 && repoPicker?.field.provider) {\n    const declared = REPO_PROPERTIES.filter((name) => name in values);\n    payload.repos = repos.map((url) => ({\n      url,\n      ...Object.fromEntries(\n        declared.map((name) => [name, fieldText(values[name])]),\n      ),\n      provider: repoPicker.field.provider as string,\n    }));\n  }\n\n  // A filter is optional: an entry that declares none accepts every delivered\n  // event, so the key is left off rather than sent empty.\n  const trigger = buildTrigger(entry, values);\n  if (trigger) payload.trigger = trigger;\n\n  const template = buildTemplate(entry, values);\n  if (template) payload.template = template;\n\n  return payload;\n}\n\n/**\n * The `template` provenance a prompt entry sends, or undefined for one that\n * publishes no version.\n *\n * It is what lets the service recognise a second setup of the same entry as\n * the automation it already holds. The bundle path derives the same block from\n * the config the bundle declares; a prompt entry declares none, so the answer\n * to \"what was this created from\" is the form as submitted.\n */\nfunction buildTemplate(\n  entry: SetupEntry,\n  values: SetupFormValues,\n): SetupRequestBody | undefined {\n  if (!entry.version) return undefined;\n  return {\n    id: entry.id,\n    version: entry.version,\n    config: { ...values },\n  };\n}\n\n/**\n * The `trigger` object, read off the key and fields under `form.triggers`.\n *\n * Identical for both kinds of direct entry: only the create endpoint and what\n * the automation is told to do differ between a prompt and a bundle.\n */\nfunction buildTrigger(\n  entry: SetupEntry,\n  values: SetupFormValues,\n): SetupRequestBody | undefined {\n  const trigger = getTrigger(entry.setup);\n  if (!trigger) return undefined;\n\n  const properties = TRIGGER_PROPERTIES[trigger.kind];\n  const declared = Object.keys(trigger.fields).filter((name) =>\n    properties.includes(name),\n  );\n  const repoPicker = findRepoPickerField(entry.setup);\n\n  return {\n    type: trigger.kind,\n    ...Object.fromEntries(\n      declared.map((name) => [name, fieldText(values[name])]),\n    ),\n    ...(trigger.kind === \"event\" && {\n      source: repoPicker?.field.provider ?? \"\",\n      ...(entry.setup.filter && {\n        filter: interpolateText(entry.setup.filter, {\n          form: values,\n          automation: entry,\n        }),\n      }),\n    }),\n  };\n}\n\n/**\n * The raw create body a bundle entry produces.\n *\n * `tarball_path` is the one value neither declared nor derived: the host packs\n * and uploads the bundle first, and creates from what came back. `template` is\n * the provenance that makes enabling the same entry twice return the\n * automation that already exists rather than a second one.\n *\n * There is no `repos`: the raw endpoint has no such field, and a bundle's\n * script fetches what it needs itself.\n */\nfunction buildBundlePayload(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  tarballPath: string,\n): SetupRequestBody {\n  const bundle = entry.setup.bundle!;\n  const scope = { form: values, automation: entry };\n\n  const payload: SetupRequestBody = {\n    name: deriveName(entry, values),\n  };\n\n  const trigger = buildTrigger(entry, values);\n  if (trigger) payload.trigger = trigger;\n\n  payload.tarball_path = tarballPath;\n  payload.entrypoint = bundle.entrypoint;\n  if (bundle.setupScript) payload.setup_script_path = bundle.setupScript;\n  if (bundle.timeout !== undefined) payload.timeout = bundle.timeout;\n  payload.template = {\n    id: entry.id,\n    version: bundle.version,\n    config: interpolateConfig(bundle.config, scope) as SetupRequestBody,\n  };\n\n  return payload;\n}\n\n/**\n * Placeholder substitution over the config tree. Only string leaves are\n * templated; a number, a boolean or a null is written through as itself, so an\n * entry can state a value the script reads as the type it expects.\n */\nfunction interpolateConfig(\n  node: SetupBundleConfigValue,\n  scope: Parameters<typeof interpolateText>[1],\n): SetupBundleConfigValue {\n  if (typeof node === \"string\") {\n    return interpolateValue(node, scope);\n  }\n  if (Array.isArray(node)) {\n    return node.map((item) => interpolateConfig(item, scope));\n  }\n  if (typeof node === \"object\" && node !== null) {\n    return Object.fromEntries(\n      Object.entries(node).map(([key, value]) => [\n        key,\n        interpolateConfig(value, scope),\n      ]),\n    );\n  }\n  return node;\n}\n\n/**\n * The preflight body the host sends. The same shape for every entry, so no\n * entry declares it.\n */\nexport function buildPreflightBody(\n  entry: SetupEntry,\n  values: SetupFormValues,\n): SetupRequestBody | null {\n  const draft = buildCreatePayload(entry, values);\n  if (!draft) return null;\n\n  return {\n    automationId: entry.id,\n    endpoint: automationCreateEndpoint(entry),\n    draft,\n  };\n}\n\n/**\n * What an assisted entry sends into the conversation that finishes setup.\n *\n * The command is not declared either: it lives once, in the owning skill's own\n * `triggers` frontmatter, and the skill defaults to the entry's id. An entry\n * whose skill is invoked by description rather than by command contributes\n * nothing here, and the answers alone open the conversation.\n */\nexport function buildAssistedMessage(\n  entry: SetupEntry,\n  values: SetupFormValues,\n): string {\n  const command = findAutomationCommand(entry);\n  const message = entry.setup.message\n    ? interpolateText(entry.setup.message, { form: values, automation: entry })\n    : \"\";\n\n  return [command, message].filter(Boolean).join(\"\\n\\n\");\n}\n\nfunction collectPlaceholderFields(value: string): string[] {\n  const names = Array.from(\n    value.matchAll(FORM_PLACEHOLDER_PATTERN),\n    (match) => match[1],\n  );\n  return Array.from(new Set(names));\n}\n\n/**\n * Which form fields built each payload path.\n *\n * Preflight and the create endpoint reject a draft by payload path, and the\n * host has to turn that back into a highlighted input. Building the body with\n * each field standing in for its own value recovers the mapping exactly, so an\n * entry does not declare it.\n */\nexport function deriveErrorMap(entry: SetupEntry): Record<string, string[]> {\n  const mapping: Record<string, string[]> = {};\n\n  const standIns = Object.fromEntries(\n    Object.keys(collectFields(entry.setup)).map((name) => [\n      name,\n      `{{form.${name}}}`,\n    ]),\n  );\n  const template = buildCreatePayload(entry, standIns);\n  if (!template) return mapping;\n\n  const walk = (node: unknown, path: string): void => {\n    if (Array.isArray(node)) {\n      node.forEach((item, index) => walk(item, `${path}[${index}]`));\n      return;\n    }\n    if (typeof node === \"object\" && node !== null) {\n      Object.entries(node).forEach(([key, item]) =>\n        walk(item, path ? `${path}.${key}` : key),\n      );\n      return;\n    }\n    if (typeof node === \"string\") {\n      const names = collectPlaceholderFields(node);\n      if (names.length > 0) mapping[path] = names;\n    }\n  };\n\n  walk(template, \"\");\n  return mapping;\n}\n"],"mappings":";;;;AA2CA,SAAgB,EAAyB,GAA4B;CAInE,OAHI,KAAS,EAAc,CAAK,IACvB,EAAsB,cAAc,IAEtC,EAAsB,cAAc;AAC7C;AAGA,SAAgB,IAAmC;CACjD,OAAO,EAAsB,SAAS;AACxC;AAUA,SAAS,EACP,GACQ;CACR,IAAM,IAAO,EAAsB,CAAI;CACvC,IAAI,CAAC,GACH,MAAU,MACR,mDAAmD,EAAK,iFAE1D;CAEF,OAAO;AACT;AAiBA,SAAgB,EAAc,GAA4B;CACxD,OAAO,EAAM,MAAM,SAAS,YAAY,EAAM,MAAM,WAAW,KAAA;AACjE"}
+{"version":3,"file":"automation-setup.js","names":[],"sources":["../../src/manifests/automation-setup.ts"],"sourcesContent":["/**\n * The only module that knows a setup entry configures an *automation*.\n *\n * The published contract states just what varies between entries; everything\n * derivable is the host's to generate. That derivation is here, and nowhere\n * else, so the rest of `src/manifests/` stays about forms rather than about\n * automations.\n *\n * The algorithm mirrors `tests/test_automation_setup.py::_render_payload` in\n * `OpenHands/extensions`, which is the authoritative reference: it produces the\n * request bodies published in that repository's contract fixtures, and those\n * were verified against the live service. The create model is `extra=\"forbid\"`,\n * so any divergence is a hard 422 rather than a dropped field.\n */\n\nimport i18n from \"#/i18n\";\nimport { I18nKey } from \"#/i18n/declaration\";\nimport { findAutomationCommand } from \"#/utils/automation-catalog\";\nimport { getAutomationEndpoint } from \"./automation-interface\";\nimport {\n  actionKinds,\n  collectFields,\n  fieldText,\n  fieldValues,\n} from \"./manifest-local-validation\";\nimport { interpolateText, interpolateValue } from \"./manifest-template\";\nimport type {\n  SetupActionKind,\n  SetupBlock,\n  SetupBundleConfigValue,\n  SetupEntry,\n  SetupFormValues,\n  SetupRequestBody,\n  SetupTriggerKind,\n} from \"./types\";\n\n/**\n * The creation endpoint a derived draft would be posted to. Resolved on call\n * rather than at import, because the endpoint is the interface manifest's and\n * this module loads whether or not one was admitted.\n *\n * A bundle entry is created through the raw endpoint, because what it sends is\n * a tarball it uploaded rather than arguments to a preset. Called without an\n * entry - as the import path does - it answers for a prompt.\n */\nexport function automationCreateEndpoint(\n  entry?: SetupEntry,\n  selectedAction?: string | null,\n): string {\n  const kind = selectedActionKind(entry, selectedAction);\n  if (kind === \"plugin\") return getAutomationEndpoint(\"createPlugin\");\n  if (kind === \"upload\" || kind === \"bundle\") {\n    return requireBundleEndpoint(\"createBundle\");\n  }\n  return getAutomationEndpoint(\"createPrompt\");\n}\n\n/** Where a bundle's tarball is uploaded, before the create call. */\nexport function automationUploadEndpoint(): string {\n  return requireBundleEndpoint(\"uploads\");\n}\n\n/** The endpoints a bundle entry cannot be created without. */\nconst BUNDLE_ENDPOINTS = [\"createBundle\", \"uploads\"] as const;\n\n/**\n * An endpoint only a bundle needs. The interface manifest may predate bundles,\n * and the host holds no path of its own to fall back to, so this is where that\n * runs out rather than somewhere deep in a request.\n */\nfunction requireBundleEndpoint(\n  name: (typeof BUNDLE_ENDPOINTS)[number],\n): string {\n  const path = getAutomationEndpoint(name);\n  if (!path) {\n    throw new Error(\n      `The published automation interface declares no '${name}' endpoint, ` +\n        \"so this deployment cannot create an automation from a script bundle.\",\n    );\n  }\n  return path;\n}\n\n/**\n * The endpoints this entry needs that the published interface does not declare.\n *\n * Asked before the form renders rather than discovered at the moment of\n * creating: a pinned package that predates bundles can never answer, and the\n * dialog can say so while nothing has been filled in yet. Empty for every\n * entry that is not a bundle, which needs nothing beyond what the block has\n * always declared.\n */\nfunction missingEndpointsForAction(kind: SetupActionKind | \"bundle\"): string[] {\n  return kind === \"upload\" || kind === \"bundle\"\n    ? BUNDLE_ENDPOINTS.filter((name) => !getAutomationEndpoint(name))\n    : [];\n}\n\nexport function missingCreateEndpoints(\n  entry: SetupEntry,\n  selectedAction?: string | null,\n): string[] {\n  if (isBundleEntry(entry)) return missingEndpointsForAction(\"bundle\");\n  if (!entry.setup.actions) return [];\n\n  if (selectedAction && selectedAction in entry.setup.actions) {\n    return missingEndpointsForAction(selectedAction as SetupActionKind);\n  }\n\n  const missingByAction = actionKinds(entry.setup).map(\n    missingEndpointsForAction,\n  );\n  if (missingByAction.some((missing) => missing.length === 0)) return [];\n  return Array.from(new Set(missingByAction.flat()));\n}\n\n/** Whether this entry ships a script tarball instead of a prompt. */\nexport function isBundleEntry(entry: SetupEntry): boolean {\n  return entry.setup.mode === \"direct\" && entry.setup.bundle !== undefined;\n}\n\nexport function isUploadAction(\n  entry: SetupEntry,\n  selectedAction?: string | null,\n): boolean {\n  return selectedActionKind(entry, selectedAction) === \"upload\";\n}\n\nexport function selectedActionKind(\n  entry: SetupEntry | undefined,\n  selectedAction?: string | null,\n): SetupActionKind | \"bundle\" | \"prompt\" {\n  if (!entry) return \"prompt\";\n  if (isBundleEntry(entry)) return \"bundle\";\n  const actions = entry.setup.actions ?? {};\n  if (selectedAction && selectedAction in actions) {\n    return selectedAction as SetupActionKind;\n  }\n  const keys = actionKinds(entry.setup);\n  if (keys.length === 1) return keys[0];\n  return \"prompt\";\n}\n\n/**\n * The `tarball_path` a preflight draft carries.\n *\n * Preflight runs on every field blur and the upload happens once, at submit,\n * so there is no real path to send yet. The service checks this field's scheme\n * at preflight and its ownership only at creation, so a well-formed stand-in\n * validates exactly what preflight is for - the rest of the body - without\n * uploading an archive per keystroke.\n */\nexport const PREFLIGHT_TARBALL_PATH =\n  \"oh-internal://uploads/00000000-0000-0000-0000-000000000000\";\n\n/**\n * Trigger properties a form field may fill, per trigger kind. A field under a\n * trigger kind whose name is listed here fills the trigger property of the same\n * name; anything else there, such as a phrase to match, is an input to `filter`.\n */\nconst TRIGGER_PROPERTIES: Record<SetupTriggerKind, readonly string[]> = {\n  cron: [\"schedule\", \"timezone\"],\n  event: [\"source\", \"on\"],\n};\n\nconst OPTIONAL_CREATE_PROPERTIES = [\"model\", \"timeout\"] as const;\n\n/**\n * Repository properties a form field may fill, read the same way\n * {@link TRIGGER_PROPERTIES} is: a field whose name is listed here fills the\n * `repos[]` property of the same name. `url` and `provider` are absent because\n * neither is answered by a field of its own — they come from the repo-picker's\n * value and from its declared provider.\n *\n * These two lists are the only field names the derivation knows; everything\n * else it reads it finds by field type. An entry that wants a base branch in\n * its request therefore has to name that field `ref`.\n */\nconst REPO_PROPERTIES: readonly string[] = [\"ref\"];\n\nconst FORM_PLACEHOLDER_PATTERN = /\\{\\{form\\.([A-Za-z0-9_.]+)\\}\\}/g;\n\n/** The repository input, which supplies `repos` and an event trigger's source. */\nfunction findRepoPickerField(\n  setup: SetupBlock,\n  selectedAction?: string | null,\n) {\n  const match = Object.entries(collectFields(setup, null, selectedAction)).find(\n    ([, field]) => field.type === \"repo-picker\",\n  );\n  return match ? { name: match[0], field: match[1] } : null;\n}\n\n/** Every repository the form collected, whether the picker takes one or many. */\nfunction repositories(\n  setup: SetupBlock,\n  values: SetupFormValues,\n  selectedAction?: string | null,\n): string[] {\n  const picker = findRepoPickerField(setup, selectedAction);\n  return picker ? fieldValues(values[picker.name]) : [];\n}\n\n/**\n * The created automation's name.\n *\n * One repository is worth naming; several are not, so the count stands in\n * rather than a list of names that would not fit.\n */\nfunction deriveName(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  selectedAction?: string | null,\n): string {\n  if (\n    \"name\" in collectFields(entry.setup, null, selectedAction) &&\n    \"name\" in values\n  ) {\n    return fieldText(values.name);\n  }\n\n  const repos = repositories(entry.setup, values, selectedAction);\n  if (repos.length === 0) return entry.name;\n  if (repos.length === 1) return `${entry.name} - ${repos[0]}`;\n  // The count is the one word here the host writes rather than reads off the\n  // entry, so it is translated. There is no translator to pass in: the\n  // derivation runs from a memo, an upload and a test alike.\n  const count = i18n.t(I18nKey.SETUP$REPOSITORY_COUNT, {\n    total: repos.length,\n  });\n  return `${entry.name} - ${count}`;\n}\n\n/** The active trigger kind for a direct entry, with its fields. */\nfunction getTrigger(setup: SetupBlock, selectedTrigger?: string | null) {\n  const triggers = setup.form.triggers ?? {};\n  const entries = Object.entries(triggers);\n  if (entries.length === 0) return null;\n  const match =\n    selectedTrigger && selectedTrigger in triggers\n      ? [selectedTrigger, triggers[selectedTrigger as SetupTriggerKind]]\n      : entries.length === 1\n        ? entries[0]\n        : null;\n  if (!match) return null;\n  const [kind, fields] = match;\n  return { kind: kind as SetupTriggerKind, fields: fields ?? {} };\n}\n\nfunction hasPayloadValue(\n  value: SetupRequestBody[string] | undefined,\n): value is SetupRequestBody[string] {\n  return value !== undefined && value !== null && value !== \"\";\n}\n\nfunction fieldPayloadValue(\n  fieldType: string | undefined,\n  value: SetupFormValues[string],\n) {\n  if (fieldType === \"number\") {\n    const text = fieldText(value);\n    return text === \"\" ? undefined : Number(text);\n  }\n  return fieldText(value);\n}\n\nfunction optionalCreateProperties(\n  setup: SetupBlock,\n  values: SetupFormValues,\n  selectedAction?: string | null,\n): SetupRequestBody {\n  return Object.fromEntries(\n    OPTIONAL_CREATE_PROPERTIES.flatMap((name) => {\n      const field = collectFields(setup, null, selectedAction)[name];\n      const value = fieldPayloadValue(field?.type, values[name]);\n      return hasPayloadValue(value) ? [[name, value]] : [];\n    }),\n  ) as SetupRequestBody;\n}\n\nfunction repositoryProperty(\n  setup: SetupBlock,\n  values: SetupFormValues,\n  selectedAction?: string | null,\n): SetupRequestBody {\n  const repoPicker = findRepoPickerField(setup, selectedAction);\n  const repos = repositories(setup, values, selectedAction);\n  if (repos.length === 0 || !repoPicker?.field.provider) return {};\n\n  const declared = REPO_PROPERTIES.filter((name) =>\n    hasPayloadValue(fieldText(values[name])),\n  );\n  return {\n    repos: repos.map((url) => ({\n      url,\n      ...Object.fromEntries(\n        declared.map((name) => [name, fieldText(values[name])]),\n      ),\n      provider: repoPicker.field.provider as string,\n    })),\n  };\n}\n\nfunction parsePluginSources(\n  value: SetupRequestBody[string],\n): SetupRequestBody[string] {\n  if (!hasPayloadValue(value) || typeof value !== \"string\") return value;\n  const trimmed = value.trim();\n  if (!trimmed) return [];\n  if (trimmed.startsWith(\"[\")) {\n    try {\n      return JSON.parse(trimmed) as SetupRequestBody[string];\n    } catch {\n      return [{ source: trimmed }];\n    }\n  }\n  return trimmed\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter(Boolean)\n    .map((line) => {\n      const [source, ...parts] = line.split(/\\s+/);\n      const plugin: Record<string, string> = { source };\n      parts.forEach((part) => {\n        const [key, ...raw] = part.split(\"=\");\n        const valuePart = raw.join(\"=\");\n        if ((key === \"ref\" || key === \"repo_path\") && valuePart) {\n          plugin[key] = valuePart;\n        }\n      });\n      return plugin;\n    });\n}\n\n/**\n * The create request body these form values produce.\n *\n * No entry declares it: `name` comes from the entry, `repos` from the\n * repo-picker field and its declared provider, and `trigger` from the key and\n * fields under `form.triggers`. Only `prompt` and an event `filter` are\n * declared, because only they cannot be read off the form.\n *\n * Returns null for an assisted entry, which hands setup to a conversation\n * instead of sending a body.\n */\nexport function buildCreatePayload(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  /** Bundle/upload entries only: what the upload returned. */\n  tarballPath: string = PREFLIGHT_TARBALL_PATH,\n  selectedTrigger?: string | null,\n  selectedActionKey?: string | null,\n): SetupRequestBody | null {\n  const { setup } = entry;\n  if (setup.mode !== \"direct\") return null;\n  if (setup.bundle) {\n    return buildBundlePayload(entry, values, tarballPath, selectedTrigger);\n  }\n  if (setup.actions) {\n    return buildActionPayload(\n      entry,\n      values,\n      tarballPath,\n      selectedTrigger,\n      selectedActionKey,\n    );\n  }\n  if (!setup.prompt) return null;\n\n  const scope = { form: values, automation: entry };\n\n  const payload: SetupRequestBody = {\n    name: deriveName(entry, values),\n    prompt: interpolateText(setup.prompt, scope),\n    ...optionalCreateProperties(setup, values),\n    ...repositoryProperty(setup, values),\n  };\n\n  const trigger = buildTrigger(entry, values, selectedTrigger);\n  if (trigger) payload.trigger = trigger;\n\n  const template = buildTemplate(entry, values);\n  if (template) payload.template = template;\n\n  return payload;\n}\n\nfunction buildActionPayload(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  tarballPath: string,\n  selectedTrigger?: string | null,\n  selectedActionKey?: string | null,\n): SetupRequestBody | null {\n  const kind = selectedActionKind(entry, selectedActionKey);\n  if (kind === \"bundle\") return null;\n\n  const setup = entry.setup;\n  const scope = { form: values, automation: entry };\n  const payload: SetupRequestBody = {\n    name: deriveName(entry, values, selectedActionKey),\n  };\n\n  const trigger = buildTrigger(\n    entry,\n    values,\n    selectedTrigger,\n    selectedActionKey,\n  );\n  if (trigger) payload.trigger = trigger;\n\n  Object.assign(\n    payload,\n    optionalCreateProperties(setup, values, selectedActionKey),\n  );\n\n  if (kind === \"upload\") {\n    const action = setup.actions?.upload;\n    if (!action) return null;\n    payload.tarball_path =\n      tarballPath || interpolateText(action.tarballPath, scope);\n    payload.entrypoint = interpolateText(action.entrypoint, scope);\n    if (action.setupScript) {\n      const setupScript = interpolateText(action.setupScript, scope);\n      if (hasPayloadValue(setupScript)) payload.setup_script_path = setupScript;\n    }\n    return payload;\n  }\n\n  const action =\n    kind === \"plugin\" ? setup.actions?.plugin : setup.actions?.prompt;\n  if (!action) return null;\n  payload.prompt = interpolateText(action.prompt, scope);\n  Object.assign(payload, repositoryProperty(setup, values, selectedActionKey));\n\n  if (kind === \"plugin\") {\n    const pluginAction = setup.actions?.plugin;\n    if (!pluginAction) return null;\n    payload.plugins = parsePluginSources(\n      interpolateValue(pluginAction.plugins, scope),\n    );\n  }\n\n  const template = buildTemplate(entry, values);\n  if (template) payload.template = template;\n\n  return payload;\n}\n\n/**\n * The `template` provenance a prompt entry sends, or undefined for one that\n * publishes no version.\n *\n * It is what lets the service recognise a second setup of the same entry as\n * the automation it already holds. The bundle path derives the same block from\n * the config the bundle declares; a prompt entry declares none, so the answer\n * to \"what was this created from\" is the form as submitted.\n */\nfunction buildTemplate(\n  entry: SetupEntry,\n  values: SetupFormValues,\n): SetupRequestBody | undefined {\n  if (!entry.version) return undefined;\n  return {\n    id: entry.id,\n    version: entry.version,\n    config: { ...values } as SetupRequestBody,\n  };\n}\n\n/**\n * The `trigger` object, read off the key and fields under `form.triggers`.\n *\n * Identical for both kinds of direct entry: only the create endpoint and what\n * the automation is told to do differ between a prompt and a bundle.\n */\nfunction buildTrigger(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupRequestBody | undefined {\n  const trigger = getTrigger(entry.setup, selectedTrigger);\n  if (!trigger) return undefined;\n\n  const properties = TRIGGER_PROPERTIES[trigger.kind];\n  const declared = Object.keys(trigger.fields).filter((name) =>\n    properties.includes(name),\n  );\n  const repoPicker = findRepoPickerField(entry.setup, selectedAction);\n  const derived = Object.fromEntries(\n    declared\n      .map((name) => [name, fieldText(values[name])])\n      .filter(([, value]) => hasPayloadValue(value)),\n  );\n\n  const filter = entry.setup.filter\n    ? interpolateText(entry.setup.filter, {\n        form: values,\n        automation: entry,\n      })\n    : undefined;\n\n  return {\n    type: trigger.kind,\n    ...derived,\n    ...(trigger.kind === \"event\" && {\n      ...(!(\"source\" in derived) && {\n        source: repoPicker?.field.provider ?? \"\",\n      }),\n      ...(hasPayloadValue(filter) && { filter }),\n    }),\n  };\n}\n\n/**\n * The raw create body a bundle entry produces.\n *\n * `tarball_path` is the one value neither declared nor derived: the host packs\n * and uploads the bundle first, and creates from what came back. `template` is\n * the provenance that makes enabling the same entry twice return the\n * automation that already exists rather than a second one.\n *\n * There is no `repos`: the raw endpoint has no such field, and a bundle's\n * script fetches what it needs itself.\n */\nfunction buildBundlePayload(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  tarballPath: string,\n  selectedTrigger?: string | null,\n): SetupRequestBody {\n  const bundle = entry.setup.bundle!;\n  const scope = { form: values, automation: entry };\n\n  const payload: SetupRequestBody = {\n    name: deriveName(entry, values),\n  };\n\n  const trigger = buildTrigger(entry, values, selectedTrigger);\n  if (trigger) payload.trigger = trigger;\n\n  payload.tarball_path = tarballPath;\n  payload.entrypoint = bundle.entrypoint;\n  if (bundle.setupScript) payload.setup_script_path = bundle.setupScript;\n  if (bundle.timeout !== undefined) payload.timeout = bundle.timeout;\n  payload.template = {\n    id: entry.id,\n    version: bundle.version,\n    config: interpolateConfig(bundle.config, scope) as SetupRequestBody,\n  };\n\n  return payload;\n}\n\n/**\n * Placeholder substitution over the config tree. Only string leaves are\n * templated; a number, a boolean or a null is written through as itself, so an\n * entry can state a value the script reads as the type it expects.\n */\nfunction interpolateConfig(\n  node: SetupBundleConfigValue,\n  scope: Parameters<typeof interpolateText>[1],\n): SetupBundleConfigValue {\n  if (typeof node === \"string\") {\n    return interpolateValue(node, scope);\n  }\n  if (Array.isArray(node)) {\n    return node.map((item) => interpolateConfig(item, scope));\n  }\n  if (typeof node === \"object\" && node !== null) {\n    return Object.fromEntries(\n      Object.entries(node).map(([key, value]) => [\n        key,\n        interpolateConfig(value, scope),\n      ]),\n    );\n  }\n  return node;\n}\n\n/**\n * The preflight body the host sends. The same shape for every entry, so no\n * entry declares it.\n */\nexport function buildPreflightBody(\n  entry: SetupEntry,\n  values: SetupFormValues,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupRequestBody | null {\n  const draft = buildCreatePayload(\n    entry,\n    values,\n    PREFLIGHT_TARBALL_PATH,\n    selectedTrigger,\n    selectedAction,\n  );\n  if (!draft) return null;\n\n  return {\n    automationId: entry.id,\n    endpoint: automationCreateEndpoint(entry, selectedAction),\n    draft,\n  };\n}\n\n/**\n * What an assisted entry sends into the conversation that finishes setup.\n *\n * The command is not declared either: it lives once, in the owning skill's own\n * `triggers` frontmatter, and the skill defaults to the entry's id. An entry\n * whose skill is invoked by description rather than by command contributes\n * nothing here, and the answers alone open the conversation.\n */\nexport function buildAssistedMessage(\n  entry: SetupEntry,\n  values: SetupFormValues,\n): string {\n  const command = findAutomationCommand(entry);\n  const message = entry.setup.message\n    ? interpolateText(entry.setup.message, { form: values, automation: entry })\n    : \"\";\n\n  return [command, message].filter(Boolean).join(\"\\n\\n\");\n}\n\nfunction collectPlaceholderFields(value: string): string[] {\n  const names = Array.from(\n    value.matchAll(FORM_PLACEHOLDER_PATTERN),\n    (match) => match[1],\n  );\n  return Array.from(new Set(names));\n}\n\n/**\n * Which form fields built each payload path.\n *\n * Preflight and the create endpoint reject a draft by payload path, and the\n * host has to turn that back into a highlighted input. Building the body with\n * each field standing in for its own value recovers the mapping exactly, so an\n * entry does not declare it.\n */\nexport function deriveErrorMap(\n  entry: SetupEntry,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): Record<string, string[]> {\n  const mapping: Record<string, string[]> = {};\n\n  const triggerEntries = Object.keys(entry.setup.form.triggers ?? {});\n  const triggerVariants = selectedTrigger\n    ? [selectedTrigger]\n    : triggerEntries.length > 1\n      ? triggerEntries\n      : [null];\n\n  const actionEntries = actionKinds(entry.setup);\n  const actionVariants = selectedAction\n    ? [selectedAction]\n    : actionEntries.length > 1\n      ? actionEntries\n      : [null];\n\n  const walk = (node: unknown, path: string): void => {\n    if (Array.isArray(node)) {\n      node.forEach((item, index) => walk(item, `${path}[${index}]`));\n      return;\n    }\n    if (typeof node === \"object\" && node !== null) {\n      Object.entries(node).forEach(([key, item]) =>\n        walk(item, path ? `${path}.${key}` : key),\n      );\n      return;\n    }\n    if (typeof node === \"string\") {\n      const names = collectPlaceholderFields(node);\n      if (names.length > 0) {\n        mapping[path] = Array.from(\n          new Set([...(mapping[path] ?? []), ...names]),\n        );\n      }\n    }\n  };\n\n  actionVariants.forEach((actionVariant) => {\n    triggerVariants.forEach((triggerVariant) => {\n      const names = Object.keys(\n        collectFields(entry.setup, triggerVariant, actionVariant),\n      );\n      const variantStandIns = Object.fromEntries(\n        names.map((name) => [name, `{{form.${name}}}`]),\n      );\n      const template = buildCreatePayload(\n        entry,\n        variantStandIns,\n        actionVariant === \"upload\" ? \"\" : PREFLIGHT_TARBALL_PATH,\n        triggerVariant,\n        actionVariant,\n      );\n      if (template) walk(template, \"\");\n    });\n  });\n  return mapping;\n}\n"],"mappings":";;;;;AA6CA,SAAgB,EACd,GACA,GACQ;CACR,IAAM,IAAO,EAAmB,GAAO,CAAc;CAKrD,OAJI,MAAS,WAAiB,EAAsB,cAAc,IAC9D,MAAS,YAAY,MAAS,WACzB,EAAsB,cAAc,IAEtC,EAAsB,cAAc;AAC7C;AAGA,SAAgB,IAAmC;CACjD,OAAO,EAAsB,SAAS;AACxC;AAUA,SAAS,EACP,GACQ;CACR,IAAM,IAAO,EAAsB,CAAI;CACvC,IAAI,CAAC,GACH,MAAU,MACR,mDAAmD,EAAK,iFAE1D;CAEF,OAAO;AACT;AAoCA,SAAgB,EAAc,GAA4B;CACxD,OAAO,EAAM,MAAM,SAAS,YAAY,EAAM,MAAM,WAAW,KAAA;AACjE;AASA,SAAgB,EACd,GACA,GACuC;CACvC,IAAI,CAAC,GAAO,OAAO;CACnB,IAAI,EAAc,CAAK,GAAG,OAAO;CACjC,IAAM,IAAU,EAAM,MAAM,WAAW,CAAC;CACxC,IAAI,KAAkB,KAAkB,GACtC,OAAO;CAET,IAAM,IAAO,EAAY,EAAM,KAAK;CAEpC,OADI,EAAK,WAAW,IAAU,EAAK,KAC5B;AACT"}

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

@@ -17,4 +17,4 @@ export interface SetupActionResult {
     /** The created resource, or the conversation that will finish setup. */
     response: Record<string, unknown>;
 }
-export declare function useSetupAction(): (entry: SetupEntry, values: SetupFormValues, payload: SetupRequestBody | null) => Promise<SetupActionResult>;
+export declare function useSetupAction(): (entry: SetupEntry, values: SetupFormValues, payload: SetupRequestBody | null, selectedTrigger?: string | null, selectedAction?: string | null) => Promise<SetupActionResult>;

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

@@ -6,7 +6,7 @@
  * what it supports. Neither side is interpreted here beyond set membership, so
  * this stays neutral about what any particular capability means.
  */
-import type { DeploymentCapabilities, SetupEntry } from "./types";
+import type { DeploymentCapabilities, SetupActionKind, SetupEntry, SetupTriggerKind } from "./types";
 /**
  * "unknown" is a real outcome, not an error: a deployment that cannot be asked
  * must not be treated as one that answered no.
@@ -22,4 +22,6 @@ export interface SetupCapabilityAssessment {
      */
     unmet: string[];
 }
+export declare function supportedActionKinds(entry: SetupEntry, reported: DeploymentCapabilities): SetupActionKind[];
+export declare function supportedTriggerKinds(entry: SetupEntry, reported: DeploymentCapabilities): SetupTriggerKind[];
 export declare function assessCapabilityRequirements(entry: SetupEntry, reported: DeploymentCapabilities): SetupCapabilityAssessment;

package/dist/manifests/manifest-local-validation.cjs

@@ -0,0 +1,2 @@
+require("../_virtual/_rolldown/runtime.cjs");function e(e){return Object.keys(e.actions??{})}exports.actionKinds=e;
+//# sourceMappingURL=manifest-local-validation.cjs.map