@itphx/synth-shared 0.13.8 → 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 (71) hide show
  1. package/dist/config/defaults.js +74 -2
  2. package/dist/config/env-overrides.d.ts +16 -0
  3. package/dist/config/env-overrides.js +103 -3
  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 +2 -0
  9. package/dist/config/index.js +2 -0
  10. package/dist/config/security.d.ts +77 -0
  11. package/dist/config/security.js +116 -0
  12. package/dist/config/types.d.ts +466 -34
  13. package/dist/config/types.js +317 -33
  14. package/dist/i18n/index.d.ts +1 -1
  15. package/dist/i18n/index.js +196 -13
  16. package/dist/index.d.ts +5 -4
  17. package/dist/index.js +15 -2
  18. package/dist/schemas/index.d.ts +156 -19
  19. package/dist/schemas/index.js +126 -15
  20. package/dist/skills/frontmatter.js +1 -1
  21. package/dist/types/agent.d.ts +29 -1
  22. package/dist/types/authority.d.ts +10 -0
  23. package/dist/types/authority.js +8 -0
  24. package/dist/types/bus-events.d.ts +87 -1
  25. package/dist/types/catalog.d.ts +1 -1
  26. package/dist/types/catalog.js +1 -1
  27. package/dist/types/command-audit.d.ts +91 -0
  28. package/dist/types/command-audit.js +44 -0
  29. package/dist/types/commands.d.ts +29 -11
  30. package/dist/types/commands.js +2 -2
  31. package/dist/types/egress.d.ts +18 -3
  32. package/dist/types/egress.js +18 -3
  33. package/dist/types/events.d.ts +23 -2
  34. package/dist/types/execution.d.ts +424 -0
  35. package/dist/types/execution.js +355 -0
  36. package/dist/types/file-kind.d.ts +3 -2
  37. package/dist/types/file-kind.js +11 -2
  38. package/dist/types/git.d.ts +48 -0
  39. package/dist/types/index.d.ts +6 -0
  40. package/dist/types/index.js +18 -2
  41. package/dist/types/mentions.d.ts +96 -0
  42. package/dist/types/mentions.js +9 -0
  43. package/dist/types/message.d.ts +24 -1
  44. package/dist/types/message.js +13 -0
  45. package/dist/types/pack.d.ts +21 -21
  46. package/dist/types/pack.js +4 -4
  47. package/dist/types/permission.d.ts +8 -1
  48. package/dist/types/pipeline.d.ts +2 -2
  49. package/dist/types/plugin-protocol.d.ts +203 -4
  50. package/dist/types/plugin-protocol.js +77 -4
  51. package/dist/types/project-access.d.ts +94 -0
  52. package/dist/types/project-access.js +140 -0
  53. package/dist/types/project.d.ts +59 -2
  54. package/dist/types/project.js +20 -0
  55. package/dist/types/schedules.d.ts +49 -3
  56. package/dist/types/schedules.js +50 -1
  57. package/dist/types/scripts.d.ts +98 -0
  58. package/dist/types/scripts.js +14 -0
  59. package/dist/types/service-keys.d.ts +12 -2
  60. package/dist/types/service-keys.js +13 -0
  61. package/dist/types/session.d.ts +60 -3
  62. package/dist/types/skills.d.ts +15 -11
  63. package/dist/types/skills.js +6 -6
  64. package/dist/types/timers.d.ts +402 -0
  65. package/dist/types/timers.js +166 -0
  66. package/dist/types/tools.d.ts +124 -1
  67. package/dist/types/tools.js +22 -0
  68. package/dist/types/user.d.ts +17 -0
  69. package/dist/version.d.ts +1 -1
  70. package/dist/version.js +1 -1
  71. package/package.json +2 -2
@@ -1,7 +1,7 @@
1
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,6 +42,34 @@ 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: {
@@ -184,6 +212,10 @@ export const defaultConfig = {
184
212
  maxArgumentsLength: 10_000,
185
213
  maxRenderedBytes: 200_000,
186
214
  },
215
+ // ADR-126 §5: скрипты проекта (`!`-запуск) — каталоги-источники деклараций.
216
+ scripts: {
217
+ paths: [],
218
+ },
187
219
  events: {
188
220
  enabled: true,
189
221
  defaultMode: 'bound',
@@ -275,6 +307,18 @@ export const defaultConfig = {
275
307
  // Срок хранения терминальных записей реестра (дни; <= 0 — без ограничения).
276
308
  retentionDays: 7,
277
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
+ },
278
322
  agents: {
279
323
  // Предохранитель по объёму промпта саб-агента (не окно модели): при
280
324
  // превышении оценка бюджета завершает прогон детерминированным отчётом.
@@ -340,6 +384,13 @@ export const defaultConfig = {
340
384
  // ADR-094: экспорт Prometheus-метрик выключен по умолчанию (`GET /metrics` → 404).
341
385
  enabled: false,
342
386
  },
387
+ terminal: {
388
+ // PROP-132: мастер-выключатель терминалов. Значение по умолчанию —
389
+ // `enabled: true` (контур включён), но здесь флаг **не задан**: «не задано
390
+ // в config.yaml» отличается от «явно задано» — по этому различаются
391
+ // источники значения в API (`config` против `default`). Сам дефолт живёт
392
+ // в резолвере ядра (`DEFAULT_TERMINAL_ENABLED`).
393
+ },
343
394
  updates: {
344
395
  // ADR-133: автопроверка обновлений **выключена по умолчанию** — инстанс не
345
396
  // ходит в реестры без явного согласия владельца (офлайн/закрытый контур не
@@ -517,7 +568,9 @@ export const defaultConfig = {
517
568
  microLlmEnabled: false,
518
569
  },
519
570
  llmGateway: {
520
- enabled: false,
571
+ // ADR-147: дефолт единый для всех профилей (standalone/hybrid/backend);
572
+ // ранее был профильный (ADR-139). Явный opt-out — config.yaml/env/runtime.
573
+ enabled: true,
521
574
  inputMode: 'obfuscate',
522
575
  logPayloads: false,
523
576
  payloadLogPath: '',
@@ -545,6 +598,25 @@ export const defaultConfig = {
545
598
  protectedPaths: {
546
599
  enabled: true,
547
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
+ },
548
620
  // ADR-099: доверие TLS/CA исходящих соединений. Пусто — системное доверие
549
621
  // (поведение не меняется); caFile — корпоративный CA, cert/key — mTLS.
550
622
  tls: {},
@@ -81,6 +81,22 @@ export type AttachmentModalityKey = (typeof ATTACHMENT_MODALITY_KEYS)[number];
81
81
  * если валидных нет — `undefined` (значение игнорируется, как невалидный env).
82
82
  */
83
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
+ };
84
100
  /**
85
101
  * ADR-052/O1: env-имя JSON-списка installer service-key'ев
86
102
  * (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
@@ -23,9 +23,9 @@ import { GlobalRole } from '../types/user.js';
23
23
  export const ENV_OVERRIDES = [
24
24
  // llm: лимит вывода по умолчанию (0 — авто-дефолт ядра).
25
25
  { section: 'llm', key: 'maxTokens', type: 'number' },
26
- // llmGateway (ADR-036): мастер-выключатель шлюза. Дефолт зависит от профиля
27
- // (backend/managed — включён, standalone — выключен); env перебивает и его,
28
- // и config.yaml, но ниже runtime-тумблера из UI (`settings.json`).
26
+ // llmGateway (ADR-036): мастер-выключатель шлюза. ADR-147: дефолт единый для
27
+ // всех профилей — включён; env перебивает и его, и config.yaml, но ниже
28
+ // runtime-тумблера из UI (`settings.json`).
29
29
  { section: 'llmGateway', key: 'enabled', type: 'boolean' },
30
30
  // session.autoTitle: авто-именование сессии (мастер-флаг, отсрочка на
31
31
  // приветствии, число реплик, порог «сигнала задачи»).
@@ -97,6 +97,13 @@ export const ENV_OVERRIDES = [
97
97
  { section: 'background', key: 'maxRunsPerSession', type: 'number' },
98
98
  { section: 'background', key: 'logMaxBytes', type: 'number' },
99
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' },
100
107
  // agents: предохранитель по объёму промпта саб-агента (не окно модели).
101
108
  { section: 'agents', key: 'subagentMaxInputTokens', type: 'number' },
102
109
  // agents: лимит глубины вложенности саб-агентов (0 — без ограничения).
@@ -121,6 +128,22 @@ export const ENV_OVERRIDES = [
121
128
  { section: 'attachments', key: 'maxActiveUploads', type: 'number' },
122
129
  // metrics (ADR-094): Helm ставит `SYNTH_METRICS_ENABLED` — имя должно совпадать.
123
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' },
124
147
  // updates (ADR-133): каналы обновлений. `check` — автопроверка в фоне;
125
148
  // `channel` — `auto`|`stable`|`beta`; интервал и реестры каналов.
126
149
  { section: 'updates', key: 'check', type: 'boolean' },
@@ -385,6 +408,82 @@ function applyOAuthProvidersEnvOverride(config, env) {
385
408
  oauth.providers = { ...providers, ...validated.data };
386
409
  config.oauth = oauth;
387
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
+ }
388
487
  /**
389
488
  * ADR-052/O1: env-имя JSON-списка installer service-key'ев
390
489
  * (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
@@ -424,6 +523,7 @@ export function applyObjectEnvOverrides(config, env = process.env) {
424
523
  applyApiKeyRolesEnvOverride(config, env);
425
524
  applyAttachmentsModalitiesEnvOverride(config, env);
426
525
  applyOAuthProvidersEnvOverride(config, env);
526
+ applyCommandPolicyEnvOverrides(config, env);
427
527
  const raw = env[BOOTSTRAP_SERVICE_KEYS_ENV];
428
528
  if (raw === undefined || raw === '')
429
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;