@itphx/synth-backend 0.10.0 → 0.11.3
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/bootstrap.d.ts +11 -0
- package/dist/app/bootstrap.js +19 -0
- package/dist/app/deps.d.ts +124 -0
- package/dist/app/deps.js +751 -0
- package/dist/app/listen.d.ts +34 -0
- package/dist/app/listen.js +309 -0
- package/dist/app/mount-routes.d.ts +31 -0
- package/dist/app/mount-routes.js +696 -0
- package/dist/app/sse-events.d.ts +15 -0
- package/dist/app/sse-events.js +83 -0
- package/dist/app.d.ts +30 -17
- package/dist/app.js +164 -1337
- package/dist/auth/guards.d.ts +2 -1
- package/dist/auth/guards.js +10 -2
- package/dist/auth/middleware.d.ts +9 -14
- package/dist/auth/middleware.js +38 -6
- package/dist/auth/oidc.d.ts +22 -0
- package/dist/auth/oidc.js +68 -9
- package/dist/auth/service-scope.d.ts +8 -4
- package/dist/auth/service-scope.js +9 -5
- package/dist/events/hub.d.ts +2 -2
- package/dist/events/hub.js +3 -38
- package/dist/lib/app-config.d.ts +2 -0
- package/dist/lib/app-config.js +3 -2
- package/dist/lib/cors.d.ts +23 -0
- package/dist/lib/cors.js +24 -0
- package/dist/lib/defaults-store.d.ts +2 -25
- package/dist/lib/defaults-store.js +5 -87
- package/dist/lib/i18n.js +58 -6
- package/dist/main.js +23 -7
- package/dist/middleware/rate-limiter.d.ts +4 -1
- package/dist/middleware/rate-limiter.js +4 -2
- package/dist/routes/agents.d.ts +2 -2
- package/dist/routes/audit.d.ts +1 -1
- package/dist/routes/audit.js +2 -2
- package/dist/routes/auth.d.ts +2 -2
- package/dist/routes/auth.js +28 -4
- package/dist/routes/context.d.ts +2 -2
- package/dist/routes/gateway-patterns.d.ts +3 -3
- package/dist/routes/gateway-patterns.js +1 -1
- package/dist/routes/llm.d.ts +8 -2
- package/dist/routes/llm.js +9 -5
- package/dist/routes/mcp-registry.d.ts +6 -6
- package/dist/routes/mcp-registry.js +10 -10
- package/dist/routes/mcp.d.ts +1 -1
- package/dist/routes/mcp.js +1 -1
- package/dist/routes/messages.d.ts +5 -4
- package/dist/routes/messages.js +30 -3
- package/dist/routes/models.d.ts +7 -2
- package/dist/routes/models.js +3 -1
- package/dist/routes/projects.d.ts +7 -7
- package/dist/routes/projects.js +7 -7
- package/dist/routes/providers.d.ts +15 -3
- package/dist/routes/providers.js +34 -21
- package/dist/routes/queue.d.ts +5 -4
- package/dist/routes/queue.js +30 -3
- package/dist/routes/sessions.d.ts +14 -4
- package/dist/routes/sessions.js +234 -34
- package/dist/routes/users.js +1 -1
- package/dist/test-helpers/close-server.d.ts +33 -0
- package/dist/test-helpers/close-server.js +50 -0
- package/package.json +3 -3
|
@@ -4,7 +4,7 @@ import { evaluateMcpNetworkAccess, getServiceCredential } from '@itphx/synth-cor
|
|
|
4
4
|
import { sessionMcpScopeSchema, hasServiceScope } from '@itphx/synth-shared';
|
|
5
5
|
import { mcpServerConfigSchema } from '@itphx/synth-shared/config';
|
|
6
6
|
import { requireAdminOrScope, requireScopeForServiceKey } from '../auth/guards.js';
|
|
7
|
-
// Backend-only MCP-роуты (
|
|
7
|
+
// Backend-only MCP-роуты (ADR-071 §2.5): legacy `/servers*`, `/session/:id` и
|
|
8
8
|
// единый реестр `/registry*`. Probe (`POST /probe`) — общая логика core,
|
|
9
9
|
// монтируется в `routes/mcp.ts` ПЕРЕД этим роутером.
|
|
10
10
|
const addServerSchema = z.object({
|
|
@@ -12,7 +12,7 @@ const addServerSchema = z.object({
|
|
|
12
12
|
config: mcpServerConfigSchema,
|
|
13
13
|
});
|
|
14
14
|
const updateServerSchema = mcpServerConfigSchema;
|
|
15
|
-
//
|
|
15
|
+
// ADR-071 §2.5: единый реестр MCP-серверов.
|
|
16
16
|
const registryAddSchema = z.object({
|
|
17
17
|
name: z.string().min(1).max(200),
|
|
18
18
|
config: mcpServerConfigSchema,
|
|
@@ -32,7 +32,7 @@ const registryUpdateSchema = z.object({
|
|
|
32
32
|
export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options) {
|
|
33
33
|
const app = new Hono();
|
|
34
34
|
const registry = options.registry;
|
|
35
|
-
const resolveNetworkPolicy = () => options.getNetworkPolicy
|
|
35
|
+
const resolveNetworkPolicy = async () => (options.getNetworkPolicy ? await options.getNetworkPolicy() : undefined) ?? options.networkPolicy;
|
|
36
36
|
/** Синхронизировать конфиг менеджера из реестра — одно чтение на все карты. */
|
|
37
37
|
const syncManagerConfig = async () => {
|
|
38
38
|
if (!mcpManager)
|
|
@@ -48,7 +48,7 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
48
48
|
const isConnected = (name) => mcpManager?.getConfiguredServers().find((s) => s.name === name)?.connected ?? false;
|
|
49
49
|
const currentUser = (c) => c.get('user') ?? null;
|
|
50
50
|
/**
|
|
51
|
-
*
|
|
51
|
+
* ADR-052/O1: запрос от installer-service-key (scope `addons:install`).
|
|
52
52
|
* Даёт scoped-ключу без роли ADMIN создавать **instance**-записи реестра
|
|
53
53
|
* (общие для инстанса, а не персональные) и обновлять созданные им записи.
|
|
54
54
|
*/
|
|
@@ -57,11 +57,11 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
57
57
|
return !!cred && hasServiceScope(cred.scopes, 'addons:install');
|
|
58
58
|
};
|
|
59
59
|
const checkNetwork = async (config, origin) => {
|
|
60
|
-
//
|
|
60
|
+
// ADR-071 §2.3.1: политика — для пользовательских HTTP-серверов; instance
|
|
61
61
|
// (в т.ч. приватные сети инстанса) доверенные.
|
|
62
62
|
if (origin !== 'user' || config.type === 'stdio' || !config.url)
|
|
63
63
|
return null;
|
|
64
|
-
const policy = resolveNetworkPolicy();
|
|
64
|
+
const policy = await resolveNetworkPolicy();
|
|
65
65
|
if (!policy)
|
|
66
66
|
return null;
|
|
67
67
|
const result = await evaluateMcpNetworkAccess(config.url, policy);
|
|
@@ -70,7 +70,7 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
70
70
|
return { code: 'NETWORK_POLICY_VIOLATION', message: result.reason ?? 'Адрес запрещён сетевой политикой' };
|
|
71
71
|
};
|
|
72
72
|
// ---------------------------------------------------------------------------
|
|
73
|
-
// Legacy `/servers*` — тонкие адаптеры над единым реестром (
|
|
73
|
+
// Legacy `/servers*` — тонкие адаптеры над единым реестром (ADR-071 §2.5).
|
|
74
74
|
// Второго хранилища (config.yaml) больше нет: источник истины — McpRegistryStore.
|
|
75
75
|
// ---------------------------------------------------------------------------
|
|
76
76
|
// --- Список настроенных серверов ---
|
|
@@ -260,14 +260,14 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
260
260
|
});
|
|
261
261
|
});
|
|
262
262
|
}
|
|
263
|
-
// --- Единый реестр MCP-серверов (
|
|
263
|
+
// --- Единый реестр MCP-серверов (ADR-071 §2.5) ---
|
|
264
264
|
// Список записей реестра (auth).
|
|
265
265
|
app.get('/registry', kit.requireAuth, async (c) => {
|
|
266
266
|
const entries = await registry.list();
|
|
267
267
|
return c.json({ entries });
|
|
268
268
|
});
|
|
269
269
|
// Добавить запись (auth): HTTP — любой пользователь, stdio — только ADMIN.
|
|
270
|
-
//
|
|
270
|
+
// ADR-052/O1: service-key должен нести scope `addons:install` (интерактив без
|
|
271
271
|
// изменений — HTTP добавляет любой, stdio-проверка ниже). Installer-ключ со
|
|
272
272
|
// scope создаёт instance-записи (общие для инстанса) без роли ADMIN.
|
|
273
273
|
app.post('/registry', kit.requireAuth, requireScopeForServiceKey('addons:install'), async (c) => {
|
|
@@ -278,7 +278,7 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
|
|
|
278
278
|
}
|
|
279
279
|
const { name, config, enabled, enabledByDefault, origin } = parsed.data;
|
|
280
280
|
const admin = kit.isAdmin(c);
|
|
281
|
-
//
|
|
281
|
+
// ADR-052/O1: installer-ключ (scope `addons:install`) создаёт instance-записи
|
|
282
282
|
// даже без роли ADMIN — это общие записи инстанса (а не персональные).
|
|
283
283
|
const isInstaller = isInstallerKey(c);
|
|
284
284
|
let entryOrigin;
|
package/dist/routes/mcp.d.ts
CHANGED
|
@@ -5,7 +5,7 @@ import type { McpRoutesOptions } from './mcp-registry.js';
|
|
|
5
5
|
export type { McpRoutesOptions } from './mcp-registry.js';
|
|
6
6
|
/**
|
|
7
7
|
* Backend MCP: probe (`POST /probe`) — общая логика core-фабрики; legacy
|
|
8
|
-
* `/servers*`, `/session/:id` и единый реестр `/registry*` (
|
|
8
|
+
* `/servers*`, `/session/:id` и единый реестр `/registry*` (ADR-071) —
|
|
9
9
|
* backend-only (см. `mcp-registry.ts`). Порядок монтирования: core probe
|
|
10
10
|
* первым, затем backend-only.
|
|
11
11
|
*/
|
package/dist/routes/mcp.js
CHANGED
|
@@ -3,7 +3,7 @@ import { createMcpRoutes as createCoreMcpRoutes } from '@itphx/synth-core';
|
|
|
3
3
|
import { createMcpRegistryRoutes } from './mcp-registry.js';
|
|
4
4
|
/**
|
|
5
5
|
* Backend MCP: probe (`POST /probe`) — общая логика core-фабрики; legacy
|
|
6
|
-
* `/servers*`, `/session/:id` и единый реестр `/registry*` (
|
|
6
|
+
* `/servers*`, `/session/:id` и единый реестр `/registry*` (ADR-071) —
|
|
7
7
|
* backend-only (см. `mcp-registry.ts`). Порядок монтирования: core probe
|
|
8
8
|
* первым, затем backend-only.
|
|
9
9
|
*/
|
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
|
-
import type { SessionManager, ContextOptimizer, EventBus } from '@itphx/synth-core';
|
|
3
|
+
import type { SessionManager, ContextOptimizer, EventBus, ProjectRepository } from '@itphx/synth-core';
|
|
4
4
|
/**
|
|
5
|
-
* Backend-обёртка над core-фабрикой сообщений: добавляет i18n
|
|
6
|
-
*
|
|
5
|
+
* Backend-обёртка над core-фабрикой сообщений: добавляет i18n-сообщения, RBAC
|
|
6
|
+
* доступа к сессии (владелец/ADMIN/участник проекта/LEAD) и хук пересчёта
|
|
7
|
+
* `canSummarize` после мутаций (backend-специфика). Логика роутов
|
|
7
8
|
* (batch/toggle/pin/delete/retry/debug) — в core-фабрике.
|
|
8
9
|
*/
|
|
9
|
-
export declare function createMessageRoutes(kit: AuthKit, sessionManager: SessionManager, contextOptimizer: ContextOptimizer | null, eventBus: EventBus): Hono;
|
|
10
|
+
export declare function createMessageRoutes(kit: AuthKit, sessionManager: SessionManager, contextOptimizer: ContextOptimizer | null, eventBus: EventBus, projectStore?: ProjectRepository): Hono;
|
package/dist/routes/messages.js
CHANGED
|
@@ -2,20 +2,47 @@ import { Hono } from 'hono';
|
|
|
2
2
|
import { createMessageRoutes as createCoreMessageRoutes } from '@itphx/synth-core';
|
|
3
3
|
import { t } from '../lib/i18n.js';
|
|
4
4
|
import { createRecalcCanSummarize } from '../lib/recalc-can-summarize.js';
|
|
5
|
+
import { createProjectAccess } from './projects.js';
|
|
5
6
|
/**
|
|
6
|
-
* Backend-обёртка над core-фабрикой сообщений: добавляет i18n
|
|
7
|
-
*
|
|
7
|
+
* Backend-обёртка над core-фабрикой сообщений: добавляет i18n-сообщения, RBAC
|
|
8
|
+
* доступа к сессии (владелец/ADMIN/участник проекта/LEAD) и хук пересчёта
|
|
9
|
+
* `canSummarize` после мутаций (backend-специфика). Логика роутов
|
|
8
10
|
* (batch/toggle/pin/delete/retry/debug) — в core-фабрике.
|
|
9
11
|
*/
|
|
10
|
-
export function createMessageRoutes(kit, sessionManager, contextOptimizer, eventBus) {
|
|
12
|
+
export function createMessageRoutes(kit, sessionManager, contextOptimizer, eventBus, projectStore) {
|
|
11
13
|
const app = new Hono();
|
|
12
14
|
const recalcCanSummarize = createRecalcCanSummarize({ sessionManager, contextOptimizer, eventBus });
|
|
15
|
+
const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
|
|
16
|
+
// ADR-071 §2.4: владелец сессии — обычный пользователь.
|
|
17
|
+
const isSessionOwner = (session, userId) => (session.ownerId ?? session.userId) === userId;
|
|
13
18
|
app.route('/', createCoreMessageRoutes({ requireAuth: kit.requireAuth }, sessionManager, undefined, {
|
|
14
19
|
messages: {
|
|
15
20
|
sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
|
|
16
21
|
messageNotFound: (c) => t('errors.notFound.message', undefined, c),
|
|
22
|
+
forbidden: (c) => t('auth.forbidden', undefined, c),
|
|
17
23
|
},
|
|
18
24
|
onMessagesChanged: (sessionId) => recalcCanSummarize(sessionId),
|
|
25
|
+
resolveUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
|
|
26
|
+
canAccess: (session, c, userId) => isSessionOwner(session, userId)
|
|
27
|
+
|| (typeof kit.isAdmin === 'function' && kit.isAdmin(c)),
|
|
28
|
+
resolveElevated: (c) => {
|
|
29
|
+
const isAdmin = typeof kit.isAdmin === 'function' && kit.isAdmin(c);
|
|
30
|
+
const isLead = typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD');
|
|
31
|
+
return isAdmin || isLead;
|
|
32
|
+
},
|
|
33
|
+
// read/write по роли в проекте: чтение — owner/любой участник, мутация —
|
|
34
|
+
// owner/EDITOR/LEAD/ADMIN (`createProjectAccess`; см. sessions.ts).
|
|
35
|
+
resolveCanAccessExtra: async (session, c, userId, access) => {
|
|
36
|
+
if (!projectStore || !session.projectId)
|
|
37
|
+
return false;
|
|
38
|
+
const project = await projectStore.load(session.projectId);
|
|
39
|
+
if (!project)
|
|
40
|
+
return false;
|
|
41
|
+
const ctx = c;
|
|
42
|
+
return access === 'read'
|
|
43
|
+
? canReadProject(ctx, project, userId)
|
|
44
|
+
: canEditProjectContent(ctx, project, userId);
|
|
45
|
+
},
|
|
19
46
|
}));
|
|
20
47
|
return app;
|
|
21
48
|
}
|
package/dist/routes/models.d.ts
CHANGED
|
@@ -1,10 +1,15 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
|
-
import {
|
|
3
|
+
import type { DefaultModelPair, JsonStoreLike } from '@itphx/synth-core';
|
|
4
4
|
import type { ModelConfig, ProviderConfig } from '@itphx/synth-shared';
|
|
5
|
+
/** Колбэки модели по умолчанию инстанса (runtime-пара provider+model). */
|
|
6
|
+
export interface ModelRoutesDefaultOptions {
|
|
7
|
+
getDefaultModel?: () => DefaultModelPair | null | Promise<DefaultModelPair | null>;
|
|
8
|
+
setDefaultModel?: (pair: DefaultModelPair) => void | Promise<void>;
|
|
9
|
+
}
|
|
5
10
|
/**
|
|
6
11
|
* Backend-обёртка над core-фабрикой моделей: добавляет только RBAC
|
|
7
12
|
* (мутации и синхронизация — ADMIN), rate limit на `fetch` и `set_as_default`.
|
|
8
13
|
* Логика роутов (GET /, POST /, DELETE /:id, POST /fetch) — в core-фабрике.
|
|
9
14
|
*/
|
|
10
|
-
export declare function createModelRoutes(kit: AuthKit, modelStore:
|
|
15
|
+
export declare function createModelRoutes(kit: AuthKit, modelStore: JsonStoreLike<ModelConfig>, providerStore: JsonStoreLike<ProviderConfig>, modelCache: Map<string, ModelConfig>, providerCache: Map<string, ProviderConfig>, defaults?: ModelRoutesDefaultOptions): Hono;
|
package/dist/routes/models.js
CHANGED
|
@@ -7,7 +7,7 @@ import { createRateLimiter } from '../middleware/rate-limiter.js';
|
|
|
7
7
|
* (мутации и синхронизация — ADMIN), rate limit на `fetch` и `set_as_default`.
|
|
8
8
|
* Логика роутов (GET /, POST /, DELETE /:id, POST /fetch) — в core-фабрике.
|
|
9
9
|
*/
|
|
10
|
-
export function createModelRoutes(kit, modelStore, providerStore, modelCache, providerCache) {
|
|
10
|
+
export function createModelRoutes(kit, modelStore, providerStore, modelCache, providerCache, defaults = {}) {
|
|
11
11
|
const app = new Hono();
|
|
12
12
|
// Общая логика (GET /, POST /, DELETE /:id, POST /fetch, set_as_default) — в core.
|
|
13
13
|
app.route('/', createCoreModelRoutes({ requireAuth: kit.requireAuth }, modelStore, providerStore, modelCache, {
|
|
@@ -16,6 +16,8 @@ export function createModelRoutes(kit, modelStore, providerStore, modelCache, pr
|
|
|
16
16
|
fetchMiddleware: [createRateLimiter(3, 120_000)],
|
|
17
17
|
providerCache,
|
|
18
18
|
supportSetAsDefault: true,
|
|
19
|
+
getDefaultModel: defaults.getDefaultModel,
|
|
20
|
+
setDefaultModel: defaults.setDefaultModel,
|
|
19
21
|
messages: {
|
|
20
22
|
idRequired: (c) => t('errors.validation.idRequired', undefined, c),
|
|
21
23
|
modelNotFound: (c) => t('errors.notFound.model', undefined, c),
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
|
-
import type {
|
|
3
|
+
import type { ProjectRepository, SessionManager, McpManager, SkillService, SettingsRepository, McpRegistryRepository } from '@itphx/synth-core';
|
|
4
4
|
import type { Project } from '@itphx/synth-shared';
|
|
5
5
|
/**
|
|
6
|
-
*
|
|
6
|
+
* ADR-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
|
|
7
7
|
* чтобы их переиспользовали git-роуты core-фабрики (`authorizeProject`), а логика
|
|
8
8
|
* ролей не дублировалась.
|
|
9
9
|
*/
|
|
@@ -21,11 +21,11 @@ export declare function createProjectAccess(kit: AuthKit): {
|
|
|
21
21
|
/**
|
|
22
22
|
* Backend-обёртка над core-фабрикой проектов: общая логика — в core, здесь только
|
|
23
23
|
* managed-специфика — RBAC (`createProjectAccess`), i18n-сообщения, авто-имя
|
|
24
|
-
* workspace (
|
|
24
|
+
* workspace (ADR-075, политика `deny` вне root), проектный MCP-скоуп (ADR-071 §2.4)
|
|
25
25
|
* и статистика сессий. Полная реализация — `@itphx/synth-core`.
|
|
26
26
|
*/
|
|
27
|
-
export declare function createProjectRoutes(kit: AuthKit, store:
|
|
28
|
-
/**
|
|
27
|
+
export declare function createProjectRoutes(kit: AuthKit, store: ProjectRepository, sessionManager: SessionManager, workspacesRoot: string,
|
|
28
|
+
/** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
|
|
29
29
|
mcpManager?: McpManager,
|
|
30
|
-
/**
|
|
31
|
-
skillService?: SkillService, settingsStore?:
|
|
30
|
+
/** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
|
|
31
|
+
skillService?: SkillService, settingsStore?: SettingsRepository, mcpRegistryStore?: McpRegistryRepository): Hono;
|
package/dist/routes/projects.js
CHANGED
|
@@ -2,12 +2,12 @@ import { createProjectRoutes as createCoreProjectRoutes, resolveProjectSkillSeed
|
|
|
2
2
|
import { ProjectRole } from '@itphx/synth-shared';
|
|
3
3
|
import { t } from '../lib/i18n.js';
|
|
4
4
|
/**
|
|
5
|
-
*
|
|
5
|
+
* ADR-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
|
|
6
6
|
* чтобы их переиспользовали git-роуты core-фабрики (`authorizeProject`), а логика
|
|
7
7
|
* ролей не дублировалась.
|
|
8
8
|
*/
|
|
9
9
|
export function createProjectAccess(kit) {
|
|
10
|
-
/**
|
|
10
|
+
/** ADR-071 §2.4: owner проекта или глобальные LEAD/ADMIN (через AuthKit). */
|
|
11
11
|
const canManageProject = (c, project, userId) => (typeof kit.isAdmin === 'function' && kit.isAdmin(c))
|
|
12
12
|
|| (typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD'))
|
|
13
13
|
|| project.ownerId === userId
|
|
@@ -16,7 +16,7 @@ export function createProjectAccess(kit) {
|
|
|
16
16
|
const canEditProjectContent = (c, project, userId) => canManageProject(c, project, userId)
|
|
17
17
|
|| project.members?.[userId] === ProjectRole.EDITOR;
|
|
18
18
|
/**
|
|
19
|
-
*
|
|
19
|
+
* ADR-089: чтение проекта по id — owner / любой участник (любая роль, в т.ч.
|
|
20
20
|
* VIEWER) / глобальные LEAD/ADMIN. Не расширяет права на редактирование.
|
|
21
21
|
*/
|
|
22
22
|
const canReadProject = (c, project, userId) => canManageProject(c, project, userId)
|
|
@@ -26,20 +26,20 @@ export function createProjectAccess(kit) {
|
|
|
26
26
|
/**
|
|
27
27
|
* Backend-обёртка над core-фабрикой проектов: общая логика — в core, здесь только
|
|
28
28
|
* managed-специфика — RBAC (`createProjectAccess`), i18n-сообщения, авто-имя
|
|
29
|
-
* workspace (
|
|
29
|
+
* workspace (ADR-075, политика `deny` вне root), проектный MCP-скоуп (ADR-071 §2.4)
|
|
30
30
|
* и статистика сессий. Полная реализация — `@itphx/synth-core`.
|
|
31
31
|
*/
|
|
32
32
|
export function createProjectRoutes(kit, store, sessionManager, workspacesRoot,
|
|
33
|
-
/**
|
|
33
|
+
/** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
|
|
34
34
|
mcpManager,
|
|
35
|
-
/**
|
|
35
|
+
/** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
|
|
36
36
|
skillService, settingsStore, mcpRegistryStore) {
|
|
37
37
|
const { canManageProject, canEditProjectContent, canReadProject } = createProjectAccess(kit);
|
|
38
38
|
return createCoreProjectRoutes({ requireAuth: kit.requireAuth }, store, undefined, {
|
|
39
39
|
canManage: canManageProject,
|
|
40
40
|
canEditContent: canEditProjectContent,
|
|
41
41
|
canRead: canReadProject,
|
|
42
|
-
//
|
|
42
|
+
// ADR-089: ADMIN/LEAD — сквозная видимость всех проектов (защита от мок-AuthKit).
|
|
43
43
|
resolveElevated: (c) => (typeof kit.isAdmin === 'function' && kit.isAdmin(c))
|
|
44
44
|
|| (typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD')),
|
|
45
45
|
getCurrentUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
|
|
@@ -1,9 +1,21 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
|
-
import {
|
|
4
|
-
import type {
|
|
3
|
+
import type { JsonStoreLike } from '@itphx/synth-core';
|
|
4
|
+
import type { DefaultModelPair } from '@itphx/synth-core';
|
|
5
|
+
import type { EgressPolicy, ProviderConfig } from '@itphx/synth-shared';
|
|
6
|
+
import type { EgressLogSink } from '@itphx/synth-core';
|
|
7
|
+
/** Инъекция egress-политики/журнала для `/fetch-icon` (резолвер из deps). */
|
|
8
|
+
export interface ProviderRoutesEgressOptions {
|
|
9
|
+
/** Живой резолвер `egress.tools` (per-request; без него — встроенный дефолт). */
|
|
10
|
+
resolvePolicy?: () => Promise<EgressPolicy>;
|
|
11
|
+
/** Приёмник журнала внешних запросов (scope `providers`). */
|
|
12
|
+
log?: EgressLogSink;
|
|
13
|
+
}
|
|
5
14
|
/**
|
|
6
15
|
* Backend-обёртка над core-фабрикой провайдеров: добавляет только RBAC
|
|
7
16
|
* (мутации — ADMIN), rate limit на тест подключения и backend-only `fetch-icon`.
|
|
17
|
+
*
|
|
18
|
+
* URL провайдера проверяется общей egress-политикой (`egress.tools`, live),
|
|
19
|
+
* без собственной копии списка приватных диапазонов.
|
|
8
20
|
*/
|
|
9
|
-
export declare function createProviderRoutes(kit: AuthKit, store:
|
|
21
|
+
export declare function createProviderRoutes(kit: AuthKit, store: JsonStoreLike<ProviderConfig>, providerCache: Map<string, ProviderConfig>, egress?: ProviderRoutesEgressOptions, getDefaultModel?: () => DefaultModelPair | null | Promise<DefaultModelPair | null>): Hono;
|
package/dist/routes/providers.js
CHANGED
|
@@ -1,23 +1,15 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
|
-
import {
|
|
3
|
-
import { createProviderRoutes as createCoreProviderRoutes, evaluateMcpNetworkAccess } from '@itphx/synth-core';
|
|
2
|
+
import { createProviderRoutes as createCoreProviderRoutes, checkEgressUrl, fetchWithEgressGuard, sanitizeEgressTarget, PRIVATE_EGRESS_POLICY, } from '@itphx/synth-core';
|
|
4
3
|
import { t } from '../lib/i18n.js';
|
|
5
4
|
import { createRateLimiter } from '../middleware/rate-limiter.js';
|
|
6
|
-
/**
|
|
7
|
-
* Политика проверки URL провайдера для `/fetch-icon`: блокируем внутренние и
|
|
8
|
-
* приватные адреса, включая DNS-резолв (переиспользуем MCP network-policy, а не
|
|
9
|
-
* собственный regex-список). Помимо дефолтных приватных диапазонов исключаем
|
|
10
|
-
* `0.0.0.0/8` — сохраняем прежнюю блокировку hostname `0.0.0.0`.
|
|
11
|
-
*/
|
|
12
|
-
const PROVIDER_URL_NETWORK_POLICY = {
|
|
13
|
-
mode: 'deny',
|
|
14
|
-
list: [...DEFAULT_MCP_PRIVATE_CIDRS, '0.0.0.0/8'],
|
|
15
|
-
};
|
|
16
5
|
/**
|
|
17
6
|
* Backend-обёртка над core-фабрикой провайдеров: добавляет только RBAC
|
|
18
7
|
* (мутации — ADMIN), rate limit на тест подключения и backend-only `fetch-icon`.
|
|
8
|
+
*
|
|
9
|
+
* URL провайдера проверяется общей egress-политикой (`egress.tools`, live),
|
|
10
|
+
* без собственной копии списка приватных диапазонов.
|
|
19
11
|
*/
|
|
20
|
-
export function createProviderRoutes(kit, store, providerCache) {
|
|
12
|
+
export function createProviderRoutes(kit, store, providerCache, egress = {}, getDefaultModel) {
|
|
21
13
|
const app = new Hono();
|
|
22
14
|
// POST /api/v2/providers/fetch-icon — получить favicon с домена (admin).
|
|
23
15
|
// Статический сегмент регистрируем до core-роутов (в т.ч. /:name).
|
|
@@ -34,19 +26,38 @@ export function createProviderRoutes(kit, store, providerCache) {
|
|
|
34
26
|
catch {
|
|
35
27
|
return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidUrl', undefined, c) } }, 400);
|
|
36
28
|
}
|
|
37
|
-
// SSRF-защита:
|
|
38
|
-
const
|
|
29
|
+
// SSRF-защита: resolved egress-политика (включая exceptions и DNS-резолв).
|
|
30
|
+
const policy = egress.resolvePolicy ? await egress.resolvePolicy() : PRIVATE_EGRESS_POLICY;
|
|
31
|
+
const networkCheck = await checkEgressUrl(origin, policy);
|
|
39
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
|
+
}
|
|
40
51
|
return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidUrl', undefined, c) } }, 400);
|
|
41
52
|
}
|
|
42
53
|
try {
|
|
43
54
|
const iconUrl = `${origin}/favicon.ico`;
|
|
44
55
|
const controller = new AbortController();
|
|
45
56
|
const timer = setTimeout(() => controller.abort(), 5000);
|
|
46
|
-
const resp = await
|
|
57
|
+
const resp = await fetchWithEgressGuard(iconUrl, {
|
|
47
58
|
signal: controller.signal,
|
|
48
59
|
headers: { Accept: 'image/*' },
|
|
49
|
-
});
|
|
60
|
+
}, { policy, scope: 'providers', log: egress.log });
|
|
50
61
|
clearTimeout(timer);
|
|
51
62
|
if (resp.ok && resp.headers.get('content-type')?.includes('image')) {
|
|
52
63
|
const buffer = await resp.arrayBuffer();
|
|
@@ -57,10 +68,10 @@ export function createProviderRoutes(kit, store, providerCache) {
|
|
|
57
68
|
// Попробовать найти <link rel="icon"> в HTML
|
|
58
69
|
const htmlController = new AbortController();
|
|
59
70
|
const htmlTimer = setTimeout(() => htmlController.abort(), 5000);
|
|
60
|
-
const htmlResp = await
|
|
71
|
+
const htmlResp = await fetchWithEgressGuard(origin, {
|
|
61
72
|
signal: htmlController.signal,
|
|
62
73
|
headers: { Accept: 'text/html' },
|
|
63
|
-
});
|
|
74
|
+
}, { policy, scope: 'providers', log: egress.log });
|
|
64
75
|
clearTimeout(htmlTimer);
|
|
65
76
|
if (htmlResp.ok) {
|
|
66
77
|
const html = await htmlResp.text();
|
|
@@ -74,10 +85,10 @@ export function createProviderRoutes(kit, store, providerCache) {
|
|
|
74
85
|
resolved = `${origin}${resolved}`;
|
|
75
86
|
else if (!resolved.startsWith('http'))
|
|
76
87
|
resolved = `${origin}/${resolved}`;
|
|
77
|
-
const iconResp = await
|
|
88
|
+
const iconResp = await fetchWithEgressGuard(resolved, {
|
|
78
89
|
signal: AbortSignal.timeout(5000),
|
|
79
90
|
headers: { Accept: 'image/*' },
|
|
80
|
-
});
|
|
91
|
+
}, { policy, scope: 'providers', log: egress.log });
|
|
81
92
|
if (iconResp.ok) {
|
|
82
93
|
const buffer = await iconResp.arrayBuffer();
|
|
83
94
|
const ct = iconResp.headers.get('content-type') || 'image/x-icon';
|
|
@@ -103,11 +114,13 @@ export function createProviderRoutes(kit, store, providerCache) {
|
|
|
103
114
|
testEnabled: true,
|
|
104
115
|
testGuard: kit.requireAdmin,
|
|
105
116
|
testMiddleware: [createRateLimiter(5, 60_000)],
|
|
117
|
+
getDefaultModel,
|
|
106
118
|
messages: {
|
|
107
119
|
nameRequired: (c) => t('errors.validation.nameRequired', undefined, c),
|
|
108
120
|
providerNotFound: (c) => t('errors.notFound.provider', undefined, c),
|
|
109
121
|
providerDisabled: (c) => t('errors.providerDisabled', undefined, c),
|
|
110
122
|
urlRequired: (c) => t('errors.validation.urlRequired', undefined, c),
|
|
123
|
+
urlInvalid: (c) => t('errors.validation.invalidUrl', undefined, c),
|
|
111
124
|
connectionError: (c) => t('errors.connectionError', undefined, c),
|
|
112
125
|
},
|
|
113
126
|
}));
|
package/dist/routes/queue.d.ts
CHANGED
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
|
-
import type { SessionManager, QueueProcessorManager, ChatOrchestrator, EventBus } from '@itphx/synth-core';
|
|
3
|
+
import type { SessionManager, QueueProcessorManager, ChatOrchestrator, EventBus, ProjectRepository } from '@itphx/synth-core';
|
|
4
4
|
/**
|
|
5
|
-
* Backend-обёртка над core-фабрикой очереди: добавляет
|
|
6
|
-
*
|
|
5
|
+
* Backend-обёртка над core-фабрикой очереди: добавляет i18n-сообщения и RBAC
|
|
6
|
+
* доступа к сессии (владелец/ADMIN/участник проекта/LEAD). Логика роутов
|
|
7
|
+
* (clear/return/resume/retry-now/cancel-retry) — в core-фабрике.
|
|
7
8
|
*/
|
|
8
|
-
export declare function createQueueRoutes(kit: AuthKit, sessionManager: SessionManager, queueManager: QueueProcessorManager, eventBus: EventBus, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']
|
|
9
|
+
export declare function createQueueRoutes(kit: AuthKit, sessionManager: SessionManager, queueManager: QueueProcessorManager, eventBus: EventBus, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, projectStore?: ProjectRepository): Hono;
|
package/dist/routes/queue.js
CHANGED
|
@@ -1,16 +1,43 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import { createQueueRoutes as createCoreQueueRoutes } from '@itphx/synth-core';
|
|
3
3
|
import { t } from '../lib/i18n.js';
|
|
4
|
+
import { createProjectAccess } from './projects.js';
|
|
4
5
|
/**
|
|
5
|
-
* Backend-обёртка над core-фабрикой очереди: добавляет
|
|
6
|
-
*
|
|
6
|
+
* Backend-обёртка над core-фабрикой очереди: добавляет i18n-сообщения и RBAC
|
|
7
|
+
* доступа к сессии (владелец/ADMIN/участник проекта/LEAD). Логика роутов
|
|
8
|
+
* (clear/return/resume/retry-now/cancel-retry) — в core-фабрике.
|
|
7
9
|
*/
|
|
8
|
-
export function createQueueRoutes(kit, sessionManager, queueManager, eventBus, processMessage) {
|
|
10
|
+
export function createQueueRoutes(kit, sessionManager, queueManager, eventBus, processMessage, projectStore) {
|
|
9
11
|
const app = new Hono();
|
|
12
|
+
const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
|
|
13
|
+
// ADR-071 §2.4: владелец сессии — обычный пользователь.
|
|
14
|
+
const isSessionOwner = (session, userId) => (session.ownerId ?? session.userId) === userId;
|
|
10
15
|
app.route('/', createCoreQueueRoutes({ requireAuth: kit.requireAuth }, sessionManager, queueManager, eventBus, processMessage, undefined, {
|
|
11
16
|
messages: {
|
|
12
17
|
sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
|
|
13
18
|
messageNotFoundIndex: (c) => t('errors.notFound.messageIndex', undefined, c),
|
|
19
|
+
forbidden: (c) => t('auth.forbidden', undefined, c),
|
|
20
|
+
},
|
|
21
|
+
resolveUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
|
|
22
|
+
canAccess: (session, c, userId) => isSessionOwner(session, userId)
|
|
23
|
+
|| (typeof kit.isAdmin === 'function' && kit.isAdmin(c)),
|
|
24
|
+
resolveElevated: (c) => {
|
|
25
|
+
const isAdmin = typeof kit.isAdmin === 'function' && kit.isAdmin(c);
|
|
26
|
+
const isLead = typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD');
|
|
27
|
+
return isAdmin || isLead;
|
|
28
|
+
},
|
|
29
|
+
// read/write по роли в проекте: чтение — owner/любой участник, мутация —
|
|
30
|
+
// owner/EDITOR/LEAD/ADMIN (`createProjectAccess`; см. sessions.ts).
|
|
31
|
+
resolveCanAccessExtra: async (session, c, userId, access) => {
|
|
32
|
+
if (!projectStore || !session.projectId)
|
|
33
|
+
return false;
|
|
34
|
+
const project = await projectStore.load(session.projectId);
|
|
35
|
+
if (!project)
|
|
36
|
+
return false;
|
|
37
|
+
const ctx = c;
|
|
38
|
+
return access === 'read'
|
|
39
|
+
? canReadProject(ctx, project, userId)
|
|
40
|
+
: canEditProjectContent(ctx, project, userId);
|
|
14
41
|
},
|
|
15
42
|
}));
|
|
16
43
|
return app;
|
|
@@ -6,9 +6,10 @@ import type { QueueProcessorManager } from '@itphx/synth-core';
|
|
|
6
6
|
import type { ChatOrchestrator } from '@itphx/synth-core';
|
|
7
7
|
import type { ContextOptimizer } from '@itphx/synth-core';
|
|
8
8
|
import type { RequestSessionService } from '@itphx/synth-core';
|
|
9
|
+
import type { AnalyticsRecorder } from '@itphx/synth-core';
|
|
9
10
|
import type { ProfileStore } from '@itphx/synth-shared';
|
|
10
11
|
import type { EventHub } from '../events/hub.js';
|
|
11
|
-
import type {
|
|
12
|
+
import type { ProjectRepository } from '@itphx/synth-core';
|
|
12
13
|
/**
|
|
13
14
|
* Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
|
|
14
15
|
* backend-специфичные роуты (MCP-скоуп сессии, секреты, export/import, отладка,
|
|
@@ -19,14 +20,23 @@ import type { ProjectStore } from '@itphx/synth-core';
|
|
|
19
20
|
* RBAC: core-фабрика параметризуется `resolveUserId`/`resolveOwner`/`resolveAuthor`,
|
|
20
21
|
* `canAccess` (владелец|ADMIN) и EventHub-хуками; remote/hybrid-ветки отключены
|
|
21
22
|
* (getRemoteClient не передаётся). `GET /:id/events` на backend не регистрируется.
|
|
23
|
+
*
|
|
24
|
+
* Исключения из общего prefix-guard'а (собственные правила, роуты зарегистрированы
|
|
25
|
+
* до guard'а): `/:id/mcp` (владелец|ADMIN, ADR-071 §2.4) и `/:id/secrets`
|
|
26
|
+
* (ADMIN|AUDITOR — карта обфускации). `/:id/export` — ПОД guard'ом: доступ к
|
|
27
|
+
* сессии решает ЕДИНЫЙ prefix-guard, а привилегию карты обфускации — отдельный
|
|
28
|
+
* route-level guard (`createSessionExportGuard`, ADR-036); в обработчике проверок
|
|
29
|
+
* доступа нет (инвариант 16).
|
|
22
30
|
*/
|
|
23
|
-
export declare function createSessionRoutes(kit: AuthKit, sessionManager: SessionManager, eventBus: EventBus, queueManager: QueueProcessorManager, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, orchestrator: ChatOrchestrator, eventHub: EventHub, contextOptimizer?: ContextOptimizer, projectStore?:
|
|
31
|
+
export declare function createSessionRoutes(kit: AuthKit, sessionManager: SessionManager, eventBus: EventBus, queueManager: QueueProcessorManager, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, orchestrator: ChatOrchestrator, eventHub: EventHub, contextOptimizer?: ContextOptimizer, projectStore?: ProjectRepository,
|
|
24
32
|
/** Профили пользователей: display name для статистики (fallback — username). */
|
|
25
33
|
profilesStore?: ProfileStore,
|
|
26
34
|
/** Агент по умолчанию для новых сессий без `settings.agentRole` (runtime-настройка). */
|
|
27
35
|
resolveDefaultAgent?: () => string | Promise<string>,
|
|
28
36
|
/**
|
|
29
|
-
*
|
|
37
|
+
* ADR-089: единый funnel создания сессий (прокидывается в core-фабрику).
|
|
30
38
|
* Не задан — core-фабрика использует прямой `SessionManager.createSession`.
|
|
31
39
|
*/
|
|
32
|
-
requestSessionService?: RequestSessionService
|
|
40
|
+
requestSessionService?: RequestSessionService,
|
|
41
|
+
/** PROP-102: сборщик `activity` (меры `aborts`/`messages_*`) для core-фабрики. */
|
|
42
|
+
analytics?: AnalyticsRecorder): Hono;
|