@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
package/dist/lib/i18n.js CHANGED
@@ -19,6 +19,8 @@ const en = {
19
19
  'errors.validation.nameRequired': 'name is required',
20
20
  'errors.validation.idRequired': 'id is required',
21
21
  'errors.validation.invalidAgentId': 'Agent ID may contain only Latin letters, digits, hyphen and underscore',
22
+ 'errors.validation.invalidRoleFile': 'Role file name must be a plain file name without paths and ".."',
23
+ 'errors.validation.invalidEffort': 'Invalid effort tier (allowed: low, medium, high, xhigh, max)',
22
24
  'errors.validation.urlRequired': 'url is required',
23
25
  'errors.validation.invalidUrl': 'Invalid URL',
24
26
  'errors.validation.apiKeyRequired': 'api_key is required',
@@ -40,16 +42,64 @@ const en = {
40
42
  // ADR-052 (этап I): service-key
41
43
  'errors.validation.invalidServiceKey': 'Invalid service key payload',
42
44
  'errors.notFound.serviceKey': 'Service key not found',
45
+ 'errors.notFound.credential': 'External access not found',
43
46
  'errors.conflict.serviceKeyLabel': 'Service key label is already used',
44
47
  'errors.forbidden.scopeRequired': 'Insufficient permissions: required scope is missing',
45
48
  'errors.forbidden.projectForbidden': 'Project is not available for this service key',
46
49
  'errors.rateLimited.serviceKey': 'Service key rate limit exceeded',
47
- // PROP-102: отчёты аналитики (только чтение)
50
+ // ADR-090 Ф7 (Уровень 2): server-scoped токен плагина
51
+ 'errors.forbidden.pluginIdMismatch': 'Plugin token: the X-Synth-Plugin-Id header does not match the key plugin_id',
52
+ 'errors.forbidden.pluginNotAllowed': 'Plugin token: the plugin is not in the server allow-list',
53
+ // ADR-101 (Э6): пайплайны проекта, прогоны, шаблоны инстанса
54
+ 'errors.notFound.pipeline': 'Pipeline not found',
55
+ 'errors.notFound.pipelineRun': 'Pipeline run not found',
56
+ 'errors.notFound.pipelineTemplate': 'Pipeline template not found',
57
+ 'errors.validation.invalidPipelineBody': 'Invalid pipeline request payload',
58
+ 'errors.validation.invalidPipelineSpec': 'Invalid pipeline specification',
59
+ 'errors.validation.projectIdRequired': 'projectId is required',
60
+ 'errors.conflict.pipelineNotPublished': 'The pipeline has no published version',
61
+ 'errors.conflict.pipelineInvalidState': 'The run is not waiting for a human decision',
62
+ 'errors.conflict.pipelineNothingToPublish': 'There is no draft to publish',
63
+ 'errors.conflict.pipelineRunFinished': 'The run is already finished',
64
+ 'errors.conflict.pipelineTemplateUnsupported': 'The template cannot be instantiated as a pipeline',
65
+ // PROP-096/097: единый реестр фоновых прогонов
66
+ 'errors.notFound.backgroundRun': 'Background run not found',
67
+ 'errors.notFound.backgroundRunSession': 'Session of the background run not found',
68
+ 'errors.validation.invalidBackgroundRunQuery': 'Invalid background run filter',
69
+ 'errors.validation.backgroundRunLogKind': 'Logs are available for background processes only',
70
+ 'errors.notFound.processLog': 'Background process log not found',
71
+ 'errors.conflict.backgroundRunFinished': 'The background run is already finished',
72
+ 'errors.conflict.backgroundRunNotStoppable': 'The background run is not controlled by this instance',
73
+ 'errors.conflict.backgroundRunActive': 'The background run is still running',
74
+ // ADR-102: отчёты аналитики (только чтение)
48
75
  'errors.validation.invalidAnalyticsPeriod': 'Invalid period: expected a date in YYYY-MM-DD (UTC)',
49
76
  'errors.validation.invalidAnalyticsRange': 'Period start is later than period end',
50
77
  'errors.validation.invalidAnalyticsGroupBy': 'Invalid grouping axis (groupBy)',
51
78
  'errors.validation.invalidAnalyticsOption': 'Invalid report parameter (report/format)',
52
79
  'errors.forbidden.analytics': 'Insufficient permissions for this report',
80
+ // ADR-107 / PROP-047: портал памяти (чтение + мутации индексов, М2)
81
+ 'errors.validation.invalidMemoryStatus': 'Invalid memory fact status filter',
82
+ 'errors.validation.invalidMemoryState': 'Invalid memory index state filter',
83
+ 'errors.validation.invalidMemoryLimit': 'Invalid limit value (an integer 1..200)',
84
+ 'errors.validation.invalidMemoryOffset': 'Invalid offset value (an integer >= 0)',
85
+ 'errors.notFound.memoryFact': 'Memory fact not found',
86
+ 'errors.unavailable.memory': 'Memory storage is unavailable',
87
+ 'errors.validation.invalidMemoryBody': 'Invalid memory request payload',
88
+ 'errors.validation.invalidMemorySource': 'Invalid memory index source (expected files or facts)',
89
+ 'errors.validation.memoryProjectRequired': 'A memory index is built in a project: projectId is required',
90
+ 'errors.notFound.memoryProject': 'Project not found',
91
+ 'errors.validation.memoryWorkspaceRequired': 'The project has no workspace: a file index cannot be built',
92
+ 'errors.unavailable.memoryProvider': 'The memory provider is unavailable: the memory plugin is not active',
93
+ 'errors.notFound.memoryIndex': 'Memory index not found',
94
+ 'errors.failed.memoryIndex': 'Failed to perform the memory index operation',
95
+ 'memory.indexCreated': 'Memory index created',
96
+ 'errors.validation.invalidMemoryThreshold': 'Invalid memory consolidation threshold (expected a number 0.5..0.99)',
97
+ 'errors.failed.memoryConsolidation': 'Failed to consolidate memory',
98
+ 'memory.consolidated': 'Memory consolidation completed',
99
+ 'errors.validation.invalidMemoryGraphDepth': 'Invalid memory graph depth (an integer 1..3)',
100
+ 'errors.validation.invalidMemoryGraphLimit': 'Invalid memory graph limit (an integer 1..200)',
101
+ 'errors.validation.invalidMemoryGraphEntity': 'Invalid memory graph entity (a non-empty string of at most 200 characters)',
102
+ 'errors.failed.memoryGraph': 'Failed to read the memory graph',
53
103
  // ADR-052 (этап II): исходящие webhooks
54
104
  'errors.validation.invalidWebhook': 'Invalid webhook subscription payload',
55
105
  'errors.notFound.webhook': 'Webhook subscription not found',
@@ -103,6 +153,16 @@ const en = {
103
153
  'locales.ru.nativeName': 'Russian',
104
154
  // Chat
105
155
  'errors.chat.queueFull': 'Queue is full (max {max} messages)',
156
+ // Отключённые провайдер/модель — отказ до постановки в очередь.
157
+ 'errors.chat.providerDisabled': 'Provider "{provider}" is disabled — choose another model',
158
+ 'errors.chat.modelDisabled': 'Model {provider}/{model} is disabled — choose another model',
159
+ 'errors.chat.steerLimitExceeded': 'Steering limit reached (max {max} injected messages per turn)',
160
+ // ADR-106 Ф3: подтверждение не принято (нет гранта / повторный ответ / чужой ход).
161
+ 'errors.chat.approvalDenied': 'Approval was not accepted: {reason}',
162
+ // Лимиты заметок сессии (`context.stickyNotes`).
163
+ 'errors.notFound.note': 'Note not found',
164
+ 'errors.validation.noteTooLong': 'Note text is too long (max {max} characters)',
165
+ 'errors.conflict.noteLimitReached': 'Session note limit reached (max {max})',
106
166
  // Stub
107
167
  'stub.llmNotConnected': '[Stub] You said: "{content}". LLM engine is not connected yet.',
108
168
  };
@@ -127,6 +187,8 @@ const ru = {
127
187
  'errors.validation.nameRequired': 'name обязателен',
128
188
  'errors.validation.idRequired': 'id обязателен',
129
189
  'errors.validation.invalidAgentId': 'ID агента может содержать только латиницу, цифры, дефис и подчёркивание',
190
+ 'errors.validation.invalidRoleFile': 'Имя файла роли должно быть именем файла без путей и «..»',
191
+ 'errors.validation.invalidEffort': 'Некорректный тир усилия (effort): допустимые значения — low, medium, high, xhigh, max',
130
192
  'errors.validation.urlRequired': 'URL не указан',
131
193
  'errors.validation.invalidUrl': 'Некорректный URL',
132
194
  'errors.validation.apiKeyRequired': 'api_key обязателен',
@@ -148,16 +210,65 @@ const ru = {
148
210
  // ADR-052 (этап I): service-key
149
211
  'errors.validation.invalidServiceKey': 'Некорректное тело service-key',
150
212
  'errors.notFound.serviceKey': 'Service-key не найден',
213
+ // ADR-105 (Ф3): внешний доступ (OAuth-кред) не найден.
214
+ 'errors.notFound.credential': 'Внешний доступ не найден',
151
215
  'errors.conflict.serviceKeyLabel': 'Метка service-key уже используется',
152
216
  'errors.forbidden.scopeRequired': 'Недостаточно прав: отсутствует требуемый scope',
153
217
  'errors.forbidden.projectForbidden': 'Проект недоступен для этого service-key',
154
218
  'errors.rateLimited.serviceKey': 'Превышен лимит запросов по service-key',
155
- // PROP-102: отчёты аналитики (только чтение)
219
+ // ADR-090 Ф7 (Уровень 2): server-scoped токен плагина
220
+ 'errors.forbidden.pluginIdMismatch': 'Токен плагина: заголовок X-Synth-Plugin-Id не совпадает с plugin_id ключа',
221
+ 'errors.forbidden.pluginNotAllowed': 'Токен плагина: плагина нет в серверном allow-list',
222
+ // ADR-101 (Э6): пайплайны проекта, прогоны, шаблоны инстанса
223
+ 'errors.notFound.pipeline': 'Пайплайн не найден',
224
+ 'errors.notFound.pipelineRun': 'Прогон пайплайна не найден',
225
+ 'errors.notFound.pipelineTemplate': 'Шаблон пайплайна не найден',
226
+ 'errors.validation.invalidPipelineBody': 'Некорректное тело запроса пайплайна',
227
+ 'errors.validation.invalidPipelineSpec': 'Некорректная спецификация пайплайна',
228
+ 'errors.validation.projectIdRequired': 'Не указан projectId',
229
+ 'errors.conflict.pipelineNotPublished': 'У пайплайна нет опубликованной версии',
230
+ 'errors.conflict.pipelineInvalidState': 'Прогон не ожидает решения человека',
231
+ 'errors.conflict.pipelineNothingToPublish': 'Нет черновика для публикации',
232
+ 'errors.conflict.pipelineRunFinished': 'Прогон уже завершён',
233
+ 'errors.conflict.pipelineTemplateUnsupported': 'Шаблон нельзя инстанцировать в пайплайн',
234
+ // PROP-096/097: единый реестр фоновых прогонов
235
+ 'errors.notFound.backgroundRun': 'Фоновый прогон не найден',
236
+ 'errors.notFound.backgroundRunSession': 'Сессия фонового прогона не найдена',
237
+ 'errors.validation.invalidBackgroundRunQuery': 'Некорректный фильтр фоновых прогонов',
238
+ 'errors.validation.backgroundRunLogKind': 'Логи доступны только для фоновых процессов',
239
+ 'errors.notFound.processLog': 'Лог фонового процесса не найден',
240
+ 'errors.conflict.backgroundRunFinished': 'Фоновый прогон уже завершён',
241
+ 'errors.conflict.backgroundRunNotStoppable': 'Фоновый прогон не контролируется этим инстансом',
242
+ 'errors.conflict.backgroundRunActive': 'Фоновый прогон ещё выполняется',
243
+ // ADR-102: отчёты аналитики (только чтение)
156
244
  'errors.validation.invalidAnalyticsPeriod': 'Некорректный период: ожидается дата YYYY-MM-DD (UTC)',
157
245
  'errors.validation.invalidAnalyticsRange': 'Начало периода позже конца периода',
158
246
  'errors.validation.invalidAnalyticsGroupBy': 'Некорректная ось группировки (groupBy)',
159
247
  'errors.validation.invalidAnalyticsOption': 'Некорректный параметр отчёта (report/format)',
160
248
  'errors.forbidden.analytics': 'Недостаточно прав для отчёта',
249
+ // ADR-107 / PROP-047: портал памяти (чтение + мутации индексов, М2)
250
+ 'errors.validation.invalidMemoryStatus': 'Некорректный фильтр статуса факта памяти',
251
+ 'errors.validation.invalidMemoryState': 'Некорректный фильтр состояния индекса памяти',
252
+ 'errors.validation.invalidMemoryLimit': 'Некорректное значение limit (целое 1..200)',
253
+ 'errors.validation.invalidMemoryOffset': 'Некорректное значение offset (целое ≥ 0)',
254
+ 'errors.notFound.memoryFact': 'Факт памяти не найден',
255
+ 'errors.unavailable.memory': 'Хранилище памяти недоступно',
256
+ 'errors.validation.invalidMemoryBody': 'Некорректное тело запроса памяти',
257
+ 'errors.validation.invalidMemorySource': 'Некорректный источник индекса памяти (ожидается files или facts)',
258
+ 'errors.validation.memoryProjectRequired': 'Индекс памяти строится в проекте: укажите projectId',
259
+ 'errors.notFound.memoryProject': 'Проект не найден',
260
+ 'errors.validation.memoryWorkspaceRequired': 'У проекта нет рабочего каталога: индекс файлов строить негде',
261
+ 'errors.unavailable.memoryProvider': 'Провайдер памяти недоступен: плагин памяти не активен',
262
+ 'errors.notFound.memoryIndex': 'Индекс памяти не найден',
263
+ 'errors.failed.memoryIndex': 'Не удалось выполнить операцию с индексом памяти',
264
+ 'memory.indexCreated': 'Индекс памяти создан',
265
+ 'errors.validation.invalidMemoryThreshold': 'Некорректный порог консолидации памяти (ожидается число 0.5..0.99)',
266
+ 'errors.failed.memoryConsolidation': 'Не удалось выполнить консолидацию памяти',
267
+ 'memory.consolidated': 'Консолидация памяти выполнена',
268
+ 'errors.validation.invalidMemoryGraphDepth': 'Некорректная глубина графа памяти (целое 1..3)',
269
+ 'errors.validation.invalidMemoryGraphLimit': 'Некорректное значение limit графа памяти (целое 1..200)',
270
+ 'errors.validation.invalidMemoryGraphEntity': 'Некорректная сущность графа памяти (непустая строка длиной до 200 символов)',
271
+ 'errors.failed.memoryGraph': 'Не удалось прочитать граф памяти',
161
272
  // ADR-052 (этап II): исходящие webhooks
162
273
  'errors.validation.invalidWebhook': 'Некорректное тело webhook-подписки',
163
274
  'errors.notFound.webhook': 'Webhook-подписка не найдена',
@@ -211,6 +322,16 @@ const ru = {
211
322
  'locales.ru.nativeName': 'Русский',
212
323
  // Chat
213
324
  'errors.chat.queueFull': 'Очередь переполнена (максимум {max} сообщений)',
325
+ // Отключённые провайдер/модель — отказ до постановки в очередь.
326
+ 'errors.chat.providerDisabled': 'Провайдер «{provider}» отключён — выберите другую модель',
327
+ 'errors.chat.modelDisabled': 'Модель {provider}/{model} отключена — выберите другую модель',
328
+ 'errors.chat.steerLimitExceeded': 'Достигнут лимит вмешательств в ход (максимум {max} сообщений на ход)',
329
+ // ADR-106 Ф3: подтверждение не принято (нет гранта / повторный ответ / чужой ход).
330
+ 'errors.chat.approvalDenied': 'Подтверждение не принято: {reason}',
331
+ // Лимиты заметок сессии (`context.stickyNotes`).
332
+ 'errors.notFound.note': 'Заметка не найдена',
333
+ 'errors.validation.noteTooLong': 'Текст заметки слишком длинный (максимум {max} символов)',
334
+ 'errors.conflict.noteLimitReached': 'Достигнут лимит заметок сессии (максимум {max})',
214
335
  // Stub
215
336
  'stub.llmNotConnected': '[Заглушка] Вы сказали: "{content}". LLM-движок ещё не подключён.',
216
337
  };
@@ -16,9 +16,14 @@ export function createRecalcCanSummarize({ sessionManager, contextOptimizer, eve
16
16
  const can = contextOptimizer.canSummarize(s);
17
17
  // Перепроверить флаг summarizationPending при toggle/pin/delete
18
18
  let shouldClearPending = false;
19
- if (s.summarizationPending && s.settings.summarizationEnabled) {
20
- const sumResult = contextOptimizer.shouldSummarize(s);
21
- if (!sumResult.triggered) {
19
+ if (s.summarizationPending) {
20
+ const compression = typeof contextOptimizer.shouldCompress === 'function'
21
+ ? contextOptimizer.shouldCompress(s)
22
+ : { ...contextOptimizer.shouldSummarize(s), mode: 'summarization' };
23
+ if (!compression.triggered || !compression.mode) {
24
+ shouldClearPending = true;
25
+ }
26
+ else if (typeof contextOptimizer.canCompress === 'function' && !contextOptimizer.canCompress(s)) {
22
27
  shouldClearPending = true;
23
28
  }
24
29
  }
package/dist/main.js CHANGED
@@ -6,8 +6,45 @@
6
6
  import { createBackendApp } from './app.js';
7
7
  import { configureRestart, resolveRestartMode, RESTART_EXIT_CODE, setSynthReady, } from '@itphx/synth-core';
8
8
  const host = process.env.SYNTH_HOST || '0.0.0.0';
9
- const handle = await createBackendApp();
10
- const { app, dataDir, port, config, auth, eventHub, queueManager, sessionManager, stopEphemeralSweeper, stopEventJournalPruner, stopAnalyticsRollupPruner, stopScheduler, stopWebhookService, stopWebhookDeliveryPruner, stopMetrics } = handle;
9
+ // ADR-077: fail-closed на старте (неверный `execution.mode` или `remote` —
10
+ // удалённый исполнитель ещё не реализован, шаг 7 плана) — с понятным текстом.
11
+ let handle;
12
+ try {
13
+ handle = await createBackendApp();
14
+ }
15
+ catch (err) {
16
+ console.error(err instanceof Error ? err.message : String(err));
17
+ process.exit(1);
18
+ }
19
+ const { app, dataDir, port, config, auth, eventHub, queueManager, sessionManager, stopEphemeralSweeper, stopEventJournalPruner, stopAnalyticsRollupPruner, stopScheduler, stopWebhookService, stopWebhookDeliveryPruner, stopMetrics, stopQuestionPruner, stopBackgroundRunPruner, stopProcessLogPruner, stopAttachmentPruner, stopMediaTempPruner } = handle;
20
+ // ADR-090 (Ф5б-1): старт-активация установленных плагинов.
21
+ // `plugins.lock.json` — источник истины; `plugins.executionEnabled=false`
22
+ // (дефолт) → no-op. Ошибка плагина/рантайма **не роняет старт** (только
23
+ // предупреждение); тексты плагинов в лог не попадают (инвариант 13).
24
+ //
25
+ // Ф5в: **сначала** установка deploy-плагинов (образ/PVC, `plugins.deployDir`),
26
+ // затем активация — иначе поставленный образом плагин не попал бы в
27
+ // `plugins.lock.json` и не активировался при первом старте.
28
+ try {
29
+ const deploy = await handle.pluginRuntime.installDeployPlugins({ actor: 'startup' });
30
+ if (deploy.installed.length > 0 || deploy.failed.length > 0) {
31
+ console.log(`[plugins] deploy: установлено ${deploy.installed.length}, ` +
32
+ `пропущено ${deploy.skipped.length}, ошибок ${deploy.failed.length}`);
33
+ }
34
+ }
35
+ catch (err) {
36
+ console.warn(`[plugins] установка deploy-плагинов не выполнена: ${err instanceof Error ? err.message : String(err)}`);
37
+ }
38
+ try {
39
+ const results = await handle.pluginRuntime.activateInstalled({ actor: 'startup' });
40
+ if (results.length > 0) {
41
+ const activated = results.filter((item) => item.outcome === 'activated').length;
42
+ console.log(`[plugins] активировано: ${activated}, отклонено: ${results.length - activated}`);
43
+ }
44
+ }
45
+ catch (err) {
46
+ console.warn(`[plugins] старт-активация не выполнена: ${err instanceof Error ? err.message : String(err)}`);
47
+ }
11
48
  let shuttingDown = false;
12
49
  async function gracefulShutdown(signal, exitCode = 0) {
13
50
  if (shuttingDown)
@@ -34,8 +71,20 @@ async function gracefulShutdown(signal, exitCode = 0) {
34
71
  stopEphemeralSweeper();
35
72
  // ADR-089: остановить retention-очистку журнала событий.
36
73
  stopEventJournalPruner();
37
- // PROP-102: остановить retention-очистку роллапов аналитики.
74
+ // ADR-102: остановить retention-очистку роллапов аналитики.
38
75
  stopAnalyticsRollupPruner();
76
+ // Этап 1 roadmap 0.13 (блок 3): остановить retention-очистку вопросов и
77
+ // освободить ожидания ответа.
78
+ stopQuestionPruner();
79
+ // Этап 1 roadmap 0.13 (блок 4): остановить retention-очистку реестра
80
+ // фоновых прогонов.
81
+ stopBackgroundRunPruner();
82
+ // PROP-097 (блок 5b): остановить retention-очистку логов фоновых процессов.
83
+ stopProcessLogPruner();
84
+ // ADR-115: остановить GC осиротевших вложений сообщений.
85
+ stopAttachmentPruner();
86
+ // ADR-115 × ADR-077: остановить уборку временных каталогов медиа-раннера.
87
+ stopMediaTempPruner();
39
88
  // ADR-094: остановить процессные метрики и фоновые доменные коллекторы
40
89
  // (таймеры сессий/хранилища, подписка шины, decision/journal).
41
90
  stopMetrics();
@@ -2,10 +2,19 @@ import { Hono } from 'hono';
2
2
  import type { AuthKit } from '../auth/middleware.js';
3
3
  import type { JsonStoreLike } from '@itphx/synth-core';
4
4
  import type { AgentDefinition } from '@itphx/synth-shared';
5
- import type { AgentRegistry } from '@itphx/synth-core';
5
+ import type { AgentRegistry, ContextFileRepository } from '@itphx/synth-core';
6
6
  /**
7
7
  * Backend-обёртка над core-фабрикой агентов: добавляет только RBAC
8
8
  * (админ-эндпоинты — ADMIN) и i18n-сообщения. Логика роутов
9
9
  * (GET /, GET /all, POST /, GET /:id, DELETE /:id, PATCH /:id/enabled) — в core.
10
+ *
11
+ * `contextFiles` — порт файлов контекста: запись ролевого промпта агента
12
+ * вместе с агентом (ADR-046/ADR-089, поле `role_prompt` в теле POST).
13
+ * Роль пишется тем же guard'ом, что и создание агента (ADMIN).
14
+ *
15
+ * ADR-052: запись агентов (создание + ролевой промпт) — «роль ADMIN **или**
16
+ * scope `automation:install`» (зонтичный скоуп установщика пакетов
17
+ * расширений). Guard `requireAdminRoleOrScope` учитывает и роль ADMIN в
18
+ * service-key, и scope — прежние права не отбираются, новые добавляются.
10
19
  */
11
- export declare function createAgentRoutes(kit: AuthKit, agentStore: JsonStoreLike<AgentDefinition>, agentRegistry?: AgentRegistry, getDefaultAgentId?: () => string | Promise<string>): Hono;
20
+ export declare function createAgentRoutes(kit: AuthKit, agentStore: JsonStoreLike<AgentDefinition>, agentRegistry?: AgentRegistry, getDefaultAgentId?: () => string | Promise<string>, contextFiles?: ContextFileRepository): Hono;
@@ -1,20 +1,33 @@
1
1
  import { Hono } from 'hono';
2
2
  import { createAgentRoutes as createCoreAgentRoutes } from '@itphx/synth-core';
3
+ import { requireAdminRoleOrScope } from '../auth/guards.js';
3
4
  import { t } from '../lib/i18n.js';
4
5
  /**
5
6
  * Backend-обёртка над core-фабрикой агентов: добавляет только RBAC
6
7
  * (админ-эндпоинты — ADMIN) и i18n-сообщения. Логика роутов
7
8
  * (GET /, GET /all, POST /, GET /:id, DELETE /:id, PATCH /:id/enabled) — в core.
9
+ *
10
+ * `contextFiles` — порт файлов контекста: запись ролевого промпта агента
11
+ * вместе с агентом (ADR-046/ADR-089, поле `role_prompt` в теле POST).
12
+ * Роль пишется тем же guard'ом, что и создание агента (ADMIN).
13
+ *
14
+ * ADR-052: запись агентов (создание + ролевой промпт) — «роль ADMIN **или**
15
+ * scope `automation:install`» (зонтичный скоуп установщика пакетов
16
+ * расширений). Guard `requireAdminRoleOrScope` учитывает и роль ADMIN в
17
+ * service-key, и scope — прежние права не отбираются, новые добавляются.
8
18
  */
9
- export function createAgentRoutes(kit, agentStore, agentRegistry, getDefaultAgentId) {
19
+ export function createAgentRoutes(kit, agentStore, agentRegistry, getDefaultAgentId, contextFiles) {
10
20
  const app = new Hono();
11
21
  app.route('/', createCoreAgentRoutes({ requireAuth: kit.requireAuth }, agentStore, agentRegistry, getDefaultAgentId, {
12
- writeGuard: kit.requireAdmin,
22
+ writeGuard: requireAdminRoleOrScope('automation:install'),
13
23
  allGuard: kit.requireAdmin,
14
24
  detailGuard: kit.requireAdmin,
25
+ roleFiles: contextFiles,
15
26
  messages: {
16
27
  idRequired: (c) => t('errors.validation.idRequired', undefined, c),
17
28
  invalidAgentId: (c) => t('errors.validation.invalidAgentId', undefined, c),
29
+ invalidRoleFile: (c) => t('errors.validation.invalidRoleFile', undefined, c),
30
+ invalidEffort: (c) => t('errors.validation.invalidEffort', undefined, c),
18
31
  agentNotFound: (c) => t('errors.notFound.agent', undefined, c),
19
32
  agentOverrideNotFound: (c) => t('errors.notFound.agentOverride', undefined, c),
20
33
  },
@@ -1,6 +1,16 @@
1
1
  import { Hono } from 'hono';
2
2
  import type { AuthKit } from '../auth/middleware.js';
3
3
  import type { AuthConfig } from '@itphx/synth-shared';
4
+ import type { PluginPolicySignal } from '@itphx/synth-shared';
4
5
  import type { ProfileStore } from '@itphx/synth-shared';
5
6
  import type { DefaultsRepository } from '@itphx/synth-core';
6
- export declare function createAuthRoutes(kit: AuthKit, config: AuthConfig, profiles?: ProfileStore, dataDir?: string, defaultsStore?: DefaultsRepository | null): Hono;
7
+ export declare function createAuthRoutes(kit: AuthKit, config: AuthConfig, profiles?: ProfileStore, dataDir?: string, defaultsStore?: DefaultsRepository | null,
8
+ /**
9
+ * ADR-090 Ф7: сигнал о серверной политике плагинов для публичного
10
+ * дискавери (`GET /auth/oidc-meta`).
11
+ *
12
+ * Только `{ enabled, mode }` — **без списка имён**: allow-list не публичен,
13
+ * полный список отдаёт аутентифицированный роут `GET /api/v2/settings/plugins`.
14
+ * Не задан — сигнала нет (старый клиент трактует это как «неизвестно»).
15
+ */
16
+ pluginPolicySignal?: PluginPolicySignal | null): Hono;
@@ -9,13 +9,42 @@ import { join, resolve, sep } from 'node:path';
9
9
  const OIDC_STATE_COOKIE = 'oidc_state';
10
10
  // Встроенные умолчания оформления (совпадают с тем, что использует UI
11
11
  // по умолчанию: packages/ui/src/lib/defaults.ts + uiScale.ts).
12
+ // `null` — «умолчание не задано»: UI берёт встроенный дефолт.
12
13
  const BUILT_IN_DEFAULTS = {
13
14
  themeMode: 'system',
14
15
  theme: 'synthesis',
15
16
  uiScaleMobile: null,
16
17
  uiScaleDesktop: null,
18
+ chatViewMode: null,
19
+ chatDensity: null,
20
+ chatScaleMobile: null,
21
+ chatScaleDesktop: null,
17
22
  };
18
- export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore) {
23
+ /**
24
+ * Поля умолчаний оформления, которые принимает `PUT /defaults`.
25
+ * Whitelist на границе: тело запроса не должно попадать в стор целиком
26
+ * (запись валидирует store, но лишние ключи там не нужны).
27
+ */
28
+ const DEFAULT_FIELDS = [
29
+ 'themeMode',
30
+ 'theme',
31
+ 'uiScaleMobile',
32
+ 'uiScaleDesktop',
33
+ 'chatViewMode',
34
+ 'chatDensity',
35
+ 'chatScaleMobile',
36
+ 'chatScaleDesktop',
37
+ ];
38
+ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore,
39
+ /**
40
+ * ADR-090 Ф7: сигнал о серверной политике плагинов для публичного
41
+ * дискавери (`GET /auth/oidc-meta`).
42
+ *
43
+ * Только `{ enabled, mode }` — **без списка имён**: allow-list не публичен,
44
+ * полный список отдаёт аутентифицированный роут `GET /api/v2/settings/plugins`.
45
+ * Не задан — сигнала нет (старый клиент трактует это как «неизвестно»).
46
+ */
47
+ pluginPolicySignal) {
19
48
  const app = new Hono();
20
49
  const avatarsDir = dataDir ? join(dataDir, 'auth', 'avatars') : null;
21
50
  // Корень каталога аватаров (абсолютный) — для containment-проверки.
@@ -135,13 +164,18 @@ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore)
135
164
  // Локальный core по адресу сервера узнаёт issuer и public client_id (для ROPC/device flow).
136
165
  // Секрет клиента НЕ отдаётся.
137
166
  app.get('/oidc-meta', (c) => {
167
+ // Ф7 (ADR-090): сигнал о серверной политике плагинов — только режим и
168
+ // признак включения слоя; список имён не публичен (полный список — по
169
+ // аутентифицированному роуту `/api/v2/settings/plugins`).
170
+ const pluginsSignal = pluginPolicySignal ? { plugins: pluginPolicySignal } : {};
138
171
  if (!config.oidc?.enabled) {
139
- return c.json({ enabled: false });
172
+ return c.json({ enabled: false, ...pluginsSignal });
140
173
  }
141
174
  return c.json({
142
175
  enabled: true,
143
176
  issuer: config.oidc.issuer,
144
177
  clientId: config.oidc.cliClientId || 'synth-cli',
178
+ ...pluginsSignal,
145
179
  });
146
180
  });
147
181
  // GET /auth/session — проверка cookie-сессии
@@ -390,7 +424,15 @@ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore)
390
424
  setDefaultLang(locale);
391
425
  }
392
426
  if (defaultsStore) {
393
- const patch = { ...body };
427
+ // Whitelist полей: остальное тело запроса игнорируется, а валидация
428
+ // значений (enum/диапазоны) — в `DefaultsStore.sanitize`.
429
+ const patch = {};
430
+ const rest = body;
431
+ for (const field of DEFAULT_FIELDS) {
432
+ if (field in rest) {
433
+ patch[field] = rest[field];
434
+ }
435
+ }
394
436
  if (patch.locale === undefined && (locale === 'en' || locale === 'ru')) {
395
437
  patch.locale = locale;
396
438
  }
@@ -1,7 +1,8 @@
1
1
  import { Hono } from 'hono';
2
2
  import { z } from 'zod';
3
3
  import { scopeGuard } from '../auth/service-scope.js';
4
- import { ContextLengthExceededError, deobfuscateSecrets, GatewayProvider, ProviderError, ProviderFactory, RateLimitError, createLlmCallRecorder, } from '@itphx/synth-core';
4
+ import { EFFORT_LEVELS, mergeModelCompatibility } from '@itphx/synth-shared';
5
+ import { buildChatOptions, ContextLengthExceededError, deobfuscateSecrets, GatewayProvider, ProviderError, ProviderFactory, RateLimitError, createLlmCallRecorder, } from '@itphx/synth-core';
5
6
  /**
6
7
  * LLM Proxy endpoint (гибридный режим, Часть 5).
7
8
  * OpenAI-совместимый POST /api/v2/llm/chat/completions, через который локальный
@@ -17,7 +18,7 @@ import { ContextLengthExceededError, deobfuscateSecrets, GatewayProvider, Provid
17
18
  const chatMessageSchema = z.object({
18
19
  role: z.string().min(1),
19
20
  content: z.string().nullable(),
20
- tool_calls: z.array(z.record(z.unknown())).optional(),
21
+ tool_calls: z.array(z.record(z.string(), z.unknown())).optional(),
21
22
  tool_call_id: z.string().optional(),
22
23
  reasoning_content: z.string().optional(),
23
24
  name: z.string().optional(),
@@ -29,12 +30,22 @@ const chatCompletionsSchema = z.object({
29
30
  temperature: z.number().optional(),
30
31
  max_tokens: z.number().int().positive().optional(),
31
32
  top_p: z.number().optional(),
33
+ /**
34
+ * ADR-117: тир усилия модели в OpenAI-совместимом поле (`EffortLevel`).
35
+ * Прокидывается провайдеру как `ChatOptions.effort`; отправляется он только
36
+ * при `compatibility.supportsEffortUpdates` (guard остаётся в провайдере).
37
+ * Невалидное значение — 400 (контракт запроса, а не «тихий» игнор).
38
+ */
39
+ reasoning_effort: z.enum(EFFORT_LEVELS).optional(),
32
40
  stream: z.boolean().optional(),
33
41
  // ADR-070: remote-зеркала (RemoteProvider) просят usage в стриме. Внутренний
34
42
  // OpenAIProvider всегда шлёт stream_options.include_usage, но поле принимаем
35
43
  // явно, чтобы Zod его не срезал (контракт запроса).
36
44
  stream_options: z.object({ include_usage: z.boolean().optional() }).optional(),
37
- tools: z.array(z.record(z.unknown())).optional(),
45
+ tools: z.array(z.record(z.string(), z.unknown())).optional(),
46
+ // Управление вызовом инструментов на шаге: `none` — финальный шаг-отчёт по
47
+ // лимиту шагов (инструменты остаются в запросе ради кэшированного префикса).
48
+ tool_choice: z.enum(['auto', 'none', 'required']).optional(),
38
49
  session_id: z.string().optional(),
39
50
  // Имя серверного провайдера (шлют remote-зеркала RemoteProvider в гибриде).
40
51
  // Опционально — старые клиенты без поля работают как раньше (резолв по модели).
@@ -156,6 +167,10 @@ export function createLlmRoutes(kit, deps) {
156
167
  }, 400);
157
168
  }
158
169
  // 2. Создаём провайдер (модель из ModelConfig.name — реальное имя для LLM API).
170
+ // ADR-117: совместимость протокола собирается теми же слоями, что и в
171
+ // сессионном вызове — провайдер → shorthand модели (`requiresReasoning`) →
172
+ // модель. Без этого у прокси не работали `requireReasoning`,
173
+ // `maxTokensField`, `cacheFormat`, `supportsEffortUpdates`.
159
174
  let inner;
160
175
  try {
161
176
  inner = ProviderFactory.create(providerName, {
@@ -167,6 +182,9 @@ export function createLlmRoutes(kit, deps) {
167
182
  timeout: providerConfig.timeout ?? 120,
168
183
  maxTokens: body.max_tokens,
169
184
  numCtx: providerConfig.numCtx,
185
+ compatibility: mergeModelCompatibility(providerConfig.compatibility, modelConfig.requiresReasoning !== undefined
186
+ ? { requireReasoning: modelConfig.requiresReasoning }
187
+ : undefined, modelConfig.compatibility),
170
188
  }, body.temperature, body.top_p);
171
189
  }
172
190
  catch (e) {
@@ -201,12 +219,16 @@ export function createLlmRoutes(kit, deps) {
201
219
  });
202
220
  const messages = toLlmMessages(body.messages);
203
221
  const tools = body.tools && body.tools.length > 0 ? body.tools : undefined;
222
+ // `tool_choice` уходит провайдеру только когда задан в теле (иначе поведение
223
+ // прежнее — решение за моделью); `reasoning_effort` — тем же объектом опций
224
+ // (`buildChatOptions` не создаёт пустой `{}`).
225
+ const chatOptions = buildChatOptions(body.reasoning_effort, body.tool_choice);
204
226
  if (body.stream) {
205
- return streamCompletions(c, provider, messages, tools, body.model, transientMap);
227
+ return streamCompletions(c, provider, messages, tools, body.model, transientMap, chatOptions);
206
228
  }
207
229
  // 4. Non-stream: полный ответ в OpenAI-формате.
208
230
  try {
209
- const response = await provider.chat(messages, undefined, tools, false);
231
+ const response = await provider.chat(messages, undefined, tools, false, undefined, chatOptions);
210
232
  const map = transientMap.get('proxy') ?? {};
211
233
  const content = deobfuscateSecrets(response.content, map);
212
234
  // Симметрично OpenAIProvider._parseResponse: tool_calls → message.tool_calls,
@@ -240,7 +262,7 @@ export function createLlmRoutes(kit, deps) {
240
262
  * Ошибки провайдера в середине стрима (статус уже 200) шлём объектом error
241
263
  * в потоке, затем [DONE] и закрываем.
242
264
  */
243
- function streamCompletions(c, provider, messages, tools, model, transientMap) {
265
+ function streamCompletions(c, provider, messages, tools, model, transientMap, chatOptions) {
244
266
  const signal = c.req.raw.signal;
245
267
  const cancellationToken = {
246
268
  cancelled: false,
@@ -269,7 +291,7 @@ function streamCompletions(c, provider, messages, tools, model, transientMap) {
269
291
  // отдаём дельту, чтобы клиент (RemoteProvider) накапливал как content.
270
292
  let sentReasoningLen = 0;
271
293
  try {
272
- for await (const chunk of provider.chatAsync(messages, undefined, tools, undefined, cancellationToken)) {
294
+ for await (const chunk of provider.chatAsync(messages, undefined, tools, undefined, cancellationToken, chatOptions)) {
273
295
  if (chunk.usage)
274
296
  finalUsage = chunk.usage;
275
297
  if (chunk.toolCalls && chunk.toolCalls.length > 0)
@@ -1,6 +1,7 @@
1
1
  import { Hono } from 'hono';
2
+ import type { Context } from 'hono';
2
3
  import type { AuthKit } from '../auth/middleware.js';
3
- import type { SessionManager, McpManager, McpRegistryRepository } from '@itphx/synth-core';
4
+ import type { SessionManager, McpManager, McpRegistryRepository, ExternalCredentialRepository } from '@itphx/synth-core';
4
5
  import type { McpNetworkPolicy } from '@itphx/synth-shared';
5
6
  export interface McpRoutesOptions {
6
7
  /** ADR-071 §2.5: единый реестр MCP-серверов (источник истины для `/servers` и `/registry`). */
@@ -12,5 +13,16 @@ export interface McpRoutesOptions {
12
13
  * Приоритетнее статической `networkPolicy`; читается на каждый запрос.
13
14
  */
14
15
  getNetworkPolicy?: () => Promise<McpNetworkPolicy | undefined>;
16
+ /**
17
+ * ADR-105 (Ф3): порт слоя внешних доступов — право привязать доступ
18
+ * к коннектору проверяется на границе (инвариант 16). Не задан — привязка
19
+ * запрещена (fail-closed).
20
+ */
21
+ credentials?: ExternalCredentialRepository;
22
+ /**
23
+ * ADR-105 (Ф3): право участника проекта **изменять содержимое** проекта
24
+ * (`OWNER`/`EDITOR`, а также `LEAD`/`ADMIN`) — для доступа уровня проекта.
25
+ */
26
+ canEditProject?: (c: Context, projectId: string) => boolean | Promise<boolean>;
15
27
  }
16
28
  export declare function createMcpRegistryRoutes(kit: AuthKit, mcpManager: McpManager | null, sessionManager: SessionManager | null, options: McpRoutesOptions): Hono;