@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.
- package/dist/app/bootstrap.d.ts +11 -0
- package/dist/app/bootstrap.js +19 -0
- package/dist/app/deps.d.ts +124 -0
- package/dist/app/deps.js +751 -0
- package/dist/app/listen.d.ts +34 -0
- package/dist/app/listen.js +309 -0
- package/dist/app/mount-routes.d.ts +31 -0
- package/dist/app/mount-routes.js +696 -0
- package/dist/app/sse-events.d.ts +15 -0
- package/dist/app/sse-events.js +83 -0
- package/dist/app.d.ts +30 -17
- package/dist/app.js +164 -1337
- package/dist/auth/guards.d.ts +2 -1
- package/dist/auth/guards.js +10 -2
- package/dist/auth/middleware.d.ts +9 -14
- package/dist/auth/middleware.js +38 -6
- package/dist/auth/oidc.d.ts +22 -0
- package/dist/auth/oidc.js +68 -9
- package/dist/auth/service-scope.d.ts +8 -4
- package/dist/auth/service-scope.js +9 -5
- package/dist/events/hub.d.ts +2 -2
- package/dist/events/hub.js +3 -38
- package/dist/lib/app-config.d.ts +2 -0
- package/dist/lib/app-config.js +3 -2
- package/dist/lib/cors.d.ts +23 -0
- package/dist/lib/cors.js +24 -0
- package/dist/lib/defaults-store.d.ts +2 -25
- package/dist/lib/defaults-store.js +5 -87
- package/dist/lib/i18n.js +58 -6
- package/dist/main.js +23 -7
- package/dist/middleware/rate-limiter.d.ts +4 -1
- package/dist/middleware/rate-limiter.js +4 -2
- package/dist/routes/agents.d.ts +2 -2
- package/dist/routes/audit.d.ts +1 -1
- package/dist/routes/audit.js +2 -2
- package/dist/routes/auth.d.ts +2 -2
- package/dist/routes/auth.js +28 -4
- package/dist/routes/context.d.ts +2 -2
- package/dist/routes/gateway-patterns.d.ts +3 -3
- package/dist/routes/gateway-patterns.js +1 -1
- package/dist/routes/llm.d.ts +8 -2
- package/dist/routes/llm.js +9 -5
- package/dist/routes/mcp-registry.d.ts +6 -6
- package/dist/routes/mcp-registry.js +10 -10
- package/dist/routes/mcp.d.ts +1 -1
- package/dist/routes/mcp.js +1 -1
- package/dist/routes/messages.d.ts +5 -4
- package/dist/routes/messages.js +30 -3
- package/dist/routes/models.d.ts +7 -2
- package/dist/routes/models.js +3 -1
- package/dist/routes/projects.d.ts +7 -7
- package/dist/routes/projects.js +7 -7
- package/dist/routes/providers.d.ts +15 -3
- package/dist/routes/providers.js +34 -21
- package/dist/routes/queue.d.ts +5 -4
- package/dist/routes/queue.js +30 -3
- package/dist/routes/sessions.d.ts +14 -4
- package/dist/routes/sessions.js +234 -34
- package/dist/routes/users.js +1 -1
- package/dist/test-helpers/close-server.d.ts +33 -0
- package/dist/test-helpers/close-server.js +50 -0
- package/package.json +3 -3
|
@@ -1,87 +1,5 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
export
|
|
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
|
-
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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
|
-
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
33
|
+
// ADR-089: остановить авто-архивацию ephemeral-сессий.
|
|
30
34
|
stopEphemeralSweeper();
|
|
31
|
-
//
|
|
35
|
+
// ADR-089: остановить retention-очистку журнала событий.
|
|
32
36
|
stopEventJournalPruner();
|
|
33
|
-
//
|
|
37
|
+
// PROP-102: остановить retention-очистку роллапов аналитики.
|
|
38
|
+
stopAnalyticsRollupPruner();
|
|
39
|
+
// ADR-094: остановить процессные метрики и фоновые доменные коллекторы
|
|
40
|
+
// (таймеры сессий/хранилища, подписка шины, decision/journal).
|
|
41
|
+
stopMetrics();
|
|
42
|
+
// ADR-051 (срез): остановить планировщик расписаний.
|
|
34
43
|
stopScheduler();
|
|
35
|
-
//
|
|
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(
|
|
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
|
});
|
package/dist/routes/agents.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
|
-
import {
|
|
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:
|
|
11
|
+
export declare function createAgentRoutes(kit: AuthKit, agentStore: JsonStoreLike<AgentDefinition>, agentRegistry?: AgentRegistry, getDefaultAgentId?: () => string | Promise<string>): Hono;
|
package/dist/routes/audit.d.ts
CHANGED
|
@@ -10,7 +10,7 @@ export interface AuditRoutesDeps {
|
|
|
10
10
|
logger: AuditLogger;
|
|
11
11
|
}
|
|
12
12
|
/**
|
|
13
|
-
* GET /api/v2/audit — просмотр аудита LLM Gateway (
|
|
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
|
*/
|
package/dist/routes/audit.js
CHANGED
|
@@ -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 (
|
|
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 — логирование раскрытия плейсхолдера (
|
|
31
|
+
* POST /api/v2/audit/revealed — логирование раскрытия плейсхолдера (ADR-036).
|
|
32
32
|
* RBAC: любой авторизованный (клик по бейджу SecretPlaceholder делает
|
|
33
33
|
* пользователь сессии), userId фиксируется из токена.
|
|
34
34
|
* Тело: { sessionId, placeholder } (placeholder вида ⟦SYNTH_SECRET_N⟧).
|
package/dist/routes/auth.d.ts
CHANGED
|
@@ -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 {
|
|
6
|
-
export declare function createAuthRoutes(kit: AuthKit, config: AuthConfig, profiles?: ProfileStore, dataDir?: string, defaultsStore?:
|
|
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;
|
package/dist/routes/auth.js
CHANGED
|
@@ -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 =
|
|
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(
|
|
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 });
|
package/dist/routes/context.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
|
-
import type {
|
|
4
|
-
export declare function createContextRoutes(kit: AuthKit, config:
|
|
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 {
|
|
3
|
+
import type { SecretPatternRepository } from '@itphx/synth-core';
|
|
4
4
|
/**
|
|
5
|
-
* LLM Gateway (
|
|
5
|
+
* LLM Gateway (ADR-036) — управление regex-паттернами детекции секретов.
|
|
6
6
|
* Схема «системный + override»: пользовательский список полностью заменяет дефолтный,
|
|
7
7
|
* DELETE сбрасывает к встроенным паттернам. Только ADMIN.
|
|
8
8
|
*/
|
|
9
|
-
export declare function createGatewayPatternsRoutes(kit: AuthKit, store:
|
|
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 (
|
|
19
|
+
* LLM Gateway (ADR-036) — управление regex-паттернами детекции секретов.
|
|
20
20
|
* Схема «системный + override»: пользовательский список полностью заменяет дефолтный,
|
|
21
21
|
* DELETE сбрасывает к встроенным паттернам. Только ADMIN.
|
|
22
22
|
*/
|
package/dist/routes/llm.d.ts
CHANGED
|
@@ -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
|
|
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:
|
|
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;
|
package/dist/routes/llm.js
CHANGED
|
@@ -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 (
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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.
|
|
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,
|
|
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
|
-
/**
|
|
7
|
-
registry:
|
|
8
|
-
/**
|
|
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
|
-
*
|
|
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;
|