@itphx/synth-backend 0.10.1 → 0.12.4
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 +2 -2
- package/dist/app/deps.d.ts +77 -33
- package/dist/app/deps.js +969 -102
- package/dist/app/listen.d.ts +13 -2
- package/dist/app/listen.js +138 -10
- package/dist/app/mount-routes.d.ts +16 -3
- package/dist/app/mount-routes.js +625 -32
- package/dist/app.d.ts +42 -7
- package/dist/app.js +149 -12
- package/dist/auth/guards.d.ts +17 -1
- package/dist/auth/guards.js +46 -2
- package/dist/auth/middleware.d.ts +2 -12
- package/dist/auth/middleware.js +20 -2
- package/dist/auth/oidc.d.ts +7 -0
- package/dist/auth/oidc.js +27 -6
- package/dist/auth/plugin-scope.d.ts +10 -0
- package/dist/auth/plugin-scope.js +69 -0
- package/dist/auth/service-scope.d.ts +7 -3
- package/dist/auth/service-scope.js +8 -4
- 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/defaults-store.d.ts +2 -25
- package/dist/lib/defaults-store.js +5 -87
- package/dist/lib/i18n.js +153 -0
- package/dist/main.js +67 -4
- package/dist/routes/agents.d.ts +12 -3
- package/dist/routes/agents.js +14 -2
- package/dist/routes/auth.d.ts +12 -2
- package/dist/routes/auth.js +16 -2
- package/dist/routes/context.d.ts +2 -2
- package/dist/routes/gateway-patterns.d.ts +2 -2
- package/dist/routes/llm.d.ts +8 -2
- package/dist/routes/llm.js +6 -3
- package/dist/routes/mcp-registry.d.ts +15 -3
- package/dist/routes/mcp-registry.js +122 -21
- package/dist/routes/messages.d.ts +7 -4
- package/dist/routes/messages.js +34 -3
- package/dist/routes/models.d.ts +7 -2
- package/dist/routes/models.js +3 -1
- package/dist/routes/processes.d.ts +34 -0
- package/dist/routes/processes.js +26 -0
- package/dist/routes/projects.d.ts +9 -3
- package/dist/routes/projects.js +8 -1
- package/dist/routes/providers.d.ts +15 -3
- package/dist/routes/providers.js +33 -21
- package/dist/routes/queue.d.ts +5 -4
- package/dist/routes/queue.js +30 -3
- package/dist/routes/sessions.d.ts +50 -3
- package/dist/routes/sessions.js +221 -74
- package/dist/test-helpers/close-server.d.ts +33 -0
- package/dist/test-helpers/close-server.js +50 -0
- package/package.json +4 -4
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { createMiddleware } from 'hono/factory';
|
|
2
|
+
import { checkPluginTokenBinding } from '@itphx/synth-core';
|
|
3
|
+
import { PLUGIN_TOKEN_ERROR_CODES } from '@itphx/synth-core';
|
|
4
|
+
import { t } from '../lib/i18n.js';
|
|
5
|
+
/**
|
|
6
|
+
* ADR-090 Ф7 (Уровень 2): guard server-scoped токена плагина — backend-обёртка
|
|
7
|
+
* над core-проверкой {@link checkPluginTokenBinding}.
|
|
8
|
+
*
|
|
9
|
+
* Enforcement (сверка заголовка `X-Synth-Plugin-Id`, scope `plugins:invoke` и
|
|
10
|
+
* серверного allow-list) остаётся в **core** — здесь только локализация
|
|
11
|
+
* отказов (как у `scopeGuard`/`serviceProjectProjection`). Для интерактивных
|
|
12
|
+
* кред (нет `serviceKey` в контексте) и для обычных service-key (без привязки
|
|
13
|
+
* к плагину) guard — no-op.
|
|
14
|
+
*
|
|
15
|
+
* Правило **fail-closed**: ключ с привязкой `plugin_id` без корректного
|
|
16
|
+
* заголовка отвергается всегда.
|
|
17
|
+
*/
|
|
18
|
+
/** Локализованный 403 по коду отказа core-проверки. */
|
|
19
|
+
function localizedDenial(c, code) {
|
|
20
|
+
if (code === PLUGIN_TOKEN_ERROR_CODES.scopeRequired) {
|
|
21
|
+
return c.json({
|
|
22
|
+
error: {
|
|
23
|
+
code: PLUGIN_TOKEN_ERROR_CODES.scopeRequired,
|
|
24
|
+
message: t('errors.forbidden.scopeRequired', undefined, c),
|
|
25
|
+
},
|
|
26
|
+
}, 403);
|
|
27
|
+
}
|
|
28
|
+
if (code === PLUGIN_TOKEN_ERROR_CODES.notAllowed) {
|
|
29
|
+
return c.json({
|
|
30
|
+
error: {
|
|
31
|
+
code: PLUGIN_TOKEN_ERROR_CODES.notAllowed,
|
|
32
|
+
message: t('errors.forbidden.pluginNotAllowed', undefined, c),
|
|
33
|
+
},
|
|
34
|
+
}, 403);
|
|
35
|
+
}
|
|
36
|
+
return c.json({
|
|
37
|
+
error: {
|
|
38
|
+
code: PLUGIN_TOKEN_ERROR_CODES.idMismatch,
|
|
39
|
+
message: t('errors.forbidden.pluginIdMismatch', undefined, c),
|
|
40
|
+
},
|
|
41
|
+
}, 403);
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Guard plugin-bound токена (Ф7): монтируется **после** резолва
|
|
45
|
+
* service-кредентал и **до** роутов, поэтому правило действует на все
|
|
46
|
+
* серверные API, а не только на плагинные.
|
|
47
|
+
*
|
|
48
|
+
* `getPolicy` — живой серверный allow-list (`plugins.hybrid`); политика
|
|
49
|
+
* меняется рестартом (инвариант 24), поэтому берётся из работающего рантайма.
|
|
50
|
+
*/
|
|
51
|
+
export function requirePluginTokenBinding(getPolicy) {
|
|
52
|
+
return createMiddleware(async (c, next) => {
|
|
53
|
+
const denied = checkPluginTokenBinding(c, getPolicy());
|
|
54
|
+
if (!denied) {
|
|
55
|
+
await next();
|
|
56
|
+
return;
|
|
57
|
+
}
|
|
58
|
+
let code = PLUGIN_TOKEN_ERROR_CODES.idMismatch;
|
|
59
|
+
try {
|
|
60
|
+
const body = (await denied.clone().json());
|
|
61
|
+
if (body?.error?.code)
|
|
62
|
+
code = body.error.code;
|
|
63
|
+
}
|
|
64
|
+
catch {
|
|
65
|
+
// Тело ответа нечитаемо — отказ по умолчанию (несовпадение plugin_id).
|
|
66
|
+
}
|
|
67
|
+
return localizedDenial(c, code);
|
|
68
|
+
});
|
|
69
|
+
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type {
|
|
1
|
+
import type { ServiceProjectProjectionGuard, ScopeGuardFactory } from '@itphx/synth-core';
|
|
2
2
|
/**
|
|
3
3
|
* ADR-052 (этап I): backend-обёртки scope-гейтов service-key.
|
|
4
4
|
*
|
|
@@ -10,5 +10,9 @@ import type { ProjectGuard, ScopeGuardFactory } from '@itphx/synth-core';
|
|
|
10
10
|
*/
|
|
11
11
|
/** Scope-гейт: делегирует проверку core-`requireScope`, переводит 403 на i18n. */
|
|
12
12
|
export declare const scopeGuard: ScopeGuardFactory;
|
|
13
|
-
/**
|
|
14
|
-
|
|
13
|
+
/**
|
|
14
|
+
* Гейт **проектной проекции service-key**: делегирует core-
|
|
15
|
+
* `checkServiceProjectProjection`, переводит 403. Это не проверка прав
|
|
16
|
+
* пользователя (RBAC): для интерактивных кред — no-op.
|
|
17
|
+
*/
|
|
18
|
+
export declare const serviceProjectProjection: ServiceProjectProjectionGuard;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { createMiddleware } from 'hono/factory';
|
|
2
|
-
import { requireScope,
|
|
2
|
+
import { requireScope, checkServiceProjectProjection } from '@itphx/synth-core';
|
|
3
3
|
import { t } from '../lib/i18n.js';
|
|
4
4
|
/**
|
|
5
5
|
* ADR-052 (этап I): backend-обёртки scope-гейтов service-key.
|
|
@@ -26,9 +26,13 @@ export const scopeGuard = (...required) => {
|
|
|
26
26
|
await next();
|
|
27
27
|
});
|
|
28
28
|
};
|
|
29
|
-
/**
|
|
30
|
-
|
|
31
|
-
|
|
29
|
+
/**
|
|
30
|
+
* Гейт **проектной проекции service-key**: делегирует core-
|
|
31
|
+
* `checkServiceProjectProjection`, переводит 403. Это не проверка прав
|
|
32
|
+
* пользователя (RBAC): для интерактивных кред — no-op.
|
|
33
|
+
*/
|
|
34
|
+
export const serviceProjectProjection = (c, projectId) => {
|
|
35
|
+
const denied = checkServiceProjectProjection(c, projectId);
|
|
32
36
|
if (!denied)
|
|
33
37
|
return undefined;
|
|
34
38
|
return c.json({
|
package/dist/events/hub.js
CHANGED
|
@@ -1,42 +1,6 @@
|
|
|
1
|
+
import { extractChildSessionId } from '@itphx/synth-core';
|
|
1
2
|
/** Служебный ключ глобальной подписки all-клиента в `clientSubs`. */
|
|
2
3
|
const ALL_SESSIONS_KEY = '*';
|
|
3
|
-
/** Безопасное чтение непустой строки из `unknown`. */
|
|
4
|
-
function readString(value) {
|
|
5
|
-
return typeof value === 'string' && value.length > 0 ? value : undefined;
|
|
6
|
-
}
|
|
7
|
-
/**
|
|
8
|
-
* Извлечь id новой дочерней сессии из события, опубликованного в родительскую
|
|
9
|
-
* сессию. Дочерние сессии саб-агентов создаются тулом `task` напрямую через
|
|
10
|
-
* `SessionManager`, минуя роуты, поэтому клиент изначально на них не подписан.
|
|
11
|
-
* Тул `task` публикует `session.created` (payload — serializeSession ребёнка) в
|
|
12
|
-
* родителя ДО старта LLM-стрима ребёнка, так что автоподписка успевает.
|
|
13
|
-
* `child.session.updated` несёт `session` (id внутри), `child.message.added` и
|
|
14
|
-
* resume-события — `child_session_id`. Ключи каждого события читаются ровно в
|
|
15
|
-
* одном месте (типизированные payload-интерфейсы выше).
|
|
16
|
-
*/
|
|
17
|
-
function extractChildSessionId(event) {
|
|
18
|
-
const data = event.data;
|
|
19
|
-
if (!data)
|
|
20
|
-
return undefined;
|
|
21
|
-
switch (event.type) {
|
|
22
|
-
case 'session.created': {
|
|
23
|
-
const payload = data;
|
|
24
|
-
return readString(payload.id);
|
|
25
|
-
}
|
|
26
|
-
case 'child.session.updated': {
|
|
27
|
-
const payload = data;
|
|
28
|
-
return readString(payload.session?.id) ?? readString(payload.child_session_id);
|
|
29
|
-
}
|
|
30
|
-
case 'child.message.added':
|
|
31
|
-
case 'subagent.resume.started':
|
|
32
|
-
case 'subagent.resume.finished': {
|
|
33
|
-
const payload = data;
|
|
34
|
-
return readString(payload.child_session_id);
|
|
35
|
-
}
|
|
36
|
-
default:
|
|
37
|
-
return undefined;
|
|
38
|
-
}
|
|
39
|
-
}
|
|
40
4
|
/**
|
|
41
5
|
* EventHub — центральный диспетчер подписок на события сессий.
|
|
42
6
|
* Управляет active-клиентами пользователя (WS и SSE),
|
|
@@ -64,7 +28,8 @@ export class EventHub {
|
|
|
64
28
|
console.log(`[EventHub] Register client (all sessions): user=${client.username} clients=${arr.length}`);
|
|
65
29
|
return;
|
|
66
30
|
}
|
|
67
|
-
|
|
31
|
+
// Нужны только id сессий владельца — лёгкая выборка (без истории сообщений).
|
|
32
|
+
const sessions = await this.sessionManager.listSessions({ userId: client.userId }, { light: true });
|
|
68
33
|
console.log(`[EventHub] Register client: user=${client.username} clients=${arr.length} sessions=${sessions.length}`);
|
|
69
34
|
for (const s of sessions) {
|
|
70
35
|
this._subscribeClientToSession(client, s.id);
|
package/dist/lib/app-config.d.ts
CHANGED
package/dist/lib/app-config.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { loadConfig, resolveDataDir, resolvePort, resolveWorkspacesRoot } from '@itphx/synth-shared';
|
|
1
|
+
import { loadConfig, resolveDataDir, resolvePort, resolveWorkspacesRoot, resolveMaxUploadBytes } from '@itphx/synth-shared';
|
|
2
2
|
const envStr = (key, fallback = '') => process.env[key] || fallback;
|
|
3
3
|
const envBool = (key, fallback = false) => process.env[key] ? process.env[key] === 'true' : fallback;
|
|
4
4
|
const envInt = (key, fallback) => {
|
|
@@ -59,6 +59,7 @@ export async function loadBackendConfig(options) {
|
|
|
59
59
|
const auth = buildAuthConfig(synth.auth);
|
|
60
60
|
const dataDir = resolveDataDir(synth);
|
|
61
61
|
const workspacesRoot = resolveWorkspacesRoot(synth);
|
|
62
|
+
const maxUploadBytes = resolveMaxUploadBytes(synth);
|
|
62
63
|
const port = resolvePort(synth, 'SYNTH_PORT', synth.server.port);
|
|
63
|
-
return { synth, dataDir, workspacesRoot, port, auth };
|
|
64
|
+
return { synth, dataDir, workspacesRoot, maxUploadBytes, port, auth };
|
|
64
65
|
}
|
|
@@ -1,25 +1,2 @@
|
|
|
1
|
-
export
|
|
2
|
-
|
|
3
|
-
themeMode?: 'system' | 'light' | 'dark';
|
|
4
|
-
theme?: string;
|
|
5
|
-
uiScaleMobile?: number;
|
|
6
|
-
uiScaleDesktop?: number;
|
|
7
|
-
}
|
|
8
|
-
export declare const UI_SCALE_MIN = 0.5;
|
|
9
|
-
export declare const UI_SCALE_MAX = 1.2;
|
|
10
|
-
/**
|
|
11
|
-
* Умолчания оформления (locale/themeMode/theme/uiScaleMobile/uiScaleDesktop) для всех пользователей.
|
|
12
|
-
*
|
|
13
|
-
* Хранятся одним JSON-файлом `{dataDir}/defaults.json`. Запись атомарная:
|
|
14
|
-
* временный файл `.tmp.{uuid}` → `rename()`. Значения переживают рестарт.
|
|
15
|
-
*/
|
|
16
|
-
export declare class DefaultsStore {
|
|
17
|
-
private _opts;
|
|
18
|
-
private _lock;
|
|
19
|
-
constructor(_opts: {
|
|
20
|
-
dataDir: string;
|
|
21
|
-
});
|
|
22
|
-
private _filePath;
|
|
23
|
-
loadDefaults(): Promise<AppearanceDefaults>;
|
|
24
|
-
saveDefaults(patch: AppearanceDefaults): Promise<AppearanceDefaults>;
|
|
25
|
-
}
|
|
1
|
+
export { DefaultsStore, UI_SCALE_MIN, UI_SCALE_MAX } from '@itphx/synth-core';
|
|
2
|
+
export type { AppearanceDefaults } from '@itphx/synth-core';
|
|
@@ -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
|
+
// ADR-096 (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
|
@@ -19,6 +19,7 @@ const en = {
|
|
|
19
19
|
'errors.validation.nameRequired': 'name is required',
|
|
20
20
|
'errors.validation.idRequired': 'id is required',
|
|
21
21
|
'errors.validation.invalidAgentId': 'Agent ID may contain only Latin letters, digits, hyphen and underscore',
|
|
22
|
+
'errors.validation.invalidRoleFile': 'Role file name must be a plain file name without paths and ".."',
|
|
22
23
|
'errors.validation.urlRequired': 'url is required',
|
|
23
24
|
'errors.validation.invalidUrl': 'Invalid URL',
|
|
24
25
|
'errors.validation.apiKeyRequired': 'api_key is required',
|
|
@@ -40,16 +41,88 @@ const en = {
|
|
|
40
41
|
// ADR-052 (этап I): service-key
|
|
41
42
|
'errors.validation.invalidServiceKey': 'Invalid service key payload',
|
|
42
43
|
'errors.notFound.serviceKey': 'Service key not found',
|
|
44
|
+
'errors.notFound.credential': 'External access not found',
|
|
43
45
|
'errors.conflict.serviceKeyLabel': 'Service key label is already used',
|
|
44
46
|
'errors.forbidden.scopeRequired': 'Insufficient permissions: required scope is missing',
|
|
45
47
|
'errors.forbidden.projectForbidden': 'Project is not available for this service key',
|
|
46
48
|
'errors.rateLimited.serviceKey': 'Service key rate limit exceeded',
|
|
49
|
+
// ADR-090 Ф7 (Уровень 2): server-scoped токен плагина
|
|
50
|
+
'errors.forbidden.pluginIdMismatch': 'Plugin token: the X-Synth-Plugin-Id header does not match the key plugin_id',
|
|
51
|
+
'errors.forbidden.pluginNotAllowed': 'Plugin token: the plugin is not in the server allow-list',
|
|
52
|
+
// ADR-101 (Э6): пайплайны проекта, прогоны, шаблоны инстанса
|
|
53
|
+
'errors.notFound.pipeline': 'Pipeline not found',
|
|
54
|
+
'errors.notFound.pipelineRun': 'Pipeline run not found',
|
|
55
|
+
'errors.notFound.pipelineTemplate': 'Pipeline template not found',
|
|
56
|
+
'errors.validation.invalidPipelineBody': 'Invalid pipeline request payload',
|
|
57
|
+
'errors.validation.invalidPipelineSpec': 'Invalid pipeline specification',
|
|
58
|
+
'errors.validation.projectIdRequired': 'projectId is required',
|
|
59
|
+
'errors.conflict.pipelineNotPublished': 'The pipeline has no published version',
|
|
60
|
+
'errors.conflict.pipelineInvalidState': 'The run is not waiting for a human decision',
|
|
61
|
+
'errors.conflict.pipelineNothingToPublish': 'There is no draft to publish',
|
|
62
|
+
'errors.conflict.pipelineRunFinished': 'The run is already finished',
|
|
63
|
+
'errors.conflict.pipelineTemplateUnsupported': 'The template cannot be instantiated as a pipeline',
|
|
64
|
+
// PROP-096/097: единый реестр фоновых прогонов
|
|
65
|
+
'errors.notFound.backgroundRun': 'Background run not found',
|
|
66
|
+
'errors.notFound.backgroundRunSession': 'Session of the background run not found',
|
|
67
|
+
'errors.validation.invalidBackgroundRunQuery': 'Invalid background run filter',
|
|
68
|
+
'errors.validation.backgroundRunLogKind': 'Logs are available for background processes only',
|
|
69
|
+
'errors.notFound.processLog': 'Background process log not found',
|
|
70
|
+
'errors.conflict.backgroundRunFinished': 'The background run is already finished',
|
|
71
|
+
'errors.conflict.backgroundRunNotStoppable': 'The background run is not controlled by this instance',
|
|
72
|
+
'errors.conflict.backgroundRunActive': 'The background run is still running',
|
|
73
|
+
// ADR-102: отчёты аналитики (только чтение)
|
|
74
|
+
'errors.validation.invalidAnalyticsPeriod': 'Invalid period: expected a date in YYYY-MM-DD (UTC)',
|
|
75
|
+
'errors.validation.invalidAnalyticsRange': 'Period start is later than period end',
|
|
76
|
+
'errors.validation.invalidAnalyticsGroupBy': 'Invalid grouping axis (groupBy)',
|
|
77
|
+
'errors.validation.invalidAnalyticsOption': 'Invalid report parameter (report/format)',
|
|
78
|
+
'errors.forbidden.analytics': 'Insufficient permissions for this report',
|
|
79
|
+
// ADR-107 / PROP-047: портал памяти (чтение + мутации индексов, М2)
|
|
80
|
+
'errors.validation.invalidMemoryStatus': 'Invalid memory fact status filter',
|
|
81
|
+
'errors.validation.invalidMemoryState': 'Invalid memory index state filter',
|
|
82
|
+
'errors.validation.invalidMemoryLimit': 'Invalid limit value (an integer 1..200)',
|
|
83
|
+
'errors.validation.invalidMemoryOffset': 'Invalid offset value (an integer >= 0)',
|
|
84
|
+
'errors.notFound.memoryFact': 'Memory fact not found',
|
|
85
|
+
'errors.unavailable.memory': 'Memory storage is unavailable',
|
|
86
|
+
'errors.validation.invalidMemoryBody': 'Invalid memory request payload',
|
|
87
|
+
'errors.validation.invalidMemorySource': 'Invalid memory index source (expected files or facts)',
|
|
88
|
+
'errors.validation.memoryProjectRequired': 'A memory index is built in a project: projectId is required',
|
|
89
|
+
'errors.notFound.memoryProject': 'Project not found',
|
|
90
|
+
'errors.validation.memoryWorkspaceRequired': 'The project has no workspace: a file index cannot be built',
|
|
91
|
+
'errors.unavailable.memoryProvider': 'The memory provider is unavailable: the memory plugin is not active',
|
|
92
|
+
'errors.notFound.memoryIndex': 'Memory index not found',
|
|
93
|
+
'errors.failed.memoryIndex': 'Failed to perform the memory index operation',
|
|
94
|
+
'memory.indexCreated': 'Memory index created',
|
|
95
|
+
'errors.validation.invalidMemoryThreshold': 'Invalid memory consolidation threshold (expected a number 0.5..0.99)',
|
|
96
|
+
'errors.failed.memoryConsolidation': 'Failed to consolidate memory',
|
|
97
|
+
'memory.consolidated': 'Memory consolidation completed',
|
|
98
|
+
'errors.validation.invalidMemoryGraphDepth': 'Invalid memory graph depth (an integer 1..3)',
|
|
99
|
+
'errors.validation.invalidMemoryGraphLimit': 'Invalid memory graph limit (an integer 1..200)',
|
|
100
|
+
'errors.validation.invalidMemoryGraphEntity': 'Invalid memory graph entity (a non-empty string of at most 200 characters)',
|
|
101
|
+
'errors.failed.memoryGraph': 'Failed to read the memory graph',
|
|
47
102
|
// ADR-052 (этап II): исходящие webhooks
|
|
48
103
|
'errors.validation.invalidWebhook': 'Invalid webhook subscription payload',
|
|
49
104
|
'errors.notFound.webhook': 'Webhook subscription not found',
|
|
50
105
|
'errors.conflict.webhookLabel': 'Webhook label is already used',
|
|
51
106
|
'errors.validation.webhookTargetForbidden': 'Webhook target URL is not allowed by security policy',
|
|
52
107
|
'errors.unavailable.webhooksDisabled': 'Webhook delivery is disabled',
|
|
108
|
+
// ADR-091/ADR-092: обслуживание инстанса (backup/restore/doctor/migrate)
|
|
109
|
+
'errors.validation.invalidMaintenanceBody': 'Invalid maintenance request payload',
|
|
110
|
+
'errors.validation.maintenanceConfirmRequired': 'Confirmation is required (confirm: true)',
|
|
111
|
+
'errors.validation.invalidBackupName': 'Invalid backup archive name',
|
|
112
|
+
'errors.validation.invalidRestoreArchive': 'Backup archive failed validation',
|
|
113
|
+
'errors.notFound.backup': 'Backup archive not found',
|
|
114
|
+
'errors.conflict.schemaTooNew': 'Instance data is newer than this Synth version; update Synth',
|
|
115
|
+
'errors.payloadTooLarge': 'Uploaded file exceeds the allowed size',
|
|
116
|
+
'errors.validation.invalidAuditLimit': 'Invalid limit value (an integer 1..500)',
|
|
117
|
+
'errors.validation.invalidAuditOp': 'Unknown maintenance journal operation',
|
|
118
|
+
'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.',
|
|
119
|
+
'errors.unavailable.restartUnsupported': 'Restart is unavailable: the instance runs without a supervisor (SYNTH_RESTART_MODE=disabled).',
|
|
120
|
+
// ADR-091 (этап 2): перенос проекта (экспорт/импорт)
|
|
121
|
+
'errors.validation.projectImportBody': 'Invalid project import request (multipart archive file is required)',
|
|
122
|
+
'errors.validation.invalidProjectArchive': 'Project archive is invalid or corrupted',
|
|
123
|
+
'errors.validation.projectArchiveChecksum': 'Project archive checksum mismatch',
|
|
124
|
+
'errors.validation.projectWorkspaceRestore': 'Failed to restore the project workspace',
|
|
125
|
+
'errors.conflict.projectNameInUse': 'A project with this name already exists',
|
|
53
126
|
// Conflict errors
|
|
54
127
|
'errors.conflict.usernameExists': 'A user with this username already exists',
|
|
55
128
|
'errors.conflict.emailExists': 'A user with this email already exists',
|
|
@@ -79,6 +152,9 @@ const en = {
|
|
|
79
152
|
'locales.ru.nativeName': 'Russian',
|
|
80
153
|
// Chat
|
|
81
154
|
'errors.chat.queueFull': 'Queue is full (max {max} messages)',
|
|
155
|
+
'errors.chat.steerLimitExceeded': 'Steering limit reached (max {max} injected messages per turn)',
|
|
156
|
+
// ADR-106 Ф3: подтверждение не принято (нет гранта / повторный ответ / чужой ход).
|
|
157
|
+
'errors.chat.approvalDenied': 'Approval was not accepted: {reason}',
|
|
82
158
|
// Stub
|
|
83
159
|
'stub.llmNotConnected': '[Stub] You said: "{content}". LLM engine is not connected yet.',
|
|
84
160
|
};
|
|
@@ -103,6 +179,7 @@ const ru = {
|
|
|
103
179
|
'errors.validation.nameRequired': 'name обязателен',
|
|
104
180
|
'errors.validation.idRequired': 'id обязателен',
|
|
105
181
|
'errors.validation.invalidAgentId': 'ID агента может содержать только латиницу, цифры, дефис и подчёркивание',
|
|
182
|
+
'errors.validation.invalidRoleFile': 'Имя файла роли должно быть именем файла без путей и «..»',
|
|
106
183
|
'errors.validation.urlRequired': 'URL не указан',
|
|
107
184
|
'errors.validation.invalidUrl': 'Некорректный URL',
|
|
108
185
|
'errors.validation.apiKeyRequired': 'api_key обязателен',
|
|
@@ -124,16 +201,89 @@ const ru = {
|
|
|
124
201
|
// ADR-052 (этап I): service-key
|
|
125
202
|
'errors.validation.invalidServiceKey': 'Некорректное тело service-key',
|
|
126
203
|
'errors.notFound.serviceKey': 'Service-key не найден',
|
|
204
|
+
// ADR-105 (Ф3): внешний доступ (OAuth-кред) не найден.
|
|
205
|
+
'errors.notFound.credential': 'Внешний доступ не найден',
|
|
127
206
|
'errors.conflict.serviceKeyLabel': 'Метка service-key уже используется',
|
|
128
207
|
'errors.forbidden.scopeRequired': 'Недостаточно прав: отсутствует требуемый scope',
|
|
129
208
|
'errors.forbidden.projectForbidden': 'Проект недоступен для этого service-key',
|
|
130
209
|
'errors.rateLimited.serviceKey': 'Превышен лимит запросов по service-key',
|
|
210
|
+
// ADR-090 Ф7 (Уровень 2): server-scoped токен плагина
|
|
211
|
+
'errors.forbidden.pluginIdMismatch': 'Токен плагина: заголовок X-Synth-Plugin-Id не совпадает с plugin_id ключа',
|
|
212
|
+
'errors.forbidden.pluginNotAllowed': 'Токен плагина: плагина нет в серверном allow-list',
|
|
213
|
+
// ADR-101 (Э6): пайплайны проекта, прогоны, шаблоны инстанса
|
|
214
|
+
'errors.notFound.pipeline': 'Пайплайн не найден',
|
|
215
|
+
'errors.notFound.pipelineRun': 'Прогон пайплайна не найден',
|
|
216
|
+
'errors.notFound.pipelineTemplate': 'Шаблон пайплайна не найден',
|
|
217
|
+
'errors.validation.invalidPipelineBody': 'Некорректное тело запроса пайплайна',
|
|
218
|
+
'errors.validation.invalidPipelineSpec': 'Некорректная спецификация пайплайна',
|
|
219
|
+
'errors.validation.projectIdRequired': 'Не указан projectId',
|
|
220
|
+
'errors.conflict.pipelineNotPublished': 'У пайплайна нет опубликованной версии',
|
|
221
|
+
'errors.conflict.pipelineInvalidState': 'Прогон не ожидает решения человека',
|
|
222
|
+
'errors.conflict.pipelineNothingToPublish': 'Нет черновика для публикации',
|
|
223
|
+
'errors.conflict.pipelineRunFinished': 'Прогон уже завершён',
|
|
224
|
+
'errors.conflict.pipelineTemplateUnsupported': 'Шаблон нельзя инстанцировать в пайплайн',
|
|
225
|
+
// PROP-096/097: единый реестр фоновых прогонов
|
|
226
|
+
'errors.notFound.backgroundRun': 'Фоновый прогон не найден',
|
|
227
|
+
'errors.notFound.backgroundRunSession': 'Сессия фонового прогона не найдена',
|
|
228
|
+
'errors.validation.invalidBackgroundRunQuery': 'Некорректный фильтр фоновых прогонов',
|
|
229
|
+
'errors.validation.backgroundRunLogKind': 'Логи доступны только для фоновых процессов',
|
|
230
|
+
'errors.notFound.processLog': 'Лог фонового процесса не найден',
|
|
231
|
+
'errors.conflict.backgroundRunFinished': 'Фоновый прогон уже завершён',
|
|
232
|
+
'errors.conflict.backgroundRunNotStoppable': 'Фоновый прогон не контролируется этим инстансом',
|
|
233
|
+
'errors.conflict.backgroundRunActive': 'Фоновый прогон ещё выполняется',
|
|
234
|
+
// ADR-102: отчёты аналитики (только чтение)
|
|
235
|
+
'errors.validation.invalidAnalyticsPeriod': 'Некорректный период: ожидается дата YYYY-MM-DD (UTC)',
|
|
236
|
+
'errors.validation.invalidAnalyticsRange': 'Начало периода позже конца периода',
|
|
237
|
+
'errors.validation.invalidAnalyticsGroupBy': 'Некорректная ось группировки (groupBy)',
|
|
238
|
+
'errors.validation.invalidAnalyticsOption': 'Некорректный параметр отчёта (report/format)',
|
|
239
|
+
'errors.forbidden.analytics': 'Недостаточно прав для отчёта',
|
|
240
|
+
// ADR-107 / PROP-047: портал памяти (чтение + мутации индексов, М2)
|
|
241
|
+
'errors.validation.invalidMemoryStatus': 'Некорректный фильтр статуса факта памяти',
|
|
242
|
+
'errors.validation.invalidMemoryState': 'Некорректный фильтр состояния индекса памяти',
|
|
243
|
+
'errors.validation.invalidMemoryLimit': 'Некорректное значение limit (целое 1..200)',
|
|
244
|
+
'errors.validation.invalidMemoryOffset': 'Некорректное значение offset (целое ≥ 0)',
|
|
245
|
+
'errors.notFound.memoryFact': 'Факт памяти не найден',
|
|
246
|
+
'errors.unavailable.memory': 'Хранилище памяти недоступно',
|
|
247
|
+
'errors.validation.invalidMemoryBody': 'Некорректное тело запроса памяти',
|
|
248
|
+
'errors.validation.invalidMemorySource': 'Некорректный источник индекса памяти (ожидается files или facts)',
|
|
249
|
+
'errors.validation.memoryProjectRequired': 'Индекс памяти строится в проекте: укажите projectId',
|
|
250
|
+
'errors.notFound.memoryProject': 'Проект не найден',
|
|
251
|
+
'errors.validation.memoryWorkspaceRequired': 'У проекта нет рабочего каталога: индекс файлов строить негде',
|
|
252
|
+
'errors.unavailable.memoryProvider': 'Провайдер памяти недоступен: плагин памяти не активен',
|
|
253
|
+
'errors.notFound.memoryIndex': 'Индекс памяти не найден',
|
|
254
|
+
'errors.failed.memoryIndex': 'Не удалось выполнить операцию с индексом памяти',
|
|
255
|
+
'memory.indexCreated': 'Индекс памяти создан',
|
|
256
|
+
'errors.validation.invalidMemoryThreshold': 'Некорректный порог консолидации памяти (ожидается число 0.5..0.99)',
|
|
257
|
+
'errors.failed.memoryConsolidation': 'Не удалось выполнить консолидацию памяти',
|
|
258
|
+
'memory.consolidated': 'Консолидация памяти выполнена',
|
|
259
|
+
'errors.validation.invalidMemoryGraphDepth': 'Некорректная глубина графа памяти (целое 1..3)',
|
|
260
|
+
'errors.validation.invalidMemoryGraphLimit': 'Некорректное значение limit графа памяти (целое 1..200)',
|
|
261
|
+
'errors.validation.invalidMemoryGraphEntity': 'Некорректная сущность графа памяти (непустая строка длиной до 200 символов)',
|
|
262
|
+
'errors.failed.memoryGraph': 'Не удалось прочитать граф памяти',
|
|
131
263
|
// ADR-052 (этап II): исходящие webhooks
|
|
132
264
|
'errors.validation.invalidWebhook': 'Некорректное тело webhook-подписки',
|
|
133
265
|
'errors.notFound.webhook': 'Webhook-подписка не найдена',
|
|
134
266
|
'errors.conflict.webhookLabel': 'Метка webhook уже используется',
|
|
135
267
|
'errors.validation.webhookTargetForbidden': 'Целевой URL webhook запрещён политикой безопасности',
|
|
136
268
|
'errors.unavailable.webhooksDisabled': 'Доставка webhooks отключена',
|
|
269
|
+
// ADR-091/ADR-092: обслуживание инстанса (backup/restore/doctor/migrate)
|
|
270
|
+
'errors.validation.invalidMaintenanceBody': 'Некорректное тело запроса обслуживания',
|
|
271
|
+
'errors.validation.maintenanceConfirmRequired': 'Требуется подтверждение (confirm: true)',
|
|
272
|
+
'errors.validation.invalidBackupName': 'Некорректное имя архива',
|
|
273
|
+
'errors.validation.invalidRestoreArchive': 'Архив не прошёл проверку',
|
|
274
|
+
'errors.notFound.backup': 'Архив не найден',
|
|
275
|
+
'errors.conflict.schemaTooNew': 'Данные новее версии Synth; обновите Synth',
|
|
276
|
+
'errors.payloadTooLarge': 'Загруженный файл превышает допустимый размер',
|
|
277
|
+
'errors.validation.invalidAuditLimit': 'Некорректное значение limit (целое 1..500)',
|
|
278
|
+
'errors.validation.invalidAuditOp': 'Неизвестная операция журнала обслуживания',
|
|
279
|
+
'errors.validation.encryptedRestoreUnsupported': 'Архив зашифрован — расшифровка доступна только через CLI (synth restore <archive.enc>); ключ серверу недоступен.',
|
|
280
|
+
'errors.unavailable.restartUnsupported': 'Рестарт недоступен: инстанс запущен без супервизора (SYNTH_RESTART_MODE=disabled).',
|
|
281
|
+
// ADR-091 (этап 2): перенос проекта (экспорт/импорт)
|
|
282
|
+
'errors.validation.projectImportBody': 'Некорректный запрос импорта проекта (нужен multipart-файл архива)',
|
|
283
|
+
'errors.validation.invalidProjectArchive': 'Архив проекта недействителен или повреждён',
|
|
284
|
+
'errors.validation.projectArchiveChecksum': 'Контрольная сумма архива проекта не совпадает',
|
|
285
|
+
'errors.validation.projectWorkspaceRestore': 'Не удалось восстановить рабочий каталог проекта',
|
|
286
|
+
'errors.conflict.projectNameInUse': 'Проект с таким именем уже существует',
|
|
137
287
|
// Conflict errors
|
|
138
288
|
'errors.conflict.usernameExists': 'Пользователь с таким именем уже существует',
|
|
139
289
|
'errors.conflict.emailExists': 'Пользователь с таким email уже существует',
|
|
@@ -163,6 +313,9 @@ const ru = {
|
|
|
163
313
|
'locales.ru.nativeName': 'Русский',
|
|
164
314
|
// Chat
|
|
165
315
|
'errors.chat.queueFull': 'Очередь переполнена (максимум {max} сообщений)',
|
|
316
|
+
'errors.chat.steerLimitExceeded': 'Достигнут лимит вмешательств в ход (максимум {max} сообщений на ход)',
|
|
317
|
+
// ADR-106 Ф3: подтверждение не принято (нет гранта / повторный ответ / чужой ход).
|
|
318
|
+
'errors.chat.approvalDenied': 'Подтверждение не принято: {reason}',
|
|
166
319
|
// Stub
|
|
167
320
|
'stub.llmNotConnected': '[Заглушка] Вы сказали: "{content}". LLM-движок ещё не подключён.',
|
|
168
321
|
};
|
package/dist/main.js
CHANGED
|
@@ -4,15 +4,56 @@
|
|
|
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
|
-
|
|
9
|
+
// ADR-077: fail-closed на старте (неверный `execution.mode` или `remote` —
|
|
10
|
+
// удалённый исполнитель ещё не реализован, шаг 7 плана) — с понятным текстом.
|
|
11
|
+
let handle;
|
|
12
|
+
try {
|
|
13
|
+
handle = await createBackendApp();
|
|
14
|
+
}
|
|
15
|
+
catch (err) {
|
|
16
|
+
console.error(err instanceof Error ? err.message : String(err));
|
|
17
|
+
process.exit(1);
|
|
18
|
+
}
|
|
19
|
+
const { app, dataDir, port, config, auth, eventHub, queueManager, sessionManager, stopEphemeralSweeper, stopEventJournalPruner, stopAnalyticsRollupPruner, stopScheduler, stopWebhookService, stopWebhookDeliveryPruner, stopMetrics, stopQuestionPruner, stopBackgroundRunPruner, stopProcessLogPruner, stopAttachmentPruner } = handle;
|
|
20
|
+
// ADR-090 (Ф5б-1): старт-активация установленных плагинов.
|
|
21
|
+
// `plugins.lock.json` — источник истины; `plugins.executionEnabled=false`
|
|
22
|
+
// (дефолт) → no-op. Ошибка плагина/рантайма **не роняет старт** (только
|
|
23
|
+
// предупреждение); тексты плагинов в лог не попадают (инвариант 13).
|
|
24
|
+
//
|
|
25
|
+
// Ф5в: **сначала** установка deploy-плагинов (образ/PVC, `plugins.deployDir`),
|
|
26
|
+
// затем активация — иначе поставленный образом плагин не попал бы в
|
|
27
|
+
// `plugins.lock.json` и не активировался при первом старте.
|
|
28
|
+
try {
|
|
29
|
+
const deploy = await handle.pluginRuntime.installDeployPlugins({ actor: 'startup' });
|
|
30
|
+
if (deploy.installed.length > 0 || deploy.failed.length > 0) {
|
|
31
|
+
console.log(`[plugins] deploy: установлено ${deploy.installed.length}, ` +
|
|
32
|
+
`пропущено ${deploy.skipped.length}, ошибок ${deploy.failed.length}`);
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
catch (err) {
|
|
36
|
+
console.warn(`[plugins] установка deploy-плагинов не выполнена: ${err instanceof Error ? err.message : String(err)}`);
|
|
37
|
+
}
|
|
38
|
+
try {
|
|
39
|
+
const results = await handle.pluginRuntime.activateInstalled({ actor: 'startup' });
|
|
40
|
+
if (results.length > 0) {
|
|
41
|
+
const activated = results.filter((item) => item.outcome === 'activated').length;
|
|
42
|
+
console.log(`[plugins] активировано: ${activated}, отклонено: ${results.length - activated}`);
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
catch (err) {
|
|
46
|
+
console.warn(`[plugins] старт-активация не выполнена: ${err instanceof Error ? err.message : String(err)}`);
|
|
47
|
+
}
|
|
10
48
|
let shuttingDown = false;
|
|
11
|
-
async function gracefulShutdown(signal) {
|
|
49
|
+
async function gracefulShutdown(signal, exitCode = 0) {
|
|
12
50
|
if (shuttingDown)
|
|
13
51
|
return;
|
|
14
52
|
shuttingDown = true;
|
|
15
53
|
console.log(`\n[Shutdown] Получен сигнал ${signal}, начинаю graceful shutdown...`);
|
|
54
|
+
// ADR-094: снять readiness до остановки сервера/коллекторов — скрейп в момент
|
|
55
|
+
// shutdown видит `synth_ready 0`.
|
|
56
|
+
setSynthReady(handle.metrics, 0);
|
|
16
57
|
server.close((err) => {
|
|
17
58
|
if (err)
|
|
18
59
|
console.error('[Shutdown] Server close error:', err);
|
|
@@ -30,6 +71,21 @@ async function gracefulShutdown(signal) {
|
|
|
30
71
|
stopEphemeralSweeper();
|
|
31
72
|
// ADR-089: остановить retention-очистку журнала событий.
|
|
32
73
|
stopEventJournalPruner();
|
|
74
|
+
// ADR-102: остановить retention-очистку роллапов аналитики.
|
|
75
|
+
stopAnalyticsRollupPruner();
|
|
76
|
+
// Этап 1 roadmap 0.13 (блок 3): остановить retention-очистку вопросов и
|
|
77
|
+
// освободить ожидания ответа.
|
|
78
|
+
stopQuestionPruner();
|
|
79
|
+
// Этап 1 roadmap 0.13 (блок 4): остановить retention-очистку реестра
|
|
80
|
+
// фоновых прогонов.
|
|
81
|
+
stopBackgroundRunPruner();
|
|
82
|
+
// PROP-097 (блок 5b): остановить retention-очистку логов фоновых процессов.
|
|
83
|
+
stopProcessLogPruner();
|
|
84
|
+
// ADR-115: остановить GC осиротевших вложений сообщений.
|
|
85
|
+
stopAttachmentPruner();
|
|
86
|
+
// ADR-094: остановить процессные метрики и фоновые доменные коллекторы
|
|
87
|
+
// (таймеры сессий/хранилища, подписка шины, decision/journal).
|
|
88
|
+
stopMetrics();
|
|
33
89
|
// ADR-051 (срез): остановить планировщик расписаний.
|
|
34
90
|
stopScheduler();
|
|
35
91
|
// ADR-052 (этап II): остановить движок исходящих webhooks и retention-очистку.
|
|
@@ -50,7 +106,7 @@ async function gracefulShutdown(signal) {
|
|
|
50
106
|
]);
|
|
51
107
|
}
|
|
52
108
|
console.log('[Shutdown] Завершено. Выход.');
|
|
53
|
-
process.exit(
|
|
109
|
+
process.exit(exitCode);
|
|
54
110
|
}
|
|
55
111
|
async function waitForStreamsDrain() {
|
|
56
112
|
while (true) {
|
|
@@ -70,6 +126,13 @@ app.post('/admin/shutdown', auth.requireAdmin, async (c) => {
|
|
|
70
126
|
app.get('/admin/sessions/blocked', auth.requireAdmin, (c) => c.json({ sessions: [], count: 0 }));
|
|
71
127
|
process.on('SIGTERM', () => { void gracefulShutdown('SIGTERM'); });
|
|
72
128
|
process.on('SIGINT', () => { void gracefulShutdown('SIGINT'); });
|
|
129
|
+
// Restart из UI: режим — `SYNTH_RESTART_MODE` (default `disabled`; managed-деплой
|
|
130
|
+
// задаёт `process` — K8s/Docker перезапускают контейнер), рестарт — graceful
|
|
131
|
+
// shutdown с кодом 75. `/admin/shutdown` остаётся обычным выходом с кодом 0.
|
|
132
|
+
configureRestart({
|
|
133
|
+
mode: resolveRestartMode(process.env),
|
|
134
|
+
request: () => gracefulShutdown('API', RESTART_EXIT_CODE),
|
|
135
|
+
});
|
|
73
136
|
console.log(`synth-backend starting on http://${host}:${port}`);
|
|
74
137
|
console.log(` data dir: ${dataDir}`);
|
|
75
138
|
console.log(` debug mode: ${config.auth.debugMode}`);
|