@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.
- package/dist/app/deps.d.ts +8 -0
- package/dist/app/deps.js +126 -9
- package/dist/app/mount-routes.js +155 -32
- package/dist/app/public-routes.d.ts +2 -0
- package/dist/app/public-routes.js +11 -0
- package/dist/app.d.ts +1 -1
- package/dist/app.js +31 -0
- package/dist/auth/api-key.d.ts +19 -0
- package/dist/auth/api-key.js +56 -0
- package/dist/auth/middleware.js +7 -3
- package/dist/events/hub.js +4 -1
- package/dist/init.d.ts +1 -0
- package/dist/init.js +96 -0
- package/dist/lib/app-config.js +12 -1
- package/dist/lib/bind-host.d.ts +10 -0
- package/dist/lib/bind-host.js +32 -0
- package/dist/lib/i18n.js +10 -0
- package/dist/main.js +4 -1
- package/dist/middleware/rate-limiter.d.ts +4 -1
- package/dist/middleware/rate-limiter.js +15 -2
- package/dist/routes/auth.js +5 -20
- package/dist/routes/llm.js +65 -7
- package/dist/routes/mcp-remote.d.ts +23 -0
- package/dist/routes/mcp-remote.js +152 -0
- package/dist/routes/mcp.d.ts +11 -6
- package/dist/routes/mcp.js +35 -6
- package/dist/routes/projects.d.ts +1 -1
- package/dist/routes/projects.js +11 -2
- package/dist/routes/providers.d.ts +4 -1
- package/dist/routes/providers.js +19 -99
- package/dist/routes/sessions.d.ts +15 -6
- package/dist/routes/sessions.js +257 -183
- package/package.json +4 -4
- package/dist/routes/audit.d.ts +0 -17
- package/dist/routes/audit.js +0 -64
- package/dist/routes/context.d.ts +0 -4
- package/dist/routes/context.js +0 -93
- package/dist/routes/debug.d.ts +0 -3
- package/dist/routes/debug.js +0 -30
- package/dist/routes/gateway-patterns.d.ts +0 -9
- package/dist/routes/gateway-patterns.js +0 -57
- package/dist/routes/logs.d.ts +0 -24
- package/dist/routes/logs.js +0 -100
- package/dist/routes/mcp-registry.d.ts +0 -28
- package/dist/routes/mcp-registry.js +0 -483
package/dist/routes/sessions.js
CHANGED
|
@@ -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-скоуп
|
|
11
|
-
*
|
|
17
|
+
* backend-специфичные роуты (MCP-скоуп сессии и секреты — более строгая политика
|
|
18
|
+
* managed, export/import, отладка). Общая логика (список/создание/чтение/изменение/
|
|
12
19
|
* удаление, status/prompt/stats, заметки (`notes`), очередь+SSE, children/tree/
|
|
13
|
-
* fork, references, merge
|
|
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 — карта обфускации).
|
|
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
|
|
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/
|
|
88
|
-
* fork/merge):
|
|
89
|
-
*
|
|
90
|
-
*
|
|
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
|
|
94
|
-
const
|
|
95
|
-
const
|
|
96
|
-
const
|
|
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` —
|
|
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
|
-
//
|
|
268
|
-
//
|
|
269
|
-
//
|
|
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
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
const
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
if (
|
|
343
|
-
|
|
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
|
-
//
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
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
|
-
|
|
377
|
-
|
|
378
|
-
|
|
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(
|
|
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
|
|
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
|
-
//
|
|
436
|
-
|
|
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.
|
|
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.
|
|
12
|
-
"@itphx/synth-shared": "0.13.
|
|
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"
|
package/dist/routes/audit.d.ts
DELETED
|
@@ -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;
|