agent-steward 0.0.3 → 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 (171) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +3 -3
  3. package/ROADMAP-STRATEGY.md +9 -9
  4. package/ROADMAP.md +50 -34
  5. package/dist/core/dlq-api.d.ts +44 -0
  6. package/dist/core/dlq-api.d.ts.map +1 -0
  7. package/dist/core/dlq-api.js +68 -0
  8. package/dist/core/dry-run.d.ts.map +1 -1
  9. package/dist/core/dry-run.js +18 -1
  10. package/dist/core/lock.d.ts +20 -4
  11. package/dist/core/lock.d.ts.map +1 -1
  12. package/dist/core/lock.js +97 -22
  13. package/dist/core/one-shot.d.ts +5 -1
  14. package/dist/core/one-shot.d.ts.map +1 -1
  15. package/dist/core/one-shot.js +33 -8
  16. package/dist/core/opencode-cli.d.ts +28 -0
  17. package/dist/core/opencode-cli.d.ts.map +1 -0
  18. package/dist/core/opencode-cli.js +74 -0
  19. package/dist/core/opencode-models.d.ts +62 -0
  20. package/dist/core/opencode-models.d.ts.map +1 -0
  21. package/dist/core/opencode-models.js +277 -0
  22. package/dist/core/ps-wrapper.d.ts +1 -1
  23. package/dist/core/ps-wrapper.d.ts.map +1 -1
  24. package/dist/core/ps-wrapper.js +11 -1
  25. package/dist/core/record-history.d.ts +15 -0
  26. package/dist/core/record-history.d.ts.map +1 -1
  27. package/dist/core/record-history.js +56 -32
  28. package/dist/core/router/dispatch.d.ts +36 -0
  29. package/dist/core/router/dispatch.d.ts.map +1 -0
  30. package/dist/core/router/dispatch.js +59 -0
  31. package/dist/core/router/escalation.d.ts +47 -0
  32. package/dist/core/router/escalation.d.ts.map +1 -0
  33. package/dist/core/router/escalation.js +87 -0
  34. package/dist/core/router/planner.d.ts +53 -0
  35. package/dist/core/router/planner.d.ts.map +1 -0
  36. package/dist/core/router/planner.js +113 -0
  37. package/dist/core/router/rules.d.ts +46 -0
  38. package/dist/core/router/rules.d.ts.map +1 -0
  39. package/dist/core/router/rules.js +85 -0
  40. package/dist/core/run-panel-api.d.ts +94 -0
  41. package/dist/core/run-panel-api.d.ts.map +1 -0
  42. package/dist/core/run-panel-api.js +169 -0
  43. package/dist/core/schedule-gate.js +5 -1
  44. package/dist/core/schedule-v2.d.ts +34 -0
  45. package/dist/core/schedule-v2.d.ts.map +1 -1
  46. package/dist/core/schedule-v2.js +91 -5
  47. package/dist/core/scheduler/at-fallback.d.ts +55 -2
  48. package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
  49. package/dist/core/scheduler/at-fallback.js +135 -5
  50. package/dist/core/scheduler/linux.d.ts +10 -1
  51. package/dist/core/scheduler/linux.d.ts.map +1 -1
  52. package/dist/core/scheduler/linux.js +29 -11
  53. package/dist/core/scheduler/posix.d.ts.map +1 -1
  54. package/dist/core/scheduler/posix.js +25 -1
  55. package/dist/core/scheduler/registry.d.ts +11 -0
  56. package/dist/core/scheduler/registry.d.ts.map +1 -1
  57. package/dist/core/scheduler/registry.js +83 -21
  58. package/dist/core/scheduler/run-now.d.ts +16 -0
  59. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  60. package/dist/core/scheduler/run-now.js +28 -0
  61. package/dist/core/secrets.d.ts.map +1 -1
  62. package/dist/core/secrets.js +125 -28
  63. package/dist/core/session.d.ts.map +1 -1
  64. package/dist/core/session.js +18 -11
  65. package/dist/core/task-name.d.ts +24 -0
  66. package/dist/core/task-name.d.ts.map +1 -0
  67. package/dist/core/task-name.js +40 -0
  68. package/dist/core/wrappers/bash.d.ts.map +1 -1
  69. package/dist/core/wrappers/bash.js +49 -4
  70. package/dist/db/capability-repo.d.ts +83 -0
  71. package/dist/db/capability-repo.d.ts.map +1 -0
  72. package/dist/db/capability-repo.js +182 -0
  73. package/dist/db/history-repo.d.ts +8 -0
  74. package/dist/db/history-repo.d.ts.map +1 -1
  75. package/dist/db/history-repo.js +19 -0
  76. package/dist/db/index.d.ts +4 -0
  77. package/dist/db/index.d.ts.map +1 -1
  78. package/dist/db/index.js +39 -1
  79. package/dist/db/migrate.d.ts.map +1 -1
  80. package/dist/db/migrate.js +3 -1
  81. package/dist/db/run-context.d.ts +103 -0
  82. package/dist/db/run-context.d.ts.map +1 -0
  83. package/dist/db/run-context.js +224 -0
  84. package/dist/db/run-dlq.d.ts +100 -0
  85. package/dist/db/run-dlq.d.ts.map +1 -0
  86. package/dist/db/run-dlq.js +191 -0
  87. package/dist/db/run-resume.d.ts +5 -2
  88. package/dist/db/run-resume.d.ts.map +1 -1
  89. package/dist/db/run-resume.js +30 -11
  90. package/dist/db/runs-repo.d.ts +13 -5
  91. package/dist/db/runs-repo.d.ts.map +1 -1
  92. package/dist/db/runs-repo.js +28 -5
  93. package/dist/db/schema.d.ts +2 -2
  94. package/dist/db/schema.d.ts.map +1 -1
  95. package/dist/db/schema.js +154 -2
  96. package/dist/db/settings-repo.d.ts +11 -0
  97. package/dist/db/settings-repo.d.ts.map +1 -1
  98. package/dist/db/settings-repo.js +25 -0
  99. package/dist/db/step-idempotency.d.ts +51 -0
  100. package/dist/db/step-idempotency.d.ts.map +1 -0
  101. package/dist/db/step-idempotency.js +136 -0
  102. package/dist/index.d.ts +4 -4
  103. package/dist/index.d.ts.map +1 -1
  104. package/dist/index.js +102 -4
  105. package/dist/rpc.d.ts +678 -0
  106. package/dist/rpc.d.ts.map +1 -1
  107. package/dist/rpc.js +235 -0
  108. package/dist/server.d.ts +31 -0
  109. package/dist/server.d.ts.map +1 -1
  110. package/dist/server.js +95 -35
  111. package/dist/types.d.ts.map +1 -1
  112. package/dist/types.js +7 -0
  113. package/dist/workspaces.d.ts +25 -3
  114. package/dist/workspaces.d.ts.map +1 -1
  115. package/dist/workspaces.js +43 -8
  116. package/docs/ARCHITECTURE.md +229 -5
  117. package/docs/CONCEPT.md +171 -91
  118. package/docs/EXECUTION-LOOP.md +196 -0
  119. package/docs/README.ru.md +2 -2
  120. package/docs/README.zh.md +3 -3
  121. package/docs/SAFETY.md +122 -0
  122. package/docs/SAVINGS.md +29 -0
  123. package/docs/SAVINGS.ru.md +29 -0
  124. package/docs/SAVINGS.zh.md +18 -0
  125. package/gui-experimental.cjs +8 -8
  126. package/locales/en.json +67 -0
  127. package/locales/ru.json +67 -0
  128. package/locales/zh.json +67 -0
  129. package/package.json +28 -3
  130. package/scripts/audit-bundle.mjs +215 -0
  131. package/src/core/dlq-api.ts +98 -0
  132. package/src/core/dry-run.ts +25 -1
  133. package/src/core/lock.ts +95 -22
  134. package/src/core/one-shot.ts +36 -8
  135. package/src/core/opencode-cli.ts +103 -0
  136. package/src/core/opencode-models.ts +315 -0
  137. package/src/core/ps-wrapper.ts +11 -1
  138. package/src/core/record-history.ts +75 -37
  139. package/src/core/router/dispatch.ts +94 -0
  140. package/src/core/router/escalation.ts +129 -0
  141. package/src/core/router/planner.ts +166 -0
  142. package/src/core/router/rules.ts +109 -0
  143. package/src/core/run-panel-api.ts +262 -0
  144. package/src/core/schedule-gate.ts +6 -2
  145. package/src/core/schedule-v2.ts +114 -5
  146. package/src/core/scheduler/at-fallback.ts +190 -5
  147. package/src/core/scheduler/linux.ts +32 -10
  148. package/src/core/scheduler/posix.ts +20 -1
  149. package/src/core/scheduler/registry.ts +107 -26
  150. package/src/core/scheduler/run-now.ts +32 -0
  151. package/src/core/secrets.ts +127 -27
  152. package/src/core/session.ts +23 -10
  153. package/src/core/task-name.ts +67 -0
  154. package/src/core/wrappers/bash.ts +49 -4
  155. package/src/db/capability-repo.ts +285 -0
  156. package/src/db/history-repo.ts +22 -0
  157. package/src/db/index.ts +37 -1
  158. package/src/db/migrate.ts +3 -1
  159. package/src/db/run-context.ts +370 -0
  160. package/src/db/run-dlq.ts +310 -0
  161. package/src/db/run-resume.ts +48 -12
  162. package/src/db/runs-repo.ts +30 -7
  163. package/src/db/schema.ts +154 -2
  164. package/src/db/settings-repo.ts +31 -0
  165. package/src/db/step-idempotency.ts +185 -0
  166. package/src/gui.tsx +515 -0
  167. package/src/index.ts +124 -4
  168. package/src/rpc.ts +251 -0
  169. package/src/server.ts +112 -36
  170. package/src/types.ts +9 -0
  171. package/src/workspaces.ts +58 -9
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, созданный другим, и задача запускалась повторно. Атомарный
@@ -75,36 +116,57 @@ export class LockManager {
75
116
  }
76
117
  /**
77
118
  * Пытается захватить блокировку для задачи.
78
- * Возвращает true, если блокировка захвачена (файл создан).
79
- * Возвращает false, если блокировка уже удерживается другим запуском.
119
+ * Возвращает уникальный токен владельца (он же содержимое lock-файла) или
120
+ * null, если блокировка уже удерживается другим запуском.
121
+ *
122
+ * Токен нужен release(): процесс, чей lock был вытеснен по stale-таймауту,
123
+ * не должен удалять файл нового владельца.
80
124
  */
81
125
  async acquire(taskName) {
82
126
  await fs.mkdir(this.lockDir, { recursive: true });
83
127
  const lockPath = this.lockFilePath(taskName);
128
+ const token = `${process.pid}-${Date.now()}-${randomUUID()}`;
84
129
  try {
85
130
  // 'wx' — exclusive create: ошибка если файл уже существует.
86
- await fs.writeFile(lockPath, String(Date.now()), { flag: "wx" });
87
- return true;
131
+ await fs.writeFile(lockPath, token, { flag: "wx" });
132
+ return token;
88
133
  }
89
134
  catch (err) {
90
135
  if (err.code === "EEXIST") {
91
- return false;
136
+ return null;
92
137
  }
93
138
  throw err;
94
139
  }
95
140
  }
96
141
  /**
97
142
  * Освобождает блокировку задачи (удаляет lock-файл).
143
+ *
144
+ * Удаляет файл только если в нём лежит токен этого владельца. Если lock
145
+ * успели вытеснить и перехватить, release ничего не трогает и возвращает
146
+ * false — иначе старый процесс снёс бы чужую критическую секцию.
98
147
  * Не выбрасывает ошибку, если файл уже удалён.
99
148
  */
100
- async release(taskName) {
149
+ async release(taskName, token) {
101
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;
102
162
  try {
103
163
  await fs.unlink(lockPath);
164
+ return true;
104
165
  }
105
166
  catch (err) {
106
- if (err.code !== "ENOENT")
107
- throw err;
167
+ if (err.code === "ENOENT")
168
+ return false;
169
+ throw err;
108
170
  }
109
171
  }
110
172
  /**
@@ -129,8 +191,8 @@ export class LockManager {
129
191
  * Гарантирует освобождение блокировки в finally (включая при ошибках).
130
192
  */
131
193
  export async function withLock(lockManager, taskName, fn) {
132
- const acquired = await lockManager.acquire(taskName);
133
- if (!acquired) {
194
+ const token = await lockManager.acquire(taskName);
195
+ if (!token) {
134
196
  console.log(`[agent-steward] Запуск задачи "${taskName}" пропущен: удерживается активная блокировка.`);
135
197
  return null;
136
198
  }
@@ -138,7 +200,7 @@ export async function withLock(lockManager, taskName, fn) {
138
200
  return await fn();
139
201
  }
140
202
  finally {
141
- await lockManager.release(taskName);
203
+ await lockManager.release(taskName, token);
142
204
  }
143
205
  }
144
206
  /**
@@ -154,25 +216,37 @@ export async function withLockWait(lockManager, taskName, fn, options = {}) {
154
216
  const staleMs = options.staleMs ?? 60000;
155
217
  const deadline = Date.now() + timeoutMs;
156
218
  const lockPath = lockManager.pathFor(taskName);
219
+ let token = null;
157
220
  for (;;) {
158
- if (await lockManager.acquire(taskName))
221
+ token = await lockManager.acquire(taskName);
222
+ if (token)
159
223
  break;
160
224
  // Осиротевший lock: короткая операция не может длиться дольше staleMs.
161
225
  if (staleMs > 0) {
162
226
  try {
163
227
  const stat = await fs.stat(lockPath);
164
228
  if (Date.now() - stat.mtimeMs > staleMs) {
165
- // T-03-совместимое вытеснение: атомарный rename выигрывает ровно
166
- // один процесс, остальные получают ENOENT и повторяют попытку.
167
- const stalePath = `${lockPath}.stale-${process.pid}-${Date.now()}`;
168
- try {
169
- await fs.rename(lockPath, stalePath);
170
- 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 вернём понятную ошибку.
171
236
  }
172
- catch {
173
- // Кто-то успел раньше — просто повторяем 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;
174
249
  }
175
- continue;
176
250
  }
177
251
  }
178
252
  catch {
@@ -188,6 +262,7 @@ export async function withLockWait(lockManager, taskName, fn, options = {}) {
188
262
  return await fn();
189
263
  }
190
264
  finally {
191
- await lockManager.release(taskName);
265
+ if (token)
266
+ await lockManager.release(taskName, token);
192
267
  }
193
268
  }
@@ -54,7 +54,11 @@ export declare function buildWindowsOneShotFlags(runAt: string, dateFormat?: str
54
54
  /**
55
55
  * Форматирует Date по шаблону локали Windows (.NET-формат, как возвращает
56
56
  * (Get-Culture).DateTimeFormat.ShortDatePattern). Поддерживает d/dd, M/MM,
57
- * y/yy/yyyy. Неизвестные символы копируются как есть.
57
+ * MMM/MMMM (название месяца), y/yy/yyyy. Неизвестные символы копируются как есть.
58
+ *
59
+ * P2-26: раньше последовательные replace(/MM/) и replace(/M/) превращали
60
+ * «MMM» в число месяца («2030. 011 2.»). Теперь разбор идёт одним проходом
61
+ * по токенам, поэтому MMM/MMMM не пересекаются с MM/M.
58
62
  */
59
63
  export declare function formatDateByLocalePattern(date: Date, pattern: string): string;
60
64
  /** Формат `at -t`: YYYYMMDDHHMM в локальном времени системы. */
@@ -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;;;;;;;;;;;;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;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAS7E;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"}
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"}
@@ -106,17 +106,42 @@ export function buildWindowsOneShotFlags(runAt, dateFormat) {
106
106
  /**
107
107
  * Форматирует Date по шаблону локали Windows (.NET-формат, как возвращает
108
108
  * (Get-Culture).DateTimeFormat.ShortDatePattern). Поддерживает d/dd, M/MM,
109
- * y/yy/yyyy. Неизвестные символы копируются как есть.
109
+ * MMM/MMMM (название месяца), y/yy/yyyy. Неизвестные символы копируются как есть.
110
+ *
111
+ * P2-26: раньше последовательные replace(/MM/) и replace(/M/) превращали
112
+ * «MMM» в число месяца («2030. 011 2.»). Теперь разбор идёт одним проходом
113
+ * по токенам, поэтому MMM/MMMM не пересекаются с MM/M.
110
114
  */
111
115
  export function formatDateByLocalePattern(date, pattern) {
112
116
  const pad2 = (v) => String(v).padStart(2, "0");
113
- return pattern
114
- .replace(/yyyy/g, String(date.getFullYear()))
115
- .replace(/yy/g, String(date.getFullYear()).slice(-2))
116
- .replace(/MM/g, pad2(date.getMonth() + 1))
117
- .replace(/M/g, String(date.getMonth() + 1))
118
- .replace(/dd/g, pad2(date.getDate()))
119
- .replace(/d/g, String(date.getDate()));
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
+ });
120
145
  }
121
146
  /** Формат `at -t`: YYYYMMDDHHMM в локальном времени системы. */
122
147
  export function buildAtTimestamp(runAt) {
@@ -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"}