@itphx/synth-shared 0.10.1 → 0.12.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (104) hide show
  1. package/dist/config/defaults.js +172 -3
  2. package/dist/config/env-overrides.d.ts +33 -1
  3. package/dist/config/env-overrides.js +191 -5
  4. package/dist/config/execution.d.ts +66 -0
  5. package/dist/config/execution.js +146 -0
  6. package/dist/config/index.d.ts +4 -0
  7. package/dist/config/index.js +4 -0
  8. package/dist/config/loader.js +19 -0
  9. package/dist/config/proxy.d.ts +415 -0
  10. package/dist/config/proxy.js +1567 -0
  11. package/dist/config/resolve.d.ts +67 -0
  12. package/dist/config/resolve.js +187 -1
  13. package/dist/config/tls-runtime.d.ts +78 -0
  14. package/dist/config/tls-runtime.js +356 -0
  15. package/dist/config/tls.d.ts +215 -0
  16. package/dist/config/tls.js +394 -0
  17. package/dist/config/types.d.ts +1571 -2835
  18. package/dist/config/types.js +717 -58
  19. package/dist/i18n/index.d.ts +1 -1
  20. package/dist/i18n/index.js +279 -0
  21. package/dist/index.d.ts +24 -3
  22. package/dist/index.js +25 -2
  23. package/dist/model-metadata.d.ts +10 -0
  24. package/dist/protocols/index.d.ts +0 -1
  25. package/dist/schemas/index.d.ts +1014 -2231
  26. package/dist/schemas/index.js +222 -14
  27. package/dist/types/analytics.d.ts +113 -0
  28. package/dist/types/analytics.js +61 -0
  29. package/dist/types/authority.d.ts +464 -0
  30. package/dist/types/authority.js +445 -0
  31. package/dist/types/background.d.ts +96 -0
  32. package/dist/types/background.js +24 -0
  33. package/dist/types/bus-events.d.ts +23 -1
  34. package/dist/types/catalog.d.ts +349 -0
  35. package/dist/types/catalog.js +393 -0
  36. package/dist/types/decision.d.ts +28 -337
  37. package/dist/types/egress.d.ts +114 -0
  38. package/dist/types/egress.js +68 -0
  39. package/dist/types/events.d.ts +54 -2
  40. package/dist/types/external-credentials.d.ts +352 -0
  41. package/dist/types/external-credentials.js +200 -0
  42. package/dist/types/fs.d.ts +11 -0
  43. package/dist/types/fs.js +11 -0
  44. package/dist/types/hooks.d.ts +50 -9
  45. package/dist/types/index.d.ts +23 -0
  46. package/dist/types/index.js +55 -0
  47. package/dist/types/llm-filters.d.ts +150 -0
  48. package/dist/types/llm-filters.js +54 -0
  49. package/dist/types/maintenance.d.ts +39 -0
  50. package/dist/types/maintenance.js +11 -0
  51. package/dist/types/mcp.d.ts +101 -5
  52. package/dist/types/mcp.js +127 -5
  53. package/dist/types/message.d.ts +45 -1
  54. package/dist/types/pack.d.ts +1102 -0
  55. package/dist/types/pack.js +1003 -0
  56. package/dist/types/permission.d.ts +31 -15
  57. package/dist/types/permission.js +1 -1
  58. package/dist/types/pipeline-engine.d.ts +453 -0
  59. package/dist/types/pipeline-engine.js +440 -0
  60. package/dist/types/pipeline.d.ts +275 -0
  61. package/dist/types/pipeline.js +212 -0
  62. package/dist/types/plugin-audit.d.ts +110 -0
  63. package/dist/types/plugin-audit.js +185 -0
  64. package/dist/types/plugin-hybrid.d.ts +85 -0
  65. package/dist/types/plugin-hybrid.js +68 -0
  66. package/dist/types/plugin-lock.d.ts +95 -0
  67. package/dist/types/plugin-lock.js +1 -0
  68. package/dist/types/plugin-protocol.d.ts +221 -0
  69. package/dist/types/plugin-protocol.js +322 -0
  70. package/dist/types/plugin-runtime.d.ts +25 -0
  71. package/dist/types/plugin-runtime.js +11 -0
  72. package/dist/types/plugin-scan.d.ts +159 -0
  73. package/dist/types/plugin-scan.js +166 -0
  74. package/dist/types/plugin-tools.d.ts +51 -0
  75. package/dist/types/plugin-tools.js +72 -0
  76. package/dist/types/project.d.ts +14 -0
  77. package/dist/types/prompt-blocks.d.ts +102 -0
  78. package/dist/types/prompt-blocks.js +24 -0
  79. package/dist/types/prompt.d.ts +47 -4
  80. package/dist/types/provider.d.ts +11 -0
  81. package/dist/types/question.d.ts +153 -0
  82. package/dist/types/question.js +65 -0
  83. package/dist/types/schedules.d.ts +26 -3
  84. package/dist/types/semver.d.ts +48 -0
  85. package/dist/types/semver.js +218 -0
  86. package/dist/types/service-keys.d.ts +41 -3
  87. package/dist/types/service-keys.js +44 -2
  88. package/dist/types/session.d.ts +54 -1
  89. package/dist/types/steering.d.ts +74 -0
  90. package/dist/types/steering.js +75 -0
  91. package/dist/types/tools.d.ts +125 -5
  92. package/dist/types/tools.js +75 -0
  93. package/dist/types/trust.d.ts +31 -0
  94. package/dist/types/trust.js +27 -0
  95. package/dist/types/webhooks.d.ts +1 -1
  96. package/dist/types/worktree.d.ts +170 -0
  97. package/dist/types/worktree.js +101 -0
  98. package/dist/utils/index.d.ts +46 -1
  99. package/dist/utils/index.js +145 -12
  100. package/dist/utils/reasoning.d.ts +16 -0
  101. package/dist/utils/reasoning.js +37 -0
  102. package/dist/version.d.ts +1 -1
  103. package/dist/version.js +1 -1
  104. package/package.json +2 -2
@@ -1,7 +1,9 @@
1
1
  import { z } from 'zod';
2
2
  import { permissionConfigSchema } from '../types/permission.js';
3
3
  import { createToolsDisabledSchema, globalRoleSchema, serviceScopeSchema } from '../schemas/index.js';
4
- import { TOOLS_POLICIES, MCP_NETWORK_POLICY_MODES, COMMAND_CONFLICT_MODES, DEFAULT_MCP_PRIVATE_CIDRS, DEFAULT_MCP_NETWORK_POLICY, DEFAULT_LLM_GATEWAY_RATE_LIMIT, ToolCapability, } from '../types/index.js';
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, ToolCapability, } from '../types/index.js';
5
+ import { catalogTrustLevelSchema } from '../types/trust.js';
6
+ import { PLUGIN_HYBRID_MODES } from '../types/plugin-hybrid.js';
5
7
  const toolCapabilityValues = Object.values(ToolCapability);
6
8
  // --- SynthConfig: единый конфиг для всех компонентов ---
7
9
  export const serverConfigSchema = z.object({
@@ -10,8 +12,75 @@ export const serverConfigSchema = z.object({
10
12
  corsOrigin: z.string().default('http://localhost:5002'),
11
13
  allowedOrigins: z.array(z.string()).default([]),
12
14
  });
15
+ /**
16
+ * ADR-097: параметры подключения к PostgreSQL (секция `storage.postgres`).
17
+ *
18
+ * Пароль здесь **не хранится** (инвариант 13) — его читает резолвер
19
+ * `resolvePostgresPassword` (env `SYNTH_POSTGRES_PASSWORD` → файл
20
+ * `{dataDir}/secrets/postgres-password`); решение об ошибке отсутствия пароля
21
+ * принимает драйвер (`@itphx/synth-storage-postgres`). `dsn` задан —
22
+ * приоритетнее отдельных `host`/`port`/`database`/`user`.
23
+ */
24
+ export const postgresStorageConfigSchema = z.object({
25
+ /** Полная строка подключения; задана — приоритетнее host/port/database/user. */
26
+ dsn: z.string().optional(),
27
+ host: z.string().optional(),
28
+ port: z.number().int().min(1).max(65535).optional(),
29
+ database: z.string().optional(),
30
+ user: z.string().optional(),
31
+ /** Схема БД (namespace таблиц). */
32
+ schema: z.string().optional(),
33
+ /**
34
+ * ADR-099/ADR-097: TLS-режим соединения с БД.
35
+ * `disable` — без TLS; `require` — шифрование без проверки сертификата;
36
+ * `verify-full` — проверка сертификата сервера по CA из `security.tls`.
37
+ * `verify-ca` принимается как **алиас** `verify-full` (нормализуется с
38
+ * предупреждением). **Не задано — прежнее поведение (`ssl: false`, без TLS)**,
39
+ * чтобы не сломать dev/существующие установки (dev-сервер без TLS).
40
+ * Читать/мапить — `resolvePostgresConfig` + `buildPostgresSslOptions`
41
+ * (`resolve.ts`/`tls.ts`, core — `storage/storage-context.ts`).
42
+ * TLS-параметры (`sslmode`/`sslrootcert`/…) **запрещены в `dsn`** — `pg`
43
+ * накладывает DSN поверх конфига и молча перекрывает `ssl`.
44
+ */
45
+ sslmode: z.enum(['disable', 'require', 'verify-full', 'verify-ca']).optional(),
46
+ /**
47
+ * Legacy-флаг TLS (`true`/`false`); используется, только если `sslmode` не
48
+ * задан (обратная совместимость). Новые установки — через `sslmode`.
49
+ */
50
+ ssl: z.boolean().optional(),
51
+ /** Максимальный размер пула соединений. */
52
+ poolMax: z.number().int().min(1).optional(),
53
+ });
13
54
  export const storageConfigSchema = z.object({
14
55
  dataDir: z.string().default('/var/synth/data'),
56
+ /**
57
+ * ADR-096: физический backend хранения. `file` — JSON-файлы с атомарной
58
+ * записью tmp→rename (ADR-005, дефолт); `memory` — in-memory (энергонезависимо
59
+ * НЕ сохраняется, для герметичных тестов); `postgres` — БД (драйвер —
60
+ * in-tree опциональный пакет `@itphx/synth-storage-postgres`). Читать через
61
+ * `resolveStorageBackend` (env `SYNTH_STORAGE_BACKEND` > это поле > `file`,
62
+ * fail-closed на неизвестном явно заданном значении).
63
+ *
64
+ * Необязательно: частичные override-объекты (`{ dataDir, workspacesRoot, … }`)
65
+ * остаются валидными, а дефолт `file` задают `defaults.ts`/`resolveStorageBackend`.
66
+ */
67
+ backend: z.enum(['file', 'memory', 'postgres']).optional(),
68
+ /** ADR-097: параметры PostgreSQL-backend (используются при `backend: postgres`). */
69
+ postgres: postgresStorageConfigSchema.prefault({}),
70
+ /**
71
+ * ADR-098 (волна 5): поведение при недоступности выбранного backend —
72
+ * `fallback-file` (перейти на файловое хранилище в `fallbackDir`, default) |
73
+ * `halt` (остановить старт). Читать через `resolveDegradedMode`
74
+ * (приоритет env `SYNTH_DEGRADED_MODE` > это поле > `fallback-file`).
75
+ */
76
+ degradedMode: z.enum(['fallback-file', 'halt']).default('fallback-file'),
77
+ /**
78
+ * ADR-098 (волна 5): каталог файлового фоллбека при деградации.
79
+ * `''` — не задано (эффективно `{dataDir}/fallback`), читать через
80
+ * `resolveStorageFallbackDir` (приоритет env `SYNTH_STORAGE_FALLBACK_DIR` >
81
+ * это поле > `{dataDir}/fallback`).
82
+ */
83
+ fallbackDir: z.string().default(''),
15
84
  workspacesRoot: z.string().default(''),
16
85
  /** Рабочий каталог по умолчанию для сессий без проекта. Резолвится от dataDir: {dataDir}/workspaces/default. */
17
86
  defaultWorkspace: z.string().default(''),
@@ -21,6 +90,68 @@ export const storageConfigSchema = z.object({
21
90
  * `confirm`), читать через `resolveWorkspaceOutsideRootPolicy`.
22
91
  */
23
92
  workspaceOutsideRoot: z.enum(['confirm', 'deny']).or(z.literal('')).default(''),
93
+ /**
94
+ * Максимальный размер загружаемого файла (`POST /api/v2/fs/upload`), в байтах.
95
+ * Валидируется (положительное целое в границах `MIN_UPLOAD_BYTES`…
96
+ * `MAX_UPLOAD_BYTES_LIMIT`), читать через `resolveMaxUploadBytes` (env
97
+ * `SYNTH_MAX_UPLOAD_BYTES` > это поле > `DEFAULT_MAX_UPLOAD_BYTES`).
98
+ * Не задано — резолвер подставляет `DEFAULT_MAX_UPLOAD_BYTES` (100 МиБ).
99
+ */
100
+ maxUploadBytes: z.number().int().min(MIN_UPLOAD_BYTES).max(MAX_UPLOAD_BYTES_LIMIT).optional(),
101
+ });
102
+ // --- Исполнение (ADR-077) ---
103
+ /**
104
+ * ADR-077: топология исполнения — переключатель запуска (`execution.mode`).
105
+ *
106
+ * - `inline` (дефолт) — исполнение в процессе backend'а (прежнее поведение,
107
+ * all-in-one образ);
108
+ * - `remote` — отдельные исполнители (`RemoteExecutionPort` + сервис-исполнитель,
109
+ * шаг 7 плана ADR-077).
110
+ *
111
+ * Секция — **параметр запуска**, а не runtime-настройка: смена режима — только
112
+ * рестартом процесса (инвариант 24 — process-глобальные решения не
113
+ * переинициализируются на лету). Значение `mode` — **fail-closed**: неизвестное
114
+ * явное значение (опечатка `inlne`) валит старт, а не молча выбирает дефолт
115
+ * (как `storage.backend`).
116
+ */
117
+ export const EXECUTION_MODES = ['inline', 'remote'];
118
+ /**
119
+ * Поведение при недоступном исполнителе:
120
+ * - `fail` (дефолт) — fail-closed: инструмент недоступен с явной причиной;
121
+ * - `inline-fallback` — backend исполняет команду сам; **только явной настройкой**
122
+ * (в managed-контуре это обход изоляции).
123
+ */
124
+ export const EXECUTION_FAIL_MODES = ['fail', 'inline-fallback'];
125
+ /**
126
+ * Таймаут exec-вызова по умолчанию (30 с — как у нынешних тулов: shell/search/git).
127
+ * Больший лимит для shell (до 120 с) — свойство тула, не конфига.
128
+ */
129
+ export const DEFAULT_EXECUTION_TIMEOUT_MS = 30_000;
130
+ /**
131
+ * Параметры удалённого исполнителя (`execution.remote`).
132
+ *
133
+ * - `url` — **список** адресов исполнителей (K8s Service `synth-executor`,
134
+ * `http://…`); пусто при `mode: remote` → fail-closed на старте;
135
+ * - `timeoutMs` — таймаут exec-вызова;
136
+ * - `concurrency` — лимит одновременных exec-вызовов на backend; не задан —
137
+ * число CPU процесса;
138
+ * - `failMode` — поведение при недоступном исполнителе;
139
+ * - `tokenSecret` — **путь/ссылка** на токен исполнителя, НЕ значение
140
+ * (инвариант 13): сам токен — `synth_exec_…` и живёт в Secret/файле.
141
+ */
142
+ export const executionRemoteConfigSchema = z.object({
143
+ url: z.array(z.string()).default([]),
144
+ timeoutMs: z.number().int().min(1).default(DEFAULT_EXECUTION_TIMEOUT_MS),
145
+ /** Лимит одновременных exec-вызовов; не задан — число CPU процесса. */
146
+ concurrency: z.number().int().min(1).optional(),
147
+ failMode: z.enum(EXECUTION_FAIL_MODES).default('fail'),
148
+ /** Путь/ссылка на токен исполнителя (НЕ значение — инвариант 13). */
149
+ tokenSecret: z.string().default(''),
150
+ });
151
+ /** ADR-077: секция `execution` — топология исполнения (параметр запуска). */
152
+ export const executionConfigSchema = z.object({
153
+ mode: z.enum(EXECUTION_MODES).default('inline'),
154
+ remote: executionRemoteConfigSchema.prefault({}),
24
155
  });
25
156
  export const authConfigSchema = z.object({
26
157
  debugMode: z.boolean().default(false),
@@ -65,7 +196,7 @@ export const runnerConfigSchema = z.object({
65
196
  opencode: z.number().int().default(4100),
66
197
  cline: z.number().int().default(4200),
67
198
  synth: z.number().int().default(4300),
68
- }).default({}),
199
+ }).prefault({}),
69
200
  proxyPort: z.number().int().min(1).max(65535).default(9090),
70
201
  });
71
202
  export const uiConfigSchema = z.object({
@@ -80,7 +211,7 @@ export const i18nConfigSchema = z.object({
80
211
  supportedLanguages: z.array(z.string()).default(['ru', 'en']),
81
212
  });
82
213
  export const loggingConfigSchema = z.object({
83
- groups: z.record(z.string(), z.string()).default({}),
214
+ groups: z.record(z.string(), z.string()).prefault({}),
84
215
  });
85
216
  export const tsmConfigSchema = z.object({
86
217
  maxIterations: z.number().int().min(1).default(50),
@@ -100,6 +231,17 @@ export const summarizationConfigSchema = z.object({
100
231
  temperature: z.number().min(0).max(2).default(0.3),
101
232
  promptFile: z.string().default('SUMMARIZER'),
102
233
  });
234
+ /**
235
+ * ADR-105 (Ф0): привязка MCP-коннектора к внешнему доступу (OAuth-креде).
236
+ *
237
+ * Коннектор ссылается на доступ **по id** — сам токен в реестре/конфиге не лежит
238
+ * (ADR-105 §5). Поле аддитивно: записи без `auth` (все существующие) остаются
239
+ * валидными.
240
+ */
241
+ export const mcpServerAuthSchema = z.object({
242
+ kind: z.literal('credential'),
243
+ credentialId: z.string().min(1),
244
+ });
103
245
  export const mcpServerConfigSchema = z.object({
104
246
  type: z.enum(['stdio', 'sse', 'http']),
105
247
  /** ADR-071 §2.2: человекочитаемое описание сервера (попадает в блок `mcp.servers`). */
@@ -109,6 +251,12 @@ export const mcpServerConfigSchema = z.object({
109
251
  env: z.record(z.string(), z.string()).optional(),
110
252
  url: z.string().optional(),
111
253
  headers: z.record(z.string(), z.string()).optional(),
254
+ /**
255
+ * ADR-105 §5: ссылка на внешний доступ (коннектор авторизуется токеном из
256
+ * слоя доступов, а не plaintext-заголовком). Аддитивно: старые записи без
257
+ * поля валидны.
258
+ */
259
+ auth: mcpServerAuthSchema.optional(),
112
260
  /**
113
261
  * Сид системного мастер-флага записи реестра при первичном создании из config
114
262
  * (`seedFromConfig`); в резолвинге/подключении не участвует — после создания
@@ -130,10 +278,12 @@ export const mcpServerConfigSchema = z.object({
130
278
  export const mcpNetworkPolicySchema = z.object({
131
279
  mode: z.enum(MCP_NETWORK_POLICY_MODES).default(DEFAULT_MCP_NETWORK_POLICY.mode),
132
280
  list: z.array(z.string()).default([...DEFAULT_MCP_PRIVATE_CIDRS]),
281
+ /** Allow-правила-исключения (общий формат с `egress.*`). */
282
+ exceptions: z.array(z.string()).default([]),
133
283
  });
134
284
  export const mcpConfigSchema = z.object({
135
- servers: z.record(z.string(), mcpServerConfigSchema).default({}),
136
- networkPolicy: mcpNetworkPolicySchema.default({}),
285
+ servers: z.record(z.string(), mcpServerConfigSchema).prefault({}),
286
+ networkPolicy: mcpNetworkPolicySchema.prefault({}),
137
287
  /**
138
288
  * ADR-071 §2.3: глобальная админская политика включения **MCP**-инструментов.
139
289
  * Независима от `tools.policy` (только встроенные). Per-session override —
@@ -156,7 +306,7 @@ export const toolsDisabledConfigSchema = createToolsDisabledSchema(false);
156
306
  export const toolsConfigSchema = z.object({
157
307
  policy: z.enum(TOOLS_POLICIES).default('auto'),
158
308
  /** ADR-071 §2.6: instance-wide отключение инструментов (admin). */
159
- disabled: toolsDisabledConfigSchema.default({}),
309
+ disabled: toolsDisabledConfigSchema.prefault({}),
160
310
  });
161
311
  // --- Скиллы (ADR-046) ---
162
312
  /**
@@ -184,7 +334,7 @@ export const skillsConfigSchema = z.object({
184
334
  * для экспансии `metadata.synth.requires_toolsets` в проверку доступности
185
335
  * скилла (union с `requires_capabilities`).
186
336
  */
187
- toolsets: z.record(z.string(), z.array(z.enum(toolCapabilityValues))).default({}),
337
+ toolsets: z.record(z.string(), z.array(z.enum(toolCapabilityValues))).prefault({}),
188
338
  });
189
339
  // --- Slash-команды (ADR-046 §7) ---
190
340
  /**
@@ -200,7 +350,7 @@ export const commandsConfigSchema = z.object({
200
350
  mode: z.enum(COMMAND_CONFLICT_MODES).default('bundle-wins'),
201
351
  namespacePrefix: z.boolean().default(false),
202
352
  })
203
- .default({}),
353
+ .prefault({}),
204
354
  maxArgumentsLength: z.number().int().min(1).default(10_000),
205
355
  maxRenderedBytes: z.number().int().min(1).default(200_000),
206
356
  });
@@ -280,7 +430,7 @@ export const eventsConfigSchema = z.object({
280
430
  * владелец не переопределяется (аутентифицированный пользователь запроса,
281
431
  * `identity.principalId` или `resolveOwnerId`).
282
432
  */
283
- identityMap: z.record(z.string(), z.string()).default({}),
433
+ identityMap: z.record(z.string(), z.string()).prefault({}),
284
434
  });
285
435
  // --- Планировщик расписаний (ADR-051 срез / ADR-089) ---
286
436
  /**
@@ -291,17 +441,19 @@ export const eventsConfigSchema = z.object({
291
441
  * - `jobRetentionDays` — срок хранения Job-истории (дни, `prune` на старте);
292
442
  * - `leaderElection` — выбор лидера-владельца тикера: `none` (каждый процесс
293
443
  * считает себя лидером, поведение single-process) | `file` (file-based lock на
294
- * общем `dataDir`). Default — `none` (OFF);
444
+ * общем `dataDir`) | `postgres` (session-level advisory-lock БД; требует
445
+ * `storage.backend=postgres`, иначе — `AlwaysLeader`). Default — `none` (OFF);
295
446
  * - `crossProcessLocks` — межпроцессная сериализация мутаций `ScheduleStore`
296
447
  * (file-мьютекс поверх in-process `AsyncLock`). Default — `false` (OFF):
297
- * поведение single-process не меняется.
448
+ * поведение single-process не меняется. Под `storage.backend=postgres`
449
+ * `ScheduleStore` не используется (мутации — атомарные SQL), лок не создаётся.
298
450
  */
299
451
  export const schedulerConfigSchema = z.object({
300
452
  enabled: z.boolean().default(true),
301
453
  tickSec: z.number().int().min(1).max(3600).default(60),
302
454
  catchUp: z.enum(['skip', 'once']).default('skip'),
303
455
  jobRetentionDays: z.number().int().min(0).default(30),
304
- leaderElection: z.enum(['none', 'file']).default('none'),
456
+ leaderElection: z.enum(['none', 'file', 'postgres']).default('none'),
305
457
  crossProcessLocks: z.boolean().default(false),
306
458
  });
307
459
  // --- Decision-модели (ADR-084) ---
@@ -328,23 +480,386 @@ export const decisionConfigSchema = z.object({
328
480
  /** ADR-084: модель тира эскалации; пусто — эскалации нет. */
329
481
  escalationModel: z.string().default(''),
330
482
  });
483
+ // --- Внешние доступы: каталог OAuth-провайдеров (ADR-105) ---
484
+ /**
485
+ * ADR-105 (Ф3): описание OAuth-провайдера в конфиге инстанса — **данные**.
486
+ *
487
+ * Секрета здесь нет (инвариант 13): `client_secret` живёт только в env
488
+ * `SYNTH_OAUTH_<PROVIDER>_CLIENT_SECRET` или в файле
489
+ * `{dataDir}/secrets/oauth/<provider>.client_secret`.
490
+ */
491
+ export const oauthProviderConfigSchema = z.object({
492
+ /** Endpoint выдачи кода (authorization endpoint, RFC 6749 §3.1). */
493
+ authorizeUrl: z.string().min(1),
494
+ /** Endpoint обмена кода и обновления токена (RFC 6749 §3.2/§6). */
495
+ tokenUrl: z.string().min(1),
496
+ /** Endpoint отзыва токена (RFC 7009) — необязателен. */
497
+ revokeUrl: z.string().min(1).optional(),
498
+ /** Endpoint device flow (RFC 8628 §3.1) — необязателен. */
499
+ deviceAuthorizationUrl: z.string().min(1).optional(),
500
+ /** `client_id` приложения (публичное значение, не секрет). */
501
+ clientId: z.string().min(1),
502
+ /** Scope'ы по умолчанию. */
503
+ scopes: z.array(z.string()).default([]),
504
+ /** Способ подтверждения клиента (по умолчанию — `none`, т.е. PKCE). */
505
+ clientAuth: z.enum(['none', 'client_secret_post', 'client_secret_basic']).optional(),
506
+ /** `redirect_uri` по умолчанию. */
507
+ redirectUri: z.string().min(1).optional(),
508
+ });
509
+ /**
510
+ * ADR-105 (Ф3): каталог OAuth-провайдеров инстанса — карта «имя → описание».
511
+ */
512
+ export const oauthProvidersSchema = z.record(z.string().min(1), oauthProviderConfigSchema);
513
+ /**
514
+ * ADR-105 (Ф3): секция `oauth` — каталог OAuth-провайдеров инстанса.
515
+ *
516
+ * `providers` — карта «имя провайдера → описание». Ключ совпадает с полем
517
+ * `provider` записи внешнего доступа (`ExternalCredential`). Пусто — каталога
518
+ * нет: доступ, созданный кодом, работает, но обновить токен без описания
519
+ * провайдера нечем (refresh вернёт понятную ошибку).
520
+ */
521
+ export const oauthConfigSchema = z.object({
522
+ providers: oauthProvidersSchema.prefault({}),
523
+ });
524
+ // --- Аналитика и отчётность (ADR-102) ---
525
+ /**
526
+ * ADR-102: конфигурация аналитики инстанса.
527
+ * - `retentionDays` — срок хранения суточных роллапов (UTC-дни): бакеты со
528
+ * `day < utcDay(now) - retentionDays` удаляются прунером. `<= 0` — без
529
+ * ограничения. Default — 400.
530
+ */
531
+ export const analyticsConfigSchema = z.object({
532
+ retentionDays: z.number().int().default(400),
533
+ });
534
+ // --- Вопросы пользователю (этап 1 roadmap 0.13 — блок 3) ---
535
+ /**
536
+ * Конфигурация подсистемы «вопрос пользователю» (`ask_user`).
537
+ *
538
+ * - `timeoutMs` — срок ожидания ответа на вопрос, мс. `0` — **без таймаута**
539
+ * (дефолт): вопрос ждёт ответа, пока его не отменят вручную или не
540
+ * прервётся ход; срок может задать тул `question` (`timeout`, ≥ 5 минут);
541
+ * - `retentionDays` — срок хранения терминальных записей вопросов (дни);
542
+ * `<= 0` — без ограничения.
543
+ */
544
+ export const questionsConfigSchema = z.object({
545
+ timeoutMs: z.number().int().min(0).default(0),
546
+ retentionDays: z.number().int().default(14),
547
+ });
548
+ // --- Фоновые прогоны (этап 1 roadmap 0.13 — блок 4) ---
549
+ /**
550
+ * Конфигурация единого реестра фоновых прогонов (PROP-096/PROP-097).
551
+ *
552
+ * - `enabled` — мастер-выключатель фоновой работы: при `false` тул `task`
553
+ * с `background: true` отказывает (`task.background_disabled`), как и
554
+ * `execute_shell` с `background: true` (`process.background_disabled`);
555
+ * - `maxSubagentsPerSession` — максимум **одновременно идущих** фоновых
556
+ * саб-агентов на одну родительскую сессию;
557
+ * - `maxProcessesPerSession` — максимум **одновременно идущих** фоновых
558
+ * шелл-процессов на одну сессию-владельца (PROP-097);
559
+ * - `maxRunsPerSession` — максимум записей реестра на одну сессию-владельца
560
+ * (защита от роста реестра; записи чистит retention);
561
+ * - `logMaxBytes` — предел размера лога фонового процесса, байт; `0` — без
562
+ * ограничения. По превышении запись в лог прекращается, а в записи реестра
563
+ * ставится `metadata.truncated`;
564
+ * - `retentionDays` — срок хранения терминальных записей реестра (дни);
565
+ * `<= 0` — без ограничения.
566
+ */
567
+ export const backgroundConfigSchema = z.object({
568
+ enabled: z.boolean().default(true),
569
+ maxSubagentsPerSession: z.number().int().min(0).default(2),
570
+ maxProcessesPerSession: z.number().int().min(0).default(5),
571
+ maxRunsPerSession: z.number().int().min(0).default(10),
572
+ logMaxBytes: z.number().int().min(0).default(10_485_760),
573
+ retentionDays: z.number().int().default(7),
574
+ });
575
+ // --- Authority-слой (ADR-106) ---
576
+ /**
577
+ * ADR-106 Ф1: конфигурация Authority-слоя.
578
+ *
579
+ * - `enabled` — мастер-выключатель слоя (по умолчанию **выключен**):
580
+ * Authority-слой не влияет на решения прав, пока его не включили
581
+ * (Ф2 — принуждение; до этого слой только считает решения);
582
+ * - `shadow` — режим **наблюдения**: решение Authority считается и пишется
583
+ * в журнал (`{dataDir}/audit/authority.jsonl`), но **не применяется** —
584
+ * поведение прав не меняется (ADR-106 §«Совместимость и миграция»:
585
+ * «Ф0–Ф1: authority-резолвер работает в режиме shadow»).
586
+ *
587
+ * По умолчанию `shadow: true` — при включении слоя он сначала наблюдает, а
588
+ * не enforced.
589
+ */
590
+ export const authorityConfigSchema = z.object({
591
+ enabled: z.boolean().default(false),
592
+ shadow: z.boolean().default(true),
593
+ });
594
+ // --- Вложения сообщений (ADR-115) ---
595
+ /**
596
+ * ADR-115: семейства вложений, включаемые/выключаемые по отдельности.
597
+ * Ключ соответствует семейству MIME: `image/*`, `application/pdf`,
598
+ * `audio/*`, `video/*`.
599
+ */
600
+ export const attachmentModalitiesSchema = z.object({
601
+ image: z.boolean().default(true),
602
+ pdf: z.boolean().default(true),
603
+ audio: z.boolean().default(true),
604
+ video: z.boolean().default(true),
605
+ });
606
+ /**
607
+ * ADR-115: ключи семейств вложений в каноническом порядке.
608
+ *
609
+ * Те же ключи используют `attachments.modalities` и
610
+ * `attachments.modalityModels`. Не путать с модальностями **модели**
611
+ * (`AttachmentModality` из `model-metadata.ts` — у неё есть ещё `text`).
612
+ */
613
+ export const ATTACHMENT_FAMILIES = ['image', 'pdf', 'audio', 'video'];
614
+ /**
615
+ * ADR-115: ссылка на модель обработки модальности (aux-модель).
616
+ *
617
+ * `provider` + `model` — ключ каталога (`ModelConfig`), как у модели по
618
+ * умолчанию инстанса. Модель сессии при этом **не меняется**: aux-модель
619
+ * получает только вложение (описание/извлечённый текст), а диалог
620
+ * продолжается на модели сессии.
621
+ */
622
+ export const modalityModelRefSchema = z.object({
623
+ provider: z.string().min(1),
624
+ model: z.string().min(1),
625
+ });
626
+ /**
627
+ * ADR-115: назначения aux-моделей по семействам вложений.
628
+ *
629
+ * Отсутствие записи по семейству = обработка **не настроена** (текущее
630
+ * поведение: вложение, которое модель сессии не принимает, отбрасывается с
631
+ * путём в workspace). `auto`-значений нет: нативная поддержка определяется
632
+ * по модальностям модели сессии (`ModelConfig.modalities`).
633
+ */
634
+ export const modalityModelsSchema = z.object({
635
+ image: modalityModelRefSchema.optional(),
636
+ pdf: modalityModelRefSchema.optional(),
637
+ audio: modalityModelRefSchema.optional(),
638
+ video: modalityModelRefSchema.optional(),
639
+ });
640
+ /**
641
+ * ADR-115 §7: конфигурация вложений сообщений (multipart-загрузка + раздача).
642
+ *
643
+ * - `enabled` — мастер-выключатель вложений: `false` — загрузка и приём
644
+ * `attachments` в промпте запрещены (`415 attachments_disabled`);
645
+ * - `modalities` — какие семейства MIME разрешены (`image`/`pdf`/`audio`/`video`);
646
+ * выключенное семейство → `415 UNSUPPORTED_MEDIA_TYPE`;
647
+ * - `maxBytesPerFile` — предел размера одного файла, байт;
648
+ * - `maxFilesPerMessage` — предел числа вложений в одном сообщении;
649
+ * - `maxBytesPerSession` — предел суммарного объёма вложений сессии, байт;
650
+ * - `maxBytesPerMessage` — бюджет вложений, которые **тулы** прикладывают к
651
+ * текущему ходу (`ToolResult.attachments`, ADR-115 §«Медиа из инструментов»):
652
+ * суммарный объём одной инъекции. Не задано — дефолт оркестратора (20 МиБ);
653
+ * - `allowedMimePrefixes` — белый список MIME-префиксов (не пустой список —
654
+ * все префиксы разрешены; список — объектный ключ, остаётся в config.yaml);
655
+ * - `workspaceFallback` — резервный путь хранения вложений в workspace проекта
656
+ * (когда blob-хранилище недоступно); применяется оркестратором;
657
+ * - `modalityModels` — модели обработки по семействам (ADR-115, aux-модели):
658
+ * если модель сессии не принимает модальность, вложение обрабатывает
659
+ * указанная модель, а в диалог попадает текстовый результат. Нет записи —
660
+ * обработка не настроена (вложение отбрасывается с путём в workspace);
661
+ * - `gcDays` — срок хранения осиротевших объектов (дней; `<= 0` — без
662
+ * ограничения).
663
+ */
664
+ export const attachmentsConfigSchema = z.object({
665
+ enabled: z.boolean().default(true),
666
+ modalities: attachmentModalitiesSchema.prefault({}),
667
+ maxBytesPerFile: z.number().int().min(1).default(25 * 1024 * 1024),
668
+ maxFilesPerMessage: z.number().int().min(1).default(10),
669
+ maxBytesPerSession: z.number().int().min(1).default(1024 * 1024 * 1024),
670
+ // ADR-115 §«Медиа из инструментов»: бюджет инъекции вложений тулов на ход.
671
+ // `optional` (без дефолта): значение читает оркестратор (fallback 20 МиБ),
672
+ // конфиг-схема остаётся аддитивной для существующих снимков.
673
+ maxBytesPerMessage: z.number().int().min(1).optional(),
674
+ allowedMimePrefixes: z
675
+ .array(z.string().min(1))
676
+ .default(['image/', 'audio/', 'video/', 'application/pdf', 'text/']),
677
+ workspaceFallback: z.boolean().default(true),
678
+ modalityModels: modalityModelsSchema.optional(),
679
+ gcDays: z.number().int().min(0).default(30),
680
+ });
681
+ // --- Наблюдаемость: Prometheus-метрики (ADR-094) ---
682
+ /**
683
+ * ADR-094: конфигурация экспорта метрик.
684
+ * - `enabled` — включает `GET /metrics` и сбор HTTP/процессных метрик
685
+ * (по умолчанию выключено — контракт «эндпоинта нет, пока не включили»).
686
+ *
687
+ * Bearer-токен в конфиге **не хранится** (инвариант 13): env
688
+ * `SYNTH_METRICS_TOKEN` либо файл `{dataDir}/secrets/metrics-token`.
689
+ * Имя env совпадает с Helm-чартом (`SYNTH_METRICS_ENABLED`).
690
+ */
691
+ export const metricsConfigSchema = z.object({
692
+ enabled: z.boolean().default(false),
693
+ });
331
694
  // --- Webhooks (ADR-052, этап II) ---
332
695
  /**
333
696
  * ADR-052 (этап II): конфигурация исходящих webhooks.
334
697
  * - `enabled` — мастер-выключатель доставки (по умолчанию выключен);
335
698
  * - `maxAttempts` — число HTTP-попыток на доставку (экспоненциальный backoff с джиттером);
336
699
  * - `timeoutMs` — таймаут одного HTTP-запроса;
337
- * - `allowPrivateTargets` — разрешить http и приватные/loopback адреса (для dev;
338
- * по умолчанию `false` — только https и публичные адреса, защита от SSRF);
339
700
  * - `deliveryRetentionDays` — срок хранения журнала доставок (0 — без ограничения).
701
+ *
702
+ * Политика egress (https/приватные адреса) вынесена в `egress.webhooks`
703
+ * (`mode: 'off'` заменяет удалённый `allowPrivateTargets`).
340
704
  */
341
705
  export const webhooksConfigSchema = z.object({
342
706
  enabled: z.boolean().default(false),
343
707
  maxAttempts: z.number().int().min(1).max(10).default(5),
344
708
  timeoutMs: z.number().int().min(1).default(10_000),
345
- allowPrivateTargets: z.boolean().default(false),
346
709
  deliveryRetentionDays: z.number().int().min(0).default(30),
347
710
  });
711
+ // --- Слой плагинов (ADR-090) ---
712
+ /**
713
+ * Ф7 (ADR-090): форма серверной политики плагинов для гибридного режима —
714
+ * `plugins.hybrid` (конфиг + runtime-настройки).
715
+ *
716
+ * `mode: 'off'` — сервер не ограничивает плагины; `mode: 'allowlist'` —
717
+ * разрешены только плагины из `allow` (пустой список — не разрешён никто).
718
+ */
719
+ export const pluginsHybridConfigSchema = z.object({
720
+ mode: z.enum(PLUGIN_HYBRID_MODES).default('off'),
721
+ allow: z.array(z.string().min(1)).default([]),
722
+ });
723
+ /**
724
+ * ADR-090: конфигурация слоя плагинов (Extension API).
725
+ *
726
+ * - `enabled` — мастер-выключатель Extension API (по умолчанию включён: слой
727
+ * Ф0–Ф2 ещё не исполняет код плагинов, но политики читаются);
728
+ * - `runtimeInstall` — установка плагинов во время работы инстанса
729
+ * (`allow`/`deny`; по умолчанию `deny` — в managed установка только
730
+ * deploy-time);
731
+ * - `trustFloor` — минимальный уровень доверия для **установки и активации**
732
+ * плагина (по умолчанию `trusted`). Плагин ниже порога **не устанавливается**:
733
+ * установщик отказывает с `plugin.trust_below_floor` — как и активация
734
+ * (ADR-090).
735
+ * - `scan` — статический сканер содержимого расширения
736
+ * (`enabled`/`disabled`; по умолчанию включён);
737
+ * - `allowlist`/`denylist` — списки имён расширений, которым разрешён/
738
+ * запрещён запуск (пусто — политика не применяется);
739
+ * - `remoteAllowlist` — allow-list расширений для hybrid-контура (Ф7);
740
+ * - `exactHostExceptions` — путь к файлу точных исключений семвер-гейта
741
+ * (формат файла — открытый вопрос ADR-090);
742
+ * - `promptBlockMaxChars` — бюджет символов **на блок** системного промпта
743
+ * от плагина (по умолчанию 4000; превышение — обрезка хостом с маркером
744
+ * усечения, ADR-090);
745
+ * - `executionEnabled` — **главный переключатель исполнения кода плагинов**
746
+ * (по умолчанию `false`: в Ф1 загрузчик доводит плагин до шага `import` и
747
+ * останавливается — `plugin.execution_disabled`; в Ф3/Ф4 включает `inline`/
748
+ * `out-of-process`);
749
+ * - `deployDir` — каталог с бандлами, поставленными **образом/развёртыванием**
750
+ * (например `/opt/synth/plugins/<name>/` с `synth.pack` + `dist/`). Дефолт —
751
+ * `/opt/synth/plugins` (конвенциональный путь образа; каталога нет — установки
752
+ * нет, разбор пустого каталога — no-op). Пустая строка — deploy-time установки
753
+ * выключены. Ставится при старте инстанса (`PluginRuntime.installDeployPlugins`,
754
+ * ADR-090, Ф5в). Значение переопределяется config.yaml
755
+ * или env `SYNTH_PLUGINS_DEPLOY_DIR` (ADR-023: env выше конфига);
756
+ * - `deployTrust` — уровень доверия, с которым ставятся бандлы `deployDir`
757
+ * (default `trusted`: бандл из образа доверен ровно настолько, насколько
758
+ * доверен сам образ; при `trustFloor: trusted` (дефолт) установка проходит).
759
+ * Не выше доверия инстанса: ниже `trustFloor` — установка отклоняется
760
+ * штатно (`plugin.trust_below_floor`);
761
+ * - `managedReadonly` — management-плагин (из `deployDir`, `lock.source ===
762
+ * 'deploy'`) **нельзя** снять или переустановить через API/CLI (default
763
+ * `true`; отказ `plugin.managed_readonly`). Действует независимо от режима
764
+ * инстанса;
765
+ * - `embeddingProvider`/`embeddingModel` — провайдер и модель эмбеддингов для
766
+ * сервиса фасада `facade.embed` (ADR-090, WP-F). Пусто — сервис не
767
+ * сконфигурирован (`facade.embed` бросает `plugin.embedding_not_configured`).
768
+ * Переопределяется config.yaml или env `SYNTH_PLUGINS_EMBEDDING_PROVIDER` /
769
+ * `SYNTH_PLUGINS_EMBEDDING_MODEL` (ADR-023: env выше конфига).
770
+ */
771
+ export const pluginsConfigSchema = z.object({
772
+ enabled: z.boolean().default(true),
773
+ runtimeInstall: z.enum(['allow', 'deny']).default('deny'),
774
+ trustFloor: catalogTrustLevelSchema.default('trusted'),
775
+ scan: z.enum(['enabled', 'disabled']).default('enabled'),
776
+ allowlist: z.array(z.string().min(1)).default([]),
777
+ denylist: z.array(z.string().min(1)).default([]),
778
+ remoteAllowlist: z.array(z.string().min(1)).default([]),
779
+ exactHostExceptions: z.string().default(''),
780
+ promptBlockMaxChars: z.number().int().positive().default(4000),
781
+ executionEnabled: z.boolean().default(false),
782
+ /**
783
+ * Бюджет времени на один вызов фильтра LLM-вызовов, мс (точка
784
+ * `llmFilters`, ADR-090). Не задан фильтром — берётся это значение;
785
+ * по истечении применяется `failMode` фильтра (`closed` → вызов не уходит,
786
+ * `open` → вызов идёт, факт — в аудите).
787
+ */
788
+ llmFilterTimeoutMs: z.number().int().positive().default(DEFAULT_LLM_FILTER_TIMEOUT_MS),
789
+ /**
790
+ * Ф5в: каталог с бандлами, поставленными образом/развёртыванием. Пусто — не
791
+ * задан (deploy-time установки нет). Каждый подкаталог — бандл
792
+ * (`synth.pack` + `dist/`), ставится при старте инстанса.
793
+ */
794
+ deployDir: z.string().default('/opt/synth/plugins'),
795
+ /**
796
+ * Ф5в: уровень доверия deploy-бандлов (не выше доверия инстанса: ниже
797
+ * `trustFloor` — штатный отказ `plugin.trust_below_floor`).
798
+ */
799
+ deployTrust: catalogTrustLevelSchema.default('trusted'),
800
+ /**
801
+ * Ф5в: management-плагин «неприкосновенен» — снятие/переустановка через
802
+ * API/CLI запрещены (`plugin.managed_readonly`). Управляется развёртыванием.
803
+ */
804
+ managedReadonly: z.boolean().default(true),
805
+ /**
806
+ * ADR-090 (WP-F): провайдер эмбеддингов для сервиса фасада `facade.embed`.
807
+ *
808
+ * Пусто — сервис эмбеддингов **не сконфигурирован**: `facade.embed` есть
809
+ * всегда, но бросает `plugin.embedding_not_configured` (плагин сам решает,
810
+ * деградировать или нет; хост не падает). Плагин может перекрыть провайдера
811
+ * и модель в вызове (`opts.provider`/`opts.model`).
812
+ */
813
+ embeddingProvider: z.string().default(''),
814
+ /**
815
+ * ADR-090 (WP-F): модель эмбеддингов для `facade.embed`.
816
+ *
817
+ * Пусто — берётся дефолтная модель провайдера (`provider.defaultModel`).
818
+ */
819
+ embeddingModel: z.string().default(''),
820
+ /**
821
+ * Ф7: серверная политика плагинов для гибридного режима.
822
+ *
823
+ * - `mode` — `off` (дефолт): сервер **не ограничивает** плагины;
824
+ * `allowlist`: сервер ограничивает, разрешены только плагины из `allow`
825
+ * (пустой список при `allowlist` — не разрешён никто);
826
+ * - `allow` — имена плагинов, которым сервер разрешает работать
827
+ * (релевантно только при `mode: 'allowlist'`).
828
+ *
829
+ * Политика применяется на двух сторонах: локальный core в гибриде сверяется
830
+ * с ней **перед активацией** плагина (Уровень 1, cooperative), а сервер
831
+ * отвергает server-scoped токен плагина, чей `plugin_id` вне списка
832
+ * (Уровень 2, server-scoped токены).
833
+ */
834
+ hybrid: pluginsHybridConfigSchema.prefault({}),
835
+ });
836
+ // --- Egress-политика (shared формат tools/webhooks/MCP) ---
837
+ /** Общий формат политики egress (`mode` + `list` + `exceptions`). */
838
+ export const egressPolicySchema = z.object({
839
+ mode: z.enum(EGRESS_POLICY_MODES).default(DEFAULT_EGRESS_TOOLS_POLICY.mode),
840
+ list: z.array(z.string()).default([...DEFAULT_MCP_PRIVATE_CIDRS]),
841
+ exceptions: z.array(z.string()).default([]),
842
+ });
843
+ /** Политика webhooks: дополнительно `off` (dev — без проверок и без https). */
844
+ export const webhooksEgressPolicySchema = z.object({
845
+ mode: z.enum(WEBHOOKS_EGRESS_POLICY_MODES).default(DEFAULT_EGRESS_WEBHOOKS_POLICY.mode),
846
+ list: z.array(z.string()).default([...DEFAULT_MCP_PRIVATE_CIDRS]),
847
+ exceptions: z.array(z.string()).default([]),
848
+ });
849
+ export const egressLogConfigSchema = z.object({
850
+ enabled: z.boolean().default(DEFAULT_EGRESS_LOG.enabled),
851
+ retentionDays: z.number().int().min(0).default(DEFAULT_EGRESS_LOG.retentionDays),
852
+ });
853
+ /**
854
+ * `egress` — настраиваемая политика исходящих запросов (tools/webhooks) и
855
+ * журнал внешних запросов. `mcp.networkPolicy` остаётся отдельным ключом, но
856
+ * использует тот же формат (mode `deny|allow` + `exceptions`).
857
+ */
858
+ export const egressConfigSchema = z.object({
859
+ tools: egressPolicySchema.prefault({}),
860
+ webhooks: webhooksEgressPolicySchema.prefault({}),
861
+ log: egressLogConfigSchema.prefault({}),
862
+ });
348
863
  // --- Проектные инструкции (ADR-069) ---
349
864
  /**
350
865
  * ADR-069 §3.4/§11: дополнительный источник проектных инструкций.
@@ -403,8 +918,8 @@ export const instructionsConfigSchema = z.object({
403
918
  minChars: z.number().int().min(1).default(20_000),
404
919
  /** Верхняя граница динамического капа (ceiling). */
405
920
  maxCharsCeiling: z.number().int().min(1).default(500_000),
406
- lazy: instructionsLazyConfigSchema.default({}),
407
- fetch: instructionsFetchConfigSchema.default({}),
921
+ lazy: instructionsLazyConfigSchema.prefault({}),
922
+ fetch: instructionsFetchConfigSchema.prefault({}),
408
923
  sources: z.array(instructionSourceConfigSchema).default([]),
409
924
  /** Проекты (id), где автозагрузка выключена. */
410
925
  excludeProjects: z.array(z.string()).default([]),
@@ -438,9 +953,37 @@ export const bootstrapServiceKeySchema = z.object({
438
953
  description: z.string().optional(),
439
954
  });
440
955
  export const bootstrapServiceKeysSchema = z.array(bootstrapServiceKeySchema);
956
+ /**
957
+ * ADR-099 (единый механизм доверия TLS/CA): секция `security.tls`.
958
+ *
959
+ * Задаёт доверие для **исходящих** соединений Synth (https-провайдеры, MCP,
960
+ * webhooks, гибридный backend, OIDC, git, загрузка иконок/обновлений):
961
+ * - `caFile` — путь к PEM-файлу с доверенным CA-сертификатом (корпоративный CA);
962
+ * - `caPem` — сам PEM-сертификат (например из Secret) — **взаимоисключающ** с `caFile`;
963
+ * - `certFile`/`keyFile` — клиентский сертификат и ключ (mTLS);
964
+ * - `rejectUnauthorized` — проверять сертификат сервера (по умолчанию `true`).
965
+ *
966
+ * Читать эффективные значения через `resolveTlsConfig`/`resolveTlsTrust` (ADR-023:
967
+ * env > config.yaml > defaults). Пусто — системное доверие (поведение не меняется).
968
+ * Опционально — литеральные `SecurityConfig` без поля валидны.
969
+ */
970
+ export const securityTlsConfigSchema = z.object({
971
+ /** Путь к PEM-файлу доверенного CA. Взаимоисключающ с `caPem`. */
972
+ caFile: z.string().optional(),
973
+ /** PEM доверенного CA (приоритетно над файлом; взаимоисключающ с `caFile`). */
974
+ caPem: z.string().optional(),
975
+ /** Путь к PEM-файлу клиентского сертификата (mTLS). */
976
+ certFile: z.string().optional(),
977
+ /** Путь к PEM-файлу приватного ключа клиента (mTLS). */
978
+ keyFile: z.string().optional(),
979
+ /** Проверять сертификат сервера (по умолчанию `true`). */
980
+ rejectUnauthorized: z.boolean().optional(),
981
+ });
441
982
  export const securityConfigSchema = z.object({
442
- promptInjection: promptInjectionConfigSchema.default({}),
443
- protectedPaths: protectedPathsConfigSchema.default({}),
983
+ promptInjection: promptInjectionConfigSchema.prefault({}),
984
+ protectedPaths: protectedPathsConfigSchema.prefault({}),
985
+ /** ADR-099: единый механизм доверия TLS/CA для исходящих соединений. */
986
+ tls: securityTlsConfigSchema.optional(),
444
987
  /**
445
988
  * ADR-076: мастер-ключ для шифрования секретов at-rest (SSH-ключи, AES-256-GCM).
446
989
  * Приоритет — env `SYNTH_SECRET_KEY` (читать через `resolveSecretKey`).
@@ -456,6 +999,111 @@ export const securityConfigSchema = z.object({
456
999
  */
457
1000
  bootstrapServiceKeys: bootstrapServiceKeysSchema.optional(),
458
1001
  });
1002
+ // --- Egress-прокси (ADR-099, этапы D1/D2a) ---
1003
+ /** Тип аутентификации прокси: D2a — только `basic` (NTLM/Negotiate — D3/D4). */
1004
+ export const PROXY_AUTH_TYPES = ['basic', 'ntlm', 'negotiate'];
1005
+ /**
1006
+ * Basic-аутентификация прокси (D2a). Пароль **не хранится в config**
1007
+ * (инвариант 13): только env `SYNTH_PROXY_PASSWORD` или файл
1008
+ * `{dataDir}/secrets/proxy-password`. Username также может быть в userinfo URL.
1009
+ */
1010
+ export const proxyAuthConfigSchema = z.object({
1011
+ type: z.enum(PROXY_AUTH_TYPES).default('basic'),
1012
+ username: z.string().default(''),
1013
+ });
1014
+ /**
1015
+ * TLS к **самому прокси** (D2a) — схема как у `security.tls` (ADR-099):
1016
+ * `caFile`/`caPem` (взаимоисключающие), `certFile`/`keyFile` (mTLS к прокси),
1017
+ * `rejectUnauthorized`. Доверие к цели по-прежнему задаёт `security.tls`.
1018
+ */
1019
+ export const proxyTlsConfigSchema = z.object({
1020
+ caFile: z.string().optional(),
1021
+ caPem: z.string().optional(),
1022
+ certFile: z.string().optional(),
1023
+ keyFile: z.string().optional(),
1024
+ rejectUnauthorized: z.boolean().optional(),
1025
+ });
1026
+ /** Режим маршрутизации прокси: `all` — default для всех, `selected` — только правила. */
1027
+ export const PROXY_MODES = ['all', 'selected'];
1028
+ /** Имя профиля прокси: lower-case буква, далее `[a-z0-9_-]`, длина 1..32. */
1029
+ export const PROXY_PROFILE_NAME_RE = /^[a-z][a-z0-9_-]{0,31}$/;
1030
+ export const proxyProfileNameSchema = z
1031
+ .string()
1032
+ .regex(PROXY_PROFILE_NAME_RE, 'имя профиля: ^[a-z][a-z0-9_-]{0,31}$');
1033
+ /**
1034
+ * Именованный профиль прокси (ADR-099, per-host маршрутизация).
1035
+ *
1036
+ * Набор URL-полей тот же, что у top-level legacy-конфига (`url` и/или
1037
+ * `httpProxy`/`httpsProxy`/`allProxy`); профиль обязан задавать хотя бы один URL
1038
+ * (проверяется резолвером). `auth` — только Basic; пароль в config не хранится —
1039
+ * env/файл: `SYNTH_PROXY_<PROFILE>_PASSWORD` / `{dataDir}/secrets/proxy/<profile>.password`
1040
+ * (для `default` — legacy `SYNTH_PROXY_PASSWORD` / `{dataDir}/secrets/proxy-password`).
1041
+ */
1042
+ export const proxyProfileSchema = z.object({
1043
+ label: z.string().optional(),
1044
+ url: z.string().optional(),
1045
+ httpProxy: z.string().optional(),
1046
+ httpsProxy: z.string().optional(),
1047
+ allProxy: z.string().optional(),
1048
+ auth: proxyAuthConfigSchema.optional(),
1049
+ tls: proxyTlsConfigSchema.optional(),
1050
+ });
1051
+ /** Действие правила маршрутизации: через прокси либо напрямую. */
1052
+ export const proxyRuleActionSchema = z.enum(['proxy', 'direct']);
1053
+ /**
1054
+ * Правило маршрутизации по хосту (порядок = приоритет, первое совпадение).
1055
+ * `hosts` — exact, `.suffix` (apex+sub), `*.suffix` (sub), `host:port`, IP, CIDR, `*`.
1056
+ * `action: direct` несовместим с `profile`.
1057
+ */
1058
+ export const proxyRuleSchema = z.object({
1059
+ id: z.string().min(1).optional(),
1060
+ label: z.string().optional(),
1061
+ hosts: z.array(z.string().min(1)).min(1),
1062
+ action: proxyRuleActionSchema,
1063
+ profile: proxyProfileNameSchema.optional(),
1064
+ });
1065
+ /**
1066
+ * ADR-099 (D1/D2a): HTTP/HTTPS-прокси единого egress-слоя.
1067
+ *
1068
+ * - `enabled` — явный выключатель; **не задан** — прокси включается наличием
1069
+ * URL (в т.ч. из стандартных env при `fromEnv`); явный `false` подавляет
1070
+ * стандартные `HTTP_PROXY`/… (прокси не включается «из окружения»);
1071
+ * - `url` + `httpProxy`/`httpsProxy`/`allProxy` — URL прокси (`http`/`https`;
1072
+ * userinfo допускается, креды вырезаются в resolved-конфиг; SOCKS5 — D2b);
1073
+ * - `auth` — Basic-аутентификация (`username`; пароль — env/файл, не config);
1074
+ * - `tls` — TLS/mTLS к самому прокси (`proxyTls`);
1075
+ * - `noProxy` — исключения (host, `.suffix`, `*.suffix`, `host:port`, IP, CIDR, `*`);
1076
+ * - `fromEnv` — учитывать стандартные `HTTP_PROXY`/`HTTPS_PROXY`/`ALL_PROXY`/`NO_PROXY`;
1077
+ * - `fallbackDirect` — явный opt-in: при недоступном прокси идти напрямую (warn);
1078
+ * - `connectTimeoutMs` — таймаут соединения с прокси.
1079
+ *
1080
+ * Эффективные значения — `resolveProxyConfig` (`config/proxy.ts`), приоритет
1081
+ * `SYNTH_PROXY_*` > config.yaml > стандартные env > defaults (ADR-023).
1082
+ */
1083
+ export const proxyConfigSchema = z.object({
1084
+ enabled: z.boolean().optional(),
1085
+ /**
1086
+ * Per-host маршрутизация: `all` — `defaultProfile` для всех, кроме `noProxy`
1087
+ * (правила могут переопределить); `selected` — только правила, остальное напрямую.
1088
+ */
1089
+ mode: z.enum(PROXY_MODES).default('all'),
1090
+ /** Профиль для `mode: all` и правил без явного `profile` (по умолчанию `default`). */
1091
+ defaultProfile: proxyProfileNameSchema.optional(),
1092
+ /** Именованные профили. При наличии top-level URL/auth/tls запрещены. */
1093
+ profiles: z.record(proxyProfileNameSchema, proxyProfileSchema).optional(),
1094
+ /** Правила маршрутизации (первое совпадение). */
1095
+ rules: z.array(proxyRuleSchema).optional(),
1096
+ url: z.string().optional(),
1097
+ httpProxy: z.string().optional(),
1098
+ httpsProxy: z.string().optional(),
1099
+ allProxy: z.string().optional(),
1100
+ auth: proxyAuthConfigSchema.optional(),
1101
+ tls: proxyTlsConfigSchema.optional(),
1102
+ noProxy: z.array(z.string()).default([]),
1103
+ fromEnv: z.boolean().default(true),
1104
+ fallbackDirect: z.boolean().default(false),
1105
+ connectTimeoutMs: z.number().int().min(1).default(10_000),
1106
+ });
459
1107
  // --- LLM Gateway (ADR-036) ---
460
1108
  export const llmGatewayRateLimitConfigSchema = z.object({
461
1109
  userPerMinute: z.number().int().min(1).default(DEFAULT_LLM_GATEWAY_RATE_LIMIT.userPerMinute),
@@ -474,23 +1122,23 @@ export const llmGatewayConfigSchema = z.object({
474
1122
  logPayloads: z.boolean().default(false),
475
1123
  /** Путь к JSONL полного лога; по умолчанию {dataDir}/audit/llm-payloads.jsonl. */
476
1124
  payloadLogPath: z.string().default(''),
477
- rateLimit: llmGatewayRateLimitConfigSchema.default({}),
478
- audit: llmGatewayAuditConfigSchema.default({}),
1125
+ rateLimit: llmGatewayRateLimitConfigSchema.prefault({}),
1126
+ audit: llmGatewayAuditConfigSchema.prefault({}),
479
1127
  });
480
1128
  // --- Router (ADR-034) ---
481
1129
  export const routerContentConfigSchema = z.object({
482
1130
  coding: z.object({
483
1131
  provider: z.string().default(''),
484
1132
  model: z.string().default(''),
485
- }).default({}),
1133
+ }).prefault({}),
486
1134
  chat: z.object({
487
1135
  provider: z.string().default(''),
488
1136
  model: z.string().default(''),
489
- }).default({}),
1137
+ }).prefault({}),
490
1138
  research: z.object({
491
1139
  provider: z.string().default(''),
492
1140
  model: z.string().default(''),
493
- }).default({}),
1141
+ }).prefault({}),
494
1142
  });
495
1143
  export const routerEscalationConfigSchema = z.object({
496
1144
  enabled: z.boolean().default(true),
@@ -528,10 +1176,10 @@ export const microFirstConfigSchema = z.object({
528
1176
  export const routerConfigSchema = z.object({
529
1177
  enabled: z.boolean().default(true),
530
1178
  strategy: z.enum(['content', 'cost', 'content+cost', 'auto']).default('auto'),
531
- content: routerContentConfigSchema.default({}),
532
- escalation: routerEscalationConfigSchema.default({}),
533
- cost: routerCostConfigSchema.default({}),
534
- subagent: routerSubagentConfigSchema.default({}),
1179
+ content: routerContentConfigSchema.prefault({}),
1180
+ escalation: routerEscalationConfigSchema.prefault({}),
1181
+ cost: routerCostConfigSchema.prefault({}),
1182
+ subagent: routerSubagentConfigSchema.prefault({}),
535
1183
  });
536
1184
  // --- Remote (гибридный режим) ---
537
1185
  export const remoteConfigSchema = z.object({
@@ -548,7 +1196,7 @@ export const remoteConfigSchema = z.object({
548
1196
  /** OIDC client_id (public client). Для device flow. */
549
1197
  clientId: z.string().default(''),
550
1198
  })
551
- .default({}),
1199
+ .prefault({}),
552
1200
  /** Куда идут LLM-запросы локальных сессий: server (централизация) | local. По умолчанию server. */
553
1201
  llm: z.enum(['server', 'local']).default('server'),
554
1202
  worlds: z
@@ -556,38 +1204,49 @@ export const remoteConfigSchema = z.object({
556
1204
  local: z.boolean().default(true),
557
1205
  remote: z.boolean().default(true),
558
1206
  })
559
- .default({}),
1207
+ .prefault({}),
560
1208
  /** Путь к файлу credentials (пусто → ~/.config/synth/credentials.json). */
561
1209
  credentialsPath: z.string().default(''),
562
1210
  timeoutMs: z.number().int().min(1).default(15000),
563
1211
  });
564
1212
  export const synthConfigSchema = z.object({
565
- server: serverConfigSchema.default({}),
566
- storage: storageConfigSchema.default({}),
567
- auth: authConfigSchema.default({}),
568
- llm: llmConfigSchema.default({}),
569
- core: coreConfigSchema.default({}),
570
- runner: runnerConfigSchema.default({}),
571
- ui: uiConfigSchema.default({}),
572
- i18n: i18nConfigSchema.default({}),
573
- logging: loggingConfigSchema.default({}),
574
- tsm: tsmConfigSchema.default({}),
575
- session: sessionConfigSchema.default({}),
576
- context: contextConfigSchema.default({}),
577
- summarization: summarizationConfigSchema.default({}),
578
- mcp: mcpConfigSchema.default({}),
579
- tools: toolsConfigSchema.default({}),
580
- skills: skillsConfigSchema.default({}),
581
- commands: commandsConfigSchema.default({}),
582
- events: eventsConfigSchema.default({}),
583
- scheduler: schedulerConfigSchema.default({}),
584
- decision: decisionConfigSchema.default({}),
585
- webhooks: webhooksConfigSchema.default({}),
586
- instructions: instructionsConfigSchema.default({}),
587
- router: routerConfigSchema.default({}),
588
- remote: remoteConfigSchema.default({}),
589
- microFirst: microFirstConfigSchema.default({}),
590
- llmGateway: llmGatewayConfigSchema.default({}),
591
- permission: permissionConfigSchema.default({}),
592
- security: securityConfigSchema.default({}),
1213
+ server: serverConfigSchema.prefault({}),
1214
+ storage: storageConfigSchema.prefault({}),
1215
+ execution: executionConfigSchema.prefault({}),
1216
+ auth: authConfigSchema.prefault({}),
1217
+ llm: llmConfigSchema.prefault({}),
1218
+ core: coreConfigSchema.prefault({}),
1219
+ runner: runnerConfigSchema.prefault({}),
1220
+ ui: uiConfigSchema.prefault({}),
1221
+ i18n: i18nConfigSchema.prefault({}),
1222
+ logging: loggingConfigSchema.prefault({}),
1223
+ tsm: tsmConfigSchema.prefault({}),
1224
+ session: sessionConfigSchema.prefault({}),
1225
+ context: contextConfigSchema.prefault({}),
1226
+ summarization: summarizationConfigSchema.prefault({}),
1227
+ mcp: mcpConfigSchema.prefault({}),
1228
+ tools: toolsConfigSchema.prefault({}),
1229
+ skills: skillsConfigSchema.prefault({}),
1230
+ commands: commandsConfigSchema.prefault({}),
1231
+ events: eventsConfigSchema.prefault({}),
1232
+ scheduler: schedulerConfigSchema.prefault({}),
1233
+ decision: decisionConfigSchema.prefault({}),
1234
+ oauth: oauthConfigSchema.prefault({}),
1235
+ analytics: analyticsConfigSchema.prefault({}),
1236
+ questions: questionsConfigSchema.prefault({}),
1237
+ background: backgroundConfigSchema.prefault({}),
1238
+ attachments: attachmentsConfigSchema.prefault({}),
1239
+ metrics: metricsConfigSchema.prefault({}),
1240
+ authority: authorityConfigSchema.prefault({}),
1241
+ plugins: pluginsConfigSchema.prefault({}),
1242
+ egress: egressConfigSchema.prefault({}),
1243
+ webhooks: webhooksConfigSchema.prefault({}),
1244
+ instructions: instructionsConfigSchema.prefault({}),
1245
+ router: routerConfigSchema.prefault({}),
1246
+ proxy: proxyConfigSchema.prefault({}),
1247
+ remote: remoteConfigSchema.prefault({}),
1248
+ microFirst: microFirstConfigSchema.prefault({}),
1249
+ llmGateway: llmGatewayConfigSchema.prefault({}),
1250
+ permission: permissionConfigSchema.prefault({}),
1251
+ security: securityConfigSchema.prefault({}),
593
1252
  });