@itphx/synth-backend 0.10.1 → 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 +2 -2
- package/dist/app/deps.d.ts +50 -32
- package/dist/app/deps.js +233 -99
- package/dist/app/listen.d.ts +7 -2
- package/dist/app/listen.js +12 -1
- package/dist/app/mount-routes.d.ts +16 -3
- package/dist/app/mount-routes.js +258 -28
- package/dist/app.d.ts +16 -7
- package/dist/app.js +104 -11
- package/dist/auth/guards.d.ts +2 -1
- package/dist/auth/guards.js +9 -1
- 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/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 +48 -0
- package/dist/main.js +19 -3
- package/dist/routes/agents.d.ts +2 -2
- package/dist/routes/auth.d.ts +2 -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 +4 -1
- package/dist/routes/mcp-registry.d.ts +3 -3
- package/dist/routes/mcp-registry.js +2 -2
- 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 +3 -3
- 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 +13 -3
- package/dist/routes/sessions.js +197 -73
- package/dist/test-helpers/close-server.d.ts +33 -0
- package/dist/test-helpers/close-server.js +50 -0
- package/package.json +3 -3
|
@@ -6,9 +6,10 @@ import type { QueueProcessorManager } from '@itphx/synth-core';
|
|
|
6
6
|
import type { ChatOrchestrator } from '@itphx/synth-core';
|
|
7
7
|
import type { ContextOptimizer } from '@itphx/synth-core';
|
|
8
8
|
import type { RequestSessionService } from '@itphx/synth-core';
|
|
9
|
+
import type { AnalyticsRecorder } from '@itphx/synth-core';
|
|
9
10
|
import type { ProfileStore } from '@itphx/synth-shared';
|
|
10
11
|
import type { EventHub } from '../events/hub.js';
|
|
11
|
-
import type {
|
|
12
|
+
import type { ProjectRepository } from '@itphx/synth-core';
|
|
12
13
|
/**
|
|
13
14
|
* Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
|
|
14
15
|
* backend-специфичные роуты (MCP-скоуп сессии, секреты, export/import, отладка,
|
|
@@ -19,8 +20,15 @@ import type { ProjectStore } from '@itphx/synth-core';
|
|
|
19
20
|
* RBAC: core-фабрика параметризуется `resolveUserId`/`resolveOwner`/`resolveAuthor`,
|
|
20
21
|
* `canAccess` (владелец|ADMIN) и EventHub-хуками; remote/hybrid-ветки отключены
|
|
21
22
|
* (getRemoteClient не передаётся). `GET /:id/events` на backend не регистрируется.
|
|
23
|
+
*
|
|
24
|
+
* Исключения из общего prefix-guard'а (собственные правила, роуты зарегистрированы
|
|
25
|
+
* до guard'а): `/:id/mcp` (владелец|ADMIN, ADR-071 §2.4) и `/:id/secrets`
|
|
26
|
+
* (ADMIN|AUDITOR — карта обфускации). `/:id/export` — ПОД guard'ом: доступ к
|
|
27
|
+
* сессии решает ЕДИНЫЙ prefix-guard, а привилегию карты обфускации — отдельный
|
|
28
|
+
* route-level guard (`createSessionExportGuard`, ADR-036); в обработчике проверок
|
|
29
|
+
* доступа нет (инвариант 16).
|
|
22
30
|
*/
|
|
23
|
-
export declare function createSessionRoutes(kit: AuthKit, sessionManager: SessionManager, eventBus: EventBus, queueManager: QueueProcessorManager, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, orchestrator: ChatOrchestrator, eventHub: EventHub, contextOptimizer?: ContextOptimizer, projectStore?:
|
|
31
|
+
export declare function createSessionRoutes(kit: AuthKit, sessionManager: SessionManager, eventBus: EventBus, queueManager: QueueProcessorManager, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, orchestrator: ChatOrchestrator, eventHub: EventHub, contextOptimizer?: ContextOptimizer, projectStore?: ProjectRepository,
|
|
24
32
|
/** Профили пользователей: display name для статистики (fallback — username). */
|
|
25
33
|
profilesStore?: ProfileStore,
|
|
26
34
|
/** Агент по умолчанию для новых сессий без `settings.agentRole` (runtime-настройка). */
|
|
@@ -29,4 +37,6 @@ resolveDefaultAgent?: () => string | Promise<string>,
|
|
|
29
37
|
* ADR-089: единый funnel создания сессий (прокидывается в core-фабрику).
|
|
30
38
|
* Не задан — core-фабрика использует прямой `SessionManager.createSession`.
|
|
31
39
|
*/
|
|
32
|
-
requestSessionService?: RequestSessionService
|
|
40
|
+
requestSessionService?: RequestSessionService,
|
|
41
|
+
/** PROP-102: сборщик `activity` (меры `aborts`/`messages_*`) для core-фабрики. */
|
|
42
|
+
analytics?: AnalyticsRecorder): Hono;
|
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, } 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,107 @@ resolveDefaultAgent,
|
|
|
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;
|
|
40
|
+
const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
|
|
30
41
|
// ADR-071 §2.4: владелец сессии — обычный пользователь, управляющий её MCP-скоупом.
|
|
31
42
|
const isSessionOwner = (session, userId) => (session.ownerId ?? session.userId) === userId;
|
|
32
43
|
/**
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
*
|
|
38
|
-
* чужой сессии (защита от перебора id; ранее здесь была IDOR-уязвимость).
|
|
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
|
+
* создание форка, копирование сообщений) — защита от всплесков/выкачивания.
|
|
39
49
|
*/
|
|
40
|
-
const
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
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
|
+
});
|
|
52
136
|
/** ADR-071 §2.4: эффективный MCP-скоуп сессии (включая отключённые с причиной). */
|
|
53
137
|
const buildSessionMcpPayload = async (session) => {
|
|
54
138
|
const servers = await orchestrator.resolveMcpServers(session);
|
|
@@ -135,27 +219,58 @@ requestSessionService) {
|
|
|
135
219
|
}
|
|
136
220
|
return c.json({ sessionId: session.id, secrets: session.obfuscationMap ?? {} });
|
|
137
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);
|
|
138
230
|
// GET /api/v2/sessions/:id/export — полный экспорт сессии для переноса между
|
|
139
231
|
// мирами (publish/fork). Внутренний формат: объект Session (camelCase) из
|
|
140
232
|
// SessionManager — история сообщений, todos, настройки, заметки, ссылки,
|
|
141
233
|
// чекпоинты, план-флаг и карта обфускации. Не публичный DTO.
|
|
142
|
-
//
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
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);
|
|
147
265
|
}
|
|
148
|
-
|
|
149
|
-
if (denied)
|
|
150
|
-
return denied;
|
|
151
|
-
return c.json(session);
|
|
266
|
+
return c.json(decision.withSecrets ? decision.session : stripSessionSecrets(decision.session));
|
|
152
267
|
});
|
|
153
268
|
// POST /api/v2/sessions/import — создать сессию из экспорта другой сессии
|
|
154
269
|
// (перенос истории между мирами). Тело: объект экспорта + import.project_id
|
|
155
270
|
// (целевой проект; если не задан — берётся из экспорта). LLM не запускается.
|
|
156
271
|
// ADR-089: это materialization-операция (создание-как-факт переноса истории),
|
|
157
272
|
// а не request — идёт прямым `createSession`, минуя funnel `session.requested`.
|
|
158
|
-
app.post('/import', kit.requireAuth, async (c) => {
|
|
273
|
+
app.post('/import', kit.requireAuth, importRateLimit, async (c) => {
|
|
159
274
|
const user = (await kit.getCurrentUser(c));
|
|
160
275
|
const body = await c.req.json().catch(() => ({}));
|
|
161
276
|
const targetProjectId = body.import?.project_id
|
|
@@ -171,12 +286,24 @@ requestSessionService) {
|
|
|
171
286
|
if (!existing) {
|
|
172
287
|
return c.json({ error: { code: 'PROJECT_NOT_FOUND', message: 'Проект не найден' } }, 400);
|
|
173
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
|
+
}
|
|
174
302
|
}
|
|
175
303
|
// ADR-089: materialization (перенос истории), не request — прямой createSession.
|
|
176
304
|
const session = await sessionManager.createSession({
|
|
177
305
|
title: typeof body.title === 'string' ? body.title : undefined,
|
|
178
306
|
projectId: targetProjectId,
|
|
179
|
-
engine: typeof body.engine === 'string' ? body.engine : undefined,
|
|
180
307
|
sessionOrigin: (body.session_origin ?? body.sessionOrigin),
|
|
181
308
|
settings: (body.settings ?? {}),
|
|
182
309
|
userId: user.id,
|
|
@@ -237,9 +364,7 @@ requestSessionService) {
|
|
|
237
364
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
238
365
|
}
|
|
239
366
|
const user = (await kit.getCurrentUser(c));
|
|
240
|
-
|
|
241
|
-
if (denied)
|
|
242
|
-
return denied;
|
|
367
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
243
368
|
const streamId = generateStreamId();
|
|
244
369
|
const sysMsg = {
|
|
245
370
|
id: streamId,
|
|
@@ -268,9 +393,7 @@ requestSessionService) {
|
|
|
268
393
|
if (!session) {
|
|
269
394
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
270
395
|
}
|
|
271
|
-
|
|
272
|
-
if (denied)
|
|
273
|
-
return denied;
|
|
396
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
274
397
|
return c.json({
|
|
275
398
|
context_optimization: session.settings.contextOptimization,
|
|
276
399
|
sliding_window_mode: session.settings.slidingWindowMode,
|
|
@@ -291,9 +414,7 @@ requestSessionService) {
|
|
|
291
414
|
if (!session) {
|
|
292
415
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
293
416
|
}
|
|
294
|
-
|
|
295
|
-
if (denied)
|
|
296
|
-
return denied;
|
|
417
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
297
418
|
const body = await c.req.json().catch(() => ({}));
|
|
298
419
|
await sessionManager.withLock(c.req.param('id'), async (s) => {
|
|
299
420
|
if (body.context_optimization !== undefined)
|
|
@@ -328,9 +449,7 @@ requestSessionService) {
|
|
|
328
449
|
if (!session) {
|
|
329
450
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
330
451
|
}
|
|
331
|
-
|
|
332
|
-
if (denied)
|
|
333
|
-
return denied;
|
|
452
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
334
453
|
if (!contextOptimizer) {
|
|
335
454
|
return c.json({ sliding_window: { triggered: false }, summarization: { triggered: false } });
|
|
336
455
|
}
|
|
@@ -349,9 +468,7 @@ requestSessionService) {
|
|
|
349
468
|
if (!session) {
|
|
350
469
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
351
470
|
}
|
|
352
|
-
|
|
353
|
-
if (denied)
|
|
354
|
-
return denied;
|
|
471
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
355
472
|
await sessionManager.withLock(session.id, async (s) => {
|
|
356
473
|
s.summarizationPending = false;
|
|
357
474
|
await sessionManager.saveSession(s);
|
|
@@ -375,9 +492,7 @@ requestSessionService) {
|
|
|
375
492
|
if (!session) {
|
|
376
493
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
377
494
|
}
|
|
378
|
-
|
|
379
|
-
if (denied)
|
|
380
|
-
return denied;
|
|
495
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
381
496
|
return c.json({ notes: session.stickyNotes });
|
|
382
497
|
});
|
|
383
498
|
// POST /api/v2/sessions/:id/notes — создать заметку
|
|
@@ -387,9 +502,7 @@ requestSessionService) {
|
|
|
387
502
|
if (!session) {
|
|
388
503
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
389
504
|
}
|
|
390
|
-
|
|
391
|
-
if (denied)
|
|
392
|
-
return denied;
|
|
505
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
393
506
|
const body = await c.req.json().catch(() => ({}));
|
|
394
507
|
if (!body.content?.trim()) {
|
|
395
508
|
return c.json({ error: { code: 'VALIDATION_ERROR', message: 'Content is required' } }, 400);
|
|
@@ -417,9 +530,7 @@ requestSessionService) {
|
|
|
417
530
|
if (!session) {
|
|
418
531
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
419
532
|
}
|
|
420
|
-
|
|
421
|
-
if (denied)
|
|
422
|
-
return denied;
|
|
533
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
423
534
|
const body = await c.req.json().catch(() => ({}));
|
|
424
535
|
const noteId = c.req.param('noteId');
|
|
425
536
|
await sessionManager.withLock(c.req.param('id'), async (s) => {
|
|
@@ -444,9 +555,7 @@ requestSessionService) {
|
|
|
444
555
|
if (!session) {
|
|
445
556
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
446
557
|
}
|
|
447
|
-
|
|
448
|
-
if (denied)
|
|
449
|
-
return denied;
|
|
558
|
+
// Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
|
|
450
559
|
const noteId = c.req.param('noteId');
|
|
451
560
|
await sessionManager.withLock(c.req.param('id'), async (s) => {
|
|
452
561
|
s.stickyNotes = s.stickyNotes.filter((n) => n.id !== noteId);
|
|
@@ -458,13 +567,17 @@ requestSessionService) {
|
|
|
458
567
|
});
|
|
459
568
|
// Общая логика — в core-фабрике (backend-специфика выше). Регистрируем её
|
|
460
569
|
// последней: статические/backend-only сегменты должны матчиться раньше.
|
|
461
|
-
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 }, {
|
|
462
571
|
resolveUserId: async (c) => (await kit.getCurrentUser(c)).id,
|
|
463
572
|
resolveOwner: async (c) => (await kit.getCurrentUser(c)).id,
|
|
464
573
|
forkWithOwner: true,
|
|
465
|
-
|
|
466
|
-
//
|
|
467
|
-
//
|
|
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
|
+
// они могут отсутствовать.
|
|
468
581
|
resolveElevated: (c) => {
|
|
469
582
|
const isAdmin = typeof kit.isAdmin === 'function' && kit.isAdmin(c);
|
|
470
583
|
const isLead = typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD');
|
|
@@ -477,15 +590,6 @@ requestSessionService) {
|
|
|
477
590
|
const projects = await projectStore.list(userId);
|
|
478
591
|
return projects.map((p) => p.id);
|
|
479
592
|
},
|
|
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
593
|
resolveAuthor: async (c) => (await kit.getCurrentUser(c)).username,
|
|
490
594
|
promptMessageId: 'stream',
|
|
491
595
|
publishRenamed: false,
|
|
@@ -494,11 +598,31 @@ requestSessionService) {
|
|
|
494
598
|
onSessionDeleted: (userId, sessionId) => { eventHub.unsubscribeFromSession(userId, sessionId); },
|
|
495
599
|
onSessionForked: (userId, sessionId) => { void eventHub.subscribeToSession(userId, sessionId).catch((e) => console.warn('subscribeToSession failed:', e)); },
|
|
496
600
|
promptMiddleware: [createRateLimiter(30, 60_000)],
|
|
601
|
+
forkMiddleware: [forkRateLimit],
|
|
602
|
+
mergeMiddleware: [mergeRateLimit],
|
|
497
603
|
enableSessionEvents: false,
|
|
498
604
|
resolveDefaultAgent,
|
|
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
|
+
},
|
|
499
623
|
// ADR-052 (этап I): scope-гейт и проектная проекция service-key (i18n-403).
|
|
500
624
|
scopeGuard,
|
|
501
|
-
|
|
625
|
+
serviceProjectProjection,
|
|
502
626
|
messages: {
|
|
503
627
|
sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
|
|
504
628
|
forbidden: (c) => t('auth.forbidden', undefined, c),
|
|
@@ -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",
|