@itphx/synth-backend 0.10.0 → 0.11.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.
Files changed (62) hide show
  1. package/dist/app/bootstrap.d.ts +11 -0
  2. package/dist/app/bootstrap.js +19 -0
  3. package/dist/app/deps.d.ts +124 -0
  4. package/dist/app/deps.js +751 -0
  5. package/dist/app/listen.d.ts +34 -0
  6. package/dist/app/listen.js +309 -0
  7. package/dist/app/mount-routes.d.ts +31 -0
  8. package/dist/app/mount-routes.js +696 -0
  9. package/dist/app/sse-events.d.ts +15 -0
  10. package/dist/app/sse-events.js +83 -0
  11. package/dist/app.d.ts +30 -17
  12. package/dist/app.js +164 -1337
  13. package/dist/auth/guards.d.ts +2 -1
  14. package/dist/auth/guards.js +10 -2
  15. package/dist/auth/middleware.d.ts +9 -14
  16. package/dist/auth/middleware.js +38 -6
  17. package/dist/auth/oidc.d.ts +22 -0
  18. package/dist/auth/oidc.js +68 -9
  19. package/dist/auth/service-scope.d.ts +8 -4
  20. package/dist/auth/service-scope.js +9 -5
  21. package/dist/events/hub.d.ts +2 -2
  22. package/dist/events/hub.js +3 -38
  23. package/dist/lib/app-config.d.ts +2 -0
  24. package/dist/lib/app-config.js +3 -2
  25. package/dist/lib/cors.d.ts +23 -0
  26. package/dist/lib/cors.js +24 -0
  27. package/dist/lib/defaults-store.d.ts +2 -25
  28. package/dist/lib/defaults-store.js +5 -87
  29. package/dist/lib/i18n.js +58 -6
  30. package/dist/main.js +23 -7
  31. package/dist/middleware/rate-limiter.d.ts +4 -1
  32. package/dist/middleware/rate-limiter.js +4 -2
  33. package/dist/routes/agents.d.ts +2 -2
  34. package/dist/routes/audit.d.ts +1 -1
  35. package/dist/routes/audit.js +2 -2
  36. package/dist/routes/auth.d.ts +2 -2
  37. package/dist/routes/auth.js +28 -4
  38. package/dist/routes/context.d.ts +2 -2
  39. package/dist/routes/gateway-patterns.d.ts +3 -3
  40. package/dist/routes/gateway-patterns.js +1 -1
  41. package/dist/routes/llm.d.ts +8 -2
  42. package/dist/routes/llm.js +9 -5
  43. package/dist/routes/mcp-registry.d.ts +6 -6
  44. package/dist/routes/mcp-registry.js +10 -10
  45. package/dist/routes/mcp.d.ts +1 -1
  46. package/dist/routes/mcp.js +1 -1
  47. package/dist/routes/messages.d.ts +5 -4
  48. package/dist/routes/messages.js +30 -3
  49. package/dist/routes/models.d.ts +7 -2
  50. package/dist/routes/models.js +3 -1
  51. package/dist/routes/projects.d.ts +7 -7
  52. package/dist/routes/projects.js +7 -7
  53. package/dist/routes/providers.d.ts +15 -3
  54. package/dist/routes/providers.js +34 -21
  55. package/dist/routes/queue.d.ts +5 -4
  56. package/dist/routes/queue.js +30 -3
  57. package/dist/routes/sessions.d.ts +14 -4
  58. package/dist/routes/sessions.js +234 -34
  59. package/dist/routes/users.js +1 -1
  60. package/dist/test-helpers/close-server.d.ts +33 -0
  61. package/dist/test-helpers/close-server.js +50 -0
  62. package/package.json +3 -3
@@ -1,87 +1,5 @@
1
- import { readFile, writeFile, rename, mkdir } from 'node:fs/promises';
2
- import { join, dirname } from 'node:path';
3
- import { atomicWrite, AsyncLock } from '@itphx/synth-shared';
4
- export const UI_SCALE_MIN = 0.5;
5
- export const UI_SCALE_MAX = 1.2;
6
- /**
7
- * Валидирует масштаб интерфейса: число в диапазоне 0.5..1.2.
8
- * Некорректное значение → undefined (поле отбрасывается).
9
- */
10
- function sanitizeScale(value) {
11
- if (typeof value === 'number' &&
12
- Number.isFinite(value) &&
13
- value >= UI_SCALE_MIN &&
14
- value <= UI_SCALE_MAX) {
15
- return value;
16
- }
17
- return undefined;
18
- }
19
- /**
20
- * Оставляет только валидные поля умолчаний оформления: locale ru/en,
21
- * themeMode system/light/dark, theme — непустая строка, uiScaleMobile и
22
- * uiScaleDesktop — каждое независимо число в диапазоне 0.5..1.2.
23
- * Некорректные поля отбрасываются (без исключений).
24
- */
25
- function sanitize(raw) {
26
- if (typeof raw !== 'object' || raw === null)
27
- return {};
28
- const src = raw;
29
- const out = {};
30
- if (src.locale === 'ru' || src.locale === 'en') {
31
- out.locale = src.locale;
32
- }
33
- if (src.themeMode === 'system' || src.themeMode === 'light' || src.themeMode === 'dark') {
34
- out.themeMode = src.themeMode;
35
- }
36
- if (typeof src.theme === 'string' && src.theme.trim() !== '') {
37
- out.theme = src.theme;
38
- }
39
- const mobile = sanitizeScale(src.uiScaleMobile);
40
- if (mobile !== undefined) {
41
- out.uiScaleMobile = mobile;
42
- }
43
- const desktop = sanitizeScale(src.uiScaleDesktop);
44
- if (desktop !== undefined) {
45
- out.uiScaleDesktop = desktop;
46
- }
47
- return out;
48
- }
49
- /**
50
- * Умолчания оформления (locale/themeMode/theme/uiScaleMobile/uiScaleDesktop) для всех пользователей.
51
- *
52
- * Хранятся одним JSON-файлом `{dataDir}/defaults.json`. Запись атомарная:
53
- * временный файл `.tmp.{uuid}` → `rename()`. Значения переживают рестарт.
54
- */
55
- export class DefaultsStore {
56
- _opts;
57
- _lock = new AsyncLock();
58
- constructor(_opts) {
59
- this._opts = _opts;
60
- }
61
- _filePath() {
62
- return join(this._opts.dataDir, 'defaults.json');
63
- }
64
- async loadDefaults() {
65
- try {
66
- const data = await readFile(this._filePath(), 'utf-8');
67
- return sanitize(JSON.parse(data));
68
- }
69
- catch {
70
- return {};
71
- }
72
- }
73
- async saveDefaults(patch) {
74
- await this._lock.acquire();
75
- try {
76
- const current = await this.loadDefaults();
77
- const next = { ...current, ...sanitize(patch) };
78
- const path = this._filePath();
79
- await mkdir(dirname(path), { recursive: true });
80
- await atomicWrite((p, d) => writeFile(p, d, 'utf-8'), (o, n) => rename(o, n), path, JSON.stringify(next, null, 2));
81
- return next;
82
- }
83
- finally {
84
- this._lock.release();
85
- }
86
- }
87
- }
1
+ // PROP-032 (W2.3): реализация перенесена в core (`storage/defaults-store.ts`) —
2
+ // это просто `{dataDir}/defaults.json` + атомарная запись, без backend-специфики.
3
+ // Здесь оставлен реэкспорт, чтобы существующие импорты (`../lib/defaults-store.js`)
4
+ // не менялись. См. `@itphx/synth-core`.
5
+ export { DefaultsStore, UI_SCALE_MIN, UI_SCALE_MAX } from '@itphx/synth-core';
package/dist/lib/i18n.js CHANGED
@@ -26,7 +26,8 @@ const en = {
26
26
  'errors.validation.groupsRequired': 'groups is required',
27
27
  'errors.validation.expectedFilesArray': 'expected { files: string[] }',
28
28
  'errors.validation.claimCodeRequired': 'Confirmation code is required',
29
- // AD-089: приём внешних событий
29
+ 'errors.validation.invalidUsername': 'Invalid username',
30
+ // ADR-089: приём внешних событий
30
31
  'errors.validation.invalidEvent': 'Invalid event payload',
31
32
  'errors.validation.invalidBinding': 'Invalid binding payload',
32
33
  'errors.notFound.binding': 'Binding not found',
@@ -36,19 +37,43 @@ const en = {
36
37
  'errors.validation.invalidEventKey': 'Invalid event API key',
37
38
  'errors.validation.invalidEventKeyUpdate': 'Invalid event API key update',
38
39
  'errors.notFound.eventKey': 'Event API key not found',
39
- // AD-052 (этап I): service-key
40
+ // ADR-052 (этап I): service-key
40
41
  'errors.validation.invalidServiceKey': 'Invalid service key payload',
41
42
  'errors.notFound.serviceKey': 'Service key not found',
42
43
  'errors.conflict.serviceKeyLabel': 'Service key label is already used',
43
44
  'errors.forbidden.scopeRequired': 'Insufficient permissions: required scope is missing',
44
45
  'errors.forbidden.projectForbidden': 'Project is not available for this service key',
45
46
  'errors.rateLimited.serviceKey': 'Service key rate limit exceeded',
46
- // AD-052 (этап II): исходящие webhooks
47
+ // PROP-102: отчёты аналитики (только чтение)
48
+ 'errors.validation.invalidAnalyticsPeriod': 'Invalid period: expected a date in YYYY-MM-DD (UTC)',
49
+ 'errors.validation.invalidAnalyticsRange': 'Period start is later than period end',
50
+ 'errors.validation.invalidAnalyticsGroupBy': 'Invalid grouping axis (groupBy)',
51
+ 'errors.validation.invalidAnalyticsOption': 'Invalid report parameter (report/format)',
52
+ 'errors.forbidden.analytics': 'Insufficient permissions for this report',
53
+ // ADR-052 (этап II): исходящие webhooks
47
54
  'errors.validation.invalidWebhook': 'Invalid webhook subscription payload',
48
55
  'errors.notFound.webhook': 'Webhook subscription not found',
49
56
  'errors.conflict.webhookLabel': 'Webhook label is already used',
50
57
  'errors.validation.webhookTargetForbidden': 'Webhook target URL is not allowed by security policy',
51
58
  'errors.unavailable.webhooksDisabled': 'Webhook delivery is disabled',
59
+ // ADR-091/ADR-092: обслуживание инстанса (backup/restore/doctor/migrate)
60
+ 'errors.validation.invalidMaintenanceBody': 'Invalid maintenance request payload',
61
+ 'errors.validation.maintenanceConfirmRequired': 'Confirmation is required (confirm: true)',
62
+ 'errors.validation.invalidBackupName': 'Invalid backup archive name',
63
+ 'errors.validation.invalidRestoreArchive': 'Backup archive failed validation',
64
+ 'errors.notFound.backup': 'Backup archive not found',
65
+ 'errors.conflict.schemaTooNew': 'Instance data is newer than this Synth version; update Synth',
66
+ 'errors.payloadTooLarge': 'Uploaded file exceeds the allowed size',
67
+ 'errors.validation.invalidAuditLimit': 'Invalid limit value (an integer 1..500)',
68
+ 'errors.validation.invalidAuditOp': 'Unknown maintenance journal operation',
69
+ 'errors.validation.encryptedRestoreUnsupported': 'The archive is encrypted — decryption is available only via the CLI (synth restore <archive.enc>); the key is not available to the server.',
70
+ 'errors.unavailable.restartUnsupported': 'Restart is unavailable: the instance runs without a supervisor (SYNTH_RESTART_MODE=disabled).',
71
+ // ADR-091 (этап 2): перенос проекта (экспорт/импорт)
72
+ 'errors.validation.projectImportBody': 'Invalid project import request (multipart archive file is required)',
73
+ 'errors.validation.invalidProjectArchive': 'Project archive is invalid or corrupted',
74
+ 'errors.validation.projectArchiveChecksum': 'Project archive checksum mismatch',
75
+ 'errors.validation.projectWorkspaceRestore': 'Failed to restore the project workspace',
76
+ 'errors.conflict.projectNameInUse': 'A project with this name already exists',
52
77
  // Conflict errors
53
78
  'errors.conflict.usernameExists': 'A user with this username already exists',
54
79
  'errors.conflict.emailExists': 'A user with this email already exists',
@@ -62,6 +87,7 @@ const en = {
62
87
  'errors.faviconFetchError': 'Error fetching favicon',
63
88
  'errors.generic': 'Error',
64
89
  'errors.rateLimited.eventKey': 'Event API key rate limit exceeded',
90
+ 'errors.rateLimited.identityClaim': 'Too many identity confirmation attempts, try again later',
65
91
  'errors.unavailable.eventsDisabled': 'External event ingestion is disabled',
66
92
  // Auth
67
93
  'auth.unauthorized': 'Authentication required',
@@ -108,7 +134,8 @@ const ru = {
108
134
  'errors.validation.groupsRequired': 'groups обязательны',
109
135
  'errors.validation.expectedFilesArray': 'expected { files: string[] }',
110
136
  'errors.validation.claimCodeRequired': 'Укажите код подтверждения',
111
- // AD-089: приём внешних событий
137
+ 'errors.validation.invalidUsername': 'Некорректное имя пользователя',
138
+ // ADR-089: приём внешних событий
112
139
  'errors.validation.invalidEvent': 'Некорректное тело события',
113
140
  'errors.validation.invalidBinding': 'Некорректное тело биндинга',
114
141
  'errors.notFound.binding': 'Биндинг не найден',
@@ -118,19 +145,43 @@ const ru = {
118
145
  'errors.validation.invalidEventKey': 'Неверный API-ключ события',
119
146
  'errors.validation.invalidEventKeyUpdate': 'Некорректное тело обновления API-ключа события',
120
147
  'errors.notFound.eventKey': 'API-ключ события не найден',
121
- // AD-052 (этап I): service-key
148
+ // ADR-052 (этап I): service-key
122
149
  'errors.validation.invalidServiceKey': 'Некорректное тело service-key',
123
150
  'errors.notFound.serviceKey': 'Service-key не найден',
124
151
  'errors.conflict.serviceKeyLabel': 'Метка service-key уже используется',
125
152
  'errors.forbidden.scopeRequired': 'Недостаточно прав: отсутствует требуемый scope',
126
153
  'errors.forbidden.projectForbidden': 'Проект недоступен для этого service-key',
127
154
  'errors.rateLimited.serviceKey': 'Превышен лимит запросов по service-key',
128
- // AD-052 (этап II): исходящие webhooks
155
+ // PROP-102: отчёты аналитики (только чтение)
156
+ 'errors.validation.invalidAnalyticsPeriod': 'Некорректный период: ожидается дата YYYY-MM-DD (UTC)',
157
+ 'errors.validation.invalidAnalyticsRange': 'Начало периода позже конца периода',
158
+ 'errors.validation.invalidAnalyticsGroupBy': 'Некорректная ось группировки (groupBy)',
159
+ 'errors.validation.invalidAnalyticsOption': 'Некорректный параметр отчёта (report/format)',
160
+ 'errors.forbidden.analytics': 'Недостаточно прав для отчёта',
161
+ // ADR-052 (этап II): исходящие webhooks
129
162
  'errors.validation.invalidWebhook': 'Некорректное тело webhook-подписки',
130
163
  'errors.notFound.webhook': 'Webhook-подписка не найдена',
131
164
  'errors.conflict.webhookLabel': 'Метка webhook уже используется',
132
165
  'errors.validation.webhookTargetForbidden': 'Целевой URL webhook запрещён политикой безопасности',
133
166
  'errors.unavailable.webhooksDisabled': 'Доставка webhooks отключена',
167
+ // ADR-091/ADR-092: обслуживание инстанса (backup/restore/doctor/migrate)
168
+ 'errors.validation.invalidMaintenanceBody': 'Некорректное тело запроса обслуживания',
169
+ 'errors.validation.maintenanceConfirmRequired': 'Требуется подтверждение (confirm: true)',
170
+ 'errors.validation.invalidBackupName': 'Некорректное имя архива',
171
+ 'errors.validation.invalidRestoreArchive': 'Архив не прошёл проверку',
172
+ 'errors.notFound.backup': 'Архив не найден',
173
+ 'errors.conflict.schemaTooNew': 'Данные новее версии Synth; обновите Synth',
174
+ 'errors.payloadTooLarge': 'Загруженный файл превышает допустимый размер',
175
+ 'errors.validation.invalidAuditLimit': 'Некорректное значение limit (целое 1..500)',
176
+ 'errors.validation.invalidAuditOp': 'Неизвестная операция журнала обслуживания',
177
+ 'errors.validation.encryptedRestoreUnsupported': 'Архив зашифрован — расшифровка доступна только через CLI (synth restore <archive.enc>); ключ серверу недоступен.',
178
+ 'errors.unavailable.restartUnsupported': 'Рестарт недоступен: инстанс запущен без супервизора (SYNTH_RESTART_MODE=disabled).',
179
+ // ADR-091 (этап 2): перенос проекта (экспорт/импорт)
180
+ 'errors.validation.projectImportBody': 'Некорректный запрос импорта проекта (нужен multipart-файл архива)',
181
+ 'errors.validation.invalidProjectArchive': 'Архив проекта недействителен или повреждён',
182
+ 'errors.validation.projectArchiveChecksum': 'Контрольная сумма архива проекта не совпадает',
183
+ 'errors.validation.projectWorkspaceRestore': 'Не удалось восстановить рабочий каталог проекта',
184
+ 'errors.conflict.projectNameInUse': 'Проект с таким именем уже существует',
134
185
  // Conflict errors
135
186
  'errors.conflict.usernameExists': 'Пользователь с таким именем уже существует',
136
187
  'errors.conflict.emailExists': 'Пользователь с таким email уже существует',
@@ -144,6 +195,7 @@ const ru = {
144
195
  'errors.faviconFetchError': 'Ошибка получения favicon',
145
196
  'errors.generic': 'Ошибка',
146
197
  'errors.rateLimited.eventKey': 'Превышен лимит запросов по API-ключу события',
198
+ 'errors.rateLimited.identityClaim': 'Слишком много попыток подтверждения идентичности, повторите позже',
147
199
  'errors.unavailable.eventsDisabled': 'Приём внешних событий отключён',
148
200
  // Auth
149
201
  'auth.unauthorized': 'Требуется аутентификация',
package/dist/main.js CHANGED
@@ -4,15 +4,19 @@
4
4
  // живёт в app.ts — это позволяет поднимать backend in-process в интеграционных
5
5
  // тестах без запуска процесса.
6
6
  import { createBackendApp } from './app.js';
7
+ import { configureRestart, resolveRestartMode, RESTART_EXIT_CODE, setSynthReady, } from '@itphx/synth-core';
7
8
  const host = process.env.SYNTH_HOST || '0.0.0.0';
8
9
  const handle = await createBackendApp();
9
- const { app, dataDir, port, config, auth, eventHub, queueManager, sessionManager, stopEphemeralSweeper, stopEventJournalPruner, stopScheduler, stopWebhookService, stopWebhookDeliveryPruner } = handle;
10
+ const { app, dataDir, port, config, auth, eventHub, queueManager, sessionManager, stopEphemeralSweeper, stopEventJournalPruner, stopAnalyticsRollupPruner, stopScheduler, stopWebhookService, stopWebhookDeliveryPruner, stopMetrics } = handle;
10
11
  let shuttingDown = false;
11
- async function gracefulShutdown(signal) {
12
+ async function gracefulShutdown(signal, exitCode = 0) {
12
13
  if (shuttingDown)
13
14
  return;
14
15
  shuttingDown = true;
15
16
  console.log(`\n[Shutdown] Получен сигнал ${signal}, начинаю graceful shutdown...`);
17
+ // ADR-094: снять readiness до остановки сервера/коллекторов — скрейп в момент
18
+ // shutdown видит `synth_ready 0`.
19
+ setSynthReady(handle.metrics, 0);
16
20
  server.close((err) => {
17
21
  if (err)
18
22
  console.error('[Shutdown] Server close error:', err);
@@ -26,13 +30,18 @@ async function gracefulShutdown(signal) {
26
30
  console.log('[Shutdown] WebSocket-сервер остановлен');
27
31
  queueManager.stopAll();
28
32
  console.log('[Shutdown] Очередь остановлена');
29
- // AD-089: остановить авто-архивацию ephemeral-сессий.
33
+ // ADR-089: остановить авто-архивацию ephemeral-сессий.
30
34
  stopEphemeralSweeper();
31
- // AD-089: остановить retention-очистку журнала событий.
35
+ // ADR-089: остановить retention-очистку журнала событий.
32
36
  stopEventJournalPruner();
33
- // AD-051 (срез): остановить планировщик расписаний.
37
+ // PROP-102: остановить retention-очистку роллапов аналитики.
38
+ stopAnalyticsRollupPruner();
39
+ // ADR-094: остановить процессные метрики и фоновые доменные коллекторы
40
+ // (таймеры сессий/хранилища, подписка шины, decision/journal).
41
+ stopMetrics();
42
+ // ADR-051 (срез): остановить планировщик расписаний.
34
43
  stopScheduler();
35
- // AD-052 (этап II): остановить движок исходящих webhooks и retention-очистку.
44
+ // ADR-052 (этап II): остановить движок исходящих webhooks и retention-очистку.
36
45
  stopWebhookService();
37
46
  stopWebhookDeliveryPruner();
38
47
  const drainTimeout = 10_000;
@@ -50,7 +59,7 @@ async function gracefulShutdown(signal) {
50
59
  ]);
51
60
  }
52
61
  console.log('[Shutdown] Завершено. Выход.');
53
- process.exit(0);
62
+ process.exit(exitCode);
54
63
  }
55
64
  async function waitForStreamsDrain() {
56
65
  while (true) {
@@ -70,6 +79,13 @@ app.post('/admin/shutdown', auth.requireAdmin, async (c) => {
70
79
  app.get('/admin/sessions/blocked', auth.requireAdmin, (c) => c.json({ sessions: [], count: 0 }));
71
80
  process.on('SIGTERM', () => { void gracefulShutdown('SIGTERM'); });
72
81
  process.on('SIGINT', () => { void gracefulShutdown('SIGINT'); });
82
+ // Restart из UI: режим — `SYNTH_RESTART_MODE` (default `disabled`; managed-деплой
83
+ // задаёт `process` — K8s/Docker перезапускают контейнер), рестарт — graceful
84
+ // shutdown с кодом 75. `/admin/shutdown` остаётся обычным выходом с кодом 0.
85
+ configureRestart({
86
+ mode: resolveRestartMode(process.env),
87
+ request: () => gracefulShutdown('API', RESTART_EXIT_CODE),
88
+ });
73
89
  console.log(`synth-backend starting on http://${host}:${port}`);
74
90
  console.log(` data dir: ${dataDir}`);
75
91
  console.log(` debug mode: ${config.auth.debugMode}`);
@@ -1,8 +1,11 @@
1
+ import type { Context } from 'hono';
1
2
  /**
2
3
  * In-memory rate limiter.
3
4
  * Ключ — Authorization header (уникален для каждого пользователя/ключа).
5
+ * `message` — опциональный резолвер локализованного текста (i18n); по умолчанию —
6
+ * общий русский текст (обратная совместимость).
4
7
  */
5
- export declare function createRateLimiter(maxRequests?: number, windowMs?: number): import("hono").MiddlewareHandler<any, string, {}, Response | (Response & import("hono").TypedResponse<{
8
+ export declare function createRateLimiter(maxRequests?: number, windowMs?: number, message?: (c: Context) => string): import("hono").MiddlewareHandler<any, string, {}, Response | (Response & import("hono").TypedResponse<{
6
9
  error: {
7
10
  code: string;
8
11
  message: string;
@@ -2,8 +2,10 @@ import { createMiddleware } from 'hono/factory';
2
2
  /**
3
3
  * In-memory rate limiter.
4
4
  * Ключ — Authorization header (уникален для каждого пользователя/ключа).
5
+ * `message` — опциональный резолвер локализованного текста (i18n); по умолчанию —
6
+ * общий русский текст (обратная совместимость).
5
7
  */
6
- export function createRateLimiter(maxRequests = 20, windowMs = 60_000) {
8
+ export function createRateLimiter(maxRequests = 20, windowMs = 60_000, message) {
7
9
  const hits = new Map();
8
10
  setInterval(() => {
9
11
  const now = Date.now();
@@ -24,7 +26,7 @@ export function createRateLimiter(maxRequests = 20, windowMs = 60_000) {
24
26
  }
25
27
  entry.count += 1;
26
28
  if (entry.count > maxRequests) {
27
- return c.json({ error: { code: 'RATE_LIMITED', message: 'Превышен лимит запросов' } }, 429);
29
+ return c.json({ error: { code: 'RATE_LIMITED', message: message ? message(c) : 'Превышен лимит запросов' } }, 429);
28
30
  }
29
31
  await next();
30
32
  });
@@ -1,6 +1,6 @@
1
1
  import { Hono } from 'hono';
2
2
  import type { AuthKit } from '../auth/middleware.js';
3
- import { JsonStore } from '@itphx/synth-core';
3
+ import type { JsonStoreLike } from '@itphx/synth-core';
4
4
  import type { AgentDefinition } from '@itphx/synth-shared';
5
5
  import type { AgentRegistry } from '@itphx/synth-core';
6
6
  /**
@@ -8,4 +8,4 @@ import type { AgentRegistry } from '@itphx/synth-core';
8
8
  * (админ-эндпоинты — ADMIN) и i18n-сообщения. Логика роутов
9
9
  * (GET /, GET /all, POST /, GET /:id, DELETE /:id, PATCH /:id/enabled) — в core.
10
10
  */
11
- export declare function createAgentRoutes(kit: AuthKit, agentStore: JsonStore<AgentDefinition>, agentRegistry?: AgentRegistry, getDefaultAgentId?: () => string | Promise<string>): Hono;
11
+ export declare function createAgentRoutes(kit: AuthKit, agentStore: JsonStoreLike<AgentDefinition>, agentRegistry?: AgentRegistry, getDefaultAgentId?: () => string | Promise<string>): Hono;
@@ -10,7 +10,7 @@ export interface AuditRoutesDeps {
10
10
  logger: AuditLogger;
11
11
  }
12
12
  /**
13
- * GET /api/v2/audit — просмотр аудита LLM Gateway (AD-036).
13
+ * GET /api/v2/audit — просмотр аудита LLM Gateway (ADR-036).
14
14
  * RBAC: только ADMIN/AUDITOR.
15
15
  * Фильтры: userId, sessionId, since/until (ISO), limit (дефолт 100, макс 500).
16
16
  */
@@ -9,7 +9,7 @@ function toInt(value, fallback) {
9
9
  return Number.isFinite(n) ? n : fallback;
10
10
  }
11
11
  /**
12
- * GET /api/v2/audit — просмотр аудита LLM Gateway (AD-036).
12
+ * GET /api/v2/audit — просмотр аудита LLM Gateway (ADR-036).
13
13
  * RBAC: только ADMIN/AUDITOR.
14
14
  * Фильтры: userId, sessionId, since/until (ISO), limit (дефолт 100, макс 500).
15
15
  */
@@ -28,7 +28,7 @@ export function createAuditRoutes(kit, deps) {
28
28
  return c.json({ entries, total });
29
29
  });
30
30
  /**
31
- * POST /api/v2/audit/revealed — логирование раскрытия плейсхолдера (AD-036).
31
+ * POST /api/v2/audit/revealed — логирование раскрытия плейсхолдера (ADR-036).
32
32
  * RBAC: любой авторизованный (клик по бейджу SecretPlaceholder делает
33
33
  * пользователь сессии), userId фиксируется из токена.
34
34
  * Тело: { sessionId, placeholder } (placeholder вида ⟦SYNTH_SECRET_N⟧).
@@ -2,5 +2,5 @@ import { Hono } from 'hono';
2
2
  import type { AuthKit } from '../auth/middleware.js';
3
3
  import type { AuthConfig } from '@itphx/synth-shared';
4
4
  import type { ProfileStore } from '@itphx/synth-shared';
5
- import type { DefaultsStore } from '../lib/defaults-store.js';
6
- export declare function createAuthRoutes(kit: AuthKit, config: AuthConfig, profiles?: ProfileStore, dataDir?: string, defaultsStore?: DefaultsStore | null): Hono;
5
+ import type { DefaultsRepository } from '@itphx/synth-core';
6
+ export declare function createAuthRoutes(kit: AuthKit, config: AuthConfig, profiles?: ProfileStore, dataDir?: string, defaultsStore?: DefaultsRepository | null): Hono;
@@ -5,7 +5,7 @@ import { getCookie, setCookie, deleteCookie } from 'hono/cookie';
5
5
  import { t } from '../lib/i18n.js';
6
6
  import { getDefaultLang, setDefaultLang } from '../lib/i18n-config.js';
7
7
  import { readFile, writeFile, unlink } from 'node:fs/promises';
8
- import { join } from 'node:path';
8
+ import { join, resolve, sep } from 'node:path';
9
9
  const OIDC_STATE_COOKIE = 'oidc_state';
10
10
  // Встроенные умолчания оформления (совпадают с тем, что использует UI
11
11
  // по умолчанию: packages/ui/src/lib/defaults.ts + uiScale.ts).
@@ -18,6 +18,24 @@ const BUILT_IN_DEFAULTS = {
18
18
  export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore) {
19
19
  const app = new Hono();
20
20
  const avatarsDir = dataDir ? join(dataDir, 'auth', 'avatars') : null;
21
+ // Корень каталога аватаров (абсолютный) — для containment-проверки.
22
+ const avatarsRoot = avatarsDir ? resolve(avatarsDir) : null;
23
+ /**
24
+ * Безопасный абсолютный путь к файлу аватара по `username`.
25
+ * Отклоняет пустое имя, разделители пути (`/`, `\`) и `.`/`..` (traversal),
26
+ * а также результат вне каталога аватаров (defense-in-depth). `null` — отказ.
27
+ */
28
+ const resolveAvatarPath = (username) => {
29
+ if (!avatarsRoot)
30
+ return null;
31
+ const name = username.trim();
32
+ if (!name || name === '.' || name === '..')
33
+ return null;
34
+ if (/[/\\\0]/.test(name))
35
+ return null;
36
+ const full = resolve(avatarsRoot, `${name}.png`);
37
+ return full.startsWith(avatarsRoot + sep) ? full : null;
38
+ };
21
39
  // Сохранённые умолчания перекрывают встроенные; uiScaleMobile/uiScaleDesktop: null — умолчание не задано.
22
40
  const resolveDefaults = async () => {
23
41
  const stored = defaultsStore ? await defaultsStore.loadDefaults() : {};
@@ -387,7 +405,10 @@ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore)
387
405
  return c.json({ error: { code: 'UNAUTHORIZED' } }, 401);
388
406
  if (!avatarsDir)
389
407
  return c.body(null, 404);
390
- const avatarPath = join(avatarsDir, `${user.username}.png`);
408
+ const avatarPath = resolveAvatarPath(user.username);
409
+ if (!avatarPath) {
410
+ return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidUsername', undefined, c) } }, 400);
411
+ }
391
412
  try {
392
413
  const data = await readFile(avatarPath);
393
414
  return new Response(data, {
@@ -405,11 +426,15 @@ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore)
405
426
  return c.json({ error: { code: 'UNAUTHORIZED' } }, 401);
406
427
  if (!avatarsDir)
407
428
  return c.json({ error: { code: 'INTERNAL_ERROR' } }, 500);
429
+ const avatarPath = resolveAvatarPath(user.username);
430
+ if (!avatarPath) {
431
+ return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidUsername', undefined, c) } }, 400);
432
+ }
408
433
  try {
409
434
  const buffer = await c.req.arrayBuffer();
410
435
  if (buffer.byteLength === 0) {
411
436
  // Удаление аватара
412
- await unlink(join(avatarsDir, `${user.username}.png`)).catch(() => { });
437
+ await unlink(avatarPath).catch(() => { });
413
438
  if (profiles) {
414
439
  const profile = await profiles.getOrCreateProfile({ username: user.username, roles: user.roles });
415
440
  const prefs = { ...(profile.preferences || {}), avatar: '' };
@@ -418,7 +443,6 @@ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore)
418
443
  }
419
444
  return c.json({ status: 'ok' });
420
445
  }
421
- const avatarPath = join(avatarsDir, `${user.username}.png`);
422
446
  await writeFile(avatarPath, Buffer.from(buffer));
423
447
  if (profiles) {
424
448
  const profile = await profiles.getOrCreateProfile({ username: user.username, roles: user.roles });
@@ -1,4 +1,4 @@
1
1
  import { Hono } from 'hono';
2
2
  import type { AuthKit } from '../auth/middleware.js';
3
- import type { ContextConfig } from '@itphx/synth-core';
4
- export declare function createContextRoutes(kit: AuthKit, config: ContextConfig): Hono;
3
+ import type { ContextFileRepository } from '@itphx/synth-core';
4
+ export declare function createContextRoutes(kit: AuthKit, config: ContextFileRepository): Hono;
@@ -1,9 +1,9 @@
1
1
  import { Hono } from 'hono';
2
2
  import type { AuthKit } from '../auth/middleware.js';
3
- import type { SecretPatternStore } from '@itphx/synth-core';
3
+ import type { SecretPatternRepository } from '@itphx/synth-core';
4
4
  /**
5
- * LLM Gateway (AD-036) — управление regex-паттернами детекции секретов.
5
+ * LLM Gateway (ADR-036) — управление regex-паттернами детекции секретов.
6
6
  * Схема «системный + override»: пользовательский список полностью заменяет дефолтный,
7
7
  * DELETE сбрасывает к встроенным паттернам. Только ADMIN.
8
8
  */
9
- export declare function createGatewayPatternsRoutes(kit: AuthKit, store: SecretPatternStore): Hono;
9
+ export declare function createGatewayPatternsRoutes(kit: AuthKit, store: SecretPatternRepository): Hono;
@@ -16,7 +16,7 @@ function isValidPattern(p) {
16
16
  }
17
17
  }
18
18
  /**
19
- * LLM Gateway (AD-036) — управление regex-паттернами детекции секретов.
19
+ * LLM Gateway (ADR-036) — управление regex-паттернами детекции секретов.
20
20
  * Схема «системный + override»: пользовательский список полностью заменяет дефолтный,
21
21
  * DELETE сбрасывает к встроенным паттернам. Только ADMIN.
22
22
  */
@@ -2,7 +2,8 @@ import { Hono } from 'hono';
2
2
  import type { AuthKit } from '../auth/middleware.js';
3
3
  import { createRateLimiter } from '../middleware/rate-limiter.js';
4
4
  import type { LLMGatewayConfig, ModelConfig, ProviderConfig as SharedProviderConfig } from '@itphx/synth-shared';
5
- import { AuditLogger, RateLimiter, SecretPatternStore } from '@itphx/synth-core';
5
+ import { AuditLogger, RateLimiter } from '@itphx/synth-core';
6
+ import type { MetricsRegistry, SecretPatternRepository } from '@itphx/synth-core';
6
7
  export interface LlmRoutesDeps {
7
8
  /** Резолв провайдера по имени (backend providerCache). */
8
9
  providerLoader: (name: string) => SharedProviderConfig | null;
@@ -17,8 +18,13 @@ export interface LlmRoutesDeps {
17
18
  /** Путь к JSONL полного лога запросов/ответов LLM. */
18
19
  gatewayPayloadLogPath?: string;
19
20
  /** Хранилище кастомных regex-паттернов детекции секретов (null — дефолт детектора). */
20
- patternStore: SecretPatternStore | null;
21
+ patternStore: SecretPatternRepository | null;
21
22
  /** HTTP-мидлварь лимита запросов на ключ/пользователя (необязательно). */
22
23
  rateLimiter?: ReturnType<typeof createRateLimiter>;
24
+ /**
25
+ * ADR-094: реестр метрик для учёта LLM-вызовов через прокси (`onCall`).
26
+ * Не задан (метрики выключены) — нулевые накладные расходы.
27
+ */
28
+ metrics?: MetricsRegistry;
23
29
  }
24
30
  export declare function createLlmRoutes(kit: AuthKit, deps: LlmRoutesDeps): Hono;
@@ -1,11 +1,11 @@
1
1
  import { Hono } from 'hono';
2
2
  import { z } from 'zod';
3
3
  import { scopeGuard } from '../auth/service-scope.js';
4
- import { ContextLengthExceededError, deobfuscateSecrets, GatewayProvider, ProviderError, ProviderFactory, RateLimitError, } from '@itphx/synth-core';
4
+ import { ContextLengthExceededError, deobfuscateSecrets, GatewayProvider, ProviderError, ProviderFactory, RateLimitError, createLlmCallRecorder, } from '@itphx/synth-core';
5
5
  /**
6
6
  * LLM Proxy endpoint (гибридный режим, Часть 5).
7
7
  * OpenAI-совместимый POST /api/v2/llm/chat/completions, через который локальный
8
- * core гоняет LLM-запросы централизованно — с применением LLM Gateway (AD-036):
8
+ * core гоняет LLM-запросы централизованно — с применением LLM Gateway (ADR-036):
9
9
  * обфускация/блокировка секретов, rate limit, аудит, полный payload-лог.
10
10
  */
11
11
  /**
@@ -30,7 +30,7 @@ const chatCompletionsSchema = z.object({
30
30
  max_tokens: z.number().int().positive().optional(),
31
31
  top_p: z.number().optional(),
32
32
  stream: z.boolean().optional(),
33
- // AD-070: remote-зеркала (RemoteProvider) просят usage в стриме. Внутренний
33
+ // ADR-070: remote-зеркала (RemoteProvider) просят usage в стриме. Внутренний
34
34
  // OpenAIProvider всегда шлёт stream_options.include_usage, но поле принимаем
35
35
  // явно, чтобы Zod его не срезал (контракт запроса).
36
36
  stream_options: z.object({ include_usage: z.boolean().optional() }).optional(),
@@ -100,7 +100,7 @@ function toLlmMessages(raw) {
100
100
  }
101
101
  export function createLlmRoutes(kit, deps) {
102
102
  const app = new Hono();
103
- // AD-052: `llm:chat` — scope service-key; обычные креды scope не ограничивают.
103
+ // ADR-052: `llm:chat` — scope service-key; обычные креды scope не ограничивают.
104
104
  const middlewares = [scopeGuard('llm:chat'), ...(deps.rateLimiter ? [deps.rateLimiter] : [])];
105
105
  // POST /api/v2/llm/chat/completions — OpenAI-совместимый LLM Proxy
106
106
  app.post('/chat/completions', kit.requireAuth, ...middlewares, async (c) => {
@@ -166,6 +166,7 @@ export function createLlmRoutes(kit, deps) {
166
166
  model: modelConfig.name,
167
167
  timeout: providerConfig.timeout ?? 120,
168
168
  maxTokens: body.max_tokens,
169
+ numCtx: providerConfig.numCtx,
169
170
  }, body.temperature, body.top_p);
170
171
  }
171
172
  catch (e) {
@@ -176,7 +177,7 @@ export function createLlmRoutes(kit, deps) {
176
177
  },
177
178
  }, 502);
178
179
  }
179
- // 3. AD-036: оборачиваем провайдер в GatewayProvider.
180
+ // 3. ADR-036: оборачиваем провайдер в GatewayProvider.
180
181
  // У локального core нет карты обфускации, поэтому для прокси держим
181
182
  // transient-карту на время запроса: getMap/saveMap читают/пишут её, а после
182
183
  // ответа деобфусцируем контент по той же карте (иначе клиент увидел бы
@@ -192,6 +193,9 @@ export function createLlmRoutes(kit, deps) {
192
193
  getRateLimiter: () => deps.gatewayRateLimiter,
193
194
  getPatterns: patternStore ? () => patternStore.getPatterns() : undefined,
194
195
  payloadLogPath: deps.gatewayPayloadLogPath,
196
+ // ADR-094: метрики LLM-вызова (ok/error/rate_limited/blocked + duration/tokens);
197
+ // при выключенных метриках колбэк не создаётся.
198
+ onCall: deps.metrics ? createLlmCallRecorder(deps.metrics) : undefined,
195
199
  sessionId,
196
200
  userId: user.id,
197
201
  });
@@ -1,16 +1,16 @@
1
1
  import { Hono } from 'hono';
2
2
  import type { AuthKit } from '../auth/middleware.js';
3
- import type { SessionManager, McpManager, McpRegistryStore } from '@itphx/synth-core';
3
+ import type { SessionManager, McpManager, McpRegistryRepository } from '@itphx/synth-core';
4
4
  import type { McpNetworkPolicy } from '@itphx/synth-shared';
5
5
  export interface McpRoutesOptions {
6
- /** AD-071 §2.5: единый реестр MCP-серверов (источник истины для `/servers` и `/registry`). */
7
- registry: McpRegistryStore;
8
- /** AD-071 §2.3.1: политика сетевого доступа HTTP-серверов. */
6
+ /** ADR-071 §2.5: единый реестр MCP-серверов (источник истины для `/servers` и `/registry`). */
7
+ registry: McpRegistryRepository;
8
+ /** ADR-071 §2.3.1: политика сетевого доступа HTTP-серверов. */
9
9
  networkPolicy?: McpNetworkPolicy;
10
10
  /**
11
- * AD-071 §2.3.1: динамический источник политики (runtime-настройка из админки).
11
+ * ADR-071 §2.3.1: динамический источник политики (runtime-настройка из админки).
12
12
  * Приоритетнее статической `networkPolicy`; читается на каждый запрос.
13
13
  */
14
- getNetworkPolicy?: () => McpNetworkPolicy | undefined;
14
+ getNetworkPolicy?: () => Promise<McpNetworkPolicy | undefined>;
15
15
  }
16
16
  export declare function createMcpRegistryRoutes(kit: AuthKit, mcpManager: McpManager | null, sessionManager: SessionManager | null, options: McpRoutesOptions): Hono;