@itphx/synth-backend 0.12.4 → 0.13.8

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 (57) hide show
  1. package/dist/app/deps.d.ts +15 -1
  2. package/dist/app/deps.js +553 -34
  3. package/dist/app/listen.js +56 -7
  4. package/dist/app/mount-routes.js +273 -32
  5. package/dist/app/public-routes.d.ts +2 -0
  6. package/dist/app/public-routes.js +11 -0
  7. package/dist/app/sse-events.d.ts +4 -0
  8. package/dist/app/sse-events.js +53 -6
  9. package/dist/app.d.ts +3 -1
  10. package/dist/app.js +33 -0
  11. package/dist/auth/api-key.d.ts +19 -0
  12. package/dist/auth/api-key.js +56 -0
  13. package/dist/auth/middleware.js +7 -3
  14. package/dist/events/hub.d.ts +17 -0
  15. package/dist/events/hub.js +50 -15
  16. package/dist/init.d.ts +1 -0
  17. package/dist/init.js +96 -0
  18. package/dist/lib/app-config.d.ts +4 -0
  19. package/dist/lib/app-config.js +16 -3
  20. package/dist/lib/bind-host.d.ts +10 -0
  21. package/dist/lib/bind-host.js +32 -0
  22. package/dist/lib/defaults-store.d.ts +1 -1
  23. package/dist/lib/defaults-store.js +1 -1
  24. package/dist/lib/i18n.js +26 -0
  25. package/dist/lib/recalc-can-summarize.js +8 -3
  26. package/dist/main.js +7 -2
  27. package/dist/middleware/rate-limiter.d.ts +4 -1
  28. package/dist/middleware/rate-limiter.js +15 -2
  29. package/dist/routes/agents.js +1 -0
  30. package/dist/routes/auth.js +29 -16
  31. package/dist/routes/llm.js +92 -12
  32. package/dist/routes/mcp-remote.d.ts +23 -0
  33. package/dist/routes/mcp-remote.js +152 -0
  34. package/dist/routes/mcp.d.ts +11 -6
  35. package/dist/routes/mcp.js +35 -6
  36. package/dist/routes/messages.js +2 -0
  37. package/dist/routes/projects.d.ts +9 -3
  38. package/dist/routes/projects.js +32 -3
  39. package/dist/routes/providers.d.ts +4 -1
  40. package/dist/routes/providers.js +19 -99
  41. package/dist/routes/queue.d.ts +4 -1
  42. package/dist/routes/queue.js +4 -1
  43. package/dist/routes/sessions.d.ts +49 -9
  44. package/dist/routes/sessions.js +299 -256
  45. package/package.json +6 -6
  46. package/dist/routes/audit.d.ts +0 -17
  47. package/dist/routes/audit.js +0 -64
  48. package/dist/routes/context.d.ts +0 -4
  49. package/dist/routes/context.js +0 -93
  50. package/dist/routes/debug.d.ts +0 -3
  51. package/dist/routes/debug.js +0 -30
  52. package/dist/routes/gateway-patterns.d.ts +0 -9
  53. package/dist/routes/gateway-patterns.js +0 -57
  54. package/dist/routes/logs.d.ts +0 -24
  55. package/dist/routes/logs.js +0 -100
  56. package/dist/routes/mcp-registry.d.ts +0 -28
  57. package/dist/routes/mcp-registry.js +0 -483
@@ -1,12 +1,17 @@
1
1
  import { Hono } from 'hono';
2
2
  import type { AuthKit } from '../auth/middleware.js';
3
3
  import type { SessionManager, McpManager } from '@itphx/synth-core';
4
- import type { McpRoutesOptions } from './mcp-registry.js';
5
- export type { McpRoutesOptions } from './mcp-registry.js';
4
+ import type { McpRegistryRoutesOptions } from '@itphx/synth-core';
5
+ export type { McpRegistryRoutesOptions as McpRoutesOptions } from '@itphx/synth-core';
6
+ export type { McpRemoteRoutesOptions } from './mcp-remote.js';
7
+ export { createMcpRemoteRoutes } from './mcp-remote.js';
6
8
  /**
7
9
  * Backend MCP: probe (`POST /probe`) — общая логика core-фабрики; legacy
8
- * `/servers*`, `/session/:id` и единый реестр `/registry*` (ADR-071) —
9
- * backend-only (см. `mcp-registry.ts`). Порядок монтирования: core probe
10
- * первым, затем backend-only.
10
+ * `/servers*`, `/session/:id` и единый реестр `/registry*` (ADR-071) — общая
11
+ * core-фабрика `createMcpRegistryRoutes` (backend передаёт RBAC-guard'ы и
12
+ * i18n-сообщения, логика — одна); `/remote/*` — backend-контракт удалённого MCP
13
+ * в режиме `tools` (PROP-125 §1, см. `mcp-remote.ts`); `/relay/*` — серверный
14
+ * MCP-relay, режим `relay` (PROP-125 §1, фабрика `createMcpRelayRoutes` в core).
15
+ * Порядок монтирования: core probe первым, затем backend-only.
11
16
  */
12
- export declare function createMcpRoutes(kit: AuthKit, mcpManager: McpManager | null, sessionManager: SessionManager | null, options: McpRoutesOptions): Hono;
17
+ export declare function createMcpRoutes(kit: AuthKit, mcpManager: McpManager | null, sessionManager: SessionManager | null, options: McpRegistryRoutesOptions): Hono;
@@ -1,15 +1,44 @@
1
1
  import { Hono } from 'hono';
2
- import { createMcpRoutes as createCoreMcpRoutes } from '@itphx/synth-core';
3
- import { createMcpRegistryRoutes } from './mcp-registry.js';
2
+ import { createMcpRoutes as createCoreMcpRoutes, createMcpRelayRoutes as createCoreMcpRelayRoutes, createMcpRegistryRoutes as createCoreMcpRegistryRoutes, } from '@itphx/synth-core';
3
+ import { createMcpRemoteRoutes } from './mcp-remote.js';
4
+ import { requireAdminOrScope, requireScopeForServiceKey } from '../auth/guards.js';
5
+ import { t } from '../lib/i18n.js';
6
+ export { createMcpRemoteRoutes } from './mcp-remote.js';
4
7
  /**
5
8
  * Backend MCP: probe (`POST /probe`) — общая логика core-фабрики; legacy
6
- * `/servers*`, `/session/:id` и единый реестр `/registry*` (ADR-071) —
7
- * backend-only (см. `mcp-registry.ts`). Порядок монтирования: core probe
8
- * первым, затем backend-only.
9
+ * `/servers*`, `/session/:id` и единый реестр `/registry*` (ADR-071) — общая
10
+ * core-фабрика `createMcpRegistryRoutes` (backend передаёт RBAC-guard'ы и
11
+ * i18n-сообщения, логика — одна); `/remote/*` — backend-контракт удалённого MCP
12
+ * в режиме `tools` (PROP-125 §1, см. `mcp-remote.ts`); `/relay/*` — серверный
13
+ * MCP-relay, режим `relay` (PROP-125 §1, фабрика `createMcpRelayRoutes` в core).
14
+ * Порядок монтирования: core probe первым, затем backend-only.
9
15
  */
10
16
  export function createMcpRoutes(kit, mcpManager, sessionManager, options) {
11
17
  const app = new Hono();
12
18
  app.route('/', createCoreMcpRoutes({ requireAuth: kit.requireAuth }, { mcpManager }));
13
- app.route('/', createMcpRegistryRoutes(kit, mcpManager, sessionManager, options));
19
+ app.route('/', createCoreMcpRegistryRoutes({ requireAuth: kit.requireAuth, isAdmin: (c) => kit.isAdmin(c) }, mcpManager, sessionManager, {
20
+ ...options,
21
+ // Managed RBAC (ADR-052/O1): `POST /servers` — только ADMIN; мутации
22
+ // legacy-сервера — ADMIN или scope `addons:install`; `POST /registry` —
23
+ // service-key обязан нести scope `addons:install` (интерактив — без
24
+ // изменений).
25
+ requireAdmin: kit.requireAdmin,
26
+ requireAdminOrScope: requireAdminOrScope('addons:install'),
27
+ requireScopeForServiceKey: requireScopeForServiceKey('addons:install'),
28
+ // i18n (ADR-041): тексты ошибок — через `t()`.
29
+ messages: {
30
+ sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
31
+ forbidden: (c) => t('auth.forbidden', undefined, c),
32
+ credentialNotFound: (c) => t('errors.notFound.credential', undefined, c),
33
+ },
34
+ }));
35
+ app.route('/', createMcpRemoteRoutes(kit, mcpManager, { registry: options.registry }));
36
+ // PROP-125 §1: relay — полноценный MCP-endpoint одного серверного сервера.
37
+ // Авторизация: интерактив — `requireAuth`; service-key — scope `mcp:invoke`.
38
+ app.route('/', createCoreMcpRelayRoutes({ requireAuth: kit.requireAuth }, {
39
+ mcpManager,
40
+ getEntry: (name) => options.registry.getByName(name),
41
+ authorize: requireScopeForServiceKey('mcp:invoke'),
42
+ }));
14
43
  return app;
15
44
  }
@@ -24,6 +24,8 @@ blobRefs) {
24
24
  forbidden: (c) => t('auth.forbidden', undefined, c),
25
25
  },
26
26
  onMessagesChanged: (sessionId) => recalcCanSummarize(sessionId),
27
+ // ADR-118 §4/§7: удаление сообщения публикует `message.deleted` в канал сессии.
28
+ eventBus,
27
29
  // ADR-115: ссылки на объекты вложений снимаются при удалении сообщения.
28
30
  ...(blobRefs ? { blobRefs } : {}),
29
31
  resolveUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
@@ -1,6 +1,6 @@
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
4
  import type { WorktreeService } from '@itphx/synth-core';
5
5
  import type { Project } from '@itphx/synth-shared';
6
6
  /**
@@ -31,7 +31,13 @@ mcpManager?: McpManager,
31
31
  /** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
32
32
  skillService?: SkillService, settingsStore?: SettingsRepository, mcpRegistryStore?: McpRegistryRepository,
33
33
  /**
34
- * ADR-114: сервис worktree'ов проекта — контур `/projects/:id/worktrees*`
34
+ * ADR-114: сервис worktree проекта — контур `/projects/:id/worktrees*`
35
35
  * (список/создание/удаление/prune). Не задан — роутов нет.
36
36
  */
37
- worktreeService?: WorktreeService): Hono;
37
+ worktreeService?: WorktreeService,
38
+ /**
39
+ * ADR-118 §4: шина событий — `PUT /:id`/`DELETE /:id` публикуют
40
+ * `project.updated`/`project.deleted` в канал каждой сессии проекта.
41
+ * Не задана — публикации нет (поведение прежнее).
42
+ */
43
+ eventBus?: EventBus): Hono;
@@ -35,10 +35,16 @@ mcpManager,
35
35
  /** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
36
36
  skillService, settingsStore, mcpRegistryStore,
37
37
  /**
38
- * ADR-114: сервис worktree'ов проекта — контур `/projects/:id/worktrees*`
38
+ * ADR-114: сервис worktree проекта — контур `/projects/:id/worktrees*`
39
39
  * (список/создание/удаление/prune). Не задан — роутов нет.
40
40
  */
41
- worktreeService) {
41
+ worktreeService,
42
+ /**
43
+ * ADR-118 §4: шина событий — `PUT /:id`/`DELETE /:id` публикуют
44
+ * `project.updated`/`project.deleted` в канал каждой сессии проекта.
45
+ * Не задана — публикации нет (поведение прежнее).
46
+ */
47
+ eventBus) {
42
48
  const { canManageProject, canEditProjectContent, canReadProject } = createProjectAccess(kit);
43
49
  return createCoreProjectRoutes({ requireAuth: kit.requireAuth }, store, undefined, {
44
50
  canManage: canManageProject,
@@ -55,6 +61,15 @@ worktreeService) {
55
61
  },
56
62
  autoProvisionWorkspace: true,
57
63
  getMcpServers: () => Object.keys(mcpManager?.getConfig() ?? {}),
64
+ // PROP-125: источник сервера (`local`/`server`) — бейдж «серверный» в UI.
65
+ // У backend удалённых записей нет (сервер отдаёт состав сам) → `local`,
66
+ // но контракт ответа единый с core.
67
+ getMcpServerSources: () => Object.fromEntries(Object.keys(mcpManager?.getConfig() ?? {}).map((name) => [
68
+ name,
69
+ (typeof mcpManager?.isRemoteServer === 'function' && mcpManager.isRemoteServer(name))
70
+ ? 'server'
71
+ : 'local',
72
+ ])),
58
73
  getProjectSeeds: async () => {
59
74
  const defaultMcpServers = mcpRegistryStore
60
75
  ? await mcpRegistryStore.toDefaultServers()
@@ -73,7 +88,21 @@ worktreeService) {
73
88
  sessionManager,
74
89
  getWorkspacesRoot: () => workspacesRoot,
75
90
  getOutsideRootPolicy: () => 'deny',
76
- // ADR-114: контур worktree'ов проекта.
91
+ // ADR-114: контур worktree проекта.
77
92
  ...(worktreeService ? { worktrees: worktreeService } : {}),
93
+ // ADR-118 §4: изменение/удаление проекта — в канал каждой сессии проекта.
94
+ ...(eventBus
95
+ ? {
96
+ sessionManager,
97
+ onProjectChanged: async (projectId, kind) => {
98
+ const sessions = await sessionManager.listSessions({ projectId });
99
+ for (const s of sessions) {
100
+ eventBus.publish(s.id, kind === 'deleted' ? 'project.deleted' : 'project.updated', {
101
+ project_id: projectId,
102
+ });
103
+ }
104
+ },
105
+ }
106
+ : {}),
78
107
  });
79
108
  }
@@ -13,7 +13,10 @@ export interface ProviderRoutesEgressOptions {
13
13
  }
14
14
  /**
15
15
  * Backend-обёртка над core-фабрикой провайдеров: добавляет только RBAC
16
- * (мутации — ADMIN), rate limit на тест подключения и backend-only `fetch-icon`.
16
+ * (мутации — ADMIN), rate limit на тест подключения и на `fetch-icon`.
17
+ *
18
+ * Сами роуты (в т.ч. `POST /fetch-icon`) — в core-фабрике; обёртка лишь
19
+ * передаёт guard'ы, rate limit, egress-политику/журнал и тексты (i18n).
17
20
  *
18
21
  * URL провайдера проверяется общей egress-политикой (`egress.tools`, live),
19
22
  * без собственной копии списка приватных диапазонов.
@@ -1,119 +1,37 @@
1
1
  import { Hono } from 'hono';
2
- import { createProviderRoutes as createCoreProviderRoutes, checkEgressUrl, fetchWithEgressGuard, sanitizeEgressTarget, PRIVATE_EGRESS_POLICY, } from '@itphx/synth-core';
2
+ import { createProviderRoutes as createCoreProviderRoutes } from '@itphx/synth-core';
3
3
  import { t } from '../lib/i18n.js';
4
4
  import { createRateLimiter } from '../middleware/rate-limiter.js';
5
5
  /**
6
6
  * Backend-обёртка над core-фабрикой провайдеров: добавляет только RBAC
7
- * (мутации — ADMIN), rate limit на тест подключения и backend-only `fetch-icon`.
7
+ * (мутации — ADMIN), rate limit на тест подключения и на `fetch-icon`.
8
+ *
9
+ * Сами роуты (в т.ч. `POST /fetch-icon`) — в core-фабрике; обёртка лишь
10
+ * передаёт guard'ы, rate limit, egress-политику/журнал и тексты (i18n).
8
11
  *
9
12
  * URL провайдера проверяется общей egress-политикой (`egress.tools`, live),
10
13
  * без собственной копии списка приватных диапазонов.
11
14
  */
12
15
  export function createProviderRoutes(kit, store, providerCache, egress = {}, getDefaultModel) {
13
16
  const app = new Hono();
14
- // POST /api/v2/providers/fetch-icon — получить favicon с домена (admin).
15
- // Статический сегмент регистрируем до core-роутов (в т.ч. /:name).
16
- app.post('/fetch-icon', kit.requireAdmin, createRateLimiter(10, 60_000), async (c) => {
17
- const body = await c.req.json().catch(() => ({}));
18
- const url = body.url?.trim();
19
- if (!url) {
20
- return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.urlRequired', undefined, c) } }, 400);
21
- }
22
- let origin;
23
- try {
24
- origin = new URL(url).origin;
25
- }
26
- catch {
27
- return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidUrl', undefined, c) } }, 400);
28
- }
29
- // SSRF-защита: resolved egress-политика (включая exceptions и DNS-резолв).
30
- const policy = egress.resolvePolicy ? await egress.resolvePolicy() : PRIVATE_EGRESS_POLICY;
31
- const networkCheck = await checkEgressUrl(origin, policy);
32
- if (!networkCheck.allowed) {
33
- // Отказ до HTTP-запроса — фиксируем в журнале egress (ответ остаётся 400).
34
- if (egress.log) {
35
- const target = sanitizeEgressTarget(origin);
36
- try {
37
- await egress.log({
38
- scope: 'providers',
39
- host: target.host,
40
- url: target.url,
41
- method: 'GET',
42
- status: 'blocked',
43
- reason: networkCheck.reason,
44
- ...(networkCheck.matchedRule ? { matchedRule: networkCheck.matchedRule } : {}),
45
- });
46
- }
47
- catch (err) {
48
- console.warn(`[providers] egress log: ${err instanceof Error ? err.message : String(err)}`);
49
- }
50
- }
51
- return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidUrl', undefined, c) } }, 400);
52
- }
53
- try {
54
- const iconUrl = `${origin}/favicon.ico`;
55
- const controller = new AbortController();
56
- const timer = setTimeout(() => controller.abort(), 5000);
57
- const resp = await fetchWithEgressGuard(iconUrl, {
58
- signal: controller.signal,
59
- headers: { Accept: 'image/*' },
60
- }, { policy, scope: 'providers', log: egress.log });
61
- clearTimeout(timer);
62
- if (resp.ok && resp.headers.get('content-type')?.includes('image')) {
63
- const buffer = await resp.arrayBuffer();
64
- const ct = resp.headers.get('content-type') || 'image/x-icon';
65
- const b64 = Buffer.from(buffer).toString('base64');
66
- return c.json({ icon: `data:${ct};base64,${b64}`, source: iconUrl });
67
- }
68
- // Попробовать найти <link rel="icon"> в HTML
69
- const htmlController = new AbortController();
70
- const htmlTimer = setTimeout(() => htmlController.abort(), 5000);
71
- const htmlResp = await fetchWithEgressGuard(origin, {
72
- signal: htmlController.signal,
73
- headers: { Accept: 'text/html' },
74
- }, { policy, scope: 'providers', log: egress.log });
75
- clearTimeout(htmlTimer);
76
- if (htmlResp.ok) {
77
- const html = await htmlResp.text();
78
- const match = html.match(/<link[^>]*rel=["'](?:shortcut\s+)?icon["'][^>]*href=["']([^"']+)["']/i)
79
- || html.match(/<link[^>]*href=["']([^"']+)["'][^>]*rel=["'](?:shortcut\s+)?icon["']/i);
80
- if (match) {
81
- const href = match[1];
82
- if (href) {
83
- let resolved = href;
84
- if (resolved.startsWith('/'))
85
- resolved = `${origin}${resolved}`;
86
- else if (!resolved.startsWith('http'))
87
- resolved = `${origin}/${resolved}`;
88
- const iconResp = await fetchWithEgressGuard(resolved, {
89
- signal: AbortSignal.timeout(5000),
90
- headers: { Accept: 'image/*' },
91
- }, { policy, scope: 'providers', log: egress.log });
92
- if (iconResp.ok) {
93
- const buffer = await iconResp.arrayBuffer();
94
- const ct = iconResp.headers.get('content-type') || 'image/x-icon';
95
- const b64 = Buffer.from(buffer).toString('base64');
96
- return c.json({ icon: `data:${ct};base64,${b64}`, source: resolved });
97
- }
98
- }
99
- }
100
- }
101
- return c.json({ icon: null, error: t('errors.notFound.favicon', undefined, c) });
102
- }
103
- catch (err) {
104
- return c.json({
105
- icon: null,
106
- error: err instanceof Error ? err.message : t('errors.faviconFetchError', undefined, c),
107
- });
108
- }
109
- });
110
- // Общая логика (GET /, POST /, GET/DELETE /:name, POST /:name/test) — в core.
17
+ // Общая логика (GET /, POST /, GET/DELETE /:name, POST /:name/test,
18
+ // POST /fetch-icon) — в core.
111
19
  app.route('/', createCoreProviderRoutes({ requireAuth: kit.requireAuth }, store, providerCache, {
112
20
  writeGuard: kit.requireAdmin,
113
21
  detailGuard: kit.requireAdmin,
114
22
  testEnabled: true,
115
23
  testGuard: kit.requireAdmin,
116
24
  testMiddleware: [createRateLimiter(5, 60_000)],
25
+ // POST /api/v2/providers/fetch-icon — favicon домена (admin).
26
+ // Статический сегмент `/fetch-icon` core-фабрика регистрирует ДО
27
+ // параметрических (`/:name`).
28
+ fetchIcon: {
29
+ enabled: true,
30
+ guard: kit.requireAdmin,
31
+ middleware: [createRateLimiter(10, 60_000)],
32
+ resolvePolicy: egress.resolvePolicy,
33
+ log: egress.log,
34
+ },
117
35
  getDefaultModel,
118
36
  messages: {
119
37
  nameRequired: (c) => t('errors.validation.nameRequired', undefined, c),
@@ -122,6 +40,8 @@ export function createProviderRoutes(kit, store, providerCache, egress = {}, get
122
40
  urlRequired: (c) => t('errors.validation.urlRequired', undefined, c),
123
41
  urlInvalid: (c) => t('errors.validation.invalidUrl', undefined, c),
124
42
  connectionError: (c) => t('errors.connectionError', undefined, c),
43
+ faviconNotFound: (c) => t('errors.notFound.favicon', undefined, c),
44
+ faviconFetchError: (c) => t('errors.faviconFetchError', undefined, c),
125
45
  },
126
46
  }));
127
47
  return app;
@@ -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
  }
@@ -12,23 +12,30 @@ import type { EventHub } from '../events/hub.js';
12
12
  import type { ProjectRepository } from '@itphx/synth-core';
13
13
  import type { MemoryFactRepository, MemoryIndexRepository } from '@itphx/synth-core';
14
14
  import type { BlobRefRepository, BlobStore } from '@itphx/synth-core';
15
- import type { AttachmentsConfig } from '@itphx/synth-shared';
15
+ import type { AttachmentThumbnailProvider } from '@itphx/synth-core';
16
+ import type { AttachmentsConfig, StickyNotesLimits } from '@itphx/synth-shared';
16
17
  import type { QuestionService } from '@itphx/synth-core';
17
18
  import type { WorktreeService } from '@itphx/synth-core';
19
+ import type { BackgroundRunService } from '@itphx/synth-core';
20
+ import type { ApprovalRegistry } from '@itphx/synth-core';
18
21
  /**
19
22
  * Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
20
- * backend-специфичные роуты (MCP-скоуп сессии, секреты, export/import, отладка,
21
- * оптимизация контекста, sticky notes). Общая логика (список/создание/чтение/
22
- * изменение/удаление, status/prompt/stats, очередь+SSE, children/tree/fork,
23
- * references, merge) — в `createSessionRoutes` из `@itphx/synth-core`.
23
+ * backend-специфичные роуты (MCP-скоуп сессии и секреты — более строгая политика
24
+ * managed, export/import, отладка). Общая логика (список/создание/чтение/изменение/
25
+ * удаление, status/prompt/stats, заметки (`notes`), очередь+SSE, children/tree/
26
+ * fork, references, merge, оптимизация контекста, core-версии MCP-скоупа и
27
+ * секретов для standalone/гибрида) — в `createSessionRoutes` из `@itphx/synth-core`.
24
28
  *
25
29
  * RBAC: core-фабрика параметризуется `resolveUserId`/`resolveOwner`/`resolveAuthor`,
26
30
  * `canAccess` (владелец|ADMIN) и EventHub-хуками; remote/hybrid-ветки отключены
27
- * (getRemoteClient не передаётся). `GET /:id/events` на backend не регистрируется.
31
+ * (getRemoteClient не передаётся). Сессионного SSE нет: наблюдение за ходом —
32
+ * единственный глобальный канал `GET /api/v2/events` (ADR-118).
28
33
  *
29
34
  * Исключения из общего prefix-guard'а (собственные правила, роуты зарегистрированы
30
35
  * до guard'а): `/:id/mcp` (владелец|ADMIN, ADR-071 §2.4) и `/:id/secrets`
31
- * (ADMIN|AUDITOR — карта обфускации). `/:id/export` — ПОД guard'ом: доступ к
36
+ * (ADMIN|AUDITOR — карта обфускации). В core-фабрике есть версии этих маршрутов
37
+ * для standalone/гибрида; здесь они регистрируются раньше и потому выигрывают,
38
+ * сохраняя прежнюю политику. `/:id/export` — ПОД guard'ом: доступ к
32
39
  * сессии решает ЕДИНЫЙ prefix-guard, а привилегию карты обфускации — отдельный
33
40
  * route-level guard (`createSessionExportGuard`, ADR-036); в обработчике проверок
34
41
  * доступа нет (инвариант 16).
@@ -58,7 +65,7 @@ memory?: {
58
65
  */
59
66
  questionService?: QuestionService,
60
67
  /**
61
- * ADR-114: сервис worktree'ов — привязка сессии к worktree
68
+ * ADR-114: сервис worktree — привязка сессии к worktree
62
69
  * (`PATCH /api/v2/sessions/:id { worktreeId }`).
63
70
  *
64
71
  * Не задан — поле `worktreeId` в PATCH игнорируется (привязка недоступна).
@@ -76,4 +83,37 @@ attachments?: {
76
83
  * из админки (`/api/v2/settings/attachments`) применяются на каждый вызов.
77
84
  */
78
85
  config: AttachmentsConfig | (() => AttachmentsConfig);
79
- }): Hono;
86
+ /** ADR-115: провайдер серверных миниатюр (`?variant=thumb`). */
87
+ thumbnails?: AttachmentThumbnailProvider;
88
+ },
89
+ /**
90
+ * ADR-111/ADR-113: единый реестр фоновых прогонов — «Стоп» сессии
91
+ * останавливает и живые дочерние прогоны (фоновые саб-агенты и их процессы),
92
+ * решение 2026-10-28. Не задан — прежнее поведение (только свой стрим/очередь).
93
+ */
94
+ backgroundService?: BackgroundRunService,
95
+ /**
96
+ * ADR-106 Ф3: реестр подтверждений — HTTP-ответ на подтверждение
97
+ * (`POST /:id/permissions/:approvalId`) принимает решение через него, как и
98
+ * WS-кадр `permission_reply`. Не задан — слой Authority выключен/в shadow.
99
+ */
100
+ approvalRegistry?: ApprovalRegistry,
101
+ /**
102
+ * Instance-wide лимиты заметок сессии (`context.stickyNotes`, live-резолвер)
103
+ * — прокидывается в core-фабрику: роуты заметок живут там (единая реализация).
104
+ */
105
+ getStickyNoteLimits?: () => StickyNotesLimits,
106
+ /**
107
+ * Доступность пары провайдер/модель **до постановки в очередь** (каталог
108
+ * инстанса). Не задана — проверка выключена.
109
+ */
110
+ llmAvailability?: {
111
+ isProviderEnabled?: (name: string) => boolean | undefined;
112
+ isModelEnabled?: (provider: string, model: string) => boolean | undefined;
113
+ },
114
+ /**
115
+ * Лимит тяжёлых операций ресурса сессий (`limits.sessionOpsPerMinute`,
116
+ * import/export/fork/merge) — live-геттер. Не задан — 10 (прежнее поведение).
117
+ * `0` — без ограничения; значение применяется без рестарта.
118
+ */
119
+ getSessionOpsPerMinute?: () => number): Hono;