@itphx/synth-backend 0.12.4 → 0.13.8
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 -1
- package/dist/app/deps.js +553 -34
- package/dist/app/listen.js +56 -7
- package/dist/app/mount-routes.js +273 -32
- package/dist/app/public-routes.d.ts +2 -0
- package/dist/app/public-routes.js +11 -0
- package/dist/app/sse-events.d.ts +4 -0
- package/dist/app/sse-events.js +53 -6
- package/dist/app.d.ts +3 -1
- package/dist/app.js +33 -0
- package/dist/auth/api-key.d.ts +19 -0
- package/dist/auth/api-key.js +56 -0
- package/dist/auth/middleware.js +7 -3
- package/dist/events/hub.d.ts +17 -0
- package/dist/events/hub.js +50 -15
- package/dist/init.d.ts +1 -0
- package/dist/init.js +96 -0
- package/dist/lib/app-config.d.ts +4 -0
- package/dist/lib/app-config.js +16 -3
- package/dist/lib/bind-host.d.ts +10 -0
- package/dist/lib/bind-host.js +32 -0
- package/dist/lib/defaults-store.d.ts +1 -1
- package/dist/lib/defaults-store.js +1 -1
- package/dist/lib/i18n.js +26 -0
- package/dist/lib/recalc-can-summarize.js +8 -3
- package/dist/main.js +7 -2
- package/dist/middleware/rate-limiter.d.ts +4 -1
- package/dist/middleware/rate-limiter.js +15 -2
- package/dist/routes/agents.js +1 -0
- package/dist/routes/auth.js +29 -16
- package/dist/routes/llm.js +92 -12
- package/dist/routes/mcp-remote.d.ts +23 -0
- package/dist/routes/mcp-remote.js +152 -0
- package/dist/routes/mcp.d.ts +11 -6
- package/dist/routes/mcp.js +35 -6
- package/dist/routes/messages.js +2 -0
- package/dist/routes/projects.d.ts +9 -3
- package/dist/routes/projects.js +32 -3
- package/dist/routes/providers.d.ts +4 -1
- package/dist/routes/providers.js +19 -99
- package/dist/routes/queue.d.ts +4 -1
- package/dist/routes/queue.js +4 -1
- package/dist/routes/sessions.d.ts +49 -9
- package/dist/routes/sessions.js +299 -256
- package/package.json +6 -6
- package/dist/routes/audit.d.ts +0 -17
- package/dist/routes/audit.js +0 -64
- package/dist/routes/context.d.ts +0 -4
- package/dist/routes/context.js +0 -93
- package/dist/routes/debug.d.ts +0 -3
- package/dist/routes/debug.js +0 -30
- package/dist/routes/gateway-patterns.d.ts +0 -9
- package/dist/routes/gateway-patterns.js +0 -57
- package/dist/routes/logs.d.ts +0 -24
- package/dist/routes/logs.js +0 -100
- package/dist/routes/mcp-registry.d.ts +0 -28
- package/dist/routes/mcp-registry.js +0 -483
package/dist/app/deps.js
CHANGED
|
@@ -3,11 +3,25 @@
|
|
|
3
3
|
// (ADR-046), runtime-настройки (ADR-005/023).
|
|
4
4
|
// Вынесено из `app.ts` (ADR-095, шаг 4b) — «вынос по швам», без изменения поведения.
|
|
5
5
|
import { mkdir } from 'node:fs/promises';
|
|
6
|
+
import { existsSync } from 'node:fs';
|
|
6
7
|
import { join } from 'node:path';
|
|
7
|
-
import { ensureDataDir, parsePrincipalId, resolveDefaultWorkspace, resolveSecretKey, resolveStorageBackend, resolvePostgresConfig, resolvePostgresPassword, resolveDegradedMode, resolveStorageFallbackDir, resolveExecutionConfig, readTlsRuntimeSettings, SYNTH_VERSION, } from '@itphx/synth-shared';
|
|
8
|
-
import {
|
|
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
|
+
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, DEFAULT_AGENT_ID, registerStoredAgents, migrateLegacyStoredAgents, AuditLogger, mergeLlmGatewayConfig, mergeSecurityConfig, mergeEventsConfig, mergeDecisionConfig, mergePluginsConfig,
|
|
9
11
|
// ADR-115: живое состояние runtime-настроек вложений (`/settings/attachments`).
|
|
10
|
-
createLiveAttachmentsSettings,
|
|
12
|
+
createLiveAttachmentsSettings,
|
|
13
|
+
// Политика контекстного окна (`/settings/context-window`).
|
|
14
|
+
createLiveContextWindowPolicy,
|
|
15
|
+
// Бюджет промпта саб-агента (`/settings/agents-limits`).
|
|
16
|
+
createLiveSubagentMaxInputTokens,
|
|
17
|
+
// Лимит тяжёлых операций с сессиями (`/settings/limits`).
|
|
18
|
+
createLiveSessionOpsPerMinute,
|
|
19
|
+
// Дефолты оптимизации контекста новых сессий (`/settings/context-defaults`).
|
|
20
|
+
createLiveContextDefaults,
|
|
21
|
+
// Instance-wide лимиты заметок сессии (`/settings/sticky-notes`).
|
|
22
|
+
createLiveStickyNotesLimits,
|
|
23
|
+
// PROP-124: режим инстанса для SSH-ключей (`/settings/ssh`).
|
|
24
|
+
createLiveSshMode, createEgressPolicyResolver, createEgressLogSink, configureEgressRuntime, startEgressLogPruner,
|
|
11
25
|
// ADR-105 (Ф3): источник access-токена для MCP-коннекторов + OAuth-сервис.
|
|
12
26
|
OAuthCredentialService, OAuthProviderRegistry, registerOAuthProvidersFromConfig, createRepositoryCredentialSource, SkillService, resolveProjectSkillSeed, CommandService, detectRuntimeDeps, syncProvidersFromEnv,
|
|
13
27
|
// ADR-115 × ADR-101: доступность `ffmpeg` — обработчик вложения aux-моделью шага.
|
|
@@ -20,7 +34,12 @@ BackgroundRunService, startBackgroundRunPruner, createBackgroundParentNotifier,
|
|
|
20
34
|
ProcessService, startProcessLogPruner,
|
|
21
35
|
// ADR-115: GC осиротевших вложений сообщений.
|
|
22
36
|
startAttachmentPruner,
|
|
23
|
-
// ADR-
|
|
37
|
+
// ADR-115 × ADR-077: медиа-раннер (ffmpeg inline/remote) и серверные миниатюры.
|
|
38
|
+
createMediaRunner, ThumbnailService,
|
|
39
|
+
// ADR-115 × ADR-077: уборка временных каталогов медиа-раннера
|
|
40
|
+
// (`{workspacesRoot}/.synth-media/*`) — после жёсткого kill они остаются.
|
|
41
|
+
startMediaTempPruner,
|
|
42
|
+
// ADR-114: сервис worktree (per-session рабочий каталог) + публикация
|
|
24
43
|
// `worktree.updated` в каналы сессий проекта.
|
|
25
44
|
WorktreeService, publishWorktreeUpdated, startWorktreeSweeper, WebhookService, startWebhookDeliveryPruner, AnalyticsRecorder, attachAnalyticsActivityHooks, startAnalyticsRollupPruner, sessionAxes, createStorageContextAsync, initTlsTrust, applyStartupProxyConfig, attachBusMetrics, startSessionMetrics, startStorageMetrics,
|
|
26
45
|
// ADR-094/PROP-047: метрики памяти (`synth_memory_*`).
|
|
@@ -44,14 +63,21 @@ PipelineArtifactStore, PipelineEngine,
|
|
|
44
63
|
// для HTTP-роута пайплайнов и встроенных тулов агента.
|
|
45
64
|
PipelineRunControl, createToolStepExecutor, createScriptStepExecutor, createHumanStepExecutor, createAgentStepExecutor, createPipelineExitHandler, createPipelineMetrics,
|
|
46
65
|
// ADR-115 × ADR-101: вложения прогона — derive для text-only модели шага.
|
|
47
|
-
createPipelineAttachmentDerive, ensureBuiltinPipelines,
|
|
66
|
+
createPipelineAttachmentDerive, ensureBuiltinPipelines,
|
|
67
|
+
// ADR-101 §4 × `AgentDefinition`: провайдер агентского шага (код общий с core).
|
|
68
|
+
resolvePipelineStepProvider, toCoreProviderConfig, ProviderFactory,
|
|
48
69
|
// ADR-077: порт исполнения команд (inline/remote).
|
|
49
70
|
createExecutionPortForConfig,
|
|
50
71
|
// ADR-090 (Ф3а) / §5, §10 (Ф5б-1): общий реестр
|
|
51
72
|
// блоков промпта (композер + фасад плагинов) и рантайм плагинов.
|
|
52
|
-
PromptBlockRegistry, PluginRuntime, PluginProcessManager, PluginFacadeError, createInlinePluginLoader, createRemotePluginLoader, resolvePluginLayout, } from '@itphx/synth-core';
|
|
73
|
+
PromptBlockRegistry, PluginRuntime, PluginProcessManager, PluginFacadeError, createInlinePluginLoader, createRemotePluginLoader, resolvePluginLayout, serializeMessage, } from '@itphx/synth-core';
|
|
53
74
|
import { EventHub } from '../events/hub.js';
|
|
54
75
|
import { seedDebugTestUsers } from './bootstrap.js';
|
|
76
|
+
/**
|
|
77
|
+
* Fallback-текст info-блока автопродолжения после рестарта: content — en-текст
|
|
78
|
+
* по контракту ADR-041 (LLM-контекст), UI локализует по `metadata.i18n`.
|
|
79
|
+
*/
|
|
80
|
+
const RESTART_RESUMED_TEXT = 'The turn was interrupted by an instance restart and continued automatically';
|
|
55
81
|
/**
|
|
56
82
|
* ADR-096 (W2.4): единая точка сборки слоя хранения backend — `app.ts` строит
|
|
57
83
|
* её до `auth` (реестр `serviceKeys` нужен резолверу ключа, `mcpRegistry` —
|
|
@@ -146,12 +172,32 @@ executionConfig) {
|
|
|
146
172
|
};
|
|
147
173
|
// ADR-030: ядровая шина хуков — общий инстанс для SessionManager и оркестратора.
|
|
148
174
|
const hooks = new HookBus();
|
|
175
|
+
// Дефолты оптимизации контекста для новых сессий (`context.defaults`):
|
|
176
|
+
// runtime-патч поверх config.yaml; применяются без рестарта.
|
|
177
|
+
const contextDefaultsSettings = createLiveContextDefaults({
|
|
178
|
+
config: config.synth.context?.defaults,
|
|
179
|
+
runtime: await settingsStore.getContextDefaults(),
|
|
180
|
+
});
|
|
181
|
+
// Instance-wide лимиты заметок сессии (`context.stickyNotes`): runtime-патч
|
|
182
|
+
// поверх config.yaml; применятся без рестарта (резолвер читается на операцию).
|
|
183
|
+
const stickyNotesLimitsSettings = createLiveStickyNotesLimits({
|
|
184
|
+
config: config.synth.context?.stickyNotes,
|
|
185
|
+
runtime: await settingsStore.getStickyNotesLimits(),
|
|
186
|
+
});
|
|
187
|
+
// PROP-124: режим инстанса для SSH-ключей (`ssh.mode`): приоритет
|
|
188
|
+
// env > runtime > config.yaml > `tools`; применяется без рестарта.
|
|
189
|
+
const sshModeSettings = createLiveSshMode({
|
|
190
|
+
config: config.synth.ssh?.mode,
|
|
191
|
+
runtime: await settingsStore.getSshMode(),
|
|
192
|
+
});
|
|
149
193
|
// ADR-102: сборщик роллапов аналитики (write-path) — только через порт слоя
|
|
150
194
|
// хранения; в деградации выключен (не пишем домен в файловый фоллбек).
|
|
151
195
|
const analytics = storageDegraded ? undefined : new AnalyticsRecorder({ repo: analyticsRollups });
|
|
152
196
|
const sessionManager = new SessionManager(fileStore, {
|
|
153
197
|
projectStore,
|
|
154
198
|
hooks,
|
|
199
|
+
// Дефолты оптимизации контекста новых сессий (`context.defaults` + runtime).
|
|
200
|
+
contextDefaults: () => contextDefaultsSettings.getDefaults(),
|
|
155
201
|
// ADR-102: точка персиста сообщений (`messages_assistant`/`messages_tool`).
|
|
156
202
|
analytics,
|
|
157
203
|
// ADR-071 §2.4 / ADR-046 §4.5: системные дефолты для сессий без проекта.
|
|
@@ -218,6 +264,25 @@ executionConfig) {
|
|
|
218
264
|
config: config.synth.attachments,
|
|
219
265
|
runtime: await settingsStore.getAttachments(),
|
|
220
266
|
});
|
|
267
|
+
// Политика ограничения контекстного окна (`context.windowPolicy`):
|
|
268
|
+
// приоритет env > runtime > config.yaml > default; применяется сразу.
|
|
269
|
+
const contextWindowSettings = createLiveContextWindowPolicy({
|
|
270
|
+
config: config.synth.context?.windowPolicy,
|
|
271
|
+
runtime: await settingsStore.getContextWindowPolicy(),
|
|
272
|
+
});
|
|
273
|
+
// Предохранитель объёма промпта саб-агента (`agents.subagentMaxInputTokens`):
|
|
274
|
+
// приоритет env > runtime > config.yaml > 0; читается при сборке `task` extra.
|
|
275
|
+
const subagentMaxInputTokensSettings = createLiveSubagentMaxInputTokens({
|
|
276
|
+
config: config.synth.agents.subagentMaxInputTokens,
|
|
277
|
+
runtime: await settingsStore.getSubagentMaxInputTokens(),
|
|
278
|
+
});
|
|
279
|
+
// Лимит тяжёлых операций ресурса сессий (`limits.sessionOpsPerMinute`):
|
|
280
|
+
// приоритет env > runtime > config.yaml > 10; `0` — без лимита. Лимитеры
|
|
281
|
+
// читают значение на каждый запрос — runtime-настройка применяется без рестарта.
|
|
282
|
+
const sessionOpsPerMinuteSettings = createLiveSessionOpsPerMinute({
|
|
283
|
+
config: config.synth.limits.sessionOpsPerMinute,
|
|
284
|
+
runtime: await settingsStore.getSessionOpsPerMinute(),
|
|
285
|
+
});
|
|
221
286
|
const stopEgressLogPruner = storageDegraded || !egressLogConfig.enabled
|
|
222
287
|
? () => { }
|
|
223
288
|
: startEgressLogPruner(egressRequests, { getRetentionDays: () => egressLogConfig.retentionDays });
|
|
@@ -296,15 +361,70 @@ executionConfig) {
|
|
|
296
361
|
// создаётся лениво, при первом вызове колбэка (он приходит только из
|
|
297
362
|
// фонового прогона, т.е. уже после старта).
|
|
298
363
|
let backgroundNotifier = null;
|
|
364
|
+
/**
|
|
365
|
+
* ADR-111/ADR-113: идёт ли ход в сессии (одна функция на нотификатор и
|
|
366
|
+
* матрицу ретрансляции результата из дочерней сессии).
|
|
367
|
+
*/
|
|
368
|
+
const isBackgroundTurnActive = async (sid) => {
|
|
369
|
+
if (queueManager.isRunning(sid))
|
|
370
|
+
return true;
|
|
371
|
+
const current = await sessionManager.getSession(sid);
|
|
372
|
+
const stream = current?.currentStream;
|
|
373
|
+
if (!stream || stream.cancelled)
|
|
374
|
+
return false;
|
|
375
|
+
return current?.status?.cancelRequested !== true;
|
|
376
|
+
};
|
|
377
|
+
/**
|
|
378
|
+
* Корень дерева сессий (обход `parentId` вверх, глубина ≤ 5, защита от
|
|
379
|
+
* циклов). Ошибка/нет сессии → `null` (fail-safe: доставим владельцу).
|
|
380
|
+
*/
|
|
381
|
+
const resolveRootSession = async (sessionId) => {
|
|
382
|
+
let current = await sessionManager.getSession(sessionId);
|
|
383
|
+
if (!current)
|
|
384
|
+
return null;
|
|
385
|
+
const seen = new Set([current.id]);
|
|
386
|
+
for (let depth = 0; depth < 5 && current.parentId; depth += 1) {
|
|
387
|
+
if (seen.has(current.parentId))
|
|
388
|
+
break;
|
|
389
|
+
const parent = await sessionManager.getSession(current.parentId);
|
|
390
|
+
if (!parent)
|
|
391
|
+
break;
|
|
392
|
+
seen.add(parent.id);
|
|
393
|
+
current = parent;
|
|
394
|
+
}
|
|
395
|
+
return { id: current.id, ...(current.title ? { title: current.title } : {}) };
|
|
396
|
+
};
|
|
299
397
|
const notifyBackgroundParent = async (sessionId, message) => {
|
|
300
398
|
backgroundNotifier ??= createBackgroundParentNotifier({
|
|
301
399
|
sessionManager,
|
|
302
400
|
eventBus,
|
|
303
401
|
processorManager: queueManager,
|
|
304
402
|
processMessage,
|
|
403
|
+
isTurnActive: isBackgroundTurnActive,
|
|
305
404
|
});
|
|
306
405
|
await backgroundNotifier(sessionId, message);
|
|
307
406
|
};
|
|
407
|
+
/**
|
|
408
|
+
* ADR-111/ADR-113 × ADR-104: остаток steer-очереди в конце хода возвращается
|
|
409
|
+
* в обычную очередь (`autostart` — нормальное завершение; после «Стопа» — нет).
|
|
410
|
+
*/
|
|
411
|
+
/**
|
|
412
|
+
* ADR-104 × ADR-111/ADR-113: остаток steer-очереди в конце хода не теряется —
|
|
413
|
+
* **все** сообщения возвращаются в `pendingMessages`; `autostart` поднимает
|
|
414
|
+
* ход (нормальное завершение), при «Стопе» — нет.
|
|
415
|
+
* `processMessage` объявлен ниже — вызов происходит уже в рантайме.
|
|
416
|
+
*/
|
|
417
|
+
const requeueSteerMessages = async (sessionId, messages, autostart) => {
|
|
418
|
+
return requeueMessages({
|
|
419
|
+
sessionManager,
|
|
420
|
+
eventBus,
|
|
421
|
+
sessionId,
|
|
422
|
+
messages,
|
|
423
|
+
...(autostart
|
|
424
|
+
? { autostart: { processorManager: queueManager, processMessage, eventBus } }
|
|
425
|
+
: {}),
|
|
426
|
+
});
|
|
427
|
+
};
|
|
308
428
|
const backgroundService = storageDegraded
|
|
309
429
|
? undefined
|
|
310
430
|
: new BackgroundRunService({
|
|
@@ -322,6 +442,13 @@ executionConfig) {
|
|
|
322
442
|
// системное (автор `Subagent`/`Process`), а не пользовательский ввод;
|
|
323
443
|
// секреты в исходящих LLM-запросах обфусцирует сам Gateway.
|
|
324
444
|
onNotifyParent: notifyBackgroundParent,
|
|
445
|
+
// ADR-111/ADR-113: матрица доставки — прогон из дочерней сессии без
|
|
446
|
+
// активного хода ретранслируется в корень (дочернюю не будим).
|
|
447
|
+
isTurnActive: isBackgroundTurnActive,
|
|
448
|
+
resolveRootSessionId: resolveRootSession,
|
|
449
|
+
// «Стоп» сессии останавливает и живые прогоны детей (ADR-111 §detach,
|
|
450
|
+
// решение 2026-10-28): дерево обходит сам сервис (глубина ≤ 5).
|
|
451
|
+
getChildSessionIds: async (parentId) => (await sessionManager.getChildren(parentId, { light: true })).map((s) => s.id),
|
|
325
452
|
});
|
|
326
453
|
// Старт: прогоны прошлого процесса не пережили рестарт (хэндлы отмены — в
|
|
327
454
|
// памяти) — помечаем их `orphaned`. Best-effort: ошибка не роняет старт.
|
|
@@ -333,6 +460,133 @@ executionConfig) {
|
|
|
333
460
|
console.warn(`[background] восстановление фоновых прогонов не удалось: ${err instanceof Error ? err.message : String(err)}`);
|
|
334
461
|
}
|
|
335
462
|
}
|
|
463
|
+
/**
|
|
464
|
+
* Info-блок «ход продолжен после рестарта»: пишется в историю (роль INFO — в
|
|
465
|
+
* LLM-контекст не попадает) и публикуется `message.added`. Дубль для того же
|
|
466
|
+
* `stream_id` не пишется: recovery и автоскан очередей могут указывать на одно
|
|
467
|
+
* и то же сообщение.
|
|
468
|
+
*/
|
|
469
|
+
const addRestartResumedNotice = async (sessionId, streamId) => {
|
|
470
|
+
const session = await sessionManager.getSession(sessionId);
|
|
471
|
+
const alreadyNotified = session?.messages.some((m) => m.metadata?.type === 'restart_resumed'
|
|
472
|
+
&& m.metadata?.stream_id === streamId);
|
|
473
|
+
if (alreadyNotified)
|
|
474
|
+
return;
|
|
475
|
+
const info = {
|
|
476
|
+
id: generateId(),
|
|
477
|
+
role: MessageRole.INFO,
|
|
478
|
+
seq: 0,
|
|
479
|
+
origin: 'local',
|
|
480
|
+
parts: [makeTextPart(RESTART_RESUMED_TEXT)],
|
|
481
|
+
content: RESTART_RESUMED_TEXT,
|
|
482
|
+
createdAt: nowISO(),
|
|
483
|
+
disabled: false,
|
|
484
|
+
pinned: false,
|
|
485
|
+
hidden: false,
|
|
486
|
+
metadata: {
|
|
487
|
+
type: 'restart_resumed',
|
|
488
|
+
...(streamId ? { stream_id: streamId } : {}),
|
|
489
|
+
i18n: { key: 'chat.notice.restartResumedText' },
|
|
490
|
+
},
|
|
491
|
+
};
|
|
492
|
+
let index = 0;
|
|
493
|
+
try {
|
|
494
|
+
const updated = await sessionManager.addMessage(sessionId, info);
|
|
495
|
+
if (updated)
|
|
496
|
+
index = Math.max(0, updated.messages.length - 1);
|
|
497
|
+
}
|
|
498
|
+
catch (err) {
|
|
499
|
+
console.warn(`[sessions] info-блок восстановления не записан: ${err instanceof Error ? err.message : String(err)}`);
|
|
500
|
+
}
|
|
501
|
+
eventBus.publish(sessionId, 'message.added', serializeMessage(info, index));
|
|
502
|
+
};
|
|
503
|
+
// Session-маркеры хода/блокировки переживают рестарт: процесс, убитый при
|
|
504
|
+
// rolling update, не успевает снять `currentStream`/`status.blocked`, а
|
|
505
|
+
// процессор очереди такую сессию считает занятой и не стартует — UI вечно
|
|
506
|
+
// показывает активность. Восстановление отложено на 60 с, чтобы старый под
|
|
507
|
+
// успел умереть, а живые маркеры работающего процесса не были сняты.
|
|
508
|
+
// В деградации хранилище read-only — ничего не пишем и не запускаем.
|
|
509
|
+
if (!storageDegraded) {
|
|
510
|
+
const bootRecovery = setTimeout(() => {
|
|
511
|
+
void sessionManager.recoverInterruptedSessions()
|
|
512
|
+
.then(async (recovered) => {
|
|
513
|
+
for (const r of recovered) {
|
|
514
|
+
eventBus.publish(r.sessionId, 'turn.finished', {
|
|
515
|
+
turn_id: r.turnId,
|
|
516
|
+
turnId: r.turnId,
|
|
517
|
+
stream_id: r.streamId,
|
|
518
|
+
status: 'stopped',
|
|
519
|
+
});
|
|
520
|
+
eventBus.publish(r.sessionId, 'session.updated', { session_id: r.sessionId });
|
|
521
|
+
if (!r.resumeMessage)
|
|
522
|
+
continue;
|
|
523
|
+
// Автопродолжение: info-блок в истории (в LLM-контекст не попадает —
|
|
524
|
+
// роль INFO исключена из промпта) и resume-сообщение процессору.
|
|
525
|
+
await addRestartResumedNotice(r.sessionId, r.streamId);
|
|
526
|
+
queueManager.createProcessor(r.sessionId, sessionManager, eventBus, processMessage, {
|
|
527
|
+
resumeMessage: r.resumeMessage,
|
|
528
|
+
});
|
|
529
|
+
}
|
|
530
|
+
if (recovered.length) {
|
|
531
|
+
console.log(`[sessions] сняты маркеры прерванных ходов: ${recovered.length}`);
|
|
532
|
+
}
|
|
533
|
+
// Автозапуск очередей, переживших рестарт: pending без активного хода
|
|
534
|
+
// и без осознанной остановки (`queueStopped`). Сессии саб-агентов не
|
|
535
|
+
// продолжаем — решение за родителем. `light`-список не подходит:
|
|
536
|
+
// он очищает `pendingMessages`.
|
|
537
|
+
try {
|
|
538
|
+
// `light`: без истории (`messages`/`checkpoints`) — полный список
|
|
539
|
+
// сессий с историями давал пик heap и OOM на инстансах с сотнями
|
|
540
|
+
// сессий. Очередь (`pendingMessages`) в light сохраняется.
|
|
541
|
+
const sessions = await sessionManager.listSessions(undefined, {
|
|
542
|
+
includeArchived: false,
|
|
543
|
+
});
|
|
544
|
+
let queueCandidates = 0;
|
|
545
|
+
let inFlightResumed = 0;
|
|
546
|
+
for (const s of sessions) {
|
|
547
|
+
if (s.archivedAt || s.sessionOrigin === 'subagent')
|
|
548
|
+
continue;
|
|
549
|
+
if (s.currentStream || s.status.blocked)
|
|
550
|
+
continue;
|
|
551
|
+
if (s.pendingMessages.length === 0)
|
|
552
|
+
continue;
|
|
553
|
+
queueCandidates += 1;
|
|
554
|
+
if (s.status.queueStopped) {
|
|
555
|
+
eventBus.publish(s.id, 'queue.stalled', {
|
|
556
|
+
pending_count: s.pendingMessages.length,
|
|
557
|
+
});
|
|
558
|
+
continue;
|
|
559
|
+
}
|
|
560
|
+
// Маркеры мог снять прошлый recovery, а сообщение осталось и в
|
|
561
|
+
// истории, и в очереди. Это прерванный in-flight ход: продолжаем
|
|
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;
|
|
572
|
+
}
|
|
573
|
+
queueManager.createProcessor(s.id, sessionManager, eventBus, processMessage);
|
|
574
|
+
}
|
|
575
|
+
if (queueCandidates > 0) {
|
|
576
|
+
// Только счётчики: ни id, ни содержимого сессий/сообщений.
|
|
577
|
+
console.log(`[sessions] автозапуск очередей: кандидатов ${queueCandidates}, in-flight продолжено ${inFlightResumed}`);
|
|
578
|
+
}
|
|
579
|
+
}
|
|
580
|
+
catch (err) {
|
|
581
|
+
console.warn(`[sessions] автозапуск очередей после рестарта: ${err instanceof Error ? err.message : String(err)}`);
|
|
582
|
+
}
|
|
583
|
+
})
|
|
584
|
+
.catch((err) => {
|
|
585
|
+
console.warn(`[sessions] восстановление прерванных ходов: ${err instanceof Error ? err.message : String(err)}`);
|
|
586
|
+
});
|
|
587
|
+
}, 60_000);
|
|
588
|
+
bootRecovery.unref?.();
|
|
589
|
+
}
|
|
336
590
|
// Retention-очистка терминальных записей реестра (сразу + каждые 6 ч).
|
|
337
591
|
const stopBackgroundRunPruner = storageDegraded
|
|
338
592
|
? () => { }
|
|
@@ -359,6 +613,15 @@ executionConfig) {
|
|
|
359
613
|
gcDays: () => attachmentsSettings.getConfig().gcDays,
|
|
360
614
|
...(attachmentMetrics ? { metrics: attachmentMetrics } : {}),
|
|
361
615
|
});
|
|
616
|
+
// ADR-115 × ADR-077: уборка временных каталогов медиа-раннера
|
|
617
|
+
// (`{workspacesRoot}/.synth-media/<uuid>`). После жёсткого kill раннер не
|
|
618
|
+
// успевает убрать каталог (`finally` не выполняется) — такие каталоги
|
|
619
|
+
// копятся на общем томе. TTL 1 ч, интервал 6 ч, best-effort: каталога нет —
|
|
620
|
+
// нечего убирать (создавать его не надо). В деградированном режиме
|
|
621
|
+
// хранилища уборка не нужна (медиа не обрабатывается).
|
|
622
|
+
const stopMediaTempPruner = storageDegraded
|
|
623
|
+
? () => { }
|
|
624
|
+
: startMediaTempPruner({ workspacesRoot: config.workspacesRoot });
|
|
362
625
|
// ADR-094: доменные коллекторы. `metrics` приходит только при
|
|
363
626
|
// `metrics.enabled=true` — иначе реестр остаётся пустым (`/metrics` → 404).
|
|
364
627
|
// Фоновые таймеры `unref`-ятся; остановка — `stopMetricsCollectors` на
|
|
@@ -440,7 +703,12 @@ executionConfig) {
|
|
|
440
703
|
const providerLoader = (name) => {
|
|
441
704
|
// При старте загружаем все конфиги — JsonStore.list() не подходит для быстрого lookup
|
|
442
705
|
// поэтому кешируем провайдеров в Map
|
|
443
|
-
|
|
706
|
+
const provider = providerCache.get(name);
|
|
707
|
+
// Fail-closed: отключённый администратором провайдер не создаётся ни в чате,
|
|
708
|
+
// ни в ретраях, ни в пайплайнах/эмбеддингах/суммаризации.
|
|
709
|
+
if (!provider || provider.enabled === false)
|
|
710
|
+
return null;
|
|
711
|
+
return provider;
|
|
444
712
|
};
|
|
445
713
|
// ADR-038: синхронизация провайдеров/моделей из переменных окружения (общая
|
|
446
714
|
// core-реализация). Вызывается ПОСЛЕ создания providerStore/modelStore, но ДО
|
|
@@ -527,6 +795,12 @@ executionConfig) {
|
|
|
527
795
|
// ADR-046 §4.5: runtime-отключение скиллов (админка) — hard-gate системного уровня.
|
|
528
796
|
const skillsDisabled = (await settingsStore.getSkillsDisabled())
|
|
529
797
|
?? { categories: [], groups: [], skills: [] };
|
|
798
|
+
// ADR-046/ADR-069: project-trust гейт скиллов/команд/инструкций. Runtime
|
|
799
|
+
// (`settings.json`/PG) приоритетнее `config.yaml`; применяется при старте —
|
|
800
|
+
// `restartRequired` в API, инвариант 24.
|
|
801
|
+
const effectiveSkillsTrustedProjectDirs = (await settingsStore.getSkillsTrustedProjectDirs())
|
|
802
|
+
?? config.synth.skills.trustedProjectDirs
|
|
803
|
+
?? [];
|
|
530
804
|
// ADR-084: runtime/эффективный конфиг decision-слоя (админка) приоритетнее
|
|
531
805
|
// config.yaml `decision`. Live-применяется ко всем трём потребителям
|
|
532
806
|
// (микро-каскад, роутер, события ADR-089) через `live.setDecision`.
|
|
@@ -539,6 +813,22 @@ executionConfig) {
|
|
|
539
813
|
// системного промпта на инстанс — композер добавляет блоки в промпт сессии,
|
|
540
814
|
// фасад плагинов (`PluginRuntime` → `PluginHost`) их регистрирует.
|
|
541
815
|
const promptBlocks = new PromptBlockRegistry();
|
|
816
|
+
// Набор ролей прежней поставки (`pm`/`developer`/`qa`/`analyst`/`auditor`)
|
|
817
|
+
// заменён на `leader`/`fixer`/`tester`/`researcher`/`security-auditor`, но в
|
|
818
|
+
// сторе остаются полные копии прежних встроенных агентов. Без миграции в
|
|
819
|
+
// списке живут две роли сразу, а старая несёт подменённый `contextFile` при
|
|
820
|
+
// прежней идентичности/правах (агент получает чужую роль с чужими правами).
|
|
821
|
+
// Переносим пользовательские настройки в целевого встроенного агента,
|
|
822
|
+
// устаревшую запись удаляем; идемпотентно.
|
|
823
|
+
try {
|
|
824
|
+
const migratedAgents = await migrateLegacyStoredAgents(agentStore);
|
|
825
|
+
if (migratedAgents.length > 0) {
|
|
826
|
+
console.info(`[agents] миграция устаревших агентов: ${migratedAgents.join(', ')}`);
|
|
827
|
+
}
|
|
828
|
+
}
|
|
829
|
+
catch (err) {
|
|
830
|
+
console.warn(`[agents] не удалось мигрировать устаревших агентов: ${err instanceof Error ? err.message : String(err)}`);
|
|
831
|
+
}
|
|
542
832
|
// ADR-096 + ADR-086 §5: агенты из **стора** — в реестр при старте.
|
|
543
833
|
// `createAgentRegistry` читает только файловый каталог `{dataDir}/agents`,
|
|
544
834
|
// а при `storage.backend=postgres` стор агентов — это БД: агент, поставленный
|
|
@@ -559,7 +849,7 @@ executionConfig) {
|
|
|
559
849
|
store: storageContext.skills,
|
|
560
850
|
configPaths: config.synth.skills.paths,
|
|
561
851
|
urls: config.synth.skills.urls,
|
|
562
|
-
trustedProjectDirs:
|
|
852
|
+
trustedProjectDirs: effectiveSkillsTrustedProjectDirs,
|
|
563
853
|
toolsets: config.synth.skills.toolsets,
|
|
564
854
|
});
|
|
565
855
|
// ADR-046 §7: slash-команды и bundles (mirror core).
|
|
@@ -572,7 +862,7 @@ executionConfig) {
|
|
|
572
862
|
maxArgumentsLength: config.synth.commands.maxArgumentsLength,
|
|
573
863
|
maxRenderedBytes: config.synth.commands.maxRenderedBytes,
|
|
574
864
|
toolsets: config.synth.skills.toolsets,
|
|
575
|
-
trustedProjectDirs:
|
|
865
|
+
trustedProjectDirs: effectiveSkillsTrustedProjectDirs,
|
|
576
866
|
inlineShell: config.synth.skills.inlineShell ?? false,
|
|
577
867
|
},
|
|
578
868
|
skillRuntime: skillService,
|
|
@@ -603,7 +893,7 @@ executionConfig) {
|
|
|
603
893
|
limits: { maxLogBytes: config.synth.background.logMaxBytes },
|
|
604
894
|
})
|
|
605
895
|
: undefined;
|
|
606
|
-
// ADR-114: сервис worktree
|
|
896
|
+
// ADR-114: сервис worktree (per-session рабочий каталог).
|
|
607
897
|
//
|
|
608
898
|
// Один инстанс на процесс: его получают HTTP-роуты проектов
|
|
609
899
|
// (`/projects/:id/worktrees*`), тулы `git_worktree_*` и привязка сессии
|
|
@@ -621,7 +911,7 @@ executionConfig) {
|
|
|
621
911
|
defaultWorkingDir,
|
|
622
912
|
// Привязанная живая сессия — по полю `session.worktree` (ADR-114 §1.3).
|
|
623
913
|
resolveAttachedSession: async (worktreeId) => {
|
|
624
|
-
const sessions = await sessionManager.listSessions(undefined
|
|
914
|
+
const sessions = await sessionManager.listSessions(undefined);
|
|
625
915
|
return sessions.find((s) => s.worktree?.worktreeId === worktreeId)?.id;
|
|
626
916
|
},
|
|
627
917
|
onUpdated: (projectId, detail) => {
|
|
@@ -632,7 +922,7 @@ executionConfig) {
|
|
|
632
922
|
});
|
|
633
923
|
},
|
|
634
924
|
});
|
|
635
|
-
// ADR-114 §7.4: sweep осиротевших записей worktree
|
|
925
|
+
// ADR-114 §7.4: sweep осиротевших записей worktree при старте процесса
|
|
636
926
|
// (записи без каталога — их чистит и prune проекта, §7.3). Фоново: старт
|
|
637
927
|
// **не блокируется**, ошибка — в лог, процесс продолжает жить. В деградированном
|
|
638
928
|
// режиме хранилища сервиса нет — вычищать нечего.
|
|
@@ -708,6 +998,102 @@ executionConfig) {
|
|
|
708
998
|
}
|
|
709
999
|
return prefixMatch;
|
|
710
1000
|
};
|
|
1001
|
+
/**
|
|
1002
|
+
* Совместимость протокола по каталогу: `provider.compatibility` (JSON
|
|
1003
|
+
* провайдера) + shorthand `ModelConfig.requiresReasoning` +
|
|
1004
|
+
* `model.compatibility` (каталог/ручной override). Порядок слоёв —
|
|
1005
|
+
* provider → shorthand → модель (модель перекрывает).
|
|
1006
|
+
* `undefined` — явных значений нет, работают эвристики провайдера.
|
|
1007
|
+
*/
|
|
1008
|
+
const resolveModelCompatibility = (providerName, modelId) => {
|
|
1009
|
+
const providerCompat = providerCache.get(providerName)?.compatibility;
|
|
1010
|
+
let model = modelCache.get(`${providerName}/${modelId}`) ?? modelCache.get(modelId);
|
|
1011
|
+
if (!model) {
|
|
1012
|
+
for (const candidate of modelCache.values()) {
|
|
1013
|
+
if (candidate.provider !== providerName)
|
|
1014
|
+
continue;
|
|
1015
|
+
if (candidate.name === modelId) {
|
|
1016
|
+
model = candidate;
|
|
1017
|
+
break;
|
|
1018
|
+
}
|
|
1019
|
+
}
|
|
1020
|
+
}
|
|
1021
|
+
const shorthand = model?.requiresReasoning !== undefined
|
|
1022
|
+
? { requireReasoning: model.requiresReasoning }
|
|
1023
|
+
: undefined;
|
|
1024
|
+
if (!providerCompat && !shorthand && !model?.compatibility)
|
|
1025
|
+
return undefined;
|
|
1026
|
+
return mergeModelCompatibility(providerCompat, shorthand, model?.compatibility);
|
|
1027
|
+
};
|
|
1028
|
+
/**
|
|
1029
|
+
* Лимит вывода модели из каталога (`ModelConfig.maxOutputTokens`): кап для
|
|
1030
|
+
* резолва `max_tokens` и источник значения при авто-лимите сессии.
|
|
1031
|
+
* `undefined` — у модели лимит неизвестен (или не положителен).
|
|
1032
|
+
*/
|
|
1033
|
+
const resolveModelMaxOutputTokens = (providerName, modelId) => {
|
|
1034
|
+
let model = modelCache.get(`${providerName}/${modelId}`) ?? modelCache.get(modelId);
|
|
1035
|
+
if (!model) {
|
|
1036
|
+
for (const candidate of modelCache.values()) {
|
|
1037
|
+
if (candidate.provider !== providerName)
|
|
1038
|
+
continue;
|
|
1039
|
+
if (candidate.name === modelId) {
|
|
1040
|
+
model = candidate;
|
|
1041
|
+
break;
|
|
1042
|
+
}
|
|
1043
|
+
}
|
|
1044
|
+
}
|
|
1045
|
+
return typeof model?.maxOutputTokens === 'number' && model.maxOutputTokens > 0
|
|
1046
|
+
? model.maxOutputTokens
|
|
1047
|
+
: undefined;
|
|
1048
|
+
};
|
|
1049
|
+
/** Доступность провайдера для понятной ошибки хода (`provider_disabled`). */
|
|
1050
|
+
const providerAvailability = (name) => {
|
|
1051
|
+
const provider = providerCache.get(name);
|
|
1052
|
+
if (!provider)
|
|
1053
|
+
return 'missing';
|
|
1054
|
+
return provider.enabled === false ? 'disabled' : 'ok';
|
|
1055
|
+
};
|
|
1056
|
+
/** Включена ли модель (`false` — отключена); нет записи — `undefined`. */
|
|
1057
|
+
const resolveModelEnabled = (providerName, modelId) => {
|
|
1058
|
+
let model = modelCache.get(`${providerName}/${modelId}`) ?? modelCache.get(modelId);
|
|
1059
|
+
if (!model) {
|
|
1060
|
+
for (const candidate of modelCache.values()) {
|
|
1061
|
+
if (candidate.provider !== providerName)
|
|
1062
|
+
continue;
|
|
1063
|
+
if (candidate.name === modelId) {
|
|
1064
|
+
model = candidate;
|
|
1065
|
+
break;
|
|
1066
|
+
}
|
|
1067
|
+
}
|
|
1068
|
+
}
|
|
1069
|
+
return model ? model.enabled !== false : undefined;
|
|
1070
|
+
};
|
|
1071
|
+
// Workstream A1: снимок метаданных инстанса для read-only тула `synth_info`
|
|
1072
|
+
// (managed). Секретов нет: только флаги наличия ключей/настроек.
|
|
1073
|
+
const authDebug = config.auth.debugMode === true;
|
|
1074
|
+
const oidcEnabled = config.auth.oidc?.enabled === true;
|
|
1075
|
+
const apiKeyConfigured = Boolean(config.auth.apiKey || process.env.SYNTH_API_KEY);
|
|
1076
|
+
const instanceMeta = {
|
|
1077
|
+
mode: 'managed',
|
|
1078
|
+
server: { port: config.port },
|
|
1079
|
+
auth: {
|
|
1080
|
+
mode: authDebug ? 'debug' : oidcEnabled ? 'oidc' : apiKeyConfigured ? 'api-key' : 'unknown',
|
|
1081
|
+
localKeyPresent: existsSync(join(dataDir, 'secrets/api-key')),
|
|
1082
|
+
apiKeyConfigured,
|
|
1083
|
+
oidcEnabled,
|
|
1084
|
+
debug: authDebug,
|
|
1085
|
+
},
|
|
1086
|
+
storage: {
|
|
1087
|
+
backend: resolveStorageBackend(config.synth, process.env),
|
|
1088
|
+
degraded: storageDegraded,
|
|
1089
|
+
},
|
|
1090
|
+
features: {
|
|
1091
|
+
mcp: true,
|
|
1092
|
+
metrics: config.synth.metrics.enabled === true,
|
|
1093
|
+
memory: true,
|
|
1094
|
+
restartMode: process.env.SYNTH_RESTART_MODE ?? 'disabled',
|
|
1095
|
+
},
|
|
1096
|
+
};
|
|
711
1097
|
const orchestrator = new ChatOrchestrator({
|
|
712
1098
|
sessionManager,
|
|
713
1099
|
eventBus,
|
|
@@ -717,10 +1103,39 @@ executionConfig) {
|
|
|
717
1103
|
authorityGate: authorityGuard?.gate,
|
|
718
1104
|
// ADR-106 Ф3: реестр подтверждений (привязка к ходу + носитель гранта).
|
|
719
1105
|
...(approvalRegistry ? { approvalRegistry } : {}),
|
|
1106
|
+
// ADR-029: отдельное хранилище ожиданий подтверждения (ADR-096) —
|
|
1107
|
+
// персистентная копия ожидания, переживающая рестарт инстанса. Документ
|
|
1108
|
+
// сессии не трогаем: запись в него — полная замена истории, а результаты
|
|
1109
|
+
// параллельных тулов пишутся точечно (`appendMessage`, ADR-118 §4).
|
|
1110
|
+
...(storageDegraded ? {} : { pendingApprovalRepository: storageContext.pendingApprovals }),
|
|
720
1111
|
// ADR-077: порт исполнения команд (inline — исполнение в процессе).
|
|
721
1112
|
executionPort,
|
|
722
1113
|
// ADR-102: сборщик `usage`/`decision` роллапов (write-path).
|
|
723
1114
|
analytics,
|
|
1115
|
+
// Аудит выдачи сессионных shell-грантов (паттерны команд и каталоги
|
|
1116
|
+
// правила `external_directory`).
|
|
1117
|
+
onPermissionGrant: (entry) => {
|
|
1118
|
+
if (!securityAudit)
|
|
1119
|
+
return;
|
|
1120
|
+
void securityAudit.append({
|
|
1121
|
+
id: `sa_${generateId()}`,
|
|
1122
|
+
ts: nowISO(),
|
|
1123
|
+
actor: entry.actor,
|
|
1124
|
+
scope: 'permission',
|
|
1125
|
+
action: 'grant',
|
|
1126
|
+
source: 'runtime',
|
|
1127
|
+
before: null,
|
|
1128
|
+
after: {
|
|
1129
|
+
sessionId: entry.sessionId,
|
|
1130
|
+
patterns: entry.patterns,
|
|
1131
|
+
directories: entry.directories,
|
|
1132
|
+
command: entry.command,
|
|
1133
|
+
},
|
|
1134
|
+
version: 1,
|
|
1135
|
+
}).catch((err) => {
|
|
1136
|
+
console.warn(`[permission] аудит гранта не записан: ${err instanceof Error ? err.message : String(err)}`);
|
|
1137
|
+
});
|
|
1138
|
+
},
|
|
724
1139
|
contextBuilder,
|
|
725
1140
|
contextConfig,
|
|
726
1141
|
providerLoader,
|
|
@@ -733,11 +1148,31 @@ executionConfig) {
|
|
|
733
1148
|
// (ниже, `PluginRuntime`) — блоки плагинов попадают в промпт сессии.
|
|
734
1149
|
promptBlocks,
|
|
735
1150
|
mcpManager,
|
|
1151
|
+
// Workstream A1: реестр MCP и снимок инстанса — read-only тулы
|
|
1152
|
+
// `synth_info`/`synth_mcp_list`/`synth_mcp_test`. Политика читается live.
|
|
1153
|
+
mcpRegistry: mcpRegistryStore,
|
|
1154
|
+
getMcpNetworkPolicy: () => egressResolver.resolveMcp(),
|
|
1155
|
+
instanceMeta,
|
|
736
1156
|
projectStore,
|
|
737
1157
|
// Онбординг: тул `profile_update` сохраняет ответы интервью в профиль.
|
|
738
1158
|
profilesStore,
|
|
739
1159
|
// ADR-076 §T6: тот же store, что у git/ssh-роутов — без дублей инстансов.
|
|
740
1160
|
sshKeyStore,
|
|
1161
|
+
// ADR-076: таймауты сетевых git-операций (`git.cloneTimeoutMs`/`fetchTimeoutMs`)
|
|
1162
|
+
// для git-сервиса тулов `project_repo_*`; git-роуты получают те же значения.
|
|
1163
|
+
...(config.synth.git?.cloneTimeoutMs !== undefined
|
|
1164
|
+
? { gitCloneTimeoutMs: config.synth.git.cloneTimeoutMs }
|
|
1165
|
+
: {}),
|
|
1166
|
+
...(config.synth.git?.fetchTimeoutMs !== undefined
|
|
1167
|
+
? { gitFetchTimeoutMs: config.synth.git.fetchTimeoutMs }
|
|
1168
|
+
: {}),
|
|
1169
|
+
// Таймауты git-тулов по классу операции: локальные изменяющие и сетевые.
|
|
1170
|
+
...(config.synth.git?.localTimeoutMs !== undefined
|
|
1171
|
+
? { gitLocalTimeoutMs: config.synth.git.localTimeoutMs }
|
|
1172
|
+
: {}),
|
|
1173
|
+
...(config.synth.git?.networkTimeoutMs !== undefined
|
|
1174
|
+
? { gitNetworkTimeoutMs: config.synth.git.networkTimeoutMs }
|
|
1175
|
+
: {}),
|
|
741
1176
|
// ADR-096 (W2.4): словари классификации — порт из контекста хранения.
|
|
742
1177
|
dictionaryStore,
|
|
743
1178
|
// ADR-115/ADR-116: blob-порт гидратации вложений — из контекста хранения
|
|
@@ -746,9 +1181,21 @@ executionConfig) {
|
|
|
746
1181
|
// ADR-115: модальности модели — из её конфига (общий резолвер инстанса,
|
|
747
1182
|
// выше: им же пользуются шаги пайплайнов).
|
|
748
1183
|
resolveModelModalities,
|
|
1184
|
+
// Совместимость протокола (provider+model) из каталога.
|
|
1185
|
+
resolveModelCompatibility,
|
|
1186
|
+
// Лимит вывода модели из каталога (кап `max_tokens`) + дефолт `llm.maxTokens`.
|
|
1187
|
+
resolveModelMaxOutputTokens,
|
|
1188
|
+
// Понятные ошибки движка: провайдер/модель отключены — fail-closed.
|
|
1189
|
+
providerAvailability,
|
|
1190
|
+
resolveModelEnabled,
|
|
1191
|
+
defaultMaxOutputTokens: config.synth.llm.maxTokens,
|
|
749
1192
|
// ADR-115: `attachments.workspaceFallback` — материализация отброшенных
|
|
750
1193
|
// вложений в workspace; live-конфиг (проверяется на каждый ход).
|
|
751
1194
|
attachmentsConfig: () => attachmentsSettings.getConfig(),
|
|
1195
|
+
// Политика контекстного окна — live-геттер (перед каждым LLM-вызовом).
|
|
1196
|
+
contextWindowPolicy: () => contextWindowSettings.getPolicy(),
|
|
1197
|
+
// Бюджет промпта саб-агента — live-геттер (runtime-настройка из UI).
|
|
1198
|
+
getSubagentMaxInputTokens: () => subagentMaxInputTokensSettings.getValue(),
|
|
752
1199
|
// ADR-115: каталог моделей инстанса для агента (тул `list_models`):
|
|
753
1200
|
// тот же `modelStore`, что у `GET /api/v2/models` (каталог провайдеров +
|
|
754
1201
|
// ручные override), поэтому модальности совпадают с UI.
|
|
@@ -767,6 +1214,8 @@ executionConfig) {
|
|
|
767
1214
|
decisionConfig: effectiveDecisionSettings,
|
|
768
1215
|
permissionConfig: config.synth.permission,
|
|
769
1216
|
defaultPlanMode: config.synth.session.planMode,
|
|
1217
|
+
// Секция `session.autoTitle` — авто-именование сессии (ранний триггер).
|
|
1218
|
+
...(config.synth.session?.autoTitle ? { autoTitle: config.synth.session.autoTitle } : {}),
|
|
770
1219
|
securityConfig,
|
|
771
1220
|
gatewayConfig,
|
|
772
1221
|
gatewayAuditLogger,
|
|
@@ -800,7 +1249,7 @@ executionConfig) {
|
|
|
800
1249
|
// ADR-069 Фаза 1: проектные инструкции (merged chain AGENTS.md).
|
|
801
1250
|
instructionsConfig: config.synth.instructions,
|
|
802
1251
|
// ADR-069 Фаза 2a: project-trust гейт инструкций (config.skills.trustedProjectDirs).
|
|
803
|
-
instructionsTrustedProjectDirs:
|
|
1252
|
+
instructionsTrustedProjectDirs: effectiveSkillsTrustedProjectDirs,
|
|
804
1253
|
// ADR-089: late-bound funnel создания сессий для тула `task` (саб-агент).
|
|
805
1254
|
// Сервис создаётся ниже (после оркестратора) — геттер читает его в рантайме.
|
|
806
1255
|
getRequestSessionService: () => requestSessionService,
|
|
@@ -821,14 +1270,50 @@ executionConfig) {
|
|
|
821
1270
|
// `task` с `background: true` регистрирует фонового саб-агента и
|
|
822
1271
|
// возвращает управление сразу (PROP-096).
|
|
823
1272
|
...(backgroundService ? { backgroundService } : {}),
|
|
1273
|
+
// ADR-104 × ADR-111/ADR-113: остаток steer-очереди в конце хода — в очередь.
|
|
1274
|
+
requeueSteerMessages: (sessionId, messages, opts) => requeueSteerMessages(sessionId, messages, opts.autostart),
|
|
824
1275
|
// PROP-097: сервис фоновых шелл-процессов — тот же экземпляр, что у
|
|
825
1276
|
// реестра и тула `execute_shell` (через `ctx.extra.processService`).
|
|
826
1277
|
...(processService ? { processService } : {}),
|
|
827
|
-
//
|
|
1278
|
+
// PROP-124 §0: режим инстанса для SSH-ключей (`ssh.mode`) — live-геттер:
|
|
1279
|
+
// runtime-настройка (`/api/v2/settings/ssh`) применяется без рестарта.
|
|
1280
|
+
// `tools` (дефолт) — ключ в окружение команд не попадает; `agent` — ключи
|
|
1281
|
+
// роли агента выдаются вызову `execute_shell` (эфемерный `ssh-agent`).
|
|
1282
|
+
getSshMode: () => sshModeSettings.getMode(),
|
|
1283
|
+
// ADR-114: сервис worktree — тулы `git_worktree_*` (инвентарь
|
|
828
1284
|
// per-session рабочих каталогов проекта).
|
|
829
1285
|
...(worktreeService ? { worktreeService } : {}),
|
|
830
1286
|
backgroundEnabled: config.synth.background.enabled,
|
|
1287
|
+
// Предохранитель по объёму промпта саб-агента (`agents.subagentMaxInputTokens`).
|
|
1288
|
+
subagentMaxInputTokens: config.synth.agents.subagentMaxInputTokens,
|
|
1289
|
+
// Лимит глубины вложенности саб-агентов (`agents.subagentDepth`): при
|
|
1290
|
+
// превышении тул `task` отказывает до создания дочерней сессии.
|
|
1291
|
+
subagentDepth: config.synth.agents.subagentDepth,
|
|
1292
|
+
// Общий предел вывода инструментов (`tools.outputMaxLines`/
|
|
1293
|
+
// `tools.outputMaxBytes`) — усечение результата тула с пояснением.
|
|
1294
|
+
toolOutputLimits: {
|
|
1295
|
+
maxLines: config.synth.tools.outputMaxLines ?? DEFAULT_TOOL_OUTPUT_MAX_LINES,
|
|
1296
|
+
maxBytes: config.synth.tools.outputMaxBytes ?? DEFAULT_TOOL_OUTPUT_MAX_BYTES,
|
|
1297
|
+
},
|
|
831
1298
|
});
|
|
1299
|
+
// ADR-029: восстановление ожиданий подтверждения после рестарта инстанса.
|
|
1300
|
+
//
|
|
1301
|
+
// Живой реестр ожиданий живёт в памяти процесса и после рестарта пуст, а
|
|
1302
|
+
// вопрос пользователю — ещё актуально. Персистентная копия лежит в
|
|
1303
|
+
// **отдельном хранилище ожиданий** (`storage.pendingApprovals`, ADR-096) —
|
|
1304
|
+
// в документе сессии её быть не может (гонка lost update с точечной
|
|
1305
|
+
// записью истории, ADR-118 §4).
|
|
1306
|
+
//
|
|
1307
|
+
// Паттерн — тот же, что у `questionService.recoverOnStart()`: best-effort,
|
|
1308
|
+
// ошибка не роняет старт.
|
|
1309
|
+
if (!storageDegraded) {
|
|
1310
|
+
try {
|
|
1311
|
+
await orchestrator.restorePendingApprovals();
|
|
1312
|
+
}
|
|
1313
|
+
catch (err) {
|
|
1314
|
+
console.warn(`[permission] восстановление ожиданий подтверждения не удалось: ${err instanceof Error ? err.message : String(err)}`);
|
|
1315
|
+
}
|
|
1316
|
+
}
|
|
832
1317
|
// ADR-090 (Ф5б-2): эффективный конфиг слоя = config.yaml (+env) поверх
|
|
833
1318
|
// runtime-настроек (`settings.json`/PG): админка `/api/v2/settings/plugins`
|
|
834
1319
|
// пишет runtime, рантайм собирается при старте (применение — рестартом,
|
|
@@ -869,7 +1354,7 @@ executionConfig) {
|
|
|
869
1354
|
throw new PluginFacadeError('plugin.embedding_not_configured', `Провайдер «${providerName}» не найден в инстансе — эмбеддинги недоступны.`);
|
|
870
1355
|
}
|
|
871
1356
|
const model = opts?.model?.trim() || sharedConfig.defaultModel || '';
|
|
872
|
-
const provider = orchestrator.wrapProviderWithGateway(ProviderFactory.create(providerName, toCoreProviderConfig(sharedConfig, model)));
|
|
1357
|
+
const provider = orchestrator.wrapProviderWithGateway(ProviderFactory.create(providerName, toCoreProviderConfig(sharedConfig, model, undefined, resolveModelCompatibility(providerName, model))));
|
|
873
1358
|
const vectors = [];
|
|
874
1359
|
for (const text of texts) {
|
|
875
1360
|
vectors.push(await provider.embed(text));
|
|
@@ -1099,9 +1584,27 @@ executionConfig) {
|
|
|
1099
1584
|
// ADR-115 × ADR-089: сервис вложений проверяет ссылки `attachments[]` события
|
|
1100
1585
|
// (объект есть, метаданные совпадают со sidecar) и даёт лимиты
|
|
1101
1586
|
// `attachments.maxFilesPerMessage`/`maxBytesPerFile` (runtime-настройки — живые).
|
|
1587
|
+
// ADR-115 × ADR-077: медиа-раннер — единая точка запуска ffmpeg. Inline —
|
|
1588
|
+
// локально, remote — на исполнителе в общем workspace (`requires: ['ffmpeg']`).
|
|
1589
|
+
const mediaRunner = createMediaRunner({
|
|
1590
|
+
blobs: storageContext.blobs,
|
|
1591
|
+
executionPort,
|
|
1592
|
+
workspacesRoot: config.workspacesRoot,
|
|
1593
|
+
log: (message) => console.warn(message),
|
|
1594
|
+
});
|
|
1595
|
+
// ADR-115: серверные миниатюры вложений (content-addressed `.thumbs`).
|
|
1596
|
+
// Настройки (`attachments.thumbnail`: enabled/maxWidthPx) — тот же live-резолвер,
|
|
1597
|
+
// что у `AttachmentService` (runtime-патч применяется без рестарта).
|
|
1598
|
+
const attachmentThumbnails = new ThumbnailService({
|
|
1599
|
+
blobs: storageContext.blobs,
|
|
1600
|
+
runner: mediaRunner,
|
|
1601
|
+
config: () => attachmentsSettings.getConfig().thumbnail,
|
|
1602
|
+
log: (message) => console.warn(message),
|
|
1603
|
+
});
|
|
1102
1604
|
const eventAttachmentService = new AttachmentService({
|
|
1103
1605
|
blobs: storageContext.blobs,
|
|
1104
1606
|
config: () => attachmentsSettings.getConfig(),
|
|
1607
|
+
thumbnails: attachmentThumbnails,
|
|
1105
1608
|
});
|
|
1106
1609
|
const eventIngress = new EventIngress({
|
|
1107
1610
|
requestSessionService,
|
|
@@ -1122,23 +1625,16 @@ executionConfig) {
|
|
|
1122
1625
|
// ADR-036/ADR-101: провайдер шага — **всегда** через `GatewayProvider`
|
|
1123
1626
|
// (обёртка оркестратора: та же точка, что у пула провайдеров). Провайдер
|
|
1124
1627
|
// не кэшируется — обёртка подхватывает live-конфиг LLM Gateway.
|
|
1125
|
-
|
|
1126
|
-
|
|
1127
|
-
|
|
1128
|
-
|
|
1129
|
-
|
|
1130
|
-
|
|
1131
|
-
|
|
1132
|
-
|
|
1133
|
-
|
|
1134
|
-
|
|
1135
|
-
return orchestrator.wrapProviderWithGateway(ProviderFactory.create(providerName, coreConfig));
|
|
1136
|
-
}
|
|
1137
|
-
catch {
|
|
1138
|
-
// Провайдер не собран — шаг упадёт с `pipeline.provider_not_found`.
|
|
1139
|
-
return null;
|
|
1140
|
-
}
|
|
1141
|
-
};
|
|
1628
|
+
// ADR-101 §4 × `AgentDefinition`: провайдер/модель/температура/sampling
|
|
1629
|
+
// агента шага (`ctx.step.agent`) приоритетнее дефолтов инстанса — резолвер
|
|
1630
|
+
// общий с core-точкой сборки (`resolvePipelineStepProvider`).
|
|
1631
|
+
const resolvePipelineProvider = (ctx) => resolvePipelineStepProvider(ctx, {
|
|
1632
|
+
resolveLlmDefaults,
|
|
1633
|
+
loadProviderConfig: providerLoader,
|
|
1634
|
+
toProviderConfig: (shared, model) => toCoreProviderConfig(shared, model, undefined, resolveModelCompatibility(shared.name, model)),
|
|
1635
|
+
createProvider: (name, config, temperature, topP, topK) => ProviderFactory.create(name, config, temperature, topP, topK),
|
|
1636
|
+
wrapProvider: (provider) => orchestrator.wrapProviderWithGateway(provider),
|
|
1637
|
+
});
|
|
1142
1638
|
// ADR-101 §9 / ADR-116: артефакты прогонов — байты в общем blob-порте
|
|
1143
1639
|
// (отдельного хранилища артефактов нет). Тот же инстанс получают выход `file`
|
|
1144
1640
|
// (запись) и HTTP-раздача артефактов прогона (`GET
|
|
@@ -1206,13 +1702,15 @@ executionConfig) {
|
|
|
1206
1702
|
const sharedConfig = providerLoader(provider);
|
|
1207
1703
|
if (!sharedConfig)
|
|
1208
1704
|
return null;
|
|
1209
|
-
return orchestrator.wrapProviderWithGateway(ProviderFactory.create(provider, toCoreProviderConfig(sharedConfig, model)));
|
|
1705
|
+
return orchestrator.wrapProviderWithGateway(ProviderFactory.create(provider, toCoreProviderConfig(sharedConfig, model, undefined, resolveModelCompatibility(provider, model))));
|
|
1210
1706
|
}
|
|
1211
1707
|
catch {
|
|
1212
1708
|
return null;
|
|
1213
1709
|
}
|
|
1214
1710
|
},
|
|
1215
1711
|
hasFfmpeg: () => isFfmpegAvailable(executionPort).catch(() => false),
|
|
1712
|
+
executionPort,
|
|
1713
|
+
workspacesRoot: config.workspacesRoot,
|
|
1216
1714
|
promptTemplate: (language) => contextConfig.getMediaDeriveTemplate(language),
|
|
1217
1715
|
language: 'ru',
|
|
1218
1716
|
log: (message) => console.warn(message),
|
|
@@ -1357,6 +1855,12 @@ executionConfig) {
|
|
|
1357
1855
|
defaultsStore,
|
|
1358
1856
|
defaultWorkingDir,
|
|
1359
1857
|
getDefaultAgentId,
|
|
1858
|
+
/**
|
|
1859
|
+
* ADR-046/ADR-069: эффективный project-trust гейт скиллов/команд/инструкций
|
|
1860
|
+
* (runtime > config), снятый на старте; нужен резолверу инструкций в
|
|
1861
|
+
* `mount-routes`.
|
|
1862
|
+
*/
|
|
1863
|
+
skillsTrustedProjectDirs: effectiveSkillsTrustedProjectDirs,
|
|
1360
1864
|
egressResolver,
|
|
1361
1865
|
egressLogConfig,
|
|
1362
1866
|
securityAudit,
|
|
@@ -1384,6 +1888,8 @@ executionConfig) {
|
|
|
1384
1888
|
// ADR-115 × ADR-101: сервис вложений — проверка `attachments[]` в теле
|
|
1385
1889
|
// запуска прогона (тот же экземпляр, что у приёма событий).
|
|
1386
1890
|
pipelineAttachments: eventAttachmentService,
|
|
1891
|
+
// ADR-115: провайдер серверных миниатюр (`?variant=thumb` в роутах вложений).
|
|
1892
|
+
attachmentThumbnails,
|
|
1387
1893
|
// ADR-101: реестр активных прогонов — общий для HTTP-роута пайплайнов и
|
|
1388
1894
|
// встроенных тулов агента (soft-lock + отмена идущего прогона).
|
|
1389
1895
|
pipelineRunControl,
|
|
@@ -1402,9 +1908,22 @@ executionConfig) {
|
|
|
1402
1908
|
stopProcessLogPruner,
|
|
1403
1909
|
// ADR-115: GC осиротевших вложений сообщений.
|
|
1404
1910
|
stopAttachmentPruner,
|
|
1911
|
+
// ADR-115 × ADR-077: уборка временных каталогов медиа-раннера.
|
|
1912
|
+
stopMediaTempPruner,
|
|
1405
1913
|
// ADR-115: живое состояние настроек вложений (сервис/промпт/GC + админ-API).
|
|
1406
1914
|
attachmentsSettings,
|
|
1407
|
-
//
|
|
1915
|
+
// Политика ограничения контекстного окна (live, админ-API).
|
|
1916
|
+
contextWindowSettings,
|
|
1917
|
+
subagentMaxInputTokensSettings,
|
|
1918
|
+
// Лимит тяжёлых операций с сессиями (live, админ-API `/settings/limits`).
|
|
1919
|
+
sessionOpsPerMinuteSettings,
|
|
1920
|
+
// Дефолты оптимизации контекста новых сессий (live, админ-API).
|
|
1921
|
+
contextDefaultsSettings,
|
|
1922
|
+
// Instance-wide лимиты заметок сессии (live, админ-API).
|
|
1923
|
+
stickyNotesLimitsSettings,
|
|
1924
|
+
// PROP-124: режим инстанса для SSH-ключей (live, админ-API).
|
|
1925
|
+
sshModeSettings,
|
|
1926
|
+
// ADR-114: сервис worktree — HTTP-контур проектов и привязка сессии.
|
|
1408
1927
|
worktreeService,
|
|
1409
1928
|
webhookStore,
|
|
1410
1929
|
webhookDeliveryStore,
|