@itphx/synth-backend 0.10.0 → 0.11.3
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/bootstrap.d.ts +11 -0
- package/dist/app/bootstrap.js +19 -0
- package/dist/app/deps.d.ts +124 -0
- package/dist/app/deps.js +751 -0
- package/dist/app/listen.d.ts +34 -0
- package/dist/app/listen.js +309 -0
- package/dist/app/mount-routes.d.ts +31 -0
- package/dist/app/mount-routes.js +696 -0
- package/dist/app/sse-events.d.ts +15 -0
- package/dist/app/sse-events.js +83 -0
- package/dist/app.d.ts +30 -17
- package/dist/app.js +164 -1337
- package/dist/auth/guards.d.ts +2 -1
- package/dist/auth/guards.js +10 -2
- package/dist/auth/middleware.d.ts +9 -14
- package/dist/auth/middleware.js +38 -6
- package/dist/auth/oidc.d.ts +22 -0
- package/dist/auth/oidc.js +68 -9
- package/dist/auth/service-scope.d.ts +8 -4
- package/dist/auth/service-scope.js +9 -5
- package/dist/events/hub.d.ts +2 -2
- package/dist/events/hub.js +3 -38
- package/dist/lib/app-config.d.ts +2 -0
- package/dist/lib/app-config.js +3 -2
- package/dist/lib/cors.d.ts +23 -0
- package/dist/lib/cors.js +24 -0
- package/dist/lib/defaults-store.d.ts +2 -25
- package/dist/lib/defaults-store.js +5 -87
- package/dist/lib/i18n.js +58 -6
- package/dist/main.js +23 -7
- package/dist/middleware/rate-limiter.d.ts +4 -1
- package/dist/middleware/rate-limiter.js +4 -2
- package/dist/routes/agents.d.ts +2 -2
- package/dist/routes/audit.d.ts +1 -1
- package/dist/routes/audit.js +2 -2
- package/dist/routes/auth.d.ts +2 -2
- package/dist/routes/auth.js +28 -4
- package/dist/routes/context.d.ts +2 -2
- package/dist/routes/gateway-patterns.d.ts +3 -3
- package/dist/routes/gateway-patterns.js +1 -1
- package/dist/routes/llm.d.ts +8 -2
- package/dist/routes/llm.js +9 -5
- package/dist/routes/mcp-registry.d.ts +6 -6
- package/dist/routes/mcp-registry.js +10 -10
- package/dist/routes/mcp.d.ts +1 -1
- package/dist/routes/mcp.js +1 -1
- package/dist/routes/messages.d.ts +5 -4
- package/dist/routes/messages.js +30 -3
- package/dist/routes/models.d.ts +7 -2
- package/dist/routes/models.js +3 -1
- package/dist/routes/projects.d.ts +7 -7
- package/dist/routes/projects.js +7 -7
- package/dist/routes/providers.d.ts +15 -3
- package/dist/routes/providers.js +34 -21
- package/dist/routes/queue.d.ts +5 -4
- package/dist/routes/queue.js +30 -3
- package/dist/routes/sessions.d.ts +14 -4
- package/dist/routes/sessions.js +234 -34
- package/dist/routes/users.js +1 -1
- package/dist/test-helpers/close-server.d.ts +33 -0
- package/dist/test-helpers/close-server.js +50 -0
- package/package.json +3 -3
package/dist/routes/sessions.js
CHANGED
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import { MessageRole, generateStreamId, nowISO, sessionMcpUpdateSchema, normalizeIconKey, normalizeColorKey, } from '@itphx/synth-shared';
|
|
3
3
|
import { createRateLimiter } from '../middleware/rate-limiter.js';
|
|
4
|
-
import { scopeGuard,
|
|
5
|
-
import { enqueueUserMessage, serializeSession, createSessionRoutes as createCoreSessionRoutes, } from '@itphx/synth-core';
|
|
4
|
+
import { scopeGuard, serviceProjectProjection } from '../auth/service-scope.js';
|
|
5
|
+
import { enqueueUserMessage, serializeSession, createSessionAccessGuard, createSessionAccessPredicate, createSessionExportGuard, getSessionExportDecision, isSessionExportPath, createSessionRoutes as createCoreSessionRoutes, stripSessionSecrets, } from '@itphx/synth-core';
|
|
6
6
|
import { t } from '../lib/i18n.js';
|
|
7
|
+
import { createProjectAccess } from './projects.js';
|
|
7
8
|
/**
|
|
8
9
|
* Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
|
|
9
10
|
* backend-специфичные роуты (MCP-скоуп сессии, секреты, export/import, отладка,
|
|
@@ -14,6 +15,13 @@ import { t } from '../lib/i18n.js';
|
|
|
14
15
|
* RBAC: core-фабрика параметризуется `resolveUserId`/`resolveOwner`/`resolveAuthor`,
|
|
15
16
|
* `canAccess` (владелец|ADMIN) и EventHub-хуками; remote/hybrid-ветки отключены
|
|
16
17
|
* (getRemoteClient не передаётся). `GET /:id/events` на backend не регистрируется.
|
|
18
|
+
*
|
|
19
|
+
* Исключения из общего prefix-guard'а (собственные правила, роуты зарегистрированы
|
|
20
|
+
* до guard'а): `/:id/mcp` (владелец|ADMIN, ADR-071 §2.4) и `/:id/secrets`
|
|
21
|
+
* (ADMIN|AUDITOR — карта обфускации). `/:id/export` — ПОД guard'ом: доступ к
|
|
22
|
+
* сессии решает ЕДИНЫЙ prefix-guard, а привилегию карты обфускации — отдельный
|
|
23
|
+
* route-level guard (`createSessionExportGuard`, ADR-036); в обработчике проверок
|
|
24
|
+
* доступа нет (инвариант 16).
|
|
17
25
|
*/
|
|
18
26
|
export function createSessionRoutes(kit, sessionManager, eventBus, queueManager, processMessage, orchestrator, eventHub, contextOptimizer, projectStore,
|
|
19
27
|
/** Профили пользователей: display name для статистики (fallback — username). */
|
|
@@ -21,15 +29,111 @@ profilesStore,
|
|
|
21
29
|
/** Агент по умолчанию для новых сессий без `settings.agentRole` (runtime-настройка). */
|
|
22
30
|
resolveDefaultAgent,
|
|
23
31
|
/**
|
|
24
|
-
*
|
|
32
|
+
* ADR-089: единый funnel создания сессий (прокидывается в core-фабрику).
|
|
25
33
|
* Не задан — core-фабрика использует прямой `SessionManager.createSession`.
|
|
26
34
|
*/
|
|
27
|
-
requestSessionService
|
|
35
|
+
requestSessionService,
|
|
36
|
+
/** PROP-102: сборщик `activity` (меры `aborts`/`messages_*`) для core-фабрики. */
|
|
37
|
+
analytics) {
|
|
28
38
|
const app = new Hono();
|
|
29
39
|
const agentRegistry = orchestrator.agentRegistry;
|
|
30
|
-
|
|
40
|
+
const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
|
|
41
|
+
// ADR-071 §2.4: владелец сессии — обычный пользователь, управляющий её MCP-скоупом.
|
|
31
42
|
const isSessionOwner = (session, userId) => (session.ownerId ?? session.userId) === userId;
|
|
32
|
-
/**
|
|
43
|
+
/**
|
|
44
|
+
* Rate limit на тяжёлые/неинтерактивные операции ресурса сессий (import/export/
|
|
45
|
+
* fork/merge): 10 запросов / 60 с на креду — тот же in-memory `createRateLimiter`,
|
|
46
|
+
* что у `POST /:id/prompt` (30/60) и `schedules/:id/run` (10/60). Значение ниже
|
|
47
|
+
* prompt: операции не частые в живом UI, но дорогие (полный объект сессии,
|
|
48
|
+
* создание форка, копирование сообщений) — защита от всплесков/выкачивания.
|
|
49
|
+
*/
|
|
50
|
+
const importRateLimit = createRateLimiter(10, 60_000);
|
|
51
|
+
const exportRateLimit = createRateLimiter(10, 60_000);
|
|
52
|
+
const forkRateLimit = createRateLimiter(10, 60_000);
|
|
53
|
+
const mergeRateLimit = createRateLimiter(10, 60_000);
|
|
54
|
+
/**
|
|
55
|
+
* Единое правило доступа к сессии (читать/писать) — ОДНА точка на весь ресурс
|
|
56
|
+
* `/api/v2/sessions`, включая backend-only маршруты (export/debug/optimization/
|
|
57
|
+
* notes) и core-маршруты. Правило:
|
|
58
|
+
* - elevated (ADMIN/LEAD) → всё (осознанное решение: мутации чужих сессий
|
|
59
|
+
* у LEAD/ADMIN сохранены как есть);
|
|
60
|
+
* - владелец сессии или сессия без владельца → всё;
|
|
61
|
+
* - иначе — роль в проекте: чтение (`GET`/`HEAD`) — проектное чтение
|
|
62
|
+
* (`canReadProject`: owner проекта или любой участник), мутация — проектное
|
|
63
|
+
* редактирование (`canEditProjectContent`: owner/EDITOR).
|
|
64
|
+
* Разделение read/write делает prefix-guard по HTTP-методу (единая точка).
|
|
65
|
+
*/
|
|
66
|
+
const sessionAccessPredicate = createSessionAccessPredicate({
|
|
67
|
+
canAccess: (session, c, userId) => {
|
|
68
|
+
const owner = session.ownerId ?? session.userId;
|
|
69
|
+
return !owner || owner === userId
|
|
70
|
+
|| (typeof kit.isAdmin === 'function' && kit.isAdmin(c));
|
|
71
|
+
},
|
|
72
|
+
resolveCanAccessExtra: async (session, c, userId, access) => {
|
|
73
|
+
if (!projectStore || !session.projectId)
|
|
74
|
+
return false;
|
|
75
|
+
const project = await projectStore.load(session.projectId);
|
|
76
|
+
if (!project)
|
|
77
|
+
return false;
|
|
78
|
+
const ctx = c;
|
|
79
|
+
return access === 'read'
|
|
80
|
+
? canReadProject(ctx, project, userId)
|
|
81
|
+
: canEditProjectContent(ctx, project, userId);
|
|
82
|
+
},
|
|
83
|
+
localUserId: 'local',
|
|
84
|
+
});
|
|
85
|
+
/**
|
|
86
|
+
* `GET /:id/export` — единственный `:id`-маршрут, где роль аудита инстанса
|
|
87
|
+
* (`AUDITOR`) является **читателем** сессии: карта обфускации ЛЮБОЙ сессии ему
|
|
88
|
+
* и так доступна (`GET /:id/secrets` — `ADMIN`/`AUDITOR`), поэтому экспорт
|
|
89
|
+
* сессии для него не привилегия сверх того, что у него уже есть. На остальных
|
|
90
|
+
* `:id`-маршрутах правило доступа не меняется (см. матрицу
|
|
91
|
+
* `session-idor-matrix.test.ts`).
|
|
92
|
+
*/
|
|
93
|
+
const isSessionExportRequest = (c) => c.req.method === 'GET' && isSessionExportPath(c.req.path);
|
|
94
|
+
const sessionAccessGuard = createSessionAccessGuard({
|
|
95
|
+
param: 'id',
|
|
96
|
+
resolveSession: (id) => sessionManager.getSession(id),
|
|
97
|
+
resolveUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
|
|
98
|
+
isAllowed: async (session, c, userId, access) => {
|
|
99
|
+
// Мок-AuthKit в тестах может не иметь isAdmin/hasRole — защищаем typeof.
|
|
100
|
+
const isAdmin = typeof kit.isAdmin === 'function' && kit.isAdmin(c);
|
|
101
|
+
const isLead = typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD');
|
|
102
|
+
if (isAdmin || isLead)
|
|
103
|
+
return true;
|
|
104
|
+
// Роль аудита инстанса — читатель сессии на маршруте экспорта (см. выше).
|
|
105
|
+
if (access === 'read' && isSessionExportRequest(c)) {
|
|
106
|
+
const isAuditor = typeof kit.hasRole === 'function' && kit.hasRole(c, 'AUDITOR');
|
|
107
|
+
if (isAuditor)
|
|
108
|
+
return true;
|
|
109
|
+
}
|
|
110
|
+
return sessionAccessPredicate(session, c, userId, access);
|
|
111
|
+
},
|
|
112
|
+
messages: {
|
|
113
|
+
sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
|
|
114
|
+
forbidden: (c) => t('auth.forbidden', undefined, c),
|
|
115
|
+
},
|
|
116
|
+
// `/import` — статический сегмент (не id сессии).
|
|
117
|
+
skipForId: (id) => id === 'import',
|
|
118
|
+
});
|
|
119
|
+
/**
|
|
120
|
+
* Привилегия карты обфускации при экспорте сессии (ADR-036, security-фикс
|
|
121
|
+
* 0.11.3) — отдельный route-level guard: он резолвит сессию, решает «полный
|
|
122
|
+
* экспорт или очищенный» и кладёт решение в контекст Hono. Обработчик
|
|
123
|
+
* `/export` только форматирует ответ по этому решению — копии правила доступа
|
|
124
|
+
* в обработчике нет (инвариант 16).
|
|
125
|
+
*/
|
|
126
|
+
const sessionExportGuard = createSessionExportGuard({
|
|
127
|
+
param: 'id',
|
|
128
|
+
resolveSession: (id) => sessionManager.getSession(id),
|
|
129
|
+
resolveUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
|
|
130
|
+
isAdmin: (c) => typeof kit.isAdmin === 'function' && kit.isAdmin(c),
|
|
131
|
+
isAuditor: (c) => typeof kit.hasRole === 'function' && kit.hasRole(c, 'AUDITOR'),
|
|
132
|
+
messages: {
|
|
133
|
+
sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
|
|
134
|
+
},
|
|
135
|
+
});
|
|
136
|
+
/** ADR-071 §2.4: эффективный MCP-скоуп сессии (включая отключённые с причиной). */
|
|
33
137
|
const buildSessionMcpPayload = async (session) => {
|
|
34
138
|
const servers = await orchestrator.resolveMcpServers(session);
|
|
35
139
|
return {
|
|
@@ -40,7 +144,7 @@ requestSessionService) {
|
|
|
40
144
|
mcpDisabledServers: session.settings.mcpDisabledServers ?? [],
|
|
41
145
|
};
|
|
42
146
|
};
|
|
43
|
-
// GET /api/v2/sessions/:id/mcp — эффективный MCP-скоуп (
|
|
147
|
+
// GET /api/v2/sessions/:id/mcp — эффективный MCP-скоуп (ADR-071 §2.4).
|
|
44
148
|
// Показывает все серверы, включая отключённые (reason). RBAC: владелец сессии/ADMIN.
|
|
45
149
|
app.get('/:id/mcp', kit.requireAuth, async (c) => {
|
|
46
150
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
@@ -53,7 +157,7 @@ requestSessionService) {
|
|
|
53
157
|
}
|
|
54
158
|
return c.json(await buildSessionMcpPayload(session));
|
|
55
159
|
});
|
|
56
|
-
// PUT /api/v2/sessions/:id/mcp — переключение MCP пользователем (
|
|
160
|
+
// PUT /api/v2/sessions/:id/mcp — переключение MCP пользователем (ADR-071 §2.4),
|
|
57
161
|
// включая opt-out системных серверов. RBAC: владелец сессии/ADMIN.
|
|
58
162
|
app.put('/:id/mcp', kit.requireAuth, async (c) => {
|
|
59
163
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
@@ -106,7 +210,7 @@ requestSessionService) {
|
|
|
106
210
|
eventBus.publish(session.id, 'session.updated', serializeSession(session, { agentRegistry }));
|
|
107
211
|
return c.json(await buildSessionMcpPayload(session));
|
|
108
212
|
});
|
|
109
|
-
// GET /api/v2/sessions/:id/secrets — карта обфускации LLM Gateway (
|
|
213
|
+
// GET /api/v2/sessions/:id/secrets — карта обфускации LLM Gateway (ADR-036).
|
|
110
214
|
// RBAC: только ADMIN/AUDITOR — сама карта является секретом.
|
|
111
215
|
app.get('/:id/secrets', kit.requirePermission('ADMIN', 'AUDITOR'), async (c) => {
|
|
112
216
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
@@ -115,23 +219,58 @@ requestSessionService) {
|
|
|
115
219
|
}
|
|
116
220
|
return c.json({ sessionId: session.id, secrets: session.obfuscationMap ?? {} });
|
|
117
221
|
});
|
|
222
|
+
// Единый prefix-guard ресурса сессий: вешается ПОСЛЕ `/:id/mcp` и `/:id/secrets`
|
|
223
|
+
// (у них собственные задокументированные правила) и покрывает отладку,
|
|
224
|
+
// оптимизацию, заметки, ЭКСПОРТ и все core-маршруты (core-фабрика
|
|
225
|
+
// регистрируется с registerAccessGuard:false — иначе был бы второй источник
|
|
226
|
+
// правил). `/import` пропускается через guard.skipForId (статический сегмент,
|
|
227
|
+
// не сессия).
|
|
228
|
+
app.use('/:id', kit.requireAuth, sessionAccessGuard);
|
|
229
|
+
app.use('/:id/*', kit.requireAuth, sessionAccessGuard);
|
|
118
230
|
// GET /api/v2/sessions/:id/export — полный экспорт сессии для переноса между
|
|
119
231
|
// мирами (publish/fork). Внутренний формат: объект Session (camelCase) из
|
|
120
232
|
// SessionManager — история сообщений, todos, настройки, заметки, ссылки,
|
|
121
233
|
// чекпоинты, план-флаг и карта обфускации. Не публичный DTO.
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
234
|
+
//
|
|
235
|
+
// ВАЖНО (инвариант 16): маршрут зарегистрирован ПОСЛЕ prefix-guard'а —
|
|
236
|
+
// доступ к сессии (404/403) решает ЕДИНЫЙ guard (`sessionAccessGuard`), и
|
|
237
|
+
// второй копии правила в обработчике быть не должно: иначе правила
|
|
238
|
+
// расходятся (было: ложный 403 у `LEAD`, «правило в двух местах»).
|
|
239
|
+
//
|
|
240
|
+
// ПРАВИЛО ОТВЕТА (security-фикс 0.11.3): экспорт переносит СЕКРЕТЫ — карту
|
|
241
|
+
// обфускации LLM Gateway (`obfuscationMap`: плейсхолдер → РЕАЛЬНЫЙ секрет) и
|
|
242
|
+
// реальные значения плейсхолдеров в `metadata.secrets` (ADR-036). Ответ
|
|
243
|
+
// зависит от отдельной привилегии, которую решает route-level guard
|
|
244
|
+
// (`sessionExportGuard`), а не обработчик:
|
|
245
|
+
//
|
|
246
|
+
// - **владелец сессии** (`ownerId ?? userId` === текущий пользователь),
|
|
247
|
+
// **ADMIN**, **AUDITOR** → полный экспорт с картой: это его собственные
|
|
248
|
+
// секреты (ADMIN/AUDITOR — тот же набор привилегий, что у `GET /:id/secrets`);
|
|
249
|
+
// - **прочие читатели сессии** (участник проекта VIEWER/EDITOR, владелец
|
|
250
|
+
// проекта, который не владеет сессией, LEAD) → 200, но ответ **очищен**:
|
|
251
|
+
// без `obfuscationMap` и без `metadata.secrets`. Переносится разговор,
|
|
252
|
+
// который этот пользователь и так видит в UI, — но не чужие секреты (смысл
|
|
253
|
+
// «выгрузки секретов» не теряется, а publish/fork не ломается: форк чужой
|
|
254
|
+
// сессии в проекте остаётся рабочим);
|
|
255
|
+
// - **нет доступа на чтение** (посторонний) → 403 FORBIDDEN (prefix-guard).
|
|
256
|
+
//
|
|
257
|
+
// Очистка — на КОПИИ: сохранённая сессия не мутируется. Формат ответа не
|
|
258
|
+
// меняется (тот же объект Session), очищенный экспорт остаётся валидным
|
|
259
|
+
// payload'ом переноса — импорт его принимает.
|
|
260
|
+
app.get('/:id/export', kit.requireAuth, exportRateLimit, sessionExportGuard, async (c) => {
|
|
261
|
+
const decision = getSessionExportDecision(c);
|
|
262
|
+
if (!decision) {
|
|
263
|
+
// Fail-closed: guard не отработал — отдаём полный экспорт нельзя.
|
|
264
|
+
return c.json({ error: { code: 'INTERNAL_ERROR', message: 'Не удалось подготовить экспорт сессии' } }, 500);
|
|
126
265
|
}
|
|
127
|
-
return c.json(session);
|
|
266
|
+
return c.json(decision.withSecrets ? decision.session : stripSessionSecrets(decision.session));
|
|
128
267
|
});
|
|
129
268
|
// POST /api/v2/sessions/import — создать сессию из экспорта другой сессии
|
|
130
269
|
// (перенос истории между мирами). Тело: объект экспорта + import.project_id
|
|
131
270
|
// (целевой проект; если не задан — берётся из экспорта). LLM не запускается.
|
|
132
|
-
//
|
|
271
|
+
// ADR-089: это materialization-операция (создание-как-факт переноса истории),
|
|
133
272
|
// а не request — идёт прямым `createSession`, минуя funnel `session.requested`.
|
|
134
|
-
app.post('/import', kit.requireAuth, async (c) => {
|
|
273
|
+
app.post('/import', kit.requireAuth, importRateLimit, async (c) => {
|
|
135
274
|
const user = (await kit.getCurrentUser(c));
|
|
136
275
|
const body = await c.req.json().catch(() => ({}));
|
|
137
276
|
const targetProjectId = body.import?.project_id
|
|
@@ -147,12 +286,24 @@ requestSessionService) {
|
|
|
147
286
|
if (!existing) {
|
|
148
287
|
return c.json({ error: { code: 'PROJECT_NOT_FOUND', message: 'Проект не найден' } }, 400);
|
|
149
288
|
}
|
|
289
|
+
// Безопасность: импорт привязывает сессию к проекту и выдаёт агенту его
|
|
290
|
+
// workspace — без проверки доступа к проекту получается IDOR (чтение/запись
|
|
291
|
+
// файлов чужого проекта).
|
|
292
|
+
//
|
|
293
|
+
// Импорт сессии В ПРОЕКТ — это ЗАПИСЬ в проект (инвариант 21: read-уровень
|
|
294
|
+
// доступа не расширяет права на изменение), поэтому нужен уровень
|
|
295
|
+
// «редактирование контента проекта» (`canEditProjectContent`: owner /
|
|
296
|
+
// EDITOR / LEAD / ADMIN) — тот же, что у импорта проекта целиком
|
|
297
|
+
// (`core/server/routes/project-portable.ts`, `deps.canEdit`). Участник с
|
|
298
|
+
// ролью VIEWER получает 403.
|
|
299
|
+
if (!canEditProjectContent(c, existing, user.id)) {
|
|
300
|
+
return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
|
|
301
|
+
}
|
|
150
302
|
}
|
|
151
|
-
//
|
|
303
|
+
// ADR-089: materialization (перенос истории), не request — прямой createSession.
|
|
152
304
|
const session = await sessionManager.createSession({
|
|
153
305
|
title: typeof body.title === 'string' ? body.title : undefined,
|
|
154
306
|
projectId: targetProjectId,
|
|
155
|
-
engine: typeof body.engine === 'string' ? body.engine : undefined,
|
|
156
307
|
sessionOrigin: (body.session_origin ?? body.sessionOrigin),
|
|
157
308
|
settings: (body.settings ?? {}),
|
|
158
309
|
userId: user.id,
|
|
@@ -206,12 +357,14 @@ requestSessionService) {
|
|
|
206
357
|
return c.json(serializeSession(session, { agentRegistry }), 201);
|
|
207
358
|
});
|
|
208
359
|
// POST /api/v2/sessions/:id/debug-system-message — отправить отладочное системное сообщение
|
|
360
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
209
361
|
app.post('/:id/debug-system-message', kit.requireAuth, async (c) => {
|
|
210
362
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
211
363
|
if (!session) {
|
|
212
364
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
213
365
|
}
|
|
214
366
|
const user = (await kit.getCurrentUser(c));
|
|
367
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
215
368
|
const streamId = generateStreamId();
|
|
216
369
|
const sysMsg = {
|
|
217
370
|
id: streamId,
|
|
@@ -234,11 +387,13 @@ requestSessionService) {
|
|
|
234
387
|
return c.json({ status: 'enqueued', stream_id: streamId });
|
|
235
388
|
});
|
|
236
389
|
// GET /api/v2/sessions/:id/optimization — настройки оптимизации
|
|
390
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
237
391
|
app.get('/:id/optimization', kit.requireAuth, async (c) => {
|
|
238
392
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
239
393
|
if (!session) {
|
|
240
394
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
241
395
|
}
|
|
396
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
242
397
|
return c.json({
|
|
243
398
|
context_optimization: session.settings.contextOptimization,
|
|
244
399
|
sliding_window_mode: session.settings.slidingWindowMode,
|
|
@@ -253,7 +408,13 @@ requestSessionService) {
|
|
|
253
408
|
});
|
|
254
409
|
});
|
|
255
410
|
// PATCH /api/v2/sessions/:id/optimization — обновить настройки
|
|
411
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
256
412
|
app.patch('/:id/optimization', kit.requireAuth, async (c) => {
|
|
413
|
+
const session = await sessionManager.getSession(c.req.param('id'));
|
|
414
|
+
if (!session) {
|
|
415
|
+
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
416
|
+
}
|
|
417
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
257
418
|
const body = await c.req.json().catch(() => ({}));
|
|
258
419
|
await sessionManager.withLock(c.req.param('id'), async (s) => {
|
|
259
420
|
if (body.context_optimization !== undefined)
|
|
@@ -282,11 +443,13 @@ requestSessionService) {
|
|
|
282
443
|
return c.json(serializeSession(updated, { agentRegistry }));
|
|
283
444
|
});
|
|
284
445
|
// POST /api/v2/sessions/:id/optimization/check — проверить триггеры
|
|
446
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
285
447
|
app.post('/:id/optimization/check', kit.requireAuth, async (c) => {
|
|
286
448
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
287
449
|
if (!session) {
|
|
288
450
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
289
451
|
}
|
|
452
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
290
453
|
if (!contextOptimizer) {
|
|
291
454
|
return c.json({ sliding_window: { triggered: false }, summarization: { triggered: false } });
|
|
292
455
|
}
|
|
@@ -299,11 +462,13 @@ requestSessionService) {
|
|
|
299
462
|
});
|
|
300
463
|
});
|
|
301
464
|
// POST /api/v2/sessions/:id/optimization/cancel-summarization — отменить ожидающую суммаризацию
|
|
465
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
302
466
|
app.post('/:id/optimization/cancel-summarization', kit.requireAuth, async (c) => {
|
|
303
467
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
304
468
|
if (!session) {
|
|
305
469
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
306
470
|
}
|
|
471
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
307
472
|
await sessionManager.withLock(session.id, async (s) => {
|
|
308
473
|
s.summarizationPending = false;
|
|
309
474
|
await sessionManager.saveSession(s);
|
|
@@ -321,15 +486,23 @@ requestSessionService) {
|
|
|
321
486
|
});
|
|
322
487
|
// ===== Sticky Notes =====
|
|
323
488
|
// GET /api/v2/sessions/:id/notes — список заметок
|
|
489
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
324
490
|
app.get('/:id/notes', kit.requireAuth, async (c) => {
|
|
325
491
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
326
492
|
if (!session) {
|
|
327
493
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
328
494
|
}
|
|
495
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
329
496
|
return c.json({ notes: session.stickyNotes });
|
|
330
497
|
});
|
|
331
498
|
// POST /api/v2/sessions/:id/notes — создать заметку
|
|
499
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
332
500
|
app.post('/:id/notes', kit.requireAuth, async (c) => {
|
|
501
|
+
const session = await sessionManager.getSession(c.req.param('id'));
|
|
502
|
+
if (!session) {
|
|
503
|
+
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
504
|
+
}
|
|
505
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
333
506
|
const body = await c.req.json().catch(() => ({}));
|
|
334
507
|
if (!body.content?.trim()) {
|
|
335
508
|
return c.json({ error: { code: 'VALIDATION_ERROR', message: 'Content is required' } }, 400);
|
|
@@ -351,7 +524,13 @@ requestSessionService) {
|
|
|
351
524
|
return c.json({ note, notes: updated.stickyNotes }, 201);
|
|
352
525
|
});
|
|
353
526
|
// PATCH /api/v2/sessions/:id/notes/:noteId — обновить заметку
|
|
527
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
354
528
|
app.patch('/:id/notes/:noteId', kit.requireAuth, async (c) => {
|
|
529
|
+
const session = await sessionManager.getSession(c.req.param('id'));
|
|
530
|
+
if (!session) {
|
|
531
|
+
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
532
|
+
}
|
|
533
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
355
534
|
const body = await c.req.json().catch(() => ({}));
|
|
356
535
|
const noteId = c.req.param('noteId');
|
|
357
536
|
await sessionManager.withLock(c.req.param('id'), async (s) => {
|
|
@@ -370,7 +549,13 @@ requestSessionService) {
|
|
|
370
549
|
return c.json({ notes: updated.stickyNotes });
|
|
371
550
|
});
|
|
372
551
|
// DELETE /api/v2/sessions/:id/notes/:noteId — удалить заметку
|
|
552
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
373
553
|
app.delete('/:id/notes/:noteId', kit.requireAuth, async (c) => {
|
|
554
|
+
const session = await sessionManager.getSession(c.req.param('id'));
|
|
555
|
+
if (!session) {
|
|
556
|
+
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
557
|
+
}
|
|
558
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
374
559
|
const noteId = c.req.param('noteId');
|
|
375
560
|
await sessionManager.withLock(c.req.param('id'), async (s) => {
|
|
376
561
|
s.stickyNotes = s.stickyNotes.filter((n) => n.id !== noteId);
|
|
@@ -382,34 +567,29 @@ requestSessionService) {
|
|
|
382
567
|
});
|
|
383
568
|
// Общая логика — в core-фабрике (backend-специфика выше). Регистрируем её
|
|
384
569
|
// последней: статические/backend-only сегменты должны матчиться раньше.
|
|
385
|
-
app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService }, {
|
|
570
|
+
app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService, analytics }, {
|
|
386
571
|
resolveUserId: async (c) => (await kit.getCurrentUser(c)).id,
|
|
387
572
|
resolveOwner: async (c) => (await kit.getCurrentUser(c)).id,
|
|
388
573
|
forkWithOwner: true,
|
|
389
|
-
|
|
390
|
-
//
|
|
391
|
-
//
|
|
574
|
+
// Доступ к сессии обеспечивает единый prefix-guard ресурса (см. выше):
|
|
575
|
+
// `registerAccessGuard: false` отключает собственный guard core-фабрики,
|
|
576
|
+
// чтобы не появился второй источник правил.
|
|
577
|
+
registerAccessGuard: false,
|
|
578
|
+
// ADR-089: сквозной обзор сессий для ADMIN/LEAD (`GET /` — список всех).
|
|
579
|
+
// Вызовы `kit.isAdmin`/`hasRole` защищены `typeof` — у мок-AuthKit в тестах
|
|
580
|
+
// они могут отсутствовать.
|
|
392
581
|
resolveElevated: (c) => {
|
|
393
582
|
const isAdmin = typeof kit.isAdmin === 'function' && kit.isAdmin(c);
|
|
394
583
|
const isLead = typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD');
|
|
395
584
|
return isAdmin || isLead;
|
|
396
585
|
},
|
|
397
|
-
//
|
|
586
|
+
// ADR-089: проекты-участия пользователя — проектные сессии видны участникам.
|
|
398
587
|
resolveMemberProjectIds: async (_c, userId) => {
|
|
399
588
|
if (!projectStore)
|
|
400
589
|
return [];
|
|
401
590
|
const projects = await projectStore.list(userId);
|
|
402
591
|
return projects.map((p) => p.id);
|
|
403
592
|
},
|
|
404
|
-
// AD-089: доступ по id — участник проекта сессии (owner/член), не только владелец.
|
|
405
|
-
resolveCanAccessExtra: async (session, _c, userId) => {
|
|
406
|
-
if (!projectStore || !session.projectId)
|
|
407
|
-
return false;
|
|
408
|
-
const project = await projectStore.load(session.projectId);
|
|
409
|
-
if (!project)
|
|
410
|
-
return false;
|
|
411
|
-
return project.ownerId === userId || userId in (project.members ?? {});
|
|
412
|
-
},
|
|
413
593
|
resolveAuthor: async (c) => (await kit.getCurrentUser(c)).username,
|
|
414
594
|
promptMessageId: 'stream',
|
|
415
595
|
publishRenamed: false,
|
|
@@ -418,11 +598,31 @@ requestSessionService) {
|
|
|
418
598
|
onSessionDeleted: (userId, sessionId) => { eventHub.unsubscribeFromSession(userId, sessionId); },
|
|
419
599
|
onSessionForked: (userId, sessionId) => { void eventHub.subscribeToSession(userId, sessionId).catch((e) => console.warn('subscribeToSession failed:', e)); },
|
|
420
600
|
promptMiddleware: [createRateLimiter(30, 60_000)],
|
|
601
|
+
forkMiddleware: [forkRateLimit],
|
|
602
|
+
mergeMiddleware: [mergeRateLimit],
|
|
421
603
|
enableSessionEvents: false,
|
|
422
604
|
resolveDefaultAgent,
|
|
423
|
-
//
|
|
605
|
+
// ADR-036: право видеть РЕАЛЬНЫЕ значения секретов (плейсхолдер → значение)
|
|
606
|
+
// в обычном чтении сессии (`GET /sessions/:id`, `GET /sessions/:id/messages`,
|
|
607
|
+
// список сессий): владелец сессии + `ADMIN`/`AUDITOR` — тот же набор
|
|
608
|
+
// привилегий, что у `GET /:id/secrets` и у полного экспорта сессии
|
|
609
|
+
// (`createSessionExportGuard`). Остальным читателям (участник проекта
|
|
610
|
+
// VIEWER/EDITOR, владелец проекта, LEAD без владения) значения
|
|
611
|
+
// вычищаются из ответа — ключи-плейсхолдеры остаются.
|
|
612
|
+
canRevealSecrets: async (c, session) => {
|
|
613
|
+
const user = await kit.getCurrentUser(c);
|
|
614
|
+
if (!user)
|
|
615
|
+
return false;
|
|
616
|
+
const ctx = c;
|
|
617
|
+
if (typeof kit.isAdmin === 'function' && kit.isAdmin(ctx))
|
|
618
|
+
return true;
|
|
619
|
+
if (typeof kit.hasRole === 'function' && kit.hasRole(ctx, 'AUDITOR'))
|
|
620
|
+
return true;
|
|
621
|
+
return (session.ownerId ?? session.userId) === user.id;
|
|
622
|
+
},
|
|
623
|
+
// ADR-052 (этап I): scope-гейт и проектная проекция service-key (i18n-403).
|
|
424
624
|
scopeGuard,
|
|
425
|
-
|
|
625
|
+
serviceProjectProjection,
|
|
426
626
|
messages: {
|
|
427
627
|
sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
|
|
428
628
|
forbidden: (c) => t('auth.forbidden', undefined, c),
|
package/dist/routes/users.js
CHANGED
|
@@ -28,7 +28,7 @@ export function createUserRoutes(kit, profiles) {
|
|
|
28
28
|
});
|
|
29
29
|
});
|
|
30
30
|
// GET /api/v2/users/:id — детали пользователя (ADMIN или scope `users:read`).
|
|
31
|
-
//
|
|
31
|
+
// ADR-089/O1: отдаёт `identities` профиля (snake_case) — нужно аддонам для
|
|
32
32
|
// адресации внешних идентичностей машинной кредой.
|
|
33
33
|
app.get('/:id', requireAdminOrScope('users:read'), async (c) => {
|
|
34
34
|
const id = c.req.param('id');
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Надёжное закрытие локального HTTP(S)-сервера в тестах.
|
|
3
|
+
*
|
|
4
|
+
* `server.close()` ждёт, пока завершатся все живые соединения. Keep-alive-сокет
|
|
5
|
+
* (его держит, например, undici-агент) сам по себе не заканчивается — `close()`
|
|
6
|
+
* не вызывает callback, и хук `afterAll` виснет до таймаута vitest
|
|
7
|
+
* («Hook timed out in 10000ms»). Поэтому закрытие идёт в три шага:
|
|
8
|
+
*
|
|
9
|
+
* 1. `closeAllConnections()` — все живые соединения сервера;
|
|
10
|
+
* 2. `server.close()` — с ограничением по времени: зависший сокет не должен
|
|
11
|
+
* блокировать suite (таймер всегда снимается).
|
|
12
|
+
*
|
|
13
|
+
* Дубль хелпера из `@itphx/synth-core` (`src/test-helpers/close-server.ts`):
|
|
14
|
+
* пакеты не зависят друг от друга на уровне внутренних модулей, а
|
|
15
|
+
* `@itphx/synth-core` не экспортирует тестовые хелперы в публичный API.
|
|
16
|
+
*/
|
|
17
|
+
/** Минимальный контракт сервера, который умеет закрыться. */
|
|
18
|
+
export interface CloseableServer {
|
|
19
|
+
close(callback: () => void): unknown;
|
|
20
|
+
}
|
|
21
|
+
export interface CloseServerOptions {
|
|
22
|
+
/** Максимальное ожидание закрытия, мс (по умолчанию 1000). */
|
|
23
|
+
timeoutMs?: number;
|
|
24
|
+
}
|
|
25
|
+
/** Таймаут ожидания закрытия по умолчанию, мс. */
|
|
26
|
+
export declare const DEFAULT_CLOSE_TIMEOUT_MS = 1000;
|
|
27
|
+
/**
|
|
28
|
+
* Закрывает сервер так, чтобы `close()` не мог зависнуть.
|
|
29
|
+
*
|
|
30
|
+
* Ошибка закрытия игнорируется: сервер уже не слушает — это не повод ронять
|
|
31
|
+
* тест. Единственный важный инвариант — функция **всегда** завершается.
|
|
32
|
+
*/
|
|
33
|
+
export declare function closeTestServer(server: CloseableServer, options?: CloseServerOptions): Promise<void>;
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Надёжное закрытие локального HTTP(S)-сервера в тестах.
|
|
3
|
+
*
|
|
4
|
+
* `server.close()` ждёт, пока завершатся все живые соединения. Keep-alive-сокет
|
|
5
|
+
* (его держит, например, undici-агент) сам по себе не заканчивается — `close()`
|
|
6
|
+
* не вызывает callback, и хук `afterAll` виснет до таймаута vitest
|
|
7
|
+
* («Hook timed out in 10000ms»). Поэтому закрытие идёт в три шага:
|
|
8
|
+
*
|
|
9
|
+
* 1. `closeAllConnections()` — все живые соединения сервера;
|
|
10
|
+
* 2. `server.close()` — с ограничением по времени: зависший сокет не должен
|
|
11
|
+
* блокировать suite (таймер всегда снимается).
|
|
12
|
+
*
|
|
13
|
+
* Дубль хелпера из `@itphx/synth-core` (`src/test-helpers/close-server.ts`):
|
|
14
|
+
* пакеты не зависят друг от друга на уровне внутренних модулей, а
|
|
15
|
+
* `@itphx/synth-core` не экспортирует тестовые хелперы в публичный API.
|
|
16
|
+
*/
|
|
17
|
+
/** Таймаут ожидания закрытия по умолчанию, мс. */
|
|
18
|
+
export const DEFAULT_CLOSE_TIMEOUT_MS = 1_000;
|
|
19
|
+
/**
|
|
20
|
+
* Закрывает сервер так, чтобы `close()` не мог зависнуть.
|
|
21
|
+
*
|
|
22
|
+
* Ошибка закрытия игнорируется: сервер уже не слушает — это не повод ронять
|
|
23
|
+
* тест. Единственный важный инвариант — функция **всегда** завершается.
|
|
24
|
+
*/
|
|
25
|
+
export async function closeTestServer(server, options = {}) {
|
|
26
|
+
const timeoutMs = options.timeoutMs ?? DEFAULT_CLOSE_TIMEOUT_MS;
|
|
27
|
+
// Тот же приём, что в остальных тестах репозитория: метод есть не во всех
|
|
28
|
+
// версиях Node и не во всех типах — вызываем опционально через каст.
|
|
29
|
+
server.closeAllConnections?.();
|
|
30
|
+
let timer;
|
|
31
|
+
try {
|
|
32
|
+
await Promise.race([
|
|
33
|
+
new Promise((resolve) => {
|
|
34
|
+
try {
|
|
35
|
+
server.close(() => resolve());
|
|
36
|
+
}
|
|
37
|
+
catch {
|
|
38
|
+
resolve();
|
|
39
|
+
}
|
|
40
|
+
}),
|
|
41
|
+
new Promise((resolve) => {
|
|
42
|
+
timer = setTimeout(resolve, timeoutMs);
|
|
43
|
+
}),
|
|
44
|
+
]);
|
|
45
|
+
}
|
|
46
|
+
finally {
|
|
47
|
+
if (timer !== undefined)
|
|
48
|
+
clearTimeout(timer);
|
|
49
|
+
}
|
|
50
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@itphx/synth-backend",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.11.3",
|
|
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": "^1.18.0",
|
|
11
|
-
"@itphx/synth-core": "0.
|
|
12
|
-
"@itphx/synth-shared": "0.
|
|
11
|
+
"@itphx/synth-core": "0.11.3",
|
|
12
|
+
"@itphx/synth-shared": "0.11.3",
|
|
13
13
|
"hono": "^4.9.0",
|
|
14
14
|
"hono-rate-limiter": "^0.5.3",
|
|
15
15
|
"jose": "^6.2.3",
|