@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.
- package/dist/app/deps.d.ts +8 -0
- package/dist/app/deps.js +126 -9
- package/dist/app/mount-routes.js +155 -32
- package/dist/app/public-routes.d.ts +2 -0
- package/dist/app/public-routes.js +11 -0
- package/dist/app.d.ts +1 -1
- package/dist/app.js +31 -0
- package/dist/auth/api-key.d.ts +19 -0
- package/dist/auth/api-key.js +56 -0
- package/dist/auth/middleware.js +7 -3
- package/dist/events/hub.js +4 -1
- package/dist/init.d.ts +1 -0
- package/dist/init.js +96 -0
- package/dist/lib/app-config.js +12 -1
- package/dist/lib/bind-host.d.ts +10 -0
- package/dist/lib/bind-host.js +32 -0
- package/dist/lib/i18n.js +10 -0
- package/dist/main.js +4 -1
- package/dist/middleware/rate-limiter.d.ts +4 -1
- package/dist/middleware/rate-limiter.js +15 -2
- package/dist/routes/auth.js +5 -20
- package/dist/routes/llm.js +65 -7
- package/dist/routes/mcp-remote.d.ts +23 -0
- package/dist/routes/mcp-remote.js +152 -0
- package/dist/routes/mcp.d.ts +11 -6
- package/dist/routes/mcp.js +35 -6
- package/dist/routes/projects.d.ts +1 -1
- package/dist/routes/projects.js +11 -2
- package/dist/routes/providers.d.ts +4 -1
- package/dist/routes/providers.js +19 -99
- package/dist/routes/sessions.d.ts +15 -6
- package/dist/routes/sessions.js +257 -183
- package/package.json +4 -4
- package/dist/routes/audit.d.ts +0 -17
- package/dist/routes/audit.js +0 -64
- package/dist/routes/context.d.ts +0 -4
- package/dist/routes/context.js +0 -93
- package/dist/routes/debug.d.ts +0 -3
- package/dist/routes/debug.js +0 -30
- package/dist/routes/gateway-patterns.d.ts +0 -9
- package/dist/routes/gateway-patterns.js +0 -57
- package/dist/routes/logs.d.ts +0 -24
- package/dist/routes/logs.js +0 -100
- package/dist/routes/mcp-registry.d.ts +0 -28
- 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
|
+
}
|
package/dist/routes/mcp.d.ts
CHANGED
|
@@ -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 {
|
|
5
|
-
export type { McpRoutesOptions } from '
|
|
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
|
-
*
|
|
10
|
-
*
|
|
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:
|
|
17
|
+
export declare function createMcpRoutes(kit: AuthKit, mcpManager: McpManager | null, sessionManager: SessionManager | null, options: McpRegistryRoutesOptions): Hono;
|
package/dist/routes/mcp.js
CHANGED
|
@@ -1,15 +1,44 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
|
-
import { createMcpRoutes as createCoreMcpRoutes } from '@itphx/synth-core';
|
|
3
|
-
import {
|
|
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
|
-
*
|
|
8
|
-
*
|
|
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('/',
|
|
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
|
|
34
|
+
* ADR-114: сервис worktree проекта — контур `/projects/:id/worktrees*`
|
|
35
35
|
* (список/создание/удаление/prune). Не задан — роутов нет.
|
|
36
36
|
*/
|
|
37
37
|
worktreeService?: WorktreeService,
|
package/dist/routes/projects.js
CHANGED
|
@@ -35,7 +35,7 @@ mcpManager,
|
|
|
35
35
|
/** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
|
|
36
36
|
skillService, settingsStore, mcpRegistryStore,
|
|
37
37
|
/**
|
|
38
|
-
* ADR-114: сервис worktree
|
|
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 на тест подключения и
|
|
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
|
* без собственной копии списка приватных диапазонов.
|
package/dist/routes/providers.js
CHANGED
|
@@ -1,119 +1,37 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
|
-
import { createProviderRoutes as createCoreProviderRoutes
|
|
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 на тест подключения и
|
|
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
|
-
//
|
|
15
|
-
//
|
|
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-скоуп
|
|
24
|
-
*
|
|
23
|
+
* backend-специфичные роуты (MCP-скоуп сессии и секреты — более строгая политика
|
|
24
|
+
* managed, export/import, отладка). Общая логика (список/создание/чтение/изменение/
|
|
25
25
|
* удаление, status/prompt/stats, заметки (`notes`), очередь+SSE, children/tree/
|
|
26
|
-
* fork, references, merge
|
|
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 — карта обфускации).
|
|
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
|
|
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
|
-
}
|
|
113
|
+
},
|
|
114
|
+
/**
|
|
115
|
+
* Лимит тяжёлых операций ресурса сессий (`limits.sessionOpsPerMinute`,
|
|
116
|
+
* import/export/fork/merge) — live-геттер. Не задан — 10 (прежнее поведение).
|
|
117
|
+
* `0` — без ограничения; значение применяется без рестарта.
|
|
118
|
+
*/
|
|
119
|
+
getSessionOpsPerMinute?: () => number): Hono;
|