@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.
- package/dist/config/defaults.js +60 -14
- package/dist/config/env-overrides.d.ts +7 -4
- package/dist/config/env-overrides.js +46 -13
- package/dist/config/index.d.ts +3 -0
- package/dist/config/index.js +3 -0
- package/dist/config/loader.d.ts +2 -2
- package/dist/config/loader.js +23 -4
- package/dist/config/proxy.d.ts +415 -0
- package/dist/config/proxy.js +1565 -0
- package/dist/config/resolve.d.ts +77 -10
- package/dist/config/resolve.js +203 -17
- package/dist/config/tls-runtime.d.ts +78 -0
- package/dist/config/tls-runtime.js +356 -0
- package/dist/config/tls.d.ts +215 -0
- package/dist/config/tls.js +394 -0
- package/dist/config/types.d.ts +1820 -334
- package/dist/config/types.js +320 -54
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +18 -10
- package/dist/index.d.ts +11 -2
- package/dist/index.js +11 -2
- package/dist/interfaces/index.d.ts +3 -3
- package/dist/protocols/index.d.ts +0 -1
- package/dist/schemas/index.d.ts +230 -105
- package/dist/schemas/index.js +121 -74
- package/dist/skills/frontmatter.js +1 -1
- package/dist/types/agent.d.ts +30 -0
- package/dist/types/agent.js +1 -0
- package/dist/types/analytics.d.ts +113 -0
- package/dist/types/analytics.js +61 -0
- package/dist/types/bus-events.d.ts +7 -0
- package/dist/types/bus-events.js +1 -0
- package/dist/types/commands.d.ts +10 -10
- package/dist/types/commands.js +2 -2
- package/dist/types/decision.d.ts +16 -16
- package/dist/types/decision.js +4 -4
- package/dist/types/egress.d.ts +114 -0
- package/dist/types/egress.js +68 -0
- package/dist/types/events.d.ts +22 -23
- package/dist/types/fs.d.ts +55 -0
- package/dist/types/fs.js +27 -0
- package/dist/types/git.d.ts +63 -0
- package/dist/types/git.js +1 -0
- package/dist/types/hooks.d.ts +24 -4
- package/dist/types/index.d.ts +15 -1165
- package/dist/types/index.js +44 -244
- package/dist/types/llm.d.ts +32 -0
- package/dist/types/llm.js +8 -0
- package/dist/types/maintenance.d.ts +39 -0
- package/dist/types/maintenance.js +11 -0
- package/dist/types/mcp.d.ts +169 -0
- package/dist/types/mcp.js +119 -0
- package/dist/types/message.d.ts +63 -0
- package/dist/types/message.js +12 -0
- package/dist/types/permission.d.ts +9 -7
- package/dist/types/permission.js +1 -1
- package/dist/types/project.d.ts +134 -0
- package/dist/types/project.js +67 -0
- package/dist/types/prompt.d.ts +237 -0
- package/dist/types/prompt.js +15 -0
- package/dist/types/provider.d.ts +84 -0
- package/dist/types/provider.js +35 -0
- package/dist/types/schedules.d.ts +8 -8
- package/dist/types/schedules.js +1 -1
- package/dist/types/service-keys.d.ts +10 -10
- package/dist/types/service-keys.js +3 -3
- package/dist/types/session.d.ts +268 -0
- package/dist/types/session.js +13 -0
- package/dist/types/skills.d.ts +11 -11
- package/dist/types/skills.js +6 -6
- package/dist/types/tools.d.ts +3 -3
- package/dist/types/user.d.ts +113 -0
- package/dist/types/user.js +31 -0
- package/dist/types/webhooks.d.ts +6 -6
- package/dist/types/webhooks.js +1 -1
- package/dist/utils/glob.d.ts +1 -1
- package/dist/utils/glob.js +1 -1
- package/dist/utils/index.d.ts +15 -0
- package/dist/utils/index.js +55 -2
- package/dist/utils/workspace.js +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
package/dist/config/types.js
CHANGED
|
@@ -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
|
-
*
|
|
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
|
-
/**
|
|
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 (
|
|
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
|
-
/**
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
// --- Инструменты (
|
|
221
|
+
// --- Инструменты (ADR-071 §2.3) ---
|
|
145
222
|
/**
|
|
146
|
-
*
|
|
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
|
-
*
|
|
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
|
-
/**
|
|
235
|
+
/** ADR-071 §2.6: instance-wide отключение инструментов (admin). */
|
|
159
236
|
disabled: toolsDisabledConfigSchema.default({}),
|
|
160
237
|
});
|
|
161
|
-
// --- Скиллы (
|
|
238
|
+
// --- Скиллы (ADR-046) ---
|
|
162
239
|
/**
|
|
163
|
-
*
|
|
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` —
|
|
248
|
+
* попадают, тело не грузится). Установка/доверие/подписи/`lock.json` — PROP-068.
|
|
172
249
|
*
|
|
173
250
|
* Внешние локальные каталоги совместимости (`.opencode`, `.claude`, `.agents`,
|
|
174
|
-
* `~/.config/opencode`) подключаются как read-only discovery в core (
|
|
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
|
-
/**
|
|
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
|
-
*
|
|
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-команды (
|
|
266
|
+
// --- Slash-команды (ADR-046 §7) ---
|
|
190
267
|
/**
|
|
191
|
-
*
|
|
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
|
-
// --- Внешние события (
|
|
284
|
+
// --- Внешние события (ADR-089) ---
|
|
208
285
|
/**
|
|
209
|
-
*
|
|
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` —
|
|
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` —
|
|
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` —
|
|
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-ключ привязки (
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
349
|
+
* ADR-089 (auto-bind): шаблон агента для auto-bind-сессий (пусто — агент по
|
|
273
350
|
* умолчанию; резолвится через `AgentRegistry` с политикой `unknownAgentTemplate`).
|
|
274
351
|
*/
|
|
275
352
|
autoBindAgentTemplate: z.string().default(''),
|
|
276
353
|
/**
|
|
277
|
-
*
|
|
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
|
-
// --- Планировщик расписаний (
|
|
362
|
+
// --- Планировщик расписаний (ADR-051 срез / ADR-089) ---
|
|
286
363
|
/**
|
|
287
|
-
*
|
|
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`)
|
|
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-модели (
|
|
386
|
+
// --- Decision-модели (ADR-084) ---
|
|
308
387
|
/**
|
|
309
|
-
*
|
|
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
|
-
/**
|
|
405
|
+
/** ADR-084: провайдер тира эскалации; пусто — эскалации нет. */
|
|
327
406
|
escalationProvider: z.string().default(''),
|
|
328
|
-
/**
|
|
407
|
+
/** ADR-084: модель тира эскалации; пусто — эскалации нет. */
|
|
329
408
|
escalationModel: z.string().default(''),
|
|
330
409
|
});
|
|
331
|
-
// ---
|
|
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
|
-
*
|
|
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
|
-
// ---
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
// ---
|
|
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 (
|
|
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 (
|
|
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({}),
|