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,72 @@
|
|
|
1
|
+
import type http from "node:http";
|
|
2
|
+
import type { HookSettings } from "./settings.js";
|
|
3
|
+
type HeaderMap = Record<string, string | string[] | undefined>;
|
|
4
|
+
/** Сравнение строк без утечки длины через раннее завершение. */
|
|
5
|
+
export declare function timingSafeStringEqual(expected: string, provided: string): boolean;
|
|
6
|
+
/** Проверяет токен из query-параметра или заголовка. */
|
|
7
|
+
export declare function verifyHookToken(expected: string, provided: string | null): boolean;
|
|
8
|
+
/** Считает HMAC-SHA256 по сырому телу и возвращает значение в формате `sha256=<hex>`. */
|
|
9
|
+
export declare function signHookPayload(secret: string, body: Buffer | string): string;
|
|
10
|
+
/**
|
|
11
|
+
* HMAC с привязкой к timestamp: подписывается `<timestamp>.<сырое тело>`.
|
|
12
|
+
* Используется, когда защита от replay включена (toleranceSeconds > 0).
|
|
13
|
+
*/
|
|
14
|
+
export declare function signHookPayloadWithTimestamp(secret: string, timestamp: string, body: Buffer | string): string;
|
|
15
|
+
/** Достаёт подпись из поддерживаемых заголовков. */
|
|
16
|
+
export declare function extractHookSignature(headers: HeaderMap): string | null;
|
|
17
|
+
/** Достаёт токен из поддерживаемых заголовков (если нет query-параметра). */
|
|
18
|
+
export declare function extractHookToken(headers: HeaderMap): string | null;
|
|
19
|
+
/**
|
|
20
|
+
* Проверяет HMAC-подпись. Принимает `sha256=<hex>` и «голый» hex;
|
|
21
|
+
* алгоритмы кроме SHA-256 намеренно не поддерживаются.
|
|
22
|
+
*
|
|
23
|
+
* Если передан timestamp, подпись проверяется по схеме `<timestamp>.<body>`
|
|
24
|
+
* (защита от replay). Без timestamp — legacy-подпись по одному телу.
|
|
25
|
+
*/
|
|
26
|
+
export declare function verifyHookSignature(secret: string, body: Buffer | string, signature: string | null, timestamp?: string | null): boolean;
|
|
27
|
+
/**
|
|
28
|
+
* Проверяет необязательный timestamp против текущего времени.
|
|
29
|
+
* 0 в настройках — проверка выключена. Без заголовка запрос разрешён.
|
|
30
|
+
*/
|
|
31
|
+
export declare function verifyHookTimestamp(value: string | null, toleranceSeconds: number, nowMs?: number): {
|
|
32
|
+
ok: boolean;
|
|
33
|
+
reason?: string;
|
|
34
|
+
};
|
|
35
|
+
export interface HookAuthInput {
|
|
36
|
+
settings: HookSettings;
|
|
37
|
+
token: string | null;
|
|
38
|
+
signature: string | null;
|
|
39
|
+
timestamp: string | null;
|
|
40
|
+
/** Сырое тело запроса — ровно те байты, по которым считался HMAC. */
|
|
41
|
+
body: Buffer;
|
|
42
|
+
/** Текущее время (для тестов). */
|
|
43
|
+
nowMs?: number;
|
|
44
|
+
}
|
|
45
|
+
export interface HookAuthResult {
|
|
46
|
+
ok: boolean;
|
|
47
|
+
/** HTTP-статус для отказа (200 при успехе). */
|
|
48
|
+
status: number;
|
|
49
|
+
error?: string;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Полная проверка входящего хука: включён ли канал, токен, HMAC, timestamp.
|
|
53
|
+
* Возвращает понятную ошибку на русском для ответа и логов.
|
|
54
|
+
*/
|
|
55
|
+
export declare function authenticateHookRequest(input: HookAuthInput): HookAuthResult;
|
|
56
|
+
export type BodyReadResult = {
|
|
57
|
+
ok: true;
|
|
58
|
+
body: Buffer;
|
|
59
|
+
} | {
|
|
60
|
+
ok: false;
|
|
61
|
+
status: number;
|
|
62
|
+
error: string;
|
|
63
|
+
};
|
|
64
|
+
/**
|
|
65
|
+
* Читает тело запроса с ограничением размера.
|
|
66
|
+
*
|
|
67
|
+
* Лишние байты не накапливаются в памяти: после превышения лимита поток
|
|
68
|
+
* дочитывается и отбрасывается, чтобы клиент получил внятный 413, а не reset.
|
|
69
|
+
*/
|
|
70
|
+
export declare function readRequestBody(req: http.IncomingMessage, maxBytes: number): Promise<BodyReadResult>;
|
|
71
|
+
export {};
|
|
72
|
+
//# sourceMappingURL=integrations.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../src/integrations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAiClD,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAQ/D,gEAAgE;AAChE,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOjF;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAElF;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAI7E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GAAG,MAAM,GACpB,MAAM,CAIR;AAED,oDAAoD;AACpD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAMtE;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAMlE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,OAAO,CAYT;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,gBAAgB,EAAE,MAAM,EACxB,KAAK,SAAa,GACjB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAoBlC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CA6D5E;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CA6CzB"}
|
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
import crypto from "node:crypto";
|
|
2
|
+
/**
|
|
3
|
+
* Входящие webhook-триггеры (Спринт 22).
|
|
4
|
+
*
|
|
5
|
+
* Контракт:
|
|
6
|
+
* POST /api/hooks/<task>?token=<token>
|
|
7
|
+
* X-Scheduler-Signature: sha256=<hex hmac>
|
|
8
|
+
* X-Scheduler-Timestamp: <unix seconds|milliseconds>
|
|
9
|
+
*
|
|
10
|
+
* При включённой подписи и ненулевом timestampToleranceSeconds заголовок
|
|
11
|
+
* X-Scheduler-Timestamp обязателен и входит в HMAC: подписывается строка
|
|
12
|
+
* `<timestamp>.<сырое тело>`. Так перехваченный запрос нельзя переиграть,
|
|
13
|
+
* подставив свежий timestamp. При toleranceSeconds = 0 (проверка времени
|
|
14
|
+
* отключена явно) подпись считается по одному телу — legacy-режим.
|
|
15
|
+
*
|
|
16
|
+
* Для совместимости с GitHub Actions принимается также `X-Hub-Signature-256`,
|
|
17
|
+
* для GitLab — `X-Gitlab-Token` вместо query-параметра.
|
|
18
|
+
*
|
|
19
|
+
* HMAC считается по **сырому телу** запроса (без нормализации JSON), поэтому
|
|
20
|
+
* отправитель должен подписывать ровно те байты, которые кладёт в body.
|
|
21
|
+
*/
|
|
22
|
+
/** Заголовки, в которых может прийти HMAC-подпись. */
|
|
23
|
+
const SIGNATURE_HEADERS = [
|
|
24
|
+
"x-scheduler-signature",
|
|
25
|
+
"x-hub-signature-256",
|
|
26
|
+
"x-signature-256",
|
|
27
|
+
];
|
|
28
|
+
/** Заголовки, в которых может прийти токен (альтернатива query-параметру). */
|
|
29
|
+
const TOKEN_HEADERS = ["x-scheduler-token", "x-gitlab-token"];
|
|
30
|
+
/** Первое значение заголовка (Node может вернуть массив). */
|
|
31
|
+
function firstHeader(value) {
|
|
32
|
+
if (Array.isArray(value))
|
|
33
|
+
return value.length > 0 ? String(value[0]) : null;
|
|
34
|
+
return typeof value === "string" && value.trim() ? value.trim() : null;
|
|
35
|
+
}
|
|
36
|
+
/** Сравнение строк без утечки длины через раннее завершение. */
|
|
37
|
+
export function timingSafeStringEqual(expected, provided) {
|
|
38
|
+
if (typeof expected !== "string" || typeof provided !== "string")
|
|
39
|
+
return false;
|
|
40
|
+
if (!expected || !provided)
|
|
41
|
+
return false;
|
|
42
|
+
const expectedHash = crypto.createHash("sha256").update(expected, "utf8").digest();
|
|
43
|
+
const providedHash = crypto.createHash("sha256").update(provided, "utf8").digest();
|
|
44
|
+
const equal = crypto.timingSafeEqual(expectedHash, providedHash);
|
|
45
|
+
return equal && expected.length === provided.length;
|
|
46
|
+
}
|
|
47
|
+
/** Проверяет токен из query-параметра или заголовка. */
|
|
48
|
+
export function verifyHookToken(expected, provided) {
|
|
49
|
+
return typeof provided === "string" && timingSafeStringEqual(expected, provided);
|
|
50
|
+
}
|
|
51
|
+
/** Считает HMAC-SHA256 по сырому телу и возвращает значение в формате `sha256=<hex>`. */
|
|
52
|
+
export function signHookPayload(secret, body) {
|
|
53
|
+
const payload = Buffer.isBuffer(body) ? body : Buffer.from(body, "utf8");
|
|
54
|
+
const digest = crypto.createHmac("sha256", secret).update(payload).digest("hex");
|
|
55
|
+
return `sha256=${digest}`;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* HMAC с привязкой к timestamp: подписывается `<timestamp>.<сырое тело>`.
|
|
59
|
+
* Используется, когда защита от replay включена (toleranceSeconds > 0).
|
|
60
|
+
*/
|
|
61
|
+
export function signHookPayloadWithTimestamp(secret, timestamp, body) {
|
|
62
|
+
const payload = Buffer.isBuffer(body) ? body : Buffer.from(body, "utf8");
|
|
63
|
+
const prefixed = Buffer.concat([Buffer.from(`${timestamp}.`, "utf8"), payload]);
|
|
64
|
+
return signHookPayload(secret, prefixed);
|
|
65
|
+
}
|
|
66
|
+
/** Достаёт подпись из поддерживаемых заголовков. */
|
|
67
|
+
export function extractHookSignature(headers) {
|
|
68
|
+
for (const name of SIGNATURE_HEADERS) {
|
|
69
|
+
const value = firstHeader(headers[name]);
|
|
70
|
+
if (value)
|
|
71
|
+
return value;
|
|
72
|
+
}
|
|
73
|
+
return null;
|
|
74
|
+
}
|
|
75
|
+
/** Достаёт токен из поддерживаемых заголовков (если нет query-параметра). */
|
|
76
|
+
export function extractHookToken(headers) {
|
|
77
|
+
for (const name of TOKEN_HEADERS) {
|
|
78
|
+
const value = firstHeader(headers[name]);
|
|
79
|
+
if (value)
|
|
80
|
+
return value;
|
|
81
|
+
}
|
|
82
|
+
return null;
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* Проверяет HMAC-подпись. Принимает `sha256=<hex>` и «голый» hex;
|
|
86
|
+
* алгоритмы кроме SHA-256 намеренно не поддерживаются.
|
|
87
|
+
*
|
|
88
|
+
* Если передан timestamp, подпись проверяется по схеме `<timestamp>.<body>`
|
|
89
|
+
* (защита от replay). Без timestamp — legacy-подпись по одному телу.
|
|
90
|
+
*/
|
|
91
|
+
export function verifyHookSignature(secret, body, signature, timestamp) {
|
|
92
|
+
if (!secret || !signature)
|
|
93
|
+
return false;
|
|
94
|
+
const normalized = signature.trim();
|
|
95
|
+
if (!/^sha256=/i.test(normalized) && !/^[a-f0-9]{64}$/i.test(normalized)) {
|
|
96
|
+
return false;
|
|
97
|
+
}
|
|
98
|
+
const provided = normalized.replace(/^sha256=/i, "").trim().toLowerCase();
|
|
99
|
+
if (!/^[a-f0-9]{64}$/.test(provided))
|
|
100
|
+
return false;
|
|
101
|
+
const expected = (timestamp ? signHookPayloadWithTimestamp(secret, timestamp, body) : signHookPayload(secret, body)).replace(/^sha256=/, "");
|
|
102
|
+
return timingSafeStringEqual(expected, provided);
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
* Проверяет необязательный timestamp против текущего времени.
|
|
106
|
+
* 0 в настройках — проверка выключена. Без заголовка запрос разрешён.
|
|
107
|
+
*/
|
|
108
|
+
export function verifyHookTimestamp(value, toleranceSeconds, nowMs = Date.now()) {
|
|
109
|
+
if (!value || toleranceSeconds <= 0)
|
|
110
|
+
return { ok: true };
|
|
111
|
+
const trimmed = value.trim();
|
|
112
|
+
if (!/^\d+$/.test(trimmed)) {
|
|
113
|
+
return { ok: false, reason: "Некорректный X-Scheduler-Timestamp." };
|
|
114
|
+
}
|
|
115
|
+
const numeric = Number(trimmed);
|
|
116
|
+
if (!Number.isFinite(numeric)) {
|
|
117
|
+
return { ok: false, reason: "Некорректный X-Scheduler-Timestamp." };
|
|
118
|
+
}
|
|
119
|
+
// Значения больше 1e12 трактуем как миллисекунды, иначе — как секунды.
|
|
120
|
+
const timestampMs = numeric > 1e12 ? numeric : numeric * 1000;
|
|
121
|
+
const skewMs = Math.abs(nowMs - timestampMs);
|
|
122
|
+
if (skewMs > toleranceSeconds * 1000) {
|
|
123
|
+
return {
|
|
124
|
+
ok: false,
|
|
125
|
+
reason: `Timestamp вне допустимого окна (±${toleranceSeconds} с).`,
|
|
126
|
+
};
|
|
127
|
+
}
|
|
128
|
+
return { ok: true };
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* Полная проверка входящего хука: включён ли канал, токен, HMAC, timestamp.
|
|
132
|
+
* Возвращает понятную ошибку на русском для ответа и логов.
|
|
133
|
+
*/
|
|
134
|
+
export function authenticateHookRequest(input) {
|
|
135
|
+
const { settings } = input;
|
|
136
|
+
if (!settings.enabled) {
|
|
137
|
+
return { ok: false, status: 403, error: "Входящие webhook-триггеры отключены." };
|
|
138
|
+
}
|
|
139
|
+
if (!settings.token) {
|
|
140
|
+
return {
|
|
141
|
+
ok: false,
|
|
142
|
+
status: 403,
|
|
143
|
+
error: "В настройках не задан token для входящих хуков.",
|
|
144
|
+
};
|
|
145
|
+
}
|
|
146
|
+
if (!verifyHookToken(settings.token, input.token)) {
|
|
147
|
+
return { ok: false, status: 401, error: "Неверный token." };
|
|
148
|
+
}
|
|
149
|
+
const timestampValue = input.timestamp?.trim() || null;
|
|
150
|
+
// Защита от replay включается только вместе с подписью и ненулевым окном.
|
|
151
|
+
const needsSignedTimestamp = settings.requireSignature && settings.timestampToleranceSeconds > 0;
|
|
152
|
+
if (settings.requireSignature) {
|
|
153
|
+
if (!settings.secret) {
|
|
154
|
+
return {
|
|
155
|
+
ok: false,
|
|
156
|
+
status: 403,
|
|
157
|
+
error: "В настройках не задан secret для HMAC-подписи.",
|
|
158
|
+
};
|
|
159
|
+
}
|
|
160
|
+
if (!input.signature) {
|
|
161
|
+
return {
|
|
162
|
+
ok: false,
|
|
163
|
+
status: 401,
|
|
164
|
+
error: "Не передана HMAC-подпись (X-Scheduler-Signature).",
|
|
165
|
+
};
|
|
166
|
+
}
|
|
167
|
+
if (needsSignedTimestamp && !timestampValue) {
|
|
168
|
+
return {
|
|
169
|
+
ok: false,
|
|
170
|
+
status: 401,
|
|
171
|
+
error: "Не передан X-Scheduler-Timestamp: при включённой подписи он обязателен.",
|
|
172
|
+
};
|
|
173
|
+
}
|
|
174
|
+
if (!verifyHookSignature(settings.secret, input.body, input.signature, needsSignedTimestamp ? timestampValue : null)) {
|
|
175
|
+
return { ok: false, status: 401, error: "Неверная HMAC-подпись." };
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
const timestamp = verifyHookTimestamp(timestampValue, settings.timestampToleranceSeconds, input.nowMs);
|
|
179
|
+
if (!timestamp.ok) {
|
|
180
|
+
return { ok: false, status: 401, error: timestamp.reason };
|
|
181
|
+
}
|
|
182
|
+
return { ok: true, status: 200 };
|
|
183
|
+
}
|
|
184
|
+
/**
|
|
185
|
+
* Читает тело запроса с ограничением размера.
|
|
186
|
+
*
|
|
187
|
+
* Лишние байты не накапливаются в памяти: после превышения лимита поток
|
|
188
|
+
* дочитывается и отбрасывается, чтобы клиент получил внятный 413, а не reset.
|
|
189
|
+
*/
|
|
190
|
+
export function readRequestBody(req, maxBytes) {
|
|
191
|
+
return new Promise((resolve) => {
|
|
192
|
+
const limit = Math.max(1, Math.floor(maxBytes) || 1);
|
|
193
|
+
let size = 0;
|
|
194
|
+
let tooLarge = false;
|
|
195
|
+
let settled = false;
|
|
196
|
+
const chunks = [];
|
|
197
|
+
const finish = (result) => {
|
|
198
|
+
if (settled)
|
|
199
|
+
return;
|
|
200
|
+
settled = true;
|
|
201
|
+
resolve(result);
|
|
202
|
+
};
|
|
203
|
+
req.on("data", (chunk) => {
|
|
204
|
+
size += chunk.length;
|
|
205
|
+
if (tooLarge)
|
|
206
|
+
return;
|
|
207
|
+
if (size > limit) {
|
|
208
|
+
tooLarge = true;
|
|
209
|
+
chunks.length = 0;
|
|
210
|
+
return;
|
|
211
|
+
}
|
|
212
|
+
chunks.push(chunk);
|
|
213
|
+
});
|
|
214
|
+
req.on("end", () => {
|
|
215
|
+
if (tooLarge) {
|
|
216
|
+
finish({
|
|
217
|
+
ok: false,
|
|
218
|
+
status: 413,
|
|
219
|
+
error: `Тело запроса больше ${limit} байт.`,
|
|
220
|
+
});
|
|
221
|
+
return;
|
|
222
|
+
}
|
|
223
|
+
finish({ ok: true, body: Buffer.concat(chunks) });
|
|
224
|
+
});
|
|
225
|
+
req.on("error", (err) => {
|
|
226
|
+
finish({
|
|
227
|
+
ok: false,
|
|
228
|
+
status: 400,
|
|
229
|
+
error: `Не удалось прочитать тело запроса: ${err instanceof Error ? err.message : String(err)}`,
|
|
230
|
+
});
|
|
231
|
+
});
|
|
232
|
+
});
|
|
233
|
+
}
|
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
import { type DigestFrequency, type DigestSettings, type NotificationFilters, type NotificationTemplates, type TriageSettings } from "./settings.js";
|
|
2
|
+
import { type AnalyticsRecord, type ErrorAnalyticsRow } from "./core/analytics.js";
|
|
3
|
+
import type { TriageInput } from "./core/triage.js";
|
|
4
|
+
/** Статус завершения задачи, который приходит из record-history. */
|
|
5
|
+
export type NotificationStatus = "success" | "error" | "timeout" | string;
|
|
6
|
+
/** Содержимое уведомления. */
|
|
7
|
+
export interface NotificationPayload {
|
|
8
|
+
taskName: string;
|
|
9
|
+
status: NotificationStatus;
|
|
10
|
+
durationMs: number;
|
|
11
|
+
error?: string | null;
|
|
12
|
+
/** Потраченные токены, если известны. */
|
|
13
|
+
tokens?: number | null;
|
|
14
|
+
/** Стоимость запуска в USD, если известна. */
|
|
15
|
+
costUsd?: number | null;
|
|
16
|
+
}
|
|
17
|
+
/** Настройки асинхронного триажа (Спринт 31.7). */
|
|
18
|
+
export interface NotifyTaskOptions {
|
|
19
|
+
/**
|
|
20
|
+
* Для `llm`/`auto`: доставить уведомление сразу, а вердикт посчитать
|
|
21
|
+
* в отдельном процессе. Тесты и прямые вызовы без опции сохраняют
|
|
22
|
+
* синхронное поведение.
|
|
23
|
+
*/
|
|
24
|
+
asyncTriage?: boolean;
|
|
25
|
+
/** Для тестов: подменить запуск фонового процесса. */
|
|
26
|
+
scheduleTriage?: (input: TriageInput, triage: TriageSettings) => unknown;
|
|
27
|
+
}
|
|
28
|
+
/** Человекочитаемая длительность: 2300 мс → «2.3s». */
|
|
29
|
+
export declare function formatDuration(durationMs: number): string;
|
|
30
|
+
/**
|
|
31
|
+
* Сопоставление имени задачи с шаблоном: `*` — любая последовательность,
|
|
32
|
+
* регистр не важен. `regen-*` покрывает `regen-api`, `regen-ui`.
|
|
33
|
+
*/
|
|
34
|
+
export declare function wildcardMatch(pattern: string, value: string): boolean;
|
|
35
|
+
/** Проверяет, разрешена ли задача фильтрами include/exclude. */
|
|
36
|
+
export declare function isTaskAllowed(taskName: string, filters?: NotificationFilters): boolean;
|
|
37
|
+
/** Подставляет {key} в шаблон; неизвестные плейсхолдеры остаются как есть. */
|
|
38
|
+
export declare function renderTemplate(template: string, vars: Record<string, string>): string;
|
|
39
|
+
/**
|
|
40
|
+
* Формат сообщения по умолчанию:
|
|
41
|
+
* ✅ Задача "Тест" выполнена (2.3s)
|
|
42
|
+
* ❌ Задача "Тест" упала (2.3s): Quality Gate провален
|
|
43
|
+
*/
|
|
44
|
+
export declare function formatNotificationMessage(payload: NotificationPayload, templates?: NotificationTemplates): string;
|
|
45
|
+
/** Информация о завершении матрицы для уведомления. */
|
|
46
|
+
export interface MatrixNotificationInfo {
|
|
47
|
+
parentName: string;
|
|
48
|
+
status: "success" | "error" | "partial";
|
|
49
|
+
total: number;
|
|
50
|
+
success: number;
|
|
51
|
+
error: number;
|
|
52
|
+
message?: string | null;
|
|
53
|
+
}
|
|
54
|
+
/** Текст уведомления о завершении матрицы. */
|
|
55
|
+
export declare function formatMatrixMessage(info: MatrixNotificationInfo): string;
|
|
56
|
+
export interface WebhookOptions {
|
|
57
|
+
/** Таймаут одной попытки в мс (по умолчанию 10 с). */
|
|
58
|
+
timeoutMs?: number;
|
|
59
|
+
/** Сколько раз повторить после неудачи (по умолчанию 0). */
|
|
60
|
+
retryCount?: number;
|
|
61
|
+
/** Базовая задержка backoff в мс (по умолчанию 1000). */
|
|
62
|
+
retryDelayMs?: number;
|
|
63
|
+
/** Подмена sleep для тестов. */
|
|
64
|
+
sleep?: (ms: number) => Promise<void>;
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Отправляет POST на webhook с повторами и экспоненциальным backoff.
|
|
68
|
+
*
|
|
69
|
+
* Тело совместимо одновременно с Discord (`content`) и Slack (`text`).
|
|
70
|
+
* Повторяются только сетевые ошибки, таймауты, 5xx и 429; прочие 4xx — сразу
|
|
71
|
+
* ошибка (повтор не поможет). Бросает исключение только для диагностики —
|
|
72
|
+
* вызывающий код обязан перехватить его, чтобы уведомление не ломало задачу.
|
|
73
|
+
*/
|
|
74
|
+
export declare function sendWebhook(url: string, message: string, options?: WebhookOptions): Promise<void>;
|
|
75
|
+
/** Канал доставки уведомлений. */
|
|
76
|
+
export type NotificationChannel = "webhook" | "telegram" | "native";
|
|
77
|
+
/** Результат отправки в один канал. */
|
|
78
|
+
export interface ChannelDeliveryResult {
|
|
79
|
+
channel: NotificationChannel;
|
|
80
|
+
ok: boolean;
|
|
81
|
+
error?: string;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Тихие часы: true, если сейчас действует окно `quiet`. Диапазон может
|
|
85
|
+
* переходить через полночь (22:00 → 08:00). Некорректное время — false.
|
|
86
|
+
*/
|
|
87
|
+
export declare function isQuietHours(now: Date, quiet?: {
|
|
88
|
+
enabled?: boolean;
|
|
89
|
+
from?: string;
|
|
90
|
+
to?: string;
|
|
91
|
+
} | null): boolean;
|
|
92
|
+
/**
|
|
93
|
+
* Уведомляет о завершении задачи во все включённые каналы.
|
|
94
|
+
*
|
|
95
|
+
* Правила:
|
|
96
|
+
* - `notifications.enabled === false` — ничего не делает;
|
|
97
|
+
* - `onlyOnError === true` — успешные запуски пропускаются;
|
|
98
|
+
* - фильтры include/exclude отсекают задачи по имени;
|
|
99
|
+
* - ошибки отправки только логируются, наружу не выбрасываются.
|
|
100
|
+
*/
|
|
101
|
+
/**
|
|
102
|
+
* Дедуп уведомлений (Спринт 31.2): группирует повторяющиеся уведомления о
|
|
103
|
+
* задаче в окне времени, считает повторы и не подавляет важные статусы.
|
|
104
|
+
*
|
|
105
|
+
* Ключ группировки: taskName + status. Запись хранится в SQLite, поэтому
|
|
106
|
+
* счётчик сохраняется между короткоживущими процессами record-history.
|
|
107
|
+
*/
|
|
108
|
+
export interface DedupRecord {
|
|
109
|
+
key: string;
|
|
110
|
+
taskName: string;
|
|
111
|
+
status: string;
|
|
112
|
+
count: number;
|
|
113
|
+
firstAt: string;
|
|
114
|
+
lastAt: string;
|
|
115
|
+
windowMinutes: number;
|
|
116
|
+
}
|
|
117
|
+
export declare function notifyTaskCompletion(taskName: string, status: NotificationStatus, durationMs: number, error?: string | null, tokens?: number | null, costUsd?: number | null, options?: NotifyTaskOptions): Promise<void>;
|
|
118
|
+
/**
|
|
119
|
+
* Уведомляет о завершении матрицы (Спринт 20).
|
|
120
|
+
*
|
|
121
|
+
* partial — только при `matrix.onPartial`; полный провал — при
|
|
122
|
+
* `matrix.onAllFailed`; успех — только когда `onlyOnError === false`.
|
|
123
|
+
*/
|
|
124
|
+
export declare function notifyMatrixCompletion(info: MatrixNotificationInfo): Promise<void>;
|
|
125
|
+
/** Запись о незавершённом запуске (для детектора зависших матриц). */
|
|
126
|
+
export interface RunningTaskRecord {
|
|
127
|
+
id: number;
|
|
128
|
+
taskName: string;
|
|
129
|
+
startedAt: string;
|
|
130
|
+
}
|
|
131
|
+
/** Найденный зависший клон матрицы. */
|
|
132
|
+
export interface StuckMatrixClone {
|
|
133
|
+
id: number;
|
|
134
|
+
cloneName: string;
|
|
135
|
+
parentName: string;
|
|
136
|
+
startedAt: string;
|
|
137
|
+
minutes: number;
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
140
|
+
* Ищет клоны матриц, которые выполняются дольше порога.
|
|
141
|
+
* `parentByClone` — соответствие «имя клона → имя родителя» (без регистра).
|
|
142
|
+
*/
|
|
143
|
+
export declare function findStuckMatrixClones(running: RunningTaskRecord[], parentByClone: Map<string, string>, now: Date, thresholdMinutes: number): StuckMatrixClone[];
|
|
144
|
+
/** Текст уведомления о зависшем клоне матрицы. */
|
|
145
|
+
export declare function formatStuckMatrixMessage(stuck: StuckMatrixClone): string;
|
|
146
|
+
/** Отправляет уведомление о зависшем клоне, если матрицы включены. */
|
|
147
|
+
export declare function notifyStuckMatrix(stuck: StuckMatrixClone): Promise<boolean>;
|
|
148
|
+
/** Сводка для дайджеста. */
|
|
149
|
+
export interface DigestSummary {
|
|
150
|
+
period: "daily" | "weekly";
|
|
151
|
+
windowDays: number;
|
|
152
|
+
total: number;
|
|
153
|
+
success: number;
|
|
154
|
+
error: number;
|
|
155
|
+
partial: number;
|
|
156
|
+
successRate: number;
|
|
157
|
+
tokens: number;
|
|
158
|
+
costUsd: number;
|
|
159
|
+
topErrors: ErrorAnalyticsRow[];
|
|
160
|
+
}
|
|
161
|
+
/** Строит сводку дайджеста из записей истории. */
|
|
162
|
+
export declare function buildDigestSummary(records: AnalyticsRecord[], options: {
|
|
163
|
+
frequency: DigestFrequency;
|
|
164
|
+
now?: Date;
|
|
165
|
+
}): DigestSummary;
|
|
166
|
+
/** Текст дайджеста. */
|
|
167
|
+
export declare function formatDigestMessage(summary: DigestSummary, now?: Date): string;
|
|
168
|
+
/**
|
|
169
|
+
* Пора ли отправлять дайджест.
|
|
170
|
+
*
|
|
171
|
+
* daily — раз в сутки после `digest.time`; weekly — по понедельникам после
|
|
172
|
+
* `digest.time`. `lastSentAt` защищает от повторной отправки после перезапуска.
|
|
173
|
+
*/
|
|
174
|
+
export declare function isDigestDue(digest: DigestSettings, now: Date): boolean;
|
|
175
|
+
/**
|
|
176
|
+
* Собирает и отправляет дайджест.
|
|
177
|
+
*
|
|
178
|
+
* `updateLastSentAt` включается только для плановой отправки: ручная кнопка
|
|
179
|
+
* «Отправить сейчас» не должна сдвигать расписание.
|
|
180
|
+
*/
|
|
181
|
+
export declare function sendDigestNow(options?: {
|
|
182
|
+
now?: Date;
|
|
183
|
+
updateLastSentAt?: boolean;
|
|
184
|
+
}): Promise<{
|
|
185
|
+
success: boolean;
|
|
186
|
+
message: string;
|
|
187
|
+
}>;
|
|
188
|
+
/** Плановая проверка дайджеста: отправляет, если пора. Возвращает true при отправке. */
|
|
189
|
+
export declare function maybeSendDigest(now?: Date): Promise<boolean>;
|
|
190
|
+
/**
|
|
191
|
+
* Отправляет тестовое сообщение в выбранный канал или во все включённые
|
|
192
|
+
* (кнопка «🧪 Тестовое уведомление»). В отличие от notifyTaskCompletion,
|
|
193
|
+
* результат возвращается пользователю: при тесте важна причина ошибки.
|
|
194
|
+
*/
|
|
195
|
+
export declare function sendTestNotification(channel?: "all" | NotificationChannel): Promise<{
|
|
196
|
+
success: boolean;
|
|
197
|
+
message: string;
|
|
198
|
+
}>;
|
|
199
|
+
//# sourceMappingURL=notifications.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"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"}
|