@itphx/synth-backend 0.10.0 → 0.10.1
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 +11 -0
- package/dist/app/bootstrap.js +19 -0
- package/dist/app/deps.d.ts +106 -0
- package/dist/app/deps.js +617 -0
- package/dist/app/listen.d.ts +29 -0
- package/dist/app/listen.js +298 -0
- package/dist/app/mount-routes.d.ts +18 -0
- package/dist/app/mount-routes.js +466 -0
- package/dist/app/sse-events.d.ts +15 -0
- package/dist/app/sse-events.js +83 -0
- package/dist/app.d.ts +15 -11
- package/dist/app.js +71 -1337
- package/dist/auth/guards.js +1 -1
- package/dist/auth/middleware.d.ts +7 -2
- package/dist/auth/middleware.js +18 -4
- package/dist/auth/oidc.d.ts +15 -0
- package/dist/auth/oidc.js +41 -3
- package/dist/auth/service-scope.d.ts +1 -1
- package/dist/auth/service-scope.js +1 -1
- package/dist/events/hub.d.ts +2 -2
- package/dist/lib/cors.d.ts +23 -0
- package/dist/lib/cors.js +24 -0
- package/dist/lib/i18n.js +10 -6
- package/dist/main.js +4 -4
- package/dist/middleware/rate-limiter.d.ts +4 -1
- package/dist/middleware/rate-limiter.js +4 -2
- package/dist/routes/audit.d.ts +1 -1
- package/dist/routes/audit.js +2 -2
- package/dist/routes/auth.js +28 -4
- package/dist/routes/gateway-patterns.d.ts +1 -1
- package/dist/routes/gateway-patterns.js +1 -1
- package/dist/routes/llm.js +5 -4
- package/dist/routes/mcp-registry.d.ts +3 -3
- package/dist/routes/mcp-registry.js +8 -8
- package/dist/routes/mcp.d.ts +1 -1
- package/dist/routes/mcp.js +1 -1
- package/dist/routes/projects.d.ts +4 -4
- package/dist/routes/projects.js +7 -7
- package/dist/routes/providers.js +1 -0
- package/dist/routes/sessions.d.ts +1 -1
- package/dist/routes/sessions.js +89 -13
- package/dist/routes/users.js +1 -1
- package/package.json +3 -3
package/dist/app/deps.js
ADDED
|
@@ -0,0 +1,617 @@
|
|
|
1
|
+
// Сборка зависимостей backend: хранилища, менеджеры, оркестратор, событийное
|
|
2
|
+
// ядро (ADR-089), планировщик (ADR-051), webhooks (ADR-052), скиллы/команды
|
|
3
|
+
// (ADR-046), runtime-настройки (ADR-005/023).
|
|
4
|
+
// Вынесено из `app.ts` (ADR-095, шаг 4b) — «вынос по швам», без изменения поведения.
|
|
5
|
+
import { mkdir } from 'node:fs/promises';
|
|
6
|
+
import { join } from 'node:path';
|
|
7
|
+
import { ensureDataDir, parsePrincipalId, resolveDefaultWorkspace, resolveSecretKey, } from '@itphx/synth-shared';
|
|
8
|
+
import { FileStore, SessionManager, EventBus, QueueProcessorManager, ContextConfig, ContextBuilder, ContextOptimizer, ChatOrchestrator, FileProfileStore, enqueueUserMessage, createToolRegistry, createAgentRegistry, McpManager, McpRegistryStore, DEFAULT_AGENT_ID, RuntimeSettingsStore, AuditLogger, mergeLlmGatewayConfig, mergeSecurityConfig, mergeMcpNetworkPolicy, mergeEventsConfig, mergeDecisionConfig, ProtectedPathsStore, SecretPatternStore, SkillService, resolveProjectSkillSeed, migrateSessionScopeSnapshots, CommandService, SkillBundleStore, SSHKeyStore, detectRuntimeDeps, syncProvidersFromEnv, HookBus, startEphemeralSweeper, EventBindingStore, EventApiKeyStore, EventJournalStore, EventRouter, RequestSessionService, EventIngress, eventToMessage, RouteRuleStore, ProjectRuleProvider, DecisionRuleProvider, IdentityClaimStore, ScheduleStore, SchedulerRuleProvider, SchedulerService, JobStore, MemoryDedupStore, FileDedupStore, AlwaysLeader, FileLeader, createExternalIdentityResolver, startEventJournalPruner, WebhookStore, WebhookDeliveryStore, WebhookService, startWebhookDeliveryPruner, JsonStore, ProjectStore, } from '@itphx/synth-core';
|
|
9
|
+
import { DefaultsStore } from '../lib/defaults-store.js';
|
|
10
|
+
import { EventHub } from '../events/hub.js';
|
|
11
|
+
import { seedDebugTestUsers } from './bootstrap.js';
|
|
12
|
+
/**
|
|
13
|
+
* Собрать зависимости backend-приложения (хранилища/менеджеры/оркестратор/
|
|
14
|
+
* событийное ядро/планировщик/webhooks). Роуты монтирует вызывающий
|
|
15
|
+
* (`mountBackendRoutes`), поэтому здесь нет ни одного `app.*`-вызова.
|
|
16
|
+
*/
|
|
17
|
+
export async function createBackendDeps(config) {
|
|
18
|
+
// Хранилища
|
|
19
|
+
const dataDir = config.dataDir;
|
|
20
|
+
await ensureDataDir(dataDir);
|
|
21
|
+
const fileStore = new FileStore({ dataDir });
|
|
22
|
+
const projectStore = new ProjectStore({ dataDir });
|
|
23
|
+
// ADR-030: ядровая шина хуков — общий инстанс для SessionManager и оркестратора.
|
|
24
|
+
const hooks = new HookBus();
|
|
25
|
+
const sessionManager = new SessionManager(fileStore, {
|
|
26
|
+
projectStore,
|
|
27
|
+
hooks,
|
|
28
|
+
// ADR-071 §2.4 / ADR-046 §4.5: системные дефолты для сессий без проекта.
|
|
29
|
+
systemDefaultsProvider: async () => ({
|
|
30
|
+
mcpDefaultOn: await mcpRegistryStore.toDefaultServers(),
|
|
31
|
+
skillsDefaultOn: (await resolveProjectSkillSeed(skillService, await settingsStore.getSkillsDisabledForNewProjects())).enabled,
|
|
32
|
+
}),
|
|
33
|
+
});
|
|
34
|
+
// ADR-089: авто-архивация ephemeral-сессий по TTL (таймер `unref`).
|
|
35
|
+
// Остановка — через хэндл `stopEphemeralSweeper` на graceful shutdown.
|
|
36
|
+
const stopEphemeralSweeper = startEphemeralSweeper(sessionManager);
|
|
37
|
+
// ADR-076 §T4: SSH-ключи агентов — core-хранилище поверх общего dataDir.
|
|
38
|
+
// Мастер-ключ: env `SYNTH_SECRET_KEY` > `config.security.secretKey` > файл dataDir.
|
|
39
|
+
const sshKeyStore = new SSHKeyStore({
|
|
40
|
+
dataDir,
|
|
41
|
+
secretKey: resolveSecretKey(config.synth),
|
|
42
|
+
env: process.env,
|
|
43
|
+
});
|
|
44
|
+
const providerStore = new JsonStore({ dataDir, subdir: 'providers' });
|
|
45
|
+
const modelStore = new JsonStore({ dataDir, subdir: 'models' });
|
|
46
|
+
const agentStore = new JsonStore({ dataDir, subdir: 'agents' });
|
|
47
|
+
const contextConfig = new ContextConfig({ userDataDir: `${dataDir}/context` });
|
|
48
|
+
const profilesStore = new FileProfileStore({ dataDir });
|
|
49
|
+
// ADR-036: хранилище кастомных regex-паттернов детекции секретов (override ?? дефолт)
|
|
50
|
+
const patternStore = new SecretPatternStore({ dataDir });
|
|
51
|
+
// Runtime-настройки (ADR-005): workspace/mcp из {dataDir}/settings.json (переживают рестарт)
|
|
52
|
+
const settingsStore = new RuntimeSettingsStore({ dataDir });
|
|
53
|
+
// ADR-075: дефолтный рабочий каталог — runtime-override `settings/workspace`
|
|
54
|
+
// приоритетнее config/env (`resolveDefaultWorkspace`), каталог создаётся
|
|
55
|
+
// заранее (как в core `server/app.ts`), чтобы инструменты не падали.
|
|
56
|
+
const runtimeWorkspace = await settingsStore.getWorkspace();
|
|
57
|
+
const defaultWorkingDir = runtimeWorkspace ?? resolveDefaultWorkspace(config.synth);
|
|
58
|
+
await mkdir(defaultWorkingDir, { recursive: true });
|
|
59
|
+
// Агент по умолчанию (админка «Агенты»): runtime-настройка поверх DEFAULT_AGENT_ID.
|
|
60
|
+
const getDefaultAgentId = async () => (await settingsStore.getDefaultAgent()) ?? DEFAULT_AGENT_ID;
|
|
61
|
+
// Умолчания оформления (ADR-005): {dataDir}/defaults.json (переживают рестарт)
|
|
62
|
+
const defaultsStore = new DefaultsStore({ dataDir });
|
|
63
|
+
// MCP: единый источник истины — реестр `McpRegistryStore` (ADR-071 §2.5).
|
|
64
|
+
// Legacy `YamlMcpConfigStore` удалён: instance-серверы из config.mcp.servers
|
|
65
|
+
// сидируются в реестр при старте (seed без дублирования по имени).
|
|
66
|
+
const mcpManager = new McpManager();
|
|
67
|
+
const mcpRegistryStore = new McpRegistryStore({ dataDir });
|
|
68
|
+
await mcpRegistryStore.seedFromConfig(config.synth.mcp.servers);
|
|
69
|
+
// Одно чтение реестра на все карты менеджера (вместо пяти).
|
|
70
|
+
const mcpMaps = await mcpRegistryStore.toManagerMaps();
|
|
71
|
+
mcpManager.setConfig(mcpMaps.servers);
|
|
72
|
+
mcpManager.setServerOrigins(mcpMaps.origins);
|
|
73
|
+
mcpManager.setServerTrusts(mcpMaps.trusts);
|
|
74
|
+
mcpManager.setServerAuthors(mcpMaps.authors);
|
|
75
|
+
mcpManager.setDefaultServers(mcpMaps.defaults);
|
|
76
|
+
// ADR-071 §2.4: системный мастер-флаг серверов (реестр `enabled`).
|
|
77
|
+
mcpManager.setServerSystemEnabled(mcpMaps.systemEnabled);
|
|
78
|
+
// ADR-071 §2.3.1: политика сетевого доступа HTTP-серверов (SSRF/egress).
|
|
79
|
+
// Runtime-настройка из админки (settings.json) приоритетнее config.yaml и
|
|
80
|
+
// переживает рестарт; храним в изменяемой переменной (аксессор `live`), чтобы
|
|
81
|
+
// registry-роуты видели свежее значение без рестарта. Слияние — единым
|
|
82
|
+
// helper'ом mergeMcpNetworkPolicy (тот же, что и в core).
|
|
83
|
+
const runtimeMcpNetworkPolicy = await settingsStore.getMcpNetworkPolicy();
|
|
84
|
+
let effectiveNetworkPolicy = mergeMcpNetworkPolicy(config.synth.mcp.networkPolicy, runtimeMcpNetworkPolicy);
|
|
85
|
+
mcpManager.setNetworkPolicy(effectiveNetworkPolicy);
|
|
86
|
+
// Сидирование тестовых пользователей (debug mode) — до построения рантайма
|
|
87
|
+
// (паритет с прежним `app.ts`: сид стоял между хранилищами и рантаймом).
|
|
88
|
+
seedDebugTestUsers(profilesStore, config.auth);
|
|
89
|
+
const eventBus = new EventBus();
|
|
90
|
+
const queueManager = new QueueProcessorManager();
|
|
91
|
+
// ADR-052 (этап II): исходящие webhooks — реестр подписок (signing-секрет
|
|
92
|
+
// `whsec_…` шифруется at-rest мастер-ключом), append-only журнал доставок и
|
|
93
|
+
// движок над той же шиной `EventBus`, что обслуживает сессии/SSE. Движок
|
|
94
|
+
// подписывается на ВСЕ события шины (`subscribeAll`) — паритет с core
|
|
95
|
+
// `server/app.ts`; `webhooks.enabled: false` (дефолт) глушит диспетчеризацию.
|
|
96
|
+
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
|
+
const webhookService = new WebhookService({
|
|
104
|
+
store: webhookStore,
|
|
105
|
+
deliveryStore: webhookDeliveryStore,
|
|
106
|
+
eventBus,
|
|
107
|
+
config: webhooksConfig,
|
|
108
|
+
});
|
|
109
|
+
webhookService.start();
|
|
110
|
+
// Retention-очистка журнала доставок: сразу при старте + каждые 6 ч (unref).
|
|
111
|
+
const stopWebhookDeliveryPruner = startWebhookDeliveryPruner(webhookDeliveryStore, {
|
|
112
|
+
getRetentionDays: () => webhooksConfig.deliveryRetentionDays,
|
|
113
|
+
});
|
|
114
|
+
// Context builder
|
|
115
|
+
const contextBuilder = new ContextBuilder(contextConfig, {
|
|
116
|
+
profilesStore,
|
|
117
|
+
projectDataDir: `${dataDir}/projects`,
|
|
118
|
+
defaultLanguage: 'ru',
|
|
119
|
+
});
|
|
120
|
+
// Provider loader
|
|
121
|
+
const providerLoader = (name) => {
|
|
122
|
+
// При старте загружаем все конфиги — JsonStore.list() не подходит для быстрого lookup
|
|
123
|
+
// поэтому кешируем провайдеров в Map
|
|
124
|
+
return providerCache.get(name) ?? null;
|
|
125
|
+
};
|
|
126
|
+
// ADR-038: синхронизация провайдеров/моделей из переменных окружения (общая
|
|
127
|
+
// core-реализация). Вызывается ПОСЛЕ создания providerStore/modelStore, но ДО
|
|
128
|
+
// заполнения кэшей, чтобы env-провайдеры попали в providerCache/modelCache.
|
|
129
|
+
await syncProvidersFromEnv(providerStore, modelStore);
|
|
130
|
+
// Кеш провайдеров (заполняется при старте)
|
|
131
|
+
const providerCache = new Map();
|
|
132
|
+
(await providerStore.list()).forEach((p) => {
|
|
133
|
+
providerCache.set(p.name, p);
|
|
134
|
+
});
|
|
135
|
+
// Кеш моделей (заполняется при старте)
|
|
136
|
+
const modelCache = new Map();
|
|
137
|
+
(await modelStore.list()).forEach((m) => {
|
|
138
|
+
modelCache.set(m.id, m);
|
|
139
|
+
});
|
|
140
|
+
// Загрузчик сохранённого контекстного окна модели (ModelConfig.contextWindow)
|
|
141
|
+
const modelWindowLoader = (modelName) => {
|
|
142
|
+
for (const m of modelCache.values()) {
|
|
143
|
+
if (m.name === modelName || m.id === modelName) {
|
|
144
|
+
return m.contextWindow && m.contextWindow > 0 ? m.contextWindow : 0;
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
return 0;
|
|
148
|
+
};
|
|
149
|
+
// Резолв модели по id или имени (для LLM Proxy — гибридный режим).
|
|
150
|
+
const modelLoader = (model) => {
|
|
151
|
+
const byId = modelCache.get(model);
|
|
152
|
+
if (byId)
|
|
153
|
+
return byId;
|
|
154
|
+
for (const m of modelCache.values()) {
|
|
155
|
+
if (m.name === model)
|
|
156
|
+
return m;
|
|
157
|
+
}
|
|
158
|
+
return null;
|
|
159
|
+
};
|
|
160
|
+
// ContextOptimizer
|
|
161
|
+
const summarizationConfig = config.synth.summarization;
|
|
162
|
+
const contextOptimizer = new ContextOptimizer(contextConfig, providerLoader, summarizationConfig, modelWindowLoader);
|
|
163
|
+
// Set ContextOptimizer on QueueProcessorManager
|
|
164
|
+
queueManager.setContextOptimizer(contextOptimizer);
|
|
165
|
+
// Model price loader
|
|
166
|
+
const modelPriceLoader = (modelName) => {
|
|
167
|
+
// Поиск по имени модели в кэше (сначала по полному ID, потом по name)
|
|
168
|
+
for (const m of modelCache.values()) {
|
|
169
|
+
if (m.name === modelName || m.id === modelName) {
|
|
170
|
+
return {
|
|
171
|
+
inputPrice: m.inputPrice,
|
|
172
|
+
outputPrice: m.outputPrice,
|
|
173
|
+
cacheReadPrice: m.cacheReadPrice,
|
|
174
|
+
cacheWritePrice: m.cacheWritePrice,
|
|
175
|
+
// Валюта: модель → провайдер → USD (обратная совместимость).
|
|
176
|
+
currency: m.currency ?? providerCache.get(m.provider)?.currency ?? 'USD',
|
|
177
|
+
};
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
return null;
|
|
181
|
+
};
|
|
182
|
+
// LLM Gateway: общий AuditLogger создаётся снаружи, чтобы эндпоинт
|
|
183
|
+
// GET /api/v2/audit и оркестратор писали/читали один и тот же JSONL-файл.
|
|
184
|
+
const gatewayAuditLogger = new AuditLogger(config.synth.llmGateway.audit.logPath || join(dataDir, 'audit', 'llm-gateway.jsonl'));
|
|
185
|
+
// Полный лог запросов/ответов LLM (после обфускации) — один JSONL-файл для
|
|
186
|
+
// записи (оркестратор) и чтения (GET /api/v2/logs/llm).
|
|
187
|
+
const gatewayPayloadLogPath = config.synth.llmGateway.payloadLogPath
|
|
188
|
+
|| join(dataDir, 'audit', 'llm-payloads.jsonl');
|
|
189
|
+
// ADR-036: runtime-настройка LLM Gateway (тумблер из UI, {dataDir}/settings.json)
|
|
190
|
+
// приоритетнее config.yaml — мёржим при старте, чтобы шлюз применялся к оркестратору.
|
|
191
|
+
const runtimeGateway = await settingsStore.getLlmGatewaySettings();
|
|
192
|
+
const gatewayConfig = mergeLlmGatewayConfig(config.synth.llmGateway, runtimeGateway);
|
|
193
|
+
// ADR-040: runtime-настройка защищённых путей (тумблер из UI, {dataDir}/settings.json)
|
|
194
|
+
// приоритетнее config.yaml — мёржим при старте, чтобы защита применялась к оркестратору.
|
|
195
|
+
const runtimeSecurity = await settingsStore.getSecuritySettings();
|
|
196
|
+
const securityConfig = mergeSecurityConfig(config.synth.security, runtimeSecurity);
|
|
197
|
+
// ADR-071 §2.3: runtime-политика встроенных инструментов (админка) приоритетнее config.yaml
|
|
198
|
+
const runtimeToolsPolicy = await settingsStore.getToolsPolicy();
|
|
199
|
+
const toolsPolicy = runtimeToolsPolicy ?? config.synth.tools.policy;
|
|
200
|
+
// ADR-071 §2.3: runtime-политика MCP-инструментов (админка) приоритетнее config.yaml
|
|
201
|
+
const runtimeMcpPolicy = await settingsStore.getMcpPolicy();
|
|
202
|
+
const mcpPolicy = runtimeMcpPolicy ?? config.synth.mcp.policy;
|
|
203
|
+
// ADR-071 §2.6: runtime-отключение инструментов (админка) приоритетнее config.yaml
|
|
204
|
+
const runtimeToolsDisabled = await settingsStore.getToolsDisabled();
|
|
205
|
+
const toolsDisabled = runtimeToolsDisabled ?? config.synth.tools.disabled ?? { capabilities: [], tools: [] };
|
|
206
|
+
// ADR-046 §4.5: runtime-отключение скиллов (админка) — hard-gate системного уровня.
|
|
207
|
+
const skillsDisabled = (await settingsStore.getSkillsDisabled())
|
|
208
|
+
?? { categories: [], groups: [], skills: [] };
|
|
209
|
+
// ADR-084: runtime/эффективный конфиг decision-слоя (админка) приоритетнее
|
|
210
|
+
// config.yaml `decision`. Live-применяется ко всем трём потребителям
|
|
211
|
+
// (микро-каскад, роутер, события ADR-089) через `live.setDecision`.
|
|
212
|
+
const runtimeDecision = await settingsStore.getDecision();
|
|
213
|
+
let effectiveDecisionSettings = mergeDecisionConfig(config.synth.decision, runtimeDecision);
|
|
214
|
+
const protectedPathsStore = new ProtectedPathsStore({ dataDir });
|
|
215
|
+
// Orchestrator
|
|
216
|
+
const toolRegistry = createToolRegistry();
|
|
217
|
+
const agentRegistry = createAgentRegistry(toolRegistry, join(dataDir, 'agents'));
|
|
218
|
+
// ADR-046: сервис скиллов (discovery + instance-запись + каталог промпта).
|
|
219
|
+
const skillService = new SkillService({
|
|
220
|
+
dataDir,
|
|
221
|
+
configPaths: config.synth.skills.paths,
|
|
222
|
+
urls: config.synth.skills.urls,
|
|
223
|
+
trustedProjectDirs: config.synth.skills.trustedProjectDirs,
|
|
224
|
+
toolsets: config.synth.skills.toolsets,
|
|
225
|
+
});
|
|
226
|
+
// ADR-046 §7: slash-команды и bundles (mirror core).
|
|
227
|
+
const bundleStore = new SkillBundleStore({
|
|
228
|
+
dataDir,
|
|
229
|
+
bundlesPath: config.synth.commands.bundlesPath,
|
|
230
|
+
});
|
|
231
|
+
const commandService = new CommandService({
|
|
232
|
+
config: {
|
|
233
|
+
dataDir,
|
|
234
|
+
commandsPaths: config.synth.commands.paths,
|
|
235
|
+
bundlesPath: config.synth.commands.bundlesPath,
|
|
236
|
+
conflict: config.synth.commands.conflict,
|
|
237
|
+
maxArgumentsLength: config.synth.commands.maxArgumentsLength,
|
|
238
|
+
maxRenderedBytes: config.synth.commands.maxRenderedBytes,
|
|
239
|
+
toolsets: config.synth.skills.toolsets,
|
|
240
|
+
trustedProjectDirs: config.synth.skills.trustedProjectDirs,
|
|
241
|
+
inlineShell: config.synth.skills.inlineShell ?? false,
|
|
242
|
+
},
|
|
243
|
+
skillRuntime: skillService,
|
|
244
|
+
skillSource: skillService,
|
|
245
|
+
bundleStore,
|
|
246
|
+
});
|
|
247
|
+
const orchestrator = new ChatOrchestrator({
|
|
248
|
+
sessionManager,
|
|
249
|
+
eventBus,
|
|
250
|
+
hooks,
|
|
251
|
+
contextBuilder,
|
|
252
|
+
contextConfig,
|
|
253
|
+
providerLoader,
|
|
254
|
+
contextOptimizer,
|
|
255
|
+
modelPriceLoader,
|
|
256
|
+
dataDir,
|
|
257
|
+
toolRegistry,
|
|
258
|
+
agentRegistry,
|
|
259
|
+
mcpManager,
|
|
260
|
+
projectStore,
|
|
261
|
+
// Онбординг: тул `profile_update` сохраняет ответы интервью в профиль.
|
|
262
|
+
profilesStore,
|
|
263
|
+
// ADR-076 §T6: тот же store, что у git/ssh-роутов — без дублей инстансов.
|
|
264
|
+
sshKeyStore,
|
|
265
|
+
workspacesRoot: config.workspacesRoot,
|
|
266
|
+
// ADR-075: backend — managed-режим, workspace вне workspacesRoot запрещён.
|
|
267
|
+
workspaceManaged: true,
|
|
268
|
+
// ADR-075: без defaultWorkingDir сессия без проекта получала бы
|
|
269
|
+
// {dataDir}/workspaces/default мимо runtime-override settings/workspace.
|
|
270
|
+
defaultWorkingDir,
|
|
271
|
+
routerConfig: config.synth.router,
|
|
272
|
+
// ADR-084: decision-слой микро-каскада (config.decision).
|
|
273
|
+
decisionConfig: effectiveDecisionSettings,
|
|
274
|
+
permissionConfig: config.synth.permission,
|
|
275
|
+
defaultPlanMode: config.synth.session.planMode,
|
|
276
|
+
securityConfig,
|
|
277
|
+
gatewayConfig,
|
|
278
|
+
gatewayAuditLogger,
|
|
279
|
+
gatewayPayloadLogPath,
|
|
280
|
+
gatewayPatternStore: patternStore,
|
|
281
|
+
cachePolicy: config.synth.llm.cache,
|
|
282
|
+
toolsPolicy,
|
|
283
|
+
mcpPolicy,
|
|
284
|
+
toolsDisabled,
|
|
285
|
+
// ADR-046 §4.5: системный hard-gate скиллов (runtime-настройка).
|
|
286
|
+
skillsDisabled,
|
|
287
|
+
// ADR-070 §2.9.1: зависимости окружения (git/rg/sh) — детекция при старте.
|
|
288
|
+
runtimeDeps: await detectRuntimeDeps(),
|
|
289
|
+
// ADR-071 §2.6: калибровка chars-per-token по модели (runtime-настройки).
|
|
290
|
+
tokenRatioLoader: (model) => settingsStore.getTokenRatio(model),
|
|
291
|
+
onTokenRatioCalibrated: (model, ratio) => settingsStore.setTokenRatio(model, ratio),
|
|
292
|
+
// ADR-046 §5: каталог скиллов в промпт + тул `skill`.
|
|
293
|
+
skillRuntime: skillService,
|
|
294
|
+
// ADR-046 §7: резолвинг `/`-команд до LLM.
|
|
295
|
+
commandRuntime: commandService,
|
|
296
|
+
// ADR-069 Фаза 1: проектные инструкции (merged chain AGENTS.md).
|
|
297
|
+
instructionsConfig: config.synth.instructions,
|
|
298
|
+
// ADR-069 Фаза 2a: project-trust гейт инструкций (config.skills.trustedProjectDirs).
|
|
299
|
+
instructionsTrustedProjectDirs: config.synth.skills.trustedProjectDirs,
|
|
300
|
+
// ADR-089: late-bound funnel создания сессий для тула `task` (саб-агент).
|
|
301
|
+
// Сервис создаётся ниже (после оркестратора) — геттер читает его в рантайме.
|
|
302
|
+
getRequestSessionService: () => requestSessionService,
|
|
303
|
+
// ADR-051: late-bound резолвер активности расписания в сессии (ScheduleStore
|
|
304
|
+
// создаётся ниже) — включает статический блок `Scheduler` в промпт.
|
|
305
|
+
isSchedulerActive: (sid) => scheduleStore.hasEnabledTargetFor(sid),
|
|
306
|
+
// «Стоп»: персистентный флаг отмены сессии — прерывает длинный
|
|
307
|
+
// многоитерационный Tool Use на границе итерации (backoff/гонка).
|
|
308
|
+
isCancelRequested: async (sid) => (await sessionManager.getSession(sid))?.status.cancelRequested === true,
|
|
309
|
+
});
|
|
310
|
+
const processMessage = orchestrator.createProcessMessage();
|
|
311
|
+
// ADR-089: ядро маршрутизации внешних событий и единый funnel создания сессий.
|
|
312
|
+
// Funnel подключён к `POST /sessions` и тулу `task` (Этап 5); приём внешних
|
|
313
|
+
// событий — на следующих этапах.
|
|
314
|
+
const eventBindingStore = new EventBindingStore({ dataDir });
|
|
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 });
|
|
322
|
+
// ADR-089 (Блок 3): runtime-настройки «События» (админка) поверх config.yaml.
|
|
323
|
+
const runtimeEvents = await settingsStore.getEvents();
|
|
324
|
+
const effectiveEvents = mergeEventsConfig(config.synth.events, runtimeEvents);
|
|
325
|
+
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
|
+
const eventRouter = new EventRouter({
|
|
332
|
+
bindingStore: eventBindingStore,
|
|
333
|
+
journal: eventJournal,
|
|
334
|
+
hooks,
|
|
335
|
+
dedupStore,
|
|
336
|
+
config: {
|
|
337
|
+
allowedSources: effectiveEvents.allowedSources,
|
|
338
|
+
defaultMode: effectiveEvents.defaultMode,
|
|
339
|
+
defaultEphemeralTtl: effectiveEvents.ephemeralTtl,
|
|
340
|
+
autoBind: effectiveEvents.autoBind,
|
|
341
|
+
autoBindAgentTemplate: effectiveEvents.autoBindAgentTemplate,
|
|
342
|
+
},
|
|
343
|
+
});
|
|
344
|
+
// ADR-089 (Блок 2): retention-очистка журнала событий (сразу + каждые 6 ч).
|
|
345
|
+
const stopEventJournalPruner = startEventJournalPruner(eventJournal, {
|
|
346
|
+
getRetentionDays: () => effectiveEventsSettings.journalRetentionDays,
|
|
347
|
+
});
|
|
348
|
+
// ADR-051 (срез) / ADR-089: правило маршрутизации cron-событий по расписанию
|
|
349
|
+
// (паритет с 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
|
+
eventRouter.registerRuleProvider(new SchedulerRuleProvider(scheduleStore, effectiveEvents.ephemeralTtl));
|
|
356
|
+
// ADR-089: правила маршрутизации по матчу события (после scheduler).
|
|
357
|
+
eventRouter.registerRuleProvider(new ProjectRuleProvider(routeRuleStore, effectiveEvents.ephemeralTtl));
|
|
358
|
+
// ADR-084 × ADR-089: decision-маршрутизация при промахе декларативных правил
|
|
359
|
+
// (opt-in `events.decisionRouting`). Паритет с core `server/app.ts`.
|
|
360
|
+
eventRouter.registerRuleProvider(new DecisionRuleProvider({
|
|
361
|
+
resolver: {
|
|
362
|
+
getDecisionProvider: (name, model) => orchestrator.getDecisionProvider(name, model),
|
|
363
|
+
},
|
|
364
|
+
getEventsConfig: () => ({
|
|
365
|
+
decisionRouting: effectiveEventsSettings.decisionRouting,
|
|
366
|
+
defaultEphemeralTtl: effectiveEventsSettings.ephemeralTtl,
|
|
367
|
+
}),
|
|
368
|
+
getDecisionConfig: () => effectiveDecisionSettings,
|
|
369
|
+
getAgentCandidates: () => agentRegistry.list().map((agent) => ({
|
|
370
|
+
id: agent.id,
|
|
371
|
+
displayName: agent.displayName,
|
|
372
|
+
description: agent.description,
|
|
373
|
+
})),
|
|
374
|
+
}));
|
|
375
|
+
// ADR-089: резолвинг `agentTemplate` (события/правила) через `AgentRegistry`:
|
|
376
|
+
// неизвестный или отключённый агент → `null`.
|
|
377
|
+
const resolveAgentTemplate = (template) => {
|
|
378
|
+
const agent = agentRegistry.get(template);
|
|
379
|
+
return agent && agent.enabled ? agent.id : null;
|
|
380
|
+
};
|
|
381
|
+
// EventHub — центральный диспетчер подписок. Создаётся до funnel: колбэк
|
|
382
|
+
// `onSessionMaterialized` подписывает клиентов владельца на сессии,
|
|
383
|
+
// созданные после их подключения (`subscribeToSession`, ADR-089).
|
|
384
|
+
const eventHub = new EventHub(eventBus, sessionManager);
|
|
385
|
+
// ADR-089: резолвер внешнего отправителя (профиль `identities`, principalId) в
|
|
386
|
+
// пользователя инстанса; override `identityMap` — приоритетнее профиля.
|
|
387
|
+
// `getIdentityMap` читает актуальное значение — `onEventsChange` обновляет
|
|
388
|
+
// runtime-настройку live. Вынесен в локальную константу: переиспользуется
|
|
389
|
+
// в `deps` и в `deliver` (attribution: `displayName` приоритетнее `payload.from`).
|
|
390
|
+
const resolveExternalIdentity = createExternalIdentityResolver({
|
|
391
|
+
profiles: profilesStore,
|
|
392
|
+
getIdentityMap: () => effectiveEventsSettings.identityMap,
|
|
393
|
+
});
|
|
394
|
+
const requestSessionService = new RequestSessionService({
|
|
395
|
+
sessionManager,
|
|
396
|
+
eventRouter,
|
|
397
|
+
bindingStore: eventBindingStore,
|
|
398
|
+
hooks,
|
|
399
|
+
config: {
|
|
400
|
+
defaultEphemeralTtl: effectiveEvents.ephemeralTtl,
|
|
401
|
+
unknownAgentTemplate: effectiveEvents.unknownAgentTemplate,
|
|
402
|
+
},
|
|
403
|
+
resolveAgentTemplate,
|
|
404
|
+
// ADR-089: маппинг идентичности внешнего отправителя на владельца сессии
|
|
405
|
+
// (`events.identityMap`) — напр. Telegram-чат → человек.
|
|
406
|
+
identityMap: effectiveEvents.identityMap,
|
|
407
|
+
// ADR-089: резолвинг внешнего отправителя → владелец сессии.
|
|
408
|
+
resolveExternalIdentity,
|
|
409
|
+
// ADR-089 (claim-flow): неизвестному отправителю выдаём одноразовый код
|
|
410
|
+
// подтверждения владения идентичностью (`provider`/`externalId` — из
|
|
411
|
+
// серверного разбора `identity.principalId`).
|
|
412
|
+
issueIdentityClaim: async (event) => {
|
|
413
|
+
const principalId = event.identity?.principalId;
|
|
414
|
+
if (!principalId)
|
|
415
|
+
return null;
|
|
416
|
+
const parsed = parsePrincipalId(principalId);
|
|
417
|
+
if (!parsed)
|
|
418
|
+
return null;
|
|
419
|
+
const claim = await identityClaimStore.create({
|
|
420
|
+
provider: parsed.provider,
|
|
421
|
+
externalId: parsed.externalId,
|
|
422
|
+
...(event.identity?.chatKey ? { chatKey: event.identity.chatKey } : {}),
|
|
423
|
+
principalId,
|
|
424
|
+
});
|
|
425
|
+
return { code: claim.code, expiresAt: claim.expiresAt };
|
|
426
|
+
},
|
|
427
|
+
// ADR-089: подписка хаба на сессию владельца сразу после материализации —
|
|
428
|
+
// чтобы клиент, подключённый до создания сессии (events-funnel), получал
|
|
429
|
+
// её события. `subscribeToSession` синхронно ставит подписки, поэтому
|
|
430
|
+
// последующая доставка события не теряется.
|
|
431
|
+
onSessionMaterialized: (session) => {
|
|
432
|
+
const owner = session.ownerId || session.userId;
|
|
433
|
+
if (!owner)
|
|
434
|
+
return;
|
|
435
|
+
void eventHub.subscribeToSession(owner, session.id).catch((e) => console.warn('subscribeToSession failed:', e));
|
|
436
|
+
},
|
|
437
|
+
// ADR-089: дефолтные provider/model инстанса (llm.defaultProvider/defaultModel)
|
|
438
|
+
// — для сессий из внешних событий (materialize ephemeral/bind), чтобы агент
|
|
439
|
+
// мог ответить без ручной простановки модели.
|
|
440
|
+
resolveLlmDefaults: () => ({
|
|
441
|
+
provider: config.synth.llm.defaultProvider,
|
|
442
|
+
model: config.synth.llm.defaultModel,
|
|
443
|
+
}),
|
|
444
|
+
// ADR-089: агент по умолчанию инстанса — чтобы сессия из внешнего события
|
|
445
|
+
// (auto-bind/bind/ephemeral) фиксировала `settings.agentRole` и UI рисовал
|
|
446
|
+
// бейдж агента (паритет с `POST /api/v2/sessions`). Источник — админка
|
|
447
|
+
// «Агенты» (`getDefaultAgentId`) поверх `DEFAULT_AGENT_ID`.
|
|
448
|
+
resolveDefaultAgent: getDefaultAgentId,
|
|
449
|
+
// ADR-089: UI-событие после материализации внешнего события.
|
|
450
|
+
publish: (type, sessionId, data) => eventBus.publish(sessionId, type, data),
|
|
451
|
+
deliver: async (sessionId, event, mode, context) => {
|
|
452
|
+
// ADR-051: cron-сообщение — от системного пользователя `Scheduler`, текст
|
|
453
|
+
// задания — чистый контент сообщения (описание Scheduler — в system-блоке).
|
|
454
|
+
let message = eventToMessage(event);
|
|
455
|
+
// ADR-089: для слинкованного человека `displayName` из резолвера приоритетнее
|
|
456
|
+
// имени из `payload.from` (tg-имя). Cron (`Scheduler`) не переопределяем.
|
|
457
|
+
if (event.source !== 'cron' && event.identity?.principalId) {
|
|
458
|
+
try {
|
|
459
|
+
const linked = await resolveExternalIdentity(event.identity);
|
|
460
|
+
if (linked?.displayName)
|
|
461
|
+
message.author = linked.displayName;
|
|
462
|
+
}
|
|
463
|
+
catch {
|
|
464
|
+
// attribution не критична — оставляем автора из `eventToMessage`
|
|
465
|
+
}
|
|
466
|
+
}
|
|
467
|
+
// ADR-089 (этап 5): эффективные роли отправителя — в metadata хода.
|
|
468
|
+
if (context) {
|
|
469
|
+
message.metadata = {
|
|
470
|
+
...(message.metadata ?? {}),
|
|
471
|
+
effective_roles: context.roles,
|
|
472
|
+
identity_linked: context.linked,
|
|
473
|
+
};
|
|
474
|
+
}
|
|
475
|
+
if (mode === 'run') {
|
|
476
|
+
// ADR-036: обфускация user-сообщения ДО сохранения в историю (паритет с
|
|
477
|
+
// prompt-путём — core routes/sessions.ts).
|
|
478
|
+
await enqueueUserMessage(sessionManager, eventBus, sessionId, message, queueManager, processMessage, (sid, msg) => orchestrator.obfuscateUserMessageForHistory(sid, msg));
|
|
479
|
+
}
|
|
480
|
+
else {
|
|
481
|
+
// ADR-036: `defer` тоже кладёт сообщение в историю — обфусцируем до
|
|
482
|
+
// постановки. Старт процессора не выполняем (только очередь владельца).
|
|
483
|
+
message = await orchestrator.obfuscateUserMessageForHistory(sessionId, message);
|
|
484
|
+
await sessionManager.addPendingMessage(sessionId, message);
|
|
485
|
+
}
|
|
486
|
+
},
|
|
487
|
+
});
|
|
488
|
+
// ADR-089: ingress-точка приёма внешних событий (Этап 6).
|
|
489
|
+
const eventIngress = new EventIngress({ requestSessionService });
|
|
490
|
+
// ADR-051 (срез) / ADR-089: планировщик публикует cron-события через ingress.
|
|
491
|
+
// `start()` гейтится конфигом (`scheduler.enabled: false` — тикер не стартует),
|
|
492
|
+
// ошибки старта логируются и не роняют процесс; остановка — `stopScheduler`.
|
|
493
|
+
const schedulerTickMs = config.synth.scheduler.tickSec * 1000;
|
|
494
|
+
const schedulerService = new SchedulerService({
|
|
495
|
+
scheduleStore,
|
|
496
|
+
ingress: eventIngress,
|
|
497
|
+
jobStore,
|
|
498
|
+
tickMs: schedulerTickMs,
|
|
499
|
+
defaultEphemeralTtl: effectiveEvents.ephemeralTtl,
|
|
500
|
+
catchUp: config.synth.scheduler.catchUp,
|
|
501
|
+
jobRetentionDays: config.synth.scheduler.jobRetentionDays,
|
|
502
|
+
// ADR-051/ADR-089: тикер стартует только у лидера (default — AlwaysLeader).
|
|
503
|
+
leader: config.synth.scheduler.leaderElection === 'file'
|
|
504
|
+
? new FileLeader({ dataDir, tickMs: schedulerTickMs })
|
|
505
|
+
: new AlwaysLeader(),
|
|
506
|
+
});
|
|
507
|
+
if (config.synth.scheduler.enabled !== false) {
|
|
508
|
+
void schedulerService.start().catch((err) => {
|
|
509
|
+
console.warn(`[scheduler] не удалось запустить: ${err instanceof Error ? err.message : String(err)}`);
|
|
510
|
+
});
|
|
511
|
+
}
|
|
512
|
+
// ADR-071 §2.4 / ADR-046 §4.5: разовая миграция снапшотов скоупа существующих сессий.
|
|
513
|
+
await migrateSessionScopeSnapshots({
|
|
514
|
+
sessionManager,
|
|
515
|
+
projectStore,
|
|
516
|
+
settingsStore,
|
|
517
|
+
resolveSystemDefaults: async () => ({
|
|
518
|
+
mcpDefaultOn: await mcpRegistryStore.toDefaultServers(),
|
|
519
|
+
skillsDefaultOn: (await resolveProjectSkillSeed(skillService, await settingsStore.getSkillsDisabledForNewProjects())).enabled,
|
|
520
|
+
}),
|
|
521
|
+
}).catch(() => 0);
|
|
522
|
+
return {
|
|
523
|
+
dataDir,
|
|
524
|
+
projectStore,
|
|
525
|
+
sessionManager,
|
|
526
|
+
// ADR-089: остановка sweeper'а авто-архивации ephemeral-сессий.
|
|
527
|
+
stopEphemeralSweeper,
|
|
528
|
+
sshKeyStore,
|
|
529
|
+
providerStore,
|
|
530
|
+
modelStore,
|
|
531
|
+
agentStore,
|
|
532
|
+
contextConfig,
|
|
533
|
+
profilesStore,
|
|
534
|
+
patternStore,
|
|
535
|
+
settingsStore,
|
|
536
|
+
defaultsStore,
|
|
537
|
+
defaultWorkingDir,
|
|
538
|
+
getDefaultAgentId,
|
|
539
|
+
mcpManager,
|
|
540
|
+
mcpRegistryStore,
|
|
541
|
+
eventBus,
|
|
542
|
+
queueManager,
|
|
543
|
+
webhookStore,
|
|
544
|
+
webhookDeliveryStore,
|
|
545
|
+
webhookService,
|
|
546
|
+
stopWebhookDeliveryPruner,
|
|
547
|
+
webhooksConfig,
|
|
548
|
+
providerLoader,
|
|
549
|
+
providerCache,
|
|
550
|
+
modelCache,
|
|
551
|
+
modelLoader,
|
|
552
|
+
modelWindowLoader,
|
|
553
|
+
contextOptimizer,
|
|
554
|
+
gatewayAuditLogger,
|
|
555
|
+
gatewayPayloadLogPath,
|
|
556
|
+
gatewayConfig,
|
|
557
|
+
protectedPathsStore,
|
|
558
|
+
toolRegistry,
|
|
559
|
+
agentRegistry,
|
|
560
|
+
skillService,
|
|
561
|
+
bundleStore,
|
|
562
|
+
commandService,
|
|
563
|
+
orchestrator,
|
|
564
|
+
processMessage,
|
|
565
|
+
eventBindingStore,
|
|
566
|
+
eventApiKeyStore,
|
|
567
|
+
eventJournal,
|
|
568
|
+
routeRuleStore,
|
|
569
|
+
identityClaimStore,
|
|
570
|
+
eventRouter,
|
|
571
|
+
stopEventJournalPruner,
|
|
572
|
+
scheduleStore,
|
|
573
|
+
jobStore,
|
|
574
|
+
resolveAgentTemplate,
|
|
575
|
+
eventHub,
|
|
576
|
+
requestSessionService,
|
|
577
|
+
eventIngress,
|
|
578
|
+
schedulerService,
|
|
579
|
+
/**
|
|
580
|
+
* Живые (мутируемые) эффективные настройки — аксессоры, а не значения:
|
|
581
|
+
* обновляются админкой в рантайме (`mountBackendRoutes`), читаются
|
|
582
|
+
* потребителями через замыкания (ADR-071 §2.3.1 / ADR-084 / ADR-089).
|
|
583
|
+
*/
|
|
584
|
+
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
|
+
/** ADR-089: runtime-настройки «События» (`enabled`/per-key лимит — роуты). */
|
|
593
|
+
getEvents: () => effectiveEventsSettings,
|
|
594
|
+
/** ADR-089: live-применение runtime-настроек «События» — Router/funnel/pruner. */
|
|
595
|
+
setEvents: (effective) => {
|
|
596
|
+
effectiveEventsSettings = effective;
|
|
597
|
+
eventRouter.updateConfig({
|
|
598
|
+
allowedSources: effective.allowedSources,
|
|
599
|
+
defaultMode: effective.defaultMode,
|
|
600
|
+
defaultEphemeralTtl: effective.ephemeralTtl,
|
|
601
|
+
autoBind: effective.autoBind,
|
|
602
|
+
autoBindAgentTemplate: effective.autoBindAgentTemplate,
|
|
603
|
+
});
|
|
604
|
+
requestSessionService.updateConfig({
|
|
605
|
+
defaultEphemeralTtl: effective.ephemeralTtl,
|
|
606
|
+
unknownAgentTemplate: effective.unknownAgentTemplate,
|
|
607
|
+
identityMap: effective.identityMap,
|
|
608
|
+
});
|
|
609
|
+
},
|
|
610
|
+
/** ADR-084: live-применение runtime-настроек decision-слоя (микро-каскад/роутер). */
|
|
611
|
+
setDecision: (effective) => {
|
|
612
|
+
effectiveDecisionSettings = effective;
|
|
613
|
+
orchestrator.setDecisionConfig(effective);
|
|
614
|
+
},
|
|
615
|
+
},
|
|
616
|
+
};
|
|
617
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { IncomingMessage } from 'node:http';
|
|
2
|
+
import type { Hono } from 'hono';
|
|
3
|
+
import type { EventBus, SessionManager, QueueProcessorManager, ChatOrchestrator, ProjectStore } from '@itphx/synth-core';
|
|
4
|
+
import type { AuthKit } from '../auth/middleware.js';
|
|
5
|
+
import type { EventHub } from '../events/hub.js';
|
|
6
|
+
export interface BackendListenDeps {
|
|
7
|
+
app: Hono;
|
|
8
|
+
auth: AuthKit;
|
|
9
|
+
eventHub: EventHub;
|
|
10
|
+
sessionManager: SessionManager;
|
|
11
|
+
projectStore: ProjectStore;
|
|
12
|
+
eventBus: EventBus;
|
|
13
|
+
queueManager: QueueProcessorManager;
|
|
14
|
+
processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>;
|
|
15
|
+
orchestrator: ChatOrchestrator;
|
|
16
|
+
/** Порт по умолчанию (`backendConfig.port`). */
|
|
17
|
+
defaultPort: number;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Создать функцию `listen` хэндла приложения.
|
|
21
|
+
*
|
|
22
|
+
* Поднять HTTP-сервер с WebSocket /ws/events на указанном порту
|
|
23
|
+
* (порт 0 → эфемерный). Возвращает фактический порт.
|
|
24
|
+
*/
|
|
25
|
+
export declare function createBackendListen(deps: BackendListenDeps): (port?: number, host?: string) => Promise<{
|
|
26
|
+
server: import("http").Server<typeof IncomingMessage, typeof import("http").ServerResponse>;
|
|
27
|
+
wss: import("ws").Server<typeof import("ws").default, typeof IncomingMessage>;
|
|
28
|
+
port: number;
|
|
29
|
+
}>;
|