@itphx/synth-backend 0.11.3 → 0.13.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.
Files changed (40) hide show
  1. package/dist/app/deps.d.ts +37 -5
  2. package/dist/app/deps.js +1172 -37
  3. package/dist/app/listen.d.ts +7 -1
  4. package/dist/app/listen.js +182 -16
  5. package/dist/app/mount-routes.js +493 -12
  6. package/dist/app/sse-events.d.ts +4 -0
  7. package/dist/app/sse-events.js +53 -6
  8. package/dist/app.d.ts +30 -2
  9. package/dist/app.js +54 -8
  10. package/dist/auth/guards.d.ts +15 -0
  11. package/dist/auth/guards.js +37 -1
  12. package/dist/auth/plugin-scope.d.ts +10 -0
  13. package/dist/auth/plugin-scope.js +69 -0
  14. package/dist/events/hub.d.ts +17 -0
  15. package/dist/events/hub.js +46 -14
  16. package/dist/lib/app-config.d.ts +4 -0
  17. package/dist/lib/app-config.js +4 -2
  18. package/dist/lib/defaults-store.d.ts +1 -1
  19. package/dist/lib/defaults-store.js +2 -2
  20. package/dist/lib/i18n.js +123 -2
  21. package/dist/lib/recalc-can-summarize.js +8 -3
  22. package/dist/main.js +52 -3
  23. package/dist/routes/agents.d.ts +11 -2
  24. package/dist/routes/agents.js +15 -2
  25. package/dist/routes/auth.d.ts +11 -1
  26. package/dist/routes/auth.js +45 -3
  27. package/dist/routes/llm.js +29 -7
  28. package/dist/routes/mcp-registry.d.ts +13 -1
  29. package/dist/routes/mcp-registry.js +120 -19
  30. package/dist/routes/messages.d.ts +4 -2
  31. package/dist/routes/messages.js +7 -1
  32. package/dist/routes/processes.d.ts +34 -0
  33. package/dist/routes/processes.js +26 -0
  34. package/dist/routes/projects.d.ts +14 -2
  35. package/dist/routes/projects.js +28 -1
  36. package/dist/routes/queue.d.ts +4 -1
  37. package/dist/routes/queue.js +4 -1
  38. package/dist/routes/sessions.d.ts +74 -6
  39. package/dist/routes/sessions.js +85 -93
  40. package/package.json +6 -6
@@ -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
@@ -2,7 +2,7 @@ import { createServer } from 'node:http';
2
2
  import { WebSocketServer } from 'ws';
3
3
  import { Hono } from 'hono';
4
4
  import { MetricsRegistry } from '@itphx/synth-core';
5
- import type { EventBus, SessionManager, QueueProcessorManager, ChatOrchestrator, ProjectRepository, SettingsRepository, EventRouter, RequestSessionService, EventBindingRepository, EventJournalRepository, EventIngress, ScheduleRepository, SchedulerService, WebhookRepository, WebhookService } from '@itphx/synth-core';
5
+ import type { EventBus, SessionManager, QueueProcessorManager, ChatOrchestrator, ProjectRepository, SettingsRepository, EventRouter, RequestSessionService, EventBindingRepository, EventJournalRepository, EventIngress, ScheduleRepository, SchedulerService, WebhookRepository, WebhookService, PluginRuntime, McpManager } from '@itphx/synth-core';
6
6
  import type { BackendConfig } from './lib/app-config.js';
7
7
  import type { AuthKit } from './auth/middleware.js';
8
8
  import type { EventHub } from './events/hub.js';
@@ -43,6 +43,16 @@ export interface BackendAppHandle {
43
43
  eventJournal: EventJournalRepository;
44
44
  /** ADR-089: ingress-точка приёма внешних событий. */
45
45
  ingress: EventIngress;
46
+ /**
47
+ * ADR-090 (Ф5б-1): рантайм плагинов — старт-активация установленного
48
+ * (`main.ts`) и точки для HTTP API/CLI (Ф5б-2/3).
49
+ */
50
+ pluginRuntime: PluginRuntime;
51
+ /**
52
+ * ADR-071 §2.5: менеджер MCP. Конфиг серверов приходит из единого реестра
53
+ * (в т.ч. после привязки внешнего доступа к коннектору, ADR-105 Ф4).
54
+ */
55
+ mcpManager: McpManager;
46
56
  scheduleStore: ScheduleRepository;
47
57
  scheduler: SchedulerService;
48
58
  /** ADR-051 (срез): остановка планировщика (на graceful shutdown). */
@@ -51,8 +61,26 @@ export interface BackendAppHandle {
51
61
  stopEphemeralSweeper: () => void;
52
62
  /** ADR-089: остановка периодической retention-очистки журнала событий. */
53
63
  stopEventJournalPruner: () => void;
54
- /** PROP-102: остановка retention-очистки суточных роллапов аналитики. */
64
+ /** ADR-102: остановка retention-очистки суточных роллапов аналитики. */
55
65
  stopAnalyticsRollupPruner: () => void;
66
+ /**
67
+ * Этап 1 roadmap 0.13 (блок 3): остановка retention-очистки вопросов и
68
+ * освобождение ожиданий ответа.
69
+ */
70
+ stopQuestionPruner: () => void;
71
+ /**
72
+ * Этап 1 roadmap 0.13 (блок 4): остановка retention-очистки реестра фоновых
73
+ * прогонов (PROP-096).
74
+ */
75
+ stopBackgroundRunPruner: () => void;
76
+ /**
77
+ * PROP-097 (блок 5b): остановка retention-очистки логов фоновых процессов.
78
+ */
79
+ stopProcessLogPruner: () => void;
80
+ /** ADR-115: остановка GC осиротевших вложений сообщений. */
81
+ stopAttachmentPruner: () => void;
82
+ /** ADR-115 × ADR-077: остановка уборки временных каталогов медиа-раннера. */
83
+ stopMediaTempPruner: () => void;
56
84
  /** ADR-052 (этап II): реестр подписок webhooks (для тестов/диагностики). */
57
85
  webhookStore: WebhookRepository;
58
86
  /** ADR-052 (этап II): движок исходящих webhooks. */
package/dist/app.js CHANGED
@@ -17,11 +17,13 @@ import { Hono } from 'hono';
17
17
  import { cors } from 'hono/cors';
18
18
  import { logger } from 'hono/logger';
19
19
  import { createMiddleware } from 'hono/factory';
20
- import { applyBootstrapServiceKeys, createHealthRoutes, createHttpMetricsMiddleware, createMetricsRoutes, KeyRateLimiter, getServiceCredential, MetricsRegistry, registerProcessMetrics, resolveMetricsEnabled, resolveMetricsToken, setSynthReady, } from '@itphx/synth-core';
20
+ import { applyBootstrapServiceKeys, checkExecutionMode, createHealthRoutes, createHttpMetricsMiddleware, createMetricsRoutes, KeyRateLimiter, getServiceCredential, MetricsRegistry, registerProcessMetrics, resolveMetricsEnabled, resolveMetricsToken, resolvePluginServerPolicy, setSynthReady, } from '@itphx/synth-core';
21
+ import { resolveExecutionConfig } from '@itphx/synth-shared';
21
22
  import { createStorageDegradedGuard, createStorageStatusRoutes } from '@itphx/synth-core/server/storage-degraded.js';
22
23
  import { loadBackendConfig } from './lib/app-config.js';
23
24
  import { resolveCorsOrigin } from './lib/cors.js';
24
25
  import { createAuthMiddleware } from './auth/middleware.js';
26
+ import { requirePluginTokenBinding } from './auth/plugin-scope.js';
25
27
  import { createAuthRoutes } from './routes/auth.js';
26
28
  import { t } from './lib/i18n.js';
27
29
  import { createBackendDeps, createBackendStorage } from './app/deps.js';
@@ -54,9 +56,17 @@ export async function createBackendApp(opts = {}) {
54
56
  try {
55
57
  // Конфигурация
56
58
  const backendConfig = await loadBackendConfig({ configPath: opts.configPath });
59
+ // ADR-077: топология исполнения — параметр запуска (инвариант 24). Fail-closed:
60
+ // неверный `mode`/`failMode` — ошибка; `remote` без адресов/пакета исполнителя/
61
+ // читаемого токена — старт прерывается, а не «молча уходит в inline».
62
+ const execution = resolveExecutionConfig(backendConfig.synth, process.env);
63
+ const executionCheck = await checkExecutionMode(execution);
64
+ if (!executionCheck.ok) {
65
+ throw new Error(executionCheck.message);
66
+ }
57
67
  const app = new Hono();
58
68
  app.use(logger());
59
- // PROP-032 (W2.4): единый контекст хранения — собирается до `auth`, реестр
69
+ // ADR-096 (W2.4): единый контекст хранения — собирается до `auth`, реестр
60
70
  // service-key (`storage.serviceKeys`) нужен резолверу `synth_svc_…`; тот же
61
71
  // инстанс переиспользует `createBackendDeps` (в т.ч. `mcpRegistry`, который
62
72
  // деп сидирует instance-серверами).
@@ -78,7 +88,7 @@ export async function createBackendApp(opts = {}) {
78
88
  if (metricsEnabled)
79
89
  app.use('*', createHttpMetricsMiddleware(metrics));
80
90
  // CORS настраивается после загрузки конфига
81
- // Health (без auth). PROP-032 (W5): при деградации хранилища status='degraded'
91
+ // Health (без auth). ADR-098 (W5): при деградации хранилища status='degraded'
82
92
  // + блок storage (аддитивно к {status, version, time}). `degradedInfo`
83
93
  // заполняется после сборки контекста хранения ниже (до первого запроса).
84
94
  // ADR-094: `/ready` — readiness (200 и при деградации, 503 — только не готов).
@@ -113,7 +123,7 @@ export async function createBackendApp(opts = {}) {
113
123
  }),
114
124
  credentials: true,
115
125
  }));
116
- // PROP-032 (W5): состояние деградации — для health/guard/диагностики
126
+ // ADR-098 (W5): состояние деградации — для health/guard/диагностики
117
127
  // (уже проставлено при сборке контекста выше).
118
128
  // ADR-052 (этап I): реестр service-key — резолвер ключа `synth_svc_…`
119
129
  // нужен аутентификации (паритет с core `server/app.ts`).
@@ -162,10 +172,26 @@ export async function createBackendApp(opts = {}) {
162
172
  // Зависимости (stores/managers/оркестратор/событийное ядро/шедулер/webhooks).
163
173
  // Тот же контекст хранения, что собран до `auth`. ADR-094: реестр передаётся
164
174
  // только при `metrics.enabled` — иначе доменные коллекторы не подключаются.
165
- const deps = await createBackendDeps(backendConfig, storage, metricsEnabled ? metrics : undefined);
175
+ const deps = await createBackendDeps(backendConfig, storage, metricsEnabled ? metrics : undefined, execution);
166
176
  // Auth routes (после profilesStore)
167
- app.route('/auth', createAuthRoutes(auth, backendConfig.auth, deps.profilesStore, deps.dataDir, deps.defaultsStore));
168
- // PROP-032 (W5): деградированное хранилище — managed: доступ только роли
177
+ app.route('/auth', createAuthRoutes(auth, backendConfig.auth, deps.profilesStore, deps.dataDir, deps.defaultsStore,
178
+ // ADR-090 Ф7: сигнал о серверной политике плагинов для публичного
179
+ // дискавери (`/auth/oidc-meta`) — только режим и признак включения
180
+ // слоя, без списка имён.
181
+ {
182
+ enabled: deps.pluginRuntime.config.enabled,
183
+ mode: deps.pluginRuntime.config.hybrid.mode,
184
+ }));
185
+ // ADR-090 Ф7 (Уровень 2): plugin-bound service-key (`plugin_id`)
186
+ // принимается только с заголовком `X-Synth-Plugin-Id` и тем же
187
+ // значением, со scope `plugins:invoke` и — при
188
+ // `plugins.hybrid.mode='allowlist'` — с именем плагина в серверном
189
+ // allow-list. Гейт стоит на границе (после `attachUser`, где уже
190
+ // разрешён service-кредентал), поэтому правило действует на **все**
191
+ // серверные API, а не только на плагинные роуты. Fail-closed: ключ с
192
+ // привязкой без корректного заголовка отвергается всегда.
193
+ app.use('/api/v2/*', requirePluginTokenBinding(() => resolvePluginServerPolicy(deps.pluginRuntime.config)));
194
+ // ADR-098 (W5): деградированное хранилище — managed: доступ только роли
169
195
  // ADMIN (остальным 503 STORAGE_DEGRADED), мутации — 503 STORAGE_DEGRADED_READONLY
170
196
  // (кроме ремонтных операций maintenance). Guard — после auth-роутов (логин/health
171
197
  // не блокируются) и до admin-роутов.
@@ -177,7 +203,7 @@ export async function createBackendApp(opts = {}) {
177
203
  },
178
204
  mutationAllowlist: ['/api/v2/maintenance'],
179
205
  }));
180
- // PROP-032 (W5): диагностика деградации (проверка соединения + «нужен рестарт»).
206
+ // ADR-098 (W5): диагностика деградации (проверка соединения + «нужен рестарт»).
181
207
  app.route('/', createStorageStatusRoutes({ getDegraded: () => degradedInfo }));
182
208
  // Роуты API v2 (порядок монтирования — как раньше, см. mount-routes.ts).
183
209
  mountBackendRoutes(app, auth, {
@@ -217,6 +243,9 @@ export async function createBackendApp(opts = {}) {
217
243
  processMessage: deps.processMessage,
218
244
  orchestrator: deps.orchestrator,
219
245
  defaultPort: backendConfig.port,
246
+ // ADR-106 Ф3: реестр подтверждений — ответ на `permission_reply`
247
+ // принимает только носитель покрывающего гранта (не «кто видит сессию»).
248
+ approvalRegistry: deps.approvalRegistry,
220
249
  // ADR-094: активные WS-соединения — в streams_active (если метрики включены).
221
250
  metrics: metricsEnabled ? metrics : undefined,
222
251
  });
@@ -257,6 +286,10 @@ export async function createBackendApp(opts = {}) {
257
286
  eventBindingStore: deps.eventBindingStore,
258
287
  eventJournal: deps.eventJournal,
259
288
  ingress: deps.eventIngress,
289
+ // ADR-090 (Ф5б-1): рантайм плагинов — старт-активация в `main.ts`
290
+ // и точки для HTTP API/CLI (Ф5б-2/3).
291
+ pluginRuntime: deps.pluginRuntime,
292
+ mcpManager: deps.mcpManager,
260
293
  // ADR-051 (срез) / ADR-089: реестр расписаний и планировщик.
261
294
  scheduleStore: deps.scheduleStore,
262
295
  scheduler: deps.schedulerService,
@@ -264,6 +297,19 @@ export async function createBackendApp(opts = {}) {
264
297
  stopEphemeralSweeper: deps.stopEphemeralSweeper,
265
298
  stopEventJournalPruner: deps.stopEventJournalPruner,
266
299
  stopAnalyticsRollupPruner: deps.stopAnalyticsRollupPruner,
300
+ // Этап 1 roadmap 0.13 (блок 3): retention-очистка вопросов + ожидания.
301
+ stopQuestionPruner: () => {
302
+ deps.stopQuestionPruner();
303
+ deps.questionService?.dispose();
304
+ },
305
+ // Этап 1 roadmap 0.13 (блок 4): retention-очистка реестра фоновых прогонов.
306
+ stopBackgroundRunPruner: () => deps.stopBackgroundRunPruner(),
307
+ // PROP-097 (блок 5b): retention-очистка логов фоновых процессов.
308
+ stopProcessLogPruner: () => deps.stopProcessLogPruner(),
309
+ // ADR-115: GC осиротевших вложений сообщений.
310
+ stopAttachmentPruner: () => deps.stopAttachmentPruner(),
311
+ // ADR-115 × ADR-077: уборка временных каталогов медиа-раннера.
312
+ stopMediaTempPruner: () => deps.stopMediaTempPruner(),
267
313
  // ADR-052 (этап II): реестр подписок и движок webhooks + остановка на shutdown.
268
314
  webhookStore: deps.webhookStore,
269
315
  webhookService: deps.webhookService,
@@ -11,6 +11,21 @@
11
11
  * скиллов и чтении пользователей.
12
12
  */
13
13
  export declare function requireAdminOrScope(...scopes: string[]): import("hono").MiddlewareHandler<any, string, {}, Response>;
14
+ /**
15
+ * Guard «scope **или** роль ADMIN»:
16
+ * - service-key → проходит, если у него есть хотя бы один из `scopes`
17
+ * (`403 SCOPE_REQUIRED` иначе) **или** среди выданных ролей есть `ADMIN`
18
+ * (роль ключа — явное решение администратора, и до введения зонтичных
19
+ * scope'ов именно она давала доступ к таким операциям);
20
+ * - интерактивные креды (cookie/debug/OIDC/API-key/локальный ключ) → требуем
21
+ * роль ADMIN: нет аутентификации → `401 UNAUTHORIZED`, аутентифицирован без
22
+ * роли → `403 FORBIDDEN` (семантика HTTP; раньше оба случая склеивались в 403).
23
+ *
24
+ * Отличие от `requireAdminOrScope`: там для service-key проверяются **только**
25
+ * scope'ы (роль ADMIN ключа не учитывается) — здесь учитывается, чтобы
26
+ * зонтичный scope не отбирал права у ключей с ролью ADMIN.
27
+ */
28
+ export declare function requireAdminRoleOrScope(...scopes: string[]): import("hono").MiddlewareHandler<any, string, {}, Response>;
14
29
  /**
15
30
  * Guard «service-key → scope»: для service-key требует хотя бы один из `scopes`;
16
31
  * интерактивные креды пропускает без изменений (их гейтит `requireAuth`/логика
@@ -1,6 +1,7 @@
1
1
  import { createMiddleware } from 'hono/factory';
2
2
  import { getServiceCredential } from '@itphx/synth-core';
3
- import { hasServiceScope } from '@itphx/synth-shared';
3
+ import { hasAnyServiceScope, hasServiceScope } from '@itphx/synth-shared';
4
+ import { GlobalRole } from '@itphx/synth-shared/types';
4
5
  import { t } from '../lib/i18n.js';
5
6
  /**
6
7
  * ADR-052/O1: комбинированные guard'ы «ADMIN **или** scope» для эндпоинтов,
@@ -55,6 +56,41 @@ export function requireAdminOrScope(...scopes) {
55
56
  await next();
56
57
  });
57
58
  }
59
+ /**
60
+ * Guard «scope **или** роль ADMIN»:
61
+ * - service-key → проходит, если у него есть хотя бы один из `scopes`
62
+ * (`403 SCOPE_REQUIRED` иначе) **или** среди выданных ролей есть `ADMIN`
63
+ * (роль ключа — явное решение администратора, и до введения зонтичных
64
+ * scope'ов именно она давала доступ к таким операциям);
65
+ * - интерактивные креды (cookie/debug/OIDC/API-key/локальный ключ) → требуем
66
+ * роль ADMIN: нет аутентификации → `401 UNAUTHORIZED`, аутентифицирован без
67
+ * роли → `403 FORBIDDEN` (семантика HTTP; раньше оба случая склеивались в 403).
68
+ *
69
+ * Отличие от `requireAdminOrScope`: там для service-key проверяются **только**
70
+ * scope'ы (роль ADMIN ключа не учитывается) — здесь учитывается, чтобы
71
+ * зонтичный scope не отбирал права у ключей с ролью ADMIN.
72
+ */
73
+ export function requireAdminRoleOrScope(...scopes) {
74
+ return createMiddleware(async (c, next) => {
75
+ const cred = getServiceCredential(c);
76
+ if (cred) {
77
+ const hasScope = hasAnyServiceScope(cred.scopes, scopes);
78
+ const adminKey = Array.isArray(cred.roles) && cred.roles.includes(GlobalRole.ADMIN);
79
+ if (!hasScope && !adminKey) {
80
+ return scopeDenied(c);
81
+ }
82
+ await next();
83
+ return;
84
+ }
85
+ if (!isAuthenticated(c)) {
86
+ return c.json({ error: { code: 'UNAUTHORIZED', message: t('auth.unauthorized', undefined, c) } }, 401);
87
+ }
88
+ if (!isAdmin(c)) {
89
+ return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
90
+ }
91
+ await next();
92
+ });
93
+ }
58
94
  /**
59
95
  * Guard «service-key → scope»: для service-key требует хотя бы один из `scopes`;
60
96
  * интерактивные креды пропускает без изменений (их гейтит `requireAuth`/логика
@@ -0,0 +1,10 @@
1
+ import type { PluginServerPolicy } from '@itphx/synth-shared';
2
+ /**
3
+ * Guard plugin-bound токена (Ф7): монтируется **после** резолва
4
+ * service-кредентал и **до** роутов, поэтому правило действует на все
5
+ * серверные API, а не только на плагинные.
6
+ *
7
+ * `getPolicy` — живой серверный allow-list (`plugins.hybrid`); политика
8
+ * меняется рестартом (инвариант 24), поэтому берётся из работающего рантайма.
9
+ */
10
+ export declare function requirePluginTokenBinding(getPolicy: () => PluginServerPolicy | undefined): import("hono").MiddlewareHandler<any, string, {}, Response>;
@@ -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
+ }
@@ -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);
@@ -91,15 +91,50 @@ export class EventHub {
91
91
  if (!subs || subs.has(ALL_SESSIONS_KEY))
92
92
  return;
93
93
  const unsub = this.eventBus.subscribeAll((event) => {
94
- try {
95
- client.send(event);
96
- }
97
- catch {
98
- // ignore send errors
99
- }
94
+ this._deliver(client, event);
100
95
  });
101
96
  subs.set(ALL_SESSIONS_KEY, unsub);
102
97
  }
98
+ /**
99
+ * ADR-118 §4: адресная доставка.
100
+ *
101
+ * Событие с `recipient` получает **только** клиент с совпадающим `userId`
102
+ * (broadcast — без `recipient` — получают все подписчики сессии).
103
+ */
104
+ _deliver(client, event) {
105
+ if (event.recipient && event.recipient !== client.userId)
106
+ return;
107
+ try {
108
+ client.send(event);
109
+ }
110
+ catch {
111
+ // ignore send errors
112
+ }
113
+ }
114
+ /**
115
+ * ADR-118 §6: догон — события журнала строго после `afterSeq` для сессий,
116
+ * на которые подписан клиент (`Last-Event-ID` / `?since`).
117
+ *
118
+ * Watch-all клиент (service-key / сквозной обзор) получает журнал всех
119
+ * сессий; обычный клиент — только своих. Номер события глобальный и
120
+ * монотонный в пределах инстанса, поэтому порядок между сессиями — точный
121
+ * (по номеру).
122
+ */
123
+ replayForClient(client, afterSeq) {
124
+ const subs = this.clientSubs.get(client);
125
+ if (!subs)
126
+ return [];
127
+ const sessionIds = [...subs.keys()].filter((id) => id !== ALL_SESSIONS_KEY);
128
+ if (sessionIds.length === 0) {
129
+ return this.eventBus.journalSince(afterSeq);
130
+ }
131
+ const out = [];
132
+ for (const sessionId of sessionIds) {
133
+ out.push(...this.eventBus.since(sessionId, afterSeq));
134
+ }
135
+ out.sort((a, b) => (a.eventSeq ?? 0) - (b.eventSeq ?? 0));
136
+ return out;
137
+ }
103
138
  _subscribeClientToSession(client, sessionId) {
104
139
  // all-клиент покрыт глобальной подпиской — per-session подписки не нужны
105
140
  // (иначе дубли доставки).
@@ -111,12 +146,7 @@ export class EventHub {
111
146
  if (subs.has(sessionId))
112
147
  return;
113
148
  const unsub = this.eventBus.subscribe(sessionId, (event) => {
114
- try {
115
- client.send(event);
116
- }
117
- catch {
118
- // ignore send errors
119
- }
149
+ this._deliver(client, event);
120
150
  // Автоподписка на дочернюю сессию саб-агента. Раньше клиент получал
121
151
  // live-события (`stream.usage`/`stream.chunk`) только по сессиям из
122
152
  // `listSessions` и созданным/форкнутым через роуты; child-сессию тул
@@ -128,7 +158,9 @@ export class EventHub {
128
158
  if (childId && childId !== sessionId) {
129
159
  this._subscribeClientToSession(client, childId);
130
160
  }
131
- });
161
+ // ADR-118 §4: адресная доставка на уровне шины — подписчик сессии
162
+ // получает событие с `recipient` только при совпадении `userId`.
163
+ }, { userId: client.userId });
132
164
  subs.set(sessionId, unsub);
133
165
  }
134
166
  _unsubscribeClientFromAll(client) {
@@ -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,4 @@
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
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) => {
@@ -60,6 +60,8 @@ export async function loadBackendConfig(options) {
60
60
  const dataDir = resolveDataDir(synth);
61
61
  const workspacesRoot = resolveWorkspacesRoot(synth);
62
62
  const maxUploadBytes = resolveMaxUploadBytes(synth);
63
+ const maxReadBytes = resolveMaxReadBytes(synth);
64
+ const maxPreviewBytes = resolveMaxPreviewBytes(synth);
63
65
  const port = resolvePort(synth, 'SYNTH_PORT', synth.server.port);
64
- return { synth, dataDir, workspacesRoot, maxUploadBytes, port, auth };
66
+ return { synth, dataDir, workspacesRoot, maxUploadBytes, maxReadBytes, maxPreviewBytes, port, auth };
65
67
  }
@@ -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';
@@ -1,5 +1,5 @@
1
- // PROP-032 (W2.3): реализация перенесена в core (`storage/defaults-store.ts`) —
1
+ // ADR-096 (W2.3): реализация перенесена в core (`storage/defaults-store.ts`) —
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';