@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.
Files changed (40) hide show
  1. package/dist/app/deps.d.ts +37 -5
  2. package/dist/app/deps.js +1172 -37
  3. package/dist/app/listen.d.ts +7 -1
  4. package/dist/app/listen.js +182 -16
  5. package/dist/app/mount-routes.js +493 -12
  6. package/dist/app/sse-events.d.ts +4 -0
  7. package/dist/app/sse-events.js +53 -6
  8. package/dist/app.d.ts +30 -2
  9. package/dist/app.js +54 -8
  10. package/dist/auth/guards.d.ts +15 -0
  11. package/dist/auth/guards.js +37 -1
  12. package/dist/auth/plugin-scope.d.ts +10 -0
  13. package/dist/auth/plugin-scope.js +69 -0
  14. package/dist/events/hub.d.ts +17 -0
  15. package/dist/events/hub.js +46 -14
  16. package/dist/lib/app-config.d.ts +4 -0
  17. package/dist/lib/app-config.js +4 -2
  18. package/dist/lib/defaults-store.d.ts +1 -1
  19. package/dist/lib/defaults-store.js +2 -2
  20. package/dist/lib/i18n.js +123 -2
  21. package/dist/lib/recalc-can-summarize.js +8 -3
  22. package/dist/main.js +52 -3
  23. package/dist/routes/agents.d.ts +11 -2
  24. package/dist/routes/agents.js +15 -2
  25. package/dist/routes/auth.d.ts +11 -1
  26. package/dist/routes/auth.js +45 -3
  27. package/dist/routes/llm.js +29 -7
  28. package/dist/routes/mcp-registry.d.ts +13 -1
  29. package/dist/routes/mcp-registry.js +120 -19
  30. package/dist/routes/messages.d.ts +4 -2
  31. package/dist/routes/messages.js +7 -1
  32. package/dist/routes/processes.d.ts +34 -0
  33. package/dist/routes/processes.js +26 -0
  34. package/dist/routes/projects.d.ts +14 -2
  35. package/dist/routes/projects.js +28 -1
  36. package/dist/routes/queue.d.ts +4 -1
  37. package/dist/routes/queue.js +4 -1
  38. package/dist/routes/sessions.d.ts +74 -6
  39. package/dist/routes/sessions.js +85 -93
  40. 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
- const maps = await registry.toManagerMaps();
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
- const entry = await registry.add({
311
- name,
312
- config,
313
- origin: entryOrigin,
314
- trust,
315
- author,
316
- enabled,
317
- enabledByDefault,
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
- const updated = await registry.update(id, parsed.data);
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): Hono;
10
+ export declare function createMessageRoutes(kit: AuthKit, sessionManager: SessionManager, contextOptimizer: ContextOptimizer | null, eventBus: EventBus, projectStore?: ProjectRepository,
11
+ /** ADR-115: учёт ссылок на объекты blob-хранилища (снятие при удалении). */
12
+ blobRefs?: BlobRefRepository): Hono;
@@ -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): Hono;
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;
@@ -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
  }
@@ -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): Hono;
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;
@@ -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
- * оптимизация контекста, sticky notes). Общая логика (список/создание/чтение/
17
- * изменение/удаление, status/prompt/stats, очередь+SSE, children/tree/fork,
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 не передаётся). `GET /:id/events` на backend не регистрируется.
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
- /** PROP-102: сборщик `activity` (меры `aborts`/`messages_*`) для core-фабрики. */
42
- analytics?: AnalyticsRecorder): Hono;
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;