@itphx/synth-shared 0.13.4 → 0.13.10

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 (89) hide show
  1. package/dist/config/defaults.js +102 -3
  2. package/dist/config/env-overrides.d.ts +39 -4
  3. package/dist/config/env-overrides.js +174 -4
  4. package/dist/config/execution-runtime.d.ts +89 -0
  5. package/dist/config/execution-runtime.js +506 -0
  6. package/dist/config/execution.d.ts +202 -1
  7. package/dist/config/execution.js +459 -3
  8. package/dist/config/index.d.ts +3 -0
  9. package/dist/config/index.js +3 -0
  10. package/dist/config/loader.d.ts +8 -0
  11. package/dist/config/loader.js +6 -1
  12. package/dist/config/redact.d.ts +22 -0
  13. package/dist/config/redact.js +53 -0
  14. package/dist/config/security.d.ts +77 -0
  15. package/dist/config/security.js +116 -0
  16. package/dist/config/tls.d.ts +7 -4
  17. package/dist/config/tls.js +10 -23
  18. package/dist/config/types.d.ts +568 -38
  19. package/dist/config/types.js +390 -33
  20. package/dist/i18n/index.d.ts +1 -1
  21. package/dist/i18n/index.js +325 -13
  22. package/dist/index.d.ts +7 -6
  23. package/dist/index.js +17 -4
  24. package/dist/model-metadata.d.ts +10 -0
  25. package/dist/model-metadata.js +10 -0
  26. package/dist/schemas/index.d.ts +444 -30
  27. package/dist/schemas/index.js +354 -17
  28. package/dist/skills/frontmatter.js +1 -1
  29. package/dist/types/agent.d.ts +29 -1
  30. package/dist/types/authority.d.ts +10 -0
  31. package/dist/types/authority.js +8 -0
  32. package/dist/types/bus-events.d.ts +88 -2
  33. package/dist/types/catalog.d.ts +1 -1
  34. package/dist/types/catalog.js +1 -1
  35. package/dist/types/command-audit.d.ts +91 -0
  36. package/dist/types/command-audit.js +44 -0
  37. package/dist/types/commands.d.ts +29 -11
  38. package/dist/types/commands.js +2 -2
  39. package/dist/types/egress.d.ts +18 -3
  40. package/dist/types/egress.js +18 -3
  41. package/dist/types/events.d.ts +23 -2
  42. package/dist/types/execution.d.ts +424 -0
  43. package/dist/types/execution.js +355 -0
  44. package/dist/types/file-kind.d.ts +3 -2
  45. package/dist/types/file-kind.js +11 -2
  46. package/dist/types/git.d.ts +131 -0
  47. package/dist/types/git.js +101 -1
  48. package/dist/types/host-pattern.d.ts +41 -0
  49. package/dist/types/host-pattern.js +143 -0
  50. package/dist/types/index.d.ts +8 -0
  51. package/dist/types/index.js +25 -3
  52. package/dist/types/maintenance.d.ts +1 -1
  53. package/dist/types/mcp.d.ts +90 -0
  54. package/dist/types/mcp.js +11 -0
  55. package/dist/types/mentions.d.ts +96 -0
  56. package/dist/types/mentions.js +9 -0
  57. package/dist/types/message-stream.d.ts +41 -0
  58. package/dist/types/message.d.ts +24 -1
  59. package/dist/types/message.js +13 -0
  60. package/dist/types/pack.d.ts +21 -21
  61. package/dist/types/pack.js +4 -4
  62. package/dist/types/permission.d.ts +20 -3
  63. package/dist/types/pipeline.d.ts +2 -2
  64. package/dist/types/plugin-protocol.d.ts +203 -4
  65. package/dist/types/plugin-protocol.js +77 -4
  66. package/dist/types/project-access.d.ts +94 -0
  67. package/dist/types/project-access.js +140 -0
  68. package/dist/types/project.d.ts +89 -2
  69. package/dist/types/project.js +36 -0
  70. package/dist/types/prompt.d.ts +4 -2
  71. package/dist/types/schedules.d.ts +49 -3
  72. package/dist/types/schedules.js +50 -1
  73. package/dist/types/scripts.d.ts +98 -0
  74. package/dist/types/scripts.js +14 -0
  75. package/dist/types/service-keys.d.ts +16 -3
  76. package/dist/types/service-keys.js +19 -1
  77. package/dist/types/session.d.ts +68 -3
  78. package/dist/types/skills.d.ts +21 -11
  79. package/dist/types/skills.js +6 -6
  80. package/dist/types/timers.d.ts +402 -0
  81. package/dist/types/timers.js +166 -0
  82. package/dist/types/tools.d.ts +160 -1
  83. package/dist/types/tools.js +70 -0
  84. package/dist/types/user.d.ts +24 -0
  85. package/dist/types/worktree.d.ts +1 -1
  86. package/dist/utils/index.js +1 -1
  87. package/dist/version.d.ts +1 -1
  88. package/dist/version.js +1 -1
  89. package/package.json +3 -2
@@ -1,7 +1,7 @@
1
- import { DEFAULT_MCP_PRIVATE_CIDRS, DEFAULT_EGRESS_TOOLS_POLICY, DEFAULT_EGRESS_WEBHOOKS_POLICY, DEFAULT_EGRESS_LOG, } 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
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
- import { DEFAULT_EXECUTION_TIMEOUT_MS } from './types.js';
4
+ import { DEFAULT_EXECUTION_BROWSER_MCP_SERVER, DEFAULT_EXECUTION_BROWSER_PROFILE, DEFAULT_EXECUTION_BROWSER_TIMEOUT_MS, DEFAULT_EXECUTION_PROVISIONER_TIMEOUT_MS, DEFAULT_EXECUTION_TIMEOUT_MS, } from './types.js';
5
5
  import { defaultExecutionConcurrency } from './execution.js';
6
6
  export const defaultConfig = {
7
7
  server: {
@@ -42,10 +42,41 @@ export const defaultConfig = {
42
42
  failMode: 'fail',
43
43
  // Путь/ссылка на токен исполнителя (НЕ значение — инвариант 13).
44
44
  tokenSecret: '',
45
+ // PROP-135 Ф4a: пулы и профили. `instance` — общий порт на процесс
46
+ // (прежнее поведение); `project`/`session` — порт на профиль.
47
+ pooling: 'instance',
48
+ defaultProfile: 'default',
49
+ // Browser-пул — проектный, но со своим профилем (образ с браузером):
50
+ // `class: 'browser'` не наследует `defaultProfile`.
51
+ browserProfile: DEFAULT_EXECUTION_BROWSER_PROFILE,
52
+ // PROP-135 (браузерный контур): явный каталог браузерных профилей.
53
+ // Пусто — эффективный каталог равен `[browserProfile]`.
54
+ browserProfiles: [],
55
+ // Имя MCP-сервера браузера в поде исполнителя (встроенные `browser_*`).
56
+ browserMcpServer: DEFAULT_EXECUTION_BROWSER_MCP_SERVER,
57
+ // Таймаут одного вызова браузерного MCP-инструмента (2 мин).
58
+ browserTimeoutMs: DEFAULT_EXECUTION_BROWSER_TIMEOUT_MS,
59
+ profiles: {},
60
+ // Непригодный профиль → откат на instance-порт; `fail` — fail-closed.
61
+ fallback: 'instance',
62
+ // PROP-135 Ф4b-1: провайдер пулов. `static` — пулы из конфигурации
63
+ // (адреса профиля, порт на старте); `http` — пулы запрашиваются у
64
+ // provisioner'а (`provisioner.url` обязателен при `http`).
65
+ provider: 'static',
66
+ // Параметры provisioner'а пулов (пусто — провайдер `static`).
67
+ provisioner: {
68
+ url: '',
69
+ // Путь/ссылка на токен provisioner'а (НЕ значение — инвариант 13).
70
+ tokenSecret: '',
71
+ timeoutMs: DEFAULT_EXECUTION_PROVISIONER_TIMEOUT_MS,
72
+ },
45
73
  },
46
74
  },
47
75
  auth: {
48
76
  debugMode: false,
77
+ // Единый API-ключ выдаёт только базовую роль; ADMIN — явной настройкой
78
+ // (`auth.apiKeyRoles` / `SYNTH_API_KEY_ROLES`).
79
+ apiKeyRoles: [GlobalRole.USER],
49
80
  sessionMaxAgeMinutes: 1440,
50
81
  },
51
82
  llm: {
@@ -181,6 +212,10 @@ export const defaultConfig = {
181
212
  maxArgumentsLength: 10_000,
182
213
  maxRenderedBytes: 200_000,
183
214
  },
215
+ // ADR-126 §5: скрипты проекта (`!`-запуск) — каталоги-источники деклараций.
216
+ scripts: {
217
+ paths: [],
218
+ },
184
219
  events: {
185
220
  enabled: true,
186
221
  defaultMode: 'bound',
@@ -241,6 +276,11 @@ export const defaultConfig = {
241
276
  localTimeoutMs: 120_000,
242
277
  networkTimeoutMs: 300_000,
243
278
  },
279
+ ssh: {
280
+ // PROP-124: режим работы инстанса с SSH-ключами. `tools` — fail-closed:
281
+ // без явного выбора ключ не попадает в окружение команд.
282
+ mode: 'tools',
283
+ },
244
284
  questions: {
245
285
  // Этап 1 roadmap 0.13 (блок 3): срок ожидания ответа пользователя на вопрос —
246
286
  // по умолчанию **без таймаута** (0): вопрос ждёт, пока ответят или отменят
@@ -267,6 +307,18 @@ export const defaultConfig = {
267
307
  // Срок хранения терминальных записей реестра (дни; <= 0 — без ограничения).
268
308
  retentionDays: 7,
269
309
  },
310
+ recovery: {
311
+ // PROP-142 §3: автовосстановление прерванных ходов после рестарта.
312
+ // Мастер-выключатель: при `false` инстанс не возобновляет ходы сам.
313
+ autoResume: true,
314
+ // Бюджет попыток на один ход: превышен — ход терминализируется.
315
+ maxAttempts: 3,
316
+ // Детект crash-loop: N рестартов за M минут.
317
+ crashLoop: {
318
+ windowMinutes: 10,
319
+ maxRestarts: 3,
320
+ },
321
+ },
270
322
  agents: {
271
323
  // Предохранитель по объёму промпта саб-агента (не окно модели): при
272
324
  // превышении оценка бюджета завершает прогон детерминированным отчётом.
@@ -276,6 +328,11 @@ export const defaultConfig = {
276
328
  // текущая — 0, родитель — 1, …). 0 — без ограничения.
277
329
  subagentDepth: 1,
278
330
  },
331
+ limits: {
332
+ // Лимит тяжёлых операций с сессиями (import/export/fork/merge) в минуту
333
+ // на креду. 0 — без ограничения.
334
+ sessionOpsPerMinute: 10,
335
+ },
279
336
  attachments: {
280
337
  // ADR-115: вложения сообщений. Мастер-выключатель, семейства MIME,
281
338
  // лимиты (байты на файл, число файлов в сообщении, суммарный объём на
@@ -327,6 +384,27 @@ export const defaultConfig = {
327
384
  // ADR-094: экспорт Prometheus-метрик выключен по умолчанию (`GET /metrics` → 404).
328
385
  enabled: false,
329
386
  },
387
+ terminal: {
388
+ // PROP-132: мастер-выключатель терминалов. Значение по умолчанию —
389
+ // `enabled: true` (контур включён), но здесь флаг **не задан**: «не задано
390
+ // в config.yaml» отличается от «явно задано» — по этому различаются
391
+ // источники значения в API (`config` против `default`). Сам дефолт живёт
392
+ // в резолвере ядра (`DEFAULT_TERMINAL_ENABLED`).
393
+ },
394
+ updates: {
395
+ // ADR-133: автопроверка обновлений **выключена по умолчанию** — инстанс не
396
+ // ходит в реестры без явного согласия владельца (офлайн/закрытый контур не
397
+ // шумит запросами). Явная проверка (`synth update --check`, `?force=1`) от
398
+ // этого флага не зависит.
399
+ check: false,
400
+ // Канал выводится из установленной версии (`-beta.` ⇒ beta), иначе stable.
401
+ channel: 'auto',
402
+ // TTL успешной проверки; ошибка кэшируется на 1 ч.
403
+ intervalHours: 24,
404
+ // Стабильный канал — npmjs; бета — npm-реестр Gitea (чтение без токена).
405
+ stableRegistry: 'https://registry.npmjs.org',
406
+ betaRegistry: 'https://git.itphx.ru/api/packages/itphx/npm/',
407
+ },
330
408
  authority: {
331
409
  // ADR-106 Ф1: Authority-слой выключен по умолчанию — права не меняются.
332
410
  enabled: false,
@@ -490,7 +568,9 @@ export const defaultConfig = {
490
568
  microLlmEnabled: false,
491
569
  },
492
570
  llmGateway: {
493
- enabled: false,
571
+ // ADR-147: дефолт единый для всех профилей (standalone/hybrid/backend);
572
+ // ранее был профильный (ADR-139). Явный opt-out — config.yaml/env/runtime.
573
+ enabled: true,
494
574
  inputMode: 'obfuscate',
495
575
  logPayloads: false,
496
576
  payloadLogPath: '',
@@ -518,6 +598,25 @@ export const defaultConfig = {
518
598
  protectedPaths: {
519
599
  enabled: true,
520
600
  },
601
+ // PROP-136: аудит исполнений shell — standalone по умолчанию выключен
602
+ // (backend/managed включает его через `baseDefaults` `loadBackendConfig`).
603
+ commandAudit: {
604
+ enabled: false,
605
+ retentionDays: 30,
606
+ path: '',
607
+ },
608
+ // PROP-136b: зеркальный чекер команд в control plane — по умолчанию
609
+ // выключен (без него поведение прежнее); backend/managed поднимает
610
+ // `failMode` до `closed` профильным дефолтом.
611
+ commandPolicy: {
612
+ enabled: false,
613
+ provider: 'http',
614
+ url: '',
615
+ tokenSecret: '',
616
+ failMode: 'open',
617
+ timeoutMs: 2_000,
618
+ opaPath: '/v1/data/synth/exec/decision',
619
+ },
521
620
  // ADR-099: доверие TLS/CA исходящих соединений. Пусто — системное доверие
522
621
  // (поведение не меняется); caFile — корпоративный CA, cert/key — mTLS.
523
622
  tls: {},
@@ -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`).
@@ -65,6 +81,22 @@ export type AttachmentModalityKey = (typeof ATTACHMENT_MODALITY_KEYS)[number];
65
81
  * если валидных нет — `undefined` (значение игнорируется, как невалидный env).
66
82
  */
67
83
  export declare function parseAttachmentsModalities(raw: string): Record<AttachmentModalityKey, boolean> | undefined;
84
+ /**
85
+ * PROP-136b: env-имена **зеркального** чекера команд (`security.commandPolicy`).
86
+ *
87
+ * Имена намеренно короткие (`SYNTH_COMMAND_POLICY_*`, без `SECURITY_`) — так
88
+ * их задают оператор и Helm; `TOKEN` — **путь** к файлу токена (инвариант 13),
89
+ * не значение. Приоритет — общий (ADR-023): env > config.yaml > дефолт.
90
+ */
91
+ export declare const COMMAND_POLICY_ENV: {
92
+ readonly enabled: "SYNTH_COMMAND_POLICY_ENABLED";
93
+ readonly provider: "SYNTH_COMMAND_POLICY_PROVIDER";
94
+ readonly url: "SYNTH_COMMAND_POLICY_URL";
95
+ readonly tokenSecret: "SYNTH_COMMAND_POLICY_TOKEN";
96
+ readonly failMode: "SYNTH_COMMAND_POLICY_FAIL_MODE";
97
+ readonly timeoutMs: "SYNTH_COMMAND_POLICY_TIMEOUT_MS";
98
+ readonly opaPath: "SYNTH_COMMAND_POLICY_OPA_PATH";
99
+ };
68
100
  /**
69
101
  * ADR-052/O1: env-имя JSON-списка installer service-key'ев
70
102
  * (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
@@ -89,10 +121,13 @@ export declare const BOOTSTRAP_SERVICE_KEYS_ENV = "SYNTH_BOOTSTRAP_SERVICE_KEYS"
89
121
  export declare const OAUTH_PROVIDERS_ENV = "SYNTH_OAUTH_PROVIDERS";
90
122
  /**
91
123
  * Применяет объектные env-оверрайды, у которых нет плоского строкового
92
- * представления (сейчас — `security.bootstrapServiceKeys`). Значение парсится
93
- * как JSON и валидируется схемой; при ошибке парсинга/валидации — warn в console
94
- * и игнор (fail-soft: кривой installer-ключ не должен ронять старт инстанса —
95
- * ensure-логика приложения просто ничего не бутстрапит, оператор видит warn).
124
+ * представления (`auth.apiKeyRoles`, `attachments.modalities`, `oauth.providers`,
125
+ * `security.bootstrapServiceKeys`). Нескалярные значения парсятся здесь;
126
+ * `security.bootstrapServiceKeys` — JSON, валидируется схемой, при ошибке
127
+ * парсинга/валидации warn в console и игнор (fail-soft: кривой installer-ключ не
128
+ * должен ронять старт инстанса — ensure-логика приложения просто ничего не
129
+ * бутстрапит, оператор видит warn). Исключение — `auth.apiKeyRoles`: там
130
+ * неизвестная роль бросает `Error` (fail-closed, права доступа).
96
131
  *
97
132
  * Мутирует переданный объект (в `loadConfig` — свежий результат `deepMerge`) и
98
133
  * возвращает его; секция `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
  *
@@ -22,6 +23,10 @@ import { bootstrapServiceKeysSchema, oauthProvidersSchema } from './types.js';
22
23
  export const ENV_OVERRIDES = [
23
24
  // llm: лимит вывода по умолчанию (0 — авто-дефолт ядра).
24
25
  { section: 'llm', key: 'maxTokens', type: 'number' },
26
+ // llmGateway (ADR-036): мастер-выключатель шлюза. ADR-147: дефолт единый для
27
+ // всех профилей — включён; env перебивает и его, и config.yaml, но ниже
28
+ // runtime-тумблера из UI (`settings.json`).
29
+ { section: 'llmGateway', key: 'enabled', type: 'boolean' },
25
30
  // session.autoTitle: авто-именование сессии (мастер-флаг, отсрочка на
26
31
  // приветствии, число реплик, порог «сигнала задачи»).
27
32
  { section: 'session', key: 'autoTitle.enabled', type: 'boolean' },
@@ -77,6 +82,11 @@ export const ENV_OVERRIDES = [
77
82
  // git-тулы агента: локальные изменяющие операции и сетевые (0 — без таймаута).
78
83
  { section: 'git', key: 'localTimeoutMs', type: 'number' },
79
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 + дефолт.
80
90
  // questions (этап 1 roadmap 0.13 — блок 3): таймаут ответа + retention.
81
91
  { section: 'questions', key: 'timeoutMs', type: 'number' },
82
92
  { section: 'questions', key: 'retentionDays', type: 'number' },
@@ -87,10 +97,19 @@ export const ENV_OVERRIDES = [
87
97
  { section: 'background', key: 'maxRunsPerSession', type: 'number' },
88
98
  { section: 'background', key: 'logMaxBytes', type: 'number' },
89
99
  { section: 'background', key: 'retentionDays', type: 'number' },
100
+ // recovery (PROP-142 §3): бюджет автовосстановления прерванных ходов +
101
+ // детект crash-loop. Вложенные ключи `crashLoop.*` дают
102
+ // `SYNTH_RECOVERY_CRASH_LOOP_WINDOW_MINUTES`/`SYNTH_RECOVERY_CRASH_LOOP_MAX_RESTARTS`.
103
+ { section: 'recovery', key: 'autoResume', type: 'boolean' },
104
+ { section: 'recovery', key: 'maxAttempts', type: 'number' },
105
+ { section: 'recovery', key: 'crashLoop.windowMinutes', type: 'number' },
106
+ { section: 'recovery', key: 'crashLoop.maxRestarts', type: 'number' },
90
107
  // agents: предохранитель по объёму промпта саб-агента (не окно модели).
91
108
  { section: 'agents', key: 'subagentMaxInputTokens', type: 'number' },
92
109
  // agents: лимит глубины вложенности саб-агентов (0 — без ограничения).
93
110
  { section: 'agents', key: 'subagentDepth', type: 'number' },
111
+ // limits: лимит тяжёлых операций с сессиями в минуту (0 — без ограничения).
112
+ { section: 'limits', key: 'sessionOpsPerMinute', type: 'number' },
94
113
  // attachments (ADR-115): вложения сообщений. Семейства MIME
95
114
  // (`SYNTH_ATTACHMENTS_MODALITIES`, csv) — объектный ключ, обрабатывается
96
115
  // отдельно (`applyAttachmentsModalitiesEnvOverride`); список префиксов
@@ -109,6 +128,29 @@ export const ENV_OVERRIDES = [
109
128
  { section: 'attachments', key: 'maxActiveUploads', type: 'number' },
110
129
  // metrics (ADR-094): Helm ставит `SYNTH_METRICS_ENABLED` — имя должно совпадать.
111
130
  { section: 'metrics', key: 'enabled', type: 'boolean' },
131
+ // terminal (PROP-132): мастер-выключатель терминального контура.
132
+ { section: 'terminal', key: 'enabled', type: 'boolean' },
133
+ // terminal (PROP-132): восстановление терминалов из снимков после рестарта.
134
+ { section: 'terminal', key: 'autoRestore', type: 'boolean' },
135
+ // terminal (PROP-132): параметры выполнения (редактируются из админки).
136
+ // Имя переменной собирается тем же правилом секций (см. `envOverrideName`):
137
+ // camelCase → SNAKE_CASE, префикс `SYNTH_<SECTION>_` — то есть
138
+ // `SYNTH_TERMINAL_IDLE_MINUTES`, `SYNTH_TERMINAL_MAX_PER_PROJECT`,
139
+ // `SYNTH_TERMINAL_MAX_PER_INSTANCE`, `SYNTH_TERMINAL_SHELL`,
140
+ // `SYNTH_TERMINAL_AUDIT_INPUT`. Невалидное значение (не число/не булево,
141
+ // пустая строка) — warn + игнор (fail-soft, как у остальных секций).
142
+ { section: 'terminal', key: 'idleMinutes', type: 'number' },
143
+ { section: 'terminal', key: 'maxPerProject', type: 'number' },
144
+ { section: 'terminal', key: 'maxPerInstance', type: 'number' },
145
+ { section: 'terminal', key: 'shell', type: 'string' },
146
+ { section: 'terminal', key: 'auditInput', type: 'boolean' },
147
+ // updates (ADR-133): каналы обновлений. `check` — автопроверка в фоне;
148
+ // `channel` — `auto`|`stable`|`beta`; интервал и реестры каналов.
149
+ { section: 'updates', key: 'check', type: 'boolean' },
150
+ { section: 'updates', key: 'channel', type: 'string' },
151
+ { section: 'updates', key: 'intervalHours', type: 'number' },
152
+ { section: 'updates', key: 'stableRegistry', type: 'string' },
153
+ { section: 'updates', key: 'betaRegistry', type: 'string' },
112
154
  // tools: общий предел вывода инструментов (строк/байт).
113
155
  { section: 'tools', key: 'outputMaxLines', type: 'number' },
114
156
  { section: 'tools', key: 'outputMaxBytes', type: 'number' },
@@ -140,6 +182,53 @@ export const ENV_OVERRIDES = [
140
182
  export function toSnakeCase(value) {
141
183
  return value.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toUpperCase();
142
184
  }
185
+ /**
186
+ * Роли пользователя единого API-ключа (`auth.apiKeyRoles`), csv: `ADMIN,USER`.
187
+ *
188
+ * Намеренно **fail-closed** (в отличие от прочих env-оверрайдов): неизвестная
189
+ * роль — ошибка конфигурации на загрузке, а не warn+игнор. Иначе опечатка в
190
+ * `SYNTH_API_KEY_ROLES` молча оставляла бы дефолт (`USER`) или, хуже, ключ без
191
+ * ожидаемых прав; для прав доступа это недопустимо.
192
+ */
193
+ export const API_KEY_ROLES_ENV = 'SYNTH_API_KEY_ROLES';
194
+ const API_KEY_ROLE_VALUES = Object.values(GlobalRole);
195
+ /**
196
+ * Разобрать csv ролей API-ключа (`ADMIN,USER`; регистр и пробелы не важны).
197
+ * Пустой список и неизвестная роль → `Error` (fail-closed, понятный текст).
198
+ * Дубликаты схлопываются с сохранением порядка.
199
+ */
200
+ export function parseApiKeyRoles(raw) {
201
+ const tokens = raw
202
+ .split(',')
203
+ .map((part) => part.trim().toUpperCase())
204
+ .filter((part) => part !== '');
205
+ if (tokens.length === 0) {
206
+ throw new Error(`[config] ${API_KEY_ROLES_ENV}: пустой список ролей; допустимо: ${API_KEY_ROLE_VALUES.join(', ')}`);
207
+ }
208
+ const roles = [];
209
+ for (const token of tokens) {
210
+ if (!API_KEY_ROLE_VALUES.includes(token)) {
211
+ throw new Error(`[config] ${API_KEY_ROLES_ENV}: неизвестная роль "${token}"; ` +
212
+ `допустимо: ${API_KEY_ROLE_VALUES.join(', ')}`);
213
+ }
214
+ const role = token;
215
+ if (!roles.includes(role))
216
+ roles.push(role);
217
+ }
218
+ return roles;
219
+ }
220
+ function applyApiKeyRolesEnvOverride(config, env) {
221
+ const raw = env[API_KEY_ROLES_ENV];
222
+ if (raw === undefined || raw === '')
223
+ return;
224
+ const roles = parseApiKeyRoles(raw);
225
+ const current = config.auth;
226
+ const auth = current !== null && typeof current === 'object' && !Array.isArray(current)
227
+ ? { ...current }
228
+ : {};
229
+ auth.apiKeyRoles = roles;
230
+ config.auth = auth;
231
+ }
143
232
  /**
144
233
  * Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. Точки в ключе означают
145
234
  * вложенность (`log.enabled` → `SYNTH_EGRESS_LOG_ENABLED`).
@@ -319,6 +408,82 @@ function applyOAuthProvidersEnvOverride(config, env) {
319
408
  oauth.providers = { ...providers, ...validated.data };
320
409
  config.oauth = oauth;
321
410
  }
411
+ /**
412
+ * PROP-136b: env-имена **зеркального** чекера команд (`security.commandPolicy`).
413
+ *
414
+ * Имена намеренно короткие (`SYNTH_COMMAND_POLICY_*`, без `SECURITY_`) — так
415
+ * их задают оператор и Helm; `TOKEN` — **путь** к файлу токена (инвариант 13),
416
+ * не значение. Приоритет — общий (ADR-023): env > config.yaml > дефолт.
417
+ */
418
+ export const COMMAND_POLICY_ENV = {
419
+ enabled: 'SYNTH_COMMAND_POLICY_ENABLED',
420
+ provider: 'SYNTH_COMMAND_POLICY_PROVIDER',
421
+ url: 'SYNTH_COMMAND_POLICY_URL',
422
+ tokenSecret: 'SYNTH_COMMAND_POLICY_TOKEN',
423
+ failMode: 'SYNTH_COMMAND_POLICY_FAIL_MODE',
424
+ timeoutMs: 'SYNTH_COMMAND_POLICY_TIMEOUT_MS',
425
+ opaPath: 'SYNTH_COMMAND_POLICY_OPA_PATH',
426
+ };
427
+ /**
428
+ * Применить env-оверрайды чекера команд к секции `security.commandPolicy`.
429
+ *
430
+ * **Fail-closed** (в отличие от большинства env-оверрайдов): невалидное
431
+ * значение — `Error` на загрузке конфигурации, а не warn+игнор. Опечатка в
432
+ * настройке политики не должна молча оставлять инстанс без неё (или с
433
+ * противоположным `failMode`). Семантику значений (`enabled` без `url`)
434
+ * проверяет схема — она тоже бросает ошибку старта.
435
+ */
436
+ function applyCommandPolicyEnvOverrides(config, env) {
437
+ const patch = {};
438
+ const rawEnabled = env[COMMAND_POLICY_ENV.enabled];
439
+ if (rawEnabled !== undefined && rawEnabled.trim() !== '') {
440
+ const parsed = parseEnvValue(rawEnabled.trim(), 'boolean');
441
+ if (!parsed.ok) {
442
+ throw new Error(`[config] невалидное значение ${COMMAND_POLICY_ENV.enabled}="${rawEnabled}" — ожидается true/false`);
443
+ }
444
+ patch.enabled = parsed.value;
445
+ }
446
+ const rawProvider = env[COMMAND_POLICY_ENV.provider]?.trim().toLowerCase();
447
+ if (rawProvider !== undefined && rawProvider !== '') {
448
+ if (rawProvider !== 'http' && rawProvider !== 'opa') {
449
+ throw new Error(`[config] невалидное значение ${COMMAND_POLICY_ENV.provider}="${rawProvider}" — допустимо: http, opa`);
450
+ }
451
+ patch.provider = rawProvider;
452
+ }
453
+ const rawFailMode = env[COMMAND_POLICY_ENV.failMode]?.trim().toLowerCase();
454
+ if (rawFailMode !== undefined && rawFailMode !== '') {
455
+ if (rawFailMode !== 'closed' && rawFailMode !== 'open') {
456
+ throw new Error(`[config] невалидное значение ${COMMAND_POLICY_ENV.failMode}="${rawFailMode}" — допустимо: closed, open`);
457
+ }
458
+ patch.failMode = rawFailMode;
459
+ }
460
+ const rawTimeout = env[COMMAND_POLICY_ENV.timeoutMs]?.trim();
461
+ if (rawTimeout !== undefined && rawTimeout !== '') {
462
+ const parsed = parseEnvValue(rawTimeout, 'number');
463
+ if (!parsed.ok || typeof parsed.value !== 'number' || !Number.isInteger(parsed.value) || parsed.value < 1) {
464
+ throw new Error(`[config] невалидное значение ${COMMAND_POLICY_ENV.timeoutMs}="${rawTimeout}" — ожидается целое ≥ 1`);
465
+ }
466
+ patch.timeoutMs = parsed.value;
467
+ }
468
+ for (const key of ['url', 'tokenSecret', 'opaPath']) {
469
+ const raw = env[COMMAND_POLICY_ENV[key]];
470
+ if (raw === undefined || raw.trim() === '')
471
+ continue;
472
+ patch[key] = raw.trim();
473
+ }
474
+ if (Object.keys(patch).length === 0)
475
+ return;
476
+ const current = config.security;
477
+ const security = current !== null && typeof current === 'object' && !Array.isArray(current)
478
+ ? { ...current }
479
+ : {};
480
+ const currentPolicy = security.commandPolicy;
481
+ const policy = currentPolicy !== null && typeof currentPolicy === 'object' && !Array.isArray(currentPolicy)
482
+ ? { ...currentPolicy }
483
+ : {};
484
+ security.commandPolicy = { ...policy, ...patch };
485
+ config.security = security;
486
+ }
322
487
  /**
323
488
  * ADR-052/O1: env-имя JSON-списка installer service-key'ев
324
489
  * (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
@@ -343,17 +508,22 @@ export const BOOTSTRAP_SERVICE_KEYS_ENV = 'SYNTH_BOOTSTRAP_SERVICE_KEYS';
343
508
  export const OAUTH_PROVIDERS_ENV = 'SYNTH_OAUTH_PROVIDERS';
344
509
  /**
345
510
  * Применяет объектные env-оверрайды, у которых нет плоского строкового
346
- * представления (сейчас — `security.bootstrapServiceKeys`). Значение парсится
347
- * как JSON и валидируется схемой; при ошибке парсинга/валидации — warn в console
348
- * и игнор (fail-soft: кривой installer-ключ не должен ронять старт инстанса —
349
- * ensure-логика приложения просто ничего не бутстрапит, оператор видит warn).
511
+ * представления (`auth.apiKeyRoles`, `attachments.modalities`, `oauth.providers`,
512
+ * `security.bootstrapServiceKeys`). Нескалярные значения парсятся здесь;
513
+ * `security.bootstrapServiceKeys` — JSON, валидируется схемой, при ошибке
514
+ * парсинга/валидации warn в console и игнор (fail-soft: кривой installer-ключ не
515
+ * должен ронять старт инстанса — ensure-логика приложения просто ничего не
516
+ * бутстрапит, оператор видит warn). Исключение — `auth.apiKeyRoles`: там
517
+ * неизвестная роль бросает `Error` (fail-closed, права доступа).
350
518
  *
351
519
  * Мутирует переданный объект (в `loadConfig` — свежий результат `deepMerge`) и
352
520
  * возвращает его; секция `security` клонируется, чтобы не мутировать `defaultConfig`.
353
521
  */
354
522
  export function applyObjectEnvOverrides(config, env = process.env) {
523
+ applyApiKeyRolesEnvOverride(config, env);
355
524
  applyAttachmentsModalitiesEnvOverride(config, env);
356
525
  applyOAuthProvidersEnvOverride(config, env);
526
+ applyCommandPolicyEnvOverrides(config, env);
357
527
  const raw = env[BOOTSTRAP_SERVICE_KEYS_ENV];
358
528
  if (raw === undefined || raw === '')
359
529
  return config;
@@ -0,0 +1,89 @@
1
+ import type { ExecutionRuntimeSettings, ExecutionProfileOrigin } from '../types/execution.js';
2
+ import type { ResolvedExecutionConfig, ResolvedExecutionProfile } from './execution.js';
3
+ /**
4
+ * Разобрать сохранённую runtime-секцию исполнения.
5
+ *
6
+ * Валидация — Zod (`:strict()`): неизвестное поле → невалидная секция.
7
+ * Невалидная секция **игнорируется** (fail-soft): испорченный `settings.json`
8
+ * не должен ронять инстанс — применяется config-уровень (как при деградации
9
+ * хранилища).
10
+ */
11
+ export declare function parseExecutionRuntimeSettings(raw: unknown): ExecutionRuntimeSettings | undefined;
12
+ /**
13
+ * Эффективный каталог профилей: **config + runtime (override) − отключённые**.
14
+ *
15
+ * Возвращает профили, их происхождение (`config`/`runtime`) и дефолты —
16
+ * единый источник истины для роутера, API и валидации.
17
+ */
18
+ export interface EffectiveExecutionCatalog {
19
+ /** Профили эффективного каталога (общие параметры секции уже подставлены). */
20
+ profiles: Record<string, ResolvedExecutionProfile>;
21
+ /** Происхождение профиля: `config` — из `config.yaml`, `runtime` — из UI. */
22
+ origins: Record<string, ExecutionProfileOrigin>;
23
+ /** Профиль по умолчанию (env > runtime > config). */
24
+ defaultProfile: string;
25
+ /** Браузерный профиль по умолчанию (env > runtime > config). */
26
+ browserProfile: string;
27
+ /** Legacy-список браузерных имён (env > runtime > config). */
28
+ browserProfiles: string[];
29
+ /** Отключённые профили config-базы (скрыты из каталога). */
30
+ disabledProfiles: string[];
31
+ }
32
+ /**
33
+ * Собрать эффективный каталог профилей (ADR-135, аддендум §11).
34
+ *
35
+ * Порядок: env > runtime > config.yaml (ADR-023). Runtime-запись профиля
36
+ * **переопределяет** одноимённую config-запись целиком; config-записи без
37
+ * runtime-пары сохраняются; `disabledProfiles` (только имена из config-базы)
38
+ * убирают профиль из каталога.
39
+ */
40
+ export declare function effectiveExecutionCatalog(base: ResolvedExecutionConfig, runtime: ExecutionRuntimeSettings | undefined, env?: NodeJS.ProcessEnv): EffectiveExecutionCatalog;
41
+ /**
42
+ * Применить runtime-каталог к эффективной секции `execution`.
43
+ *
44
+ * Вход — **уже разрешённая** секция (config.yaml + env, ADR-023); выход —
45
+ * секция, с которой работает процесс (config.yaml + env + runtime).
46
+ *
47
+ * Env/CLI выше runtime: поле, явно заданное переменной окружения, не
48
+ * перекрывается (иначе оператор не смог бы зафиксировать значение из
49
+ * `SYNTH_EXECUTION_*`).
50
+ *
51
+ * Каталог `profiles` runtime-секции **сливается** с каталогом config.yaml
52
+ * (runtime-запись переопределяет одноимённую config-запись целиком), а
53
+ * `disabledProfiles` убирают профили config-базы из эффективного каталога.
54
+ */
55
+ export declare function applyExecutionRuntimeSettings(resolved: ResolvedExecutionConfig, runtime: ExecutionRuntimeSettings | undefined, env?: NodeJS.ProcessEnv): ResolvedExecutionConfig;
56
+ /**
57
+ * Снимок эффективной секции `execution` в форме runtime-секции.
58
+ *
59
+ * Нужен админ-API: «что сейчас работает» (`running`) и «что сохранено»
60
+ * (`saved`) сравниваются одним отпечатком. Профили приводятся к runtime-форме
61
+ * (только поля runtime-модели; `url` — фактический адрес профиля, включая
62
+ * унаследованный; `class` — **эффективный** класс профиля; `mcpServers` —
63
+ * имя + команда, если она известна).
64
+ */
65
+ export declare function executionRuntimeSettingsFromResolved(resolved: ResolvedExecutionConfig | undefined | null): ExecutionRuntimeSettings | null;
66
+ /**
67
+ * Слить config-уровень и runtime-секцию (runtime > config).
68
+ *
69
+ * `profiles` runtime-секции **сливается** с каталогом base: одноимённая
70
+ * запись runtime переопределяет base целиком, остальные base-записи
71
+ * сохраняются (ADR-135, аддендум §11).
72
+ */
73
+ export declare function mergeExecutionRuntimeSettings(base: ExecutionRuntimeSettings | undefined | null, runtime: ExecutionRuntimeSettings | undefined | null): ExecutionRuntimeSettings;
74
+ /**
75
+ * Имена профилей **эффективного** каталога (после применения runtime-секции).
76
+ *
77
+ * Каталог = config-профили + runtime-профили (override) − отключённые.
78
+ */
79
+ export declare function effectiveExecutionProfileNames(base: ExecutionRuntimeSettings | undefined | null, runtime: ExecutionRuntimeSettings | undefined | null): string[];
80
+ /**
81
+ * Отпечаток runtime-секции — для сравнения «сохранено» vs «работает»
82
+ * (`restartRequired`).
83
+ *
84
+ * Нормализация: имена профилей — по алфавиту, ключи профиля — по алфавиту,
85
+ * списки (`url`, `mcpServers`, `disabledProfiles`) — по алфавиту (порядок
86
+ * элементов и ключей не влияет на отпечаток). Пустая секция и `null` — один
87
+ * отпечаток («ничего не задано»).
88
+ */
89
+ export declare function executionRuntimeFingerprint(settings: ExecutionRuntimeSettings | undefined | null): string;