@itphx/synth-backend 0.10.1 → 0.12.4

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 (53) hide show
  1. package/dist/app/bootstrap.d.ts +2 -2
  2. package/dist/app/deps.d.ts +77 -33
  3. package/dist/app/deps.js +969 -102
  4. package/dist/app/listen.d.ts +13 -2
  5. package/dist/app/listen.js +138 -10
  6. package/dist/app/mount-routes.d.ts +16 -3
  7. package/dist/app/mount-routes.js +625 -32
  8. package/dist/app.d.ts +42 -7
  9. package/dist/app.js +149 -12
  10. package/dist/auth/guards.d.ts +17 -1
  11. package/dist/auth/guards.js +46 -2
  12. package/dist/auth/middleware.d.ts +2 -12
  13. package/dist/auth/middleware.js +20 -2
  14. package/dist/auth/oidc.d.ts +7 -0
  15. package/dist/auth/oidc.js +27 -6
  16. package/dist/auth/plugin-scope.d.ts +10 -0
  17. package/dist/auth/plugin-scope.js +69 -0
  18. package/dist/auth/service-scope.d.ts +7 -3
  19. package/dist/auth/service-scope.js +8 -4
  20. package/dist/events/hub.js +3 -38
  21. package/dist/lib/app-config.d.ts +2 -0
  22. package/dist/lib/app-config.js +3 -2
  23. package/dist/lib/defaults-store.d.ts +2 -25
  24. package/dist/lib/defaults-store.js +5 -87
  25. package/dist/lib/i18n.js +153 -0
  26. package/dist/main.js +67 -4
  27. package/dist/routes/agents.d.ts +12 -3
  28. package/dist/routes/agents.js +14 -2
  29. package/dist/routes/auth.d.ts +12 -2
  30. package/dist/routes/auth.js +16 -2
  31. package/dist/routes/context.d.ts +2 -2
  32. package/dist/routes/gateway-patterns.d.ts +2 -2
  33. package/dist/routes/llm.d.ts +8 -2
  34. package/dist/routes/llm.js +6 -3
  35. package/dist/routes/mcp-registry.d.ts +15 -3
  36. package/dist/routes/mcp-registry.js +122 -21
  37. package/dist/routes/messages.d.ts +7 -4
  38. package/dist/routes/messages.js +34 -3
  39. package/dist/routes/models.d.ts +7 -2
  40. package/dist/routes/models.js +3 -1
  41. package/dist/routes/processes.d.ts +34 -0
  42. package/dist/routes/processes.js +26 -0
  43. package/dist/routes/projects.d.ts +9 -3
  44. package/dist/routes/projects.js +8 -1
  45. package/dist/routes/providers.d.ts +15 -3
  46. package/dist/routes/providers.js +33 -21
  47. package/dist/routes/queue.d.ts +5 -4
  48. package/dist/routes/queue.js +30 -3
  49. package/dist/routes/sessions.d.ts +50 -3
  50. package/dist/routes/sessions.js +221 -74
  51. package/dist/test-helpers/close-server.d.ts +33 -0
  52. package/dist/test-helpers/close-server.js +50 -0
  53. package/package.json +4 -4
@@ -1,6 +1,7 @@
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
+ import type { WorktreeService } from '@itphx/synth-core';
4
5
  import type { Project } from '@itphx/synth-shared';
5
6
  /**
6
7
  * ADR-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
@@ -24,8 +25,13 @@ export declare function createProjectAccess(kit: AuthKit): {
24
25
  * workspace (ADR-075, политика `deny` вне root), проектный MCP-скоуп (ADR-071 §2.4)
25
26
  * и статистика сессий. Полная реализация — `@itphx/synth-core`.
26
27
  */
27
- export declare function createProjectRoutes(kit: AuthKit, store: ProjectStore, sessionManager: SessionManager, workspacesRoot: string,
28
+ export declare function createProjectRoutes(kit: AuthKit, store: ProjectRepository, sessionManager: SessionManager, workspacesRoot: string,
28
29
  /** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
29
30
  mcpManager?: McpManager,
30
31
  /** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
31
- skillService?: SkillService, settingsStore?: RuntimeSettingsStore, mcpRegistryStore?: McpRegistryStore): Hono;
32
+ skillService?: SkillService, settingsStore?: SettingsRepository, mcpRegistryStore?: McpRegistryRepository,
33
+ /**
34
+ * ADR-114: сервис worktree'ов проекта — контур `/projects/:id/worktrees*`
35
+ * (список/создание/удаление/prune). Не задан — роутов нет.
36
+ */
37
+ worktreeService?: WorktreeService): Hono;
@@ -33,7 +33,12 @@ export function createProjectRoutes(kit, store, sessionManager, workspacesRoot,
33
33
  /** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
34
34
  mcpManager,
35
35
  /** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
36
- skillService, settingsStore, mcpRegistryStore) {
36
+ skillService, settingsStore, mcpRegistryStore,
37
+ /**
38
+ * ADR-114: сервис worktree'ов проекта — контур `/projects/:id/worktrees*`
39
+ * (список/создание/удаление/prune). Не задан — роутов нет.
40
+ */
41
+ worktreeService) {
37
42
  const { canManageProject, canEditProjectContent, canReadProject } = createProjectAccess(kit);
38
43
  return createCoreProjectRoutes({ requireAuth: kit.requireAuth }, store, undefined, {
39
44
  canManage: canManageProject,
@@ -68,5 +73,7 @@ skillService, settingsStore, mcpRegistryStore) {
68
73
  sessionManager,
69
74
  getWorkspacesRoot: () => workspacesRoot,
70
75
  getOutsideRootPolicy: () => 'deny',
76
+ // ADR-114: контур worktree'ов проекта.
77
+ ...(worktreeService ? { worktrees: worktreeService } : {}),
71
78
  });
72
79
  }
@@ -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,6 +114,7 @@ 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),
@@ -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,15 @@ 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';
13
+ import type { MemoryFactRepository, MemoryIndexRepository } from '@itphx/synth-core';
14
+ import type { BlobRefRepository, BlobStore } from '@itphx/synth-core';
15
+ import type { AttachmentsConfig } from '@itphx/synth-shared';
16
+ import type { QuestionService } from '@itphx/synth-core';
17
+ import type { WorktreeService } from '@itphx/synth-core';
12
18
  /**
13
19
  * Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
14
20
  * backend-специфичные роуты (MCP-скоуп сессии, секреты, export/import, отладка,
@@ -19,8 +25,15 @@ import type { ProjectStore } from '@itphx/synth-core';
19
25
  * RBAC: core-фабрика параметризуется `resolveUserId`/`resolveOwner`/`resolveAuthor`,
20
26
  * `canAccess` (владелец|ADMIN) и EventHub-хуками; remote/hybrid-ветки отключены
21
27
  * (getRemoteClient не передаётся). `GET /:id/events` на backend не регистрируется.
28
+ *
29
+ * Исключения из общего prefix-guard'а (собственные правила, роуты зарегистрированы
30
+ * до guard'а): `/:id/mcp` (владелец|ADMIN, ADR-071 §2.4) и `/:id/secrets`
31
+ * (ADMIN|AUDITOR — карта обфускации). `/:id/export` — ПОД guard'ом: доступ к
32
+ * сессии решает ЕДИНЫЙ prefix-guard, а привилегию карты обфускации — отдельный
33
+ * route-level guard (`createSessionExportGuard`, ADR-036); в обработчике проверок
34
+ * доступа нет (инвариант 16).
22
35
  */
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,
36
+ 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
37
  /** Профили пользователей: display name для статистики (fallback — username). */
25
38
  profilesStore?: ProfileStore,
26
39
  /** Агент по умолчанию для новых сессий без `settings.agentRole` (runtime-настройка). */
@@ -29,4 +42,38 @@ resolveDefaultAgent?: () => string | Promise<string>,
29
42
  * ADR-089: единый funnel создания сессий (прокидывается в core-фабрику).
30
43
  * Не задан — core-фабрика использует прямой `SessionManager.createSession`.
31
44
  */
32
- requestSessionService?: RequestSessionService): Hono;
45
+ requestSessionService?: RequestSessionService,
46
+ /** ADR-102: сборщик `activity` (меры `aborts`/`messages_*`) для core-фабрики. */
47
+ analytics?: AnalyticsRecorder,
48
+ /** ADR-107: агрегаты памяти сессии для `GET /:id/memory` (вкладка «Память»). */
49
+ memory?: {
50
+ facts: MemoryFactRepository;
51
+ indexes: MemoryIndexRepository;
52
+ isPluginActive: () => boolean;
53
+ },
54
+ /**
55
+ * Этап 1 roadmap 0.13 (блок 3): сервис «вопрос пользователю» (`ask_user`).
56
+ *
57
+ * Не задан — маршруты вопросов отвечают 503 (подсистема не подключена).
58
+ */
59
+ questionService?: QuestionService,
60
+ /**
61
+ * ADR-114: сервис worktree'ов — привязка сессии к worktree
62
+ * (`PATCH /api/v2/sessions/:id { worktreeId }`).
63
+ *
64
+ * Не задан — поле `worktreeId` в PATCH игнорируется (привязка недоступна).
65
+ */
66
+ worktreeService?: WorktreeService,
67
+ /**
68
+ * ADR-115: вложения сообщений — blob-порт, учёт ссылок и лимиты
69
+ * (прокидывается в core-фабрику: загрузка/раздача + `attachments` в промпте).
70
+ */
71
+ attachments?: {
72
+ blobs: BlobStore;
73
+ blobRefs?: BlobRefRepository;
74
+ /**
75
+ * Настройки вложений: снимок **или** резолвер (ADR-115) — runtime-настройки
76
+ * из админки (`/api/v2/settings/attachments`) применяются на каждый вызов.
77
+ */
78
+ config: AttachmentsConfig | (() => AttachmentsConfig);
79
+ }): Hono;