@itphx/synth-shared 0.10.0 → 0.11.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 (83) hide show
  1. package/dist/config/defaults.js +60 -14
  2. package/dist/config/env-overrides.d.ts +7 -4
  3. package/dist/config/env-overrides.js +46 -13
  4. package/dist/config/index.d.ts +3 -0
  5. package/dist/config/index.js +3 -0
  6. package/dist/config/loader.d.ts +2 -2
  7. package/dist/config/loader.js +23 -4
  8. package/dist/config/proxy.d.ts +415 -0
  9. package/dist/config/proxy.js +1565 -0
  10. package/dist/config/resolve.d.ts +77 -10
  11. package/dist/config/resolve.js +203 -17
  12. package/dist/config/tls-runtime.d.ts +78 -0
  13. package/dist/config/tls-runtime.js +356 -0
  14. package/dist/config/tls.d.ts +215 -0
  15. package/dist/config/tls.js +394 -0
  16. package/dist/config/types.d.ts +1820 -334
  17. package/dist/config/types.js +320 -54
  18. package/dist/i18n/index.d.ts +1 -1
  19. package/dist/i18n/index.js +18 -10
  20. package/dist/index.d.ts +11 -2
  21. package/dist/index.js +11 -2
  22. package/dist/interfaces/index.d.ts +3 -3
  23. package/dist/protocols/index.d.ts +0 -1
  24. package/dist/schemas/index.d.ts +230 -105
  25. package/dist/schemas/index.js +121 -74
  26. package/dist/skills/frontmatter.js +1 -1
  27. package/dist/types/agent.d.ts +30 -0
  28. package/dist/types/agent.js +1 -0
  29. package/dist/types/analytics.d.ts +113 -0
  30. package/dist/types/analytics.js +61 -0
  31. package/dist/types/bus-events.d.ts +7 -0
  32. package/dist/types/bus-events.js +1 -0
  33. package/dist/types/commands.d.ts +10 -10
  34. package/dist/types/commands.js +2 -2
  35. package/dist/types/decision.d.ts +16 -16
  36. package/dist/types/decision.js +4 -4
  37. package/dist/types/egress.d.ts +114 -0
  38. package/dist/types/egress.js +68 -0
  39. package/dist/types/events.d.ts +22 -23
  40. package/dist/types/fs.d.ts +55 -0
  41. package/dist/types/fs.js +27 -0
  42. package/dist/types/git.d.ts +63 -0
  43. package/dist/types/git.js +1 -0
  44. package/dist/types/hooks.d.ts +24 -4
  45. package/dist/types/index.d.ts +15 -1165
  46. package/dist/types/index.js +44 -244
  47. package/dist/types/llm.d.ts +32 -0
  48. package/dist/types/llm.js +8 -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 +169 -0
  52. package/dist/types/mcp.js +119 -0
  53. package/dist/types/message.d.ts +63 -0
  54. package/dist/types/message.js +12 -0
  55. package/dist/types/permission.d.ts +9 -7
  56. package/dist/types/permission.js +1 -1
  57. package/dist/types/project.d.ts +134 -0
  58. package/dist/types/project.js +67 -0
  59. package/dist/types/prompt.d.ts +237 -0
  60. package/dist/types/prompt.js +15 -0
  61. package/dist/types/provider.d.ts +84 -0
  62. package/dist/types/provider.js +35 -0
  63. package/dist/types/schedules.d.ts +8 -8
  64. package/dist/types/schedules.js +1 -1
  65. package/dist/types/service-keys.d.ts +10 -10
  66. package/dist/types/service-keys.js +3 -3
  67. package/dist/types/session.d.ts +268 -0
  68. package/dist/types/session.js +13 -0
  69. package/dist/types/skills.d.ts +11 -11
  70. package/dist/types/skills.js +6 -6
  71. package/dist/types/tools.d.ts +3 -3
  72. package/dist/types/user.d.ts +113 -0
  73. package/dist/types/user.js +31 -0
  74. package/dist/types/webhooks.d.ts +6 -6
  75. package/dist/types/webhooks.js +1 -1
  76. package/dist/utils/glob.d.ts +1 -1
  77. package/dist/utils/glob.js +1 -1
  78. package/dist/utils/index.d.ts +15 -0
  79. package/dist/utils/index.js +55 -2
  80. package/dist/utils/workspace.js +1 -1
  81. package/dist/version.d.ts +1 -1
  82. package/dist/version.js +1 -1
  83. package/package.json +1 -1
@@ -1,7 +1,7 @@
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, MIN_UPLOAD_BYTES, MAX_UPLOAD_BYTES_LIMIT, ToolCapability, } from '../types/index.js';
5
5
  const toolCapabilityValues = Object.values(ToolCapability);
6
6
  // --- SynthConfig: единый конфиг для всех компонентов ---
7
7
  export const serverConfigSchema = z.object({
@@ -10,17 +10,92 @@ export const serverConfigSchema = z.object({
10
10
  corsOrigin: z.string().default('http://localhost:5002'),
11
11
  allowedOrigins: z.array(z.string()).default([]),
12
12
  });
13
+ /**
14
+ * PROP-032: параметры подключения к PostgreSQL (секция `storage.postgres`).
15
+ *
16
+ * Пароль здесь **не хранится** (инвариант 13) — его читает резолвер
17
+ * `resolvePostgresPassword` (env `SYNTH_POSTGRES_PASSWORD` → файл
18
+ * `{dataDir}/secrets/postgres-password`); решение об ошибке отсутствия пароля
19
+ * принимает драйвер (`@itphx/synth-storage-postgres`). `dsn` задан —
20
+ * приоритетнее отдельных `host`/`port`/`database`/`user`.
21
+ */
22
+ export const postgresStorageConfigSchema = z.object({
23
+ /** Полная строка подключения; задана — приоритетнее host/port/database/user. */
24
+ dsn: z.string().optional(),
25
+ host: z.string().optional(),
26
+ port: z.number().int().min(1).max(65535).optional(),
27
+ database: z.string().optional(),
28
+ user: z.string().optional(),
29
+ /** Схема БД (namespace таблиц). */
30
+ schema: z.string().optional(),
31
+ /**
32
+ * ADR-099/PROP-032: TLS-режим соединения с БД.
33
+ * `disable` — без TLS; `require` — шифрование без проверки сертификата;
34
+ * `verify-full` — проверка сертификата сервера по CA из `security.tls`.
35
+ * `verify-ca` принимается как **алиас** `verify-full` (нормализуется с
36
+ * предупреждением). **Не задано — прежнее поведение (`ssl: false`, без TLS)**,
37
+ * чтобы не сломать dev/существующие установки (dev-сервер без TLS).
38
+ * Читать/мапить — `resolvePostgresConfig` + `buildPostgresSslOptions`
39
+ * (`resolve.ts`/`tls.ts`, core — `storage/storage-context.ts`).
40
+ * TLS-параметры (`sslmode`/`sslrootcert`/…) **запрещены в `dsn`** — `pg`
41
+ * накладывает DSN поверх конфига и молча перекрывает `ssl`.
42
+ */
43
+ sslmode: z.enum(['disable', 'require', 'verify-full', 'verify-ca']).optional(),
44
+ /**
45
+ * Legacy-флаг TLS (`true`/`false`); используется, только если `sslmode` не
46
+ * задан (обратная совместимость). Новые установки — через `sslmode`.
47
+ */
48
+ ssl: z.boolean().optional(),
49
+ /** Максимальный размер пула соединений. */
50
+ poolMax: z.number().int().min(1).optional(),
51
+ });
13
52
  export const storageConfigSchema = z.object({
14
53
  dataDir: z.string().default('/var/synth/data'),
54
+ /**
55
+ * PROP-032: физический backend хранения. `file` — JSON-файлы с атомарной
56
+ * записью tmp→rename (ADR-005, дефолт); `memory` — in-memory (энергонезависимо
57
+ * НЕ сохраняется, для герметичных тестов); `postgres` — БД (драйвер —
58
+ * in-tree опциональный пакет `@itphx/synth-storage-postgres`). Читать через
59
+ * `resolveStorageBackend` (env `SYNTH_STORAGE_BACKEND` > это поле > `file`,
60
+ * fail-closed на неизвестном явно заданном значении).
61
+ *
62
+ * Необязательно: частичные override-объекты (`{ dataDir, workspacesRoot, … }`)
63
+ * остаются валидными, а дефолт `file` задают `defaults.ts`/`resolveStorageBackend`.
64
+ */
65
+ backend: z.enum(['file', 'memory', 'postgres']).optional(),
66
+ /** PROP-032: параметры PostgreSQL-backend (используются при `backend: postgres`). */
67
+ postgres: postgresStorageConfigSchema.default({}),
68
+ /**
69
+ * PROP-032 (волна 5): поведение при недоступности выбранного backend —
70
+ * `fallback-file` (перейти на файловое хранилище в `fallbackDir`, default) |
71
+ * `halt` (остановить старт). Читать через `resolveDegradedMode`
72
+ * (приоритет env `SYNTH_DEGRADED_MODE` > это поле > `fallback-file`).
73
+ */
74
+ degradedMode: z.enum(['fallback-file', 'halt']).default('fallback-file'),
75
+ /**
76
+ * PROP-032 (волна 5): каталог файлового фоллбека при деградации.
77
+ * `''` — не задано (эффективно `{dataDir}/fallback`), читать через
78
+ * `resolveStorageFallbackDir` (приоритет env `SYNTH_STORAGE_FALLBACK_DIR` >
79
+ * это поле > `{dataDir}/fallback`).
80
+ */
81
+ fallbackDir: z.string().default(''),
15
82
  workspacesRoot: z.string().default(''),
16
83
  /** Рабочий каталог по умолчанию для сессий без проекта. Резолвится от dataDir: {dataDir}/workspaces/default. */
17
84
  defaultWorkspace: z.string().default(''),
18
85
  /**
19
- * AD-075: политика для абсолютного `project.workspace` вне `workspacesRoot`
86
+ * ADR-075: политика для абсолютного `project.workspace` вне `workspacesRoot`
20
87
  * (`confirm` — подтверждение, `deny` — запрет). `''` — не задано (эффективно
21
88
  * `confirm`), читать через `resolveWorkspaceOutsideRootPolicy`.
22
89
  */
23
90
  workspaceOutsideRoot: z.enum(['confirm', 'deny']).or(z.literal('')).default(''),
91
+ /**
92
+ * Максимальный размер загружаемого файла (`POST /api/v2/fs/upload`), в байтах.
93
+ * Валидируется (положительное целое в границах `MIN_UPLOAD_BYTES`…
94
+ * `MAX_UPLOAD_BYTES_LIMIT`), читать через `resolveMaxUploadBytes` (env
95
+ * `SYNTH_MAX_UPLOAD_BYTES` > это поле > `DEFAULT_MAX_UPLOAD_BYTES`).
96
+ * Не задано — резолвер подставляет `DEFAULT_MAX_UPLOAD_BYTES` (100 МиБ).
97
+ */
98
+ maxUploadBytes: z.number().int().min(MIN_UPLOAD_BYTES).max(MAX_UPLOAD_BYTES_LIMIT).optional(),
24
99
  });
25
100
  export const authConfigSchema = z.object({
26
101
  debugMode: z.boolean().default(false),
@@ -51,7 +126,7 @@ export const llmConfigSchema = z.object({
51
126
  defaultModel: z.string().default(''),
52
127
  maxRetries: z.number().int().min(0).default(3),
53
128
  timeout: z.number().int().min(1).default(60),
54
- /** AD-070 §2.2: политика prompt-cache — auto (ставить маркеры) | none (отключить). */
129
+ /** ADR-070 §2.2: политика prompt-cache — auto (ставить маркеры) | none (отключить). */
55
130
  cache: z.enum(['auto', 'none']).default('auto'),
56
131
  });
57
132
  export const coreConfigSchema = z.object({
@@ -86,7 +161,7 @@ export const tsmConfigSchema = z.object({
86
161
  maxIterations: z.number().int().min(1).default(50),
87
162
  validationTimeout: z.number().int().min(1).default(30),
88
163
  });
89
- // --- Session (AD-025 / AD-028): настройки по умолчанию для сессий ---
164
+ // --- Session (ADR-025 / ADR-028): настройки по умолчанию для сессий ---
90
165
  export const sessionConfigSchema = z.object({
91
166
  /** Строгость цикла Plan→Build по умолчанию для новых сессий: auto | strict | off. */
92
167
  planMode: z.enum(['auto', 'strict', 'off']).default('auto'),
@@ -102,7 +177,7 @@ export const summarizationConfigSchema = z.object({
102
177
  });
103
178
  export const mcpServerConfigSchema = z.object({
104
179
  type: z.enum(['stdio', 'sse', 'http']),
105
- /** AD-071 §2.2: человекочитаемое описание сервера (попадает в блок `mcp.servers`). */
180
+ /** ADR-071 §2.2: человекочитаемое описание сервера (попадает в блок `mcp.servers`). */
106
181
  description: z.string().optional(),
107
182
  command: z.string().optional(),
108
183
  args: z.array(z.string()).optional(),
@@ -124,43 +199,45 @@ export const mcpServerConfigSchema = z.object({
124
199
  connectTimeout: z.number().int().min(1).optional(),
125
200
  });
126
201
  /**
127
- * AD-071 §2.3.1: политика сетевого доступа пользовательских HTTP MCP-серверов.
202
+ * ADR-071 §2.3.1: политика сетевого доступа пользовательских HTTP MCP-серверов.
128
203
  * Дефолт — `deny` приватных/служебных диапазонов (SSRF/egress).
129
204
  */
130
205
  export const mcpNetworkPolicySchema = z.object({
131
206
  mode: z.enum(MCP_NETWORK_POLICY_MODES).default(DEFAULT_MCP_NETWORK_POLICY.mode),
132
207
  list: z.array(z.string()).default([...DEFAULT_MCP_PRIVATE_CIDRS]),
208
+ /** Allow-правила-исключения (общий формат с `egress.*`). */
209
+ exceptions: z.array(z.string()).default([]),
133
210
  });
134
211
  export const mcpConfigSchema = z.object({
135
212
  servers: z.record(z.string(), mcpServerConfigSchema).default({}),
136
213
  networkPolicy: mcpNetworkPolicySchema.default({}),
137
214
  /**
138
- * AD-071 §2.3: глобальная админская политика включения **MCP**-инструментов.
215
+ * ADR-071 §2.3: глобальная админская политика включения **MCP**-инструментов.
139
216
  * Независима от `tools.policy` (только встроенные). Per-session override —
140
217
  * `SessionSettings.mcpPolicy`.
141
218
  */
142
219
  policy: z.enum(TOOLS_POLICIES).default('auto'),
143
220
  });
144
- // --- Инструменты (AD-071 §2.3) ---
221
+ // --- Инструменты (ADR-071 §2.3) ---
145
222
  /**
146
- * AD-071 §2.6: instance-wide жёсткое отключение инструментов администратором.
223
+ * ADR-071 §2.6: instance-wide жёсткое отключение инструментов администратором.
147
224
  * Отключённые тулы не попадают в запрос независимо от `tools.policy`.
148
225
  * `runtime`-capability неотключаема (ядро сессии).
149
226
  */
150
227
  export const toolsDisabledConfigSchema = createToolsDisabledSchema(false);
151
228
  /**
152
- * AD-071 §2.3: глобальная админская политика включения **встроенных**
229
+ * ADR-071 §2.3: глобальная админская политика включения **встроенных**
153
230
  * инструментов (MCP — отдельная `mcp.policy`). Per-session override —
154
231
  * `SessionSettings.toolsPolicy`.
155
232
  */
156
233
  export const toolsConfigSchema = z.object({
157
234
  policy: z.enum(TOOLS_POLICIES).default('auto'),
158
- /** AD-071 §2.6: instance-wide отключение инструментов (admin). */
235
+ /** ADR-071 §2.6: instance-wide отключение инструментов (admin). */
159
236
  disabled: toolsDisabledConfigSchema.default({}),
160
237
  });
161
- // --- Скиллы (AD-046) ---
238
+ // --- Скиллы (ADR-046) ---
162
239
  /**
163
- * AD-046 §4.2/§4.4/§7.4: конфигурация механизма скиллов.
240
+ * ADR-046 §4.2/§4.4/§7.4: конфигурация механизма скиллов.
164
241
  * `paths` — дополнительные пользовательские каталоги; `trustedProjectDirs` —
165
242
  * доверенные проектные каталоги (бинарный trust); `inlineShell` — выключатель
166
243
  * `!`cmd`` в шаблонных командах (по умолчанию выключено).
@@ -168,27 +245,27 @@ export const toolsConfigSchema = z.object({
168
245
  * `urls` — внешние удалённые каталоги (opencode-совместимый `index.json`):
169
246
  * **только read-only индексация** — скачиваются в `{dataDir}/skills-cache/urls`,
170
247
  * видны в реестре/диагностике, но `trusted: false` (в каталог для модели не
171
- * попадают, тело не грузится). Установка/доверие/подписи/`lock.json` — AD-068.
248
+ * попадают, тело не грузится). Установка/доверие/подписи/`lock.json` — PROP-068.
172
249
  *
173
250
  * Внешние локальные каталоги совместимости (`.opencode`, `.claude`, `.agents`,
174
- * `~/.config/opencode`) подключаются как read-only discovery в core (AD-046 §4.2).
251
+ * `~/.config/opencode`) подключаются как read-only discovery в core (ADR-046 §4.2).
175
252
  */
176
253
  export const skillsConfigSchema = z.object({
177
254
  paths: z.array(z.string()).default([]),
178
- /** AD-046 §4.2/§4.3: удалённые каталоги — read-only индексация (`trusted: false`). */
255
+ /** ADR-046 §4.2/§4.3: удалённые каталоги — read-only индексация (`trusted: false`). */
179
256
  urls: z.array(z.string()).default([]),
180
257
  trustedProjectDirs: z.array(z.string()).default([]),
181
258
  inlineShell: z.boolean().default(false),
182
259
  /**
183
- * AD-046 §3.2/§12: именованные группы тулов → capabilities. Используется
260
+ * ADR-046 §3.2/§12: именованные группы тулов → capabilities. Используется
184
261
  * для экспансии `metadata.synth.requires_toolsets` в проверку доступности
185
262
  * скилла (union с `requires_capabilities`).
186
263
  */
187
264
  toolsets: z.record(z.string(), z.array(z.enum(toolCapabilityValues))).default({}),
188
265
  });
189
- // --- Slash-команды (AD-046 §7) ---
266
+ // --- Slash-команды (ADR-046 §7) ---
190
267
  /**
191
- * AD-046 §7/§9.4: конфигурация slash-команд. `paths` — дополнительные каталоги
268
+ * ADR-046 §7/§9.4: конфигурация slash-команд. `paths` — дополнительные каталоги
192
269
  * шаблонных `.md`-команд; `bundlesPath` — подкаталог `{dataDir}` для YAML-бандлов;
193
270
  * `conflict` — режим разрешения конфликтов имён (см. resolver).
194
271
  */
@@ -204,9 +281,9 @@ export const commandsConfigSchema = z.object({
204
281
  maxArgumentsLength: z.number().int().min(1).default(10_000),
205
282
  maxRenderedBytes: z.number().int().min(1).default(200_000),
206
283
  });
207
- // --- Внешние события (AD-089) ---
284
+ // --- Внешние события (ADR-089) ---
208
285
  /**
209
- * AD-089: конфигурация приёма внешних событий.
286
+ * ADR-089: конфигурация приёма внешних событий.
210
287
  * - `enabled` — мастер-выключатель приёма событий;
211
288
  * - `defaultMode` — режим по умолчанию, если Router не выбрал иной;
212
289
  * - `ephemeralTtl` — TTL ephemeral-сессий по умолчанию;
@@ -221,18 +298,18 @@ export const commandsConfigSchema = z.object({
221
298
  * `default-agent` — не задавать `agentRole` (сессия возьмёт агента по умолчанию);
222
299
  * - `keyRateLimitPerMinute` — глобальный дефолт лимита запросов/мин на API-ключ
223
300
  * привязки (0 — без лимита; конкретный ключ может переопределить);
224
- * - `decisionRouting` — AD-084 × AD-089: умная классификация внешних событий
301
+ * - `decisionRouting` — ADR-084 × ADR-089: умная классификация внешних событий
225
302
  * decision-моделью. `false` (default, opt-in) — только декларативные правила
226
303
  * (`ProjectRuleProvider`); `true` — при промахе правил decision-модель выбирает
227
304
  * шаблон агента для ephemeral-сессии. Fail-safe: ошибка/неуверенность/пустой
228
305
  * список агентов → фоллбек Router (`defaultMode`);
229
- * - `autoBind` — AD-089: фоллбек Router закрепляет событие с `identity.chatKey`/
306
+ * - `autoBind` — ADR-089: фоллбек Router закрепляет событие с `identity.chatKey`/
230
307
  * `threadKey` за новой сессией (`EventBinding` `mode='bound'`) вместо
231
308
  * `defaultMode`. `false` (default) — поведение не меняется; влияет только на
232
309
  * фоллбек;
233
310
  * - `autoBindAgentTemplate` — шаблон агента для auto-bind-сессий (пусто — агент
234
311
  * по умолчанию);
235
- * - `identityMap` — AD-089: маппинг идентичности внешнего отправителя на
312
+ * - `identityMap` — ADR-089: маппинг идентичности внешнего отправителя на
236
313
  * владельца синт-сессии. Ключ — `identity.chatKey` (`chat:telegram:<id>`) или
237
314
  * `identity.principalId` (`tg:<id>`), значение — id пользователя
238
315
  * синт-инстанса. Применяется при материализации сессий `ephemeral`/`bind`:
@@ -249,19 +326,19 @@ export const eventsConfigSchema = z.object({
249
326
  dedupStore: z.enum(['memory', 'file']).default('memory'),
250
327
  unknownAgentTemplate: z.enum(['drop', 'default-agent']).default('drop'),
251
328
  /**
252
- * Глобальный дефолт лимита запросов/мин на API-ключ привязки (AD-089/AD-052).
329
+ * Глобальный дефолт лимита запросов/мин на API-ключ привязки (ADR-089/ADR-052).
253
330
  * `0` — без лимита; конкретный ключ может переопределить своим
254
331
  * `rateLimitPerMinute`.
255
332
  */
256
333
  keyRateLimitPerMinute: z.number().int().min(0).default(0),
257
334
  /**
258
- * AD-084 × AD-089: decision-маршрутизация внешних событий. По умолчанию
335
+ * ADR-084 × ADR-089: decision-маршрутизация внешних событий. По умолчанию
259
336
  * выключена (поведение не меняется) — включение требует настроенного
260
337
  * decision-провайдера (`decision.enabled`).
261
338
  */
262
339
  decisionRouting: z.boolean().default(false),
263
340
  /**
264
- * AD-089 (auto-bind): фоллбек Router — если у события есть `identity.chatKey`
341
+ * ADR-089 (auto-bind): фоллбек Router — если у события есть `identity.chatKey`
265
342
  * или `identity.threadKey`, закрепить его за новой сессией (создать
266
343
  * `EventBinding` `mode='bound'`) вместо `defaultMode`. По умолчанию выключено
267
344
  * (поведение не меняется). Влияет **только** на фоллбек — явный binding,
@@ -269,12 +346,12 @@ export const eventsConfigSchema = z.object({
269
346
  */
270
347
  autoBind: z.boolean().default(false),
271
348
  /**
272
- * AD-089 (auto-bind): шаблон агента для auto-bind-сессий (пусто — агент по
349
+ * ADR-089 (auto-bind): шаблон агента для auto-bind-сессий (пусто — агент по
273
350
  * умолчанию; резолвится через `AgentRegistry` с политикой `unknownAgentTemplate`).
274
351
  */
275
352
  autoBindAgentTemplate: z.string().default(''),
276
353
  /**
277
- * AD-089: маппинг идентичности внешнего отправителя (`identity.chatKey` или
354
+ * ADR-089: маппинг идентичности внешнего отправителя (`identity.chatKey` или
278
355
  * `identity.principalId`) на владельца синт-сессии (id пользователя
279
356
  * инстанса). Применяется при материализации `ephemeral`/`bind`; пусто —
280
357
  * владелец не переопределяется (аутентифицированный пользователь запроса,
@@ -282,31 +359,33 @@ export const eventsConfigSchema = z.object({
282
359
  */
283
360
  identityMap: z.record(z.string(), z.string()).default({}),
284
361
  });
285
- // --- Планировщик расписаний (AD-051 срез / AD-089) ---
362
+ // --- Планировщик расписаний (ADR-051 срез / ADR-089) ---
286
363
  /**
287
- * AD-051 (минимальный срез) / AD-089: конфигурация cron/interval-планировщика.
364
+ * ADR-051 (минимальный срез) / ADR-089: конфигурация cron/interval-планировщика.
288
365
  * - `enabled` — мастер-выключатель сервиса (в standalone гейтит `start()`);
289
366
  * - `tickSec` — период тика, секунды (1..3600);
290
367
  * - `catchUp` — дефолт поведения при пропущенном срабатывании (`skip`/`once`);
291
368
  * - `jobRetentionDays` — срок хранения Job-истории (дни, `prune` на старте);
292
369
  * - `leaderElection` — выбор лидера-владельца тикера: `none` (каждый процесс
293
370
  * считает себя лидером, поведение single-process) | `file` (file-based lock на
294
- * общем `dataDir`). Default — `none` (OFF);
371
+ * общем `dataDir`) | `postgres` (session-level advisory-lock БД; требует
372
+ * `storage.backend=postgres`, иначе — `AlwaysLeader`). Default — `none` (OFF);
295
373
  * - `crossProcessLocks` — межпроцессная сериализация мутаций `ScheduleStore`
296
374
  * (file-мьютекс поверх in-process `AsyncLock`). Default — `false` (OFF):
297
- * поведение single-process не меняется.
375
+ * поведение single-process не меняется. Под `storage.backend=postgres`
376
+ * `ScheduleStore` не используется (мутации — атомарные SQL), лок не создаётся.
298
377
  */
299
378
  export const schedulerConfigSchema = z.object({
300
379
  enabled: z.boolean().default(true),
301
380
  tickSec: z.number().int().min(1).max(3600).default(60),
302
381
  catchUp: z.enum(['skip', 'once']).default('skip'),
303
382
  jobRetentionDays: z.number().int().min(0).default(30),
304
- leaderElection: z.enum(['none', 'file']).default('none'),
383
+ leaderElection: z.enum(['none', 'file', 'postgres']).default('none'),
305
384
  crossProcessLocks: z.boolean().default(false),
306
385
  });
307
- // --- Decision-модели (AD-084) ---
386
+ // --- Decision-модели (ADR-084) ---
308
387
  /**
309
- * AD-084: конфигурация класса decision-моделей (System One: Clef/Jev/…).
388
+ * ADR-084: конфигурация класса decision-моделей (System One: Clef/Jev/…).
310
389
  * - `enabled` — мастер-выключатель decision-слоя (по умолчанию выключен);
311
390
  * - `provider` — имя провайдера decision-типа (`decision`/`systemone`);
312
391
  * - `model` — модель decision-слоя (напр. `clef-flash`);
@@ -323,31 +402,81 @@ export const decisionConfigSchema = z.object({
323
402
  provider: z.string().default(''),
324
403
  model: z.string().default(''),
325
404
  confidenceThreshold: z.number().min(0).max(1).default(0.6),
326
- /** AD-084: провайдер тира эскалации; пусто — эскалации нет. */
405
+ /** ADR-084: провайдер тира эскалации; пусто — эскалации нет. */
327
406
  escalationProvider: z.string().default(''),
328
- /** AD-084: модель тира эскалации; пусто — эскалации нет. */
407
+ /** ADR-084: модель тира эскалации; пусто — эскалации нет. */
329
408
  escalationModel: z.string().default(''),
330
409
  });
331
- // --- Webhooks (AD-052, этап II) ---
410
+ // --- Аналитика и отчётность (PROP-102) ---
411
+ /**
412
+ * PROP-102: конфигурация аналитики инстанса.
413
+ * - `retentionDays` — срок хранения суточных роллапов (UTC-дни): бакеты со
414
+ * `day < utcDay(now) - retentionDays` удаляются прунером. `<= 0` — без
415
+ * ограничения. Default — 400.
416
+ */
417
+ export const analyticsConfigSchema = z.object({
418
+ retentionDays: z.number().int().default(400),
419
+ });
420
+ // --- Наблюдаемость: Prometheus-метрики (ADR-094) ---
332
421
  /**
333
- * AD-052 (этап II): конфигурация исходящих webhooks.
422
+ * ADR-094: конфигурация экспорта метрик.
423
+ * - `enabled` — включает `GET /metrics` и сбор HTTP/процессных метрик
424
+ * (по умолчанию выключено — контракт «эндпоинта нет, пока не включили»).
425
+ *
426
+ * Bearer-токен в конфиге **не хранится** (инвариант 13): env
427
+ * `SYNTH_METRICS_TOKEN` либо файл `{dataDir}/secrets/metrics-token`.
428
+ * Имя env совпадает с Helm-чартом (`SYNTH_METRICS_ENABLED`).
429
+ */
430
+ export const metricsConfigSchema = z.object({
431
+ enabled: z.boolean().default(false),
432
+ });
433
+ // --- Webhooks (ADR-052, этап II) ---
434
+ /**
435
+ * ADR-052 (этап II): конфигурация исходящих webhooks.
334
436
  * - `enabled` — мастер-выключатель доставки (по умолчанию выключен);
335
437
  * - `maxAttempts` — число HTTP-попыток на доставку (экспоненциальный backoff с джиттером);
336
438
  * - `timeoutMs` — таймаут одного HTTP-запроса;
337
- * - `allowPrivateTargets` — разрешить http и приватные/loopback адреса (для dev;
338
- * по умолчанию `false` — только https и публичные адреса, защита от SSRF);
339
439
  * - `deliveryRetentionDays` — срок хранения журнала доставок (0 — без ограничения).
440
+ *
441
+ * Политика egress (https/приватные адреса) вынесена в `egress.webhooks`
442
+ * (`mode: 'off'` заменяет удалённый `allowPrivateTargets`).
340
443
  */
341
444
  export const webhooksConfigSchema = z.object({
342
445
  enabled: z.boolean().default(false),
343
446
  maxAttempts: z.number().int().min(1).max(10).default(5),
344
447
  timeoutMs: z.number().int().min(1).default(10_000),
345
- allowPrivateTargets: z.boolean().default(false),
346
448
  deliveryRetentionDays: z.number().int().min(0).default(30),
347
449
  });
348
- // --- Проектные инструкции (AD-069) ---
450
+ // --- Egress-политика (shared формат tools/webhooks/MCP) ---
451
+ /** Общий формат политики egress (`mode` + `list` + `exceptions`). */
452
+ export const egressPolicySchema = z.object({
453
+ mode: z.enum(EGRESS_POLICY_MODES).default(DEFAULT_EGRESS_TOOLS_POLICY.mode),
454
+ list: z.array(z.string()).default([...DEFAULT_MCP_PRIVATE_CIDRS]),
455
+ exceptions: z.array(z.string()).default([]),
456
+ });
457
+ /** Политика webhooks: дополнительно `off` (dev — без проверок и без https). */
458
+ export const webhooksEgressPolicySchema = z.object({
459
+ mode: z.enum(WEBHOOKS_EGRESS_POLICY_MODES).default(DEFAULT_EGRESS_WEBHOOKS_POLICY.mode),
460
+ list: z.array(z.string()).default([...DEFAULT_MCP_PRIVATE_CIDRS]),
461
+ exceptions: z.array(z.string()).default([]),
462
+ });
463
+ export const egressLogConfigSchema = z.object({
464
+ enabled: z.boolean().default(DEFAULT_EGRESS_LOG.enabled),
465
+ retentionDays: z.number().int().min(0).default(DEFAULT_EGRESS_LOG.retentionDays),
466
+ });
349
467
  /**
350
- * AD-069 §3.4/§11: дополнительный источник проектных инструкций.
468
+ * `egress` — настраиваемая политика исходящих запросов (tools/webhooks) и
469
+ * журнал внешних запросов. `mcp.networkPolicy` остаётся отдельным ключом, но
470
+ * использует тот же формат (mode `deny|allow` + `exceptions`).
471
+ */
472
+ export const egressConfigSchema = z.object({
473
+ tools: egressPolicySchema.default({}),
474
+ webhooks: webhooksEgressPolicySchema.default({}),
475
+ log: egressLogConfigSchema.default({}),
476
+ });
477
+ // --- Проектные инструкции (ADR-069) ---
478
+ /**
479
+ * ADR-069 §3.4/§11: дополнительный источник проектных инструкций.
351
480
  * `position` задаёт место в порядке: `before` — перед merged chain, `after` —
352
481
  * после. `ttlSec` (только для URL) переопределяет `instructions.fetch.cacheTtlSec`.
353
482
  */
@@ -359,7 +488,7 @@ export const instructionSourceConfigSchema = z.object({
359
488
  ttlSec: z.number().int().min(0).optional(),
360
489
  });
361
490
  /**
362
- * AD-069 §4: параметры lazy-догрузки подкаталогов (реализация — Фаза 2;
491
+ * ADR-069 §4: параметры lazy-догрузки подкаталогов (реализация — Фаза 2;
363
492
  * схема заводится в Фазе 1).
364
493
  */
365
494
  export const instructionsLazyConfigSchema = z.object({
@@ -371,7 +500,7 @@ export const instructionsLazyConfigSchema = z.object({
371
500
  .default(['node_modules', '.git', 'vendor', 'dist', 'build', '.next', 'coverage', 'tmp', '.cache']),
372
501
  });
373
502
  /**
374
- * AD-069 §5.1/§9.1: параметры fetch URL-источников (без фонового таймера —
503
+ * ADR-069 §5.1/§9.1: параметры fetch URL-источников (без фонового таймера —
375
504
  * загрузка при старте + TTL-кэш). Реализация fetch — Фаза 2.
376
505
  */
377
506
  export const instructionsFetchConfigSchema = z.object({
@@ -380,7 +509,7 @@ export const instructionsFetchConfigSchema = z.object({
380
509
  maxBytes: z.number().int().min(1).default(262_144),
381
510
  });
382
511
  /**
383
- * AD-069 §5.1/§9.1: конфигурация проектных инструкций (`AGENTS.md` и совместимые).
512
+ * ADR-069 §5.1/§9.1: конфигурация проектных инструкций (`AGENTS.md` и совместимые).
384
513
  * Порядок: `sources` с `position: before` → merged chain (`git root → … → cwd`) →
385
514
  * `sources` с `position: after`. Кап — динамический от окна модели.
386
515
  */
@@ -425,7 +554,7 @@ export const protectedPathsConfigSchema = z.object({
425
554
  enabled: z.boolean().default(true),
426
555
  });
427
556
  /**
428
- * AD-052/O1: installer service-key, провижининг которого делается при старте из
557
+ * ADR-052/O1: installer service-key, провижининг которого делается при старте из
429
558
  * конфига/Secret (идемпотентно). `secret` — plaintext-секрет `synth_svc_…`
430
559
  * (приходит из env/Secret; in config.yaml держать не рекомендуется). `scopes` —
431
560
  * только известные (`serviceScopeSchema`); `roles` не заданы — дефолт хранилища.
@@ -438,17 +567,45 @@ export const bootstrapServiceKeySchema = z.object({
438
567
  description: z.string().optional(),
439
568
  });
440
569
  export const bootstrapServiceKeysSchema = z.array(bootstrapServiceKeySchema);
570
+ /**
571
+ * ADR-099 (единый механизм доверия TLS/CA): секция `security.tls`.
572
+ *
573
+ * Задаёт доверие для **исходящих** соединений Synth (https-провайдеры, MCP,
574
+ * webhooks, гибридный backend, OIDC, git, загрузка иконок/обновлений):
575
+ * - `caFile` — путь к PEM-файлу с доверенным CA-сертификатом (корпоративный CA);
576
+ * - `caPem` — сам PEM-сертификат (например из Secret) — **взаимоисключающ** с `caFile`;
577
+ * - `certFile`/`keyFile` — клиентский сертификат и ключ (mTLS);
578
+ * - `rejectUnauthorized` — проверять сертификат сервера (по умолчанию `true`).
579
+ *
580
+ * Читать эффективные значения через `resolveTlsConfig`/`resolveTlsTrust` (ADR-023:
581
+ * env > config.yaml > defaults). Пусто — системное доверие (поведение не меняется).
582
+ * Опционально — литеральные `SecurityConfig` без поля валидны.
583
+ */
584
+ export const securityTlsConfigSchema = z.object({
585
+ /** Путь к PEM-файлу доверенного CA. Взаимоисключающ с `caPem`. */
586
+ caFile: z.string().optional(),
587
+ /** PEM доверенного CA (приоритетно над файлом; взаимоисключающ с `caFile`). */
588
+ caPem: z.string().optional(),
589
+ /** Путь к PEM-файлу клиентского сертификата (mTLS). */
590
+ certFile: z.string().optional(),
591
+ /** Путь к PEM-файлу приватного ключа клиента (mTLS). */
592
+ keyFile: z.string().optional(),
593
+ /** Проверять сертификат сервера (по умолчанию `true`). */
594
+ rejectUnauthorized: z.boolean().optional(),
595
+ });
441
596
  export const securityConfigSchema = z.object({
442
597
  promptInjection: promptInjectionConfigSchema.default({}),
443
598
  protectedPaths: protectedPathsConfigSchema.default({}),
599
+ /** ADR-099: единый механизм доверия TLS/CA для исходящих соединений. */
600
+ tls: securityTlsConfigSchema.optional(),
444
601
  /**
445
- * AD-076: мастер-ключ для шифрования секретов at-rest (SSH-ключи, AES-256-GCM).
602
+ * ADR-076: мастер-ключ для шифрования секретов at-rest (SSH-ключи, AES-256-GCM).
446
603
  * Приоритет — env `SYNTH_SECRET_KEY` (читать через `resolveSecretKey`).
447
604
  * Пусто — core использует файл `{dataDir}/secrets/master.key`.
448
605
  */
449
606
  secretKey: z.string().default(''),
450
607
  /**
451
- * AD-052/O1: installer service-key'и, провижининг которых выполняется
608
+ * ADR-052/O1: installer service-key'и, провижининг которых выполняется
452
609
  * идемпотентно при старте (core standalone и backend). Может задаваться
453
610
  * JSON-строкой через env `SYNTH_BOOTSTRAP_SERVICE_KEYS` (приоритетнее
454
611
  * config.yaml) — так секрет не попадает в файл конфигурации.
@@ -456,7 +613,112 @@ export const securityConfigSchema = z.object({
456
613
  */
457
614
  bootstrapServiceKeys: bootstrapServiceKeysSchema.optional(),
458
615
  });
459
- // --- LLM Gateway (AD-036) ---
616
+ // --- Egress-прокси (ADR-099, этапы D1/D2a) ---
617
+ /** Тип аутентификации прокси: D2a — только `basic` (NTLM/Negotiate — D3/D4). */
618
+ export const PROXY_AUTH_TYPES = ['basic', 'ntlm', 'negotiate'];
619
+ /**
620
+ * Basic-аутентификация прокси (D2a). Пароль **не хранится в config**
621
+ * (инвариант 13): только env `SYNTH_PROXY_PASSWORD` или файл
622
+ * `{dataDir}/secrets/proxy-password`. Username также может быть в userinfo URL.
623
+ */
624
+ export const proxyAuthConfigSchema = z.object({
625
+ type: z.enum(PROXY_AUTH_TYPES).default('basic'),
626
+ username: z.string().default(''),
627
+ });
628
+ /**
629
+ * TLS к **самому прокси** (D2a) — схема как у `security.tls` (ADR-099):
630
+ * `caFile`/`caPem` (взаимоисключающие), `certFile`/`keyFile` (mTLS к прокси),
631
+ * `rejectUnauthorized`. Доверие к цели по-прежнему задаёт `security.tls`.
632
+ */
633
+ export const proxyTlsConfigSchema = z.object({
634
+ caFile: z.string().optional(),
635
+ caPem: z.string().optional(),
636
+ certFile: z.string().optional(),
637
+ keyFile: z.string().optional(),
638
+ rejectUnauthorized: z.boolean().optional(),
639
+ });
640
+ /** Режим маршрутизации прокси: `all` — default для всех, `selected` — только правила. */
641
+ export const PROXY_MODES = ['all', 'selected'];
642
+ /** Имя профиля прокси: lower-case буква, далее `[a-z0-9_-]`, длина 1..32. */
643
+ export const PROXY_PROFILE_NAME_RE = /^[a-z][a-z0-9_-]{0,31}$/;
644
+ export const proxyProfileNameSchema = z
645
+ .string()
646
+ .regex(PROXY_PROFILE_NAME_RE, 'имя профиля: ^[a-z][a-z0-9_-]{0,31}$');
647
+ /**
648
+ * Именованный профиль прокси (ADR-099, per-host маршрутизация).
649
+ *
650
+ * Набор URL-полей тот же, что у top-level legacy-конфига (`url` и/или
651
+ * `httpProxy`/`httpsProxy`/`allProxy`); профиль обязан задавать хотя бы один URL
652
+ * (проверяется резолвером). `auth` — только Basic; пароль в config не хранится —
653
+ * env/файл: `SYNTH_PROXY_<PROFILE>_PASSWORD` / `{dataDir}/secrets/proxy/<profile>.password`
654
+ * (для `default` — legacy `SYNTH_PROXY_PASSWORD` / `{dataDir}/secrets/proxy-password`).
655
+ */
656
+ export const proxyProfileSchema = z.object({
657
+ label: z.string().optional(),
658
+ url: z.string().optional(),
659
+ httpProxy: z.string().optional(),
660
+ httpsProxy: z.string().optional(),
661
+ allProxy: z.string().optional(),
662
+ auth: proxyAuthConfigSchema.optional(),
663
+ tls: proxyTlsConfigSchema.optional(),
664
+ });
665
+ /** Действие правила маршрутизации: через прокси либо напрямую. */
666
+ export const proxyRuleActionSchema = z.enum(['proxy', 'direct']);
667
+ /**
668
+ * Правило маршрутизации по хосту (порядок = приоритет, первое совпадение).
669
+ * `hosts` — exact, `.suffix` (apex+sub), `*.suffix` (sub), `host:port`, IP, CIDR, `*`.
670
+ * `action: direct` несовместим с `profile`.
671
+ */
672
+ export const proxyRuleSchema = z.object({
673
+ id: z.string().min(1).optional(),
674
+ label: z.string().optional(),
675
+ hosts: z.array(z.string().min(1)).min(1),
676
+ action: proxyRuleActionSchema,
677
+ profile: proxyProfileNameSchema.optional(),
678
+ });
679
+ /**
680
+ * ADR-099 (D1/D2a): HTTP/HTTPS-прокси единого egress-слоя.
681
+ *
682
+ * - `enabled` — явный выключатель; **не задан** — прокси включается наличием
683
+ * URL (в т.ч. из стандартных env при `fromEnv`); явный `false` подавляет
684
+ * стандартные `HTTP_PROXY`/… (прокси не включается «из окружения»);
685
+ * - `url` + `httpProxy`/`httpsProxy`/`allProxy` — URL прокси (`http`/`https`;
686
+ * userinfo допускается, креды вырезаются в resolved-конфиг; SOCKS5 — D2b);
687
+ * - `auth` — Basic-аутентификация (`username`; пароль — env/файл, не config);
688
+ * - `tls` — TLS/mTLS к самому прокси (`proxyTls`);
689
+ * - `noProxy` — исключения (host, `.suffix`, `*.suffix`, `host:port`, IP, CIDR, `*`);
690
+ * - `fromEnv` — учитывать стандартные `HTTP_PROXY`/`HTTPS_PROXY`/`ALL_PROXY`/`NO_PROXY`;
691
+ * - `fallbackDirect` — явный opt-in: при недоступном прокси идти напрямую (warn);
692
+ * - `connectTimeoutMs` — таймаут соединения с прокси.
693
+ *
694
+ * Эффективные значения — `resolveProxyConfig` (`config/proxy.ts`), приоритет
695
+ * `SYNTH_PROXY_*` > config.yaml > стандартные env > defaults (ADR-023).
696
+ */
697
+ export const proxyConfigSchema = z.object({
698
+ enabled: z.boolean().optional(),
699
+ /**
700
+ * Per-host маршрутизация: `all` — `defaultProfile` для всех, кроме `noProxy`
701
+ * (правила могут переопределить); `selected` — только правила, остальное напрямую.
702
+ */
703
+ mode: z.enum(PROXY_MODES).default('all'),
704
+ /** Профиль для `mode: all` и правил без явного `profile` (по умолчанию `default`). */
705
+ defaultProfile: proxyProfileNameSchema.optional(),
706
+ /** Именованные профили. При наличии top-level URL/auth/tls запрещены. */
707
+ profiles: z.record(proxyProfileNameSchema, proxyProfileSchema).optional(),
708
+ /** Правила маршрутизации (первое совпадение). */
709
+ rules: z.array(proxyRuleSchema).optional(),
710
+ url: z.string().optional(),
711
+ httpProxy: z.string().optional(),
712
+ httpsProxy: z.string().optional(),
713
+ allProxy: z.string().optional(),
714
+ auth: proxyAuthConfigSchema.optional(),
715
+ tls: proxyTlsConfigSchema.optional(),
716
+ noProxy: z.array(z.string()).default([]),
717
+ fromEnv: z.boolean().default(true),
718
+ fallbackDirect: z.boolean().default(false),
719
+ connectTimeoutMs: z.number().int().min(1).default(10_000),
720
+ });
721
+ // --- LLM Gateway (ADR-036) ---
460
722
  export const llmGatewayRateLimitConfigSchema = z.object({
461
723
  userPerMinute: z.number().int().min(1).default(DEFAULT_LLM_GATEWAY_RATE_LIMIT.userPerMinute),
462
724
  providerPerMinute: z.number().int().min(1).default(DEFAULT_LLM_GATEWAY_RATE_LIMIT.providerPerMinute),
@@ -477,7 +739,7 @@ export const llmGatewayConfigSchema = z.object({
477
739
  rateLimit: llmGatewayRateLimitConfigSchema.default({}),
478
740
  audit: llmGatewayAuditConfigSchema.default({}),
479
741
  });
480
- // --- Router (AD-034) ---
742
+ // --- Router (ADR-034) ---
481
743
  export const routerContentConfigSchema = z.object({
482
744
  coding: z.object({
483
745
  provider: z.string().default(''),
@@ -513,7 +775,7 @@ export const routerSubagentConfigSchema = z.object({
513
775
  model: z.string().default(''),
514
776
  provider: z.string().default(''),
515
777
  });
516
- // --- Micro-first (AD-035) ---
778
+ // --- Micro-first (ADR-035) ---
517
779
  export const microFirstConfigSchema = z.object({
518
780
  enabled: z.boolean().default(false),
519
781
  confidenceThreshold: z.number().min(0).max(1).default(0.8),
@@ -582,9 +844,13 @@ export const synthConfigSchema = z.object({
582
844
  events: eventsConfigSchema.default({}),
583
845
  scheduler: schedulerConfigSchema.default({}),
584
846
  decision: decisionConfigSchema.default({}),
847
+ analytics: analyticsConfigSchema.default({}),
848
+ metrics: metricsConfigSchema.default({}),
849
+ egress: egressConfigSchema.default({}),
585
850
  webhooks: webhooksConfigSchema.default({}),
586
851
  instructions: instructionsConfigSchema.default({}),
587
852
  router: routerConfigSchema.default({}),
853
+ proxy: proxyConfigSchema.default({}),
588
854
  remote: remoteConfigSchema.default({}),
589
855
  microFirst: microFirstConfigSchema.default({}),
590
856
  llmGateway: llmGatewayConfigSchema.default({}),