@itphx/synth-backend 0.10.1 → 0.12.4
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 +2 -2
- package/dist/app/deps.d.ts +77 -33
- package/dist/app/deps.js +969 -102
- package/dist/app/listen.d.ts +13 -2
- package/dist/app/listen.js +138 -10
- package/dist/app/mount-routes.d.ts +16 -3
- package/dist/app/mount-routes.js +625 -32
- package/dist/app.d.ts +42 -7
- package/dist/app.js +149 -12
- package/dist/auth/guards.d.ts +17 -1
- package/dist/auth/guards.js +46 -2
- package/dist/auth/middleware.d.ts +2 -12
- package/dist/auth/middleware.js +20 -2
- package/dist/auth/oidc.d.ts +7 -0
- package/dist/auth/oidc.js +27 -6
- package/dist/auth/plugin-scope.d.ts +10 -0
- package/dist/auth/plugin-scope.js +69 -0
- package/dist/auth/service-scope.d.ts +7 -3
- package/dist/auth/service-scope.js +8 -4
- 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/defaults-store.d.ts +2 -25
- package/dist/lib/defaults-store.js +5 -87
- package/dist/lib/i18n.js +153 -0
- package/dist/main.js +67 -4
- package/dist/routes/agents.d.ts +12 -3
- package/dist/routes/agents.js +14 -2
- package/dist/routes/auth.d.ts +12 -2
- package/dist/routes/auth.js +16 -2
- package/dist/routes/context.d.ts +2 -2
- package/dist/routes/gateway-patterns.d.ts +2 -2
- package/dist/routes/llm.d.ts +8 -2
- package/dist/routes/llm.js +6 -3
- package/dist/routes/mcp-registry.d.ts +15 -3
- package/dist/routes/mcp-registry.js +122 -21
- package/dist/routes/messages.d.ts +7 -4
- package/dist/routes/messages.js +34 -3
- package/dist/routes/models.d.ts +7 -2
- package/dist/routes/models.js +3 -1
- package/dist/routes/processes.d.ts +34 -0
- package/dist/routes/processes.js +26 -0
- package/dist/routes/projects.d.ts +9 -3
- package/dist/routes/projects.js +8 -1
- package/dist/routes/providers.d.ts +15 -3
- package/dist/routes/providers.js +33 -21
- package/dist/routes/queue.d.ts +5 -4
- package/dist/routes/queue.js +30 -3
- package/dist/routes/sessions.d.ts +50 -3
- package/dist/routes/sessions.js +221 -74
- package/dist/test-helpers/close-server.d.ts +33 -0
- package/dist/test-helpers/close-server.js +50 -0
- package/package.json +4 -4
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,
|
|
4
|
+
import { scopeGuard, serviceProjectProjection } from '../auth/service-scope.js';
|
|
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 { 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). */
|
|
@@ -24,31 +32,127 @@ resolveDefaultAgent,
|
|
|
24
32
|
* ADR-089: единый funnel создания сессий (прокидывается в core-фабрику).
|
|
25
33
|
* Не задан — core-фабрика использует прямой `SessionManager.createSession`.
|
|
26
34
|
*/
|
|
27
|
-
requestSessionService
|
|
35
|
+
requestSessionService,
|
|
36
|
+
/** ADR-102: сборщик `activity` (меры `aborts`/`messages_*`) для core-фабрики. */
|
|
37
|
+
analytics,
|
|
38
|
+
/** ADR-107: агрегаты памяти сессии для `GET /:id/memory` (вкладка «Память»). */
|
|
39
|
+
memory,
|
|
40
|
+
/**
|
|
41
|
+
* Этап 1 roadmap 0.13 (блок 3): сервис «вопрос пользователю» (`ask_user`).
|
|
42
|
+
*
|
|
43
|
+
* Не задан — маршруты вопросов отвечают 503 (подсистема не подключена).
|
|
44
|
+
*/
|
|
45
|
+
questionService,
|
|
46
|
+
/**
|
|
47
|
+
* ADR-114: сервис worktree'ов — привязка сессии к worktree
|
|
48
|
+
* (`PATCH /api/v2/sessions/:id { worktreeId }`).
|
|
49
|
+
*
|
|
50
|
+
* Не задан — поле `worktreeId` в PATCH игнорируется (привязка недоступна).
|
|
51
|
+
*/
|
|
52
|
+
worktreeService,
|
|
53
|
+
/**
|
|
54
|
+
* ADR-115: вложения сообщений — blob-порт, учёт ссылок и лимиты
|
|
55
|
+
* (прокидывается в core-фабрику: загрузка/раздача + `attachments` в промпте).
|
|
56
|
+
*/
|
|
57
|
+
attachments) {
|
|
28
58
|
const app = new Hono();
|
|
29
59
|
const agentRegistry = orchestrator.agentRegistry;
|
|
60
|
+
const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
|
|
30
61
|
// ADR-071 §2.4: владелец сессии — обычный пользователь, управляющий её MCP-скоупом.
|
|
31
62
|
const isSessionOwner = (session, userId) => (session.ownerId ?? session.userId) === userId;
|
|
32
63
|
/**
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
*
|
|
38
|
-
* чужой сессии (защита от перебора id; ранее здесь была IDOR-уязвимость).
|
|
64
|
+
* Rate limit на тяжёлые/неинтерактивные операции ресурса сессий (import/export/
|
|
65
|
+
* fork/merge): 10 запросов / 60 с на креду — тот же in-memory `createRateLimiter`,
|
|
66
|
+
* что у `POST /:id/prompt` (30/60) и `schedules/:id/run` (10/60). Значение ниже
|
|
67
|
+
* prompt: операции не частые в живом UI, но дорогие (полный объект сессии,
|
|
68
|
+
* создание форка, копирование сообщений) — защита от всплесков/выкачивания.
|
|
39
69
|
*/
|
|
40
|
-
const
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
70
|
+
const importRateLimit = createRateLimiter(10, 60_000);
|
|
71
|
+
const exportRateLimit = createRateLimiter(10, 60_000);
|
|
72
|
+
const forkRateLimit = createRateLimiter(10, 60_000);
|
|
73
|
+
const mergeRateLimit = createRateLimiter(10, 60_000);
|
|
74
|
+
/**
|
|
75
|
+
* Единое правило доступа к сессии (читать/писать) — ОДНА точка на весь ресурс
|
|
76
|
+
* `/api/v2/sessions`, включая backend-only маршруты (export/debug/optimization/
|
|
77
|
+
* notes) и core-маршруты. Правило:
|
|
78
|
+
* - elevated (ADMIN/LEAD) → всё (осознанное решение: мутации чужих сессий
|
|
79
|
+
* у LEAD/ADMIN сохранены как есть);
|
|
80
|
+
* - владелец сессии или сессия без владельца → всё;
|
|
81
|
+
* - иначе — роль в проекте: чтение (`GET`/`HEAD`) — проектное чтение
|
|
82
|
+
* (`canReadProject`: owner проекта или любой участник), мутация — проектное
|
|
83
|
+
* редактирование (`canEditProjectContent`: owner/EDITOR).
|
|
84
|
+
* Разделение read/write делает prefix-guard по HTTP-методу (единая точка).
|
|
85
|
+
*/
|
|
86
|
+
const sessionAccessPredicate = createSessionAccessPredicate({
|
|
87
|
+
canAccess: (session, c, userId) => {
|
|
88
|
+
const owner = session.ownerId ?? session.userId;
|
|
89
|
+
return !owner || owner === userId
|
|
90
|
+
|| (typeof kit.isAdmin === 'function' && kit.isAdmin(c));
|
|
91
|
+
},
|
|
92
|
+
resolveCanAccessExtra: async (session, c, userId, access) => {
|
|
93
|
+
if (!projectStore || !session.projectId)
|
|
94
|
+
return false;
|
|
95
|
+
const project = await projectStore.load(session.projectId);
|
|
96
|
+
if (!project)
|
|
97
|
+
return false;
|
|
98
|
+
const ctx = c;
|
|
99
|
+
return access === 'read'
|
|
100
|
+
? canReadProject(ctx, project, userId)
|
|
101
|
+
: canEditProjectContent(ctx, project, userId);
|
|
102
|
+
},
|
|
103
|
+
localUserId: 'local',
|
|
104
|
+
});
|
|
105
|
+
/**
|
|
106
|
+
* `GET /:id/export` — единственный `:id`-маршрут, где роль аудита инстанса
|
|
107
|
+
* (`AUDITOR`) является **читателем** сессии: карта обфускации ЛЮБОЙ сессии ему
|
|
108
|
+
* и так доступна (`GET /:id/secrets` — `ADMIN`/`AUDITOR`), поэтому экспорт
|
|
109
|
+
* сессии для него не привилегия сверх того, что у него уже есть. На остальных
|
|
110
|
+
* `:id`-маршрутах правило доступа не меняется (см. матрицу
|
|
111
|
+
* `session-idor-matrix.test.ts`).
|
|
112
|
+
*/
|
|
113
|
+
const isSessionExportRequest = (c) => c.req.method === 'GET' && isSessionExportPath(c.req.path);
|
|
114
|
+
const sessionAccessGuard = createSessionAccessGuard({
|
|
115
|
+
param: 'id',
|
|
116
|
+
resolveSession: (id) => sessionManager.getSession(id),
|
|
117
|
+
resolveUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
|
|
118
|
+
isAllowed: async (session, c, userId, access) => {
|
|
119
|
+
// Мок-AuthKit в тестах может не иметь isAdmin/hasRole — защищаем typeof.
|
|
120
|
+
const isAdmin = typeof kit.isAdmin === 'function' && kit.isAdmin(c);
|
|
121
|
+
const isLead = typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD');
|
|
122
|
+
if (isAdmin || isLead)
|
|
123
|
+
return true;
|
|
124
|
+
// Роль аудита инстанса — читатель сессии на маршруте экспорта (см. выше).
|
|
125
|
+
if (access === 'read' && isSessionExportRequest(c)) {
|
|
126
|
+
const isAuditor = typeof kit.hasRole === 'function' && kit.hasRole(c, 'AUDITOR');
|
|
127
|
+
if (isAuditor)
|
|
128
|
+
return true;
|
|
129
|
+
}
|
|
130
|
+
return sessionAccessPredicate(session, c, userId, access);
|
|
131
|
+
},
|
|
132
|
+
messages: {
|
|
133
|
+
sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
|
|
134
|
+
forbidden: (c) => t('auth.forbidden', undefined, c),
|
|
135
|
+
},
|
|
136
|
+
// `/import` — статический сегмент (не id сессии).
|
|
137
|
+
skipForId: (id) => id === 'import',
|
|
138
|
+
});
|
|
139
|
+
/**
|
|
140
|
+
* Привилегия карты обфускации при экспорте сессии (ADR-036, security-фикс
|
|
141
|
+
* 0.11.3) — отдельный route-level guard: он резолвит сессию, решает «полный
|
|
142
|
+
* экспорт или очищенный» и кладёт решение в контекст Hono. Обработчик
|
|
143
|
+
* `/export` только форматирует ответ по этому решению — копии правила доступа
|
|
144
|
+
* в обработчике нет (инвариант 16).
|
|
145
|
+
*/
|
|
146
|
+
const sessionExportGuard = createSessionExportGuard({
|
|
147
|
+
param: 'id',
|
|
148
|
+
resolveSession: (id) => sessionManager.getSession(id),
|
|
149
|
+
resolveUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
|
|
150
|
+
isAdmin: (c) => typeof kit.isAdmin === 'function' && kit.isAdmin(c),
|
|
151
|
+
isAuditor: (c) => typeof kit.hasRole === 'function' && kit.hasRole(c, 'AUDITOR'),
|
|
152
|
+
messages: {
|
|
153
|
+
sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
|
|
154
|
+
},
|
|
155
|
+
});
|
|
52
156
|
/** ADR-071 §2.4: эффективный MCP-скоуп сессии (включая отключённые с причиной). */
|
|
53
157
|
const buildSessionMcpPayload = async (session) => {
|
|
54
158
|
const servers = await orchestrator.resolveMcpServers(session);
|
|
@@ -135,27 +239,58 @@ requestSessionService) {
|
|
|
135
239
|
}
|
|
136
240
|
return c.json({ sessionId: session.id, secrets: session.obfuscationMap ?? {} });
|
|
137
241
|
});
|
|
242
|
+
// Единый prefix-guard ресурса сессий: вешается ПОСЛЕ `/:id/mcp` и `/:id/secrets`
|
|
243
|
+
// (у них собственные задокументированные правила) и покрывает отладку,
|
|
244
|
+
// оптимизацию, заметки, ЭКСПОРТ и все core-маршруты (core-фабрика
|
|
245
|
+
// регистрируется с registerAccessGuard:false — иначе был бы второй источник
|
|
246
|
+
// правил). `/import` пропускается через guard.skipForId (статический сегмент,
|
|
247
|
+
// не сессия).
|
|
248
|
+
app.use('/:id', kit.requireAuth, sessionAccessGuard);
|
|
249
|
+
app.use('/:id/*', kit.requireAuth, sessionAccessGuard);
|
|
138
250
|
// GET /api/v2/sessions/:id/export — полный экспорт сессии для переноса между
|
|
139
251
|
// мирами (publish/fork). Внутренний формат: объект Session (camelCase) из
|
|
140
252
|
// SessionManager — история сообщений, todos, настройки, заметки, ссылки,
|
|
141
253
|
// чекпоинты, план-флаг и карта обфускации. Не публичный DTO.
|
|
142
|
-
//
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
254
|
+
//
|
|
255
|
+
// ВАЖНО (инвариант 16): маршрут зарегистрирован ПОСЛЕ prefix-guard'а —
|
|
256
|
+
// доступ к сессии (404/403) решает ЕДИНЫЙ guard (`sessionAccessGuard`), и
|
|
257
|
+
// второй копии правила в обработчике быть не должно: иначе правила
|
|
258
|
+
// расходятся (было: ложный 403 у `LEAD`, «правило в двух местах»).
|
|
259
|
+
//
|
|
260
|
+
// ПРАВИЛО ОТВЕТА (security-фикс 0.11.3): экспорт переносит СЕКРЕТЫ — карту
|
|
261
|
+
// обфускации LLM Gateway (`obfuscationMap`: плейсхолдер → РЕАЛЬНЫЙ секрет) и
|
|
262
|
+
// реальные значения плейсхолдеров в `metadata.secrets` (ADR-036). Ответ
|
|
263
|
+
// зависит от отдельной привилегии, которую решает route-level guard
|
|
264
|
+
// (`sessionExportGuard`), а не обработчик:
|
|
265
|
+
//
|
|
266
|
+
// - **владелец сессии** (`ownerId ?? userId` === текущий пользователь),
|
|
267
|
+
// **ADMIN**, **AUDITOR** → полный экспорт с картой: это его собственные
|
|
268
|
+
// секреты (ADMIN/AUDITOR — тот же набор привилегий, что у `GET /:id/secrets`);
|
|
269
|
+
// - **прочие читатели сессии** (участник проекта VIEWER/EDITOR, владелец
|
|
270
|
+
// проекта, который не владеет сессией, LEAD) → 200, но ответ **очищен**:
|
|
271
|
+
// без `obfuscationMap` и без `metadata.secrets`. Переносится разговор,
|
|
272
|
+
// который этот пользователь и так видит в UI, — но не чужие секреты (смысл
|
|
273
|
+
// «выгрузки секретов» не теряется, а publish/fork не ломается: форк чужой
|
|
274
|
+
// сессии в проекте остаётся рабочим);
|
|
275
|
+
// - **нет доступа на чтение** (посторонний) → 403 FORBIDDEN (prefix-guard).
|
|
276
|
+
//
|
|
277
|
+
// Очистка — на КОПИИ: сохранённая сессия не мутируется. Формат ответа не
|
|
278
|
+
// меняется (тот же объект Session), очищенный экспорт остаётся валидным
|
|
279
|
+
// payload'ом переноса — импорт его принимает.
|
|
280
|
+
app.get('/:id/export', kit.requireAuth, exportRateLimit, sessionExportGuard, async (c) => {
|
|
281
|
+
const decision = getSessionExportDecision(c);
|
|
282
|
+
if (!decision) {
|
|
283
|
+
// Fail-closed: guard не отработал — отдаём полный экспорт нельзя.
|
|
284
|
+
return c.json({ error: { code: 'INTERNAL_ERROR', message: 'Не удалось подготовить экспорт сессии' } }, 500);
|
|
147
285
|
}
|
|
148
|
-
|
|
149
|
-
if (denied)
|
|
150
|
-
return denied;
|
|
151
|
-
return c.json(session);
|
|
286
|
+
return c.json(decision.withSecrets ? decision.session : stripSessionSecrets(decision.session));
|
|
152
287
|
});
|
|
153
288
|
// POST /api/v2/sessions/import — создать сессию из экспорта другой сессии
|
|
154
289
|
// (перенос истории между мирами). Тело: объект экспорта + import.project_id
|
|
155
290
|
// (целевой проект; если не задан — берётся из экспорта). LLM не запускается.
|
|
156
291
|
// ADR-089: это materialization-операция (создание-как-факт переноса истории),
|
|
157
292
|
// а не request — идёт прямым `createSession`, минуя funnel `session.requested`.
|
|
158
|
-
app.post('/import', kit.requireAuth, async (c) => {
|
|
293
|
+
app.post('/import', kit.requireAuth, importRateLimit, async (c) => {
|
|
159
294
|
const user = (await kit.getCurrentUser(c));
|
|
160
295
|
const body = await c.req.json().catch(() => ({}));
|
|
161
296
|
const targetProjectId = body.import?.project_id
|
|
@@ -171,12 +306,24 @@ requestSessionService) {
|
|
|
171
306
|
if (!existing) {
|
|
172
307
|
return c.json({ error: { code: 'PROJECT_NOT_FOUND', message: 'Проект не найден' } }, 400);
|
|
173
308
|
}
|
|
309
|
+
// Безопасность: импорт привязывает сессию к проекту и выдаёт агенту его
|
|
310
|
+
// workspace — без проверки доступа к проекту получается IDOR (чтение/запись
|
|
311
|
+
// файлов чужого проекта).
|
|
312
|
+
//
|
|
313
|
+
// Импорт сессии В ПРОЕКТ — это ЗАПИСЬ в проект (инвариант 21: read-уровень
|
|
314
|
+
// доступа не расширяет права на изменение), поэтому нужен уровень
|
|
315
|
+
// «редактирование контента проекта» (`canEditProjectContent`: owner /
|
|
316
|
+
// EDITOR / LEAD / ADMIN) — тот же, что у импорта проекта целиком
|
|
317
|
+
// (`core/server/routes/project-portable.ts`, `deps.canEdit`). Участник с
|
|
318
|
+
// ролью VIEWER получает 403.
|
|
319
|
+
if (!canEditProjectContent(c, existing, user.id)) {
|
|
320
|
+
return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
|
|
321
|
+
}
|
|
174
322
|
}
|
|
175
323
|
// ADR-089: materialization (перенос истории), не request — прямой createSession.
|
|
176
324
|
const session = await sessionManager.createSession({
|
|
177
325
|
title: typeof body.title === 'string' ? body.title : undefined,
|
|
178
326
|
projectId: targetProjectId,
|
|
179
|
-
engine: typeof body.engine === 'string' ? body.engine : undefined,
|
|
180
327
|
sessionOrigin: (body.session_origin ?? body.sessionOrigin),
|
|
181
328
|
settings: (body.settings ?? {}),
|
|
182
329
|
userId: user.id,
|
|
@@ -237,9 +384,7 @@ requestSessionService) {
|
|
|
237
384
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
238
385
|
}
|
|
239
386
|
const user = (await kit.getCurrentUser(c));
|
|
240
|
-
|
|
241
|
-
if (denied)
|
|
242
|
-
return denied;
|
|
387
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
243
388
|
const streamId = generateStreamId();
|
|
244
389
|
const sysMsg = {
|
|
245
390
|
id: streamId,
|
|
@@ -255,7 +400,9 @@ requestSessionService) {
|
|
|
255
400
|
author: user.username,
|
|
256
401
|
metadata: { type: 'debug_system_message', reason: 'manual', stream_id: streamId },
|
|
257
402
|
};
|
|
258
|
-
|
|
403
|
+
// ADR-106 Ф4: принципал инициатора (ввод от пользователя, не системный ход).
|
|
404
|
+
const turnPrincipal = resolveUserPrincipal(user.id);
|
|
405
|
+
const result = await enqueueUserMessage(sessionManager, eventBus, session.id, sysMsg, queueManager, processMessage, undefined, turnPrincipal ? { principal: turnPrincipal } : undefined);
|
|
259
406
|
if (!result) {
|
|
260
407
|
return c.json({ error: { code: 'QUEUE_FULL', message: 'Queue is full' } }, 429);
|
|
261
408
|
}
|
|
@@ -268,9 +415,7 @@ requestSessionService) {
|
|
|
268
415
|
if (!session) {
|
|
269
416
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
270
417
|
}
|
|
271
|
-
|
|
272
|
-
if (denied)
|
|
273
|
-
return denied;
|
|
418
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
274
419
|
return c.json({
|
|
275
420
|
context_optimization: session.settings.contextOptimization,
|
|
276
421
|
sliding_window_mode: session.settings.slidingWindowMode,
|
|
@@ -291,9 +436,7 @@ requestSessionService) {
|
|
|
291
436
|
if (!session) {
|
|
292
437
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
293
438
|
}
|
|
294
|
-
|
|
295
|
-
if (denied)
|
|
296
|
-
return denied;
|
|
439
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
297
440
|
const body = await c.req.json().catch(() => ({}));
|
|
298
441
|
await sessionManager.withLock(c.req.param('id'), async (s) => {
|
|
299
442
|
if (body.context_optimization !== undefined)
|
|
@@ -328,9 +471,7 @@ requestSessionService) {
|
|
|
328
471
|
if (!session) {
|
|
329
472
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
330
473
|
}
|
|
331
|
-
|
|
332
|
-
if (denied)
|
|
333
|
-
return denied;
|
|
474
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
334
475
|
if (!contextOptimizer) {
|
|
335
476
|
return c.json({ sliding_window: { triggered: false }, summarization: { triggered: false } });
|
|
336
477
|
}
|
|
@@ -349,9 +490,7 @@ requestSessionService) {
|
|
|
349
490
|
if (!session) {
|
|
350
491
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
351
492
|
}
|
|
352
|
-
|
|
353
|
-
if (denied)
|
|
354
|
-
return denied;
|
|
493
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
355
494
|
await sessionManager.withLock(session.id, async (s) => {
|
|
356
495
|
s.summarizationPending = false;
|
|
357
496
|
await sessionManager.saveSession(s);
|
|
@@ -375,9 +514,7 @@ requestSessionService) {
|
|
|
375
514
|
if (!session) {
|
|
376
515
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
377
516
|
}
|
|
378
|
-
|
|
379
|
-
if (denied)
|
|
380
|
-
return denied;
|
|
517
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
381
518
|
return c.json({ notes: session.stickyNotes });
|
|
382
519
|
});
|
|
383
520
|
// POST /api/v2/sessions/:id/notes — создать заметку
|
|
@@ -387,9 +524,7 @@ requestSessionService) {
|
|
|
387
524
|
if (!session) {
|
|
388
525
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
389
526
|
}
|
|
390
|
-
|
|
391
|
-
if (denied)
|
|
392
|
-
return denied;
|
|
527
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
393
528
|
const body = await c.req.json().catch(() => ({}));
|
|
394
529
|
if (!body.content?.trim()) {
|
|
395
530
|
return c.json({ error: { code: 'VALIDATION_ERROR', message: 'Content is required' } }, 400);
|
|
@@ -417,9 +552,7 @@ requestSessionService) {
|
|
|
417
552
|
if (!session) {
|
|
418
553
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
419
554
|
}
|
|
420
|
-
|
|
421
|
-
if (denied)
|
|
422
|
-
return denied;
|
|
555
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
423
556
|
const body = await c.req.json().catch(() => ({}));
|
|
424
557
|
const noteId = c.req.param('noteId');
|
|
425
558
|
await sessionManager.withLock(c.req.param('id'), async (s) => {
|
|
@@ -444,9 +577,7 @@ requestSessionService) {
|
|
|
444
577
|
if (!session) {
|
|
445
578
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
446
579
|
}
|
|
447
|
-
|
|
448
|
-
if (denied)
|
|
449
|
-
return denied;
|
|
580
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
450
581
|
const noteId = c.req.param('noteId');
|
|
451
582
|
await sessionManager.withLock(c.req.param('id'), async (s) => {
|
|
452
583
|
s.stickyNotes = s.stickyNotes.filter((n) => n.id !== noteId);
|
|
@@ -458,13 +589,17 @@ requestSessionService) {
|
|
|
458
589
|
});
|
|
459
590
|
// Общая логика — в core-фабрике (backend-специфика выше). Регистрируем её
|
|
460
591
|
// последней: статические/backend-only сегменты должны матчиться раньше.
|
|
461
|
-
app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService }, {
|
|
592
|
+
app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService, analytics, ...(memory ? { memory } : {}), ...(questionService ? { questionService } : {}), ...(worktreeService ? { worktreeService } : {}), ...(attachments ? { attachments } : {}) }, {
|
|
462
593
|
resolveUserId: async (c) => (await kit.getCurrentUser(c)).id,
|
|
463
594
|
resolveOwner: async (c) => (await kit.getCurrentUser(c)).id,
|
|
464
595
|
forkWithOwner: true,
|
|
465
|
-
|
|
466
|
-
//
|
|
467
|
-
//
|
|
596
|
+
// Доступ к сессии обеспечивает единый prefix-guard ресурса (см. выше):
|
|
597
|
+
// `registerAccessGuard: false` отключает собственный guard core-фабрики,
|
|
598
|
+
// чтобы не появился второй источник правил.
|
|
599
|
+
registerAccessGuard: false,
|
|
600
|
+
// ADR-089: сквозной обзор сессий для ADMIN/LEAD (`GET /` — список всех).
|
|
601
|
+
// Вызовы `kit.isAdmin`/`hasRole` защищены `typeof` — у мок-AuthKit в тестах
|
|
602
|
+
// они могут отсутствовать.
|
|
468
603
|
resolveElevated: (c) => {
|
|
469
604
|
const isAdmin = typeof kit.isAdmin === 'function' && kit.isAdmin(c);
|
|
470
605
|
const isLead = typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD');
|
|
@@ -477,15 +612,6 @@ requestSessionService) {
|
|
|
477
612
|
const projects = await projectStore.list(userId);
|
|
478
613
|
return projects.map((p) => p.id);
|
|
479
614
|
},
|
|
480
|
-
// ADR-089: доступ по id — участник проекта сессии (owner/член), не только владелец.
|
|
481
|
-
resolveCanAccessExtra: async (session, _c, userId) => {
|
|
482
|
-
if (!projectStore || !session.projectId)
|
|
483
|
-
return false;
|
|
484
|
-
const project = await projectStore.load(session.projectId);
|
|
485
|
-
if (!project)
|
|
486
|
-
return false;
|
|
487
|
-
return project.ownerId === userId || userId in (project.members ?? {});
|
|
488
|
-
},
|
|
489
615
|
resolveAuthor: async (c) => (await kit.getCurrentUser(c)).username,
|
|
490
616
|
promptMessageId: 'stream',
|
|
491
617
|
publishRenamed: false,
|
|
@@ -494,16 +620,37 @@ requestSessionService) {
|
|
|
494
620
|
onSessionDeleted: (userId, sessionId) => { eventHub.unsubscribeFromSession(userId, sessionId); },
|
|
495
621
|
onSessionForked: (userId, sessionId) => { void eventHub.subscribeToSession(userId, sessionId).catch((e) => console.warn('subscribeToSession failed:', e)); },
|
|
496
622
|
promptMiddleware: [createRateLimiter(30, 60_000)],
|
|
623
|
+
forkMiddleware: [forkRateLimit],
|
|
624
|
+
mergeMiddleware: [mergeRateLimit],
|
|
497
625
|
enableSessionEvents: false,
|
|
498
626
|
resolveDefaultAgent,
|
|
627
|
+
// ADR-036: право видеть РЕАЛЬНЫЕ значения секретов (плейсхолдер → значение)
|
|
628
|
+
// в обычном чтении сессии (`GET /sessions/:id`, `GET /sessions/:id/messages`,
|
|
629
|
+
// список сессий): владелец сессии + `ADMIN`/`AUDITOR` — тот же набор
|
|
630
|
+
// привилегий, что у `GET /:id/secrets` и у полного экспорта сессии
|
|
631
|
+
// (`createSessionExportGuard`). Остальным читателям (участник проекта
|
|
632
|
+
// VIEWER/EDITOR, владелец проекта, LEAD без владения) значения
|
|
633
|
+
// вычищаются из ответа — ключи-плейсхолдеры остаются.
|
|
634
|
+
canRevealSecrets: async (c, session) => {
|
|
635
|
+
const user = await kit.getCurrentUser(c);
|
|
636
|
+
if (!user)
|
|
637
|
+
return false;
|
|
638
|
+
const ctx = c;
|
|
639
|
+
if (typeof kit.isAdmin === 'function' && kit.isAdmin(ctx))
|
|
640
|
+
return true;
|
|
641
|
+
if (typeof kit.hasRole === 'function' && kit.hasRole(ctx, 'AUDITOR'))
|
|
642
|
+
return true;
|
|
643
|
+
return (session.ownerId ?? session.userId) === user.id;
|
|
644
|
+
},
|
|
499
645
|
// ADR-052 (этап I): scope-гейт и проектная проекция service-key (i18n-403).
|
|
500
646
|
scopeGuard,
|
|
501
|
-
|
|
647
|
+
serviceProjectProjection,
|
|
502
648
|
messages: {
|
|
503
649
|
sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
|
|
504
650
|
forbidden: (c) => t('auth.forbidden', undefined, c),
|
|
505
651
|
contentRequired: (c) => t('errors.validation.contentRequired', undefined, c),
|
|
506
652
|
queueFull: (c, max) => t('errors.chat.queueFull', { max }, c),
|
|
653
|
+
steerLimitExceeded: (c, max) => t('errors.chat.steerLimitExceeded', { max }, c),
|
|
507
654
|
},
|
|
508
655
|
}));
|
|
509
656
|
return app;
|
|
@@ -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.12.4",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"files": [
|
|
@@ -8,14 +8,14 @@
|
|
|
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.12.4",
|
|
12
|
+
"@itphx/synth-shared": "0.12.4",
|
|
13
13
|
"hono": "^4.9.0",
|
|
14
14
|
"hono-rate-limiter": "^0.5.3",
|
|
15
15
|
"jose": "^6.2.3",
|
|
16
16
|
"js-yaml": "^4.1.1",
|
|
17
17
|
"ws": "^8.20.1",
|
|
18
|
-
"zod": "^
|
|
18
|
+
"zod": "^4.6.7"
|
|
19
19
|
},
|
|
20
20
|
"devDependencies": {
|
|
21
21
|
"@types/js-yaml": "^4.0.9",
|