@itphx/synth-backend 0.11.3 → 0.13.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 +37 -5
- package/dist/app/deps.js +1172 -37
- package/dist/app/listen.d.ts +7 -1
- package/dist/app/listen.js +182 -16
- package/dist/app/mount-routes.js +493 -12
- package/dist/app/sse-events.d.ts +4 -0
- package/dist/app/sse-events.js +53 -6
- package/dist/app.d.ts +30 -2
- package/dist/app.js +54 -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/events/hub.d.ts +17 -0
- package/dist/events/hub.js +46 -14
- package/dist/lib/app-config.d.ts +4 -0
- package/dist/lib/app-config.js +4 -2
- package/dist/lib/defaults-store.d.ts +1 -1
- package/dist/lib/defaults-store.js +2 -2
- package/dist/lib/i18n.js +123 -2
- package/dist/lib/recalc-can-summarize.js +8 -3
- package/dist/main.js +52 -3
- package/dist/routes/agents.d.ts +11 -2
- package/dist/routes/agents.js +15 -2
- package/dist/routes/auth.d.ts +11 -1
- package/dist/routes/auth.js +45 -3
- package/dist/routes/llm.js +29 -7
- 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 +7 -1
- package/dist/routes/processes.d.ts +34 -0
- package/dist/routes/processes.js +26 -0
- package/dist/routes/projects.d.ts +14 -2
- package/dist/routes/projects.js +28 -1
- package/dist/routes/queue.d.ts +4 -1
- package/dist/routes/queue.js +4 -1
- package/dist/routes/sessions.d.ts +74 -6
- package/dist/routes/sessions.js +85 -93
- package/package.json +6 -6
|
@@ -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,10 @@ 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-118 §4/§7: удаление сообщения публикует `message.deleted` в канал сессии.
|
|
28
|
+
eventBus,
|
|
29
|
+
// ADR-115: ссылки на объекты вложений снимаются при удалении сообщения.
|
|
30
|
+
...(blobRefs ? { blobRefs } : {}),
|
|
25
31
|
resolveUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
|
|
26
32
|
canAccess: (session, c, userId) => isSessionOwner(session, userId)
|
|
27
33
|
|| (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
|
-
import type { ProjectRepository, SessionManager, McpManager, SkillService, SettingsRepository, McpRegistryRepository } from '@itphx/synth-core';
|
|
3
|
+
import type { ProjectRepository, SessionManager, McpManager, SkillService, SettingsRepository, McpRegistryRepository, EventBus } 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,15 @@ 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,
|
|
38
|
+
/**
|
|
39
|
+
* ADR-118 §4: шина событий — `PUT /:id`/`DELETE /:id` публикуют
|
|
40
|
+
* `project.updated`/`project.deleted` в канал каждой сессии проекта.
|
|
41
|
+
* Не задана — публикации нет (поведение прежнее).
|
|
42
|
+
*/
|
|
43
|
+
eventBus?: EventBus): Hono;
|
package/dist/routes/projects.js
CHANGED
|
@@ -33,7 +33,18 @@ 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,
|
|
42
|
+
/**
|
|
43
|
+
* ADR-118 §4: шина событий — `PUT /:id`/`DELETE /:id` публикуют
|
|
44
|
+
* `project.updated`/`project.deleted` в канал каждой сессии проекта.
|
|
45
|
+
* Не задана — публикации нет (поведение прежнее).
|
|
46
|
+
*/
|
|
47
|
+
eventBus) {
|
|
37
48
|
const { canManageProject, canEditProjectContent, canReadProject } = createProjectAccess(kit);
|
|
38
49
|
return createCoreProjectRoutes({ requireAuth: kit.requireAuth }, store, undefined, {
|
|
39
50
|
canManage: canManageProject,
|
|
@@ -68,5 +79,21 @@ skillService, settingsStore, mcpRegistryStore) {
|
|
|
68
79
|
sessionManager,
|
|
69
80
|
getWorkspacesRoot: () => workspacesRoot,
|
|
70
81
|
getOutsideRootPolicy: () => 'deny',
|
|
82
|
+
// ADR-114: контур worktree'ов проекта.
|
|
83
|
+
...(worktreeService ? { worktrees: worktreeService } : {}),
|
|
84
|
+
// ADR-118 §4: изменение/удаление проекта — в канал каждой сессии проекта.
|
|
85
|
+
...(eventBus
|
|
86
|
+
? {
|
|
87
|
+
sessionManager,
|
|
88
|
+
onProjectChanged: async (projectId, kind) => {
|
|
89
|
+
const sessions = await sessionManager.listSessions({ projectId });
|
|
90
|
+
for (const s of sessions) {
|
|
91
|
+
eventBus.publish(s.id, kind === 'deleted' ? 'project.deleted' : 'project.updated', {
|
|
92
|
+
project_id: projectId,
|
|
93
|
+
});
|
|
94
|
+
}
|
|
95
|
+
},
|
|
96
|
+
}
|
|
97
|
+
: {}),
|
|
71
98
|
});
|
|
72
99
|
}
|
package/dist/routes/queue.d.ts
CHANGED
|
@@ -1,9 +1,12 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
3
|
import type { SessionManager, QueueProcessorManager, ChatOrchestrator, EventBus, ProjectRepository } from '@itphx/synth-core';
|
|
4
|
+
import type { Message } from '@itphx/synth-shared';
|
|
4
5
|
/**
|
|
5
6
|
* Backend-обёртка над core-фабрикой очереди: добавляет i18n-сообщения и RBAC
|
|
6
7
|
* доступа к сессии (владелец/ADMIN/участник проекта/LEAD). Логика роутов
|
|
7
8
|
* (clear/return/resume/retry-now/cancel-retry) — в core-фабрике.
|
|
8
9
|
*/
|
|
9
|
-
export declare function createQueueRoutes(kit: AuthKit, sessionManager: SessionManager, queueManager: QueueProcessorManager, eventBus: EventBus, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, projectStore?: ProjectRepository
|
|
10
|
+
export declare function createQueueRoutes(kit: AuthKit, sessionManager: SessionManager, queueManager: QueueProcessorManager, eventBus: EventBus, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, projectStore?: ProjectRepository,
|
|
11
|
+
/** ADR-036: обфускация user-сообщения (та же, что у `POST /sessions/:id/prompt`). */
|
|
12
|
+
obfuscate?: (sessionId: string, message: Message) => Promise<Message>): Hono;
|
package/dist/routes/queue.js
CHANGED
|
@@ -7,7 +7,9 @@ import { createProjectAccess } from './projects.js';
|
|
|
7
7
|
* доступа к сессии (владелец/ADMIN/участник проекта/LEAD). Логика роутов
|
|
8
8
|
* (clear/return/resume/retry-now/cancel-retry) — в core-фабрике.
|
|
9
9
|
*/
|
|
10
|
-
export function createQueueRoutes(kit, sessionManager, queueManager, eventBus, processMessage, projectStore
|
|
10
|
+
export function createQueueRoutes(kit, sessionManager, queueManager, eventBus, processMessage, projectStore,
|
|
11
|
+
/** ADR-036: обфускация user-сообщения (та же, что у `POST /sessions/:id/prompt`). */
|
|
12
|
+
obfuscate) {
|
|
11
13
|
const app = new Hono();
|
|
12
14
|
const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
|
|
13
15
|
// ADR-071 §2.4: владелец сессии — обычный пользователь.
|
|
@@ -39,6 +41,7 @@ export function createQueueRoutes(kit, sessionManager, queueManager, eventBus, p
|
|
|
39
41
|
? canReadProject(ctx, project, userId)
|
|
40
42
|
: canEditProjectContent(ctx, project, userId);
|
|
41
43
|
},
|
|
44
|
+
...(obfuscate ? { obfuscate } : {}),
|
|
42
45
|
}));
|
|
43
46
|
return app;
|
|
44
47
|
}
|
|
@@ -10,16 +10,25 @@ 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 { AttachmentThumbnailProvider } from '@itphx/synth-core';
|
|
16
|
+
import type { AttachmentsConfig, StickyNotesLimits } from '@itphx/synth-shared';
|
|
17
|
+
import type { QuestionService } from '@itphx/synth-core';
|
|
18
|
+
import type { WorktreeService } from '@itphx/synth-core';
|
|
19
|
+
import type { BackgroundRunService } from '@itphx/synth-core';
|
|
20
|
+
import type { ApprovalRegistry } from '@itphx/synth-core';
|
|
13
21
|
/**
|
|
14
22
|
* Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
|
|
15
23
|
* backend-специфичные роуты (MCP-скоуп сессии, секреты, export/import, отладка,
|
|
16
|
-
* оптимизация
|
|
17
|
-
*
|
|
18
|
-
* references, merge) — в `createSessionRoutes` из `@itphx/synth-core`.
|
|
24
|
+
* оптимизация контекста). Общая логика (список/создание/чтение/изменение/
|
|
25
|
+
* удаление, status/prompt/stats, заметки (`notes`), очередь+SSE, children/tree/
|
|
26
|
+
* fork, references, merge) — в `createSessionRoutes` из `@itphx/synth-core`.
|
|
19
27
|
*
|
|
20
28
|
* RBAC: core-фабрика параметризуется `resolveUserId`/`resolveOwner`/`resolveAuthor`,
|
|
21
29
|
* `canAccess` (владелец|ADMIN) и EventHub-хуками; remote/hybrid-ветки отключены
|
|
22
|
-
* (getRemoteClient не передаётся).
|
|
30
|
+
* (getRemoteClient не передаётся). Сессионного SSE нет: наблюдение за ходом —
|
|
31
|
+
* единственный глобальный канал `GET /api/v2/events` (ADR-118).
|
|
23
32
|
*
|
|
24
33
|
* Исключения из общего prefix-guard'а (собственные правила, роуты зарегистрированы
|
|
25
34
|
* до guard'а): `/:id/mcp` (владелец|ADMIN, ADR-071 §2.4) и `/:id/secrets`
|
|
@@ -38,5 +47,64 @@ resolveDefaultAgent?: () => string | Promise<string>,
|
|
|
38
47
|
* Не задан — core-фабрика использует прямой `SessionManager.createSession`.
|
|
39
48
|
*/
|
|
40
49
|
requestSessionService?: RequestSessionService,
|
|
41
|
-
/**
|
|
42
|
-
analytics?: AnalyticsRecorder
|
|
50
|
+
/** ADR-102: сборщик `activity` (меры `aborts`/`messages_*`) для core-фабрики. */
|
|
51
|
+
analytics?: AnalyticsRecorder,
|
|
52
|
+
/** ADR-107: агрегаты памяти сессии для `GET /:id/memory` (вкладка «Память»). */
|
|
53
|
+
memory?: {
|
|
54
|
+
facts: MemoryFactRepository;
|
|
55
|
+
indexes: MemoryIndexRepository;
|
|
56
|
+
isPluginActive: () => boolean;
|
|
57
|
+
},
|
|
58
|
+
/**
|
|
59
|
+
* Этап 1 roadmap 0.13 (блок 3): сервис «вопрос пользователю» (`ask_user`).
|
|
60
|
+
*
|
|
61
|
+
* Не задан — маршруты вопросов отвечают 503 (подсистема не подключена).
|
|
62
|
+
*/
|
|
63
|
+
questionService?: QuestionService,
|
|
64
|
+
/**
|
|
65
|
+
* ADR-114: сервис worktree'ов — привязка сессии к worktree
|
|
66
|
+
* (`PATCH /api/v2/sessions/:id { worktreeId }`).
|
|
67
|
+
*
|
|
68
|
+
* Не задан — поле `worktreeId` в PATCH игнорируется (привязка недоступна).
|
|
69
|
+
*/
|
|
70
|
+
worktreeService?: WorktreeService,
|
|
71
|
+
/**
|
|
72
|
+
* ADR-115: вложения сообщений — blob-порт, учёт ссылок и лимиты
|
|
73
|
+
* (прокидывается в core-фабрику: загрузка/раздача + `attachments` в промпте).
|
|
74
|
+
*/
|
|
75
|
+
attachments?: {
|
|
76
|
+
blobs: BlobStore;
|
|
77
|
+
blobRefs?: BlobRefRepository;
|
|
78
|
+
/**
|
|
79
|
+
* Настройки вложений: снимок **или** резолвер (ADR-115) — runtime-настройки
|
|
80
|
+
* из админки (`/api/v2/settings/attachments`) применяются на каждый вызов.
|
|
81
|
+
*/
|
|
82
|
+
config: AttachmentsConfig | (() => AttachmentsConfig);
|
|
83
|
+
/** ADR-115: провайдер серверных миниатюр (`?variant=thumb`). */
|
|
84
|
+
thumbnails?: AttachmentThumbnailProvider;
|
|
85
|
+
},
|
|
86
|
+
/**
|
|
87
|
+
* ADR-111/ADR-113: единый реестр фоновых прогонов — «Стоп» сессии
|
|
88
|
+
* останавливает и живые дочерние прогоны (фоновые саб-агенты и их процессы),
|
|
89
|
+
* решение 2026-10-28. Не задан — прежнее поведение (только свой стрим/очередь).
|
|
90
|
+
*/
|
|
91
|
+
backgroundService?: BackgroundRunService,
|
|
92
|
+
/**
|
|
93
|
+
* ADR-106 Ф3: реестр подтверждений — HTTP-ответ на подтверждение
|
|
94
|
+
* (`POST /:id/permissions/:approvalId`) принимает решение через него, как и
|
|
95
|
+
* WS-кадр `permission_reply`. Не задан — слой Authority выключен/в shadow.
|
|
96
|
+
*/
|
|
97
|
+
approvalRegistry?: ApprovalRegistry,
|
|
98
|
+
/**
|
|
99
|
+
* Instance-wide лимиты заметок сессии (`context.stickyNotes`, live-резолвер)
|
|
100
|
+
* — прокидывается в core-фабрику: роуты заметок живут там (единая реализация).
|
|
101
|
+
*/
|
|
102
|
+
getStickyNoteLimits?: () => StickyNotesLimits,
|
|
103
|
+
/**
|
|
104
|
+
* Доступность пары провайдер/модель **до постановки в очередь** (каталог
|
|
105
|
+
* инстанса). Не задана — проверка выключена.
|
|
106
|
+
*/
|
|
107
|
+
llmAvailability?: {
|
|
108
|
+
isProviderEnabled?: (name: string) => boolean | undefined;
|
|
109
|
+
isModelEnabled?: (provider: string, model: string) => boolean | undefined;
|
|
110
|
+
}): Hono;
|