@itphx/synth-backend 0.13.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 (45) hide show
  1. package/dist/app/deps.d.ts +8 -0
  2. package/dist/app/deps.js +126 -9
  3. package/dist/app/mount-routes.js +155 -32
  4. package/dist/app/public-routes.d.ts +2 -0
  5. package/dist/app/public-routes.js +11 -0
  6. package/dist/app.d.ts +1 -1
  7. package/dist/app.js +31 -0
  8. package/dist/auth/api-key.d.ts +19 -0
  9. package/dist/auth/api-key.js +56 -0
  10. package/dist/auth/middleware.js +7 -3
  11. package/dist/events/hub.js +4 -1
  12. package/dist/init.d.ts +1 -0
  13. package/dist/init.js +96 -0
  14. package/dist/lib/app-config.js +12 -1
  15. package/dist/lib/bind-host.d.ts +10 -0
  16. package/dist/lib/bind-host.js +32 -0
  17. package/dist/lib/i18n.js +10 -0
  18. package/dist/main.js +4 -1
  19. package/dist/middleware/rate-limiter.d.ts +4 -1
  20. package/dist/middleware/rate-limiter.js +15 -2
  21. package/dist/routes/auth.js +5 -20
  22. package/dist/routes/llm.js +65 -7
  23. package/dist/routes/mcp-remote.d.ts +23 -0
  24. package/dist/routes/mcp-remote.js +152 -0
  25. package/dist/routes/mcp.d.ts +11 -6
  26. package/dist/routes/mcp.js +35 -6
  27. package/dist/routes/projects.d.ts +1 -1
  28. package/dist/routes/projects.js +11 -2
  29. package/dist/routes/providers.d.ts +4 -1
  30. package/dist/routes/providers.js +19 -99
  31. package/dist/routes/sessions.d.ts +15 -6
  32. package/dist/routes/sessions.js +257 -183
  33. package/package.json +4 -4
  34. package/dist/routes/audit.d.ts +0 -17
  35. package/dist/routes/audit.js +0 -64
  36. package/dist/routes/context.d.ts +0 -4
  37. package/dist/routes/context.js +0 -93
  38. package/dist/routes/debug.d.ts +0 -3
  39. package/dist/routes/debug.js +0 -30
  40. package/dist/routes/gateway-patterns.d.ts +0 -9
  41. package/dist/routes/gateway-patterns.js +0 -57
  42. package/dist/routes/logs.d.ts +0 -24
  43. package/dist/routes/logs.js +0 -100
  44. package/dist/routes/mcp-registry.d.ts +0 -28
  45. package/dist/routes/mcp-registry.js +0 -483
@@ -0,0 +1,23 @@
1
+ import { Hono } from 'hono';
2
+ import type { AuthKit } from '../auth/middleware.js';
3
+ import type { McpManager, McpRegistryRepository } from '@itphx/synth-core';
4
+ /**
5
+ * PROP-125 §1: backend-контракт удалённого MCP в режиме `tools`.
6
+ *
7
+ * Локальный core гибрида ходит сюда вместо прямого egress к MCP-серверу:
8
+ * секреты и сеть остаются на сервере (ADR-105/ADR-099), а локальная сессия
9
+ * получает тот же шейп результата, что и протокол исполнителя 5.
10
+ *
11
+ * Маршруты:
12
+ * - `GET /remote/servers` — состав серверов реестра (все записи, решение 10);
13
+ * - `GET /remote/tools?server=…` — схемы инструментов + `instructions`;
14
+ * - `POST /remote/call` — вызов инструмента `{server, tool, arguments?, meta?}`.
15
+ *
16
+ * Авторизация: интерактивный пользователь — `requireAuth` (ADR-043);
17
+ * service-key — scope `mcp:invoke` (решение 9 владельца).
18
+ */
19
+ export interface McpRemoteRoutesOptions {
20
+ /** Единый реестр MCP-серверов (ADR-071 §2.5) — источник истины для `/remote/*`. */
21
+ registry: McpRegistryRepository;
22
+ }
23
+ export declare function createMcpRemoteRoutes(kit: AuthKit, mcpManager: McpManager | null, options: McpRemoteRoutesOptions): Hono;
@@ -0,0 +1,152 @@
1
+ import { Hono } from 'hono';
2
+ import { z } from 'zod';
3
+ import { requireScopeForServiceKey } from '../auth/guards.js';
4
+ /** Тело `POST /remote/call` — поля контракта `RemoteMcpCallRequest`. */
5
+ const remoteCallSchema = z.object({
6
+ server: z.string().min(1),
7
+ tool: z.string().min(1),
8
+ arguments: z.record(z.string(), z.unknown()).optional(),
9
+ meta: z.record(z.string(), z.unknown()).optional(),
10
+ });
11
+ /** Текст ошибки: только текст исключения — без конфига, URL и секретов. */
12
+ function errorMessage(err) {
13
+ return err instanceof Error ? err.message : String(err);
14
+ }
15
+ export function createMcpRemoteRoutes(kit, mcpManager, options) {
16
+ const app = new Hono();
17
+ const registry = options.registry;
18
+ /**
19
+ * Транспортный статус сервера для локального клиента:
20
+ * `connected` → `up`, `disconnected` → `idle`, `error`/`circuit-open` → `down`.
21
+ */
22
+ const remoteStatus = (name) => {
23
+ if (!mcpManager)
24
+ return 'idle';
25
+ const status = mcpManager.getServerStatus(name);
26
+ if (status === 'connected')
27
+ return 'up';
28
+ if (status === 'disconnected')
29
+ return 'idle';
30
+ return 'down';
31
+ };
32
+ /** Подключить сервер, если он ещё не подключён (иначе — успех). */
33
+ const ensureConnected = async (name) => {
34
+ if (!mcpManager)
35
+ return;
36
+ if (mcpManager.getServerStatus(name) === 'connected')
37
+ return;
38
+ await mcpManager.connectServer(name);
39
+ };
40
+ // --- Список серверных MCP-серверов (все записи реестра) ---
41
+ app.get('/remote/servers', kit.requireAuth, requireScopeForServiceKey('mcp:invoke'), async (c) => {
42
+ const entries = await registry.list();
43
+ const servers = entries.map((entry) => {
44
+ const instructions = mcpManager?.getServerInstructions(entry.name);
45
+ return {
46
+ name: entry.name,
47
+ type: entry.config.type,
48
+ origin: entry.origin,
49
+ trust: entry.trust,
50
+ enabled: entry.enabled,
51
+ enabledByDefault: entry.enabledByDefault,
52
+ remoteMode: entry.remoteMode ?? 'auto',
53
+ status: remoteStatus(entry.name),
54
+ toolCount: mcpManager?.getServerTools(entry.name)?.length ?? 0,
55
+ ...(instructions ? { instructions } : {}),
56
+ };
57
+ });
58
+ return c.json(servers);
59
+ });
60
+ // --- Схемы инструментов сервера ---
61
+ app.get('/remote/tools', kit.requireAuth, requireScopeForServiceKey('mcp:invoke'), async (c) => {
62
+ // Имя сервера ищем в реестре **как есть** (без trim): имя записи реестра —
63
+ // точный ключ. Пустое/пробельное значение — «параметр не задан».
64
+ const name = c.req.query('server') ?? '';
65
+ if (!name.trim()) {
66
+ return c.json({
67
+ error: { code: 'VALIDATION_ERROR', message: 'Параметр server обязателен' },
68
+ }, 400);
69
+ }
70
+ const entry = await registry.getByName(name);
71
+ if (!entry) {
72
+ return c.json({
73
+ error: { code: 'MCP_REMOTE_SERVER_NOT_FOUND', message: `MCP-сервер "${name}" не найден` },
74
+ }, 404);
75
+ }
76
+ if (!mcpManager) {
77
+ return c.json({
78
+ error: { code: 'MCP_REMOTE_UNAVAILABLE', message: 'MCP-менеджер недоступен' },
79
+ }, 503);
80
+ }
81
+ try {
82
+ await ensureConnected(name);
83
+ }
84
+ catch (err) {
85
+ return c.json({
86
+ error: { code: 'MCP_REMOTE_SERVER_DOWN', message: errorMessage(err) },
87
+ }, 502);
88
+ }
89
+ const body = {
90
+ server: name,
91
+ instructions: mcpManager.getServerInstructions(name),
92
+ tools: (mcpManager.getServerTools(name) ?? []).map((tool) => ({ server: name, ...tool })),
93
+ };
94
+ return c.json(body);
95
+ });
96
+ // --- Вызов инструмента серверного MCP-сервера ---
97
+ app.post('/remote/call', kit.requireAuth, requireScopeForServiceKey('mcp:invoke'), async (c) => {
98
+ const raw = await c.req.json().catch(() => null);
99
+ const parsed = remoteCallSchema.safeParse(raw);
100
+ if (!parsed.success) {
101
+ return c.json({
102
+ error: { code: 'VALIDATION_ERROR', message: parsed.error.message },
103
+ }, 400);
104
+ }
105
+ const { server, tool, arguments: args, meta } = parsed.data;
106
+ const entry = await registry.getByName(server);
107
+ if (!entry) {
108
+ return c.json({
109
+ error: { code: 'MCP_REMOTE_SERVER_NOT_FOUND', message: `MCP-сервер "${server}" не найден` },
110
+ }, 404);
111
+ }
112
+ // Системный мастер-флаг: выключенный администратором сервер недоступен нигде.
113
+ if (entry.enabled === false) {
114
+ return c.json({
115
+ error: { code: 'MCP_SERVER_DISABLED', message: 'MCP-сервер отключён администратором' },
116
+ }, 409);
117
+ }
118
+ if (!mcpManager) {
119
+ return c.json({
120
+ error: { code: 'MCP_REMOTE_UNAVAILABLE', message: 'MCP-менеджер недоступен' },
121
+ }, 503);
122
+ }
123
+ try {
124
+ await ensureConnected(server);
125
+ }
126
+ catch (err) {
127
+ return c.json({
128
+ error: { code: 'MCP_REMOTE_SERVER_DOWN', message: errorMessage(err) },
129
+ }, 502);
130
+ }
131
+ try {
132
+ const result = await mcpManager.callServerTool(server, tool, args ?? {}, meta);
133
+ const attachments = result.attachments?.map((item) => ({
134
+ mime: item.mime,
135
+ ...(item.name ? { name: item.name } : {}),
136
+ base64: item.base64,
137
+ }));
138
+ const payload = {
139
+ content: result.content,
140
+ isError: result.isError,
141
+ ...(attachments && attachments.length > 0 ? { attachments } : {}),
142
+ };
143
+ return c.json(payload);
144
+ }
145
+ catch (err) {
146
+ return c.json({
147
+ error: { code: 'MCP_REMOTE_CALL_FAILED', message: errorMessage(err) },
148
+ }, 502);
149
+ }
150
+ });
151
+ return app;
152
+ }
@@ -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
  }
@@ -31,7 +31,7 @@ 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
37
  worktreeService?: WorktreeService,
@@ -35,7 +35,7 @@ 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
41
  worktreeService,
@@ -61,6 +61,15 @@ eventBus) {
61
61
  },
62
62
  autoProvisionWorkspace: true,
63
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
+ ])),
64
73
  getProjectSeeds: async () => {
65
74
  const defaultMcpServers = mcpRegistryStore
66
75
  ? await mcpRegistryStore.toDefaultServers()
@@ -79,7 +88,7 @@ eventBus) {
79
88
  sessionManager,
80
89
  getWorkspacesRoot: () => workspacesRoot,
81
90
  getOutsideRootPolicy: () => 'deny',
82
- // ADR-114: контур worktree'ов проекта.
91
+ // ADR-114: контур worktree проекта.
83
92
  ...(worktreeService ? { worktrees: worktreeService } : {}),
84
93
  // ADR-118 §4: изменение/удаление проекта — в канал каждой сессии проекта.
85
94
  ...(eventBus
@@ -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;
@@ -20,10 +20,11 @@ import type { BackgroundRunService } from '@itphx/synth-core';
20
20
  import type { ApprovalRegistry } from '@itphx/synth-core';
21
21
  /**
22
22
  * Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
23
- * backend-специфичные роуты (MCP-скоуп сессии, секреты, export/import, отладка,
24
- * оптимизация контекста). Общая логика (список/создание/чтение/изменение/
23
+ * backend-специфичные роуты (MCP-скоуп сессии и секреты — более строгая политика
24
+ * managed, export/import, отладка). Общая логика (список/создание/чтение/изменение/
25
25
  * удаление, status/prompt/stats, заметки (`notes`), очередь+SSE, children/tree/
26
- * fork, references, merge) — в `createSessionRoutes` из `@itphx/synth-core`.
26
+ * fork, references, merge, оптимизация контекста, core-версии MCP-скоупа и
27
+ * секретов для standalone/гибрида) — в `createSessionRoutes` из `@itphx/synth-core`.
27
28
  *
28
29
  * RBAC: core-фабрика параметризуется `resolveUserId`/`resolveOwner`/`resolveAuthor`,
29
30
  * `canAccess` (владелец|ADMIN) и EventHub-хуками; remote/hybrid-ветки отключены
@@ -32,7 +33,9 @@ import type { ApprovalRegistry } from '@itphx/synth-core';
32
33
  *
33
34
  * Исключения из общего prefix-guard'а (собственные правила, роуты зарегистрированы
34
35
  * до guard'а): `/:id/mcp` (владелец|ADMIN, ADR-071 §2.4) и `/:id/secrets`
35
- * (ADMIN|AUDITOR — карта обфускации). `/:id/export` — ПОД guard'ом: доступ к
36
+ * (ADMIN|AUDITOR — карта обфускации). В core-фабрике есть версии этих маршрутов
37
+ * для standalone/гибрида; здесь они регистрируются раньше и потому выигрывают,
38
+ * сохраняя прежнюю политику. `/:id/export` — ПОД guard'ом: доступ к
36
39
  * сессии решает ЕДИНЫЙ prefix-guard, а привилегию карты обфускации — отдельный
37
40
  * route-level guard (`createSessionExportGuard`, ADR-036); в обработчике проверок
38
41
  * доступа нет (инвариант 16).
@@ -62,7 +65,7 @@ memory?: {
62
65
  */
63
66
  questionService?: QuestionService,
64
67
  /**
65
- * ADR-114: сервис worktree'ов — привязка сессии к worktree
68
+ * ADR-114: сервис worktree — привязка сессии к worktree
66
69
  * (`PATCH /api/v2/sessions/:id { worktreeId }`).
67
70
  *
68
71
  * Не задан — поле `worktreeId` в PATCH игнорируется (привязка недоступна).
@@ -107,4 +110,10 @@ getStickyNoteLimits?: () => StickyNotesLimits,
107
110
  llmAvailability?: {
108
111
  isProviderEnabled?: (name: string) => boolean | undefined;
109
112
  isModelEnabled?: (provider: string, model: string) => boolean | undefined;
110
- }): Hono;
113
+ },
114
+ /**
115
+ * Лимит тяжёлых операций ресурса сессий (`limits.sessionOpsPerMinute`,
116
+ * import/export/fork/merge) — live-геттер. Не задан — 10 (прежнее поведение).
117
+ * `0` — без ограничения; значение применяется без рестарта.
118
+ */
119
+ getSessionOpsPerMinute?: () => number): Hono;