agent-steward 0.0.1 → 0.0.3
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 +399 -0
- package/CROSS_PLATFORM.md +151 -0
- package/README.md +307 -15
- package/ROADMAP-STRATEGY.md +196 -0
- package/ROADMAP.md +184 -0
- package/dist/core/analytics.d.ts +132 -0
- package/dist/core/analytics.d.ts.map +1 -0
- package/dist/core/analytics.js +290 -0
- package/dist/core/audit.d.ts +96 -0
- package/dist/core/audit.d.ts.map +1 -0
- package/dist/core/audit.js +297 -0
- package/dist/core/cron-to-schtasks.d.ts +12 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -0
- package/dist/core/cron-to-schtasks.js +175 -0
- package/dist/core/dry-run.d.ts +102 -0
- package/dist/core/dry-run.d.ts.map +1 -0
- package/dist/core/dry-run.js +447 -0
- package/dist/core/file-watcher.d.ts +31 -0
- package/dist/core/file-watcher.d.ts.map +1 -0
- package/dist/core/file-watcher.js +186 -0
- package/dist/core/git-trigger.d.ts +82 -0
- package/dist/core/git-trigger.d.ts.map +1 -0
- package/dist/core/git-trigger.js +312 -0
- package/dist/core/glob.d.ts +38 -0
- package/dist/core/glob.d.ts.map +1 -0
- package/dist/core/glob.js +233 -0
- package/dist/core/local-ai.d.ts +52 -0
- package/dist/core/local-ai.d.ts.map +1 -0
- package/dist/core/local-ai.js +119 -0
- package/dist/core/lock.d.ts +57 -0
- package/dist/core/lock.d.ts.map +1 -0
- package/dist/core/lock.js +193 -0
- package/dist/core/matrix.d.ts +167 -0
- package/dist/core/matrix.d.ts.map +1 -0
- package/dist/core/matrix.js +724 -0
- package/dist/core/native-notify.d.ts +36 -0
- package/dist/core/native-notify.d.ts.map +1 -0
- package/dist/core/native-notify.js +113 -0
- package/dist/core/one-shot.d.ts +90 -0
- package/dist/core/one-shot.d.ts.map +1 -0
- package/dist/core/one-shot.js +182 -0
- package/dist/core/otel.d.ts +4 -0
- package/dist/core/otel.d.ts.map +1 -0
- package/dist/core/otel.js +98 -0
- package/dist/core/permissions.d.ts +69 -0
- package/dist/core/permissions.d.ts.map +1 -0
- package/dist/core/permissions.js +143 -0
- package/dist/core/prometheus.d.ts +23 -0
- package/dist/core/prometheus.d.ts.map +1 -0
- package/dist/core/prometheus.js +146 -0
- package/dist/core/ps-wrapper.d.ts +73 -0
- package/dist/core/ps-wrapper.d.ts.map +1 -0
- package/dist/core/ps-wrapper.js +1091 -0
- package/dist/core/record-history.d.ts +25 -0
- package/dist/core/record-history.d.ts.map +1 -0
- package/dist/core/record-history.js +471 -0
- package/dist/core/retention.d.ts +29 -0
- package/dist/core/retention.d.ts.map +1 -0
- package/dist/core/retention.js +98 -0
- package/dist/core/savings.d.ts +70 -0
- package/dist/core/savings.d.ts.map +1 -0
- package/dist/core/savings.js +87 -0
- package/dist/core/schedule-gate.d.ts +2 -0
- package/dist/core/schedule-gate.d.ts.map +1 -0
- package/dist/core/schedule-gate.js +211 -0
- package/dist/core/schedule-v2.d.ts +116 -0
- package/dist/core/schedule-v2.d.ts.map +1 -0
- package/dist/core/schedule-v2.js +586 -0
- package/dist/core/scheduler/at-fallback.d.ts +42 -0
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
- package/dist/core/scheduler/at-fallback.js +70 -0
- package/dist/core/scheduler/index.d.ts +32 -0
- package/dist/core/scheduler/index.d.ts.map +1 -0
- package/dist/core/scheduler/index.js +63 -0
- package/dist/core/scheduler/linux.d.ts +46 -0
- package/dist/core/scheduler/linux.d.ts.map +1 -0
- package/dist/core/scheduler/linux.js +261 -0
- package/dist/core/scheduler/logs.d.ts +11 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -0
- package/dist/core/scheduler/logs.js +34 -0
- package/dist/core/scheduler/mac.d.ts +46 -0
- package/dist/core/scheduler/mac.d.ts.map +1 -0
- package/dist/core/scheduler/mac.js +256 -0
- package/dist/core/scheduler/posix.d.ts +40 -0
- package/dist/core/scheduler/posix.d.ts.map +1 -0
- package/dist/core/scheduler/posix.js +100 -0
- package/dist/core/scheduler/registry.d.ts +43 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -0
- package/dist/core/scheduler/registry.js +57 -0
- package/dist/core/scheduler/types.d.ts +86 -0
- package/dist/core/scheduler/types.d.ts.map +1 -0
- package/dist/core/scheduler/types.js +1 -0
- package/dist/core/scheduler/windows.d.ts +112 -0
- package/dist/core/scheduler/windows.d.ts.map +1 -0
- package/dist/core/scheduler/windows.js +749 -0
- package/dist/core/secrets.d.ts +66 -0
- package/dist/core/secrets.d.ts.map +1 -0
- package/dist/core/secrets.js +433 -0
- package/dist/core/self-analysis.d.ts +117 -0
- package/dist/core/self-analysis.d.ts.map +1 -0
- package/dist/core/self-analysis.js +539 -0
- package/dist/core/session.d.ts +42 -0
- package/dist/core/session.d.ts.map +1 -0
- package/dist/core/session.js +134 -0
- package/dist/core/shutdown.d.ts +26 -0
- package/dist/core/shutdown.d.ts.map +1 -0
- package/dist/core/shutdown.js +49 -0
- package/dist/core/structured-log.d.ts +84 -0
- package/dist/core/structured-log.d.ts.map +1 -0
- package/dist/core/structured-log.js +146 -0
- package/dist/core/summary.d.ts +69 -0
- package/dist/core/summary.d.ts.map +1 -0
- package/dist/core/summary.js +250 -0
- package/dist/core/telegram.d.ts +55 -0
- package/dist/core/telegram.d.ts.map +1 -0
- package/dist/core/telegram.js +344 -0
- package/dist/core/triage-chain.d.ts +40 -0
- package/dist/core/triage-chain.d.ts.map +1 -0
- package/dist/core/triage-chain.js +80 -0
- package/dist/core/triage-compare.d.ts +68 -0
- package/dist/core/triage-compare.d.ts.map +1 -0
- package/dist/core/triage-compare.js +184 -0
- package/dist/core/triage-rules.d.ts +23 -0
- package/dist/core/triage-rules.d.ts.map +1 -0
- package/dist/core/triage-rules.js +196 -0
- package/dist/core/triage-shadow.d.ts +91 -0
- package/dist/core/triage-shadow.d.ts.map +1 -0
- package/dist/core/triage-shadow.js +160 -0
- package/dist/core/triage-worker.d.ts +55 -0
- package/dist/core/triage-worker.d.ts.map +1 -0
- package/dist/core/triage-worker.js +314 -0
- package/dist/core/triage.d.ts +76 -0
- package/dist/core/triage.d.ts.map +1 -0
- package/dist/core/triage.js +271 -0
- package/dist/core/watch-paths.d.ts +6 -0
- package/dist/core/watch-paths.d.ts.map +1 -0
- package/dist/core/watch-paths.js +62 -0
- package/dist/core/wrappers/bash.d.ts +95 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -0
- package/dist/core/wrappers/bash.js +413 -0
- package/dist/db/git-state-repo.d.ts +16 -0
- package/dist/db/git-state-repo.d.ts.map +1 -0
- package/dist/db/git-state-repo.js +38 -0
- package/dist/db/history-repo.d.ts +110 -0
- package/dist/db/history-repo.d.ts.map +1 -0
- package/dist/db/history-repo.js +300 -0
- package/dist/db/index.d.ts +49 -0
- package/dist/db/index.d.ts.map +1 -0
- package/dist/db/index.js +128 -0
- package/dist/db/metrics-repo.d.ts +46 -0
- package/dist/db/metrics-repo.d.ts.map +1 -0
- package/dist/db/metrics-repo.js +103 -0
- package/dist/db/migrate.d.ts +24 -0
- package/dist/db/migrate.d.ts.map +1 -0
- package/dist/db/migrate.js +244 -0
- package/dist/db/recovery.d.ts +11 -0
- package/dist/db/recovery.d.ts.map +1 -0
- package/dist/db/recovery.js +38 -0
- package/dist/db/run-journal.d.ts +60 -0
- package/dist/db/run-journal.d.ts.map +1 -0
- package/dist/db/run-journal.js +143 -0
- package/dist/db/run-resume.d.ts +48 -0
- package/dist/db/run-resume.d.ts.map +1 -0
- package/dist/db/run-resume.js +137 -0
- package/dist/db/runs-repo.d.ts +120 -0
- package/dist/db/runs-repo.d.ts.map +1 -0
- package/dist/db/runs-repo.js +319 -0
- package/dist/db/schema.d.ts +38 -0
- package/dist/db/schema.d.ts.map +1 -0
- package/dist/db/schema.js +325 -0
- package/dist/db/settings-repo.d.ts +8 -0
- package/dist/db/settings-repo.d.ts.map +1 -0
- package/dist/db/settings-repo.js +27 -0
- package/dist/db/tasks-repo.d.ts +26 -0
- package/dist/db/tasks-repo.d.ts.map +1 -0
- package/dist/db/tasks-repo.js +120 -0
- package/dist/db/templates-repo.d.ts +17 -0
- package/dist/db/templates-repo.d.ts.map +1 -0
- package/dist/db/templates-repo.js +57 -0
- package/dist/history.d.ts +60 -0
- package/dist/history.d.ts.map +1 -0
- package/dist/history.js +70 -0
- package/dist/i18n.d.ts +75 -0
- package/dist/i18n.d.ts.map +1 -0
- package/dist/i18n.js +357 -0
- package/dist/index.d.ts +858 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +5209 -0
- package/dist/integrations.d.ts +72 -0
- package/dist/integrations.d.ts.map +1 -0
- package/dist/integrations.js +233 -0
- package/dist/notifications.d.ts +199 -0
- package/dist/notifications.d.ts.map +1 -0
- package/dist/notifications.js +967 -0
- package/dist/profiles.d.ts +64 -0
- package/dist/profiles.d.ts.map +1 -0
- package/dist/profiles.js +305 -0
- package/dist/rpc.d.ts +3915 -0
- package/dist/rpc.d.ts.map +1 -0
- package/dist/rpc.js +1596 -0
- package/dist/schtasks.d.ts +32 -0
- package/dist/schtasks.d.ts.map +1 -0
- package/dist/schtasks.js +45 -0
- package/dist/server.d.ts +128 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +2414 -0
- package/dist/settings.d.ts +389 -0
- package/dist/settings.d.ts.map +1 -0
- package/dist/settings.js +770 -0
- package/dist/shared/jobs-view.d.ts +59 -0
- package/dist/shared/jobs-view.d.ts.map +1 -0
- package/dist/shared/jobs-view.js +146 -0
- package/dist/skill.d.ts +15 -0
- package/dist/skill.d.ts.map +1 -0
- package/dist/skill.js +93 -0
- package/dist/task-transfer.d.ts +252 -0
- package/dist/task-transfer.d.ts.map +1 -0
- package/dist/task-transfer.js +632 -0
- package/dist/templates.d.ts +57 -0
- package/dist/templates.d.ts.map +1 -0
- package/dist/templates.js +16 -0
- package/dist/types.d.ts +112 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +158 -0
- package/dist/version.d.ts +8 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +27 -0
- package/dist/workspaces.d.ts +113 -0
- package/dist/workspaces.d.ts.map +1 -0
- package/dist/workspaces.js +393 -0
- package/docs/ARCHITECTURE.md +559 -0
- package/docs/COMPATIBILITY.md +237 -0
- package/docs/CONCEPT.md +242 -0
- package/docs/CROSS_PLATFORM.ru.md +152 -0
- package/docs/CROSS_PLATFORM.zh.md +148 -0
- package/docs/FAQ.md +52 -0
- package/docs/FAQ.ru.md +53 -0
- package/docs/FAQ.zh.md +43 -0
- package/docs/FEATURES.md +699 -0
- package/docs/FEATURES.zh.md +656 -0
- package/docs/LOCAL-AI.md +300 -0
- package/docs/MIGRATION.md +363 -0
- package/docs/README.ru.md +287 -0
- package/docs/README.zh.md +306 -0
- package/docs/SAVINGS.md +61 -0
- package/docs/SAVINGS.ru.md +60 -0
- package/docs/SAVINGS.zh.md +52 -0
- package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
- package/docs/ZH-LOCALE-PLAN.md +324 -0
- package/docs/dashboard.png +0 -0
- package/docs/spikes/local-model-structured-output.md +81 -0
- package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
- package/docs/spikes/ollama-qwen3-4b.json +163 -0
- package/gui-experimental.cjs +9 -0
- package/index.js +2 -0
- package/locales/en.json +781 -0
- package/locales/ru.json +781 -0
- package/locales/zh.json +781 -0
- package/package.json +154 -13
- package/scripts/bench-local.mjs +321 -0
- package/scripts/check-zh-locale.mjs +218 -0
- package/scripts/demo-dashboard.mjs +209 -0
- package/scripts/run-tests.mjs +236 -0
- package/scripts/spike-local-structured.mjs +182 -0
- package/scripts/test-locale.mjs +45 -0
- package/skills/scheduled-job-best-practices/SKILL.md +158 -0
- package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
- package/src/core/analytics.ts +424 -0
- package/src/core/audit.ts +418 -0
- package/src/core/cron-to-schtasks.ts +209 -0
- package/src/core/dry-run.ts +601 -0
- package/src/core/file-watcher.ts +245 -0
- package/src/core/git-trigger.ts +391 -0
- package/src/core/glob.ts +226 -0
- package/src/core/local-ai.ts +173 -0
- package/src/core/lock.ts +219 -0
- package/src/core/matrix.ts +947 -0
- package/src/core/native-notify.ts +157 -0
- package/src/core/one-shot.ts +239 -0
- package/src/core/otel.ts +128 -0
- package/src/core/permissions.ts +200 -0
- package/src/core/prometheus.ts +215 -0
- package/src/core/ps-wrapper.ts +1160 -0
- package/src/core/record-history.ts +615 -0
- package/src/core/retention.ts +141 -0
- package/src/core/savings.ts +150 -0
- package/src/core/schedule-gate.ts +253 -0
- package/src/core/schedule-v2.ts +668 -0
- package/src/core/scheduler/at-fallback.ts +113 -0
- package/src/core/scheduler/index.ts +82 -0
- package/src/core/scheduler/linux.ts +308 -0
- package/src/core/scheduler/logs.ts +37 -0
- package/src/core/scheduler/mac.ts +322 -0
- package/src/core/scheduler/posix.ts +128 -0
- package/src/core/scheduler/registry.ts +101 -0
- package/src/core/scheduler/types.ts +90 -0
- package/src/core/scheduler/windows.ts +881 -0
- package/src/core/secrets.ts +503 -0
- package/src/core/self-analysis.ts +744 -0
- package/src/core/session.ts +150 -0
- package/src/core/shutdown.ts +69 -0
- package/src/core/structured-log.ts +214 -0
- package/src/core/summary.ts +318 -0
- package/src/core/telegram.ts +436 -0
- package/src/core/triage-chain.ts +125 -0
- package/src/core/triage-compare.ts +277 -0
- package/src/core/triage-rules.ts +238 -0
- package/src/core/triage-shadow.ts +240 -0
- package/src/core/triage-worker.ts +344 -0
- package/src/core/triage.ts +366 -0
- package/src/core/watch-paths.ts +70 -0
- package/src/core/wrappers/bash.ts +532 -0
- package/src/db/git-state-repo.ts +62 -0
- package/src/db/history-repo.ts +492 -0
- package/src/db/index.ts +176 -0
- package/src/db/metrics-repo.ts +170 -0
- package/src/db/migrate.ts +328 -0
- package/src/db/recovery.ts +46 -0
- package/src/db/run-journal.ts +212 -0
- package/src/db/run-resume.ts +220 -0
- package/src/db/runs-repo.ts +481 -0
- package/src/db/schema.ts +349 -0
- package/src/db/settings-repo.ts +31 -0
- package/src/db/tasks-repo.ts +162 -0
- package/src/db/templates-repo.ts +77 -0
- package/src/gui.tsx +5222 -0
- package/src/history.ts +128 -0
- package/src/i18n.ts +413 -0
- package/src/index.ts +6642 -0
- package/src/integrations.ts +297 -0
- package/src/notifications.ts +1346 -0
- package/src/profiles.ts +345 -0
- package/src/rpc.ts +1704 -0
- package/src/schtasks.ts +75 -0
- package/src/server.ts +2663 -0
- package/src/settings.ts +1369 -0
- package/src/shared/jobs-view.ts +188 -0
- package/src/skill.ts +113 -0
- package/src/task-transfer.ts +946 -0
- package/src/templates.ts +67 -0
- package/src/tui-v1.tsx +341 -0
- package/src/tui.tsx +329 -0
- package/src/types.ts +226 -0
- package/src/version.ts +27 -0
- package/src/workspaces.ts +487 -0
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
import crypto from "node:crypto";
|
|
2
|
+
import fs from "node:fs/promises";
|
|
3
|
+
import path from "node:path";
|
|
4
|
+
import { execFile } from "node:child_process";
|
|
5
|
+
import { getTask, saveTask } from "../db/tasks-repo.js";
|
|
6
|
+
import { appendStructuredLog } from "./structured-log.js";
|
|
7
|
+
import { WRAPPER_DIR, sanitizeName } from "../types.js";
|
|
8
|
+
export const SESSION_MODES = ["new", "reuse", "last"];
|
|
9
|
+
const SESSION_ID_PATTERN = /^ses_[A-Za-z0-9]{10,64}$/;
|
|
10
|
+
/** Генерация id сессии в формате `ses_<26+ base36>`. */
|
|
11
|
+
export function generateSessionId() {
|
|
12
|
+
const alphabet = "abcdefghijklmnopqrstuvwxyz0123456789";
|
|
13
|
+
const bytes = crypto.randomBytes(13);
|
|
14
|
+
let suffix = "";
|
|
15
|
+
for (const byte of bytes) {
|
|
16
|
+
suffix += alphabet[byte % 36];
|
|
17
|
+
}
|
|
18
|
+
// 13 байт → 20 символов base36; добавляем 6 случайных, чтобы было ≥26.
|
|
19
|
+
const extra = crypto.randomBytes(3).toString("hex");
|
|
20
|
+
return `ses_${suffix}${extra}`;
|
|
21
|
+
}
|
|
22
|
+
/** Проверка формата id сессии. */
|
|
23
|
+
export function isValidSessionId(value) {
|
|
24
|
+
return typeof value === "string" && SESSION_ID_PATTERN.test(value);
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Нормализация режима сессии. undefined → "new".
|
|
28
|
+
* Возвращает undefined для мусора, чтобы вызывающий мог решить, падать или нет.
|
|
29
|
+
*/
|
|
30
|
+
export function normalizeSessionMode(value) {
|
|
31
|
+
if (value === undefined || value === null)
|
|
32
|
+
return "new";
|
|
33
|
+
if (value === "new" || value === "reuse" || value === "last")
|
|
34
|
+
return value;
|
|
35
|
+
return undefined;
|
|
36
|
+
}
|
|
37
|
+
/** Аргументы для `opencode run` в зависимости от режима. */
|
|
38
|
+
export function buildSessionArgs(mode, sessionId) {
|
|
39
|
+
switch (mode) {
|
|
40
|
+
case "reuse":
|
|
41
|
+
return sessionId && isValidSessionId(sessionId) ? ["--session", sessionId] : [];
|
|
42
|
+
case "last":
|
|
43
|
+
return ["--continue"];
|
|
44
|
+
default:
|
|
45
|
+
return [];
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
/** Признак того, что сессию пора ротировать после N запусков. */
|
|
49
|
+
export function shouldRotateSession(runCount, maxRuns) {
|
|
50
|
+
return maxRuns > 0 && runCount >= maxRuns;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Счётчик запусков сессии при сохранении определения задачи.
|
|
54
|
+
*
|
|
55
|
+
* Редактирование не должно обнулять прогресс к sessionMaxRuns, если сессия
|
|
56
|
+
* осталась прежней. При смене режима или id сессии счётчик начинается заново.
|
|
57
|
+
*/
|
|
58
|
+
export function preservedSessionRunCount(previous, session, sessionId) {
|
|
59
|
+
if (!previous)
|
|
60
|
+
return 0;
|
|
61
|
+
if (previous.session !== session || previous.sessionId !== sessionId)
|
|
62
|
+
return 0;
|
|
63
|
+
return previous.sessionRunCount ?? 0;
|
|
64
|
+
}
|
|
65
|
+
/** Путь к sidecar-файлу с актуальным id сессии задачи. */
|
|
66
|
+
export function sessionStatePath(taskName) {
|
|
67
|
+
return path.join(WRAPPER_DIR, `${sanitizeName(taskName)}.session`);
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* Записывает актуальный id сессии в sidecar-файл, который обёртка читает
|
|
71
|
+
* непосредственно перед запуском opencode. `undefined` удаляет файл.
|
|
72
|
+
* Никогда не бросает.
|
|
73
|
+
*/
|
|
74
|
+
export async function writeSessionStateFile(taskName, sessionId) {
|
|
75
|
+
try {
|
|
76
|
+
const file = sessionStatePath(taskName);
|
|
77
|
+
await fs.mkdir(WRAPPER_DIR, { recursive: true });
|
|
78
|
+
if (sessionId) {
|
|
79
|
+
await fs.writeFile(file, `${sessionId}\n`, "utf8");
|
|
80
|
+
}
|
|
81
|
+
else {
|
|
82
|
+
await fs.unlink(file).catch(() => undefined);
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
catch (error) {
|
|
86
|
+
console.warn(`[session] Не удалось обновить файл сессии задачи "${taskName}":`, error);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Best-effort ротация переиспользуемой сессии после завершения запуска.
|
|
91
|
+
* Удаляет сессию через opencode CLI, генерирует новый id, обновляет
|
|
92
|
+
* определение задачи и sidecar-файл обёртки. Никогда не бросает — сбой
|
|
93
|
+
* ротации не должен ломать историю запуска.
|
|
94
|
+
*/
|
|
95
|
+
export async function rotateSessionIfNeeded(taskName) {
|
|
96
|
+
try {
|
|
97
|
+
const def = await getTask(taskName);
|
|
98
|
+
if (!def || def.session !== "reuse")
|
|
99
|
+
return;
|
|
100
|
+
const maxRuns = def.sessionMaxRuns ?? 0;
|
|
101
|
+
const count = (def.sessionRunCount ?? 0) + 1;
|
|
102
|
+
if (shouldRotateSession(count, maxRuns)) {
|
|
103
|
+
const sessionId = def.sessionId;
|
|
104
|
+
if (sessionId && isValidSessionId(sessionId)) {
|
|
105
|
+
try {
|
|
106
|
+
await new Promise((resolve) => {
|
|
107
|
+
execFile("opencode", ["session", "delete", sessionId], () => resolve());
|
|
108
|
+
});
|
|
109
|
+
}
|
|
110
|
+
catch {
|
|
111
|
+
// Удаление не должно мешать: просто фиксируем в логе ниже.
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
const newSessionId = generateSessionId();
|
|
115
|
+
await saveTask({
|
|
116
|
+
...def,
|
|
117
|
+
sessionId: newSessionId,
|
|
118
|
+
sessionRunCount: 0,
|
|
119
|
+
});
|
|
120
|
+
await writeSessionStateFile(taskName, newSessionId);
|
|
121
|
+
appendStructuredLog({
|
|
122
|
+
event: "session.rotated",
|
|
123
|
+
task: taskName,
|
|
124
|
+
reason: `maxRuns=${maxRuns} достигнут; сессия удалена, создана новая, счётчик сброшен`,
|
|
125
|
+
});
|
|
126
|
+
}
|
|
127
|
+
else {
|
|
128
|
+
await saveTask({ ...def, sessionRunCount: count });
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
catch (error) {
|
|
132
|
+
console.warn(`[session] Ротация сессии задачи "${taskName}" не выполнена:`, error);
|
|
133
|
+
}
|
|
134
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Д6: ворота выгрузки плагина.
|
|
3
|
+
*
|
|
4
|
+
* Позволяют перестать принимать новые запуски и дождаться уже начатых
|
|
5
|
+
* in-process операций (запуск задачи, matrix, DAG-триггер) перед закрытием
|
|
6
|
+
* SQLite и HTTP-сервера. Внешние процессы планировщика ОС эти ворота не
|
|
7
|
+
* отслеживают: их жизненным циклом управляет сама ОС.
|
|
8
|
+
*/
|
|
9
|
+
export interface ShutdownWaitResult {
|
|
10
|
+
timedOut: boolean;
|
|
11
|
+
remaining: number;
|
|
12
|
+
}
|
|
13
|
+
export interface ShutdownGate {
|
|
14
|
+
/** true после begin(): новые запуски должны отклоняться. */
|
|
15
|
+
isShuttingDown(): boolean;
|
|
16
|
+
/** Переводит ворота в режим выгрузки. */
|
|
17
|
+
begin(): void;
|
|
18
|
+
/** Учитывает промис до его завершения (успех или ошибка). */
|
|
19
|
+
track<T>(promise: Promise<T>): Promise<T>;
|
|
20
|
+
/** Сколько операций ещё выполняется. */
|
|
21
|
+
activeCount(): number;
|
|
22
|
+
/** Ждёт завершения активных операций не дольше timeoutMs. */
|
|
23
|
+
waitForIdle(timeoutMs: number): Promise<ShutdownWaitResult>;
|
|
24
|
+
}
|
|
25
|
+
export declare function createShutdownGate(): ShutdownGate;
|
|
26
|
+
//# sourceMappingURL=shutdown.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/core/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,cAAc,IAAI,OAAO,CAAC;IAC1B,yCAAyC;IACzC,KAAK,IAAI,IAAI,CAAC;IACd,6DAA6D;IAC7D,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1C,wCAAwC;IACxC,WAAW,IAAI,MAAM,CAAC;IACtB,6DAA6D;IAC7D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC7D;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CAyCjD"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Д6: ворота выгрузки плагина.
|
|
3
|
+
*
|
|
4
|
+
* Позволяют перестать принимать новые запуски и дождаться уже начатых
|
|
5
|
+
* in-process операций (запуск задачи, matrix, DAG-триггер) перед закрытием
|
|
6
|
+
* SQLite и HTTP-сервера. Внешние процессы планировщика ОС эти ворота не
|
|
7
|
+
* отслеживают: их жизненным циклом управляет сама ОС.
|
|
8
|
+
*/
|
|
9
|
+
export function createShutdownGate() {
|
|
10
|
+
let shuttingDown = false;
|
|
11
|
+
const active = new Set();
|
|
12
|
+
return {
|
|
13
|
+
isShuttingDown: () => shuttingDown,
|
|
14
|
+
begin: () => {
|
|
15
|
+
shuttingDown = true;
|
|
16
|
+
},
|
|
17
|
+
track(promise) {
|
|
18
|
+
const tracked = promise.finally(() => {
|
|
19
|
+
active.delete(tracked);
|
|
20
|
+
});
|
|
21
|
+
active.add(tracked);
|
|
22
|
+
return tracked;
|
|
23
|
+
},
|
|
24
|
+
activeCount: () => active.size,
|
|
25
|
+
async waitForIdle(timeoutMs) {
|
|
26
|
+
if (active.size === 0) {
|
|
27
|
+
return { timedOut: false, remaining: 0 };
|
|
28
|
+
}
|
|
29
|
+
let timer;
|
|
30
|
+
const timeout = new Promise((resolve) => {
|
|
31
|
+
timer = setTimeout(() => resolve("timeout"), Math.max(0, timeoutMs));
|
|
32
|
+
});
|
|
33
|
+
try {
|
|
34
|
+
const outcome = await Promise.race([
|
|
35
|
+
Promise.allSettled(Array.from(active)).then(() => "done"),
|
|
36
|
+
timeout,
|
|
37
|
+
]);
|
|
38
|
+
return {
|
|
39
|
+
timedOut: outcome === "timeout",
|
|
40
|
+
remaining: active.size,
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
finally {
|
|
44
|
+
if (timer)
|
|
45
|
+
clearTimeout(timer);
|
|
46
|
+
}
|
|
47
|
+
},
|
|
48
|
+
};
|
|
49
|
+
}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Машиночитаемые логи запусков (Спринт 22).
|
|
3
|
+
*
|
|
4
|
+
* Формат — JSONL: одна строка = один JSON-объект. Файл лежит рядом с
|
|
5
|
+
* человекочитаемыми логами задач: `<PLUGIN_DIR>/logs/runs.jsonl`.
|
|
6
|
+
*
|
|
7
|
+
* Ротация простая: при превышении лимита текущий файл переименовывается
|
|
8
|
+
* в `runs.jsonl.1` (предыдущий `.1` перезаписывается). Этого достаточно,
|
|
9
|
+
* чтобы лог не рос бесконечно, и не требуется внешних зависимостей.
|
|
10
|
+
*
|
|
11
|
+
* Любая ошибка записи логируется в console.warn и **никогда** не ломает
|
|
12
|
+
* запуск задачи: наблюдаемость не должна влиять на планировщик.
|
|
13
|
+
*/
|
|
14
|
+
/** События структурированного лога. */
|
|
15
|
+
export type StructuredLogEvent = "run.started" | "run.finished" | "hook.received" | string;
|
|
16
|
+
export interface StructuredLogRecord {
|
|
17
|
+
/** Время записи (ISO). */
|
|
18
|
+
ts: string;
|
|
19
|
+
event: StructuredLogEvent;
|
|
20
|
+
/** id записи history (для run.*). */
|
|
21
|
+
runId?: number;
|
|
22
|
+
task?: string;
|
|
23
|
+
status?: string;
|
|
24
|
+
startedAt?: string;
|
|
25
|
+
finishedAt?: string | null;
|
|
26
|
+
durationMs?: number | null;
|
|
27
|
+
error?: string | null;
|
|
28
|
+
nextTask?: string | null;
|
|
29
|
+
tokens?: number;
|
|
30
|
+
costUsd?: number;
|
|
31
|
+
model?: string;
|
|
32
|
+
workspaceId?: string | null;
|
|
33
|
+
preFlightStatus?: string;
|
|
34
|
+
postFlightStatus?: string;
|
|
35
|
+
/** Источник события: schedule, dashboard, hook, cli, mcp и т.п. */
|
|
36
|
+
source?: string;
|
|
37
|
+
/** HTTP-статус ответа на hook.received. */
|
|
38
|
+
httpStatus?: number;
|
|
39
|
+
/** Адрес отправителя хука (без порта). */
|
|
40
|
+
remote?: string | null;
|
|
41
|
+
/** Размер тела хука в байтах. */
|
|
42
|
+
payloadBytes?: number;
|
|
43
|
+
/** Причина отказа/пропуска. */
|
|
44
|
+
reason?: string;
|
|
45
|
+
}
|
|
46
|
+
export interface ReadStructuredLogsFilter {
|
|
47
|
+
task?: string;
|
|
48
|
+
status?: string;
|
|
49
|
+
event?: string;
|
|
50
|
+
/** ISO-время: записи не раньше. */
|
|
51
|
+
since?: string;
|
|
52
|
+
/** ISO-время: записи не позже. */
|
|
53
|
+
until?: string;
|
|
54
|
+
limit?: number;
|
|
55
|
+
}
|
|
56
|
+
export interface ReadStructuredLogsResult {
|
|
57
|
+
records: StructuredLogRecord[];
|
|
58
|
+
/** Сколько всего записей подошло под фильтр (до применения limit). */
|
|
59
|
+
total: number;
|
|
60
|
+
/** Сколько строк не удалось разобрать как JSON. */
|
|
61
|
+
malformed: number;
|
|
62
|
+
file: string;
|
|
63
|
+
}
|
|
64
|
+
/** Текущий файл и его архив после ротации. */
|
|
65
|
+
export declare const STRUCTURED_LOG_FILE: string;
|
|
66
|
+
export declare const STRUCTURED_LOG_ARCHIVE: string;
|
|
67
|
+
export declare const STRUCTURED_LOG_MAX_BYTES: number;
|
|
68
|
+
/**
|
|
69
|
+
* Добавляет запись в JSONL-лог. Возвращает true при успешной записи.
|
|
70
|
+
* Не бросает исключений.
|
|
71
|
+
*/
|
|
72
|
+
export declare function appendStructuredLog(record: Omit<StructuredLogRecord, "ts"> & {
|
|
73
|
+
ts?: string;
|
|
74
|
+
}): boolean;
|
|
75
|
+
/**
|
|
76
|
+
* Читает JSONL-лог (текущий + архив), фильтрует и сортирует новые сверху.
|
|
77
|
+
*
|
|
78
|
+
* `limit` по умолчанию 200, максимум 5000 — как у HTTP-эндпоинта.
|
|
79
|
+
* `total` считается до применения limit, чтобы клиент знал полный объём.
|
|
80
|
+
*/
|
|
81
|
+
export declare function readStructuredLogs(filter?: ReadStructuredLogsFilter): ReadStructuredLogsResult;
|
|
82
|
+
/** Удаляет JSONL-логи (для тестов и обслуживания). */
|
|
83
|
+
export declare function clearStructuredLogs(): void;
|
|
84
|
+
//# sourceMappingURL=structured-log.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"structured-log.d.ts","sourceRoot":"","sources":["../../src/core/structured-log.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AAEH,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;AAE3F,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,kBAAkB,CAAC;IAC1B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,QAAmC,CAAC;AACpE,eAAO,MAAM,sBAAsB,QAA6B,CAAC;AACjE,eAAO,MAAM,wBAAwB,QAAmB,CAAC;AAiCzD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,OAAO,CAsBT;AAcD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,GAAE,wBAA6B,GACpC,wBAAwB,CA4C1B;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}
|
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
import fs from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { LOG_DIR } from "../types.js";
|
|
4
|
+
import { redactSecretsInText } from "./secrets.js";
|
|
5
|
+
/** Текущий файл и его архив после ротации. */
|
|
6
|
+
export const STRUCTURED_LOG_FILE = path.join(LOG_DIR, "runs.jsonl");
|
|
7
|
+
export const STRUCTURED_LOG_ARCHIVE = `${STRUCTURED_LOG_FILE}.1`;
|
|
8
|
+
export const STRUCTURED_LOG_MAX_BYTES = 10 * 1024 * 1024;
|
|
9
|
+
function warn(message, err) {
|
|
10
|
+
try {
|
|
11
|
+
console.warn(`[structured-log] ${message}: ${err instanceof Error ? err.message : String(err)}`);
|
|
12
|
+
}
|
|
13
|
+
catch {
|
|
14
|
+
// console может быть недоступен в урезанном окружении — молча игнорируем.
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
function ensureLogDir() {
|
|
18
|
+
fs.mkdirSync(LOG_DIR, { recursive: true });
|
|
19
|
+
}
|
|
20
|
+
/** Ротирует лог, если он превысил лимит. Вызывается перед append. */
|
|
21
|
+
function rotateIfNeeded() {
|
|
22
|
+
try {
|
|
23
|
+
const stat = fs.statSync(STRUCTURED_LOG_FILE);
|
|
24
|
+
if (stat.size < STRUCTURED_LOG_MAX_BYTES)
|
|
25
|
+
return;
|
|
26
|
+
try {
|
|
27
|
+
fs.rmSync(STRUCTURED_LOG_ARCHIVE, { force: true });
|
|
28
|
+
}
|
|
29
|
+
catch {
|
|
30
|
+
// Нет старого архива — не страшно.
|
|
31
|
+
}
|
|
32
|
+
fs.renameSync(STRUCTURED_LOG_FILE, STRUCTURED_LOG_ARCHIVE);
|
|
33
|
+
}
|
|
34
|
+
catch (err) {
|
|
35
|
+
// ENOENT — файла ещё нет, это нормально.
|
|
36
|
+
if (err?.code !== "ENOENT")
|
|
37
|
+
warn("не удалось ротировать лог", err);
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Добавляет запись в JSONL-лог. Возвращает true при успешной записи.
|
|
42
|
+
* Не бросает исключений.
|
|
43
|
+
*/
|
|
44
|
+
export function appendStructuredLog(record) {
|
|
45
|
+
try {
|
|
46
|
+
ensureLogDir();
|
|
47
|
+
rotateIfNeeded();
|
|
48
|
+
const payload = {
|
|
49
|
+
...record,
|
|
50
|
+
ts: record.ts ?? new Date().toISOString(),
|
|
51
|
+
};
|
|
52
|
+
// Спринт 26: даже если ошибка пришла из внешнего процесса, известные
|
|
53
|
+
// значения секретов и присваивания TOKEN=/password: вырезаются.
|
|
54
|
+
if (typeof payload.error === "string") {
|
|
55
|
+
payload.error = redactSecretsInText(payload.error);
|
|
56
|
+
}
|
|
57
|
+
if (typeof payload.reason === "string") {
|
|
58
|
+
payload.reason = redactSecretsInText(payload.reason);
|
|
59
|
+
}
|
|
60
|
+
fs.appendFileSync(STRUCTURED_LOG_FILE, `${JSON.stringify(payload)}\n`, "utf8");
|
|
61
|
+
return true;
|
|
62
|
+
}
|
|
63
|
+
catch (err) {
|
|
64
|
+
warn("не удалось записать событие", err);
|
|
65
|
+
return false;
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
function readLines(file) {
|
|
69
|
+
try {
|
|
70
|
+
return fs
|
|
71
|
+
.readFileSync(file, "utf8")
|
|
72
|
+
.split(/\r?\n/)
|
|
73
|
+
.filter((line) => line.trim().length > 0);
|
|
74
|
+
}
|
|
75
|
+
catch (err) {
|
|
76
|
+
if (err?.code !== "ENOENT")
|
|
77
|
+
warn(`не удалось прочитать ${file}`, err);
|
|
78
|
+
return [];
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Читает JSONL-лог (текущий + архив), фильтрует и сортирует новые сверху.
|
|
83
|
+
*
|
|
84
|
+
* `limit` по умолчанию 200, максимум 5000 — как у HTTP-эндпоинта.
|
|
85
|
+
* `total` считается до применения limit, чтобы клиент знал полный объём.
|
|
86
|
+
*/
|
|
87
|
+
export function readStructuredLogs(filter = {}) {
|
|
88
|
+
const limit = Math.max(1, Math.min(5000, Math.floor(filter.limit ?? 200) || 200));
|
|
89
|
+
const task = filter.task?.trim().toLowerCase();
|
|
90
|
+
const status = filter.status?.trim().toLowerCase();
|
|
91
|
+
const event = filter.event?.trim().toLowerCase();
|
|
92
|
+
const since = filter.since?.trim();
|
|
93
|
+
const until = filter.until?.trim();
|
|
94
|
+
const records = [];
|
|
95
|
+
let malformed = 0;
|
|
96
|
+
// Архив старше текущего файла; порядок не важен, ниже сортируем по ts.
|
|
97
|
+
for (const file of [STRUCTURED_LOG_ARCHIVE, STRUCTURED_LOG_FILE]) {
|
|
98
|
+
for (const line of readLines(file)) {
|
|
99
|
+
let parsed;
|
|
100
|
+
try {
|
|
101
|
+
parsed = JSON.parse(line);
|
|
102
|
+
}
|
|
103
|
+
catch {
|
|
104
|
+
malformed += 1;
|
|
105
|
+
continue;
|
|
106
|
+
}
|
|
107
|
+
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
|
|
108
|
+
malformed += 1;
|
|
109
|
+
continue;
|
|
110
|
+
}
|
|
111
|
+
if (typeof parsed.ts !== "string")
|
|
112
|
+
parsed.ts = "";
|
|
113
|
+
if (typeof parsed.event !== "string")
|
|
114
|
+
parsed.event = "";
|
|
115
|
+
if (task && String(parsed.task ?? "").toLowerCase() !== task)
|
|
116
|
+
continue;
|
|
117
|
+
if (status && String(parsed.status ?? "").toLowerCase() !== status)
|
|
118
|
+
continue;
|
|
119
|
+
if (event && String(parsed.event).toLowerCase() !== event)
|
|
120
|
+
continue;
|
|
121
|
+
if (since && String(parsed.ts) < since)
|
|
122
|
+
continue;
|
|
123
|
+
if (until && String(parsed.ts) > until)
|
|
124
|
+
continue;
|
|
125
|
+
records.push(parsed);
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
const total = records.length;
|
|
129
|
+
records.sort((a, b) => String(b.ts).localeCompare(String(a.ts)));
|
|
130
|
+
return {
|
|
131
|
+
records: records.slice(0, limit),
|
|
132
|
+
total,
|
|
133
|
+
malformed,
|
|
134
|
+
file: STRUCTURED_LOG_FILE,
|
|
135
|
+
};
|
|
136
|
+
}
|
|
137
|
+
/** Удаляет JSONL-логи (для тестов и обслуживания). */
|
|
138
|
+
export function clearStructuredLogs() {
|
|
139
|
+
try {
|
|
140
|
+
fs.rmSync(STRUCTURED_LOG_FILE, { force: true });
|
|
141
|
+
fs.rmSync(STRUCTURED_LOG_ARCHIVE, { force: true });
|
|
142
|
+
}
|
|
143
|
+
catch (err) {
|
|
144
|
+
warn("не удалось очистить лог", err);
|
|
145
|
+
}
|
|
146
|
+
}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Саммари уведомления (Спринт 31.3).
|
|
3
|
+
*
|
|
4
|
+
* Модель возвращает строгий JSON из 1–3 коротких строк для Telegram и тостов.
|
|
5
|
+
* Любой сбой (нет модели, таймаут, битый JSON, неверная схема) переводит на
|
|
6
|
+
* детерминированное усечение: уведомление не блокируется и не теряется.
|
|
7
|
+
*/
|
|
8
|
+
import type { NotificationSummarySettings, TriageSettings } from "../settings.js";
|
|
9
|
+
/** Входные данные саммари — то, что реально есть у уведомления. */
|
|
10
|
+
export interface SummaryInput {
|
|
11
|
+
taskName: string;
|
|
12
|
+
status: string;
|
|
13
|
+
error?: string;
|
|
14
|
+
durationMs?: number;
|
|
15
|
+
tokens?: number;
|
|
16
|
+
costUsd?: number;
|
|
17
|
+
}
|
|
18
|
+
/** Результат саммари: строки и признак, откуда они взялись. */
|
|
19
|
+
export interface SummaryResult {
|
|
20
|
+
ok: boolean;
|
|
21
|
+
/** 1–3 строки, уже обрезанные по maxCharsPerLine. */
|
|
22
|
+
lines: string[];
|
|
23
|
+
/** model — ответила модель; fallback — детерминированное усечение. */
|
|
24
|
+
source: "model" | "fallback";
|
|
25
|
+
/** Причина отказа модели, если source === "fallback". */
|
|
26
|
+
failure?: string;
|
|
27
|
+
latencyMs: number;
|
|
28
|
+
model?: string;
|
|
29
|
+
protocol?: "ollama" | "openai";
|
|
30
|
+
}
|
|
31
|
+
/** JSON-схема ответа модели: только массив строк 1..3, каждая 1..120 символов. */
|
|
32
|
+
export declare const SUMMARY_SCHEMA: {
|
|
33
|
+
readonly type: "object";
|
|
34
|
+
readonly additionalProperties: false;
|
|
35
|
+
readonly required: readonly ["lines"];
|
|
36
|
+
readonly properties: {
|
|
37
|
+
readonly lines: {
|
|
38
|
+
readonly type: "array";
|
|
39
|
+
readonly minItems: 1;
|
|
40
|
+
readonly maxItems: 3;
|
|
41
|
+
readonly items: {
|
|
42
|
+
readonly type: "string";
|
|
43
|
+
readonly minLength: 1;
|
|
44
|
+
readonly maxLength: 120;
|
|
45
|
+
};
|
|
46
|
+
};
|
|
47
|
+
};
|
|
48
|
+
};
|
|
49
|
+
/**
|
|
50
|
+
* Детерминированное саммари без модели: те же три строки, но усечением.
|
|
51
|
+
* Всегда возвращает 1–3 непустые строки.
|
|
52
|
+
*/
|
|
53
|
+
export declare function truncateSummary(input: SummaryInput, maxLines: number, maxChars: number): string[];
|
|
54
|
+
/** Провайдер саммари берётся из настроек триажа; таймаут — из настроек саммари. */
|
|
55
|
+
export interface SummaryProvider {
|
|
56
|
+
baseUrl?: string;
|
|
57
|
+
model?: string;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Просит модель собрать 1–3 строки. Никогда не бросает и не блокирует
|
|
61
|
+
* дольше `options.timeoutMs` (по умолчанию 8000 мс): при любой ошибке
|
|
62
|
+
* возвращает детерминированное усечение.
|
|
63
|
+
*/
|
|
64
|
+
export declare function summarizeNotification(input: SummaryInput, settings: NotificationSummarySettings, provider: SummaryProvider, options?: {
|
|
65
|
+
timeoutMs?: number;
|
|
66
|
+
}): Promise<SummaryResult>;
|
|
67
|
+
/** Провайдер из настроек триажа: baseUrl/model используются те же. */
|
|
68
|
+
export declare function summaryProviderFromTriage(triage: TriageSettings | undefined): SummaryProvider;
|
|
69
|
+
//# sourceMappingURL=summary.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/core/summary.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,2BAA2B,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAElF,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,qDAAqD;IACrD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,sEAAsE;IACtE,MAAM,EAAE,OAAO,GAAG,UAAU,CAAC;IAC7B,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAChC;AAED,kFAAkF;AAClF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;CAYjB,CAAC;AAkIX;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,CAmBV;AAED,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,2BAA2B,EACrC,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,OAAO,CAAC,aAAa,CAAC,CAyFxB;AAED,sEAAsE;AACtE,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,cAAc,GAAG,SAAS,GACjC,eAAe,CAEjB"}
|