@itphx/synth-backend 0.10.0 → 0.10.1
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 +106 -0
- package/dist/app/deps.js +617 -0
- package/dist/app/listen.d.ts +29 -0
- package/dist/app/listen.js +298 -0
- package/dist/app/mount-routes.d.ts +18 -0
- package/dist/app/mount-routes.js +466 -0
- package/dist/app/sse-events.d.ts +15 -0
- package/dist/app/sse-events.js +83 -0
- package/dist/app.d.ts +15 -11
- package/dist/app.js +71 -1337
- package/dist/auth/guards.js +1 -1
- package/dist/auth/middleware.d.ts +7 -2
- package/dist/auth/middleware.js +18 -4
- package/dist/auth/oidc.d.ts +15 -0
- package/dist/auth/oidc.js +41 -3
- package/dist/auth/service-scope.d.ts +1 -1
- package/dist/auth/service-scope.js +1 -1
- package/dist/events/hub.d.ts +2 -2
- package/dist/lib/cors.d.ts +23 -0
- package/dist/lib/cors.js +24 -0
- package/dist/lib/i18n.js +10 -6
- package/dist/main.js +4 -4
- package/dist/middleware/rate-limiter.d.ts +4 -1
- package/dist/middleware/rate-limiter.js +4 -2
- package/dist/routes/audit.d.ts +1 -1
- package/dist/routes/audit.js +2 -2
- package/dist/routes/auth.js +28 -4
- package/dist/routes/gateway-patterns.d.ts +1 -1
- package/dist/routes/gateway-patterns.js +1 -1
- package/dist/routes/llm.js +5 -4
- package/dist/routes/mcp-registry.d.ts +3 -3
- package/dist/routes/mcp-registry.js +8 -8
- package/dist/routes/mcp.d.ts +1 -1
- package/dist/routes/mcp.js +1 -1
- package/dist/routes/projects.d.ts +4 -4
- package/dist/routes/projects.js +7 -7
- package/dist/routes/providers.js +1 -0
- package/dist/routes/sessions.d.ts +1 -1
- package/dist/routes/sessions.js +89 -13
- package/dist/routes/users.js +1 -1
- package/package.json +3 -3
|
@@ -4,7 +4,7 @@ import { evaluateMcpNetworkAccess, getServiceCredential } from '@itphx/synth-cor
|
|
|
4
4
|
import { sessionMcpScopeSchema, hasServiceScope } from '@itphx/synth-shared';
|
|
5
5
|
import { mcpServerConfigSchema } from '@itphx/synth-shared/config';
|
|
6
6
|
import { requireAdminOrScope, requireScopeForServiceKey } from '../auth/guards.js';
|
|
7
|
-
// Backend-only MCP-роуты (
|
|
7
|
+
// Backend-only MCP-роуты (ADR-071 §2.5): legacy `/servers*`, `/session/:id` и
|
|
8
8
|
// единый реестр `/registry*`. Probe (`POST /probe`) — общая логика core,
|
|
9
9
|
// монтируется в `routes/mcp.ts` ПЕРЕД этим роутером.
|
|
10
10
|
const addServerSchema = z.object({
|
|
@@ -12,7 +12,7 @@ const addServerSchema = z.object({
|
|
|
12
12
|
config: mcpServerConfigSchema,
|
|
13
13
|
});
|
|
14
14
|
const updateServerSchema = mcpServerConfigSchema;
|
|
15
|
-
//
|
|
15
|
+
// ADR-071 §2.5: единый реестр MCP-серверов.
|
|
16
16
|
const registryAddSchema = z.object({
|
|
17
17
|
name: z.string().min(1).max(200),
|
|
18
18
|
config: mcpServerConfigSchema,
|
|
@@ -48,7 +48,7 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
48
48
|
const isConnected = (name) => mcpManager?.getConfiguredServers().find((s) => s.name === name)?.connected ?? false;
|
|
49
49
|
const currentUser = (c) => c.get('user') ?? null;
|
|
50
50
|
/**
|
|
51
|
-
*
|
|
51
|
+
* ADR-052/O1: запрос от installer-service-key (scope `addons:install`).
|
|
52
52
|
* Даёт scoped-ключу без роли ADMIN создавать **instance**-записи реестра
|
|
53
53
|
* (общие для инстанса, а не персональные) и обновлять созданные им записи.
|
|
54
54
|
*/
|
|
@@ -57,7 +57,7 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
57
57
|
return !!cred && hasServiceScope(cred.scopes, 'addons:install');
|
|
58
58
|
};
|
|
59
59
|
const checkNetwork = async (config, origin) => {
|
|
60
|
-
//
|
|
60
|
+
// ADR-071 §2.3.1: политика — для пользовательских HTTP-серверов; instance
|
|
61
61
|
// (в т.ч. приватные сети инстанса) доверенные.
|
|
62
62
|
if (origin !== 'user' || config.type === 'stdio' || !config.url)
|
|
63
63
|
return null;
|
|
@@ -70,7 +70,7 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
70
70
|
return { code: 'NETWORK_POLICY_VIOLATION', message: result.reason ?? 'Адрес запрещён сетевой политикой' };
|
|
71
71
|
};
|
|
72
72
|
// ---------------------------------------------------------------------------
|
|
73
|
-
// Legacy `/servers*` — тонкие адаптеры над единым реестром (
|
|
73
|
+
// Legacy `/servers*` — тонкие адаптеры над единым реестром (ADR-071 §2.5).
|
|
74
74
|
// Второго хранилища (config.yaml) больше нет: источник истины — McpRegistryStore.
|
|
75
75
|
// ---------------------------------------------------------------------------
|
|
76
76
|
// --- Список настроенных серверов ---
|
|
@@ -260,14 +260,14 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
260
260
|
});
|
|
261
261
|
});
|
|
262
262
|
}
|
|
263
|
-
// --- Единый реестр MCP-серверов (
|
|
263
|
+
// --- Единый реестр MCP-серверов (ADR-071 §2.5) ---
|
|
264
264
|
// Список записей реестра (auth).
|
|
265
265
|
app.get('/registry', kit.requireAuth, async (c) => {
|
|
266
266
|
const entries = await registry.list();
|
|
267
267
|
return c.json({ entries });
|
|
268
268
|
});
|
|
269
269
|
// Добавить запись (auth): HTTP — любой пользователь, stdio — только ADMIN.
|
|
270
|
-
//
|
|
270
|
+
// ADR-052/O1: service-key должен нести scope `addons:install` (интерактив без
|
|
271
271
|
// изменений — HTTP добавляет любой, stdio-проверка ниже). Installer-ключ со
|
|
272
272
|
// scope создаёт instance-записи (общие для инстанса) без роли ADMIN.
|
|
273
273
|
app.post('/registry', kit.requireAuth, requireScopeForServiceKey('addons:install'), async (c) => {
|
|
@@ -278,7 +278,7 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
278
278
|
}
|
|
279
279
|
const { name, config, enabled, enabledByDefault, origin } = parsed.data;
|
|
280
280
|
const admin = kit.isAdmin(c);
|
|
281
|
-
//
|
|
281
|
+
// ADR-052/O1: installer-ключ (scope `addons:install`) создаёт instance-записи
|
|
282
282
|
// даже без роли ADMIN — это общие записи инстанса (а не персональные).
|
|
283
283
|
const isInstaller = isInstallerKey(c);
|
|
284
284
|
let entryOrigin;
|
package/dist/routes/mcp.d.ts
CHANGED
|
@@ -5,7 +5,7 @@ import type { McpRoutesOptions } from './mcp-registry.js';
|
|
|
5
5
|
export type { McpRoutesOptions } from './mcp-registry.js';
|
|
6
6
|
/**
|
|
7
7
|
* Backend MCP: probe (`POST /probe`) — общая логика core-фабрики; legacy
|
|
8
|
-
* `/servers*`, `/session/:id` и единый реестр `/registry*` (
|
|
8
|
+
* `/servers*`, `/session/:id` и единый реестр `/registry*` (ADR-071) —
|
|
9
9
|
* backend-only (см. `mcp-registry.ts`). Порядок монтирования: core probe
|
|
10
10
|
* первым, затем backend-only.
|
|
11
11
|
*/
|
package/dist/routes/mcp.js
CHANGED
|
@@ -3,7 +3,7 @@ import { createMcpRoutes as createCoreMcpRoutes } from '@itphx/synth-core';
|
|
|
3
3
|
import { createMcpRegistryRoutes } from './mcp-registry.js';
|
|
4
4
|
/**
|
|
5
5
|
* Backend MCP: probe (`POST /probe`) — общая логика core-фабрики; legacy
|
|
6
|
-
* `/servers*`, `/session/:id` и единый реестр `/registry*` (
|
|
6
|
+
* `/servers*`, `/session/:id` и единый реестр `/registry*` (ADR-071) —
|
|
7
7
|
* backend-only (см. `mcp-registry.ts`). Порядок монтирования: core probe
|
|
8
8
|
* первым, затем backend-only.
|
|
9
9
|
*/
|
|
@@ -3,7 +3,7 @@ import type { AuthKit } from '../auth/middleware.js';
|
|
|
3
3
|
import type { ProjectStore, SessionManager, McpManager, SkillService, RuntimeSettingsStore, McpRegistryStore } from '@itphx/synth-core';
|
|
4
4
|
import type { Project } from '@itphx/synth-shared';
|
|
5
5
|
/**
|
|
6
|
-
*
|
|
6
|
+
* ADR-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
|
|
7
7
|
* чтобы их переиспользовали git-роуты core-фабрики (`authorizeProject`), а логика
|
|
8
8
|
* ролей не дублировалась.
|
|
9
9
|
*/
|
|
@@ -21,11 +21,11 @@ export declare function createProjectAccess(kit: AuthKit): {
|
|
|
21
21
|
/**
|
|
22
22
|
* Backend-обёртка над core-фабрикой проектов: общая логика — в core, здесь только
|
|
23
23
|
* managed-специфика — RBAC (`createProjectAccess`), i18n-сообщения, авто-имя
|
|
24
|
-
* workspace (
|
|
24
|
+
* workspace (ADR-075, политика `deny` вне root), проектный MCP-скоуп (ADR-071 §2.4)
|
|
25
25
|
* и статистика сессий. Полная реализация — `@itphx/synth-core`.
|
|
26
26
|
*/
|
|
27
27
|
export declare function createProjectRoutes(kit: AuthKit, store: ProjectStore, sessionManager: SessionManager, workspacesRoot: string,
|
|
28
|
-
/**
|
|
28
|
+
/** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
|
|
29
29
|
mcpManager?: McpManager,
|
|
30
|
-
/**
|
|
30
|
+
/** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
|
|
31
31
|
skillService?: SkillService, settingsStore?: RuntimeSettingsStore, mcpRegistryStore?: McpRegistryStore): Hono;
|
package/dist/routes/projects.js
CHANGED
|
@@ -2,12 +2,12 @@ import { createProjectRoutes as createCoreProjectRoutes, resolveProjectSkillSeed
|
|
|
2
2
|
import { ProjectRole } from '@itphx/synth-shared';
|
|
3
3
|
import { t } from '../lib/i18n.js';
|
|
4
4
|
/**
|
|
5
|
-
*
|
|
5
|
+
* ADR-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
|
|
6
6
|
* чтобы их переиспользовали git-роуты core-фабрики (`authorizeProject`), а логика
|
|
7
7
|
* ролей не дублировалась.
|
|
8
8
|
*/
|
|
9
9
|
export function createProjectAccess(kit) {
|
|
10
|
-
/**
|
|
10
|
+
/** ADR-071 §2.4: owner проекта или глобальные LEAD/ADMIN (через AuthKit). */
|
|
11
11
|
const canManageProject = (c, project, userId) => (typeof kit.isAdmin === 'function' && kit.isAdmin(c))
|
|
12
12
|
|| (typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD'))
|
|
13
13
|
|| project.ownerId === userId
|
|
@@ -16,7 +16,7 @@ export function createProjectAccess(kit) {
|
|
|
16
16
|
const canEditProjectContent = (c, project, userId) => canManageProject(c, project, userId)
|
|
17
17
|
|| project.members?.[userId] === ProjectRole.EDITOR;
|
|
18
18
|
/**
|
|
19
|
-
*
|
|
19
|
+
* ADR-089: чтение проекта по id — owner / любой участник (любая роль, в т.ч.
|
|
20
20
|
* VIEWER) / глобальные LEAD/ADMIN. Не расширяет права на редактирование.
|
|
21
21
|
*/
|
|
22
22
|
const canReadProject = (c, project, userId) => canManageProject(c, project, userId)
|
|
@@ -26,20 +26,20 @@ export function createProjectAccess(kit) {
|
|
|
26
26
|
/**
|
|
27
27
|
* Backend-обёртка над core-фабрикой проектов: общая логика — в core, здесь только
|
|
28
28
|
* managed-специфика — RBAC (`createProjectAccess`), i18n-сообщения, авто-имя
|
|
29
|
-
* workspace (
|
|
29
|
+
* workspace (ADR-075, политика `deny` вне root), проектный MCP-скоуп (ADR-071 §2.4)
|
|
30
30
|
* и статистика сессий. Полная реализация — `@itphx/synth-core`.
|
|
31
31
|
*/
|
|
32
32
|
export function createProjectRoutes(kit, store, sessionManager, workspacesRoot,
|
|
33
|
-
/**
|
|
33
|
+
/** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
|
|
34
34
|
mcpManager,
|
|
35
|
-
/**
|
|
35
|
+
/** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
|
|
36
36
|
skillService, settingsStore, mcpRegistryStore) {
|
|
37
37
|
const { canManageProject, canEditProjectContent, canReadProject } = createProjectAccess(kit);
|
|
38
38
|
return createCoreProjectRoutes({ requireAuth: kit.requireAuth }, store, undefined, {
|
|
39
39
|
canManage: canManageProject,
|
|
40
40
|
canEditContent: canEditProjectContent,
|
|
41
41
|
canRead: canReadProject,
|
|
42
|
-
//
|
|
42
|
+
// ADR-089: ADMIN/LEAD — сквозная видимость всех проектов (защита от мок-AuthKit).
|
|
43
43
|
resolveElevated: (c) => (typeof kit.isAdmin === 'function' && kit.isAdmin(c))
|
|
44
44
|
|| (typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD')),
|
|
45
45
|
getCurrentUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
|
package/dist/routes/providers.js
CHANGED
|
@@ -108,6 +108,7 @@ export function createProviderRoutes(kit, store, providerCache) {
|
|
|
108
108
|
providerNotFound: (c) => t('errors.notFound.provider', undefined, c),
|
|
109
109
|
providerDisabled: (c) => t('errors.providerDisabled', undefined, c),
|
|
110
110
|
urlRequired: (c) => t('errors.validation.urlRequired', undefined, c),
|
|
111
|
+
urlInvalid: (c) => t('errors.validation.invalidUrl', undefined, c),
|
|
111
112
|
connectionError: (c) => t('errors.connectionError', undefined, c),
|
|
112
113
|
},
|
|
113
114
|
}));
|
|
@@ -26,7 +26,7 @@ profilesStore?: ProfileStore,
|
|
|
26
26
|
/** Агент по умолчанию для новых сессий без `settings.agentRole` (runtime-настройка). */
|
|
27
27
|
resolveDefaultAgent?: () => string | Promise<string>,
|
|
28
28
|
/**
|
|
29
|
-
*
|
|
29
|
+
* ADR-089: единый funnel создания сессий (прокидывается в core-фабрику).
|
|
30
30
|
* Не задан — core-фабрика использует прямой `SessionManager.createSession`.
|
|
31
31
|
*/
|
|
32
32
|
requestSessionService?: RequestSessionService): Hono;
|
package/dist/routes/sessions.js
CHANGED
|
@@ -2,7 +2,7 @@ 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
4
|
import { scopeGuard, projectGuard } from '../auth/service-scope.js';
|
|
5
|
-
import { enqueueUserMessage, serializeSession, createSessionRoutes as createCoreSessionRoutes, } from '@itphx/synth-core';
|
|
5
|
+
import { enqueueUserMessage, serializeSession, isSessionVisible, createSessionRoutes as createCoreSessionRoutes, } from '@itphx/synth-core';
|
|
6
6
|
import { t } from '../lib/i18n.js';
|
|
7
7
|
/**
|
|
8
8
|
* Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
|
|
@@ -21,15 +21,35 @@ profilesStore,
|
|
|
21
21
|
/** Агент по умолчанию для новых сессий без `settings.agentRole` (runtime-настройка). */
|
|
22
22
|
resolveDefaultAgent,
|
|
23
23
|
/**
|
|
24
|
-
*
|
|
24
|
+
* ADR-089: единый funnel создания сессий (прокидывается в core-фабрику).
|
|
25
25
|
* Не задан — core-фабрика использует прямой `SessionManager.createSession`.
|
|
26
26
|
*/
|
|
27
27
|
requestSessionService) {
|
|
28
28
|
const app = new Hono();
|
|
29
29
|
const agentRegistry = orchestrator.agentRegistry;
|
|
30
|
-
//
|
|
30
|
+
// ADR-071 §2.4: владелец сессии — обычный пользователь, управляющий её MCP-скоупом.
|
|
31
31
|
const isSessionOwner = (session, userId) => (session.ownerId ?? session.userId) === userId;
|
|
32
|
-
/**
|
|
32
|
+
/**
|
|
33
|
+
* ADR-089 / безопасность: доступ к сессии по id для backend-only роутов
|
|
34
|
+
* (export/notes/optimization/debug-system-message). Единое правило —
|
|
35
|
+
* `isSessionVisible` из core: elevated (ADMIN/LEAD) → всё; владелец → да;
|
|
36
|
+
* сессия без владельца → да; иначе сессия проекта видна её owner/участникам
|
|
37
|
+
* (`projectStore`). Нет доступа → 404 NOT_FOUND: не раскрываем существование
|
|
38
|
+
* чужой сессии (защита от перебора id; ранее здесь была IDOR-уязвимость).
|
|
39
|
+
*/
|
|
40
|
+
const sessionAccessDenied = async (c, session, currentUser) => {
|
|
41
|
+
const user = currentUser ?? (await kit.getCurrentUser(c));
|
|
42
|
+
// Вызовы `kit.isAdmin`/`hasRole` защищены `typeof` — у мок-AuthKit в тестах
|
|
43
|
+
// они могут отсутствовать (паритет с resolveElevated ниже).
|
|
44
|
+
const elevated = (typeof kit.isAdmin === 'function'
|
|
45
|
+
&& kit.isAdmin(c))
|
|
46
|
+
|| (typeof kit.hasRole === 'function'
|
|
47
|
+
&& kit.hasRole(c, 'LEAD'));
|
|
48
|
+
if (await isSessionVisible(session, projectStore, { userId: user.id, elevated }))
|
|
49
|
+
return null;
|
|
50
|
+
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
51
|
+
};
|
|
52
|
+
/** ADR-071 §2.4: эффективный MCP-скоуп сессии (включая отключённые с причиной). */
|
|
33
53
|
const buildSessionMcpPayload = async (session) => {
|
|
34
54
|
const servers = await orchestrator.resolveMcpServers(session);
|
|
35
55
|
return {
|
|
@@ -40,7 +60,7 @@ requestSessionService) {
|
|
|
40
60
|
mcpDisabledServers: session.settings.mcpDisabledServers ?? [],
|
|
41
61
|
};
|
|
42
62
|
};
|
|
43
|
-
// GET /api/v2/sessions/:id/mcp — эффективный MCP-скоуп (
|
|
63
|
+
// GET /api/v2/sessions/:id/mcp — эффективный MCP-скоуп (ADR-071 §2.4).
|
|
44
64
|
// Показывает все серверы, включая отключённые (reason). RBAC: владелец сессии/ADMIN.
|
|
45
65
|
app.get('/:id/mcp', kit.requireAuth, async (c) => {
|
|
46
66
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
@@ -53,7 +73,7 @@ requestSessionService) {
|
|
|
53
73
|
}
|
|
54
74
|
return c.json(await buildSessionMcpPayload(session));
|
|
55
75
|
});
|
|
56
|
-
// PUT /api/v2/sessions/:id/mcp — переключение MCP пользователем (
|
|
76
|
+
// PUT /api/v2/sessions/:id/mcp — переключение MCP пользователем (ADR-071 §2.4),
|
|
57
77
|
// включая opt-out системных серверов. RBAC: владелец сессии/ADMIN.
|
|
58
78
|
app.put('/:id/mcp', kit.requireAuth, async (c) => {
|
|
59
79
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
@@ -106,7 +126,7 @@ requestSessionService) {
|
|
|
106
126
|
eventBus.publish(session.id, 'session.updated', serializeSession(session, { agentRegistry }));
|
|
107
127
|
return c.json(await buildSessionMcpPayload(session));
|
|
108
128
|
});
|
|
109
|
-
// GET /api/v2/sessions/:id/secrets — карта обфускации LLM Gateway (
|
|
129
|
+
// GET /api/v2/sessions/:id/secrets — карта обфускации LLM Gateway (ADR-036).
|
|
110
130
|
// RBAC: только ADMIN/AUDITOR — сама карта является секретом.
|
|
111
131
|
app.get('/:id/secrets', kit.requirePermission('ADMIN', 'AUDITOR'), async (c) => {
|
|
112
132
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
@@ -119,17 +139,21 @@ requestSessionService) {
|
|
|
119
139
|
// мирами (publish/fork). Внутренний формат: объект Session (camelCase) из
|
|
120
140
|
// SessionManager — история сообщений, todos, настройки, заметки, ссылки,
|
|
121
141
|
// чекпоинты, план-флаг и карта обфускации. Не публичный DTO.
|
|
142
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
122
143
|
app.get('/:id/export', kit.requireAuth, async (c) => {
|
|
123
144
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
124
145
|
if (!session) {
|
|
125
146
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
126
147
|
}
|
|
148
|
+
const denied = await sessionAccessDenied(c, session);
|
|
149
|
+
if (denied)
|
|
150
|
+
return denied;
|
|
127
151
|
return c.json(session);
|
|
128
152
|
});
|
|
129
153
|
// POST /api/v2/sessions/import — создать сессию из экспорта другой сессии
|
|
130
154
|
// (перенос истории между мирами). Тело: объект экспорта + import.project_id
|
|
131
155
|
// (целевой проект; если не задан — берётся из экспорта). LLM не запускается.
|
|
132
|
-
//
|
|
156
|
+
// ADR-089: это materialization-операция (создание-как-факт переноса истории),
|
|
133
157
|
// а не request — идёт прямым `createSession`, минуя funnel `session.requested`.
|
|
134
158
|
app.post('/import', kit.requireAuth, async (c) => {
|
|
135
159
|
const user = (await kit.getCurrentUser(c));
|
|
@@ -148,7 +172,7 @@ requestSessionService) {
|
|
|
148
172
|
return c.json({ error: { code: 'PROJECT_NOT_FOUND', message: 'Проект не найден' } }, 400);
|
|
149
173
|
}
|
|
150
174
|
}
|
|
151
|
-
//
|
|
175
|
+
// ADR-089: materialization (перенос истории), не request — прямой createSession.
|
|
152
176
|
const session = await sessionManager.createSession({
|
|
153
177
|
title: typeof body.title === 'string' ? body.title : undefined,
|
|
154
178
|
projectId: targetProjectId,
|
|
@@ -206,12 +230,16 @@ requestSessionService) {
|
|
|
206
230
|
return c.json(serializeSession(session, { agentRegistry }), 201);
|
|
207
231
|
});
|
|
208
232
|
// POST /api/v2/sessions/:id/debug-system-message — отправить отладочное системное сообщение
|
|
233
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
209
234
|
app.post('/:id/debug-system-message', kit.requireAuth, async (c) => {
|
|
210
235
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
211
236
|
if (!session) {
|
|
212
237
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
213
238
|
}
|
|
214
239
|
const user = (await kit.getCurrentUser(c));
|
|
240
|
+
const denied = await sessionAccessDenied(c, session, user);
|
|
241
|
+
if (denied)
|
|
242
|
+
return denied;
|
|
215
243
|
const streamId = generateStreamId();
|
|
216
244
|
const sysMsg = {
|
|
217
245
|
id: streamId,
|
|
@@ -234,11 +262,15 @@ requestSessionService) {
|
|
|
234
262
|
return c.json({ status: 'enqueued', stream_id: streamId });
|
|
235
263
|
});
|
|
236
264
|
// GET /api/v2/sessions/:id/optimization — настройки оптимизации
|
|
265
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
237
266
|
app.get('/:id/optimization', kit.requireAuth, async (c) => {
|
|
238
267
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
239
268
|
if (!session) {
|
|
240
269
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
241
270
|
}
|
|
271
|
+
const denied = await sessionAccessDenied(c, session);
|
|
272
|
+
if (denied)
|
|
273
|
+
return denied;
|
|
242
274
|
return c.json({
|
|
243
275
|
context_optimization: session.settings.contextOptimization,
|
|
244
276
|
sliding_window_mode: session.settings.slidingWindowMode,
|
|
@@ -253,7 +285,15 @@ requestSessionService) {
|
|
|
253
285
|
});
|
|
254
286
|
});
|
|
255
287
|
// PATCH /api/v2/sessions/:id/optimization — обновить настройки
|
|
288
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
256
289
|
app.patch('/:id/optimization', kit.requireAuth, async (c) => {
|
|
290
|
+
const session = await sessionManager.getSession(c.req.param('id'));
|
|
291
|
+
if (!session) {
|
|
292
|
+
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
293
|
+
}
|
|
294
|
+
const denied = await sessionAccessDenied(c, session);
|
|
295
|
+
if (denied)
|
|
296
|
+
return denied;
|
|
257
297
|
const body = await c.req.json().catch(() => ({}));
|
|
258
298
|
await sessionManager.withLock(c.req.param('id'), async (s) => {
|
|
259
299
|
if (body.context_optimization !== undefined)
|
|
@@ -282,11 +322,15 @@ requestSessionService) {
|
|
|
282
322
|
return c.json(serializeSession(updated, { agentRegistry }));
|
|
283
323
|
});
|
|
284
324
|
// POST /api/v2/sessions/:id/optimization/check — проверить триггеры
|
|
325
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
285
326
|
app.post('/:id/optimization/check', kit.requireAuth, async (c) => {
|
|
286
327
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
287
328
|
if (!session) {
|
|
288
329
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
289
330
|
}
|
|
331
|
+
const denied = await sessionAccessDenied(c, session);
|
|
332
|
+
if (denied)
|
|
333
|
+
return denied;
|
|
290
334
|
if (!contextOptimizer) {
|
|
291
335
|
return c.json({ sliding_window: { triggered: false }, summarization: { triggered: false } });
|
|
292
336
|
}
|
|
@@ -299,11 +343,15 @@ requestSessionService) {
|
|
|
299
343
|
});
|
|
300
344
|
});
|
|
301
345
|
// POST /api/v2/sessions/:id/optimization/cancel-summarization — отменить ожидающую суммаризацию
|
|
346
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
302
347
|
app.post('/:id/optimization/cancel-summarization', kit.requireAuth, async (c) => {
|
|
303
348
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
304
349
|
if (!session) {
|
|
305
350
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
306
351
|
}
|
|
352
|
+
const denied = await sessionAccessDenied(c, session);
|
|
353
|
+
if (denied)
|
|
354
|
+
return denied;
|
|
307
355
|
await sessionManager.withLock(session.id, async (s) => {
|
|
308
356
|
s.summarizationPending = false;
|
|
309
357
|
await sessionManager.saveSession(s);
|
|
@@ -321,15 +369,27 @@ requestSessionService) {
|
|
|
321
369
|
});
|
|
322
370
|
// ===== Sticky Notes =====
|
|
323
371
|
// GET /api/v2/sessions/:id/notes — список заметок
|
|
372
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
324
373
|
app.get('/:id/notes', kit.requireAuth, async (c) => {
|
|
325
374
|
const session = await sessionManager.getSession(c.req.param('id'));
|
|
326
375
|
if (!session) {
|
|
327
376
|
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
328
377
|
}
|
|
378
|
+
const denied = await sessionAccessDenied(c, session);
|
|
379
|
+
if (denied)
|
|
380
|
+
return denied;
|
|
329
381
|
return c.json({ notes: session.stickyNotes });
|
|
330
382
|
});
|
|
331
383
|
// POST /api/v2/sessions/:id/notes — создать заметку
|
|
384
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
332
385
|
app.post('/:id/notes', kit.requireAuth, async (c) => {
|
|
386
|
+
const session = await sessionManager.getSession(c.req.param('id'));
|
|
387
|
+
if (!session) {
|
|
388
|
+
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
389
|
+
}
|
|
390
|
+
const denied = await sessionAccessDenied(c, session);
|
|
391
|
+
if (denied)
|
|
392
|
+
return denied;
|
|
333
393
|
const body = await c.req.json().catch(() => ({}));
|
|
334
394
|
if (!body.content?.trim()) {
|
|
335
395
|
return c.json({ error: { code: 'VALIDATION_ERROR', message: 'Content is required' } }, 400);
|
|
@@ -351,7 +411,15 @@ requestSessionService) {
|
|
|
351
411
|
return c.json({ note, notes: updated.stickyNotes }, 201);
|
|
352
412
|
});
|
|
353
413
|
// PATCH /api/v2/sessions/:id/notes/:noteId — обновить заметку
|
|
414
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
354
415
|
app.patch('/:id/notes/:noteId', kit.requireAuth, async (c) => {
|
|
416
|
+
const session = await sessionManager.getSession(c.req.param('id'));
|
|
417
|
+
if (!session) {
|
|
418
|
+
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
419
|
+
}
|
|
420
|
+
const denied = await sessionAccessDenied(c, session);
|
|
421
|
+
if (denied)
|
|
422
|
+
return denied;
|
|
355
423
|
const body = await c.req.json().catch(() => ({}));
|
|
356
424
|
const noteId = c.req.param('noteId');
|
|
357
425
|
await sessionManager.withLock(c.req.param('id'), async (s) => {
|
|
@@ -370,7 +438,15 @@ requestSessionService) {
|
|
|
370
438
|
return c.json({ notes: updated.stickyNotes });
|
|
371
439
|
});
|
|
372
440
|
// DELETE /api/v2/sessions/:id/notes/:noteId — удалить заметку
|
|
441
|
+
// RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
|
|
373
442
|
app.delete('/:id/notes/:noteId', kit.requireAuth, async (c) => {
|
|
443
|
+
const session = await sessionManager.getSession(c.req.param('id'));
|
|
444
|
+
if (!session) {
|
|
445
|
+
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
446
|
+
}
|
|
447
|
+
const denied = await sessionAccessDenied(c, session);
|
|
448
|
+
if (denied)
|
|
449
|
+
return denied;
|
|
374
450
|
const noteId = c.req.param('noteId');
|
|
375
451
|
await sessionManager.withLock(c.req.param('id'), async (s) => {
|
|
376
452
|
s.stickyNotes = s.stickyNotes.filter((n) => n.id !== noteId);
|
|
@@ -387,21 +463,21 @@ requestSessionService) {
|
|
|
387
463
|
resolveOwner: async (c) => (await kit.getCurrentUser(c)).id,
|
|
388
464
|
forkWithOwner: true,
|
|
389
465
|
canAccess: (session, c, userId) => isSessionOwner(session, userId) || kit.isAdmin(c),
|
|
390
|
-
//
|
|
466
|
+
// ADR-089: сквозной обзор сессий для ADMIN/LEAD. Вызовы `kit.isAdmin`/`hasRole`
|
|
391
467
|
// защищены `typeof` — у мок-AuthKit в тестах они могут отсутствовать.
|
|
392
468
|
resolveElevated: (c) => {
|
|
393
469
|
const isAdmin = typeof kit.isAdmin === 'function' && kit.isAdmin(c);
|
|
394
470
|
const isLead = typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD');
|
|
395
471
|
return isAdmin || isLead;
|
|
396
472
|
},
|
|
397
|
-
//
|
|
473
|
+
// ADR-089: проекты-участия пользователя — проектные сессии видны участникам.
|
|
398
474
|
resolveMemberProjectIds: async (_c, userId) => {
|
|
399
475
|
if (!projectStore)
|
|
400
476
|
return [];
|
|
401
477
|
const projects = await projectStore.list(userId);
|
|
402
478
|
return projects.map((p) => p.id);
|
|
403
479
|
},
|
|
404
|
-
//
|
|
480
|
+
// ADR-089: доступ по id — участник проекта сессии (owner/член), не только владелец.
|
|
405
481
|
resolveCanAccessExtra: async (session, _c, userId) => {
|
|
406
482
|
if (!projectStore || !session.projectId)
|
|
407
483
|
return false;
|
|
@@ -420,7 +496,7 @@ requestSessionService) {
|
|
|
420
496
|
promptMiddleware: [createRateLimiter(30, 60_000)],
|
|
421
497
|
enableSessionEvents: false,
|
|
422
498
|
resolveDefaultAgent,
|
|
423
|
-
//
|
|
499
|
+
// ADR-052 (этап I): scope-гейт и проектная проекция service-key (i18n-403).
|
|
424
500
|
scopeGuard,
|
|
425
501
|
projectGuard,
|
|
426
502
|
messages: {
|
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');
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@itphx/synth-backend",
|
|
3
|
-
"version": "0.10.
|
|
3
|
+
"version": "0.10.1",
|
|
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.10.
|
|
12
|
-
"@itphx/synth-shared": "0.10.
|
|
11
|
+
"@itphx/synth-core": "0.10.1",
|
|
12
|
+
"@itphx/synth-shared": "0.10.1",
|
|
13
13
|
"hono": "^4.9.0",
|
|
14
14
|
"hono-rate-limiter": "^0.5.3",
|
|
15
15
|
"jose": "^6.2.3",
|