@itphx/synth-backend 0.11.3 → 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/deps.d.ts +31 -5
- package/dist/app/deps.js +769 -36
- package/dist/app/listen.d.ts +7 -1
- package/dist/app/listen.js +126 -9
- package/dist/app/mount-routes.js +374 -11
- package/dist/app.d.ts +28 -2
- package/dist/app.js +52 -8
- package/dist/auth/guards.d.ts +15 -0
- package/dist/auth/guards.js +37 -1
- package/dist/auth/plugin-scope.d.ts +10 -0
- package/dist/auth/plugin-scope.js +69 -0
- package/dist/lib/defaults-store.js +1 -1
- package/dist/lib/i18n.js +107 -2
- package/dist/main.js +50 -3
- package/dist/routes/agents.d.ts +11 -2
- package/dist/routes/agents.js +14 -2
- package/dist/routes/auth.d.ts +11 -1
- package/dist/routes/auth.js +16 -2
- package/dist/routes/llm.js +2 -2
- package/dist/routes/mcp-registry.d.ts +13 -1
- package/dist/routes/mcp-registry.js +120 -19
- package/dist/routes/messages.d.ts +4 -2
- package/dist/routes/messages.js +5 -1
- package/dist/routes/processes.d.ts +34 -0
- package/dist/routes/processes.js +26 -0
- package/dist/routes/projects.d.ts +7 -1
- package/dist/routes/projects.js +8 -1
- package/dist/routes/sessions.d.ts +39 -2
- package/dist/routes/sessions.js +28 -5
- package/package.json +4 -4
package/dist/routes/auth.js
CHANGED
|
@@ -15,7 +15,16 @@ const BUILT_IN_DEFAULTS = {
|
|
|
15
15
|
uiScaleMobile: null,
|
|
16
16
|
uiScaleDesktop: null,
|
|
17
17
|
};
|
|
18
|
-
export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore
|
|
18
|
+
export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore,
|
|
19
|
+
/**
|
|
20
|
+
* ADR-090 Ф7: сигнал о серверной политике плагинов для публичного
|
|
21
|
+
* дискавери (`GET /auth/oidc-meta`).
|
|
22
|
+
*
|
|
23
|
+
* Только `{ enabled, mode }` — **без списка имён**: allow-list не публичен,
|
|
24
|
+
* полный список отдаёт аутентифицированный роут `GET /api/v2/settings/plugins`.
|
|
25
|
+
* Не задан — сигнала нет (старый клиент трактует это как «неизвестно»).
|
|
26
|
+
*/
|
|
27
|
+
pluginPolicySignal) {
|
|
19
28
|
const app = new Hono();
|
|
20
29
|
const avatarsDir = dataDir ? join(dataDir, 'auth', 'avatars') : null;
|
|
21
30
|
// Корень каталога аватаров (абсолютный) — для containment-проверки.
|
|
@@ -135,13 +144,18 @@ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore)
|
|
|
135
144
|
// Локальный core по адресу сервера узнаёт issuer и public client_id (для ROPC/device flow).
|
|
136
145
|
// Секрет клиента НЕ отдаётся.
|
|
137
146
|
app.get('/oidc-meta', (c) => {
|
|
147
|
+
// Ф7 (ADR-090): сигнал о серверной политике плагинов — только режим и
|
|
148
|
+
// признак включения слоя; список имён не публичен (полный список — по
|
|
149
|
+
// аутентифицированному роуту `/api/v2/settings/plugins`).
|
|
150
|
+
const pluginsSignal = pluginPolicySignal ? { plugins: pluginPolicySignal } : {};
|
|
138
151
|
if (!config.oidc?.enabled) {
|
|
139
|
-
return c.json({ enabled: false });
|
|
152
|
+
return c.json({ enabled: false, ...pluginsSignal });
|
|
140
153
|
}
|
|
141
154
|
return c.json({
|
|
142
155
|
enabled: true,
|
|
143
156
|
issuer: config.oidc.issuer,
|
|
144
157
|
clientId: config.oidc.cliClientId || 'synth-cli',
|
|
158
|
+
...pluginsSignal,
|
|
145
159
|
});
|
|
146
160
|
});
|
|
147
161
|
// GET /auth/session — проверка cookie-сессии
|
package/dist/routes/llm.js
CHANGED
|
@@ -17,7 +17,7 @@ import { ContextLengthExceededError, deobfuscateSecrets, GatewayProvider, Provid
|
|
|
17
17
|
const chatMessageSchema = z.object({
|
|
18
18
|
role: z.string().min(1),
|
|
19
19
|
content: z.string().nullable(),
|
|
20
|
-
tool_calls: z.array(z.record(z.unknown())).optional(),
|
|
20
|
+
tool_calls: z.array(z.record(z.string(), z.unknown())).optional(),
|
|
21
21
|
tool_call_id: z.string().optional(),
|
|
22
22
|
reasoning_content: z.string().optional(),
|
|
23
23
|
name: z.string().optional(),
|
|
@@ -34,7 +34,7 @@ const chatCompletionsSchema = z.object({
|
|
|
34
34
|
// OpenAIProvider всегда шлёт stream_options.include_usage, но поле принимаем
|
|
35
35
|
// явно, чтобы Zod его не срезал (контракт запроса).
|
|
36
36
|
stream_options: z.object({ include_usage: z.boolean().optional() }).optional(),
|
|
37
|
-
tools: z.array(z.record(z.unknown())).optional(),
|
|
37
|
+
tools: z.array(z.record(z.string(), z.unknown())).optional(),
|
|
38
38
|
session_id: z.string().optional(),
|
|
39
39
|
// Имя серверного провайдера (шлют remote-зеркала RemoteProvider в гибриде).
|
|
40
40
|
// Опционально — старые клиенты без поля работают как раньше (резолв по модели).
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
|
+
import type { Context } from 'hono';
|
|
2
3
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
|
-
import type { SessionManager, McpManager, McpRegistryRepository } from '@itphx/synth-core';
|
|
4
|
+
import type { SessionManager, McpManager, McpRegistryRepository, ExternalCredentialRepository } from '@itphx/synth-core';
|
|
4
5
|
import type { McpNetworkPolicy } from '@itphx/synth-shared';
|
|
5
6
|
export interface McpRoutesOptions {
|
|
6
7
|
/** ADR-071 §2.5: единый реестр MCP-серверов (источник истины для `/servers` и `/registry`). */
|
|
@@ -12,5 +13,16 @@ export interface McpRoutesOptions {
|
|
|
12
13
|
* Приоритетнее статической `networkPolicy`; читается на каждый запрос.
|
|
13
14
|
*/
|
|
14
15
|
getNetworkPolicy?: () => Promise<McpNetworkPolicy | undefined>;
|
|
16
|
+
/**
|
|
17
|
+
* ADR-105 (Ф3): порт слоя внешних доступов — право привязать доступ
|
|
18
|
+
* к коннектору проверяется на границе (инвариант 16). Не задан — привязка
|
|
19
|
+
* запрещена (fail-closed).
|
|
20
|
+
*/
|
|
21
|
+
credentials?: ExternalCredentialRepository;
|
|
22
|
+
/**
|
|
23
|
+
* ADR-105 (Ф3): право участника проекта **изменять содержимое** проекта
|
|
24
|
+
* (`OWNER`/`EDITOR`, а также `LEAD`/`ADMIN`) — для доступа уровня проекта.
|
|
25
|
+
*/
|
|
26
|
+
canEditProject?: (c: Context, projectId: string) => boolean | Promise<boolean>;
|
|
15
27
|
}
|
|
16
28
|
export declare function createMcpRegistryRoutes(kit: AuthKit, mcpManager: McpManager | null, sessionManager: SessionManager | null, options: McpRoutesOptions): Hono;
|
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import { z } from 'zod';
|
|
3
|
-
import { evaluateMcpNetworkAccess, getServiceCredential } from '@itphx/synth-core';
|
|
4
|
-
import { sessionMcpScopeSchema, hasServiceScope } from '@itphx/synth-shared';
|
|
3
|
+
import { createCredentialBindGuard, evaluateMcpNetworkAccess, getServiceCredential, McpRegistryValidationError, syncMcpManagerFromRegistry, } from '@itphx/synth-core';
|
|
4
|
+
import { sessionMcpScopeSchema, hasServiceScope, findForbiddenMcpSecretHeaders, mcpSecretHeaderErrorMessage, MCP_SECRET_HEADER_ERROR_CODE, } from '@itphx/synth-shared';
|
|
5
5
|
import { mcpServerConfigSchema } from '@itphx/synth-shared/config';
|
|
6
6
|
import { requireAdminOrScope, requireScopeForServiceKey } from '../auth/guards.js';
|
|
7
|
+
import { t } from '../lib/i18n.js';
|
|
7
8
|
// Backend-only MCP-роуты (ADR-071 §2.5): legacy `/servers*`, `/session/:id` и
|
|
8
9
|
// единый реестр `/registry*`. Probe (`POST /probe`) — общая логика core,
|
|
9
10
|
// монтируется в `routes/mcp.ts` ПЕРЕД этим роутером.
|
|
@@ -29,6 +30,28 @@ const registryUpdateSchema = z.object({
|
|
|
29
30
|
enabled: z.boolean().optional(),
|
|
30
31
|
enabledByDefault: z.boolean().optional(),
|
|
31
32
|
});
|
|
33
|
+
/**
|
|
34
|
+
* ADR-105 (Ф3): plaintext-секрет в заголовках коннектора запрещён —
|
|
35
|
+
* авторизация только через слой внешних доступов (`auth.kind='credential'`).
|
|
36
|
+
*
|
|
37
|
+
* Значений заголовков в тексте ошибки нет — только их имена.
|
|
38
|
+
*/
|
|
39
|
+
function secretHeaderError(config) {
|
|
40
|
+
const forbidden = findForbiddenMcpSecretHeaders(config?.headers);
|
|
41
|
+
if (forbidden.length === 0)
|
|
42
|
+
return null;
|
|
43
|
+
return { code: MCP_SECRET_HEADER_ERROR_CODE, message: mcpSecretHeaderErrorMessage(forbidden) };
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* ADR-105 (Ф3): хранилище реестра — последний рубеж запрета plaintext-секрета.
|
|
47
|
+
* Ошибка валидации → 400 с тем же кодом (иначе роут отдал бы 500).
|
|
48
|
+
*/
|
|
49
|
+
function secretHeaderStoreError(err) {
|
|
50
|
+
if (err instanceof McpRegistryValidationError && err.code === MCP_SECRET_HEADER_ERROR_CODE) {
|
|
51
|
+
return { code: err.code, message: err.message };
|
|
52
|
+
}
|
|
53
|
+
return null;
|
|
54
|
+
}
|
|
32
55
|
export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options) {
|
|
33
56
|
const app = new Hono();
|
|
34
57
|
const registry = options.registry;
|
|
@@ -37,16 +60,29 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
37
60
|
const syncManagerConfig = async () => {
|
|
38
61
|
if (!mcpManager)
|
|
39
62
|
return;
|
|
40
|
-
|
|
41
|
-
mcpManager.setConfig(maps.servers);
|
|
42
|
-
mcpManager.setServerOrigins(maps.origins);
|
|
43
|
-
mcpManager.setServerTrusts(maps.trusts);
|
|
44
|
-
mcpManager.setServerAuthors(maps.authors);
|
|
45
|
-
mcpManager.setDefaultServers(maps.defaults);
|
|
46
|
-
mcpManager.setServerSystemEnabled(maps.systemEnabled);
|
|
63
|
+
await syncMcpManagerFromRegistry(mcpManager, registry);
|
|
47
64
|
};
|
|
48
65
|
const isConnected = (name) => mcpManager?.getConfiguredServers().find((s) => s.name === name)?.connected ?? false;
|
|
49
66
|
const currentUser = (c) => c.get('user') ?? null;
|
|
67
|
+
/**
|
|
68
|
+
* ADR-105 (Ф3): граница проверки права привязки внешнего доступа к коннектору
|
|
69
|
+
* (инвариант 16 — проверка не в обработчике, правило — в core).
|
|
70
|
+
*
|
|
71
|
+
* Актор — пользователь запроса (для service-key — синтетический
|
|
72
|
+
* `service:<keyId>` с ролями ключа, ADR-052).
|
|
73
|
+
*/
|
|
74
|
+
const checkCredentialBinding = createCredentialBindGuard({
|
|
75
|
+
...(options.credentials ? { credentials: options.credentials } : {}),
|
|
76
|
+
resolveActor: (c) => {
|
|
77
|
+
const user = currentUser(c);
|
|
78
|
+
return { userId: user?.id ?? '', roles: user?.roles ?? [] };
|
|
79
|
+
},
|
|
80
|
+
...(options.canEditProject ? { canEditProject: options.canEditProject } : {}),
|
|
81
|
+
messages: {
|
|
82
|
+
notFound: (c) => t('errors.notFound.credential', undefined, c),
|
|
83
|
+
forbidden: (c) => t('auth.forbidden', undefined, c),
|
|
84
|
+
},
|
|
85
|
+
});
|
|
50
86
|
/**
|
|
51
87
|
* ADR-052/O1: запрос от installer-service-key (scope `addons:install`).
|
|
52
88
|
* Даёт scoped-ключу без роли ADMIN создавать **instance**-записи реестра
|
|
@@ -93,6 +129,16 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
93
129
|
if (await registry.getByName(name)) {
|
|
94
130
|
return c.json({ error: { code: 'CONFLICT', message: `Сервер "${name}" уже существует` } }, 409);
|
|
95
131
|
}
|
|
132
|
+
// ADR-105 (Ф3): plaintext-секрет в заголовках → 400 (не 500).
|
|
133
|
+
const secretError = secretHeaderError(config);
|
|
134
|
+
if (secretError) {
|
|
135
|
+
return c.json({ error: secretError }, 400);
|
|
136
|
+
}
|
|
137
|
+
// ADR-105 (Ф3): право привязать внешний доступ к коннектору (граница).
|
|
138
|
+
const bindError = await checkCredentialBinding(c, config);
|
|
139
|
+
if (bindError) {
|
|
140
|
+
return c.json({ error: bindError }, bindError.code === 'NOT_FOUND' ? 404 : 403);
|
|
141
|
+
}
|
|
96
142
|
const networkError = await checkNetwork(config, 'instance');
|
|
97
143
|
if (networkError) {
|
|
98
144
|
return c.json({ error: networkError }, 400);
|
|
@@ -123,6 +169,16 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
123
169
|
if (!parsed.success) {
|
|
124
170
|
return c.json({ error: { code: 'VALIDATION_ERROR', message: parsed.error.message } }, 400);
|
|
125
171
|
}
|
|
172
|
+
// ADR-105 (Ф3): plaintext-секрет в заголовках → 400 (не 500).
|
|
173
|
+
const secretError = secretHeaderError(parsed.data);
|
|
174
|
+
if (secretError) {
|
|
175
|
+
return c.json({ error: secretError }, 400);
|
|
176
|
+
}
|
|
177
|
+
// ADR-105 (Ф3): право привязать внешний доступ к коннектору (граница).
|
|
178
|
+
const bindError = await checkCredentialBinding(c, parsed.data, entry.config.auth?.kind === 'credential' ? entry.config.auth.credentialId : undefined);
|
|
179
|
+
if (bindError) {
|
|
180
|
+
return c.json({ error: bindError }, bindError.code === 'NOT_FOUND' ? 404 : 403);
|
|
181
|
+
}
|
|
126
182
|
const networkError = await checkNetwork(parsed.data, entry.origin);
|
|
127
183
|
if (networkError) {
|
|
128
184
|
return c.json({ error: networkError }, 400);
|
|
@@ -163,6 +219,11 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
163
219
|
if (!config) {
|
|
164
220
|
return c.json({ error: { code: 'NOT_FOUND', message: `Сервер "${name}" не найден` } }, 404);
|
|
165
221
|
}
|
|
222
|
+
// ADR-105 (Ф3): probe/тест не подключается к коннектору с plaintext-секретом.
|
|
223
|
+
const secretError = secretHeaderError(config);
|
|
224
|
+
if (secretError) {
|
|
225
|
+
return c.json({ error: secretError }, 400);
|
|
226
|
+
}
|
|
166
227
|
if (!mcpManager) {
|
|
167
228
|
return c.json({ error: { code: 'INTERNAL_ERROR', message: 'McpManager не настроен' } }, 500);
|
|
168
229
|
}
|
|
@@ -278,6 +339,16 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
278
339
|
}
|
|
279
340
|
const { name, config, enabled, enabledByDefault, origin } = parsed.data;
|
|
280
341
|
const admin = kit.isAdmin(c);
|
|
342
|
+
// ADR-105 (Ф3): plaintext-секрет в заголовках → 400 (не 500).
|
|
343
|
+
const secretError = secretHeaderError(config);
|
|
344
|
+
if (secretError) {
|
|
345
|
+
return c.json({ error: secretError }, 400);
|
|
346
|
+
}
|
|
347
|
+
// ADR-105 (Ф3): право привязать внешний доступ к коннектору (граница).
|
|
348
|
+
const bindError = await checkCredentialBinding(c, config);
|
|
349
|
+
if (bindError) {
|
|
350
|
+
return c.json({ error: bindError }, bindError.code === 'NOT_FOUND' ? 404 : 403);
|
|
351
|
+
}
|
|
281
352
|
// ADR-052/O1: installer-ключ (scope `addons:install`) создаёт instance-записи
|
|
282
353
|
// даже без роли ADMIN — это общие записи инстанса (а не персональные).
|
|
283
354
|
const isInstaller = isInstallerKey(c);
|
|
@@ -307,15 +378,25 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
307
378
|
}
|
|
308
379
|
const user = currentUser(c);
|
|
309
380
|
const author = user ? { userId: user.id, username: user.username } : null;
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
381
|
+
let entry;
|
|
382
|
+
try {
|
|
383
|
+
entry = await registry.add({
|
|
384
|
+
name,
|
|
385
|
+
config,
|
|
386
|
+
origin: entryOrigin,
|
|
387
|
+
trust,
|
|
388
|
+
author,
|
|
389
|
+
enabled,
|
|
390
|
+
enabledByDefault,
|
|
391
|
+
});
|
|
392
|
+
}
|
|
393
|
+
catch (err) {
|
|
394
|
+
// ADR-105 (Ф3): запрет plaintext-секрета → 400, а не 500.
|
|
395
|
+
const storeError = secretHeaderStoreError(err);
|
|
396
|
+
if (storeError)
|
|
397
|
+
return c.json({ error: storeError }, 400);
|
|
398
|
+
throw err;
|
|
399
|
+
}
|
|
319
400
|
await syncManagerConfig();
|
|
320
401
|
return c.json(entry, 201);
|
|
321
402
|
});
|
|
@@ -345,6 +426,16 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
345
426
|
if (nextConfig.type === 'stdio' && !admin) {
|
|
346
427
|
return c.json({ error: { code: 'FORBIDDEN', message: 'stdio-серверы может изменять только ADMIN' } }, 403);
|
|
347
428
|
}
|
|
429
|
+
// ADR-105 (Ф3): plaintext-секрет в заголовках → 400 (не 500).
|
|
430
|
+
const secretError = secretHeaderError(nextConfig);
|
|
431
|
+
if (secretError) {
|
|
432
|
+
return c.json({ error: secretError }, 400);
|
|
433
|
+
}
|
|
434
|
+
// ADR-105 (Ф3): право привязать внешний доступ к коннектору (граница).
|
|
435
|
+
const bindError = await checkCredentialBinding(c, nextConfig, existing.config.auth?.kind === 'credential' ? existing.config.auth.credentialId : undefined);
|
|
436
|
+
if (bindError) {
|
|
437
|
+
return c.json({ error: bindError }, bindError.code === 'NOT_FOUND' ? 404 : 403);
|
|
438
|
+
}
|
|
348
439
|
const networkError = await checkNetwork(nextConfig, existing.origin);
|
|
349
440
|
if (networkError) {
|
|
350
441
|
return c.json({ error: networkError }, 400);
|
|
@@ -356,7 +447,17 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
356
447
|
error: { code: 'CONFLICT', message: `Сервер "${parsed.data.name}" уже существует в реестре` },
|
|
357
448
|
}, 409);
|
|
358
449
|
}
|
|
359
|
-
|
|
450
|
+
let updated;
|
|
451
|
+
try {
|
|
452
|
+
updated = await registry.update(id, parsed.data);
|
|
453
|
+
}
|
|
454
|
+
catch (err) {
|
|
455
|
+
// ADR-105 (Ф3): запрет plaintext-секрета → 400, а не 500.
|
|
456
|
+
const storeError = secretHeaderStoreError(err);
|
|
457
|
+
if (storeError)
|
|
458
|
+
return c.json({ error: storeError }, 400);
|
|
459
|
+
throw err;
|
|
460
|
+
}
|
|
360
461
|
await syncManagerConfig();
|
|
361
462
|
return c.json(updated);
|
|
362
463
|
});
|
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
|
-
import type { SessionManager, ContextOptimizer, EventBus, ProjectRepository } from '@itphx/synth-core';
|
|
3
|
+
import type { SessionManager, ContextOptimizer, EventBus, ProjectRepository, BlobRefRepository } from '@itphx/synth-core';
|
|
4
4
|
/**
|
|
5
5
|
* Backend-обёртка над core-фабрикой сообщений: добавляет i18n-сообщения, RBAC
|
|
6
6
|
* доступа к сессии (владелец/ADMIN/участник проекта/LEAD) и хук пересчёта
|
|
7
7
|
* `canSummarize` после мутаций (backend-специфика). Логика роутов
|
|
8
8
|
* (batch/toggle/pin/delete/retry/debug) — в core-фабрике.
|
|
9
9
|
*/
|
|
10
|
-
export declare function createMessageRoutes(kit: AuthKit, sessionManager: SessionManager, contextOptimizer: ContextOptimizer | null, eventBus: EventBus, projectStore?: ProjectRepository
|
|
10
|
+
export declare function createMessageRoutes(kit: AuthKit, sessionManager: SessionManager, contextOptimizer: ContextOptimizer | null, eventBus: EventBus, projectStore?: ProjectRepository,
|
|
11
|
+
/** ADR-115: учёт ссылок на объекты blob-хранилища (снятие при удалении). */
|
|
12
|
+
blobRefs?: BlobRefRepository): Hono;
|
package/dist/routes/messages.js
CHANGED
|
@@ -9,7 +9,9 @@ import { createProjectAccess } from './projects.js';
|
|
|
9
9
|
* `canSummarize` после мутаций (backend-специфика). Логика роутов
|
|
10
10
|
* (batch/toggle/pin/delete/retry/debug) — в core-фабрике.
|
|
11
11
|
*/
|
|
12
|
-
export function createMessageRoutes(kit, sessionManager, contextOptimizer, eventBus, projectStore
|
|
12
|
+
export function createMessageRoutes(kit, sessionManager, contextOptimizer, eventBus, projectStore,
|
|
13
|
+
/** ADR-115: учёт ссылок на объекты blob-хранилища (снятие при удалении). */
|
|
14
|
+
blobRefs) {
|
|
13
15
|
const app = new Hono();
|
|
14
16
|
const recalcCanSummarize = createRecalcCanSummarize({ sessionManager, contextOptimizer, eventBus });
|
|
15
17
|
const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
|
|
@@ -22,6 +24,8 @@ export function createMessageRoutes(kit, sessionManager, contextOptimizer, event
|
|
|
22
24
|
forbidden: (c) => t('auth.forbidden', undefined, c),
|
|
23
25
|
},
|
|
24
26
|
onMessagesChanged: (sessionId) => recalcCanSummarize(sessionId),
|
|
27
|
+
// ADR-115: ссылки на объекты вложений снимаются при удалении сообщения.
|
|
28
|
+
...(blobRefs ? { blobRefs } : {}),
|
|
25
29
|
resolveUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
|
|
26
30
|
canAccess: (session, c, userId) => isSessionOwner(session, userId)
|
|
27
31
|
|| (typeof kit.isAdmin === 'function' && kit.isAdmin(c)),
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Managed-правило доступа к реестру фоновых прогонов (PROP-096/097).
|
|
3
|
+
*
|
|
4
|
+
* Право на прогон — это право на его **сессию-владельца**:
|
|
5
|
+
* - **владелец** сессии — да;
|
|
6
|
+
* - **ADMIN** — да (сквозной доступ к инстансу);
|
|
7
|
+
* - **участник проекта** сессии: чтение — `canReadProject` (любая роль, в т.ч.
|
|
8
|
+
* `VIEWER`), изменение — `canEditProjectContent` (`OWNER`/`EDITOR`/`LEAD`/
|
|
9
|
+
* `ADMIN`). Read-доступ **не** расширяет права на изменение (инвариант 21):
|
|
10
|
+
* `VIEWER` читает прогон, но не может его остановить или удалить;
|
|
11
|
+
* - **LEAD** — сквозной доступ к содержимому проекта (как у `canManageProject`).
|
|
12
|
+
*
|
|
13
|
+
* Правило одно и то же для HTTP-контура и для любых других потребителей
|
|
14
|
+
* (его же использует `createProjectAccess` — источник истины по ролям).
|
|
15
|
+
*/
|
|
16
|
+
import type { Context } from 'hono';
|
|
17
|
+
import type { Session } from '@itphx/synth-shared';
|
|
18
|
+
import type { ProjectRepository, SessionAccessKind } from '@itphx/synth-core';
|
|
19
|
+
import type { AuthKit } from '../auth/middleware.js';
|
|
20
|
+
export interface BackendProcessAccessDeps {
|
|
21
|
+
/** AuthKit backend (OIDC/RBAC). */
|
|
22
|
+
auth: AuthKit;
|
|
23
|
+
/** Порт проектов — по нему резолвятся права на проект сессии. */
|
|
24
|
+
projectStore: ProjectRepository;
|
|
25
|
+
}
|
|
26
|
+
/** Предикат доступа к прогону (совместим с `SessionAccessPredicate` core). */
|
|
27
|
+
export type BackendProcessAccess = (session: Session, c: Context, userId: string, access: SessionAccessKind) => Promise<boolean>;
|
|
28
|
+
/**
|
|
29
|
+
* Собрать правило доступа к фоновым прогонам для managed-контура.
|
|
30
|
+
*
|
|
31
|
+
* Fail-closed: сессия без проекта и не своего владельца — отказ; проект не
|
|
32
|
+
* найден — отказ.
|
|
33
|
+
*/
|
|
34
|
+
export declare function createBackendProcessAccess(deps: BackendProcessAccessDeps): BackendProcessAccess;
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { createProjectAccess } from './projects.js';
|
|
2
|
+
/**
|
|
3
|
+
* Собрать правило доступа к фоновым прогонам для managed-контура.
|
|
4
|
+
*
|
|
5
|
+
* Fail-closed: сессия без проекта и не своего владельца — отказ; проект не
|
|
6
|
+
* найден — отказ.
|
|
7
|
+
*/
|
|
8
|
+
export function createBackendProcessAccess(deps) {
|
|
9
|
+
const projectAccess = createProjectAccess(deps.auth);
|
|
10
|
+
return async (session, c, userId, access) => {
|
|
11
|
+
const owner = session.ownerId ?? session.userId;
|
|
12
|
+
if (owner && owner === userId)
|
|
13
|
+
return true;
|
|
14
|
+
if (deps.auth.isAdmin(c))
|
|
15
|
+
return true;
|
|
16
|
+
if (!session.projectId)
|
|
17
|
+
return false;
|
|
18
|
+
const project = await deps.projectStore.load(session.projectId);
|
|
19
|
+
if (!project)
|
|
20
|
+
return false;
|
|
21
|
+
const ctx = c;
|
|
22
|
+
return access === 'read'
|
|
23
|
+
? projectAccess.canReadProject(ctx, project, userId)
|
|
24
|
+
: projectAccess.canEditProjectContent(ctx, project, userId);
|
|
25
|
+
};
|
|
26
|
+
}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
3
|
import type { ProjectRepository, SessionManager, McpManager, SkillService, SettingsRepository, McpRegistryRepository } from '@itphx/synth-core';
|
|
4
|
+
import type { WorktreeService } from '@itphx/synth-core';
|
|
4
5
|
import type { Project } from '@itphx/synth-shared';
|
|
5
6
|
/**
|
|
6
7
|
* ADR-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
|
|
@@ -28,4 +29,9 @@ export declare function createProjectRoutes(kit: AuthKit, store: ProjectReposito
|
|
|
28
29
|
/** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
|
|
29
30
|
mcpManager?: McpManager,
|
|
30
31
|
/** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
|
|
31
|
-
skillService?: SkillService, settingsStore?: SettingsRepository, mcpRegistryStore?: McpRegistryRepository
|
|
32
|
+
skillService?: SkillService, settingsStore?: SettingsRepository, mcpRegistryStore?: McpRegistryRepository,
|
|
33
|
+
/**
|
|
34
|
+
* ADR-114: сервис worktree'ов проекта — контур `/projects/:id/worktrees*`
|
|
35
|
+
* (список/создание/удаление/prune). Не задан — роутов нет.
|
|
36
|
+
*/
|
|
37
|
+
worktreeService?: WorktreeService): Hono;
|
package/dist/routes/projects.js
CHANGED
|
@@ -33,7 +33,12 @@ export function createProjectRoutes(kit, store, sessionManager, workspacesRoot,
|
|
|
33
33
|
/** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
|
|
34
34
|
mcpManager,
|
|
35
35
|
/** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
|
|
36
|
-
skillService, settingsStore, mcpRegistryStore
|
|
36
|
+
skillService, settingsStore, mcpRegistryStore,
|
|
37
|
+
/**
|
|
38
|
+
* ADR-114: сервис worktree'ов проекта — контур `/projects/:id/worktrees*`
|
|
39
|
+
* (список/создание/удаление/prune). Не задан — роутов нет.
|
|
40
|
+
*/
|
|
41
|
+
worktreeService) {
|
|
37
42
|
const { canManageProject, canEditProjectContent, canReadProject } = createProjectAccess(kit);
|
|
38
43
|
return createCoreProjectRoutes({ requireAuth: kit.requireAuth }, store, undefined, {
|
|
39
44
|
canManage: canManageProject,
|
|
@@ -68,5 +73,7 @@ skillService, settingsStore, mcpRegistryStore) {
|
|
|
68
73
|
sessionManager,
|
|
69
74
|
getWorkspacesRoot: () => workspacesRoot,
|
|
70
75
|
getOutsideRootPolicy: () => 'deny',
|
|
76
|
+
// ADR-114: контур worktree'ов проекта.
|
|
77
|
+
...(worktreeService ? { worktrees: worktreeService } : {}),
|
|
71
78
|
});
|
|
72
79
|
}
|
|
@@ -10,6 +10,11 @@ import type { AnalyticsRecorder } from '@itphx/synth-core';
|
|
|
10
10
|
import type { ProfileStore } from '@itphx/synth-shared';
|
|
11
11
|
import type { EventHub } from '../events/hub.js';
|
|
12
12
|
import type { ProjectRepository } from '@itphx/synth-core';
|
|
13
|
+
import type { MemoryFactRepository, MemoryIndexRepository } from '@itphx/synth-core';
|
|
14
|
+
import type { BlobRefRepository, BlobStore } from '@itphx/synth-core';
|
|
15
|
+
import type { AttachmentsConfig } from '@itphx/synth-shared';
|
|
16
|
+
import type { QuestionService } from '@itphx/synth-core';
|
|
17
|
+
import type { WorktreeService } from '@itphx/synth-core';
|
|
13
18
|
/**
|
|
14
19
|
* Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
|
|
15
20
|
* backend-специфичные роуты (MCP-скоуп сессии, секреты, export/import, отладка,
|
|
@@ -38,5 +43,37 @@ resolveDefaultAgent?: () => string | Promise<string>,
|
|
|
38
43
|
* Не задан — core-фабрика использует прямой `SessionManager.createSession`.
|
|
39
44
|
*/
|
|
40
45
|
requestSessionService?: RequestSessionService,
|
|
41
|
-
/**
|
|
42
|
-
analytics?: AnalyticsRecorder
|
|
46
|
+
/** ADR-102: сборщик `activity` (меры `aborts`/`messages_*`) для core-фабрики. */
|
|
47
|
+
analytics?: AnalyticsRecorder,
|
|
48
|
+
/** ADR-107: агрегаты памяти сессии для `GET /:id/memory` (вкладка «Память»). */
|
|
49
|
+
memory?: {
|
|
50
|
+
facts: MemoryFactRepository;
|
|
51
|
+
indexes: MemoryIndexRepository;
|
|
52
|
+
isPluginActive: () => boolean;
|
|
53
|
+
},
|
|
54
|
+
/**
|
|
55
|
+
* Этап 1 roadmap 0.13 (блок 3): сервис «вопрос пользователю» (`ask_user`).
|
|
56
|
+
*
|
|
57
|
+
* Не задан — маршруты вопросов отвечают 503 (подсистема не подключена).
|
|
58
|
+
*/
|
|
59
|
+
questionService?: QuestionService,
|
|
60
|
+
/**
|
|
61
|
+
* ADR-114: сервис worktree'ов — привязка сессии к worktree
|
|
62
|
+
* (`PATCH /api/v2/sessions/:id { worktreeId }`).
|
|
63
|
+
*
|
|
64
|
+
* Не задан — поле `worktreeId` в PATCH игнорируется (привязка недоступна).
|
|
65
|
+
*/
|
|
66
|
+
worktreeService?: WorktreeService,
|
|
67
|
+
/**
|
|
68
|
+
* ADR-115: вложения сообщений — blob-порт, учёт ссылок и лимиты
|
|
69
|
+
* (прокидывается в core-фабрику: загрузка/раздача + `attachments` в промпте).
|
|
70
|
+
*/
|
|
71
|
+
attachments?: {
|
|
72
|
+
blobs: BlobStore;
|
|
73
|
+
blobRefs?: BlobRefRepository;
|
|
74
|
+
/**
|
|
75
|
+
* Настройки вложений: снимок **или** резолвер (ADR-115) — runtime-настройки
|
|
76
|
+
* из админки (`/api/v2/settings/attachments`) применяются на каждый вызов.
|
|
77
|
+
*/
|
|
78
|
+
config: AttachmentsConfig | (() => AttachmentsConfig);
|
|
79
|
+
}): 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, serviceProjectProjection } from '../auth/service-scope.js';
|
|
5
|
-
import { enqueueUserMessage, serializeSession, createSessionAccessGuard, createSessionAccessPredicate, createSessionExportGuard, getSessionExportDecision, isSessionExportPath, createSessionRoutes as createCoreSessionRoutes, stripSessionSecrets, } from '@itphx/synth-core';
|
|
5
|
+
import { enqueueUserMessage, serializeSession, createSessionAccessGuard, createSessionAccessPredicate, createSessionExportGuard, getSessionExportDecision, isSessionExportPath, createSessionRoutes as createCoreSessionRoutes, stripSessionSecrets, resolveUserPrincipal, } from '@itphx/synth-core';
|
|
6
6
|
import { t } from '../lib/i18n.js';
|
|
7
7
|
import { createProjectAccess } from './projects.js';
|
|
8
8
|
/**
|
|
@@ -33,8 +33,28 @@ resolveDefaultAgent,
|
|
|
33
33
|
* Не задан — core-фабрика использует прямой `SessionManager.createSession`.
|
|
34
34
|
*/
|
|
35
35
|
requestSessionService,
|
|
36
|
-
/**
|
|
37
|
-
analytics
|
|
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) {
|
|
38
58
|
const app = new Hono();
|
|
39
59
|
const agentRegistry = orchestrator.agentRegistry;
|
|
40
60
|
const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
|
|
@@ -380,7 +400,9 @@ analytics) {
|
|
|
380
400
|
author: user.username,
|
|
381
401
|
metadata: { type: 'debug_system_message', reason: 'manual', stream_id: streamId },
|
|
382
402
|
};
|
|
383
|
-
|
|
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);
|
|
384
406
|
if (!result) {
|
|
385
407
|
return c.json({ error: { code: 'QUEUE_FULL', message: 'Queue is full' } }, 429);
|
|
386
408
|
}
|
|
@@ -567,7 +589,7 @@ analytics) {
|
|
|
567
589
|
});
|
|
568
590
|
// Общая логика — в core-фабрике (backend-специфика выше). Регистрируем её
|
|
569
591
|
// последней: статические/backend-only сегменты должны матчиться раньше.
|
|
570
|
-
app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService, analytics }, {
|
|
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 } : {}) }, {
|
|
571
593
|
resolveUserId: async (c) => (await kit.getCurrentUser(c)).id,
|
|
572
594
|
resolveOwner: async (c) => (await kit.getCurrentUser(c)).id,
|
|
573
595
|
forkWithOwner: true,
|
|
@@ -628,6 +650,7 @@ analytics) {
|
|
|
628
650
|
forbidden: (c) => t('auth.forbidden', undefined, c),
|
|
629
651
|
contentRequired: (c) => t('errors.validation.contentRequired', undefined, c),
|
|
630
652
|
queueFull: (c, max) => t('errors.chat.queueFull', { max }, c),
|
|
653
|
+
steerLimitExceeded: (c, max) => t('errors.chat.steerLimitExceeded', { max }, c),
|
|
631
654
|
},
|
|
632
655
|
}));
|
|
633
656
|
return app;
|
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",
|