@itphx/synth-shared 0.11.3 → 0.12.4
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 +126 -3
- package/dist/config/env-overrides.d.ts +29 -0
- package/dist/config/env-overrides.js +155 -2
- package/dist/config/execution.d.ts +66 -0
- package/dist/config/execution.js +146 -0
- package/dist/config/index.d.ts +1 -0
- package/dist/config/index.js +1 -0
- package/dist/config/proxy.js +3 -1
- package/dist/config/resolve.d.ts +8 -8
- package/dist/config/resolve.js +7 -7
- package/dist/config/types.d.ts +1287 -4037
- package/dist/config/types.js +461 -68
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +277 -0
- package/dist/index.d.ts +14 -2
- package/dist/index.js +16 -2
- package/dist/model-metadata.d.ts +10 -0
- package/dist/schemas/index.d.ts +980 -2322
- package/dist/schemas/index.js +183 -22
- package/dist/types/analytics.d.ts +6 -6
- package/dist/types/analytics.js +4 -4
- 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 +1 -1
- package/dist/types/egress.js +1 -1
- package/dist/types/events.d.ts +54 -1
- package/dist/types/external-credentials.d.ts +352 -0
- package/dist/types/external-credentials.js +200 -0
- package/dist/types/hooks.d.ts +33 -12
- package/dist/types/index.d.ts +20 -0
- package/dist/types/index.js +50 -1
- package/dist/types/llm-filters.d.ts +150 -0
- package/dist/types/llm-filters.js +54 -0
- package/dist/types/mcp.d.ts +33 -2
- package/dist/types/mcp.js +44 -1
- 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 +25 -11
- 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 +45 -3
- 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 -0
- 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/worktree.d.ts +170 -0
- package/dist/types/worktree.js +101 -0
- package/dist/utils/index.d.ts +31 -1
- package/dist/utils/index.js +92 -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,5 +1,8 @@
|
|
|
1
1
|
import { DEFAULT_MCP_PRIVATE_CIDRS, DEFAULT_EGRESS_TOOLS_POLICY, DEFAULT_EGRESS_WEBHOOKS_POLICY, DEFAULT_EGRESS_LOG, } from '../types/index.js';
|
|
2
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';
|
|
3
6
|
export const defaultConfig = {
|
|
4
7
|
server: {
|
|
5
8
|
host: '0.0.0.0',
|
|
@@ -10,9 +13,9 @@ export const defaultConfig = {
|
|
|
10
13
|
storage: {
|
|
11
14
|
dataDir: '/var/synth/data',
|
|
12
15
|
backend: 'file',
|
|
13
|
-
//
|
|
16
|
+
// ADR-097: параметры PostgreSQL-backend (пусто — драйвер берёт дефолты/env).
|
|
14
17
|
postgres: {},
|
|
15
|
-
//
|
|
18
|
+
// ADR-098 (задел W5): при недоступности backend — файловый фоллбек в {dataDir}/fallback.
|
|
16
19
|
degradedMode: 'fallback-file',
|
|
17
20
|
fallbackDir: '',
|
|
18
21
|
workspacesRoot: '',
|
|
@@ -20,6 +23,25 @@ export const defaultConfig = {
|
|
|
20
23
|
workspaceOutsideRoot: '',
|
|
21
24
|
maxUploadBytes: DEFAULT_MAX_UPLOAD_BYTES,
|
|
22
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
|
+
},
|
|
44
|
+
},
|
|
23
45
|
auth: {
|
|
24
46
|
debugMode: false,
|
|
25
47
|
sessionMaxAgeMinutes: 1440,
|
|
@@ -158,14 +180,115 @@ export const defaultConfig = {
|
|
|
158
180
|
escalationProvider: '',
|
|
159
181
|
escalationModel: '',
|
|
160
182
|
},
|
|
183
|
+
oauth: {
|
|
184
|
+
// ADR-105 (Ф3): каталога OAuth-провайдеров нет — описания задаёт оператор
|
|
185
|
+
// (`oauth.providers` в config.yaml или env `SYNTH_OAUTH_PROVIDERS`).
|
|
186
|
+
providers: {},
|
|
187
|
+
},
|
|
161
188
|
analytics: {
|
|
162
|
-
//
|
|
189
|
+
// ADR-102: срок хранения суточных роллапов — 400 дней (<= 0 — без ограничения).
|
|
163
190
|
retentionDays: 400,
|
|
164
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
|
+
},
|
|
165
235
|
metrics: {
|
|
166
236
|
// ADR-094: экспорт Prometheus-метрик выключен по умолчанию (`GET /metrics` → 404).
|
|
167
237
|
enabled: false,
|
|
168
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
|
+
},
|
|
169
292
|
egress: {
|
|
170
293
|
// Политика встроенных инструментов: deny приватных/служебных диапазонов.
|
|
171
294
|
tools: {
|
|
@@ -49,6 +49,22 @@ export declare function parseEnvValue(raw: string, type: EnvOverrideType): Parse
|
|
|
49
49
|
* игнор (как `resolvePort`/`resolveIgnoreRules`, без падения).
|
|
50
50
|
*/
|
|
51
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;
|
|
52
68
|
/**
|
|
53
69
|
* ADR-052/O1: env-имя JSON-списка installer service-key'ев
|
|
54
70
|
* (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
|
|
@@ -58,6 +74,19 @@ export declare function applyEnvOverrides<T extends Record<string, unknown>>(con
|
|
|
58
74
|
* (передаётся из env/Secret).
|
|
59
75
|
*/
|
|
60
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";
|
|
61
90
|
/**
|
|
62
91
|
* Применяет объектные env-оверрайды, у которых нет плоского строкового
|
|
63
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
|
*
|
|
@@ -59,10 +59,53 @@ export const ENV_OVERRIDES = [
|
|
|
59
59
|
{ section: 'decision', key: 'confidenceThreshold', type: 'number' },
|
|
60
60
|
{ section: 'decision', key: 'escalationProvider', type: 'string' },
|
|
61
61
|
{ section: 'decision', key: 'escalationModel', type: 'string' },
|
|
62
|
-
// analytics (
|
|
62
|
+
// analytics (ADR-102)
|
|
63
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' },
|
|
64
84
|
// metrics (ADR-094): Helm ставит `SYNTH_METRICS_ENABLED` — имя должно совпадать.
|
|
65
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' },
|
|
66
109
|
];
|
|
67
110
|
/** camelCase → SNAKE_CASE (`autoBind` → `AUTO_BIND`, `ephemeralTtl` → `EPHEMERAL_TTL`). */
|
|
68
111
|
export function toSnakeCase(value) {
|
|
@@ -152,6 +195,101 @@ export function applyEnvOverrides(config, env = process.env) {
|
|
|
152
195
|
}
|
|
153
196
|
return config;
|
|
154
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
|
+
}
|
|
155
293
|
/**
|
|
156
294
|
* ADR-052/O1: env-имя JSON-списка installer service-key'ев
|
|
157
295
|
* (`security.bootstrapServiceKeys`). Значение — JSON-массив объектов
|
|
@@ -161,6 +299,19 @@ export function applyEnvOverrides(config, env = process.env) {
|
|
|
161
299
|
* (передаётся из env/Secret).
|
|
162
300
|
*/
|
|
163
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';
|
|
164
315
|
/**
|
|
165
316
|
* Применяет объектные env-оверрайды, у которых нет плоского строкового
|
|
166
317
|
* представления (сейчас — `security.bootstrapServiceKeys`). Значение парсится
|
|
@@ -172,6 +323,8 @@ export const BOOTSTRAP_SERVICE_KEYS_ENV = 'SYNTH_BOOTSTRAP_SERVICE_KEYS';
|
|
|
172
323
|
* возвращает его; секция `security` клонируется, чтобы не мутировать `defaultConfig`.
|
|
173
324
|
*/
|
|
174
325
|
export function applyObjectEnvOverrides(config, env = process.env) {
|
|
326
|
+
applyAttachmentsModalitiesEnvOverride(config, env);
|
|
327
|
+
applyOAuthProvidersEnvOverride(config, env);
|
|
175
328
|
const raw = env[BOOTSTRAP_SERVICE_KEYS_ENV];
|
|
176
329
|
if (raw === undefined || raw === '')
|
|
177
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;
|
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-077: резолвер секции `execution` — топология исполнения.
|
|
3
|
+
*
|
|
4
|
+
* Секция — **параметр запуска** (не runtime-настройка): смена `mode` — только
|
|
5
|
+
* рестартом процесса (инвариант 24). Приоритет (ADR-023):
|
|
6
|
+
* **CLI-флаг > env > config.yaml > дефолт**.
|
|
7
|
+
*
|
|
8
|
+
* Env-имена (ровно эти — как зафиксировано в ADR-077):
|
|
9
|
+
* `SYNTH_EXECUTION_MODE`, `SYNTH_EXECUTION_REMOTE_URL`, `SYNTH_EXECUTION_TOKEN`,
|
|
10
|
+
* `SYNTH_EXECUTION_TIMEOUT_MS`, `SYNTH_EXECUTION_CONCURRENCY`,
|
|
11
|
+
* `SYNTH_EXECUTION_FAIL_MODE`.
|
|
12
|
+
*
|
|
13
|
+
* Fail-closed (как `storage.backend`): неизвестное **явное** значение `mode`
|
|
14
|
+
* (опечатка `inlne`) или `failMode` — ошибка, а не тихий выбор дефолта.
|
|
15
|
+
*/
|
|
16
|
+
import { availableParallelism, cpus } from 'node:os';
|
|
17
|
+
import { DEFAULT_EXECUTION_TIMEOUT_MS, EXECUTION_FAIL_MODES, EXECUTION_MODES, } from './types.js';
|
|
18
|
+
/** Env-имена секции `execution` (ADR-077). */
|
|
19
|
+
export const EXECUTION_ENV = {
|
|
20
|
+
mode: 'SYNTH_EXECUTION_MODE',
|
|
21
|
+
remoteUrl: 'SYNTH_EXECUTION_REMOTE_URL',
|
|
22
|
+
token: 'SYNTH_EXECUTION_TOKEN',
|
|
23
|
+
timeoutMs: 'SYNTH_EXECUTION_TIMEOUT_MS',
|
|
24
|
+
concurrency: 'SYNTH_EXECUTION_CONCURRENCY',
|
|
25
|
+
failMode: 'SYNTH_EXECUTION_FAIL_MODE',
|
|
26
|
+
};
|
|
27
|
+
/** Имя CLI-флага переключателя топологии (`synth serve --execution-mode`). */
|
|
28
|
+
export const EXECUTION_MODE_CLI_FLAG = '--execution-mode';
|
|
29
|
+
/**
|
|
30
|
+
* Лимит одновременных exec-вызовов по умолчанию — число CPU процесса.
|
|
31
|
+
* `availableParallelism()` (Node 18.14+) учитывает cgroup/affinity; фолбэк —
|
|
32
|
+
* `os.cpus().length`.
|
|
33
|
+
*/
|
|
34
|
+
export function defaultExecutionConcurrency() {
|
|
35
|
+
const n = typeof availableParallelism === 'function' ? availableParallelism() : cpus().length;
|
|
36
|
+
return Math.max(1, n);
|
|
37
|
+
}
|
|
38
|
+
export function isExecutionMode(value) {
|
|
39
|
+
return typeof value === 'string' && EXECUTION_MODES.includes(value);
|
|
40
|
+
}
|
|
41
|
+
export function isExecutionFailMode(value) {
|
|
42
|
+
return (typeof value === 'string' && EXECUTION_FAIL_MODES.includes(value));
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Разбор списка адресов исполнителей: строка через запятую (`a, b`) — как у
|
|
46
|
+
* прочих списков конфигурации (`proxy.noProxy`). Пустые элементы отбрасываются.
|
|
47
|
+
*/
|
|
48
|
+
export function parseExecutionUrlList(raw) {
|
|
49
|
+
return raw
|
|
50
|
+
.split(',')
|
|
51
|
+
.map((item) => item.trim())
|
|
52
|
+
.filter((item) => item.length > 0);
|
|
53
|
+
}
|
|
54
|
+
function invalidModeMessage(source, value) {
|
|
55
|
+
return (`[config] невалидное значение ${source}="${value}": ` +
|
|
56
|
+
`ожидается одно из ${EXECUTION_MODES.map((m) => `'${m}'`).join(', ')}`);
|
|
57
|
+
}
|
|
58
|
+
function invalidFailModeMessage(source, value) {
|
|
59
|
+
return (`[config] невалидное значение ${source}="${value}": ` +
|
|
60
|
+
`ожидается одно из ${EXECUTION_FAIL_MODES.map((m) => `'${m}'`).join(', ')}`);
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* Резолвит режим исполнения. Приоритет: CLI-флаг > env `SYNTH_EXECUTION_MODE` >
|
|
64
|
+
* `config.execution.mode` > `inline`.
|
|
65
|
+
*
|
|
66
|
+
* **Fail-closed**: неизвестное явно заданное значение — ошибка (опечатка `inlne`
|
|
67
|
+
* не должна молча оставить инстанс в inline-режиме).
|
|
68
|
+
*/
|
|
69
|
+
export function resolveExecutionMode(config, env = process.env, cli) {
|
|
70
|
+
const cliMode = cli?.mode;
|
|
71
|
+
if (cliMode !== undefined && cliMode !== null && String(cliMode).trim() !== '') {
|
|
72
|
+
const raw = String(cliMode).trim();
|
|
73
|
+
if (isExecutionMode(raw))
|
|
74
|
+
return raw;
|
|
75
|
+
throw new Error(invalidModeMessage(EXECUTION_MODE_CLI_FLAG, raw));
|
|
76
|
+
}
|
|
77
|
+
const envMode = env[EXECUTION_ENV.mode];
|
|
78
|
+
if (envMode !== undefined && envMode !== '') {
|
|
79
|
+
const raw = envMode.trim();
|
|
80
|
+
if (isExecutionMode(raw))
|
|
81
|
+
return raw;
|
|
82
|
+
throw new Error(invalidModeMessage(EXECUTION_ENV.mode, envMode));
|
|
83
|
+
}
|
|
84
|
+
const cfgMode = config.execution?.mode;
|
|
85
|
+
if (cfgMode !== undefined) {
|
|
86
|
+
if (isExecutionMode(cfgMode))
|
|
87
|
+
return cfgMode;
|
|
88
|
+
throw new Error(invalidModeMessage('execution.mode', String(cfgMode)));
|
|
89
|
+
}
|
|
90
|
+
return 'inline';
|
|
91
|
+
}
|
|
92
|
+
/**
|
|
93
|
+
* Резолвит секцию `execution` целиком (ADR-077).
|
|
94
|
+
*
|
|
95
|
+
* Приоритет (ADR-023): CLI-флаг (`--execution-mode`) > env `SYNTH_EXECUTION_*` >
|
|
96
|
+
* `config.execution.*` > дефолты. Нечисловые env-значения — warn и фолбэк на
|
|
97
|
+
* config/дефолт (fail-soft, как прочие числовые env-резолверы); неизвестные
|
|
98
|
+
* `mode`/`failMode` — **fail-closed** (ошибка).
|
|
99
|
+
*/
|
|
100
|
+
export function resolveExecutionConfig(config, env = process.env, cli) {
|
|
101
|
+
const mode = resolveExecutionMode(config, env, cli);
|
|
102
|
+
const remoteCfg = config.execution?.remote ?? {};
|
|
103
|
+
// Адреса исполнителей: env (список через запятую) > config.yaml > [].
|
|
104
|
+
const rawUrl = env[EXECUTION_ENV.remoteUrl];
|
|
105
|
+
const url = rawUrl !== undefined && rawUrl !== ''
|
|
106
|
+
? parseExecutionUrlList(rawUrl)
|
|
107
|
+
: [...(remoteCfg.url ?? [])];
|
|
108
|
+
// Таймаут exec-вызова: env > config.yaml > дефолт (30 с).
|
|
109
|
+
const timeoutMs = resolvePositiveInt(env[EXECUTION_ENV.timeoutMs], remoteCfg.timeoutMs, EXECUTION_ENV.timeoutMs) ?? DEFAULT_EXECUTION_TIMEOUT_MS;
|
|
110
|
+
// Лимит одновременных вызовов: env > config.yaml > число CPU процесса.
|
|
111
|
+
const concurrency = resolvePositiveInt(env[EXECUTION_ENV.concurrency], remoteCfg.concurrency, EXECUTION_ENV.concurrency) ?? defaultExecutionConcurrency();
|
|
112
|
+
// Поведение при недоступности исполнителя: env > config.yaml > `fail`.
|
|
113
|
+
const failMode = resolveFailMode(remoteCfg.failMode, env);
|
|
114
|
+
// Токен исполнителя: env > config.yaml > '' (путь/ссылка, НЕ значение).
|
|
115
|
+
const tokenEnv = env[EXECUTION_ENV.token];
|
|
116
|
+
const tokenSecret = tokenEnv !== undefined && tokenEnv !== '' ? tokenEnv : (remoteCfg.tokenSecret ?? '');
|
|
117
|
+
return {
|
|
118
|
+
mode,
|
|
119
|
+
remote: { url, timeoutMs, concurrency, failMode, tokenSecret },
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
function resolveFailMode(cfgValue, env) {
|
|
123
|
+
const raw = env[EXECUTION_ENV.failMode];
|
|
124
|
+
if (raw !== undefined && raw !== '') {
|
|
125
|
+
const trimmed = raw.trim();
|
|
126
|
+
if (isExecutionFailMode(trimmed))
|
|
127
|
+
return trimmed;
|
|
128
|
+
throw new Error(invalidFailModeMessage(EXECUTION_ENV.failMode, raw));
|
|
129
|
+
}
|
|
130
|
+
if (cfgValue !== undefined) {
|
|
131
|
+
if (isExecutionFailMode(cfgValue))
|
|
132
|
+
return cfgValue;
|
|
133
|
+
throw new Error(invalidFailModeMessage('execution.remote.failMode', String(cfgValue)));
|
|
134
|
+
}
|
|
135
|
+
return 'fail';
|
|
136
|
+
}
|
|
137
|
+
/** Положительное целое из env; невалидно — warn и фолбэк на config (fail-soft). */
|
|
138
|
+
function resolvePositiveInt(rawEnv, cfgValue, envName) {
|
|
139
|
+
if (rawEnv !== undefined && rawEnv !== '') {
|
|
140
|
+
const n = Number(rawEnv);
|
|
141
|
+
if (Number.isFinite(n) && Number.isInteger(n) && n > 0)
|
|
142
|
+
return n;
|
|
143
|
+
console.warn(`[config] невалидное значение ${envName}="${rawEnv}" (ожидается целое > 0) — игнорируется`);
|
|
144
|
+
}
|
|
145
|
+
return cfgValue;
|
|
146
|
+
}
|
package/dist/config/index.d.ts
CHANGED
package/dist/config/index.js
CHANGED
package/dist/config/proxy.js
CHANGED
|
@@ -16,6 +16,7 @@ import { readFileSync } from 'node:fs';
|
|
|
16
16
|
import { join } from 'node:path';
|
|
17
17
|
import { BlockList, isIP } from 'node:net';
|
|
18
18
|
import { PROXY_PROFILE_NAME_RE, proxyConfigSchema } from './types.js';
|
|
19
|
+
import { matchTlsHostPattern } from './tls.js';
|
|
19
20
|
/** Env-имена секции `proxy` (ADR-023). */
|
|
20
21
|
export const PROXY_ENV = {
|
|
21
22
|
enabled: 'SYNTH_PROXY_ENABLED',
|
|
@@ -260,7 +261,8 @@ export class NoProxyMatcher {
|
|
|
260
261
|
return true;
|
|
261
262
|
if (this._suffixes.some((suffix) => host === suffix || host.endsWith(`.${suffix}`)))
|
|
262
263
|
return true;
|
|
263
|
-
|
|
264
|
+
// `*.suffix` — только поддомены; семантика шаблона общая с ADR-099-матчером.
|
|
265
|
+
if (this._wildcards.some((suffix) => matchTlsHostPattern(`*.${suffix}`, host)))
|
|
264
266
|
return true;
|
|
265
267
|
if (port !== undefined && port !== '') {
|
|
266
268
|
if (this._hostPorts.has(`${host}|${String(port)}`))
|