@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
@@ -5,20 +5,31 @@ 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
- * оптимизация контекста, sticky notes). Общая логика (список/создание/чтение/
12
- * изменение/удаление, status/prompt/stats, очередь+SSE, children/tree/fork,
13
- * references, merge) — в `createSessionRoutes` из `@itphx/synth-core`.
17
+ * backend-специфичные роуты (MCP-скоуп сессии и секреты — более строгая политика
18
+ * managed, export/import, отладка). Общая логика (список/создание/чтение/изменение/
19
+ * удаление, status/prompt/stats, заметки (`notes`), очередь+SSE, children/tree/
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-ветки отключены
17
- * (getRemoteClient не передаётся). `GET /:id/events` на backend не регистрируется.
25
+ * (getRemoteClient не передаётся). Сессионного SSE нет: наблюдение за ходом —
26
+ * единственный глобальный канал `GET /api/v2/events` (ADR-118).
18
27
  *
19
28
  * Исключения из общего prefix-guard'а (собственные правила, роуты зарегистрированы
20
29
  * до guard'а): `/:id/mcp` (владелец|ADMIN, ADR-071 §2.4) и `/:id/secrets`
21
- * (ADMIN|AUDITOR — карта обфускации). `/:id/export` — ПОД guard'ом: доступ к
30
+ * (ADMIN|AUDITOR — карта обфускации). В core-фабрике есть версии этих маршрутов
31
+ * для standalone/гибрида; здесь они регистрируются раньше и потому выигрывают,
32
+ * сохраняя прежнюю политику. `/:id/export` — ПОД guard'ом: доступ к
22
33
  * сессии решает ЕДИНЫЙ prefix-guard, а привилегию карты обфускации — отдельный
23
34
  * route-level guard (`createSessionExportGuard`, ADR-036); в обработчике проверок
24
35
  * доступа нет (инвариант 16).
@@ -44,7 +55,7 @@ memory,
44
55
  */
45
56
  questionService,
46
57
  /**
47
- * ADR-114: сервис worktree'ов — привязка сессии к worktree
58
+ * ADR-114: сервис worktree — привязка сессии к worktree
48
59
  * (`PATCH /api/v2/sessions/:id { worktreeId }`).
49
60
  *
50
61
  * Не задан — поле `worktreeId` в PATCH игнорируется (привязка недоступна).
@@ -54,23 +65,53 @@ worktreeService,
54
65
  * ADR-115: вложения сообщений — blob-порт, учёт ссылок и лимиты
55
66
  * (прокидывается в core-фабрику: загрузка/раздача + `attachments` в промпте).
56
67
  */
57
- attachments) {
68
+ attachments,
69
+ /**
70
+ * ADR-111/ADR-113: единый реестр фоновых прогонов — «Стоп» сессии
71
+ * останавливает и живые дочерние прогоны (фоновые саб-агенты и их процессы),
72
+ * решение 2026-10-28. Не задан — прежнее поведение (только свой стрим/очередь).
73
+ */
74
+ backgroundService,
75
+ /**
76
+ * ADR-106 Ф3: реестр подтверждений — HTTP-ответ на подтверждение
77
+ * (`POST /:id/permissions/:approvalId`) принимает решение через него, как и
78
+ * WS-кадр `permission_reply`. Не задан — слой Authority выключен/в shadow.
79
+ */
80
+ approvalRegistry,
81
+ /**
82
+ * Instance-wide лимиты заметок сессии (`context.stickyNotes`, live-резолвер)
83
+ * — прокидывается в core-фабрику: роуты заметок живут там (единая реализация).
84
+ */
85
+ getStickyNoteLimits,
86
+ /**
87
+ * Доступность пары провайдер/модель **до постановки в очередь** (каталог
88
+ * инстанса). Не задана — проверка выключена.
89
+ */
90
+ llmAvailability,
91
+ /**
92
+ * Лимит тяжёлых операций ресурса сессий (`limits.sessionOpsPerMinute`,
93
+ * import/export/fork/merge) — live-геттер. Не задан — 10 (прежнее поведение).
94
+ * `0` — без ограничения; значение применяется без рестарта.
95
+ */
96
+ getSessionOpsPerMinute) {
58
97
  const app = new Hono();
59
98
  const agentRegistry = orchestrator.agentRegistry;
60
99
  const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
61
100
  // ADR-071 §2.4: владелец сессии — обычный пользователь, управляющий её MCP-скоупом.
62
101
  const isSessionOwner = (session, userId) => (session.ownerId ?? session.userId) === userId;
63
102
  /**
64
- * Rate limit на тяжёлые/неинтерактивные операции ресурса сессий (import/export/
65
- * fork/merge): 10 запросов / 60 с на креду — тот же in-memory `createRateLimiter`,
66
- * что у `POST /:id/prompt` (30/60) и `schedules/:id/run` (10/60). Значение ниже
67
- * prompt: операции не частые в живом UI, но дорогие (полный объект сессии,
68
- * создание форка, копирование сообщений) — защита от всплесков/выкачивания.
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-изменение из админки применяется без рестарта.
69
109
  */
70
- const importRateLimit = createRateLimiter(10, 60_000);
71
- const exportRateLimit = createRateLimiter(10, 60_000);
72
- const forkRateLimit = createRateLimiter(10, 60_000);
73
- 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);
74
115
  /**
75
116
  * Единое правило доступа к сессии (читать/писать) — ОДНА точка на весь ресурс
76
117
  * `/api/v2/sessions`, включая backend-only маршруты (export/debug/optimization/
@@ -133,8 +174,8 @@ attachments) {
133
174
  sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
134
175
  forbidden: (c) => t('auth.forbidden', undefined, c),
135
176
  },
136
- // `/import` — статический сегмент (не id сессии).
137
- skipForId: (id) => id === 'import',
177
+ // `/import` и `/import-batch` — статические сегменты (не id сессии).
178
+ skipForId: (id) => id === 'import' || id === 'import-batch',
138
179
  });
139
180
  /**
140
181
  * Привилегия карты обфускации при экспорте сессии (ADR-036, security-фикс
@@ -241,9 +282,10 @@ attachments) {
241
282
  });
242
283
  // Единый prefix-guard ресурса сессий: вешается ПОСЛЕ `/:id/mcp` и `/:id/secrets`
243
284
  // (у них собственные задокументированные правила) и покрывает отладку,
244
- // оптимизацию, заметки, ЭКСПОРТ и все core-маршруты (core-фабрика
245
- // регистрируется с registerAccessGuard:false — иначе был бы второй источник
246
- // правил). `/import` пропускается через guard.skipForId (статический сегмент,
285
+ // оптимизацию (реализация — в core-фабрике, регистрируется ниже), заметки,
286
+ // ЭКСПОРТ и все core-маршруты (core-фабрика регистрируется с
287
+ // registerAccessGuard:false — иначе был бы второй источник правил).
288
+ // `/import` пропускается через guard.skipForId (статический сегмент,
247
289
  // не сессия).
248
290
  app.use('/:id', kit.requireAuth, sessionAccessGuard);
249
291
  app.use('/:id/*', kit.requireAuth, sessionAccessGuard);
@@ -285,53 +327,52 @@ attachments) {
285
327
  }
286
328
  return c.json(decision.withSecrets ? decision.session : stripSessionSecrets(decision.session));
287
329
  });
288
- // POST /api/v2/sessions/import — создать сессию из экспорта другой сессии
289
- // (перенос истории между мирами). Тело: объект экспорта + import.project_id
290
- // (целевой проект; если не задан — берётся из экспорта). LLM не запускается.
291
- // ADR-089: это materialization-операция (создание-как-факт переноса истории),
292
- // а не request — идёт прямым `createSession`, минуя funnel `session.requested`.
293
- app.post('/import', kit.requireAuth, importRateLimit, async (c) => {
294
- const user = (await kit.getCurrentUser(c));
295
- const body = await c.req.json().catch(() => ({}));
296
- const targetProjectId = body.import?.project_id
297
- ?? body.import?.projectId
298
- ?? body.project_id
299
- ?? body.projectId
300
- ?? undefined;
301
- if (targetProjectId) {
302
- if (!projectStore) {
303
- return c.json({ error: { code: 'INTERNAL_ERROR', message: 'Хранилище проектов недоступно' } }, 500);
304
- }
305
- const existing = await projectStore.load(targetProjectId);
306
- if (!existing) {
307
- return c.json({ error: { code: 'PROJECT_NOT_FOUND', message: 'Проект не найден' } }, 400);
308
- }
309
- // Безопасность: импорт привязывает сессию к проекту и выдаёт агенту его
310
- // workspace — без проверки доступа к проекту получается IDOR (чтение/запись
311
- // файлов чужого проекта).
312
- //
313
- // Импорт сессии В ПРОЕКТ — это ЗАПИСЬ в проект (инвариант 21: read-уровень
314
- // доступа не расширяет права на изменение), поэтому нужен уровень
315
- // «редактирование контента проекта» (`canEditProjectContent`: owner /
316
- // EDITOR / LEAD / ADMIN) — тот же, что у импорта проекта целиком
317
- // (`core/server/routes/project-portable.ts`, `deps.canEdit`). Участник с
318
- // ролью VIEWER получает 403.
319
- if (!canEditProjectContent(c, existing, user.id)) {
320
- 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;
321
365
  }
322
366
  }
323
- // ADR-089: materialization (перенос истории), не request — прямой createSession.
324
- const session = await sessionManager.createSession({
325
- title: typeof body.title === 'string' ? body.title : undefined,
326
- projectId: targetProjectId,
327
- sessionOrigin: (body.session_origin ?? body.sessionOrigin),
328
- settings: (body.settings ?? {}),
329
- userId: user.id,
330
- ownerId: user.id,
331
- });
332
- // Переносим историю и состояние из экспорта.
333
- // parentId: publish переписывает ссылки на новые remote-id до импорта — сохраняем.
334
- 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;
335
376
  const messages = Array.isArray(body.messages) ? body.messages : [];
336
377
  session.messages = messages.map((m) => ({ ...structuredClone(m), seq: 0 }));
337
378
  session.messages.forEach((m, i) => { m.seq = i + 1; });
@@ -344,21 +385,26 @@ attachments) {
344
385
  session.references = Array.isArray(body.references) ? body.references : [];
345
386
  session.checkpoints = Array.isArray(body.checkpoints) ? body.checkpoints : [];
346
387
  session.mode = (body.mode ?? undefined);
347
- session.planApproved = body.plan_approved ?? body.planApproved ?? false;
348
- session.branchPoint = body.branch_point ?? body.branchPoint;
388
+ session.planApproved = (body.plan_approved ?? body.planApproved ?? false);
389
+ session.branchPoint = (body.branch_point ?? body.branchPoint);
349
390
  // Метаданные сессии (иконка/цвет) — нормализуем legacy при импорте.
350
391
  session.icon = normalizeIconKey(body.icon);
351
392
  session.color = normalizeColorKey(body.color);
352
393
  session.obfuscationMap = (body.obfuscation_map ?? body.obfuscationMap);
353
- session.createdAt = typeof (body.created_at ?? body.createdAt) === 'string'
354
- ? (body.created_at ?? body.createdAt)
355
- : 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
+ }
356
401
  session.updatedAt = nowISO();
357
402
  // Сбрасываем runtime-состояние: блокировки/стримы с другого хоста не переносим.
358
403
  session.status = {};
359
404
  session.currentStream = undefined;
360
405
  session.summarizationPending = false;
361
406
  session.canSummarize = false;
407
+ session.retry = undefined;
362
408
  const num = (v, def = 0) => (typeof v === 'number' ? v : def);
363
409
  session.inputTokens = num(body.input_tokens ?? body.inputTokens);
364
410
  session.outputTokens = num(body.output_tokens ?? body.outputTokens);
@@ -370,11 +416,165 @@ attachments) {
370
416
  session.outputCost = num(body.output_cost ?? body.outputCost);
371
417
  session.cacheReadCost = num(body.cache_read_cost ?? body.cacheReadCost);
372
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);
373
490
  await sessionManager.saveSession(session);
374
491
  // Автоматически подписываем активных клиентов на новую сессию
375
- 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));
376
493
  eventBus.publish(session.id, 'session.created', serializeSession(session, { agentRegistry }));
377
- 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);
378
578
  });
379
579
  // POST /api/v2/sessions/:id/debug-system-message — отправить отладочное системное сообщение
380
580
  // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
@@ -408,188 +608,17 @@ attachments) {
408
608
  }
409
609
  return c.json({ status: 'enqueued', stream_id: streamId });
410
610
  });
411
- // GET /api/v2/sessions/:id/optimization — настройки оптимизации
412
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
413
- app.get('/:id/optimization', kit.requireAuth, async (c) => {
414
- const session = await sessionManager.getSession(c.req.param('id'));
415
- if (!session) {
416
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
417
- }
418
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
419
- return c.json({
420
- context_optimization: session.settings.contextOptimization,
421
- sliding_window_mode: session.settings.slidingWindowMode,
422
- sliding_window_message_limit: session.settings.slidingWindowMessageLimit,
423
- sliding_window_token_threshold: session.settings.slidingWindowTokenThreshold,
424
- summarization_enabled: session.settings.summarizationEnabled,
425
- summarization_trigger_mode: session.settings.summarizationTriggerMode,
426
- summarize_after_n: session.settings.summarizeAfterN,
427
- summarize_token_threshold: session.settings.summarizeTokenThreshold,
428
- summarization_head_messages: session.settings.summarizationHeadMessages,
429
- summarization_tail_messages: session.settings.summarizationTailMessages,
430
- });
431
- });
432
- // PATCH /api/v2/sessions/:id/optimization — обновить настройки
433
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
434
- app.patch('/:id/optimization', kit.requireAuth, async (c) => {
435
- const session = await sessionManager.getSession(c.req.param('id'));
436
- if (!session) {
437
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
438
- }
439
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
440
- const body = await c.req.json().catch(() => ({}));
441
- await sessionManager.withLock(c.req.param('id'), async (s) => {
442
- if (body.context_optimization !== undefined)
443
- s.settings.contextOptimization = body.context_optimization;
444
- if (body.sliding_window_mode !== undefined)
445
- s.settings.slidingWindowMode = body.sliding_window_mode;
446
- if (body.sliding_window_message_limit !== undefined)
447
- s.settings.slidingWindowMessageLimit = body.sliding_window_message_limit;
448
- if (body.sliding_window_token_threshold !== undefined)
449
- s.settings.slidingWindowTokenThreshold = body.sliding_window_token_threshold;
450
- if (body.summarization_enabled !== undefined)
451
- s.settings.summarizationEnabled = body.summarization_enabled;
452
- if (body.summarization_trigger_mode !== undefined)
453
- s.settings.summarizationTriggerMode = body.summarization_trigger_mode;
454
- if (body.summarize_after_n !== undefined)
455
- s.settings.summarizeAfterN = body.summarize_after_n;
456
- if (body.summarize_token_threshold !== undefined)
457
- s.settings.summarizeTokenThreshold = body.summarize_token_threshold;
458
- if (body.summarization_head_messages !== undefined)
459
- s.settings.summarizationHeadMessages = body.summarization_head_messages;
460
- if (body.summarization_tail_messages !== undefined)
461
- s.settings.summarizationTailMessages = body.summarization_tail_messages;
462
- await sessionManager.saveSession(s);
463
- });
464
- const updated = await sessionManager.getSession(c.req.param('id'));
465
- return c.json(serializeSession(updated, { agentRegistry }));
466
- });
467
- // POST /api/v2/sessions/:id/optimization/check — проверить триггеры
468
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
469
- app.post('/:id/optimization/check', kit.requireAuth, async (c) => {
470
- const session = await sessionManager.getSession(c.req.param('id'));
471
- if (!session) {
472
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
473
- }
474
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
475
- if (!contextOptimizer) {
476
- return c.json({ sliding_window: { triggered: false }, summarization: { triggered: false } });
477
- }
478
- const swResult = contextOptimizer.shouldApplySlidingWindow(session);
479
- const sumResult = contextOptimizer.shouldSummarize(session);
480
- return c.json({
481
- sliding_window: swResult,
482
- summarization: sumResult,
483
- summarization_pending: session.summarizationPending,
484
- });
485
- });
486
- // POST /api/v2/sessions/:id/optimization/cancel-summarization — отменить ожидающую суммаризацию
487
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
488
- app.post('/:id/optimization/cancel-summarization', kit.requireAuth, async (c) => {
489
- const session = await sessionManager.getSession(c.req.param('id'));
490
- if (!session) {
491
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
492
- }
493
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
494
- await sessionManager.withLock(session.id, async (s) => {
495
- s.summarizationPending = false;
496
- await sessionManager.saveSession(s);
497
- });
498
- if (contextOptimizer) {
499
- const updated = await sessionManager.getSession(session.id);
500
- const can = contextOptimizer.canSummarize(updated);
501
- eventBus.publish(session.id, 'session.updated', {
502
- session_id: session.id,
503
- can_summarize: can,
504
- summarization_pending: false,
505
- });
506
- }
507
- return c.json({ success: true });
508
- });
509
- // ===== Sticky Notes =====
510
- // GET /api/v2/sessions/:id/notes — список заметок
511
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
512
- app.get('/:id/notes', kit.requireAuth, async (c) => {
513
- const session = await sessionManager.getSession(c.req.param('id'));
514
- if (!session) {
515
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
516
- }
517
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
518
- return c.json({ notes: session.stickyNotes });
519
- });
520
- // POST /api/v2/sessions/:id/notes — создать заметку
521
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
522
- app.post('/:id/notes', kit.requireAuth, async (c) => {
523
- const session = await sessionManager.getSession(c.req.param('id'));
524
- if (!session) {
525
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
526
- }
527
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
528
- const body = await c.req.json().catch(() => ({}));
529
- if (!body.content?.trim()) {
530
- return c.json({ error: { code: 'VALIDATION_ERROR', message: 'Content is required' } }, 400);
531
- }
532
- const now = nowISO();
533
- const note = {
534
- id: generateStreamId(),
535
- content: body.content.trim(),
536
- createdAt: now,
537
- updatedAt: now,
538
- disabled: false,
539
- };
540
- await sessionManager.withLock(c.req.param('id'), async (s) => {
541
- s.stickyNotes.push(note);
542
- await sessionManager.saveSession(s);
543
- });
544
- const updated = await sessionManager.getSession(c.req.param('id'));
545
- eventBus.publish(c.req.param('id'), 'context.sticky_note_added', { note_id: note.id });
546
- return c.json({ note, notes: updated.stickyNotes }, 201);
547
- });
548
- // PATCH /api/v2/sessions/:id/notes/:noteId — обновить заметку
549
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
550
- app.patch('/:id/notes/:noteId', kit.requireAuth, async (c) => {
551
- const session = await sessionManager.getSession(c.req.param('id'));
552
- if (!session) {
553
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
554
- }
555
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
556
- const body = await c.req.json().catch(() => ({}));
557
- const noteId = c.req.param('noteId');
558
- await sessionManager.withLock(c.req.param('id'), async (s) => {
559
- const note = s.stickyNotes.find((n) => n.id === noteId);
560
- if (!note)
561
- throw new Error('Note not found');
562
- if (body.content !== undefined)
563
- note.content = body.content;
564
- if (body.disabled !== undefined)
565
- note.disabled = body.disabled;
566
- note.updatedAt = nowISO();
567
- await sessionManager.saveSession(s);
568
- });
569
- const updated = await sessionManager.getSession(c.req.param('id'));
570
- eventBus.publish(c.req.param('id'), 'context.sticky_note_updated', { note_id: noteId });
571
- return c.json({ notes: updated.stickyNotes });
572
- });
573
- // DELETE /api/v2/sessions/:id/notes/:noteId — удалить заметку
574
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
575
- app.delete('/:id/notes/:noteId', kit.requireAuth, async (c) => {
576
- const session = await sessionManager.getSession(c.req.param('id'));
577
- if (!session) {
578
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
579
- }
580
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
581
- const noteId = c.req.param('noteId');
582
- await sessionManager.withLock(c.req.param('id'), async (s) => {
583
- s.stickyNotes = s.stickyNotes.filter((n) => n.id !== noteId);
584
- await sessionManager.saveSession(s);
585
- });
586
- const updated = await sessionManager.getSession(c.req.param('id'));
587
- eventBus.publish(c.req.param('id'), 'context.sticky_note_deleted', { note_id: noteId });
588
- return c.json({ notes: updated.stickyNotes });
589
- });
611
+ // GET /api/v2/sessions/:id/optimization — настройки оптимизации контекста
612
+ // (ADR-119). Реализация — в core-фабрике (нужна standalone/гибриду): backend
613
+ // монтирует её ниже, единый prefix-guard покрывает доступ (инвариант 16).
590
614
  // Общая логика — в core-фабрике (backend-специфика выше). Регистрируем её
591
615
  // последней: статические/backend-only сегменты должны матчиться раньше.
592
- app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService, analytics, ...(memory ? { memory } : {}), ...(questionService ? { questionService } : {}), ...(worktreeService ? { worktreeService } : {}), ...(attachments ? { attachments } : {}) }, {
616
+ // Оптимизация контекста (ADR-119), MCP-скоуп сессии и карта обфускации живут
617
+ // в core-фабрике — они нужны standalone/гибриду (`remote:`-сессии
618
+ // форвардятся на backend). Свои `/:id/mcp` и `/:id/secrets` зарегистрированы
619
+ // ВЫШЕ и сохраняют более строгую политику managed (владелец|ADMIN и
620
+ // ADMIN|AUDITOR соответственно) — порядок регистрации оставляет её в силе.
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 } : {}) }, {
593
622
  resolveUserId: async (c) => (await kit.getCurrentUser(c)).id,
594
623
  resolveOwner: async (c) => (await kit.getCurrentUser(c)).id,
595
624
  forkWithOwner: true,
@@ -613,16 +642,23 @@ attachments) {
613
642
  return projects.map((p) => p.id);
614
643
  },
615
644
  resolveAuthor: async (c) => (await kit.getCurrentUser(c)).username,
616
- promptMessageId: 'stream',
645
+ // ADR-106 Ф3: принципал ответа на подтверждение — аутентифицированный
646
+ // пользователь запроса (клиенту не доверяем) и его роли инстанса.
647
+ resolvePermissionResponder: async (c) => {
648
+ const user = await kit.getCurrentUser(c);
649
+ return { kind: 'user', id: user?.id ?? '', roles: user?.roles ?? [] };
650
+ },
617
651
  publishRenamed: false,
618
652
  publishDeletedBefore: false,
653
+ // Instance-wide лимиты заметок сессии (`context.stickyNotes`): роуты
654
+ // заметок — в core-фабрике, лимиты читаются резолвером (live).
655
+ ...(getStickyNoteLimits ? { getStickyNoteLimits } : {}),
619
656
  onSessionCreated: (userId, sessionId) => { void eventHub.subscribeToSession(userId, sessionId).catch((e) => console.warn('subscribeToSession failed:', e)); },
620
657
  onSessionDeleted: (userId, sessionId) => { eventHub.unsubscribeFromSession(userId, sessionId); },
621
658
  onSessionForked: (userId, sessionId) => { void eventHub.subscribeToSession(userId, sessionId).catch((e) => console.warn('subscribeToSession failed:', e)); },
622
659
  promptMiddleware: [createRateLimiter(30, 60_000)],
623
660
  forkMiddleware: [forkRateLimit],
624
661
  mergeMiddleware: [mergeRateLimit],
625
- enableSessionEvents: false,
626
662
  resolveDefaultAgent,
627
663
  // ADR-036: право видеть РЕАЛЬНЫЕ значения секретов (плейсхолдер → значение)
628
664
  // в обычном чтении сессии (`GET /sessions/:id`, `GET /sessions/:id/messages`,
@@ -651,6 +687,13 @@ attachments) {
651
687
  contentRequired: (c) => t('errors.validation.contentRequired', undefined, c),
652
688
  queueFull: (c, max) => t('errors.chat.queueFull', { max }, c),
653
689
  steerLimitExceeded: (c, max) => t('errors.chat.steerLimitExceeded', { max }, c),
690
+ // Отключённые провайдер/модель — понятные 400 до постановки в очередь.
691
+ providerDisabled: (c, provider) => t('errors.chat.providerDisabled', { provider }, c),
692
+ modelDisabled: (c, provider, model) => t('errors.chat.modelDisabled', { provider, model }, c),
693
+ // Лимиты заметок сессии (`context.stickyNotes`) — instance-wide.
694
+ noteNotFound: (c) => t('errors.notFound.note', undefined, c),
695
+ noteLimitReached: (c, max) => t('errors.conflict.noteLimitReached', { max }, c),
696
+ noteTooLong: (c, max) => t('errors.validation.noteTooLong', { max }, c),
654
697
  },
655
698
  }));
656
699
  return app;