@itphx/synth-backend 0.10.1 → 0.12.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/app/bootstrap.d.ts +2 -2
- package/dist/app/deps.d.ts +77 -33
- package/dist/app/deps.js +969 -102
- package/dist/app/listen.d.ts +13 -2
- package/dist/app/listen.js +138 -10
- package/dist/app/mount-routes.d.ts +16 -3
- package/dist/app/mount-routes.js +625 -32
- package/dist/app.d.ts +42 -7
- package/dist/app.js +149 -12
- package/dist/auth/guards.d.ts +17 -1
- package/dist/auth/guards.js +46 -2
- package/dist/auth/middleware.d.ts +2 -12
- package/dist/auth/middleware.js +20 -2
- package/dist/auth/oidc.d.ts +7 -0
- package/dist/auth/oidc.js +27 -6
- package/dist/auth/plugin-scope.d.ts +10 -0
- package/dist/auth/plugin-scope.js +69 -0
- package/dist/auth/service-scope.d.ts +7 -3
- package/dist/auth/service-scope.js +8 -4
- package/dist/events/hub.js +3 -38
- package/dist/lib/app-config.d.ts +2 -0
- package/dist/lib/app-config.js +3 -2
- package/dist/lib/defaults-store.d.ts +2 -25
- package/dist/lib/defaults-store.js +5 -87
- package/dist/lib/i18n.js +153 -0
- package/dist/main.js +67 -4
- package/dist/routes/agents.d.ts +12 -3
- package/dist/routes/agents.js +14 -2
- package/dist/routes/auth.d.ts +12 -2
- package/dist/routes/auth.js +16 -2
- package/dist/routes/context.d.ts +2 -2
- package/dist/routes/gateway-patterns.d.ts +2 -2
- package/dist/routes/llm.d.ts +8 -2
- package/dist/routes/llm.js +6 -3
- package/dist/routes/mcp-registry.d.ts +15 -3
- package/dist/routes/mcp-registry.js +122 -21
- package/dist/routes/messages.d.ts +7 -4
- package/dist/routes/messages.js +34 -3
- package/dist/routes/models.d.ts +7 -2
- package/dist/routes/models.js +3 -1
- package/dist/routes/processes.d.ts +34 -0
- package/dist/routes/processes.js +26 -0
- package/dist/routes/projects.d.ts +9 -3
- package/dist/routes/projects.js +8 -1
- package/dist/routes/providers.d.ts +15 -3
- package/dist/routes/providers.js +33 -21
- package/dist/routes/queue.d.ts +5 -4
- package/dist/routes/queue.js +30 -3
- package/dist/routes/sessions.d.ts +50 -3
- package/dist/routes/sessions.js +221 -74
- package/dist/test-helpers/close-server.d.ts +33 -0
- package/dist/test-helpers/close-server.js +50 -0
- package/package.json +4 -4
package/dist/app/deps.js
CHANGED
|
@@ -4,27 +4,156 @@
|
|
|
4
4
|
// Вынесено из `app.ts` (ADR-095, шаг 4b) — «вынос по швам», без изменения поведения.
|
|
5
5
|
import { mkdir } from 'node:fs/promises';
|
|
6
6
|
import { join } from 'node:path';
|
|
7
|
-
import { ensureDataDir, parsePrincipalId, resolveDefaultWorkspace, resolveSecretKey, } from '@itphx/synth-shared';
|
|
8
|
-
import {
|
|
9
|
-
|
|
7
|
+
import { ensureDataDir, parsePrincipalId, resolveDefaultWorkspace, resolveSecretKey, resolveStorageBackend, resolvePostgresConfig, resolvePostgresPassword, resolveDegradedMode, resolveStorageFallbackDir, resolveExecutionConfig, readTlsRuntimeSettings, SYNTH_VERSION, } from '@itphx/synth-shared';
|
|
8
|
+
import { SessionManager, EventBus, QueueProcessorManager, ContextBuilder, ContextOptimizer, ChatOrchestrator, enqueueUserMessage, createToolRegistry, createAgentRegistry, McpManager, DEFAULT_AGENT_ID, registerStoredAgents, AuditLogger, mergeLlmGatewayConfig, mergeSecurityConfig, mergeEventsConfig, mergeDecisionConfig, mergePluginsConfig,
|
|
9
|
+
// ADR-115: живое состояние runtime-настроек вложений (`/settings/attachments`).
|
|
10
|
+
createLiveAttachmentsSettings, createEgressPolicyResolver, createEgressLogSink, configureEgressRuntime, startEgressLogPruner,
|
|
11
|
+
// ADR-105 (Ф3): источник access-токена для MCP-коннекторов + OAuth-сервис.
|
|
12
|
+
OAuthCredentialService, OAuthProviderRegistry, registerOAuthProvidersFromConfig, createRepositoryCredentialSource, SkillService, resolveProjectSkillSeed, CommandService, detectRuntimeDeps, syncProvidersFromEnv,
|
|
13
|
+
// ADR-115 × ADR-101: доступность `ffmpeg` — обработчик вложения aux-моделью шага.
|
|
14
|
+
isFfmpegAvailable, HookBus, startEphemeralSweeper, assertInstanceDataNotTooNew, applyStartupMigrations, applyPendingRestore, EventRouter, RequestSessionService, EventIngress, eventToMessage, addEventAttachmentRefs, AttachmentService, ProjectRuleProvider, DecisionRuleProvider, PipelineTracker, SchedulerRuleProvider, SchedulerService, AlwaysLeader, FileLeader, createExternalIdentityResolver, startEventJournalPruner,
|
|
15
|
+
// Этап 1 roadmap 0.13 (блок 3): сервис вопросов пользователю + retention.
|
|
16
|
+
QuestionService, startQuestionPruner,
|
|
17
|
+
// Этап 1 roadmap 0.13 (блок 4): реестр фоновых прогонов + retention.
|
|
18
|
+
BackgroundRunService, startBackgroundRunPruner, createBackgroundParentNotifier,
|
|
19
|
+
// PROP-097 (блок 5b): сервис фоновых шелл-процессов + retention логов.
|
|
20
|
+
ProcessService, startProcessLogPruner,
|
|
21
|
+
// ADR-115: GC осиротевших вложений сообщений.
|
|
22
|
+
startAttachmentPruner,
|
|
23
|
+
// ADR-114: сервис worktree'ов (per-session рабочий каталог) + публикация
|
|
24
|
+
// `worktree.updated` в каналы сессий проекта.
|
|
25
|
+
WorktreeService, publishWorktreeUpdated, startWorktreeSweeper, WebhookService, startWebhookDeliveryPruner, AnalyticsRecorder, attachAnalyticsActivityHooks, startAnalyticsRollupPruner, sessionAxes, createStorageContextAsync, initTlsTrust, applyStartupProxyConfig, attachBusMetrics, startSessionMetrics, startStorageMetrics,
|
|
26
|
+
// ADR-094/PROP-047: метрики памяти (`synth_memory_*`).
|
|
27
|
+
startMemoryMetrics,
|
|
28
|
+
// ADR-107: телеметрия контекста памяти и recall (`synth_memory_context_*`,
|
|
29
|
+
// `synth_memory_recall_*`).
|
|
30
|
+
createMemoryTelemetry, registerDecisionMetrics, createSchedulerMetrics,
|
|
31
|
+
// ADR-094/ADR-077: метрики пула исполнителей (`synth_executor_*`).
|
|
32
|
+
createExecutorMetricsCollector, createWebhookMetrics, createEventMetrics,
|
|
33
|
+
// ADR-094/ADR-115: метрики вложений (`synth_attachment_*`) + установка их
|
|
34
|
+
// sink'а (сервис вложений собирается внутри фабрики роутов сессий).
|
|
35
|
+
createAttachmentMetrics, setAttachmentMetricsHook,
|
|
36
|
+
// ADR-106 Ф1/Ф2: счётчик решений Authority-слоя (`synth_authority_decisions_total`)
|
|
37
|
+
// и guard-слоя (решение считается; в enforced-режиме — применяется).
|
|
38
|
+
createAuthorityMetrics, AuthorityGuard,
|
|
39
|
+
// ADR-106 Ф3: реестр подтверждений + покрытие (носитель покрывающего гранта).
|
|
40
|
+
ApprovalRegistry, buildApprovalResponderProfile, createApprovalCoverageResolver, startEventJournalMetrics,
|
|
41
|
+
// ADR-101 (Э5): движок пайплайнов, исполнители шагов, обработчики выходов.
|
|
42
|
+
PipelineArtifactStore, PipelineEngine,
|
|
43
|
+
// ADR-101: реестр активных прогонов (soft-lock + отмена) — общий экземпляр
|
|
44
|
+
// для HTTP-роута пайплайнов и встроенных тулов агента.
|
|
45
|
+
PipelineRunControl, createToolStepExecutor, createScriptStepExecutor, createHumanStepExecutor, createAgentStepExecutor, createPipelineExitHandler, createPipelineMetrics,
|
|
46
|
+
// ADR-115 × ADR-101: вложения прогона — derive для text-only модели шага.
|
|
47
|
+
createPipelineAttachmentDerive, ensureBuiltinPipelines, toCoreProviderConfig, ProviderFactory,
|
|
48
|
+
// ADR-077: порт исполнения команд (inline/remote).
|
|
49
|
+
createExecutionPortForConfig,
|
|
50
|
+
// ADR-090 (Ф3а) / §5, §10 (Ф5б-1): общий реестр
|
|
51
|
+
// блоков промпта (композер + фасад плагинов) и рантайм плагинов.
|
|
52
|
+
PromptBlockRegistry, PluginRuntime, PluginProcessManager, PluginFacadeError, createInlinePluginLoader, createRemotePluginLoader, resolvePluginLayout, } from '@itphx/synth-core';
|
|
10
53
|
import { EventHub } from '../events/hub.js';
|
|
11
54
|
import { seedDebugTestUsers } from './bootstrap.js';
|
|
55
|
+
/**
|
|
56
|
+
* ADR-096 (W2.4): единая точка сборки слоя хранения backend — `app.ts` строит
|
|
57
|
+
* её до `auth` (реестр `serviceKeys` нужен резолверу ключа, `mcpRegistry` —
|
|
58
|
+
* сидированию instance-серверов), а `createBackendDeps` переиспользует инстанс.
|
|
59
|
+
*/
|
|
60
|
+
export async function createBackendStorage(config) {
|
|
61
|
+
// ADR-099: единый механизм доверия TLS/CA — применяем **до** первого исходящего
|
|
62
|
+
// запроса (сборка хранилища/PG, дискавери OIDC, сид провайдеров из env ниже).
|
|
63
|
+
// Вызывается в начале `createBackendApp` (env-оверрайды уже выставлены).
|
|
64
|
+
// Fail-closed: битый/отсутствующий CA останавливает старт (не тихий фоллбэк).
|
|
65
|
+
// ADR-099: bootstrap runtime-настройки TLS читаются до подключения к PG и
|
|
66
|
+
// передаются и в initTlsTrust, и драйверу (per-host mTLS по host БД).
|
|
67
|
+
const tlsRuntime = readTlsRuntimeSettings(config.dataDir);
|
|
68
|
+
await initTlsTrust({ security: config.synth.security, proxy: config.synth.proxy }, process.env, { dataDir: config.dataDir, tlsRuntime: tlsRuntime ?? null });
|
|
69
|
+
const kind = resolveStorageBackend(config.synth, process.env);
|
|
70
|
+
if (kind === 'memory') {
|
|
71
|
+
console.warn('storage.backend=memory: данные не сохраняются на диск');
|
|
72
|
+
}
|
|
73
|
+
const storage = await createStorageContextAsync(kind, {
|
|
74
|
+
dataDir: config.dataDir,
|
|
75
|
+
secretKey: resolveSecretKey(config.synth),
|
|
76
|
+
env: process.env,
|
|
77
|
+
postgres: resolvePostgresConfig(config.synth, process.env),
|
|
78
|
+
postgresPassword: resolvePostgresPassword({ dataDir: config.dataDir }, process.env),
|
|
79
|
+
...(config.synth.security?.tls ? { security: { tls: config.synth.security.tls } } : {}),
|
|
80
|
+
...(tlsRuntime ? { tlsRuntime } : {}),
|
|
81
|
+
degradedMode: resolveDegradedMode(config.synth),
|
|
82
|
+
fallbackDir: resolveStorageFallbackDir(config.synth, process.env),
|
|
83
|
+
dedupStore: config.synth.events.dedupStore,
|
|
84
|
+
scheduleCrossProcess: config.synth.scheduler.crossProcessLocks,
|
|
85
|
+
bundlesPath: config.synth.commands.bundlesPath,
|
|
86
|
+
// ADR-090: путь lock-файла плагинов задаёт раскладка (композиционный
|
|
87
|
+
// корень) — `<home>/plugin/plugins.lock.json` либо `{dataDir}/plugin/…`.
|
|
88
|
+
// Резолвер один — `resolvePluginLayout` (его же использует `PluginRuntime`),
|
|
89
|
+
// поэтому порт и каталоги установки согласованы.
|
|
90
|
+
pluginLockPath: resolvePluginLayout({ dataDir: config.dataDir, env: process.env }).lockPath,
|
|
91
|
+
});
|
|
92
|
+
// ADR-099: второй шаг egress — runtime-override прокси после хранилища и до
|
|
93
|
+
// создания deps/провайдеров (TLS/PG уже применены ранним `initTlsTrust`).
|
|
94
|
+
await applyStartupProxyConfig(storage.settings, { proxy: config.synth.proxy }, process.env, { dataDir: config.dataDir });
|
|
95
|
+
return storage;
|
|
96
|
+
}
|
|
12
97
|
/**
|
|
13
98
|
* Собрать зависимости backend-приложения (хранилища/менеджеры/оркестратор/
|
|
14
99
|
* событийное ядро/планировщик/webhooks). Роуты монтирует вызывающий
|
|
15
100
|
* (`mountBackendRoutes`), поэтому здесь нет ни одного `app.*`-вызова.
|
|
16
101
|
*/
|
|
17
|
-
export async function createBackendDeps(config
|
|
102
|
+
export async function createBackendDeps(config, storage, metrics,
|
|
103
|
+
/**
|
|
104
|
+
* ADR-077: эффективная секция `execution` (режим исполнения + параметры
|
|
105
|
+
* удалённого исполнителя). Не задана — резолвится из конфигу инстанса.
|
|
106
|
+
*/
|
|
107
|
+
executionConfig) {
|
|
18
108
|
// Хранилища
|
|
19
109
|
const dataDir = config.dataDir;
|
|
20
110
|
await ensureDataDir(dataDir);
|
|
21
|
-
|
|
22
|
-
|
|
111
|
+
// ADR-091: отложенное восстановление из бэкапа (паритет со standalone-core) —
|
|
112
|
+
// офлайн-операция при старте **до** миграций и до использования стораджей.
|
|
113
|
+
// Fail-closed: невалидный запрос останавливает старт, запрос не удаляется.
|
|
114
|
+
await applyPendingRestore({ dataDir });
|
|
115
|
+
// ADR-092: guard совместимости схемы данных (паритет со standalone-core):
|
|
116
|
+
// данные новее Synth → отказ старта (fail-fast); устаревшая схема → авто-миграции
|
|
117
|
+
// с обязательной страховочной копией ниже (`applyStartupMigrations`).
|
|
118
|
+
await assertInstanceDataNotTooNew(dataDir);
|
|
119
|
+
// ADR-096 (W2.3/W2.4): единый контекст хранения — домен получает порты из
|
|
120
|
+
// одного места. По умолчанию собирается `createBackendStorage`, готовый можно
|
|
121
|
+
// передать (паритет с `app.ts`, где `serviceKeys`/`mcpRegistry` нужны до `auth`).
|
|
122
|
+
const storageContext = storage ?? (await createBackendStorage(config));
|
|
123
|
+
// ADR-098 (W5): деградированное хранилище (postgres недоступен → файловый
|
|
124
|
+
// фоллбек, read-only). Фоновые писатели отключаются (split-brain): миграции,
|
|
125
|
+
// провайдеры из env, шедулер, webhooks, sweeper/ephemeral, retention-прунеры.
|
|
126
|
+
const storageDegraded = storageContext.degraded !== undefined;
|
|
127
|
+
const { settings: settingsStore, defaults: defaultsStore, secretPatterns: patternStore, protectedPaths: protectedPathsStore, sessions: fileStore, projects: projectStore, profiles: profilesStore, sshKeys: sshKeyStore, contextFiles: contextConfig, providers: providerStore, models: modelStore, agents: agentStore, dictionaries: dictionaryStore, serviceKeys: serviceApiKeyStore, webhooks: webhookStore, securityAudit, egressRequests, webhookDeliveries: webhookDeliveryStore, eventBindings: eventBindingStore, eventApiKeys: eventApiKeyStore, eventJournal, eventRoutes: routeRuleStore, identityClaims: identityClaimStore, dedup: dedupStore, schedules: scheduleStore, jobs: jobStore, skillBundles: bundleStore, mcpRegistry: mcpRegistryStore, analyticsRollups,
|
|
128
|
+
// ADR-051/ADR-100: реестр пайплайнов; ADR-086 §5: реестр установок пакетов.
|
|
129
|
+
pipelines: pipelineStore, packs: packStore, } = storageContext;
|
|
130
|
+
// ADR-101: реестр активных прогонов пайплайнов — **один на процесс**.
|
|
131
|
+
// Его получают и HTTP-роут пайплайнов, и встроенные тулы агента: поэтому
|
|
132
|
+
// soft-lock «не запустить второй прогон того же пайплайна» и отмена
|
|
133
|
+
// идущего прогона работают одинаково для обоих контуров.
|
|
134
|
+
const pipelineRunControl = new PipelineRunControl();
|
|
135
|
+
// ADR-101/ADR-051: рантайм автоматизации для встроенных тулов
|
|
136
|
+
// (`pipeline_*`/`schedule_*`). Движок пайплайнов и шедулер создаются
|
|
137
|
+
// **ниже** (после оркестратора), поэтому объект заполняется по мере сборки,
|
|
138
|
+
// а оркестратор получает late-bound геттер (`engine/tools/automation-runtime.ts`).
|
|
139
|
+
const automationRuntime = {
|
|
140
|
+
pipelines: storageContext.projectPipelines,
|
|
141
|
+
runs: storageContext.pipelineRuns,
|
|
142
|
+
runControl: pipelineRunControl,
|
|
143
|
+
templates: pipelineStore,
|
|
144
|
+
schedules: scheduleStore,
|
|
145
|
+
jobs: jobStore,
|
|
146
|
+
};
|
|
23
147
|
// ADR-030: ядровая шина хуков — общий инстанс для SessionManager и оркестратора.
|
|
24
148
|
const hooks = new HookBus();
|
|
149
|
+
// ADR-102: сборщик роллапов аналитики (write-path) — только через порт слоя
|
|
150
|
+
// хранения; в деградации выключен (не пишем домен в файловый фоллбек).
|
|
151
|
+
const analytics = storageDegraded ? undefined : new AnalyticsRecorder({ repo: analyticsRollups });
|
|
25
152
|
const sessionManager = new SessionManager(fileStore, {
|
|
26
153
|
projectStore,
|
|
27
154
|
hooks,
|
|
155
|
+
// ADR-102: точка персиста сообщений (`messages_assistant`/`messages_tool`).
|
|
156
|
+
analytics,
|
|
28
157
|
// ADR-071 §2.4 / ADR-046 §4.5: системные дефолты для сессий без проекта.
|
|
29
158
|
systemDefaultsProvider: async () => ({
|
|
30
159
|
mcpDefaultOn: await mcpRegistryStore.toDefaultServers(),
|
|
@@ -33,23 +162,22 @@ export async function createBackendDeps(config) {
|
|
|
33
162
|
});
|
|
34
163
|
// ADR-089: авто-архивация ephemeral-сессий по TTL (таймер `unref`).
|
|
35
164
|
// Остановка — через хэндл `stopEphemeralSweeper` на graceful shutdown.
|
|
36
|
-
const stopEphemeralSweeper = startEphemeralSweeper(sessionManager);
|
|
37
|
-
// ADR-
|
|
38
|
-
//
|
|
39
|
-
const
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
const
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
//
|
|
52
|
-
const settingsStore = new RuntimeSettingsStore({ dataDir });
|
|
165
|
+
const stopEphemeralSweeper = storageDegraded ? () => { } : startEphemeralSweeper(sessionManager);
|
|
166
|
+
// ADR-102: шов записи `activity` через hook-шину (ADR-030) + retention суточных
|
|
167
|
+
// роллапов (prune на старте и каждые 6 ч, таймер `unref`).
|
|
168
|
+
const detachAnalyticsHooks = analytics
|
|
169
|
+
? attachAnalyticsActivityHooks(hooks, {
|
|
170
|
+
recorder: analytics,
|
|
171
|
+
resolveSessionAxes: async (sessionId) => sessionAxes(await sessionManager.getSession(sessionId)),
|
|
172
|
+
})
|
|
173
|
+
: () => { };
|
|
174
|
+
const stopAnalyticsRollupPruner = storageDegraded || !analytics
|
|
175
|
+
? () => { }
|
|
176
|
+
: startAnalyticsRollupPruner(analyticsRollups, {
|
|
177
|
+
getRetentionDays: () => config.synth.analytics.retentionDays,
|
|
178
|
+
});
|
|
179
|
+
// ADR-036/ADR-005: паттерны секретов и runtime-настройки («workspace/mcp»,
|
|
180
|
+
// умолчания оформления) — из контекста хранения (собраны выше).
|
|
53
181
|
// ADR-075: дефолтный рабочий каталог — runtime-override `settings/workspace`
|
|
54
182
|
// приоритетнее config/env (`resolveDefaultWorkspace`), каталог создаётся
|
|
55
183
|
// заранее (как в core `server/app.ts`), чтобы инструменты не падали.
|
|
@@ -58,13 +186,10 @@ export async function createBackendDeps(config) {
|
|
|
58
186
|
await mkdir(defaultWorkingDir, { recursive: true });
|
|
59
187
|
// Агент по умолчанию (админка «Агенты»): runtime-настройка поверх DEFAULT_AGENT_ID.
|
|
60
188
|
const getDefaultAgentId = async () => (await settingsStore.getDefaultAgent()) ?? DEFAULT_AGENT_ID;
|
|
61
|
-
// Умолчания оформления (ADR-005): {dataDir}/defaults.json (переживают рестарт)
|
|
62
|
-
const defaultsStore = new DefaultsStore({ dataDir });
|
|
63
189
|
// MCP: единый источник истины — реестр `McpRegistryStore` (ADR-071 §2.5).
|
|
64
190
|
// Legacy `YamlMcpConfigStore` удалён: instance-серверы из config.mcp.servers
|
|
65
191
|
// сидируются в реестр при старте (seed без дублирования по имени).
|
|
66
192
|
const mcpManager = new McpManager();
|
|
67
|
-
const mcpRegistryStore = new McpRegistryStore({ dataDir });
|
|
68
193
|
await mcpRegistryStore.seedFromConfig(config.synth.mcp.servers);
|
|
69
194
|
// Одно чтение реестра на все карты менеджера (вместо пяти).
|
|
70
195
|
const mcpMaps = await mcpRegistryStore.toManagerMaps();
|
|
@@ -75,42 +200,236 @@ export async function createBackendDeps(config) {
|
|
|
75
200
|
mcpManager.setDefaultServers(mcpMaps.defaults);
|
|
76
201
|
// ADR-071 §2.4: системный мастер-флаг серверов (реестр `enabled`).
|
|
77
202
|
mcpManager.setServerSystemEnabled(mcpMaps.systemEnabled);
|
|
78
|
-
//
|
|
79
|
-
//
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
203
|
+
// Egress: живой резолвер политики (settings.json → config.yaml → дефолт) и
|
|
204
|
+
// журнал внешних запросов. Резолвер читает стор на каждый запрос (live).
|
|
205
|
+
const egressResolver = createEgressPolicyResolver(settingsStore, {
|
|
206
|
+
tools: config.synth.egress.tools,
|
|
207
|
+
webhooks: config.synth.egress.webhooks,
|
|
208
|
+
mcp: config.synth.mcp.networkPolicy,
|
|
209
|
+
});
|
|
210
|
+
const egressLogConfig = config.synth.egress.log;
|
|
211
|
+
const egressLog = createEgressLogSink(egressRequests, { enabled: () => egressLogConfig.enabled });
|
|
212
|
+
configureEgressRuntime({ resolver: egressResolver, log: egressLog });
|
|
213
|
+
// ADR-115: живое состояние настроек вложений. Приоритет env > runtime
|
|
214
|
+
// (`settings.json`/PG) > config.yaml > defaults; мутации — админ-API
|
|
215
|
+
// `/api/v2/settings/attachments`. Резолвер синхронный: сервис вложений,
|
|
216
|
+
// промпт и GC читают его на каждый вызов (применение без рестарта).
|
|
217
|
+
const attachmentsSettings = createLiveAttachmentsSettings({
|
|
218
|
+
config: config.synth.attachments,
|
|
219
|
+
runtime: await settingsStore.getAttachments(),
|
|
220
|
+
});
|
|
221
|
+
const stopEgressLogPruner = storageDegraded || !egressLogConfig.enabled
|
|
222
|
+
? () => { }
|
|
223
|
+
: startEgressLogPruner(egressRequests, { getRetentionDays: () => egressLogConfig.retentionDays });
|
|
224
|
+
// ADR-071 §2.3.1: политика сетевого доступа HTTP-серверов (SSRF/egress)
|
|
225
|
+
// резолвится при каждом connect/probe (live; без стартового снимка).
|
|
226
|
+
mcpManager.setNetworkPolicyResolver(() => egressResolver.resolveMcp());
|
|
227
|
+
// ADR-105 (Ф3): коннекторы с `auth.kind='credential'` авторизуются токеном
|
|
228
|
+
// из слоя доступов (подстановка в транспорт, refresh при 401).
|
|
229
|
+
const oauthProviders = new OAuthProviderRegistry();
|
|
230
|
+
// Каталог OAuth-провайдеров из конфига инстанса (`oauth.providers`): без него
|
|
231
|
+
// refresh живого доступа не работает — провайдера не найти.
|
|
232
|
+
await registerOAuthProvidersFromConfig(oauthProviders, config.synth.oauth.providers, {
|
|
233
|
+
dataDir,
|
|
234
|
+
});
|
|
235
|
+
const oauthCredentialService = new OAuthCredentialService({
|
|
236
|
+
repo: storageContext.externalCredentials,
|
|
237
|
+
clientFor: (provider) => oauthProviders.clientFor(provider),
|
|
238
|
+
// ADR-105 (Ф4): журнал операций со слоем доступов (append-only).
|
|
239
|
+
audit: storageContext.credentialAudit,
|
|
240
|
+
});
|
|
241
|
+
mcpManager.setCredentialSource(createRepositoryCredentialSource({
|
|
242
|
+
repo: storageContext.externalCredentials,
|
|
243
|
+
refresh: async (credentialId) => {
|
|
244
|
+
await oauthCredentialService.refresh(credentialId);
|
|
245
|
+
},
|
|
246
|
+
// ADR-105 (Ф4): подстановка токена в транспорт журналируется (`use`).
|
|
247
|
+
audit: storageContext.credentialAudit,
|
|
248
|
+
}));
|
|
86
249
|
// Сидирование тестовых пользователей (debug mode) — до построения рантайма
|
|
87
250
|
// (паритет с прежним `app.ts`: сид стоял между хранилищами и рантаймом).
|
|
88
251
|
seedDebugTestUsers(profilesStore, config.auth);
|
|
89
252
|
const eventBus = new EventBus();
|
|
90
253
|
const queueManager = new QueueProcessorManager();
|
|
254
|
+
// ADR-102: пользовательские сообщения персистит процессор — мера `messages_user`.
|
|
255
|
+
queueManager.setAnalytics(analytics);
|
|
256
|
+
// Этап 1 roadmap 0.13 (блок 3): сервис «вопрос пользователю» (`ask_user`).
|
|
257
|
+
//
|
|
258
|
+
// Паритет с standalone-core: тот же порт записи (ADR-096), тот же срок
|
|
259
|
+
// ожидания ответа из конфигурации `questions.timeoutMs` (`0` — без
|
|
260
|
+
// таймаута). Один инстанс на процесс: его получают и оркестратор (тул
|
|
261
|
+
// `question`), и HTTP-роуты сессий.
|
|
262
|
+
const questionService = storageDegraded
|
|
263
|
+
? undefined
|
|
264
|
+
: new QuestionService({
|
|
265
|
+
repository: storageContext.questions,
|
|
266
|
+
eventBus,
|
|
267
|
+
timeoutMs: config.synth.questions.timeoutMs,
|
|
268
|
+
});
|
|
269
|
+
// Старт: открытые вопросы прошлого процесса не пережили рестарт (ожидание
|
|
270
|
+
// в памяти) — снимаем их с причиной `interrupted`. Best-effort: ошибка не
|
|
271
|
+
// роняет старт.
|
|
272
|
+
if (questionService) {
|
|
273
|
+
try {
|
|
274
|
+
await questionService.recoverOnStart();
|
|
275
|
+
}
|
|
276
|
+
catch (err) {
|
|
277
|
+
console.warn(`[questions] восстановление открытых вопросов не удалось: ${err instanceof Error ? err.message : String(err)}`);
|
|
278
|
+
}
|
|
279
|
+
}
|
|
280
|
+
// Retention-очистка терминальных записей вопросов (сразу + каждые 6 ч).
|
|
281
|
+
const stopQuestionPruner = storageDegraded
|
|
282
|
+
? () => { }
|
|
283
|
+
: startQuestionPruner(storageContext.questions, {
|
|
284
|
+
getRetentionDays: () => config.synth.questions.retentionDays,
|
|
285
|
+
});
|
|
286
|
+
// Этап 1 roadmap 0.13 (блок 4): единый реестр фоновых прогонов (PROP-096).
|
|
287
|
+
//
|
|
288
|
+
// Паритет с standalone-core: тот же порт записи (ADR-096), те же лимиты из
|
|
289
|
+
// конфигурации `background.*`. Один инстанс на процесс: его получают тул
|
|
290
|
+
// `task` (фоновый запуск саб-агента) и HTTP-точки обслуживания реестра.
|
|
291
|
+
//
|
|
292
|
+
// Уведомление родителя о завершении фонового прогона (ADR-111): ОДИН путь —
|
|
293
|
+
// постановка в очередь (`enqueueUserMessage`); процессор добавит сообщение в
|
|
294
|
+
// историю сам и опубликует `message.added` (двух копий больше нет).
|
|
295
|
+
// `processMessage` собирается ниже (после оркестратора) — нотификатор
|
|
296
|
+
// создаётся лениво, при первом вызове колбэка (он приходит только из
|
|
297
|
+
// фонового прогона, т.е. уже после старта).
|
|
298
|
+
let backgroundNotifier = null;
|
|
299
|
+
const notifyBackgroundParent = async (sessionId, message) => {
|
|
300
|
+
backgroundNotifier ??= createBackgroundParentNotifier({
|
|
301
|
+
sessionManager,
|
|
302
|
+
eventBus,
|
|
303
|
+
processorManager: queueManager,
|
|
304
|
+
processMessage,
|
|
305
|
+
});
|
|
306
|
+
await backgroundNotifier(sessionId, message);
|
|
307
|
+
};
|
|
308
|
+
const backgroundService = storageDegraded
|
|
309
|
+
? undefined
|
|
310
|
+
: new BackgroundRunService({
|
|
311
|
+
repository: storageContext.backgroundRuns,
|
|
312
|
+
eventBus,
|
|
313
|
+
limits: {
|
|
314
|
+
maxSubagentsPerSession: config.synth.background.maxSubagentsPerSession,
|
|
315
|
+
// PROP-097: лимит одновременных фоновых шелл-процессов на сессию.
|
|
316
|
+
maxProcessesPerSession: config.synth.background.maxProcessesPerSession,
|
|
317
|
+
maxRunsPerSession: config.synth.background.maxRunsPerSession,
|
|
318
|
+
},
|
|
319
|
+
// Точка сборки уведомления — здесь (глобальных синглтонов нет).
|
|
320
|
+
//
|
|
321
|
+
// ADR-036: обфускация user-сообщений НЕ применяется — уведомление
|
|
322
|
+
// системное (автор `Subagent`/`Process`), а не пользовательский ввод;
|
|
323
|
+
// секреты в исходящих LLM-запросах обфусцирует сам Gateway.
|
|
324
|
+
onNotifyParent: notifyBackgroundParent,
|
|
325
|
+
});
|
|
326
|
+
// Старт: прогоны прошлого процесса не пережили рестарт (хэндлы отмены — в
|
|
327
|
+
// памяти) — помечаем их `orphaned`. Best-effort: ошибка не роняет старт.
|
|
328
|
+
if (backgroundService) {
|
|
329
|
+
try {
|
|
330
|
+
await backgroundService.recoverOnStart();
|
|
331
|
+
}
|
|
332
|
+
catch (err) {
|
|
333
|
+
console.warn(`[background] восстановление фоновых прогонов не удалось: ${err instanceof Error ? err.message : String(err)}`);
|
|
334
|
+
}
|
|
335
|
+
}
|
|
336
|
+
// Retention-очистка терминальных записей реестра (сразу + каждые 6 ч).
|
|
337
|
+
const stopBackgroundRunPruner = storageDegraded
|
|
338
|
+
? () => { }
|
|
339
|
+
: startBackgroundRunPruner(storageContext.backgroundRuns, {
|
|
340
|
+
getRetentionDays: () => config.synth.background.retentionDays,
|
|
341
|
+
});
|
|
342
|
+
// PROP-097 (блок 5b): retention логов фоновых процессов. Создаётся **до**
|
|
343
|
+
// pruner'а записей реестра: лог удаляется, пока его запись ещё видна.
|
|
344
|
+
const stopProcessLogPruner = storageDegraded
|
|
345
|
+
? () => { }
|
|
346
|
+
: startProcessLogPruner(storageContext.backgroundRuns, storageContext.blobs, {
|
|
347
|
+
getRetentionDays: () => config.synth.background.retentionDays,
|
|
348
|
+
});
|
|
349
|
+
// ADR-094/ADR-115: метрики вложений (`synth_attachment_*`) — создаются до GC,
|
|
350
|
+
// чтобы счётчик удалённых объектов был доступен при первом прогоне.
|
|
351
|
+
const attachmentMetrics = metrics ? createAttachmentMetrics(metrics) : undefined;
|
|
352
|
+
// ADR-115: GC осиротевших вложений (нет ссылок `blob_refs` + объект старше
|
|
353
|
+
// `attachments.gcDays`; `<= 0` — без ограничения).
|
|
354
|
+
const stopAttachmentPruner = storageDegraded
|
|
355
|
+
? () => { }
|
|
356
|
+
: startAttachmentPruner({
|
|
357
|
+
blobs: storageContext.blobs,
|
|
358
|
+
blobRefs: storageContext.blobRefs,
|
|
359
|
+
gcDays: () => attachmentsSettings.getConfig().gcDays,
|
|
360
|
+
...(attachmentMetrics ? { metrics: attachmentMetrics } : {}),
|
|
361
|
+
});
|
|
362
|
+
// ADR-094: доменные коллекторы. `metrics` приходит только при
|
|
363
|
+
// `metrics.enabled=true` — иначе реестр остаётся пустым (`/metrics` → 404).
|
|
364
|
+
// Фоновые таймеры `unref`-ятся; остановка — `stopMetricsCollectors` на
|
|
365
|
+
// graceful shutdown (`app.ts`/`main.ts`).
|
|
366
|
+
const stopMetricsCollectors = [];
|
|
367
|
+
// ADR-094: доменные хуки (колбэки сервисов) — создаются только при включённых метриках.
|
|
368
|
+
const schedulerJobMetrics = metrics ? createSchedulerMetrics(metrics) : undefined;
|
|
369
|
+
const webhookDeliveryMetrics = metrics ? createWebhookMetrics(metrics) : undefined;
|
|
370
|
+
const eventMetrics = metrics ? createEventMetrics(metrics) : undefined;
|
|
371
|
+
// ADR-106 Ф1: решения Authority-слоя (`synth_authority_decisions_total`) —
|
|
372
|
+
// лейблы только `action`/`effect`/`source`, без id (ADR-094).
|
|
373
|
+
const authorityMetrics = metrics ? createAuthorityMetrics(metrics) : undefined;
|
|
374
|
+
if (metrics) {
|
|
375
|
+
// ADR-115: сервис вложений собирается внутри фабрики роутов сессий, куда
|
|
376
|
+
// метрики не прокинуть — ставим хуки в sink коллектора (снимается на stop).
|
|
377
|
+
stopMetricsCollectors.push(setAttachmentMetricsHook(attachmentMetrics ?? null));
|
|
378
|
+
stopMetricsCollectors.push(attachBusMetrics(metrics, eventBus));
|
|
379
|
+
stopMetricsCollectors.push(startSessionMetrics(metrics, sessionManager));
|
|
380
|
+
stopMetricsCollectors.push(startStorageMetrics(metrics, {
|
|
381
|
+
sessions: fileStore,
|
|
382
|
+
projects: projectStore,
|
|
383
|
+
providers: providerStore,
|
|
384
|
+
models: modelStore,
|
|
385
|
+
agents: agentStore,
|
|
386
|
+
webhooks: webhookStore,
|
|
387
|
+
schedules: scheduleStore,
|
|
388
|
+
eventBindings: eventBindingStore,
|
|
389
|
+
eventRoutes: routeRuleStore,
|
|
390
|
+
dataDir,
|
|
391
|
+
backend: storageContext.kind,
|
|
392
|
+
degraded: () => Boolean(storageContext.degraded),
|
|
393
|
+
}));
|
|
394
|
+
stopMetricsCollectors.push(registerDecisionMetrics(metrics));
|
|
395
|
+
// ADR-094: размер журнала внешних событий (фон, раз в 5 минут).
|
|
396
|
+
stopMetricsCollectors.push(startEventJournalMetrics(metrics, eventJournal));
|
|
397
|
+
// ADR-094/PROP-047: метрики памяти (`synth_memory_*`) — пересчёт на скрейпе.
|
|
398
|
+
stopMetricsCollectors.push(startMemoryMetrics(metrics, {
|
|
399
|
+
facts: storageContext.memoryFacts,
|
|
400
|
+
indexes: storageContext.memoryIndexes,
|
|
401
|
+
}));
|
|
402
|
+
}
|
|
403
|
+
// ADR-107: телеметрия памяти — блоки памяти в промпте хода и recall-запросы
|
|
404
|
+
// плагина памяти. Метрики выключены — телеметрии нет (плагин и ход работают
|
|
405
|
+
// как раньше).
|
|
406
|
+
const memoryTelemetry = metrics ? createMemoryTelemetry(metrics) : undefined;
|
|
91
407
|
// ADR-052 (этап II): исходящие webhooks — реестр подписок (signing-секрет
|
|
92
408
|
// `whsec_…` шифруется at-rest мастер-ключом), append-only журнал доставок и
|
|
93
409
|
// движок над той же шиной `EventBus`, что обслуживает сессии/SSE. Движок
|
|
94
410
|
// подписывается на ВСЕ события шины (`subscribeAll`) — паритет с core
|
|
95
411
|
// `server/app.ts`; `webhooks.enabled: false` (дефолт) глушит диспетчеризацию.
|
|
96
412
|
const webhooksConfig = config.synth.webhooks;
|
|
97
|
-
const webhookStore = new WebhookStore({
|
|
98
|
-
dataDir: config.dataDir,
|
|
99
|
-
secretKey: resolveSecretKey(config.synth),
|
|
100
|
-
env: process.env,
|
|
101
|
-
});
|
|
102
|
-
const webhookDeliveryStore = new WebhookDeliveryStore({ dataDir: config.dataDir });
|
|
103
413
|
const webhookService = new WebhookService({
|
|
104
414
|
store: webhookStore,
|
|
105
415
|
deliveryStore: webhookDeliveryStore,
|
|
106
416
|
eventBus,
|
|
107
|
-
|
|
417
|
+
// ADR-094: исходящие доставки (ok/error/blocked + retries/duration).
|
|
418
|
+
onDelivery: webhookDeliveryMetrics,
|
|
419
|
+
config: {
|
|
420
|
+
...webhooksConfig,
|
|
421
|
+
// Отдельный экземпляр политики (граница доверия не смешивается с tools).
|
|
422
|
+
resolvePolicy: () => egressResolver.resolveWebhooks(),
|
|
423
|
+
},
|
|
108
424
|
});
|
|
109
|
-
|
|
425
|
+
if (!storageDegraded)
|
|
426
|
+
webhookService.start();
|
|
110
427
|
// Retention-очистка журнала доставок: сразу при старте + каждые 6 ч (unref).
|
|
111
|
-
const stopWebhookDeliveryPruner =
|
|
112
|
-
|
|
113
|
-
|
|
428
|
+
const stopWebhookDeliveryPruner = storageDegraded
|
|
429
|
+
? () => { }
|
|
430
|
+
: startWebhookDeliveryPruner(webhookDeliveryStore, {
|
|
431
|
+
getRetentionDays: () => webhooksConfig.deliveryRetentionDays,
|
|
432
|
+
});
|
|
114
433
|
// Context builder
|
|
115
434
|
const contextBuilder = new ContextBuilder(contextConfig, {
|
|
116
435
|
profilesStore,
|
|
@@ -126,7 +445,9 @@ export async function createBackendDeps(config) {
|
|
|
126
445
|
// ADR-038: синхронизация провайдеров/моделей из переменных окружения (общая
|
|
127
446
|
// core-реализация). Вызывается ПОСЛЕ создания providerStore/modelStore, но ДО
|
|
128
447
|
// заполнения кэшей, чтобы env-провайдеры попали в providerCache/modelCache.
|
|
129
|
-
|
|
448
|
+
// ADR-098 (W5): в деградации не пишем в фоллбек.
|
|
449
|
+
if (!storageDegraded)
|
|
450
|
+
await syncProvidersFromEnv(providerStore, modelStore);
|
|
130
451
|
// Кеш провайдеров (заполняется при старте)
|
|
131
452
|
const providerCache = new Map();
|
|
132
453
|
(await providerStore.list()).forEach((p) => {
|
|
@@ -211,23 +532,37 @@ export async function createBackendDeps(config) {
|
|
|
211
532
|
// (микро-каскад, роутер, события ADR-089) через `live.setDecision`.
|
|
212
533
|
const runtimeDecision = await settingsStore.getDecision();
|
|
213
534
|
let effectiveDecisionSettings = mergeDecisionConfig(config.synth.decision, runtimeDecision);
|
|
214
|
-
const protectedPathsStore = new ProtectedPathsStore({ dataDir });
|
|
215
535
|
// Orchestrator
|
|
216
536
|
const toolRegistry = createToolRegistry();
|
|
217
537
|
const agentRegistry = createAgentRegistry(toolRegistry, join(dataDir, 'agents'));
|
|
538
|
+
// ADR-090 (Ф3а): **один** реестр провайдеров блоков
|
|
539
|
+
// системного промпта на инстанс — композер добавляет блоки в промпт сессии,
|
|
540
|
+
// фасад плагинов (`PluginRuntime` → `PluginHost`) их регистрирует.
|
|
541
|
+
const promptBlocks = new PromptBlockRegistry();
|
|
542
|
+
// ADR-096 + ADR-086 §5: агенты из **стора** — в реестр при старте.
|
|
543
|
+
// `createAgentRegistry` читает только файловый каталог `{dataDir}/agents`,
|
|
544
|
+
// а при `storage.backend=postgres` стор агентов — это БД: агент, поставленный
|
|
545
|
+
// пакетом расширения, после рестарта не попадал в реестр → Router не
|
|
546
|
+
// резолвил `agentTemplate` (`resolveAgentTemplate` → `null`) и сессия не
|
|
547
|
+
// создавалась. Merge — как в `GET /api/v2/agents` (override выигрывает).
|
|
548
|
+
try {
|
|
549
|
+
registerStoredAgents(agentRegistry, await agentStore.list());
|
|
550
|
+
}
|
|
551
|
+
catch (err) {
|
|
552
|
+
console.warn(`[agents] не удалось загрузить агентов из стора: ${err instanceof Error ? err.message : String(err)}`);
|
|
553
|
+
}
|
|
218
554
|
// ADR-046: сервис скиллов (discovery + instance-запись + каталог промпта).
|
|
555
|
+
// ADR-116: instance-скиллы — порт слоя хранения (`storageContext.skills`):
|
|
556
|
+
// при `storage.backend=postgres` это метаданные в SQL + содержимое в blobs.
|
|
219
557
|
const skillService = new SkillService({
|
|
220
558
|
dataDir,
|
|
559
|
+
store: storageContext.skills,
|
|
221
560
|
configPaths: config.synth.skills.paths,
|
|
222
561
|
urls: config.synth.skills.urls,
|
|
223
562
|
trustedProjectDirs: config.synth.skills.trustedProjectDirs,
|
|
224
563
|
toolsets: config.synth.skills.toolsets,
|
|
225
564
|
});
|
|
226
565
|
// ADR-046 §7: slash-команды и bundles (mirror core).
|
|
227
|
-
const bundleStore = new SkillBundleStore({
|
|
228
|
-
dataDir,
|
|
229
|
-
bundlesPath: config.synth.commands.bundlesPath,
|
|
230
|
-
});
|
|
231
566
|
const commandService = new CommandService({
|
|
232
567
|
config: {
|
|
233
568
|
dataDir,
|
|
@@ -244,10 +579,148 @@ export async function createBackendDeps(config) {
|
|
|
244
579
|
skillSource: skillService,
|
|
245
580
|
bundleStore,
|
|
246
581
|
});
|
|
582
|
+
// ADR-077: порт исполнения команд. Режим (`inline`/`remote`) — параметр
|
|
583
|
+
// запуска процесса (инвариант 24), поэтому порт собирается здесь, при старте.
|
|
584
|
+
// Тот же порт получают оркестратор (тулы, inline-shell, детект зависимостей)
|
|
585
|
+
// и резолвер проектных инструкций.
|
|
586
|
+
const execution = executionConfig ?? resolveExecutionConfig(config.synth, process.env);
|
|
587
|
+
// ADR-094/ADR-077: метрики пула исполнителей (`synth_executor_*`) — приёмник
|
|
588
|
+
// для клиента удалённого порта (очередь, занятость, ожидание, исход).
|
|
589
|
+
const executorMetrics = metrics ? createExecutorMetricsCollector(metrics) : undefined;
|
|
590
|
+
const executionPort = await createExecutionPortForConfig(execution, executorMetrics ? { metricsSink: executorMetrics } : undefined);
|
|
591
|
+
// PROP-097 (блок 5b): сервис фоновых шелл-процессов (паритет с standalone).
|
|
592
|
+
//
|
|
593
|
+
// Тот же порт исполнения, что у тулов (ADR-077): фон — это лишь способ
|
|
594
|
+
// ожидания, а не отдельный путь исполнения. Учёт прогона — общий реестр
|
|
595
|
+
// фоновых прогонов (`kind: 'process'`), лог — blob-хранилище (ADR-096).
|
|
596
|
+
// В деградированном режиме хранилища сервиса нет (писать некуда).
|
|
597
|
+
const processService = backgroundService
|
|
598
|
+
? new ProcessService({
|
|
599
|
+
executionPort,
|
|
600
|
+
background: backgroundService,
|
|
601
|
+
blobs: storageContext.blobs,
|
|
602
|
+
eventBus,
|
|
603
|
+
limits: { maxLogBytes: config.synth.background.logMaxBytes },
|
|
604
|
+
})
|
|
605
|
+
: undefined;
|
|
606
|
+
// ADR-114: сервис worktree'ов (per-session рабочий каталог).
|
|
607
|
+
//
|
|
608
|
+
// Один инстанс на процесс: его получают HTTP-роуты проектов
|
|
609
|
+
// (`/projects/:id/worktrees*`), тулы `git_worktree_*` и привязка сессии
|
|
610
|
+
// (`PATCH /sessions/:id { worktreeId }`). Порт инвентаря — из контекста
|
|
611
|
+
// хранения (ADR-096); git-команды — через порт исполнения (ADR-077);
|
|
612
|
+
// `onUpdated` публикует `worktree.updated` в каналы сессий проекта
|
|
613
|
+
// (ADR-114 §6, ADR-024). В деградированном режиме хранилища сервиса нет
|
|
614
|
+
// (писать некуда — split-brain).
|
|
615
|
+
const worktreeService = storageDegraded
|
|
616
|
+
? undefined
|
|
617
|
+
: new WorktreeService({
|
|
618
|
+
repository: storageContext.worktrees,
|
|
619
|
+
workspacesRoot: config.workspacesRoot,
|
|
620
|
+
execution: executionPort,
|
|
621
|
+
defaultWorkingDir,
|
|
622
|
+
// Привязанная живая сессия — по полю `session.worktree` (ADR-114 §1.3).
|
|
623
|
+
resolveAttachedSession: async (worktreeId) => {
|
|
624
|
+
const sessions = await sessionManager.listSessions(undefined, { light: true });
|
|
625
|
+
return sessions.find((s) => s.worktree?.worktreeId === worktreeId)?.id;
|
|
626
|
+
},
|
|
627
|
+
onUpdated: (projectId, detail) => {
|
|
628
|
+
void publishWorktreeUpdated({ eventBus, sessionStore: sessionManager }, {
|
|
629
|
+
projectId,
|
|
630
|
+
...(detail.worktreeId !== undefined ? { worktreeId: detail.worktreeId } : {}),
|
|
631
|
+
action: detail.action,
|
|
632
|
+
});
|
|
633
|
+
},
|
|
634
|
+
});
|
|
635
|
+
// ADR-114 §7.4: sweep осиротевших записей worktree'ов при старте процесса
|
|
636
|
+
// (записи без каталога — их чистит и prune проекта, §7.3). Фоново: старт
|
|
637
|
+
// **не блокируется**, ошибка — в лог, процесс продолжает жить. В деградированном
|
|
638
|
+
// режиме хранилища сервиса нет — вычищать нечего.
|
|
639
|
+
if (worktreeService)
|
|
640
|
+
startWorktreeSweeper(worktreeService);
|
|
641
|
+
// ADR-070 §2.9.1/ADR-101: зависимости окружения (git/rg/sh) — детекция при
|
|
642
|
+
// старте, fail-open при ошибке. Общий для оркестратора и движка пайплайнов
|
|
643
|
+
// (контекст шага, ADR-101 §10).
|
|
644
|
+
//
|
|
645
|
+
// ADR-077: проба бинарников идёт **через порт исполнения** — в split-режиме
|
|
646
|
+
// они ищутся в окружении исполнителя. Порт передаётся здесь: кэш детекции
|
|
647
|
+
// модульный, порт берётся из первого вызова (fail-closed в remote-режиме).
|
|
648
|
+
const runtimeDeps = await detectRuntimeDeps(executionPort);
|
|
649
|
+
// ADR-106 Ф1/Ф2: Authority-слой. Решение считается и пишется в журнал
|
|
650
|
+
// (`{dataDir}/audit/authority.jsonl` через порт). При `authority.enabled`
|
|
651
|
+
// **без** `authority.shadow` решение **применяется** (Ф2): `deny`/`ask`
|
|
652
|
+
// сужают решение permission-слоя. Секция `authority` выключена по умолчанию:
|
|
653
|
+
// слой считает решения только когда его явно включили.
|
|
654
|
+
const authorityPolicy = (await storageContext.authorityPolicy?.getPolicy()) ?? null;
|
|
655
|
+
const authorityGuard = config.synth.authority?.enabled
|
|
656
|
+
? new AuthorityGuard({
|
|
657
|
+
enabled: true,
|
|
658
|
+
shadow: config.synth.authority.shadow,
|
|
659
|
+
journal: storageContext.authorityDecisions,
|
|
660
|
+
policy: authorityPolicy,
|
|
661
|
+
// ADR-094: счётчик решений Authority-слоя (`synth_authority_decisions_total`).
|
|
662
|
+
onDecision: authorityMetrics?.onDecision,
|
|
663
|
+
})
|
|
664
|
+
: undefined;
|
|
665
|
+
// ADR-106 Ф3: реестр подтверждений. Задаётся **только** в enforced-режиме
|
|
666
|
+
// (слой Authority применяет решения): ответ на `permission_reply` принимает
|
|
667
|
+
// лишь носитель покрывающего гранта — не «кто видит сессию» (дыра
|
|
668
|
+
// «`VIEWER` подтверждает мутирующий тул»).
|
|
669
|
+
const approvalRegistry = authorityGuard?.enforced
|
|
670
|
+
? new ApprovalRegistry({
|
|
671
|
+
coverage: createApprovalCoverageResolver({
|
|
672
|
+
policy: authorityPolicy,
|
|
673
|
+
profile: async (sessionId, principal) => {
|
|
674
|
+
const session = await sessionManager.getSession(sessionId);
|
|
675
|
+
const project = session?.projectId
|
|
676
|
+
? await projectStore.load(session.projectId)
|
|
677
|
+
: null;
|
|
678
|
+
return buildApprovalResponderProfile({
|
|
679
|
+
principal,
|
|
680
|
+
sources: { session, project },
|
|
681
|
+
});
|
|
682
|
+
},
|
|
683
|
+
}),
|
|
684
|
+
})
|
|
685
|
+
: undefined;
|
|
686
|
+
/**
|
|
687
|
+
* ADR-115: модальности модели — только из её конфига (каталог провайдера при
|
|
688
|
+
* синхронизации моделей либо ручной override). Справочника модальностей в
|
|
689
|
+
* ядре нет (решение 2026-10-27): не нашли — `undefined`, и гидратация
|
|
690
|
+
* вложений их не фильтрует (ошибку модальности вернёт провайдер).
|
|
691
|
+
*
|
|
692
|
+
* Один резолвер на инстанс: тот же нужен шагам пайплайна (ADR-115 × ADR-101),
|
|
693
|
+
* иначе сессии и прогоны разошлись бы по фильтру модальностей.
|
|
694
|
+
*/
|
|
695
|
+
const resolveModelModalities = (providerName, modelId) => {
|
|
696
|
+
const direct = modelCache.get(`${providerName}/${modelId}`) ?? modelCache.get(modelId);
|
|
697
|
+
if (direct?.modalities?.length)
|
|
698
|
+
return direct.modalities;
|
|
699
|
+
let prefixMatch;
|
|
700
|
+
for (const model of modelCache.values()) {
|
|
701
|
+
if (model.provider !== providerName || !model.modalities?.length)
|
|
702
|
+
continue;
|
|
703
|
+
if (model.name === modelId)
|
|
704
|
+
return model.modalities;
|
|
705
|
+
// В сессии имя может нести суффикс (например, `-1017`).
|
|
706
|
+
if (!prefixMatch && modelId.startsWith(model.name))
|
|
707
|
+
prefixMatch = model.modalities;
|
|
708
|
+
}
|
|
709
|
+
return prefixMatch;
|
|
710
|
+
};
|
|
247
711
|
const orchestrator = new ChatOrchestrator({
|
|
248
712
|
sessionManager,
|
|
249
713
|
eventBus,
|
|
250
714
|
hooks,
|
|
715
|
+
// ADR-106 Ф1/Ф2: шов решения Authority-слоя (считает, журналит и —
|
|
716
|
+
// в enforced-режиме — применяет решение).
|
|
717
|
+
authorityGate: authorityGuard?.gate,
|
|
718
|
+
// ADR-106 Ф3: реестр подтверждений (привязка к ходу + носитель гранта).
|
|
719
|
+
...(approvalRegistry ? { approvalRegistry } : {}),
|
|
720
|
+
// ADR-077: порт исполнения команд (inline — исполнение в процессе).
|
|
721
|
+
executionPort,
|
|
722
|
+
// ADR-102: сборщик `usage`/`decision` роллапов (write-path).
|
|
723
|
+
analytics,
|
|
251
724
|
contextBuilder,
|
|
252
725
|
contextConfig,
|
|
253
726
|
providerLoader,
|
|
@@ -256,12 +729,33 @@ export async function createBackendDeps(config) {
|
|
|
256
729
|
dataDir,
|
|
257
730
|
toolRegistry,
|
|
258
731
|
agentRegistry,
|
|
732
|
+
// ADR-090: тот же реестр, что у фасада плагинов
|
|
733
|
+
// (ниже, `PluginRuntime`) — блоки плагинов попадают в промпт сессии.
|
|
734
|
+
promptBlocks,
|
|
259
735
|
mcpManager,
|
|
260
736
|
projectStore,
|
|
261
737
|
// Онбординг: тул `profile_update` сохраняет ответы интервью в профиль.
|
|
262
738
|
profilesStore,
|
|
263
739
|
// ADR-076 §T6: тот же store, что у git/ssh-роутов — без дублей инстансов.
|
|
264
740
|
sshKeyStore,
|
|
741
|
+
// ADR-096 (W2.4): словари классификации — порт из контекста хранения.
|
|
742
|
+
dictionaryStore,
|
|
743
|
+
// ADR-115/ADR-116: blob-порт гидратации вложений — из контекста хранения
|
|
744
|
+
// (managed: тот же корень, что у раздачи/записи blob'ов).
|
|
745
|
+
blobs: storageContext.blobs,
|
|
746
|
+
// ADR-115: модальности модели — из её конфига (общий резолвер инстанса,
|
|
747
|
+
// выше: им же пользуются шаги пайплайнов).
|
|
748
|
+
resolveModelModalities,
|
|
749
|
+
// ADR-115: `attachments.workspaceFallback` — материализация отброшенных
|
|
750
|
+
// вложений в workspace; live-конфиг (проверяется на каждый ход).
|
|
751
|
+
attachmentsConfig: () => attachmentsSettings.getConfig(),
|
|
752
|
+
// ADR-115: каталог моделей инстанса для агента (тул `list_models`):
|
|
753
|
+
// тот же `modelStore`, что у `GET /api/v2/models` (каталог провайдеров +
|
|
754
|
+
// ручные override), поэтому модальности совпадают с UI.
|
|
755
|
+
listModels: () => modelStore.list(),
|
|
756
|
+
// ADR-115: порт ссылок на blob-объекты — для инъекции вложений тулов
|
|
757
|
+
// (`ToolResult.attachments`, включая `attach_workspace_file`).
|
|
758
|
+
blobRefs: storageContext.blobRefs,
|
|
265
759
|
workspacesRoot: config.workspacesRoot,
|
|
266
760
|
// ADR-075: backend — managed-режим, workspace вне workspacesRoot запрещён.
|
|
267
761
|
workspaceManaged: true,
|
|
@@ -278,6 +772,15 @@ export async function createBackendDeps(config) {
|
|
|
278
772
|
gatewayAuditLogger,
|
|
279
773
|
gatewayPayloadLogPath,
|
|
280
774
|
gatewayPatternStore: patternStore,
|
|
775
|
+
// ADR-090: бюджет времени фильтров LLM-вызовов
|
|
776
|
+
// (`plugins.llmFilterTimeoutMs`); реестр — `orchestrator.getLlmFilters()`.
|
|
777
|
+
llmFilterTimeoutMs: config.synth.plugins?.llmFilterTimeoutMs,
|
|
778
|
+
// ADR-094: реестр метрик (только при `metrics.enabled`) — LLM-вызовы
|
|
779
|
+
// сессий учитываются и при выключенном LLM Gateway.
|
|
780
|
+
metrics,
|
|
781
|
+
// ADR-107: телеметрия блоков памяти в промпте хода
|
|
782
|
+
// (`synth_memory_context_*`).
|
|
783
|
+
...(memoryTelemetry ? { onMemoryContext: memoryTelemetry.recordContext } : {}),
|
|
281
784
|
cachePolicy: config.synth.llm.cache,
|
|
282
785
|
toolsPolicy,
|
|
283
786
|
mcpPolicy,
|
|
@@ -285,7 +788,8 @@ export async function createBackendDeps(config) {
|
|
|
285
788
|
// ADR-046 §4.5: системный hard-gate скиллов (runtime-настройка).
|
|
286
789
|
skillsDisabled,
|
|
287
790
|
// ADR-070 §2.9.1: зависимости окружения (git/rg/sh) — детекция при старте.
|
|
288
|
-
|
|
791
|
+
// Проба бинарников — через тот же порт исполнения (ADR-077).
|
|
792
|
+
runtimeDeps: await detectRuntimeDeps(executionPort),
|
|
289
793
|
// ADR-071 §2.6: калибровка chars-per-token по модели (runtime-настройки).
|
|
290
794
|
tokenRatioLoader: (model) => settingsStore.getTokenRatio(model),
|
|
291
795
|
onTokenRatioCalibrated: (model, ratio) => settingsStore.setTokenRatio(model, ratio),
|
|
@@ -303,36 +807,118 @@ export async function createBackendDeps(config) {
|
|
|
303
807
|
// ADR-051: late-bound резолвер активности расписания в сессии (ScheduleStore
|
|
304
808
|
// создаётся ниже) — включает статический блок `Scheduler` в промпт.
|
|
305
809
|
isSchedulerActive: (sid) => scheduleStore.hasEnabledTargetFor(sid),
|
|
810
|
+
// ADR-101/ADR-051: late-bound рантайм автоматизации для встроенных тулов
|
|
811
|
+
// (`pipeline_*`/`schedule_*`) — движок пайплайнов и шедулер создаются ниже,
|
|
812
|
+
// поэтому геттер отдаёт актуальный снимок в момент хода.
|
|
813
|
+
getAutomationRuntime: () => automationRuntime,
|
|
306
814
|
// «Стоп»: персистентный флаг отмены сессии — прерывает длинный
|
|
307
815
|
// многоитерационный Tool Use на границе итерации (backoff/гонка).
|
|
308
816
|
isCancelRequested: async (sid) => (await sessionManager.getSession(sid))?.status.cancelRequested === true,
|
|
817
|
+
// Этап 1 roadmap 0.13 (блок 3): сервис «вопрос пользователю» — тул
|
|
818
|
+
// `question` задаёт вопрос и ждёт ответа пользователя.
|
|
819
|
+
...(questionService ? { questionService } : {}),
|
|
820
|
+
// Этап 1 roadmap 0.13 (блок 4): единый реестр фоновых прогонов — тул
|
|
821
|
+
// `task` с `background: true` регистрирует фонового саб-агента и
|
|
822
|
+
// возвращает управление сразу (PROP-096).
|
|
823
|
+
...(backgroundService ? { backgroundService } : {}),
|
|
824
|
+
// PROP-097: сервис фоновых шелл-процессов — тот же экземпляр, что у
|
|
825
|
+
// реестра и тула `execute_shell` (через `ctx.extra.processService`).
|
|
826
|
+
...(processService ? { processService } : {}),
|
|
827
|
+
// ADR-114: сервис worktree'ов — тулы `git_worktree_*` (инвентарь
|
|
828
|
+
// per-session рабочих каталогов проекта).
|
|
829
|
+
...(worktreeService ? { worktreeService } : {}),
|
|
830
|
+
backgroundEnabled: config.synth.background.enabled,
|
|
831
|
+
});
|
|
832
|
+
// ADR-090 (Ф5б-2): эффективный конфиг слоя = config.yaml (+env) поверх
|
|
833
|
+
// runtime-настроек (`settings.json`/PG): админка `/api/v2/settings/plugins`
|
|
834
|
+
// пишет runtime, рантайм собирается при старте (применение — рестартом,
|
|
835
|
+
// инвариант 24), поэтому слияние делается **здесь**, а не в рантайме.
|
|
836
|
+
const effectivePluginsConfig = mergePluginsConfig(config.synth.plugins, await settingsStore.getPlugins());
|
|
837
|
+
// ADR-090 (Ф5б-1): рантайм плагинов — старт-активация установленного
|
|
838
|
+
// (`plugins.lock.json` — источник истины), список со статусом активации и
|
|
839
|
+
// точки `activate`/`deactivate` для HTTP API/CLI (Ф5б-2/3). Реестры — **те же**
|
|
840
|
+
// экземпляры, что у оркестратора (`promptBlocks`, `getLlmFilters()`, `toolRegistry`).
|
|
841
|
+
// `plugins.executionEnabled=false` (дефолт) → `activateInstalled()` — no-op.
|
|
842
|
+
// Ф4б-2: транспорты исполнения плагина (`inline` — в процессе core,
|
|
843
|
+
// `remote` — отдельный процесс на loopback). Менеджер процессов гасится в
|
|
844
|
+
// `PluginRuntime.dispose()` при остановке инстанса.
|
|
845
|
+
const pluginProcessManager = new PluginProcessManager({
|
|
846
|
+
secretsDir: join(dataDir, 'secrets'),
|
|
847
|
+
logger: { warn: (message) => console.warn(`[plugin-process] ${message}`) },
|
|
848
|
+
});
|
|
849
|
+
// ADR-090 (WP-F): сервис эмбеддингов фасада (`facade.embed`).
|
|
850
|
+
//
|
|
851
|
+
// Эмбеддинги плагина идут **тем же** путём, что и остальные LLM-вызовы:
|
|
852
|
+
// провайдер создаётся `ProviderFactory`, оборачивается в `GatewayProvider`
|
|
853
|
+
// (`orchestrator.wrapProviderWithGateway`) — значит, работают guard'ы,
|
|
854
|
+
// обфускация, rate-limit, аудит и embedding-фаза фильтров `llmFilters`
|
|
855
|
+
// (инвариант 3, ADR-036). Плагин провайдера напрямую не достаёт.
|
|
856
|
+
//
|
|
857
|
+
// Провайдер/модель приходят из фасада: конфиг инстанса
|
|
858
|
+
// (`plugins.embeddingProvider`/`plugins.embeddingModel`) с перекрытием
|
|
859
|
+
// аргументом вызова. `GatewayProvider.embed` принимает **одну** строку —
|
|
860
|
+
// батча в v1 нет, поэтому цикл по текстам.
|
|
861
|
+
const pluginEmbed = async (texts, opts) => {
|
|
862
|
+
const providerName = opts?.provider?.trim() ?? '';
|
|
863
|
+
if (!providerName) {
|
|
864
|
+
throw new PluginFacadeError('plugin.embedding_not_configured', 'Эмбеддинги не сконфигурированы: задайте plugins.embeddingProvider ' +
|
|
865
|
+
'(или передайте провайдера в вызове facade.embed).');
|
|
866
|
+
}
|
|
867
|
+
const sharedConfig = providerLoader(providerName);
|
|
868
|
+
if (!sharedConfig) {
|
|
869
|
+
throw new PluginFacadeError('plugin.embedding_not_configured', `Провайдер «${providerName}» не найден в инстансе — эмбеддинги недоступны.`);
|
|
870
|
+
}
|
|
871
|
+
const model = opts?.model?.trim() || sharedConfig.defaultModel || '';
|
|
872
|
+
const provider = orchestrator.wrapProviderWithGateway(ProviderFactory.create(providerName, toCoreProviderConfig(sharedConfig, model)));
|
|
873
|
+
const vectors = [];
|
|
874
|
+
for (const text of texts) {
|
|
875
|
+
vectors.push(await provider.embed(text));
|
|
876
|
+
}
|
|
877
|
+
return vectors;
|
|
878
|
+
};
|
|
879
|
+
const pluginRuntime = new PluginRuntime({
|
|
880
|
+
layout: resolvePluginLayout({ dataDir, env: process.env }),
|
|
881
|
+
config: effectivePluginsConfig,
|
|
882
|
+
hostVersion: SYNTH_VERSION,
|
|
883
|
+
audit: storageContext.pluginAudit,
|
|
884
|
+
lock: storageContext.pluginLock,
|
|
885
|
+
promptBlocks,
|
|
886
|
+
llmFilters: orchestrator.getLlmFilters(),
|
|
887
|
+
tools: toolRegistry,
|
|
888
|
+
// PROP-047 §2.1: порты памяти инстанса — фасад плагина отдаёт **scoped**
|
|
889
|
+
// доступ (namespace навязывает хост). Порты обязательны в
|
|
890
|
+
// `StorageContext`, поэтому сервис доступен всегда.
|
|
891
|
+
memory: {
|
|
892
|
+
memoryFacts: storageContext.memoryFacts,
|
|
893
|
+
memoryIndexes: storageContext.memoryIndexes,
|
|
894
|
+
},
|
|
895
|
+
loaders: {
|
|
896
|
+
inline: createInlinePluginLoader(),
|
|
897
|
+
remote: createRemotePluginLoader({ processManager: pluginProcessManager }),
|
|
898
|
+
},
|
|
899
|
+
processManager: pluginProcessManager,
|
|
900
|
+
// ADR-090 (WP-F): сервис эмбеддингов фасада — через Gateway (инвариант 3).
|
|
901
|
+
embed: pluginEmbed,
|
|
902
|
+
// ADR-107: телеметрия recall/search-запросов памяти
|
|
903
|
+
// (`synth_memory_recall_*`).
|
|
904
|
+
...(memoryTelemetry ? { memoryTelemetry: memoryTelemetry.recordRecall } : {}),
|
|
309
905
|
});
|
|
310
906
|
const processMessage = orchestrator.createProcessMessage();
|
|
311
907
|
// ADR-089: ядро маршрутизации внешних событий и единый funnel создания сессий.
|
|
312
908
|
// Funnel подключён к `POST /sessions` и тулу `task` (Этап 5); приём внешних
|
|
313
|
-
// событий — на следующих этапах.
|
|
314
|
-
|
|
315
|
-
// ADR-089/ADR-052: API-ключи привязок для аутентификации приёма событий.
|
|
316
|
-
const eventApiKeyStore = new EventApiKeyStore({ dataDir });
|
|
317
|
-
const eventJournal = new EventJournalStore({ dataDir });
|
|
318
|
-
// ADR-089: реестр правил маршрутизации (проектные/инстанс-правила).
|
|
319
|
-
const routeRuleStore = new RouteRuleStore({ dataDir });
|
|
320
|
-
// ADR-089 (claim-flow): одноразовые коды подтверждения владения идентичностью.
|
|
321
|
-
const identityClaimStore = new IdentityClaimStore({ dataDir });
|
|
909
|
+
// событий — на следующих этапах. Сторы bindings/ключей/журнала/правил/claim,
|
|
910
|
+
// дедуп и расписания/jobs — из единого контекста хранения (собраны выше).
|
|
322
911
|
// ADR-089 (Блок 3): runtime-настройки «События» (админка) поверх config.yaml.
|
|
323
912
|
const runtimeEvents = await settingsStore.getEvents();
|
|
324
913
|
const effectiveEvents = mergeEventsConfig(config.synth.events, runtimeEvents);
|
|
325
914
|
let effectiveEventsSettings = effectiveEvents;
|
|
326
|
-
// ADR-051/ADR-089: источник дедупа — in-process (default) или файловый
|
|
327
|
-
// межпроцессный (`events.dedupStore: file`).
|
|
328
|
-
const dedupStore = config.synth.events.dedupStore === 'file'
|
|
329
|
-
? new FileDedupStore({ dataDir })
|
|
330
|
-
: new MemoryDedupStore();
|
|
331
915
|
const eventRouter = new EventRouter({
|
|
332
916
|
bindingStore: eventBindingStore,
|
|
333
917
|
journal: eventJournal,
|
|
334
918
|
hooks,
|
|
335
919
|
dedupStore,
|
|
920
|
+
// ADR-094: решения Router (kind; `bind` → `bound`).
|
|
921
|
+
metrics: eventMetrics,
|
|
336
922
|
config: {
|
|
337
923
|
allowedSources: effectiveEvents.allowedSources,
|
|
338
924
|
defaultMode: effectiveEvents.defaultMode,
|
|
@@ -342,16 +928,13 @@ export async function createBackendDeps(config) {
|
|
|
342
928
|
},
|
|
343
929
|
});
|
|
344
930
|
// ADR-089 (Блок 2): retention-очистка журнала событий (сразу + каждые 6 ч).
|
|
345
|
-
const stopEventJournalPruner =
|
|
346
|
-
|
|
347
|
-
|
|
931
|
+
const stopEventJournalPruner = storageDegraded
|
|
932
|
+
? () => { }
|
|
933
|
+
: startEventJournalPruner(eventJournal, {
|
|
934
|
+
getRetentionDays: () => effectiveEventsSettings.journalRetentionDays,
|
|
935
|
+
});
|
|
348
936
|
// ADR-051 (срез) / ADR-089: правило маршрутизации cron-событий по расписанию
|
|
349
937
|
// (паритет с core `server/app.ts`; store без дублей).
|
|
350
|
-
const scheduleStore = new ScheduleStore({
|
|
351
|
-
dataDir,
|
|
352
|
-
crossProcess: config.synth.scheduler.crossProcessLocks,
|
|
353
|
-
});
|
|
354
|
-
const jobStore = new JobStore({ dataDir });
|
|
355
938
|
eventRouter.registerRuleProvider(new SchedulerRuleProvider(scheduleStore, effectiveEvents.ephemeralTtl));
|
|
356
939
|
// ADR-089: правила маршрутизации по матчу события (после scheduler).
|
|
357
940
|
eventRouter.registerRuleProvider(new ProjectRuleProvider(routeRuleStore, effectiveEvents.ephemeralTtl));
|
|
@@ -371,6 +954,8 @@ export async function createBackendDeps(config) {
|
|
|
371
954
|
displayName: agent.displayName,
|
|
372
955
|
description: agent.description,
|
|
373
956
|
})),
|
|
957
|
+
// ADR-102: персистентные decision-метрики (ось provider/model).
|
|
958
|
+
analytics,
|
|
374
959
|
}));
|
|
375
960
|
// ADR-089: резолвинг `agentTemplate` (события/правила) через `AgentRegistry`:
|
|
376
961
|
// неизвестный или отключённый агент → `null`.
|
|
@@ -391,6 +976,22 @@ export async function createBackendDeps(config) {
|
|
|
391
976
|
profiles: profilesStore,
|
|
392
977
|
getIdentityMap: () => effectiveEventsSettings.identityMap,
|
|
393
978
|
});
|
|
979
|
+
// ADR-089/ADR-051: учёт экземпляров пайплайна (ADR-100) — состояние
|
|
980
|
+
// автомата публикации живёт в ядре (решение владельца), add-on отдаёт
|
|
981
|
+
// артефакт по id. Трекер работает через порт `storage.pipelines`.
|
|
982
|
+
const pipelineTracker = new PipelineTracker({ repository: pipelineStore });
|
|
983
|
+
// ADR-089: дефолтные `provider`/`model` инстанса — общий seam для funnel'а
|
|
984
|
+
// сессий и движка пайплайнов (ADR-101): приоритет — runtime-пара «Модели»
|
|
985
|
+
// (provider+model), затем config.yaml (llm.defaultProvider/defaultModel).
|
|
986
|
+
const resolveLlmDefaults = async () => {
|
|
987
|
+
const pair = await settingsStore.getDefaultModel();
|
|
988
|
+
if (pair)
|
|
989
|
+
return { provider: pair.provider, model: pair.model };
|
|
990
|
+
return {
|
|
991
|
+
provider: config.synth.llm.defaultProvider,
|
|
992
|
+
model: config.synth.llm.defaultModel,
|
|
993
|
+
};
|
|
994
|
+
};
|
|
394
995
|
const requestSessionService = new RequestSessionService({
|
|
395
996
|
sessionManager,
|
|
396
997
|
eventRouter,
|
|
@@ -436,16 +1037,17 @@ export async function createBackendDeps(config) {
|
|
|
436
1037
|
},
|
|
437
1038
|
// ADR-089: дефолтные provider/model инстанса (llm.defaultProvider/defaultModel)
|
|
438
1039
|
// — для сессий из внешних событий (materialize ephemeral/bind), чтобы агент
|
|
439
|
-
// мог ответить без ручной простановки модели.
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
model: config.synth.llm.defaultModel,
|
|
443
|
-
}),
|
|
1040
|
+
// мог ответить без ручной простановки модели. Приоритет: runtime-пара
|
|
1041
|
+
// «Модели» (provider+model), затем config.
|
|
1042
|
+
resolveLlmDefaults,
|
|
444
1043
|
// ADR-089: агент по умолчанию инстанса — чтобы сессия из внешнего события
|
|
445
1044
|
// (auto-bind/bind/ephemeral) фиксировала `settings.agentRole` и UI рисовал
|
|
446
1045
|
// бейдж агента (паритет с `POST /api/v2/sessions`). Источник — админка
|
|
447
1046
|
// «Агенты» (`getDefaultAgentId`) поверх `DEFAULT_AGENT_ID`.
|
|
448
1047
|
resolveDefaultAgent: getDefaultAgentId,
|
|
1048
|
+
// ADR-089/ADR-051: учёт экземпляров пайплайна (ADR-100) — решение с
|
|
1049
|
+
// `pipeline: {id, step}` продвигает автомат пайплайна; учёт best-effort.
|
|
1050
|
+
pipelineTracker,
|
|
449
1051
|
// ADR-089: UI-событие после материализации внешнего события.
|
|
450
1052
|
publish: (type, sessionId, data) => eventBus.publish(sessionId, type, data),
|
|
451
1053
|
deliver: async (sessionId, event, mode, context) => {
|
|
@@ -475,22 +1077,188 @@ export async function createBackendDeps(config) {
|
|
|
475
1077
|
if (mode === 'run') {
|
|
476
1078
|
// ADR-036: обфускация user-сообщения ДО сохранения в историю (паритет с
|
|
477
1079
|
// prompt-путём — core routes/sessions.ts).
|
|
478
|
-
await enqueueUserMessage(sessionManager, eventBus, sessionId, message, queueManager, processMessage, (sid, msg) => orchestrator.obfuscateUserMessageForHistory(sid, msg));
|
|
1080
|
+
const queued = await enqueueUserMessage(sessionManager, eventBus, sessionId, message, queueManager, processMessage, (sid, msg) => orchestrator.obfuscateUserMessageForHistory(sid, msg));
|
|
1081
|
+
// ADR-115 × ADR-089: ссылки на вложения события — только после успешной
|
|
1082
|
+
// постановки (иначе GC удалит объект, на который сообщение не ссылается).
|
|
1083
|
+
if (queued) {
|
|
1084
|
+
await addEventAttachmentRefs(storageContext.blobRefs, event, message.id);
|
|
1085
|
+
}
|
|
479
1086
|
}
|
|
480
1087
|
else {
|
|
481
1088
|
// ADR-036: `defer` тоже кладёт сообщение в историю — обфусцируем до
|
|
482
1089
|
// постановки. Старт процессора не выполняем (только очередь владельца).
|
|
483
1090
|
message = await orchestrator.obfuscateUserMessageForHistory(sessionId, message);
|
|
484
|
-
await sessionManager.addPendingMessage(sessionId, message);
|
|
1091
|
+
const queued = await sessionManager.addPendingMessage(sessionId, message);
|
|
1092
|
+
if (queued) {
|
|
1093
|
+
await addEventAttachmentRefs(storageContext.blobRefs, event, message.id);
|
|
1094
|
+
}
|
|
485
1095
|
}
|
|
486
1096
|
},
|
|
487
1097
|
});
|
|
488
1098
|
// ADR-089: ingress-точка приёма внешних событий (Этап 6).
|
|
489
|
-
|
|
1099
|
+
// ADR-115 × ADR-089: сервис вложений проверяет ссылки `attachments[]` события
|
|
1100
|
+
// (объект есть, метаданные совпадают со sidecar) и даёт лимиты
|
|
1101
|
+
// `attachments.maxFilesPerMessage`/`maxBytesPerFile` (runtime-настройки — живые).
|
|
1102
|
+
const eventAttachmentService = new AttachmentService({
|
|
1103
|
+
blobs: storageContext.blobs,
|
|
1104
|
+
config: () => attachmentsSettings.getConfig(),
|
|
1105
|
+
});
|
|
1106
|
+
const eventIngress = new EventIngress({
|
|
1107
|
+
requestSessionService,
|
|
1108
|
+
metrics: eventMetrics,
|
|
1109
|
+
attachments: eventAttachmentService,
|
|
1110
|
+
});
|
|
1111
|
+
// ADR-101 (Э5): движок пайплайнов — второй движок рядом с оркестратором
|
|
1112
|
+
// (ADR-101 §1). Собирается в точке сборки (никаких глобальных синглтонов):
|
|
1113
|
+
// шаг пайплайна не сессия, но окружение то же — порты хранилища (ADR-096),
|
|
1114
|
+
// permission-слой (ADR-029), промпт (ADR-070), Gateway (ADR-036).
|
|
1115
|
+
//
|
|
1116
|
+
// HTTP-роутов у движка нет (Э6): он живёт в `deps` и используется
|
|
1117
|
+
// вызывающим кодом (запуск прогона/возобновление — Э6).
|
|
1118
|
+
const pipelinePermissions = {
|
|
1119
|
+
permissionConfig: config.synth.permission,
|
|
1120
|
+
runtimeDeps,
|
|
1121
|
+
};
|
|
1122
|
+
// ADR-036/ADR-101: провайдер шага — **всегда** через `GatewayProvider`
|
|
1123
|
+
// (обёртка оркестратора: та же точка, что у пула провайдеров). Провайдер
|
|
1124
|
+
// не кэшируется — обёртка подхватывает live-конфиг LLM Gateway.
|
|
1125
|
+
const resolvePipelineProvider = async () => {
|
|
1126
|
+
try {
|
|
1127
|
+
const defaults = await resolveLlmDefaults();
|
|
1128
|
+
const providerName = defaults.provider?.trim();
|
|
1129
|
+
if (!providerName)
|
|
1130
|
+
return null;
|
|
1131
|
+
const sharedConfig = providerLoader(providerName);
|
|
1132
|
+
if (!sharedConfig)
|
|
1133
|
+
return null;
|
|
1134
|
+
const coreConfig = toCoreProviderConfig(sharedConfig, defaults.model?.trim() || sharedConfig.defaultModel || '');
|
|
1135
|
+
return orchestrator.wrapProviderWithGateway(ProviderFactory.create(providerName, coreConfig));
|
|
1136
|
+
}
|
|
1137
|
+
catch {
|
|
1138
|
+
// Провайдер не собран — шаг упадёт с `pipeline.provider_not_found`.
|
|
1139
|
+
return null;
|
|
1140
|
+
}
|
|
1141
|
+
};
|
|
1142
|
+
// ADR-101 §9 / ADR-116: артефакты прогонов — байты в общем blob-порте
|
|
1143
|
+
// (отдельного хранилища артефактов нет). Тот же инстанс получают выход `file`
|
|
1144
|
+
// (запись) и HTTP-раздача артефактов прогона (`GET
|
|
1145
|
+
// /pipeline-runs/:runId/artifacts/:name`), иначе route отдавал бы 404.
|
|
1146
|
+
const pipelineArtifacts = new PipelineArtifactStore({
|
|
1147
|
+
blobs: storageContext.blobs,
|
|
1148
|
+
blobRefs: storageContext.blobRefs,
|
|
1149
|
+
});
|
|
1150
|
+
const pipelineEngine = new PipelineEngine({
|
|
1151
|
+
// ADR-096: порты спецификаций пайплайнов и прогонов — из контекста хранения.
|
|
1152
|
+
pipelines: storageContext.projectPipelines,
|
|
1153
|
+
runs: storageContext.pipelineRuns,
|
|
1154
|
+
// ADR-101 §4: исполнители видов шага (tool/script/human/agent).
|
|
1155
|
+
executors: [
|
|
1156
|
+
createToolStepExecutor({ toolRegistry, permissions: pipelinePermissions }),
|
|
1157
|
+
createScriptStepExecutor({ toolRegistry, permissions: pipelinePermissions }),
|
|
1158
|
+
createHumanStepExecutor(),
|
|
1159
|
+
createAgentStepExecutor({ toolRegistry, permissions: pipelinePermissions }),
|
|
1160
|
+
],
|
|
1161
|
+
// ADR-101 §9: выходы пайплайна — сессия/файл/шлюз/none.
|
|
1162
|
+
exits: [
|
|
1163
|
+
createPipelineExitHandler({
|
|
1164
|
+
sessionManager,
|
|
1165
|
+
projectStore,
|
|
1166
|
+
eventBus,
|
|
1167
|
+
ingress: eventIngress,
|
|
1168
|
+
// ADR-116: выход `file` дополнительно кладёт байты в blob-порт —
|
|
1169
|
+
// артефакт прогона переживает очистку workspace.
|
|
1170
|
+
artifacts: pipelineArtifacts,
|
|
1171
|
+
workspacesRoot: config.workspacesRoot,
|
|
1172
|
+
resolveLlmDefaults,
|
|
1173
|
+
// ADR-089: владелец сессии, созданной выходом, — владелец проекта
|
|
1174
|
+
// прогона (резолвится в обработчике выхода). Без проекта владельца нет:
|
|
1175
|
+
// сессия инстансная (видима ADMIN/LEAD) — права уточняются в Э6.
|
|
1176
|
+
onSessionMaterialized: (session) => {
|
|
1177
|
+
const owner = session.ownerId || session.userId;
|
|
1178
|
+
if (!owner)
|
|
1179
|
+
return;
|
|
1180
|
+
void eventHub.subscribeToSession(owner, session.id).catch((e) => console.warn('subscribeToSession failed:', e));
|
|
1181
|
+
},
|
|
1182
|
+
}),
|
|
1183
|
+
],
|
|
1184
|
+
// ADR-101 §2.12: инстансные события прогона (новая шина не заводится).
|
|
1185
|
+
eventBus,
|
|
1186
|
+
// ADR-094: метрики прогонов (`synth_pipeline_*`).
|
|
1187
|
+
metrics: metrics ? createPipelineMetrics(metrics) : undefined,
|
|
1188
|
+
// ADR-101 §4/ADR-070: промпт шага — тем же сборщиком, что у сессий.
|
|
1189
|
+
composer: orchestrator.getComposer(),
|
|
1190
|
+
resolveProvider: resolvePipelineProvider,
|
|
1191
|
+
resolveLlmDefaults,
|
|
1192
|
+
// ADR-115 × ADR-101: вложения прогона — тот же сервис вложений, что у
|
|
1193
|
+
// приёма событий (чтение `attachments/…`, sidecar-метаданные, лимиты) и
|
|
1194
|
+
// тот же blob-порт артефактов, что у HTTP-раздачи (`artifacts/…`).
|
|
1195
|
+
attachments: eventAttachmentService,
|
|
1196
|
+
artifacts: pipelineArtifacts,
|
|
1197
|
+
resolveModalities: resolveModelModalities,
|
|
1198
|
+
deriveAttachment: createPipelineAttachmentDerive({
|
|
1199
|
+
config: () => attachmentsSettings.getConfig(),
|
|
1200
|
+
attachments: eventAttachmentService,
|
|
1201
|
+
blobs: storageContext.blobs,
|
|
1202
|
+
// Инвариант 3: LLM-вызов только через gateway — провайдер aux-модели
|
|
1203
|
+
// обёрнут той же обвязкой, что и провайдер шага.
|
|
1204
|
+
resolveProvider: async (provider, model) => {
|
|
1205
|
+
try {
|
|
1206
|
+
const sharedConfig = providerLoader(provider);
|
|
1207
|
+
if (!sharedConfig)
|
|
1208
|
+
return null;
|
|
1209
|
+
return orchestrator.wrapProviderWithGateway(ProviderFactory.create(provider, toCoreProviderConfig(sharedConfig, model)));
|
|
1210
|
+
}
|
|
1211
|
+
catch {
|
|
1212
|
+
return null;
|
|
1213
|
+
}
|
|
1214
|
+
},
|
|
1215
|
+
hasFfmpeg: () => isFfmpegAvailable(executionPort).catch(() => false),
|
|
1216
|
+
promptTemplate: (language) => contextConfig.getMediaDeriveTemplate(language),
|
|
1217
|
+
language: 'ru',
|
|
1218
|
+
log: (message) => console.warn(message),
|
|
1219
|
+
}),
|
|
1220
|
+
attachmentsNoticeTemplate: (language) => contextConfig.getAttachmentsDroppedTemplate(language),
|
|
1221
|
+
// ADR-101 §10: контекст шага — те же объекты, что собраны для сессий.
|
|
1222
|
+
projectStore,
|
|
1223
|
+
toolRegistry,
|
|
1224
|
+
mcpManager,
|
|
1225
|
+
instructionsResolver: orchestrator.getInstructionsResolver(),
|
|
1226
|
+
agentRegistry,
|
|
1227
|
+
skillsCatalog: skillService,
|
|
1228
|
+
runtimeDeps,
|
|
1229
|
+
workspacesRoot: config.workspacesRoot,
|
|
1230
|
+
});
|
|
1231
|
+
// ADR-101/ADR-051: движок пайплайнов появился — отдаём его тулам
|
|
1232
|
+
// `pipeline_*` через рантайм автоматизации (late-bound).
|
|
1233
|
+
automationRuntime.engine = pipelineEngine;
|
|
1234
|
+
// ADR-101: встроенные шаблоны пайплайнов инстанса (сид при старте).
|
|
1235
|
+
// Идемпотентно: существующий шаблон не перезаписывается. Ошибка сидирования
|
|
1236
|
+
// **не** роняет старт — только предупреждение в лог. В деградированном
|
|
1237
|
+
// режиме (ADR-098) хранилище read-only — запись не выполняется вовсе.
|
|
1238
|
+
if (!storageDegraded) {
|
|
1239
|
+
try {
|
|
1240
|
+
await ensureBuiltinPipelines({
|
|
1241
|
+
pipelines: storageContext.projectPipelines,
|
|
1242
|
+
logger: {
|
|
1243
|
+
info: (message) => console.log(message),
|
|
1244
|
+
warn: (message) => console.warn(message),
|
|
1245
|
+
},
|
|
1246
|
+
});
|
|
1247
|
+
}
|
|
1248
|
+
catch (err) {
|
|
1249
|
+
console.warn(`[pipelines] не удалось засеять встроенные шаблоны: ${err instanceof Error ? err.message : String(err)}`);
|
|
1250
|
+
}
|
|
1251
|
+
}
|
|
490
1252
|
// ADR-051 (срез) / ADR-089: планировщик публикует cron-события через ingress.
|
|
491
1253
|
// `start()` гейтится конфигом (`scheduler.enabled: false` — тикер не стартует),
|
|
492
1254
|
// ошибки старта логируются и не роняют процесс; остановка — `stopScheduler`.
|
|
493
1255
|
const schedulerTickMs = config.synth.scheduler.tickSec * 1000;
|
|
1256
|
+
// ADR-097: `leaderElection=postgres` требует advisory-локов backend'а
|
|
1257
|
+
// (`storage.backend=postgres`); иначе — предупреждение и AlwaysLeader.
|
|
1258
|
+
if (config.synth.scheduler.leaderElection === 'postgres' && !storageContext.locks) {
|
|
1259
|
+
console.warn('[scheduler] leaderElection=postgres, но backend не предоставляет advisory-локи ' +
|
|
1260
|
+
'(нужен storage.backend=postgres) — используется AlwaysLeader');
|
|
1261
|
+
}
|
|
494
1262
|
const schedulerService = new SchedulerService({
|
|
495
1263
|
scheduleStore,
|
|
496
1264
|
ingress: eventIngress,
|
|
@@ -499,28 +1267,78 @@ export async function createBackendDeps(config) {
|
|
|
499
1267
|
defaultEphemeralTtl: effectiveEvents.ephemeralTtl,
|
|
500
1268
|
catchUp: config.synth.scheduler.catchUp,
|
|
501
1269
|
jobRetentionDays: config.synth.scheduler.jobRetentionDays,
|
|
502
|
-
// ADR-
|
|
1270
|
+
// ADR-030 (Ф0 ADR-090): хук `schedule_fired` (async, метаданные расписания).
|
|
1271
|
+
hooks,
|
|
1272
|
+
// ADR-094: завершённые Job (outcome + дрейф cron).
|
|
1273
|
+
onJob: schedulerJobMetrics,
|
|
1274
|
+
// ADR-101: цель расписания `mode:'pipeline'` — прямой запуск прогона.
|
|
1275
|
+
// Прогон идёт в фоне: ждём только `onStarted` (id прогона), не конца.
|
|
1276
|
+
runPipeline: async ({ projectId, pipelineId, version, payload, dedupKey }) => {
|
|
1277
|
+
const started = new Promise((resolve, reject) => {
|
|
1278
|
+
const p = pipelineEngine.run({
|
|
1279
|
+
projectId,
|
|
1280
|
+
pipelineId,
|
|
1281
|
+
...(version !== undefined ? { version } : {}),
|
|
1282
|
+
trigger: { kind: 'schedule', source: 'cron', type: 'schedule_fired', payload, dedupKey },
|
|
1283
|
+
onStarted: resolve,
|
|
1284
|
+
});
|
|
1285
|
+
// Ошибка до старта — reject (Job → error). Ошибка после старта — в журнале
|
|
1286
|
+
// прогона; обработчик снимает unhandled rejection, `reject` уже не сработает.
|
|
1287
|
+
p.catch(reject);
|
|
1288
|
+
});
|
|
1289
|
+
const run = await started;
|
|
1290
|
+
return { runId: run.id };
|
|
1291
|
+
},
|
|
1292
|
+
// ADR-051/ADR-089/ADR-096: тикер стартует только у лидера (default —
|
|
1293
|
+
// AlwaysLeader). `file` — файловый лок на общем dataDir, `postgres` —
|
|
1294
|
+
// session-level advisory-lock драйвера (доступен только при PG-backend).
|
|
503
1295
|
leader: config.synth.scheduler.leaderElection === 'file'
|
|
504
1296
|
? new FileLeader({ dataDir, tickMs: schedulerTickMs })
|
|
505
|
-
:
|
|
1297
|
+
: config.synth.scheduler.leaderElection === 'postgres' && storageContext.locks
|
|
1298
|
+
? storageContext.locks.createLeader({ name: 'scheduler/leader', tickMs: schedulerTickMs })
|
|
1299
|
+
: new AlwaysLeader(),
|
|
506
1300
|
});
|
|
507
|
-
if (config.synth.scheduler.enabled !== false) {
|
|
1301
|
+
if (config.synth.scheduler.enabled !== false && !storageDegraded) {
|
|
508
1302
|
void schedulerService.start().catch((err) => {
|
|
509
1303
|
console.warn(`[scheduler] не удалось запустить: ${err instanceof Error ? err.message : String(err)}`);
|
|
510
1304
|
});
|
|
511
1305
|
}
|
|
512
|
-
// ADR-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
1306
|
+
// ADR-101/ADR-051: шедулер появился — отдаём его тулам `schedule_*`
|
|
1307
|
+
// через рантайм автоматизации (late-bound).
|
|
1308
|
+
automationRuntime.scheduler = schedulerService;
|
|
1309
|
+
// ADR-092: авто-миграции схемы данных при старте (паритет со standalone-core) —
|
|
1310
|
+
// обязательная страховочная копия + межпроцессный лок. Миграция снапшотов скоупа —
|
|
1311
|
+
// зарегистрированная миграция реестра (`session-scope-snapshots-v1`), отдельный
|
|
1312
|
+
// прямой вызов больше не нужен. Fail-closed: ошибка не глушится.
|
|
1313
|
+
// ADR-098 (W5): в деградации миграции не применяем (фоллбек-каталог пуст —
|
|
1314
|
+
// страховочная копия/миграция были бы доменной записью в фоллбек).
|
|
1315
|
+
if (!storageDegraded) {
|
|
1316
|
+
await applyStartupMigrations({
|
|
1317
|
+
dataDir,
|
|
1318
|
+
settingsStore,
|
|
1319
|
+
sessionManager,
|
|
1320
|
+
projectStore,
|
|
1321
|
+
// ADR-097: под PG — advisory-лок драйвера вместо файлового `{dataDir}/migrate`.
|
|
1322
|
+
...(storageContext.locks
|
|
1323
|
+
? { mutex: storageContext.locks.createMutex({ name: 'startup-migrate' }) }
|
|
1324
|
+
: {}),
|
|
1325
|
+
resolveSystemDefaults: async () => ({
|
|
1326
|
+
mcpDefaultOn: await mcpRegistryStore.toDefaultServers(),
|
|
1327
|
+
skillsDefaultOn: (await resolveProjectSkillSeed(skillService, await settingsStore.getSkillsDisabledForNewProjects())).enabled,
|
|
1328
|
+
}),
|
|
1329
|
+
});
|
|
1330
|
+
}
|
|
522
1331
|
return {
|
|
523
1332
|
dataDir,
|
|
1333
|
+
// ADR-106 Ф3: реестр подтверждений (enforced-режим Authority-слоя).
|
|
1334
|
+
approvalRegistry,
|
|
1335
|
+
// ADR-096: контекст хранения инстанса — для операций, которым нужен
|
|
1336
|
+
// целиком (напр. портативный экспорт/импорт проекта, ADR-091).
|
|
1337
|
+
storageContext,
|
|
1338
|
+
// ADR-094: реестр метрик (доменные коллекторы подключаются выше) и
|
|
1339
|
+
// остановка фоновых коллекторов на graceful shutdown.
|
|
1340
|
+
metrics,
|
|
1341
|
+
stopMetricsCollectors,
|
|
524
1342
|
projectStore,
|
|
525
1343
|
sessionManager,
|
|
526
1344
|
// ADR-089: остановка sweeper'а авто-архивации ephemeral-сессий.
|
|
@@ -529,6 +1347,9 @@ export async function createBackendDeps(config) {
|
|
|
529
1347
|
providerStore,
|
|
530
1348
|
modelStore,
|
|
531
1349
|
agentStore,
|
|
1350
|
+
// ADR-096 (W2.4): конфигурационные словари и реестр service-key — из контекста.
|
|
1351
|
+
dictionaries: dictionaryStore,
|
|
1352
|
+
serviceApiKeyStore,
|
|
532
1353
|
contextConfig,
|
|
533
1354
|
profilesStore,
|
|
534
1355
|
patternStore,
|
|
@@ -536,10 +1357,55 @@ export async function createBackendDeps(config) {
|
|
|
536
1357
|
defaultsStore,
|
|
537
1358
|
defaultWorkingDir,
|
|
538
1359
|
getDefaultAgentId,
|
|
1360
|
+
egressResolver,
|
|
1361
|
+
egressLogConfig,
|
|
1362
|
+
securityAudit,
|
|
1363
|
+
egressRequests,
|
|
1364
|
+
// ADR-102 (волна 1): порт пред-агрегированных роллапов аналитики — для роутов отчётов.
|
|
1365
|
+
analyticsRollups,
|
|
1366
|
+
// ADR-102: write-path — сборщик роллапов (+ остановка hook-подписки и pruner'а).
|
|
1367
|
+
analytics,
|
|
1368
|
+
detachAnalyticsHooks,
|
|
1369
|
+
stopAnalyticsRollupPruner,
|
|
1370
|
+
stopEgressLogPruner,
|
|
539
1371
|
mcpManager,
|
|
540
1372
|
mcpRegistryStore,
|
|
1373
|
+
// ADR-105 (Ф3/Ф4): реестр описаний OAuth-провайдеров и сервис слоя доступов
|
|
1374
|
+
// (HTTP-контур `/api/v2/oauth/credentials`).
|
|
1375
|
+
oauthProviders,
|
|
1376
|
+
oauthCredentialService,
|
|
1377
|
+
// ADR-051/ADR-100: порт реестра пайплайнов (определения + экземпляры).
|
|
1378
|
+
pipelines: pipelineStore,
|
|
1379
|
+
// ADR-101 (Э5): движок пайплайнов (второй движок) — HTTP-роутов нет (Э6).
|
|
1380
|
+
pipelineEngine,
|
|
1381
|
+
// ADR-101 §9/ADR-116: хранилище артефактов прогонов поверх blob-порта —
|
|
1382
|
+
// получает HTTP-раздача `GET /pipeline-runs/:runId/artifacts/:name`.
|
|
1383
|
+
pipelineArtifacts,
|
|
1384
|
+
// ADR-115 × ADR-101: сервис вложений — проверка `attachments[]` в теле
|
|
1385
|
+
// запуска прогона (тот же экземпляр, что у приёма событий).
|
|
1386
|
+
pipelineAttachments: eventAttachmentService,
|
|
1387
|
+
// ADR-101: реестр активных прогонов — общий для HTTP-роута пайплайнов и
|
|
1388
|
+
// встроенных тулов агента (soft-lock + отмена идущего прогона).
|
|
1389
|
+
pipelineRunControl,
|
|
1390
|
+
// ADR-086 §5: порт реестра установок пакетов расширений.
|
|
1391
|
+
packs: packStore,
|
|
541
1392
|
eventBus,
|
|
542
1393
|
queueManager,
|
|
1394
|
+
// Этап 1 roadmap 0.13 (блок 3): сервис вопросов пользователю (+ pruner).
|
|
1395
|
+
questionService,
|
|
1396
|
+
stopQuestionPruner,
|
|
1397
|
+
// Этап 1 roadmap 0.13 (блок 4): реестр фоновых прогонов (+ pruner).
|
|
1398
|
+
backgroundService,
|
|
1399
|
+
stopBackgroundRunPruner,
|
|
1400
|
+
// PROP-097 (блок 5b): сервис фоновых шелл-процессов (+ pruner логов).
|
|
1401
|
+
processService,
|
|
1402
|
+
stopProcessLogPruner,
|
|
1403
|
+
// ADR-115: GC осиротевших вложений сообщений.
|
|
1404
|
+
stopAttachmentPruner,
|
|
1405
|
+
// ADR-115: живое состояние настроек вложений (сервис/промпт/GC + админ-API).
|
|
1406
|
+
attachmentsSettings,
|
|
1407
|
+
// ADR-114: сервис worktree'ов — HTTP-контур проектов и привязка сессии.
|
|
1408
|
+
worktreeService,
|
|
543
1409
|
webhookStore,
|
|
544
1410
|
webhookDeliveryStore,
|
|
545
1411
|
webhookService,
|
|
@@ -561,6 +1427,12 @@ export async function createBackendDeps(config) {
|
|
|
561
1427
|
bundleStore,
|
|
562
1428
|
commandService,
|
|
563
1429
|
orchestrator,
|
|
1430
|
+
// ADR-090 (Ф5б-1): рантайм плагинов — старт-активация установленного
|
|
1431
|
+
// (`app.ts`/`main.ts`) и точки для HTTP API/CLI (Ф5б-2/3). `host`+`installer` внутри.
|
|
1432
|
+
pluginRuntime,
|
|
1433
|
+
// ADR-077: порт исполнения — тот же инстанс, что у оркестратора и тулов
|
|
1434
|
+
// (резолвер проектных инструкций берёт его для `git rev-parse`).
|
|
1435
|
+
executionPort,
|
|
564
1436
|
processMessage,
|
|
565
1437
|
eventBindingStore,
|
|
566
1438
|
eventApiKeyStore,
|
|
@@ -571,6 +1443,8 @@ export async function createBackendDeps(config) {
|
|
|
571
1443
|
stopEventJournalPruner,
|
|
572
1444
|
scheduleStore,
|
|
573
1445
|
jobStore,
|
|
1446
|
+
// ADR-092: аудит-журнал обслуживания — порт слоя хранения (ADR-096).
|
|
1447
|
+
maintenanceAudit: storageContext.maintenanceAudit,
|
|
574
1448
|
resolveAgentTemplate,
|
|
575
1449
|
eventHub,
|
|
576
1450
|
requestSessionService,
|
|
@@ -582,13 +1456,6 @@ export async function createBackendDeps(config) {
|
|
|
582
1456
|
* потребителями через замыкания (ADR-071 §2.3.1 / ADR-084 / ADR-089).
|
|
583
1457
|
*/
|
|
584
1458
|
live: {
|
|
585
|
-
/** ADR-071 §2.3.1: эффективная политика сетевого доступа MCP. */
|
|
586
|
-
getNetworkPolicy: () => effectiveNetworkPolicy,
|
|
587
|
-
/** ADR-071 §2.3.1: live-применение политики (админка → менеджер MCP). */
|
|
588
|
-
setNetworkPolicy: (policy) => {
|
|
589
|
-
effectiveNetworkPolicy = policy;
|
|
590
|
-
mcpManager.setNetworkPolicy(policy);
|
|
591
|
-
},
|
|
592
1459
|
/** ADR-089: runtime-настройки «События» (`enabled`/per-key лимит — роуты). */
|
|
593
1460
|
getEvents: () => effectiveEventsSettings,
|
|
594
1461
|
/** ADR-089: live-применение runtime-настроек «События» — Router/funnel/pruner. */
|