@itphx/synth-backend 0.12.4 → 0.13.8

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 (57) hide show
  1. package/dist/app/deps.d.ts +15 -1
  2. package/dist/app/deps.js +553 -34
  3. package/dist/app/listen.js +56 -7
  4. package/dist/app/mount-routes.js +273 -32
  5. package/dist/app/public-routes.d.ts +2 -0
  6. package/dist/app/public-routes.js +11 -0
  7. package/dist/app/sse-events.d.ts +4 -0
  8. package/dist/app/sse-events.js +53 -6
  9. package/dist/app.d.ts +3 -1
  10. package/dist/app.js +33 -0
  11. package/dist/auth/api-key.d.ts +19 -0
  12. package/dist/auth/api-key.js +56 -0
  13. package/dist/auth/middleware.js +7 -3
  14. package/dist/events/hub.d.ts +17 -0
  15. package/dist/events/hub.js +50 -15
  16. package/dist/init.d.ts +1 -0
  17. package/dist/init.js +96 -0
  18. package/dist/lib/app-config.d.ts +4 -0
  19. package/dist/lib/app-config.js +16 -3
  20. package/dist/lib/bind-host.d.ts +10 -0
  21. package/dist/lib/bind-host.js +32 -0
  22. package/dist/lib/defaults-store.d.ts +1 -1
  23. package/dist/lib/defaults-store.js +1 -1
  24. package/dist/lib/i18n.js +26 -0
  25. package/dist/lib/recalc-can-summarize.js +8 -3
  26. package/dist/main.js +7 -2
  27. package/dist/middleware/rate-limiter.d.ts +4 -1
  28. package/dist/middleware/rate-limiter.js +15 -2
  29. package/dist/routes/agents.js +1 -0
  30. package/dist/routes/auth.js +29 -16
  31. package/dist/routes/llm.js +92 -12
  32. package/dist/routes/mcp-remote.d.ts +23 -0
  33. package/dist/routes/mcp-remote.js +152 -0
  34. package/dist/routes/mcp.d.ts +11 -6
  35. package/dist/routes/mcp.js +35 -6
  36. package/dist/routes/messages.js +2 -0
  37. package/dist/routes/projects.d.ts +9 -3
  38. package/dist/routes/projects.js +32 -3
  39. package/dist/routes/providers.d.ts +4 -1
  40. package/dist/routes/providers.js +19 -99
  41. package/dist/routes/queue.d.ts +4 -1
  42. package/dist/routes/queue.js +4 -1
  43. package/dist/routes/sessions.d.ts +49 -9
  44. package/dist/routes/sessions.js +299 -256
  45. package/package.json +6 -6
  46. package/dist/routes/audit.d.ts +0 -17
  47. package/dist/routes/audit.js +0 -64
  48. package/dist/routes/context.d.ts +0 -4
  49. package/dist/routes/context.js +0 -93
  50. package/dist/routes/debug.d.ts +0 -3
  51. package/dist/routes/debug.js +0 -30
  52. package/dist/routes/gateway-patterns.d.ts +0 -9
  53. package/dist/routes/gateway-patterns.js +0 -57
  54. package/dist/routes/logs.d.ts +0 -24
  55. package/dist/routes/logs.js +0 -100
  56. package/dist/routes/mcp-registry.d.ts +0 -28
  57. package/dist/routes/mcp-registry.js +0 -483
@@ -1,7 +1,12 @@
1
1
  import { getServiceCredential } from '@itphx/synth-core';
2
+ import { MESSAGE_MODEL_QUERY_PARAM, MESSAGE_MODEL_UNSUPPORTED_REASON, isSupportedMessageModelParam, parseSinceParam, } from '@itphx/synth-core';
2
3
  /**
3
4
  * Зарегистрировать SSE-хаб (`GET /api/v2/events`): подписка на события сессий
4
5
  * пользователя (watch-all — для service-key и ADMIN/LEAD, ADR-052 этап IV).
6
+ *
7
+ * ADR-118 §6/§8: кадр несёт `id:` (глобальный номер события) — по нему
8
+ * работает догон (`Last-Event-ID` / `?since`); клиент обязан заявить модель
9
+ * сообщений (`messageModel=2`) — иначе поток не устанавливается (fail-closed).
5
10
  */
6
11
  export function registerEventsSse(app, deps) {
7
12
  const { auth, eventHub, scopeGuard } = deps;
@@ -10,6 +15,13 @@ export function registerEventsSse(app, deps) {
10
15
  app.get('/api/v2/events', auth.requireAuth, scopeGuard('events:watch'), async (c) => {
11
16
  const user = (await auth.getCurrentUser(c));
12
17
  const signal = c.req.raw.signal;
18
+ // ADR-118 §8: гейт минимальной версии клиента (fail-closed) — без
19
+ // `messageModel=2` поток не открывается (426 Upgrade Required).
20
+ if (!isSupportedMessageModelParam(c.req.query(MESSAGE_MODEL_QUERY_PARAM))) {
21
+ return c.json({ error: { code: 'UPGRADE_REQUIRED', message: MESSAGE_MODEL_UNSUPPORTED_REASON } }, 426);
22
+ }
23
+ // ADR-118 §6: догон — `Last-Event-ID` (заголовок) либо `?since=`.
24
+ const sinceSeq = parseSinceParam(c.req.header('last-event-id') ?? c.req.query('since'));
13
25
  // ADR-052 (этап IV) / ADR-089: машинный watcher (service-key со scope
14
26
  // `events:watch`) и роли сквозного обзора ADMIN/LEAD получают события ВСЕХ
15
27
  // сессий (паритет со standalone-core `subscribeAll`), обычный пользователь —
@@ -19,23 +31,58 @@ export function registerEventsSse(app, deps) {
19
31
  return new Response(new ReadableStream({
20
32
  async start(controller) {
21
33
  const encoder = new TextEncoder();
34
+ /**
35
+ * ADR-118 §6: порядок «сначала журнал, потом живое». Пока идёт
36
+ * воспроизведение журнала, живые события копятся в буфере; уже
37
+ * отправленные номера (`sentSeq`) отсекают дубли.
38
+ */
39
+ let replaying = sinceSeq !== null;
40
+ const pending = [];
41
+ const sentSeq = new Map();
42
+ const write = (event) => {
43
+ const seq = event.eventSeq;
44
+ if (typeof seq === 'number') {
45
+ const last = sentSeq.get(event.sessionId) ?? 0;
46
+ if (seq <= last)
47
+ return;
48
+ sentSeq.set(event.sessionId, seq);
49
+ }
50
+ try {
51
+ // `id:` — глобальный номер события (ADR-118 §6): по нему
52
+ // клиент продолжает ленту после переподключения (`Last-Event-ID`).
53
+ const id = typeof event.eventSeq === 'number' ? `id: ${event.eventSeq}\n` : '';
54
+ const line = `${id}data: ${JSON.stringify(event)}\n\n`;
55
+ controller.enqueue(encoder.encode(line));
56
+ }
57
+ catch {
58
+ // client disconnected
59
+ }
60
+ };
22
61
  const sseClient = {
23
62
  userId: user.id,
24
63
  username: user.username,
25
64
  allSessions,
26
65
  send(event) {
27
- try {
28
- const line = `data: ${JSON.stringify(event)}\n\n`;
29
- controller.enqueue(encoder.encode(line));
30
- }
31
- catch {
32
- // client disconnected
66
+ if (replaying) {
67
+ pending.push(event);
68
+ return;
33
69
  }
70
+ write(event);
34
71
  },
35
72
  };
36
73
  try {
37
74
  console.log(`[SSE /api/v2/events] Connected: user=${user.username} allSessions=${allSessions}`);
38
75
  await eventHub.registerClient(sseClient);
76
+ // ADR-118 §6: догон — журнал строго после `since`, затем живые
77
+ // события (буфер), без разрыва и без дублей.
78
+ if (sinceSeq !== null) {
79
+ for (const event of eventHub.replayForClient(sseClient, sinceSeq))
80
+ write(event);
81
+ }
82
+ replaying = false;
83
+ for (const event of pending)
84
+ write(event);
85
+ pending.length = 0;
39
86
  // Keepalive: раз в 30 секунд отправляем комментарий для предотвращения разрыва
40
87
  const keepalive = setInterval(() => {
41
88
  try {
package/dist/app.d.ts CHANGED
@@ -13,7 +13,7 @@ export interface CreateBackendAppOptions {
13
13
  dataDir?: string;
14
14
  /** Debug auth: переопределяет SYNTH_AUTH_DEBUG (тестовые ключи admin-key-123 и т.п.). */
15
15
  authDebug?: boolean;
16
- /** Единый API-ключ (роль ADMIN): переопределяет SYNTH_API_KEY. */
16
+ /** Единый API-ключ (роли из `auth.apiKeyRoles`, дефолт USER): переопределяет SYNTH_API_KEY. */
17
17
  apiKey?: string;
18
18
  /** Порт: переопределяет SYNTH_PORT. 0 — эфемерный (для тестов). */
19
19
  port?: number;
@@ -79,6 +79,8 @@ export interface BackendAppHandle {
79
79
  stopProcessLogPruner: () => void;
80
80
  /** ADR-115: остановка GC осиротевших вложений сообщений. */
81
81
  stopAttachmentPruner: () => void;
82
+ /** ADR-115 × ADR-077: остановка уборки временных каталогов медиа-раннера. */
83
+ stopMediaTempPruner: () => void;
82
84
  /** ADR-052 (этап II): реестр подписок webhooks (для тестов/диагностики). */
83
85
  webhookStore: WebhookRepository;
84
86
  /** ADR-052 (этап II): движок исходящих webhooks. */
package/dist/app.js CHANGED
@@ -28,6 +28,7 @@ import { createAuthRoutes } from './routes/auth.js';
28
28
  import { t } from './lib/i18n.js';
29
29
  import { createBackendDeps, createBackendStorage } from './app/deps.js';
30
30
  import { mountBackendRoutes } from './app/mount-routes.js';
31
+ import { isPublicApiV2Path } from './app/public-routes.js';
31
32
  import { createBackendListen } from './app/listen.js';
32
33
  /**
33
34
  * Backend-приложение Synth (managed): `createBackendApp` без прослушивания порта.
@@ -94,12 +95,17 @@ export async function createBackendApp(opts = {}) {
94
95
  // ADR-094: `/ready` — readiness (200 и при деградации, 503 — только не готов).
95
96
  const degradedInfo = storage.degraded ?? null;
96
97
  let initialized = false;
98
+ // F4 (аудит S1): эффективное состояние LLM-шлюза (`deps.gatewayConfig.enabled`,
99
+ // с учётом runtime-тумблера из UI) — для предупреждения в `/health`/`/ready`.
100
+ // deps создаются ниже: геттер ленивый (до сборки — поля нет).
101
+ let depsRef = null;
97
102
  app.route('/', createHealthRoutes({
98
103
  getStorageDegraded: () => degradedInfo ?? null,
99
104
  getReadiness: () => ({
100
105
  ready: initialized,
101
106
  storage: degradedInfo ? 'degraded' : 'ok',
102
107
  }),
108
+ getLlmGatewayState: () => depsRef ? (depsRef.gatewayConfig?.enabled ? 'enabled' : 'disabled') : null,
103
109
  }));
104
110
  // ADR-094: `/metrics` — до auth (скрейп по сети pod'а, опциональный bearer).
105
111
  // Токен читается на каждый запрос — правка из UI применяется без рестарта.
@@ -173,6 +179,9 @@ export async function createBackendApp(opts = {}) {
173
179
  // Тот же контекст хранения, что собран до `auth`. ADR-094: реестр передаётся
174
180
  // только при `metrics.enabled` — иначе доменные коллекторы не подключаются.
175
181
  const deps = await createBackendDeps(backendConfig, storage, metricsEnabled ? metrics : undefined, execution);
182
+ // F4 (аудит S1): health-геттер состояния LLM-шлюза читает эффективный конфиг
183
+ // (`deps.gatewayConfig` — config + runtime-тумблер), который готов только здесь.
184
+ depsRef = deps;
176
185
  // Auth routes (после profilesStore)
177
186
  app.route('/auth', createAuthRoutes(auth, backendConfig.auth, deps.profilesStore, deps.dataDir, deps.defaultsStore,
178
187
  // ADR-090 Ф7: сигнал о серверной политике плагинов для публичного
@@ -182,6 +191,28 @@ export async function createBackendApp(opts = {}) {
182
191
  enabled: deps.pluginRuntime.config.enabled,
183
192
  mode: deps.pluginRuntime.config.hybrid.mode,
184
193
  }));
194
+ // F6 (аудит §6.1) — единый fail-closed гейт на границе `/api/v2/*`.
195
+ //
196
+ // Роутеры создаются фабриками с `{ requireAuth }`, но сама граница
197
+ // приложения проверку не гарантировала: новый роутер, смонтированный без
198
+ // guard'а, становился анонимным (перепись маршрутов покрывала 3 роутера
199
+ // из 59). Здесь — последняя проверка для всего дерева API, кроме
200
+ // allowlist публичных путей (`app/public-routes.ts`; строго метод+путь,
201
+ // без wildcard по префиксу).
202
+ //
203
+ // Порядок важен: после `attachUser` (service-key и cookie-пользователь уже
204
+ // в контексте — `requireAuth` берёт его оттуда без повторной проверки) и
205
+ // `/auth`-роутов, до plugin-bound guard'а (он различает только
206
+ // service-key, аноним до него не доходит), guard'а деградации и
207
+ // монтирования роутов. Проверок внутри обработчиков не добавляем —
208
+ // там остаются только RBAC/область доступа (инвариант 16).
209
+ app.use('/api/v2/*', createMiddleware(async (c, next) => {
210
+ if (isPublicApiV2Path(c.req.method, c.req.path)) {
211
+ await next();
212
+ return;
213
+ }
214
+ return auth.requireAuth(c, next);
215
+ }));
185
216
  // ADR-090 Ф7 (Уровень 2): plugin-bound service-key (`plugin_id`)
186
217
  // принимается только с заголовком `X-Synth-Plugin-Id` и тем же
187
218
  // значением, со scope `plugins:invoke` и — при
@@ -308,6 +339,8 @@ export async function createBackendApp(opts = {}) {
308
339
  stopProcessLogPruner: () => deps.stopProcessLogPruner(),
309
340
  // ADR-115: GC осиротевших вложений сообщений.
310
341
  stopAttachmentPruner: () => deps.stopAttachmentPruner(),
342
+ // ADR-115 × ADR-077: уборка временных каталогов медиа-раннера.
343
+ stopMediaTempPruner: () => deps.stopMediaTempPruner(),
311
344
  // ADR-052 (этап II): реестр подписок и движок webhooks + остановка на shutdown.
312
345
  webhookStore: deps.webhookStore,
313
346
  webhookService: deps.webhookService,
@@ -0,0 +1,19 @@
1
+ import { GlobalRole } from '@itphx/synth-shared';
2
+ /** Допустимые роли для `auth.apiKeyRoles` (порядок — для текста ошибки). */
3
+ export declare const ALLOWED_API_KEY_ROLES: readonly GlobalRole[];
4
+ /** Роль по умолчанию для API-ключа: базовый пользователь, не ADMIN. */
5
+ export declare const DEFAULT_API_KEY_ROLE: GlobalRole;
6
+ /**
7
+ * Сравнить представленный ключ с ожидаемым за постоянное время.
8
+ *
9
+ * Дайджесты sha256 всегда одной длины (32 байта), поэтому `timingSafeEqual`
10
+ * не бросает на разной длине входных строк и не раскрывает её. Пустая строка
11
+ * с любой стороны → `false` (незаданный ключ не аутентифицирует никого).
12
+ */
13
+ export declare function apiKeyEquals(presented: string | null | undefined, expected: string | null | undefined): boolean;
14
+ /**
15
+ * Роли пользователя API-ключа из конфигурации: явный список либо `['USER']`.
16
+ * Неизвестная роль — ошибка конфигурации (fail-closed): молча выдать меньше
17
+ * прав нельзя (это скрытая поломка доступа), выдать больше — тем более.
18
+ */
19
+ export declare function resolveApiKeyRoles(configured: readonly string[] | undefined): GlobalRole[];
@@ -0,0 +1,56 @@
1
+ /**
2
+ * Единый API-ключ backend (`auth.apiKey` / `SYNTH_API_KEY`).
3
+ *
4
+ * Два независимых правила (аудит F5):
5
+ * 1. Сравнение ключа — **постоянное по времени**: равные по длине sha256-дайджесты
6
+ * (`timingSafeEqual`), поэтому ни содержимое, ни длина представленного ключа
7
+ * не утекают через тайминг. Пустой конфиг/пустой заголовок → не совпадает.
8
+ * 2. Роли пользователя ключа — **только явная настройка** (`auth.apiKeyRoles`):
9
+ * дефолт `USER`; права ADMIN не выдаются по факту наличия ключа.
10
+ */
11
+ import { createHash, timingSafeEqual } from 'node:crypto';
12
+ import { GlobalRole } from '@itphx/synth-shared';
13
+ /** Допустимые роли для `auth.apiKeyRoles` (порядок — для текста ошибки). */
14
+ export const ALLOWED_API_KEY_ROLES = [
15
+ GlobalRole.ADMIN,
16
+ GlobalRole.USER,
17
+ GlobalRole.LEAD,
18
+ GlobalRole.AUDITOR,
19
+ ];
20
+ /** Роль по умолчанию для API-ключа: базовый пользователь, не ADMIN. */
21
+ export const DEFAULT_API_KEY_ROLE = GlobalRole.USER;
22
+ function digest(value) {
23
+ return createHash('sha256').update(value, 'utf8').digest();
24
+ }
25
+ /**
26
+ * Сравнить представленный ключ с ожидаемым за постоянное время.
27
+ *
28
+ * Дайджесты sha256 всегда одной длины (32 байта), поэтому `timingSafeEqual`
29
+ * не бросает на разной длине входных строк и не раскрывает её. Пустая строка
30
+ * с любой стороны → `false` (незаданный ключ не аутентифицирует никого).
31
+ */
32
+ export function apiKeyEquals(presented, expected) {
33
+ if (!presented || !expected)
34
+ return false;
35
+ return timingSafeEqual(digest(presented), digest(expected));
36
+ }
37
+ /**
38
+ * Роли пользователя API-ключа из конфигурации: явный список либо `['USER']`.
39
+ * Неизвестная роль — ошибка конфигурации (fail-closed): молча выдать меньше
40
+ * прав нельзя (это скрытая поломка доступа), выдать больше — тем более.
41
+ */
42
+ export function resolveApiKeyRoles(configured) {
43
+ if (!configured || configured.length === 0)
44
+ return [DEFAULT_API_KEY_ROLE];
45
+ const roles = [];
46
+ for (const value of configured) {
47
+ if (!ALLOWED_API_KEY_ROLES.includes(value)) {
48
+ throw new Error(`[config] auth.apiKeyRoles: неизвестная роль "${value}"; ` +
49
+ `допустимо: ${ALLOWED_API_KEY_ROLES.join(', ')}`);
50
+ }
51
+ const role = value;
52
+ if (!roles.includes(role))
53
+ roles.push(role);
54
+ }
55
+ return roles.length > 0 ? roles : [DEFAULT_API_KEY_ROLE];
56
+ }
@@ -3,6 +3,7 @@ import { createMiddleware } from 'hono/factory';
3
3
  import { getCookie, setCookie, deleteCookie } from 'hono/cookie';
4
4
  import { t } from '../lib/i18n.js';
5
5
  import { createLazyOidcClient } from './oidc.js';
6
+ import { apiKeyEquals, resolveApiKeyRoles } from './api-key.js';
6
7
  const SESSION_COOKIE = 'user_session';
7
8
  /**
8
9
  * Флаг `Secure` cookie сессии: по умолчанию `true`; локальная http-разработка
@@ -117,14 +118,17 @@ export function createAuthMiddleware(config) {
117
118
  // 4. API Key mode (продакшен без OIDC)
118
119
  if (!config.debugMode && !config.oidc?.enabled && config.apiKey) {
119
120
  const apiKey = extractBearerToken(c.req.header('Authorization'));
120
- if (apiKey === config.apiKey) {
121
+ // Постоянное по времени сравнение (аудит F5): неверный/пустой ключ → не
122
+ // аутентифицирован; роли — из явной настройки, по умолчанию USER.
123
+ if (apiKeyEquals(apiKey, config.apiKey)) {
124
+ const roles = resolveApiKeyRoles(config.apiKeyRoles);
121
125
  return {
122
126
  id: 'api',
123
127
  username: 'api',
124
- roles: ['ADMIN'],
128
+ roles,
125
129
  preferredLanguage: 'ru',
126
130
  createdAt: '',
127
- teamRole: 'ADMIN',
131
+ teamRole: roles[0] ?? 'USER',
128
132
  notes: '',
129
133
  interviewCompleted: false,
130
134
  };
@@ -31,6 +31,23 @@ export declare class EventHub {
31
31
  unsubscribeFromSession(userId: string, sessionId: string): void;
32
32
  /** Глобальная подписка all-клиента: события всех сессий без привязки к владельцу. */
33
33
  private _subscribeClientToAll;
34
+ /**
35
+ * ADR-118 §4: адресная доставка.
36
+ *
37
+ * Событие с `recipient` получает **только** клиент с совпадающим `userId`
38
+ * (broadcast — без `recipient` — получают все подписчики сессии).
39
+ */
40
+ private _deliver;
41
+ /**
42
+ * ADR-118 §6: догон — события журнала строго после `afterSeq` для сессий,
43
+ * на которые подписан клиент (`Last-Event-ID` / `?since`).
44
+ *
45
+ * Watch-all клиент (service-key / сквозной обзор) получает журнал всех
46
+ * сессий; обычный клиент — только своих. Номер события глобальный и
47
+ * монотонный в пределах инстанса, поэтому порядок между сессиями — точный
48
+ * (по номеру).
49
+ */
50
+ replayForClient(client: EventClient, afterSeq: number): BusEvent[];
34
51
  private _subscribeClientToSession;
35
52
  private _unsubscribeClientFromAll;
36
53
  }
@@ -29,7 +29,7 @@ export class EventHub {
29
29
  return;
30
30
  }
31
31
  // Нужны только id сессий владельца — лёгкая выборка (без истории сообщений).
32
- const sessions = await this.sessionManager.listSessions({ userId: client.userId }, { light: true });
32
+ const sessions = await this.sessionManager.listSessions({ userId: client.userId });
33
33
  console.log(`[EventHub] Register client: user=${client.username} clients=${arr.length} sessions=${sessions.length}`);
34
34
  for (const s of sessions) {
35
35
  this._subscribeClientToSession(client, s.id);
@@ -90,16 +90,54 @@ export class EventHub {
90
90
  const subs = this.clientSubs.get(client);
91
91
  if (!subs || subs.has(ALL_SESSIONS_KEY))
92
92
  return;
93
+ // `userFacing`: клиент (WS/SSE) обслуживает пользователя и может ответить
94
+ // на `permission.asked`. Без флага подтверждение считалось бы «некому
95
+ // показать»: у watch-all клиентов per-session подписок нет.
93
96
  const unsub = this.eventBus.subscribeAll((event) => {
94
- try {
95
- client.send(event);
96
- }
97
- catch {
98
- // ignore send errors
99
- }
100
- });
97
+ this._deliver(client, event);
98
+ }, { userFacing: true });
101
99
  subs.set(ALL_SESSIONS_KEY, unsub);
102
100
  }
101
+ /**
102
+ * ADR-118 §4: адресная доставка.
103
+ *
104
+ * Событие с `recipient` получает **только** клиент с совпадающим `userId`
105
+ * (broadcast — без `recipient` — получают все подписчики сессии).
106
+ */
107
+ _deliver(client, event) {
108
+ if (event.recipient && event.recipient !== client.userId)
109
+ return;
110
+ try {
111
+ client.send(event);
112
+ }
113
+ catch {
114
+ // ignore send errors
115
+ }
116
+ }
117
+ /**
118
+ * ADR-118 §6: догон — события журнала строго после `afterSeq` для сессий,
119
+ * на которые подписан клиент (`Last-Event-ID` / `?since`).
120
+ *
121
+ * Watch-all клиент (service-key / сквозной обзор) получает журнал всех
122
+ * сессий; обычный клиент — только своих. Номер события глобальный и
123
+ * монотонный в пределах инстанса, поэтому порядок между сессиями — точный
124
+ * (по номеру).
125
+ */
126
+ replayForClient(client, afterSeq) {
127
+ const subs = this.clientSubs.get(client);
128
+ if (!subs)
129
+ return [];
130
+ const sessionIds = [...subs.keys()].filter((id) => id !== ALL_SESSIONS_KEY);
131
+ if (sessionIds.length === 0) {
132
+ return this.eventBus.journalSince(afterSeq);
133
+ }
134
+ const out = [];
135
+ for (const sessionId of sessionIds) {
136
+ out.push(...this.eventBus.since(sessionId, afterSeq));
137
+ }
138
+ out.sort((a, b) => (a.eventSeq ?? 0) - (b.eventSeq ?? 0));
139
+ return out;
140
+ }
103
141
  _subscribeClientToSession(client, sessionId) {
104
142
  // all-клиент покрыт глобальной подпиской — per-session подписки не нужны
105
143
  // (иначе дубли доставки).
@@ -111,12 +149,7 @@ export class EventHub {
111
149
  if (subs.has(sessionId))
112
150
  return;
113
151
  const unsub = this.eventBus.subscribe(sessionId, (event) => {
114
- try {
115
- client.send(event);
116
- }
117
- catch {
118
- // ignore send errors
119
- }
152
+ this._deliver(client, event);
120
153
  // Автоподписка на дочернюю сессию саб-агента. Раньше клиент получал
121
154
  // live-события (`stream.usage`/`stream.chunk`) только по сессиям из
122
155
  // `listSessions` и созданным/форкнутым через роуты; child-сессию тул
@@ -128,7 +161,9 @@ export class EventHub {
128
161
  if (childId && childId !== sessionId) {
129
162
  this._subscribeClientToSession(client, childId);
130
163
  }
131
- });
164
+ // ADR-118 §4: адресная доставка на уровне шины — подписчик сессии
165
+ // получает событие с `recipient` только при совпадении `userId`.
166
+ }, { userId: client.userId });
132
167
  subs.set(sessionId, unsub);
133
168
  }
134
169
  _unsubscribeClientFromAll(client) {
package/dist/init.d.ts ADDED
@@ -0,0 +1 @@
1
+ export {};
package/dist/init.js ADDED
@@ -0,0 +1,96 @@
1
+ // Обёртка дочернего процесса в контейнере backend (вторая ступень после
2
+ // sh-инициализатора `docker/init.sh`, см. ниже «Чего обёртка НЕ делает»).
3
+ //
4
+ // Зачем обёртка. С `CMD ["node","dist/main.js"]` приложение само становится
5
+ // PID 1 (в Docker/K8s это первый процесс, у которого нет родителя). PID 1
6
+ // обязан **пожинать** осиротевших детей (`waitpid`): иначе завершившиеся
7
+ // процессы остаются зомби, занимают слоты PID и ломают `kill(pid, 0)` —
8
+ // «процесс ещё жив» для давно мёртвого (аудит 0.13.4 §5.2: 38–42 зомби и
9
+ // падающие abort-тесты).
10
+ //
11
+ // Что делает обёртка:
12
+ // 1. запускает `node dist/main.js` (тот же `process.execPath`, тот же argv/env,
13
+ // тот же cwd) в **отдельной process group** (`detached: true`) — поэтому
14
+ // сигнал можно отправить всей группе (`kill(-pid)`), а не только шефу;
15
+ // 2. пробрасывает SIGTERM/SIGINT/SIGHUP группе дочернего процесса (Docker и
16
+ // K8s шлют сигнал только PID 1 — сама обёртка);
17
+ // 3. ждёт завершения ребёнка и выходит с **тем же кодом** — включая 75
18
+ // (graceful restart, ADR-092 п. 7 / инвариант 24) и 128+N при гибели от
19
+ // сигнала; супервизор (Docker `restart`/K8s `restartPolicy`) видит
20
+ // исходный код, а не код обёртки;
21
+ // 4. ошибка запуска/отсутствие цели — код 1 и понятная строка в stderr.
22
+ //
23
+ // Чего обёртка НЕ делает — reaping. Пожинать осиротевших детей умеет только
24
+ // PID 1, и для этого нужен `waitpid(-1)`; Node/libuv так не может: libuv ждёт
25
+ // лишь pid'ы своих child-handle'ов (`waitpid(process->pid)`), а усыновлённые
26
+ // сироты остаются зомби. Поэтому в контейнере PID 1 — sh-скрипт
27
+ // `docker/init.sh` (`synth-init`), а эта обёртка — его дочерний процесс
28
+ // (см. шапку `docker/Dockerfile.backend`).
29
+ //
30
+ // Это **не** замена graceful shutdown приложения: SIGTERM доходит до main.js,
31
+ // и тот закрывает сервер/очередь как раньше (см. `main.ts`).
32
+ //
33
+ // `SYNTH_INIT_ENTRY` переопределяет цель запуска — только для тестов и ручной
34
+ // отладки (в образе он не задаётся, дефолт — `dist/main.js` рядом с обёрткой).
35
+ import { spawn } from 'node:child_process';
36
+ import { existsSync } from 'node:fs';
37
+ import { constants } from 'node:os';
38
+ import { dirname, join, resolve } from 'node:path';
39
+ import { fileURLToPath } from 'node:url';
40
+ /** Сигналы, которые обёртка пересылает дочернему процессу (вся группа). */
41
+ const FORWARDED_SIGNALS = ['SIGTERM', 'SIGINT', 'SIGHUP'];
42
+ /**
43
+ * Код выхода по сигналу — как у оболочки: 128 + номер сигнала
44
+ * (SIGKILL → 137, SIGTERM → 143). `undefined` — сигнал неизвестен.
45
+ */
46
+ function signalExitCode(signal) {
47
+ const number = constants.signals[signal];
48
+ return typeof number === 'number' ? 128 + number : 1;
49
+ }
50
+ /** Скрипт-цель: `dist/main.js` рядом с обёрткой (или `SYNTH_INIT_ENTRY`). */
51
+ function resolveEntry() {
52
+ const override = process.env.SYNTH_INIT_ENTRY?.trim();
53
+ if (override !== undefined && override.length > 0)
54
+ return resolve(process.cwd(), override);
55
+ return join(dirname(fileURLToPath(import.meta.url)), 'main.js');
56
+ }
57
+ function main() {
58
+ const entry = resolveEntry();
59
+ if (!existsSync(entry)) {
60
+ // Внятная причина вместо стектрейса node «Cannot find module»: в образе
61
+ // цель — `dist/main.js` рядом с обёрткой, её отсутствие = битая сборка.
62
+ console.error(`[init] цель запуска не найдена: ${entry}`);
63
+ process.exit(1);
64
+ }
65
+ const child = spawn(process.execPath, [entry, ...process.argv.slice(2)], {
66
+ cwd: process.cwd(),
67
+ env: process.env,
68
+ stdio: 'inherit',
69
+ // Своя process group (setsid): `kill(-pid, sig)` накрывает и потомков,
70
+ // оставшихся от дочернего процесса (`sh -c '… &'`, обёртки команд).
71
+ detached: true,
72
+ });
73
+ const forward = (signal) => {
74
+ if (child.pid === undefined)
75
+ return;
76
+ try {
77
+ process.kill(-child.pid, signal);
78
+ }
79
+ catch {
80
+ // Группы уже нет (ребёнок завершился) — нечего пересылать.
81
+ }
82
+ };
83
+ for (const signal of FORWARDED_SIGNALS) {
84
+ process.on(signal, () => forward(signal));
85
+ }
86
+ child.on('error', (err) => {
87
+ console.error(`[init] не удалось запустить ${entry}: ${err.message}`);
88
+ process.exit(1);
89
+ });
90
+ child.on('exit', (code, signal) => {
91
+ // Код ребёнка сохраняется как есть (75 — рестарт, 0 — штатный выход);
92
+ // гибель от сигнала переводится в 128+N, как в оболочке.
93
+ process.exit(code ?? (signal === null ? 1 : signalExitCode(signal)));
94
+ });
95
+ }
96
+ main();
@@ -6,6 +6,10 @@ export interface BackendConfig {
6
6
  workspacesRoot: string;
7
7
  /** Максимальный размер загрузки файла (`POST /api/v2/fs/upload`), байт (config/env). */
8
8
  maxUploadBytes: number;
9
+ /** Максимальный размер файла, отдаваемого `GET /api/v2/fs/read`, байт (config/env). */
10
+ maxReadBytes: number;
11
+ /** Максимальный размер файла, отдаваемого `GET /api/v2/fs/raw` (предпросмотр), байт (config/env). */
12
+ maxPreviewBytes: number;
9
13
  port: number;
10
14
  auth: AuthConfig;
11
15
  }
@@ -1,4 +1,5 @@
1
- import { loadConfig, resolveDataDir, resolvePort, resolveWorkspacesRoot, resolveMaxUploadBytes } from '@itphx/synth-shared';
1
+ import { loadConfig, resolveDataDir, resolvePort, resolveWorkspacesRoot, resolveMaxUploadBytes, resolveMaxReadBytes, resolveMaxPreviewBytes } from '@itphx/synth-shared';
2
+ import { resolveApiKeyRoles } from '../auth/api-key.js';
2
3
  const envStr = (key, fallback = '') => process.env[key] || fallback;
3
4
  const envBool = (key, fallback = false) => process.env[key] ? process.env[key] === 'true' : fallback;
4
5
  const envInt = (key, fallback) => {
@@ -40,6 +41,9 @@ function buildAuthConfig(defaults) {
40
41
  return {
41
42
  debugMode,
42
43
  apiKey: envStr('SYNTH_API_KEY', defaults.apiKey ?? ''),
44
+ // Аудит F5: роли API-ключа — только явная настройка (`auth.apiKeyRoles` /
45
+ // `SYNTH_API_KEY_ROLES`), дефолт USER. Неизвестная роль — ошибка загрузки.
46
+ apiKeyRoles: resolveApiKeyRoles(defaults.apiKeyRoles),
43
47
  testUsers,
44
48
  sessionMaxAgeMinutes: envInt('SYNTH_SESSION_MAX_AGE', defaults.sessionMaxAgeMinutes),
45
49
  oidc: oidcEnabled
@@ -55,11 +59,20 @@ function buildAuthConfig(defaults) {
55
59
  };
56
60
  }
57
61
  export async function loadBackendConfig(options) {
58
- const synth = await loadConfig(options);
62
+ // F4 (аудит S1): профиль backend/managed включает LLM-шлюз по умолчанию —
63
+ // обфускация секретов, аудит каждого запроса и rate limit должны работать
64
+ // «из коробки». Явные config.yaml/env/CLI и runtime-тумблер из UI это
65
+ // перебивают (приоритет выше профиля). Standalone остаётся выключенным.
66
+ const synth = await loadConfig({
67
+ baseDefaults: { llmGateway: { enabled: true } },
68
+ ...options,
69
+ });
59
70
  const auth = buildAuthConfig(synth.auth);
60
71
  const dataDir = resolveDataDir(synth);
61
72
  const workspacesRoot = resolveWorkspacesRoot(synth);
62
73
  const maxUploadBytes = resolveMaxUploadBytes(synth);
74
+ const maxReadBytes = resolveMaxReadBytes(synth);
75
+ const maxPreviewBytes = resolveMaxPreviewBytes(synth);
63
76
  const port = resolvePort(synth, 'SYNTH_PORT', synth.server.port);
64
- return { synth, dataDir, workspacesRoot, maxUploadBytes, port, auth };
77
+ return { synth, dataDir, workspacesRoot, maxUploadBytes, maxReadBytes, maxPreviewBytes, port, auth };
65
78
  }
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Признак контейнера: маркер Docker (`/.dockerenv`), окружение Kubernetes
3
+ * (`KUBERNETES_SERVICE_HOST`) либо явный `SYNTH_IN_CONTAINER` (образ/split-режим).
4
+ */
5
+ export declare function detectContainer(env?: NodeJS.ProcessEnv, dockerEnvFileExists?: (path: string) => boolean): boolean;
6
+ /**
7
+ * Итоговый bind-host: `SYNTH_HOST` > контейнер (`0.0.0.0`) > loopback.
8
+ * Пустой `SYNTH_HOST` трактуется как «не задан».
9
+ */
10
+ export declare function resolveBindHost(env: NodeJS.ProcessEnv, isContainer: boolean): string;
@@ -0,0 +1,32 @@
1
+ /**
2
+ * Адрес прослушивания backend (аудит F5, безопасный дефолт).
3
+ *
4
+ * Вне контейнера backend по умолчанию слушает **loopback** (`127.0.0.1`):
5
+ * публикация порта наружу — только явным `SYNTH_HOST`. В контейнере/K8s
6
+ * (образ, Helm-чарт, docker-compose) — `0.0.0.0`, иначе порт не был бы доступен
7
+ * снаружи контейнера.
8
+ *
9
+ * `SYNTH_HOST` приоритетен всегда (явная настройка оператора).
10
+ */
11
+ import { existsSync } from 'node:fs';
12
+ /**
13
+ * Признак контейнера: маркер Docker (`/.dockerenv`), окружение Kubernetes
14
+ * (`KUBERNETES_SERVICE_HOST`) либо явный `SYNTH_IN_CONTAINER` (образ/split-режим).
15
+ */
16
+ export function detectContainer(env = process.env, dockerEnvFileExists = existsSync) {
17
+ if (dockerEnvFileExists('/.dockerenv'))
18
+ return true;
19
+ if (env.KUBERNETES_SERVICE_HOST)
20
+ return true;
21
+ return env.SYNTH_IN_CONTAINER === 'true' || env.SYNTH_IN_CONTAINER === '1';
22
+ }
23
+ /**
24
+ * Итоговый bind-host: `SYNTH_HOST` > контейнер (`0.0.0.0`) > loopback.
25
+ * Пустой `SYNTH_HOST` трактуется как «не задан».
26
+ */
27
+ export function resolveBindHost(env, isContainer) {
28
+ const explicit = env.SYNTH_HOST?.trim();
29
+ if (explicit)
30
+ return explicit;
31
+ return isContainer ? '0.0.0.0' : '127.0.0.1';
32
+ }
@@ -1,2 +1,2 @@
1
- export { DefaultsStore, UI_SCALE_MIN, UI_SCALE_MAX } from '@itphx/synth-core';
1
+ export { DefaultsStore, UI_SCALE_MIN, UI_SCALE_MAX, CHAT_SCALE_MIN, CHAT_SCALE_MAX } from '@itphx/synth-core';
2
2
  export type { AppearanceDefaults } from '@itphx/synth-core';
@@ -2,4 +2,4 @@
2
2
  // это просто `{dataDir}/defaults.json` + атомарная запись, без backend-специфики.
3
3
  // Здесь оставлен реэкспорт, чтобы существующие импорты (`../lib/defaults-store.js`)
4
4
  // не менялись. См. `@itphx/synth-core`.
5
- export { DefaultsStore, UI_SCALE_MIN, UI_SCALE_MAX } from '@itphx/synth-core';
5
+ export { DefaultsStore, UI_SCALE_MIN, UI_SCALE_MAX, CHAT_SCALE_MIN, CHAT_SCALE_MAX } from '@itphx/synth-core';