@itphx/synth-shared 0.12.4 → 0.13.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/dist/config/defaults.js +125 -5
  2. package/dist/config/env-overrides.d.ts +23 -4
  3. package/dist/config/env-overrides.js +103 -4
  4. package/dist/config/index.d.ts +1 -0
  5. package/dist/config/index.js +1 -0
  6. package/dist/config/loader.d.ts +8 -0
  7. package/dist/config/loader.js +6 -1
  8. package/dist/config/redact.d.ts +22 -0
  9. package/dist/config/redact.js +53 -0
  10. package/dist/config/resolve.d.ts +17 -0
  11. package/dist/config/resolve.js +40 -1
  12. package/dist/config/tls.d.ts +7 -4
  13. package/dist/config/tls.js +10 -23
  14. package/dist/config/types.d.ts +496 -11
  15. package/dist/config/types.js +348 -6
  16. package/dist/i18n/index.d.ts +1 -1
  17. package/dist/i18n/index.js +317 -3
  18. package/dist/index.d.ts +4 -4
  19. package/dist/index.js +4 -4
  20. package/dist/model-metadata.d.ts +10 -0
  21. package/dist/model-metadata.js +10 -0
  22. package/dist/schemas/index.d.ts +378 -21
  23. package/dist/schemas/index.js +282 -5
  24. package/dist/types/agent.d.ts +8 -1
  25. package/dist/types/bus-events.d.ts +60 -2
  26. package/dist/types/egress.d.ts +2 -2
  27. package/dist/types/egress.js +2 -2
  28. package/dist/types/file-kind.d.ts +40 -0
  29. package/dist/types/file-kind.js +157 -0
  30. package/dist/types/fs.d.ts +54 -1
  31. package/dist/types/fs.js +43 -0
  32. package/dist/types/git.d.ts +88 -0
  33. package/dist/types/git.js +101 -1
  34. package/dist/types/host-pattern.d.ts +41 -0
  35. package/dist/types/host-pattern.js +143 -0
  36. package/dist/types/index.d.ts +4 -0
  37. package/dist/types/index.js +13 -1
  38. package/dist/types/llm.d.ts +95 -0
  39. package/dist/types/llm.js +58 -0
  40. package/dist/types/maintenance.d.ts +1 -1
  41. package/dist/types/mcp.d.ts +90 -0
  42. package/dist/types/mcp.js +11 -0
  43. package/dist/types/message-stream.d.ts +389 -0
  44. package/dist/types/message-stream.js +41 -0
  45. package/dist/types/message.d.ts +49 -0
  46. package/dist/types/pack.d.ts +6 -6
  47. package/dist/types/permission.d.ts +39 -3
  48. package/dist/types/pipeline-engine.d.ts +2 -2
  49. package/dist/types/project.d.ts +30 -0
  50. package/dist/types/project.js +16 -0
  51. package/dist/types/prompt.d.ts +4 -2
  52. package/dist/types/provider.d.ts +280 -0
  53. package/dist/types/provider.js +289 -0
  54. package/dist/types/service-keys.d.ts +6 -3
  55. package/dist/types/service-keys.js +6 -1
  56. package/dist/types/session.d.ts +178 -3
  57. package/dist/types/skills.d.ts +6 -0
  58. package/dist/types/tools.d.ts +57 -0
  59. package/dist/types/tools.js +49 -1
  60. package/dist/types/user.d.ts +7 -0
  61. package/dist/types/worktree.d.ts +1 -1
  62. package/dist/utils/index.js +1 -1
  63. package/dist/utils/reasoning.d.ts +18 -2
  64. package/dist/utils/reasoning.js +16 -7
  65. package/dist/version.d.ts +1 -1
  66. package/dist/version.js +1 -1
  67. package/package.json +4 -3
@@ -1,5 +1,5 @@
1
- import { DEFAULT_MCP_PRIVATE_CIDRS, DEFAULT_EGRESS_TOOLS_POLICY, DEFAULT_EGRESS_WEBHOOKS_POLICY, DEFAULT_EGRESS_LOG, } from '../types/index.js';
2
- import { DEFAULT_MAX_UPLOAD_BYTES } from '../types/index.js';
1
+ import { DEFAULT_MCP_PRIVATE_CIDRS, DEFAULT_EGRESS_TOOLS_POLICY, DEFAULT_EGRESS_WEBHOOKS_POLICY, DEFAULT_EGRESS_LOG, GlobalRole, } from '../types/index.js';
2
+ import { DEFAULT_MAX_UPLOAD_BYTES, DEFAULT_MAX_READ_BYTES, DEFAULT_MAX_PREVIEW_BYTES } from '../types/index.js';
3
3
  import { DEFAULT_PROMPT_BLOCK_MAX_CHARS, DEFAULT_LLM_FILTER_TIMEOUT_MS } from '../types/index.js';
4
4
  import { DEFAULT_EXECUTION_TIMEOUT_MS } from './types.js';
5
5
  import { defaultExecutionConcurrency } from './execution.js';
@@ -22,6 +22,8 @@ export const defaultConfig = {
22
22
  defaultWorkspace: '',
23
23
  workspaceOutsideRoot: '',
24
24
  maxUploadBytes: DEFAULT_MAX_UPLOAD_BYTES,
25
+ maxReadBytes: DEFAULT_MAX_READ_BYTES,
26
+ maxPreviewBytes: DEFAULT_MAX_PREVIEW_BYTES,
25
27
  },
26
28
  execution: {
27
29
  // ADR-077: топология исполнения — параметр запуска (инвариант 24: смена
@@ -44,6 +46,9 @@ export const defaultConfig = {
44
46
  },
45
47
  auth: {
46
48
  debugMode: false,
49
+ // Единый API-ключ выдаёт только базовую роль; ADMIN — явной настройкой
50
+ // (`auth.apiKeyRoles` / `SYNTH_API_KEY_ROLES`).
51
+ apiKeyRoles: [GlobalRole.USER],
47
52
  sessionMaxAgeMinutes: 1440,
48
53
  },
49
54
  llm: {
@@ -51,6 +56,7 @@ export const defaultConfig = {
51
56
  defaultModel: '',
52
57
  maxRetries: 3,
53
58
  timeout: 60,
59
+ maxTokens: 8192,
54
60
  cache: 'auto',
55
61
  },
56
62
  core: {
@@ -98,9 +104,42 @@ export const defaultConfig = {
98
104
  },
99
105
  session: {
100
106
  planMode: 'auto',
107
+ // Авто-заголовок сессии: включён, приветствие откладывает именование,
108
+ // ждём до 2 реплик, «сигналом задачи» считаем сообщение от 30 символов.
109
+ autoTitle: {
110
+ enabled: true,
111
+ deferOnChatter: true,
112
+ maxAttempts: 2,
113
+ minSignalChars: 30,
114
+ },
101
115
  },
102
116
  context: {
103
117
  enabledFiles: ['SOUL.md', 'COMPANY.md', 'ABOUT.md'],
118
+ // Политика контекстного окна: по умолчанию только предупреждать (блокировка — opt-in).
119
+ windowPolicy: 'warn',
120
+ // Дефолты оптимизации контекста для новых сессий (совпадают с прежними
121
+ // литералами `SessionManager.createSession`).
122
+ defaults: {
123
+ contextOptimization: 'compaction',
124
+ summarizationEnabled: true,
125
+ summarizationTriggerMode: 'messages',
126
+ summarizeAfterN: 10,
127
+ summarizeTokenThreshold: 50,
128
+ summarizationHeadMessages: 2,
129
+ summarizationTailMessages: 3,
130
+ summarizationKeepTokens: 5000,
131
+ compactionKeepTokens: 15000,
132
+ compactionTokenThreshold: 85,
133
+ slidingWindowMode: 'messages',
134
+ slidingWindowMessageLimit: 10,
135
+ slidingWindowTokenThreshold: 80,
136
+ },
137
+ // Instance-wide лимиты заметок сессии (`context.stickyNotes`): ограничения
138
+ // инстанса, не дефолты сессии. Существующие заметки не обрезаются.
139
+ stickyNotes: {
140
+ maxCount: 50,
141
+ maxChars: 2000,
142
+ },
104
143
  },
105
144
  summarization: {
106
145
  provider: '',
@@ -123,6 +162,10 @@ export const defaultConfig = {
123
162
  capabilities: [],
124
163
  tools: [],
125
164
  },
165
+ // Общий предел вывода инструментов (строк/байт) — усечение результата
166
+ // с пометкой «показано N из M».
167
+ outputMaxLines: 2000,
168
+ outputMaxBytes: 51_200,
126
169
  },
127
170
  skills: {
128
171
  paths: [],
@@ -189,6 +232,23 @@ export const defaultConfig = {
189
232
  // ADR-102: срок хранения суточных роллапов — 400 дней (<= 0 — без ограничения).
190
233
  retentionDays: 400,
191
234
  },
235
+ git: {
236
+ // ADR-076: таймауты сетевых git-операций. 5 минут: сеть git может идти
237
+ // минутами (большой репозиторий/медленный remote), но «зависший» вызов не
238
+ // должен держать ход агента бесконечно; 0 — без таймаута.
239
+ cloneTimeoutMs: 300_000,
240
+ fetchTimeoutMs: 300_000,
241
+ // Таймауты git-тулов агента по классам операции: локальные изменяющие
242
+ // (commit/checkout/stash) — 2 минуты, сетевые (push/pull) — 5 минут.
243
+ // Read-only операции имеют фиксированный предел 30 с. 0 — без таймаута.
244
+ localTimeoutMs: 120_000,
245
+ networkTimeoutMs: 300_000,
246
+ },
247
+ ssh: {
248
+ // PROP-124: режим работы инстанса с SSH-ключами. `tools` — fail-closed:
249
+ // без явного выбора ключ не попадает в окружение команд.
250
+ mode: 'tools',
251
+ },
192
252
  questions: {
193
253
  // Этап 1 roadmap 0.13 (блок 3): срок ожидания ответа пользователя на вопрос —
194
254
  // по умолчанию **без таймаута** (0): вопрос ждёт, пока ответят или отменят
@@ -207,13 +267,28 @@ export const defaultConfig = {
207
267
  maxSubagentsPerSession: 2,
208
268
  // Максимум одновременно идущих фоновых шелл-процессов на сессию-владельца.
209
269
  maxProcessesPerSession: 5,
210
- // Максимум записей реестра на сессию-владельца (чистится retention-ом).
270
+ // Максимум одновременно идущих прогонов любого вида на сессию-владельца
271
+ // (история реестра лимитом не считается — её чистит retention).
211
272
  maxRunsPerSession: 10,
212
273
  // Предел размера лога фонового процесса, байт (10 МиБ; 0 — без ограничения).
213
274
  logMaxBytes: 10_485_760,
214
275
  // Срок хранения терминальных записей реестра (дни; <= 0 — без ограничения).
215
276
  retentionDays: 7,
216
277
  },
278
+ agents: {
279
+ // Предохранитель по объёму промпта саб-агента (не окно модели): при
280
+ // превышении оценка бюджета завершает прогон детерминированным отчётом.
281
+ // 0 — без ограничения.
282
+ subagentMaxInputTokens: 0,
283
+ // Лимит глубины вложенности саб-агентов (по цепочке `parentId` сессий:
284
+ // текущая — 0, родитель — 1, …). 0 — без ограничения.
285
+ subagentDepth: 1,
286
+ },
287
+ limits: {
288
+ // Лимит тяжёлых операций с сессиями (import/export/fork/merge) в минуту
289
+ // на креду. 0 — без ограничения.
290
+ sessionOpsPerMinute: 10,
291
+ },
217
292
  attachments: {
218
293
  // ADR-115: вложения сообщений. Мастер-выключатель, семейства MIME,
219
294
  // лимиты (байты на файл, число файлов в сообщении, суммарный объём на
@@ -221,7 +296,7 @@ export const defaultConfig = {
221
296
  // хранения осиротевших объектов.
222
297
  enabled: true,
223
298
  modalities: { image: true, pdf: true, audio: true, video: true },
224
- maxBytesPerFile: 25 * 1024 * 1024,
299
+ maxBytesPerFile: 100 * 1024 * 1024,
225
300
  maxFilesPerMessage: 10,
226
301
  maxBytesPerSession: 1024 * 1024 * 1024,
227
302
  allowedMimePrefixes: ['image/', 'audio/', 'video/', 'application/pdf', 'text/'],
@@ -231,11 +306,54 @@ export const defaultConfig = {
231
306
  // с путём в workspace (текущее поведение).
232
307
  modalityModels: {},
233
308
  gcDays: 30,
309
+ // ADR-115: сжатие — только на границе отправки провайдеру (в blob лежит
310
+ // оригинал). Пределы сторон/битрейты — разумные дефолты для чата; пороги
311
+ // `minBytes` не дают перекодировать мелкие файлы.
312
+ compression: {
313
+ enabled: true,
314
+ image: { enabled: true, maxSidePx: 2048, quality: 85, minBytes: 1024 * 1024 },
315
+ video: {
316
+ enabled: true,
317
+ maxHeightPx: 720,
318
+ bitrateKbps: 2000,
319
+ audioBitrateKbps: 96,
320
+ minBytes: 8 * 1024 * 1024,
321
+ },
322
+ audio: {
323
+ enabled: true,
324
+ bitrateKbps: 64,
325
+ channels: 1,
326
+ sampleRateHz: 16000,
327
+ minBytes: 4 * 1024 * 1024,
328
+ },
329
+ },
330
+ // ADR-115: серверные миниатюры для UI (производный JPEG в blob).
331
+ thumbnail: { enabled: true, maxWidthPx: 512 },
332
+ // Предел одной части chunked-загрузки, байт (8 МиБ).
333
+ maxChunkBytes: 8 * 1024 * 1024,
334
+ // Пределы числа незавершённых chunked-загрузок: одной сессии и инстанса
335
+ // (включая staging-контур без привязки к сессии).
336
+ maxActiveUploadsPerSession: 16,
337
+ maxActiveUploads: 256,
234
338
  },
235
339
  metrics: {
236
340
  // ADR-094: экспорт Prometheus-метрик выключен по умолчанию (`GET /metrics` → 404).
237
341
  enabled: false,
238
342
  },
343
+ updates: {
344
+ // ADR-133: автопроверка обновлений **выключена по умолчанию** — инстанс не
345
+ // ходит в реестры без явного согласия владельца (офлайн/закрытый контур не
346
+ // шумит запросами). Явная проверка (`synth update --check`, `?force=1`) от
347
+ // этого флага не зависит.
348
+ check: false,
349
+ // Канал выводится из установленной версии (`-beta.` ⇒ beta), иначе stable.
350
+ channel: 'auto',
351
+ // TTL успешной проверки; ошибка кэшируется на 1 ч.
352
+ intervalHours: 24,
353
+ // Стабильный канал — npmjs; бета — npm-реестр Gitea (чтение без токена).
354
+ stableRegistry: 'https://registry.npmjs.org',
355
+ betaRegistry: 'https://git.itphx.ru/api/packages/itphx/npm/',
356
+ },
239
357
  authority: {
240
358
  // ADR-106 Ф1: Authority-слой выключен по умолчанию — права не меняются.
241
359
  enabled: false,
@@ -414,7 +532,9 @@ export const defaultConfig = {
414
532
  },
415
533
  permission: {
416
534
  rules: {},
417
- askTimeoutMs: 30_000,
535
+ // ADR-029: срок ожидания подтверждения `ask` (по истечении — авто-отказ).
536
+ // 5 минут: пользователь должен успеть увидеть запрос и ответить.
537
+ askTimeoutMs: 300_000,
418
538
  },
419
539
  security: {
420
540
  promptInjection: {
@@ -1,3 +1,4 @@
1
+ import { GlobalRole } from '../types/user.js';
1
2
  export type EnvOverrideType = 'boolean' | 'number' | 'string';
2
3
  export interface EnvOverrideDefinition {
3
4
  /** Секция верхнего уровня конфига (`events`, `scheduler`, `webhooks`, `decision`). */
@@ -18,6 +19,21 @@ export interface EnvOverrideDefinition {
18
19
  export declare const ENV_OVERRIDES: readonly EnvOverrideDefinition[];
19
20
  /** camelCase → SNAKE_CASE (`autoBind` → `AUTO_BIND`, `ephemeralTtl` → `EPHEMERAL_TTL`). */
20
21
  export declare function toSnakeCase(value: string): string;
22
+ /**
23
+ * Роли пользователя единого API-ключа (`auth.apiKeyRoles`), csv: `ADMIN,USER`.
24
+ *
25
+ * Намеренно **fail-closed** (в отличие от прочих env-оверрайдов): неизвестная
26
+ * роль — ошибка конфигурации на загрузке, а не warn+игнор. Иначе опечатка в
27
+ * `SYNTH_API_KEY_ROLES` молча оставляла бы дефолт (`USER`) или, хуже, ключ без
28
+ * ожидаемых прав; для прав доступа это недопустимо.
29
+ */
30
+ export declare const API_KEY_ROLES_ENV = "SYNTH_API_KEY_ROLES";
31
+ /**
32
+ * Разобрать csv ролей API-ключа (`ADMIN,USER`; регистр и пробелы не важны).
33
+ * Пустой список и неизвестная роль → `Error` (fail-closed, понятный текст).
34
+ * Дубликаты схлопываются с сохранением порядка.
35
+ */
36
+ export declare function parseApiKeyRoles(raw: string): GlobalRole[];
21
37
  /**
22
38
  * Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. Точки в ключе означают
23
39
  * вложенность (`log.enabled` → `SYNTH_EGRESS_LOG_ENABLED`).
@@ -89,10 +105,13 @@ export declare const BOOTSTRAP_SERVICE_KEYS_ENV = "SYNTH_BOOTSTRAP_SERVICE_KEYS"
89
105
  export declare const OAUTH_PROVIDERS_ENV = "SYNTH_OAUTH_PROVIDERS";
90
106
  /**
91
107
  * Применяет объектные env-оверрайды, у которых нет плоского строкового
92
- * представления (сейчас — `security.bootstrapServiceKeys`). Значение парсится
93
- * как JSON и валидируется схемой; при ошибке парсинга/валидации — warn в console
94
- * и игнор (fail-soft: кривой installer-ключ не должен ронять старт инстанса —
95
- * ensure-логика приложения просто ничего не бутстрапит, оператор видит warn).
108
+ * представления (`auth.apiKeyRoles`, `attachments.modalities`, `oauth.providers`,
109
+ * `security.bootstrapServiceKeys`). Нескалярные значения парсятся здесь;
110
+ * `security.bootstrapServiceKeys` — JSON, валидируется схемой, при ошибке
111
+ * парсинга/валидации warn в console и игнор (fail-soft: кривой installer-ключ не
112
+ * должен ронять старт инстанса — ensure-логика приложения просто ничего не
113
+ * бутстрапит, оператор видит warn). Исключение — `auth.apiKeyRoles`: там
114
+ * неизвестная роль бросает `Error` (fail-closed, права доступа).
96
115
  *
97
116
  * Мутирует переданный объект (в `loadConfig` — свежий результат `deepMerge`) и
98
117
  * возвращает его; секция `security` клонируется, чтобы не мутировать `defaultConfig`.
@@ -11,6 +11,7 @@
11
11
  * Приоритет (ADR-023): CLI-флаги (`overrides`) > env (`SYNTH_*`) > config.yaml > defaults.
12
12
  */
13
13
  import { bootstrapServiceKeysSchema, oauthProvidersSchema } from './types.js';
14
+ import { GlobalRole } from '../types/user.js';
14
15
  /**
15
16
  * Реестр env-оверрайдов скалярных ключей вложенных секций (ADR-023).
16
17
  *
@@ -20,6 +21,20 @@ import { bootstrapServiceKeysSchema, oauthProvidersSchema } from './types.js';
20
21
  * плоского строкового представления — они остаются в config.yaml.
21
22
  */
22
23
  export const ENV_OVERRIDES = [
24
+ // llm: лимит вывода по умолчанию (0 — авто-дефолт ядра).
25
+ { section: 'llm', key: 'maxTokens', type: 'number' },
26
+ // llmGateway (ADR-036): мастер-выключатель шлюза. Дефолт зависит от профиля
27
+ // (backend/managed — включён, standalone — выключен); env перебивает и его,
28
+ // и config.yaml, но ниже runtime-тумблера из UI (`settings.json`).
29
+ { section: 'llmGateway', key: 'enabled', type: 'boolean' },
30
+ // session.autoTitle: авто-именование сессии (мастер-флаг, отсрочка на
31
+ // приветствии, число реплик, порог «сигнала задачи»).
32
+ { section: 'session', key: 'autoTitle.enabled', type: 'boolean' },
33
+ { section: 'session', key: 'autoTitle.deferOnChatter', type: 'boolean' },
34
+ { section: 'session', key: 'autoTitle.maxAttempts', type: 'number' },
35
+ { section: 'session', key: 'autoTitle.minSignalChars', type: 'number' },
36
+ // context: политика ограничения контекстного окна (`off`|`warn`|`enforce`).
37
+ { section: 'context', key: 'windowPolicy', type: 'string' },
23
38
  // events (ADR-089)
24
39
  { section: 'events', key: 'enabled', type: 'boolean' },
25
40
  { section: 'events', key: 'defaultMode', type: 'string' },
@@ -61,6 +76,17 @@ export const ENV_OVERRIDES = [
61
76
  { section: 'decision', key: 'escalationModel', type: 'string' },
62
77
  // analytics (ADR-102)
63
78
  { section: 'analytics', key: 'retentionDays', type: 'number' },
79
+ // git (ADR-076): таймауты сетевых git-операций (0 — без таймаута).
80
+ { section: 'git', key: 'cloneTimeoutMs', type: 'number' },
81
+ { section: 'git', key: 'fetchTimeoutMs', type: 'number' },
82
+ // git-тулы агента: локальные изменяющие операции и сетевые (0 — без таймаута).
83
+ { section: 'git', key: 'localTimeoutMs', type: 'number' },
84
+ { section: 'git', key: 'networkTimeoutMs', type: 'number' },
85
+ // ssh (PROP-124): режим работы инстанса с SSH-ключами (`tools`|`agent`).
86
+ // Переменная `SYNTH_SSH_MODE` читается НЕ здесь, а дедикарованным
87
+ // резолвером `resolveSshMode` (core) — как `SYNTH_EXECUTION_MODE`/
88
+ // `SYNTH_STORAGE_BACKEND`: один путь чтения на переменную, невалидное
89
+ // значение — ошибка конфигурации (fail-closed), а не warn + дефолт.
64
90
  // questions (этап 1 roadmap 0.13 — блок 3): таймаут ответа + retention.
65
91
  { section: 'questions', key: 'timeoutMs', type: 'number' },
66
92
  { section: 'questions', key: 'retentionDays', type: 'number' },
@@ -71,6 +97,12 @@ export const ENV_OVERRIDES = [
71
97
  { section: 'background', key: 'maxRunsPerSession', type: 'number' },
72
98
  { section: 'background', key: 'logMaxBytes', type: 'number' },
73
99
  { section: 'background', key: 'retentionDays', type: 'number' },
100
+ // agents: предохранитель по объёму промпта саб-агента (не окно модели).
101
+ { section: 'agents', key: 'subagentMaxInputTokens', type: 'number' },
102
+ // agents: лимит глубины вложенности саб-агентов (0 — без ограничения).
103
+ { section: 'agents', key: 'subagentDepth', type: 'number' },
104
+ // limits: лимит тяжёлых операций с сессиями в минуту (0 — без ограничения).
105
+ { section: 'limits', key: 'sessionOpsPerMinute', type: 'number' },
74
106
  // attachments (ADR-115): вложения сообщений. Семейства MIME
75
107
  // (`SYNTH_ATTACHMENTS_MODALITIES`, csv) — объектный ключ, обрабатывается
76
108
  // отдельно (`applyAttachmentsModalitiesEnvOverride`); список префиксов
@@ -81,8 +113,24 @@ export const ENV_OVERRIDES = [
81
113
  { section: 'attachments', key: 'maxFilesPerMessage', type: 'number' },
82
114
  { section: 'attachments', key: 'maxBytesPerSession', type: 'number' },
83
115
  { section: 'attachments', key: 'gcDays', type: 'number' },
116
+ // attachments: размер части chunked-загрузки, байт (схема: ≥ 1024;
117
+ // невалидное значение ниже порога отбрасывает резолвер core).
118
+ { section: 'attachments', key: 'maxChunkBytes', type: 'number' },
119
+ // attachments: число одновременных chunked-загрузок — на сессию и глобально.
120
+ { section: 'attachments', key: 'maxActiveUploadsPerSession', type: 'number' },
121
+ { section: 'attachments', key: 'maxActiveUploads', type: 'number' },
84
122
  // metrics (ADR-094): Helm ставит `SYNTH_METRICS_ENABLED` — имя должно совпадать.
85
123
  { section: 'metrics', key: 'enabled', type: 'boolean' },
124
+ // updates (ADR-133): каналы обновлений. `check` — автопроверка в фоне;
125
+ // `channel` — `auto`|`stable`|`beta`; интервал и реестры каналов.
126
+ { section: 'updates', key: 'check', type: 'boolean' },
127
+ { section: 'updates', key: 'channel', type: 'string' },
128
+ { section: 'updates', key: 'intervalHours', type: 'number' },
129
+ { section: 'updates', key: 'stableRegistry', type: 'string' },
130
+ { section: 'updates', key: 'betaRegistry', type: 'string' },
131
+ // tools: общий предел вывода инструментов (строк/байт).
132
+ { section: 'tools', key: 'outputMaxLines', type: 'number' },
133
+ { section: 'tools', key: 'outputMaxBytes', type: 'number' },
86
134
  // authority (ADR-106 Ф1): мастер-выключатель слоя и режим наблюдения.
87
135
  { section: 'authority', key: 'enabled', type: 'boolean' },
88
136
  { section: 'authority', key: 'shadow', type: 'boolean' },
@@ -111,6 +159,53 @@ export const ENV_OVERRIDES = [
111
159
  export function toSnakeCase(value) {
112
160
  return value.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toUpperCase();
113
161
  }
162
+ /**
163
+ * Роли пользователя единого API-ключа (`auth.apiKeyRoles`), csv: `ADMIN,USER`.
164
+ *
165
+ * Намеренно **fail-closed** (в отличие от прочих env-оверрайдов): неизвестная
166
+ * роль — ошибка конфигурации на загрузке, а не warn+игнор. Иначе опечатка в
167
+ * `SYNTH_API_KEY_ROLES` молча оставляла бы дефолт (`USER`) или, хуже, ключ без
168
+ * ожидаемых прав; для прав доступа это недопустимо.
169
+ */
170
+ export const API_KEY_ROLES_ENV = 'SYNTH_API_KEY_ROLES';
171
+ const API_KEY_ROLE_VALUES = Object.values(GlobalRole);
172
+ /**
173
+ * Разобрать csv ролей API-ключа (`ADMIN,USER`; регистр и пробелы не важны).
174
+ * Пустой список и неизвестная роль → `Error` (fail-closed, понятный текст).
175
+ * Дубликаты схлопываются с сохранением порядка.
176
+ */
177
+ export function parseApiKeyRoles(raw) {
178
+ const tokens = raw
179
+ .split(',')
180
+ .map((part) => part.trim().toUpperCase())
181
+ .filter((part) => part !== '');
182
+ if (tokens.length === 0) {
183
+ throw new Error(`[config] ${API_KEY_ROLES_ENV}: пустой список ролей; допустимо: ${API_KEY_ROLE_VALUES.join(', ')}`);
184
+ }
185
+ const roles = [];
186
+ for (const token of tokens) {
187
+ if (!API_KEY_ROLE_VALUES.includes(token)) {
188
+ throw new Error(`[config] ${API_KEY_ROLES_ENV}: неизвестная роль "${token}"; ` +
189
+ `допустимо: ${API_KEY_ROLE_VALUES.join(', ')}`);
190
+ }
191
+ const role = token;
192
+ if (!roles.includes(role))
193
+ roles.push(role);
194
+ }
195
+ return roles;
196
+ }
197
+ function applyApiKeyRolesEnvOverride(config, env) {
198
+ const raw = env[API_KEY_ROLES_ENV];
199
+ if (raw === undefined || raw === '')
200
+ return;
201
+ const roles = parseApiKeyRoles(raw);
202
+ const current = config.auth;
203
+ const auth = current !== null && typeof current === 'object' && !Array.isArray(current)
204
+ ? { ...current }
205
+ : {};
206
+ auth.apiKeyRoles = roles;
207
+ config.auth = auth;
208
+ }
114
209
  /**
115
210
  * Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. Точки в ключе означают
116
211
  * вложенность (`log.enabled` → `SYNTH_EGRESS_LOG_ENABLED`).
@@ -314,15 +409,19 @@ export const BOOTSTRAP_SERVICE_KEYS_ENV = 'SYNTH_BOOTSTRAP_SERVICE_KEYS';
314
409
  export const OAUTH_PROVIDERS_ENV = 'SYNTH_OAUTH_PROVIDERS';
315
410
  /**
316
411
  * Применяет объектные env-оверрайды, у которых нет плоского строкового
317
- * представления (сейчас — `security.bootstrapServiceKeys`). Значение парсится
318
- * как JSON и валидируется схемой; при ошибке парсинга/валидации — warn в console
319
- * и игнор (fail-soft: кривой installer-ключ не должен ронять старт инстанса —
320
- * ensure-логика приложения просто ничего не бутстрапит, оператор видит warn).
412
+ * представления (`auth.apiKeyRoles`, `attachments.modalities`, `oauth.providers`,
413
+ * `security.bootstrapServiceKeys`). Нескалярные значения парсятся здесь;
414
+ * `security.bootstrapServiceKeys` — JSON, валидируется схемой, при ошибке
415
+ * парсинга/валидации warn в console и игнор (fail-soft: кривой installer-ключ не
416
+ * должен ронять старт инстанса — ensure-логика приложения просто ничего не
417
+ * бутстрапит, оператор видит warn). Исключение — `auth.apiKeyRoles`: там
418
+ * неизвестная роль бросает `Error` (fail-closed, права доступа).
321
419
  *
322
420
  * Мутирует переданный объект (в `loadConfig` — свежий результат `deepMerge`) и
323
421
  * возвращает его; секция `security` клонируется, чтобы не мутировать `defaultConfig`.
324
422
  */
325
423
  export function applyObjectEnvOverrides(config, env = process.env) {
424
+ applyApiKeyRolesEnvOverride(config, env);
326
425
  applyAttachmentsModalitiesEnvOverride(config, env);
327
426
  applyOAuthProvidersEnvOverride(config, env);
328
427
  const raw = env[BOOTSTRAP_SERVICE_KEYS_ENV];
@@ -4,6 +4,7 @@ export * from './loader.js';
4
4
  export * from './env-overrides.js';
5
5
  export * from './merge.js';
6
6
  export * from './resolve.js';
7
+ export * from './redact.js';
7
8
  export * from './execution.js';
8
9
  export * from './tls.js';
9
10
  export * from './tls-runtime.js';
@@ -4,6 +4,7 @@ export * from './loader.js';
4
4
  export * from './env-overrides.js';
5
5
  export * from './merge.js';
6
6
  export * from './resolve.js';
7
+ export * from './redact.js';
7
8
  export * from './execution.js';
8
9
  export * from './tls.js';
9
10
  export * from './tls-runtime.js';
@@ -6,5 +6,13 @@ export interface LoadConfigOptions {
6
6
  overrides?: Partial<SynthConfig>;
7
7
  /** ADR-023: источник env для оверрайдов; по умолчанию `process.env` (в тестах — свой env). */
8
8
  env?: NodeJS.ProcessEnv;
9
+ /**
10
+ * Дефолты профиля (например, backend/managed): глубокий мёрж **после**
11
+ * общего `defaultConfig` и **до** `config.yaml`/env/CLI. Позволяет профилю
12
+ * поднять дефолт (`llmGateway.enabled: true`), не перебивая явную
13
+ * конфигурацию (приоритет: CLI > env > config.yaml > профиль-дефолт >
14
+ * общий дефолт).
15
+ */
16
+ baseDefaults?: Record<string, unknown>;
9
17
  }
10
18
  export declare function loadConfig(options?: LoadConfigOptions): Promise<SynthConfig>;
@@ -74,7 +74,12 @@ export async function loadConfig(options = {}) {
74
74
  }
75
75
  }
76
76
  warnLegacyKeys(fileConfig, options.env ?? process.env);
77
- const merged = deepMerge(defaultConfig, fileConfig);
77
+ // Профильные дефолты (backend/managed) — выше общего `defaultConfig`, но ниже
78
+ // `config.yaml`/env/CLI: явная настройка всегда перебивает профиль.
79
+ const withBaseDefaults = options.baseDefaults
80
+ ? deepMerge(defaultConfig, options.baseDefaults)
81
+ : defaultConfig;
82
+ const merged = deepMerge(withBaseDefaults, fileConfig);
78
83
  // ADR-023: env-оверрайды скалярных ключей вложенных секций применяются одним
79
84
  // местом — поверх defaults + config.yaml и ниже CLI-overrides
80
85
  // (приоритет: CLI > env > config.yaml > defaults).
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Редактирование секретов в дампе конфигурации (`synth config show`).
3
+ *
4
+ * `SynthConfig` может содержать значения секретов (`core.apiKey`,
5
+ * `security.secretKey`, `remote.auth.apiKey`, `auth.oidc.clientSecret`,
6
+ * `storage.postgres.password` и т.п.). Печатать такой дамп целиком нельзя:
7
+ * это утечка в журнал/терминал/CI. Хелпер возвращает **глубокую копию** с
8
+ * замаскированными непустыми значениями секретных ключей — исходный объект не
9
+ * мутируется.
10
+ *
11
+ * Маскируются только ключи с **точным** (case-insensitive) именем из списка;
12
+ * `timeout`, `tokenizer`, `apiKeyRoles` и другие похожие по подстроке ключи
13
+ * остаются как есть. Значение-маска — строка `'***'`.
14
+ */
15
+ import type { SynthConfig } from './types.js';
16
+ /**
17
+ * Вернуть копию конфигурации с замаскированными секретами.
18
+ *
19
+ * Копирование — `structuredClone` (конфиг состоит из JSON-совместимых данных);
20
+ * fallback на JSON-клон для сред без `structuredClone`.
21
+ */
22
+ export declare function redactConfigSecrets(config: SynthConfig): SynthConfig;
@@ -0,0 +1,53 @@
1
+ /** Имена ключей, значения которых считаются секретами (без учёта регистра). */
2
+ const SECRET_KEY_NAMES = new Set([
3
+ 'apiKey',
4
+ 'tokenSecret',
5
+ 'secretKey',
6
+ 'password',
7
+ 'token',
8
+ 'clientSecret',
9
+ 'privateKey',
10
+ 'passphrase',
11
+ 'secret',
12
+ 'signingKey',
13
+ 'webhookSecret',
14
+ ].map((key) => key.toLowerCase()));
15
+ /** Строка-маска для скрытого значения. */
16
+ const MASK = '***';
17
+ /** Непустое значение (пустая строка/пробелы, null и undefined — не секрет). */
18
+ function isNonEmpty(value) {
19
+ if (value === undefined || value === null)
20
+ return false;
21
+ if (typeof value === 'string')
22
+ return value.trim().length > 0;
23
+ return true;
24
+ }
25
+ /** Рекурсивно замаскировать секретные ключи в копии значения. */
26
+ function maskSecrets(value) {
27
+ if (Array.isArray(value))
28
+ return value.map(maskSecrets);
29
+ if (value && typeof value === 'object') {
30
+ const source = value;
31
+ const result = {};
32
+ for (const [key, child] of Object.entries(source)) {
33
+ result[key] =
34
+ SECRET_KEY_NAMES.has(key.toLowerCase()) && isNonEmpty(child)
35
+ ? MASK
36
+ : maskSecrets(child);
37
+ }
38
+ return result;
39
+ }
40
+ return value;
41
+ }
42
+ /**
43
+ * Вернуть копию конфигурации с замаскированными секретами.
44
+ *
45
+ * Копирование — `structuredClone` (конфиг состоит из JSON-совместимых данных);
46
+ * fallback на JSON-клон для сред без `structuredClone`.
47
+ */
48
+ export function redactConfigSecrets(config) {
49
+ const clone = typeof structuredClone === 'function'
50
+ ? structuredClone(config)
51
+ : JSON.parse(JSON.stringify(config));
52
+ return maskSecrets(clone);
53
+ }
@@ -45,6 +45,23 @@ export declare function resolveWorkspaceOutsideRootPolicy(config: SynthConfig, e
45
45
  * config/дефолт (fail-soft, как остальные env-резолверы; не падаем).
46
46
  */
47
47
  export declare function resolveMaxUploadBytes(config: SynthConfig, env?: NodeJS.ProcessEnv): number;
48
+ /**
49
+ * Максимальный размер файла, отдаваемого `GET /api/v2/fs/read`, в байтах.
50
+ * Приоритет: env `SYNTH_MAX_READ_BYTES` > `config.storage.maxReadBytes` >
51
+ * `DEFAULT_MAX_READ_BYTES` (5 МиБ). Некорректное env-значение (не число или
52
+ * вне границ `MIN_READ_BYTES`…`MAX_READ_BYTES_LIMIT`) — warn и фолбэк на
53
+ * config/дефолт (fail-soft, как остальные env-резолверы; не падаем).
54
+ */
55
+ export declare function resolveMaxReadBytes(config: SynthConfig, env?: NodeJS.ProcessEnv): number;
56
+ /**
57
+ * Максимальный размер файла, отдаваемого `GET /api/v2/fs/raw` (предпросмотр
58
+ * медиа), в байтах. Приоритет: env `SYNTH_MAX_PREVIEW_BYTES` >
59
+ * `config.storage.maxPreviewBytes` > `DEFAULT_MAX_PREVIEW_BYTES` (100 МиБ).
60
+ * Некорректное env-значение (не число или вне границ
61
+ * `MIN_PREVIEW_BYTES`…`MAX_PREVIEW_BYTES_LIMIT`) — warn и фолбэк на
62
+ * config/дефолт (fail-soft, как остальные env-резолверы; не падаем).
63
+ */
64
+ export declare function resolveMaxPreviewBytes(config: SynthConfig, env?: NodeJS.ProcessEnv): number;
48
65
  /**
49
66
  * ADR-096: физический backend хранения. Приоритет (ADR-023): env
50
67
  * `SYNTH_STORAGE_BACKEND` > `config.storage.backend` > `'file'`.
@@ -2,7 +2,7 @@ import { existsSync, readFileSync } from 'node:fs';
2
2
  import { mkdir, writeFile } from 'node:fs/promises';
3
3
  import { join, resolve } from 'node:path';
4
4
  import { dump as dumpYaml } from 'js-yaml';
5
- import { DEFAULT_MAX_UPLOAD_BYTES, MIN_UPLOAD_BYTES, MAX_UPLOAD_BYTES_LIMIT } from '../types/index.js';
5
+ import { DEFAULT_MAX_UPLOAD_BYTES, MIN_UPLOAD_BYTES, MAX_UPLOAD_BYTES_LIMIT, DEFAULT_MAX_READ_BYTES, MIN_READ_BYTES, MAX_READ_BYTES_LIMIT, DEFAULT_MAX_PREVIEW_BYTES, MIN_PREVIEW_BYTES, MAX_PREVIEW_BYTES_LIMIT, } from '../types/index.js';
6
6
  import { defaultConfig } from './defaults.js';
7
7
  import { normalizePostgresSslMode } from './tls.js';
8
8
  const DATA_SUBDIRS = [
@@ -236,6 +236,45 @@ export function resolveMaxUploadBytes(config, env) {
236
236
  }
237
237
  return config.storage.maxUploadBytes ?? DEFAULT_MAX_UPLOAD_BYTES;
238
238
  }
239
+ /**
240
+ * Максимальный размер файла, отдаваемого `GET /api/v2/fs/read`, в байтах.
241
+ * Приоритет: env `SYNTH_MAX_READ_BYTES` > `config.storage.maxReadBytes` >
242
+ * `DEFAULT_MAX_READ_BYTES` (5 МиБ). Некорректное env-значение (не число или
243
+ * вне границ `MIN_READ_BYTES`…`MAX_READ_BYTES_LIMIT`) — warn и фолбэк на
244
+ * config/дефолт (fail-soft, как остальные env-резолверы; не падаем).
245
+ */
246
+ export function resolveMaxReadBytes(config, env) {
247
+ const raw = (env ?? process.env).SYNTH_MAX_READ_BYTES;
248
+ if (raw) {
249
+ const n = Number(raw);
250
+ if (Number.isFinite(n) && n >= MIN_READ_BYTES && n <= MAX_READ_BYTES_LIMIT) {
251
+ return Math.floor(n);
252
+ }
253
+ console.warn(`[config] невалидное значение SYNTH_MAX_READ_BYTES="${raw}" ` +
254
+ `(ожидается число от ${MIN_READ_BYTES} до ${MAX_READ_BYTES_LIMIT}) — игнорируется`);
255
+ }
256
+ return config.storage.maxReadBytes ?? DEFAULT_MAX_READ_BYTES;
257
+ }
258
+ /**
259
+ * Максимальный размер файла, отдаваемого `GET /api/v2/fs/raw` (предпросмотр
260
+ * медиа), в байтах. Приоритет: env `SYNTH_MAX_PREVIEW_BYTES` >
261
+ * `config.storage.maxPreviewBytes` > `DEFAULT_MAX_PREVIEW_BYTES` (100 МиБ).
262
+ * Некорректное env-значение (не число или вне границ
263
+ * `MIN_PREVIEW_BYTES`…`MAX_PREVIEW_BYTES_LIMIT`) — warn и фолбэк на
264
+ * config/дефолт (fail-soft, как остальные env-резолверы; не падаем).
265
+ */
266
+ export function resolveMaxPreviewBytes(config, env) {
267
+ const raw = (env ?? process.env).SYNTH_MAX_PREVIEW_BYTES;
268
+ if (raw) {
269
+ const n = Number(raw);
270
+ if (Number.isFinite(n) && n >= MIN_PREVIEW_BYTES && n <= MAX_PREVIEW_BYTES_LIMIT) {
271
+ return Math.floor(n);
272
+ }
273
+ console.warn(`[config] невалидное значение SYNTH_MAX_PREVIEW_BYTES="${raw}" ` +
274
+ `(ожидается число от ${MIN_PREVIEW_BYTES} до ${MAX_PREVIEW_BYTES_LIMIT}) — игнорируется`);
275
+ }
276
+ return config.storage.maxPreviewBytes ?? DEFAULT_MAX_PREVIEW_BYTES;
277
+ }
239
278
  /**
240
279
  * ADR-096: физический backend хранения. Приоритет (ADR-023): env
241
280
  * `SYNTH_STORAGE_BACKEND` > `config.storage.backend` > `'file'`.