@openhands/agent-canvas 1.16.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-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

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-local-validation.cjs","names":[],"sources":["../../src/manifests/manifest-local-validation.ts"],"sourcesContent":["/**\n * The form model, and the host's own check of what the user typed into it.\n *\n * Local validation is a convenience, not the authority: it is instant and needs\n * no round trip, so it catches empty required fields and obvious typos.\n * Deployment-specific questions (\"is a one-minute schedule allowed here?\")\n * belong to preflight, which is authoritative.\n *\n * Errors are returned as codes rather than sentences so the host can render\n * them through its own translations; only manifest-authored copy is literal.\n */\n\nimport type {\n  DeploymentCapabilities,\n  SetupActionKind,\n  SetupBlock,\n  SetupFieldOption,\n  SetupFormField,\n  SetupFormFields,\n  SetupFormValue,\n  SetupFormValues,\n} from \"./types\";\n\n/** Characters that would break out of an expression string literal. */\nconst UNSAFE_EXPRESSION_LITERAL_PATTERN = /[\"'\\\\]/;\n\nexport type SetupFieldError =\n  | { code: \"required\" }\n  | { code: \"minLength\"; length: number }\n  | { code: \"maxLength\"; length: number }\n  | { code: \"min\"; value: number }\n  | { code: \"max\"; value: number }\n  | { code: \"invalidOption\" }\n  | { code: \"unsafeExpressionLiteral\" };\n\nexport type SetupFieldErrors = Record<string, SetupFieldError>;\n\n/** Field constraints supplied by the deployment rather than by the manifest. */\nexport interface SetupFieldOverride {\n  options?: SetupFieldOption[];\n}\n\nexport function triggerKinds(setup: SetupBlock): string[] {\n  return Object.keys(setup.form.triggers ?? {});\n}\n\nexport function initialTriggerKind(setup: SetupBlock): string | null {\n  return triggerKinds(setup)[0] ?? null;\n}\n\nexport function actionKinds(setup: SetupBlock): SetupActionKind[] {\n  return Object.keys(setup.actions ?? {}) as SetupActionKind[];\n}\n\nexport function initialActionKind(setup: SetupBlock): SetupActionKind | null {\n  return actionKinds(setup)[0] ?? null;\n}\n\nexport type SetupFieldOverrides = Record<string, SetupFieldOverride>;\n\n/**\n * Every input the form declares, keyed by name, whichever half it is in.\n *\n * Trigger inputs come first so the user is asked when it runs before what it\n * runs on, and so every derived view of the form keeps that order. Admission\n * rejects a name declared in both halves, so the merge cannot lose a field.\n */\nexport function collectFields(\n  setup: SetupBlock,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFormFields {\n  const triggers = setup.form.triggers ?? {};\n  const triggerEntries = Object.entries(triggers);\n  const activeTrigger =\n    selectedTrigger && selectedTrigger in triggers\n      ? triggers[selectedTrigger as keyof typeof triggers]\n      : triggerEntries.length === 1\n        ? triggerEntries[0][1]\n        : {};\n  const actions = setup.actions ?? {};\n  const actionEntries = Object.entries(actions);\n  const activeAction =\n    selectedAction && selectedAction in actions\n      ? actions[selectedAction as SetupActionKind]?.args\n      : actionEntries.length === 1\n        ? actionEntries[0][1]?.args\n        : {};\n  return Object.assign(\n    {},\n    activeTrigger,\n    setup.form.args,\n    activeAction,\n  ) as SetupFormFields;\n}\n\n/**\n * Feed deployment values into form field constraints, so the form offers only\n * what the deployment accepts.\n *\n * A `timezone` field is the case that needs it: a manifest declares no options\n * for one, because the accepted zones belong to the deployment. The cron\n * interval floor is deliberately left to preflight — the deployment owns that\n * limit and states it in its own words, and a local approximation would\n * pre-empt the authoritative message with a worse one.\n */\nexport function resolveFieldOverrides(\n  setup: SetupBlock,\n  capabilities: DeploymentCapabilities | null,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFieldOverrides {\n  const overrides: SetupFieldOverrides = {};\n  const fields = collectFields(setup, selectedTrigger, selectedAction);\n  const timezones = capabilities?.triggers?.cron?.timezones;\n  if (timezones?.length) {\n    const options = timezones.map((zone) => ({ value: zone, label: zone }));\n    Object.entries(fields)\n      .filter(([, field]) => field.type === \"timezone\")\n      .forEach(([name]) => {\n        overrides[name] = { options };\n      });\n  }\n\n  if (capabilities?.eventSources?.length) {\n    const options = capabilities.eventSources.map((source) => ({\n      value: source,\n      label: source,\n    }));\n    Object.entries(fields)\n      .filter(([, field]) => field.type === \"event-source\")\n      .forEach(([name]) => {\n        overrides[name] = { options };\n      });\n  }\n\n  if (capabilities?.eventTypes?.length) {\n    const options = capabilities.eventTypes.map((type) => ({\n      value: type,\n      label: type,\n    }));\n    Object.entries(fields)\n      .filter(([, field]) => field.type === \"event-type\")\n      .forEach(([name]) => {\n        overrides[name] = { options };\n      });\n  }\n\n  return overrides;\n}\n\n/** The options a field offers, after deployment constraints are applied. */\nexport function getFieldOptions(\n  name: string,\n  field: SetupFormField,\n  overrides: SetupFieldOverrides = {},\n): SetupFieldOption[] {\n  return overrides[name]?.options ?? field.options ?? [];\n}\n\n/**\n * Every value a field holds, whether it collects one or many.\n *\n * Reading both shapes as a list is what keeps validation, interpolation and\n * the payload mapping from branching on `multiple` at every use.\n */\nfunction isFileValue(value: SetupFormValue | undefined): value is File {\n  return typeof File !== \"undefined\" && value instanceof File;\n}\n\nexport function fieldValues(value: SetupFormValue | undefined): string[] {\n  if (Array.isArray(value)) return value.filter((item) => item.trim() !== \"\");\n  if (isFileValue(value)) return value.name ? [value.name] : [];\n  if (typeof value === \"string\" && value.trim() === \"\") return [];\n  if (value === undefined || value === null) return [];\n  return [String(value)];\n}\n\n/** The single value a field holds, or \"\" for a field collecting several. */\nexport function fieldText(value: SetupFormValue | undefined): string {\n  if (Array.isArray(value) || value === undefined || value === null) return \"\";\n  if (isFileValue(value)) return value.name;\n  return String(value);\n}\n\n/** Initial form state: every declared field, seeded with its declared default. */\nexport function getInitialFormValues(\n  setup: SetupBlock,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFormValues {\n  return Object.fromEntries(\n    Object.entries(collectFields(setup, selectedTrigger, selectedAction)).map(\n      ([name, field]) => [\n        name,\n        // A field collecting several values starts empty rather than holding one\n        // blank entry, so \"required\" means \"add one\" rather than \"fill this in\".\n        field.multiple ? [] : (field.default ?? \"\"),\n      ],\n    ),\n  );\n}\n\nfunction validateField(\n  name: string,\n  field: SetupFormField,\n  rawValue: SetupFormValue | undefined,\n  overrides: SetupFieldOverrides,\n): SetupFieldError | null {\n  const entered = fieldValues(rawValue);\n\n  if (entered.length === 0) {\n    return field.required ? { code: \"required\" } : null;\n  }\n\n  // Every entry of a multi-value field answers the same field, so each is held\n  // to the same rules and the first failure is the one reported.\n  const failures = entered\n    .map((item) => validateValue(name, field, item.trim(), overrides))\n    .filter((error): error is SetupFieldError => error !== null);\n  return failures[0] ?? null;\n}\n\nfunction validateValue(\n  name: string,\n  field: SetupFormField,\n  value: string,\n  overrides: SetupFieldOverrides,\n): SetupFieldError | null {\n  const { minLength, maxLength, min, max, format } = field.constraints ?? {};\n  if (minLength !== undefined && value.length < minLength) {\n    return { code: \"minLength\", length: minLength };\n  }\n  if (maxLength !== undefined && value.length > maxLength) {\n    return { code: \"maxLength\", length: maxLength };\n  }\n  if (field.type === \"number\") {\n    const numeric = Number(value);\n    if (Number.isNaN(numeric)) return { code: \"invalidOption\" };\n    if (min !== undefined && numeric < min) return { code: \"min\", value: min };\n    if (max !== undefined && numeric > max) return { code: \"max\", value: max };\n  }\n  if (\n    format === \"safeExpressionLiteral\" &&\n    UNSAFE_EXPRESSION_LITERAL_PATTERN.test(value)\n  ) {\n    return { code: \"unsafeExpressionLiteral\" };\n  }\n\n  // Any field offering a closed set of values, whether the manifest declared it\n  // or the deployment supplied it, must be answered from that set.\n  const options = getFieldOptions(name, field, overrides);\n  if (options.length > 0 && !options.some((option) => option.value === value)) {\n    return { code: \"invalidOption\" };\n  }\n\n  return null;\n}\n\n/** Check every declared field. Returns only the fields that failed. */\nexport function validateFormValues(\n  setup: SetupBlock,\n  values: SetupFormValues,\n  overrides: SetupFieldOverrides = {},\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFieldErrors {\n  return Object.entries(\n    collectFields(setup, selectedTrigger, selectedAction),\n  ).reduce<SetupFieldErrors>((errors, [name, field]) => {\n    const error = validateField(name, field, values[name], overrides);\n    return error ? { ...errors, [name]: error } : errors;\n  }, {});\n}\n"],"mappings":"6CAkDA,SAAgB,EAAY,EAAsC,CAChE,OAAO,OAAO,KAAK,EAAM,SAAW,CAAC,CAAC,CACxC"}

package/dist/manifests/manifest-local-validation.d.ts

@@ -9,7 +9,7 @@
  * Errors are returned as codes rather than sentences so the host can render
  * them through its own translations; only manifest-authored copy is literal.
  */
-import type { DeploymentCapabilities, SetupBlock, SetupFieldOption, SetupFormField, SetupFormFields, SetupFormValue, SetupFormValues } from "./types";
+import type { DeploymentCapabilities, SetupActionKind, SetupBlock, SetupFieldOption, SetupFormField, SetupFormFields, SetupFormValue, SetupFormValues } from "./types";
 export type SetupFieldError = {
     code: "required";
 } | {
@@ -18,6 +18,12 @@ export type SetupFieldError = {
 } | {
     code: "maxLength";
     length: number;
+} | {
+    code: "min";
+    value: number;
+} | {
+    code: "max";
+    value: number;
 } | {
     code: "invalidOption";
 } | {
@@ -28,6 +34,10 @@ export type SetupFieldErrors = Record<string, SetupFieldError>;
 export interface SetupFieldOverride {
     options?: SetupFieldOption[];
 }
+export declare function triggerKinds(setup: SetupBlock): string[];
+export declare function initialTriggerKind(setup: SetupBlock): string | null;
+export declare function actionKinds(setup: SetupBlock): SetupActionKind[];
+export declare function initialActionKind(setup: SetupBlock): SetupActionKind | null;
 export type SetupFieldOverrides = Record<string, SetupFieldOverride>;
 /**
  * Every input the form declares, keyed by name, whichever half it is in.
@@ -36,7 +46,7 @@ export type SetupFieldOverrides = Record<string, SetupFieldOverride>;
  * runs on, and so every derived view of the form keeps that order. Admission
  * rejects a name declared in both halves, so the merge cannot lose a field.
  */
-export declare function collectFields(setup: SetupBlock): SetupFormFields;
+export declare function collectFields(setup: SetupBlock, selectedTrigger?: string | null, selectedAction?: string | null): SetupFormFields;
 /**
  * Feed deployment values into form field constraints, so the form offers only
  * what the deployment accepts.
@@ -47,19 +57,13 @@ export declare function collectFields(setup: SetupBlock): SetupFormFields;
  * limit and states it in its own words, and a local approximation would
  * pre-empt the authoritative message with a worse one.
  */
-export declare function resolveFieldOverrides(setup: SetupBlock, capabilities: DeploymentCapabilities | null): SetupFieldOverrides;
+export declare function resolveFieldOverrides(setup: SetupBlock, capabilities: DeploymentCapabilities | null, selectedTrigger?: string | null, selectedAction?: string | null): SetupFieldOverrides;
 /** The options a field offers, after deployment constraints are applied. */
 export declare function getFieldOptions(name: string, field: SetupFormField, overrides?: SetupFieldOverrides): SetupFieldOption[];
-/**
- * Every value a field holds, whether it collects one or many.
- *
- * Reading both shapes as a list is what keeps validation, interpolation and
- * the payload mapping from branching on `multiple` at every use.
- */
 export declare function fieldValues(value: SetupFormValue | undefined): string[];
 /** The single value a field holds, or "" for a field collecting several. */
 export declare function fieldText(value: SetupFormValue | undefined): string;
 /** Initial form state: every declared field, seeded with its declared default. */
-export declare function getInitialFormValues(setup: SetupBlock): SetupFormValues;
+export declare function getInitialFormValues(setup: SetupBlock, selectedTrigger?: string | null, selectedAction?: string | null): SetupFormValues;
 /** Check every declared field. Returns only the fields that failed. */
-export declare function validateFormValues(setup: SetupBlock, values: SetupFormValues, overrides?: SetupFieldOverrides): SetupFieldErrors;
+export declare function validateFormValues(setup: SetupBlock, values: SetupFormValues, overrides?: SetupFieldOverrides, selectedTrigger?: string | null, selectedAction?: string | null): SetupFieldErrors;

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

@@ -0,0 +1,8 @@
+//#region src/manifests/manifest-local-validation.ts
+function e(e) {
+	return Object.keys(e.actions ?? {});
+}
+//#endregion
+export { e as actionKinds };
+
+//# sourceMappingURL=manifest-local-validation.js.map

package/dist/manifests/manifest-local-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-local-validation.js","names":[],"sources":["../../src/manifests/manifest-local-validation.ts"],"sourcesContent":["/**\n * The form model, and the host's own check of what the user typed into it.\n *\n * Local validation is a convenience, not the authority: it is instant and needs\n * no round trip, so it catches empty required fields and obvious typos.\n * Deployment-specific questions (\"is a one-minute schedule allowed here?\")\n * belong to preflight, which is authoritative.\n *\n * Errors are returned as codes rather than sentences so the host can render\n * them through its own translations; only manifest-authored copy is literal.\n */\n\nimport type {\n  DeploymentCapabilities,\n  SetupActionKind,\n  SetupBlock,\n  SetupFieldOption,\n  SetupFormField,\n  SetupFormFields,\n  SetupFormValue,\n  SetupFormValues,\n} from \"./types\";\n\n/** Characters that would break out of an expression string literal. */\nconst UNSAFE_EXPRESSION_LITERAL_PATTERN = /[\"'\\\\]/;\n\nexport type SetupFieldError =\n  | { code: \"required\" }\n  | { code: \"minLength\"; length: number }\n  | { code: \"maxLength\"; length: number }\n  | { code: \"min\"; value: number }\n  | { code: \"max\"; value: number }\n  | { code: \"invalidOption\" }\n  | { code: \"unsafeExpressionLiteral\" };\n\nexport type SetupFieldErrors = Record<string, SetupFieldError>;\n\n/** Field constraints supplied by the deployment rather than by the manifest. */\nexport interface SetupFieldOverride {\n  options?: SetupFieldOption[];\n}\n\nexport function triggerKinds(setup: SetupBlock): string[] {\n  return Object.keys(setup.form.triggers ?? {});\n}\n\nexport function initialTriggerKind(setup: SetupBlock): string | null {\n  return triggerKinds(setup)[0] ?? null;\n}\n\nexport function actionKinds(setup: SetupBlock): SetupActionKind[] {\n  return Object.keys(setup.actions ?? {}) as SetupActionKind[];\n}\n\nexport function initialActionKind(setup: SetupBlock): SetupActionKind | null {\n  return actionKinds(setup)[0] ?? null;\n}\n\nexport type SetupFieldOverrides = Record<string, SetupFieldOverride>;\n\n/**\n * Every input the form declares, keyed by name, whichever half it is in.\n *\n * Trigger inputs come first so the user is asked when it runs before what it\n * runs on, and so every derived view of the form keeps that order. Admission\n * rejects a name declared in both halves, so the merge cannot lose a field.\n */\nexport function collectFields(\n  setup: SetupBlock,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFormFields {\n  const triggers = setup.form.triggers ?? {};\n  const triggerEntries = Object.entries(triggers);\n  const activeTrigger =\n    selectedTrigger && selectedTrigger in triggers\n      ? triggers[selectedTrigger as keyof typeof triggers]\n      : triggerEntries.length === 1\n        ? triggerEntries[0][1]\n        : {};\n  const actions = setup.actions ?? {};\n  const actionEntries = Object.entries(actions);\n  const activeAction =\n    selectedAction && selectedAction in actions\n      ? actions[selectedAction as SetupActionKind]?.args\n      : actionEntries.length === 1\n        ? actionEntries[0][1]?.args\n        : {};\n  return Object.assign(\n    {},\n    activeTrigger,\n    setup.form.args,\n    activeAction,\n  ) as SetupFormFields;\n}\n\n/**\n * Feed deployment values into form field constraints, so the form offers only\n * what the deployment accepts.\n *\n * A `timezone` field is the case that needs it: a manifest declares no options\n * for one, because the accepted zones belong to the deployment. The cron\n * interval floor is deliberately left to preflight — the deployment owns that\n * limit and states it in its own words, and a local approximation would\n * pre-empt the authoritative message with a worse one.\n */\nexport function resolveFieldOverrides(\n  setup: SetupBlock,\n  capabilities: DeploymentCapabilities | null,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFieldOverrides {\n  const overrides: SetupFieldOverrides = {};\n  const fields = collectFields(setup, selectedTrigger, selectedAction);\n  const timezones = capabilities?.triggers?.cron?.timezones;\n  if (timezones?.length) {\n    const options = timezones.map((zone) => ({ value: zone, label: zone }));\n    Object.entries(fields)\n      .filter(([, field]) => field.type === \"timezone\")\n      .forEach(([name]) => {\n        overrides[name] = { options };\n      });\n  }\n\n  if (capabilities?.eventSources?.length) {\n    const options = capabilities.eventSources.map((source) => ({\n      value: source,\n      label: source,\n    }));\n    Object.entries(fields)\n      .filter(([, field]) => field.type === \"event-source\")\n      .forEach(([name]) => {\n        overrides[name] = { options };\n      });\n  }\n\n  if (capabilities?.eventTypes?.length) {\n    const options = capabilities.eventTypes.map((type) => ({\n      value: type,\n      label: type,\n    }));\n    Object.entries(fields)\n      .filter(([, field]) => field.type === \"event-type\")\n      .forEach(([name]) => {\n        overrides[name] = { options };\n      });\n  }\n\n  return overrides;\n}\n\n/** The options a field offers, after deployment constraints are applied. */\nexport function getFieldOptions(\n  name: string,\n  field: SetupFormField,\n  overrides: SetupFieldOverrides = {},\n): SetupFieldOption[] {\n  return overrides[name]?.options ?? field.options ?? [];\n}\n\n/**\n * Every value a field holds, whether it collects one or many.\n *\n * Reading both shapes as a list is what keeps validation, interpolation and\n * the payload mapping from branching on `multiple` at every use.\n */\nfunction isFileValue(value: SetupFormValue | undefined): value is File {\n  return typeof File !== \"undefined\" && value instanceof File;\n}\n\nexport function fieldValues(value: SetupFormValue | undefined): string[] {\n  if (Array.isArray(value)) return value.filter((item) => item.trim() !== \"\");\n  if (isFileValue(value)) return value.name ? [value.name] : [];\n  if (typeof value === \"string\" && value.trim() === \"\") return [];\n  if (value === undefined || value === null) return [];\n  return [String(value)];\n}\n\n/** The single value a field holds, or \"\" for a field collecting several. */\nexport function fieldText(value: SetupFormValue | undefined): string {\n  if (Array.isArray(value) || value === undefined || value === null) return \"\";\n  if (isFileValue(value)) return value.name;\n  return String(value);\n}\n\n/** Initial form state: every declared field, seeded with its declared default. */\nexport function getInitialFormValues(\n  setup: SetupBlock,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFormValues {\n  return Object.fromEntries(\n    Object.entries(collectFields(setup, selectedTrigger, selectedAction)).map(\n      ([name, field]) => [\n        name,\n        // A field collecting several values starts empty rather than holding one\n        // blank entry, so \"required\" means \"add one\" rather than \"fill this in\".\n        field.multiple ? [] : (field.default ?? \"\"),\n      ],\n    ),\n  );\n}\n\nfunction validateField(\n  name: string,\n  field: SetupFormField,\n  rawValue: SetupFormValue | undefined,\n  overrides: SetupFieldOverrides,\n): SetupFieldError | null {\n  const entered = fieldValues(rawValue);\n\n  if (entered.length === 0) {\n    return field.required ? { code: \"required\" } : null;\n  }\n\n  // Every entry of a multi-value field answers the same field, so each is held\n  // to the same rules and the first failure is the one reported.\n  const failures = entered\n    .map((item) => validateValue(name, field, item.trim(), overrides))\n    .filter((error): error is SetupFieldError => error !== null);\n  return failures[0] ?? null;\n}\n\nfunction validateValue(\n  name: string,\n  field: SetupFormField,\n  value: string,\n  overrides: SetupFieldOverrides,\n): SetupFieldError | null {\n  const { minLength, maxLength, min, max, format } = field.constraints ?? {};\n  if (minLength !== undefined && value.length < minLength) {\n    return { code: \"minLength\", length: minLength };\n  }\n  if (maxLength !== undefined && value.length > maxLength) {\n    return { code: \"maxLength\", length: maxLength };\n  }\n  if (field.type === \"number\") {\n    const numeric = Number(value);\n    if (Number.isNaN(numeric)) return { code: \"invalidOption\" };\n    if (min !== undefined && numeric < min) return { code: \"min\", value: min };\n    if (max !== undefined && numeric > max) return { code: \"max\", value: max };\n  }\n  if (\n    format === \"safeExpressionLiteral\" &&\n    UNSAFE_EXPRESSION_LITERAL_PATTERN.test(value)\n  ) {\n    return { code: \"unsafeExpressionLiteral\" };\n  }\n\n  // Any field offering a closed set of values, whether the manifest declared it\n  // or the deployment supplied it, must be answered from that set.\n  const options = getFieldOptions(name, field, overrides);\n  if (options.length > 0 && !options.some((option) => option.value === value)) {\n    return { code: \"invalidOption\" };\n  }\n\n  return null;\n}\n\n/** Check every declared field. Returns only the fields that failed. */\nexport function validateFormValues(\n  setup: SetupBlock,\n  values: SetupFormValues,\n  overrides: SetupFieldOverrides = {},\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFieldErrors {\n  return Object.entries(\n    collectFields(setup, selectedTrigger, selectedAction),\n  ).reduce<SetupFieldErrors>((errors, [name, field]) => {\n    const error = validateField(name, field, values[name], overrides);\n    return error ? { ...errors, [name]: error } : errors;\n  }, {});\n}\n"],"mappings":";AAkDA,SAAgB,EAAY,GAAsC;CAChE,OAAO,OAAO,KAAK,EAAM,WAAW,CAAC,CAAC;AACxC"}

package/dist/manifests/manifest-template.cjs

@@ -0,0 +1,2 @@
+require("../_virtual/_rolldown/runtime.cjs");var e=/\{\{([A-Za-z0-9_]+(?:\.[A-Za-z0-9_]+)*)\}\}/g;function t(e){return typeof e==`string`?e:typeof e==`number`||typeof e==`boolean`?String(e):Array.isArray(e)?e.map(t).filter(Boolean).join(`, `):``}function n(n,r){return n.replace(e,(e,n)=>t(r[n]))}exports.interpolateValues=n;
+//# sourceMappingURL=manifest-template.cjs.map

package/dist/manifests/manifest-template.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-template.cjs","names":[],"sources":["../../src/manifests/manifest-template.ts"],"sourcesContent":["/**\n * Placeholder interpolation for setup copy and request-body strings.\n *\n * A setup block declares what the user sees and the two request strings the\n * host cannot derive as templates over a small set of namespaces. Interpolation\n * is plain substitution — there is no expression language, so a setup block\n * cannot express behavior here.\n */\n\nimport type { SetupEntry, SetupFormValues, SetupPayloadValue } from \"./types\";\n\nconst PLACEHOLDER_PATTERN = /\\{\\{([A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*)\\}\\}/g;\n\nexport interface SetupScope {\n  form?: SetupFormValues;\n  /** The catalog entry the setup block belongs to. */\n  automation?: SetupEntry;\n}\n\n/** Walk a dotted path through plain objects. */\nexport function getByPath(source: unknown, path: string): unknown {\n  return path.split(\".\").reduce<unknown>((current, segment) => {\n    if (typeof current !== \"object\" || current === null) return undefined;\n    return (current as Record<string, unknown>)[segment];\n  }, source);\n}\n\nfunction toText(value: unknown): string {\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n  // A multi-value field inside a sentence reads as a list of names.\n  if (Array.isArray(value)) return value.map(toText).filter(Boolean).join(\", \");\n  // Missing values render as blank; callers that care show their own fallback.\n  return \"\";\n}\n\n/** A template that is exactly one placeholder, or null if it is not. */\nfunction wholePlaceholderPath(template: string): string | null {\n  const match = /^\\{\\{([A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*)\\}\\}$/.exec(template);\n  return match ? match[1] : null;\n}\n\nfunction isPlainPayloadValue(value: unknown): value is SetupPayloadValue {\n  if (\n    value === null ||\n    typeof value === \"string\" ||\n    typeof value === \"number\" ||\n    typeof value === \"boolean\"\n  ) {\n    return true;\n  }\n  if (Array.isArray(value)) return value.every(isPlainPayloadValue);\n  if (typeof value !== \"object\") return false;\n  if (Object.getPrototypeOf(value) !== Object.prototype) return false;\n  return Object.values(value).every(isPlainPayloadValue);\n}\n\n/**\n * Substitute placeholders, keeping the resolved value's own type when the\n * template is nothing but that placeholder.\n *\n * This is what lets a request body state `\"repos\": \"{{form.repositories}}\"` and\n * get an array. Inside a sentence the same placeholder still reads as text,\n * because there is nowhere for a list to go in a string.\n *\n * Plain JSON form values are kept whole. A placeholder naming anything else -\n * for example `{{automation.setup}}`, or a browser `File` selected by the user -\n * reads as text like it does inside a sentence, so a manifest cannot state one\n * value and put its own object graph into the request body.\n */\nexport function interpolateValue(\n  template: string,\n  scope: SetupScope,\n): SetupPayloadValue {\n  const path = wholePlaceholderPath(template);\n  if (path === null) return interpolateText(template, scope);\n  const resolved = getByPath(scope, path);\n  return isPlainPayloadValue(resolved) ? resolved : toText(resolved);\n}\n\n/** Substitute placeholders inside a template string. */\nexport function interpolateText(template: string, scope: SetupScope): string {\n  return template.replace(PLACEHOLDER_PATTERN, (_match, path: string) =>\n    toText(getByPath(scope, path)),\n  );\n}\n\n/** Substitute placeholders from a flat name → value record. */\nexport function interpolateValues(\n  template: string,\n  values: Record<string, string | number>,\n): string {\n  return template.replace(PLACEHOLDER_PATTERN, (_match, name: string) =>\n    toText(values[name]),\n  );\n}\n"],"mappings":"6CAWA,IAAM,EAAsB,+CAgB5B,SAAS,EAAO,EAAwB,CAQtC,OAPI,OAAO,GAAU,SAAiB,EAClC,OAAO,GAAU,UAAY,OAAO,GAAU,UACzC,OAAO,CAAK,EAGjB,MAAM,QAAQ,CAAK,EAAU,EAAM,IAAI,CAAM,EAAE,OAAO,OAAO,EAAE,KAAK,IAAI,EAErE,EACT,CAsDA,SAAgB,EACd,EACA,EACQ,CACR,OAAO,EAAS,QAAQ,GAAsB,EAAQ,IACpD,EAAO,EAAO,EAAK,CACrB,CACF"}

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

@@ -6,7 +6,7 @@
  * is plain substitution — there is no expression language, so a setup block
  * cannot express behavior here.
  */
-import type { SetupEntry, SetupFormValues } from "./types";
+import type { SetupEntry, SetupFormValues, SetupPayloadValue } from "./types";
 export interface SetupScope {
     form?: SetupFormValues;
     /** The catalog entry the setup block belongs to. */
@@ -22,12 +22,12 @@ export declare function getByPath(source: unknown, path: string): unknown;
  * get an array. Inside a sentence the same placeholder still reads as text,
  * because there is nowhere for a list to go in a string.
  *
- * Only the shapes a form value has are kept whole. A placeholder naming
- * anything else - `{{automation.setup}}` resolves to the setup block itself -
+ * Plain JSON form values are kept whole. A placeholder naming anything else -
+ * for example `{{automation.setup}}`, or a browser `File` selected by the user -
  * reads as text like it does inside a sentence, so a manifest cannot state one
  * value and put its own object graph into the request body.
  */
-export declare function interpolateValue(template: string, scope: SetupScope): string | string[];
+export declare function interpolateValue(template: string, scope: SetupScope): SetupPayloadValue;
 /** Substitute placeholders inside a template string. */
 export declare function interpolateText(template: string, scope: SetupScope): string;
 /** Substitute placeholders from a flat name → value record. */

package/dist/manifests/manifest-template.js

@@ -0,0 +1,12 @@
+//#region src/manifests/manifest-template.ts
+var e = /\{\{([A-Za-z0-9_]+(?:\.[A-Za-z0-9_]+)*)\}\}/g;
+function t(e) {
+	return typeof e == "string" ? e : typeof e == "number" || typeof e == "boolean" ? String(e) : Array.isArray(e) ? e.map(t).filter(Boolean).join(", ") : "";
+}
+function n(n, r) {
+	return n.replace(e, (e, n) => t(r[n]));
+}
+//#endregion
+export { n as interpolateValues };
+
+//# sourceMappingURL=manifest-template.js.map

package/dist/manifests/manifest-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-template.js","names":[],"sources":["../../src/manifests/manifest-template.ts"],"sourcesContent":["/**\n * Placeholder interpolation for setup copy and request-body strings.\n *\n * A setup block declares what the user sees and the two request strings the\n * host cannot derive as templates over a small set of namespaces. Interpolation\n * is plain substitution — there is no expression language, so a setup block\n * cannot express behavior here.\n */\n\nimport type { SetupEntry, SetupFormValues, SetupPayloadValue } from \"./types\";\n\nconst PLACEHOLDER_PATTERN = /\\{\\{([A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*)\\}\\}/g;\n\nexport interface SetupScope {\n  form?: SetupFormValues;\n  /** The catalog entry the setup block belongs to. */\n  automation?: SetupEntry;\n}\n\n/** Walk a dotted path through plain objects. */\nexport function getByPath(source: unknown, path: string): unknown {\n  return path.split(\".\").reduce<unknown>((current, segment) => {\n    if (typeof current !== \"object\" || current === null) return undefined;\n    return (current as Record<string, unknown>)[segment];\n  }, source);\n}\n\nfunction toText(value: unknown): string {\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n  // A multi-value field inside a sentence reads as a list of names.\n  if (Array.isArray(value)) return value.map(toText).filter(Boolean).join(\", \");\n  // Missing values render as blank; callers that care show their own fallback.\n  return \"\";\n}\n\n/** A template that is exactly one placeholder, or null if it is not. */\nfunction wholePlaceholderPath(template: string): string | null {\n  const match = /^\\{\\{([A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*)\\}\\}$/.exec(template);\n  return match ? match[1] : null;\n}\n\nfunction isPlainPayloadValue(value: unknown): value is SetupPayloadValue {\n  if (\n    value === null ||\n    typeof value === \"string\" ||\n    typeof value === \"number\" ||\n    typeof value === \"boolean\"\n  ) {\n    return true;\n  }\n  if (Array.isArray(value)) return value.every(isPlainPayloadValue);\n  if (typeof value !== \"object\") return false;\n  if (Object.getPrototypeOf(value) !== Object.prototype) return false;\n  return Object.values(value).every(isPlainPayloadValue);\n}\n\n/**\n * Substitute placeholders, keeping the resolved value's own type when the\n * template is nothing but that placeholder.\n *\n * This is what lets a request body state `\"repos\": \"{{form.repositories}}\"` and\n * get an array. Inside a sentence the same placeholder still reads as text,\n * because there is nowhere for a list to go in a string.\n *\n * Plain JSON form values are kept whole. A placeholder naming anything else -\n * for example `{{automation.setup}}`, or a browser `File` selected by the user -\n * reads as text like it does inside a sentence, so a manifest cannot state one\n * value and put its own object graph into the request body.\n */\nexport function interpolateValue(\n  template: string,\n  scope: SetupScope,\n): SetupPayloadValue {\n  const path = wholePlaceholderPath(template);\n  if (path === null) return interpolateText(template, scope);\n  const resolved = getByPath(scope, path);\n  return isPlainPayloadValue(resolved) ? resolved : toText(resolved);\n}\n\n/** Substitute placeholders inside a template string. */\nexport function interpolateText(template: string, scope: SetupScope): string {\n  return template.replace(PLACEHOLDER_PATTERN, (_match, path: string) =>\n    toText(getByPath(scope, path)),\n  );\n}\n\n/** Substitute placeholders from a flat name → value record. */\nexport function interpolateValues(\n  template: string,\n  values: Record<string, string | number>,\n): string {\n  return template.replace(PLACEHOLDER_PATTERN, (_match, name: string) =>\n    toText(values[name]),\n  );\n}\n"],"mappings":";AAWA,IAAM,IAAsB;AAgB5B,SAAS,EAAO,GAAwB;CAQtC,OAPI,OAAO,KAAU,WAAiB,IAClC,OAAO,KAAU,YAAY,OAAO,KAAU,YACzC,OAAO,CAAK,IAGjB,MAAM,QAAQ,CAAK,IAAU,EAAM,IAAI,CAAM,EAAE,OAAO,OAAO,EAAE,KAAK,IAAI,IAErE;AACT;AAsDA,SAAgB,EACd,GACA,GACQ;CACR,OAAO,EAAS,QAAQ,IAAsB,GAAQ,MACpD,EAAO,EAAO,EAAK,CACrB;AACF"}