agent-steward 0.0.1 → 0.0.2
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 +376 -0
- package/CROSS_PLATFORM.md +149 -0
- package/README.md +306 -15
- package/ROADMAP-STRATEGY.md +147 -0
- package/ROADMAP.md +1069 -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 +20 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -0
- package/dist/core/cron-to-schtasks.js +250 -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 +195 -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 +68 -0
- package/dist/core/one-shot.d.ts.map +1 -0
- package/dist/core/one-shot.js +139 -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 +1071 -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/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 +44 -0
- package/dist/core/scheduler/linux.d.ts.map +1 -0
- package/dist/core/scheduler/linux.js +225 -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 +40 -0
- package/dist/core/scheduler/mac.d.ts.map +1 -0
- package/dist/core/scheduler/mac.js +207 -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 +89 -0
- package/dist/core/scheduler/registry.d.ts +41 -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 +99 -0
- package/dist/core/scheduler/windows.d.ts.map +1 -0
- package/dist/core/scheduler/windows.js +596 -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/self-analysis.test.d.ts +2 -0
- package/dist/core/self-analysis.test.d.ts.map +1 -0
- package/dist/core/self-analysis.test.js +219 -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 +47 -0
- package/dist/db/index.d.ts.map +1 -0
- package/dist/db/index.js +120 -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/schema.d.ts +24 -0
- package/dist/db/schema.d.ts.map +1 -0
- package/dist/db/schema.js +170 -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/gui-experimental.cjs +1 -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 +5179 -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 +60 -0
- package/dist/profiles.d.ts.map +1 -0
- package/dist/profiles.js +227 -0
- package/dist/rpc.d.ts +3806 -0
- package/dist/rpc.d.ts.map +1 -0
- package/dist/rpc.js +1507 -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 +2413 -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 +628 -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 +96 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +130 -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 +457 -0
- package/docs/COMPATIBILITY.md +233 -0
- package/docs/CONCEPT.md +230 -0
- package/docs/CROSS_PLATFORM.ru.md +150 -0
- package/docs/CROSS_PLATFORM.zh.md +146 -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 +698 -0
- package/docs/FEATURES.zh.md +655 -0
- package/docs/LOCAL-AI.md +300 -0
- package/docs/MIGRATION.md +355 -0
- package/docs/README.ru.md +268 -0
- package/docs/README.zh.md +305 -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 +1 -0
- package/locales/en.json +780 -0
- package/locales/ru.json +780 -0
- package/locales/zh.json +780 -0
- package/package.json +133 -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 +288 -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 +189 -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 +1140 -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/index.ts +82 -0
- package/src/core/scheduler/linux.ts +257 -0
- package/src/core/scheduler/logs.ts +37 -0
- package/src/core/scheduler/mac.ts +270 -0
- package/src/core/scheduler/posix.ts +114 -0
- package/src/core/scheduler/registry.ts +99 -0
- package/src/core/scheduler/types.ts +90 -0
- package/src/core/scheduler/windows.ts +711 -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 +166 -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/schema.ts +188 -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 +6605 -0
- package/src/integrations.ts +297 -0
- package/src/notifications.ts +1346 -0
- package/src/profiles.ts +254 -0
- package/src/rpc.ts +1609 -0
- package/src/schtasks.ts +75 -0
- package/src/server.ts +2662 -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 +944 -0
- package/src/templates.ts +67 -0
- package/src/tui-v1.tsx +341 -0
- package/src/tui.tsx +329 -0
- package/src/types.ts +191 -0
- package/src/version.ts +27 -0
- package/src/workspaces.ts +487 -0
|
@@ -0,0 +1,436 @@
|
|
|
1
|
+
import { t } from "../i18n.js";
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Telegram Bot API: отправка уведомлений (Спринт 25).
|
|
5
|
+
*
|
|
6
|
+
* Модуль намеренно не зависит от настроек и сетевого слоя приложения:
|
|
7
|
+
* всё, что нужно, передаётся аргументами. Это позволяет тестировать
|
|
8
|
+
* экранирование и сборку запроса без реальных вызовов Telegram.
|
|
9
|
+
*/
|
|
10
|
+
export type TelegramParseMode = "" | "HTML" | "Markdown" | "MarkdownV2";
|
|
11
|
+
|
|
12
|
+
/** Таймаут запроса по умолчанию. */
|
|
13
|
+
const DEFAULT_TIMEOUT_MS = 10_000;
|
|
14
|
+
|
|
15
|
+
export interface TelegramSendOptions {
|
|
16
|
+
/** База API; по умолчанию https://api.telegram.org. */
|
|
17
|
+
apiBase?: string;
|
|
18
|
+
/** Разметка; пусто — plain text. */
|
|
19
|
+
parseMode?: TelegramParseMode;
|
|
20
|
+
/** Отправить без звука. */
|
|
21
|
+
disableNotification?: boolean;
|
|
22
|
+
/** ID темы форума, если указан. */
|
|
23
|
+
messageThreadId?: number | null;
|
|
24
|
+
/** Добавить ссылку на дашборд. */
|
|
25
|
+
includeDashboardLink?: boolean;
|
|
26
|
+
/** URL дашборда; null/пусто — ссылка не добавляется. */
|
|
27
|
+
dashboardUrl?: string | null;
|
|
28
|
+
/** Таймаут запроса в мс. */
|
|
29
|
+
timeoutMs?: number;
|
|
30
|
+
/** Подмена fetch для тестов. */
|
|
31
|
+
fetchImpl?: typeof fetch;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/** Экранирует текст под выбранный parse_mode. */
|
|
35
|
+
export function escapeTelegramText(
|
|
36
|
+
text: string,
|
|
37
|
+
parseMode: TelegramParseMode = ""
|
|
38
|
+
): string {
|
|
39
|
+
const value = String(text ?? "");
|
|
40
|
+
if (parseMode === "HTML") {
|
|
41
|
+
return value
|
|
42
|
+
.replace(/&/g, "&")
|
|
43
|
+
.replace(/</g, "<")
|
|
44
|
+
.replace(/>/g, ">");
|
|
45
|
+
}
|
|
46
|
+
if (parseMode === "MarkdownV2") {
|
|
47
|
+
return value.replace(/([\\_*[\]()~`>#+\-=|{}.!])/g, "\\$1");
|
|
48
|
+
}
|
|
49
|
+
if (parseMode === "Markdown") {
|
|
50
|
+
return value.replace(/([\\_*[\]`])/g, "\\$1");
|
|
51
|
+
}
|
|
52
|
+
return value;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** Экранирует URL для HTML-атрибута. */
|
|
56
|
+
function escapeHtmlAttribute(url: string): string {
|
|
57
|
+
return url
|
|
58
|
+
.replace(/&/g, "&")
|
|
59
|
+
.replace(/</g, "<")
|
|
60
|
+
.replace(/>/g, ">")
|
|
61
|
+
.replace(/"/g, """)
|
|
62
|
+
.replace(/'/g, "'");
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* Готовит текст сообщения: экранирует пользовательские данные и добавляет
|
|
67
|
+
* ссылку на дашборд в разметке выбранного режима.
|
|
68
|
+
*/
|
|
69
|
+
export function formatTelegramText(
|
|
70
|
+
text: string,
|
|
71
|
+
parseMode: TelegramParseMode = "",
|
|
72
|
+
dashboardUrl?: string | null
|
|
73
|
+
): string {
|
|
74
|
+
const body = escapeTelegramText(text, parseMode);
|
|
75
|
+
const url = (dashboardUrl ?? "").trim();
|
|
76
|
+
if (!url) return body;
|
|
77
|
+
|
|
78
|
+
if (parseMode === "HTML") {
|
|
79
|
+
return `${body}\n\n<a href="${escapeHtmlAttribute(url)}">${t("notify.telegram.openDashboard")}</a>`;
|
|
80
|
+
}
|
|
81
|
+
if (parseMode === "MarkdownV2") {
|
|
82
|
+
const escapedUrl = url.replace(/[)\\]/g, "\\$&");
|
|
83
|
+
return `${body}\n\n[${t("notify.telegram.openDashboard")}](${escapedUrl})`;
|
|
84
|
+
}
|
|
85
|
+
if (parseMode === "Markdown") {
|
|
86
|
+
const escapedUrl = url.replace(/[)]/g, "\\)");
|
|
87
|
+
return `${body}\n\n[${t("notify.telegram.openDashboard")}](${escapedUrl})`;
|
|
88
|
+
}
|
|
89
|
+
return `${body}\n\n${t("notify.telegram.openDashboardUrl", { url })}`;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/** Проверяет формат токена бота; возвращает trimmed-значение. */
|
|
93
|
+
export function validateTelegramToken(token: string): string {
|
|
94
|
+
const value = (token ?? "").trim();
|
|
95
|
+
if (!value) {
|
|
96
|
+
throw new Error(t("notify.error.telegramTokenMissing"));
|
|
97
|
+
}
|
|
98
|
+
// Формат BotFather: <digits>:<base64-ish>. Проверяем достаточно мягко,
|
|
99
|
+
// чтобы не ломать тестовые токены, но отсекать явный мусор.
|
|
100
|
+
if (!/^\d+:[A-Za-z0-9_-]{5,}$/.test(value)) {
|
|
101
|
+
throw new Error(t("notify.error.telegramTokenInvalid"));
|
|
102
|
+
}
|
|
103
|
+
return value;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/** Маскирует токен для сообщений об ошибках и логов. */
|
|
107
|
+
export function maskTelegramToken(token: string): string {
|
|
108
|
+
const value = (token ?? "").trim();
|
|
109
|
+
if (!value) return "***";
|
|
110
|
+
const colon = value.indexOf(":");
|
|
111
|
+
if (colon <= 0) return "***";
|
|
112
|
+
const id = value.slice(0, colon);
|
|
113
|
+
const secret = value.slice(colon + 1);
|
|
114
|
+
const tail = secret.length >= 4 ? secret.slice(-4) : "";
|
|
115
|
+
return `${id}:***${tail}`;
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
/** Убирает токен из произвольного текста ошибки. */
|
|
119
|
+
function sanitizeErrorText(text: string, token: string): string {
|
|
120
|
+
if (!text) return text;
|
|
121
|
+
return text.split(token).join(maskTelegramToken(token));
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
function resolveApiBase(apiBase?: string): string {
|
|
125
|
+
const value = (apiBase ?? "https://api.telegram.org").trim().replace(/\/+$/, "");
|
|
126
|
+
let parsed: URL;
|
|
127
|
+
try {
|
|
128
|
+
parsed = new URL(value);
|
|
129
|
+
} catch {
|
|
130
|
+
throw new Error(t("notify.error.telegramApiBaseInvalid"));
|
|
131
|
+
}
|
|
132
|
+
if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
|
|
133
|
+
throw new Error(t("notify.error.telegramScheme"));
|
|
134
|
+
}
|
|
135
|
+
return value;
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
/** Лимит одного сообщения Telegram Bot API. */
|
|
139
|
+
export const TELEGRAM_MAX_MESSAGE_LENGTH = 4096;
|
|
140
|
+
|
|
141
|
+
/** Сколько раз повторяем отправку при HTTP 429. */
|
|
142
|
+
const TELEGRAM_MAX_RETRIES = 3;
|
|
143
|
+
|
|
144
|
+
/**
|
|
145
|
+
* Режет длинный текст на части по лимиту Bot API (4096 UTF-16 code units).
|
|
146
|
+
* Старается рвать по переводу строки, не разрывает surrogate pair и
|
|
147
|
+
* экранированный символ MarkdownV2 (`\x`).
|
|
148
|
+
*/
|
|
149
|
+
export function splitTelegramMessage(
|
|
150
|
+
text: string,
|
|
151
|
+
limit = TELEGRAM_MAX_MESSAGE_LENGTH
|
|
152
|
+
): string[] {
|
|
153
|
+
const value = String(text ?? "");
|
|
154
|
+
const max = Math.max(1, Math.floor(limit));
|
|
155
|
+
if (!value) return [""];
|
|
156
|
+
const chunks: string[] = [];
|
|
157
|
+
let rest = value;
|
|
158
|
+
while (rest.length > max) {
|
|
159
|
+
let cut = max;
|
|
160
|
+
const newline = rest.lastIndexOf("\n", max);
|
|
161
|
+
if (newline > max * 0.5) cut = newline + 1;
|
|
162
|
+
// Не разрываем surrogate pair (эмодзи и т.п.).
|
|
163
|
+
if (cut > 0 && cut < rest.length) {
|
|
164
|
+
const code = rest.charCodeAt(cut - 1);
|
|
165
|
+
if (code >= 0xd800 && code <= 0xdbff) cut -= 1;
|
|
166
|
+
}
|
|
167
|
+
// MarkdownV2: обратный слэш должен остаться вместе с экранируемым символом.
|
|
168
|
+
if (cut > 0 && rest[cut - 1] === "\\") cut -= 1;
|
|
169
|
+
if (cut <= 0) cut = max;
|
|
170
|
+
chunks.push(rest.slice(0, cut));
|
|
171
|
+
rest = rest.slice(cut);
|
|
172
|
+
}
|
|
173
|
+
chunks.push(rest);
|
|
174
|
+
return chunks;
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
/** Спецсимволы MarkdownV2 (должны совпадать с escapeTelegramText). */
|
|
178
|
+
const MARKDOWN_V2_SPECIAL = new Set("\\_*[]()~`>#+-=|{}.!".split(""));
|
|
179
|
+
/** Спецсимволы legacy Markdown. */
|
|
180
|
+
const MARKDOWN_SPECIAL = new Set("\\_*[]`".split(""));
|
|
181
|
+
|
|
182
|
+
/** Сколько UTF-16 code units займёт символ после экранирования. */
|
|
183
|
+
function escapedCharLength(ch: string, parseMode: TelegramParseMode): number {
|
|
184
|
+
if (parseMode === "HTML") {
|
|
185
|
+
if (ch === "&") return 5;
|
|
186
|
+
if (ch === "<" || ch === ">") return 4;
|
|
187
|
+
return ch.length;
|
|
188
|
+
}
|
|
189
|
+
if (parseMode === "MarkdownV2") {
|
|
190
|
+
return MARKDOWN_V2_SPECIAL.has(ch) ? ch.length + 1 : ch.length;
|
|
191
|
+
}
|
|
192
|
+
if (parseMode === "Markdown") {
|
|
193
|
+
return MARKDOWN_SPECIAL.has(ch) ? ch.length + 1 : ch.length;
|
|
194
|
+
}
|
|
195
|
+
return ch.length;
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
/** Длина текста после экранирования под parse_mode. */
|
|
199
|
+
function formattedLength(text: string, parseMode: TelegramParseMode): number {
|
|
200
|
+
let total = 0;
|
|
201
|
+
for (const ch of String(text ?? "")) {
|
|
202
|
+
total += escapedCharLength(ch, parseMode);
|
|
203
|
+
}
|
|
204
|
+
return total;
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
/**
|
|
208
|
+
* Возвращает индекс конца сырого чанка, который после экранирования
|
|
209
|
+
* укладывается в maxFormatted. Старается рвать по переводу строки и никогда
|
|
210
|
+
* не разрывает surrogate pair.
|
|
211
|
+
*/
|
|
212
|
+
function cutRawChunk(
|
|
213
|
+
text: string,
|
|
214
|
+
start: number,
|
|
215
|
+
maxFormatted: number,
|
|
216
|
+
parseMode: TelegramParseMode
|
|
217
|
+
): number {
|
|
218
|
+
let index = start;
|
|
219
|
+
let used = 0;
|
|
220
|
+
let lastNewline = -1;
|
|
221
|
+
while (index < text.length) {
|
|
222
|
+
const codePoint = text.codePointAt(index) as number;
|
|
223
|
+
const ch = String.fromCodePoint(codePoint);
|
|
224
|
+
const cost = escapedCharLength(ch, parseMode);
|
|
225
|
+
if (used + cost > maxFormatted) break;
|
|
226
|
+
used += cost;
|
|
227
|
+
index += ch.length;
|
|
228
|
+
if (ch === "\n") lastNewline = index;
|
|
229
|
+
}
|
|
230
|
+
if (index < text.length && index > start && lastNewline > start) {
|
|
231
|
+
const consumed = index - start;
|
|
232
|
+
if (lastNewline - start > consumed * 0.5) index = lastNewline;
|
|
233
|
+
}
|
|
234
|
+
if (index <= start) {
|
|
235
|
+
// Гарантируем прогресс хотя бы на один code point.
|
|
236
|
+
const codePoint = text.codePointAt(start) as number;
|
|
237
|
+
index = start + String.fromCodePoint(codePoint).length;
|
|
238
|
+
}
|
|
239
|
+
return index;
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
/**
|
|
243
|
+
* Режет СЫРОЙ текст так, чтобы каждый отформатированный чанк укладывался в
|
|
244
|
+
* лимит Telegram. Резать уже экранированный текст нельзя: HTML-сущности
|
|
245
|
+
* (&, <) и MarkdownV2-экранирование (\*) могут разорваться между
|
|
246
|
+
* сообщениями, и Bot API отвечает 400 «can't parse entities».
|
|
247
|
+
* linkReserve — запас под ссылку на дашборд в последнем чанке.
|
|
248
|
+
*/
|
|
249
|
+
function splitRawMessageForSend(
|
|
250
|
+
text: string,
|
|
251
|
+
limit: number,
|
|
252
|
+
parseMode: TelegramParseMode,
|
|
253
|
+
linkReserve = 0
|
|
254
|
+
): string[] {
|
|
255
|
+
const value = String(text ?? "");
|
|
256
|
+
const max = Math.max(1, Math.floor(limit));
|
|
257
|
+
if (!value) return [""];
|
|
258
|
+
|
|
259
|
+
const chunks: string[] = [];
|
|
260
|
+
let start = 0;
|
|
261
|
+
while (start < value.length) {
|
|
262
|
+
const end = cutRawChunk(value, start, max, parseMode);
|
|
263
|
+
chunks.push(value.slice(start, end));
|
|
264
|
+
start = end;
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
if (linkReserve > 0 && chunks.length > 0) {
|
|
268
|
+
const maxLast = Math.max(1, max - linkReserve);
|
|
269
|
+
const lastStart = value.length - chunks[chunks.length - 1].length;
|
|
270
|
+
if (formattedLength(value.slice(lastStart), parseMode) > maxLast) {
|
|
271
|
+
// Пересобираем хвост с меньшим лимитом, чтобы влезла ссылка.
|
|
272
|
+
chunks.splice(chunks.length - 1, 1);
|
|
273
|
+
let tailStart = lastStart;
|
|
274
|
+
while (tailStart < value.length) {
|
|
275
|
+
const end = cutRawChunk(value, tailStart, maxLast, parseMode);
|
|
276
|
+
chunks.push(value.slice(tailStart, end));
|
|
277
|
+
tailStart = end;
|
|
278
|
+
}
|
|
279
|
+
}
|
|
280
|
+
}
|
|
281
|
+
return chunks;
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
/** Пауза без утечки таймера. */
|
|
285
|
+
function sleep(ms: number): Promise<void> {
|
|
286
|
+
return new Promise((resolve) => {
|
|
287
|
+
const timer = setTimeout(resolve, ms);
|
|
288
|
+
// timer.unref?.() УБРАН: процесс не должен завершаться во время 429-ретрая,
|
|
289
|
+
// иначе уведомление теряется (record-history — короткоживущий процесс,
|
|
290
|
+
// event loop не удерживается unref-таймером).
|
|
291
|
+
});
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
/**
|
|
295
|
+
* Отправляет сообщение через Bot API `sendMessage`.
|
|
296
|
+
*
|
|
297
|
+
* Длинный текст режется на части по 4096 символов. При HTTP 429 отправка
|
|
298
|
+
* повторяется с учётом `parameters.retry_after` (не более 3 повторов).
|
|
299
|
+
* Бросает Error с безопасным текстом (токен замаскирован). Вызывающий код
|
|
300
|
+
* обязан перехватить ошибку, чтобы уведомление не ломало задачу.
|
|
301
|
+
*/
|
|
302
|
+
export async function sendTelegramMessage(
|
|
303
|
+
token: string,
|
|
304
|
+
chatId: string,
|
|
305
|
+
text: string,
|
|
306
|
+
options: TelegramSendOptions = {}
|
|
307
|
+
): Promise<void> {
|
|
308
|
+
const safeToken = validateTelegramToken(token);
|
|
309
|
+
const target = (chatId ?? "").trim();
|
|
310
|
+
if (!target) {
|
|
311
|
+
throw new Error(t("notify.error.telegramChatMissing"));
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
const apiBase = resolveApiBase(options.apiBase);
|
|
315
|
+
const parseMode = options.parseMode ?? "";
|
|
316
|
+
const dashboardUrl =
|
|
317
|
+
options.includeDashboardLink === false ? null : options.dashboardUrl;
|
|
318
|
+
// Ссылку добавляем только в последний чанк, поэтому её длину резервируем
|
|
319
|
+
// заранее: formatTelegramText("") возвращает ровно суффикс со ссылкой.
|
|
320
|
+
const linkSuffix = dashboardUrl
|
|
321
|
+
? formatTelegramText("", parseMode, dashboardUrl)
|
|
322
|
+
: "";
|
|
323
|
+
const rawChunks = splitRawMessageForSend(
|
|
324
|
+
text,
|
|
325
|
+
TELEGRAM_MAX_MESSAGE_LENGTH,
|
|
326
|
+
parseMode,
|
|
327
|
+
linkSuffix.length
|
|
328
|
+
);
|
|
329
|
+
|
|
330
|
+
const timeoutMs = Math.max(
|
|
331
|
+
1_000,
|
|
332
|
+
Math.floor(options.timeoutMs ?? DEFAULT_TIMEOUT_MS)
|
|
333
|
+
);
|
|
334
|
+
const fetchImpl = options.fetchImpl ?? fetch;
|
|
335
|
+
const url = `${apiBase}/bot${safeToken}/sendMessage`;
|
|
336
|
+
|
|
337
|
+
for (let chunkIndex = 0; chunkIndex < rawChunks.length; chunkIndex++) {
|
|
338
|
+
const isLastChunk = chunkIndex === rawChunks.length - 1;
|
|
339
|
+
// Форматируем каждый сырой чанк отдельно: экранированные сущности
|
|
340
|
+
// (&, \*) никогда не разрываются между сообщениями.
|
|
341
|
+
const chunk = formatTelegramText(
|
|
342
|
+
rawChunks[chunkIndex],
|
|
343
|
+
parseMode,
|
|
344
|
+
isLastChunk ? dashboardUrl : null
|
|
345
|
+
);
|
|
346
|
+
let parseModeForChunk = parseMode;
|
|
347
|
+
let downgradedParseMode = false;
|
|
348
|
+
|
|
349
|
+
for (let attempt = 0; ; attempt++) {
|
|
350
|
+
const body: Record<string, unknown> = { chat_id: target, text: chunk };
|
|
351
|
+
if (parseModeForChunk) body.parse_mode = parseModeForChunk;
|
|
352
|
+
if (options.disableNotification) body.disable_notification = true;
|
|
353
|
+
if (
|
|
354
|
+
typeof options.messageThreadId === "number" &&
|
|
355
|
+
Number.isFinite(options.messageThreadId) &&
|
|
356
|
+
options.messageThreadId > 0
|
|
357
|
+
) {
|
|
358
|
+
body.message_thread_id = Math.floor(options.messageThreadId);
|
|
359
|
+
}
|
|
360
|
+
|
|
361
|
+
const controller = new AbortController();
|
|
362
|
+
const timer = setTimeout(() => controller.abort(), timeoutMs);
|
|
363
|
+
try {
|
|
364
|
+
const response = await fetchImpl(url, {
|
|
365
|
+
method: "POST",
|
|
366
|
+
headers: { "Content-Type": "application/json" },
|
|
367
|
+
body: JSON.stringify(body),
|
|
368
|
+
signal: controller.signal,
|
|
369
|
+
});
|
|
370
|
+
|
|
371
|
+
const raw = await response.text().catch(() => "");
|
|
372
|
+
let parsed: any = null;
|
|
373
|
+
try {
|
|
374
|
+
parsed = raw ? JSON.parse(raw) : null;
|
|
375
|
+
} catch {
|
|
376
|
+
parsed = null;
|
|
377
|
+
}
|
|
378
|
+
|
|
379
|
+
if (response.status === 429 && attempt < TELEGRAM_MAX_RETRIES) {
|
|
380
|
+
const retryAfter = Number(parsed?.parameters?.retry_after);
|
|
381
|
+
const delaySeconds = Number.isFinite(retryAfter) && retryAfter > 0
|
|
382
|
+
? Math.min(60, Math.ceil(retryAfter))
|
|
383
|
+
: Math.min(30, 2 ** attempt);
|
|
384
|
+
await sleep(delaySeconds * 1000);
|
|
385
|
+
continue;
|
|
386
|
+
}
|
|
387
|
+
|
|
388
|
+
const description =
|
|
389
|
+
(typeof parsed?.description === "string" && parsed.description) ||
|
|
390
|
+
raw.slice(0, 200) ||
|
|
391
|
+
`HTTP ${response.status}`;
|
|
392
|
+
|
|
393
|
+
// Страховка: если Telegram всё равно не разобрал разметку, повторяем
|
|
394
|
+
// тот же чанк без parse_mode — лучше без форматирования, чем потерять
|
|
395
|
+
// уведомление целиком.
|
|
396
|
+
if (
|
|
397
|
+
response.status === 400 &&
|
|
398
|
+
parseModeForChunk &&
|
|
399
|
+
!downgradedParseMode &&
|
|
400
|
+
/parse entities|can't parse|unsupported start tag|can't find end/i.test(
|
|
401
|
+
description
|
|
402
|
+
)
|
|
403
|
+
) {
|
|
404
|
+
console.warn(
|
|
405
|
+
`[notify] Telegram отклонил разметку (${sanitizeErrorText(
|
|
406
|
+
description,
|
|
407
|
+
safeToken
|
|
408
|
+
)}) — чанк повторно отправлен без parse_mode. Проверьте шаблоны уведомлений.`
|
|
409
|
+
);
|
|
410
|
+
downgradedParseMode = true;
|
|
411
|
+
parseModeForChunk = "";
|
|
412
|
+
continue;
|
|
413
|
+
}
|
|
414
|
+
|
|
415
|
+
if (!response.ok || parsed?.ok === false) {
|
|
416
|
+
throw new Error(
|
|
417
|
+
`Telegram API: ${sanitizeErrorText(description, safeToken)}`
|
|
418
|
+
);
|
|
419
|
+
}
|
|
420
|
+
break;
|
|
421
|
+
} catch (err: any) {
|
|
422
|
+
if (err?.name === "AbortError") {
|
|
423
|
+
throw new Error(
|
|
424
|
+
t("notify.error.telegramTimeout", {
|
|
425
|
+
seconds: Math.floor(timeoutMs / 1000),
|
|
426
|
+
})
|
|
427
|
+
);
|
|
428
|
+
}
|
|
429
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
430
|
+
throw new Error(sanitizeErrorText(message, safeToken));
|
|
431
|
+
} finally {
|
|
432
|
+
clearTimeout(timer);
|
|
433
|
+
}
|
|
434
|
+
}
|
|
435
|
+
}
|
|
436
|
+
}
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
import {
|
|
2
|
+
classifyNotification,
|
|
3
|
+
type TriageFailure,
|
|
4
|
+
type TriageInput,
|
|
5
|
+
type TriageOptions,
|
|
6
|
+
type TriageVerdict,
|
|
7
|
+
} from "./triage.js";
|
|
8
|
+
import { evaluateTriageRules } from "./triage-rules.js";
|
|
9
|
+
import { recordTriageOutcome } from "./triage-shadow.js";
|
|
10
|
+
import { isShadowActive, type TriageSettings } from "../settings.js";
|
|
11
|
+
|
|
12
|
+
/** Что делать с уведомлением после триажа. */
|
|
13
|
+
export type TriageAction = "notify" | "skip";
|
|
14
|
+
|
|
15
|
+
/** Откуда взято решение — для shadow-режима и диагностики. */
|
|
16
|
+
export type TriageSource = "off" | "llm" | "rules" | "fallback";
|
|
17
|
+
|
|
18
|
+
/** Итог цепочки LLM → правила → fail-open. */
|
|
19
|
+
export interface TriageDecision {
|
|
20
|
+
action: TriageAction;
|
|
21
|
+
source: TriageSource;
|
|
22
|
+
verdict?: TriageVerdict;
|
|
23
|
+
/** Причина, по которой LLM не дал пригодного вердикта. */
|
|
24
|
+
failure?: TriageFailure | "low-confidence";
|
|
25
|
+
attempts: number;
|
|
26
|
+
latencyMs: number;
|
|
27
|
+
/** id сработавшего правила, если решение приняли правила. */
|
|
28
|
+
ruleId?: string;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
const NOTIFY: TriageAction = "notify";
|
|
32
|
+
|
|
33
|
+
function ruleDecision(
|
|
34
|
+
input: TriageInput,
|
|
35
|
+
settings: TriageSettings,
|
|
36
|
+
source: TriageSource
|
|
37
|
+
): TriageDecision {
|
|
38
|
+
const result = evaluateTriageRules(input, settings.rules);
|
|
39
|
+
return {
|
|
40
|
+
action: result.action,
|
|
41
|
+
source,
|
|
42
|
+
verdict: result.verdict,
|
|
43
|
+
attempts: 0,
|
|
44
|
+
latencyMs: 0,
|
|
45
|
+
ruleId: result.ruleId,
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* Применяет цепочку деградации к одному уведомлению.
|
|
51
|
+
*
|
|
52
|
+
* - `off` — триаж выключен, уведомление отправляется.
|
|
53
|
+
* - `rules` — решают только правила; нет совпадения = отправить.
|
|
54
|
+
* - `llm`/`auto` — LLM классифицирует, но сам ничего не подавляет; при
|
|
55
|
+
* ошибке, таймауте или низкой уверенности управление переходит к правилам
|
|
56
|
+
* (если `fallback: "rules"`) либо уведомление отправляется без правил
|
|
57
|
+
* (`fallback: "notify"`; устаревшее имя — `"skip"`).
|
|
58
|
+
*
|
|
59
|
+
* Функция никогда не бросает исключение и по умолчанию возвращает `notify`:
|
|
60
|
+
* недоступный классификатор не должен терять уведомление.
|
|
61
|
+
*/
|
|
62
|
+
export async function decideTriage(
|
|
63
|
+
input: TriageInput,
|
|
64
|
+
settings: TriageSettings | undefined,
|
|
65
|
+
options: TriageOptions = {}
|
|
66
|
+
): Promise<TriageDecision> {
|
|
67
|
+
if (!settings || settings.mode === "off") {
|
|
68
|
+
return { action: NOTIFY, source: "off", attempts: 0, latencyMs: 0 };
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
if (settings.mode === "rules") {
|
|
72
|
+
return ruleDecision(input, settings, "rules");
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
const llm = await classifyNotification(input, settings, options);
|
|
76
|
+
if (llm.ok && llm.verdict && llm.verdict.confidence >= settings.confidenceThreshold) {
|
|
77
|
+
return {
|
|
78
|
+
action: NOTIFY,
|
|
79
|
+
source: "llm",
|
|
80
|
+
verdict: llm.verdict,
|
|
81
|
+
attempts: llm.attempts,
|
|
82
|
+
latencyMs: llm.latencyMs,
|
|
83
|
+
};
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
const failure: TriageFailure | "low-confidence" = llm.ok
|
|
87
|
+
? "low-confidence"
|
|
88
|
+
: llm.failure ?? "invalid-response";
|
|
89
|
+
|
|
90
|
+
if (settings.fallback === "notify" || settings.fallback === "skip") {
|
|
91
|
+
return {
|
|
92
|
+
action: NOTIFY,
|
|
93
|
+
source: "fallback",
|
|
94
|
+
failure,
|
|
95
|
+
attempts: llm.attempts,
|
|
96
|
+
latencyMs: llm.latencyMs,
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
const byRules = ruleDecision(input, settings, "fallback");
|
|
101
|
+
return {
|
|
102
|
+
...byRules,
|
|
103
|
+
failure,
|
|
104
|
+
attempts: llm.attempts,
|
|
105
|
+
latencyMs: llm.latencyMs,
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* Записывает решение в shadow-журнал, если shadow-режим активен.
|
|
111
|
+
*
|
|
112
|
+
* Оставлено для обратной совместимости; `notifyTaskCompletion` пишет все
|
|
113
|
+
* решения через `recordTriageOutcome` (31.8).
|
|
114
|
+
*/
|
|
115
|
+
export function recordShadow(
|
|
116
|
+
input: TriageInput,
|
|
117
|
+
decision: TriageDecision,
|
|
118
|
+
shadow: TriageSettings["shadow"] | undefined
|
|
119
|
+
): void {
|
|
120
|
+
if (!shadow || !shadow.enabled) return;
|
|
121
|
+
recordTriageOutcome(input, decision, {
|
|
122
|
+
shadowActive: isShadowActive(shadow),
|
|
123
|
+
suppressed: false,
|
|
124
|
+
});
|
|
125
|
+
}
|