agent-steward 0.0.2 → 0.0.4

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 (263) hide show
  1. package/CHANGELOG.md +45 -2
  2. package/CROSS_PLATFORM.md +11 -9
  3. package/README.md +11 -10
  4. package/ROADMAP-STRATEGY.md +93 -44
  5. package/ROADMAP.md +148 -1017
  6. package/dist/core/cron-to-schtasks.d.ts +0 -8
  7. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  8. package/dist/core/cron-to-schtasks.js +11 -86
  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 +19 -2
  14. package/dist/core/file-watcher.js +9 -9
  15. package/dist/core/git-trigger.js +4 -4
  16. package/dist/core/lock.d.ts +20 -4
  17. package/dist/core/lock.d.ts.map +1 -1
  18. package/dist/core/lock.js +99 -26
  19. package/dist/core/one-shot.d.ts +31 -5
  20. package/dist/core/one-shot.d.ts.map +1 -1
  21. package/dist/core/one-shot.js +78 -10
  22. package/dist/core/opencode-cli.d.ts +28 -0
  23. package/dist/core/opencode-cli.d.ts.map +1 -0
  24. package/dist/core/opencode-cli.js +74 -0
  25. package/dist/core/opencode-models.d.ts +62 -0
  26. package/dist/core/opencode-models.d.ts.map +1 -0
  27. package/dist/core/opencode-models.js +277 -0
  28. package/dist/core/otel.js +2 -2
  29. package/dist/core/ps-wrapper.d.ts +1 -1
  30. package/dist/core/ps-wrapper.d.ts.map +1 -1
  31. package/dist/core/ps-wrapper.js +66 -36
  32. package/dist/core/record-history.d.ts +15 -0
  33. package/dist/core/record-history.d.ts.map +1 -1
  34. package/dist/core/record-history.js +78 -54
  35. package/dist/core/router/dispatch.d.ts +36 -0
  36. package/dist/core/router/dispatch.d.ts.map +1 -0
  37. package/dist/core/router/dispatch.js +59 -0
  38. package/dist/core/router/escalation.d.ts +47 -0
  39. package/dist/core/router/escalation.d.ts.map +1 -0
  40. package/dist/core/router/escalation.js +87 -0
  41. package/dist/core/router/planner.d.ts +53 -0
  42. package/dist/core/router/planner.d.ts.map +1 -0
  43. package/dist/core/router/planner.js +113 -0
  44. package/dist/core/router/rules.d.ts +46 -0
  45. package/dist/core/router/rules.d.ts.map +1 -0
  46. package/dist/core/router/rules.js +85 -0
  47. package/dist/core/run-panel-api.d.ts +94 -0
  48. package/dist/core/run-panel-api.d.ts.map +1 -0
  49. package/dist/core/run-panel-api.js +169 -0
  50. package/dist/core/schedule-gate.js +5 -1
  51. package/dist/core/schedule-v2.d.ts +36 -2
  52. package/dist/core/schedule-v2.d.ts.map +1 -1
  53. package/dist/core/schedule-v2.js +98 -12
  54. package/dist/core/scheduler/at-fallback.d.ts +95 -0
  55. package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
  56. package/dist/core/scheduler/at-fallback.js +200 -0
  57. package/dist/core/scheduler/linux.d.ts +13 -2
  58. package/dist/core/scheduler/linux.d.ts.map +1 -1
  59. package/dist/core/scheduler/linux.js +67 -13
  60. package/dist/core/scheduler/mac.d.ts +14 -8
  61. package/dist/core/scheduler/mac.d.ts.map +1 -1
  62. package/dist/core/scheduler/mac.js +71 -22
  63. package/dist/core/scheduler/posix.d.ts.map +1 -1
  64. package/dist/core/scheduler/posix.js +37 -2
  65. package/dist/core/scheduler/registry.d.ts +13 -0
  66. package/dist/core/scheduler/registry.d.ts.map +1 -1
  67. package/dist/core/scheduler/registry.js +83 -21
  68. package/dist/core/scheduler/run-now.d.ts +16 -0
  69. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  70. package/dist/core/scheduler/run-now.js +28 -0
  71. package/dist/core/scheduler/windows.d.ts +16 -3
  72. package/dist/core/scheduler/windows.d.ts.map +1 -1
  73. package/dist/core/scheduler/windows.js +249 -96
  74. package/dist/core/secrets.d.ts.map +1 -1
  75. package/dist/core/secrets.js +127 -30
  76. package/dist/core/self-analysis.js +55 -55
  77. package/dist/core/session.d.ts.map +1 -1
  78. package/dist/core/session.js +18 -11
  79. package/dist/core/summary.js +1 -1
  80. package/dist/core/task-name.d.ts +24 -0
  81. package/dist/core/task-name.d.ts.map +1 -0
  82. package/dist/core/task-name.js +40 -0
  83. package/dist/core/triage-chain.js +1 -1
  84. package/dist/core/triage-worker.js +2 -2
  85. package/dist/core/triage.js +1 -1
  86. package/dist/core/wrappers/bash.d.ts.map +1 -1
  87. package/dist/core/wrappers/bash.js +82 -37
  88. package/dist/db/capability-repo.d.ts +83 -0
  89. package/dist/db/capability-repo.d.ts.map +1 -0
  90. package/dist/db/capability-repo.js +182 -0
  91. package/dist/db/history-repo.d.ts +8 -0
  92. package/dist/db/history-repo.d.ts.map +1 -1
  93. package/dist/db/history-repo.js +19 -0
  94. package/dist/db/index.d.ts +6 -0
  95. package/dist/db/index.d.ts.map +1 -1
  96. package/dist/db/index.js +48 -2
  97. package/dist/db/migrate.d.ts.map +1 -1
  98. package/dist/db/migrate.js +3 -1
  99. package/dist/db/run-context.d.ts +103 -0
  100. package/dist/db/run-context.d.ts.map +1 -0
  101. package/dist/db/run-context.js +224 -0
  102. package/dist/db/run-dlq.d.ts +100 -0
  103. package/dist/db/run-dlq.d.ts.map +1 -0
  104. package/dist/db/run-dlq.js +191 -0
  105. package/dist/db/run-journal.d.ts +60 -0
  106. package/dist/db/run-journal.d.ts.map +1 -0
  107. package/dist/db/run-journal.js +143 -0
  108. package/dist/db/run-resume.d.ts +51 -0
  109. package/dist/db/run-resume.d.ts.map +1 -0
  110. package/dist/db/run-resume.js +156 -0
  111. package/dist/db/runs-repo.d.ts +128 -0
  112. package/dist/db/runs-repo.d.ts.map +1 -0
  113. package/dist/db/runs-repo.js +342 -0
  114. package/dist/db/schema.d.ts +16 -2
  115. package/dist/db/schema.d.ts.map +1 -1
  116. package/dist/db/schema.js +342 -35
  117. package/dist/db/settings-repo.d.ts +11 -0
  118. package/dist/db/settings-repo.d.ts.map +1 -1
  119. package/dist/db/settings-repo.js +25 -0
  120. package/dist/db/step-idempotency.d.ts +51 -0
  121. package/dist/db/step-idempotency.d.ts.map +1 -0
  122. package/dist/db/step-idempotency.js +136 -0
  123. package/dist/index.d.ts +5 -5
  124. package/dist/index.d.ts.map +1 -1
  125. package/dist/index.js +168 -40
  126. package/dist/notifications.js +18 -18
  127. package/dist/profiles.d.ts +7 -3
  128. package/dist/profiles.d.ts.map +1 -1
  129. package/dist/profiles.js +85 -7
  130. package/dist/rpc.d.ts +787 -0
  131. package/dist/rpc.d.ts.map +1 -1
  132. package/dist/rpc.js +324 -0
  133. package/dist/server.d.ts +33 -2
  134. package/dist/server.d.ts.map +1 -1
  135. package/dist/server.js +115 -54
  136. package/dist/shared/jobs-view.d.ts.map +1 -1
  137. package/dist/skill.js +1 -1
  138. package/dist/task-transfer.d.ts +1 -1
  139. package/dist/task-transfer.d.ts.map +1 -1
  140. package/dist/task-transfer.js +14 -10
  141. package/dist/types.d.ts +20 -4
  142. package/dist/types.d.ts.map +1 -1
  143. package/dist/types.js +44 -9
  144. package/dist/workspaces.d.ts +25 -3
  145. package/dist/workspaces.d.ts.map +1 -1
  146. package/dist/workspaces.js +44 -9
  147. package/docs/ARCHITECTURE.md +335 -9
  148. package/docs/COMPATIBILITY.md +10 -6
  149. package/docs/CONCEPT.md +183 -91
  150. package/docs/CROSS_PLATFORM.ru.md +11 -9
  151. package/docs/CROSS_PLATFORM.zh.md +11 -9
  152. package/docs/EXECUTION-LOOP.md +196 -0
  153. package/docs/FAQ.md +2 -2
  154. package/docs/FAQ.ru.md +2 -2
  155. package/docs/FAQ.zh.md +2 -2
  156. package/docs/FEATURES.md +5 -4
  157. package/docs/FEATURES.zh.md +5 -4
  158. package/docs/MIGRATION.md +34 -26
  159. package/docs/README.ru.md +27 -8
  160. package/docs/README.zh.md +11 -10
  161. package/docs/SAFETY.md +122 -0
  162. package/docs/SAVINGS.md +29 -0
  163. package/docs/SAVINGS.ru.md +29 -0
  164. package/docs/SAVINGS.zh.md +18 -0
  165. package/docs/V1-V2-COMPATIBILITY-PLAN.md +6 -6
  166. package/gui-experimental.cjs +8 -8
  167. package/index.js +1 -0
  168. package/locales/en.json +68 -0
  169. package/locales/ru.json +68 -0
  170. package/locales/zh.json +68 -0
  171. package/package.json +57 -11
  172. package/scripts/audit-bundle.mjs +215 -0
  173. package/src/core/analytics.ts +2 -2
  174. package/src/core/audit.ts +17 -17
  175. package/src/core/cron-to-schtasks.ts +14 -93
  176. package/src/core/dlq-api.ts +98 -0
  177. package/src/core/dry-run.ts +51 -27
  178. package/src/core/file-watcher.ts +17 -17
  179. package/src/core/git-trigger.ts +9 -9
  180. package/src/core/glob.ts +1 -1
  181. package/src/core/local-ai.ts +2 -2
  182. package/src/core/lock.ts +104 -31
  183. package/src/core/matrix.ts +31 -31
  184. package/src/core/native-notify.ts +2 -2
  185. package/src/core/one-shot.ts +91 -13
  186. package/src/core/opencode-cli.ts +103 -0
  187. package/src/core/opencode-models.ts +315 -0
  188. package/src/core/otel.ts +4 -4
  189. package/src/core/permissions.ts +5 -5
  190. package/src/core/prometheus.ts +17 -17
  191. package/src/core/ps-wrapper.ts +68 -38
  192. package/src/core/record-history.ts +114 -76
  193. package/src/core/retention.ts +3 -3
  194. package/src/core/router/dispatch.ts +94 -0
  195. package/src/core/router/escalation.ts +129 -0
  196. package/src/core/router/planner.ts +166 -0
  197. package/src/core/router/rules.ts +109 -0
  198. package/src/core/run-panel-api.ts +262 -0
  199. package/src/core/savings.ts +1 -1
  200. package/src/core/schedule-gate.ts +17 -13
  201. package/src/core/schedule-v2.ts +138 -29
  202. package/src/core/scheduler/at-fallback.ts +298 -0
  203. package/src/core/scheduler/index.ts +3 -3
  204. package/src/core/scheduler/linux.ts +92 -19
  205. package/src/core/scheduler/logs.ts +1 -1
  206. package/src/core/scheduler/mac.ts +112 -60
  207. package/src/core/scheduler/posix.ts +35 -2
  208. package/src/core/scheduler/registry.ts +109 -26
  209. package/src/core/scheduler/run-now.ts +32 -0
  210. package/src/core/scheduler/windows.ts +295 -125
  211. package/src/core/secrets.ts +139 -39
  212. package/src/core/self-analysis.ts +61 -61
  213. package/src/core/session.ts +26 -13
  214. package/src/core/structured-log.ts +3 -3
  215. package/src/core/summary.ts +25 -25
  216. package/src/core/task-name.ts +67 -0
  217. package/src/core/telegram.ts +16 -16
  218. package/src/core/triage-chain.ts +4 -4
  219. package/src/core/triage-compare.ts +8 -8
  220. package/src/core/triage-rules.ts +4 -4
  221. package/src/core/triage-shadow.ts +7 -7
  222. package/src/core/triage-worker.ts +6 -6
  223. package/src/core/triage.ts +23 -23
  224. package/src/core/watch-paths.ts +1 -1
  225. package/src/core/wrappers/bash.ts +90 -45
  226. package/src/db/capability-repo.ts +285 -0
  227. package/src/db/git-state-repo.ts +1 -1
  228. package/src/db/history-repo.ts +44 -22
  229. package/src/db/index.ts +53 -7
  230. package/src/db/metrics-repo.ts +10 -10
  231. package/src/db/migrate.ts +13 -11
  232. package/src/db/recovery.ts +3 -3
  233. package/src/db/run-context.ts +370 -0
  234. package/src/db/run-dlq.ts +310 -0
  235. package/src/db/run-journal.ts +212 -0
  236. package/src/db/run-resume.ts +256 -0
  237. package/src/db/runs-repo.ts +504 -0
  238. package/src/db/schema.ts +357 -44
  239. package/src/db/settings-repo.ts +33 -2
  240. package/src/db/step-idempotency.ts +185 -0
  241. package/src/db/tasks-repo.ts +10 -10
  242. package/src/db/templates-repo.ts +7 -7
  243. package/src/gui.tsx +516 -1
  244. package/src/history.ts +4 -4
  245. package/src/i18n.ts +7 -7
  246. package/src/index.ts +465 -308
  247. package/src/integrations.ts +6 -6
  248. package/src/notifications.ts +76 -76
  249. package/src/profiles.ts +98 -7
  250. package/src/rpc.ts +347 -1
  251. package/src/schtasks.ts +2 -2
  252. package/src/server.ts +155 -78
  253. package/src/settings.ts +44 -44
  254. package/src/shared/jobs-view.ts +60 -60
  255. package/src/skill.ts +1 -1
  256. package/src/task-transfer.ts +58 -56
  257. package/src/templates.ts +1 -1
  258. package/src/types.ts +54 -10
  259. package/src/workspaces.ts +73 -24
  260. package/dist/core/self-analysis.test.d.ts +0 -2
  261. package/dist/core/self-analysis.test.d.ts.map +0 -1
  262. package/dist/core/self-analysis.test.js +0 -219
  263. package/dist/gui-experimental.cjs +0 -1
package/dist/core/lock.js CHANGED
@@ -1,6 +1,36 @@
1
1
  import fs from "node:fs/promises";
2
2
  import path from "node:path";
3
+ import { randomUUID } from "node:crypto";
3
4
  import { LOCK_DIR, STALE_LOCK_MAX_AGE_MS } from "../types.js";
5
+ /**
6
+ * Проверяет, жив ли процесс-владелец lock-файла.
7
+ *
8
+ * `process.kill(pid, 0)` не посылает сигнал, а только проверяет существование.
9
+ * EPERM означает, что процесс есть, но у нас нет прав на сигнал — считаем живым.
10
+ * Остальные ошибки трактуем консервативно как «жив», чтобы не вытеснить
11
+ * чужую критическую секцию.
12
+ */
13
+ export function isProcessAlive(pid) {
14
+ if (!Number.isInteger(pid) || pid <= 0)
15
+ return false;
16
+ try {
17
+ process.kill(pid, 0);
18
+ return true;
19
+ }
20
+ catch (err) {
21
+ if (err?.code === "ESRCH")
22
+ return false;
23
+ return true;
24
+ }
25
+ }
26
+ /** PID владельца из токена lock-файла (`<pid>-<timestamp>-<uuid>`). */
27
+ function ownerPidFromToken(content) {
28
+ const match = /^(\d+)-/.exec(content.trim());
29
+ if (!match)
30
+ return null;
31
+ const pid = Number.parseInt(match[1], 10);
32
+ return Number.isInteger(pid) ? pid : null;
33
+ }
4
34
  /**
5
35
  * Менеджер файловых блокировок для предотвращения наложения запусков одной задачи.
6
36
  *
@@ -52,6 +82,17 @@ export class LockManager {
52
82
  const stat = await fs.stat(fullPath);
53
83
  const age = now - stat.mtimeMs;
54
84
  if (age > STALE_LOCK_MAX_AGE_MS) {
85
+ // P2-18: возраст — только повод проверить владельца. Задача может
86
+ // легально работать дольше 24 ч (timeoutSeconds: 0), поэтому живой
87
+ // процесс не вытесняем: иначе после рестарта плагина появится дубль.
88
+ if (isLockFile) {
89
+ const content = await fs.readFile(fullPath, "utf8").catch(() => "");
90
+ const ownerPid = ownerPidFromToken(content);
91
+ if (ownerPid !== null && isProcessAlive(ownerPid)) {
92
+ console.log(`[agent-steward] Lock ${file} старше ${Math.round(age / 1000)} с, но процесс ${ownerPid} жив — оставляем.`);
93
+ continue;
94
+ }
95
+ }
55
96
  // T-03: не удаляем lock напрямую. Два воркера могли одновременно
56
97
  // снести один и тот же файл, после чего один из них удалял свежий
57
98
  // lock, созданный другим, и задача запускалась повторно. Атомарный
@@ -65,8 +106,7 @@ export class LockManager {
65
106
  continue;
66
107
  }
67
108
  await fs.rm(stalePath, { recursive: true, force: true }).catch(() => { });
68
- // eslint-disable-next-line no-console
69
- console.log(`[windows-scheduler] Вытеснен зависший lock: ${file} (возраст ${Math.round(age / 1000)} с)`);
109
+ console.log(`[agent-steward] Вытеснен зависший lock: ${file} (возраст ${Math.round(age / 1000)} с)`);
70
110
  }
71
111
  }
72
112
  catch {
@@ -76,36 +116,57 @@ export class LockManager {
76
116
  }
77
117
  /**
78
118
  * Пытается захватить блокировку для задачи.
79
- * Возвращает true, если блокировка захвачена (файл создан).
80
- * Возвращает false, если блокировка уже удерживается другим запуском.
119
+ * Возвращает уникальный токен владельца (он же содержимое lock-файла) или
120
+ * null, если блокировка уже удерживается другим запуском.
121
+ *
122
+ * Токен нужен release(): процесс, чей lock был вытеснен по stale-таймауту,
123
+ * не должен удалять файл нового владельца.
81
124
  */
82
125
  async acquire(taskName) {
83
126
  await fs.mkdir(this.lockDir, { recursive: true });
84
127
  const lockPath = this.lockFilePath(taskName);
128
+ const token = `${process.pid}-${Date.now()}-${randomUUID()}`;
85
129
  try {
86
130
  // 'wx' — exclusive create: ошибка если файл уже существует.
87
- await fs.writeFile(lockPath, String(Date.now()), { flag: "wx" });
88
- return true;
131
+ await fs.writeFile(lockPath, token, { flag: "wx" });
132
+ return token;
89
133
  }
90
134
  catch (err) {
91
135
  if (err.code === "EEXIST") {
92
- return false;
136
+ return null;
93
137
  }
94
138
  throw err;
95
139
  }
96
140
  }
97
141
  /**
98
142
  * Освобождает блокировку задачи (удаляет lock-файл).
143
+ *
144
+ * Удаляет файл только если в нём лежит токен этого владельца. Если lock
145
+ * успели вытеснить и перехватить, release ничего не трогает и возвращает
146
+ * false — иначе старый процесс снёс бы чужую критическую секцию.
99
147
  * Не выбрасывает ошибку, если файл уже удалён.
100
148
  */
101
- async release(taskName) {
149
+ async release(taskName, token) {
102
150
  const lockPath = this.lockFilePath(taskName);
151
+ let current;
152
+ try {
153
+ current = await fs.readFile(lockPath, "utf8");
154
+ }
155
+ catch (err) {
156
+ if (err.code === "ENOENT")
157
+ return false;
158
+ throw err;
159
+ }
160
+ if (current !== token)
161
+ return false;
103
162
  try {
104
163
  await fs.unlink(lockPath);
164
+ return true;
105
165
  }
106
166
  catch (err) {
107
- if (err.code !== "ENOENT")
108
- throw err;
167
+ if (err.code === "ENOENT")
168
+ return false;
169
+ throw err;
109
170
  }
110
171
  }
111
172
  /**
@@ -130,17 +191,16 @@ export class LockManager {
130
191
  * Гарантирует освобождение блокировки в finally (включая при ошибках).
131
192
  */
132
193
  export async function withLock(lockManager, taskName, fn) {
133
- const acquired = await lockManager.acquire(taskName);
134
- if (!acquired) {
135
- // eslint-disable-next-line no-console
136
- console.log(`[windows-scheduler] Запуск задачи "${taskName}" пропущен: удерживается активная блокировка.`);
194
+ const token = await lockManager.acquire(taskName);
195
+ if (!token) {
196
+ console.log(`[agent-steward] Запуск задачи "${taskName}" пропущен: удерживается активная блокировка.`);
137
197
  return null;
138
198
  }
139
199
  try {
140
200
  return await fn();
141
201
  }
142
202
  finally {
143
- await lockManager.release(taskName);
203
+ await lockManager.release(taskName, token);
144
204
  }
145
205
  }
146
206
  /**
@@ -156,25 +216,37 @@ export async function withLockWait(lockManager, taskName, fn, options = {}) {
156
216
  const staleMs = options.staleMs ?? 60000;
157
217
  const deadline = Date.now() + timeoutMs;
158
218
  const lockPath = lockManager.pathFor(taskName);
219
+ let token = null;
159
220
  for (;;) {
160
- if (await lockManager.acquire(taskName))
221
+ token = await lockManager.acquire(taskName);
222
+ if (token)
161
223
  break;
162
224
  // Осиротевший lock: короткая операция не может длиться дольше staleMs.
163
225
  if (staleMs > 0) {
164
226
  try {
165
227
  const stat = await fs.stat(lockPath);
166
228
  if (Date.now() - stat.mtimeMs > staleMs) {
167
- // T-03-совместимое вытеснение: атомарный rename выигрывает ровно
168
- // один процесс, остальные получают ENOENT и повторяют попытку.
169
- const stalePath = `${lockPath}.stale-${process.pid}-${Date.now()}`;
170
- try {
171
- await fs.rename(lockPath, stalePath);
172
- await fs.rm(stalePath, { force: true }).catch(() => { });
229
+ // P2-18: staleMs — не приговор. Если владелец ещё жив, его
230
+ // критическая секция может быть легально долгой (crontab RMW,
231
+ // длинная задача). Вытесняем только мёртвый/неизвестный lock.
232
+ const content = await fs.readFile(lockPath, "utf8").catch(() => "");
233
+ const ownerPid = ownerPidFromToken(content);
234
+ if (ownerPid !== null && isProcessAlive(ownerPid)) {
235
+ // Ждём дальше; по deadline вернём понятную ошибку.
173
236
  }
174
- catch {
175
- // Кто-то успел раньше — просто повторяем acquire.
237
+ else {
238
+ // T-03-совместимое вытеснение: атомарный rename выигрывает ровно
239
+ // один процесс, остальные получают ENOENT и повторяют попытку.
240
+ const stalePath = `${lockPath}.stale-${process.pid}-${Date.now()}`;
241
+ try {
242
+ await fs.rename(lockPath, stalePath);
243
+ await fs.rm(stalePath, { force: true }).catch(() => { });
244
+ }
245
+ catch {
246
+ // Кто-то успел раньше — просто повторяем acquire.
247
+ }
248
+ continue;
176
249
  }
177
- continue;
178
250
  }
179
251
  }
180
252
  catch {
@@ -190,6 +262,7 @@ export async function withLockWait(lockManager, taskName, fn, options = {}) {
190
262
  return await fn();
191
263
  }
192
264
  finally {
193
- await lockManager.release(taskName);
265
+ if (token)
266
+ await lockManager.release(taskName, token);
194
267
  }
195
268
  }
@@ -40,16 +40,42 @@ export declare function normalizeOneShotRunAt(input: OneShotInput, nowMs?: numbe
40
40
  /**
41
41
  * Формат даты/времени для schtasks /sd и /st.
42
42
  *
43
- * Windows Task Scheduler ожидает дату в формате текущей локали. Плагин уже
44
- * использует DD.MM.YYYY для ONCE-заглушки, поэтому сохраняем этот формат
45
- * для совместимости с русской локалью (основной сценарий проекта).
43
+ * Windows Task Scheduler ожидает дату в формате текущей локали. На русской
44
+ * Windows — DD.MM.YYYY, на английской — M/d/yyyy и т.д. Жёсткий DD.MM.YYYY
45
+ * ломает создание one-shot и file/git/mcp-задач на не-RU Windows (P1-8).
46
+ * Вызывающий код (windows.ts) передаёт `dateFormat`, полученный из системной
47
+ * локали через PowerShell `(Get-Culture).DateTimeFormat.ShortDatePattern`.
48
+ *
49
+ * @param runAt — ISO-8601 время запуска.
50
+ * @param dateFormat — шаблон даты локали (например, "dd.MM.yyyy" или "M/d/yyyy").
51
+ * Если не задан — используется DD.MM.YYYY (по умолчанию RU).
52
+ */
53
+ export declare function buildWindowsOneShotFlags(runAt: string, dateFormat?: string): ["/sc", "ONCE", "/sd", string, "/st", string];
54
+ /**
55
+ * Форматирует Date по шаблону локали Windows (.NET-формат, как возвращает
56
+ * (Get-Culture).DateTimeFormat.ShortDatePattern). Поддерживает d/dd, M/MM,
57
+ * MMM/MMMM (название месяца), y/yy/yyyy. Неизвестные символы копируются как есть.
58
+ *
59
+ * P2-26: раньше последовательные replace(/MM/) и replace(/M/) превращали
60
+ * «MMM» в число месяца («2030. 011 2.»). Теперь разбор идёт одним проходом
61
+ * по токенам, поэтому MMM/MMMM не пересекаются с MM/M.
46
62
  */
47
- export declare function buildWindowsOneShotFlags(runAt: string): ["/sc", "ONCE", "/sd", string, "/st", string];
63
+ export declare function formatDateByLocalePattern(date: Date, pattern: string): string;
48
64
  /** Формат `at -t`: YYYYMMDDHHMM в локальном времени системы. */
49
65
  export declare function buildAtTimestamp(runAt: string): string;
66
+ /**
67
+ * Bash-команда для one-shot в launchd.
68
+ *
69
+ * StartCalendarInterval не поддерживает год: без защиты задача с runAt
70
+ * дальше чем через год сработала бы в ближайшую годовщину, а после
71
+ * выполнения — повторно через год. Гейт сравнивает now с runAt и ставит
72
+ * маркер, привязанный ко времени запуска.
73
+ */
74
+ export declare function buildOneShotGuardCommand(command: string, runAt: string, stampPath: string): string;
50
75
  /**
51
76
  * StartCalendarInterval для launchd. launchd не поддерживает год, поэтому
52
- * плагин дополнительно выгружает plist после первого запуска (см. обёртку).
77
+ * обёртка дополнительно проверяет runAt и ставит маркер выполнения
78
+ * (см. buildOneShotGuardCommand).
53
79
  */
54
80
  export declare function buildLaunchdCalendar(runAt: string): {
55
81
  Month: number;
@@ -1 +1 @@
1
- {"version":3,"file":"one-shot.d.ts","sourceRoot":"","sources":["../../src/core/one-shot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,QAAyB,CAAC;AAEhE,wCAAwC;AACxC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IACE,EAAE,EAAE,IAAI,CAAC;IACT,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAYjC;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,KAAK,GAAE,MAAmB,GACzB,oBAAoB,CAoDtB;AAMD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,GACZ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAU/C;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAStD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAQA;AAED,sEAAsE;AACtE,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,MAAkB,GAC1B,MAAM,CAOR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,GAAE,MAAkB,GAAG,MAAM,CAKvF"}
1
+ {"version":3,"file":"one-shot.d.ts","sourceRoot":"","sources":["../../src/core/one-shot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,QAAyB,CAAC;AAEhE,wCAAwC;AACxC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IACE,EAAE,EAAE,IAAI,CAAC;IACT,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAYjC;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,KAAK,GAAE,MAAmB,GACzB,oBAAoB,CAoDtB;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAW/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAiC7E;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAStD;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,CAWR;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAQA;AAED,sEAAsE;AACtE,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,OAAO,SAAY,GAClB,MAAM,CAOR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,SAAY,GAAG,MAAM,CAK/E"}
@@ -46,7 +46,7 @@ export function normalizeOneShotRunAt(input, nowMs = Date.now()) {
46
46
  if (!Number.isFinite(timestamp)) {
47
47
  return {
48
48
  ok: false,
49
- error: `runAt должен быть датой в формате ISO-8601, например ` +
49
+ error: "runAt должен быть датой в формате ISO-8601, например " +
50
50
  `2026-12-01T09:00:00Z (получено «${rawRunAt}»).`,
51
51
  };
52
52
  }
@@ -54,7 +54,7 @@ export function normalizeOneShotRunAt(input, nowMs = Date.now()) {
54
54
  return {
55
55
  ok: false,
56
56
  error: `runAt должен быть в будущем (получено «${rawRunAt}»). ` +
57
- `Для запуска сразу используйте run_task_now.`,
57
+ "Для запуска сразу используйте run_task_now.",
58
58
  };
59
59
  }
60
60
  return {
@@ -81,21 +81,68 @@ function pad(value) {
81
81
  /**
82
82
  * Формат даты/времени для schtasks /sd и /st.
83
83
  *
84
- * Windows Task Scheduler ожидает дату в формате текущей локали. Плагин уже
85
- * использует DD.MM.YYYY для ONCE-заглушки, поэтому сохраняем этот формат
86
- * для совместимости с русской локалью (основной сценарий проекта).
84
+ * Windows Task Scheduler ожидает дату в формате текущей локали. На русской
85
+ * Windows — DD.MM.YYYY, на английской — M/d/yyyy и т.д. Жёсткий DD.MM.YYYY
86
+ * ломает создание one-shot и file/git/mcp-задач на не-RU Windows (P1-8).
87
+ * Вызывающий код (windows.ts) передаёт `dateFormat`, полученный из системной
88
+ * локали через PowerShell `(Get-Culture).DateTimeFormat.ShortDatePattern`.
89
+ *
90
+ * @param runAt — ISO-8601 время запуска.
91
+ * @param dateFormat — шаблон даты локали (например, "dd.MM.yyyy" или "M/d/yyyy").
92
+ * Если не задан — используется DD.MM.YYYY (по умолчанию RU).
87
93
  */
88
- export function buildWindowsOneShotFlags(runAt) {
94
+ export function buildWindowsOneShotFlags(runAt, dateFormat) {
89
95
  const date = new Date(runAt);
96
+ const sd = dateFormat ? formatDateByLocalePattern(date, dateFormat) : `${pad(date.getDate())}.${pad(date.getMonth() + 1)}.${date.getFullYear()}`;
90
97
  return [
91
98
  "/sc",
92
99
  "ONCE",
93
100
  "/sd",
94
- `${pad(date.getDate())}.${pad(date.getMonth() + 1)}.${date.getFullYear()}`,
101
+ sd,
95
102
  "/st",
96
103
  `${pad(date.getHours())}:${pad(date.getMinutes())}`,
97
104
  ];
98
105
  }
106
+ /**
107
+ * Форматирует Date по шаблону локали Windows (.NET-формат, как возвращает
108
+ * (Get-Culture).DateTimeFormat.ShortDatePattern). Поддерживает d/dd, M/MM,
109
+ * MMM/MMMM (название месяца), y/yy/yyyy. Неизвестные символы копируются как есть.
110
+ *
111
+ * P2-26: раньше последовательные replace(/MM/) и replace(/M/) превращали
112
+ * «MMM» в число месяца («2030. 011 2.»). Теперь разбор идёт одним проходом
113
+ * по токенам, поэтому MMM/MMMM не пересекаются с MM/M.
114
+ */
115
+ export function formatDateByLocalePattern(date, pattern) {
116
+ const pad2 = (v) => String(v).padStart(2, "0");
117
+ const monthShort = new Intl.DateTimeFormat(undefined, {
118
+ month: "short",
119
+ }).format(date);
120
+ const monthLong = new Intl.DateTimeFormat(undefined, {
121
+ month: "long",
122
+ }).format(date);
123
+ return pattern.replace(/yyyy|yy|MMMM|MMM|MM|M|dd|d/g, (token) => {
124
+ switch (token) {
125
+ case "yyyy":
126
+ return String(date.getFullYear());
127
+ case "yy":
128
+ return String(date.getFullYear()).slice(-2);
129
+ case "MMMM":
130
+ return monthLong;
131
+ case "MMM":
132
+ return monthShort;
133
+ case "MM":
134
+ return pad2(date.getMonth() + 1);
135
+ case "M":
136
+ return String(date.getMonth() + 1);
137
+ case "dd":
138
+ return pad2(date.getDate());
139
+ case "d":
140
+ return String(date.getDate());
141
+ default:
142
+ return token;
143
+ }
144
+ });
145
+ }
99
146
  /** Формат `at -t`: YYYYMMDDHHMM в локальном времени системы. */
100
147
  export function buildAtTimestamp(runAt) {
101
148
  const date = new Date(runAt);
@@ -105,9 +152,30 @@ export function buildAtTimestamp(runAt) {
105
152
  `${pad(date.getHours())}` +
106
153
  `${pad(date.getMinutes())}`);
107
154
  }
155
+ /**
156
+ * Bash-команда для one-shot в launchd.
157
+ *
158
+ * StartCalendarInterval не поддерживает год: без защиты задача с runAt
159
+ * дальше чем через год сработала бы в ближайшую годовщину, а после
160
+ * выполнения — повторно через год. Гейт сравнивает now с runAt и ставит
161
+ * маркер, привязанный ко времени запуска.
162
+ */
163
+ export function buildOneShotGuardCommand(command, runAt, stampPath) {
164
+ const epoch = Math.floor(new Date(runAt).getTime() / 1000);
165
+ const quote = (value) => `'${value.replace(/'/g, "'\\''")}'`;
166
+ return [
167
+ `stamp=${quote(stampPath)}`,
168
+ "[ -f \"$stamp\" ] && exit 0",
169
+ `[ "$(date +%s)" -lt ${epoch} ] && exit 0`,
170
+ "mkdir -p \"$(dirname \"$stamp\")\" 2>/dev/null || true",
171
+ ": > \"$stamp\" 2>/dev/null || true",
172
+ command,
173
+ ].join("; ");
174
+ }
108
175
  /**
109
176
  * StartCalendarInterval для launchd. launchd не поддерживает год, поэтому
110
- * плагин дополнительно выгружает plist после первого запуска (см. обёртку).
177
+ * обёртка дополнительно проверяет runAt и ставит маркер выполнения
178
+ * (см. buildOneShotGuardCommand).
111
179
  */
112
180
  export function buildLaunchdCalendar(runAt) {
113
181
  const date = new Date(runAt);
@@ -121,9 +189,9 @@ export function buildLaunchdCalendar(runAt) {
121
189
  /** Команда самоочистки launchd-агента после единственного запуска. */
122
190
  export function buildLaunchdOneShotCleanup(sanitizedName, profile = "default") {
123
191
  const label = launchdLabel(sanitizedName, profile);
124
- return (`launchctl bootout "gui/$(id -u)" ` +
192
+ return ("launchctl bootout \"gui/$(id -u)\" " +
125
193
  `"$HOME/Library/LaunchAgents/${label}.plist" ` +
126
- `>/dev/null 2>&1 || true`);
194
+ ">/dev/null 2>&1 || true");
127
195
  }
128
196
  /**
129
197
  * label launchd-агента задачи. Для default сохраняется историческое имя
@@ -0,0 +1,28 @@
1
+ /** Готовая команда для `execFile`/`execFileSync`. */
2
+ export interface OpencodeCommand {
3
+ file: string;
4
+ args: string[];
5
+ }
6
+ /** Результат запуска CLI. */
7
+ export interface RunOpencodeResult {
8
+ ok: boolean;
9
+ stdout: string;
10
+ stderr: string;
11
+ /** Текст ошибки запуска (только при ok = false). */
12
+ error?: string;
13
+ }
14
+ /**
15
+ * Экранирует аргумент для командной строки cmd.exe.
16
+ * Бросает на переводы строк: они разрывают команду на две.
17
+ */
18
+ export declare function quoteCmdArg(arg: string): string;
19
+ /** Команда запуска OpenCode для указанной платформы (чистая функция). */
20
+ export declare function opencodeCommandFor(platform: NodeJS.Platform, args: string[]): OpencodeCommand;
21
+ /** Команда запуска OpenCode на текущей платформе. */
22
+ export declare function opencodeCommand(args: string[]): OpencodeCommand;
23
+ /**
24
+ * Запускает OpenCode CLI и ждёт завершения. Никогда не бросает.
25
+ * `timeoutMs` защищает от зависшего процесса: CLI не должен держать ротацию.
26
+ */
27
+ export declare function runOpencode(args: string[], timeoutMs?: number): Promise<RunOpencodeResult>;
28
+ //# sourceMappingURL=opencode-cli.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"opencode-cli.d.ts","sourceRoot":"","sources":["../../src/core/opencode-cli.ts"],"names":[],"mappings":"AAaA,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAKD,6BAA6B;AAC7B,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,IAAI,EAAE,MAAM,EAAE,GACb,eAAe,CAIjB;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CAE/D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,SAAS,GACjB,OAAO,CAAC,iBAAiB,CAAC,CAqC5B"}
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Кроссплатформенный запуск OpenCode CLI.
3
+ *
4
+ * На Windows `opencode` — это `opencode.cmd`. Node с 18.20/20.12 запрещает
5
+ * запускать `.cmd`/`.bat` через `execFile` без shell (EINVAL), а имя без
6
+ * расширения не находится вовсе (ENOENT). Поэтому на Windows команда идёт
7
+ * через `cmd.exe /d /s /c` — ровно так же, как в `opencode-models.ts`.
8
+ *
9
+ * Модуль не бросает: результат запуска возвращается объектом, чтобы вызывающий
10
+ * сам решал, писать предупреждение или продолжать молча.
11
+ */
12
+ import { execFile } from "node:child_process";
13
+ /** Аргументы без спецсимволов cmd.exe можно передавать как есть. */
14
+ const SAFE_ARG = /^[A-Za-z0-9_.,:@/\\+=-]+$/;
15
+ /**
16
+ * Экранирует аргумент для командной строки cmd.exe.
17
+ * Бросает на переводы строк: они разрывают команду на две.
18
+ */
19
+ export function quoteCmdArg(arg) {
20
+ if (/[\r\n]/.test(arg)) {
21
+ throw new Error("Аргумент командной строки не может содержать перевод строки");
22
+ }
23
+ if (SAFE_ARG.test(arg))
24
+ return arg;
25
+ return `"${arg.replace(/"/g, '""')}"`;
26
+ }
27
+ /** Команда запуска OpenCode для указанной платформы (чистая функция). */
28
+ export function opencodeCommandFor(platform, args) {
29
+ if (platform !== "win32")
30
+ return { file: "opencode", args: args.slice() };
31
+ const line = ["opencode", ...args].map(quoteCmdArg).join(" ");
32
+ return { file: "cmd.exe", args: ["/d", "/s", "/c", line] };
33
+ }
34
+ /** Команда запуска OpenCode на текущей платформе. */
35
+ export function opencodeCommand(args) {
36
+ return opencodeCommandFor(process.platform, args);
37
+ }
38
+ /**
39
+ * Запускает OpenCode CLI и ждёт завершения. Никогда не бросает.
40
+ * `timeoutMs` защищает от зависшего процесса: CLI не должен держать ротацию.
41
+ */
42
+ export function runOpencode(args, timeoutMs = 30000) {
43
+ let command;
44
+ try {
45
+ command = opencodeCommand(args);
46
+ }
47
+ catch (error) {
48
+ return Promise.resolve({
49
+ ok: false,
50
+ stdout: "",
51
+ stderr: "",
52
+ error: error instanceof Error ? error.message : String(error),
53
+ });
54
+ }
55
+ return new Promise((resolve) => {
56
+ execFile(command.file, command.args, {
57
+ timeout: timeoutMs,
58
+ windowsHide: true,
59
+ encoding: "utf8",
60
+ maxBuffer: 4 * 1024 * 1024,
61
+ }, (error, stdout, stderr) => {
62
+ if (error) {
63
+ resolve({
64
+ ok: false,
65
+ stdout: String(stdout ?? ""),
66
+ stderr: String(stderr ?? ""),
67
+ error: error.message,
68
+ });
69
+ return;
70
+ }
71
+ resolve({ ok: true, stdout: String(stdout ?? ""), stderr: String(stderr ?? "") });
72
+ });
73
+ });
74
+ }
@@ -0,0 +1,62 @@
1
+ /** Цена за 1M токенов модели в каталоге models.dev. */
2
+ export interface ModelCatalogEntry {
3
+ /** Входные токены, USD за 1M. */
4
+ input: number;
5
+ /** Выходные токены, USD за 1M. */
6
+ output: number;
7
+ }
8
+ /** Сколько what-if моделей показывать максимум. */
9
+ export declare const MAX_WHAT_IF_MODELS = 5;
10
+ /**
11
+ * Цены по умолчанию: используются только если модели нет ни в каталоге
12
+ * OpenCode, ни в OPENCODE_SCHEDULER_MODEL_PRICES.
13
+ */
14
+ export declare const DEFAULT_MODEL_PRICE_PER_MILLION: Record<string, number>;
15
+ /** Средняя оценка цены, если модель вообще неизвестна. */
16
+ export declare const DEFAULT_PRICE_PER_MILLION = 3;
17
+ /** What-if модели, если OpenCode недоступен и истории ещё нет. */
18
+ export declare const DEFAULT_WHAT_IF_MODELS: string[];
19
+ /** Приводит id модели к виду для сравнения (регистр и пробелы не важны). */
20
+ export declare function normalizeModelId(model: string | undefined): string;
21
+ /** Режим общения с OpenCode: "auto" (по умолчанию) или "static". */
22
+ export declare function modelSourceMode(): "auto" | "static";
23
+ /** Разбирает каталог models.dev в карту `provider/model` → цены. */
24
+ export declare function parseModelsCatalog(raw: string): Map<string, ModelCatalogEntry>;
25
+ /** Разбирает вывод `opencode models` (по одному id в строке). */
26
+ export declare function parseModelList(stdout: string): string[];
27
+ /** Средняя цена за 1M токенов: история не делит токены на вход и выход. */
28
+ export declare function blendedPrice(entry: ModelCatalogEntry): number;
29
+ /** Путь к файлу каталога models.dev, если он есть на диске. */
30
+ export declare function findModelsCacheFile(): string | null;
31
+ /**
32
+ * Каталог цен из кэша OpenCode. Файл читается заново только когда изменился
33
+ * (плюс не чаще раза в минуту), поэтому 6 МБ JSON не парсятся на каждый запрос.
34
+ */
35
+ export declare function getModelsCatalog(): Map<string, ModelCatalogEntry>;
36
+ /** Цена модели за 1M токенов по каталогу OpenCode (null — цены нет). */
37
+ export declare function catalogPricePerMillion(model: string | undefined): number | null;
38
+ /** Доступные пользователю модели (`opencode models`), кэш 10 минут. */
39
+ export declare function listAvailableModels(): string[];
40
+ /** Откуда взялся список what-if моделей. */
41
+ export type WhatIfSource = "history" | "opencode" | "default";
42
+ export interface WhatIfSelection {
43
+ models: string[];
44
+ source: WhatIfSource;
45
+ }
46
+ /**
47
+ * Что показывать в What-If.
48
+ *
49
+ * Сначала модели, которые пользователь реально запускал (история), затем — по
50
+ * одной модели на каждую цену из доступных в OpenCode: дешёвая, средняя,
51
+ * дорогая. Так список обозрим и отвечает на вопрос «а сколько было бы на
52
+ * другой модели», а не перечисляет пять бесплатных подряд.
53
+ *
54
+ * `available` и `priceOf` вынесены параметрами, чтобы правило выбора
55
+ * проверялось тестом на фиксированных данных.
56
+ */
57
+ export declare function selectWhatIfModels(preferred: string[], available: string[], priceOf?: (model: string) => number | null): WhatIfSelection;
58
+ /** What-If по реальным источникам: история + `opencode models` + каталог цен. */
59
+ export declare function resolveWhatIfModels(preferred?: string[]): WhatIfSelection;
60
+ /** Сбрасывает кэши (нужно тестам). */
61
+ export declare function resetModelCaches(): void;
62
+ //# sourceMappingURL=opencode-models.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"opencode-models.d.ts","sourceRoot":"","sources":["../../src/core/opencode-models.ts"],"names":[],"mappings":"AA0BA,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQlE,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,UAGlC,CAAC;AAgBF,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAElE;AAED,oEAAoE;AACpE,wBAAgB,eAAe,IAAI,MAAM,GAAG,QAAQ,CAGnD;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAyB9E;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAYvD;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAE7D;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAenD;AAoBD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAuBjE;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAO/E;AAoBD,uEAAuE;AACvE,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAO9C;AAED,4CAA4C;AAC5C,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAA6B,GACjE,eAAe,CA4CjB;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,SAAS,GAAE,MAAM,EAAO,GAAG,eAAe,CAE7E;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}