@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.
- package/dist/config/defaults.js +172 -3
- package/dist/config/env-overrides.d.ts +33 -1
- package/dist/config/env-overrides.js +191 -5
- package/dist/config/execution.d.ts +66 -0
- package/dist/config/execution.js +146 -0
- package/dist/config/index.d.ts +4 -0
- package/dist/config/index.js +4 -0
- package/dist/config/loader.js +19 -0
- package/dist/config/proxy.d.ts +415 -0
- package/dist/config/proxy.js +1567 -0
- package/dist/config/resolve.d.ts +67 -0
- package/dist/config/resolve.js +187 -1
- 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 +1571 -2835
- package/dist/config/types.js +717 -58
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +279 -0
- package/dist/index.d.ts +24 -3
- package/dist/index.js +25 -2
- package/dist/model-metadata.d.ts +10 -0
- package/dist/protocols/index.d.ts +0 -1
- package/dist/schemas/index.d.ts +1014 -2231
- package/dist/schemas/index.js +222 -14
- package/dist/types/analytics.d.ts +113 -0
- package/dist/types/analytics.js +61 -0
- package/dist/types/authority.d.ts +464 -0
- package/dist/types/authority.js +445 -0
- package/dist/types/background.d.ts +96 -0
- package/dist/types/background.js +24 -0
- package/dist/types/bus-events.d.ts +23 -1
- package/dist/types/catalog.d.ts +349 -0
- package/dist/types/catalog.js +393 -0
- package/dist/types/decision.d.ts +28 -337
- package/dist/types/egress.d.ts +114 -0
- package/dist/types/egress.js +68 -0
- package/dist/types/events.d.ts +54 -2
- package/dist/types/external-credentials.d.ts +352 -0
- package/dist/types/external-credentials.js +200 -0
- package/dist/types/fs.d.ts +11 -0
- package/dist/types/fs.js +11 -0
- package/dist/types/hooks.d.ts +50 -9
- package/dist/types/index.d.ts +23 -0
- package/dist/types/index.js +55 -0
- package/dist/types/llm-filters.d.ts +150 -0
- package/dist/types/llm-filters.js +54 -0
- package/dist/types/maintenance.d.ts +39 -0
- package/dist/types/maintenance.js +11 -0
- package/dist/types/mcp.d.ts +101 -5
- package/dist/types/mcp.js +127 -5
- package/dist/types/message.d.ts +45 -1
- package/dist/types/pack.d.ts +1102 -0
- package/dist/types/pack.js +1003 -0
- package/dist/types/permission.d.ts +31 -15
- package/dist/types/permission.js +1 -1
- package/dist/types/pipeline-engine.d.ts +453 -0
- package/dist/types/pipeline-engine.js +440 -0
- package/dist/types/pipeline.d.ts +275 -0
- package/dist/types/pipeline.js +212 -0
- package/dist/types/plugin-audit.d.ts +110 -0
- package/dist/types/plugin-audit.js +185 -0
- package/dist/types/plugin-hybrid.d.ts +85 -0
- package/dist/types/plugin-hybrid.js +68 -0
- package/dist/types/plugin-lock.d.ts +95 -0
- package/dist/types/plugin-lock.js +1 -0
- package/dist/types/plugin-protocol.d.ts +221 -0
- package/dist/types/plugin-protocol.js +322 -0
- package/dist/types/plugin-runtime.d.ts +25 -0
- package/dist/types/plugin-runtime.js +11 -0
- package/dist/types/plugin-scan.d.ts +159 -0
- package/dist/types/plugin-scan.js +166 -0
- package/dist/types/plugin-tools.d.ts +51 -0
- package/dist/types/plugin-tools.js +72 -0
- package/dist/types/project.d.ts +14 -0
- package/dist/types/prompt-blocks.d.ts +102 -0
- package/dist/types/prompt-blocks.js +24 -0
- package/dist/types/prompt.d.ts +47 -4
- package/dist/types/provider.d.ts +11 -0
- package/dist/types/question.d.ts +153 -0
- package/dist/types/question.js +65 -0
- package/dist/types/schedules.d.ts +26 -3
- package/dist/types/semver.d.ts +48 -0
- package/dist/types/semver.js +218 -0
- package/dist/types/service-keys.d.ts +41 -3
- package/dist/types/service-keys.js +44 -2
- package/dist/types/session.d.ts +54 -1
- package/dist/types/steering.d.ts +74 -0
- package/dist/types/steering.js +75 -0
- package/dist/types/tools.d.ts +125 -5
- package/dist/types/tools.js +75 -0
- package/dist/types/trust.d.ts +31 -0
- package/dist/types/trust.js +27 -0
- package/dist/types/webhooks.d.ts +1 -1
- package/dist/types/worktree.d.ts +170 -0
- package/dist/types/worktree.js +101 -0
- package/dist/utils/index.d.ts +46 -1
- package/dist/utils/index.js +145 -12
- package/dist/utils/reasoning.d.ts +16 -0
- package/dist/utils/reasoning.js +37 -0
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +2 -2
package/dist/config/defaults.js
CHANGED
|
@@ -1,4 +1,8 @@
|
|
|
1
|
-
import { DEFAULT_MCP_PRIVATE_CIDRS } from '../types/index.js';
|
|
1
|
+
import { DEFAULT_MCP_PRIVATE_CIDRS, DEFAULT_EGRESS_TOOLS_POLICY, DEFAULT_EGRESS_WEBHOOKS_POLICY, DEFAULT_EGRESS_LOG, } from '../types/index.js';
|
|
2
|
+
import { DEFAULT_MAX_UPLOAD_BYTES } from '../types/index.js';
|
|
3
|
+
import { DEFAULT_PROMPT_BLOCK_MAX_CHARS, DEFAULT_LLM_FILTER_TIMEOUT_MS } from '../types/index.js';
|
|
4
|
+
import { DEFAULT_EXECUTION_TIMEOUT_MS } from './types.js';
|
|
5
|
+
import { defaultExecutionConcurrency } from './execution.js';
|
|
2
6
|
export const defaultConfig = {
|
|
3
7
|
server: {
|
|
4
8
|
host: '0.0.0.0',
|
|
@@ -8,9 +12,35 @@ export const defaultConfig = {
|
|
|
8
12
|
},
|
|
9
13
|
storage: {
|
|
10
14
|
dataDir: '/var/synth/data',
|
|
15
|
+
backend: 'file',
|
|
16
|
+
// ADR-097: параметры PostgreSQL-backend (пусто — драйвер берёт дефолты/env).
|
|
17
|
+
postgres: {},
|
|
18
|
+
// ADR-098 (задел W5): при недоступности backend — файловый фоллбек в {dataDir}/fallback.
|
|
19
|
+
degradedMode: 'fallback-file',
|
|
20
|
+
fallbackDir: '',
|
|
11
21
|
workspacesRoot: '',
|
|
12
22
|
defaultWorkspace: '',
|
|
13
23
|
workspaceOutsideRoot: '',
|
|
24
|
+
maxUploadBytes: DEFAULT_MAX_UPLOAD_BYTES,
|
|
25
|
+
},
|
|
26
|
+
execution: {
|
|
27
|
+
// ADR-077: топология исполнения — параметр запуска (инвариант 24: смена
|
|
28
|
+
// режима — только рестартом). `inline` — исполнение в процессе (прежнее
|
|
29
|
+
// поведение); `remote` — отдельные исполнители (шаг 7 плана ADR-077).
|
|
30
|
+
mode: 'inline',
|
|
31
|
+
remote: {
|
|
32
|
+
// Список адресов исполнителей; пусто при `remote` → fail-closed на старте.
|
|
33
|
+
url: [],
|
|
34
|
+
// Таймаут exec-вызова (30 с — как у нынешних тулов).
|
|
35
|
+
timeoutMs: DEFAULT_EXECUTION_TIMEOUT_MS,
|
|
36
|
+
// Лимит одновременных exec-вызовов — число CPU процесса.
|
|
37
|
+
concurrency: defaultExecutionConcurrency(),
|
|
38
|
+
// Fail-closed при недоступности исполнителя; inline-fallback — только
|
|
39
|
+
// явной настройкой.
|
|
40
|
+
failMode: 'fail',
|
|
41
|
+
// Путь/ссылка на токен исполнителя (НЕ значение — инвариант 13).
|
|
42
|
+
tokenSecret: '',
|
|
43
|
+
},
|
|
14
44
|
},
|
|
15
45
|
auth: {
|
|
16
46
|
debugMode: false,
|
|
@@ -84,6 +114,7 @@ export const defaultConfig = {
|
|
|
84
114
|
networkPolicy: {
|
|
85
115
|
mode: 'deny',
|
|
86
116
|
list: [...DEFAULT_MCP_PRIVATE_CIDRS],
|
|
117
|
+
exceptions: [],
|
|
87
118
|
},
|
|
88
119
|
},
|
|
89
120
|
tools: {
|
|
@@ -149,13 +180,136 @@ export const defaultConfig = {
|
|
|
149
180
|
escalationProvider: '',
|
|
150
181
|
escalationModel: '',
|
|
151
182
|
},
|
|
183
|
+
oauth: {
|
|
184
|
+
// ADR-105 (Ф3): каталога OAuth-провайдеров нет — описания задаёт оператор
|
|
185
|
+
// (`oauth.providers` в config.yaml или env `SYNTH_OAUTH_PROVIDERS`).
|
|
186
|
+
providers: {},
|
|
187
|
+
},
|
|
188
|
+
analytics: {
|
|
189
|
+
// ADR-102: срок хранения суточных роллапов — 400 дней (<= 0 — без ограничения).
|
|
190
|
+
retentionDays: 400,
|
|
191
|
+
},
|
|
192
|
+
questions: {
|
|
193
|
+
// Этап 1 roadmap 0.13 (блок 3): срок ожидания ответа пользователя на вопрос —
|
|
194
|
+
// по умолчанию **без таймаута** (0): вопрос ждёт, пока ответят или отменят
|
|
195
|
+
// вручную. Тул `question` может задать срок для конкретного вопроса
|
|
196
|
+
// (`timeout`, ≥ 5 минут — не рекомендуется: ожидание обрывается).
|
|
197
|
+
timeoutMs: 0,
|
|
198
|
+
// Срок хранения терминальных записей вопросов (дни; <= 0 — без ограничения).
|
|
199
|
+
retentionDays: 14,
|
|
200
|
+
},
|
|
201
|
+
background: {
|
|
202
|
+
// Этап 1 roadmap 0.13 (блок 4): единый реестр фоновых прогонов
|
|
203
|
+
// (PROP-096 — фоновые саб-агенты, PROP-097 — фоновые шелл-процессы).
|
|
204
|
+
// Фоновая работа включена; лимиты — по родительской сессии.
|
|
205
|
+
enabled: true,
|
|
206
|
+
// Максимум одновременно идущих фоновых саб-агентов на родительскую сессию.
|
|
207
|
+
maxSubagentsPerSession: 2,
|
|
208
|
+
// Максимум одновременно идущих фоновых шелл-процессов на сессию-владельца.
|
|
209
|
+
maxProcessesPerSession: 5,
|
|
210
|
+
// Максимум записей реестра на сессию-владельца (чистится retention-ом).
|
|
211
|
+
maxRunsPerSession: 10,
|
|
212
|
+
// Предел размера лога фонового процесса, байт (10 МиБ; 0 — без ограничения).
|
|
213
|
+
logMaxBytes: 10_485_760,
|
|
214
|
+
// Срок хранения терминальных записей реестра (дни; <= 0 — без ограничения).
|
|
215
|
+
retentionDays: 7,
|
|
216
|
+
},
|
|
217
|
+
attachments: {
|
|
218
|
+
// ADR-115: вложения сообщений. Мастер-выключатель, семейства MIME,
|
|
219
|
+
// лимиты (байты на файл, число файлов в сообщении, суммарный объём на
|
|
220
|
+
// сессию), белый список MIME, резервное хранение в workspace и срок
|
|
221
|
+
// хранения осиротевших объектов.
|
|
222
|
+
enabled: true,
|
|
223
|
+
modalities: { image: true, pdf: true, audio: true, video: true },
|
|
224
|
+
maxBytesPerFile: 25 * 1024 * 1024,
|
|
225
|
+
maxFilesPerMessage: 10,
|
|
226
|
+
maxBytesPerSession: 1024 * 1024 * 1024,
|
|
227
|
+
allowedMimePrefixes: ['image/', 'audio/', 'video/', 'application/pdf', 'text/'],
|
|
228
|
+
workspaceFallback: true,
|
|
229
|
+
// ADR-115: модели обработки по семействам (aux-модели). Пусто — обработка
|
|
230
|
+
// не настроена: вложение, которое модель сессии не принимает, отбрасывается
|
|
231
|
+
// с путём в workspace (текущее поведение).
|
|
232
|
+
modalityModels: {},
|
|
233
|
+
gcDays: 30,
|
|
234
|
+
},
|
|
235
|
+
metrics: {
|
|
236
|
+
// ADR-094: экспорт Prometheus-метрик выключен по умолчанию (`GET /metrics` → 404).
|
|
237
|
+
enabled: false,
|
|
238
|
+
},
|
|
239
|
+
authority: {
|
|
240
|
+
// ADR-106 Ф1: Authority-слой выключен по умолчанию — права не меняются.
|
|
241
|
+
enabled: false,
|
|
242
|
+
// При включении слоя он сначала только наблюдает (shadow): решение
|
|
243
|
+
// считается и пишется в журнал, но не применяется.
|
|
244
|
+
shadow: true,
|
|
245
|
+
},
|
|
246
|
+
plugins: {
|
|
247
|
+
// ADR-090: слой плагинов. Мастер-выключатель Extension API включён;
|
|
248
|
+
// исполнение кода плагинов появляется в Ф1+ (сейчас — только политики).
|
|
249
|
+
enabled: true,
|
|
250
|
+
// Установка во время работы инстанса — по умолчанию запрещена (managed:
|
|
251
|
+
// только deploy-time).
|
|
252
|
+
runtimeInstall: 'deny',
|
|
253
|
+
// Trust-floor плагина: ниже порога — установка есть, активации нет.
|
|
254
|
+
trustFloor: 'trusted',
|
|
255
|
+
// Статический сканер содержимого расширения включён.
|
|
256
|
+
scan: 'enabled',
|
|
257
|
+
// Списки имён расширений (пусто — политика не применяется).
|
|
258
|
+
allowlist: [],
|
|
259
|
+
denylist: [],
|
|
260
|
+
// Allow-list расширений для hybrid-контура (Ф7).
|
|
261
|
+
remoteAllowlist: [],
|
|
262
|
+
// Файл точных исключений семвер-гейта (формат — открытый вопрос §14).
|
|
263
|
+
exactHostExceptions: '',
|
|
264
|
+
// Бюджет символов на блок системного промпта от плагина.
|
|
265
|
+
promptBlockMaxChars: DEFAULT_PROMPT_BLOCK_MAX_CHARS,
|
|
266
|
+
// Исполнение кода плагинов выключено по умолчанию (Ф1: загрузчик доходит
|
|
267
|
+
// до шага `import` и останавливается — `plugin.execution_disabled`).
|
|
268
|
+
executionEnabled: false,
|
|
269
|
+
// Бюджет времени на один вызов фильтра LLM-вызовов (точка `llmFilters`,
|
|
270
|
+
// Ф3б). Значение — вопрос владельца (ADR-090), механизм fail-closed/open
|
|
271
|
+
// реализован.
|
|
272
|
+
llmFilterTimeoutMs: DEFAULT_LLM_FILTER_TIMEOUT_MS,
|
|
273
|
+
// Ф5в: каталог deploy-плагинов (образ/PVC). Пусто — не задан.
|
|
274
|
+
deployDir: '/opt/synth/plugins',
|
|
275
|
+
// Ф5в: доверие deploy-бандлов (образ — доверенный источник, но не выше
|
|
276
|
+
// политики инстанса: ниже trust-floor — штатный отказ).
|
|
277
|
+
deployTrust: 'trusted',
|
|
278
|
+
// Ф5в: management-плагин нельзя снять/переустановить через API/CLI.
|
|
279
|
+
managedReadonly: true,
|
|
280
|
+
// ADR-090 (WP-F): провайдер/модель эмбеддингов для `facade.embed`.
|
|
281
|
+
// Пусто — сервис эмбеддингов не сконфигурирован (вызов бросает
|
|
282
|
+
// `plugin.embedding_not_configured`, плагин решает, деградировать ли).
|
|
283
|
+
embeddingProvider: '',
|
|
284
|
+
embeddingModel: '',
|
|
285
|
+
// Ф7: серверная политика плагинов в гибриде. По умолчанию сервер не
|
|
286
|
+
// ограничивает плагины (`off`); allow-list включается явно.
|
|
287
|
+
hybrid: {
|
|
288
|
+
mode: 'off',
|
|
289
|
+
allow: [],
|
|
290
|
+
},
|
|
291
|
+
},
|
|
292
|
+
egress: {
|
|
293
|
+
// Политика встроенных инструментов: deny приватных/служебных диапазонов.
|
|
294
|
+
tools: {
|
|
295
|
+
mode: DEFAULT_EGRESS_TOOLS_POLICY.mode,
|
|
296
|
+
list: [...DEFAULT_EGRESS_TOOLS_POLICY.list],
|
|
297
|
+
exceptions: [],
|
|
298
|
+
},
|
|
299
|
+
// Политика webhooks: deny приватных + обязательный https (`off` — dev).
|
|
300
|
+
webhooks: {
|
|
301
|
+
mode: DEFAULT_EGRESS_WEBHOOKS_POLICY.mode,
|
|
302
|
+
list: [...DEFAULT_EGRESS_WEBHOOKS_POLICY.list],
|
|
303
|
+
exceptions: [],
|
|
304
|
+
},
|
|
305
|
+
// Журнал внешних запросов: включён, retention 7 дней (0 — без очистки).
|
|
306
|
+
log: { ...DEFAULT_EGRESS_LOG },
|
|
307
|
+
},
|
|
152
308
|
webhooks: {
|
|
153
309
|
// ADR-052 (этап II): доставка webhooks выключена по умолчанию (opt-in).
|
|
154
310
|
enabled: false,
|
|
155
311
|
maxAttempts: 5,
|
|
156
312
|
timeoutMs: 10_000,
|
|
157
|
-
// Только https и публичные адреса; приватные/loopback — запрещены (SSRF).
|
|
158
|
-
allowPrivateTargets: false,
|
|
159
313
|
deliveryRetentionDays: 30,
|
|
160
314
|
},
|
|
161
315
|
instructions: {
|
|
@@ -212,6 +366,18 @@ export const defaultConfig = {
|
|
|
212
366
|
provider: '',
|
|
213
367
|
},
|
|
214
368
|
},
|
|
369
|
+
proxy: {
|
|
370
|
+
// ADR-099 (D1): прокси выключен по умолчанию (поведение не меняется).
|
|
371
|
+
// `enabled` намеренно не задан: явный `false` в config.yaml подавляет
|
|
372
|
+
// стандартные HTTP_PROXY/…, а отсутствие — позволяет включиться из env.
|
|
373
|
+
// `profiles`/`rules` намеренно не заданы: отсутствие = legacy-поведение
|
|
374
|
+
// (top-level URL + синтетический профиль `default`).
|
|
375
|
+
mode: 'all',
|
|
376
|
+
noProxy: [],
|
|
377
|
+
fromEnv: true,
|
|
378
|
+
fallbackDirect: false,
|
|
379
|
+
connectTimeoutMs: 10_000,
|
|
380
|
+
},
|
|
215
381
|
remote: {
|
|
216
382
|
enabled: false,
|
|
217
383
|
backendUrl: '',
|
|
@@ -259,6 +425,9 @@ export const defaultConfig = {
|
|
|
259
425
|
protectedPaths: {
|
|
260
426
|
enabled: true,
|
|
261
427
|
},
|
|
428
|
+
// ADR-099: доверие TLS/CA исходящих соединений. Пусто — системное доверие
|
|
429
|
+
// (поведение не меняется); caFile — корпоративный CA, cert/key — mTLS.
|
|
430
|
+
tls: {},
|
|
262
431
|
// Пусто — core использует файл {dataDir}/secrets/master.key (ADR-076).
|
|
263
432
|
secretKey: '',
|
|
264
433
|
// ADR-052/O1: installer service-key'и из env/Secret (по умолчанию нет).
|
|
@@ -18,7 +18,10 @@ export interface EnvOverrideDefinition {
|
|
|
18
18
|
export declare const ENV_OVERRIDES: readonly EnvOverrideDefinition[];
|
|
19
19
|
/** camelCase → SNAKE_CASE (`autoBind` → `AUTO_BIND`, `ephemeralTtl` → `EPHEMERAL_TTL`). */
|
|
20
20
|
export declare function toSnakeCase(value: string): string;
|
|
21
|
-
/**
|
|
21
|
+
/**
|
|
22
|
+
* Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. Точки в ключе означают
|
|
23
|
+
* вложенность (`log.enabled` → `SYNTH_EGRESS_LOG_ENABLED`).
|
|
24
|
+
*/
|
|
22
25
|
export declare function envOverrideName(def: EnvOverrideDefinition): string;
|
|
23
26
|
export type ParsedEnvValue = {
|
|
24
27
|
ok: true;
|
|
@@ -46,6 +49,22 @@ export declare function parseEnvValue(raw: string, type: EnvOverrideType): Parse
|
|
|
46
49
|
* игнор (как `resolvePort`/`resolveIgnoreRules`, без падения).
|
|
47
50
|
*/
|
|
48
51
|
export declare function applyEnvOverrides<T extends Record<string, unknown>>(config: T, env?: NodeJS.ProcessEnv): T;
|
|
52
|
+
/**
|
|
53
|
+
* ADR-115: env-имя списка включённых семейств вложений.
|
|
54
|
+
*
|
|
55
|
+
* Значение — csv из `image,pdf,audio,video`; перечисленные семейства
|
|
56
|
+
* включаются, отсутствующие — выключаются (полный список заменяется).
|
|
57
|
+
* Пустая строка — «не задано».
|
|
58
|
+
*/
|
|
59
|
+
export declare const ATTACHMENTS_MODALITIES_ENV = "SYNTH_ATTACHMENTS_MODALITIES";
|
|
60
|
+
/** Канонические семейства вложений (порядок — как в схеме). */
|
|
61
|
+
export declare const ATTACHMENT_MODALITY_KEYS: readonly ["image", "pdf", "audio", "video"];
|
|
62
|
+
export type AttachmentModalityKey = (typeof ATTACHMENT_MODALITY_KEYS)[number];
|
|
63
|
+
/**
|
|
64
|
+
* Разобрать csv семейств вложений. Неизвестные элементы пропускаются с warn;
|
|
65
|
+
* если валидных нет — `undefined` (значение игнорируется, как невалидный env).
|
|
66
|
+
*/
|
|
67
|
+
export declare function parseAttachmentsModalities(raw: string): Record<AttachmentModalityKey, boolean> | undefined;
|
|
49
68
|
/**
|
|
50
69
|
* ADR-052/O1: env-имя JSON-списка installer service-key'ев
|
|
51
70
|
* (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
|
|
@@ -55,6 +74,19 @@ export declare function applyEnvOverrides<T extends Record<string, unknown>>(con
|
|
|
55
74
|
* (передаётся из env/Secret).
|
|
56
75
|
*/
|
|
57
76
|
export declare const BOOTSTRAP_SERVICE_KEYS_ENV = "SYNTH_BOOTSTRAP_SERVICE_KEYS";
|
|
77
|
+
/**
|
|
78
|
+
* ADR-105 (Ф3): env-имя JSON-каталога OAuth-провайдеров (`oauth.providers`).
|
|
79
|
+
*
|
|
80
|
+
* Значение — JSON-объект «имя провайдера → описание»
|
|
81
|
+
* (`{ authorizeUrl, tokenUrl, revokeUrl?, deviceAuthorizationUrl?, clientId, scopes[] }`).
|
|
82
|
+
* Приоритет — как у скалярных env-оверрайдов: env > config.yaml (ADR-023),
|
|
83
|
+
* но ниже CLI-overrides. Провайдер из env **заменяет** одноимённого из
|
|
84
|
+
* config.yaml (описание целиком), остальные записи config.yaml сохраняются.
|
|
85
|
+
*
|
|
86
|
+
* Секрета здесь нет: `client_secret` — только env `SYNTH_OAUTH_<PROVIDER>_CLIENT_SECRET`
|
|
87
|
+
* или файл `{dataDir}/secrets/oauth/<provider>.client_secret` (инвариант 13).
|
|
88
|
+
*/
|
|
89
|
+
export declare const OAUTH_PROVIDERS_ENV = "SYNTH_OAUTH_PROVIDERS";
|
|
58
90
|
/**
|
|
59
91
|
* Применяет объектные env-оверрайды, у которых нет плоского строкового
|
|
60
92
|
* представления (сейчас — `security.bootstrapServiceKeys`). Значение парсится
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
*
|
|
11
11
|
* Приоритет (ADR-023): CLI-флаги (`overrides`) > env (`SYNTH_*`) > config.yaml > defaults.
|
|
12
12
|
*/
|
|
13
|
-
import { bootstrapServiceKeysSchema } from './types.js';
|
|
13
|
+
import { bootstrapServiceKeysSchema, oauthProvidersSchema } from './types.js';
|
|
14
14
|
/**
|
|
15
15
|
* Реестр env-оверрайдов скалярных ключей вложенных секций (ADR-023).
|
|
16
16
|
*
|
|
@@ -38,8 +38,20 @@ export const ENV_OVERRIDES = [
|
|
|
38
38
|
{ section: 'webhooks', key: 'enabled', type: 'boolean' },
|
|
39
39
|
{ section: 'webhooks', key: 'maxAttempts', type: 'number' },
|
|
40
40
|
{ section: 'webhooks', key: 'timeoutMs', type: 'number' },
|
|
41
|
-
{ section: 'webhooks', key: 'allowPrivateTargets', type: 'boolean' },
|
|
42
41
|
{ section: 'webhooks', key: 'deliveryRetentionDays', type: 'number' },
|
|
42
|
+
// egress (настраиваемая политика + журнал): только скалярные ключи.
|
|
43
|
+
{ section: 'egress', key: 'tools.mode', type: 'string' },
|
|
44
|
+
{ section: 'egress', key: 'webhooks.mode', type: 'string' },
|
|
45
|
+
{ section: 'egress', key: 'log.enabled', type: 'boolean' },
|
|
46
|
+
{ section: 'egress', key: 'log.retentionDays', type: 'number' },
|
|
47
|
+
// proxy (ADR-099, D1): скалярные ключи секции; списки (noProxy) — в config/env.
|
|
48
|
+
{ section: 'proxy', key: 'enabled', type: 'boolean' },
|
|
49
|
+
{ section: 'proxy', key: 'url', type: 'string' },
|
|
50
|
+
{ section: 'proxy', key: 'httpProxy', type: 'string' },
|
|
51
|
+
{ section: 'proxy', key: 'httpsProxy', type: 'string' },
|
|
52
|
+
{ section: 'proxy', key: 'allProxy', type: 'string' },
|
|
53
|
+
{ section: 'proxy', key: 'fallbackDirect', type: 'boolean' },
|
|
54
|
+
{ section: 'proxy', key: 'connectTimeoutMs', type: 'number' },
|
|
43
55
|
// decision (ADR-084)
|
|
44
56
|
{ section: 'decision', key: 'enabled', type: 'boolean' },
|
|
45
57
|
{ section: 'decision', key: 'provider', type: 'string' },
|
|
@@ -47,14 +59,65 @@ export const ENV_OVERRIDES = [
|
|
|
47
59
|
{ section: 'decision', key: 'confidenceThreshold', type: 'number' },
|
|
48
60
|
{ section: 'decision', key: 'escalationProvider', type: 'string' },
|
|
49
61
|
{ section: 'decision', key: 'escalationModel', type: 'string' },
|
|
62
|
+
// analytics (ADR-102)
|
|
63
|
+
{ section: 'analytics', key: 'retentionDays', type: 'number' },
|
|
64
|
+
// questions (этап 1 roadmap 0.13 — блок 3): таймаут ответа + retention.
|
|
65
|
+
{ section: 'questions', key: 'timeoutMs', type: 'number' },
|
|
66
|
+
{ section: 'questions', key: 'retentionDays', type: 'number' },
|
|
67
|
+
// background (этап 1 roadmap 0.13 — блок 4): реестр фоновых прогонов.
|
|
68
|
+
{ section: 'background', key: 'enabled', type: 'boolean' },
|
|
69
|
+
{ section: 'background', key: 'maxSubagentsPerSession', type: 'number' },
|
|
70
|
+
{ section: 'background', key: 'maxProcessesPerSession', type: 'number' },
|
|
71
|
+
{ section: 'background', key: 'maxRunsPerSession', type: 'number' },
|
|
72
|
+
{ section: 'background', key: 'logMaxBytes', type: 'number' },
|
|
73
|
+
{ section: 'background', key: 'retentionDays', type: 'number' },
|
|
74
|
+
// attachments (ADR-115): вложения сообщений. Семейства MIME
|
|
75
|
+
// (`SYNTH_ATTACHMENTS_MODALITIES`, csv) — объектный ключ, обрабатывается
|
|
76
|
+
// отдельно (`applyAttachmentsModalitiesEnvOverride`); список префиксов
|
|
77
|
+
// (`allowedMimePrefixes`) остаётся только в config.yaml.
|
|
78
|
+
{ section: 'attachments', key: 'enabled', type: 'boolean' },
|
|
79
|
+
{ section: 'attachments', key: 'workspaceFallback', type: 'boolean' },
|
|
80
|
+
{ section: 'attachments', key: 'maxBytesPerFile', type: 'number' },
|
|
81
|
+
{ section: 'attachments', key: 'maxFilesPerMessage', type: 'number' },
|
|
82
|
+
{ section: 'attachments', key: 'maxBytesPerSession', type: 'number' },
|
|
83
|
+
{ section: 'attachments', key: 'gcDays', type: 'number' },
|
|
84
|
+
// metrics (ADR-094): Helm ставит `SYNTH_METRICS_ENABLED` — имя должно совпадать.
|
|
85
|
+
{ section: 'metrics', key: 'enabled', type: 'boolean' },
|
|
86
|
+
// authority (ADR-106 Ф1): мастер-выключатель слоя и режим наблюдения.
|
|
87
|
+
{ section: 'authority', key: 'enabled', type: 'boolean' },
|
|
88
|
+
{ section: 'authority', key: 'shadow', type: 'boolean' },
|
|
89
|
+
// plugins (ADR-090): политики слоя плагинов. Списки (allowlist/denylist/
|
|
90
|
+
// remoteAllowlist) — объектные, остаются в config.yaml.
|
|
91
|
+
{ section: 'plugins', key: 'enabled', type: 'boolean' },
|
|
92
|
+
{ section: 'plugins', key: 'runtimeInstall', type: 'string' },
|
|
93
|
+
{ section: 'plugins', key: 'trustFloor', type: 'string' },
|
|
94
|
+
{ section: 'plugins', key: 'scan', type: 'string' },
|
|
95
|
+
{ section: 'plugins', key: 'exactHostExceptions', type: 'string' },
|
|
96
|
+
{ section: 'plugins', key: 'promptBlockMaxChars', type: 'number' },
|
|
97
|
+
{ section: 'plugins', key: 'executionEnabled', type: 'boolean' },
|
|
98
|
+
{ section: 'plugins', key: 'llmFilterTimeoutMs', type: 'number' },
|
|
99
|
+
// Ф5в: деплой-каталог из образа/PVC и «неприкосновенность» management-плагинов.
|
|
100
|
+
{ section: 'plugins', key: 'deployDir', type: 'string' },
|
|
101
|
+
{ section: 'plugins', key: 'deployTrust', type: 'string' },
|
|
102
|
+
{ section: 'plugins', key: 'managedReadonly', type: 'boolean' },
|
|
103
|
+
// ADR-090 (WP-F): провайдер/модель эмбеддингов для `facade.embed`.
|
|
104
|
+
{ section: 'plugins', key: 'embeddingProvider', type: 'string' },
|
|
105
|
+
{ section: 'plugins', key: 'embeddingModel', type: 'string' },
|
|
106
|
+
// Ф7: режим серверной политики плагинов в гибриде (`off`|`allowlist`).
|
|
107
|
+
// Список имён (`plugins.hybrid.allow`) — объектный, остаётся в config.yaml.
|
|
108
|
+
{ section: 'plugins', key: 'hybrid.mode', type: 'string' },
|
|
50
109
|
];
|
|
51
110
|
/** camelCase → SNAKE_CASE (`autoBind` → `AUTO_BIND`, `ephemeralTtl` → `EPHEMERAL_TTL`). */
|
|
52
111
|
export function toSnakeCase(value) {
|
|
53
112
|
return value.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toUpperCase();
|
|
54
113
|
}
|
|
55
|
-
/**
|
|
114
|
+
/**
|
|
115
|
+
* Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. Точки в ключе означают
|
|
116
|
+
* вложенность (`log.enabled` → `SYNTH_EGRESS_LOG_ENABLED`).
|
|
117
|
+
*/
|
|
56
118
|
export function envOverrideName(def) {
|
|
57
|
-
|
|
119
|
+
const key = def.key.split('.').map(toSnakeCase).join('_');
|
|
120
|
+
return `SYNTH_${toSnakeCase(def.section)}_${key}`;
|
|
58
121
|
}
|
|
59
122
|
/**
|
|
60
123
|
* Парсинг env-строки по типу ключа:
|
|
@@ -114,11 +177,119 @@ export function applyEnvOverrides(config, env = process.env) {
|
|
|
114
177
|
const section = current !== null && typeof current === 'object' && !Array.isArray(current)
|
|
115
178
|
? { ...current }
|
|
116
179
|
: {};
|
|
117
|
-
|
|
180
|
+
// `key` может быть вложенным (`log.enabled`): клонируем промежуточные объекты,
|
|
181
|
+
// чтобы не мутировать defaultConfig.
|
|
182
|
+
const path = def.key.split('.');
|
|
183
|
+
let target = section;
|
|
184
|
+
for (let i = 0; i < path.length - 1; i += 1) {
|
|
185
|
+
const part = path[i];
|
|
186
|
+
const child = target[part];
|
|
187
|
+
const copy = child !== null && typeof child === 'object' && !Array.isArray(child)
|
|
188
|
+
? { ...child }
|
|
189
|
+
: {};
|
|
190
|
+
target[part] = copy;
|
|
191
|
+
target = copy;
|
|
192
|
+
}
|
|
193
|
+
target[path[path.length - 1]] = parsed.value;
|
|
118
194
|
config[def.section] = section;
|
|
119
195
|
}
|
|
120
196
|
return config;
|
|
121
197
|
}
|
|
198
|
+
/**
|
|
199
|
+
* ADR-115: env-имя списка включённых семейств вложений.
|
|
200
|
+
*
|
|
201
|
+
* Значение — csv из `image,pdf,audio,video`; перечисленные семейства
|
|
202
|
+
* включаются, отсутствующие — выключаются (полный список заменяется).
|
|
203
|
+
* Пустая строка — «не задано».
|
|
204
|
+
*/
|
|
205
|
+
export const ATTACHMENTS_MODALITIES_ENV = 'SYNTH_ATTACHMENTS_MODALITIES';
|
|
206
|
+
/** Канонические семейства вложений (порядок — как в схеме). */
|
|
207
|
+
export const ATTACHMENT_MODALITY_KEYS = ['image', 'pdf', 'audio', 'video'];
|
|
208
|
+
/**
|
|
209
|
+
* Разобрать csv семейств вложений. Неизвестные элементы пропускаются с warn;
|
|
210
|
+
* если валидных нет — `undefined` (значение игнорируется, как невалидный env).
|
|
211
|
+
*/
|
|
212
|
+
export function parseAttachmentsModalities(raw) {
|
|
213
|
+
const tokens = raw
|
|
214
|
+
.split(',')
|
|
215
|
+
.map((part) => part.trim().toLowerCase())
|
|
216
|
+
.filter((part) => part !== '');
|
|
217
|
+
if (tokens.length === 0)
|
|
218
|
+
return undefined;
|
|
219
|
+
const enabled = new Set();
|
|
220
|
+
for (const token of tokens) {
|
|
221
|
+
if (ATTACHMENT_MODALITY_KEYS.includes(token)) {
|
|
222
|
+
enabled.add(token);
|
|
223
|
+
}
|
|
224
|
+
else {
|
|
225
|
+
console.warn(`[config] неизвестное семейство вложений "${token}" в ${ATTACHMENTS_MODALITIES_ENV} — пропущено`);
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
if (enabled.size === 0)
|
|
229
|
+
return undefined;
|
|
230
|
+
return {
|
|
231
|
+
image: enabled.has('image'),
|
|
232
|
+
pdf: enabled.has('pdf'),
|
|
233
|
+
audio: enabled.has('audio'),
|
|
234
|
+
video: enabled.has('video'),
|
|
235
|
+
};
|
|
236
|
+
}
|
|
237
|
+
/**
|
|
238
|
+
* Применить csv-оверрайд `SYNTH_ATTACHMENTS_MODALITIES` к секции `attachments`
|
|
239
|
+
* (список перечисляет только **включённые** семейства). Невалидное значение —
|
|
240
|
+
* warn и игнор (fail-soft, как у остальных env-оверрайдов).
|
|
241
|
+
*/
|
|
242
|
+
function applyAttachmentsModalitiesEnvOverride(config, env) {
|
|
243
|
+
const raw = env[ATTACHMENTS_MODALITIES_ENV];
|
|
244
|
+
if (raw === undefined || raw === '')
|
|
245
|
+
return;
|
|
246
|
+
const parsed = parseAttachmentsModalities(raw);
|
|
247
|
+
if (!parsed) {
|
|
248
|
+
console.warn(`[config] невалидное значение ${ATTACHMENTS_MODALITIES_ENV}="${raw}" — игнорируется`);
|
|
249
|
+
return;
|
|
250
|
+
}
|
|
251
|
+
const current = config.attachments;
|
|
252
|
+
const attachments = current !== null && typeof current === 'object' && !Array.isArray(current)
|
|
253
|
+
? { ...current }
|
|
254
|
+
: {};
|
|
255
|
+
attachments.modalities = parsed;
|
|
256
|
+
config.attachments = attachments;
|
|
257
|
+
}
|
|
258
|
+
/**
|
|
259
|
+
* ADR-105 (Ф3): env-оверрайд каталога OAuth-провайдеров (`oauth.providers`).
|
|
260
|
+
*
|
|
261
|
+
* Значение — JSON-объект «имя → описание». Провайдер из env заменяет
|
|
262
|
+
* одноимённого из config.yaml; остальные записи config.yaml сохраняются.
|
|
263
|
+
* Невалидный JSON/набор — warn в console и игнор (fail-soft: кривой каталог
|
|
264
|
+
* не должен ронять старт инстанса — доступы просто не обновятся).
|
|
265
|
+
*/
|
|
266
|
+
function applyOAuthProvidersEnvOverride(config, env) {
|
|
267
|
+
const raw = env[OAUTH_PROVIDERS_ENV];
|
|
268
|
+
if (raw === undefined || raw === '')
|
|
269
|
+
return;
|
|
270
|
+
let parsed;
|
|
271
|
+
try {
|
|
272
|
+
parsed = JSON.parse(raw);
|
|
273
|
+
}
|
|
274
|
+
catch {
|
|
275
|
+
console.warn(`[config] невалидный JSON ${OAUTH_PROVIDERS_ENV} — игнорируется`);
|
|
276
|
+
return;
|
|
277
|
+
}
|
|
278
|
+
const validated = oauthProvidersSchema.safeParse(parsed);
|
|
279
|
+
if (!validated.success) {
|
|
280
|
+
console.warn(`[config] ${OAUTH_PROVIDERS_ENV} не прошёл валидацию — игнорируется`);
|
|
281
|
+
return;
|
|
282
|
+
}
|
|
283
|
+
const current = config.oauth;
|
|
284
|
+
const oauth = current !== null && typeof current === 'object' && !Array.isArray(current)
|
|
285
|
+
? { ...current }
|
|
286
|
+
: {};
|
|
287
|
+
const providers = oauth.providers !== null && typeof oauth.providers === 'object' && !Array.isArray(oauth.providers)
|
|
288
|
+
? { ...oauth.providers }
|
|
289
|
+
: {};
|
|
290
|
+
oauth.providers = { ...providers, ...validated.data };
|
|
291
|
+
config.oauth = oauth;
|
|
292
|
+
}
|
|
122
293
|
/**
|
|
123
294
|
* ADR-052/O1: env-имя JSON-списка installer service-key'ев
|
|
124
295
|
* (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
|
|
@@ -128,6 +299,19 @@ export function applyEnvOverrides(config, env = process.env) {
|
|
|
128
299
|
* (передаётся из env/Secret).
|
|
129
300
|
*/
|
|
130
301
|
export const BOOTSTRAP_SERVICE_KEYS_ENV = 'SYNTH_BOOTSTRAP_SERVICE_KEYS';
|
|
302
|
+
/**
|
|
303
|
+
* ADR-105 (Ф3): env-имя JSON-каталога OAuth-провайдеров (`oauth.providers`).
|
|
304
|
+
*
|
|
305
|
+
* Значение — JSON-объект «имя провайдера → описание»
|
|
306
|
+
* (`{ authorizeUrl, tokenUrl, revokeUrl?, deviceAuthorizationUrl?, clientId, scopes[] }`).
|
|
307
|
+
* Приоритет — как у скалярных env-оверрайдов: env > config.yaml (ADR-023),
|
|
308
|
+
* но ниже CLI-overrides. Провайдер из env **заменяет** одноимённого из
|
|
309
|
+
* config.yaml (описание целиком), остальные записи config.yaml сохраняются.
|
|
310
|
+
*
|
|
311
|
+
* Секрета здесь нет: `client_secret` — только env `SYNTH_OAUTH_<PROVIDER>_CLIENT_SECRET`
|
|
312
|
+
* или файл `{dataDir}/secrets/oauth/<provider>.client_secret` (инвариант 13).
|
|
313
|
+
*/
|
|
314
|
+
export const OAUTH_PROVIDERS_ENV = 'SYNTH_OAUTH_PROVIDERS';
|
|
131
315
|
/**
|
|
132
316
|
* Применяет объектные env-оверрайды, у которых нет плоского строкового
|
|
133
317
|
* представления (сейчас — `security.bootstrapServiceKeys`). Значение парсится
|
|
@@ -139,6 +323,8 @@ export const BOOTSTRAP_SERVICE_KEYS_ENV = 'SYNTH_BOOTSTRAP_SERVICE_KEYS';
|
|
|
139
323
|
* возвращает его; секция `security` клонируется, чтобы не мутировать `defaultConfig`.
|
|
140
324
|
*/
|
|
141
325
|
export function applyObjectEnvOverrides(config, env = process.env) {
|
|
326
|
+
applyAttachmentsModalitiesEnvOverride(config, env);
|
|
327
|
+
applyOAuthProvidersEnvOverride(config, env);
|
|
142
328
|
const raw = env[BOOTSTRAP_SERVICE_KEYS_ENV];
|
|
143
329
|
if (raw === undefined || raw === '')
|
|
144
330
|
return config;
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import type { SynthConfig } from './types.js';
|
|
2
|
+
import { type ExecutionFailMode, type ExecutionMode } from './types.js';
|
|
3
|
+
/** Env-имена секции `execution` (ADR-077). */
|
|
4
|
+
export declare const EXECUTION_ENV: {
|
|
5
|
+
readonly mode: "SYNTH_EXECUTION_MODE";
|
|
6
|
+
readonly remoteUrl: "SYNTH_EXECUTION_REMOTE_URL";
|
|
7
|
+
readonly token: "SYNTH_EXECUTION_TOKEN";
|
|
8
|
+
readonly timeoutMs: "SYNTH_EXECUTION_TIMEOUT_MS";
|
|
9
|
+
readonly concurrency: "SYNTH_EXECUTION_CONCURRENCY";
|
|
10
|
+
readonly failMode: "SYNTH_EXECUTION_FAIL_MODE";
|
|
11
|
+
};
|
|
12
|
+
/** Имя CLI-флага переключателя топологии (`synth serve --execution-mode`). */
|
|
13
|
+
export declare const EXECUTION_MODE_CLI_FLAG = "--execution-mode";
|
|
14
|
+
/**
|
|
15
|
+
* Лимит одновременных exec-вызовов по умолчанию — число CPU процесса.
|
|
16
|
+
* `availableParallelism()` (Node 18.14+) учитывает cgroup/affinity; фолбэк —
|
|
17
|
+
* `os.cpus().length`.
|
|
18
|
+
*/
|
|
19
|
+
export declare function defaultExecutionConcurrency(): number;
|
|
20
|
+
/** Эффективные параметры удалённого исполнителя. */
|
|
21
|
+
export interface ResolvedExecutionRemoteConfig {
|
|
22
|
+
/** Список адресов исполнителей (пусто — при `remote` fail-closed на старте). */
|
|
23
|
+
url: string[];
|
|
24
|
+
/** Таймаут exec-вызова, мс. */
|
|
25
|
+
timeoutMs: number;
|
|
26
|
+
/** Лимит одновременных exec-вызовов. */
|
|
27
|
+
concurrency: number;
|
|
28
|
+
/** Поведение при недоступном исполнителе. */
|
|
29
|
+
failMode: ExecutionFailMode;
|
|
30
|
+
/** Путь/ссылка на токен исполнителя (НЕ значение — инвариант 13). */
|
|
31
|
+
tokenSecret: string;
|
|
32
|
+
}
|
|
33
|
+
/** Эффективная секция `execution`. */
|
|
34
|
+
export interface ResolvedExecutionConfig {
|
|
35
|
+
/** Топология исполнения. */
|
|
36
|
+
mode: ExecutionMode;
|
|
37
|
+
remote: ResolvedExecutionRemoteConfig;
|
|
38
|
+
}
|
|
39
|
+
/** Явное значение CLI-флага (приоритетнее env и config.yaml). */
|
|
40
|
+
export interface ExecutionCliOverride {
|
|
41
|
+
mode?: string | null;
|
|
42
|
+
}
|
|
43
|
+
export declare function isExecutionMode(value: unknown): value is ExecutionMode;
|
|
44
|
+
export declare function isExecutionFailMode(value: unknown): value is ExecutionFailMode;
|
|
45
|
+
/**
|
|
46
|
+
* Разбор списка адресов исполнителей: строка через запятую (`a, b`) — как у
|
|
47
|
+
* прочих списков конфигурации (`proxy.noProxy`). Пустые элементы отбрасываются.
|
|
48
|
+
*/
|
|
49
|
+
export declare function parseExecutionUrlList(raw: string): string[];
|
|
50
|
+
/**
|
|
51
|
+
* Резолвит режим исполнения. Приоритет: CLI-флаг > env `SYNTH_EXECUTION_MODE` >
|
|
52
|
+
* `config.execution.mode` > `inline`.
|
|
53
|
+
*
|
|
54
|
+
* **Fail-closed**: неизвестное явно заданное значение — ошибка (опечатка `inlne`
|
|
55
|
+
* не должна молча оставить инстанс в inline-режиме).
|
|
56
|
+
*/
|
|
57
|
+
export declare function resolveExecutionMode(config: SynthConfig, env?: NodeJS.ProcessEnv, cli?: ExecutionCliOverride): ExecutionMode;
|
|
58
|
+
/**
|
|
59
|
+
* Резолвит секцию `execution` целиком (ADR-077).
|
|
60
|
+
*
|
|
61
|
+
* Приоритет (ADR-023): CLI-флаг (`--execution-mode`) > env `SYNTH_EXECUTION_*` >
|
|
62
|
+
* `config.execution.*` > дефолты. Нечисловые env-значения — warn и фолбэк на
|
|
63
|
+
* config/дефолт (fail-soft, как прочие числовые env-резолверы); неизвестные
|
|
64
|
+
* `mode`/`failMode` — **fail-closed** (ошибка).
|
|
65
|
+
*/
|
|
66
|
+
export declare function resolveExecutionConfig(config: SynthConfig, env?: NodeJS.ProcessEnv, cli?: ExecutionCliOverride): ResolvedExecutionConfig;
|