@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
@@ -71,34 +71,20 @@ export declare const storageConfigSchema: z.ZodObject<{
71
71
  maxPreviewBytes: z.ZodOptional<z.ZodNumber>;
72
72
  }, z.core.$strip>;
73
73
  /**
74
- * ADR-077: топология исполнения — переключатель запуска (`execution.mode`).
74
+ * ADR-077/ADR-135: канонические перечисления и константы секции `execution`
75
+ * живут в **browser-safe** модуле `types/execution.ts` — их читает и ядро, и
76
+ * UI (админка «Исполнение»). Здесь — реэкспорт (обратная совместимость
77
+ * импортов `@itphx/synth-shared/config`).
75
78
  *
76
- * - `inline` (дефолт) — исполнение в процессе backend'а (прежнее поведение,
77
- * all-in-one образ);
78
- * - `remote` — отдельные исполнители (`RemoteExecutionPort` + сервис-исполнитель,
79
- * шаг 7 плана ADR-077).
80
- *
81
- * Секция — **параметр запуска**, а не runtime-настройка: смена режима — только
82
- * рестартом процесса (инвариант 24 — process-глобальные решения не
83
- * переинициализируются на лету). Значение `mode` — **fail-closed**: неизвестное
84
- * явное значение (опечатка `inlne`) валит старт, а не молча выбирает дефолт
85
- * (как `storage.backend`).
86
- */
87
- export declare const EXECUTION_MODES: readonly ["inline", "remote"];
88
- export type ExecutionMode = (typeof EXECUTION_MODES)[number];
89
- /**
90
- * Поведение при недоступном исполнителе:
91
- * - `fail` (дефолт) — fail-closed: инструмент недоступен с явной причиной;
92
- * - `inline-fallback` — backend исполняет команду сам; **только явной настройкой**
93
- * (в managed-контуре это обход изоляции).
94
- */
95
- export declare const EXECUTION_FAIL_MODES: readonly ["fail", "inline-fallback"];
96
- export type ExecutionFailMode = (typeof EXECUTION_FAIL_MODES)[number];
97
- /**
98
- * Таймаут exec-вызова по умолчанию (30 с — как у нынешних тулов: shell/search/git).
99
- * Больший лимит для shell (до 120 с) — свойство тула, не конфига.
79
+ * Топология исполнения — переключатель запуска (`execution.mode`):
80
+ * `inline` (дефолт) — исполнение в процессе control plane; `remote` —
81
+ * отдельные исполнители (ADR-077). Секция — **параметр запуска**, а не
82
+ * runtime-настройка: смена режима — только рестартом процесса (инвариант 24).
83
+ * Значение `mode` — **fail-closed**: неизвестное явное значение (опечатка
84
+ * `inlne`) валит старт, а не молча выбирает дефолт (как `storage.backend`).
100
85
  */
101
- export declare const DEFAULT_EXECUTION_TIMEOUT_MS = 30000;
86
+ export { EXECUTION_MODES, EXECUTION_FAIL_MODES, EXECUTION_POOLINGS, EXECUTION_FALLBACKS, EXECUTION_POOL_PROVIDERS, EXECUTION_PROFILE_NETWORKS, EXECUTION_PROFILE_CLASSES, DEFAULT_EXECUTION_PROVISIONER_TIMEOUT_MS, DEFAULT_EXECUTION_TIMEOUT_MS, DEFAULT_EXECUTION_BROWSER_PROFILE, DEFAULT_EXECUTION_BROWSER_MCP_SERVER, DEFAULT_EXECUTION_BROWSER_TIMEOUT_MS, MAX_EXECUTION_BROWSER_TIMEOUT_MS, } from '../types/execution.js';
87
+ export type { ExecutionMode, ExecutionFailMode, ExecutionPooling, ExecutionFallback, ExecutionPoolProviderKind, ExecutionProfileNetwork, ExecutionProfileResourceList, ExecutionProfileResources, ExecutionProfileClass, ExecutionProfileOrigin, ExecutionProfileToleration, ExecutionTolerationEffect, ExecutionTolerationOperator, ExecutionMcpServer, } from '../types/execution.js';
102
88
  /**
103
89
  * Параметры удалённого исполнителя (`execution.remote`).
104
90
  *
@@ -120,6 +106,82 @@ export declare const executionRemoteConfigSchema: z.ZodObject<{
120
106
  "inline-fallback": "inline-fallback";
121
107
  }>>;
122
108
  tokenSecret: z.ZodDefault<z.ZodString>;
109
+ pooling: z.ZodDefault<z.ZodEnum<{
110
+ project: "project";
111
+ session: "session";
112
+ instance: "instance";
113
+ }>>;
114
+ defaultProfile: z.ZodDefault<z.ZodString>;
115
+ browserProfile: z.ZodDefault<z.ZodString>;
116
+ browserProfiles: z.ZodDefault<z.ZodArray<z.ZodString>>;
117
+ browserMcpServer: z.ZodDefault<z.ZodString>;
118
+ browserTimeoutMs: z.ZodOptional<z.ZodNumber>;
119
+ profiles: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
120
+ url: z.ZodDefault<z.ZodArray<z.ZodString>>;
121
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
122
+ concurrency: z.ZodOptional<z.ZodNumber>;
123
+ failMode: z.ZodOptional<z.ZodEnum<{
124
+ fail: "fail";
125
+ "inline-fallback": "inline-fallback";
126
+ }>>;
127
+ description: z.ZodOptional<z.ZodString>;
128
+ image: z.ZodOptional<z.ZodString>;
129
+ network: z.ZodOptional<z.ZodEnum<{
130
+ none: "none";
131
+ restricted: "restricted";
132
+ full: "full";
133
+ }>>;
134
+ resources: z.ZodOptional<z.ZodObject<{
135
+ requests: z.ZodOptional<z.ZodObject<{
136
+ cpu: z.ZodOptional<z.ZodString>;
137
+ memory: z.ZodOptional<z.ZodString>;
138
+ ephemeralStorage: z.ZodOptional<z.ZodString>;
139
+ }, z.core.$catchall<z.ZodString>>>;
140
+ limits: z.ZodOptional<z.ZodObject<{
141
+ cpu: z.ZodOptional<z.ZodString>;
142
+ memory: z.ZodOptional<z.ZodString>;
143
+ ephemeralStorage: z.ZodOptional<z.ZodString>;
144
+ }, z.core.$catchall<z.ZodString>>>;
145
+ }, z.core.$strip>>;
146
+ annotations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
147
+ labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
148
+ nodeSelector: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
149
+ tolerations: z.ZodOptional<z.ZodArray<z.ZodObject<{
150
+ key: z.ZodOptional<z.ZodString>;
151
+ operator: z.ZodOptional<z.ZodEnum<{
152
+ Exists: "Exists";
153
+ Equal: "Equal";
154
+ }>>;
155
+ value: z.ZodOptional<z.ZodString>;
156
+ effect: z.ZodOptional<z.ZodEnum<{
157
+ NoSchedule: "NoSchedule";
158
+ PreferNoSchedule: "PreferNoSchedule";
159
+ NoExecute: "NoExecute";
160
+ }>>;
161
+ tolerationSeconds: z.ZodOptional<z.ZodNumber>;
162
+ }, z.core.$strict>>>;
163
+ affinity: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
164
+ runtimeClass: z.ZodOptional<z.ZodString>;
165
+ class: z.ZodOptional<z.ZodEnum<{
166
+ exec: "exec";
167
+ browser: "browser";
168
+ both: "both";
169
+ }>>;
170
+ mcpServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
171
+ }, z.core.$strip>>>;
172
+ fallback: z.ZodDefault<z.ZodEnum<{
173
+ instance: "instance";
174
+ fail: "fail";
175
+ }>>;
176
+ provider: z.ZodDefault<z.ZodEnum<{
177
+ static: "static";
178
+ http: "http";
179
+ }>>;
180
+ provisioner: z.ZodPrefault<z.ZodObject<{
181
+ url: z.ZodDefault<z.ZodString>;
182
+ tokenSecret: z.ZodDefault<z.ZodString>;
183
+ timeoutMs: z.ZodDefault<z.ZodNumber>;
184
+ }, z.core.$strip>>;
123
185
  }, z.core.$strip>;
124
186
  /** ADR-077: секция `execution` — топология исполнения (параметр запуска). */
125
187
  export declare const executionConfigSchema: z.ZodObject<{
@@ -136,6 +198,82 @@ export declare const executionConfigSchema: z.ZodObject<{
136
198
  "inline-fallback": "inline-fallback";
137
199
  }>>;
138
200
  tokenSecret: z.ZodDefault<z.ZodString>;
201
+ pooling: z.ZodDefault<z.ZodEnum<{
202
+ project: "project";
203
+ session: "session";
204
+ instance: "instance";
205
+ }>>;
206
+ defaultProfile: z.ZodDefault<z.ZodString>;
207
+ browserProfile: z.ZodDefault<z.ZodString>;
208
+ browserProfiles: z.ZodDefault<z.ZodArray<z.ZodString>>;
209
+ browserMcpServer: z.ZodDefault<z.ZodString>;
210
+ browserTimeoutMs: z.ZodOptional<z.ZodNumber>;
211
+ profiles: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
212
+ url: z.ZodDefault<z.ZodArray<z.ZodString>>;
213
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
214
+ concurrency: z.ZodOptional<z.ZodNumber>;
215
+ failMode: z.ZodOptional<z.ZodEnum<{
216
+ fail: "fail";
217
+ "inline-fallback": "inline-fallback";
218
+ }>>;
219
+ description: z.ZodOptional<z.ZodString>;
220
+ image: z.ZodOptional<z.ZodString>;
221
+ network: z.ZodOptional<z.ZodEnum<{
222
+ none: "none";
223
+ restricted: "restricted";
224
+ full: "full";
225
+ }>>;
226
+ resources: z.ZodOptional<z.ZodObject<{
227
+ requests: z.ZodOptional<z.ZodObject<{
228
+ cpu: z.ZodOptional<z.ZodString>;
229
+ memory: z.ZodOptional<z.ZodString>;
230
+ ephemeralStorage: z.ZodOptional<z.ZodString>;
231
+ }, z.core.$catchall<z.ZodString>>>;
232
+ limits: z.ZodOptional<z.ZodObject<{
233
+ cpu: z.ZodOptional<z.ZodString>;
234
+ memory: z.ZodOptional<z.ZodString>;
235
+ ephemeralStorage: z.ZodOptional<z.ZodString>;
236
+ }, z.core.$catchall<z.ZodString>>>;
237
+ }, z.core.$strip>>;
238
+ annotations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
239
+ labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
240
+ nodeSelector: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
241
+ tolerations: z.ZodOptional<z.ZodArray<z.ZodObject<{
242
+ key: z.ZodOptional<z.ZodString>;
243
+ operator: z.ZodOptional<z.ZodEnum<{
244
+ Exists: "Exists";
245
+ Equal: "Equal";
246
+ }>>;
247
+ value: z.ZodOptional<z.ZodString>;
248
+ effect: z.ZodOptional<z.ZodEnum<{
249
+ NoSchedule: "NoSchedule";
250
+ PreferNoSchedule: "PreferNoSchedule";
251
+ NoExecute: "NoExecute";
252
+ }>>;
253
+ tolerationSeconds: z.ZodOptional<z.ZodNumber>;
254
+ }, z.core.$strict>>>;
255
+ affinity: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
256
+ runtimeClass: z.ZodOptional<z.ZodString>;
257
+ class: z.ZodOptional<z.ZodEnum<{
258
+ exec: "exec";
259
+ browser: "browser";
260
+ both: "both";
261
+ }>>;
262
+ mcpServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
263
+ }, z.core.$strip>>>;
264
+ fallback: z.ZodDefault<z.ZodEnum<{
265
+ instance: "instance";
266
+ fail: "fail";
267
+ }>>;
268
+ provider: z.ZodDefault<z.ZodEnum<{
269
+ static: "static";
270
+ http: "http";
271
+ }>>;
272
+ provisioner: z.ZodPrefault<z.ZodObject<{
273
+ url: z.ZodDefault<z.ZodString>;
274
+ tokenSecret: z.ZodDefault<z.ZodString>;
275
+ timeoutMs: z.ZodDefault<z.ZodNumber>;
276
+ }, z.core.$strip>>;
139
277
  }, z.core.$strip>>;
140
278
  }, z.core.$strip>;
141
279
  export declare const authConfigSchema: z.ZodObject<{
@@ -156,6 +294,10 @@ export declare const authConfigSchema: z.ZodObject<{
156
294
  clientSecret: z.ZodDefault<z.ZodString>;
157
295
  redirectUri: z.ZodDefault<z.ZodString>;
158
296
  cliClientId: z.ZodDefault<z.ZodString>;
297
+ groups: z.ZodOptional<z.ZodObject<{
298
+ claim: z.ZodDefault<z.ZodString>;
299
+ allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
300
+ }, z.core.$strip>>;
159
301
  }, z.core.$strip>>;
160
302
  }, z.core.$strip>;
161
303
  export declare const llmConfigSchema: z.ZodObject<{
@@ -301,9 +443,9 @@ export declare const mcpServerAuthSchema: z.ZodObject<{
301
443
  }, z.core.$strip>;
302
444
  export declare const mcpServerConfigSchema: z.ZodObject<{
303
445
  type: z.ZodEnum<{
446
+ http: "http";
304
447
  stdio: "stdio";
305
448
  sse: "sse";
306
- http: "http";
307
449
  }>;
308
450
  description: z.ZodOptional<z.ZodString>;
309
451
  command: z.ZodOptional<z.ZodString>;
@@ -335,9 +477,9 @@ export declare const mcpNetworkPolicySchema: z.ZodObject<{
335
477
  export declare const mcpConfigSchema: z.ZodObject<{
336
478
  servers: z.ZodPrefault<z.ZodRecord<z.ZodString, z.ZodObject<{
337
479
  type: z.ZodEnum<{
480
+ http: "http";
338
481
  stdio: "stdio";
339
482
  sse: "sse";
340
- http: "http";
341
483
  }>;
342
484
  description: z.ZodOptional<z.ZodString>;
343
485
  command: z.ZodOptional<z.ZodString>;
@@ -408,7 +550,7 @@ export declare const toolsConfigSchema: z.ZodObject<{
408
550
  outputMaxBytes: z.ZodDefault<z.ZodNumber>;
409
551
  }, z.core.$strip>;
410
552
  /**
411
- * ADR-046 §4.2/§4.4/§7.4: конфигурация механизма скиллов.
553
+ * ADR-126 §7/§4.4/§7.4: конфигурация механизма скиллов.
412
554
  * `paths` — дополнительные пользовательские каталоги; `trustedProjectDirs` —
413
555
  * доверенные проектные каталоги (бинарный trust); `inlineShell` — выключатель
414
556
  * `!`cmd`` в шаблонных командах (по умолчанию выключено).
@@ -419,7 +561,7 @@ export declare const toolsConfigSchema: z.ZodObject<{
419
561
  * попадают, тело не грузится). Установка/доверие/подписи/`lock.json` — PROP-068.
420
562
  *
421
563
  * Внешние локальные каталоги совместимости (`.opencode`, `.claude`, `.agents`,
422
- * `~/.config/opencode`) подключаются как read-only discovery в core (ADR-046 §4.2).
564
+ * `~/.config/opencode`) подключаются как read-only discovery в core (ADR-126 §7).
423
565
  */
424
566
  export declare const skillsConfigSchema: z.ZodObject<{
425
567
  paths: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -447,10 +589,11 @@ export declare const skillsConfigSchema: z.ZodObject<{
447
589
  models: "models";
448
590
  ssh: "ssh";
449
591
  todo: "todo";
592
+ terminal: "terminal";
450
593
  }>>>>;
451
594
  }, z.core.$strip>;
452
595
  /**
453
- * ADR-046 §7/§9.4: конфигурация slash-команд. `paths` — дополнительные каталоги
596
+ * ADR-126 §1/§9.4: конфигурация slash-команд. `paths` — дополнительные каталоги
454
597
  * шаблонных `.md`-команд; `bundlesPath` — подкаталог `{dataDir}` для YAML-бандлов;
455
598
  * `conflict` — режим разрешения конфликтов имён (см. resolver).
456
599
  */
@@ -468,6 +611,17 @@ export declare const commandsConfigSchema: z.ZodObject<{
468
611
  maxArgumentsLength: z.ZodDefault<z.ZodNumber>;
469
612
  maxRenderedBytes: z.ZodDefault<z.ZodNumber>;
470
613
  }, z.core.$strip>;
614
+ /**
615
+ * ADR-126 §5: конфигурация реестра скриптов проекта (`!`-запуск).
616
+ *
617
+ * `paths` — дополнительные каталоги-источники деклараций `.synth/scripts`.
618
+ * Приоритет источников: проект (`{project.workspace}/.synth/scripts`) >
619
+ * инстанс (`{dataDir}/scripts`) > `config.scripts.paths` — как у команд и
620
+ * скиллов (ADR-126 §9).
621
+ */
622
+ export declare const scriptsConfigSchema: z.ZodObject<{
623
+ paths: z.ZodPrefault<z.ZodArray<z.ZodString>>;
624
+ }, z.core.$strip>;
471
625
  /**
472
626
  * ADR-089: конфигурация приёма внешних событий.
473
627
  * - `enabled` — мастер-выключатель приёма событий;
@@ -744,6 +898,27 @@ export declare const backgroundConfigSchema: z.ZodObject<{
744
898
  logMaxBytes: z.ZodDefault<z.ZodNumber>;
745
899
  retentionDays: z.ZodDefault<z.ZodNumber>;
746
900
  }, z.core.$strip>;
901
+ /**
902
+ * Секция `recovery` — бюджет автовосстановления прерванных ходов после
903
+ * рестарта инстанса (PROP-142 §3).
904
+ *
905
+ * - `autoResume` — мастер-выключатель автовосстановления: при `false` инстанс
906
+ * не возобновляет прерванные ходы сам (деградация к «терминализировать»);
907
+ * - `maxAttempts` — максимум автовосстановлений **одного хода**: превышен →
908
+ * ход терминализируется (`failed`), владельцу уходит уведомление;
909
+ * - `crashLoop.windowMinutes` — окно детекта crash-loop (минуты);
910
+ * - `crashLoop.maxRestarts` — сколько рестартов в окне считаются crash-loop'ом.
911
+ *
912
+ * Решение владельца (2026-11-18): «попытки на ход + детект crash-loop».
913
+ */
914
+ export declare const recoveryConfigSchema: z.ZodObject<{
915
+ autoResume: z.ZodDefault<z.ZodBoolean>;
916
+ maxAttempts: z.ZodDefault<z.ZodNumber>;
917
+ crashLoop: z.ZodPrefault<z.ZodObject<{
918
+ windowMinutes: z.ZodDefault<z.ZodNumber>;
919
+ maxRestarts: z.ZodDefault<z.ZodNumber>;
920
+ }, z.core.$strip>>;
921
+ }, z.core.$strip>;
747
922
  /**
748
923
  * Дефолт предохранителя по объёму промпта саб-агента
749
924
  * (`agents.subagentMaxInputTokens`): `0` — **без ограничения** (паритет с
@@ -1104,6 +1279,58 @@ export type UpdatesConfig = z.infer<typeof updatesConfigSchema>;
1104
1279
  export declare const metricsConfigSchema: z.ZodObject<{
1105
1280
  enabled: z.ZodDefault<z.ZodBoolean>;
1106
1281
  }, z.core.$strip>;
1282
+ /**
1283
+ * PROP-132: конфигурация интерактивных терминалов.
1284
+ *
1285
+ * - `enabled` — мастер-выключатель терминального контура: `false` — весь
1286
+ * контур `/api/v2/terminals*` отвечает `403 TERMINALS_DISABLED`, живые
1287
+ * терминалы закрываются, новые не создаются.
1288
+ *
1289
+ * Флаг **необязателен** в схеме намеренно: «не задано в config.yaml» должно
1290
+ * отличаться от «явно задано `true`» — по этому различаются источники
1291
+ * значения в API (`config` против `default`). Само значение по умолчанию
1292
+ * (`enabled: true`) живёт в резолвере ядра (`DEFAULT_TERMINAL_ENABLED`).
1293
+ *
1294
+ * - `autoRestore` — восстанавливать ли терминалы после рестарта ядра из
1295
+ * снимков (`terminals/<id>/meta.json` + `terminals/<id>/output.txt` в
1296
+ * blob-хранилище, ADR-096/ADR-116): `false` — снимки не поднимаются, их
1297
+ * убирает reaper. По умолчанию `true` (`DEFAULT_TERMINAL_AUTO_RESTORE`).
1298
+ *
1299
+ * PROP-132 (параметры выполнения): секция описывает не только мастер-флаги, но
1300
+ * и **параметры выполнения** терминалов, редактируемые из админки:
1301
+ *
1302
+ * - `idleMinutes` — простой (минуты) до закрытия терминала; он же TTL
1303
+ * снимков. Границы 30…10080, дефолт `2880` (2 дня);
1304
+ * - `maxPerProject` — предел живых терминалов на проект. Границы 1…64,
1305
+ * дефолт `8`;
1306
+ * - `maxPerInstance` — предел живых терминалов на инстанс. Границы 1…256,
1307
+ * дефолт `32`;
1308
+ * - `shell` — имя программы или абсолютный путь оболочки терминала
1309
+ * (`^[A-Za-z0-9._/+-]{1,200}$`, без пробелов). **Не задано** —
1310
+ * платформенный дефолт (`$SHELL` → `/bin/bash`);
1311
+ * - `auditInput` — писать ли `terminal.input` в журнал исполнений команд
1312
+ * (ADR-136). Дефолт `true`.
1313
+ *
1314
+ * Все поля **необязательны** (без `.default()`): «не задано в config.yaml» ≠
1315
+ * «задано значение по умолчанию» — по этому различаются источники значения в
1316
+ * API (`config` против `default`). Сами дефолты, границы и нормализация живут в
1317
+ * резолвере ядра (`engine/terminal/config.ts`) — единственном источнике истины.
1318
+ *
1319
+ * Env-оверрайды — `SYNTH_TERMINAL_*` (`ENABLED`, `AUTO_RESTORE`,
1320
+ * `IDLE_MINUTES`, `MAX_PER_PROJECT`, `MAX_PER_INSTANCE`, `SHELL`,
1321
+ * `AUDIT_INPUT`; общее правило секций, ADR-023).
1322
+ */
1323
+ export declare const terminalConfigSchema: z.ZodObject<{
1324
+ enabled: z.ZodOptional<z.ZodBoolean>;
1325
+ autoRestore: z.ZodOptional<z.ZodBoolean>;
1326
+ idleMinutes: z.ZodOptional<z.ZodNumber>;
1327
+ maxPerProject: z.ZodOptional<z.ZodNumber>;
1328
+ maxPerInstance: z.ZodOptional<z.ZodNumber>;
1329
+ shell: z.ZodOptional<z.ZodString>;
1330
+ auditInput: z.ZodOptional<z.ZodBoolean>;
1331
+ }, z.core.$strip>;
1332
+ /** PROP-132: секция `terminal` — мастер-флаги и параметры выполнения. */
1333
+ export type TerminalConfig = z.infer<typeof terminalConfigSchema>;
1107
1334
  /**
1108
1335
  * ADR-052 (этап II): конфигурация исходящих webhooks.
1109
1336
  * - `enabled` — мастер-выключатель доставки (по умолчанию выключен);
@@ -1406,6 +1633,66 @@ export declare const securityTlsConfigSchema: z.ZodObject<{
1406
1633
  keyFile: z.ZodOptional<z.ZodString>;
1407
1634
  rejectUnauthorized: z.ZodOptional<z.ZodBoolean>;
1408
1635
  }, z.core.$strip>;
1636
+ /**
1637
+ * PROP-136: append-only аудит исполнений `execute_shell`/`sandbox_exec`.
1638
+ *
1639
+ * `enabled` — мастер-выключатель: выключен — журнал не пишется и команда не
1640
+ * блокируется; включён — **сбой записи блокирует выполнение** (запись `started`
1641
+ * делается до запуска). Профильный дефолт: backend/managed — включён,
1642
+ * standalone — выключен. Env:
1643
+ * `SYNTH_COMMAND_AUDIT_ENABLED`, `SYNTH_COMMAND_AUDIT_RETENTION_DAYS`
1644
+ * (читаются `resolveCommandAuditConfig` в core — приоритет env > config).
1645
+ *
1646
+ * `path` — путь журнала; пусто → `{dataDir}/audit/commands.jsonl`.
1647
+ */
1648
+ export declare const commandAuditConfigSchema: z.ZodObject<{
1649
+ enabled: z.ZodDefault<z.ZodBoolean>;
1650
+ retentionDays: z.ZodDefault<z.ZodNumber>;
1651
+ path: z.ZodDefault<z.ZodString>;
1652
+ }, z.core.$strip>;
1653
+ export type CommandAuditConfig = z.infer<typeof commandAuditConfigSchema>;
1654
+ /** PROP-136b: провайдер внешнего чекера команд (`off` — проверки нет). */
1655
+ export declare const COMMAND_POLICY_PROVIDERS: readonly ["http", "opa"];
1656
+ export type CommandPolicyProviderName = (typeof COMMAND_POLICY_PROVIDERS)[number];
1657
+ /** Поведение при недоступном чекере команд (PROP-136b). */
1658
+ export declare const COMMAND_POLICY_FAIL_MODES: readonly ["closed", "open"];
1659
+ export type CommandPolicyFailMode = (typeof COMMAND_POLICY_FAIL_MODES)[number];
1660
+ /**
1661
+ * PROP-136b (слайс 136b-2a): **зеркальный** внешний чекер команд в control
1662
+ * plane (`security.commandPolicy`).
1663
+ *
1664
+ * Точка принуждения — исполнитель (`command-policy.ts` пакета executor:
1665
+ * проверка до `spawn`). Здесь — ранний отказ/UX и запись вердикта в аудит
1666
+ * исполнений: тот же чекер судит текст команды, но решение **не** является
1667
+ * границей безопасности (её нет у control plane — команда исполняется на
1668
+ * исполнителе). `enabled: false` (дефолт) — поведение прежнее, провайдер не
1669
+ * создаётся.
1670
+ *
1671
+ * `tokenSecret` — **путь** к файлу bearer-токена (инвариант 13), не значение;
1672
+ * читается `readExecutorToken` при первом обращении. `failMode` по умолчанию
1673
+ * `open` (standalone), backend/managed поднимает до `closed` профильным
1674
+ * дефолтом. `enabled: true` без `url` — ошибка старта (fail-closed).
1675
+ *
1676
+ * Env (по общему правилу ADR-023, читаются `applyObjectEnvOverrides`):
1677
+ * `SYNTH_COMMAND_POLICY_ENABLED`, `_PROVIDER`, `_URL`, `_TOKEN`, `_FAIL_MODE`,
1678
+ * `_TIMEOUT_MS`, `_OPA_PATH`.
1679
+ */
1680
+ export declare const commandPolicyConfigSchema: z.ZodObject<{
1681
+ enabled: z.ZodDefault<z.ZodBoolean>;
1682
+ provider: z.ZodDefault<z.ZodEnum<{
1683
+ http: "http";
1684
+ opa: "opa";
1685
+ }>>;
1686
+ url: z.ZodDefault<z.ZodString>;
1687
+ tokenSecret: z.ZodDefault<z.ZodString>;
1688
+ failMode: z.ZodDefault<z.ZodEnum<{
1689
+ open: "open";
1690
+ closed: "closed";
1691
+ }>>;
1692
+ timeoutMs: z.ZodDefault<z.ZodNumber>;
1693
+ opaPath: z.ZodDefault<z.ZodString>;
1694
+ }, z.core.$strip>;
1695
+ export type CommandPolicyConfig = z.infer<typeof commandPolicyConfigSchema>;
1409
1696
  export declare const securityConfigSchema: z.ZodObject<{
1410
1697
  promptInjection: z.ZodPrefault<z.ZodObject<{
1411
1698
  enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1419,6 +1706,26 @@ export declare const securityConfigSchema: z.ZodObject<{
1419
1706
  protectedPaths: z.ZodPrefault<z.ZodObject<{
1420
1707
  enabled: z.ZodDefault<z.ZodBoolean>;
1421
1708
  }, z.core.$strip>>;
1709
+ commandAudit: z.ZodPrefault<z.ZodObject<{
1710
+ enabled: z.ZodDefault<z.ZodBoolean>;
1711
+ retentionDays: z.ZodDefault<z.ZodNumber>;
1712
+ path: z.ZodDefault<z.ZodString>;
1713
+ }, z.core.$strip>>;
1714
+ commandPolicy: z.ZodPrefault<z.ZodObject<{
1715
+ enabled: z.ZodDefault<z.ZodBoolean>;
1716
+ provider: z.ZodDefault<z.ZodEnum<{
1717
+ http: "http";
1718
+ opa: "opa";
1719
+ }>>;
1720
+ url: z.ZodDefault<z.ZodString>;
1721
+ tokenSecret: z.ZodDefault<z.ZodString>;
1722
+ failMode: z.ZodDefault<z.ZodEnum<{
1723
+ open: "open";
1724
+ closed: "closed";
1725
+ }>>;
1726
+ timeoutMs: z.ZodDefault<z.ZodNumber>;
1727
+ opaPath: z.ZodDefault<z.ZodString>;
1728
+ }, z.core.$strip>>;
1422
1729
  tls: z.ZodOptional<z.ZodObject<{
1423
1730
  caFile: z.ZodOptional<z.ZodString>;
1424
1731
  caPem: z.ZodOptional<z.ZodString>;
@@ -1541,8 +1848,8 @@ export declare const proxyRuleSchema: z.ZodObject<{
1541
1848
  export declare const proxyConfigSchema: z.ZodObject<{
1542
1849
  enabled: z.ZodOptional<z.ZodBoolean>;
1543
1850
  mode: z.ZodDefault<z.ZodEnum<{
1544
- all: "all";
1545
1851
  selected: "selected";
1852
+ all: "all";
1546
1853
  }>>;
1547
1854
  defaultProfile: z.ZodOptional<z.ZodString>;
1548
1855
  profiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -1806,6 +2113,82 @@ export declare const synthConfigSchema: z.ZodObject<{
1806
2113
  "inline-fallback": "inline-fallback";
1807
2114
  }>>;
1808
2115
  tokenSecret: z.ZodDefault<z.ZodString>;
2116
+ pooling: z.ZodDefault<z.ZodEnum<{
2117
+ project: "project";
2118
+ session: "session";
2119
+ instance: "instance";
2120
+ }>>;
2121
+ defaultProfile: z.ZodDefault<z.ZodString>;
2122
+ browserProfile: z.ZodDefault<z.ZodString>;
2123
+ browserProfiles: z.ZodDefault<z.ZodArray<z.ZodString>>;
2124
+ browserMcpServer: z.ZodDefault<z.ZodString>;
2125
+ browserTimeoutMs: z.ZodOptional<z.ZodNumber>;
2126
+ profiles: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
2127
+ url: z.ZodDefault<z.ZodArray<z.ZodString>>;
2128
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
2129
+ concurrency: z.ZodOptional<z.ZodNumber>;
2130
+ failMode: z.ZodOptional<z.ZodEnum<{
2131
+ fail: "fail";
2132
+ "inline-fallback": "inline-fallback";
2133
+ }>>;
2134
+ description: z.ZodOptional<z.ZodString>;
2135
+ image: z.ZodOptional<z.ZodString>;
2136
+ network: z.ZodOptional<z.ZodEnum<{
2137
+ none: "none";
2138
+ restricted: "restricted";
2139
+ full: "full";
2140
+ }>>;
2141
+ resources: z.ZodOptional<z.ZodObject<{
2142
+ requests: z.ZodOptional<z.ZodObject<{
2143
+ cpu: z.ZodOptional<z.ZodString>;
2144
+ memory: z.ZodOptional<z.ZodString>;
2145
+ ephemeralStorage: z.ZodOptional<z.ZodString>;
2146
+ }, z.core.$catchall<z.ZodString>>>;
2147
+ limits: z.ZodOptional<z.ZodObject<{
2148
+ cpu: z.ZodOptional<z.ZodString>;
2149
+ memory: z.ZodOptional<z.ZodString>;
2150
+ ephemeralStorage: z.ZodOptional<z.ZodString>;
2151
+ }, z.core.$catchall<z.ZodString>>>;
2152
+ }, z.core.$strip>>;
2153
+ annotations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
2154
+ labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
2155
+ nodeSelector: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
2156
+ tolerations: z.ZodOptional<z.ZodArray<z.ZodObject<{
2157
+ key: z.ZodOptional<z.ZodString>;
2158
+ operator: z.ZodOptional<z.ZodEnum<{
2159
+ Exists: "Exists";
2160
+ Equal: "Equal";
2161
+ }>>;
2162
+ value: z.ZodOptional<z.ZodString>;
2163
+ effect: z.ZodOptional<z.ZodEnum<{
2164
+ NoSchedule: "NoSchedule";
2165
+ PreferNoSchedule: "PreferNoSchedule";
2166
+ NoExecute: "NoExecute";
2167
+ }>>;
2168
+ tolerationSeconds: z.ZodOptional<z.ZodNumber>;
2169
+ }, z.core.$strict>>>;
2170
+ affinity: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2171
+ runtimeClass: z.ZodOptional<z.ZodString>;
2172
+ class: z.ZodOptional<z.ZodEnum<{
2173
+ exec: "exec";
2174
+ browser: "browser";
2175
+ both: "both";
2176
+ }>>;
2177
+ mcpServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
2178
+ }, z.core.$strip>>>;
2179
+ fallback: z.ZodDefault<z.ZodEnum<{
2180
+ instance: "instance";
2181
+ fail: "fail";
2182
+ }>>;
2183
+ provider: z.ZodDefault<z.ZodEnum<{
2184
+ static: "static";
2185
+ http: "http";
2186
+ }>>;
2187
+ provisioner: z.ZodPrefault<z.ZodObject<{
2188
+ url: z.ZodDefault<z.ZodString>;
2189
+ tokenSecret: z.ZodDefault<z.ZodString>;
2190
+ timeoutMs: z.ZodDefault<z.ZodNumber>;
2191
+ }, z.core.$strip>>;
1809
2192
  }, z.core.$strip>>;
1810
2193
  }, z.core.$strip>>;
1811
2194
  auth: z.ZodPrefault<z.ZodObject<{
@@ -1826,6 +2209,10 @@ export declare const synthConfigSchema: z.ZodObject<{
1826
2209
  clientSecret: z.ZodDefault<z.ZodString>;
1827
2210
  redirectUri: z.ZodDefault<z.ZodString>;
1828
2211
  cliClientId: z.ZodDefault<z.ZodString>;
2212
+ groups: z.ZodOptional<z.ZodObject<{
2213
+ claim: z.ZodDefault<z.ZodString>;
2214
+ allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
2215
+ }, z.core.$strip>>;
1829
2216
  }, z.core.$strip>>;
1830
2217
  }, z.core.$strip>>;
1831
2218
  llm: z.ZodPrefault<z.ZodObject<{
@@ -1935,9 +2322,9 @@ export declare const synthConfigSchema: z.ZodObject<{
1935
2322
  mcp: z.ZodPrefault<z.ZodObject<{
1936
2323
  servers: z.ZodPrefault<z.ZodRecord<z.ZodString, z.ZodObject<{
1937
2324
  type: z.ZodEnum<{
2325
+ http: "http";
1938
2326
  stdio: "stdio";
1939
2327
  sse: "sse";
1940
- http: "http";
1941
2328
  }>;
1942
2329
  description: z.ZodOptional<z.ZodString>;
1943
2330
  command: z.ZodOptional<z.ZodString>;
@@ -2009,6 +2396,7 @@ export declare const synthConfigSchema: z.ZodObject<{
2009
2396
  models: "models";
2010
2397
  ssh: "ssh";
2011
2398
  todo: "todo";
2399
+ terminal: "terminal";
2012
2400
  }>>>>;
2013
2401
  }, z.core.$strip>>;
2014
2402
  commands: z.ZodPrefault<z.ZodObject<{
@@ -2025,6 +2413,9 @@ export declare const synthConfigSchema: z.ZodObject<{
2025
2413
  maxArgumentsLength: z.ZodDefault<z.ZodNumber>;
2026
2414
  maxRenderedBytes: z.ZodDefault<z.ZodNumber>;
2027
2415
  }, z.core.$strip>>;
2416
+ scripts: z.ZodPrefault<z.ZodObject<{
2417
+ paths: z.ZodPrefault<z.ZodArray<z.ZodString>>;
2418
+ }, z.core.$strip>>;
2028
2419
  events: z.ZodPrefault<z.ZodObject<{
2029
2420
  enabled: z.ZodDefault<z.ZodBoolean>;
2030
2421
  defaultMode: z.ZodDefault<z.ZodEnum<{
@@ -2114,6 +2505,14 @@ export declare const synthConfigSchema: z.ZodObject<{
2114
2505
  logMaxBytes: z.ZodDefault<z.ZodNumber>;
2115
2506
  retentionDays: z.ZodDefault<z.ZodNumber>;
2116
2507
  }, z.core.$strip>>;
2508
+ recovery: z.ZodPrefault<z.ZodObject<{
2509
+ autoResume: z.ZodDefault<z.ZodBoolean>;
2510
+ maxAttempts: z.ZodDefault<z.ZodNumber>;
2511
+ crashLoop: z.ZodPrefault<z.ZodObject<{
2512
+ windowMinutes: z.ZodDefault<z.ZodNumber>;
2513
+ maxRestarts: z.ZodDefault<z.ZodNumber>;
2514
+ }, z.core.$strip>>;
2515
+ }, z.core.$strip>>;
2117
2516
  agents: z.ZodPrefault<z.ZodObject<{
2118
2517
  subagentMaxInputTokens: z.ZodDefault<z.ZodNumber>;
2119
2518
  subagentDepth: z.ZodDefault<z.ZodNumber>;
@@ -2188,6 +2587,15 @@ export declare const synthConfigSchema: z.ZodObject<{
2188
2587
  metrics: z.ZodPrefault<z.ZodObject<{
2189
2588
  enabled: z.ZodDefault<z.ZodBoolean>;
2190
2589
  }, z.core.$strip>>;
2590
+ terminal: z.ZodOptional<z.ZodObject<{
2591
+ enabled: z.ZodOptional<z.ZodBoolean>;
2592
+ autoRestore: z.ZodOptional<z.ZodBoolean>;
2593
+ idleMinutes: z.ZodOptional<z.ZodNumber>;
2594
+ maxPerProject: z.ZodOptional<z.ZodNumber>;
2595
+ maxPerInstance: z.ZodOptional<z.ZodNumber>;
2596
+ shell: z.ZodOptional<z.ZodString>;
2597
+ auditInput: z.ZodOptional<z.ZodBoolean>;
2598
+ }, z.core.$strip>>;
2191
2599
  updates: z.ZodPrefault<z.ZodObject<{
2192
2600
  check: z.ZodDefault<z.ZodBoolean>;
2193
2601
  channel: z.ZodDefault<z.ZodEnum<{
@@ -2361,8 +2769,8 @@ export declare const synthConfigSchema: z.ZodObject<{
2361
2769
  proxy: z.ZodPrefault<z.ZodObject<{
2362
2770
  enabled: z.ZodOptional<z.ZodBoolean>;
2363
2771
  mode: z.ZodDefault<z.ZodEnum<{
2364
- all: "all";
2365
2772
  selected: "selected";
2773
+ all: "all";
2366
2774
  }>>;
2367
2775
  defaultProfile: z.ZodOptional<z.ZodString>;
2368
2776
  profiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -2497,6 +2905,26 @@ export declare const synthConfigSchema: z.ZodObject<{
2497
2905
  protectedPaths: z.ZodPrefault<z.ZodObject<{
2498
2906
  enabled: z.ZodDefault<z.ZodBoolean>;
2499
2907
  }, z.core.$strip>>;
2908
+ commandAudit: z.ZodPrefault<z.ZodObject<{
2909
+ enabled: z.ZodDefault<z.ZodBoolean>;
2910
+ retentionDays: z.ZodDefault<z.ZodNumber>;
2911
+ path: z.ZodDefault<z.ZodString>;
2912
+ }, z.core.$strip>>;
2913
+ commandPolicy: z.ZodPrefault<z.ZodObject<{
2914
+ enabled: z.ZodDefault<z.ZodBoolean>;
2915
+ provider: z.ZodDefault<z.ZodEnum<{
2916
+ http: "http";
2917
+ opa: "opa";
2918
+ }>>;
2919
+ url: z.ZodDefault<z.ZodString>;
2920
+ tokenSecret: z.ZodDefault<z.ZodString>;
2921
+ failMode: z.ZodDefault<z.ZodEnum<{
2922
+ open: "open";
2923
+ closed: "closed";
2924
+ }>>;
2925
+ timeoutMs: z.ZodDefault<z.ZodNumber>;
2926
+ opaPath: z.ZodDefault<z.ZodString>;
2927
+ }, z.core.$strip>>;
2500
2928
  tls: z.ZodOptional<z.ZodObject<{
2501
2929
  caFile: z.ZodOptional<z.ZodString>;
2502
2930
  caPem: z.ZodOptional<z.ZodString>;
@@ -2543,6 +2971,8 @@ export type ToolsConfig = z.infer<typeof toolsConfigSchema>;
2543
2971
  export type ToolsDisabledConfig = z.infer<typeof toolsDisabledConfigSchema>;
2544
2972
  export type SkillsConfig = z.infer<typeof skillsConfigSchema>;
2545
2973
  export type CommandsConfig = z.infer<typeof commandsConfigSchema>;
2974
+ /** ADR-126 §5: секция `scripts` (каталоги-источники деклараций скриптов). */
2975
+ export type ScriptsConfig = z.infer<typeof scriptsConfigSchema>;
2546
2976
  export type EventsConfig = z.infer<typeof eventsConfigSchema>;
2547
2977
  export type SchedulerConfig = z.infer<typeof schedulerConfigSchema>;
2548
2978
  export type DecisionConfig = z.infer<typeof decisionConfigSchema>;
@@ -2559,6 +2989,8 @@ export type SshConfig = z.infer<typeof sshConfigSchema>;
2559
2989
  export type QuestionsConfig = z.infer<typeof questionsConfigSchema>;
2560
2990
  /** Этап 1 roadmap 0.13 (блок 4): секция `background` (реестр фоновых прогонов). */
2561
2991
  export type BackgroundConfig = z.infer<typeof backgroundConfigSchema>;
2992
+ /** PROP-142 §3: секция `recovery` (бюджет автовосстановления прерванных ходов). */
2993
+ export type RecoveryConfig = z.infer<typeof recoveryConfigSchema>;
2562
2994
  /** Секция `agents` — предохранители прогонов агентов. */
2563
2995
  export type AgentsConfig = z.infer<typeof agentsConfigSchema>;
2564
2996
  /** ADR-115: секция `attachments` (лимиты и политика вложений сообщений). */