@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.
- package/dist/app/deps.d.ts +15 -1
- package/dist/app/deps.js +553 -34
- package/dist/app/listen.js +56 -7
- package/dist/app/mount-routes.js +273 -32
- package/dist/app/public-routes.d.ts +2 -0
- package/dist/app/public-routes.js +11 -0
- package/dist/app/sse-events.d.ts +4 -0
- package/dist/app/sse-events.js +53 -6
- package/dist/app.d.ts +3 -1
- package/dist/app.js +33 -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.d.ts +17 -0
- package/dist/events/hub.js +50 -15
- package/dist/init.d.ts +1 -0
- package/dist/init.js +96 -0
- package/dist/lib/app-config.d.ts +4 -0
- package/dist/lib/app-config.js +16 -3
- package/dist/lib/bind-host.d.ts +10 -0
- package/dist/lib/bind-host.js +32 -0
- package/dist/lib/defaults-store.d.ts +1 -1
- package/dist/lib/defaults-store.js +1 -1
- package/dist/lib/i18n.js +26 -0
- package/dist/lib/recalc-can-summarize.js +8 -3
- package/dist/main.js +7 -2
- package/dist/middleware/rate-limiter.d.ts +4 -1
- package/dist/middleware/rate-limiter.js +15 -2
- package/dist/routes/agents.js +1 -0
- package/dist/routes/auth.js +29 -16
- package/dist/routes/llm.js +92 -12
- 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/messages.js +2 -0
- package/dist/routes/projects.d.ts +9 -3
- package/dist/routes/projects.js +32 -3
- package/dist/routes/providers.d.ts +4 -1
- package/dist/routes/providers.js +19 -99
- package/dist/routes/queue.d.ts +4 -1
- package/dist/routes/queue.js +4 -1
- package/dist/routes/sessions.d.ts +49 -9
- package/dist/routes/sessions.js +299 -256
- package/package.json +6 -6
- 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
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
|
}
|
package/dist/routes/messages.js
CHANGED
|
@@ -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
|
|
34
|
+
* ADR-114: сервис worktree проекта — контур `/projects/:id/worktrees*`
|
|
35
35
|
* (список/создание/удаление/prune). Не задан — роутов нет.
|
|
36
36
|
*/
|
|
37
|
-
worktreeService?: WorktreeService
|
|
37
|
+
worktreeService?: WorktreeService,
|
|
38
|
+
/**
|
|
39
|
+
* ADR-118 §4: шина событий — `PUT /:id`/`DELETE /:id` публикуют
|
|
40
|
+
* `project.updated`/`project.deleted` в канал каждой сессии проекта.
|
|
41
|
+
* Не задана — публикации нет (поведение прежнее).
|
|
42
|
+
*/
|
|
43
|
+
eventBus?: EventBus): Hono;
|
package/dist/routes/projects.js
CHANGED
|
@@ -35,10 +35,16 @@ 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
|
-
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 на тест подключения и
|
|
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;
|
package/dist/routes/queue.d.ts
CHANGED
|
@@ -1,9 +1,12 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
3
|
import type { SessionManager, QueueProcessorManager, ChatOrchestrator, EventBus, ProjectRepository } from '@itphx/synth-core';
|
|
4
|
+
import type { Message } from '@itphx/synth-shared';
|
|
4
5
|
/**
|
|
5
6
|
* Backend-обёртка над core-фабрикой очереди: добавляет i18n-сообщения и RBAC
|
|
6
7
|
* доступа к сессии (владелец/ADMIN/участник проекта/LEAD). Логика роутов
|
|
7
8
|
* (clear/return/resume/retry-now/cancel-retry) — в core-фабрике.
|
|
8
9
|
*/
|
|
9
|
-
export declare function createQueueRoutes(kit: AuthKit, sessionManager: SessionManager, queueManager: QueueProcessorManager, eventBus: EventBus, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, projectStore?: ProjectRepository
|
|
10
|
+
export declare function createQueueRoutes(kit: AuthKit, sessionManager: SessionManager, queueManager: QueueProcessorManager, eventBus: EventBus, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, projectStore?: ProjectRepository,
|
|
11
|
+
/** ADR-036: обфускация user-сообщения (та же, что у `POST /sessions/:id/prompt`). */
|
|
12
|
+
obfuscate?: (sessionId: string, message: Message) => Promise<Message>): Hono;
|
package/dist/routes/queue.js
CHANGED
|
@@ -7,7 +7,9 @@ import { createProjectAccess } from './projects.js';
|
|
|
7
7
|
* доступа к сессии (владелец/ADMIN/участник проекта/LEAD). Логика роутов
|
|
8
8
|
* (clear/return/resume/retry-now/cancel-retry) — в core-фабрике.
|
|
9
9
|
*/
|
|
10
|
-
export function createQueueRoutes(kit, sessionManager, queueManager, eventBus, processMessage, projectStore
|
|
10
|
+
export function createQueueRoutes(kit, sessionManager, queueManager, eventBus, processMessage, projectStore,
|
|
11
|
+
/** ADR-036: обфускация user-сообщения (та же, что у `POST /sessions/:id/prompt`). */
|
|
12
|
+
obfuscate) {
|
|
11
13
|
const app = new Hono();
|
|
12
14
|
const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
|
|
13
15
|
// ADR-071 §2.4: владелец сессии — обычный пользователь.
|
|
@@ -39,6 +41,7 @@ export function createQueueRoutes(kit, sessionManager, queueManager, eventBus, p
|
|
|
39
41
|
? canReadProject(ctx, project, userId)
|
|
40
42
|
: canEditProjectContent(ctx, project, userId);
|
|
41
43
|
},
|
|
44
|
+
...(obfuscate ? { obfuscate } : {}),
|
|
42
45
|
}));
|
|
43
46
|
return app;
|
|
44
47
|
}
|
|
@@ -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 {
|
|
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-скоуп
|
|
21
|
-
*
|
|
22
|
-
*
|
|
23
|
-
* references, merge
|
|
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 не передаётся).
|
|
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 — карта обфускации).
|
|
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
|
|
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
|
-
|
|
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;
|