@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
@@ -4,6 +4,13 @@ import { contextDefaultsSchema, createToolsDisabledSchema, globalRoleSchema, ser
4
4
  import { TOOLS_POLICIES, MCP_NETWORK_POLICY_MODES, COMMAND_CONFLICT_MODES, DEFAULT_MCP_PRIVATE_CIDRS, DEFAULT_MCP_NETWORK_POLICY, DEFAULT_EGRESS_TOOLS_POLICY, DEFAULT_EGRESS_WEBHOOKS_POLICY, DEFAULT_EGRESS_LOG, EGRESS_POLICY_MODES, WEBHOOKS_EGRESS_POLICY_MODES, DEFAULT_LLM_GATEWAY_RATE_LIMIT, DEFAULT_LLM_FILTER_TIMEOUT_MS, MIN_UPLOAD_BYTES, MAX_UPLOAD_BYTES_LIMIT, MIN_READ_BYTES, MAX_READ_BYTES_LIMIT, MIN_PREVIEW_BYTES, MAX_PREVIEW_BYTES_LIMIT, ToolCapability, } from '../types/index.js';
5
5
  import { catalogTrustLevelSchema } from '../types/trust.js';
6
6
  import { PLUGIN_HYBRID_MODES } from '../types/plugin-hybrid.js';
7
+ import { GlobalRole } from '../types/user.js';
8
+ // ADR-135: канонические перечисления секции `execution` — browser-safe
9
+ // (`types/execution.ts`), здесь импортируются для схемы конфигурации.
10
+ import { DEFAULT_EXECUTION_BROWSER_MCP_SERVER, DEFAULT_EXECUTION_BROWSER_PROFILE, DEFAULT_EXECUTION_PROVISIONER_TIMEOUT_MS, DEFAULT_EXECUTION_TIMEOUT_MS, EXECUTION_FAIL_MODES, EXECUTION_FALLBACKS, EXECUTION_MODES, EXECUTION_POOLINGS, EXECUTION_POOL_PROVIDERS, EXECUTION_PROFILE_NETWORKS, EXECUTION_PROFILE_CLASSES, MAX_EXECUTION_BROWSER_TIMEOUT_MS, executionAffinitySchema, executionAnnotationValueSchema, executionLabelValueSchema, executionPodKeySchema, executionResourceListSchema, executionTolerationSchema, } from '../types/execution.js';
11
+ // PROP-124: режимы инстанса для SSH-ключей (`ssh.mode`) — канонический список
12
+ // в типах (browser-safe), чтобы UI и ядро читали один источник.
13
+ import { SSH_MODES } from '../types/git.js';
7
14
  const toolCapabilityValues = Object.values(ToolCapability);
8
15
  // --- SynthConfig: единый конфиг для всех компонентов ---
9
16
  export const serverConfigSchema = z.object({
@@ -118,32 +125,19 @@ export const storageConfigSchema = z.object({
118
125
  });
119
126
  // --- Исполнение (ADR-077) ---
120
127
  /**
121
- * ADR-077: топология исполнения — переключатель запуска (`execution.mode`).
128
+ * ADR-077/ADR-135: канонические перечисления и константы секции `execution`
129
+ * живут в **browser-safe** модуле `types/execution.ts` — их читает и ядро, и
130
+ * UI (админка «Исполнение»). Здесь — реэкспорт (обратная совместимость
131
+ * импортов `@itphx/synth-shared/config`).
122
132
  *
123
- * - `inline` (дефолт) — исполнение в процессе backend'а (прежнее поведение,
124
- * all-in-one образ);
125
- * - `remote` — отдельные исполнители (`RemoteExecutionPort` + сервис-исполнитель,
126
- * шаг 7 плана ADR-077).
127
- *
128
- * Секция — **параметр запуска**, а не runtime-настройка: смена режима — только
129
- * рестартом процесса (инвариант 24 — process-глобальные решения не
130
- * переинициализируются на лету). Значение `mode` — **fail-closed**: неизвестное
131
- * явное значение (опечатка `inlne`) валит старт, а не молча выбирает дефолт
132
- * (как `storage.backend`).
133
- */
134
- export const EXECUTION_MODES = ['inline', 'remote'];
135
- /**
136
- * Поведение при недоступном исполнителе:
137
- * - `fail` (дефолт) — fail-closed: инструмент недоступен с явной причиной;
138
- * - `inline-fallback` — backend исполняет команду сам; **только явной настройкой**
139
- * (в managed-контуре это обход изоляции).
133
+ * Топология исполнения — переключатель запуска (`execution.mode`):
134
+ * `inline` (дефолт) — исполнение в процессе control plane; `remote` —
135
+ * отдельные исполнители (ADR-077). Секция — **параметр запуска**, а не
136
+ * runtime-настройка: смена режима — только рестартом процесса (инвариант 24).
137
+ * Значение `mode` — **fail-closed**: неизвестное явное значение (опечатка
138
+ * `inlne`) валит старт, а не молча выбирает дефолт (как `storage.backend`).
140
139
  */
141
- export const EXECUTION_FAIL_MODES = ['fail', 'inline-fallback'];
142
- /**
143
- * Таймаут exec-вызова по умолчанию (30 с — как у нынешних тулов: shell/search/git).
144
- * Больший лимит для shell (до 120 с) — свойство тула, не конфига.
145
- */
146
- export const DEFAULT_EXECUTION_TIMEOUT_MS = 30_000;
140
+ 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';
147
141
  /**
148
142
  * Параметры удалённого исполнителя (`execution.remote`).
149
143
  *
@@ -164,6 +158,125 @@ export const executionRemoteConfigSchema = z.object({
164
158
  failMode: z.enum(EXECUTION_FAIL_MODES).default('fail'),
165
159
  /** Путь/ссылка на токен исполнителя (НЕ значение — инвариант 13). */
166
160
  tokenSecret: z.string().default(''),
161
+ /**
162
+ * PROP-135 Ф4a: режим пула исполнителей. `instance` — общий порт на
163
+ * процесс (прежнее поведение); `project`/`session` — порт на профиль.
164
+ */
165
+ pooling: z.enum(EXECUTION_POOLINGS).default('instance'),
166
+ /** Имя профиля по умолчанию (каталог профилей задаёт ADMIN). */
167
+ defaultProfile: z.string().default('default'),
168
+ /**
169
+ * Имя профиля для пула класса `browser` (браузер — проектный пул со своим
170
+ * образом). Используется, когда цель вызова класс `browser` и профиль не
171
+ * задан явно; `defaultProfile` для браузера **не** применяется.
172
+ */
173
+ browserProfile: z.string().default(DEFAULT_EXECUTION_BROWSER_PROFILE),
174
+ /**
175
+ * PROP-135 (браузерный контур): явный каталог **браузерных** профилей.
176
+ *
177
+ * Имена из этого списка доступны только браузерному пулу (`class: 'browser'`)
178
+ * и **исключаются** из exec-каталога (`router.profiles()`); metadata-записи в
179
+ * `execution.remote.profiles` для них остаются (описание/сеть/mcpServers для
180
+ * details). Пусто — каталог равен `[browserProfile]` (обратная совместимость).
181
+ * Env — `SYNTH_EXECUTION_BROWSER_PROFILES` (csv).
182
+ */
183
+ browserProfiles: z.array(z.string()).default([]),
184
+ /**
185
+ * Имя MCP-сервера браузера в поде исполнителя (встроенные `browser_*`-тулы
186
+ * адресуют вызов этому серверу).
187
+ */
188
+ browserMcpServer: z.string().default(DEFAULT_EXECUTION_BROWSER_MCP_SERVER),
189
+ /**
190
+ * Таймаут одного вызова браузерного MCP-инструмента, мс.
191
+ *
192
+ * У тулов `browser_*` переопределяется параметром `timeout`; потолок —
193
+ * 600 000 мс (`MAX_EXECUTION_BROWSER_TIMEOUT_MS`). Не задан — дефолт
194
+ * 120 000 мс (`DEFAULT_EXECUTION_BROWSER_TIMEOUT_MS`).
195
+ */
196
+ browserTimeoutMs: z
197
+ .number()
198
+ .int()
199
+ .min(1)
200
+ .max(MAX_EXECUTION_BROWSER_TIMEOUT_MS)
201
+ .optional(),
202
+ /**
203
+ * Каталог профилей исполнения (PROP-135 Ф4a): имя → параметры профиля.
204
+ * Профиль **поверх** общих параметров: пустой `url` наследует
205
+ * `execution.remote.url`, незаданные `timeoutMs`/`concurrency`/`failMode` —
206
+ * общие значения секции.
207
+ */
208
+ profiles: z
209
+ .record(z.string(), z.object({
210
+ url: z.array(z.string()).default([]),
211
+ timeoutMs: z.number().int().min(1).optional(),
212
+ concurrency: z.number().int().min(1).optional(),
213
+ failMode: z.enum(EXECUTION_FAIL_MODES).optional(),
214
+ /**
215
+ * Метаданные профиля (для admin-API/UI): аддитивные поля, на
216
+ * маршрутизацию и создание портов **не** влияют.
217
+ */
218
+ description: z.string().max(500).optional(),
219
+ image: z.string().optional(),
220
+ network: z.enum(EXECUTION_PROFILE_NETWORKS).optional(),
221
+ resources: z
222
+ .object({
223
+ requests: executionResourceListSchema.optional(),
224
+ limits: executionResourceListSchema.optional(),
225
+ })
226
+ .optional(),
227
+ /**
228
+ * Произвольные аннотации пода (`metadata.annotations`); служебные
229
+ * `synth.io/*` приоритетнее.
230
+ */
231
+ annotations: z
232
+ .record(executionPodKeySchema, executionAnnotationValueSchema)
233
+ .optional(),
234
+ /** Пользовательские метки пода (`metadata.labels`). */
235
+ labels: z.record(executionPodKeySchema, executionLabelValueSchema).optional(),
236
+ /** `spec.nodeSelector` пода — отбор нод по меткам. */
237
+ nodeSelector: z.record(executionPodKeySchema, executionLabelValueSchema).optional(),
238
+ /** `spec.tolerations` пода — правила размещения на «tainted» нодах. */
239
+ tolerations: z.array(executionTolerationSchema).optional(),
240
+ /** `spec.affinity` пода — passthrough (JSON, ≤8 КиБ). */
241
+ affinity: executionAffinitySchema.optional(),
242
+ runtimeClass: z.string().optional(),
243
+ /**
244
+ * Класс профиля (ADR-135, аддендум §11): `exec` (дефолт) | `browser` |
245
+ * `both`. Профиль из legacy-списка `browserProfiles` получает
246
+ * эффективный класс `browser`, если класс не задан явно.
247
+ */
248
+ class: z.enum(EXECUTION_PROFILE_CLASSES).optional(),
249
+ /** **Только имена** MCP-серверов профиля (без команд/env). */
250
+ mcpServers: z.array(z.string()).optional(),
251
+ }))
252
+ .default({}),
253
+ /**
254
+ * Поведение роутера при непригодном профиле: `instance` — откат на
255
+ * instance-порт; `fail` — fail-closed (старт прерывается).
256
+ */
257
+ fallback: z.enum(EXECUTION_FALLBACKS).default('instance'),
258
+ /**
259
+ * Провайдер пулов исполнения (PROP-135 Ф4b-1): `static` — пулы из
260
+ * конфигурации (адреса профиля, порт на старте); `http` — пулы запрашиваются
261
+ * у provisioner'а (`execution.remote.provisioner.url`).
262
+ */
263
+ provider: z.enum(EXECUTION_POOL_PROVIDERS).default('static'),
264
+ /**
265
+ * Параметры provisioner'а пулов (PROP-135 Ф4b-1).
266
+ *
267
+ * - `url` — адрес provisioner'а; пусто при `provider: http` → **fail-closed**
268
+ * на старте (провайдер задан, но куда обращаться — не указано);
269
+ * - `tokenSecret` — **путь/ссылка** на токен provisioner'а, НЕ значение
270
+ * (инвариант 13);
271
+ * - `timeoutMs` — таймаут обращения к provisioner'у.
272
+ */
273
+ provisioner: z
274
+ .object({
275
+ url: z.string().default(''),
276
+ tokenSecret: z.string().default(''),
277
+ timeoutMs: z.number().int().min(1).default(DEFAULT_EXECUTION_PROVISIONER_TIMEOUT_MS),
278
+ })
279
+ .prefault({}),
167
280
  });
168
281
  /** ADR-077: секция `execution` — топология исполнения (параметр запуска). */
169
282
  export const executionConfigSchema = z.object({
@@ -173,6 +286,12 @@ export const executionConfigSchema = z.object({
173
286
  export const authConfigSchema = z.object({
174
287
  debugMode: z.boolean().default(false),
175
288
  apiKey: z.string().optional(),
289
+ /**
290
+ * Роли пользователя единого API-ключа (`auth.apiKey`, вне debug/OIDC).
291
+ * Дефолт — `USER`: права ADMIN не выдаются по факту наличия ключа, только
292
+ * явной настройкой (fail-closed). Env — `SYNTH_API_KEY_ROLES` (csv).
293
+ */
294
+ apiKeyRoles: z.array(globalRoleSchema).default([GlobalRole.USER]),
176
295
  testUsers: z
177
296
  .array(z.object({
178
297
  username: z.string(),
@@ -191,6 +310,17 @@ export const authConfigSchema = z.object({
191
310
  redirectUri: z.string().default('http://localhost:5002/auth/callback'),
192
311
  /** Public client_id для локального CLI/core (ROPC/device flow). Не секрет. */
193
312
  cliClientId: z.string().default('synth-cli'),
313
+ /**
314
+ * ADR-140: источник групп пользователя — claim IdP + allowlist имён.
315
+ * Секция опциональна (старые конфиги без неё валидны); пустой allowlist —
316
+ * групп нет (fail-closed).
317
+ */
318
+ groups: z
319
+ .object({
320
+ claim: z.string().min(1).default('groups'),
321
+ allow: z.array(z.string().min(1)).default([]),
322
+ })
323
+ .optional(),
194
324
  })
195
325
  .optional(),
196
326
  });
@@ -396,9 +526,9 @@ export const toolsConfigSchema = z.object({
396
526
  */
397
527
  outputMaxBytes: z.number().int().min(1).default(DEFAULT_TOOL_OUTPUT_MAX_BYTES),
398
528
  });
399
- // --- Скиллы (ADR-046) ---
529
+ // --- Скиллы (ADR-126) ---
400
530
  /**
401
- * ADR-046 §4.2/§4.4/§7.4: конфигурация механизма скиллов.
531
+ * ADR-126 §7/§4.4/§7.4: конфигурация механизма скиллов.
402
532
  * `paths` — дополнительные пользовательские каталоги; `trustedProjectDirs` —
403
533
  * доверенные проектные каталоги (бинарный trust); `inlineShell` — выключатель
404
534
  * `!`cmd`` в шаблонных командах (по умолчанию выключено).
@@ -409,24 +539,24 @@ export const toolsConfigSchema = z.object({
409
539
  * попадают, тело не грузится). Установка/доверие/подписи/`lock.json` — PROP-068.
410
540
  *
411
541
  * Внешние локальные каталоги совместимости (`.opencode`, `.claude`, `.agents`,
412
- * `~/.config/opencode`) подключаются как read-only discovery в core (ADR-046 §4.2).
542
+ * `~/.config/opencode`) подключаются как read-only discovery в core (ADR-126 §7).
413
543
  */
414
544
  export const skillsConfigSchema = z.object({
415
545
  paths: z.array(z.string()).default([]),
416
- /** ADR-046 §4.2/§4.3: удалённые каталоги — read-only индексация (`trusted: false`). */
546
+ /** ADR-126 §7/§4.3: удалённые каталоги — read-only индексация (`trusted: false`). */
417
547
  urls: z.array(z.string()).default([]),
418
548
  trustedProjectDirs: z.array(z.string()).default([]),
419
549
  inlineShell: z.boolean().default(false),
420
550
  /**
421
- * ADR-046 §3.2/§12: именованные группы тулов → capabilities. Используется
551
+ * ADR-126 §13/§12: именованные группы тулов → capabilities. Используется
422
552
  * для экспансии `metadata.synth.requires_toolsets` в проверку доступности
423
553
  * скилла (union с `requires_capabilities`).
424
554
  */
425
555
  toolsets: z.record(z.string(), z.array(z.enum(toolCapabilityValues))).prefault({}),
426
556
  });
427
- // --- Slash-команды (ADR-046 §7) ---
557
+ // --- Slash-команды (ADR-126 §1) ---
428
558
  /**
429
- * ADR-046 §7/§9.4: конфигурация slash-команд. `paths` — дополнительные каталоги
559
+ * ADR-126 §1/§9.4: конфигурация slash-команд. `paths` — дополнительные каталоги
430
560
  * шаблонных `.md`-команд; `bundlesPath` — подкаталог `{dataDir}` для YAML-бандлов;
431
561
  * `conflict` — режим разрешения конфликтов имён (см. resolver).
432
562
  */
@@ -442,6 +572,18 @@ export const commandsConfigSchema = z.object({
442
572
  maxArgumentsLength: z.number().int().min(1).default(10_000),
443
573
  maxRenderedBytes: z.number().int().min(1).default(200_000),
444
574
  });
575
+ // --- Скрипты проекта (ADR-126 §5) ---
576
+ /**
577
+ * ADR-126 §5: конфигурация реестра скриптов проекта (`!`-запуск).
578
+ *
579
+ * `paths` — дополнительные каталоги-источники деклараций `.synth/scripts`.
580
+ * Приоритет источников: проект (`{project.workspace}/.synth/scripts`) >
581
+ * инстанс (`{dataDir}/scripts`) > `config.scripts.paths` — как у команд и
582
+ * скиллов (ADR-126 §9).
583
+ */
584
+ export const scriptsConfigSchema = z.object({
585
+ paths: z.array(z.string()).prefault([]),
586
+ });
445
587
  // --- Внешние события (ADR-089) ---
446
588
  /**
447
589
  * ADR-089: конфигурация приёма внешних событий.
@@ -657,6 +799,23 @@ export const gitConfigSchema = z.object({
657
799
  localTimeoutMs: z.number().int().min(0).default(120_000),
658
800
  networkTimeoutMs: z.number().int().min(0).default(300_000),
659
801
  });
802
+ // --- SSH-доступ агента (PROP-124) ---
803
+ /**
804
+ * PROP-124: режим работы инстанса с SSH-ключами.
805
+ *
806
+ * - `tools` — ключ попадает к потребителю через argv адресных тулов (`-i` на
807
+ * время вызова); политика хостов/портов на ключе обязательна;
808
+ * - `agent` — ключ выдаётся через эфемерный `ssh-agent` на время вызова
809
+ * (`SSH_AUTH_SOCK`); фильтрация по хостам не применяется, ограничение —
810
+ * на стороне хоста (`authorized_keys`).
811
+ *
812
+ * Дефолт — **`tools`** (fail-closed: без явного выбора ключ в окружение
813
+ * команд не попадает). Переключение режима — runtime-настройка инстанса
814
+ * (`/api/v2/settings/ssh`), применяется без рестарта.
815
+ */
816
+ export const sshConfigSchema = z.object({
817
+ mode: z.enum(SSH_MODES).default('tools'),
818
+ });
660
819
  // --- Вопросы пользователю (этап 1 roadmap 0.13 — блок 3) ---
661
820
  /**
662
821
  * Конфигурация подсистемы «вопрос пользователю» (`ask_user`).
@@ -699,6 +858,28 @@ export const backgroundConfigSchema = z.object({
699
858
  logMaxBytes: z.number().int().min(0).default(10_485_760),
700
859
  retentionDays: z.number().int().default(7),
701
860
  });
861
+ // --- Автовосстановление прерванных ходов (PROP-142 §3) ---
862
+ /**
863
+ * Секция `recovery` — бюджет автовосстановления прерванных ходов после
864
+ * рестарта инстанса (PROP-142 §3).
865
+ *
866
+ * - `autoResume` — мастер-выключатель автовосстановления: при `false` инстанс
867
+ * не возобновляет прерванные ходы сам (деградация к «терминализировать»);
868
+ * - `maxAttempts` — максимум автовосстановлений **одного хода**: превышен →
869
+ * ход терминализируется (`failed`), владельцу уходит уведомление;
870
+ * - `crashLoop.windowMinutes` — окно детекта crash-loop (минуты);
871
+ * - `crashLoop.maxRestarts` — сколько рестартов в окне считаются crash-loop'ом.
872
+ *
873
+ * Решение владельца (2026-11-18): «попытки на ход + детект crash-loop».
874
+ */
875
+ export const recoveryConfigSchema = z.object({
876
+ autoResume: z.boolean().default(true),
877
+ maxAttempts: z.number().int().min(1).default(3),
878
+ crashLoop: z.object({
879
+ windowMinutes: z.number().int().min(1).default(10),
880
+ maxRestarts: z.number().int().min(1).default(3),
881
+ }).prefault({}),
882
+ });
702
883
  // --- Агенты: предохранители прогонов ---
703
884
  /**
704
885
  * Дефолт предохранителя по объёму промпта саб-агента
@@ -732,6 +913,22 @@ export const agentsConfigSchema = z.object({
732
913
  subagentMaxInputTokens: z.number().int().min(0).default(DEFAULT_SUBAGENT_MAX_INPUT_TOKENS),
733
914
  subagentDepth: z.number().int().min(0).default(DEFAULT_SUBAGENT_DEPTH),
734
915
  });
916
+ // --- Лимиты тяжёлых операций с сессиями ---
917
+ /**
918
+ * Дефолт лимита тяжёлых операций с сессиями (import/export/fork/merge) в
919
+ * минуту на креду: 10. `0` — **без ограничения**.
920
+ */
921
+ export const DEFAULT_SESSION_OPS_PER_MINUTE = 10;
922
+ /**
923
+ * Секция `limits` — instance-wide лимиты тяжёлых операций.
924
+ *
925
+ * - `sessionOpsPerMinute` — число тяжёлых операций с сессиями (import/export/
926
+ * fork/merge) в минуту на креду. Применяется ко всем четырём операциям;
927
+ * `0` — без ограничения.
928
+ */
929
+ export const limitsConfigSchema = z.object({
930
+ sessionOpsPerMinute: z.number().int().min(0).default(DEFAULT_SESSION_OPS_PER_MINUTE),
931
+ });
735
932
  // --- Authority-слой (ADR-106) ---
736
933
  /**
737
934
  * ADR-106 Ф1: конфигурация Authority-слоя.
@@ -945,6 +1142,33 @@ export const attachmentsConfigSchema = z.object({
945
1142
  */
946
1143
  maxActiveUploads: z.number().int().min(1).default(256),
947
1144
  });
1145
+ // --- Обновления пакета (ADR-133) ---
1146
+ /**
1147
+ * ADR-133: канал обновлений — значение настройки `updates.channel`.
1148
+ *
1149
+ * - `auto` (дефолт) — канал выводится из установленной версии: `-beta.` в
1150
+ * `SYNTH_VERSION` ⇒ `beta`, иначе `stable` (файл-маркер не заводится);
1151
+ * - `stable`/`beta` — явный override (в т.ч. для смены канала вручную).
1152
+ */
1153
+ export const UPDATE_CHANNEL_CHOICES = ['auto', 'stable', 'beta'];
1154
+ /**
1155
+ * ADR-133: секция `updates` — каналы и проверка обновлений.
1156
+ *
1157
+ * - `check` — автопроверка обновлений в фоне (**по умолчанию выключена**:
1158
+ * офлайн-инстансы не должны шуметь запросами к реестрам);
1159
+ * - `channel` — `auto` (по установленной версии) | `stable` | `beta`;
1160
+ * - `intervalHours` — TTL успешной проверки, часы (ошибка кэшируется на 1 ч);
1161
+ * - `stableRegistry` — реестр стабильного канала (`latest`);
1162
+ * - `betaRegistry` — реестр бета-канала (`beta`; Gitea читается без токена,
1163
+ * токен нужен только публикации).
1164
+ */
1165
+ export const updatesConfigSchema = z.object({
1166
+ check: z.boolean().default(false),
1167
+ channel: z.enum(['auto', 'stable', 'beta']).default('auto'),
1168
+ intervalHours: z.number().int().min(1).default(24),
1169
+ stableRegistry: z.string().default('https://registry.npmjs.org'),
1170
+ betaRegistry: z.string().default('https://git.itphx.ru/api/packages/itphx/npm/'),
1171
+ });
948
1172
  // --- Наблюдаемость: Prometheus-метрики (ADR-094) ---
949
1173
  /**
950
1174
  * ADR-094: конфигурация экспорта метрик.
@@ -958,6 +1182,60 @@ export const attachmentsConfigSchema = z.object({
958
1182
  export const metricsConfigSchema = z.object({
959
1183
  enabled: z.boolean().default(false),
960
1184
  });
1185
+ // --- Терминалы (PROP-132) ---
1186
+ /**
1187
+ * PROP-132: конфигурация интерактивных терминалов.
1188
+ *
1189
+ * - `enabled` — мастер-выключатель терминального контура: `false` — весь
1190
+ * контур `/api/v2/terminals*` отвечает `403 TERMINALS_DISABLED`, живые
1191
+ * терминалы закрываются, новые не создаются.
1192
+ *
1193
+ * Флаг **необязателен** в схеме намеренно: «не задано в config.yaml» должно
1194
+ * отличаться от «явно задано `true`» — по этому различаются источники
1195
+ * значения в API (`config` против `default`). Само значение по умолчанию
1196
+ * (`enabled: true`) живёт в резолвере ядра (`DEFAULT_TERMINAL_ENABLED`).
1197
+ *
1198
+ * - `autoRestore` — восстанавливать ли терминалы после рестарта ядра из
1199
+ * снимков (`terminals/<id>/meta.json` + `terminals/<id>/output.txt` в
1200
+ * blob-хранилище, ADR-096/ADR-116): `false` — снимки не поднимаются, их
1201
+ * убирает reaper. По умолчанию `true` (`DEFAULT_TERMINAL_AUTO_RESTORE`).
1202
+ *
1203
+ * PROP-132 (параметры выполнения): секция описывает не только мастер-флаги, но
1204
+ * и **параметры выполнения** терминалов, редактируемые из админки:
1205
+ *
1206
+ * - `idleMinutes` — простой (минуты) до закрытия терминала; он же TTL
1207
+ * снимков. Границы 30…10080, дефолт `2880` (2 дня);
1208
+ * - `maxPerProject` — предел живых терминалов на проект. Границы 1…64,
1209
+ * дефолт `8`;
1210
+ * - `maxPerInstance` — предел живых терминалов на инстанс. Границы 1…256,
1211
+ * дефолт `32`;
1212
+ * - `shell` — имя программы или абсолютный путь оболочки терминала
1213
+ * (`^[A-Za-z0-9._/+-]{1,200}$`, без пробелов). **Не задано** —
1214
+ * платформенный дефолт (`$SHELL` → `/bin/bash`);
1215
+ * - `auditInput` — писать ли `terminal.input` в журнал исполнений команд
1216
+ * (ADR-136). Дефолт `true`.
1217
+ *
1218
+ * Все поля **необязательны** (без `.default()`): «не задано в config.yaml» ≠
1219
+ * «задано значение по умолчанию» — по этому различаются источники значения в
1220
+ * API (`config` против `default`). Сами дефолты, границы и нормализация живут в
1221
+ * резолвере ядра (`engine/terminal/config.ts`) — единственном источнике истины.
1222
+ *
1223
+ * Env-оверрайды — `SYNTH_TERMINAL_*` (`ENABLED`, `AUTO_RESTORE`,
1224
+ * `IDLE_MINUTES`, `MAX_PER_PROJECT`, `MAX_PER_INSTANCE`, `SHELL`,
1225
+ * `AUDIT_INPUT`; общее правило секций, ADR-023).
1226
+ */
1227
+ export const terminalConfigSchema = z.object({
1228
+ enabled: z.boolean().optional(),
1229
+ autoRestore: z.boolean().optional(),
1230
+ idleMinutes: z.number().int().min(30).max(10080).optional(),
1231
+ maxPerProject: z.number().int().min(1).max(64).optional(),
1232
+ maxPerInstance: z.number().int().min(1).max(256).optional(),
1233
+ shell: z
1234
+ .string()
1235
+ .regex(/^[A-Za-z0-9._/+-]{1,200}$/, 'terminal.shell: ожидается имя программы или абсолютный путь без пробелов (допустимы A-Za-z0-9._/+-), 1…200 символов')
1236
+ .optional(),
1237
+ auditInput: z.boolean().optional(),
1238
+ });
961
1239
  // --- Webhooks (ADR-052, этап II) ---
962
1240
  /**
963
1241
  * ADR-052 (этап II): конфигурация исходящих webhooks.
@@ -1246,9 +1524,79 @@ export const securityTlsConfigSchema = z.object({
1246
1524
  /** Проверять сертификат сервера (по умолчанию `true`). */
1247
1525
  rejectUnauthorized: z.boolean().optional(),
1248
1526
  });
1527
+ /**
1528
+ * PROP-136: append-only аудит исполнений `execute_shell`/`sandbox_exec`.
1529
+ *
1530
+ * `enabled` — мастер-выключатель: выключен — журнал не пишется и команда не
1531
+ * блокируется; включён — **сбой записи блокирует выполнение** (запись `started`
1532
+ * делается до запуска). Профильный дефолт: backend/managed — включён,
1533
+ * standalone — выключен. Env:
1534
+ * `SYNTH_COMMAND_AUDIT_ENABLED`, `SYNTH_COMMAND_AUDIT_RETENTION_DAYS`
1535
+ * (читаются `resolveCommandAuditConfig` в core — приоритет env > config).
1536
+ *
1537
+ * `path` — путь журнала; пусто → `{dataDir}/audit/commands.jsonl`.
1538
+ */
1539
+ export const commandAuditConfigSchema = z.object({
1540
+ enabled: z.boolean().default(false),
1541
+ /** Срок хранения журнала, дней (`prune`); `<= 0` — без ограничения. */
1542
+ retentionDays: z.number().int().default(30),
1543
+ /** Путь журнала (пусто — `{dataDir}/audit/commands.jsonl`). */
1544
+ path: z.string().default(''),
1545
+ });
1546
+ /** PROP-136b: провайдер внешнего чекера команд (`off` — проверки нет). */
1547
+ export const COMMAND_POLICY_PROVIDERS = ['http', 'opa'];
1548
+ /** Поведение при недоступном чекере команд (PROP-136b). */
1549
+ export const COMMAND_POLICY_FAIL_MODES = ['closed', 'open'];
1550
+ /**
1551
+ * PROP-136b (слайс 136b-2a): **зеркальный** внешний чекер команд в control
1552
+ * plane (`security.commandPolicy`).
1553
+ *
1554
+ * Точка принуждения — исполнитель (`command-policy.ts` пакета executor:
1555
+ * проверка до `spawn`). Здесь — ранний отказ/UX и запись вердикта в аудит
1556
+ * исполнений: тот же чекер судит текст команды, но решение **не** является
1557
+ * границей безопасности (её нет у control plane — команда исполняется на
1558
+ * исполнителе). `enabled: false` (дефолт) — поведение прежнее, провайдер не
1559
+ * создаётся.
1560
+ *
1561
+ * `tokenSecret` — **путь** к файлу bearer-токена (инвариант 13), не значение;
1562
+ * читается `readExecutorToken` при первом обращении. `failMode` по умолчанию
1563
+ * `open` (standalone), backend/managed поднимает до `closed` профильным
1564
+ * дефолтом. `enabled: true` без `url` — ошибка старта (fail-closed).
1565
+ *
1566
+ * Env (по общему правилу ADR-023, читаются `applyObjectEnvOverrides`):
1567
+ * `SYNTH_COMMAND_POLICY_ENABLED`, `_PROVIDER`, `_URL`, `_TOKEN`, `_FAIL_MODE`,
1568
+ * `_TIMEOUT_MS`, `_OPA_PATH`.
1569
+ */
1570
+ export const commandPolicyConfigSchema = z
1571
+ .object({
1572
+ enabled: z.boolean().default(false),
1573
+ provider: z.enum(COMMAND_POLICY_PROVIDERS).default('http'),
1574
+ /** Адрес чекера (обязателен при `enabled: true`). */
1575
+ url: z.string().default(''),
1576
+ /** Путь к файлу bearer-токена чекера (не значение). */
1577
+ tokenSecret: z.string().default(''),
1578
+ failMode: z.enum(COMMAND_POLICY_FAIL_MODES).default('open'),
1579
+ /** Таймаут запроса к чекеру, мс. */
1580
+ timeoutMs: z.number().int().min(1).default(2_000),
1581
+ /** Путь OPA-решения (`provider: opa`). */
1582
+ opaPath: z.string().default('/v1/data/synth/exec/decision'),
1583
+ })
1584
+ .superRefine((cfg, ctx) => {
1585
+ if (cfg.enabled && cfg.url.trim() === '') {
1586
+ ctx.addIssue({
1587
+ code: z.ZodIssueCode.custom,
1588
+ path: ['url'],
1589
+ message: 'security.commandPolicy.url обязателен при enabled: true (fail-closed)',
1590
+ });
1591
+ }
1592
+ });
1249
1593
  export const securityConfigSchema = z.object({
1250
1594
  promptInjection: promptInjectionConfigSchema.prefault({}),
1251
1595
  protectedPaths: protectedPathsConfigSchema.prefault({}),
1596
+ /** PROP-136: журнал исполнений shell/песочных команд. */
1597
+ commandAudit: commandAuditConfigSchema.prefault({}),
1598
+ /** PROP-136b: зеркальный внешний чекер команд (опционален; выключен — прежнее поведение). */
1599
+ commandPolicy: commandPolicyConfigSchema.prefault({}),
1252
1600
  /** ADR-099: единый механизм доверия TLS/CA для исходящих соединений. */
1253
1601
  tls: securityTlsConfigSchema.optional(),
1254
1602
  /**
@@ -1381,8 +1729,8 @@ export const llmGatewayAuditConfigSchema = z.object({
1381
1729
  logPath: z.string().default(''), // по умолчанию {dataDir}/audit/llm-gateway.jsonl
1382
1730
  });
1383
1731
  export const llmGatewayConfigSchema = z.object({
1384
- /** Глобальный выключатель LLM Gateway. */
1385
- enabled: z.boolean().default(false),
1732
+ /** Глобальный выключатель LLM Gateway (ADR-147: единый дефолт — включён). */
1733
+ enabled: z.boolean().default(true),
1386
1734
  /** Режим Input Guard: obfuscate (замена на плейсхолдер) | block (запрос блокируется). */
1387
1735
  inputMode: z.enum(['obfuscate', 'block']).default('obfuscate'),
1388
1736
  /** Полное логирование запросов и ответов LLM (после обфускации) в JSONL. */
@@ -1495,17 +1843,26 @@ export const synthConfigSchema = z.object({
1495
1843
  tools: toolsConfigSchema.prefault({}),
1496
1844
  skills: skillsConfigSchema.prefault({}),
1497
1845
  commands: commandsConfigSchema.prefault({}),
1846
+ scripts: scriptsConfigSchema.prefault({}),
1498
1847
  events: eventsConfigSchema.prefault({}),
1499
1848
  scheduler: schedulerConfigSchema.prefault({}),
1500
1849
  decision: decisionConfigSchema.prefault({}),
1501
1850
  oauth: oauthConfigSchema.prefault({}),
1502
1851
  analytics: analyticsConfigSchema.prefault({}),
1503
1852
  git: gitConfigSchema.prefault({}),
1853
+ ssh: sshConfigSchema.prefault({}),
1504
1854
  questions: questionsConfigSchema.prefault({}),
1505
1855
  background: backgroundConfigSchema.prefault({}),
1856
+ recovery: recoveryConfigSchema.prefault({}),
1506
1857
  agents: agentsConfigSchema.prefault({}),
1858
+ limits: limitsConfigSchema.prefault({}),
1507
1859
  attachments: attachmentsConfigSchema.prefault({}),
1508
1860
  metrics: metricsConfigSchema.prefault({}),
1861
+ // PROP-132: секция `terminal` — мастер-выключатель терминалов. Секция
1862
+ // необязательна: отсутствие = «не задано в config.yaml» (дефолт `enabled:
1863
+ // true` живёт в резолвере ядра).
1864
+ terminal: terminalConfigSchema.optional(),
1865
+ updates: updatesConfigSchema.prefault({}),
1509
1866
  authority: authorityConfigSchema.prefault({}),
1510
1867
  plugins: pluginsConfigSchema.prefault({}),
1511
1868
  egress: egressConfigSchema.prefault({}),