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.
- package/CHANGELOG.md +20 -0
- package/README.md +3 -3
- package/ROADMAP-STRATEGY.md +9 -9
- package/ROADMAP.md +50 -34
- package/dist/core/dlq-api.d.ts +44 -0
- package/dist/core/dlq-api.d.ts.map +1 -0
- package/dist/core/dlq-api.js +68 -0
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +18 -1
- package/dist/core/lock.d.ts +20 -4
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +97 -22
- package/dist/core/one-shot.d.ts +5 -1
- package/dist/core/one-shot.d.ts.map +1 -1
- package/dist/core/one-shot.js +33 -8
- package/dist/core/opencode-cli.d.ts +28 -0
- package/dist/core/opencode-cli.d.ts.map +1 -0
- package/dist/core/opencode-cli.js +74 -0
- package/dist/core/opencode-models.d.ts +62 -0
- package/dist/core/opencode-models.d.ts.map +1 -0
- package/dist/core/opencode-models.js +277 -0
- package/dist/core/ps-wrapper.d.ts +1 -1
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +11 -1
- package/dist/core/record-history.d.ts +15 -0
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +56 -32
- package/dist/core/router/dispatch.d.ts +36 -0
- package/dist/core/router/dispatch.d.ts.map +1 -0
- package/dist/core/router/dispatch.js +59 -0
- package/dist/core/router/escalation.d.ts +47 -0
- package/dist/core/router/escalation.d.ts.map +1 -0
- package/dist/core/router/escalation.js +87 -0
- package/dist/core/router/planner.d.ts +53 -0
- package/dist/core/router/planner.d.ts.map +1 -0
- package/dist/core/router/planner.js +113 -0
- package/dist/core/router/rules.d.ts +46 -0
- package/dist/core/router/rules.d.ts.map +1 -0
- package/dist/core/router/rules.js +85 -0
- package/dist/core/run-panel-api.d.ts +94 -0
- package/dist/core/run-panel-api.d.ts.map +1 -0
- package/dist/core/run-panel-api.js +169 -0
- package/dist/core/schedule-gate.js +5 -1
- package/dist/core/schedule-v2.d.ts +34 -0
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +91 -5
- package/dist/core/scheduler/at-fallback.d.ts +55 -2
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
- package/dist/core/scheduler/at-fallback.js +135 -5
- package/dist/core/scheduler/linux.d.ts +10 -1
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +29 -11
- package/dist/core/scheduler/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +25 -1
- package/dist/core/scheduler/registry.d.ts +11 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -1
- package/dist/core/scheduler/registry.js +83 -21
- package/dist/core/scheduler/run-now.d.ts +16 -0
- package/dist/core/scheduler/run-now.d.ts.map +1 -0
- package/dist/core/scheduler/run-now.js +28 -0
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +125 -28
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +18 -11
- package/dist/core/task-name.d.ts +24 -0
- package/dist/core/task-name.d.ts.map +1 -0
- package/dist/core/task-name.js +40 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +49 -4
- package/dist/db/capability-repo.d.ts +83 -0
- package/dist/db/capability-repo.d.ts.map +1 -0
- package/dist/db/capability-repo.js +182 -0
- package/dist/db/history-repo.d.ts +8 -0
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +19 -0
- package/dist/db/index.d.ts +4 -0
- package/dist/db/index.d.ts.map +1 -1
- package/dist/db/index.js +39 -1
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +3 -1
- package/dist/db/run-context.d.ts +103 -0
- package/dist/db/run-context.d.ts.map +1 -0
- package/dist/db/run-context.js +224 -0
- package/dist/db/run-dlq.d.ts +100 -0
- package/dist/db/run-dlq.d.ts.map +1 -0
- package/dist/db/run-dlq.js +191 -0
- package/dist/db/run-resume.d.ts +5 -2
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +30 -11
- package/dist/db/runs-repo.d.ts +13 -5
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +28 -5
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +154 -2
- package/dist/db/settings-repo.d.ts +11 -0
- package/dist/db/settings-repo.d.ts.map +1 -1
- package/dist/db/settings-repo.js +25 -0
- package/dist/db/step-idempotency.d.ts +51 -0
- package/dist/db/step-idempotency.d.ts.map +1 -0
- package/dist/db/step-idempotency.js +136 -0
- package/dist/index.d.ts +4 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +102 -4
- package/dist/rpc.d.ts +678 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +235 -0
- package/dist/server.d.ts +31 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +95 -35
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +7 -0
- package/dist/workspaces.d.ts +25 -3
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +43 -8
- package/docs/ARCHITECTURE.md +229 -5
- package/docs/CONCEPT.md +171 -91
- package/docs/EXECUTION-LOOP.md +196 -0
- package/docs/README.ru.md +2 -2
- package/docs/README.zh.md +3 -3
- package/docs/SAFETY.md +122 -0
- package/docs/SAVINGS.md +29 -0
- package/docs/SAVINGS.ru.md +29 -0
- package/docs/SAVINGS.zh.md +18 -0
- package/gui-experimental.cjs +8 -8
- package/locales/en.json +67 -0
- package/locales/ru.json +67 -0
- package/locales/zh.json +67 -0
- package/package.json +28 -3
- package/scripts/audit-bundle.mjs +215 -0
- package/src/core/dlq-api.ts +98 -0
- package/src/core/dry-run.ts +25 -1
- package/src/core/lock.ts +95 -22
- package/src/core/one-shot.ts +36 -8
- package/src/core/opencode-cli.ts +103 -0
- package/src/core/opencode-models.ts +315 -0
- package/src/core/ps-wrapper.ts +11 -1
- package/src/core/record-history.ts +75 -37
- package/src/core/router/dispatch.ts +94 -0
- package/src/core/router/escalation.ts +129 -0
- package/src/core/router/planner.ts +166 -0
- package/src/core/router/rules.ts +109 -0
- package/src/core/run-panel-api.ts +262 -0
- package/src/core/schedule-gate.ts +6 -2
- package/src/core/schedule-v2.ts +114 -5
- package/src/core/scheduler/at-fallback.ts +190 -5
- package/src/core/scheduler/linux.ts +32 -10
- package/src/core/scheduler/posix.ts +20 -1
- package/src/core/scheduler/registry.ts +107 -26
- package/src/core/scheduler/run-now.ts +32 -0
- package/src/core/secrets.ts +127 -27
- package/src/core/session.ts +23 -10
- package/src/core/task-name.ts +67 -0
- package/src/core/wrappers/bash.ts +49 -4
- package/src/db/capability-repo.ts +285 -0
- package/src/db/history-repo.ts +22 -0
- package/src/db/index.ts +37 -1
- package/src/db/migrate.ts +3 -1
- package/src/db/run-context.ts +370 -0
- package/src/db/run-dlq.ts +310 -0
- package/src/db/run-resume.ts +48 -12
- package/src/db/runs-repo.ts +30 -7
- package/src/db/schema.ts +154 -2
- package/src/db/settings-repo.ts +31 -0
- package/src/db/step-idempotency.ts +185 -0
- package/src/gui.tsx +515 -0
- package/src/index.ts +124 -4
- package/src/rpc.ts +251 -0
- package/src/server.ts +112 -36
- package/src/types.ts +9 -0
- 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
|
-
* Возвращает
|
|
79
|
-
*
|
|
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,
|
|
87
|
-
return
|
|
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
|
|
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
|
|
107
|
-
|
|
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
|
|
133
|
-
if (!
|
|
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
|
-
|
|
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
|
-
//
|
|
166
|
-
//
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
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
|
-
|
|
173
|
-
//
|
|
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
|
-
|
|
265
|
+
if (token)
|
|
266
|
+
await lockManager.release(taskName, token);
|
|
192
267
|
}
|
|
193
268
|
}
|
package/dist/core/one-shot.d.ts
CHANGED
|
@@ -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
|
|
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"}
|
package/dist/core/one-shot.js
CHANGED
|
@@ -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
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
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"}
|