agent-steward 0.0.3 → 0.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (287) hide show
  1. package/CHANGELOG.md +154 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +54 -9
  4. package/ROADMAP-STRATEGY.md +23 -20
  5. package/ROADMAP.md +140 -143
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +351 -0
  9. package/dist/core/dlq-api.d.ts +44 -0
  10. package/dist/core/dlq-api.d.ts.map +1 -0
  11. package/dist/core/dlq-api.js +68 -0
  12. package/dist/core/dry-run.d.ts.map +1 -1
  13. package/dist/core/dry-run.js +18 -1
  14. package/dist/core/execution.d.ts +203 -0
  15. package/dist/core/execution.d.ts.map +1 -0
  16. package/dist/core/execution.js +309 -0
  17. package/dist/core/gate-integrity.d.ts +35 -0
  18. package/dist/core/gate-integrity.d.ts.map +1 -0
  19. package/dist/core/gate-integrity.js +132 -0
  20. package/dist/core/git-trigger.d.ts.map +1 -1
  21. package/dist/core/git-trigger.js +14 -2
  22. package/dist/core/guard-run.d.ts +4 -0
  23. package/dist/core/guard-run.d.ts.map +1 -0
  24. package/dist/core/guard-run.js +101 -0
  25. package/dist/core/guard.d.ts +52 -0
  26. package/dist/core/guard.d.ts.map +1 -0
  27. package/dist/core/guard.js +362 -0
  28. package/dist/core/lock.d.ts +61 -4
  29. package/dist/core/lock.d.ts.map +1 -1
  30. package/dist/core/lock.js +213 -26
  31. package/dist/core/matrix.d.ts.map +1 -1
  32. package/dist/core/matrix.js +75 -15
  33. package/dist/core/mission.d.ts +83 -0
  34. package/dist/core/mission.d.ts.map +1 -0
  35. package/dist/core/mission.js +334 -0
  36. package/dist/core/one-shot.d.ts +5 -1
  37. package/dist/core/one-shot.d.ts.map +1 -1
  38. package/dist/core/one-shot.js +33 -8
  39. package/dist/core/opencode-cli.d.ts +28 -0
  40. package/dist/core/opencode-cli.d.ts.map +1 -0
  41. package/dist/core/opencode-cli.js +74 -0
  42. package/dist/core/opencode-models.d.ts +62 -0
  43. package/dist/core/opencode-models.d.ts.map +1 -0
  44. package/dist/core/opencode-models.js +277 -0
  45. package/dist/core/pipeline-apply.d.ts +38 -0
  46. package/dist/core/pipeline-apply.d.ts.map +1 -0
  47. package/dist/core/pipeline-apply.js +117 -0
  48. package/dist/core/pipeline-io.d.ts +13 -0
  49. package/dist/core/pipeline-io.d.ts.map +1 -0
  50. package/dist/core/pipeline-io.js +64 -0
  51. package/dist/core/pipeline-map.d.ts +46 -0
  52. package/dist/core/pipeline-map.d.ts.map +1 -0
  53. package/dist/core/pipeline-map.js +196 -0
  54. package/dist/core/pipeline-spec.d.ts +109 -0
  55. package/dist/core/pipeline-spec.d.ts.map +1 -0
  56. package/dist/core/pipeline-spec.js +554 -0
  57. package/dist/core/ps-wrapper.d.ts +19 -2
  58. package/dist/core/ps-wrapper.d.ts.map +1 -1
  59. package/dist/core/ps-wrapper.js +261 -63
  60. package/dist/core/record-history.d.ts +15 -0
  61. package/dist/core/record-history.d.ts.map +1 -1
  62. package/dist/core/record-history.js +183 -58
  63. package/dist/core/router/dispatch.d.ts +36 -0
  64. package/dist/core/router/dispatch.d.ts.map +1 -0
  65. package/dist/core/router/dispatch.js +59 -0
  66. package/dist/core/router/escalation.d.ts +47 -0
  67. package/dist/core/router/escalation.d.ts.map +1 -0
  68. package/dist/core/router/escalation.js +87 -0
  69. package/dist/core/router/planner.d.ts +53 -0
  70. package/dist/core/router/planner.d.ts.map +1 -0
  71. package/dist/core/router/planner.js +113 -0
  72. package/dist/core/router/rules.d.ts +46 -0
  73. package/dist/core/router/rules.d.ts.map +1 -0
  74. package/dist/core/router/rules.js +91 -0
  75. package/dist/core/run-panel-api.d.ts +94 -0
  76. package/dist/core/run-panel-api.d.ts.map +1 -0
  77. package/dist/core/run-panel-api.js +169 -0
  78. package/dist/core/schedule-gate.js +5 -1
  79. package/dist/core/schedule-v2.d.ts +34 -0
  80. package/dist/core/schedule-v2.d.ts.map +1 -1
  81. package/dist/core/schedule-v2.js +91 -5
  82. package/dist/core/scheduler/at-fallback.d.ts +55 -2
  83. package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
  84. package/dist/core/scheduler/at-fallback.js +135 -5
  85. package/dist/core/scheduler/linux.d.ts +18 -2
  86. package/dist/core/scheduler/linux.d.ts.map +1 -1
  87. package/dist/core/scheduler/linux.js +63 -20
  88. package/dist/core/scheduler/mac.d.ts +44 -2
  89. package/dist/core/scheduler/mac.d.ts.map +1 -1
  90. package/dist/core/scheduler/mac.js +126 -15
  91. package/dist/core/scheduler/posix.d.ts.map +1 -1
  92. package/dist/core/scheduler/posix.js +25 -1
  93. package/dist/core/scheduler/registry.d.ts +11 -0
  94. package/dist/core/scheduler/registry.d.ts.map +1 -1
  95. package/dist/core/scheduler/registry.js +83 -21
  96. package/dist/core/scheduler/run-now.d.ts +16 -0
  97. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  98. package/dist/core/scheduler/run-now.js +28 -0
  99. package/dist/core/scheduler/windows.d.ts.map +1 -1
  100. package/dist/core/scheduler/windows.js +15 -12
  101. package/dist/core/secrets.d.ts.map +1 -1
  102. package/dist/core/secrets.js +125 -28
  103. package/dist/core/session.d.ts.map +1 -1
  104. package/dist/core/session.js +18 -11
  105. package/dist/core/structured-log.d.ts +7 -1
  106. package/dist/core/structured-log.d.ts.map +1 -1
  107. package/dist/core/task-name.d.ts +24 -0
  108. package/dist/core/task-name.d.ts.map +1 -0
  109. package/dist/core/task-name.js +40 -0
  110. package/dist/core/worktree-run.d.ts +4 -0
  111. package/dist/core/worktree-run.d.ts.map +1 -0
  112. package/dist/core/worktree-run.js +164 -0
  113. package/dist/core/worktree.d.ts +115 -0
  114. package/dist/core/worktree.d.ts.map +1 -0
  115. package/dist/core/worktree.js +462 -0
  116. package/dist/core/wrappers/bash.d.ts +17 -0
  117. package/dist/core/wrappers/bash.d.ts.map +1 -1
  118. package/dist/core/wrappers/bash.js +224 -28
  119. package/dist/db/capability-repo.d.ts +124 -0
  120. package/dist/db/capability-repo.d.ts.map +1 -0
  121. package/dist/db/capability-repo.js +267 -0
  122. package/dist/db/history-repo.d.ts +46 -5
  123. package/dist/db/history-repo.d.ts.map +1 -1
  124. package/dist/db/history-repo.js +107 -25
  125. package/dist/db/index.d.ts +4 -0
  126. package/dist/db/index.d.ts.map +1 -1
  127. package/dist/db/index.js +39 -1
  128. package/dist/db/metrics-repo.js +2 -2
  129. package/dist/db/migrate.d.ts.map +1 -1
  130. package/dist/db/migrate.js +3 -1
  131. package/dist/db/recovery.d.ts.map +1 -1
  132. package/dist/db/recovery.js +5 -4
  133. package/dist/db/run-context.d.ts +103 -0
  134. package/dist/db/run-context.d.ts.map +1 -0
  135. package/dist/db/run-context.js +224 -0
  136. package/dist/db/run-dlq.d.ts +100 -0
  137. package/dist/db/run-dlq.d.ts.map +1 -0
  138. package/dist/db/run-dlq.js +191 -0
  139. package/dist/db/run-journal.d.ts +33 -5
  140. package/dist/db/run-journal.d.ts.map +1 -1
  141. package/dist/db/run-journal.js +78 -14
  142. package/dist/db/run-resume.d.ts +10 -2
  143. package/dist/db/run-resume.d.ts.map +1 -1
  144. package/dist/db/run-resume.js +39 -13
  145. package/dist/db/runs-repo.d.ts +32 -7
  146. package/dist/db/runs-repo.d.ts.map +1 -1
  147. package/dist/db/runs-repo.js +50 -11
  148. package/dist/db/schema.d.ts +2 -2
  149. package/dist/db/schema.d.ts.map +1 -1
  150. package/dist/db/schema.js +216 -3
  151. package/dist/db/settings-repo.d.ts +11 -0
  152. package/dist/db/settings-repo.d.ts.map +1 -1
  153. package/dist/db/settings-repo.js +25 -0
  154. package/dist/db/step-idempotency.d.ts +51 -0
  155. package/dist/db/step-idempotency.d.ts.map +1 -0
  156. package/dist/db/step-idempotency.js +136 -0
  157. package/dist/history.d.ts +1 -1
  158. package/dist/history.d.ts.map +1 -1
  159. package/dist/i18n.d.ts +5 -0
  160. package/dist/i18n.d.ts.map +1 -1
  161. package/dist/i18n.js +11 -4
  162. package/dist/index.d.ts +140 -6
  163. package/dist/index.d.ts.map +1 -1
  164. package/dist/index.js +480 -18
  165. package/dist/notifications.d.ts +22 -0
  166. package/dist/notifications.d.ts.map +1 -1
  167. package/dist/notifications.js +36 -8
  168. package/dist/profiles.d.ts.map +1 -1
  169. package/dist/profiles.js +25 -4
  170. package/dist/rpc.d.ts +924 -0
  171. package/dist/rpc.d.ts.map +1 -1
  172. package/dist/rpc.js +352 -0
  173. package/dist/server.d.ts +46 -0
  174. package/dist/server.d.ts.map +1 -1
  175. package/dist/server.js +172 -53
  176. package/dist/settings.d.ts +2 -2
  177. package/dist/settings.d.ts.map +1 -1
  178. package/dist/settings.js +3 -3
  179. package/dist/shared/jobs-view.d.ts +1 -1
  180. package/dist/shared/jobs-view.d.ts.map +1 -1
  181. package/dist/shared/jobs-view.js +2 -0
  182. package/dist/task-transfer.d.ts +16 -0
  183. package/dist/task-transfer.d.ts.map +1 -1
  184. package/dist/task-transfer.js +16 -0
  185. package/dist/types.d.ts.map +1 -1
  186. package/dist/types.js +7 -0
  187. package/dist/workspaces.d.ts +25 -3
  188. package/dist/workspaces.d.ts.map +1 -1
  189. package/dist/workspaces.js +43 -8
  190. package/docs/ARCHITECTURE.md +498 -58
  191. package/docs/COMPATIBILITY.md +2 -2
  192. package/docs/CONCEPT.md +185 -91
  193. package/docs/CROSS_PLATFORM.ru.md +20 -0
  194. package/docs/CROSS_PLATFORM.zh.md +18 -0
  195. package/docs/EXECUTION-LOOP.md +211 -0
  196. package/docs/FEATURES.md +65 -4
  197. package/docs/FEATURES.zh.md +52 -4
  198. package/docs/MIGRATION.md +2 -2
  199. package/docs/PIPELINE.md +293 -0
  200. package/docs/README.ru.md +44 -5
  201. package/docs/README.zh.md +46 -6
  202. package/docs/SAFETY.md +142 -0
  203. package/docs/SAVINGS.md +29 -0
  204. package/docs/SAVINGS.ru.md +29 -0
  205. package/docs/SAVINGS.zh.md +18 -0
  206. package/gui-experimental.cjs +9 -8
  207. package/locales/en.json +84 -1
  208. package/locales/ru.json +84 -1
  209. package/locales/zh.json +84 -1
  210. package/opencode.pipeline.yaml +35 -0
  211. package/package.json +46 -2
  212. package/scripts/audit-bundle.mjs +215 -0
  213. package/scripts/test-home.mjs +83 -0
  214. package/src/cli.ts +412 -0
  215. package/src/core/dlq-api.ts +98 -0
  216. package/src/core/dry-run.ts +27 -3
  217. package/src/core/execution.ts +538 -0
  218. package/src/core/file-watcher.ts +2 -2
  219. package/src/core/gate-integrity.ts +160 -0
  220. package/src/core/git-trigger.ts +18 -5
  221. package/src/core/guard-run.ts +119 -0
  222. package/src/core/guard.ts +431 -0
  223. package/src/core/lock.ts +244 -30
  224. package/src/core/matrix.ts +95 -50
  225. package/src/core/mission.ts +485 -0
  226. package/src/core/native-notify.ts +1 -1
  227. package/src/core/one-shot.ts +36 -8
  228. package/src/core/opencode-cli.ts +103 -0
  229. package/src/core/opencode-models.ts +315 -0
  230. package/src/core/pipeline-apply.ts +158 -0
  231. package/src/core/pipeline-io.ts +79 -0
  232. package/src/core/pipeline-map.ts +264 -0
  233. package/src/core/pipeline-spec.ts +775 -0
  234. package/src/core/ps-wrapper.ts +274 -64
  235. package/src/core/record-history.ts +229 -104
  236. package/src/core/router/dispatch.ts +94 -0
  237. package/src/core/router/escalation.ts +129 -0
  238. package/src/core/router/planner.ts +166 -0
  239. package/src/core/router/rules.ts +115 -0
  240. package/src/core/run-panel-api.ts +262 -0
  241. package/src/core/schedule-gate.ts +7 -3
  242. package/src/core/schedule-v2.ts +114 -5
  243. package/src/core/scheduler/at-fallback.ts +190 -5
  244. package/src/core/scheduler/linux.ts +72 -21
  245. package/src/core/scheduler/logs.ts +2 -2
  246. package/src/core/scheduler/mac.ts +174 -14
  247. package/src/core/scheduler/posix.ts +20 -1
  248. package/src/core/scheduler/registry.ts +107 -26
  249. package/src/core/scheduler/run-now.ts +32 -0
  250. package/src/core/scheduler/windows.ts +19 -15
  251. package/src/core/secrets.ts +131 -31
  252. package/src/core/session.ts +23 -10
  253. package/src/core/structured-log.ts +22 -5
  254. package/src/core/task-name.ts +67 -0
  255. package/src/core/telegram.ts +2 -2
  256. package/src/core/triage-worker.ts +7 -7
  257. package/src/core/triage.ts +2 -2
  258. package/src/core/worktree-run.ts +199 -0
  259. package/src/core/worktree.ts +600 -0
  260. package/src/core/wrappers/bash.ts +239 -27
  261. package/src/db/capability-repo.ts +402 -0
  262. package/src/db/history-repo.ts +151 -22
  263. package/src/db/index.ts +37 -1
  264. package/src/db/metrics-repo.ts +2 -2
  265. package/src/db/migrate.ts +3 -1
  266. package/src/db/recovery.ts +5 -4
  267. package/src/db/run-context.ts +370 -0
  268. package/src/db/run-dlq.ts +310 -0
  269. package/src/db/run-journal.ts +100 -13
  270. package/src/db/run-resume.ts +65 -13
  271. package/src/db/runs-repo.ts +66 -13
  272. package/src/db/schema.ts +218 -3
  273. package/src/db/settings-repo.ts +31 -0
  274. package/src/db/step-idempotency.ts +185 -0
  275. package/src/gui.tsx +692 -13
  276. package/src/history.ts +1 -1
  277. package/src/i18n.ts +12 -4
  278. package/src/index.ts +648 -8
  279. package/src/notifications.ts +38 -8
  280. package/src/profiles.ts +26 -4
  281. package/src/rpc.ts +379 -0
  282. package/src/server.ts +206 -54
  283. package/src/settings.ts +5 -5
  284. package/src/shared/jobs-view.ts +3 -1
  285. package/src/task-transfer.ts +31 -0
  286. package/src/types.ts +9 -0
  287. package/src/workspaces.ts +58 -9
@@ -0,0 +1,277 @@
1
+ /**
2
+ * Модели и цены — из самого OpenCode, а не из захардкоженного списка.
3
+ *
4
+ * Что берём и откуда:
5
+ * 1. Список доступных моделей — `opencode models`. Это ровно тот набор,
6
+ * который настроен у пользователя (провайдеры, ключи, локальные модели),
7
+ * а не «все модели мира».
8
+ * 2. Цены — кэш каталога models.dev, который OpenCode держит в
9
+ * `<cache>/opencode/models.json` (`cost.input` / `cost.output`, USD за 1M
10
+ * токенов). В истории токены не разделены на вход/выход, поэтому берём
11
+ * среднее из двух цен.
12
+ *
13
+ * Модуль никогда не бросает: если CLI или кэш недоступны, возвращаются
14
+ * значения по умолчанию, чтобы дашборд продолжал работать без OpenCode.
15
+ *
16
+ * Переключатели (переменные окружения):
17
+ * - OPENCODE_SCHEDULER_MODEL_SOURCE=static — не обращаться к OpenCode вообще
18
+ * (только встроенные значения; используется тестами);
19
+ * - OPENCODE_SCHEDULER_MODELS_CACHE=<путь> — свой файл каталога models.dev.
20
+ */
21
+ import fs from "node:fs";
22
+ import os from "node:os";
23
+ import path from "node:path";
24
+ import { execFileSync } from "node:child_process";
25
+ import { opencodeCommand } from "./opencode-cli.js";
26
+ /** Сколько what-if моделей показывать максимум. */
27
+ export const MAX_WHAT_IF_MODELS = 5;
28
+ /**
29
+ * Цены по умолчанию: используются только если модели нет ни в каталоге
30
+ * OpenCode, ни в OPENCODE_SCHEDULER_MODEL_PRICES.
31
+ */
32
+ export const DEFAULT_MODEL_PRICE_PER_MILLION = {
33
+ "openai/gpt-4o": 10,
34
+ "openai/gpt-4o-mini": 0.6,
35
+ "deepseek/deepseek-coder": 0.28,
36
+ "anthropic/claude-3-5-sonnet": 9,
37
+ "anthropic/claude-3-5-haiku": 1.2,
38
+ "google/gemini-2.5-pro": 3.5,
39
+ "google/gemini-2.0-flash": 0.3,
40
+ };
41
+ /** Средняя оценка цены, если модель вообще неизвестна. */
42
+ export const DEFAULT_PRICE_PER_MILLION = 3;
43
+ /** What-if модели, если OpenCode недоступен и истории ещё нет. */
44
+ export const DEFAULT_WHAT_IF_MODELS = [
45
+ "openai/gpt-4o",
46
+ "deepseek/deepseek-coder",
47
+ ];
48
+ /** Провайдеры локальных моделей: они не выставляют счёт. */
49
+ const LOCAL_PROVIDERS = new Set([
50
+ "ollama",
51
+ "lmstudio",
52
+ "llamacpp",
53
+ "llama.cpp",
54
+ "vllm",
55
+ "local",
56
+ ]);
57
+ const CATALOG_TTL_MS = 60000;
58
+ const CLI_TTL_MS = 10 * 60000;
59
+ const CLI_TIMEOUT_MS = 20000;
60
+ /** Приводит id модели к виду для сравнения (регистр и пробелы не важны). */
61
+ export function normalizeModelId(model) {
62
+ return (model ?? "").trim().toLowerCase();
63
+ }
64
+ /** Режим общения с OpenCode: "auto" (по умолчанию) или "static". */
65
+ export function modelSourceMode() {
66
+ const raw = (process.env.OPENCODE_SCHEDULER_MODEL_SOURCE ?? "").trim().toLowerCase();
67
+ return raw === "static" || raw === "off" ? "static" : "auto";
68
+ }
69
+ /** Разбирает каталог models.dev в карту `provider/model` → цены. */
70
+ export function parseModelsCatalog(raw) {
71
+ const result = new Map();
72
+ let parsed;
73
+ try {
74
+ parsed = JSON.parse(raw);
75
+ }
76
+ catch {
77
+ return result;
78
+ }
79
+ if (!parsed || typeof parsed !== "object")
80
+ return result;
81
+ for (const [providerId, provider] of Object.entries(parsed)) {
82
+ const models = provider?.models;
83
+ if (!models || typeof models !== "object")
84
+ continue;
85
+ for (const [modelId, model] of Object.entries(models)) {
86
+ const cost = model?.cost;
87
+ if (!cost || typeof cost !== "object")
88
+ continue;
89
+ const input = Number(cost.input);
90
+ const output = Number(cost.output);
91
+ if (!Number.isFinite(input) || !Number.isFinite(output))
92
+ continue;
93
+ result.set(normalizeModelId(`${providerId}/${modelId}`), { input, output });
94
+ }
95
+ }
96
+ return result;
97
+ }
98
+ /** Разбирает вывод `opencode models` (по одному id в строке). */
99
+ export function parseModelList(stdout) {
100
+ const seen = new Set();
101
+ const models = [];
102
+ for (const line of stdout.split(/\r?\n/)) {
103
+ const id = line.trim();
104
+ if (!id || /\s/.test(id) || !id.includes("/"))
105
+ continue;
106
+ const key = normalizeModelId(id);
107
+ if (seen.has(key))
108
+ continue;
109
+ seen.add(key);
110
+ models.push(id);
111
+ }
112
+ return models;
113
+ }
114
+ /** Средняя цена за 1M токенов: история не делит токены на вход и выход. */
115
+ export function blendedPrice(entry) {
116
+ return (entry.input + entry.output) / 2;
117
+ }
118
+ /** Путь к файлу каталога models.dev, если он есть на диске. */
119
+ export function findModelsCacheFile() {
120
+ const explicit = process.env.OPENCODE_SCHEDULER_MODELS_CACHE?.trim();
121
+ if (explicit)
122
+ return fs.existsSync(explicit) ? explicit : null;
123
+ const home = os.homedir();
124
+ const candidates = [
125
+ path.join(process.env.XDG_CACHE_HOME || path.join(home, ".cache"), "opencode", "models.json"),
126
+ process.env.LOCALAPPDATA ? path.join(process.env.LOCALAPPDATA, "opencode", "models.json") : "",
127
+ process.env.APPDATA ? path.join(process.env.APPDATA, "opencode", "models.json") : "",
128
+ ].filter(Boolean);
129
+ for (const candidate of candidates) {
130
+ if (fs.existsSync(candidate))
131
+ return candidate;
132
+ }
133
+ return null;
134
+ }
135
+ /** Локальная модель: счёт не выставляется, цена — ноль. */
136
+ function isLocalProvider(model) {
137
+ const provider = normalizeModelId(model).split("/")[0] ?? "";
138
+ return LOCAL_PROVIDERS.has(provider);
139
+ }
140
+ /** Бесплатная модель OpenCode (`...-free`): счёт не выставляется. */
141
+ function isKnownFreeModel(model) {
142
+ return /(?:^|\/)[^/]*-free$/i.test(normalizeModelId(model));
143
+ }
144
+ let catalogCache = null;
145
+ /**
146
+ * Каталог цен из кэша OpenCode. Файл читается заново только когда изменился
147
+ * (плюс не чаще раза в минуту), поэтому 6 МБ JSON не парсятся на каждый запрос.
148
+ */
149
+ export function getModelsCatalog() {
150
+ if (modelSourceMode() === "static")
151
+ return new Map();
152
+ const file = findModelsCacheFile();
153
+ if (!file)
154
+ return new Map();
155
+ const now = Date.now();
156
+ if (catalogCache?.file === file && now - catalogCache.checkedAt < CATALOG_TTL_MS) {
157
+ return catalogCache.data;
158
+ }
159
+ try {
160
+ const stat = fs.statSync(file);
161
+ if (catalogCache?.file === file && catalogCache.mtimeMs === stat.mtimeMs) {
162
+ catalogCache.checkedAt = now;
163
+ return catalogCache.data;
164
+ }
165
+ const data = parseModelsCatalog(fs.readFileSync(file, "utf8"));
166
+ catalogCache = { file, mtimeMs: stat.mtimeMs, checkedAt: now, data };
167
+ return data;
168
+ }
169
+ catch {
170
+ return catalogCache?.data ?? new Map();
171
+ }
172
+ }
173
+ /** Цена модели за 1M токенов по каталогу OpenCode (null — цены нет). */
174
+ export function catalogPricePerMillion(model) {
175
+ const key = normalizeModelId(model);
176
+ if (!key)
177
+ return null;
178
+ const entry = getModelsCatalog().get(key);
179
+ if (entry)
180
+ return blendedPrice(entry);
181
+ // Локальные провайдеры и бесплатные тарифы счёта не выставляют.
182
+ return isLocalProvider(key) || isKnownFreeModel(key) ? 0 : null;
183
+ }
184
+ let cliCache = null;
185
+ /** Запускает `opencode models` один раз (на Windows — через cmd.exe). */
186
+ function runModelsCli() {
187
+ try {
188
+ const command = opencodeCommand(["models"]);
189
+ const stdout = execFileSync(command.file, command.args, {
190
+ encoding: "utf8",
191
+ timeout: CLI_TIMEOUT_MS,
192
+ windowsHide: true,
193
+ stdio: ["ignore", "pipe", "ignore"],
194
+ });
195
+ return parseModelList(stdout);
196
+ }
197
+ catch {
198
+ return [];
199
+ }
200
+ }
201
+ /** Доступные пользователю модели (`opencode models`), кэш 10 минут. */
202
+ export function listAvailableModels() {
203
+ if (modelSourceMode() === "static")
204
+ return [];
205
+ const now = Date.now();
206
+ if (cliCache && now - cliCache.at < CLI_TTL_MS)
207
+ return cliCache.models;
208
+ const models = runModelsCli();
209
+ cliCache = { at: now, models };
210
+ return models;
211
+ }
212
+ /**
213
+ * Что показывать в What-If.
214
+ *
215
+ * Сначала модели, которые пользователь реально запускал (история), затем — по
216
+ * одной модели на каждую цену из доступных в OpenCode: дешёвая, средняя,
217
+ * дорогая. Так список обозрим и отвечает на вопрос «а сколько было бы на
218
+ * другой модели», а не перечисляет пять бесплатных подряд.
219
+ *
220
+ * `available` и `priceOf` вынесены параметрами, чтобы правило выбора
221
+ * проверялось тестом на фиксированных данных.
222
+ */
223
+ export function selectWhatIfModels(preferred, available, priceOf = catalogPricePerMillion) {
224
+ const picked = [];
225
+ const seen = new Set();
226
+ const push = (model) => {
227
+ const id = (model ?? "").trim();
228
+ const key = normalizeModelId(id);
229
+ if (!key || seen.has(key))
230
+ return;
231
+ seen.add(key);
232
+ picked.push(id);
233
+ };
234
+ const fromHistory = [];
235
+ for (const model of preferred) {
236
+ if (picked.length >= MAX_WHAT_IF_MODELS)
237
+ break;
238
+ const before = picked.length;
239
+ push(model);
240
+ if (picked.length > before)
241
+ fromHistory.push(picked[picked.length - 1]);
242
+ }
243
+ const candidates = available
244
+ .filter((model) => !seen.has(normalizeModelId(model)))
245
+ .map((model) => ({ model, price: priceOf(model) ?? DEFAULT_PRICE_PER_MILLION }))
246
+ .sort((a, b) => {
247
+ if (a.price !== b.price)
248
+ return a.price - b.price;
249
+ // При равной цене берём самое короткое имя: списку нужен один пример.
250
+ if (a.model.length !== b.model.length)
251
+ return a.model.length - b.model.length;
252
+ return a.model.localeCompare(b.model);
253
+ });
254
+ const prices = new Set();
255
+ for (const item of candidates) {
256
+ if (picked.length >= MAX_WHAT_IF_MODELS)
257
+ break;
258
+ if (prices.has(item.price))
259
+ continue;
260
+ prices.add(item.price);
261
+ push(item.model);
262
+ }
263
+ if (picked.length === 0) {
264
+ return { models: DEFAULT_WHAT_IF_MODELS.slice(), source: "default" };
265
+ }
266
+ const source = fromHistory.length > 0 ? "history" : "opencode";
267
+ return { models: picked, source };
268
+ }
269
+ /** What-If по реальным источникам: история + `opencode models` + каталог цен. */
270
+ export function resolveWhatIfModels(preferred = []) {
271
+ return selectWhatIfModels(preferred, listAvailableModels());
272
+ }
273
+ /** Сбрасывает кэши (нужно тестам). */
274
+ export function resetModelCaches() {
275
+ catalogCache = null;
276
+ cliCache = null;
277
+ }
@@ -0,0 +1,38 @@
1
+ import type { TaskDefinition } from "../task-transfer.js";
2
+ import type { PipelineSpec } from "./pipeline-spec.js";
3
+ export interface PipelineApplyPlan {
4
+ /** Задачи, которых ещё нет в БД. */
5
+ creates: TaskDefinition[];
6
+ /** Задачи с изменённым определением. */
7
+ updates: {
8
+ task: TaskDefinition;
9
+ previous: TaskDefinition;
10
+ }[];
11
+ /** Задачи, определение не изменилось. */
12
+ unchanged: TaskDefinition[];
13
+ /** Задачи этого pipeline, которых больше нет в YAML (не удаляются автоматически). */
14
+ stale: TaskDefinition[];
15
+ warnings: string[];
16
+ }
17
+ export interface PipelineApplyResult {
18
+ created: number;
19
+ updated: number;
20
+ unchanged: number;
21
+ stale: number;
22
+ }
23
+ export interface PipelineApplyHandlers {
24
+ create(task: TaskDefinition): Promise<void> | void;
25
+ update(task: TaskDefinition): Promise<void> | void;
26
+ }
27
+ /** Стабильная подпись значимых полей задачи — для сравнения create/update/unchanged. */
28
+ export declare function pipelineTaskSignature(task: TaskDefinition): string;
29
+ /**
30
+ * Чистый diff: сравнивает желаемые задачи pipeline с существующими.
31
+ * Задачи без маркеров pipelineName/pipelineStepId не трогаются никогда.
32
+ */
33
+ export declare function planPipelineApply(spec: PipelineSpec, existing: TaskDefinition[], options?: {
34
+ resolveWorkspaceId?: (value: string) => string | undefined;
35
+ }): PipelineApplyPlan;
36
+ /** Применяет план через переданные обработчики (БД/планировщик) и считает итог. */
37
+ export declare function executePipelineApply(plan: PipelineApplyPlan, handlers: PipelineApplyHandlers): Promise<PipelineApplyResult>;
38
+ //# sourceMappingURL=pipeline-apply.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pipeline-apply.d.ts","sourceRoot":"","sources":["../../src/core/pipeline-apply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,wCAAwC;IACxC,OAAO,EAAE;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,cAAc,CAAA;KAAE,EAAE,CAAC;IAC9D,yCAAyC;IACzC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,qFAAqF;IACrF,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACnD,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpD;AA6CD,wFAAwF;AACxF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAOlE;AASD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,GAAE;IAAE,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;CAAO,GAC3E,iBAAiB,CAsCnB;AAED,mFAAmF;AACnF,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAiB9B"}
@@ -0,0 +1,117 @@
1
+ import { pipelineSpecToTasks } from "./pipeline-map.js";
2
+ const SIGNATURE_FIELDS = [
3
+ "name",
4
+ "schedule",
5
+ "prompt",
6
+ "triggerType",
7
+ "dependsOn",
8
+ "model",
9
+ "priority",
10
+ "timeoutSeconds",
11
+ "workingDirectory",
12
+ "workspaceId",
13
+ "retryCount",
14
+ "retryDelay",
15
+ "qualityGate",
16
+ "beforeScript",
17
+ "afterScript",
18
+ "guards",
19
+ "allowedTools",
20
+ "deniedTools",
21
+ "matrix",
22
+ "timezone",
23
+ "notBefore",
24
+ "notAfter",
25
+ "activeDays",
26
+ "windowPolicy",
27
+ "runAt",
28
+ "pipelineName",
29
+ "pipelineStepId",
30
+ ];
31
+ function normalizeValue(value) {
32
+ if (Array.isArray(value))
33
+ return value.map(normalizeValue);
34
+ if (value && typeof value === "object") {
35
+ const source = value;
36
+ const result = {};
37
+ for (const key of Object.keys(source).sort()) {
38
+ if (source[key] !== undefined)
39
+ result[key] = normalizeValue(source[key]);
40
+ }
41
+ return result;
42
+ }
43
+ return value;
44
+ }
45
+ /** Стабильная подпись значимых полей задачи — для сравнения create/update/unchanged. */
46
+ export function pipelineTaskSignature(task) {
47
+ const picked = {};
48
+ const source = task;
49
+ for (const field of SIGNATURE_FIELDS) {
50
+ if (source[field] !== undefined)
51
+ picked[field] = normalizeValue(source[field]);
52
+ }
53
+ return JSON.stringify(picked);
54
+ }
55
+ function samePipeline(task, pipelineName) {
56
+ return (typeof task.pipelineName === "string" &&
57
+ task.pipelineName.toLowerCase() === pipelineName.toLowerCase());
58
+ }
59
+ /**
60
+ * Чистый diff: сравнивает желаемые задачи pipeline с существующими.
61
+ * Задачи без маркеров pipelineName/pipelineStepId не трогаются никогда.
62
+ */
63
+ export function planPipelineApply(spec, existing, options = {}) {
64
+ const mapped = pipelineSpecToTasks(spec, options);
65
+ const create = [];
66
+ const updates = [];
67
+ const unchanged = [];
68
+ const byStep = new Map();
69
+ for (const task of existing) {
70
+ if (!samePipeline(task, spec.name))
71
+ continue;
72
+ const stepId = task.pipelineStepId;
73
+ if (typeof stepId !== "string" || !stepId)
74
+ continue;
75
+ byStep.set(stepId.toLowerCase(), task);
76
+ }
77
+ for (const task of mapped.tasks) {
78
+ const previous = byStep.get((task.pipelineStepId ?? "").toLowerCase());
79
+ if (!previous) {
80
+ create.push(task);
81
+ continue;
82
+ }
83
+ if (pipelineTaskSignature(previous) === pipelineTaskSignature(task)) {
84
+ unchanged.push(task);
85
+ }
86
+ else {
87
+ updates.push({ task, previous });
88
+ }
89
+ byStep.delete((task.pipelineStepId ?? "").toLowerCase());
90
+ }
91
+ const stale = [...byStep.values()];
92
+ const warnings = [...mapped.warnings];
93
+ if (stale.length > 0) {
94
+ warnings.push(`В YAML больше нет шагов: ${stale.map((task) => task.name).join(", ")}. ` +
95
+ "Они не удалены автоматически — удалите вручную или верните шаг.");
96
+ }
97
+ return { creates: create, updates, unchanged, stale, warnings };
98
+ }
99
+ /** Применяет план через переданные обработчики (БД/планировщик) и считает итог. */
100
+ export async function executePipelineApply(plan, handlers) {
101
+ let created = 0;
102
+ for (const task of plan.creates) {
103
+ await handlers.create(task);
104
+ created += 1;
105
+ }
106
+ let updated = 0;
107
+ for (const entry of plan.updates) {
108
+ await handlers.update(entry.task);
109
+ updated += 1;
110
+ }
111
+ return {
112
+ created,
113
+ updated,
114
+ unchanged: plan.unchanged.length,
115
+ stale: plan.stale.length,
116
+ };
117
+ }
@@ -0,0 +1,13 @@
1
+ import { type PipelineSpec, type PipelineValidationResult } from "./pipeline-spec.js";
2
+ /** Результат разбора YAML: спека возвращается только при успешной валидации. */
3
+ export interface PipelineParseResult extends PipelineValidationResult {
4
+ spec?: PipelineSpec;
5
+ }
6
+ /**
7
+ * Разбирает YAML-текст в `PipelineSpec` и сразу валидирует его.
8
+ * Функция не бросает: синтаксические и смысловые ошибки возвращаются в `errors`.
9
+ */
10
+ export declare function parsePipelineYaml(source: string): PipelineParseResult;
11
+ /** Читает YAML-файл и валидирует его. Ошибки ввода-вывода также попадают в `errors`. */
12
+ export declare function loadPipelineFile(filePath: string): Promise<PipelineParseResult>;
13
+ //# sourceMappingURL=pipeline-io.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pipeline-io.d.ts","sourceRoot":"","sources":["../../src/core/pipeline-io.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,wBAAwB,EAC9B,MAAM,oBAAoB,CAAC;AAE5B,gFAAgF;AAChF,MAAM,WAAW,mBAAoB,SAAQ,wBAAwB;IACnE,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AASD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAsCrE;AAED,wFAAwF;AACxF,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAYrF"}
@@ -0,0 +1,64 @@
1
+ import { readFile } from "node:fs/promises";
2
+ import { parseDocument } from "yaml";
3
+ import { validatePipelineSpec, } from "./pipeline-spec.js";
4
+ const MAX_YAML_BYTES = 1024 * 1024;
5
+ const MAX_ALIAS_COUNT = 100;
6
+ function issueMessage(err) {
7
+ return err instanceof Error ? err.message : String(err);
8
+ }
9
+ /**
10
+ * Разбирает YAML-текст в `PipelineSpec` и сразу валидирует его.
11
+ * Функция не бросает: синтаксические и смысловые ошибки возвращаются в `errors`.
12
+ */
13
+ export function parsePipelineYaml(source) {
14
+ const errors = [];
15
+ const warnings = [];
16
+ if (source.length > MAX_YAML_BYTES) {
17
+ return {
18
+ ok: false,
19
+ errors: [{ path: "$", message: `YAML больше ${MAX_YAML_BYTES} байт` }],
20
+ warnings,
21
+ };
22
+ }
23
+ let data;
24
+ try {
25
+ const doc = parseDocument(source, {
26
+ prettyErrors: true,
27
+ uniqueKeys: true,
28
+ strict: true,
29
+ });
30
+ if (doc.errors.length > 0) {
31
+ for (const err of doc.errors) {
32
+ errors.push({ path: "$", message: err.message });
33
+ }
34
+ return { ok: false, errors, warnings };
35
+ }
36
+ data = doc.toJS({ maxAliasCount: MAX_ALIAS_COUNT });
37
+ }
38
+ catch (err) {
39
+ return {
40
+ ok: false,
41
+ errors: [{ path: "$", message: issueMessage(err) }],
42
+ warnings,
43
+ };
44
+ }
45
+ const result = validatePipelineSpec(data);
46
+ if (!result.ok)
47
+ return result;
48
+ return { ...result, spec: data };
49
+ }
50
+ /** Читает YAML-файл и валидирует его. Ошибки ввода-вывода также попадают в `errors`. */
51
+ export async function loadPipelineFile(filePath) {
52
+ let source;
53
+ try {
54
+ source = await readFile(filePath, "utf8");
55
+ }
56
+ catch (err) {
57
+ return {
58
+ ok: false,
59
+ errors: [{ path: filePath, message: `Не удалось прочитать файл: ${issueMessage(err)}` }],
60
+ warnings: [],
61
+ };
62
+ }
63
+ return parsePipelineYaml(source);
64
+ }
@@ -0,0 +1,46 @@
1
+ /**
2
+ * Спринт 32 (Pipeline-as-code, 0.0.5): маппинг `PipelineSpec` → `TaskDefinition[]`.
3
+ *
4
+ * Модуль чистый: не читает БД и не трогает планировщик. Всё, что требует
5
+ * состояния (разрешение имён workspace в id), передаётся через опции.
6
+ * Маркеры `pipelineName` / `pipelineStepId` сохраняются в definition_json,
7
+ * чтобы идемпотентный apply мог отличать шаги pipeline от «чужих» задач.
8
+ */
9
+ import type { TaskDefinition } from "../task-transfer.js";
10
+ import { type PipelineSpec } from "./pipeline-spec.js";
11
+ export interface PipelineMapOptions {
12
+ /**
13
+ * Разрешение имени workspace в id. Если не задано, значения
14
+ * `matrix.workspaces` считаются уже id. Apply передаёт резолвер из БД.
15
+ */
16
+ resolveWorkspaceId?: (nameOrId: string) => string | undefined;
17
+ }
18
+ export interface PipelineTaskMapping {
19
+ tasks: TaskDefinition[];
20
+ warnings: string[];
21
+ }
22
+ /**
23
+ * Преобразует провалидированный pipeline в определения задач.
24
+ *
25
+ * Правила:
26
+ * - `trigger: dag` → задача без собственного триггера (`triggerType: "file"`),
27
+ * как матричные родители: её запускает только DAG-движок по `dependsOn`;
28
+ * - `needs` → `dependsOn` с именами задач (`<pipeline> <step>`);
29
+ * - `defaults` наследуются шагом;
30
+ * - матрица `workspaces` переносится в `matrix.workspaceIds`.
31
+ */
32
+ export declare function pipelineSpecToTasks(spec: PipelineSpec, options?: PipelineMapOptions): PipelineTaskMapping;
33
+ export interface PipelineExportResult {
34
+ spec: PipelineSpec;
35
+ warnings: string[];
36
+ }
37
+ /**
38
+ * Обратный маппинг: задачи одного pipeline из БД → `PipelineSpec` для export.
39
+ *
40
+ * Восстанавливает `needs` по `dependsOn`, `matrix.workspaces` по
41
+ * `matrix.workspaceIds`, trigger по `triggerType`. Шаг `dag` неотличим от
42
+ * ручного `file`-шага с зависимостями, поэтому восстанавливается эвристикой:
43
+ * `file`, без cron и watchPath, но с `dependsOn` → `dag`.
44
+ */
45
+ export declare function tasksToPipelineSpec(tasks: TaskDefinition[], pipelineName: string): PipelineExportResult;
46
+ //# sourceMappingURL=pipeline-map.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pipeline-map.d.ts","sourceRoot":"","sources":["../../src/core/pipeline-map.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAIL,KAAK,YAAY,EAIlB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC/D;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE,kBAAuB,GAC/B,mBAAmB,CA2ErB;AA4BD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EAAE,EACvB,YAAY,EAAE,MAAM,GACnB,oBAAoB,CAsFtB"}