@itphx/synth-backend 0.8.8 → 0.10.0

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.js CHANGED
@@ -17,10 +17,13 @@ import { Readable } from 'node:stream';
17
17
  import { Hono } from 'hono';
18
18
  import { cors } from 'hono/cors';
19
19
  import { logger } from 'hono/logger';
20
- import { FileStore, SessionManager, EventBus, QueueProcessorManager, ContextConfig, ContextBuilder, ContextOptimizer, ChatOrchestrator, FileProfileStore, enqueueUserMessage, createToolRegistry, createAgentRegistry, McpManager, McpRegistryStore, RuntimeSettingsStore, createSettingsRoutes, AuditLogger, mergeLlmGatewayConfig, mergeSecurityConfig, mergeMcpNetworkPolicy, ProtectedPathsStore, SecretPatternStore, RateLimiter, DictionaryStore, createDictionaryRoutes, SkillService, createSkillRoutes, resolveProjectSkillSeed, migrateSessionScopeSnapshots, CommandService, createCommandRoutes, createSkillBundleRoutes, SkillBundleStore, createSessionSkillScopeRoutes, createProjectSkillScopeRoutes, createSkillSettingsRoutes, ProjectInstructionsResolver, createInstructionsInfoResolver, createContextRoutes as createCoreContextRoutes, DEFAULT_AGENT_ID, SSHKeyStore, createGitRoutes, createSshKeyRoutes, createAgentSshKeyRoutes, createFsRoutes, resolveProjectWorkspace, detectRuntimeDeps, syncProvidersFromEnv, } from '@itphx/synth-core';
21
- import { nowISO, ensureDataDir, MessageRole, generateStreamId, SYNTH_VERSION, DEFAULT_LLM_GATEWAY_RATE_LIMIT, ProjectRole, resolveDefaultWorkspace, resolveSecretKey } from '@itphx/synth-shared';
20
+ import { createMiddleware } from 'hono/factory';
21
+ import { FileStore, SessionManager, EventBus, QueueProcessorManager, ContextConfig, ContextBuilder, ContextOptimizer, ChatOrchestrator, FileProfileStore, enqueueUserMessage, createToolRegistry, createAgentRegistry, McpManager, McpRegistryStore, RuntimeSettingsStore, createSettingsRoutes, AuditLogger, mergeLlmGatewayConfig, mergeSecurityConfig, mergeMcpNetworkPolicy, mergeEventsConfig, mergeDecisionConfig, ProtectedPathsStore, SecretPatternStore, RateLimiter, DictionaryStore, createDictionaryRoutes, SkillService, createSkillRoutes, resolveProjectSkillSeed, migrateSessionScopeSnapshots, CommandService, createCommandRoutes, createSkillBundleRoutes, SkillBundleStore, createSessionSkillScopeRoutes, createProjectSkillScopeRoutes, createSkillSettingsRoutes, createIdentityRoutes, ProjectInstructionsResolver, createInstructionsInfoResolver, createContextRoutes as createCoreContextRoutes, DEFAULT_AGENT_ID, SSHKeyStore, createGitRoutes, createSshKeyRoutes, createAgentSshKeyRoutes, createFsRoutes, resolveProjectWorkspace, detectRuntimeDeps, syncProvidersFromEnv, HookBus, startEphemeralSweeper, EventBindingStore, EventApiKeyStore, EventJournalStore, EventRouter, RequestSessionService, EventIngress, eventToMessage, RouteRuleStore, ProjectRuleProvider, DecisionRuleProvider, IdentityClaimStore, ScheduleStore, SchedulerRuleProvider, SchedulerService, JobStore, MemoryDedupStore, FileDedupStore, AlwaysLeader, FileLeader, createEventRoutes, createSchedulerRoutes, createExternalIdentityResolver, startEventJournalPruner, ServiceApiKeyStore, createServiceKeyRoutes, KeyRateLimiter, getServiceCredential, applyBootstrapServiceKeys, WebhookStore, WebhookDeliveryStore, WebhookService, startWebhookDeliveryPruner, createWebhookRoutes, getPublicOpenApiDocument, } from '@itphx/synth-core';
22
+ import { nowISO, ensureDataDir, MessageRole, generateStreamId, SYNTH_VERSION, DEFAULT_LLM_GATEWAY_RATE_LIMIT, ProjectRole, resolveDefaultWorkspace, resolveSecretKey, parsePrincipalId } from '@itphx/synth-shared';
22
23
  import { loadBackendConfig } from './lib/app-config.js';
23
24
  import { createAuthMiddleware } from './auth/middleware.js';
25
+ import { scopeGuard, projectGuard } from './auth/service-scope.js';
26
+ import { requireAdminOrScope } from './auth/guards.js';
24
27
  import { createAuthRoutes } from './routes/auth.js';
25
28
  import { createProjectRoutes, createProjectAccess } from './routes/projects.js';
26
29
  import { createSessionRoutes } from './routes/sessions.js';
@@ -131,22 +134,69 @@ export async function createBackendApp(opts = {}) {
131
134
  },
132
135
  credentials: true,
133
136
  }));
134
- const auth = createAuthMiddleware(backendConfig.auth);
137
+ // AD-052 (этап I): реестр service-key создаётся до auth — резолвер
138
+ // `synth_svc_…` нужен аутентификации (паритет с core `server/app.ts`).
139
+ const serviceApiKeyStore = new ServiceApiKeyStore({ dataDir: backendConfig.dataDir });
140
+ // AD-052/O1: идемпотентный bootstrap installer-ключей из env/Secret
141
+ // (best-effort — ошибка конфигурации не роняет старт, пишется в лог).
142
+ await applyBootstrapServiceKeys(serviceApiKeyStore, backendConfig.synth.security.bootstrapServiceKeys ?? []);
143
+ const auth = createAuthMiddleware({
144
+ ...backendConfig.auth,
145
+ resolveServiceKey: async (raw) => {
146
+ const resolved = await serviceApiKeyStore.resolveBySecret(raw);
147
+ if (!resolved)
148
+ return null;
149
+ const key = resolved.key;
150
+ // Best-effort отметка использования — не блокирует и не роняет запрос.
151
+ void serviceApiKeyStore.touch(key.id).catch(() => { });
152
+ return {
153
+ user: {
154
+ id: `service:${key.id}`,
155
+ username: key.label,
156
+ roles: [...key.roles],
157
+ preferredLanguage: 'ru',
158
+ createdAt: key.createdAt,
159
+ teamRole: key.roles[0] ?? 'USER',
160
+ notes: '',
161
+ interviewCompleted: false,
162
+ isLocal: false,
163
+ },
164
+ credential: resolved.credential,
165
+ };
166
+ },
167
+ });
135
168
  // Прикрепляем пользователя ко всем запросам
136
169
  app.use('*', auth.attachUser);
170
+ // AD-052: per-key rate limit service-key (`rateLimitPerMinute` ключа;
171
+ // 0/не задан — без лимита). После attachUser: `serviceKey` уже в контексте.
172
+ const serviceKeyRateLimiter = new KeyRateLimiter(60_000);
173
+ app.use('*', createMiddleware(async (c, next) => {
174
+ const credential = getServiceCredential(c);
175
+ const limit = credential?.rateLimitPerMinute ?? 0;
176
+ if (credential && limit > 0 && !serviceKeyRateLimiter.check(credential.keyId, limit)) {
177
+ return c.json({ error: { code: 'RATE_LIMITED', message: t('errors.rateLimited.serviceKey', undefined, c) } }, 429);
178
+ }
179
+ await next();
180
+ }));
137
181
  // Хранилища
138
182
  const dataDir = backendConfig.dataDir;
139
183
  await ensureDataDir(dataDir);
140
184
  const fileStore = new FileStore({ dataDir });
141
185
  const projectStore = new ProjectStore({ dataDir });
186
+ // AD-030: ядровая шина хуков — общий инстанс для SessionManager и оркестратора.
187
+ const hooks = new HookBus();
142
188
  const sessionManager = new SessionManager(fileStore, {
143
189
  projectStore,
190
+ hooks,
144
191
  // AD-071 §2.4 / AD-046 §4.5: системные дефолты для сессий без проекта.
145
192
  systemDefaultsProvider: async () => ({
146
193
  mcpDefaultOn: await mcpRegistryStore.toDefaultServers(),
147
194
  skillsDefaultOn: (await resolveProjectSkillSeed(skillService, await settingsStore.getSkillsDisabledForNewProjects())).enabled,
148
195
  }),
149
196
  });
197
+ // AD-089: авто-архивация ephemeral-сессий по TTL (таймер `unref`).
198
+ // Остановка — через хэндл `stopEphemeralSweeper` на graceful shutdown.
199
+ const stopEphemeralSweeper = startEphemeralSweeper(sessionManager);
150
200
  // AD-076 §T4: SSH-ключи агентов — core-хранилище поверх общего dataDir.
151
201
  // Мастер-ключ: env `SYNTH_SECRET_KEY` > `config.security.secretKey` > файл dataDir.
152
202
  const sshKeyStore = new SSHKeyStore({
@@ -209,6 +259,29 @@ export async function createBackendApp(opts = {}) {
209
259
  }
210
260
  const eventBus = new EventBus();
211
261
  const queueManager = new QueueProcessorManager();
262
+ // AD-052 (этап II): исходящие webhooks — реестр подписок (signing-секрет
263
+ // `whsec_…` шифруется at-rest мастер-ключом), append-only журнал доставок и
264
+ // движок над той же шиной `EventBus`, что обслуживает сессии/SSE. Движок
265
+ // подписывается на ВСЕ события шины (`subscribeAll`) — паритет с core
266
+ // `server/app.ts`; `webhooks.enabled: false` (дефолт) глушит диспетчеризацию.
267
+ const webhooksConfig = backendConfig.synth.webhooks;
268
+ const webhookStore = new WebhookStore({
269
+ dataDir: backendConfig.dataDir,
270
+ secretKey: resolveSecretKey(backendConfig.synth),
271
+ env: process.env,
272
+ });
273
+ const webhookDeliveryStore = new WebhookDeliveryStore({ dataDir: backendConfig.dataDir });
274
+ const webhookService = new WebhookService({
275
+ store: webhookStore,
276
+ deliveryStore: webhookDeliveryStore,
277
+ eventBus,
278
+ config: webhooksConfig,
279
+ });
280
+ webhookService.start();
281
+ // Retention-очистка журнала доставок: сразу при старте + каждые 6 ч (unref).
282
+ const stopWebhookDeliveryPruner = startWebhookDeliveryPruner(webhookDeliveryStore, {
283
+ getRetentionDays: () => webhooksConfig.deliveryRetentionDays,
284
+ });
212
285
  // Context builder
213
286
  const contextBuilder = new ContextBuilder(contextConfig, {
214
287
  profilesStore,
@@ -304,6 +377,11 @@ export async function createBackendApp(opts = {}) {
304
377
  // AD-046 §4.5: runtime-отключение скиллов (админка) — hard-gate системного уровня.
305
378
  const skillsDisabled = (await settingsStore.getSkillsDisabled())
306
379
  ?? { categories: [], groups: [], skills: [] };
380
+ // AD-084: runtime/эффективный конфиг decision-слоя (админка) приоритетнее
381
+ // config.yaml `decision`. Live-применяется ко всем трём потребителям
382
+ // (микро-каскад, роутер, события AD-089) через `onDecisionChange`.
383
+ const runtimeDecision = await settingsStore.getDecision();
384
+ let effectiveDecisionSettings = mergeDecisionConfig(backendConfig.synth.decision, runtimeDecision);
307
385
  const protectedPathsStore = new ProtectedPathsStore({ dataDir });
308
386
  // Orchestrator
309
387
  const toolRegistry = createToolRegistry();
@@ -340,6 +418,7 @@ export async function createBackendApp(opts = {}) {
340
418
  const orchestrator = new ChatOrchestrator({
341
419
  sessionManager,
342
420
  eventBus,
421
+ hooks,
343
422
  contextBuilder,
344
423
  contextConfig,
345
424
  providerLoader,
@@ -350,6 +429,8 @@ export async function createBackendApp(opts = {}) {
350
429
  agentRegistry,
351
430
  mcpManager,
352
431
  projectStore,
432
+ // Онбординг: тул `profile_update` сохраняет ответы интервью в профиль.
433
+ profilesStore,
353
434
  // AD-076 §T6: тот же store, что у git/ssh-роутов — без дублей инстансов.
354
435
  sshKeyStore,
355
436
  workspacesRoot: backendConfig.workspacesRoot,
@@ -359,6 +440,8 @@ export async function createBackendApp(opts = {}) {
359
440
  // {dataDir}/workspaces/default мимо runtime-override settings/workspace.
360
441
  defaultWorkingDir,
361
442
  routerConfig: backendConfig.synth.router,
443
+ // AD-084: decision-слой микро-каскада (config.decision).
444
+ decisionConfig: effectiveDecisionSettings,
362
445
  permissionConfig: backendConfig.synth.permission,
363
446
  defaultPlanMode: backendConfig.synth.session.planMode,
364
447
  securityConfig,
@@ -385,8 +468,218 @@ export async function createBackendApp(opts = {}) {
385
468
  instructionsConfig: backendConfig.synth.instructions,
386
469
  // AD-069 Фаза 2a: project-trust гейт инструкций (config.skills.trustedProjectDirs).
387
470
  instructionsTrustedProjectDirs: backendConfig.synth.skills.trustedProjectDirs,
471
+ // AD-089: late-bound funnel создания сессий для тула `task` (саб-агент).
472
+ // Сервис создаётся ниже (после оркестратора) — геттер читает его в рантайме.
473
+ getRequestSessionService: () => requestSessionService,
474
+ // AD-051: late-bound резолвер активности расписания в сессии (ScheduleStore
475
+ // создаётся ниже) — включает статический блок `Scheduler` в промпт.
476
+ isSchedulerActive: (sid) => scheduleStore.hasEnabledTargetFor(sid),
477
+ // «Стоп»: персистентный флаг отмены сессии — прерывает длинный
478
+ // многоитерационный Tool Use на границе итерации (backoff/гонка).
479
+ isCancelRequested: async (sid) => (await sessionManager.getSession(sid))?.status.cancelRequested === true,
388
480
  });
389
481
  const processMessage = orchestrator.createProcessMessage();
482
+ // AD-089: ядро маршрутизации внешних событий и единый funnel создания сессий.
483
+ // Funnel подключён к `POST /sessions` и тулу `task` (Этап 5); приём внешних
484
+ // событий — на следующих этапах.
485
+ const eventBindingStore = new EventBindingStore({ dataDir });
486
+ // AD-089/AD-052: API-ключи привязок для аутентификации приёма событий.
487
+ const eventApiKeyStore = new EventApiKeyStore({ dataDir });
488
+ const eventJournal = new EventJournalStore({ dataDir });
489
+ // AD-089: реестр правил маршрутизации (проектные/инстанс-правила).
490
+ const routeRuleStore = new RouteRuleStore({ dataDir });
491
+ // AD-089 (claim-flow): одноразовые коды подтверждения владения идентичностью.
492
+ const identityClaimStore = new IdentityClaimStore({ dataDir });
493
+ // AD-089 (Блок 3): runtime-настройки «События» (админка) поверх config.yaml.
494
+ const runtimeEvents = await settingsStore.getEvents();
495
+ const effectiveEvents = mergeEventsConfig(backendConfig.synth.events, runtimeEvents);
496
+ let effectiveEventsSettings = effectiveEvents;
497
+ // AD-051/AD-089: источник дедупа — in-process (default) или файловый
498
+ // межпроцессный (`events.dedupStore: file`).
499
+ const dedupStore = backendConfig.synth.events.dedupStore === 'file'
500
+ ? new FileDedupStore({ dataDir })
501
+ : new MemoryDedupStore();
502
+ const eventRouter = new EventRouter({
503
+ bindingStore: eventBindingStore,
504
+ journal: eventJournal,
505
+ hooks,
506
+ dedupStore,
507
+ config: {
508
+ allowedSources: effectiveEvents.allowedSources,
509
+ defaultMode: effectiveEvents.defaultMode,
510
+ defaultEphemeralTtl: effectiveEvents.ephemeralTtl,
511
+ autoBind: effectiveEvents.autoBind,
512
+ autoBindAgentTemplate: effectiveEvents.autoBindAgentTemplate,
513
+ },
514
+ });
515
+ // AD-089 (Блок 2): retention-очистка журнала событий (сразу + каждые 6 ч).
516
+ const stopEventJournalPruner = startEventJournalPruner(eventJournal, {
517
+ getRetentionDays: () => effectiveEventsSettings.journalRetentionDays,
518
+ });
519
+ // AD-051 (срез) / AD-089: правило маршрутизации cron-событий по расписанию
520
+ // (паритет с core `server/app.ts`; store без дублей).
521
+ const scheduleStore = new ScheduleStore({
522
+ dataDir,
523
+ crossProcess: backendConfig.synth.scheduler.crossProcessLocks,
524
+ });
525
+ const jobStore = new JobStore({ dataDir });
526
+ eventRouter.registerRuleProvider(new SchedulerRuleProvider(scheduleStore, effectiveEvents.ephemeralTtl));
527
+ // AD-089: правила маршрутизации по матчу события (после scheduler).
528
+ eventRouter.registerRuleProvider(new ProjectRuleProvider(routeRuleStore, effectiveEvents.ephemeralTtl));
529
+ // AD-084 × AD-089: decision-маршрутизация при промахе декларативных правил
530
+ // (opt-in `events.decisionRouting`). Паритет с core `server/app.ts`.
531
+ eventRouter.registerRuleProvider(new DecisionRuleProvider({
532
+ resolver: {
533
+ getDecisionProvider: (name, model) => orchestrator.getDecisionProvider(name, model),
534
+ },
535
+ getEventsConfig: () => ({
536
+ decisionRouting: effectiveEventsSettings.decisionRouting,
537
+ defaultEphemeralTtl: effectiveEventsSettings.ephemeralTtl,
538
+ }),
539
+ getDecisionConfig: () => effectiveDecisionSettings,
540
+ getAgentCandidates: () => agentRegistry.list().map((agent) => ({
541
+ id: agent.id,
542
+ displayName: agent.displayName,
543
+ description: agent.description,
544
+ })),
545
+ }));
546
+ // AD-089: резолвинг `agentTemplate` (события/правила) через `AgentRegistry`:
547
+ // неизвестный или отключённый агент → `null`.
548
+ const resolveAgentTemplate = (template) => {
549
+ const agent = agentRegistry.get(template);
550
+ return agent && agent.enabled ? agent.id : null;
551
+ };
552
+ // EventHub — центральный диспетчер подписок. Создаётся до funnel: колбэк
553
+ // `onSessionMaterialized` подписывает клиентов владельца на сессии,
554
+ // созданные после их подключения (`subscribeToSession`, AD-089).
555
+ const eventHub = new EventHub(eventBus, sessionManager);
556
+ // AD-089: резолвер внешнего отправителя (профиль `identities`, principalId) в
557
+ // пользователя инстанса; override `identityMap` — приоритетнее профиля.
558
+ // `getIdentityMap` читает актуальное значение — `onEventsChange` обновляет
559
+ // runtime-настройку live. Вынесен в локальную константу: переиспользуется
560
+ // в `deps` и в `deliver` (attribution: `displayName` приоритетнее `payload.from`).
561
+ const resolveExternalIdentity = createExternalIdentityResolver({
562
+ profiles: profilesStore,
563
+ getIdentityMap: () => effectiveEventsSettings.identityMap,
564
+ });
565
+ const requestSessionService = new RequestSessionService({
566
+ sessionManager,
567
+ eventRouter,
568
+ bindingStore: eventBindingStore,
569
+ hooks,
570
+ config: {
571
+ defaultEphemeralTtl: effectiveEvents.ephemeralTtl,
572
+ unknownAgentTemplate: effectiveEvents.unknownAgentTemplate,
573
+ },
574
+ resolveAgentTemplate,
575
+ // AD-089: маппинг идентичности внешнего отправителя на владельца сессии
576
+ // (`events.identityMap`) — напр. Telegram-чат → человек.
577
+ identityMap: effectiveEvents.identityMap,
578
+ // AD-089: резолвинг внешнего отправителя → владелец сессии.
579
+ resolveExternalIdentity,
580
+ // AD-089 (claim-flow): неизвестному отправителю выдаём одноразовый код
581
+ // подтверждения владения идентичностью (`provider`/`externalId` — из
582
+ // серверного разбора `identity.principalId`).
583
+ issueIdentityClaim: async (event) => {
584
+ const principalId = event.identity?.principalId;
585
+ if (!principalId)
586
+ return null;
587
+ const parsed = parsePrincipalId(principalId);
588
+ if (!parsed)
589
+ return null;
590
+ const claim = await identityClaimStore.create({
591
+ provider: parsed.provider,
592
+ externalId: parsed.externalId,
593
+ ...(event.identity?.chatKey ? { chatKey: event.identity.chatKey } : {}),
594
+ principalId,
595
+ });
596
+ return { code: claim.code, expiresAt: claim.expiresAt };
597
+ },
598
+ // AD-089: подписка хаба на сессию владельца сразу после материализации —
599
+ // чтобы клиент, подключённый до создания сессии (events-funnel), получал
600
+ // её события. `subscribeToSession` синхронно ставит подписки, поэтому
601
+ // последующая доставка события не теряется.
602
+ onSessionMaterialized: (session) => {
603
+ const owner = session.ownerId || session.userId;
604
+ if (!owner)
605
+ return;
606
+ void eventHub.subscribeToSession(owner, session.id).catch((e) => console.warn('subscribeToSession failed:', e));
607
+ },
608
+ // AD-089: дефолтные provider/model инстанса (llm.defaultProvider/defaultModel)
609
+ // — для сессий из внешних событий (materialize ephemeral/bind), чтобы агент
610
+ // мог ответить без ручной простановки модели.
611
+ resolveLlmDefaults: () => ({
612
+ provider: backendConfig.synth.llm.defaultProvider,
613
+ model: backendConfig.synth.llm.defaultModel,
614
+ }),
615
+ // AD-089: агент по умолчанию инстанса — чтобы сессия из внешнего события
616
+ // (auto-bind/bind/ephemeral) фиксировала `settings.agentRole` и UI рисовал
617
+ // бейдж агента (паритет с `POST /api/v2/sessions`). Источник — админка
618
+ // «Агенты» (`getDefaultAgentId`) поверх `DEFAULT_AGENT_ID`.
619
+ resolveDefaultAgent: getDefaultAgentId,
620
+ // AD-089: UI-событие после материализации внешнего события.
621
+ publish: (type, sessionId, data) => eventBus.publish(sessionId, type, data),
622
+ deliver: async (sessionId, event, mode, context) => {
623
+ // AD-051: cron-сообщение — от системного пользователя `Scheduler`, текст
624
+ // задания — чистый контент сообщения (описание Scheduler — в system-блоке).
625
+ let message = eventToMessage(event);
626
+ // AD-089: для слинкованного человека `displayName` из резолвера приоритетнее
627
+ // имени из `payload.from` (tg-имя). Cron (`Scheduler`) не переопределяем.
628
+ if (event.source !== 'cron' && event.identity?.principalId) {
629
+ try {
630
+ const linked = await resolveExternalIdentity(event.identity);
631
+ if (linked?.displayName)
632
+ message.author = linked.displayName;
633
+ }
634
+ catch {
635
+ // attribution не критична — оставляем автора из `eventToMessage`
636
+ }
637
+ }
638
+ // AD-089 (этап 5): эффективные роли отправителя — в metadata хода.
639
+ if (context) {
640
+ message.metadata = {
641
+ ...(message.metadata ?? {}),
642
+ effective_roles: context.roles,
643
+ identity_linked: context.linked,
644
+ };
645
+ }
646
+ if (mode === 'run') {
647
+ // AD-036: обфускация user-сообщения ДО сохранения в историю (паритет с
648
+ // prompt-путём — core routes/sessions.ts).
649
+ await enqueueUserMessage(sessionManager, eventBus, sessionId, message, queueManager, processMessage, (sid, msg) => orchestrator.obfuscateUserMessageForHistory(sid, msg));
650
+ }
651
+ else {
652
+ // AD-036: `defer` тоже кладёт сообщение в историю — обфусцируем до
653
+ // постановки. Старт процессора не выполняем (только очередь владельца).
654
+ message = await orchestrator.obfuscateUserMessageForHistory(sessionId, message);
655
+ await sessionManager.addPendingMessage(sessionId, message);
656
+ }
657
+ },
658
+ });
659
+ // AD-089: ingress-точка приёма внешних событий (Этап 6).
660
+ const eventIngress = new EventIngress({ requestSessionService });
661
+ // AD-051 (срез) / AD-089: планировщик публикует cron-события через ingress.
662
+ // `start()` гейтится конфигом (`scheduler.enabled: false` — тикер не стартует),
663
+ // ошибки старта логируются и не роняют процесс; остановка — `stopScheduler`.
664
+ const schedulerTickMs = backendConfig.synth.scheduler.tickSec * 1000;
665
+ const schedulerService = new SchedulerService({
666
+ scheduleStore,
667
+ ingress: eventIngress,
668
+ jobStore,
669
+ tickMs: schedulerTickMs,
670
+ defaultEphemeralTtl: effectiveEvents.ephemeralTtl,
671
+ catchUp: backendConfig.synth.scheduler.catchUp,
672
+ jobRetentionDays: backendConfig.synth.scheduler.jobRetentionDays,
673
+ // AD-051/AD-089: тикер стартует только у лидера (default — AlwaysLeader).
674
+ leader: backendConfig.synth.scheduler.leaderElection === 'file'
675
+ ? new FileLeader({ dataDir, tickMs: schedulerTickMs })
676
+ : new AlwaysLeader(),
677
+ });
678
+ if (backendConfig.synth.scheduler.enabled !== false) {
679
+ void schedulerService.start().catch((err) => {
680
+ console.warn(`[scheduler] не удалось запустить: ${err instanceof Error ? err.message : String(err)}`);
681
+ });
682
+ }
390
683
  // AD-071 §2.4 / AD-046 §4.5: разовая миграция снапшотов скоупа существующих сессий.
391
684
  await migrateSessionScopeSnapshots({
392
685
  sessionManager,
@@ -397,8 +690,6 @@ export async function createBackendApp(opts = {}) {
397
690
  skillsDefaultOn: (await resolveProjectSkillSeed(skillService, await settingsStore.getSkillsDisabledForNewProjects())).enabled,
398
691
  }),
399
692
  }).catch(() => 0);
400
- // EventHub — центральный диспетчер подписок
401
- const eventHub = new EventHub(eventBus, sessionManager);
402
693
  // API-заглушки для UI
403
694
  app.get('/api/config/themes', (c) => c.json({ themes: [] }));
404
695
  // i18n endpoints
@@ -409,10 +700,13 @@ export async function createBackendApp(opts = {}) {
409
700
  });
410
701
  app.get('/api/v2/i18n/translations/ru', (c) => c.json(getTranslations('ru')));
411
702
  app.get('/api/v2/i18n/translations/en', (c) => c.json(getTranslations('en')));
703
+ // AD-052 (этап I): публичный OpenAPI-документ (spike) за requireAuth;
704
+ // публичную выдачу без auth согласуем отдельно.
705
+ app.get('/api/v2/openapi.json', auth.requireAuth, (c) => c.json(getPublicOpenApiDocument()));
412
706
  // Projects routes
413
707
  app.route('/api/v2/projects', createProjectRoutes(auth, projectStore, sessionManager, backendConfig.workspacesRoot, mcpManager, skillService, settingsStore, mcpRegistryStore));
414
708
  // Sessions routes
415
- app.route('/api/v2/sessions', createSessionRoutes(auth, sessionManager, eventBus, queueManager, processMessage, orchestrator, eventHub, contextOptimizer, projectStore, profilesStore, getDefaultAgentId));
709
+ app.route('/api/v2/sessions', createSessionRoutes(auth, sessionManager, eventBus, queueManager, processMessage, orchestrator, eventHub, contextOptimizer, projectStore, profilesStore, getDefaultAgentId, requestSessionService));
416
710
  // Messages routes
417
711
  app.route('/api/v2/messages', createMessageRoutes(auth, sessionManager, contextOptimizer, eventBus));
418
712
  // Queue routes
@@ -463,6 +757,102 @@ export async function createBackendApp(opts = {}) {
463
757
  app.route('/api/v2/agents/:agentId/ssh-keys', createAgentSshKeyRoutes(auth, sshKeyStore, {
464
758
  writeGuard: auth.requireAdmin,
465
759
  }));
760
+ // AD-089: приём внешних событий (ingress), биндинги и журнал. Ingress —
761
+ // requireAuth + rate limit (внешние сервисы до AD-052 используют общий ключ);
762
+ // чтение биндингов/журнала — requireAuth; мутации биндингов — ADMIN.
763
+ // `GET /` не переопределяем — на этом пути SSE-хаб ниже.
764
+ app.route('/api/v2/events', createEventRoutes({ requireAuth: auth.requireAuth }, { ingress: eventIngress, bindingStore: eventBindingStore, journal: eventJournal, routeRuleStore, apiKeyStore: eventApiKeyStore }, {
765
+ // Rate limit — до решения о способе аутентификации; fallback-креды —
766
+ // requireAuth (приём по API-ключу привязки креды пользователя не требует).
767
+ ingestPreGuard: createRateLimiter(120, 60_000),
768
+ ingestGuard: auth.requireAuth,
769
+ // AD-089/AD-052: мутации bindings/routes/keys — LEAD и ADMIN; чтение
770
+ // ключей привязки — тоже LEAD и ADMIN (чувствительные метаданные).
771
+ writeGuard: auth.requirePermission('ADMIN', 'LEAD'),
772
+ keyReadGuard: auth.requirePermission('ADMIN', 'LEAD'),
773
+ // AD-052 (этап I): scope-гейт и проектная проекция service-key (i18n-403).
774
+ scopeGuard,
775
+ projectGuard,
776
+ // AD-089/AD-052: per-key rate limit и мастер-выключатель приёма (live).
777
+ getKeyRateLimitPerMinute: () => effectiveEventsSettings.keyRateLimitPerMinute,
778
+ isEnabled: () => effectiveEventsSettings.enabled,
779
+ resolveAgentTemplate,
780
+ sessionExists: async (id) => (await sessionManager.getSession(id)) !== null,
781
+ resolveApiKeySecret: async (raw) => {
782
+ const resolved = await eventApiKeyStore.resolveBySecret(raw);
783
+ if (!resolved)
784
+ return null;
785
+ const binding = await eventBindingStore.get(resolved.credential.bindingId);
786
+ if (!binding)
787
+ return null;
788
+ return { binding, credential: resolved.credential };
789
+ },
790
+ touchApiKey: (id) => eventApiKeyStore.touch(id),
791
+ messages: {
792
+ invalidEvent: (c) => t('errors.validation.invalidEvent', undefined, c),
793
+ invalidBinding: (c) => t('errors.validation.invalidBinding', undefined, c),
794
+ bindingNotFound: (c) => t('errors.notFound.binding', undefined, c),
795
+ invalidRule: (c) => t('errors.validation.invalidRule', undefined, c),
796
+ ruleNotFound: (c) => t('errors.notFound.rule', undefined, c),
797
+ unknownAgent: (c) => t('errors.validation.unknownAgent', undefined, c),
798
+ invalidKey: (c) => t('errors.validation.invalidEventKey', undefined, c),
799
+ keyNotFound: (c) => t('errors.notFound.eventKey', undefined, c),
800
+ invalidKeyUpdate: (c) => t('errors.validation.invalidEventKeyUpdate', undefined, c),
801
+ keyLabelConflict: (c) => t('errors.conflict.eventKeyLabel', undefined, c),
802
+ rateLimitedKey: (c) => t('errors.rateLimited.eventKey', undefined, c),
803
+ eventsDisabled: (c) => t('errors.unavailable.eventsDisabled', undefined, c),
804
+ },
805
+ }));
806
+ // AD-051 / AD-089: CRUD расписаний, принудительный запуск и Job-история.
807
+ // Чтение — requireAuth (дефолт core-фабрики), мутации — ADMIN. `run` —
808
+ // ADMIN + rate limit (образец — ingest внешних событий): 10 запусков / 60 c
809
+ // на ключ, т.к. каждый запуск ингестит событие в Router.
810
+ app.route('/api/v2/schedules', createSchedulerRoutes(auth, { scheduleStore, scheduler: schedulerService, jobStore }, {
811
+ writeGuard: auth.requireAdmin,
812
+ runGuard: auth.requireAdmin,
813
+ runMiddleware: [createRateLimiter(10, 60_000)],
814
+ // AD-052 (этап I): scope-гейт, проектная проекция и резолвинг
815
+ // projectId `bound`/`queue`-целей расписания.
816
+ scopeGuard,
817
+ projectGuard,
818
+ resolveSessionProject: async (id) => (await sessionManager.getSession(id))?.projectId,
819
+ }));
820
+ // AD-052 (этап I): CRUD service-key инстанса (`synth_svc_…`). Managed RBAC:
821
+ // только ADMIN (ключи дают машинный доступ — управление админское), i18n.
822
+ app.route('/api/v2/service-keys', createServiceKeyRoutes({ requireAuth: auth.requireAuth }, { store: serviceApiKeyStore }, {
823
+ writeGuard: auth.requirePermission('ADMIN'),
824
+ readGuard: auth.requirePermission('ADMIN'),
825
+ // createdBy: `attachUser` уже положил пользователя в контекст — берём его id.
826
+ resolveUserId: (c) => {
827
+ const user = c.get('user');
828
+ return user?.id ?? '';
829
+ },
830
+ messages: {
831
+ invalidKey: (c) => t('errors.validation.invalidServiceKey', undefined, c),
832
+ keyNotFound: (c) => t('errors.notFound.serviceKey', undefined, c),
833
+ keyLabelConflict: (c) => t('errors.conflict.serviceKeyLabel', undefined, c),
834
+ },
835
+ }));
836
+ // AD-052 (этап II): подписки на исходящие webhooks (CRUD + журнал + тест).
837
+ // Managed RBAC: только ADMIN (webhook может утекать данные на произвольный
838
+ // URL), i18n. Мастер-выключатель `webhooks.enabled` → 503 на мутации/тест.
839
+ app.route('/api/v2/webhooks', createWebhookRoutes({ requireAuth: auth.requireAuth }, { store: webhookStore, deliveryStore: webhookDeliveryStore, service: webhookService }, {
840
+ writeGuard: auth.requirePermission('ADMIN'),
841
+ readGuard: auth.requirePermission('ADMIN'),
842
+ resolveUserId: (c) => {
843
+ const user = c.get('user');
844
+ return user?.id ?? 'unknown';
845
+ },
846
+ isEnabled: () => webhooksConfig.enabled,
847
+ allowPrivateTargets: webhooksConfig.allowPrivateTargets,
848
+ messages: {
849
+ invalid: (c) => t('errors.validation.invalidWebhook', undefined, c),
850
+ notFound: (c) => t('errors.notFound.webhook', undefined, c),
851
+ labelConflict: (c) => t('errors.conflict.webhookLabel', undefined, c),
852
+ targetForbidden: (c) => t('errors.validation.webhookTargetForbidden', undefined, c),
853
+ disabled: (c) => t('errors.unavailable.webhooksDisabled', undefined, c),
854
+ },
855
+ }));
466
856
  // MCP routes (единый реестр; legacy /servers — адаптеры над ним)
467
857
  app.route('/api/v2/mcp', createMcpRoutes(auth, mcpManager, sessionManager, {
468
858
  registry: mcpRegistryStore,
@@ -480,7 +870,7 @@ export async function createBackendApp(opts = {}) {
480
870
  ? normalize(project.workspace)
481
871
  : resolve(backendConfig.workspacesRoot, project.workspace);
482
872
  },
483
- }, { writeGuard: auth.requireAdmin }));
873
+ }, { writeGuard: requireAdminOrScope('addons:install') }));
484
874
  // AD-046 §7/§9.1: команды и bundles (mirror core, мутации — ADMIN).
485
875
  app.route('/api/v2/commands', createCommandRoutes(auth, {
486
876
  commandService,
@@ -543,6 +933,30 @@ export async function createBackendApp(opts = {}) {
543
933
  writeGuard: auth.requireAdmin,
544
934
  onSkillsDisabledChange: (disabled) => orchestrator.setSkillsDisabled(disabled),
545
935
  }));
936
+ // AD-089: идентичности текущего пользователя (`GET/DELETE /api/v2/me/identities`).
937
+ // RBAC: аутентифицированный пользователь (только свои); линковка — claim-flow
938
+ // (`POST /api/v2/me/identities/claim`).
939
+ // Резолвим **id профиля** по `username` аутентифицированного пользователя
940
+ // (OIDC `sub` — не id профиля: профили хранятся под сгенерированным id).
941
+ // Не передаём `roles` — чтобы не перезаписывать роли существующего профиля.
942
+ app.route('/api/v2/me', createIdentityRoutes(auth, profilesStore, {
943
+ resolveProfileId: async (c) => {
944
+ const u = await auth.getCurrentUser(c);
945
+ if (!u)
946
+ return '';
947
+ const profile = (await profilesStore.getProfileByUsername(u.username))
948
+ ?? (await profilesStore.getOrCreateProfile({ username: u.username, email: u.email }));
949
+ return profile.id;
950
+ },
951
+ claimStore: identityClaimStore,
952
+ messages: {
953
+ identityNotFound: (c) => t('errors.notFound.identity', undefined, c),
954
+ claimNotFound: (c) => t('errors.notFound.identityClaim', undefined, c),
955
+ claimConflict: (c) => t('errors.conflict.identityClaim', undefined, c),
956
+ claimCodeRequired: (c) => t('errors.validation.claimCodeRequired', undefined, c),
957
+ unauthorized: (c) => t('auth.unauthorized', undefined, c),
958
+ },
959
+ }));
546
960
  // LLM Gateway audit routes (AD-036) — GET только ADMIN/AUDITOR, POST /revealed — все авторизованные
547
961
  app.route('/api/v2/audit', createAuditRoutes(auth, {
548
962
  auditLogPath: gatewayAuditLogger.logPath,
@@ -635,7 +1049,38 @@ export async function createBackendApp(opts = {}) {
635
1049
  effectiveNetworkPolicy = policy;
636
1050
  mcpManager.setNetworkPolicy(policy);
637
1051
  },
1052
+ // AD-089: дефолт config.yaml для GET/DELETE-сброса раздела «События».
1053
+ fallbackEvents: backendConfig.synth.events,
1054
+ // AD-089: live-применение runtime-настроек «События» — Router/funnel/pruner.
1055
+ onEventsChange: (effective) => {
1056
+ effectiveEventsSettings = effective;
1057
+ eventRouter.updateConfig({
1058
+ allowedSources: effective.allowedSources,
1059
+ defaultMode: effective.defaultMode,
1060
+ defaultEphemeralTtl: effective.ephemeralTtl,
1061
+ autoBind: effective.autoBind,
1062
+ autoBindAgentTemplate: effective.autoBindAgentTemplate,
1063
+ });
1064
+ requestSessionService.updateConfig({
1065
+ defaultEphemeralTtl: effective.ephemeralTtl,
1066
+ unknownAgentTemplate: effective.unknownAgentTemplate,
1067
+ identityMap: effective.identityMap,
1068
+ });
1069
+ },
1070
+ // AD-084: дефолт config.yaml для GET/DELETE-сброса decision-слоя.
1071
+ fallbackDecision: backendConfig.synth.decision,
1072
+ // AD-084: live-применение runtime-настроек decision-слоя — микро-каскад и
1073
+ // роутер читают конфиг геттером оркестратора; события — геттером выше.
1074
+ onDecisionChange: (effective) => {
1075
+ effectiveDecisionSettings = effective;
1076
+ orchestrator.setDecisionConfig(effective);
1077
+ },
638
1078
  protectedPathsStore,
1079
+ }, {
1080
+ // AD-089: мутации раздела «События» — только ADMIN (managed RBAC).
1081
+ eventsWriteGuard: auth.requirePermission('ADMIN'),
1082
+ // AD-084: мутации decision-слоя — только ADMIN (managed RBAC).
1083
+ decisionWriteGuard: auth.requirePermission('ADMIN'),
639
1084
  }));
640
1085
  // Словари классификации: чтение — все авторизованные, запись/сброс — ADMIN
641
1086
  // (тот же guard, что у users.ts). Реализация общая с core.
@@ -669,16 +1114,24 @@ export async function createBackendApp(opts = {}) {
669
1114
  || project.ownerId === userId
670
1115
  || project.members?.[userId] === ProjectRole.OWNER,
671
1116
  }));
672
- // Глобальный SSE-хаб для всех сессий пользователя
673
- app.get('/api/v2/events', auth.requireAuth, async (c) => {
1117
+ // Глобальный SSE-хаб для всех сессий пользователя.
1118
+ // AD-052: `events:watch` — scope service-key для подписки на поток событий.
1119
+ app.get('/api/v2/events', auth.requireAuth, scopeGuard('events:watch'), async (c) => {
674
1120
  const user = (await auth.getCurrentUser(c));
675
1121
  const signal = c.req.raw.signal;
1122
+ // AD-052 (этап IV) / AD-089: машинный watcher (service-key со scope
1123
+ // `events:watch`) и роли сквозного обзора ADMIN/LEAD получают события ВСЕХ
1124
+ // сессий (паритет со standalone-core `subscribeAll`), обычный пользователь —
1125
+ // только своих. Без этого синтетический `service:<keyId>` шлюза не владеет
1126
+ // сессиями → подписок 0 → ответы агента не доходят до Telegram.
1127
+ const allSessions = Boolean(getServiceCredential(c)) || auth.hasRole(c, 'ADMIN', 'LEAD');
676
1128
  return new Response(new ReadableStream({
677
1129
  async start(controller) {
678
1130
  const encoder = new TextEncoder();
679
1131
  const sseClient = {
680
1132
  userId: user.id,
681
1133
  username: user.username,
1134
+ allSessions,
682
1135
  send(event) {
683
1136
  try {
684
1137
  const line = `data: ${JSON.stringify(event)}\n\n`;
@@ -690,7 +1143,7 @@ export async function createBackendApp(opts = {}) {
690
1143
  },
691
1144
  };
692
1145
  try {
693
- console.log(`[SSE /api/v2/events] Connected: user=${user.username}`);
1146
+ console.log(`[SSE /api/v2/events] Connected: user=${user.username} allSessions=${allSessions}`);
694
1147
  await eventHub.registerClient(sseClient);
695
1148
  // Keepalive: раз в 30 секунд отправляем комментарий для предотвращения разрыва
696
1149
  const keepalive = setInterval(() => {
@@ -803,11 +1256,17 @@ export async function createBackendApp(opts = {}) {
803
1256
  socket.destroy();
804
1257
  return;
805
1258
  }
1259
+ // AD-052 (этап IV) / AD-089: тот же watch-all, что у SSE. В WS-апгрейде
1260
+ // Hono-контекста нет, поэтому service-key распознаётся по синтетическому
1261
+ // id `service:<keyId>` (его ставит резолвер `getCurrentUser`); ADMIN/LEAD —
1262
+ // сквозной обзор. Обычный USER получает только свои сессии.
1263
+ const allSessions = user.id.startsWith('service:') || auth.hasRole({ get: () => user }, 'ADMIN', 'LEAD');
806
1264
  wss.handleUpgrade(request, socket, head, (ws) => {
807
1265
  const clientId = `ws-events-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
808
1266
  const client = {
809
1267
  userId: user.id,
810
1268
  username: user.username,
1269
+ allSessions,
811
1270
  send(event) {
812
1271
  try {
813
1272
  if (ws.readyState === ws.OPEN) {
@@ -967,6 +1426,23 @@ export async function createBackendApp(opts = {}) {
967
1426
  orchestrator,
968
1427
  queueManager,
969
1428
  settingsStore,
1429
+ // AD-089: ядро событий (понадобится на этапах 5–6).
1430
+ eventRouter,
1431
+ requestSessionService,
1432
+ eventBindingStore,
1433
+ eventJournal,
1434
+ ingress: eventIngress,
1435
+ // AD-051 (срез) / AD-089: реестр расписаний и планировщик.
1436
+ scheduleStore,
1437
+ scheduler: schedulerService,
1438
+ stopScheduler: () => schedulerService.stop(),
1439
+ stopEphemeralSweeper,
1440
+ stopEventJournalPruner,
1441
+ // AD-052 (этап II): реестр подписок и движок webhooks + остановка на shutdown.
1442
+ webhookStore,
1443
+ webhookService,
1444
+ stopWebhookService: () => webhookService.stop(),
1445
+ stopWebhookDeliveryPruner: () => stopWebhookDeliveryPruner(),
970
1446
  listen,
971
1447
  };
972
1448
  }