@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.
- package/dist/app/deps.d.ts +15 -2
- package/dist/app/deps.js +620 -57
- package/dist/app/listen.js +30 -35
- package/dist/app/mount-routes.js +258 -22
- package/dist/app/sse-events.js +2 -0
- package/dist/app.d.ts +7 -0
- package/dist/app.js +14 -11
- package/dist/auth/middleware.js +4 -12
- package/dist/auth/oidc.d.ts +46 -4
- package/dist/auth/oidc.js +55 -8
- package/dist/events/hub.d.ts +36 -2
- package/dist/events/hub.js +62 -3
- package/dist/events/visible-session-ids.d.ts +35 -0
- package/dist/events/visible-session-ids.js +29 -0
- package/dist/lib/app-config.js +35 -5
- package/dist/lib/i18n.js +14 -0
- package/dist/lib/principal-identity.d.ts +35 -0
- package/dist/lib/principal-identity.js +43 -0
- package/dist/lib/project-principal.d.ts +27 -0
- package/dist/lib/project-principal.js +27 -0
- package/dist/lib/recalc-can-summarize.js +8 -5
- package/dist/main.js +5 -1
- package/dist/routes/agents.d.ts +3 -3
- package/dist/routes/agents.js +6 -2
- package/dist/routes/auth.js +33 -0
- package/dist/routes/project-access.d.ts +61 -0
- package/dist/routes/project-access.js +62 -0
- package/dist/routes/projects.d.ts +41 -4
- package/dist/routes/projects.js +117 -15
- package/dist/routes/queue.d.ts +7 -1
- package/dist/routes/queue.js +7 -1
- package/dist/routes/schedules.d.ts +46 -0
- package/dist/routes/schedules.js +10 -0
- package/dist/routes/sessions.d.ts +53 -1
- package/dist/routes/sessions.js +92 -26
- package/dist/routes/users.d.ts +14 -1
- package/dist/routes/users.js +91 -1
- package/package.json +5 -5
package/dist/app/listen.js
CHANGED
|
@@ -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
|
-
|
|
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
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
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
|
-
|
|
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 } : {}),
|
package/dist/app/mount-routes.js
CHANGED
|
@@ -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 {
|
|
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,
|
|
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,
|
|
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
|
-
|
|
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-
|
|
341
|
+
// ADR-126/ADR-089: ролевой промпт агента (`role_prompt` в теле POST)
|
|
277
342
|
// пишется портом файлов контекста — `{dataDir}/context/roles/<contextFile>`.
|
|
278
|
-
|
|
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
|
-
|
|
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 расписаний, принудительный
|
|
379
|
-
//
|
|
380
|
-
//
|
|
381
|
-
//
|
|
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.
|
|
384
|
-
runGuard: auth.
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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): отчёты аналитики — только чтение, данных без локализации.
|
package/dist/app/sse-events.js
CHANGED
|
@@ -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. */
|