@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.
Files changed (62) hide show
  1. package/dist/app/bootstrap.d.ts +11 -0
  2. package/dist/app/bootstrap.js +19 -0
  3. package/dist/app/deps.d.ts +124 -0
  4. package/dist/app/deps.js +751 -0
  5. package/dist/app/listen.d.ts +34 -0
  6. package/dist/app/listen.js +309 -0
  7. package/dist/app/mount-routes.d.ts +31 -0
  8. package/dist/app/mount-routes.js +696 -0
  9. package/dist/app/sse-events.d.ts +15 -0
  10. package/dist/app/sse-events.js +83 -0
  11. package/dist/app.d.ts +30 -17
  12. package/dist/app.js +164 -1337
  13. package/dist/auth/guards.d.ts +2 -1
  14. package/dist/auth/guards.js +10 -2
  15. package/dist/auth/middleware.d.ts +9 -14
  16. package/dist/auth/middleware.js +38 -6
  17. package/dist/auth/oidc.d.ts +22 -0
  18. package/dist/auth/oidc.js +68 -9
  19. package/dist/auth/service-scope.d.ts +8 -4
  20. package/dist/auth/service-scope.js +9 -5
  21. package/dist/events/hub.d.ts +2 -2
  22. package/dist/events/hub.js +3 -38
  23. package/dist/lib/app-config.d.ts +2 -0
  24. package/dist/lib/app-config.js +3 -2
  25. package/dist/lib/cors.d.ts +23 -0
  26. package/dist/lib/cors.js +24 -0
  27. package/dist/lib/defaults-store.d.ts +2 -25
  28. package/dist/lib/defaults-store.js +5 -87
  29. package/dist/lib/i18n.js +58 -6
  30. package/dist/main.js +23 -7
  31. package/dist/middleware/rate-limiter.d.ts +4 -1
  32. package/dist/middleware/rate-limiter.js +4 -2
  33. package/dist/routes/agents.d.ts +2 -2
  34. package/dist/routes/audit.d.ts +1 -1
  35. package/dist/routes/audit.js +2 -2
  36. package/dist/routes/auth.d.ts +2 -2
  37. package/dist/routes/auth.js +28 -4
  38. package/dist/routes/context.d.ts +2 -2
  39. package/dist/routes/gateway-patterns.d.ts +3 -3
  40. package/dist/routes/gateway-patterns.js +1 -1
  41. package/dist/routes/llm.d.ts +8 -2
  42. package/dist/routes/llm.js +9 -5
  43. package/dist/routes/mcp-registry.d.ts +6 -6
  44. package/dist/routes/mcp-registry.js +10 -10
  45. package/dist/routes/mcp.d.ts +1 -1
  46. package/dist/routes/mcp.js +1 -1
  47. package/dist/routes/messages.d.ts +5 -4
  48. package/dist/routes/messages.js +30 -3
  49. package/dist/routes/models.d.ts +7 -2
  50. package/dist/routes/models.js +3 -1
  51. package/dist/routes/projects.d.ts +7 -7
  52. package/dist/routes/projects.js +7 -7
  53. package/dist/routes/providers.d.ts +15 -3
  54. package/dist/routes/providers.js +34 -21
  55. package/dist/routes/queue.d.ts +5 -4
  56. package/dist/routes/queue.js +30 -3
  57. package/dist/routes/sessions.d.ts +14 -4
  58. package/dist/routes/sessions.js +234 -34
  59. package/dist/routes/users.js +1 -1
  60. package/dist/test-helpers/close-server.d.ts +33 -0
  61. package/dist/test-helpers/close-server.js +50 -0
  62. 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-роуты (AD-071 §2.5): legacy `/servers*`, `/session/:id` и
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
- // AD-071 §2.5: единый реестр MCP-серверов.
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?.() ?? options.networkPolicy;
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
- * AD-052/O1: запрос от installer-service-key (scope `addons:install`).
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
- // AD-071 §2.3.1: политика — для пользовательских HTTP-серверов; instance
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*` — тонкие адаптеры над единым реестром (AD-071 §2.5).
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-серверов (AD-071 §2.5) ---
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
- // AD-052/O1: service-key должен нести scope `addons:install` (интерактив без
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
- // AD-052/O1: installer-ключ (scope `addons:install`) создаёт instance-записи
281
+ // ADR-052/O1: installer-ключ (scope `addons:install`) создаёт instance-записи
282
282
  // даже без роли ADMIN — это общие записи инстанса (а не персональные).
283
283
  const isInstaller = isInstallerKey(c);
284
284
  let entryOrigin;
@@ -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*` (AD-071) —
8
+ * `/servers*`, `/session/:id` и единый реестр `/registry*` (ADR-071) —
9
9
  * backend-only (см. `mcp-registry.ts`). Порядок монтирования: core probe
10
10
  * первым, затем backend-only.
11
11
  */
@@ -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*` (AD-071) —
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
- * пересчёта `canSummarize` после мутаций (backend-специфика). Логика роутов
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;
@@ -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
- * пересчёта `canSummarize` после мутаций (backend-специфика). Логика роутов
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
  }
@@ -1,10 +1,15 @@
1
1
  import { Hono } from 'hono';
2
2
  import type { AuthKit } from '../auth/middleware.js';
3
- import { JsonStore } from '@itphx/synth-core';
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: JsonStore<ModelConfig>, providerStore: JsonStore<ProviderConfig>, modelCache: Map<string, ModelConfig>, providerCache: Map<string, ProviderConfig>): Hono;
15
+ export declare function createModelRoutes(kit: AuthKit, modelStore: JsonStoreLike<ModelConfig>, providerStore: JsonStoreLike<ProviderConfig>, modelCache: Map<string, ModelConfig>, providerCache: Map<string, ProviderConfig>, defaults?: ModelRoutesDefaultOptions): Hono;
@@ -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 { ProjectStore, SessionManager, McpManager, SkillService, RuntimeSettingsStore, McpRegistryStore } from '@itphx/synth-core';
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
- * AD-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
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 (AD-075, политика `deny` вне root), проектный MCP-скоуп (AD-071 §2.4)
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: ProjectStore, sessionManager: SessionManager, workspacesRoot: string,
28
- /** AD-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
27
+ export declare function createProjectRoutes(kit: AuthKit, store: ProjectRepository, sessionManager: SessionManager, workspacesRoot: string,
28
+ /** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
29
29
  mcpManager?: McpManager,
30
- /** AD-046 §4.5: сид скиллов нового проекта (системные дефолты). */
31
- skillService?: SkillService, settingsStore?: RuntimeSettingsStore, mcpRegistryStore?: McpRegistryStore): Hono;
30
+ /** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
31
+ skillService?: SkillService, settingsStore?: SettingsRepository, mcpRegistryStore?: McpRegistryRepository): Hono;
@@ -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
- * AD-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
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
- /** AD-071 §2.4: owner проекта или глобальные LEAD/ADMIN (через AuthKit). */
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
- * AD-089: чтение проекта по id — owner / любой участник (любая роль, в т.ч.
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 (AD-075, политика `deny` вне root), проектный MCP-скоуп (AD-071 §2.4)
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
- /** AD-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
33
+ /** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
34
34
  mcpManager,
35
- /** AD-046 §4.5: сид скиллов нового проекта (системные дефолты). */
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
- // AD-089: ADMIN/LEAD — сквозная видимость всех проектов (защита от мок-AuthKit).
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 { JsonStore } from '@itphx/synth-core';
4
- import type { ProviderConfig } from '@itphx/synth-shared';
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: JsonStore<ProviderConfig>, providerCache: Map<string, ProviderConfig>): Hono;
21
+ export declare function createProviderRoutes(kit: AuthKit, store: JsonStoreLike<ProviderConfig>, providerCache: Map<string, ProviderConfig>, egress?: ProviderRoutesEgressOptions, getDefaultModel?: () => DefaultModelPair | null | Promise<DefaultModelPair | null>): Hono;
@@ -1,23 +1,15 @@
1
1
  import { Hono } from 'hono';
2
- import { DEFAULT_MCP_PRIVATE_CIDRS } from '@itphx/synth-shared';
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-защита: внутренние/приватные адреса запрещены (включая DNS-резолв).
38
- const networkCheck = await evaluateMcpNetworkAccess(origin, PROVIDER_URL_NETWORK_POLICY);
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 fetch(iconUrl, {
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 fetch(origin, {
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 fetch(resolved, {
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
  }));
@@ -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-фабрикой очереди: добавляет только i18n-сообщения.
6
- * Логика роутов (clear/return/resume/retry-now/cancel-retry) — в core-фабрике.
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']>): Hono;
9
+ export declare function createQueueRoutes(kit: AuthKit, sessionManager: SessionManager, queueManager: QueueProcessorManager, eventBus: EventBus, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, projectStore?: ProjectRepository): Hono;
@@ -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-фабрикой очереди: добавляет только i18n-сообщения.
6
- * Логика роутов (clear/return/resume/retry-now/cancel-retry) — в core-фабрике.
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 { ProjectStore } from '@itphx/synth-core';
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?: 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
- * AD-089: единый funnel создания сессий (прокидывается в core-фабрику).
37
+ * ADR-089: единый funnel создания сессий (прокидывается в core-фабрику).
30
38
  * Не задан — core-фабрика использует прямой `SessionManager.createSession`.
31
39
  */
32
- requestSessionService?: RequestSessionService): Hono;
40
+ requestSessionService?: RequestSessionService,
41
+ /** PROP-102: сборщик `activity` (меры `aborts`/`messages_*`) для core-фабрики. */
42
+ analytics?: AnalyticsRecorder): Hono;