@itphx/synth-backend 0.11.3 → 0.13.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/dist/app/deps.d.ts +37 -5
  2. package/dist/app/deps.js +1172 -37
  3. package/dist/app/listen.d.ts +7 -1
  4. package/dist/app/listen.js +182 -16
  5. package/dist/app/mount-routes.js +493 -12
  6. package/dist/app/sse-events.d.ts +4 -0
  7. package/dist/app/sse-events.js +53 -6
  8. package/dist/app.d.ts +30 -2
  9. package/dist/app.js +54 -8
  10. package/dist/auth/guards.d.ts +15 -0
  11. package/dist/auth/guards.js +37 -1
  12. package/dist/auth/plugin-scope.d.ts +10 -0
  13. package/dist/auth/plugin-scope.js +69 -0
  14. package/dist/events/hub.d.ts +17 -0
  15. package/dist/events/hub.js +46 -14
  16. package/dist/lib/app-config.d.ts +4 -0
  17. package/dist/lib/app-config.js +4 -2
  18. package/dist/lib/defaults-store.d.ts +1 -1
  19. package/dist/lib/defaults-store.js +2 -2
  20. package/dist/lib/i18n.js +123 -2
  21. package/dist/lib/recalc-can-summarize.js +8 -3
  22. package/dist/main.js +52 -3
  23. package/dist/routes/agents.d.ts +11 -2
  24. package/dist/routes/agents.js +15 -2
  25. package/dist/routes/auth.d.ts +11 -1
  26. package/dist/routes/auth.js +45 -3
  27. package/dist/routes/llm.js +29 -7
  28. package/dist/routes/mcp-registry.d.ts +13 -1
  29. package/dist/routes/mcp-registry.js +120 -19
  30. package/dist/routes/messages.d.ts +4 -2
  31. package/dist/routes/messages.js +7 -1
  32. package/dist/routes/processes.d.ts +34 -0
  33. package/dist/routes/processes.js +26 -0
  34. package/dist/routes/projects.d.ts +14 -2
  35. package/dist/routes/projects.js +28 -1
  36. package/dist/routes/queue.d.ts +4 -1
  37. package/dist/routes/queue.js +4 -1
  38. package/dist/routes/sessions.d.ts +74 -6
  39. package/dist/routes/sessions.js +85 -93
  40. package/package.json +6 -6
@@ -2,19 +2,20 @@ import { Hono } from 'hono';
2
2
  import { MessageRole, generateStreamId, nowISO, sessionMcpUpdateSchema, normalizeIconKey, normalizeColorKey, } from '@itphx/synth-shared';
3
3
  import { createRateLimiter } from '../middleware/rate-limiter.js';
4
4
  import { scopeGuard, serviceProjectProjection } from '../auth/service-scope.js';
5
- import { enqueueUserMessage, serializeSession, createSessionAccessGuard, createSessionAccessPredicate, createSessionExportGuard, getSessionExportDecision, isSessionExportPath, createSessionRoutes as createCoreSessionRoutes, stripSessionSecrets, } from '@itphx/synth-core';
5
+ import { enqueueUserMessage, serializeSession, createSessionAccessGuard, createSessionAccessPredicate, createSessionExportGuard, getSessionExportDecision, isSessionExportPath, createSessionRoutes as createCoreSessionRoutes, stripSessionSecrets, resolveUserPrincipal, } from '@itphx/synth-core';
6
6
  import { t } from '../lib/i18n.js';
7
7
  import { createProjectAccess } from './projects.js';
8
8
  /**
9
9
  * Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
10
10
  * backend-специфичные роуты (MCP-скоуп сессии, секреты, export/import, отладка,
11
- * оптимизация контекста, sticky notes). Общая логика (список/создание/чтение/
12
- * изменение/удаление, status/prompt/stats, очередь+SSE, children/tree/fork,
13
- * references, merge) — в `createSessionRoutes` из `@itphx/synth-core`.
11
+ * оптимизация контекста). Общая логика (список/создание/чтение/изменение/
12
+ * удаление, status/prompt/stats, заметки (`notes`), очередь+SSE, children/tree/
13
+ * fork, references, merge) — в `createSessionRoutes` из `@itphx/synth-core`.
14
14
  *
15
15
  * RBAC: core-фабрика параметризуется `resolveUserId`/`resolveOwner`/`resolveAuthor`,
16
16
  * `canAccess` (владелец|ADMIN) и EventHub-хуками; remote/hybrid-ветки отключены
17
- * (getRemoteClient не передаётся). `GET /:id/events` на backend не регистрируется.
17
+ * (getRemoteClient не передаётся). Сессионного SSE нет: наблюдение за ходом —
18
+ * единственный глобальный канал `GET /api/v2/events` (ADR-118).
18
19
  *
19
20
  * Исключения из общего prefix-guard'а (собственные правила, роуты зарегистрированы
20
21
  * до guard'а): `/:id/mcp` (владелец|ADMIN, ADR-071 §2.4) и `/:id/secrets`
@@ -33,8 +34,50 @@ resolveDefaultAgent,
33
34
  * Не задан — core-фабрика использует прямой `SessionManager.createSession`.
34
35
  */
35
36
  requestSessionService,
36
- /** PROP-102: сборщик `activity` (меры `aborts`/`messages_*`) для core-фабрики. */
37
- analytics) {
37
+ /** ADR-102: сборщик `activity` (меры `aborts`/`messages_*`) для core-фабрики. */
38
+ analytics,
39
+ /** ADR-107: агрегаты памяти сессии для `GET /:id/memory` (вкладка «Память»). */
40
+ memory,
41
+ /**
42
+ * Этап 1 roadmap 0.13 (блок 3): сервис «вопрос пользователю» (`ask_user`).
43
+ *
44
+ * Не задан — маршруты вопросов отвечают 503 (подсистема не подключена).
45
+ */
46
+ questionService,
47
+ /**
48
+ * ADR-114: сервис worktree'ов — привязка сессии к worktree
49
+ * (`PATCH /api/v2/sessions/:id { worktreeId }`).
50
+ *
51
+ * Не задан — поле `worktreeId` в PATCH игнорируется (привязка недоступна).
52
+ */
53
+ worktreeService,
54
+ /**
55
+ * ADR-115: вложения сообщений — blob-порт, учёт ссылок и лимиты
56
+ * (прокидывается в core-фабрику: загрузка/раздача + `attachments` в промпте).
57
+ */
58
+ attachments,
59
+ /**
60
+ * ADR-111/ADR-113: единый реестр фоновых прогонов — «Стоп» сессии
61
+ * останавливает и живые дочерние прогоны (фоновые саб-агенты и их процессы),
62
+ * решение 2026-10-28. Не задан — прежнее поведение (только свой стрим/очередь).
63
+ */
64
+ backgroundService,
65
+ /**
66
+ * ADR-106 Ф3: реестр подтверждений — HTTP-ответ на подтверждение
67
+ * (`POST /:id/permissions/:approvalId`) принимает решение через него, как и
68
+ * WS-кадр `permission_reply`. Не задан — слой Authority выключен/в shadow.
69
+ */
70
+ approvalRegistry,
71
+ /**
72
+ * Instance-wide лимиты заметок сессии (`context.stickyNotes`, live-резолвер)
73
+ * — прокидывается в core-фабрику: роуты заметок живут там (единая реализация).
74
+ */
75
+ getStickyNoteLimits,
76
+ /**
77
+ * Доступность пары провайдер/модель **до постановки в очередь** (каталог
78
+ * инстанса). Не задана — проверка выключена.
79
+ */
80
+ llmAvailability) {
38
81
  const app = new Hono();
39
82
  const agentRegistry = orchestrator.agentRegistry;
40
83
  const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
@@ -380,7 +423,9 @@ analytics) {
380
423
  author: user.username,
381
424
  metadata: { type: 'debug_system_message', reason: 'manual', stream_id: streamId },
382
425
  };
383
- const result = await enqueueUserMessage(sessionManager, eventBus, session.id, sysMsg, queueManager, processMessage);
426
+ // ADR-106 Ф4: принципал инициатора (ввод от пользователя, не системный ход).
427
+ const turnPrincipal = resolveUserPrincipal(user.id);
428
+ const result = await enqueueUserMessage(sessionManager, eventBus, session.id, sysMsg, queueManager, processMessage, undefined, turnPrincipal ? { principal: turnPrincipal } : undefined);
384
429
  if (!result) {
385
430
  return c.json({ error: { code: 'QUEUE_FULL', message: 'Queue is full' } }, 429);
386
431
  }
@@ -405,6 +450,9 @@ analytics) {
405
450
  summarize_token_threshold: session.settings.summarizeTokenThreshold,
406
451
  summarization_head_messages: session.settings.summarizationHeadMessages,
407
452
  summarization_tail_messages: session.settings.summarizationTailMessages,
453
+ summarization_keep_tokens: session.settings.summarizationKeepTokens,
454
+ compaction_keep_tokens: session.settings.compactionKeepTokens,
455
+ compaction_token_threshold: session.settings.compactionTokenThreshold,
408
456
  });
409
457
  });
410
458
  // PATCH /api/v2/sessions/:id/optimization — обновить настройки
@@ -437,6 +485,12 @@ analytics) {
437
485
  s.settings.summarizationHeadMessages = body.summarization_head_messages;
438
486
  if (body.summarization_tail_messages !== undefined)
439
487
  s.settings.summarizationTailMessages = body.summarization_tail_messages;
488
+ if (body.summarization_keep_tokens !== undefined)
489
+ s.settings.summarizationKeepTokens = body.summarization_keep_tokens;
490
+ if (body.compaction_keep_tokens !== undefined)
491
+ s.settings.compactionKeepTokens = body.compaction_keep_tokens;
492
+ if (body.compaction_token_threshold !== undefined)
493
+ s.settings.compactionTokenThreshold = body.compaction_token_threshold;
440
494
  await sessionManager.saveSession(s);
441
495
  });
442
496
  const updated = await sessionManager.getSession(c.req.param('id'));
@@ -451,13 +505,17 @@ analytics) {
451
505
  }
452
506
  // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
453
507
  if (!contextOptimizer) {
454
- return c.json({ sliding_window: { triggered: false }, summarization: { triggered: false } });
508
+ return c.json({ sliding_window: { triggered: false }, summarization: { triggered: false }, compression: { triggered: false, reason: 'none', mode: null } });
455
509
  }
456
510
  const swResult = contextOptimizer.shouldApplySlidingWindow(session);
457
511
  const sumResult = contextOptimizer.shouldSummarize(session);
512
+ const compression = typeof contextOptimizer.shouldCompress === 'function'
513
+ ? contextOptimizer.shouldCompress(session)
514
+ : { ...contextOptimizer.shouldSummarize(session), mode: 'summarization' };
458
515
  return c.json({
459
516
  sliding_window: swResult,
460
517
  summarization: sumResult,
518
+ compression,
461
519
  summarization_pending: session.summarizationPending,
462
520
  });
463
521
  });
@@ -484,90 +542,9 @@ analytics) {
484
542
  }
485
543
  return c.json({ success: true });
486
544
  });
487
- // ===== Sticky Notes =====
488
- // GET /api/v2/sessions/:id/notes — список заметок
489
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
490
- app.get('/:id/notes', kit.requireAuth, async (c) => {
491
- const session = await sessionManager.getSession(c.req.param('id'));
492
- if (!session) {
493
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
494
- }
495
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
496
- return c.json({ notes: session.stickyNotes });
497
- });
498
- // POST /api/v2/sessions/:id/notes — создать заметку
499
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
500
- app.post('/:id/notes', kit.requireAuth, async (c) => {
501
- const session = await sessionManager.getSession(c.req.param('id'));
502
- if (!session) {
503
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
504
- }
505
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
506
- const body = await c.req.json().catch(() => ({}));
507
- if (!body.content?.trim()) {
508
- return c.json({ error: { code: 'VALIDATION_ERROR', message: 'Content is required' } }, 400);
509
- }
510
- const now = nowISO();
511
- const note = {
512
- id: generateStreamId(),
513
- content: body.content.trim(),
514
- createdAt: now,
515
- updatedAt: now,
516
- disabled: false,
517
- };
518
- await sessionManager.withLock(c.req.param('id'), async (s) => {
519
- s.stickyNotes.push(note);
520
- await sessionManager.saveSession(s);
521
- });
522
- const updated = await sessionManager.getSession(c.req.param('id'));
523
- eventBus.publish(c.req.param('id'), 'context.sticky_note_added', { note_id: note.id });
524
- return c.json({ note, notes: updated.stickyNotes }, 201);
525
- });
526
- // PATCH /api/v2/sessions/:id/notes/:noteId — обновить заметку
527
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
528
- app.patch('/:id/notes/:noteId', kit.requireAuth, async (c) => {
529
- const session = await sessionManager.getSession(c.req.param('id'));
530
- if (!session) {
531
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
532
- }
533
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
534
- const body = await c.req.json().catch(() => ({}));
535
- const noteId = c.req.param('noteId');
536
- await sessionManager.withLock(c.req.param('id'), async (s) => {
537
- const note = s.stickyNotes.find((n) => n.id === noteId);
538
- if (!note)
539
- throw new Error('Note not found');
540
- if (body.content !== undefined)
541
- note.content = body.content;
542
- if (body.disabled !== undefined)
543
- note.disabled = body.disabled;
544
- note.updatedAt = nowISO();
545
- await sessionManager.saveSession(s);
546
- });
547
- const updated = await sessionManager.getSession(c.req.param('id'));
548
- eventBus.publish(c.req.param('id'), 'context.sticky_note_updated', { note_id: noteId });
549
- return c.json({ notes: updated.stickyNotes });
550
- });
551
- // DELETE /api/v2/sessions/:id/notes/:noteId — удалить заметку
552
- // RBAC: владелец сессии / elevated (ADMIN/LEAD) / участник проекта (ADR-089).
553
- app.delete('/:id/notes/:noteId', kit.requireAuth, async (c) => {
554
- const session = await sessionManager.getSession(c.req.param('id'));
555
- if (!session) {
556
- return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
557
- }
558
- // Доступ — у единого prefix-guard'а выше (владелец/elevated/роль в проекте).
559
- const noteId = c.req.param('noteId');
560
- await sessionManager.withLock(c.req.param('id'), async (s) => {
561
- s.stickyNotes = s.stickyNotes.filter((n) => n.id !== noteId);
562
- await sessionManager.saveSession(s);
563
- });
564
- const updated = await sessionManager.getSession(c.req.param('id'));
565
- eventBus.publish(c.req.param('id'), 'context.sticky_note_deleted', { note_id: noteId });
566
- return c.json({ notes: updated.stickyNotes });
567
- });
568
545
  // Общая логика — в core-фабрике (backend-специфика выше). Регистрируем её
569
546
  // последней: статические/backend-only сегменты должны матчиться раньше.
570
- app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService, analytics }, {
547
+ app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService, analytics, ...(memory ? { memory } : {}), ...(questionService ? { questionService } : {}), ...(worktreeService ? { worktreeService } : {}), ...(attachments ? { attachments } : {}), ...(backgroundService ? { backgroundService } : {}), ...(approvalRegistry ? { approvalRegistry } : {}), ...(llmAvailability ? { llmAvailability } : {}) }, {
571
548
  resolveUserId: async (c) => (await kit.getCurrentUser(c)).id,
572
549
  resolveOwner: async (c) => (await kit.getCurrentUser(c)).id,
573
550
  forkWithOwner: true,
@@ -591,16 +568,23 @@ analytics) {
591
568
  return projects.map((p) => p.id);
592
569
  },
593
570
  resolveAuthor: async (c) => (await kit.getCurrentUser(c)).username,
594
- promptMessageId: 'stream',
571
+ // ADR-106 Ф3: принципал ответа на подтверждение — аутентифицированный
572
+ // пользователь запроса (клиенту не доверяем) и его роли инстанса.
573
+ resolvePermissionResponder: async (c) => {
574
+ const user = await kit.getCurrentUser(c);
575
+ return { kind: 'user', id: user?.id ?? '', roles: user?.roles ?? [] };
576
+ },
595
577
  publishRenamed: false,
596
578
  publishDeletedBefore: false,
579
+ // Instance-wide лимиты заметок сессии (`context.stickyNotes`): роуты
580
+ // заметок — в core-фабрике, лимиты читаются резолвером (live).
581
+ ...(getStickyNoteLimits ? { getStickyNoteLimits } : {}),
597
582
  onSessionCreated: (userId, sessionId) => { void eventHub.subscribeToSession(userId, sessionId).catch((e) => console.warn('subscribeToSession failed:', e)); },
598
583
  onSessionDeleted: (userId, sessionId) => { eventHub.unsubscribeFromSession(userId, sessionId); },
599
584
  onSessionForked: (userId, sessionId) => { void eventHub.subscribeToSession(userId, sessionId).catch((e) => console.warn('subscribeToSession failed:', e)); },
600
585
  promptMiddleware: [createRateLimiter(30, 60_000)],
601
586
  forkMiddleware: [forkRateLimit],
602
587
  mergeMiddleware: [mergeRateLimit],
603
- enableSessionEvents: false,
604
588
  resolveDefaultAgent,
605
589
  // ADR-036: право видеть РЕАЛЬНЫЕ значения секретов (плейсхолдер → значение)
606
590
  // в обычном чтении сессии (`GET /sessions/:id`, `GET /sessions/:id/messages`,
@@ -628,6 +612,14 @@ analytics) {
628
612
  forbidden: (c) => t('auth.forbidden', undefined, c),
629
613
  contentRequired: (c) => t('errors.validation.contentRequired', undefined, c),
630
614
  queueFull: (c, max) => t('errors.chat.queueFull', { max }, c),
615
+ steerLimitExceeded: (c, max) => t('errors.chat.steerLimitExceeded', { max }, c),
616
+ // Отключённые провайдер/модель — понятные 400 до постановки в очередь.
617
+ providerDisabled: (c, provider) => t('errors.chat.providerDisabled', { provider }, c),
618
+ modelDisabled: (c, provider, model) => t('errors.chat.modelDisabled', { provider, model }, c),
619
+ // Лимиты заметок сессии (`context.stickyNotes`) — instance-wide.
620
+ noteNotFound: (c) => t('errors.notFound.note', undefined, c),
621
+ noteLimitReached: (c, max) => t('errors.conflict.noteLimitReached', { max }, c),
622
+ noteTooLong: (c, max) => t('errors.validation.noteTooLong', { max }, c),
631
623
  },
632
624
  }));
633
625
  return app;
package/package.json CHANGED
@@ -1,21 +1,21 @@
1
1
  {
2
2
  "name": "@itphx/synth-backend",
3
- "version": "0.11.3",
3
+ "version": "0.13.4",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "files": [
7
7
  "dist"
8
8
  ],
9
9
  "dependencies": {
10
- "@hono/node-server": "^1.18.0",
11
- "@itphx/synth-core": "0.11.3",
12
- "@itphx/synth-shared": "0.11.3",
10
+ "@hono/node-server": "^2.1.3",
11
+ "@itphx/synth-core": "0.13.4",
12
+ "@itphx/synth-shared": "0.13.4",
13
13
  "hono": "^4.9.0",
14
14
  "hono-rate-limiter": "^0.5.3",
15
15
  "jose": "^6.2.3",
16
- "js-yaml": "^4.1.1",
16
+ "js-yaml": "^4.3.2",
17
17
  "ws": "^8.20.1",
18
- "zod": "^3.24.0"
18
+ "zod": "^4.6.7"
19
19
  },
20
20
  "devDependencies": {
21
21
  "@types/js-yaml": "^4.0.9",