@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/deps.js
CHANGED
|
@@ -1,13 +1,19 @@
|
|
|
1
1
|
// Сборка зависимостей backend: хранилища, менеджеры, оркестратор, событийное
|
|
2
2
|
// ядро (ADR-089), планировщик (ADR-051), webhooks (ADR-052), скиллы/команды
|
|
3
|
-
// (ADR-
|
|
3
|
+
// (ADR-126), runtime-настройки (ADR-005/023).
|
|
4
4
|
// Вынесено из `app.ts` (ADR-095, шаг 4b) — «вынос по швам», без изменения поведения.
|
|
5
5
|
import { mkdir } from 'node:fs/promises';
|
|
6
6
|
import { existsSync } from 'node:fs';
|
|
7
7
|
import { join } from 'node:path';
|
|
8
8
|
import { ensureDataDir, mergeModelCompatibility, parsePrincipalId, resolveDefaultWorkspace, resolveSecretKey, resolveStorageBackend, resolvePostgresConfig, resolvePostgresPassword, resolveDegradedMode, resolveStorageFallbackDir, resolveExecutionConfig, readTlsRuntimeSettings, SYNTH_VERSION, generateId, makeTextPart, nowISO, MessageRole, } from '@itphx/synth-shared';
|
|
9
|
+
// ADR-135: применение runtime-каталога профилей исполнения (runtime > config;
|
|
10
|
+
// env/CLI выше — их разрешает `resolveExecutionConfig`, ADR-023).
|
|
11
|
+
import { applyExecutionRuntimeSettings, resolvePromptInjection } from '@itphx/synth-shared/config';
|
|
9
12
|
import { DEFAULT_TOOL_OUTPUT_MAX_BYTES, DEFAULT_TOOL_OUTPUT_MAX_LINES } from '@itphx/synth-shared/config';
|
|
10
|
-
import { SessionManager, EventBus, QueueProcessorManager, ContextBuilder, ContextOptimizer, ChatOrchestrator, enqueueUserMessage, requeueMessages, createToolRegistry, createAgentRegistry, McpManager,
|
|
13
|
+
import { SessionManager, EventBus, QueueProcessorManager, ContextBuilder, ContextOptimizer, ChatOrchestrator, enqueueUserMessage, requeueMessages, createToolRegistry, createAgentRegistry, McpManager, hiddenMcpServersForExecution,
|
|
14
|
+
// ADR-077: fail-closed проверка режима исполнения при старте (единственное
|
|
15
|
+
// место в backend — `app.ts` секцию не разрешает повторно).
|
|
16
|
+
checkExecutionMode, DEFAULT_AGENT_ID, registerStoredAgents, migrateLegacyStoredAgents, AuditLogger, mergeLlmGatewayConfig, mergeSecurityConfig, mergeEventsConfig, mergeDecisionConfig, mergePluginsConfig,
|
|
11
17
|
// ADR-115: живое состояние runtime-настроек вложений (`/settings/attachments`).
|
|
12
18
|
createLiveAttachmentsSettings,
|
|
13
19
|
// Политика контекстного окна (`/settings/context-window`).
|
|
@@ -21,17 +27,32 @@ createLiveContextDefaults,
|
|
|
21
27
|
// Instance-wide лимиты заметок сессии (`/settings/sticky-notes`).
|
|
22
28
|
createLiveStickyNotesLimits,
|
|
23
29
|
// PROP-124: режим инстанса для SSH-ключей (`/settings/ssh`).
|
|
24
|
-
createLiveSshMode,
|
|
30
|
+
createLiveSshMode,
|
|
31
|
+
// Этап 1 roadmap 0.13 (блок 4): секция `background` (`/settings/background`).
|
|
32
|
+
createLiveBackgroundSettings,
|
|
33
|
+
// ADR-135: чтение runtime-каталога профилей исполнения (`/settings/execution`).
|
|
34
|
+
readExecutionRuntimeSettings, createEgressPolicyResolver, createEgressLogSink, configureEgressRuntime, startEgressLogPruner,
|
|
25
35
|
// ADR-105 (Ф3): источник access-токена для MCP-коннекторов + OAuth-сервис.
|
|
26
|
-
OAuthCredentialService, OAuthProviderRegistry, registerOAuthProvidersFromConfig, createRepositoryCredentialSource, SkillService, resolveProjectSkillSeed, CommandService, detectRuntimeDeps, syncProvidersFromEnv,
|
|
36
|
+
OAuthCredentialService, OAuthProviderRegistry, registerOAuthProvidersFromConfig, createRepositoryCredentialSource, SkillService, resolveProjectSkillSeed, CommandService, SnippetService, detectRuntimeDeps, syncProvidersFromEnv,
|
|
27
37
|
// ADR-115 × ADR-101: доступность `ffmpeg` — обработчик вложения aux-моделью шага.
|
|
28
|
-
isFfmpegAvailable, HookBus, startEphemeralSweeper, assertInstanceDataNotTooNew,
|
|
38
|
+
isFfmpegAvailable, HookBus, startEphemeralSweeper, assertInstanceDataNotTooNew,
|
|
39
|
+
// PROP-137 Ф1: fail-closed проверка записи в каталог данных — до сборки
|
|
40
|
+
// хранилища (общая реализация в core, ADR-096: хранилище — только порты).
|
|
41
|
+
assertDataDirWritable, applyStartupMigrations, applyPendingRestore, EventRouter, RequestSessionService, EventIngress, eventToMessage, addEventAttachmentRefs, AttachmentService, ProjectRuleProvider, DecisionRuleProvider, PipelineTracker, SchedulerRuleProvider, SchedulerService, AlwaysLeader, FileLeader, SharedLeader,
|
|
42
|
+
// PROP-141 (Часть B): движок таймеров/будильников + правило маршрутизации.
|
|
43
|
+
TimerService, TimerRuleProvider, TIMER_EVENT_SOURCE, TIMER_EVENT_TYPE,
|
|
44
|
+
// PROP-141 (Часть D): сервис переноса сессии между проектами.
|
|
45
|
+
SessionMoveService, createExternalIdentityResolver, startEventJournalPruner,
|
|
29
46
|
// Этап 1 roadmap 0.13 (блок 3): сервис вопросов пользователю + retention.
|
|
30
47
|
QuestionService, startQuestionPruner,
|
|
31
48
|
// Этап 1 roadmap 0.13 (блок 4): реестр фоновых прогонов + retention.
|
|
32
49
|
BackgroundRunService, startBackgroundRunPruner, createBackgroundParentNotifier,
|
|
50
|
+
// PROP-143: durable-запись о прогоне, потерянном при рестарте.
|
|
51
|
+
appendLostRunRecords,
|
|
33
52
|
// PROP-097 (блок 5b): сервис фоновых шелл-процессов + retention логов.
|
|
34
53
|
ProcessService, startProcessLogPruner,
|
|
54
|
+
// ADR-126 §5: сервис реестра скриптов проекта (`!`-запуск).
|
|
55
|
+
ScriptService,
|
|
35
56
|
// ADR-115: GC осиротевших вложений сообщений.
|
|
36
57
|
startAttachmentPruner,
|
|
37
58
|
// ADR-115 × ADR-077: медиа-раннер (ffmpeg inline/remote) и серверные миниатюры.
|
|
@@ -49,12 +70,21 @@ startMemoryMetrics,
|
|
|
49
70
|
createMemoryTelemetry, registerDecisionMetrics, createSchedulerMetrics,
|
|
50
71
|
// ADR-094/ADR-077: метрики пула исполнителей (`synth_executor_*`).
|
|
51
72
|
createExecutorMetricsCollector, createWebhookMetrics, createEventMetrics,
|
|
73
|
+
// PROP-141 (Часть B): метрики таймеров (`synth_timer_*`, ADR-094).
|
|
74
|
+
createTimerMetrics,
|
|
52
75
|
// ADR-094/ADR-115: метрики вложений (`synth_attachment_*`) + установка их
|
|
53
76
|
// sink'а (сервис вложений собирается внутри фабрики роутов сессий).
|
|
54
77
|
createAttachmentMetrics, setAttachmentMetricsHook,
|
|
55
78
|
// ADR-106 Ф1/Ф2: счётчик решений Authority-слоя (`synth_authority_decisions_total`)
|
|
56
79
|
// и guard-слоя (решение считается; в enforced-режиме — применяется).
|
|
57
|
-
createAuthorityMetrics,
|
|
80
|
+
createAuthorityMetrics,
|
|
81
|
+
// PROP-136 (слайс 136a): журнал исполнений команд + его метрики.
|
|
82
|
+
createCommandAuditLog, createCommandAuditMetrics,
|
|
83
|
+
// ADR-136/ADR-126 §5: парная запись `finished` по терминальному переходу
|
|
84
|
+
// фонового скрипта.
|
|
85
|
+
createScriptRunAuditFinisher,
|
|
86
|
+
// PROP-136b (слайс 136b-2a): зеркальный чекер команд (провайдер + метрики).
|
|
87
|
+
createCommandPolicyMetrics, createCommandPolicyProvider, AuthorityGuard,
|
|
58
88
|
// ADR-106 Ф3: реестр подтверждений + покрытие (носитель покрывающего гранта).
|
|
59
89
|
ApprovalRegistry, buildApprovalResponderProfile, createApprovalCoverageResolver, startEventJournalMetrics,
|
|
60
90
|
// ADR-101 (Э5): движок пайплайнов, исполнители шагов, обработчики выходов.
|
|
@@ -66,11 +96,28 @@ PipelineRunControl, createToolStepExecutor, createScriptStepExecutor, createHuma
|
|
|
66
96
|
createPipelineAttachmentDerive, ensureBuiltinPipelines,
|
|
67
97
|
// ADR-101 §4 × `AgentDefinition`: провайдер агентского шага (код общий с core).
|
|
68
98
|
resolvePipelineStepProvider, toCoreProviderConfig, ProviderFactory,
|
|
69
|
-
//
|
|
70
|
-
|
|
99
|
+
// PROP-135 Ф4b-1: instance-порт (при `provider: http` — ленивый, на пул).
|
|
100
|
+
createInstanceExecutionPort,
|
|
101
|
+
// PROP-135 Ф4a: роутер портов исполнения (пулы/профили).
|
|
102
|
+
createExecutionRouter,
|
|
103
|
+
// PROP-135 слайс 5b-2: резолвер проектного (браузерного) пула для вызовов
|
|
104
|
+
// MCP-инструментов исполнителя.
|
|
105
|
+
createExecutorMcpPoolResolver,
|
|
106
|
+
// PROP-132 (Ф3в): сервис терминалов инстанса + настройки секции `terminal`
|
|
107
|
+
// (env > runtime > config > default, по каждому полю).
|
|
108
|
+
createTerminalService, resolveTerminalSettings,
|
|
109
|
+
// PROP-135: порт терминала — тем же роутером, что и порт тулов.
|
|
110
|
+
createTerminalPortResolver,
|
|
111
|
+
// PROP-132 (Ф5): сообщение-уведомление о завершении запуска команды в
|
|
112
|
+
// терминале (точка сборки — тот же нотификатор, что у фоновых процессов).
|
|
113
|
+
buildTerminalRunNotification,
|
|
71
114
|
// ADR-090 (Ф3а) / §5, §10 (Ф5б-1): общий реестр
|
|
72
115
|
// блоков промпта (композер + фасад плагинов) и рантайм плагинов.
|
|
73
|
-
PromptBlockRegistry, PluginRuntime, PluginProcessManager, PluginFacadeError, createInlinePluginLoader, createRemotePluginLoader, resolvePluginLayout, serializeMessage,
|
|
116
|
+
PromptBlockRegistry, PluginRuntime, PluginProcessManager, PluginFacadeError, createInlinePluginLoader, createRemotePluginLoader, resolvePluginLayout, serializeMessage,
|
|
117
|
+
// PROP-142 §3: бюджет автовосстановления + планировщик boot-восстановления.
|
|
118
|
+
recordRecoveryAttempt, planBootRecovery, resolveRecoveryBudget,
|
|
119
|
+
// PROP-143: durable-запись причины остановки хода (след отказа по бюджету).
|
|
120
|
+
appendStopRecord, } from '@itphx/synth-core';
|
|
74
121
|
import { EventHub } from '../events/hub.js';
|
|
75
122
|
import { seedDebugTestUsers } from './bootstrap.js';
|
|
76
123
|
/**
|
|
@@ -96,6 +143,14 @@ export async function createBackendStorage(config) {
|
|
|
96
143
|
if (kind === 'memory') {
|
|
97
144
|
console.warn('storage.backend=memory: данные не сохраняются на диск');
|
|
98
145
|
}
|
|
146
|
+
// PROP-137 Ф1: fail-closed проверка записи в каталог данных — **до** сборки
|
|
147
|
+
// хранилища. Каталог нужен и при 'file' (все JSON-данные), и при
|
|
148
|
+
// 'postgres' (секреты, мастер-ключ и blob-хранилище — ADR-116/ADR-097).
|
|
149
|
+
// Без проверки EACCES всплывает позже и неясно (сессии/секреты/блобы),
|
|
150
|
+
// а UI при этом отвечает 200 — «сайт открыт, данные не сохраняются».
|
|
151
|
+
if (kind !== 'memory') {
|
|
152
|
+
await assertDataDirWritable(config.dataDir);
|
|
153
|
+
}
|
|
99
154
|
const storage = await createStorageContextAsync(kind, {
|
|
100
155
|
dataDir: config.dataDir,
|
|
101
156
|
secretKey: resolveSecretKey(config.synth),
|
|
@@ -190,17 +245,37 @@ executionConfig) {
|
|
|
190
245
|
config: config.synth.ssh?.mode,
|
|
191
246
|
runtime: await settingsStore.getSshMode(),
|
|
192
247
|
});
|
|
248
|
+
// Этап 1 roadmap 0.13 (блок 4): секция `background` (реестр фоновых
|
|
249
|
+
// прогонов) — приоритет env > runtime > config.yaml > default. Один
|
|
250
|
+
// экземпляр на процесс: сервисы/прунеры/оркестратор читают его на каждый
|
|
251
|
+
// запуск/тик, поэтому runtime-настройка применяется без рестарта.
|
|
252
|
+
const backgroundSettings = createLiveBackgroundSettings({
|
|
253
|
+
store: settingsStore,
|
|
254
|
+
config: config.synth.background,
|
|
255
|
+
});
|
|
256
|
+
await backgroundSettings.refresh();
|
|
193
257
|
// ADR-102: сборщик роллапов аналитики (write-path) — только через порт слоя
|
|
194
258
|
// хранения; в деградации выключен (не пишем домен в файловый фоллбек).
|
|
195
259
|
const analytics = storageDegraded ? undefined : new AnalyticsRecorder({ repo: analyticsRollups });
|
|
260
|
+
// PROP-141 (Часть B): каскад удаления сессии — снятие её таймеров/будильников.
|
|
261
|
+
// Сервис таймеров собирается ниже (после ingress'а), поэтому ссылка
|
|
262
|
+
// late-bound: шов один — `SessionManager.deleteSession` (инвариант 16).
|
|
263
|
+
const timerServiceRef = {};
|
|
264
|
+
// PROP-141 (Часть D): сервис переноса сессии — late-bound (собирается после
|
|
265
|
+
// движка таймеров, а оркестратор/extra тулов читают его на лету).
|
|
266
|
+
const moveServiceRef = {};
|
|
196
267
|
const sessionManager = new SessionManager(fileStore, {
|
|
197
268
|
projectStore,
|
|
198
269
|
hooks,
|
|
270
|
+
// PROP-141: удаление сессии снимает её автоматизации (таймеры/будильники).
|
|
271
|
+
onSessionDeleted: async (sessionId) => {
|
|
272
|
+
await timerServiceRef.service?.onSessionDeleted(sessionId);
|
|
273
|
+
},
|
|
199
274
|
// Дефолты оптимизации контекста новых сессий (`context.defaults` + runtime).
|
|
200
275
|
contextDefaults: () => contextDefaultsSettings.getDefaults(),
|
|
201
276
|
// ADR-102: точка персиста сообщений (`messages_assistant`/`messages_tool`).
|
|
202
277
|
analytics,
|
|
203
|
-
// ADR-071 §2.4 / ADR-
|
|
278
|
+
// ADR-071 §2.4 / ADR-126 §11: системные дефолты для сессий без проекта.
|
|
204
279
|
systemDefaultsProvider: async () => ({
|
|
205
280
|
mcpDefaultOn: await mcpRegistryStore.toDefaultServers(),
|
|
206
281
|
skillsDefaultOn: (await resolveProjectSkillSeed(skillService, await settingsStore.getSkillsDisabledForNewProjects())).enabled,
|
|
@@ -235,7 +310,12 @@ executionConfig) {
|
|
|
235
310
|
// MCP: единый источник истины — реестр `McpRegistryStore` (ADR-071 §2.5).
|
|
236
311
|
// Legacy `YamlMcpConfigStore` удалён: instance-серверы из config.mcp.servers
|
|
237
312
|
// сидируются в реестр при старте (seed без дублирования по имени).
|
|
238
|
-
const mcpManager = new McpManager(
|
|
313
|
+
const mcpManager = new McpManager({
|
|
314
|
+
// Advisory-детекция prompt injection в описаниях/`instructions` MCP
|
|
315
|
+
// (ru+en словарь `injection`) — только пометка в промпте, без блокировки.
|
|
316
|
+
dictionaryStore,
|
|
317
|
+
...(metrics ? { metrics } : {}),
|
|
318
|
+
});
|
|
239
319
|
await mcpRegistryStore.seedFromConfig(config.synth.mcp.servers);
|
|
240
320
|
// Одно чтение реестра на все карты менеджера (вместо пяти).
|
|
241
321
|
const mcpMaps = await mcpRegistryStore.toManagerMaps();
|
|
@@ -430,12 +510,15 @@ executionConfig) {
|
|
|
430
510
|
: new BackgroundRunService({
|
|
431
511
|
repository: storageContext.backgroundRuns,
|
|
432
512
|
eventBus,
|
|
513
|
+
// Снимок — fallback; живой резолвер читается на каждый запуск
|
|
514
|
+
// (runtime-настройка применяется без рестарта).
|
|
433
515
|
limits: {
|
|
434
516
|
maxSubagentsPerSession: config.synth.background.maxSubagentsPerSession,
|
|
435
517
|
// PROP-097: лимит одновременных фоновых шелл-процессов на сессию.
|
|
436
518
|
maxProcessesPerSession: config.synth.background.maxProcessesPerSession,
|
|
437
519
|
maxRunsPerSession: config.synth.background.maxRunsPerSession,
|
|
438
520
|
},
|
|
521
|
+
getLimits: () => backgroundSettings.getLimits(),
|
|
439
522
|
// Точка сборки уведомления — здесь (глобальных синглтонов нет).
|
|
440
523
|
//
|
|
441
524
|
// ADR-036: обфускация user-сообщений НЕ применяется — уведомление
|
|
@@ -453,12 +536,30 @@ executionConfig) {
|
|
|
453
536
|
// Старт: прогоны прошлого процесса не пережили рестарт (хэндлы отмены — в
|
|
454
537
|
// памяти) — помечаем их `orphaned`. Best-effort: ошибка не роняет старт.
|
|
455
538
|
if (backgroundService) {
|
|
539
|
+
let recovered = [];
|
|
456
540
|
try {
|
|
457
|
-
await backgroundService.recoverOnStart();
|
|
541
|
+
recovered = await backgroundService.recoverOnStart();
|
|
458
542
|
}
|
|
459
543
|
catch (err) {
|
|
460
544
|
console.warn(`[background] восстановление фоновых прогонов не удалось: ${err instanceof Error ? err.message : String(err)}`);
|
|
461
545
|
}
|
|
546
|
+
// PROP-143 §4 п.3: факт прерывания возвращается в историю сессии-владельца
|
|
547
|
+
// (durable-запись `execution_stopped`) — иначе о потере прогона знает только
|
|
548
|
+
// реестр, а не человек/родитель. Ход не запускается — только дозапись.
|
|
549
|
+
if (recovered.length) {
|
|
550
|
+
try {
|
|
551
|
+
const written = await appendLostRunRecords({
|
|
552
|
+
sessionManager,
|
|
553
|
+
eventBus,
|
|
554
|
+
records: recovered,
|
|
555
|
+
logger: { warn: (message) => console.warn(message) },
|
|
556
|
+
});
|
|
557
|
+
console.log(`[background] фоновые прогоны прерваны рестартом: осиротело ${recovered.length}, записей в историю добавлено ${written}`);
|
|
558
|
+
}
|
|
559
|
+
catch (err) {
|
|
560
|
+
console.warn(`[background] записи о прерванных прогонах не добавлены: ${err instanceof Error ? err.message : String(err)}`);
|
|
561
|
+
}
|
|
562
|
+
}
|
|
462
563
|
}
|
|
463
564
|
/**
|
|
464
565
|
* Info-блок «ход продолжен после рестарта»: пишется в историю (роль INFO — в
|
|
@@ -506,6 +607,30 @@ executionConfig) {
|
|
|
506
607
|
// показывает активность. Восстановление отложено на 60 с, чтобы старый под
|
|
507
608
|
// успел умереть, а живые маркеры работающего процесса не были сняты.
|
|
508
609
|
// В деградации хранилище read-only — ничего не пишем и не запускаем.
|
|
610
|
+
//
|
|
611
|
+
// PROP-142 §3: автовосстановление — **под бюджетом** (попытки на ход +
|
|
612
|
+
// детект crash-loop). Секция `recovery` конфига (`shared/config/types.ts`).
|
|
613
|
+
const recoveryBudget = resolveRecoveryBudget(config.synth);
|
|
614
|
+
/**
|
|
615
|
+
* Отказ по бюджету автовосстановления: след в истории (PROP-143) —
|
|
616
|
+
* durable-запись `execution_stopped` с причиной `orphaned`. Запись
|
|
617
|
+
* идемпотентна по `dedupeKey` (ход/сессия), ошибка записи не ломает boot.
|
|
618
|
+
*/
|
|
619
|
+
const recordRecoveryDenied = async (sessionId, reason, dedupeKey) => {
|
|
620
|
+
try {
|
|
621
|
+
await appendStopRecord({
|
|
622
|
+
sessionManager,
|
|
623
|
+
eventBus,
|
|
624
|
+
sessionId,
|
|
625
|
+
input: { reason: 'orphaned', error: `recovery budget exhausted (${reason})` },
|
|
626
|
+
dedupeKey,
|
|
627
|
+
});
|
|
628
|
+
}
|
|
629
|
+
catch (err) {
|
|
630
|
+
console.warn(`[sessions] запись об отказе восстановления не добавлена: ${err instanceof Error ? err.message : String(err)}`);
|
|
631
|
+
}
|
|
632
|
+
console.warn(`[sessions] восстановление ${sessionId} запрещено бюджетом (${reason})`);
|
|
633
|
+
};
|
|
509
634
|
if (!storageDegraded) {
|
|
510
635
|
const bootRecovery = setTimeout(() => {
|
|
511
636
|
void sessionManager.recoverInterruptedSessions()
|
|
@@ -518,14 +643,56 @@ executionConfig) {
|
|
|
518
643
|
status: 'stopped',
|
|
519
644
|
});
|
|
520
645
|
eventBus.publish(r.sessionId, 'session.updated', { session_id: r.sessionId });
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
|
|
527
|
-
|
|
528
|
-
|
|
646
|
+
// PROP-142 §3: план восстановления — вид сессии (основная/дочерняя)
|
|
647
|
+
// и бюджет попыток/crash-loop. Одна сессия не должна ломать boot.
|
|
648
|
+
try {
|
|
649
|
+
const session = await sessionManager.getSession(r.sessionId);
|
|
650
|
+
const plan = planBootRecovery({
|
|
651
|
+
sessions: [
|
|
652
|
+
{
|
|
653
|
+
id: r.sessionId,
|
|
654
|
+
...(session?.parentId ? { parentId: session.parentId } : {}),
|
|
655
|
+
...(session?.sessionOrigin ? { sessionOrigin: session.sessionOrigin } : {}),
|
|
656
|
+
...(session?.status.recovery ? { recovery: session.status.recovery } : {}),
|
|
657
|
+
},
|
|
658
|
+
],
|
|
659
|
+
config: recoveryBudget,
|
|
660
|
+
})[0];
|
|
661
|
+
if (!plan)
|
|
662
|
+
continue;
|
|
663
|
+
if (plan.action === 'deny') {
|
|
664
|
+
// Бюджет исчерпан: ход терминализируется, след — в истории.
|
|
665
|
+
await recordRecoveryDenied(r.sessionId, plan.reason, `recovery:${r.turnId ?? r.sessionId}`);
|
|
666
|
+
continue;
|
|
667
|
+
}
|
|
668
|
+
if (plan.action === 'resume-child') {
|
|
669
|
+
// Дочерняя сессия (саб-агент): её цикл ведёт родитель — процессор
|
|
670
|
+
// очереди не создаём (у ребёнка нет своей очереди), возобновляем
|
|
671
|
+
// через цикл саб-агента (PROP-142 §3).
|
|
672
|
+
await recordRecoveryAttempt(sessionManager, r.sessionId);
|
|
673
|
+
try {
|
|
674
|
+
await orchestrator.startSubagentResume(r.sessionId);
|
|
675
|
+
await addRestartResumedNotice(r.sessionId, r.streamId);
|
|
676
|
+
}
|
|
677
|
+
catch (err) {
|
|
678
|
+
console.warn(`[sessions] возобновление дочерней сессии не выполнено: ${err instanceof Error ? err.message : String(err)}`);
|
|
679
|
+
}
|
|
680
|
+
continue;
|
|
681
|
+
}
|
|
682
|
+
// Основная сессия — прежнее поведение автопродолжения.
|
|
683
|
+
if (!r.resumeMessage)
|
|
684
|
+
continue;
|
|
685
|
+
await recordRecoveryAttempt(sessionManager, r.sessionId);
|
|
686
|
+
// Автопродолжение: info-блок в истории (в LLM-контекст не попадает —
|
|
687
|
+
// роль INFO исключена из промпта) и resume-сообщение процессору.
|
|
688
|
+
await addRestartResumedNotice(r.sessionId, r.streamId);
|
|
689
|
+
queueManager.createProcessor(r.sessionId, sessionManager, eventBus, processMessage, {
|
|
690
|
+
resumeMessage: r.resumeMessage,
|
|
691
|
+
});
|
|
692
|
+
}
|
|
693
|
+
catch (err) {
|
|
694
|
+
console.warn(`[sessions] восстановление сессии не выполнено: ${err instanceof Error ? err.message : String(err)}`);
|
|
695
|
+
}
|
|
529
696
|
}
|
|
530
697
|
if (recovered.length) {
|
|
531
698
|
console.log(`[sessions] сняты маркеры прерванных ходов: ${recovered.length}`);
|
|
@@ -551,26 +718,51 @@ executionConfig) {
|
|
|
551
718
|
if (s.pendingMessages.length === 0)
|
|
552
719
|
continue;
|
|
553
720
|
queueCandidates += 1;
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
721
|
+
try {
|
|
722
|
+
// PROP-142 §3: бюджет автовосстановления — до любых действий
|
|
723
|
+
// (в т.ч. `queue.stalled`): при отказе очередь не трогаем, след
|
|
724
|
+
// в истории оставляем.
|
|
725
|
+
const plan = planBootRecovery({
|
|
726
|
+
sessions: [
|
|
727
|
+
{
|
|
728
|
+
id: s.id,
|
|
729
|
+
...(s.parentId ? { parentId: s.parentId } : {}),
|
|
730
|
+
...(s.sessionOrigin ? { sessionOrigin: s.sessionOrigin } : {}),
|
|
731
|
+
...(s.status.recovery ? { recovery: s.status.recovery } : {}),
|
|
732
|
+
},
|
|
733
|
+
],
|
|
734
|
+
config: recoveryBudget,
|
|
735
|
+
})[0];
|
|
736
|
+
if (plan?.action === 'deny') {
|
|
737
|
+
await recordRecoveryDenied(s.id, plan.reason, `recovery:queue:${s.id}`);
|
|
738
|
+
continue;
|
|
739
|
+
}
|
|
740
|
+
if (s.status.queueStopped) {
|
|
741
|
+
eventBus.publish(s.id, 'queue.stalled', {
|
|
742
|
+
pending_count: s.pendingMessages.length,
|
|
743
|
+
});
|
|
744
|
+
continue;
|
|
745
|
+
}
|
|
746
|
+
// Маркеры мог снять прошлый recovery, а сообщение осталось и в
|
|
747
|
+
// истории, и в очереди. Это прерванный in-flight ход: продолжаем
|
|
748
|
+
// его как resume (info-блок + метка `resumed`), а не как новую
|
|
749
|
+
// очередь — иначе сообщение материализуется в историю повторно.
|
|
750
|
+
const resume = await sessionManager.takePendingInFlight(s.id);
|
|
751
|
+
if (resume) {
|
|
752
|
+
inFlightResumed += 1;
|
|
753
|
+
await recordRecoveryAttempt(sessionManager, s.id);
|
|
754
|
+
await addRestartResumedNotice(s.id, resume.metadata?.stream_id);
|
|
755
|
+
queueManager.createProcessor(s.id, sessionManager, eventBus, processMessage, {
|
|
756
|
+
resumeMessage: resume,
|
|
757
|
+
});
|
|
758
|
+
continue;
|
|
759
|
+
}
|
|
760
|
+
await recordRecoveryAttempt(sessionManager, s.id);
|
|
761
|
+
queueManager.createProcessor(s.id, sessionManager, eventBus, processMessage);
|
|
559
762
|
}
|
|
560
|
-
|
|
561
|
-
|
|
562
|
-
// его как resume (info-блок + метка `resumed`), а не как новую
|
|
563
|
-
// очередь — иначе сообщение материализуется в историю повторно.
|
|
564
|
-
const resume = await sessionManager.takePendingInFlight(s.id);
|
|
565
|
-
if (resume) {
|
|
566
|
-
inFlightResumed += 1;
|
|
567
|
-
await addRestartResumedNotice(s.id, resume.metadata?.stream_id);
|
|
568
|
-
queueManager.createProcessor(s.id, sessionManager, eventBus, processMessage, {
|
|
569
|
-
resumeMessage: resume,
|
|
570
|
-
});
|
|
571
|
-
continue;
|
|
763
|
+
catch (err) {
|
|
764
|
+
console.warn(`[sessions] автозапуск очереди не выполнен: ${err instanceof Error ? err.message : String(err)}`);
|
|
572
765
|
}
|
|
573
|
-
queueManager.createProcessor(s.id, sessionManager, eventBus, processMessage);
|
|
574
766
|
}
|
|
575
767
|
if (queueCandidates > 0) {
|
|
576
768
|
// Только счётчики: ни id, ни содержимого сессий/сообщений.
|
|
@@ -591,14 +783,16 @@ executionConfig) {
|
|
|
591
783
|
const stopBackgroundRunPruner = storageDegraded
|
|
592
784
|
? () => { }
|
|
593
785
|
: startBackgroundRunPruner(storageContext.backgroundRuns, {
|
|
594
|
-
|
|
786
|
+
// Живой резолвер: retention-настройка применяется на каждом тике.
|
|
787
|
+
getRetentionDays: () => backgroundSettings.getRetentionDays(),
|
|
595
788
|
});
|
|
596
789
|
// PROP-097 (блок 5b): retention логов фоновых процессов. Создаётся **до**
|
|
597
790
|
// pruner'а записей реестра: лог удаляется, пока его запись ещё видна.
|
|
598
791
|
const stopProcessLogPruner = storageDegraded
|
|
599
792
|
? () => { }
|
|
600
793
|
: startProcessLogPruner(storageContext.backgroundRuns, storageContext.blobs, {
|
|
601
|
-
|
|
794
|
+
// Живой резолвер: retention-настройка применяется на каждом тике.
|
|
795
|
+
getRetentionDays: () => backgroundSettings.getRetentionDays(),
|
|
602
796
|
});
|
|
603
797
|
// ADR-094/ADR-115: метрики вложений (`synth_attachment_*`) — создаются до GC,
|
|
604
798
|
// чтобы счётчик удалённых объектов был доступен при первом прогоне.
|
|
@@ -634,6 +828,15 @@ executionConfig) {
|
|
|
634
828
|
// ADR-106 Ф1: решения Authority-слоя (`synth_authority_decisions_total`) —
|
|
635
829
|
// лейблы только `action`/`effect`/`source`, без id (ADR-094).
|
|
636
830
|
const authorityMetrics = metrics ? createAuthorityMetrics(metrics) : undefined;
|
|
831
|
+
// PROP-136 (слайс 136a): append-only журнал исполнений `execute_shell`/
|
|
832
|
+
// `sandbox_exec`. Managed-профиль включает его по умолчанию
|
|
833
|
+
// (`security.commandAudit.enabled`, `loadBackendConfig`).
|
|
834
|
+
const commandAuditMetrics = metrics ? createCommandAuditMetrics(metrics) : undefined;
|
|
835
|
+
const commandAuditLog = createCommandAuditLog({
|
|
836
|
+
dataDir,
|
|
837
|
+
...(config.synth.security?.commandAudit ? { config: config.synth.security.commandAudit } : {}),
|
|
838
|
+
...(commandAuditMetrics ? { metrics: commandAuditMetrics } : {}),
|
|
839
|
+
});
|
|
637
840
|
if (metrics) {
|
|
638
841
|
// ADR-115: сервис вложений собирается внутри фабрики роутов сессий, куда
|
|
639
842
|
// метрики не прокинуть — ставим хуки в sink коллектора (снимается на stop).
|
|
@@ -783,6 +986,20 @@ executionConfig) {
|
|
|
783
986
|
// приоритетнее config.yaml — мёржим при старте, чтобы защита применялась к оркестратору.
|
|
784
987
|
const runtimeSecurity = await settingsStore.getSecuritySettings();
|
|
785
988
|
const securityConfig = mergeSecurityConfig(config.synth.security, runtimeSecurity);
|
|
989
|
+
if (securityConfig) {
|
|
990
|
+
// ADR-023: env `SYNTH_SECURITY_PROMPT_INJECTION_*` перекрывает runtime и
|
|
991
|
+
// config.yaml (приоритет env > runtime > config > default, по полю).
|
|
992
|
+
securityConfig.promptInjection = resolvePromptInjection(config.synth.security?.promptInjection, runtimeSecurity.promptInjection).config;
|
|
993
|
+
}
|
|
994
|
+
// PROP-136b (слайс 136b-2a): зеркальный чекер команд (`security.commandPolicy`).
|
|
995
|
+
// Managed-профиль поднимает `failMode` до `closed` (`loadBackendConfig`);
|
|
996
|
+
// `enabled: true` без адреса — ошибка старта (fail-closed).
|
|
997
|
+
const commandPolicyMetrics = metrics ? createCommandPolicyMetrics(metrics) : undefined;
|
|
998
|
+
const commandPolicyProvider = securityConfig?.commandPolicy
|
|
999
|
+
? createCommandPolicyProvider(securityConfig.commandPolicy, {
|
|
1000
|
+
...(commandPolicyMetrics ? { metrics: commandPolicyMetrics } : {}),
|
|
1001
|
+
})
|
|
1002
|
+
: null;
|
|
786
1003
|
// ADR-071 §2.3: runtime-политика встроенных инструментов (админка) приоритетнее config.yaml
|
|
787
1004
|
const runtimeToolsPolicy = await settingsStore.getToolsPolicy();
|
|
788
1005
|
const toolsPolicy = runtimeToolsPolicy ?? config.synth.tools.policy;
|
|
@@ -792,10 +1009,10 @@ executionConfig) {
|
|
|
792
1009
|
// ADR-071 §2.6: runtime-отключение инструментов (админка) приоритетнее config.yaml
|
|
793
1010
|
const runtimeToolsDisabled = await settingsStore.getToolsDisabled();
|
|
794
1011
|
const toolsDisabled = runtimeToolsDisabled ?? config.synth.tools.disabled ?? { capabilities: [], tools: [] };
|
|
795
|
-
// ADR-
|
|
1012
|
+
// ADR-126 §11: runtime-отключение скиллов (админка) — hard-gate системного уровня.
|
|
796
1013
|
const skillsDisabled = (await settingsStore.getSkillsDisabled())
|
|
797
1014
|
?? { categories: [], groups: [], skills: [] };
|
|
798
|
-
// ADR-
|
|
1015
|
+
// ADR-126/ADR-069: project-trust гейт скиллов/команд/инструкций. Runtime
|
|
799
1016
|
// (`settings.json`/PG) приоритетнее `config.yaml`; применяется при старте —
|
|
800
1017
|
// `restartRequired` в API, инвариант 24.
|
|
801
1018
|
const effectiveSkillsTrustedProjectDirs = (await settingsStore.getSkillsTrustedProjectDirs())
|
|
@@ -841,7 +1058,7 @@ executionConfig) {
|
|
|
841
1058
|
catch (err) {
|
|
842
1059
|
console.warn(`[agents] не удалось загрузить агентов из стора: ${err instanceof Error ? err.message : String(err)}`);
|
|
843
1060
|
}
|
|
844
|
-
// ADR-
|
|
1061
|
+
// ADR-126: сервис скиллов (discovery + instance-запись + каталог промпта).
|
|
845
1062
|
// ADR-116: instance-скиллы — порт слоя хранения (`storageContext.skills`):
|
|
846
1063
|
// при `storage.backend=postgres` это метаданные в SQL + содержимое в blobs.
|
|
847
1064
|
const skillService = new SkillService({
|
|
@@ -852,7 +1069,13 @@ executionConfig) {
|
|
|
852
1069
|
trustedProjectDirs: effectiveSkillsTrustedProjectDirs,
|
|
853
1070
|
toolsets: config.synth.skills.toolsets,
|
|
854
1071
|
});
|
|
855
|
-
// ADR-
|
|
1072
|
+
// ADR-126 §4: сервис сниппетов (`#`) — три уровня (`instance`/`project`/`user`),
|
|
1073
|
+
// discovery + запись файлов + раскрытие (mirror core).
|
|
1074
|
+
const snippetService = new SnippetService({
|
|
1075
|
+
dataDir,
|
|
1076
|
+
trustedProjectDirs: effectiveSkillsTrustedProjectDirs,
|
|
1077
|
+
});
|
|
1078
|
+
// ADR-126 §1: slash-команды и bundles (mirror core).
|
|
856
1079
|
const commandService = new CommandService({
|
|
857
1080
|
config: {
|
|
858
1081
|
dataDir,
|
|
@@ -873,24 +1096,167 @@ executionConfig) {
|
|
|
873
1096
|
// запуска процесса (инвариант 24), поэтому порт собирается здесь, при старте.
|
|
874
1097
|
// Тот же порт получают оркестратор (тулы, inline-shell, детект зависимостей)
|
|
875
1098
|
// и резолвер проектных инструкций.
|
|
876
|
-
|
|
1099
|
+
//
|
|
1100
|
+
// ADR-135: поверх config-уровня применяется **runtime-каталог профилей
|
|
1101
|
+
// исполнения** (`settings.json`/PG). Приоритет — **env/CLI > runtime >
|
|
1102
|
+
// config.yaml** (env/CLI разрешаются внутри `resolveExecutionConfig`,
|
|
1103
|
+
// ADR-023); каталог `profiles` runtime-секции **заменяет** каталог
|
|
1104
|
+
// config.yaml целиком. Секция `execution` — параметр запуска: порты пулов и
|
|
1105
|
+
// роутер создаются на старте, поэтому изменение требует рестарта
|
|
1106
|
+
// (`restartRequired` в `/api/v2/settings/execution`). Хранилище может быть
|
|
1107
|
+
// недоступно (деградация, ADR-098) — тогда действует config-уровень.
|
|
1108
|
+
const baseExecution = executionConfig ?? resolveExecutionConfig(config.synth, process.env);
|
|
1109
|
+
const runtimeExecution = await readExecutionRuntimeSettings(settingsStore);
|
|
1110
|
+
const execution = applyExecutionRuntimeSettings(baseExecution, runtimeExecution);
|
|
1111
|
+
// ADR-077: fail-closed проверка режима исполнения — **единственное** место
|
|
1112
|
+
// (backend `app.ts` разрешение секции не дублирует): неверный
|
|
1113
|
+
// `mode`/`failMode` — ошибка; `remote` без адресов/пакета исполнителя/
|
|
1114
|
+
// читаемого токена — старт прерывается, а не «молча уходит в inline».
|
|
1115
|
+
// Runtime-каталог профилей проверку не меняет (общий адрес секции и режим
|
|
1116
|
+
// остаются config/env-уровня).
|
|
1117
|
+
const executionCheck = await checkExecutionMode(execution);
|
|
1118
|
+
if (!executionCheck.ok) {
|
|
1119
|
+
throw new Error(executionCheck.message);
|
|
1120
|
+
}
|
|
1121
|
+
// PROP-135 D1/D2: браузерный MCP-сервер исполнителя (дефолт `playwright`)
|
|
1122
|
+
// остаётся подключённым — его вызывает `ExecutionPort.browserCall` напрямую
|
|
1123
|
+
// (`POST /mcp/call`), — но его инструменты не регистрируются: модели нужны
|
|
1124
|
+
// встроенные `browser_*`, а `playwright_*` были дублями в реестре/промпте.
|
|
1125
|
+
// `inline`/пустое имя → скрытых нет (прежнее поведение).
|
|
1126
|
+
mcpManager.setHiddenServers(hiddenMcpServersForExecution(execution));
|
|
877
1127
|
// ADR-094/ADR-077: метрики пула исполнителей (`synth_executor_*`) — приёмник
|
|
878
1128
|
// для клиента удалённого порта (очередь, занятость, ожидание, исход).
|
|
879
1129
|
const executorMetrics = metrics ? createExecutorMetricsCollector(metrics) : undefined;
|
|
880
|
-
|
|
1130
|
+
// PROP-135 Ф4b-1: при `provider: http` адреса исполнителей приходят от
|
|
1131
|
+
// provisioner'а — instance-порт собирается **лениво** (на instance-пул),
|
|
1132
|
+
// статический `execution.remote.url` не требуется.
|
|
1133
|
+
const executionPort = await createInstanceExecutionPort(execution, executorMetrics ? { metricsSink: executorMetrics } : undefined);
|
|
1134
|
+
// PROP-135 Ф4a: роутер портов исполнения (пулы/профили). Порты профилей
|
|
1135
|
+
// создаются **на старте** (инвариант 24: `execution.*` — параметр запуска),
|
|
1136
|
+
// поэтому роутер синхронен: `portFor(profile)` отдаёт порт профиля.
|
|
1137
|
+
// Instance-порт переиспользуется (второй клиент удалённого пула не нужен).
|
|
1138
|
+
const executionRouter = await createExecutionRouter({
|
|
1139
|
+
config: execution,
|
|
1140
|
+
...(executorMetrics ? { metricsSink: executorMetrics } : {}),
|
|
1141
|
+
instancePort: executionPort,
|
|
1142
|
+
});
|
|
1143
|
+
// PROP-135 слайс 5b-2: резолвер **проектного** (браузерного) пула для
|
|
1144
|
+
// вызовов MCP-инструментов исполнителя (`project:<id>:browser:<profile>`).
|
|
1145
|
+
// Роутер не умеет отдавать ссылку (`poolRefFor` нет — `inline`/вырожденный
|
|
1146
|
+
// роутер) → резолвера нет: вызовы идут с инстанс-пула (прежнее поведение).
|
|
1147
|
+
const executorMcpResolvePool = createExecutorMcpPoolResolver(executionRouter);
|
|
1148
|
+
// PROP-132 (Ф3в): сервис терминалов инстанса — **один экземпляр на процесс**
|
|
1149
|
+
// (реестр живых терминалов, поток вывода, ввод, лимиты, аудит, метрики).
|
|
1150
|
+
//
|
|
1151
|
+
// Жизненный цикл — здесь, а не в `mount-routes.ts`: сервис гасится на
|
|
1152
|
+
// graceful shutdown (`stopTerminalService`), а мастер-выключатель
|
|
1153
|
+
// `terminal.enabled` применяется **live** (`setEnabled`): живые терминалы
|
|
1154
|
+
// закрываются, создание новых запрещается — рестарт не нужен.
|
|
1155
|
+
//
|
|
1156
|
+
// PROP-135: порт терминала выбирается **тем же** роутером, что и порт тулов
|
|
1157
|
+
// (профиль по binding'у + область пула + `workspaceSubPath`) — терминал живёт
|
|
1158
|
+
// на той же точке исполнения, что и ход сессии.
|
|
1159
|
+
const terminalPortResolver = createTerminalPortResolver({
|
|
1160
|
+
router: executionRouter,
|
|
1161
|
+
sessions: { getSession: (id) => sessionManager.getSession(id) },
|
|
1162
|
+
projects: { load: (id) => projectStore.load(id) },
|
|
1163
|
+
agents: { get: (role) => agentRegistry.get(role) },
|
|
1164
|
+
workspacesRoot: config.workspacesRoot ?? join(dataDir, 'workspaces'),
|
|
1165
|
+
});
|
|
1166
|
+
// Эффективные настройки секции `terminal` (env > runtime > config > default,
|
|
1167
|
+
// по каждому полю): читаются **до** сборки сервиса — параметры выполнения,
|
|
1168
|
+
// оболочка новых терминалов и журналирование ввода приезжают стартовыми
|
|
1169
|
+
// значениями, дальше меняются live из `/api/v2/settings/terminal`.
|
|
1170
|
+
const terminalRuntime = await settingsStore.getTerminal();
|
|
1171
|
+
const terminalSettings = resolveTerminalSettings({
|
|
1172
|
+
...(config.synth.terminal ? { config: config.synth.terminal } : {}),
|
|
1173
|
+
runtime: terminalRuntime,
|
|
1174
|
+
env: process.env,
|
|
1175
|
+
});
|
|
1176
|
+
const terminalService = createTerminalService({
|
|
1177
|
+
port: executionPort,
|
|
1178
|
+
resolvePort: terminalPortResolver,
|
|
1179
|
+
blobs: storageContext.blobs,
|
|
1180
|
+
eventBus,
|
|
1181
|
+
commandAuditLog,
|
|
1182
|
+
...(metrics ? { metrics } : {}),
|
|
1183
|
+
sessions: { getSession: (id) => sessionManager.getSession(id) },
|
|
1184
|
+
limits: {
|
|
1185
|
+
idleMs: terminalSettings.idleMinutes * 60_000,
|
|
1186
|
+
maxPerProject: terminalSettings.maxPerProject,
|
|
1187
|
+
maxPerInstance: terminalSettings.maxPerInstance,
|
|
1188
|
+
},
|
|
1189
|
+
defaultShell: terminalSettings.shell,
|
|
1190
|
+
auditInput: terminalSettings.auditInput,
|
|
1191
|
+
// PROP-132 (Ф5): результат запуска команды в терминале приходит в сессию
|
|
1192
|
+
// **сообщением** — тем же нотификатором, что у фоновых шелл-процессов
|
|
1193
|
+
// (ADR-113): ровно одна копия (steer при активном ходе, иначе очередь).
|
|
1194
|
+
onRunFinished: async (run, terminal) => {
|
|
1195
|
+
const sessionId = terminal?.sessionId ?? run.sessionId;
|
|
1196
|
+
if (!sessionId) {
|
|
1197
|
+
// Терминал без привязки к сессии — уведомлять некуда (только лог).
|
|
1198
|
+
console.warn(`[terminal] терминал ${run.terminalId} не привязан к сессии — результат запуска ${run.runId} не доставлен`);
|
|
1199
|
+
return;
|
|
1200
|
+
}
|
|
1201
|
+
await notifyBackgroundParent(sessionId, buildTerminalRunNotification(run));
|
|
1202
|
+
},
|
|
1203
|
+
});
|
|
1204
|
+
// PROP-132: восстановление терминалов из снимков — тот же порядок
|
|
1205
|
+
// приоритета. Значение применяется **до** восстановления: выключенное
|
|
1206
|
+
// восстановление → снимки не поднимаются (их уберёт reaper).
|
|
1207
|
+
terminalService.setAutoRestore(terminalSettings.autoRestore);
|
|
1208
|
+
// Снимки терминалов поднимаются **до** применения мастер-выключателя:
|
|
1209
|
+
// восстановление поднимает **процесс** (новый PTY) для терминалов, живых на
|
|
1210
|
+
// момент остановки, — при выключенном контуре они сразу закрываются
|
|
1211
|
+
// (`setEnabled(false)`), при включённом возвращаются с сохранённой историей
|
|
1212
|
+
// вывода.
|
|
1213
|
+
const restoredTerminals = await terminalService.restoreFromSnapshots();
|
|
1214
|
+
if (restoredTerminals > 0) {
|
|
1215
|
+
console.log(`[terminal] восстановлено терминалов из снимков: ${restoredTerminals}`);
|
|
1216
|
+
}
|
|
1217
|
+
terminalService.setEnabled(terminalSettings.enabled);
|
|
881
1218
|
// PROP-097 (блок 5b): сервис фоновых шелл-процессов (паритет с standalone).
|
|
882
1219
|
//
|
|
883
1220
|
// Тот же порт исполнения, что у тулов (ADR-077): фон — это лишь способ
|
|
884
1221
|
// ожидания, а не отдельный путь исполнения. Учёт прогона — общий реестр
|
|
885
1222
|
// фоновых прогонов (`kind: 'process'`), лог — blob-хранилище (ADR-096).
|
|
886
1223
|
// В деградированном режиме хранилища сервиса нет (писать некуда).
|
|
1224
|
+
//
|
|
1225
|
+
// Логгер сервиса: предупреждения — в вывод процесса (в journal — консоль).
|
|
1226
|
+
const processLogger = { warn: (message) => console.warn(message) };
|
|
887
1227
|
const processService = backgroundService
|
|
888
1228
|
? new ProcessService({
|
|
889
1229
|
executionPort,
|
|
890
1230
|
background: backgroundService,
|
|
891
1231
|
blobs: storageContext.blobs,
|
|
892
1232
|
eventBus,
|
|
1233
|
+
// Снимок — fallback; живой предел лога читается при создании лога.
|
|
893
1234
|
limits: { maxLogBytes: config.synth.background.logMaxBytes },
|
|
1235
|
+
getMaxLogBytes: () => backgroundSettings.getMaxLogBytes(),
|
|
1236
|
+
logger: processLogger,
|
|
1237
|
+
// ADR-136/ADR-126 §5: терминальный переход фонового процесса
|
|
1238
|
+
// дописывает в журнал исполнений парную запись `finished`
|
|
1239
|
+
// (только метаданные — вывод процесса не пишется).
|
|
1240
|
+
onFinished: createScriptRunAuditFinisher({
|
|
1241
|
+
audit: commandAuditLog,
|
|
1242
|
+
logger: processLogger,
|
|
1243
|
+
}),
|
|
1244
|
+
})
|
|
1245
|
+
: undefined;
|
|
1246
|
+
// ADR-126 §5: сервис реестра скриптов проекта (`!`-запуск) — mirror core.
|
|
1247
|
+
//
|
|
1248
|
+
// Тот же экземпляр получают HTTP-роуты `/api/v2/sessions/:id/scripts*` и
|
|
1249
|
+
// тулы `script_list`/`script_run`. Создаётся только вместе с
|
|
1250
|
+
// `processService`: запускать скрипты негде (фоновые процессы в
|
|
1251
|
+
// деградированном режиме хранилища не создаются).
|
|
1252
|
+
const scriptService = processService
|
|
1253
|
+
? new ScriptService({
|
|
1254
|
+
config: {
|
|
1255
|
+
dataDir,
|
|
1256
|
+
scriptsPaths: config.synth.scripts.paths,
|
|
1257
|
+
trustedProjectDirs: effectiveSkillsTrustedProjectDirs,
|
|
1258
|
+
},
|
|
1259
|
+
processService,
|
|
894
1260
|
})
|
|
895
1261
|
: undefined;
|
|
896
1262
|
// ADR-114: сервис worktree (per-session рабочий каталог).
|
|
@@ -1110,6 +1476,18 @@ executionConfig) {
|
|
|
1110
1476
|
...(storageDegraded ? {} : { pendingApprovalRepository: storageContext.pendingApprovals }),
|
|
1111
1477
|
// ADR-077: порт исполнения команд (inline — исполнение в процессе).
|
|
1112
1478
|
executionPort,
|
|
1479
|
+
// PROP-135 Ф4a: роутер портов — порт тулов выбирается по профилю
|
|
1480
|
+
// сессии (`session.settings.executorProfile`).
|
|
1481
|
+
executionRouter,
|
|
1482
|
+
// ADR-135/PROP-135: эффективная секция `execution` — из неё выводится вид
|
|
1483
|
+
// среды исполнения (блок `[СРЕДА ИСПОЛНЕНИЯ]` в системном промпте).
|
|
1484
|
+
executionConfig: execution,
|
|
1485
|
+
// PROP-135 слайс 5b-2: резолвер **проектного** (браузерного) пула для
|
|
1486
|
+
// вызовов MCP-инструментов исполнителя: по `projectId` цели — адреса и
|
|
1487
|
+
// токен пула `project:<id>:browser:<profile>`. Роутер не умеет отдавать
|
|
1488
|
+
// ссылку (`poolRefFor` нет) → резолвера нет, вызовы идут с инстанс-пула
|
|
1489
|
+
// (прежнее поведение).
|
|
1490
|
+
...(executorMcpResolvePool ? { executorMcpResolvePool } : {}),
|
|
1113
1491
|
// ADR-102: сборщик `usage`/`decision` роллапов (write-path).
|
|
1114
1492
|
analytics,
|
|
1115
1493
|
// Аудит выдачи сессионных shell-грантов (паттерны команд и каталоги
|
|
@@ -1218,6 +1596,11 @@ executionConfig) {
|
|
|
1218
1596
|
...(config.synth.session?.autoTitle ? { autoTitle: config.synth.session.autoTitle } : {}),
|
|
1219
1597
|
securityConfig,
|
|
1220
1598
|
gatewayConfig,
|
|
1599
|
+
// PROP-136 (слайс 136a): журнал исполнений команд — тот же экземпляр
|
|
1600
|
+
// читает `GET /api/v2/audit/commands`.
|
|
1601
|
+
commandAudit: commandAuditLog,
|
|
1602
|
+
// PROP-136b (слайс 136b-2a): зеркальный чекер команд (нет — прежнее поведение).
|
|
1603
|
+
...(commandPolicyProvider ? { commandPolicy: commandPolicyProvider } : {}),
|
|
1221
1604
|
gatewayAuditLogger,
|
|
1222
1605
|
gatewayPayloadLogPath,
|
|
1223
1606
|
gatewayPatternStore: patternStore,
|
|
@@ -1234,7 +1617,7 @@ executionConfig) {
|
|
|
1234
1617
|
toolsPolicy,
|
|
1235
1618
|
mcpPolicy,
|
|
1236
1619
|
toolsDisabled,
|
|
1237
|
-
// ADR-
|
|
1620
|
+
// ADR-126 §11: системный hard-gate скиллов (runtime-настройка).
|
|
1238
1621
|
skillsDisabled,
|
|
1239
1622
|
// ADR-070 §2.9.1: зависимости окружения (git/rg/sh) — детекция при старте.
|
|
1240
1623
|
// Проба бинарников — через тот же порт исполнения (ADR-077).
|
|
@@ -1242,9 +1625,9 @@ executionConfig) {
|
|
|
1242
1625
|
// ADR-071 §2.6: калибровка chars-per-token по модели (runtime-настройки).
|
|
1243
1626
|
tokenRatioLoader: (model) => settingsStore.getTokenRatio(model),
|
|
1244
1627
|
onTokenRatioCalibrated: (model, ratio) => settingsStore.setTokenRatio(model, ratio),
|
|
1245
|
-
// ADR-
|
|
1628
|
+
// ADR-126 §5: каталог скиллов в промпт + тул `skill`.
|
|
1246
1629
|
skillRuntime: skillService,
|
|
1247
|
-
// ADR-
|
|
1630
|
+
// ADR-126 §1: резолвинг `/`-команд до LLM.
|
|
1248
1631
|
commandRuntime: commandService,
|
|
1249
1632
|
// ADR-069 Фаза 1: проектные инструкции (merged chain AGENTS.md).
|
|
1250
1633
|
instructionsConfig: config.synth.instructions,
|
|
@@ -1256,6 +1639,14 @@ executionConfig) {
|
|
|
1256
1639
|
// ADR-051: late-bound резолвер активности расписания в сессии (ScheduleStore
|
|
1257
1640
|
// создаётся ниже) — включает статический блок `Scheduler` в промпт.
|
|
1258
1641
|
isSchedulerActive: (sid) => scheduleStore.hasEnabledTargetFor(sid),
|
|
1642
|
+
// PROP-141 (Часть D): сервис переноса сессии (late-bound — собирается
|
|
1643
|
+
// после движка таймеров) → extra тулов `project_attach`/`project_create`.
|
|
1644
|
+
getMoveService: () => moveServiceRef.service,
|
|
1645
|
+
// PROP-141 (этап 6): движок таймеров/будильников (late-bound — тот же
|
|
1646
|
+
// экземпляр, что у HTTP-роутов `/api/v2/timers*`) и порт реестра →
|
|
1647
|
+
// extra тулов `timer`/`alarm`.
|
|
1648
|
+
getTimerService: () => timerServiceRef.service,
|
|
1649
|
+
timerRepository: storageContext.timers,
|
|
1259
1650
|
// ADR-101/ADR-051: late-bound рантайм автоматизации для встроенных тулов
|
|
1260
1651
|
// (`pipeline_*`/`schedule_*`) — движок пайплайнов и шедулер создаются ниже,
|
|
1261
1652
|
// поэтому геттер отдаёт актуальный снимок в момент хода.
|
|
@@ -1275,6 +1666,12 @@ executionConfig) {
|
|
|
1275
1666
|
// PROP-097: сервис фоновых шелл-процессов — тот же экземпляр, что у
|
|
1276
1667
|
// реестра и тула `execute_shell` (через `ctx.extra.processService`).
|
|
1277
1668
|
...(processService ? { processService } : {}),
|
|
1669
|
+
// ADR-126 §5: реестр скриптов проекта — тулы `script_list`/`script_run`
|
|
1670
|
+
// (через `ctx.extra.scriptService`) и HTTP-роут `/sessions/:id/scripts*`.
|
|
1671
|
+
...(scriptService ? { scriptService } : {}),
|
|
1672
|
+
// PROP-132 (Ф5): сервис интерактивных терминалов — тот же экземпляр, что у
|
|
1673
|
+
// HTTP-роутов `/api/v2/terminals*` (через `ctx.extra.terminalService`).
|
|
1674
|
+
terminalService,
|
|
1278
1675
|
// PROP-124 §0: режим инстанса для SSH-ключей (`ssh.mode`) — live-геттер:
|
|
1279
1676
|
// runtime-настройка (`/api/v2/settings/ssh`) применяется без рестарта.
|
|
1280
1677
|
// `tools` (дефолт) — ключ в окружение команд не попадает; `agent` — ключи
|
|
@@ -1283,7 +1680,10 @@ executionConfig) {
|
|
|
1283
1680
|
// ADR-114: сервис worktree — тулы `git_worktree_*` (инвентарь
|
|
1284
1681
|
// per-session рабочих каталогов проекта).
|
|
1285
1682
|
...(worktreeService ? { worktreeService } : {}),
|
|
1683
|
+
// Снимок — fallback; живой геттер читается при сборке контекста каждого
|
|
1684
|
+
// вызова (runtime-тумблер `background.enabled` действует без рестарта).
|
|
1286
1685
|
backgroundEnabled: config.synth.background.enabled,
|
|
1686
|
+
getBackgroundEnabled: () => backgroundSettings.isEnabled(),
|
|
1287
1687
|
// Предохранитель по объёму промпта саб-агента (`agents.subagentMaxInputTokens`).
|
|
1288
1688
|
subagentMaxInputTokens: config.synth.agents.subagentMaxInputTokens,
|
|
1289
1689
|
// Лимит глубины вложенности саб-агентов (`agents.subagentDepth`): при
|
|
@@ -1421,6 +1821,10 @@ executionConfig) {
|
|
|
1421
1821
|
// ADR-051 (срез) / ADR-089: правило маршрутизации cron-событий по расписанию
|
|
1422
1822
|
// (паритет с core `server/app.ts`; store без дублей).
|
|
1423
1823
|
eventRouter.registerRuleProvider(new SchedulerRuleProvider(scheduleStore, effectiveEvents.ephemeralTtl));
|
|
1824
|
+
// PROP-141 (Часть B): правило маршрутизации срабатываний таймеров/будильников.
|
|
1825
|
+
// Источник свой (`timer`), тип свой (`timer_fired`) — правила cron и внешних
|
|
1826
|
+
// событий не затрагиваются.
|
|
1827
|
+
eventRouter.registerRuleProvider(new TimerRuleProvider());
|
|
1424
1828
|
// ADR-089: правила маршрутизации по матчу события (после scheduler).
|
|
1425
1829
|
eventRouter.registerRuleProvider(new ProjectRuleProvider(routeRuleStore, effectiveEvents.ephemeralTtl));
|
|
1426
1830
|
// ADR-084 × ADR-089: decision-маршрутизация при промахе декларативных правил
|
|
@@ -1451,7 +1855,9 @@ executionConfig) {
|
|
|
1451
1855
|
// EventHub — центральный диспетчер подписок. Создаётся до funnel: колбэк
|
|
1452
1856
|
// `onSessionMaterialized` подписывает клиентов владельца на сессии,
|
|
1453
1857
|
// созданные после их подключения (`subscribeToSession`, ADR-089).
|
|
1454
|
-
|
|
1858
|
+
// PROP-133 §6: проекты — чтобы подписка покрывала сессии всех видимых
|
|
1859
|
+
// проектов (не только свои).
|
|
1860
|
+
const eventHub = new EventHub(eventBus, sessionManager, projectStore);
|
|
1455
1861
|
// ADR-089: резолвер внешнего отправителя (профиль `identities`, principalId) в
|
|
1456
1862
|
// пользователя инстанса; override `identityMap` — приоритетнее профиля.
|
|
1457
1863
|
// `getIdentityMap` читает актуальное значение — `onEventsChange` обновляет
|
|
@@ -1541,7 +1947,10 @@ executionConfig) {
|
|
|
1541
1947
|
let message = eventToMessage(event);
|
|
1542
1948
|
// ADR-089: для слинкованного человека `displayName` из резолвера приоритетнее
|
|
1543
1949
|
// имени из `payload.from` (tg-имя). Cron (`Scheduler`) не переопределяем.
|
|
1544
|
-
|
|
1950
|
+
// PROP-141: таймер — системный автор `Timer`, его не переопределяем.
|
|
1951
|
+
if (event.source !== 'cron'
|
|
1952
|
+
&& event.source !== TIMER_EVENT_SOURCE
|
|
1953
|
+
&& event.identity?.principalId) {
|
|
1545
1954
|
try {
|
|
1546
1955
|
const linked = await resolveExternalIdentity(event.identity);
|
|
1547
1956
|
if (linked?.displayName)
|
|
@@ -1569,6 +1978,17 @@ executionConfig) {
|
|
|
1569
1978
|
await addEventAttachmentRefs(storageContext.blobRefs, event, message.id);
|
|
1570
1979
|
}
|
|
1571
1980
|
}
|
|
1981
|
+
else if (mode === 'steer') {
|
|
1982
|
+
// PROP-141 (Часть B, «Доставка»): доставка срабатывания таймера —
|
|
1983
|
+
// **как завершение фонового процесса** (ADR-113/ADR-104): ход идёт —
|
|
1984
|
+
// вклинивание в него на границе шага, хода нет — обычная очередь с
|
|
1985
|
+
// автоходом, фоллбек — запись в историю. Ровно одна копия в истории
|
|
1986
|
+
// гарантирует сам нотификатор (`createBackgroundParentNotifier`).
|
|
1987
|
+
//
|
|
1988
|
+
// Ошибка доставки **пробрасывается наружу**: движок таймеров по ней
|
|
1989
|
+
// ставит `outcome:'error'` (и `lastError` у записи).
|
|
1990
|
+
await notifyBackgroundParent(sessionId, message);
|
|
1991
|
+
}
|
|
1572
1992
|
else {
|
|
1573
1993
|
// ADR-036: `defer` тоже кладёт сообщение в историю — обфусцируем до
|
|
1574
1994
|
// постановки. Старт процессора не выполняем (только очередь владельца).
|
|
@@ -1683,6 +2103,15 @@ executionConfig) {
|
|
|
1683
2103
|
metrics: metrics ? createPipelineMetrics(metrics) : undefined,
|
|
1684
2104
|
// ADR-101 §4/ADR-070: промпт шага — тем же сборщиком, что у сессий.
|
|
1685
2105
|
composer: orchestrator.getComposer(),
|
|
2106
|
+
// IPI шага (ADR-101): тот же фильтр контента тулов, что у хода и
|
|
2107
|
+
// саб-агента. Конфиг — **живой** геттер оркестратора (runtime-настройка
|
|
2108
|
+
// безопасности применяется без рестарта), словари — порт инстанса.
|
|
2109
|
+
securityContentFilter: {
|
|
2110
|
+
getConfig: () => orchestrator.getSecurityConfig(),
|
|
2111
|
+
dictionaryStore,
|
|
2112
|
+
},
|
|
2113
|
+
// ADR-135/PROP-135: среда исполнения шага — та же, что у сессий.
|
|
2114
|
+
environmentKind: orchestrator.getEnvironmentKind(),
|
|
1686
2115
|
resolveProvider: resolvePipelineProvider,
|
|
1687
2116
|
resolveLlmDefaults,
|
|
1688
2117
|
// ADR-115 × ADR-101: вложения прогона — тот же сервис вложений, что у
|
|
@@ -1725,6 +2154,12 @@ executionConfig) {
|
|
|
1725
2154
|
skillsCatalog: skillService,
|
|
1726
2155
|
runtimeDeps,
|
|
1727
2156
|
workspacesRoot: config.workspacesRoot,
|
|
2157
|
+
// ADR-077/PROP-135: контур исполнения шага — те же порт и роутер, что у
|
|
2158
|
+
// сессий: плагинный тул получает `ctx.runtime` (PROP-138), `sandbox_exec`
|
|
2159
|
+
// находит пул по классу `sandbox`, а per-project монтирование PVC —
|
|
2160
|
+
// `executionWorkspaceSubPath` (движок считает его от `workspacesRoot`).
|
|
2161
|
+
executionPort,
|
|
2162
|
+
executionRouter,
|
|
1728
2163
|
});
|
|
1729
2164
|
// ADR-101/ADR-051: движок пайплайнов появился — отдаём его тулам
|
|
1730
2165
|
// `pipeline_*` через рантайм автоматизации (late-bound).
|
|
@@ -1757,6 +2192,15 @@ executionConfig) {
|
|
|
1757
2192
|
console.warn('[scheduler] leaderElection=postgres, но backend не предоставляет advisory-локи ' +
|
|
1758
2193
|
'(нужен storage.backend=postgres) — используется AlwaysLeader');
|
|
1759
2194
|
}
|
|
2195
|
+
// ADR-051/ADR-089 + PROP-141: **общий** лидер-выбор для шедулера и движка
|
|
2196
|
+
// таймеров. Второй лок означал бы двух владельцев (тик расписаний в одной
|
|
2197
|
+
// реплике, таймеров — в другой), а `FileMutex` повторно не захватывается тем
|
|
2198
|
+
// же экземпляром. `SharedLeader` — один лок на оба тикера.
|
|
2199
|
+
const sharedLeader = new SharedLeader(config.synth.scheduler.leaderElection === 'file'
|
|
2200
|
+
? new FileLeader({ dataDir, tickMs: schedulerTickMs })
|
|
2201
|
+
: config.synth.scheduler.leaderElection === 'postgres' && storageContext.locks
|
|
2202
|
+
? storageContext.locks.createLeader({ name: 'scheduler/leader', tickMs: schedulerTickMs })
|
|
2203
|
+
: new AlwaysLeader());
|
|
1760
2204
|
const schedulerService = new SchedulerService({
|
|
1761
2205
|
scheduleStore,
|
|
1762
2206
|
ingress: eventIngress,
|
|
@@ -1790,17 +2234,104 @@ executionConfig) {
|
|
|
1790
2234
|
// ADR-051/ADR-089/ADR-096: тикер стартует только у лидера (default —
|
|
1791
2235
|
// AlwaysLeader). `file` — файловый лок на общем dataDir, `postgres` —
|
|
1792
2236
|
// session-level advisory-lock драйвера (доступен только при PG-backend).
|
|
1793
|
-
|
|
1794
|
-
|
|
1795
|
-
: config.synth.scheduler.leaderElection === 'postgres' && storageContext.locks
|
|
1796
|
-
? storageContext.locks.createLeader({ name: 'scheduler/leader', tickMs: schedulerTickMs })
|
|
1797
|
-
: new AlwaysLeader(),
|
|
2237
|
+
// PROP-141: тот же лидер-выбор — и у шедулера, и у таймеров.
|
|
2238
|
+
leader: sharedLeader,
|
|
1798
2239
|
});
|
|
2240
|
+
// PROP-141: бэкфилл `projectId` у легаси-расписаний (идемпотентно).
|
|
2241
|
+
//
|
|
2242
|
+
// Выполняется **до** старта шедулера: инстансных автоматизаций нет, каждое
|
|
2243
|
+
// расписание принадлежит проекту. Проект выводится из цели (`pipeline`/
|
|
2244
|
+
// `ephemeral` — из самой цели, `bound`/`queue` — у сессии-цели); вывести
|
|
2245
|
+
// нельзя — запись остаётся в реестре, но отключается (`project_required`)
|
|
2246
|
+
// и не срабатывает. Ошибка бэкфилла не роняет старт (запись не теряется).
|
|
2247
|
+
try {
|
|
2248
|
+
const backfill = await storageContext.schedules.backfillProjectIds?.();
|
|
2249
|
+
if (backfill && (backfill.backfilled > 0 || backfill.disabled > 0)) {
|
|
2250
|
+
console.warn(`[scheduler] бэкфилл проектов расписаний: проект проставлен у ${backfill.backfilled}, `
|
|
2251
|
+
+ `отключено ${backfill.disabled}`);
|
|
2252
|
+
}
|
|
2253
|
+
}
|
|
2254
|
+
catch (err) {
|
|
2255
|
+
console.warn(`[scheduler] бэкфилл проектов расписаний не удался: ${err instanceof Error ? err.message : String(err)}`);
|
|
2256
|
+
}
|
|
1799
2257
|
if (config.synth.scheduler.enabled !== false && !storageDegraded) {
|
|
1800
2258
|
void schedulerService.start().catch((err) => {
|
|
1801
2259
|
console.warn(`[scheduler] не удалось запустить: ${err instanceof Error ? err.message : String(err)}`);
|
|
1802
2260
|
});
|
|
1803
2261
|
}
|
|
2262
|
+
// PROP-141 (Часть B, «Доставка»): движок таймеров/будильников.
|
|
2263
|
+
//
|
|
2264
|
+
// Доставка — **гибрид** (PROP-141, «Доставка»): журнал и дедуп — через
|
|
2265
|
+
// событийный контур (`EventIngress` → Router → `TimerRuleProvider`), сама
|
|
2266
|
+
// доставка в сессию — как завершение фонового процесса (ADR-113/ADR-104):
|
|
2267
|
+
// вклинивание в текущий ход, иначе очередь, иначе запись в историю.
|
|
2268
|
+
const timerMetrics = metrics ? createTimerMetrics(metrics) : undefined;
|
|
2269
|
+
const timerService = storageDegraded
|
|
2270
|
+
? undefined
|
|
2271
|
+
: new TimerService({
|
|
2272
|
+
// ADR-096: порты реестра таймеров и истории срабатываний.
|
|
2273
|
+
timers: storageContext.timers,
|
|
2274
|
+
firings: storageContext.timerFirings,
|
|
2275
|
+
// Ошибка доставки пробрасывается наружу — движок ставит `outcome:'error'`.
|
|
2276
|
+
deliver: async (timer, firing, meta) => {
|
|
2277
|
+
const result = await eventIngress.ingest({
|
|
2278
|
+
source: TIMER_EVENT_SOURCE,
|
|
2279
|
+
type: TIMER_EVENT_TYPE,
|
|
2280
|
+
payload: {
|
|
2281
|
+
sessionId: timer.sessionId,
|
|
2282
|
+
timerId: timer.id,
|
|
2283
|
+
kind: timer.kind,
|
|
2284
|
+
repeat: timer.repeat.mode,
|
|
2285
|
+
comment: timer.comment,
|
|
2286
|
+
...(timer.name ? { name: timer.name } : {}),
|
|
2287
|
+
scheduledFor: firing.scheduledFor,
|
|
2288
|
+
firedAt: firing.firedAt,
|
|
2289
|
+
catchup: meta.catchup,
|
|
2290
|
+
},
|
|
2291
|
+
// Дедуп по (таймер, плановое время) — повторный тик и смена лидера
|
|
2292
|
+
// не дают двух сообщений.
|
|
2293
|
+
dedupKey: `timer:${timer.id}:${firing.scheduledFor}`,
|
|
2294
|
+
identity: { principalId: timer.ownerId },
|
|
2295
|
+
});
|
|
2296
|
+
if (result.error)
|
|
2297
|
+
throw new Error(result.error);
|
|
2298
|
+
},
|
|
2299
|
+
// PROP-141: лидер тот же, что у шедулера (второго тикера нет).
|
|
2300
|
+
leader: sharedLeader,
|
|
2301
|
+
// ADR-094: метрики `synth_timer_*`.
|
|
2302
|
+
metrics: timerMetrics,
|
|
2303
|
+
// Аудит `scope:'timer'` (создание/правка/срабатывание/отмена).
|
|
2304
|
+
audit: securityAudit,
|
|
2305
|
+
// Live-события в канале сессии (ADR-009/ADR-024; новых каналов нет).
|
|
2306
|
+
onEvent: (sessionId, type, data) => {
|
|
2307
|
+
eventBus.publish(sessionId, type, data);
|
|
2308
|
+
},
|
|
2309
|
+
});
|
|
2310
|
+
timerServiceRef.service = timerService;
|
|
2311
|
+
if (timerService) {
|
|
2312
|
+
void timerService.start().catch((err) => {
|
|
2313
|
+
console.warn(`[timers] не удалось запустить: ${err instanceof Error ? err.message : String(err)}`);
|
|
2314
|
+
});
|
|
2315
|
+
}
|
|
2316
|
+
// PROP-141 (Часть D): сервис переноса сессии между проектами — единый шов
|
|
2317
|
+
// для HTTP-роута `PATCH /sessions/:id { project_id }` и агентских
|
|
2318
|
+
// `project_attach`/`project_create`.
|
|
2319
|
+
const moveService = storageDegraded
|
|
2320
|
+
? undefined
|
|
2321
|
+
: new SessionMoveService({
|
|
2322
|
+
sessionManager,
|
|
2323
|
+
backgroundRuns: storageContext.backgroundRuns,
|
|
2324
|
+
...(backgroundService ? { backgroundService } : {}),
|
|
2325
|
+
...(processService ? { processService } : {}),
|
|
2326
|
+
terminalService,
|
|
2327
|
+
...(timerService ? { timerService } : {}),
|
|
2328
|
+
timers: storageContext.timers,
|
|
2329
|
+
scheduleStore,
|
|
2330
|
+
isTurnActive: isBackgroundTurnActive,
|
|
2331
|
+
eventBus,
|
|
2332
|
+
...(securityAudit ? { audit: securityAudit } : {}),
|
|
2333
|
+
});
|
|
2334
|
+
moveServiceRef.service = moveService;
|
|
1804
2335
|
// ADR-101/ADR-051: шедулер появился — отдаём его тулам `schedule_*`
|
|
1805
2336
|
// через рантайм автоматизации (late-bound).
|
|
1806
2337
|
automationRuntime.scheduler = schedulerService;
|
|
@@ -1828,6 +2359,15 @@ executionConfig) {
|
|
|
1828
2359
|
}
|
|
1829
2360
|
return {
|
|
1830
2361
|
dataDir,
|
|
2362
|
+
// PROP-135 Ф6a: роутер портов исполнения — каталог профилей для
|
|
2363
|
+
// валидации `project.executor`/`settings.executorProfile` в роутах.
|
|
2364
|
+
executionRouter,
|
|
2365
|
+
// PROP-135 Ф6b-1: эффективная секция `execution` — admin-API профилей и
|
|
2366
|
+
// пулов (`/api/v2/execution/*`): `provider`/`pooling`/каталог профилей.
|
|
2367
|
+
executionConfig: execution,
|
|
2368
|
+
// ADR-135: секция `execution` **config-уровня** (без runtime) — база для
|
|
2369
|
+
// runtime-каталога профилей в `/api/v2/settings/execution` («дефолты»).
|
|
2370
|
+
fallbackExecutionConfig: baseExecution,
|
|
1831
2371
|
// ADR-106 Ф3: реестр подтверждений (enforced-режим Authority-слоя).
|
|
1832
2372
|
approvalRegistry,
|
|
1833
2373
|
// ADR-096: контекст хранения инстанса — для операций, которым нужен
|
|
@@ -1856,7 +2396,7 @@ executionConfig) {
|
|
|
1856
2396
|
defaultWorkingDir,
|
|
1857
2397
|
getDefaultAgentId,
|
|
1858
2398
|
/**
|
|
1859
|
-
* ADR-
|
|
2399
|
+
* ADR-126/ADR-069: эффективный project-trust гейт скиллов/команд/инструкций
|
|
1860
2400
|
* (runtime > config), снятый на старте; нужен резолверу инструкций в
|
|
1861
2401
|
* `mount-routes`.
|
|
1862
2402
|
*/
|
|
@@ -1865,6 +2405,18 @@ executionConfig) {
|
|
|
1865
2405
|
egressLogConfig,
|
|
1866
2406
|
securityAudit,
|
|
1867
2407
|
egressRequests,
|
|
2408
|
+
// PROP-136 (слайс 136a): журнал исполнений команд — роуты
|
|
2409
|
+
// `/api/v2/audit/commands` читают тот же экземпляр, что пишет оркестратор.
|
|
2410
|
+
commandAuditLog,
|
|
2411
|
+
// PROP-132 (Ф3в): сервис терминалов инстанса (один на процесс) + его
|
|
2412
|
+
// остановка на graceful shutdown (`dispose()` закрывает живые терминалы).
|
|
2413
|
+
terminalService,
|
|
2414
|
+
stopTerminalService: () => terminalService.dispose(),
|
|
2415
|
+
// PROP-141 (Часть D): сервис переноса сессии между проектами (роуты
|
|
2416
|
+
// `PATCH /sessions/:id { project_id }`).
|
|
2417
|
+
moveService,
|
|
2418
|
+
// PROP-136b (слайс 136b-2a): зеркальный чекер команд — для тестов/UI.
|
|
2419
|
+
commandPolicyProvider,
|
|
1868
2420
|
// ADR-102 (волна 1): порт пред-агрегированных роллапов аналитики — для роутов отчётов.
|
|
1869
2421
|
analyticsRollups,
|
|
1870
2422
|
// ADR-102: write-path — сборщик роллапов (+ остановка hook-подписки и pruner'а).
|
|
@@ -1906,6 +2458,8 @@ executionConfig) {
|
|
|
1906
2458
|
// PROP-097 (блок 5b): сервис фоновых шелл-процессов (+ pruner логов).
|
|
1907
2459
|
processService,
|
|
1908
2460
|
stopProcessLogPruner,
|
|
2461
|
+
// ADR-126 §5: сервис реестра скриптов проекта (HTTP-контур `/scripts*`).
|
|
2462
|
+
scriptService,
|
|
1909
2463
|
// ADR-115: GC осиротевших вложений сообщений.
|
|
1910
2464
|
stopAttachmentPruner,
|
|
1911
2465
|
// ADR-115 × ADR-077: уборка временных каталогов медиа-раннера.
|
|
@@ -1923,6 +2477,9 @@ executionConfig) {
|
|
|
1923
2477
|
stickyNotesLimitsSettings,
|
|
1924
2478
|
// PROP-124: режим инстанса для SSH-ключей (live, админ-API).
|
|
1925
2479
|
sshModeSettings,
|
|
2480
|
+
// Этап 1 roadmap 0.13 (блок 4): живое состояние секции `background`
|
|
2481
|
+
// (сервисы/прунеры/оркестратор + админ-API `/settings/background`).
|
|
2482
|
+
backgroundSettings,
|
|
1926
2483
|
// ADR-114: сервис worktree — HTTP-контур проектов и привязка сессии.
|
|
1927
2484
|
worktreeService,
|
|
1928
2485
|
webhookStore,
|
|
@@ -1945,6 +2502,8 @@ executionConfig) {
|
|
|
1945
2502
|
skillService,
|
|
1946
2503
|
bundleStore,
|
|
1947
2504
|
commandService,
|
|
2505
|
+
// ADR-126 §4: сервис сниппетов (`#`) — HTTP-контур `/api/v2/snippets`.
|
|
2506
|
+
snippetService,
|
|
1948
2507
|
orchestrator,
|
|
1949
2508
|
// ADR-090 (Ф5б-1): рантайм плагинов — старт-активация установленного
|
|
1950
2509
|
// (`app.ts`/`main.ts`) и точки для HTTP API/CLI (Ф5б-2/3). `host`+`installer` внутри.
|
|
@@ -1969,6 +2528,10 @@ executionConfig) {
|
|
|
1969
2528
|
requestSessionService,
|
|
1970
2529
|
eventIngress,
|
|
1971
2530
|
schedulerService,
|
|
2531
|
+
// PROP-141 (Часть B): движок таймеров/будильников + его остановка
|
|
2532
|
+
// (graceful shutdown — рядом с `stopScheduler`).
|
|
2533
|
+
timerService,
|
|
2534
|
+
stopTimerService: () => timerService?.stop(),
|
|
1972
2535
|
/**
|
|
1973
2536
|
* Живые (мутируемые) эффективные настройки — аксессоры, а не значения:
|
|
1974
2537
|
* обновляются админкой в рантайме (`mountBackendRoutes`), читаются
|