@itphx/synth-backend 0.13.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 (45) hide show
  1. package/dist/app/deps.d.ts +8 -0
  2. package/dist/app/deps.js +126 -9
  3. package/dist/app/mount-routes.js +155 -32
  4. package/dist/app/public-routes.d.ts +2 -0
  5. package/dist/app/public-routes.js +11 -0
  6. package/dist/app.d.ts +1 -1
  7. package/dist/app.js +31 -0
  8. package/dist/auth/api-key.d.ts +19 -0
  9. package/dist/auth/api-key.js +56 -0
  10. package/dist/auth/middleware.js +7 -3
  11. package/dist/events/hub.js +4 -1
  12. package/dist/init.d.ts +1 -0
  13. package/dist/init.js +96 -0
  14. package/dist/lib/app-config.js +12 -1
  15. package/dist/lib/bind-host.d.ts +10 -0
  16. package/dist/lib/bind-host.js +32 -0
  17. package/dist/lib/i18n.js +10 -0
  18. package/dist/main.js +4 -1
  19. package/dist/middleware/rate-limiter.d.ts +4 -1
  20. package/dist/middleware/rate-limiter.js +15 -2
  21. package/dist/routes/auth.js +5 -20
  22. package/dist/routes/llm.js +65 -7
  23. package/dist/routes/mcp-remote.d.ts +23 -0
  24. package/dist/routes/mcp-remote.js +152 -0
  25. package/dist/routes/mcp.d.ts +11 -6
  26. package/dist/routes/mcp.js +35 -6
  27. package/dist/routes/projects.d.ts +1 -1
  28. package/dist/routes/projects.js +11 -2
  29. package/dist/routes/providers.d.ts +4 -1
  30. package/dist/routes/providers.js +19 -99
  31. package/dist/routes/sessions.d.ts +15 -6
  32. package/dist/routes/sessions.js +257 -183
  33. package/package.json +4 -4
  34. package/dist/routes/audit.d.ts +0 -17
  35. package/dist/routes/audit.js +0 -64
  36. package/dist/routes/context.d.ts +0 -4
  37. package/dist/routes/context.js +0 -93
  38. package/dist/routes/debug.d.ts +0 -3
  39. package/dist/routes/debug.js +0 -30
  40. package/dist/routes/gateway-patterns.d.ts +0 -9
  41. package/dist/routes/gateway-patterns.js +0 -57
  42. package/dist/routes/logs.d.ts +0 -24
  43. package/dist/routes/logs.js +0 -100
  44. package/dist/routes/mcp-registry.d.ts +0 -28
  45. package/dist/routes/mcp-registry.js +0 -483
@@ -5,12 +5,20 @@ import { scopeGuard, serviceProjectProjection } from '../auth/service-scope.js';
5
5
  import { enqueueUserMessage, serializeSession, createSessionAccessGuard, createSessionAccessPredicate, createSessionExportGuard, getSessionExportDecision, isSessionExportPath, createSessionRoutes as createCoreSessionRoutes, stripSessionSecrets, resolveUserPrincipal, } from '@itphx/synth-core';
6
6
  import { t } from '../lib/i18n.js';
7
7
  import { createProjectAccess } from './projects.js';
8
+ /**
9
+ * Максимум сессий в одном пакетном импорте (`POST /sessions/import-batch`).
10
+ * Защита от гигантских тел и длинных транзакционных серий.
11
+ */
12
+ const MAX_IMPORT_BATCH = 200;
13
+ /** Предел длины маркера источника (`import.source_session_id`), символов. */
14
+ const MAX_IMPORT_SOURCE_ID_LENGTH = 200;
8
15
  /**
9
16
  * Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
10
- * backend-специфичные роуты (MCP-скоуп сессии, секреты, export/import, отладка,
11
- * оптимизация контекста). Общая логика (список/создание/чтение/изменение/
17
+ * backend-специфичные роуты (MCP-скоуп сессии и секреты — более строгая политика
18
+ * managed, export/import, отладка). Общая логика (список/создание/чтение/изменение/
12
19
  * удаление, status/prompt/stats, заметки (`notes`), очередь+SSE, children/tree/
13
- * fork, references, merge) — в `createSessionRoutes` из `@itphx/synth-core`.
20
+ * fork, references, merge, оптимизация контекста, core-версии MCP-скоупа и
21
+ * секретов для standalone/гибрида) — в `createSessionRoutes` из `@itphx/synth-core`.
14
22
  *
15
23
  * RBAC: core-фабрика параметризуется `resolveUserId`/`resolveOwner`/`resolveAuthor`,
16
24
  * `canAccess` (владелец|ADMIN) и EventHub-хуками; remote/hybrid-ветки отключены
@@ -19,7 +27,9 @@ import { createProjectAccess } from './projects.js';
19
27
  *
20
28
  * Исключения из общего prefix-guard'а (собственные правила, роуты зарегистрированы
21
29
  * до guard'а): `/:id/mcp` (владелец|ADMIN, ADR-071 §2.4) и `/:id/secrets`
22
- * (ADMIN|AUDITOR — карта обфускации). `/:id/export` — ПОД guard'ом: доступ к
30
+ * (ADMIN|AUDITOR — карта обфускации). В core-фабрике есть версии этих маршрутов
31
+ * для standalone/гибрида; здесь они регистрируются раньше и потому выигрывают,
32
+ * сохраняя прежнюю политику. `/:id/export` — ПОД guard'ом: доступ к
23
33
  * сессии решает ЕДИНЫЙ prefix-guard, а привилегию карты обфускации — отдельный
24
34
  * route-level guard (`createSessionExportGuard`, ADR-036); в обработчике проверок
25
35
  * доступа нет (инвариант 16).
@@ -45,7 +55,7 @@ memory,
45
55
  */
46
56
  questionService,
47
57
  /**
48
- * ADR-114: сервис worktree'ов — привязка сессии к worktree
58
+ * ADR-114: сервис worktree — привязка сессии к worktree
49
59
  * (`PATCH /api/v2/sessions/:id { worktreeId }`).
50
60
  *
51
61
  * Не задан — поле `worktreeId` в PATCH игнорируется (привязка недоступна).
@@ -77,23 +87,31 @@ getStickyNoteLimits,
77
87
  * Доступность пары провайдер/модель **до постановки в очередь** (каталог
78
88
  * инстанса). Не задана — проверка выключена.
79
89
  */
80
- llmAvailability) {
90
+ llmAvailability,
91
+ /**
92
+ * Лимит тяжёлых операций ресурса сессий (`limits.sessionOpsPerMinute`,
93
+ * import/export/fork/merge) — live-геттер. Не задан — 10 (прежнее поведение).
94
+ * `0` — без ограничения; значение применяется без рестарта.
95
+ */
96
+ getSessionOpsPerMinute) {
81
97
  const app = new Hono();
82
98
  const agentRegistry = orchestrator.agentRegistry;
83
99
  const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
84
100
  // ADR-071 §2.4: владелец сессии — обычный пользователь, управляющий её MCP-скоупом.
85
101
  const isSessionOwner = (session, userId) => (session.ownerId ?? session.userId) === userId;
86
102
  /**
87
- * Rate limit на тяжёлые/неинтерактивные операции ресурса сессий (import/export/
88
- * fork/merge): 10 запросов / 60 с на креду — тот же in-memory `createRateLimiter`,
89
- * что у `POST /:id/prompt` (30/60) и `schedules/:id/run` (10/60). Значение ниже
90
- * prompt: операции не частые в живом UI, но дорогие (полный объект сессии,
91
- * создание форка, копирование сообщений) — защита от всплесков/выкачивания.
103
+ * Rate limit на тяжёлые/неинтерактивные операции ресурса сессий (import/
104
+ * export/fork/merge): значение настраивается instance-wide
105
+ * (`limits.sessionOpsPerMinute`, дефолт 10 запросов / 60 с на креду),
106
+ * `0` — без лимита. Тот же in-memory `createRateLimiter`, что у
107
+ * `POST /:id/prompt` (30/60) и `schedules/:id/run` (10/60). Порог —
108
+ * live-геттер: runtime-изменение из админки применяется без рестарта.
92
109
  */
93
- const importRateLimit = createRateLimiter(10, 60_000);
94
- const exportRateLimit = createRateLimiter(10, 60_000);
95
- const forkRateLimit = createRateLimiter(10, 60_000);
96
- const mergeRateLimit = createRateLimiter(10, 60_000);
110
+ const sessionOpsLimit = () => getSessionOpsPerMinute?.() ?? 10;
111
+ const importRateLimit = createRateLimiter(sessionOpsLimit, 60_000);
112
+ const exportRateLimit = createRateLimiter(sessionOpsLimit, 60_000);
113
+ const forkRateLimit = createRateLimiter(sessionOpsLimit, 60_000);
114
+ const mergeRateLimit = createRateLimiter(sessionOpsLimit, 60_000);
97
115
  /**
98
116
  * Единое правило доступа к сессии (читать/писать) — ОДНА точка на весь ресурс
99
117
  * `/api/v2/sessions`, включая backend-only маршруты (export/debug/optimization/
@@ -156,8 +174,8 @@ llmAvailability) {
156
174
  sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
157
175
  forbidden: (c) => t('auth.forbidden', undefined, c),
158
176
  },
159
- // `/import` — статический сегмент (не id сессии).
160
- skipForId: (id) => id === 'import',
177
+ // `/import` и `/import-batch` — статические сегменты (не id сессии).
178
+ skipForId: (id) => id === 'import' || id === 'import-batch',
161
179
  });
162
180
  /**
163
181
  * Привилегия карты обфускации при экспорте сессии (ADR-036, security-фикс
@@ -264,9 +282,10 @@ llmAvailability) {
264
282
  });
265
283
  // Единый prefix-guard ресурса сессий: вешается ПОСЛЕ `/:id/mcp` и `/:id/secrets`
266
284
  // (у них собственные задокументированные правила) и покрывает отладку,
267
- // оптимизацию, заметки, ЭКСПОРТ и все core-маршруты (core-фабрика
268
- // регистрируется с registerAccessGuard:false — иначе был бы второй источник
269
- // правил). `/import` пропускается через guard.skipForId (статический сегмент,
285
+ // оптимизацию (реализация — в core-фабрике, регистрируется ниже), заметки,
286
+ // ЭКСПОРТ и все core-маршруты (core-фабрика регистрируется с
287
+ // registerAccessGuard:false — иначе был бы второй источник правил).
288
+ // `/import` пропускается через guard.skipForId (статический сегмент,
270
289
  // не сессия).
271
290
  app.use('/:id', kit.requireAuth, sessionAccessGuard);
272
291
  app.use('/:id/*', kit.requireAuth, sessionAccessGuard);
@@ -308,53 +327,52 @@ llmAvailability) {
308
327
  }
309
328
  return c.json(decision.withSecrets ? decision.session : stripSessionSecrets(decision.session));
310
329
  });
311
- // POST /api/v2/sessions/import — создать сессию из экспорта другой сессии
312
- // (перенос истории между мирами). Тело: объект экспорта + import.project_id
313
- // (целевой проект; если не задан — берётся из экспорта). LLM не запускается.
314
- // ADR-089: это materialization-операция (создание-как-факт переноса истории),
315
- // а не request — идёт прямым `createSession`, минуя funnel `session.requested`.
316
- app.post('/import', kit.requireAuth, importRateLimit, async (c) => {
317
- const user = (await kit.getCurrentUser(c));
318
- const body = await c.req.json().catch(() => ({}));
319
- const targetProjectId = body.import?.project_id
320
- ?? body.import?.projectId
321
- ?? body.project_id
322
- ?? body.projectId
323
- ?? undefined;
324
- if (targetProjectId) {
325
- if (!projectStore) {
326
- return c.json({ error: { code: 'INTERNAL_ERROR', message: 'Хранилище проектов недоступно' } }, 500);
327
- }
328
- const existing = await projectStore.load(targetProjectId);
329
- if (!existing) {
330
- return c.json({ error: { code: 'PROJECT_NOT_FOUND', message: 'Проект не найден' } }, 400);
331
- }
332
- // Безопасность: импорт привязывает сессию к проекту и выдаёт агенту его
333
- // workspace — без проверки доступа к проекту получается IDOR (чтение/запись
334
- // файлов чужого проекта).
335
- //
336
- // Импорт сессии В ПРОЕКТ — это ЗАПИСЬ в проект (инвариант 21: read-уровень
337
- // доступа не расширяет права на изменение), поэтому нужен уровень
338
- // «редактирование контента проекта» (`canEditProjectContent`: owner /
339
- // EDITOR / LEAD / ADMIN) — тот же, что у импорта проекта целиком
340
- // (`core/server/routes/project-portable.ts`, `deps.canEdit`). Участник с
341
- // ролью VIEWER получает 403.
342
- if (!canEditProjectContent(c, existing, user.id)) {
343
- return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
330
+ /**
331
+ * Маркер источника из `body.import` (`source_session_id` | `sourceSessionId`):
332
+ * непустая строка ≤ 200 символов; иначе маркера нет (дедуп не применяется).
333
+ */
334
+ const readImportSourceId = (body) => {
335
+ const imp = body.import;
336
+ const raw = imp?.source_session_id ?? imp?.sourceSessionId;
337
+ if (typeof raw !== 'string')
338
+ return undefined;
339
+ const trimmed = raw.trim();
340
+ if (!trimmed || trimmed.length > MAX_IMPORT_SOURCE_ID_LENGTH)
341
+ return undefined;
342
+ return trimmed;
343
+ };
344
+ /**
345
+ * Применить тело экспорта к сессии — **одна реализация** для нового импорта и
346
+ * дедуплицированного обновления.
347
+ *
348
+ * `isUpdate: true` (дедуп) — «перезапись выбранного проекта»: `title`,
349
+ * `settings`, `icon`/`color` и весь контент берутся из тела. Идентичность
350
+ * записи сохраняется: `id`/`projectId`/`userId`/`ownerId`/`sessionOrigin`/
351
+ * `createdAt`/`archivedAt`/`sourceSessionId` не трогаются, `parentId`
352
+ * перезаписывается только если пришёл в теле.
353
+ *
354
+ * `isUpdate: false` (новая сессия) — поведение прежнее: `title`/`settings`
355
+ * уже проставлены `createSession` (с дефолтами), `createdAt` берётся из тела.
356
+ */
357
+ const applyImportBody = (session, body, sourceSessionId, isUpdate = false) => {
358
+ // Свойства записи: при обновлении — из тела (перезапись проекта), при
359
+ // создании их уже проставил `createSession` (там же дефолты настроек).
360
+ if (isUpdate) {
361
+ if (typeof body.title === 'string')
362
+ session.title = body.title;
363
+ if (body.settings && typeof body.settings === 'object' && !Array.isArray(body.settings)) {
364
+ session.settings = body.settings;
344
365
  }
345
366
  }
346
- // ADR-089: materialization (перенос истории), не request — прямой createSession.
347
- const session = await sessionManager.createSession({
348
- title: typeof body.title === 'string' ? body.title : undefined,
349
- projectId: targetProjectId,
350
- sessionOrigin: (body.session_origin ?? body.sessionOrigin),
351
- settings: (body.settings ?? {}),
352
- userId: user.id,
353
- ownerId: user.id,
354
- });
355
- // Переносим историю и состояние из экспорта.
356
- // parentId: publish переписывает ссылки на новые remote-id до импорта — сохраняем.
357
- session.parentId = (body.parent_id ?? body.parentId);
367
+ // parentId: publish переписывает ссылки на новые remote-id до импорта —
368
+ // сохраняем. При обновлении отсутствие поля в теле не очищает привязку.
369
+ const parentId = body.parent_id ?? body.parentId;
370
+ if (typeof parentId === 'string')
371
+ session.parentId = parentId;
372
+ else if (parentId === null)
373
+ session.parentId = undefined;
374
+ else if (!isUpdate)
375
+ session.parentId = undefined;
358
376
  const messages = Array.isArray(body.messages) ? body.messages : [];
359
377
  session.messages = messages.map((m) => ({ ...structuredClone(m), seq: 0 }));
360
378
  session.messages.forEach((m, i) => { m.seq = i + 1; });
@@ -367,21 +385,26 @@ llmAvailability) {
367
385
  session.references = Array.isArray(body.references) ? body.references : [];
368
386
  session.checkpoints = Array.isArray(body.checkpoints) ? body.checkpoints : [];
369
387
  session.mode = (body.mode ?? undefined);
370
- session.planApproved = body.plan_approved ?? body.planApproved ?? false;
371
- session.branchPoint = body.branch_point ?? body.branchPoint;
388
+ session.planApproved = (body.plan_approved ?? body.planApproved ?? false);
389
+ session.branchPoint = (body.branch_point ?? body.branchPoint);
372
390
  // Метаданные сессии (иконка/цвет) — нормализуем legacy при импорте.
373
391
  session.icon = normalizeIconKey(body.icon);
374
392
  session.color = normalizeColorKey(body.color);
375
393
  session.obfuscationMap = (body.obfuscation_map ?? body.obfuscationMap);
376
- session.createdAt = typeof (body.created_at ?? body.createdAt) === 'string'
377
- ? (body.created_at ?? body.createdAt)
378
- : session.createdAt;
394
+ // `createdAt` — идентичность записи: при обновлении сохраняем исходное
395
+ // серверное значение; при создании — как раньше, из тела экспорта.
396
+ if (!isUpdate) {
397
+ session.createdAt = typeof (body.created_at ?? body.createdAt) === 'string'
398
+ ? (body.created_at ?? body.createdAt)
399
+ : session.createdAt;
400
+ }
379
401
  session.updatedAt = nowISO();
380
402
  // Сбрасываем runtime-состояние: блокировки/стримы с другого хоста не переносим.
381
403
  session.status = {};
382
404
  session.currentStream = undefined;
383
405
  session.summarizationPending = false;
384
406
  session.canSummarize = false;
407
+ session.retry = undefined;
385
408
  const num = (v, def = 0) => (typeof v === 'number' ? v : def);
386
409
  session.inputTokens = num(body.input_tokens ?? body.inputTokens);
387
410
  session.outputTokens = num(body.output_tokens ?? body.outputTokens);
@@ -393,11 +416,165 @@ llmAvailability) {
393
416
  session.outputCost = num(body.output_cost ?? body.outputCost);
394
417
  session.cacheReadCost = num(body.cache_read_cost ?? body.cacheReadCost);
395
418
  session.cacheWriteCost = num(body.cache_write_cost ?? body.cacheWriteCost);
419
+ // Маркер источника переноса — ключ дедупликации повторного импорта.
420
+ if (sourceSessionId)
421
+ session.sourceSessionId = sourceSessionId;
422
+ };
423
+ /**
424
+ * Импорт одной сессии: проверка проекта (право записи), дедуп по маркеру
425
+ * источника, создание либо обновление. Общий код одиночного и пакетного
426
+ * маршрутов — дефолты/дедуп не разъезжаются.
427
+ */
428
+ const importSessionFromBody = async (body, userId, forbiddenMessage, ctx) => {
429
+ const imp = (body.import ?? {});
430
+ const targetProjectId = (imp.project_id
431
+ ?? imp.projectId
432
+ ?? body.project_id
433
+ ?? body.projectId
434
+ ?? undefined);
435
+ if (targetProjectId) {
436
+ if (!projectStore) {
437
+ return { ok: false, status: 500, code: 'INTERNAL_ERROR', message: 'Хранилище проектов недоступно' };
438
+ }
439
+ const existingProject = await projectStore.load(targetProjectId);
440
+ if (!existingProject) {
441
+ return { ok: false, status: 400, code: 'PROJECT_NOT_FOUND', message: 'Проект не найден' };
442
+ }
443
+ // Безопасность: импорт привязывает сессию к проекту и выдаёт агенту его
444
+ // workspace — без проверки доступа к проекту получается IDOR (чтение/запись
445
+ // файлов чужого проекта).
446
+ //
447
+ // Импорт сессии В ПРОЕКТ — это ЗАПИСЬ в проект (инвариант 21: read-уровень
448
+ // доступа не расширяет права на изменение), поэтому нужен уровень
449
+ // «редактирование контента проекта» (`canEditProjectContent`: owner /
450
+ // EDITOR / LEAD / ADMIN) — тот же, что у импорта проекта целиком
451
+ // (`core/server/routes/project-portable.ts`, `deps.canEdit`). Участник с
452
+ // ролью VIEWER получает 403.
453
+ if (!canEditProjectContent(ctx, existingProject, userId)) {
454
+ return { ok: false, status: 403, code: 'FORBIDDEN', message: forbiddenMessage };
455
+ }
456
+ }
457
+ const sourceSessionId = readImportSourceId(body);
458
+ // Дедуп: та же исходная сессия уже перенесена — обновляем её, а не создаём
459
+ // дубль. Область поиска: целевой проект; без проекта — только **свои**
460
+ // сессии (иначе подставленный чужой маркер обновил бы чужую запись).
461
+ // `includeArchived` — ранее импортированная и заархивированная сессия не
462
+ // должна дублироваться при повторной публикации.
463
+ if (sourceSessionId) {
464
+ const candidates = await sessionManager.listSessions(targetProjectId ? { projectId: targetProjectId } : { userId }, { includeArchived: true });
465
+ // Страховка поверх фильтра: обновляем только свою сессию. Если проектный
466
+ // обзор/видимость вернули чужую запись с тем же маркером — не трогаем её,
467
+ // создаём новую.
468
+ const match = candidates.find((s) => s.sourceSessionId === sourceSessionId && (s.ownerId ?? s.userId) === userId);
469
+ if (match) {
470
+ const existingSession = await sessionManager.getSession(match.id);
471
+ if (existingSession && (existingSession.ownerId ?? existingSession.userId) === userId) {
472
+ applyImportBody(existingSession, body, sourceSessionId, true);
473
+ await sessionManager.saveSession(existingSession);
474
+ // Инвариант 27: обновление видно другим клиентам.
475
+ eventBus.publish(existingSession.id, 'session.updated', serializeSession(existingSession, { agentRegistry }));
476
+ return { ok: true, session: existingSession, updated: true };
477
+ }
478
+ }
479
+ }
480
+ // ADR-089: materialization (перенос истории), не request — прямой createSession.
481
+ const session = await sessionManager.createSession({
482
+ title: typeof body.title === 'string' ? body.title : undefined,
483
+ projectId: targetProjectId,
484
+ sessionOrigin: (body.session_origin ?? body.sessionOrigin),
485
+ settings: (body.settings ?? {}),
486
+ userId,
487
+ ownerId: userId,
488
+ });
489
+ applyImportBody(session, body, sourceSessionId, false);
396
490
  await sessionManager.saveSession(session);
397
491
  // Автоматически подписываем активных клиентов на новую сессию
398
- eventHub.subscribeToSession(user.id, session.id).catch((e) => console.warn('subscribeToSession failed:', e));
492
+ eventHub.subscribeToSession(userId, session.id).catch((e) => console.warn('subscribeToSession failed:', e));
399
493
  eventBus.publish(session.id, 'session.created', serializeSession(session, { agentRegistry }));
400
- return c.json(serializeSession(session, { agentRegistry }), 201);
494
+ return { ok: true, session, updated: false };
495
+ };
496
+ // POST /api/v2/sessions/import — создать сессию из экспорта другой сессии
497
+ // (перенос истории между мирами). Тело: объект экспорта + import.project_id
498
+ // (целевой проект; если не задан — берётся из экспорта) + опциональный
499
+ // import.source_session_id — маркер источника (ключ дедупликации повторного
500
+ // импорта: та же сессия в том же проекте обновляется, а не дублируется).
501
+ // LLM не запускается.
502
+ // ADR-089: это materialization-операция (создание-как-факт переноса истории),
503
+ // а не request — идёт прямым `createSession`, минуя funnel `session.requested`.
504
+ app.post('/import', kit.requireAuth, importRateLimit, async (c) => {
505
+ const user = (await kit.getCurrentUser(c));
506
+ const body = (await c.req.json().catch(() => ({})));
507
+ const outcome = await importSessionFromBody(body, user.id, t('auth.forbidden', undefined, c), c);
508
+ if (!outcome.ok) {
509
+ return c.json({ error: { code: outcome.code, message: outcome.message } }, outcome.status);
510
+ }
511
+ // `updated` — аддитивное поле поверх DTO: true — обновлена существующая
512
+ // запись (dedup по маркеру), false — создана новая.
513
+ return c.json({ ...serializeSession(outcome.session, { agentRegistry }), updated: outcome.updated }, outcome.updated ? 200 : 201);
514
+ });
515
+ // POST /api/v2/sessions/import-batch — пакетный импорт сессий одним запросом.
516
+ // Тело: `{ sessions: Array<тело экспорта + import { project_id, source_session_id }> }`
517
+ // (1..MAX_IMPORT_BATCH). Элементы обрабатываются **последовательно** тем же
518
+ // кодом, что одиночный импорт (дедуп/дефолты не разъезжаются). Ошибка на
519
+ // элементе прерывает пакет; частичные записи безопасны — повтор идемпотентен
520
+ // благодаря дедупу по `source_session_id`.
521
+ app.post('/import-batch', kit.requireAuth, importRateLimit, async (c) => {
522
+ const user = (await kit.getCurrentUser(c));
523
+ const body = (await c.req.json().catch(() => ({})));
524
+ const rawSessions = body.sessions;
525
+ if (!Array.isArray(rawSessions) || rawSessions.length < 1 || rawSessions.length > MAX_IMPORT_BATCH) {
526
+ return c.json({
527
+ error: {
528
+ code: 'VALIDATION_ERROR',
529
+ message: `sessions: ожидается массив из 1..${MAX_IMPORT_BATCH} элементов`,
530
+ },
531
+ }, 400);
532
+ }
533
+ const results = [];
534
+ let imported = 0;
535
+ let updated = 0;
536
+ for (const item of rawSessions) {
537
+ if (!item || typeof item !== 'object' || Array.isArray(item)) {
538
+ return c.json({
539
+ error: {
540
+ code: 'VALIDATION_ERROR',
541
+ message: 'sessions: элемент должен быть объектом экспорта сессии',
542
+ },
543
+ details: { imported, updated, source_session_id: null },
544
+ }, 400);
545
+ }
546
+ const itemBody = item;
547
+ const sourceSessionId = readImportSourceId(itemBody);
548
+ let outcome;
549
+ try {
550
+ outcome = await importSessionFromBody(itemBody, user.id, t('auth.forbidden', undefined, c), c);
551
+ }
552
+ catch (err) {
553
+ return c.json({
554
+ error: {
555
+ code: 'INTERNAL_ERROR',
556
+ message: err instanceof Error ? err.message : 'Импорт сессии не удался',
557
+ },
558
+ details: { imported, updated, source_session_id: sourceSessionId ?? null },
559
+ }, 500);
560
+ }
561
+ if (!outcome.ok) {
562
+ return c.json({
563
+ error: { code: outcome.code, message: outcome.message },
564
+ details: { imported, updated, source_session_id: sourceSessionId ?? null },
565
+ }, outcome.status);
566
+ }
567
+ results.push({
568
+ source_session_id: sourceSessionId ?? null,
569
+ id: outcome.session.id,
570
+ updated: outcome.updated,
571
+ });
572
+ if (outcome.updated)
573
+ updated += 1;
574
+ else
575
+ imported += 1;
576
+ }
577
+ return c.json({ sessions: results, imported, updated }, 200);
401
578
  });
402
579
  // POST /api/v2/sessions/:id/debug-system-message — отправить отладочное системное сообщение
403
580
  // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
@@ -431,119 +608,16 @@ llmAvailability) {
431
608
  }
432
609
  return c.json({ status: 'enqueued', stream_id: streamId });
433
610
  });
434
- // GET /api/v2/sessions/:id/optimization — настройки оптимизации
435
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
436
- app.get('/:id/optimization', kit.requireAuth, async (c) => {
437
- const session = await sessionManager.getSession(c.req.param('id'));
438
- if (!session) {
439
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
440
- }
441
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
442
- return c.json({
443
- context_optimization: session.settings.contextOptimization,
444
- sliding_window_mode: session.settings.slidingWindowMode,
445
- sliding_window_message_limit: session.settings.slidingWindowMessageLimit,
446
- sliding_window_token_threshold: session.settings.slidingWindowTokenThreshold,
447
- summarization_enabled: session.settings.summarizationEnabled,
448
- summarization_trigger_mode: session.settings.summarizationTriggerMode,
449
- summarize_after_n: session.settings.summarizeAfterN,
450
- summarize_token_threshold: session.settings.summarizeTokenThreshold,
451
- summarization_head_messages: session.settings.summarizationHeadMessages,
452
- summarization_tail_messages: session.settings.summarizationTailMessages,
453
- summarization_keep_tokens: session.settings.summarizationKeepTokens,
454
- compaction_keep_tokens: session.settings.compactionKeepTokens,
455
- compaction_token_threshold: session.settings.compactionTokenThreshold,
456
- });
457
- });
458
- // PATCH /api/v2/sessions/:id/optimization — обновить настройки
459
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
460
- app.patch('/:id/optimization', kit.requireAuth, async (c) => {
461
- const session = await sessionManager.getSession(c.req.param('id'));
462
- if (!session) {
463
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
464
- }
465
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
466
- const body = await c.req.json().catch(() => ({}));
467
- await sessionManager.withLock(c.req.param('id'), async (s) => {
468
- if (body.context_optimization !== undefined)
469
- s.settings.contextOptimization = body.context_optimization;
470
- if (body.sliding_window_mode !== undefined)
471
- s.settings.slidingWindowMode = body.sliding_window_mode;
472
- if (body.sliding_window_message_limit !== undefined)
473
- s.settings.slidingWindowMessageLimit = body.sliding_window_message_limit;
474
- if (body.sliding_window_token_threshold !== undefined)
475
- s.settings.slidingWindowTokenThreshold = body.sliding_window_token_threshold;
476
- if (body.summarization_enabled !== undefined)
477
- s.settings.summarizationEnabled = body.summarization_enabled;
478
- if (body.summarization_trigger_mode !== undefined)
479
- s.settings.summarizationTriggerMode = body.summarization_trigger_mode;
480
- if (body.summarize_after_n !== undefined)
481
- s.settings.summarizeAfterN = body.summarize_after_n;
482
- if (body.summarize_token_threshold !== undefined)
483
- s.settings.summarizeTokenThreshold = body.summarize_token_threshold;
484
- if (body.summarization_head_messages !== undefined)
485
- s.settings.summarizationHeadMessages = body.summarization_head_messages;
486
- if (body.summarization_tail_messages !== undefined)
487
- s.settings.summarizationTailMessages = body.summarization_tail_messages;
488
- if (body.summarization_keep_tokens !== undefined)
489
- s.settings.summarizationKeepTokens = body.summarization_keep_tokens;
490
- if (body.compaction_keep_tokens !== undefined)
491
- s.settings.compactionKeepTokens = body.compaction_keep_tokens;
492
- if (body.compaction_token_threshold !== undefined)
493
- s.settings.compactionTokenThreshold = body.compaction_token_threshold;
494
- await sessionManager.saveSession(s);
495
- });
496
- const updated = await sessionManager.getSession(c.req.param('id'));
497
- return c.json(serializeSession(updated, { agentRegistry }));
498
- });
499
- // POST /api/v2/sessions/:id/optimization/check — проверить триггеры
500
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
501
- app.post('/:id/optimization/check', kit.requireAuth, async (c) => {
502
- const session = await sessionManager.getSession(c.req.param('id'));
503
- if (!session) {
504
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
505
- }
506
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
507
- if (!contextOptimizer) {
508
- return c.json({ sliding_window: { triggered: false }, summarization: { triggered: false }, compression: { triggered: false, reason: 'none', mode: null } });
509
- }
510
- const swResult = contextOptimizer.shouldApplySlidingWindow(session);
511
- const sumResult = contextOptimizer.shouldSummarize(session);
512
- const compression = typeof contextOptimizer.shouldCompress === 'function'
513
- ? contextOptimizer.shouldCompress(session)
514
- : { ...contextOptimizer.shouldSummarize(session), mode: 'summarization' };
515
- return c.json({
516
- sliding_window: swResult,
517
- summarization: sumResult,
518
- compression,
519
- summarization_pending: session.summarizationPending,
520
- });
521
- });
522
- // POST /api/v2/sessions/:id/optimization/cancel-summarization — отменить ожидающую суммаризацию
523
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
524
- app.post('/:id/optimization/cancel-summarization', kit.requireAuth, async (c) => {
525
- const session = await sessionManager.getSession(c.req.param('id'));
526
- if (!session) {
527
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
528
- }
529
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
530
- await sessionManager.withLock(session.id, async (s) => {
531
- s.summarizationPending = false;
532
- await sessionManager.saveSession(s);
533
- });
534
- if (contextOptimizer) {
535
- const updated = await sessionManager.getSession(session.id);
536
- const can = contextOptimizer.canSummarize(updated);
537
- eventBus.publish(session.id, 'session.updated', {
538
- session_id: session.id,
539
- can_summarize: can,
540
- summarization_pending: false,
541
- });
542
- }
543
- return c.json({ success: true });
544
- });
611
+ // GET /api/v2/sessions/:id/optimization — настройки оптимизации контекста
612
+ // (ADR-119). Реализация — в core-фабрике (нужна standalone/гибриду): backend
613
+ // монтирует её ниже, единый prefix-guard покрывает доступ (инвариант 16).
545
614
  // Общая логика — в core-фабрике (backend-специфика выше). Регистрируем её
546
615
  // последней: статические/backend-only сегменты должны матчиться раньше.
616
+ // Оптимизация контекста (ADR-119), MCP-скоуп сессии и карта обфускации живут
617
+ // в core-фабрике — они нужны standalone/гибриду (`remote:`-сессии
618
+ // форвардятся на backend). Свои `/:id/mcp` и `/:id/secrets` зарегистрированы
619
+ // ВЫШЕ и сохраняют более строгую политику managed (владелец|ADMIN и
620
+ // ADMIN|AUDITOR соответственно) — порядок регистрации оставляет её в силе.
547
621
  app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService, analytics, ...(memory ? { memory } : {}), ...(questionService ? { questionService } : {}), ...(worktreeService ? { worktreeService } : {}), ...(attachments ? { attachments } : {}), ...(backgroundService ? { backgroundService } : {}), ...(approvalRegistry ? { approvalRegistry } : {}), ...(llmAvailability ? { llmAvailability } : {}) }, {
548
622
  resolveUserId: async (c) => (await kit.getCurrentUser(c)).id,
549
623
  resolveOwner: async (c) => (await kit.getCurrentUser(c)).id,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@itphx/synth-backend",
3
- "version": "0.13.4",
3
+ "version": "0.13.8",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "files": [
@@ -8,8 +8,8 @@
8
8
  ],
9
9
  "dependencies": {
10
10
  "@hono/node-server": "^2.1.3",
11
- "@itphx/synth-core": "0.13.4",
12
- "@itphx/synth-shared": "0.13.4",
11
+ "@itphx/synth-core": "0.13.8",
12
+ "@itphx/synth-shared": "0.13.8",
13
13
  "hono": "^4.9.0",
14
14
  "hono-rate-limiter": "^0.5.3",
15
15
  "jose": "^6.2.3",
@@ -29,7 +29,7 @@
29
29
  "start": "node dist/main.js",
30
30
  "build": "rm -rf dist && tsc -p tsconfig.build.json",
31
31
  "typecheck": "tsc --noEmit",
32
- "lint": "eslint src/",
32
+ "lint": "eslint src/ --max-warnings 178",
33
33
  "test": "vitest run",
34
34
  "test:watch": "vitest",
35
35
  "clean": "rm -rf dist"
@@ -1,17 +0,0 @@
1
- import { Hono } from 'hono';
2
- import type { AuthKit } from '../auth/middleware.js';
3
- import { AuditLogger } from '@itphx/synth-core';
4
- export interface AuditRoutesDeps {
5
- /** Путь к append-only JSONL файлу аудита LLM Gateway. */
6
- auditLogPath: string;
7
- /** Проверка существования сессии (для POST /api/v2/audit/revealed). */
8
- sessionExists: (sessionId: string) => Promise<boolean>;
9
- /** Логгер записи событий аудита (тот же JSONL-файл, что читает GET /api/v2/audit). */
10
- logger: AuditLogger;
11
- }
12
- /**
13
- * GET /api/v2/audit — просмотр аудита LLM Gateway (ADR-036).
14
- * RBAC: только ADMIN/AUDITOR.
15
- * Фильтры: userId, sessionId, since/until (ISO), limit (дефолт 100, макс 500).
16
- */
17
- export declare function createAuditRoutes(kit: AuthKit, deps: AuditRoutesDeps): Hono;