@itphx/synth-shared 0.10.1 → 0.12.3

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 (104) hide show
  1. package/dist/config/defaults.js +172 -3
  2. package/dist/config/env-overrides.d.ts +33 -1
  3. package/dist/config/env-overrides.js +191 -5
  4. package/dist/config/execution.d.ts +66 -0
  5. package/dist/config/execution.js +146 -0
  6. package/dist/config/index.d.ts +4 -0
  7. package/dist/config/index.js +4 -0
  8. package/dist/config/loader.js +19 -0
  9. package/dist/config/proxy.d.ts +415 -0
  10. package/dist/config/proxy.js +1567 -0
  11. package/dist/config/resolve.d.ts +67 -0
  12. package/dist/config/resolve.js +187 -1
  13. package/dist/config/tls-runtime.d.ts +78 -0
  14. package/dist/config/tls-runtime.js +356 -0
  15. package/dist/config/tls.d.ts +215 -0
  16. package/dist/config/tls.js +394 -0
  17. package/dist/config/types.d.ts +1571 -2835
  18. package/dist/config/types.js +717 -58
  19. package/dist/i18n/index.d.ts +1 -1
  20. package/dist/i18n/index.js +279 -0
  21. package/dist/index.d.ts +24 -3
  22. package/dist/index.js +25 -2
  23. package/dist/model-metadata.d.ts +10 -0
  24. package/dist/protocols/index.d.ts +0 -1
  25. package/dist/schemas/index.d.ts +1014 -2231
  26. package/dist/schemas/index.js +222 -14
  27. package/dist/types/analytics.d.ts +113 -0
  28. package/dist/types/analytics.js +61 -0
  29. package/dist/types/authority.d.ts +464 -0
  30. package/dist/types/authority.js +445 -0
  31. package/dist/types/background.d.ts +96 -0
  32. package/dist/types/background.js +24 -0
  33. package/dist/types/bus-events.d.ts +23 -1
  34. package/dist/types/catalog.d.ts +349 -0
  35. package/dist/types/catalog.js +393 -0
  36. package/dist/types/decision.d.ts +28 -337
  37. package/dist/types/egress.d.ts +114 -0
  38. package/dist/types/egress.js +68 -0
  39. package/dist/types/events.d.ts +54 -2
  40. package/dist/types/external-credentials.d.ts +352 -0
  41. package/dist/types/external-credentials.js +200 -0
  42. package/dist/types/fs.d.ts +11 -0
  43. package/dist/types/fs.js +11 -0
  44. package/dist/types/hooks.d.ts +50 -9
  45. package/dist/types/index.d.ts +23 -0
  46. package/dist/types/index.js +55 -0
  47. package/dist/types/llm-filters.d.ts +150 -0
  48. package/dist/types/llm-filters.js +54 -0
  49. package/dist/types/maintenance.d.ts +39 -0
  50. package/dist/types/maintenance.js +11 -0
  51. package/dist/types/mcp.d.ts +101 -5
  52. package/dist/types/mcp.js +127 -5
  53. package/dist/types/message.d.ts +45 -1
  54. package/dist/types/pack.d.ts +1102 -0
  55. package/dist/types/pack.js +1003 -0
  56. package/dist/types/permission.d.ts +31 -15
  57. package/dist/types/permission.js +1 -1
  58. package/dist/types/pipeline-engine.d.ts +453 -0
  59. package/dist/types/pipeline-engine.js +440 -0
  60. package/dist/types/pipeline.d.ts +275 -0
  61. package/dist/types/pipeline.js +212 -0
  62. package/dist/types/plugin-audit.d.ts +110 -0
  63. package/dist/types/plugin-audit.js +185 -0
  64. package/dist/types/plugin-hybrid.d.ts +85 -0
  65. package/dist/types/plugin-hybrid.js +68 -0
  66. package/dist/types/plugin-lock.d.ts +95 -0
  67. package/dist/types/plugin-lock.js +1 -0
  68. package/dist/types/plugin-protocol.d.ts +221 -0
  69. package/dist/types/plugin-protocol.js +322 -0
  70. package/dist/types/plugin-runtime.d.ts +25 -0
  71. package/dist/types/plugin-runtime.js +11 -0
  72. package/dist/types/plugin-scan.d.ts +159 -0
  73. package/dist/types/plugin-scan.js +166 -0
  74. package/dist/types/plugin-tools.d.ts +51 -0
  75. package/dist/types/plugin-tools.js +72 -0
  76. package/dist/types/project.d.ts +14 -0
  77. package/dist/types/prompt-blocks.d.ts +102 -0
  78. package/dist/types/prompt-blocks.js +24 -0
  79. package/dist/types/prompt.d.ts +47 -4
  80. package/dist/types/provider.d.ts +11 -0
  81. package/dist/types/question.d.ts +153 -0
  82. package/dist/types/question.js +65 -0
  83. package/dist/types/schedules.d.ts +26 -3
  84. package/dist/types/semver.d.ts +48 -0
  85. package/dist/types/semver.js +218 -0
  86. package/dist/types/service-keys.d.ts +41 -3
  87. package/dist/types/service-keys.js +44 -2
  88. package/dist/types/session.d.ts +54 -1
  89. package/dist/types/steering.d.ts +74 -0
  90. package/dist/types/steering.js +75 -0
  91. package/dist/types/tools.d.ts +125 -5
  92. package/dist/types/tools.js +75 -0
  93. package/dist/types/trust.d.ts +31 -0
  94. package/dist/types/trust.js +27 -0
  95. package/dist/types/webhooks.d.ts +1 -1
  96. package/dist/types/worktree.d.ts +170 -0
  97. package/dist/types/worktree.js +101 -0
  98. package/dist/utils/index.d.ts +46 -1
  99. package/dist/utils/index.js +145 -12
  100. package/dist/utils/reasoning.d.ts +16 -0
  101. package/dist/utils/reasoning.js +37 -0
  102. package/dist/version.d.ts +1 -1
  103. package/dist/version.js +1 -1
  104. package/package.json +2 -2
@@ -1,4 +1,8 @@
1
- import { DEFAULT_MCP_PRIVATE_CIDRS } from '../types/index.js';
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';
3
+ import { DEFAULT_PROMPT_BLOCK_MAX_CHARS, DEFAULT_LLM_FILTER_TIMEOUT_MS } from '../types/index.js';
4
+ import { DEFAULT_EXECUTION_TIMEOUT_MS } from './types.js';
5
+ import { defaultExecutionConcurrency } from './execution.js';
2
6
  export const defaultConfig = {
3
7
  server: {
4
8
  host: '0.0.0.0',
@@ -8,9 +12,35 @@ export const defaultConfig = {
8
12
  },
9
13
  storage: {
10
14
  dataDir: '/var/synth/data',
15
+ backend: 'file',
16
+ // ADR-097: параметры PostgreSQL-backend (пусто — драйвер берёт дефолты/env).
17
+ postgres: {},
18
+ // ADR-098 (задел W5): при недоступности backend — файловый фоллбек в {dataDir}/fallback.
19
+ degradedMode: 'fallback-file',
20
+ fallbackDir: '',
11
21
  workspacesRoot: '',
12
22
  defaultWorkspace: '',
13
23
  workspaceOutsideRoot: '',
24
+ maxUploadBytes: DEFAULT_MAX_UPLOAD_BYTES,
25
+ },
26
+ execution: {
27
+ // ADR-077: топология исполнения — параметр запуска (инвариант 24: смена
28
+ // режима — только рестартом). `inline` — исполнение в процессе (прежнее
29
+ // поведение); `remote` — отдельные исполнители (шаг 7 плана ADR-077).
30
+ mode: 'inline',
31
+ remote: {
32
+ // Список адресов исполнителей; пусто при `remote` → fail-closed на старте.
33
+ url: [],
34
+ // Таймаут exec-вызова (30 с — как у нынешних тулов).
35
+ timeoutMs: DEFAULT_EXECUTION_TIMEOUT_MS,
36
+ // Лимит одновременных exec-вызовов — число CPU процесса.
37
+ concurrency: defaultExecutionConcurrency(),
38
+ // Fail-closed при недоступности исполнителя; inline-fallback — только
39
+ // явной настройкой.
40
+ failMode: 'fail',
41
+ // Путь/ссылка на токен исполнителя (НЕ значение — инвариант 13).
42
+ tokenSecret: '',
43
+ },
14
44
  },
15
45
  auth: {
16
46
  debugMode: false,
@@ -84,6 +114,7 @@ export const defaultConfig = {
84
114
  networkPolicy: {
85
115
  mode: 'deny',
86
116
  list: [...DEFAULT_MCP_PRIVATE_CIDRS],
117
+ exceptions: [],
87
118
  },
88
119
  },
89
120
  tools: {
@@ -149,13 +180,136 @@ export const defaultConfig = {
149
180
  escalationProvider: '',
150
181
  escalationModel: '',
151
182
  },
183
+ oauth: {
184
+ // ADR-105 (Ф3): каталога OAuth-провайдеров нет — описания задаёт оператор
185
+ // (`oauth.providers` в config.yaml или env `SYNTH_OAUTH_PROVIDERS`).
186
+ providers: {},
187
+ },
188
+ analytics: {
189
+ // ADR-102: срок хранения суточных роллапов — 400 дней (<= 0 — без ограничения).
190
+ retentionDays: 400,
191
+ },
192
+ questions: {
193
+ // Этап 1 roadmap 0.13 (блок 3): срок ожидания ответа пользователя на вопрос —
194
+ // по умолчанию **без таймаута** (0): вопрос ждёт, пока ответят или отменят
195
+ // вручную. Тул `question` может задать срок для конкретного вопроса
196
+ // (`timeout`, ≥ 5 минут — не рекомендуется: ожидание обрывается).
197
+ timeoutMs: 0,
198
+ // Срок хранения терминальных записей вопросов (дни; <= 0 — без ограничения).
199
+ retentionDays: 14,
200
+ },
201
+ background: {
202
+ // Этап 1 roadmap 0.13 (блок 4): единый реестр фоновых прогонов
203
+ // (PROP-096 — фоновые саб-агенты, PROP-097 — фоновые шелл-процессы).
204
+ // Фоновая работа включена; лимиты — по родительской сессии.
205
+ enabled: true,
206
+ // Максимум одновременно идущих фоновых саб-агентов на родительскую сессию.
207
+ maxSubagentsPerSession: 2,
208
+ // Максимум одновременно идущих фоновых шелл-процессов на сессию-владельца.
209
+ maxProcessesPerSession: 5,
210
+ // Максимум записей реестра на сессию-владельца (чистится retention-ом).
211
+ maxRunsPerSession: 10,
212
+ // Предел размера лога фонового процесса, байт (10 МиБ; 0 — без ограничения).
213
+ logMaxBytes: 10_485_760,
214
+ // Срок хранения терминальных записей реестра (дни; <= 0 — без ограничения).
215
+ retentionDays: 7,
216
+ },
217
+ attachments: {
218
+ // ADR-115: вложения сообщений. Мастер-выключатель, семейства MIME,
219
+ // лимиты (байты на файл, число файлов в сообщении, суммарный объём на
220
+ // сессию), белый список MIME, резервное хранение в workspace и срок
221
+ // хранения осиротевших объектов.
222
+ enabled: true,
223
+ modalities: { image: true, pdf: true, audio: true, video: true },
224
+ maxBytesPerFile: 25 * 1024 * 1024,
225
+ maxFilesPerMessage: 10,
226
+ maxBytesPerSession: 1024 * 1024 * 1024,
227
+ allowedMimePrefixes: ['image/', 'audio/', 'video/', 'application/pdf', 'text/'],
228
+ workspaceFallback: true,
229
+ // ADR-115: модели обработки по семействам (aux-модели). Пусто — обработка
230
+ // не настроена: вложение, которое модель сессии не принимает, отбрасывается
231
+ // с путём в workspace (текущее поведение).
232
+ modalityModels: {},
233
+ gcDays: 30,
234
+ },
235
+ metrics: {
236
+ // ADR-094: экспорт Prometheus-метрик выключен по умолчанию (`GET /metrics` → 404).
237
+ enabled: false,
238
+ },
239
+ authority: {
240
+ // ADR-106 Ф1: Authority-слой выключен по умолчанию — права не меняются.
241
+ enabled: false,
242
+ // При включении слоя он сначала только наблюдает (shadow): решение
243
+ // считается и пишется в журнал, но не применяется.
244
+ shadow: true,
245
+ },
246
+ plugins: {
247
+ // ADR-090: слой плагинов. Мастер-выключатель Extension API включён;
248
+ // исполнение кода плагинов появляется в Ф1+ (сейчас — только политики).
249
+ enabled: true,
250
+ // Установка во время работы инстанса — по умолчанию запрещена (managed:
251
+ // только deploy-time).
252
+ runtimeInstall: 'deny',
253
+ // Trust-floor плагина: ниже порога — установка есть, активации нет.
254
+ trustFloor: 'trusted',
255
+ // Статический сканер содержимого расширения включён.
256
+ scan: 'enabled',
257
+ // Списки имён расширений (пусто — политика не применяется).
258
+ allowlist: [],
259
+ denylist: [],
260
+ // Allow-list расширений для hybrid-контура (Ф7).
261
+ remoteAllowlist: [],
262
+ // Файл точных исключений семвер-гейта (формат — открытый вопрос §14).
263
+ exactHostExceptions: '',
264
+ // Бюджет символов на блок системного промпта от плагина.
265
+ promptBlockMaxChars: DEFAULT_PROMPT_BLOCK_MAX_CHARS,
266
+ // Исполнение кода плагинов выключено по умолчанию (Ф1: загрузчик доходит
267
+ // до шага `import` и останавливается — `plugin.execution_disabled`).
268
+ executionEnabled: false,
269
+ // Бюджет времени на один вызов фильтра LLM-вызовов (точка `llmFilters`,
270
+ // Ф3б). Значение — вопрос владельца (ADR-090), механизм fail-closed/open
271
+ // реализован.
272
+ llmFilterTimeoutMs: DEFAULT_LLM_FILTER_TIMEOUT_MS,
273
+ // Ф5в: каталог deploy-плагинов (образ/PVC). Пусто — не задан.
274
+ deployDir: '/opt/synth/plugins',
275
+ // Ф5в: доверие deploy-бандлов (образ — доверенный источник, но не выше
276
+ // политики инстанса: ниже trust-floor — штатный отказ).
277
+ deployTrust: 'trusted',
278
+ // Ф5в: management-плагин нельзя снять/переустановить через API/CLI.
279
+ managedReadonly: true,
280
+ // ADR-090 (WP-F): провайдер/модель эмбеддингов для `facade.embed`.
281
+ // Пусто — сервис эмбеддингов не сконфигурирован (вызов бросает
282
+ // `plugin.embedding_not_configured`, плагин решает, деградировать ли).
283
+ embeddingProvider: '',
284
+ embeddingModel: '',
285
+ // Ф7: серверная политика плагинов в гибриде. По умолчанию сервер не
286
+ // ограничивает плагины (`off`); allow-list включается явно.
287
+ hybrid: {
288
+ mode: 'off',
289
+ allow: [],
290
+ },
291
+ },
292
+ egress: {
293
+ // Политика встроенных инструментов: deny приватных/служебных диапазонов.
294
+ tools: {
295
+ mode: DEFAULT_EGRESS_TOOLS_POLICY.mode,
296
+ list: [...DEFAULT_EGRESS_TOOLS_POLICY.list],
297
+ exceptions: [],
298
+ },
299
+ // Политика webhooks: deny приватных + обязательный https (`off` — dev).
300
+ webhooks: {
301
+ mode: DEFAULT_EGRESS_WEBHOOKS_POLICY.mode,
302
+ list: [...DEFAULT_EGRESS_WEBHOOKS_POLICY.list],
303
+ exceptions: [],
304
+ },
305
+ // Журнал внешних запросов: включён, retention 7 дней (0 — без очистки).
306
+ log: { ...DEFAULT_EGRESS_LOG },
307
+ },
152
308
  webhooks: {
153
309
  // ADR-052 (этап II): доставка webhooks выключена по умолчанию (opt-in).
154
310
  enabled: false,
155
311
  maxAttempts: 5,
156
312
  timeoutMs: 10_000,
157
- // Только https и публичные адреса; приватные/loopback — запрещены (SSRF).
158
- allowPrivateTargets: false,
159
313
  deliveryRetentionDays: 30,
160
314
  },
161
315
  instructions: {
@@ -212,6 +366,18 @@ export const defaultConfig = {
212
366
  provider: '',
213
367
  },
214
368
  },
369
+ proxy: {
370
+ // ADR-099 (D1): прокси выключен по умолчанию (поведение не меняется).
371
+ // `enabled` намеренно не задан: явный `false` в config.yaml подавляет
372
+ // стандартные HTTP_PROXY/…, а отсутствие — позволяет включиться из env.
373
+ // `profiles`/`rules` намеренно не заданы: отсутствие = legacy-поведение
374
+ // (top-level URL + синтетический профиль `default`).
375
+ mode: 'all',
376
+ noProxy: [],
377
+ fromEnv: true,
378
+ fallbackDirect: false,
379
+ connectTimeoutMs: 10_000,
380
+ },
215
381
  remote: {
216
382
  enabled: false,
217
383
  backendUrl: '',
@@ -259,6 +425,9 @@ export const defaultConfig = {
259
425
  protectedPaths: {
260
426
  enabled: true,
261
427
  },
428
+ // ADR-099: доверие TLS/CA исходящих соединений. Пусто — системное доверие
429
+ // (поведение не меняется); caFile — корпоративный CA, cert/key — mTLS.
430
+ tls: {},
262
431
  // Пусто — core использует файл {dataDir}/secrets/master.key (ADR-076).
263
432
  secretKey: '',
264
433
  // ADR-052/O1: installer service-key'и из env/Secret (по умолчанию нет).
@@ -18,7 +18,10 @@ export interface EnvOverrideDefinition {
18
18
  export declare const ENV_OVERRIDES: readonly EnvOverrideDefinition[];
19
19
  /** camelCase → SNAKE_CASE (`autoBind` → `AUTO_BIND`, `ephemeralTtl` → `EPHEMERAL_TTL`). */
20
20
  export declare function toSnakeCase(value: string): string;
21
- /** Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. */
21
+ /**
22
+ * Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. Точки в ключе означают
23
+ * вложенность (`log.enabled` → `SYNTH_EGRESS_LOG_ENABLED`).
24
+ */
22
25
  export declare function envOverrideName(def: EnvOverrideDefinition): string;
23
26
  export type ParsedEnvValue = {
24
27
  ok: true;
@@ -46,6 +49,22 @@ export declare function parseEnvValue(raw: string, type: EnvOverrideType): Parse
46
49
  * игнор (как `resolvePort`/`resolveIgnoreRules`, без падения).
47
50
  */
48
51
  export declare function applyEnvOverrides<T extends Record<string, unknown>>(config: T, env?: NodeJS.ProcessEnv): T;
52
+ /**
53
+ * ADR-115: env-имя списка включённых семейств вложений.
54
+ *
55
+ * Значение — csv из `image,pdf,audio,video`; перечисленные семейства
56
+ * включаются, отсутствующие — выключаются (полный список заменяется).
57
+ * Пустая строка — «не задано».
58
+ */
59
+ export declare const ATTACHMENTS_MODALITIES_ENV = "SYNTH_ATTACHMENTS_MODALITIES";
60
+ /** Канонические семейства вложений (порядок — как в схеме). */
61
+ export declare const ATTACHMENT_MODALITY_KEYS: readonly ["image", "pdf", "audio", "video"];
62
+ export type AttachmentModalityKey = (typeof ATTACHMENT_MODALITY_KEYS)[number];
63
+ /**
64
+ * Разобрать csv семейств вложений. Неизвестные элементы пропускаются с warn;
65
+ * если валидных нет — `undefined` (значение игнорируется, как невалидный env).
66
+ */
67
+ export declare function parseAttachmentsModalities(raw: string): Record<AttachmentModalityKey, boolean> | undefined;
49
68
  /**
50
69
  * ADR-052/O1: env-имя JSON-списка installer service-key'ев
51
70
  * (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
@@ -55,6 +74,19 @@ export declare function applyEnvOverrides<T extends Record<string, unknown>>(con
55
74
  * (передаётся из env/Secret).
56
75
  */
57
76
  export declare const BOOTSTRAP_SERVICE_KEYS_ENV = "SYNTH_BOOTSTRAP_SERVICE_KEYS";
77
+ /**
78
+ * ADR-105 (Ф3): env-имя JSON-каталога OAuth-провайдеров (`oauth.providers`).
79
+ *
80
+ * Значение — JSON-объект «имя провайдера → описание»
81
+ * (`{ authorizeUrl, tokenUrl, revokeUrl?, deviceAuthorizationUrl?, clientId, scopes[] }`).
82
+ * Приоритет — как у скалярных env-оверрайдов: env > config.yaml (ADR-023),
83
+ * но ниже CLI-overrides. Провайдер из env **заменяет** одноимённого из
84
+ * config.yaml (описание целиком), остальные записи config.yaml сохраняются.
85
+ *
86
+ * Секрета здесь нет: `client_secret` — только env `SYNTH_OAUTH_<PROVIDER>_CLIENT_SECRET`
87
+ * или файл `{dataDir}/secrets/oauth/<provider>.client_secret` (инвариант 13).
88
+ */
89
+ export declare const OAUTH_PROVIDERS_ENV = "SYNTH_OAUTH_PROVIDERS";
58
90
  /**
59
91
  * Применяет объектные env-оверрайды, у которых нет плоского строкового
60
92
  * представления (сейчас — `security.bootstrapServiceKeys`). Значение парсится
@@ -10,7 +10,7 @@
10
10
  *
11
11
  * Приоритет (ADR-023): CLI-флаги (`overrides`) > env (`SYNTH_*`) > config.yaml > defaults.
12
12
  */
13
- import { bootstrapServiceKeysSchema } from './types.js';
13
+ import { bootstrapServiceKeysSchema, oauthProvidersSchema } from './types.js';
14
14
  /**
15
15
  * Реестр env-оверрайдов скалярных ключей вложенных секций (ADR-023).
16
16
  *
@@ -38,8 +38,20 @@ export const ENV_OVERRIDES = [
38
38
  { section: 'webhooks', key: 'enabled', type: 'boolean' },
39
39
  { section: 'webhooks', key: 'maxAttempts', type: 'number' },
40
40
  { section: 'webhooks', key: 'timeoutMs', type: 'number' },
41
- { section: 'webhooks', key: 'allowPrivateTargets', type: 'boolean' },
42
41
  { section: 'webhooks', key: 'deliveryRetentionDays', type: 'number' },
42
+ // egress (настраиваемая политика + журнал): только скалярные ключи.
43
+ { section: 'egress', key: 'tools.mode', type: 'string' },
44
+ { section: 'egress', key: 'webhooks.mode', type: 'string' },
45
+ { section: 'egress', key: 'log.enabled', type: 'boolean' },
46
+ { section: 'egress', key: 'log.retentionDays', type: 'number' },
47
+ // proxy (ADR-099, D1): скалярные ключи секции; списки (noProxy) — в config/env.
48
+ { section: 'proxy', key: 'enabled', type: 'boolean' },
49
+ { section: 'proxy', key: 'url', type: 'string' },
50
+ { section: 'proxy', key: 'httpProxy', type: 'string' },
51
+ { section: 'proxy', key: 'httpsProxy', type: 'string' },
52
+ { section: 'proxy', key: 'allProxy', type: 'string' },
53
+ { section: 'proxy', key: 'fallbackDirect', type: 'boolean' },
54
+ { section: 'proxy', key: 'connectTimeoutMs', type: 'number' },
43
55
  // decision (ADR-084)
44
56
  { section: 'decision', key: 'enabled', type: 'boolean' },
45
57
  { section: 'decision', key: 'provider', type: 'string' },
@@ -47,14 +59,65 @@ export const ENV_OVERRIDES = [
47
59
  { section: 'decision', key: 'confidenceThreshold', type: 'number' },
48
60
  { section: 'decision', key: 'escalationProvider', type: 'string' },
49
61
  { section: 'decision', key: 'escalationModel', type: 'string' },
62
+ // analytics (ADR-102)
63
+ { section: 'analytics', key: 'retentionDays', type: 'number' },
64
+ // questions (этап 1 roadmap 0.13 — блок 3): таймаут ответа + retention.
65
+ { section: 'questions', key: 'timeoutMs', type: 'number' },
66
+ { section: 'questions', key: 'retentionDays', type: 'number' },
67
+ // background (этап 1 roadmap 0.13 — блок 4): реестр фоновых прогонов.
68
+ { section: 'background', key: 'enabled', type: 'boolean' },
69
+ { section: 'background', key: 'maxSubagentsPerSession', type: 'number' },
70
+ { section: 'background', key: 'maxProcessesPerSession', type: 'number' },
71
+ { section: 'background', key: 'maxRunsPerSession', type: 'number' },
72
+ { section: 'background', key: 'logMaxBytes', type: 'number' },
73
+ { section: 'background', key: 'retentionDays', type: 'number' },
74
+ // attachments (ADR-115): вложения сообщений. Семейства MIME
75
+ // (`SYNTH_ATTACHMENTS_MODALITIES`, csv) — объектный ключ, обрабатывается
76
+ // отдельно (`applyAttachmentsModalitiesEnvOverride`); список префиксов
77
+ // (`allowedMimePrefixes`) остаётся только в config.yaml.
78
+ { section: 'attachments', key: 'enabled', type: 'boolean' },
79
+ { section: 'attachments', key: 'workspaceFallback', type: 'boolean' },
80
+ { section: 'attachments', key: 'maxBytesPerFile', type: 'number' },
81
+ { section: 'attachments', key: 'maxFilesPerMessage', type: 'number' },
82
+ { section: 'attachments', key: 'maxBytesPerSession', type: 'number' },
83
+ { section: 'attachments', key: 'gcDays', type: 'number' },
84
+ // metrics (ADR-094): Helm ставит `SYNTH_METRICS_ENABLED` — имя должно совпадать.
85
+ { section: 'metrics', key: 'enabled', type: 'boolean' },
86
+ // authority (ADR-106 Ф1): мастер-выключатель слоя и режим наблюдения.
87
+ { section: 'authority', key: 'enabled', type: 'boolean' },
88
+ { section: 'authority', key: 'shadow', type: 'boolean' },
89
+ // plugins (ADR-090): политики слоя плагинов. Списки (allowlist/denylist/
90
+ // remoteAllowlist) — объектные, остаются в config.yaml.
91
+ { section: 'plugins', key: 'enabled', type: 'boolean' },
92
+ { section: 'plugins', key: 'runtimeInstall', type: 'string' },
93
+ { section: 'plugins', key: 'trustFloor', type: 'string' },
94
+ { section: 'plugins', key: 'scan', type: 'string' },
95
+ { section: 'plugins', key: 'exactHostExceptions', type: 'string' },
96
+ { section: 'plugins', key: 'promptBlockMaxChars', type: 'number' },
97
+ { section: 'plugins', key: 'executionEnabled', type: 'boolean' },
98
+ { section: 'plugins', key: 'llmFilterTimeoutMs', type: 'number' },
99
+ // Ф5в: деплой-каталог из образа/PVC и «неприкосновенность» management-плагинов.
100
+ { section: 'plugins', key: 'deployDir', type: 'string' },
101
+ { section: 'plugins', key: 'deployTrust', type: 'string' },
102
+ { section: 'plugins', key: 'managedReadonly', type: 'boolean' },
103
+ // ADR-090 (WP-F): провайдер/модель эмбеддингов для `facade.embed`.
104
+ { section: 'plugins', key: 'embeddingProvider', type: 'string' },
105
+ { section: 'plugins', key: 'embeddingModel', type: 'string' },
106
+ // Ф7: режим серверной политики плагинов в гибриде (`off`|`allowlist`).
107
+ // Список имён (`plugins.hybrid.allow`) — объектный, остаётся в config.yaml.
108
+ { section: 'plugins', key: 'hybrid.mode', type: 'string' },
50
109
  ];
51
110
  /** camelCase → SNAKE_CASE (`autoBind` → `AUTO_BIND`, `ephemeralTtl` → `EPHEMERAL_TTL`). */
52
111
  export function toSnakeCase(value) {
53
112
  return value.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toUpperCase();
54
113
  }
55
- /** Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. */
114
+ /**
115
+ * Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. Точки в ключе означают
116
+ * вложенность (`log.enabled` → `SYNTH_EGRESS_LOG_ENABLED`).
117
+ */
56
118
  export function envOverrideName(def) {
57
- return `SYNTH_${toSnakeCase(def.section)}_${toSnakeCase(def.key)}`;
119
+ const key = def.key.split('.').map(toSnakeCase).join('_');
120
+ return `SYNTH_${toSnakeCase(def.section)}_${key}`;
58
121
  }
59
122
  /**
60
123
  * Парсинг env-строки по типу ключа:
@@ -114,11 +177,119 @@ export function applyEnvOverrides(config, env = process.env) {
114
177
  const section = current !== null && typeof current === 'object' && !Array.isArray(current)
115
178
  ? { ...current }
116
179
  : {};
117
- section[def.key] = parsed.value;
180
+ // `key` может быть вложенным (`log.enabled`): клонируем промежуточные объекты,
181
+ // чтобы не мутировать defaultConfig.
182
+ const path = def.key.split('.');
183
+ let target = section;
184
+ for (let i = 0; i < path.length - 1; i += 1) {
185
+ const part = path[i];
186
+ const child = target[part];
187
+ const copy = child !== null && typeof child === 'object' && !Array.isArray(child)
188
+ ? { ...child }
189
+ : {};
190
+ target[part] = copy;
191
+ target = copy;
192
+ }
193
+ target[path[path.length - 1]] = parsed.value;
118
194
  config[def.section] = section;
119
195
  }
120
196
  return config;
121
197
  }
198
+ /**
199
+ * ADR-115: env-имя списка включённых семейств вложений.
200
+ *
201
+ * Значение — csv из `image,pdf,audio,video`; перечисленные семейства
202
+ * включаются, отсутствующие — выключаются (полный список заменяется).
203
+ * Пустая строка — «не задано».
204
+ */
205
+ export const ATTACHMENTS_MODALITIES_ENV = 'SYNTH_ATTACHMENTS_MODALITIES';
206
+ /** Канонические семейства вложений (порядок — как в схеме). */
207
+ export const ATTACHMENT_MODALITY_KEYS = ['image', 'pdf', 'audio', 'video'];
208
+ /**
209
+ * Разобрать csv семейств вложений. Неизвестные элементы пропускаются с warn;
210
+ * если валидных нет — `undefined` (значение игнорируется, как невалидный env).
211
+ */
212
+ export function parseAttachmentsModalities(raw) {
213
+ const tokens = raw
214
+ .split(',')
215
+ .map((part) => part.trim().toLowerCase())
216
+ .filter((part) => part !== '');
217
+ if (tokens.length === 0)
218
+ return undefined;
219
+ const enabled = new Set();
220
+ for (const token of tokens) {
221
+ if (ATTACHMENT_MODALITY_KEYS.includes(token)) {
222
+ enabled.add(token);
223
+ }
224
+ else {
225
+ console.warn(`[config] неизвестное семейство вложений "${token}" в ${ATTACHMENTS_MODALITIES_ENV} — пропущено`);
226
+ }
227
+ }
228
+ if (enabled.size === 0)
229
+ return undefined;
230
+ return {
231
+ image: enabled.has('image'),
232
+ pdf: enabled.has('pdf'),
233
+ audio: enabled.has('audio'),
234
+ video: enabled.has('video'),
235
+ };
236
+ }
237
+ /**
238
+ * Применить csv-оверрайд `SYNTH_ATTACHMENTS_MODALITIES` к секции `attachments`
239
+ * (список перечисляет только **включённые** семейства). Невалидное значение —
240
+ * warn и игнор (fail-soft, как у остальных env-оверрайдов).
241
+ */
242
+ function applyAttachmentsModalitiesEnvOverride(config, env) {
243
+ const raw = env[ATTACHMENTS_MODALITIES_ENV];
244
+ if (raw === undefined || raw === '')
245
+ return;
246
+ const parsed = parseAttachmentsModalities(raw);
247
+ if (!parsed) {
248
+ console.warn(`[config] невалидное значение ${ATTACHMENTS_MODALITIES_ENV}="${raw}" — игнорируется`);
249
+ return;
250
+ }
251
+ const current = config.attachments;
252
+ const attachments = current !== null && typeof current === 'object' && !Array.isArray(current)
253
+ ? { ...current }
254
+ : {};
255
+ attachments.modalities = parsed;
256
+ config.attachments = attachments;
257
+ }
258
+ /**
259
+ * ADR-105 (Ф3): env-оверрайд каталога OAuth-провайдеров (`oauth.providers`).
260
+ *
261
+ * Значение — JSON-объект «имя → описание». Провайдер из env заменяет
262
+ * одноимённого из config.yaml; остальные записи config.yaml сохраняются.
263
+ * Невалидный JSON/набор — warn в console и игнор (fail-soft: кривой каталог
264
+ * не должен ронять старт инстанса — доступы просто не обновятся).
265
+ */
266
+ function applyOAuthProvidersEnvOverride(config, env) {
267
+ const raw = env[OAUTH_PROVIDERS_ENV];
268
+ if (raw === undefined || raw === '')
269
+ return;
270
+ let parsed;
271
+ try {
272
+ parsed = JSON.parse(raw);
273
+ }
274
+ catch {
275
+ console.warn(`[config] невалидный JSON ${OAUTH_PROVIDERS_ENV} — игнорируется`);
276
+ return;
277
+ }
278
+ const validated = oauthProvidersSchema.safeParse(parsed);
279
+ if (!validated.success) {
280
+ console.warn(`[config] ${OAUTH_PROVIDERS_ENV} не прошёл валидацию — игнорируется`);
281
+ return;
282
+ }
283
+ const current = config.oauth;
284
+ const oauth = current !== null && typeof current === 'object' && !Array.isArray(current)
285
+ ? { ...current }
286
+ : {};
287
+ const providers = oauth.providers !== null && typeof oauth.providers === 'object' && !Array.isArray(oauth.providers)
288
+ ? { ...oauth.providers }
289
+ : {};
290
+ oauth.providers = { ...providers, ...validated.data };
291
+ config.oauth = oauth;
292
+ }
122
293
  /**
123
294
  * ADR-052/O1: env-имя JSON-списка installer service-key'ев
124
295
  * (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
@@ -128,6 +299,19 @@ export function applyEnvOverrides(config, env = process.env) {
128
299
  * (передаётся из env/Secret).
129
300
  */
130
301
  export const BOOTSTRAP_SERVICE_KEYS_ENV = 'SYNTH_BOOTSTRAP_SERVICE_KEYS';
302
+ /**
303
+ * ADR-105 (Ф3): env-имя JSON-каталога OAuth-провайдеров (`oauth.providers`).
304
+ *
305
+ * Значение — JSON-объект «имя провайдера → описание»
306
+ * (`{ authorizeUrl, tokenUrl, revokeUrl?, deviceAuthorizationUrl?, clientId, scopes[] }`).
307
+ * Приоритет — как у скалярных env-оверрайдов: env > config.yaml (ADR-023),
308
+ * но ниже CLI-overrides. Провайдер из env **заменяет** одноимённого из
309
+ * config.yaml (описание целиком), остальные записи config.yaml сохраняются.
310
+ *
311
+ * Секрета здесь нет: `client_secret` — только env `SYNTH_OAUTH_<PROVIDER>_CLIENT_SECRET`
312
+ * или файл `{dataDir}/secrets/oauth/<provider>.client_secret` (инвариант 13).
313
+ */
314
+ export const OAUTH_PROVIDERS_ENV = 'SYNTH_OAUTH_PROVIDERS';
131
315
  /**
132
316
  * Применяет объектные env-оверрайды, у которых нет плоского строкового
133
317
  * представления (сейчас — `security.bootstrapServiceKeys`). Значение парсится
@@ -139,6 +323,8 @@ export const BOOTSTRAP_SERVICE_KEYS_ENV = 'SYNTH_BOOTSTRAP_SERVICE_KEYS';
139
323
  * возвращает его; секция `security` клонируется, чтобы не мутировать `defaultConfig`.
140
324
  */
141
325
  export function applyObjectEnvOverrides(config, env = process.env) {
326
+ applyAttachmentsModalitiesEnvOverride(config, env);
327
+ applyOAuthProvidersEnvOverride(config, env);
142
328
  const raw = env[BOOTSTRAP_SERVICE_KEYS_ENV];
143
329
  if (raw === undefined || raw === '')
144
330
  return config;
@@ -0,0 +1,66 @@
1
+ import type { SynthConfig } from './types.js';
2
+ import { type ExecutionFailMode, type ExecutionMode } from './types.js';
3
+ /** Env-имена секции `execution` (ADR-077). */
4
+ export declare const EXECUTION_ENV: {
5
+ readonly mode: "SYNTH_EXECUTION_MODE";
6
+ readonly remoteUrl: "SYNTH_EXECUTION_REMOTE_URL";
7
+ readonly token: "SYNTH_EXECUTION_TOKEN";
8
+ readonly timeoutMs: "SYNTH_EXECUTION_TIMEOUT_MS";
9
+ readonly concurrency: "SYNTH_EXECUTION_CONCURRENCY";
10
+ readonly failMode: "SYNTH_EXECUTION_FAIL_MODE";
11
+ };
12
+ /** Имя CLI-флага переключателя топологии (`synth serve --execution-mode`). */
13
+ export declare const EXECUTION_MODE_CLI_FLAG = "--execution-mode";
14
+ /**
15
+ * Лимит одновременных exec-вызовов по умолчанию — число CPU процесса.
16
+ * `availableParallelism()` (Node 18.14+) учитывает cgroup/affinity; фолбэк —
17
+ * `os.cpus().length`.
18
+ */
19
+ export declare function defaultExecutionConcurrency(): number;
20
+ /** Эффективные параметры удалённого исполнителя. */
21
+ export interface ResolvedExecutionRemoteConfig {
22
+ /** Список адресов исполнителей (пусто — при `remote` fail-closed на старте). */
23
+ url: string[];
24
+ /** Таймаут exec-вызова, мс. */
25
+ timeoutMs: number;
26
+ /** Лимит одновременных exec-вызовов. */
27
+ concurrency: number;
28
+ /** Поведение при недоступном исполнителе. */
29
+ failMode: ExecutionFailMode;
30
+ /** Путь/ссылка на токен исполнителя (НЕ значение — инвариант 13). */
31
+ tokenSecret: string;
32
+ }
33
+ /** Эффективная секция `execution`. */
34
+ export interface ResolvedExecutionConfig {
35
+ /** Топология исполнения. */
36
+ mode: ExecutionMode;
37
+ remote: ResolvedExecutionRemoteConfig;
38
+ }
39
+ /** Явное значение CLI-флага (приоритетнее env и config.yaml). */
40
+ export interface ExecutionCliOverride {
41
+ mode?: string | null;
42
+ }
43
+ export declare function isExecutionMode(value: unknown): value is ExecutionMode;
44
+ export declare function isExecutionFailMode(value: unknown): value is ExecutionFailMode;
45
+ /**
46
+ * Разбор списка адресов исполнителей: строка через запятую (`a, b`) — как у
47
+ * прочих списков конфигурации (`proxy.noProxy`). Пустые элементы отбрасываются.
48
+ */
49
+ export declare function parseExecutionUrlList(raw: string): string[];
50
+ /**
51
+ * Резолвит режим исполнения. Приоритет: CLI-флаг > env `SYNTH_EXECUTION_MODE` >
52
+ * `config.execution.mode` > `inline`.
53
+ *
54
+ * **Fail-closed**: неизвестное явно заданное значение — ошибка (опечатка `inlne`
55
+ * не должна молча оставить инстанс в inline-режиме).
56
+ */
57
+ export declare function resolveExecutionMode(config: SynthConfig, env?: NodeJS.ProcessEnv, cli?: ExecutionCliOverride): ExecutionMode;
58
+ /**
59
+ * Резолвит секцию `execution` целиком (ADR-077).
60
+ *
61
+ * Приоритет (ADR-023): CLI-флаг (`--execution-mode`) > env `SYNTH_EXECUTION_*` >
62
+ * `config.execution.*` > дефолты. Нечисловые env-значения — warn и фолбэк на
63
+ * config/дефолт (fail-soft, как прочие числовые env-резолверы); неизвестные
64
+ * `mode`/`failMode` — **fail-closed** (ошибка).
65
+ */
66
+ export declare function resolveExecutionConfig(config: SynthConfig, env?: NodeJS.ProcessEnv, cli?: ExecutionCliOverride): ResolvedExecutionConfig;