@itphx/synth-backend 0.13.8 → 0.13.10

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.
@@ -2,33 +2,17 @@
2
2
  // (включая SSE/долгоживущие стримы) и WebSocket `/ws/events` (ADR-008/009/024/089).
3
3
  // Вынесено из `app.ts` (ADR-095, шаг 4b) — «вынос по швам», без изменения поведения.
4
4
  import { createServer } from 'node:http';
5
- import { Readable } from 'node:stream';
6
5
  import { WebSocketServer } from 'ws';
6
+ // Node-адаптер core — **общий** контракт standalone и managed (ADR-017/ADR-018:
7
+ // общая логика HTTP живёт в core): `toWebRequest` с сигналом отключения клиента
8
+ // и `pumpBody` с отменой читателя. Своей копии здесь быть не должно — иначе
9
+ // отмена стримов/подписок снова разойдётся (утечка `attached_clients`).
10
+ import { pumpBody, toWebRequest } from '@itphx/synth-core';
7
11
  import { enqueueUserMessage, enqueueSteerMessage, isSessionVisible, parsePermissionPrincipal, resolveUserPrincipal } from '@itphx/synth-core';
8
12
  import { MESSAGE_MODEL_QUERY_PARAM, MESSAGE_MODEL_UNSUPPORTED_CLOSE_CODE, MESSAGE_MODEL_UNSUPPORTED_REASON, isSupportedMessageModelParam, parseSinceParam, } from '@itphx/synth-core';
9
13
  import { nowISO, MessageRole, generateStreamId, isSteerMode, DEFAULT_STEER_MODE, MAX_STEER_INJECTIONS_PER_TURN, STEERING_ERROR_CODES } from '@itphx/synth-shared';
10
14
  import { t } from '../lib/i18n.js';
11
- /**
12
- * Вспомогательная функция для конвертации Node Request в Web Request.
13
- */
14
- function toWebRequest(req) {
15
- const protocol = 'http';
16
- const host = req.headers.host || 'localhost';
17
- const url = `${protocol}://${host}${req.url || '/'}`;
18
- const headers = new Headers();
19
- for (const [k, v] of Object.entries(req.headers)) {
20
- if (v)
21
- headers.set(k, Array.isArray(v) ? v.join(', ') : v);
22
- }
23
- const method = req.method || 'GET';
24
- const noBody = ['GET', 'HEAD'].includes(method) || !req.headers['content-length'];
25
- return new Request(url, {
26
- method,
27
- headers,
28
- body: noBody ? undefined : Readable.toWeb(req),
29
- duplex: 'half',
30
- });
31
- }
15
+ import { groupsOf } from '../lib/project-principal.js';
32
16
  /**
33
17
  * Адаптер для auth.getCurrentUser из сырого IncomingMessage (WS upgrade).
34
18
  */
@@ -62,7 +46,18 @@ export function createBackendListen(deps) {
62
46
  // Создаем HTTP сервер с WebSocket
63
47
  const server = createServer(async (req, res) => {
64
48
  try {
65
- const webReq = toWebRequest(req);
49
+ // Сигнал отключения клиента для `c.req.raw.signal`: Node сообщает о
50
+ // закрытии соединения событием `close` ответа (в т.ч. по таймауту
51
+ // клиента). Без него хендлеры долгоживущих потоков (терминал, SSE) не
52
+ // узнают об уходе клиента и не снимают подписки — `attached_clients`
53
+ // растёт, idle-reaper не срабатывает. Контракт — core
54
+ // `server/app/http-server.ts` (та же логика в standalone).
55
+ const abort = new AbortController();
56
+ res.on('close', () => {
57
+ if (!res.writableFinished)
58
+ abort.abort();
59
+ });
60
+ const webReq = toWebRequest(req, abort.signal);
66
61
  const response = await app.fetch(webReq, {});
67
62
  if (!response) {
68
63
  res.writeHead(500);
@@ -77,24 +72,20 @@ export function createBackendListen(deps) {
77
72
  // вовсе — сбрасываем head принудительно.
78
73
  res.flushHeaders();
79
74
  if (response.body) {
80
- const reader = response.body.getReader();
81
- const pump = async () => {
82
- while (true) {
83
- const { done, value } = await reader.read();
84
- if (done)
85
- break;
86
- res.write(value);
87
- }
88
- res.end();
89
- };
90
- pump().catch(() => res.end());
75
+ // Прокачка — общая с standalone: при обрыве клиента читатель
76
+ // **отменяется** (`reader.cancel()`), иначе цикл `read()` висит вечно
77
+ // и подписка хендлера остаётся живой.
78
+ pumpBody(response.body.getReader(), res);
91
79
  }
92
80
  else {
93
81
  res.end();
94
82
  }
95
83
  }
96
84
  catch {
97
- res.writeHead(500);
85
+ // После аборта клиента ответ уже может быть частично отправлен —
86
+ // повторный `writeHead` дал бы `ERR_HEADERS_SENT` в обработчике.
87
+ if (!res.headersSent)
88
+ res.writeHead(500);
98
89
  res.end();
99
90
  }
100
91
  });
@@ -172,6 +163,7 @@ export function createBackendListen(deps) {
172
163
  userId: user.id,
173
164
  username: user.username,
174
165
  allSessions,
166
+ ...(groupsOf(user) ? { groups: groupsOf(user) } : {}),
175
167
  send(event) {
176
168
  if (replaying) {
177
169
  pending.push(event);
@@ -387,6 +379,9 @@ export function createBackendListen(deps) {
387
379
  kind: 'user',
388
380
  id: user.id,
389
381
  roles: user.roles ?? [],
382
+ // ADR-140 Ф2: группы аутентифицированного пользователя
383
+ // (снимок claim'а IdP); нет — групп нет (fail-closed).
384
+ groups: user.groups ?? [],
390
385
  };
391
386
  const claim = await registry.claim(approvalId, sid, responder, {
392
387
  ...(turnId ? { turnId } : {}),
@@ -6,7 +6,10 @@
6
6
  import { isAbsolute, join, normalize, resolve } from 'node:path';
7
7
  import { randomUUID } from 'node:crypto';
8
8
  import { DEFAULT_LLM_GATEWAY_RATE_LIMIT, ProjectRole, SYNTH_VERSION, resolveSecretKey, resolveStorageBackend, resolvePostgresConfig, resolvePostgresPassword } from '@itphx/synth-shared';
9
- import { DEFAULT_AGENT_ID, RateLimiter, resolveAgentRoleAlias, getPublicOpenApiDocument, createFsRoutes, createGitRoutes, createSshKeyRoutes, createAgentSshKeyRoutes, createEventRoutes, createSchedulerRoutes, createServiceKeyRoutes, createWebhookRoutes, mergeLlmGatewayConfig, mergeSecurityConfig, mergePluginsConfig, createSkillRoutes, createCommandRoutes, createSkillBundleRoutes, createSessionSkillScopeRoutes, createProjectSkillScopeRoutes, createSkillSettingsRoutes, createIdentityRoutes, createMaintenanceRoutes, createAnalyticsRoutes, AnalyticsService, createProjectPortableRoutes, createStorageContextAsync, ProjectInstructionsResolver, createInstructionsInfoResolver, createSettingsRoutes, createDictionaryRoutes, createAuditRoutes, currentEgressLog,
9
+ import { resolvePromptInjection } from '@itphx/synth-shared/config';
10
+ import { DEFAULT_AGENT_ID, RateLimiter, resolveAgentRoleAlias, getPublicOpenApiDocument, createFsRoutes, createGitRoutes, createSshKeyRoutes, createAgentSshKeyRoutes, createEventRoutes, createSchedulerRoutes, createServiceKeyRoutes, createWebhookRoutes,
11
+ // PROP-141 (этап 5, B-2): HTTP-контур таймеров и будильников.
12
+ createTimerRoutes, mergeLlmGatewayConfig, mergeSecurityConfig, mergePluginsConfig, createSkillRoutes, createCommandRoutes, createSkillBundleRoutes, createSnippetRoutes, createSessionSkillScopeRoutes, createProjectSkillScopeRoutes, createSkillSettingsRoutes, createIdentityRoutes, createMaintenanceRoutes, createAnalyticsRoutes, AnalyticsService, createProjectPortableRoutes, createStorageContextAsync, ProjectInstructionsResolver, createInstructionsInfoResolver, createSettingsRoutes, createDictionaryRoutes, createAuditRoutes, currentEgressLog,
10
13
  // ADR-036/ADR-095: логи, аудит LLM Gateway, regex-паттерны, файлы контекста
11
14
  // и группы логирования — core-фабрики (backend передаёт RBAC/i18n через opts).
12
15
  createLogsRoutes, resolveLogDir, createGatewayPatternsRoutes, createContextFileRoutes, createDebugRoutes, createContextRoutes as createCoreContextRoutes, createMetricsSettingsRoutes,
@@ -15,11 +18,27 @@ createUpdateRoutes, createUpdatesSettingsRoutes,
15
18
  // ADR-115: админ-раздел «Вложения» — runtime-настройки мультимодального ввода.
16
19
  createAttachmentsSettingsRoutes, createModalityModelLookup, createContextWindowSettingsRoutes, createAgentsLimitsSettingsRoutes,
17
20
  // Лимит тяжёлых операций с сессиями (`limits.sessionOpsPerMinute`).
18
- createRequestLimitsSettingsRoutes, createContextDefaultsSettingsRoutes, createStickyNotesSettingsRoutes, createSshSettingsRoutes, createStagingAttachmentRoutes, AttachmentService, createPacksRoutes, createPipelinesRoutes, createPipelineProjectRoutes, createProcessRoutes, createPluginsRoutes, createPluginSettingsRoutes, createMemoryRoutes, MEMORY_PLUGIN_NAME, MemoryProviderUnavailableError, executeToolDef,
21
+ createRequestLimitsSettingsRoutes, createContextDefaultsSettingsRoutes, createStickyNotesSettingsRoutes, createSshSettingsRoutes, createBackgroundSettingsRoutes, createStagingAttachmentRoutes, AttachmentService, createPacksRoutes, createPipelinesRoutes, createPipelineProjectRoutes, createProcessRoutes, toBlockingRunDto,
22
+ // ADR-111 §detach: авто-detach блокирующих прогонов при вмешательстве
23
+ // (вклинивание из очереди) — тот же шов, что у prompt-роута.
24
+ autoDetachOnSteer,
25
+ // PROP-132 (Ф3б): HTTP-контур терминалов (сервис собирается в `deps.ts`).
26
+ createTerminalRoutes,
27
+ // PROP-132 (Ф3в): мастер-выключатель терминалов (`/api/v2/settings/terminal`).
28
+ createTerminalSettingsRoutes,
29
+ // PROP-135 Ф6b-1: профили и пулы исполнения — admin-API (`/api/v2/execution/*`).
30
+ createExecutionRoutes, createPluginsRoutes, createPluginSettingsRoutes, createMemoryRoutes, MEMORY_PLUGIN_NAME, MemoryProviderUnavailableError, executeToolDef,
19
31
  // ADR-118 §8: возможности инстанса (`GET /api/v2/meta`).
20
- createMetaRoutes, createOAuthRoutes, bindCredentialToConnector, syncMcpManagerFromRegistry, createProjectPlanRoutes, createProjectLogRoutes, resolveProjectWorkspace, resolvePluginServerPolicy, } from '@itphx/synth-core';
32
+ createMetaRoutes, createOAuthRoutes, bindCredentialToConnector, syncMcpManagerFromRegistry, createProjectPlanRoutes, createProjectLogRoutes, resolveProjectWorkspace, resolvePluginServerPolicy,
33
+ // PROP-135 Ф6a: каталог профилей исполнения — валидация проектных/сессионных
34
+ // настроек профиля.
35
+ executionProfileCatalog, browserProfileCatalog,
36
+ // ADR-099: env дочернего npm (CA `security.tls` + прокси-маршрут реестра).
37
+ resolveNpmInstallEnvironment, } from '@itphx/synth-core';
21
38
  import { createProjectRoutes, createProjectAccess } from '../routes/projects.js';
22
39
  import { createBackendProcessAccess } from '../routes/processes.js';
40
+ import { createBackendScheduleAccess } from '../routes/schedules.js';
41
+ import { createBackendProjectAccess } from '../routes/project-access.js';
23
42
  import { createSessionRoutes } from '../routes/sessions.js';
24
43
  import { createMessageRoutes } from '../routes/messages.js';
25
44
  import { createQueueRoutes } from '../routes/queue.js';
@@ -40,7 +59,7 @@ import { registerEventsSse } from './sse-events.js';
40
59
  */
41
60
  export function mountBackendRoutes(app, auth, ctx) {
42
61
  const { config, deps } = ctx;
43
- const { dataDir, projectStore, sessionManager, eventBus, queueManager, processMessage, orchestrator, profilesStore, getDefaultAgentId, requestSessionService, contextOptimizer, protectedPathsStore, providerStore, providerCache, modelStore, modelCache, agentStore, agentRegistry, contextConfig, sshKeyStore, commandService, bundleStore, dictionaries, serviceApiKeyStore, eventIngress, eventBindingStore, eventJournal, routeRuleStore, eventApiKeyStore, schedulerService, scheduleStore, jobStore, webhookStore, webhookDeliveryStore, webhookService, webhooksConfig, eventHub, mcpManager, mcpRegistryStore, skillService, settingsStore, egressResolver, securityAudit, egressRequests, defaultWorkingDir, patternStore, toolRegistry, gatewayAuditLogger, gatewayPayloadLogPath, gatewayConfig, providerLoader, modelLoader, modelWindowLoader, resolveAgentTemplate, identityClaimStore, live, maintenanceAudit, analyticsRollups, analytics, metrics, pipelines, packs, } = deps;
62
+ const { dataDir, projectStore, sessionManager, eventBus, queueManager, processMessage, orchestrator, profilesStore, getDefaultAgentId, requestSessionService, contextOptimizer, protectedPathsStore, providerStore, providerCache, modelStore, modelCache, agentStore, agentRegistry, contextConfig, sshKeyStore, commandService, bundleStore, dictionaries, serviceApiKeyStore, snippetService, eventIngress, eventBindingStore, eventJournal, routeRuleStore, eventApiKeyStore, schedulerService, scheduleStore, jobStore, webhookStore, webhookDeliveryStore, webhookService, webhooksConfig, eventHub, mcpManager, mcpRegistryStore, skillService, settingsStore, egressResolver, securityAudit, egressRequests, commandAuditLog, defaultWorkingDir, patternStore, toolRegistry, gatewayAuditLogger, gatewayPayloadLogPath, gatewayConfig, providerLoader, modelLoader, modelWindowLoader, resolveAgentTemplate, identityClaimStore, live, maintenanceAudit, analyticsRollups, analytics, metrics, pipelines, packs, } = deps;
44
63
  /**
45
64
  * Fallback-пара «модель по умолчанию» из config (`llm.defaultProvider` +
46
65
  * `llm.defaultModel`) — только если заданы оба.
@@ -65,8 +84,16 @@ export function mountBackendRoutes(app, auth, ctx) {
65
84
  // Объявлены до монтирования проектов — их используют и контур плана/журнала
66
85
  // (PROP-054), и FS/git-роуты.
67
86
  const projectAccess = createProjectAccess(auth);
87
+ // PROP-135 Ф6a: снимок каталога профилей исполнения — валидация
88
+ // `project.executor` (PUT проекта) и `settings.executorProfile` (PATCH сессии).
89
+ const executionProfiles = executionProfileCatalog(deps.executionRouter);
90
+ // PROP-135 (браузерный контур): каталог браузерных профилей — валидация
91
+ // `browser_profile`/`allowedBrowserProfiles` у агента/проекта/сессии.
92
+ const browserProfiles = browserProfileCatalog(deps.executionRouter);
68
93
  // Projects routes
69
- app.route('/api/v2/projects', createProjectRoutes(auth, projectStore, sessionManager, config.workspacesRoot, mcpManager, skillService, settingsStore, mcpRegistryStore, deps.worktreeService, eventBus));
94
+ // ADR-140 Ф2: хаб подписок — при смене состояния доступа к проекту
95
+ // пересчитываются подписки уже подключённых клиентов (WS/SSE).
96
+ app.route('/api/v2/projects', createProjectRoutes(auth, projectStore, sessionManager, config.workspacesRoot, mcpManager, skillService, settingsStore, mcpRegistryStore, deps.worktreeService, eventBus, executionProfiles, browserProfiles, securityAudit, eventHub, profilesStore));
70
97
  // PROP-054: точечные операции плана проекта (`/projects/:id/plan*`) —
71
98
  // core-фабрика, RBAC — те же правила проекта (чтение — право чтения,
72
99
  // мутации — право изменения содержимого; `VIEWER` читает, но не мутирует).
@@ -206,7 +233,35 @@ export function mountBackendRoutes(app, auth, ctx) {
206
233
  },
207
234
  // Лимит тяжёлых операций ресурса сессий (`limits.sessionOpsPerMinute`) —
208
235
  // live-геттер: резолвится на каждый запрос (0 — без лимита).
209
- () => deps.sessionOpsPerMinuteSettings.getValue()));
236
+ () => deps.sessionOpsPerMinuteSettings.getValue(),
237
+ // PROP-135 Ф6a: каталог профилей — валидация `settings.executorProfile`.
238
+ executionProfiles,
239
+ // PROP-135 (браузерный контур): каталог браузерных профилей сессии.
240
+ browserProfiles,
241
+ // ADR-126 §4: сниппеты (`#`) — раскрытие в приёме промпта (до очереди).
242
+ snippetService,
243
+ // Рабочий каталог проекта — project-уровень сниппетов. Резолв тот же,
244
+ // что у snippet-routes (относительный workspace — от `workspacesRoot`).
245
+ async (projectId) => {
246
+ const project = await projectStore.load(projectId);
247
+ if (!project?.workspace)
248
+ return undefined;
249
+ return isAbsolute(project.workspace)
250
+ ? normalize(project.workspace)
251
+ : resolve(config.workspacesRoot, project.workspace);
252
+ },
253
+ // ADR-126 §5: реестр скриптов проекта (`!`-запуск) — контур
254
+ // `/api/v2/sessions/:id/scripts*` (внутри сессий — под prefix-guard'ом).
255
+ deps.scriptService,
256
+ // Правила прав инстанса — fallback для `permission.rules.script`.
257
+ config.synth.permission,
258
+ // ADR-136: журнал исполнений — запись `script.run` (только метаданные).
259
+ deps.commandAuditLog,
260
+ // ADR-126 §5: реестр скриптов для сессии без проекта — default workspace.
261
+ defaultWorkingDir,
262
+ // PROP-141 (Часть D): сервис переноса сессии между проектами (единый шов:
263
+ // блокеры, согласие `move_consent`, порядок эффектов).
264
+ deps.moveService));
210
265
  // Messages routes
211
266
  app.route('/api/v2/messages', createMessageRoutes(auth, sessionManager, contextOptimizer, eventBus, projectStore,
212
267
  // ADR-115: удаление сообщения снимает ссылки на объекты вложений.
@@ -214,7 +269,17 @@ export function mountBackendRoutes(app, auth, ctx) {
214
269
  // Queue routes
215
270
  app.route('/api/v2/queue', createQueueRoutes(auth, sessionManager, queueManager, eventBus, processMessage, projectStore,
216
271
  // ADR-036: обфускация user-сообщения при /queue/:sessionId/steer.
217
- (sessionId, message) => orchestrator.obfuscateUserMessageForHistory(sessionId, message)));
272
+ (sessionId, message) => orchestrator.obfuscateUserMessageForHistory(sessionId, message),
273
+ // ADR-111 §detach: вклинивание из очереди — вмешательство пользователя,
274
+ // поэтому блокирующие прогоны сессии уходят в фон (как steer в prompt-роуте).
275
+ // Гейт `background.enabled` читается живым геттером оркестратора.
276
+ ({ sessionId, enabled, reason }) => autoDetachOnSteer({
277
+ orchestrator,
278
+ sessionId,
279
+ enabled: enabled ?? orchestrator.isBackgroundEnabled?.(),
280
+ reason: reason ?? 'message',
281
+ eventBus,
282
+ })));
218
283
  // FS routes (ADR-075): core-фабрика, managed поверх workspace проекта.
219
284
  // ADR-089 (P0): доступ к проекту обязателен — иначе любой USER читал/писал бы
220
285
  // файлы чужого проекта по id (IDOR). Чтение — canRead, мутации — canEditContent.
@@ -273,9 +338,10 @@ export function mountBackendRoutes(app, auth, ctx) {
273
338
  setDefaultModel: (pair) => settingsStore.setDefaultModel(pair),
274
339
  }));
275
340
  // Agents routes
276
- // ADR-046/ADR-089: ролевой промпт агента (`role_prompt` в теле POST)
341
+ // ADR-126/ADR-089: ролевой промпт агента (`role_prompt` в теле POST)
277
342
  // пишется портом файлов контекста — `{dataDir}/context/roles/<contextFile>`.
278
- app.route('/api/v2/agents', createAgentRoutes(auth, agentStore, agentRegistry, getDefaultAgentId, contextConfig));
343
+ // PROP-135 Ф6a: каталог профилей — проверка `executor_profile`/`allowed_profiles`.
344
+ app.route('/api/v2/agents', createAgentRoutes(auth, agentStore, agentRegistry, getDefaultAgentId, contextConfig, executionProfiles, browserProfiles));
279
345
  // Context routes (файлы контекста/промптов инстанца; админ-мутации) — core-фабрика.
280
346
  app.route('/api/v2/context', createContextFileRoutes(auth, contextConfig, {
281
347
  adminGuard: auth.requireAdmin,
@@ -285,7 +351,10 @@ export function mountBackendRoutes(app, auth, ctx) {
285
351
  },
286
352
  }));
287
353
  // User admin routes
288
- app.route('/api/v2/users', createUserRoutes(auth, profilesStore));
354
+ // ADR-140 Ф2: `GET /api/v2/users/groups` — каталог групп из allowlist
355
+ // `auth.oidc.groups.allow` (env `SYNTH_OIDC_GROUPS_ALLOW` перекрывает конфиг;
356
+ // пустой allowlist → групп нет, fail-closed).
357
+ app.route('/api/v2/users', createUserRoutes(auth, profilesStore, { groups: config.auth.oidc?.groups?.allow ?? [] }));
289
358
  // Git routes (ADR-076 §T4): core-фабрика + managed RBAC. Write-эндпоинты
290
359
  // (init/clone/register/remove/fetch) требуют прав на изменение контента
291
360
  // проекта (owner/EDITOR/LEAD/ADMIN); read-only (scan/log/commit) — права
@@ -375,20 +444,56 @@ export function mountBackendRoutes(app, auth, ctx) {
375
444
  eventsDisabled: (c) => t('errors.unavailable.eventsDisabled', undefined, c),
376
445
  },
377
446
  }));
378
- // ADR-051 / ADR-089: CRUD расписаний, принудительный запуск и Job-история.
379
- // Чтение — requireAuth (дефолт core-фабрики), мутации — ADMIN. `run` —
380
- // ADMIN + rate limit (образец — ingest внешних событий): 10 запусков / 60 c
381
- // на ключ, т.к. каждый запуск ингестит событие в Router.
447
+ // ADR-051 / ADR-089 / PROP-141 (этап 5, B-1): CRUD расписаний, принудительный
448
+ // запуск и Job-история. Права — **по проекту расписания** (ADR-089 §5.5/§5.8):
449
+ // читать — владелец/участник/`LEAD`/`ADMIN`, изменять — `OWNER`/`EDITOR`/
450
+ // `LEAD`/`ADMIN` (`VIEWER` читает, но не мутирует — инвариант 21). Прежний
451
+ // `requireAdmin` на все мутации снят (PROP-141, решение владельца 2026-11-17).
452
+ // Проверка — граничная (инвариант 16): `authorizeProject`/`listVisibleProjectIds`
453
+ // из `routes/schedules.ts` (тот же `createProjectAccess`, что у процессов).
454
+ // `run` — `requireAuth` + rate limit (образец — ingest внешних событий):
455
+ // 10 запусков / 60 c на ключ, т.к. каждый запуск ингестит событие в Router.
456
+ const scheduleAccess = createBackendScheduleAccess({ auth, projectStore });
382
457
  app.route('/api/v2/schedules', createSchedulerRoutes(auth, { scheduleStore, scheduler: schedulerService, jobStore }, {
383
- writeGuard: auth.requireAdmin,
384
- runGuard: auth.requireAdmin,
458
+ writeGuard: auth.requireAuth,
459
+ runGuard: auth.requireAuth,
385
460
  runMiddleware: [createRateLimiter(10, 60_000)],
386
461
  // ADR-052 (этап I): scope-гейт, проектная проекция и резолвинг
387
462
  // projectId `bound`/`queue`-целей расписания.
388
463
  scopeGuard,
389
464
  serviceProjectProjection,
390
465
  resolveSessionProject: async (id) => (await sessionManager.getSession(id))?.projectId,
466
+ // PROP-141 (этап 5): права — по проекту расписания; список ограничен
467
+ // видимыми проектами и собственными расписаниями.
468
+ authorizeProject: scheduleAccess.authorizeProject,
469
+ listVisibleProjectIds: scheduleAccess.listVisibleProjectIds,
391
470
  }));
471
+ // PROP-141 (этап 5, B-2): HTTP-контур таймеров и будильников
472
+ // (`/api/v2/timers`). Права — **по проекту таймера** (ADR-089 §5.5/§5.8):
473
+ // читать — владелец/участник/`LEAD`/`ADMIN`, изменять — `OWNER`/`EDITOR`/
474
+ // `LEAD`/`ADMIN` (`VIEWER` читает, но не мутирует — инвариант 21). Проверка —
475
+ // граничная (инвариант 16): `authorizeProject`/`listVisibleProjectIds` из
476
+ // `routes/project-access.ts` (общий хелпер с расписаниями — правило одно).
477
+ // Мутации — под rate limit 10/60 c (как принудительный запуск расписания).
478
+ // Движок не создан в деградированном режиме хранилища — тогда контура нет.
479
+ if (deps.timerService) {
480
+ const timerAccess = createBackendProjectAccess({ auth, projectStore });
481
+ app.route('/api/v2/timers', createTimerRoutes(auth, {
482
+ timerService: deps.timerService,
483
+ timers: deps.storageContext.timers,
484
+ firings: deps.storageContext.timerFirings,
485
+ }, {
486
+ writeGuard: auth.requireAuth,
487
+ writeMiddleware: [createRateLimiter(10, 60_000)],
488
+ // ADR-052 (этап I): scope-гейт service-key и проектная проекция.
489
+ scopeGuard,
490
+ serviceProjectProjection,
491
+ // Проект таймера выводится из сессии (инстансных автоматизаций нет).
492
+ resolveSessionProject: async (id) => (await sessionManager.getSession(id))?.projectId,
493
+ authorizeProject: timerAccess.authorizeProject,
494
+ listVisibleProjectIds: timerAccess.listVisibleProjectIds,
495
+ }));
496
+ }
392
497
  // ADR-051/ADR-100: API пайплайнов — определения (ставит установщик пакета),
393
498
  // экземпляры и ручной запуск. Чтение — ADMIN (реестр автоматов инстанса),
394
499
  // ручной запуск — ADMIN или service-key со scope `automation:install`.
@@ -455,6 +560,35 @@ export function mountBackendRoutes(app, auth, ctx) {
455
560
  background: deps.backgroundService,
456
561
  processes: deps.processService,
457
562
  sessionManager,
563
+ // ADR-111 §detach: блокирующие (foreground) прогоны видны во вкладке
564
+ // «Процессы» и останавливаются отдельно. Seam'ы читают **живой**
565
+ // реестр оркестратора (ленивый геттер, не снимок).
566
+ getBlocking: (sessionIds) => orchestrator.activeRuns
567
+ .listForSessions(sessionIds)
568
+ .filter((run) => !!run.sessionId)
569
+ .map((run) => toBlockingRunDto(run)),
570
+ stopBlocking: async (sessionIds, id) => {
571
+ const run = orchestrator.activeRuns.find(sessionIds, id);
572
+ if (typeof run?.stop !== 'function')
573
+ return false;
574
+ await run.stop();
575
+ return true;
576
+ },
577
+ readBlockingLog: async (sessionIds, id, logOpts) => {
578
+ const run = orchestrator.activeRuns.find(sessionIds, id);
579
+ if (!run?.logPath || !deps.processService)
580
+ return null;
581
+ const segment = await deps.processService.readLogAtPath(run.logPath, logOpts);
582
+ if (!segment)
583
+ return null;
584
+ return {
585
+ output: segment.content,
586
+ truncated: segment.truncated === true,
587
+ logPath: run.logPath,
588
+ size: segment.totalBytes,
589
+ nextOffset: segment.nextOffset,
590
+ };
591
+ },
458
592
  }, {
459
593
  isAllowed: createBackendProcessAccess({ auth, projectStore }),
460
594
  resolveUserId: async (c) => (await auth.getCurrentUser(c))?.id ?? '',
@@ -471,6 +605,26 @@ export function mountBackendRoutes(app, auth, ctx) {
471
605
  },
472
606
  }));
473
607
  }
608
+ // PROP-132 (Ф3б): HTTP-контур интерактивных терминалов
609
+ // (`/api/v2/terminals*`): список, создание, снимок, правка, закрытие,
610
+ // вывод (снимок + NDJSON-поток), ввод и размер. Права — **по правилам
611
+ // проекта** (ADR-089 §5.5/§5.8): чтение — `canReadProject`, мутации —
612
+ // `canEditProjectContent` (`VIEWER` читает, но не мутирует — инвариант 21);
613
+ // проверка — граничные guard'ы фабрики (инвариант 16), в обработчиках её нет.
614
+ //
615
+ // Сервис терминалов собирается в `deps.ts` (Ф3в): один экземпляр на
616
+ // процесс, мастер-выключатель `terminal.enabled` (`/api/v2/settings/terminal`)
617
+ // и остановка на graceful shutdown — там.
618
+ app.route('/api/v2/terminals', createTerminalRoutes({ requireAuth: auth.requireAuth }, {
619
+ terminal: deps.terminalService,
620
+ projects: { load: (id) => projectStore.load(id) },
621
+ sessions: { getSession: (id) => sessionManager.getSession(id) },
622
+ }, {
623
+ getCurrentUserId: async (c) => (await auth.getCurrentUser(c))?.id ?? '',
624
+ canReadProject: async (c, project, userId) => projectAccess.canReadProject(c, project, userId),
625
+ canEditProjectContent: async (c, project, userId) => projectAccess.canEditProjectContent(c, project, userId),
626
+ workspacesRoot: config.workspacesRoot,
627
+ }));
474
628
  // ADR-086 §5: установка пакетов расширений (скиллы/MCP/агенты/пайплайны) и
475
629
  // реестр установок. Managed RBAC: установка — ADMIN или service-key со
476
630
  // scope `automation:install`; одобрение и снятие — **только ADMIN** (снимают
@@ -641,6 +795,19 @@ export function mountBackendRoutes(app, auth, ctx) {
641
795
  readGuard: auth.requirePermission('ADMIN'),
642
796
  writeGuard: auth.requirePermission('ADMIN'),
643
797
  }));
798
+ // Этап 1 roadmap 0.13 (блок 4): настройки секции `background` (реестр фоновых
799
+ // прогонов) — тумблер, лимиты, предел лога, retention. Применяются **сразу**
800
+ // (сервисы и pruner'ы читают живой резолвер). Managed RBAC — ADMIN.
801
+ app.route('/api/v2/settings', createBackgroundSettingsRoutes({ requireAuth: auth.requireAuth }, {
802
+ settingsStore,
803
+ config: config.synth.background,
804
+ live: deps.backgroundSettings,
805
+ securityAudit,
806
+ env: process.env,
807
+ }, {
808
+ readGuard: auth.requirePermission('ADMIN'),
809
+ writeGuard: auth.requirePermission('ADMIN'),
810
+ }));
644
811
  // ADR-115: staging-загрузка без сессии — `POST /api/v2/attachments`
645
812
  // (шлюзы принимают файл из внешнего канала, пайплайны — из шага). Managed:
646
813
  // `requireAuth` + scope-гейт service-key `events:ingest` (у шлюзов он уже
@@ -903,7 +1070,7 @@ export function mountBackendRoutes(app, auth, ctx) {
903
1070
  await syncMcpManagerFromRegistry(mcpManager, deps.mcpRegistryStore);
904
1071
  },
905
1072
  }));
906
- // Скиллы (ADR-046 §9.1/§9.2): core-фабрика + RBAC ADMIN на запись.
1073
+ // Скиллы (ADR-126 §9): core-фабрика + RBAC ADMIN на запись.
907
1074
  app.route('/api/v2/skills', createSkillRoutes(auth, {
908
1075
  skillService,
909
1076
  resolveProjectWorkspace: async (projectId) => {
@@ -915,7 +1082,27 @@ export function mountBackendRoutes(app, auth, ctx) {
915
1082
  : resolve(config.workspacesRoot, project.workspace);
916
1083
  },
917
1084
  }, { writeGuard: requireAdminOrScope('addons:install') }));
918
- // ADR-046 §7/§9.1: команды и bundles (mirror core, мутации — ADMIN).
1085
+ // ADR-126 §4: сниппеты (`#`) — core-фабрика. Права: инстанс-уровень —
1086
+ // ADMIN (`writeGuard`), user-уровень — только свой, проектный — право
1087
+ // изменения содержимого проекта (`OWNER`/`EDITOR`, инвариант 21).
1088
+ app.route('/api/v2/snippets', createSnippetRoutes(auth, {
1089
+ snippetService,
1090
+ projectStore,
1091
+ resolveProjectWorkspace: async (projectId) => {
1092
+ const project = await projectStore.load(projectId);
1093
+ if (!project?.workspace)
1094
+ return undefined;
1095
+ return isAbsolute(project.workspace)
1096
+ ? normalize(project.workspace)
1097
+ : resolve(config.workspacesRoot, project.workspace);
1098
+ },
1099
+ }, {
1100
+ writeGuard: auth.requireAdmin,
1101
+ resolveUserId: async (c) => (await auth.getCurrentUser(c))?.id ?? '',
1102
+ canReadProject: (c, project, userId) => projectAccess.canReadProject(c, project, userId),
1103
+ canEditProject: (c, project, userId) => projectAccess.canEditProjectContent(c, project, userId),
1104
+ }));
1105
+ // ADR-126 §1/§14: команды и bundles (mirror core, мутации — ADMIN); скиллов в каталоге нет.
919
1106
  app.route('/api/v2/commands', createCommandRoutes(auth, {
920
1107
  commandService,
921
1108
  resolveProjectWorkspace: async (projectId) => {
@@ -938,7 +1125,7 @@ export function mountBackendRoutes(app, auth, ctx) {
938
1125
  return missing;
939
1126
  },
940
1127
  }, { writeGuard: auth.requireAdmin }));
941
- // ADR-046 §4.5: scope-API скиллов. Доступ к сессии — та же семантика, что у
1128
+ // ADR-126 §11: scope-API скиллов. Доступ к сессии — та же семантика, что у
942
1129
  // `createSessionRoutes` (единая точка истины на ресурс сессии): владелец|ADMIN
943
1130
  // (`canAccess`), участник проекта (`resolveCanAccessExtra`), сквозной обзор
944
1131
  // ADMIN/LEAD (`resolveElevated`); проект — owner/LEAD/ADMIN.
@@ -954,7 +1141,7 @@ export function mountBackendRoutes(app, auth, ctx) {
954
1141
  sessionManager, skillService, settingsStore, projectStore,
955
1142
  permissionConfig: config.synth.permission,
956
1143
  resolveProjectWorkspace: resolveSkillWorkspace,
957
- // ADR-046 §6.3: capability-гейт сессии — по capabilities её агента
1144
+ // ADR-126 §10: capability-гейт сессии — по capabilities её агента
958
1145
  // (legacy-роль резолвится алиасом, как в рантайме оркестратора).
959
1146
  resolveAgentCapabilities: (role) => {
960
1147
  const resolved = role ? (resolveAgentRoleAlias(role) ?? role) : undefined;
@@ -988,7 +1175,7 @@ export function mountBackendRoutes(app, auth, ctx) {
988
1175
  permissionConfig: config.synth.permission,
989
1176
  resolveProjectWorkspace: resolveSkillWorkspace,
990
1177
  }, {
991
- // ADR-046 §4.5: проектным уровнем управляют owner/LEAD/ADMIN — как в
1178
+ // ADR-126 §11: проектным уровнем управляют owner/LEAD/ADMIN — как в
992
1179
  // project-MCP (`canManageProjectMcp`), поэтому writeGuard не requireAdmin;
993
1180
  // владение проверяет canAccessProject (403 не-членам, 404 — нет проекта).
994
1181
  writeGuard: auth.requireAuth,
@@ -1038,6 +1225,8 @@ export function mountBackendRoutes(app, auth, ctx) {
1038
1225
  app.route('/api/v2/audit', createAuditRoutes(auth, {
1039
1226
  securityAudit,
1040
1227
  egressRequests,
1228
+ // PROP-136 (слайс 136a): журнал исполнений команд (`/audit/commands`).
1229
+ commandAudit: commandAuditLog,
1041
1230
  gatewayAudit: {
1042
1231
  auditLogPath: gatewayAuditLogger.logPath,
1043
1232
  sessionExists: async (sessionId) => {
@@ -1050,6 +1239,8 @@ export function mountBackendRoutes(app, auth, ctx) {
1050
1239
  readGuard: auth.requirePermission('ADMIN', 'AUDITOR'),
1051
1240
  gatewayReadGuard: auth.requirePermission('ADMIN', 'AUDITOR'),
1052
1241
  revealedGuard: auth.requireAuth,
1242
+ // Retention-очистка журнала исполнений — только ADMIN (изменяет данные журнала).
1243
+ commandsAdminGuard: auth.requireAdmin,
1053
1244
  }));
1054
1245
  // Логи сервисов (core/ui/backend) + полный лог запросов/ответов LLM — чтение, только ADMIN/AUDITOR
1055
1246
  app.route('/api/v2/logs', createLogsRoutes(auth, {
@@ -1117,6 +1308,8 @@ export function mountBackendRoutes(app, auth, ctx) {
1117
1308
  // ADR-029: askTimeoutMs живёт в permission-секции конфига (не в security).
1118
1309
  askTimeoutMs: config.synth.permission?.askTimeoutMs,
1119
1310
  },
1311
+ // ADR-023: база `security.promptInjection` (config.yaml) — GET/DELETE и env-резолвер.
1312
+ fallbackPromptInjection: config.synth.security.promptInjection,
1120
1313
  // ADR-036: live-применение тумблера LLM Gateway из UI — без рестарта сервера.
1121
1314
  onLlmGatewayChange: async (runtime) => {
1122
1315
  const merged = mergeLlmGatewayConfig(config.synth.llmGateway, runtime);
@@ -1125,6 +1318,10 @@ export function mountBackendRoutes(app, auth, ctx) {
1125
1318
  // live-применение тумблера защищённых путей из UI — без рестарта сервера.
1126
1319
  onSecurityChange: async (runtime) => {
1127
1320
  const merged = mergeSecurityConfig(config.synth.security, runtime);
1321
+ if (merged) {
1322
+ // ADR-023: env `SYNTH_SECURITY_PROMPT_INJECTION_*` перекрывает runtime/config.
1323
+ merged.promptInjection = resolvePromptInjection(config.synth.security.promptInjection, runtime.promptInjection).config;
1324
+ }
1128
1325
  orchestrator.setSecurityConfig(merged);
1129
1326
  },
1130
1327
  // ADR-071 §2.3: live-применение политики встроенных инструментов из админки.
@@ -1155,6 +1352,10 @@ export function mountBackendRoutes(app, auth, ctx) {
1155
1352
  fallbackEgressWebhooks: config.synth.egress.webhooks,
1156
1353
  // ADR-099: прокси — config-уровень, runtime-override и файл пароля.
1157
1354
  fallbackProxy: config.synth.proxy,
1355
+ // ADR-135: runtime-каталог профилей исполнения — config-уровень (база) и
1356
+ // секция, с которой работает процесс (`restartRequired`).
1357
+ fallbackExecution: deps.fallbackExecutionConfig,
1358
+ getRunningExecution: () => deps.executionConfig,
1158
1359
  // ADR-099: TLS/CA — config-уровень (read-only в UI; runtime — bootstrap).
1159
1360
  fallbackTls: config.synth.security?.tls,
1160
1361
  dataDir,
@@ -1193,13 +1394,33 @@ export function mountBackendRoutes(app, auth, ctx) {
1193
1394
  app.route('/api/v2/updates', createUpdateRoutes(auth, dataDir, {
1194
1395
  updates: config.synth.updates,
1195
1396
  audit: maintenanceAudit,
1397
+ // ADR-099: дочерний npm получает доверие CA и прокси-маршрут инстанса.
1398
+ npmEnvironment: resolveNpmInstallEnvironment,
1196
1399
  }, {
1197
1400
  readGuard: auth.requirePermission('ADMIN'),
1198
1401
  writeGuard: auth.requirePermission('ADMIN'),
1199
1402
  }));
1403
+ // PROP-135 Ф6b-1: профили и пулы исполнения (`/api/v2/execution/*`).
1404
+ // Managed RBAC: каталог профилей — любой аутентифицированный (владелец проекта
1405
+ // выбирает профиль в настройках, роль у него может быть USER); список пулов —
1406
+ // ADMIN|LEAD (обзор инстанса); `drain`/`release` — только ADMIN (управление
1407
+ // ресурсами provisioner'а). Адреса и токены пулов наружу не отдаются (инвариант 13).
1408
+ app.route('/api/v2/execution', createExecutionRoutes({ requireAuth: auth.requireAuth }, {
1409
+ ...(deps.executionConfig ? { executionConfig: deps.executionConfig } : {}),
1410
+ executionRouter: deps.executionRouter,
1411
+ }, {
1412
+ profilesReadGuard: auth.requireAuth,
1413
+ poolsReadGuard: auth.requirePermission('ADMIN', 'LEAD'),
1414
+ writeGuard: auth.requirePermission('ADMIN'),
1415
+ messages: {
1416
+ invalidKey: (c) => t('errors.validation.executionPoolKey', undefined, c),
1417
+ providerUnavailable: (c) => t('errors.unavailable.executionProvider', undefined, c),
1418
+ poolNotFound: (c, key) => `${t('errors.notFound.executionPool', undefined, c)} (${key})`,
1419
+ },
1420
+ }));
1200
1421
  // ADR-133: админ-раздел «Обновления» — runtime-тумблер автопроверки.
1201
1422
  // Managed RBAC: чтение и запись — только ADMIN.
1202
- app.route('/api/v2/settings', createUpdatesSettingsRoutes({ requireAuth: auth.requireAuth }, { settingsStore, config: config.synth.updates, env: process.env }, {
1423
+ app.route('/api/v2/settings', createUpdatesSettingsRoutes({ requireAuth: auth.requireAuth }, { settingsStore, dataDir, config: config.synth.updates, env: process.env }, {
1203
1424
  readGuard: auth.requirePermission('ADMIN'),
1204
1425
  writeGuard: auth.requirePermission('ADMIN'),
1205
1426
  }));
@@ -1220,6 +1441,21 @@ export function mountBackendRoutes(app, auth, ctx) {
1220
1441
  readGuard: auth.requirePermission('ADMIN'),
1221
1442
  writeGuard: auth.requirePermission('ADMIN'),
1222
1443
  }));
1444
+ // PROP-132 (Ф3в): настройки терминалов — мастер-выключатель, восстановление
1445
+ // из снимков и параметры выполнения (`idleMinutes`/`maxPerProject`/
1446
+ // `maxPerInstance`/`shell`/`auditInput`). Применяются **сразу**
1447
+ // (`setEnabled`/`setAutoRestore`/`setLimits`/`setDefaultShell`/
1448
+ // `setAuditInput` — рестарт не нужен).
1449
+ // Managed RBAC: чтение и мутации — только ADMIN.
1450
+ app.route('/api/v2/settings', createTerminalSettingsRoutes({ requireAuth: auth.requireAuth }, {
1451
+ settingsStore,
1452
+ ...(config.synth.terminal ? { config: config.synth.terminal } : {}),
1453
+ terminalService: deps.terminalService,
1454
+ env: process.env,
1455
+ }, {
1456
+ readGuard: auth.requirePermission('ADMIN'),
1457
+ writeGuard: auth.requirePermission('ADMIN'),
1458
+ }));
1223
1459
  // Журналы безопасности (аудит политик + egress) и голый аудит LLM Gateway
1224
1460
  // смонтированы **одной** core-фабрикой выше (префикс `/api/v2/audit`).
1225
1461
  // ADR-102 (волна 1): отчёты аналитики — только чтение, данных без локализации.
@@ -1,5 +1,6 @@
1
1
  import { getServiceCredential } from '@itphx/synth-core';
2
2
  import { MESSAGE_MODEL_QUERY_PARAM, MESSAGE_MODEL_UNSUPPORTED_REASON, isSupportedMessageModelParam, parseSinceParam, } from '@itphx/synth-core';
3
+ import { groupsOf } from '../lib/project-principal.js';
3
4
  /**
4
5
  * Зарегистрировать SSE-хаб (`GET /api/v2/events`): подписка на события сессий
5
6
  * пользователя (watch-all — для service-key и ADMIN/LEAD, ADR-052 этап IV).
@@ -62,6 +63,7 @@ export function registerEventsSse(app, deps) {
62
63
  userId: user.id,
63
64
  username: user.username,
64
65
  allSessions,
66
+ ...(groupsOf(user) ? { groups: groupsOf(user) } : {}),
65
67
  send(event) {
66
68
  if (replaying) {
67
69
  pending.push(event);
package/dist/app.d.ts CHANGED
@@ -57,6 +57,11 @@ export interface BackendAppHandle {
57
57
  scheduler: SchedulerService;
58
58
  /** ADR-051 (срез): остановка планировщика (на graceful shutdown). */
59
59
  stopScheduler: () => void;
60
+ /**
61
+ * PROP-141 (Часть B): остановка движка таймеров/будильников (на graceful
62
+ * shutdown — рядом с `stopScheduler`).
63
+ */
64
+ stopTimerService: () => void;
60
65
  /** ADR-089: остановка sweeper'а авто-архивации ephemeral-сессий. */
61
66
  stopEphemeralSweeper: () => void;
62
67
  /** ADR-089: остановка периодической retention-очистки журнала событий. */
@@ -81,6 +86,8 @@ export interface BackendAppHandle {
81
86
  stopAttachmentPruner: () => void;
82
87
  /** ADR-115 × ADR-077: остановка уборки временных каталогов медиа-раннера. */
83
88
  stopMediaTempPruner: () => void;
89
+ /** PROP-132 (Ф3в): остановка сервиса терминалов (закрытие живых PTY). */
90
+ stopTerminalService: () => void;
84
91
  /** ADR-052 (этап II): реестр подписок webhooks (для тестов/диагностики). */
85
92
  webhookStore: WebhookRepository;
86
93
  /** ADR-052 (этап II): движок исходящих webhooks. */