@openhands/agent-canvas 1.16.0 → 1.18.0

package/dist/locales/zh-TW/openhands.json

@@ -693,6 +693,7 @@
   "SETTINGS$RESET": "設置已重置",
   "SETTINGS$API_KEYS": "API金鑰",
   "SETTINGS$API_KEYS_DESCRIPTION": "API密鑰允許您以編程方式驗證OpenHands API。請確保您的API密鑰安全；任何擁有您API密鑰的人都可以訪問您的賬戶。有關如何使用API的更多信息，請參閱我們的<a>API文檔</a>。",
+  "SETTINGS$OPENHANDS_FREE_MODELS_NOTE": "免費的 OpenHands 模型：{{ids}}。其他供應商中名稱相似的模型端點可能需要另外付費。",
   "SETTINGS$OPENHANDS_API_KEY_HELP_TEXT": "您可以在",
   "SETTINGS$OPENHANDS_API_KEY_HELP_LINK": "OpenHands LLM Key",
   "SETTINGS$OPENHANDS_API_KEY_HELP_SUFFIX": "區塊中找到您的 OpenHands Provider LLM Key -",
@@ -797,7 +798,9 @@
   "AUTOMATIONS$ERROR_TIMEOUT_INVALID_NUMBER": "超時必須是有效數字",
   "AUTOMATIONS$ERROR_TIMEOUT_POSITIVE": "超時必須為正數",
   "AUTOMATIONS$ERROR_TIMEOUT_MAX_EXCEEDED": "超時不能超過{{max}}秒",
-  "AUTOMATIONS$CUSTOM_SCHEDULE_HINT": "此自動化使用自訂排程。已停用頻率編輯以避免破壞它。",
+  "AUTOMATIONS$CRON_EXPRESSION": "Cron 運算式",
+  "AUTOMATIONS$ERROR_CRON_INVALID": "請輸入有效的 cron 運算式",
+  "AUTOMATIONS$ERROR_CRON_UNREACHABLE": "此 cron 運算式永遠不會執行",
   "AUTOMATIONS$EDIT_SUCCESS": "自動化已更新",
   "AUTOMATIONS$EDIT_ERROR": "無法更新自動化",
   "AUTOMATIONS$RUN_NOW_SUCCESS": "自動化已觸發",
@@ -817,6 +820,18 @@
   "AUTOMATIONS$DETAIL$RUNNING": "執行中",
   "AUTOMATIONS$DETAIL$CANCELLED": "已取消",
   "AUTOMATIONS$DETAIL$SKIPPED": "已略過",
+  "AUTOMATIONS$DETAIL$BLOCKED": "受阻",
+  "AUTOMATIONS$DETAIL$PARTIAL": "部分完成",
+  "AUTOMATIONS$DETAIL$NEEDS_REVIEW": "需要審查",
+  "AUTOMATIONS$DETAIL$RUN_LABEL": "執行",
+  "AUTOMATIONS$DETAIL$TASK_LABEL": "任務",
+  "AUTOMATIONS$DETAIL$SYSTEM_LABEL": "系統",
+  "AUTOMATIONS$DETAIL$NO_TASK_OUTCOME": "未回報任務結果。",
+  "AUTOMATIONS$DETAIL$NO_SYSTEM_ISSUES": "未回報系統問題。",
+  "AUTOMATIONS$DETAIL$STATUS_DETAIL": "狀態詳細資訊",
+  "AUTOMATIONS$DETAIL$TASK_METADATA": "任務中繼資料",
+  "AUTOMATIONS$DETAIL$CUSTOM_TASK_METADATA": "已回報自訂任務中繼資料。",
+  "AUTOMATIONS$DETAIL$VIEW_CONVERSATION_FOR_RUN": "查看 {{timestamp}} 執行的對話",
   "AUTOMATIONS$DETAIL$PHASE": "階段",
   "AUTOMATIONS$DETAIL$PHASE_QUEUED": "排隊中",
   "AUTOMATIONS$DETAIL$PHASE_SANDBOX_PROVISIONING": "正在設定沙盒",
@@ -861,6 +876,7 @@
   "AUTOMATIONS$DETAIL$PLUGINS": "外掛",
   "AUTOMATIONS$DETAIL$PROMPT": "提示",
   "AUTOMATIONS$DETAIL$REPOSITORIES": "存放庫",
+  "AUTOMATIONS$DETAIL$RUNS_AS": "自動化執行身分",
   "AUTOMATIONS$DETAIL$SCHEDULE": "排程",
   "AUTOMATIONS$DETAIL$SUCCESSFUL": "成功",
   "AUTOMATIONS$DETAIL$TRIGGER": "觸發器",
@@ -1034,27 +1050,48 @@
   "CONVERSATION_PANEL$ORGANIZE": "整理",
   "CONVERSATION_PANEL$BY_WORKSPACE": "依工作區",
   "CONVERSATION_PANEL$BY_REPOSITORY": "依存放庫",
-  "CONVERSATION_PANEL$CHRONOLOGICAL": "時間序列清單",
+  "CONVERSATION_PANEL$CHRONOLOGICAL": "依日期",
+  "CONVERSATION_PANEL$CLEAR_FILTERS": "全部清除",
   "CONVERSATION_PANEL$SORT_BY": "排序依據",
   "CONVERSATION_PANEL$SORT_CREATED": "建立時間",
   "CONVERSATION_PANEL$SORT_UPDATED": "更新時間",
   "CONVERSATION_PANEL$OLDER_SECTION": "較舊的對話",
   "CONVERSATION_PANEL$OLDER_OVER_ONE_HOUR": "超過 1 小時",
-  "CONVERSATION_PANEL$SHOW": "顯示",
+  "CONVERSATION_PANEL$OLDER_OVER_ONE_DAY": "超過 1 天",
+  "CONVERSATION_PANEL$OLDER_OVER_ONE_WEEK": "超過 1 週",
+  "CONVERSATION_PANEL$OLDER_OVER_THIRTY_DAYS": "超過 30 天",
+  "CONVERSATION_PANEL$HIDE_CONVERSATIONS": "隱藏舊對話",
+  "CONVERSATION_PANEL$OLDER_CUTOFF_LABEL": "隱藏早於此時間的對話",
+  "CONVERSATION_PANEL$SHOW": "其他",
+  "CONVERSATION_PANEL$THREADS": "對話串",
   "CONVERSATION_PANEL$ALL_THREADS": "所有對話串",
-  "CONVERSATION_PANEL$RELEVANT_THREADS": "相關（進行中）",
+  "CONVERSATION_PANEL$RELEVANT_THREADS": "僅作用中",
   "CONVERSATION_PANEL$SHOW_ARCHIVED": "顯示已封存",
   "CONVERSATION_PANEL$METADATA": "中繼資料",
   "CONVERSATION_PANEL$LLM_MODEL": "代理 / 模型",
   "CONVERSATION_PANEL$REPO_BRANCH": "存放庫與分支",
   "CONVERSATION_PANEL$TAGS": "標籤",
+  "CONVERSATION_PANEL$SHOW_TAGS": "顯示 {{count}} 個標籤",
+  "CONVERSATION_PANEL$HIDE_TAGS": "隱藏標籤",
+  "CONVERSATION_PANEL$TAG_CHIPS": "顯示標籤",
+  "CONVERSATION_PANEL$LAYOUTS_HEADING": "檢視",
+  "CONVERSATION_PANEL$LAYOUT_RECENT_ACTIVITY": "最近",
+  "CONVERSATION_PANEL$LAYOUT_FOCUSED": "作用中",
+  "CONVERSATION_PANEL$LAYOUT_MINIMAL": "精簡",
+  "CONVERSATION_PANEL$TAG_FILTERS": "依標籤篩選",
+  "CONVERSATION_PANEL$NO_VISIBLE_TAGS": "尚無標籤",
+  "CONVERSATION_PANEL$ADVANCED_OPTIONS": "更多選項",
+  "CONVERSATION_PANEL$ADVANCED_OPTIONS_CUSTOM": "自訂",
+  "CONVERSATION_PANEL$ADVANCED_OPTIONS_DESCRIPTION": "選擇對話如何分組以及每列顯示什麼。變更會自動儲存。",
+  "CONVERSATION_PANEL$SHOW_OLDER_CONVERSATIONS": "顯示較早的對話",
   "CONVERSATION_PANEL$AUTOMATIONS": "自動化",
-  "CONVERSATION_PANEL$AUTOMATIONS_ALL": "所有對話",
+  "CONVERSATION_PANEL$AUTOMATIONS_ALL": "與全部一起顯示",
   "CONVERSATION_PANEL$AUTOMATIONS_HIDE": "隱藏自動化執行",
   "CONVERSATION_PANEL$AUTOMATIONS_ONLY": "僅自動化執行",
   "CONVERSATION_PANEL$AUTOMATION_UNNAMED": "未命名自動化",
   "CONVERSATION_PANEL$NO_AUTOMATION_MATCHES": "沒有對話符合自動化篩選條件",
-  "CONVERSATION_PANEL$HOVER_METADATA": "懸停中繼資料",
+  "CONVERSATION_PANEL$NO_TAG_MATCHES": "沒有對話符合標籤篩選條件",
+  "CONVERSATION_PANEL$HOVER_METADATA": "懸停時顯示詳情",
   "CONVERSATION_PANEL$NO_WORKSPACE": "無工作區",
   "CONVERSATION_PANEL$NO_REPOSITORY": "無存放庫",
   "CONVERSATION_PANEL$NEW_THREAD_FOLDER_ARIA": "建立對話資料夾 — 選擇工作區或存放庫",
@@ -1112,7 +1149,6 @@
   "CONVERSATION$TOTAL_COST": "總成本",
   "CONVERSATION$BUDGET": "預算",
   "CONVERSATION$BUDGET_USAGE": "% 已使用",
-  "CONVERSATION$NO_BUDGET_LIMIT": "無預算限制",
   "CONVERSATION$INPUT": "輸入",
   "CONVERSATION$OUTPUT": "輸出",
   "CONVERSATION$TOTAL": "總計",
@@ -1220,7 +1256,7 @@
   "SETTINGS$FAILED_TO_SAVE_EMAIL": "儲存郵箱失敗",
   "SETTINGS$SENDING": "發送中",
   "SETTINGS$VERIFICATION_EMAIL_SENT": "驗證郵件已發送",
-  "SETTINGS$EMAIL_VERIFICATION_REQUIRED": "使用All Hands前，您必須驗證您的電子郵件地址",
+  "SETTINGS$EMAIL_VERIFICATION_REQUIRED": "使用OpenHands前，您必須驗證您的電子郵件地址",
   "SETTINGS$INVALID_EMAIL_FORMAT": "請輸入有效的電子郵件地址",
   "SETTINGS$EMAIL_VERIFICATION_RESTRICTION_MESSAGE": "在驗證您的電子郵件之前，您的訪問權限受到限制。您只能訪問此設置頁面。",
   "SETTINGS$RESEND_VERIFICATION": "重新發送驗證",
@@ -1286,7 +1322,7 @@
   "API$TVLY_KEY_EXAMPLE": "tvly-...",
   "SECRETS$CONNECT_GIT_PROVIDER": "連接Git提供商以管理密鑰",
   "SETTINGS$OPENHANDS_API_KEYS": "OpenHands API密鑰",
-  "CONVERSATION$BUDGET_USAGE_FORMAT": "${currentCost} / ${maxBudget} ({usagePercentage}% {used})",
+  "CONVERSATION$BUDGET_USAGE_FORMAT": "{{currentCost}} / {{maxBudget}} ({{usagePercentage}}% {{used}})",
   "CONVERSATION$CACHE_HIT": "緩存命中",
   "CONVERSATION$CACHE_WRITE": "緩存寫入",
   "BUTTON$CONFIRM": "確認",
@@ -1880,7 +1916,8 @@
   "THINKING$COLLAPSE": "摺疊思考",
   "MCP$LIBRARY_TITLE": "資料庫",
   "NAV$CUSTOMIZE": "自訂",
-  "NAV$EXTENSIONS": "擴充功能",
+  "NAV$EXTENSIONS": "應用程式",
+  "SETTINGS$APPS_PAGE_TITLE": "Agent Canvas 應用程式",
   "NAV$COMING_SOON": "即將推出",
   "SETTINGS$PLUGINS_TITLE": "外掛程式",
   "SETTINGS$PLUGINS_DESCRIPTION": "外掛程式設定選項將顯示於此。",
@@ -1907,17 +1944,21 @@
   "SETTINGS$PLUGINS_UNINSTALL_SUCCESS": "外掛程式已解除安裝。",
   "SETTINGS$PLUGINS_REFRESH_SUCCESS": "外掛程式已更新。",
   "SETTINGS$PLUGINS_SKILLS_IN_BUNDLE": "此外掛程式套件中的技能",
-  "SETTINGS$CANVAS_EXTENSIONS_PAGE_DESCRIPTION": "為此後端安裝在 Canvas 內執行的受信任 UI。已安裝的擴充功能在您於此處啟用前將保持關閉。",
-  "SETTINGS$CANVAS_EXTENSIONS_ADD_BUTTON": "新增擴充功能",
-  "SETTINGS$CANVAS_EXTENSIONS_EMPTY": "此後端未安裝任何 Canvas 擴充功能。",
-  "SETTINGS$CANVAS_EXTENSIONS_TRUST_NOTICE": "已啟用的擴充功能是受信任程式碼，可完整存取此 Canvas 工作階段。",
-  "SETTINGS$CANVAS_EXTENSIONS_ADD_MODAL_INTRO": "從 Git 來源或作用中 Agent Server 上的路徑安裝。擴充功能安裝後將處於停用狀態。",
-  "SETTINGS$CANVAS_EXTENSIONS_INSTALL_SUCCESS": "擴充功能已安裝。請在此處檢視，並在準備好後啟用。",
-  "SETTINGS$CANVAS_EXTENSIONS_UNINSTALL_SUCCESS": "擴充功能已解除安裝。",
-  "SETTINGS$CANVAS_EXTENSIONS_ENABLE_CONFIRM": "已啟用的擴充功能是受信任程式碼，可完整存取此 Canvas 工作階段。要啟用 {{name}} 嗎？",
-  "SETTINGS$CANVAS_EXTENSIONS_UNINSTALL_CONFIRM": "要從此後端解除安裝 {{name}} 嗎？",
-  "SETTINGS$CANVAS_EXTENSIONS_PAGES": "頁面",
-  "SETTINGS$CANVAS_EXTENSIONS_PAGE_UNAVAILABLE": "此擴充功能已停用、遺失或未提供此頁面。",
+  "SETTINGS$APPS_PAGE_DESCRIPTION": "應用程式使用 Canvas Extensions API 建置",
+  "SETTINGS$APPS_BUILD_LINK": "建置應用程式",
+  "SETTINGS$APPS_ADD_BUTTON": "新增應用程式",
+  "SETTINGS$APPS_INSTALLED": "已安裝的應用程式",
+  "SETTINGS$APPS_SOURCE_LABEL": "應用程式來源",
+  "SETTINGS$APPS_EMPTY": "此後端未安裝任何應用程式。",
+  "SETTINGS$APPS_TRUST_NOTICE": "此應用程式會在 Agent Canvas 中執行受信任的 JavaScript，並可向目前的 Agent Server 發出經過驗證的請求。啟用前請檢查其原始碼和修訂版本。",
+  "SETTINGS$APPS_ENABLE_ACTION": "啟用受信任的應用程式",
+  "SETTINGS$APPS_ADD_MODAL_INTRO": "從 Git 來源或目前 Agent Server 上的路徑安裝。應用程式安裝後將保持停用。",
+  "SETTINGS$APPS_INSTALL_SUCCESS": "應用程式已安裝。請在此檢查，準備好後再啟用。",
+  "SETTINGS$APPS_UNINSTALL_SUCCESS": "應用程式已解除安裝。",
+  "SETTINGS$APPS_ENABLE_CONFIRM": "此應用程式會在 Agent Canvas 中執行受信任的 JavaScript，並可向目前的 Agent Server 發出經過驗證的請求。啟用前請檢查其原始碼和修訂版本。",
+  "SETTINGS$APPS_UNINSTALL_CONFIRM": "要從此後端解除安裝 {{name}} 嗎？",
+  "SETTINGS$APPS_PAGES": "頁面",
+  "SETTINGS$APPS_PAGE_UNAVAILABLE": "此應用程式已停用、缺少或未提供此頁面。",
   "SETTINGS$SKILLS_PAGE_DESCRIPTION": "探索要加入工作區的技能。開啟卡片以查看提示、curl 和安裝流程。從側邊欄搜尋以篩選清單。啟用或停用預設技能。停用的技能不會載入到代理上下文中。",
   "SETTINGS$SKILLS_ADD_BUTTON": "新增技能",
   "SETTINGS$SKILLS_USE_SKILL_BUTTON": "使用技能",
@@ -2161,6 +2202,9 @@
   "SETUP$VALIDATION_INVALID_OPTION": "請從可用選項中選擇。",
   "SETUP$VALIDATION_UNSAFE_VALUE": "不允許使用引號和反斜線。",
   "SETUP$REVIEW_TITLE": "確認",
+  "SETUP$ACTION_LABEL": "動作",
+  "SETUP$TRIGGER_LABEL": "觸發條件",
+  "SETUP$TRIGGER_HELP": "選擇自動化要依排程執行，還是在事件到達時執行。",
   "SETUP$CONFIRM": "確認並建立",
   "SETUP$FALLBACK_CONVERSATION": "在對話中設定",
   "SETUP$EMPTY_VALUE": "未設定",
@@ -2267,6 +2311,16 @@
   "CHAT_INTERFACE$CONTEXT_WINDOW_METER_LABEL": "上下文視窗用量",
   "CHAT_INTERFACE$SHOW_CONTEXT": "顯示上下文",
   "CONVERSATION$TAGS_OVERFLOW_ARIA": "顯示另外 {{count}} 個標籤",
+  "CONVERSATION$EDIT_TAGS": "編輯標籤",
+  "CONVERSATION$EDIT_TAGS_DESCRIPTION": "為此對話新增或刪除標籤。",
+  "CONVERSATION$TAG_KEY_PLACEHOLDER": "名稱",
+  "CONVERSATION$TAG_VALUE_PLACEHOLDER": "值（選填）",
+  "CONVERSATION$REMOVE_TAG": "刪除標籤",
+  "CONVERSATION$TAG_KEY_INVALID": "標籤名稱只能包含小寫字母和數字",
+  "CONVERSATION$TAG_KEY_RESERVED": "此標籤名稱已被保留",
+  "CONVERSATION$TAG_KEY_DUPLICATE": "此標籤名稱已被使用",
+  "CONVERSATION$TAG_VALUE_INVALID": "標籤值不能超過 256 個字元",
+  "CONVERSATION$TAGS_UPDATED": "標籤已更新",
   "CONVERSATION_PANEL$PREVIEW_GIT": "Git",
   "CONVERSATION_PANEL$PREVIEW_REPO": "倉庫",
   "CONVERSATION_PANEL$PREVIEW_BRANCH": "分支",
@@ -2398,5 +2452,8 @@
   "SETTINGS$PROVIDER_CONNECTION_PROVIDER": "提供者",
   "SETTINGS$PROVIDER_CONNECTION_ROTATE_HINT": "留空以保留目前的金鑰。",
   "SETTINGS$PROVIDER_CONNECTION_SELECT_LABEL": "提供者連線",
-  "SETTINGS$PROVIDER_CONNECTION_UPDATED": "已更新連線「{{name}}」"
+  "SETTINGS$PROVIDER_CONNECTION_UPDATED": "已更新連線「{{name}}」",
+  "BUTTON$VIEW_FULL_SIZE_IMAGE": "檢視原始尺寸圖片",
+  "BUTTON$REMOVE_IMAGE": "移除圖片",
+  "IMAGE$FULL_SIZE_PREVIEW": "原始尺寸圖片預覽"
 }

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

@@ -1 +1 @@
-{"version":3,"file":"automation-insights.cjs","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":"wFAuE0B,IAAI,IAAyB,CACrD,EAAA,oBAAoB,UACpB,EAAA,oBAAoB,MACtB,CAAC,EAyDD,SAAgB,EAAsB,EAA2B,CAI/D,OAHI,IAAO,MAAQ,CAAC,OAAO,SAAS,CAAE,EAAU,IAC5C,EAAK,IAAe,GAAG,KAAK,IAAI,EAAG,KAAK,MAAM,EAAK,GAAI,CAAC,EAAE,GAC1D,EAAK,KAAkB,GAAG,KAAK,IAAI,EAAG,KAAK,MAAM,EAAK,GAAM,CAAC,EAAE,GAC5D,IAAI,EAAK,MAAW,QAAQ,CAAC,EAAE,EACxC"}
+{"version":3,"file":"automation-insights.cjs","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":"wFAgF0B,IAAI,IAAyB,CACrD,EAAA,oBAAoB,UACpB,EAAA,oBAAoB,MACtB,CAAC,EAiFD,SAAgB,EAAsB,EAA2B,CAI/D,OAHI,IAAO,MAAQ,CAAC,OAAO,SAAS,CAAE,EAAU,IAC5C,EAAK,IAAe,GAAG,KAAK,IAAI,EAAG,KAAK,MAAM,EAAK,GAAI,CAAC,EAAE,GAC1D,EAAK,KAAkB,GAAG,KAAK,IAAI,EAAG,KAAK,MAAM,EAAK,GAAM,CAAC,EAAE,GAC5D,IAAI,EAAK,MAAW,QAAQ,CAAC,EAAE,EACxC"}

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

@@ -9,8 +9,9 @@
  *
  * Summaries are derived from the newest page of runs (the sample the runs
  * hook fetches); `total` alone is the response's lifetime count. Success rate
- * and durations consider only COMPLETED and FAILED runs — a cancelled or
- * skipped run says nothing about either.
+ * and durations consider only terminal lifecycle runs; the success numerator
+ * uses task-aware display status so completed-but-blocked work is not counted
+ * as successful.
  */
 import { type Automation, type AutomationRun, type AutomationRunsResponse } from "#/types/automation";
 import type { DashboardSortValue, DashboardStatusValue, DashboardTriggerValue, InterfaceListInsights, OverviewMetric } from "./types";
@@ -20,6 +21,13 @@ export declare const HEALTH_LABEL_KEYS: Record<AutomationHealth, keyof Interface
 export interface AutomationRunSummary {
     /** Lifetime run count, from the response — not the sample's length. */
     total: number;
+    /**
+     * Lifetime COMPLETED-run count. From the response's `status_counts` when
+     * the service reports it; an older service leaves that out, so the sample
+     * stands in exactly when it holds the whole history (`total` ≤ its length)
+     * and the count is null — unknowable, never guessed — otherwise.
+     */
+    completedTotal: number | null;
     latestRun: AutomationRun | null;
     /** Newest-first sample used by the list sparkline (same page as the summary). */
     recentRuns: AutomationRun[];

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