@itphx/synth-backend 0.13.4 → 0.13.10

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 (67) hide show
  1. package/dist/app/deps.d.ts +22 -1
  2. package/dist/app/deps.js +743 -63
  3. package/dist/app/listen.js +30 -35
  4. package/dist/app/mount-routes.js +405 -46
  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.js +2 -0
  8. package/dist/app.d.ts +8 -1
  9. package/dist/app.js +45 -11
  10. package/dist/auth/api-key.d.ts +19 -0
  11. package/dist/auth/api-key.js +56 -0
  12. package/dist/auth/middleware.js +11 -15
  13. package/dist/auth/oidc.d.ts +46 -4
  14. package/dist/auth/oidc.js +55 -8
  15. package/dist/events/hub.d.ts +36 -2
  16. package/dist/events/hub.js +66 -4
  17. package/dist/events/visible-session-ids.d.ts +35 -0
  18. package/dist/events/visible-session-ids.js +29 -0
  19. package/dist/init.d.ts +1 -0
  20. package/dist/init.js +96 -0
  21. package/dist/lib/app-config.js +42 -1
  22. package/dist/lib/bind-host.d.ts +10 -0
  23. package/dist/lib/bind-host.js +32 -0
  24. package/dist/lib/i18n.js +24 -0
  25. package/dist/lib/principal-identity.d.ts +35 -0
  26. package/dist/lib/principal-identity.js +43 -0
  27. package/dist/lib/project-principal.d.ts +27 -0
  28. package/dist/lib/project-principal.js +27 -0
  29. package/dist/lib/recalc-can-summarize.js +8 -5
  30. package/dist/main.js +9 -2
  31. package/dist/middleware/rate-limiter.d.ts +4 -1
  32. package/dist/middleware/rate-limiter.js +15 -2
  33. package/dist/routes/agents.d.ts +3 -3
  34. package/dist/routes/agents.js +6 -2
  35. package/dist/routes/auth.js +38 -20
  36. package/dist/routes/llm.js +65 -7
  37. package/dist/routes/mcp-remote.d.ts +23 -0
  38. package/dist/routes/mcp-remote.js +152 -0
  39. package/dist/routes/mcp.d.ts +11 -6
  40. package/dist/routes/mcp.js +35 -6
  41. package/dist/routes/project-access.d.ts +61 -0
  42. package/dist/routes/project-access.js +62 -0
  43. package/dist/routes/projects.d.ts +42 -5
  44. package/dist/routes/projects.js +128 -17
  45. package/dist/routes/providers.d.ts +4 -1
  46. package/dist/routes/providers.js +19 -99
  47. package/dist/routes/queue.d.ts +7 -1
  48. package/dist/routes/queue.js +7 -1
  49. package/dist/routes/schedules.d.ts +46 -0
  50. package/dist/routes/schedules.js +10 -0
  51. package/dist/routes/sessions.d.ts +67 -6
  52. package/dist/routes/sessions.js +348 -208
  53. package/dist/routes/users.d.ts +14 -1
  54. package/dist/routes/users.js +91 -1
  55. package/package.json +5 -5
  56. package/dist/routes/audit.d.ts +0 -17
  57. package/dist/routes/audit.js +0 -64
  58. package/dist/routes/context.d.ts +0 -4
  59. package/dist/routes/context.js +0 -93
  60. package/dist/routes/debug.d.ts +0 -3
  61. package/dist/routes/debug.js +0 -30
  62. package/dist/routes/gateway-patterns.d.ts +0 -9
  63. package/dist/routes/gateway-patterns.js +0 -57
  64. package/dist/routes/logs.d.ts +0 -24
  65. package/dist/routes/logs.js +0 -100
  66. package/dist/routes/mcp-registry.d.ts +0 -28
  67. package/dist/routes/mcp-registry.js +0 -483
@@ -4,13 +4,23 @@ import { createRateLimiter } from '../middleware/rate-limiter.js';
4
4
  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
+ import { groupsOf } from '../lib/project-principal.js';
8
+ import { resolveVisibleProjectIds } from '../events/visible-session-ids.js';
7
9
  import { createProjectAccess } from './projects.js';
10
+ /**
11
+ * Максимум сессий в одном пакетном импорте (`POST /sessions/import-batch`).
12
+ * Защита от гигантских тел и длинных транзакционных серий.
13
+ */
14
+ const MAX_IMPORT_BATCH = 200;
15
+ /** Предел длины маркера источника (`import.source_session_id`), символов. */
16
+ const MAX_IMPORT_SOURCE_ID_LENGTH = 200;
8
17
  /**
9
18
  * Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
10
- * backend-специфичные роуты (MCP-скоуп сессии, секреты, export/import, отладка,
11
- * оптимизация контекста). Общая логика (список/создание/чтение/изменение/
19
+ * backend-специфичные роуты (MCP-скоуп сессии и секреты — более строгая политика
20
+ * managed, export/import, отладка). Общая логика (список/создание/чтение/изменение/
12
21
  * удаление, status/prompt/stats, заметки (`notes`), очередь+SSE, children/tree/
13
- * fork, references, merge) — в `createSessionRoutes` из `@itphx/synth-core`.
22
+ * fork, references, merge, оптимизация контекста, core-версии MCP-скоупа и
23
+ * секретов для standalone/гибрида) — в `createSessionRoutes` из `@itphx/synth-core`.
14
24
  *
15
25
  * RBAC: core-фабрика параметризуется `resolveUserId`/`resolveOwner`/`resolveAuthor`,
16
26
  * `canAccess` (владелец|ADMIN) и EventHub-хуками; remote/hybrid-ветки отключены
@@ -19,7 +29,9 @@ import { createProjectAccess } from './projects.js';
19
29
  *
20
30
  * Исключения из общего prefix-guard'а (собственные правила, роуты зарегистрированы
21
31
  * до guard'а): `/:id/mcp` (владелец|ADMIN, ADR-071 §2.4) и `/:id/secrets`
22
- * (ADMIN|AUDITOR — карта обфускации). `/:id/export` — ПОД guard'ом: доступ к
32
+ * (ADMIN|AUDITOR — карта обфускации). В core-фабрике есть версии этих маршрутов
33
+ * для standalone/гибрида; здесь они регистрируются раньше и потому выигрывают,
34
+ * сохраняя прежнюю политику. `/:id/export` — ПОД guard'ом: доступ к
23
35
  * сессии решает ЕДИНЫЙ prefix-guard, а привилегию карты обфускации — отдельный
24
36
  * route-level guard (`createSessionExportGuard`, ADR-036); в обработчике проверок
25
37
  * доступа нет (инвариант 16).
@@ -45,7 +57,7 @@ memory,
45
57
  */
46
58
  questionService,
47
59
  /**
48
- * ADR-114: сервис worktree'ов — привязка сессии к worktree
60
+ * ADR-114: сервис worktree — привязка сессии к worktree
49
61
  * (`PATCH /api/v2/sessions/:id { worktreeId }`).
50
62
  *
51
63
  * Не задан — поле `worktreeId` в PATCH игнорируется (привязка недоступна).
@@ -77,23 +89,78 @@ getStickyNoteLimits,
77
89
  * Доступность пары провайдер/модель **до постановки в очередь** (каталог
78
90
  * инстанса). Не задана — проверка выключена.
79
91
  */
80
- llmAvailability) {
92
+ llmAvailability,
93
+ /**
94
+ * Лимит тяжёлых операций ресурса сессий (`limits.sessionOpsPerMinute`,
95
+ * import/export/fork/merge) — live-геттер. Не задан — 10 (прежнее поведение).
96
+ * `0` — без ограничения; значение применяется без рестарта.
97
+ */
98
+ getSessionOpsPerMinute,
99
+ /**
100
+ * PROP-135 Ф6a: каталог профилей исполнения (`execution.remote`) —
101
+ * валидация `settings.executorProfile` в PATCH /:id. Не задан — проверка
102
+ * существования профиля пропускается (поведение прежнее).
103
+ */
104
+ executionProfileCatalog,
105
+ /**
106
+ * PROP-135 (браузерный контур): каталог браузерных профилей — валидация
107
+ * `settings.browserProfile` в PATCH /:id.
108
+ */
109
+ browserProfileCatalog,
110
+ /**
111
+ * ADR-126 §4: сервис сниппетов (`#`) — раскрытие `#токен` в пользовательском
112
+ * тексте на входе промпта (до очереди). Не задан — раскрытия нет.
113
+ */
114
+ snippetService,
115
+ /**
116
+ * ADR-126 §4: абсолютный рабочий каталог проекта по id — для project-уровня
117
+ * сниппетов. Не задан — workspace берётся из карточки проекта как есть.
118
+ */
119
+ resolveProjectWorkspace,
120
+ /**
121
+ * ADR-126 §5: сервис реестра скриптов проекта (`!`-запуск) — HTTP-контур
122
+ * `/api/v2/sessions/:id/scripts*`. Не задан — контура нет.
123
+ */
124
+ scriptService,
125
+ /**
126
+ * ADR-126 §5: правила прав инстанса — fallback для правила
127
+ * `permission.rules.script` (собственные правила сессии важнее).
128
+ */
129
+ permissionConfig,
130
+ /**
131
+ * ADR-136: журнал исполнений команд — запись `script.run` (только
132
+ * метаданные).
133
+ */
134
+ commandAudit,
135
+ /**
136
+ * ADR-126 §5: рабочий каталог по умолчанию — фоллбек для сессии **без
137
+ * проекта** (`.synth/scripts` из default workspace, как у `!`-запуска).
138
+ */
139
+ defaultWorkingDir,
140
+ /**
141
+ * PROP-141 (Часть D): сервис переноса сессии между проектами (единый шов:
142
+ * блокеры, согласие `move_consent`, порядок эффектов). Не задан — перенос
143
+ * между проектами недоступен (`PATCH { project_id }` → 500).
144
+ */
145
+ moveService) {
81
146
  const app = new Hono();
82
147
  const agentRegistry = orchestrator.agentRegistry;
83
148
  const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
84
149
  // ADR-071 §2.4: владелец сессии — обычный пользователь, управляющий её MCP-скоупом.
85
150
  const isSessionOwner = (session, userId) => (session.ownerId ?? session.userId) === userId;
86
151
  /**
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
- * создание форка, копирование сообщений) — защита от всплесков/выкачивания.
152
+ * Rate limit на тяжёлые/неинтерактивные операции ресурса сессий (import/
153
+ * export/fork/merge): значение настраивается instance-wide
154
+ * (`limits.sessionOpsPerMinute`, дефолт 10 запросов / 60 с на креду),
155
+ * `0` — без лимита. Тот же in-memory `createRateLimiter`, что у
156
+ * `POST /:id/prompt` (30/60) и `schedules/:id/run` (10/60). Порог —
157
+ * live-геттер: runtime-изменение из админки применяется без рестарта.
92
158
  */
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);
159
+ const sessionOpsLimit = () => getSessionOpsPerMinute?.() ?? 10;
160
+ const importRateLimit = createRateLimiter(sessionOpsLimit, 60_000);
161
+ const exportRateLimit = createRateLimiter(sessionOpsLimit, 60_000);
162
+ const forkRateLimit = createRateLimiter(sessionOpsLimit, 60_000);
163
+ const mergeRateLimit = createRateLimiter(sessionOpsLimit, 60_000);
97
164
  /**
98
165
  * Единое правило доступа к сессии (читать/писать) — ОДНА точка на весь ресурс
99
166
  * `/api/v2/sessions`, включая backend-only маршруты (export/debug/optimization/
@@ -156,8 +223,8 @@ llmAvailability) {
156
223
  sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
157
224
  forbidden: (c) => t('auth.forbidden', undefined, c),
158
225
  },
159
- // `/import` — статический сегмент (не id сессии).
160
- skipForId: (id) => id === 'import',
226
+ // `/import` и `/import-batch` — статические сегменты (не id сессии).
227
+ skipForId: (id) => id === 'import' || id === 'import-batch',
161
228
  });
162
229
  /**
163
230
  * Привилегия карты обфускации при экспорте сессии (ADR-036, security-фикс
@@ -228,30 +295,40 @@ llmAvailability) {
228
295
  }, 400);
229
296
  }
230
297
  }
231
- if (name !== undefined) {
232
- // Точечный toggle: enabled → session.enabled; disabled → opt-out.
233
- const enabledList = new Set(session.settings.mcpServers ?? []);
234
- const disabledList = new Set(session.settings.mcpDisabledServers ?? []);
235
- if (enabled === false) {
236
- enabledList.delete(name);
237
- disabledList.add(name);
298
+ // Тоггл/список — метаданные сессии: точечная правка под локом порта
299
+ // (`mutateMeta`); история и очередь не перезаписываются. `updatedAt`
300
+ // двигается — паритет с прежним `updateSession`.
301
+ const scoped = await sessionManager.mutateMeta(session.id, (meta) => {
302
+ if (name !== undefined) {
303
+ // Точечный toggle: enabled → session.enabled; disabled → opt-out.
304
+ const enabledList = new Set(meta.settings.mcpServers ?? []);
305
+ const disabledList = new Set(meta.settings.mcpDisabledServers ?? []);
306
+ if (enabled === false) {
307
+ enabledList.delete(name);
308
+ disabledList.add(name);
309
+ }
310
+ else {
311
+ enabledList.add(name);
312
+ disabledList.delete(name);
313
+ }
314
+ meta.settings.mcpServers = [...enabledList];
315
+ meta.settings.mcpDisabledServers = [...disabledList];
238
316
  }
239
317
  else {
240
- enabledList.add(name);
241
- disabledList.delete(name);
318
+ if (mcpServers !== undefined)
319
+ meta.settings.mcpServers = mcpServers;
320
+ if (mcpDisabledServers !== undefined)
321
+ meta.settings.mcpDisabledServers = mcpDisabledServers;
242
322
  }
243
- session.settings.mcpServers = [...enabledList];
244
- session.settings.mcpDisabledServers = [...disabledList];
245
- }
246
- else {
247
- if (mcpServers !== undefined)
248
- session.settings.mcpServers = mcpServers;
249
- if (mcpDisabledServers !== undefined)
250
- session.settings.mcpDisabledServers = mcpDisabledServers;
323
+ return meta.settings;
324
+ });
325
+ if (!scoped.found) {
326
+ return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
251
327
  }
252
- await sessionManager.updateSession(session);
253
- eventBus.publish(session.id, 'session.updated', serializeSession(session, { agentRegistry }));
254
- return c.json(await buildSessionMcpPayload(session));
328
+ // Свежий снимок — для события и ответа.
329
+ const updatedSession = (await sessionManager.getSession(session.id)) ?? session;
330
+ eventBus.publish(updatedSession.id, 'session.updated', serializeSession(updatedSession, { agentRegistry }));
331
+ return c.json(await buildSessionMcpPayload(updatedSession));
255
332
  });
256
333
  // GET /api/v2/sessions/:id/secrets — карта обфускации LLM Gateway (ADR-036).
257
334
  // RBAC: только ADMIN/AUDITOR — сама карта является секретом.
@@ -264,9 +341,10 @@ llmAvailability) {
264
341
  });
265
342
  // Единый prefix-guard ресурса сессий: вешается ПОСЛЕ `/:id/mcp` и `/:id/secrets`
266
343
  // (у них собственные задокументированные правила) и покрывает отладку,
267
- // оптимизацию, заметки, ЭКСПОРТ и все core-маршруты (core-фабрика
268
- // регистрируется с registerAccessGuard:false — иначе был бы второй источник
269
- // правил). `/import` пропускается через guard.skipForId (статический сегмент,
344
+ // оптимизацию (реализация — в core-фабрике, регистрируется ниже), заметки,
345
+ // ЭКСПОРТ и все core-маршруты (core-фабрика регистрируется с
346
+ // registerAccessGuard:false — иначе был бы второй источник правил).
347
+ // `/import` пропускается через guard.skipForId (статический сегмент,
270
348
  // не сессия).
271
349
  app.use('/:id', kit.requireAuth, sessionAccessGuard);
272
350
  app.use('/:id/*', kit.requireAuth, sessionAccessGuard);
@@ -308,53 +386,52 @@ llmAvailability) {
308
386
  }
309
387
  return c.json(decision.withSecrets ? decision.session : stripSessionSecrets(decision.session));
310
388
  });
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);
389
+ /**
390
+ * Маркер источника из `body.import` (`source_session_id` | `sourceSessionId`):
391
+ * непустая строка ≤ 200 символов; иначе маркера нет (дедуп не применяется).
392
+ */
393
+ const readImportSourceId = (body) => {
394
+ const imp = body.import;
395
+ const raw = imp?.source_session_id ?? imp?.sourceSessionId;
396
+ if (typeof raw !== 'string')
397
+ return undefined;
398
+ const trimmed = raw.trim();
399
+ if (!trimmed || trimmed.length > MAX_IMPORT_SOURCE_ID_LENGTH)
400
+ return undefined;
401
+ return trimmed;
402
+ };
403
+ /**
404
+ * Применить тело экспорта к сессии — **одна реализация** для нового импорта и
405
+ * дедуплицированного обновления.
406
+ *
407
+ * `isUpdate: true` (дедуп) — «перезапись выбранного проекта»: `title`,
408
+ * `settings`, `icon`/`color` и весь контент берутся из тела. Идентичность
409
+ * записи сохраняется: `id`/`projectId`/`userId`/`ownerId`/`sessionOrigin`/
410
+ * `createdAt`/`archivedAt`/`sourceSessionId` не трогаются, `parentId`
411
+ * перезаписывается только если пришёл в теле.
412
+ *
413
+ * `isUpdate: false` (новая сессия) — поведение прежнее: `title`/`settings`
414
+ * уже проставлены `createSession` (с дефолтами), `createdAt` берётся из тела.
415
+ */
416
+ const applyImportBody = (session, body, sourceSessionId, isUpdate = false) => {
417
+ // Свойства записи: при обновлении — из тела (перезапись проекта), при
418
+ // создании их уже проставил `createSession` (там же дефолты настроек).
419
+ if (isUpdate) {
420
+ if (typeof body.title === 'string')
421
+ session.title = body.title;
422
+ if (body.settings && typeof body.settings === 'object' && !Array.isArray(body.settings)) {
423
+ session.settings = body.settings;
344
424
  }
345
425
  }
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);
426
+ // parentId: publish переписывает ссылки на новые remote-id до импорта —
427
+ // сохраняем. При обновлении отсутствие поля в теле не очищает привязку.
428
+ const parentId = body.parent_id ?? body.parentId;
429
+ if (typeof parentId === 'string')
430
+ session.parentId = parentId;
431
+ else if (parentId === null)
432
+ session.parentId = undefined;
433
+ else if (!isUpdate)
434
+ session.parentId = undefined;
358
435
  const messages = Array.isArray(body.messages) ? body.messages : [];
359
436
  session.messages = messages.map((m) => ({ ...structuredClone(m), seq: 0 }));
360
437
  session.messages.forEach((m, i) => { m.seq = i + 1; });
@@ -367,21 +444,26 @@ llmAvailability) {
367
444
  session.references = Array.isArray(body.references) ? body.references : [];
368
445
  session.checkpoints = Array.isArray(body.checkpoints) ? body.checkpoints : [];
369
446
  session.mode = (body.mode ?? undefined);
370
- session.planApproved = body.plan_approved ?? body.planApproved ?? false;
371
- session.branchPoint = body.branch_point ?? body.branchPoint;
447
+ session.planApproved = (body.plan_approved ?? body.planApproved ?? false);
448
+ session.branchPoint = (body.branch_point ?? body.branchPoint);
372
449
  // Метаданные сессии (иконка/цвет) — нормализуем legacy при импорте.
373
450
  session.icon = normalizeIconKey(body.icon);
374
451
  session.color = normalizeColorKey(body.color);
375
452
  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;
453
+ // `createdAt` — идентичность записи: при обновлении сохраняем исходное
454
+ // серверное значение; при создании — как раньше, из тела экспорта.
455
+ if (!isUpdate) {
456
+ session.createdAt = typeof (body.created_at ?? body.createdAt) === 'string'
457
+ ? (body.created_at ?? body.createdAt)
458
+ : session.createdAt;
459
+ }
379
460
  session.updatedAt = nowISO();
380
461
  // Сбрасываем runtime-состояние: блокировки/стримы с другого хоста не переносим.
381
462
  session.status = {};
382
463
  session.currentStream = undefined;
383
464
  session.summarizationPending = false;
384
465
  session.canSummarize = false;
466
+ session.retry = undefined;
385
467
  const num = (v, def = 0) => (typeof v === 'number' ? v : def);
386
468
  session.inputTokens = num(body.input_tokens ?? body.inputTokens);
387
469
  session.outputTokens = num(body.output_tokens ?? body.outputTokens);
@@ -393,11 +475,165 @@ llmAvailability) {
393
475
  session.outputCost = num(body.output_cost ?? body.outputCost);
394
476
  session.cacheReadCost = num(body.cache_read_cost ?? body.cacheReadCost);
395
477
  session.cacheWriteCost = num(body.cache_write_cost ?? body.cacheWriteCost);
478
+ // Маркер источника переноса — ключ дедупликации повторного импорта.
479
+ if (sourceSessionId)
480
+ session.sourceSessionId = sourceSessionId;
481
+ };
482
+ /**
483
+ * Импорт одной сессии: проверка проекта (право записи), дедуп по маркеру
484
+ * источника, создание либо обновление. Общий код одиночного и пакетного
485
+ * маршрутов — дефолты/дедуп не разъезжаются.
486
+ */
487
+ const importSessionFromBody = async (body, userId, forbiddenMessage, ctx) => {
488
+ const imp = (body.import ?? {});
489
+ const targetProjectId = (imp.project_id
490
+ ?? imp.projectId
491
+ ?? body.project_id
492
+ ?? body.projectId
493
+ ?? undefined);
494
+ if (targetProjectId) {
495
+ if (!projectStore) {
496
+ return { ok: false, status: 500, code: 'INTERNAL_ERROR', message: 'Хранилище проектов недоступно' };
497
+ }
498
+ const existingProject = await projectStore.load(targetProjectId);
499
+ if (!existingProject) {
500
+ return { ok: false, status: 400, code: 'PROJECT_NOT_FOUND', message: 'Проект не найден' };
501
+ }
502
+ // Безопасность: импорт привязывает сессию к проекту и выдаёт агенту его
503
+ // workspace — без проверки доступа к проекту получается IDOR (чтение/запись
504
+ // файлов чужого проекта).
505
+ //
506
+ // Импорт сессии В ПРОЕКТ — это ЗАПИСЬ в проект (инвариант 21: read-уровень
507
+ // доступа не расширяет права на изменение), поэтому нужен уровень
508
+ // «редактирование контента проекта» (`canEditProjectContent`: owner /
509
+ // EDITOR / LEAD / ADMIN) — тот же, что у импорта проекта целиком
510
+ // (`core/server/routes/project-portable.ts`, `deps.canEdit`). Участник с
511
+ // ролью VIEWER получает 403.
512
+ if (!canEditProjectContent(ctx, existingProject, userId)) {
513
+ return { ok: false, status: 403, code: 'FORBIDDEN', message: forbiddenMessage };
514
+ }
515
+ }
516
+ const sourceSessionId = readImportSourceId(body);
517
+ // Дедуп: та же исходная сессия уже перенесена — обновляем её, а не создаём
518
+ // дубль. Область поиска: целевой проект; без проекта — только **свои**
519
+ // сессии (иначе подставленный чужой маркер обновил бы чужую запись).
520
+ // `includeArchived` — ранее импортированная и заархивированная сессия не
521
+ // должна дублироваться при повторной публикации.
522
+ if (sourceSessionId) {
523
+ const candidates = await sessionManager.listSessions(targetProjectId ? { projectId: targetProjectId } : { userId }, { includeArchived: true });
524
+ // Страховка поверх фильтра: обновляем только свою сессию. Если проектный
525
+ // обзор/видимость вернули чужую запись с тем же маркером — не трогаем её,
526
+ // создаём новую.
527
+ const match = candidates.find((s) => s.sourceSessionId === sourceSessionId && (s.ownerId ?? s.userId) === userId);
528
+ if (match) {
529
+ const existingSession = await sessionManager.getSession(match.id);
530
+ if (existingSession && (existingSession.ownerId ?? existingSession.userId) === userId) {
531
+ applyImportBody(existingSession, body, sourceSessionId, true);
532
+ await sessionManager.saveSession(existingSession);
533
+ // Инвариант 27: обновление видно другим клиентам.
534
+ eventBus.publish(existingSession.id, 'session.updated', serializeSession(existingSession, { agentRegistry }));
535
+ return { ok: true, session: existingSession, updated: true };
536
+ }
537
+ }
538
+ }
539
+ // ADR-089: materialization (перенос истории), не request — прямой createSession.
540
+ const session = await sessionManager.createSession({
541
+ title: typeof body.title === 'string' ? body.title : undefined,
542
+ projectId: targetProjectId,
543
+ sessionOrigin: (body.session_origin ?? body.sessionOrigin),
544
+ settings: (body.settings ?? {}),
545
+ userId,
546
+ ownerId: userId,
547
+ });
548
+ applyImportBody(session, body, sourceSessionId, false);
396
549
  await sessionManager.saveSession(session);
397
550
  // Автоматически подписываем активных клиентов на новую сессию
398
- eventHub.subscribeToSession(user.id, session.id).catch((e) => console.warn('subscribeToSession failed:', e));
551
+ eventHub.subscribeToSession(userId, session.id).catch((e) => console.warn('subscribeToSession failed:', e));
399
552
  eventBus.publish(session.id, 'session.created', serializeSession(session, { agentRegistry }));
400
- return c.json(serializeSession(session, { agentRegistry }), 201);
553
+ return { ok: true, session, updated: false };
554
+ };
555
+ // POST /api/v2/sessions/import — создать сессию из экспорта другой сессии
556
+ // (перенос истории между мирами). Тело: объект экспорта + import.project_id
557
+ // (целевой проект; если не задан — берётся из экспорта) + опциональный
558
+ // import.source_session_id — маркер источника (ключ дедупликации повторного
559
+ // импорта: та же сессия в том же проекте обновляется, а не дублируется).
560
+ // LLM не запускается.
561
+ // ADR-089: это materialization-операция (создание-как-факт переноса истории),
562
+ // а не request — идёт прямым `createSession`, минуя funnel `session.requested`.
563
+ app.post('/import', kit.requireAuth, importRateLimit, async (c) => {
564
+ const user = (await kit.getCurrentUser(c));
565
+ const body = (await c.req.json().catch(() => ({})));
566
+ const outcome = await importSessionFromBody(body, user.id, t('auth.forbidden', undefined, c), c);
567
+ if (!outcome.ok) {
568
+ return c.json({ error: { code: outcome.code, message: outcome.message } }, outcome.status);
569
+ }
570
+ // `updated` — аддитивное поле поверх DTO: true — обновлена существующая
571
+ // запись (dedup по маркеру), false — создана новая.
572
+ return c.json({ ...serializeSession(outcome.session, { agentRegistry }), updated: outcome.updated }, outcome.updated ? 200 : 201);
573
+ });
574
+ // POST /api/v2/sessions/import-batch — пакетный импорт сессий одним запросом.
575
+ // Тело: `{ sessions: Array<тело экспорта + import { project_id, source_session_id }> }`
576
+ // (1..MAX_IMPORT_BATCH). Элементы обрабатываются **последовательно** тем же
577
+ // кодом, что одиночный импорт (дедуп/дефолты не разъезжаются). Ошибка на
578
+ // элементе прерывает пакет; частичные записи безопасны — повтор идемпотентен
579
+ // благодаря дедупу по `source_session_id`.
580
+ app.post('/import-batch', kit.requireAuth, importRateLimit, async (c) => {
581
+ const user = (await kit.getCurrentUser(c));
582
+ const body = (await c.req.json().catch(() => ({})));
583
+ const rawSessions = body.sessions;
584
+ if (!Array.isArray(rawSessions) || rawSessions.length < 1 || rawSessions.length > MAX_IMPORT_BATCH) {
585
+ return c.json({
586
+ error: {
587
+ code: 'VALIDATION_ERROR',
588
+ message: `sessions: ожидается массив из 1..${MAX_IMPORT_BATCH} элементов`,
589
+ },
590
+ }, 400);
591
+ }
592
+ const results = [];
593
+ let imported = 0;
594
+ let updated = 0;
595
+ for (const item of rawSessions) {
596
+ if (!item || typeof item !== 'object' || Array.isArray(item)) {
597
+ return c.json({
598
+ error: {
599
+ code: 'VALIDATION_ERROR',
600
+ message: 'sessions: элемент должен быть объектом экспорта сессии',
601
+ },
602
+ details: { imported, updated, source_session_id: null },
603
+ }, 400);
604
+ }
605
+ const itemBody = item;
606
+ const sourceSessionId = readImportSourceId(itemBody);
607
+ let outcome;
608
+ try {
609
+ outcome = await importSessionFromBody(itemBody, user.id, t('auth.forbidden', undefined, c), c);
610
+ }
611
+ catch (err) {
612
+ return c.json({
613
+ error: {
614
+ code: 'INTERNAL_ERROR',
615
+ message: err instanceof Error ? err.message : 'Импорт сессии не удался',
616
+ },
617
+ details: { imported, updated, source_session_id: sourceSessionId ?? null },
618
+ }, 500);
619
+ }
620
+ if (!outcome.ok) {
621
+ return c.json({
622
+ error: { code: outcome.code, message: outcome.message },
623
+ details: { imported, updated, source_session_id: sourceSessionId ?? null },
624
+ }, outcome.status);
625
+ }
626
+ results.push({
627
+ source_session_id: sourceSessionId ?? null,
628
+ id: outcome.session.id,
629
+ updated: outcome.updated,
630
+ });
631
+ if (outcome.updated)
632
+ updated += 1;
633
+ else
634
+ imported += 1;
635
+ }
636
+ return c.json({ sessions: results, imported, updated }, 200);
401
637
  });
402
638
  // POST /api/v2/sessions/:id/debug-system-message — отправить отладочное системное сообщение
403
639
  // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
@@ -431,122 +667,22 @@ llmAvailability) {
431
667
  }
432
668
  return c.json({ status: 'enqueued', stream_id: streamId });
433
669
  });
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
- });
670
+ // GET /api/v2/sessions/:id/optimization — настройки оптимизации контекста
671
+ // (ADR-119). Реализация — в core-фабрике (нужна standalone/гибриду): backend
672
+ // монтирует её ниже, единый prefix-guard покрывает доступ (инвариант 16).
545
673
  // Общая логика — в core-фабрике (backend-специфика выше). Регистрируем её
546
674
  // последней: статические/backend-only сегменты должны матчиться раньше.
547
- 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 } : {}) }, {
675
+ // Оптимизация контекста (ADR-119), MCP-скоуп сессии и карта обфускации живут
676
+ // в core-фабрике — они нужны standalone/гибриду (`remote:`-сессии
677
+ // форвардятся на backend). Свои `/:id/mcp` и `/:id/secrets` зарегистрированы
678
+ // ВЫШЕ и сохраняют более строгую политику managed (владелец|ADMIN и
679
+ // ADMIN|AUDITOR соответственно) — порядок регистрации оставляет её в силе.
680
+ 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 } : {}), ...(executionProfileCatalog ? { executionProfileCatalog } : {}), ...(browserProfileCatalog ? { browserProfileCatalog } : {}), ...(snippetService ? { snippetService } : {}), ...(resolveProjectWorkspace ? { resolveProjectWorkspace } : {}), ...(scriptService ? { scriptService } : {}), ...(permissionConfig ? { permissionConfig } : {}), ...(commandAudit ? { commandAudit } : {}), ...(defaultWorkingDir ? { defaultWorkingDir } : {}), ...(moveService ? { moveService } : {}) }, {
548
681
  resolveUserId: async (c) => (await kit.getCurrentUser(c)).id,
549
682
  resolveOwner: async (c) => (await kit.getCurrentUser(c)).id,
683
+ // ADR-140 Ф2: группы пользователя запроса (снимок claim'а IdP) — кладутся
684
+ // в принципал хода при приёме ввода; нет — групп нет (fail-closed).
685
+ resolveUserGroups: (c) => groupsOf(c.get('user')),
550
686
  forkWithOwner: true,
551
687
  // Доступ к сессии обеспечивает единый prefix-guard ресурса (см. выше):
552
688
  // `registerAccessGuard: false` отключает собственный guard core-фабрики,
@@ -561,18 +697,22 @@ llmAvailability) {
561
697
  return isAdmin || isLead;
562
698
  },
563
699
  // ADR-089: проекты-участия пользователя — проектные сессии видны участникам.
564
- resolveMemberProjectIds: async (_c, userId) => {
700
+ // PROP-133 §6: список — **все** проекты, где у пользователя есть роль
701
+ // (владелец/участник/грант по группе/«всем пользователям»), а не только
702
+ // записи в `members`. Тот же шов использует хаб подписок.
703
+ resolveMemberProjectIds: async (c, userId) => {
565
704
  if (!projectStore)
566
705
  return [];
567
- const projects = await projectStore.list(userId);
568
- return projects.map((p) => p.id);
706
+ const user = await kit.getCurrentUser(c);
707
+ const groups = groupsOf(user);
708
+ return resolveVisibleProjectIds(projectStore, { userId, ...(groups ? { groups } : {}) });
569
709
  },
570
710
  resolveAuthor: async (c) => (await kit.getCurrentUser(c)).username,
571
711
  // ADR-106 Ф3: принципал ответа на подтверждение — аутентифицированный
572
712
  // пользователь запроса (клиенту не доверяем) и его роли инстанса.
573
713
  resolvePermissionResponder: async (c) => {
574
714
  const user = await kit.getCurrentUser(c);
575
- return { kind: 'user', id: user?.id ?? '', roles: user?.roles ?? [] };
715
+ return { kind: 'user', id: user?.id ?? '', roles: user?.roles ?? [], groups: user?.groups ?? [] };
576
716
  },
577
717
  publishRenamed: false,
578
718
  publishDeletedBefore: false,