@itphx/synth-shared 0.13.4 → 0.13.10
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 +102 -3
- package/dist/config/env-overrides.d.ts +39 -4
- package/dist/config/env-overrides.js +174 -4
- package/dist/config/execution-runtime.d.ts +89 -0
- package/dist/config/execution-runtime.js +506 -0
- package/dist/config/execution.d.ts +202 -1
- package/dist/config/execution.js +459 -3
- package/dist/config/index.d.ts +3 -0
- package/dist/config/index.js +3 -0
- package/dist/config/loader.d.ts +8 -0
- package/dist/config/loader.js +6 -1
- package/dist/config/redact.d.ts +22 -0
- package/dist/config/redact.js +53 -0
- package/dist/config/security.d.ts +77 -0
- package/dist/config/security.js +116 -0
- package/dist/config/tls.d.ts +7 -4
- package/dist/config/tls.js +10 -23
- package/dist/config/types.d.ts +568 -38
- package/dist/config/types.js +390 -33
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +325 -13
- package/dist/index.d.ts +7 -6
- package/dist/index.js +17 -4
- package/dist/model-metadata.d.ts +10 -0
- package/dist/model-metadata.js +10 -0
- package/dist/schemas/index.d.ts +444 -30
- package/dist/schemas/index.js +354 -17
- package/dist/skills/frontmatter.js +1 -1
- package/dist/types/agent.d.ts +29 -1
- package/dist/types/authority.d.ts +10 -0
- package/dist/types/authority.js +8 -0
- package/dist/types/bus-events.d.ts +88 -2
- package/dist/types/catalog.d.ts +1 -1
- package/dist/types/catalog.js +1 -1
- package/dist/types/command-audit.d.ts +91 -0
- package/dist/types/command-audit.js +44 -0
- package/dist/types/commands.d.ts +29 -11
- package/dist/types/commands.js +2 -2
- package/dist/types/egress.d.ts +18 -3
- package/dist/types/egress.js +18 -3
- package/dist/types/events.d.ts +23 -2
- package/dist/types/execution.d.ts +424 -0
- package/dist/types/execution.js +355 -0
- package/dist/types/file-kind.d.ts +3 -2
- package/dist/types/file-kind.js +11 -2
- package/dist/types/git.d.ts +131 -0
- package/dist/types/git.js +101 -1
- package/dist/types/host-pattern.d.ts +41 -0
- package/dist/types/host-pattern.js +143 -0
- package/dist/types/index.d.ts +8 -0
- package/dist/types/index.js +25 -3
- package/dist/types/maintenance.d.ts +1 -1
- package/dist/types/mcp.d.ts +90 -0
- package/dist/types/mcp.js +11 -0
- package/dist/types/mentions.d.ts +96 -0
- package/dist/types/mentions.js +9 -0
- package/dist/types/message-stream.d.ts +41 -0
- package/dist/types/message.d.ts +24 -1
- package/dist/types/message.js +13 -0
- package/dist/types/pack.d.ts +21 -21
- package/dist/types/pack.js +4 -4
- package/dist/types/permission.d.ts +20 -3
- package/dist/types/pipeline.d.ts +2 -2
- package/dist/types/plugin-protocol.d.ts +203 -4
- package/dist/types/plugin-protocol.js +77 -4
- package/dist/types/project-access.d.ts +94 -0
- package/dist/types/project-access.js +140 -0
- package/dist/types/project.d.ts +89 -2
- package/dist/types/project.js +36 -0
- package/dist/types/prompt.d.ts +4 -2
- package/dist/types/schedules.d.ts +49 -3
- package/dist/types/schedules.js +50 -1
- package/dist/types/scripts.d.ts +98 -0
- package/dist/types/scripts.js +14 -0
- package/dist/types/service-keys.d.ts +16 -3
- package/dist/types/service-keys.js +19 -1
- package/dist/types/session.d.ts +68 -3
- package/dist/types/skills.d.ts +21 -11
- package/dist/types/skills.js +6 -6
- package/dist/types/timers.d.ts +402 -0
- package/dist/types/timers.js +166 -0
- package/dist/types/tools.d.ts +160 -1
- package/dist/types/tools.js +70 -0
- package/dist/types/user.d.ts +24 -0
- package/dist/types/worktree.d.ts +1 -1
- package/dist/utils/index.js +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +3 -2
package/dist/config/execution.js
CHANGED
|
@@ -10,11 +10,32 @@
|
|
|
10
10
|
* `SYNTH_EXECUTION_TIMEOUT_MS`, `SYNTH_EXECUTION_CONCURRENCY`,
|
|
11
11
|
* `SYNTH_EXECUTION_FAIL_MODE`.
|
|
12
12
|
*
|
|
13
|
+
* PROP-135 Ф4a (пулы и профили) добавляет ещё три:
|
|
14
|
+
* `SYNTH_EXECUTION_POOLING`, `SYNTH_EXECUTION_DEFAULT_PROFILE`,
|
|
15
|
+
* `SYNTH_EXECUTION_FALLBACK`. Каталог профилей (`execution.remote.profiles`)
|
|
16
|
+
* задаётся **только** в `config.yaml` — env-переопределение профилей на этом
|
|
17
|
+
* шаге не заводим.
|
|
18
|
+
*
|
|
19
|
+
* PROP-135 Ф4b-1 (провайдер пулов) добавляет ещё четыре:
|
|
20
|
+
* `SYNTH_EXECUTION_PROVIDER`, `SYNTH_EXECUTION_PROVISIONER_URL`,
|
|
21
|
+
* `SYNTH_EXECUTION_PROVISIONER_TOKEN` (путь/ссылка, НЕ значение),
|
|
22
|
+
* `SYNTH_EXECUTION_PROVISIONER_TIMEOUT_MS`.
|
|
23
|
+
*
|
|
24
|
+
* Browser-тулы добавляют два: `SYNTH_EXECUTION_BROWSER_PROFILE` (профиль пула
|
|
25
|
+
* класса `browser`; дефолт `browser` — браузер не наследует `defaultProfile`)
|
|
26
|
+
* и `SYNTH_EXECUTION_BROWSER_MCP_SERVER` (имя MCP-сервера браузера в поде).
|
|
27
|
+
*
|
|
28
|
+
* Таймаут одного вызова браузерного MCP-инструмента — ещё одна переменная
|
|
29
|
+
* browser-контура: `SYNTH_EXECUTION_BROWSER_TIMEOUT_MS`
|
|
30
|
+
* (`execution.remote.browserTimeoutMs`).
|
|
31
|
+
*
|
|
13
32
|
* Fail-closed (как `storage.backend`): неизвестное **явное** значение `mode`
|
|
14
|
-
* (опечатка `inlne`)
|
|
33
|
+
* (опечатка `inlne`), `failMode`, `pooling`, `fallback` или `provider` —
|
|
34
|
+
* ошибка, а не тихий выбор дефолта. Тот же принцип и для `provider: http`
|
|
35
|
+
* без адреса provisioner'а: «куда обращаться» не задано — ошибка конфигурации.
|
|
15
36
|
*/
|
|
16
37
|
import { availableParallelism, cpus } from 'node:os';
|
|
17
|
-
import { DEFAULT_EXECUTION_TIMEOUT_MS, EXECUTION_FAIL_MODES, EXECUTION_MODES, } from './types.js';
|
|
38
|
+
import { DEFAULT_EXECUTION_BROWSER_MCP_SERVER, DEFAULT_EXECUTION_BROWSER_PROFILE, DEFAULT_EXECUTION_BROWSER_TIMEOUT_MS, DEFAULT_EXECUTION_PROVISIONER_TIMEOUT_MS, DEFAULT_EXECUTION_TIMEOUT_MS, EXECUTION_FAIL_MODES, EXECUTION_FALLBACKS, EXECUTION_MODES, EXECUTION_POOLINGS, EXECUTION_POOL_PROVIDERS, MAX_EXECUTION_BROWSER_TIMEOUT_MS, } from './types.js';
|
|
18
39
|
/** Env-имена секции `execution` (ADR-077). */
|
|
19
40
|
export const EXECUTION_ENV = {
|
|
20
41
|
mode: 'SYNTH_EXECUTION_MODE',
|
|
@@ -23,6 +44,28 @@ export const EXECUTION_ENV = {
|
|
|
23
44
|
timeoutMs: 'SYNTH_EXECUTION_TIMEOUT_MS',
|
|
24
45
|
concurrency: 'SYNTH_EXECUTION_CONCURRENCY',
|
|
25
46
|
failMode: 'SYNTH_EXECUTION_FAIL_MODE',
|
|
47
|
+
/** PROP-135 Ф4a: режим пула (`instance`|`project`|`session`). */
|
|
48
|
+
pooling: 'SYNTH_EXECUTION_POOLING',
|
|
49
|
+
/** PROP-135 Ф4a: имя профиля по умолчанию. */
|
|
50
|
+
defaultProfile: 'SYNTH_EXECUTION_DEFAULT_PROFILE',
|
|
51
|
+
/** Профиль пула класса `browser` (браузер — свой образ/профиль). */
|
|
52
|
+
browserProfile: 'SYNTH_EXECUTION_BROWSER_PROFILE',
|
|
53
|
+
/** Браузерный контур: явный каталог браузерных профилей (csv). */
|
|
54
|
+
browserProfiles: 'SYNTH_EXECUTION_BROWSER_PROFILES',
|
|
55
|
+
/** Имя MCP-сервера браузера в поде исполнителя. */
|
|
56
|
+
browserMcpServer: 'SYNTH_EXECUTION_BROWSER_MCP_SERVER',
|
|
57
|
+
/** Таймаут одного вызова браузерного MCP-инструмента, мс. */
|
|
58
|
+
browserTimeoutMs: 'SYNTH_EXECUTION_BROWSER_TIMEOUT_MS',
|
|
59
|
+
/** PROP-135 Ф4a: поведение при непригодном профиле (`instance`|`fail`). */
|
|
60
|
+
fallback: 'SYNTH_EXECUTION_FALLBACK',
|
|
61
|
+
/** PROP-135 Ф4b-1: провайдер пулов (`static`|`http`). */
|
|
62
|
+
provider: 'SYNTH_EXECUTION_PROVIDER',
|
|
63
|
+
/** PROP-135 Ф4b-1: адрес provisioner'а пулов. */
|
|
64
|
+
provisionerUrl: 'SYNTH_EXECUTION_PROVISIONER_URL',
|
|
65
|
+
/** PROP-135 Ф4b-1: путь/ссылка на токен provisioner'а (НЕ значение). */
|
|
66
|
+
provisionerToken: 'SYNTH_EXECUTION_PROVISIONER_TOKEN',
|
|
67
|
+
/** PROP-135 Ф4b-1: таймаут обращения к provisioner'у, мс. */
|
|
68
|
+
provisionerTimeoutMs: 'SYNTH_EXECUTION_PROVISIONER_TIMEOUT_MS',
|
|
26
69
|
};
|
|
27
70
|
/** Имя CLI-флага переключателя топологии (`synth serve --execution-mode`). */
|
|
28
71
|
export const EXECUTION_MODE_CLI_FLAG = '--execution-mode';
|
|
@@ -41,6 +84,18 @@ export function isExecutionMode(value) {
|
|
|
41
84
|
export function isExecutionFailMode(value) {
|
|
42
85
|
return (typeof value === 'string' && EXECUTION_FAIL_MODES.includes(value));
|
|
43
86
|
}
|
|
87
|
+
/** Предикат режима пула (PROP-135 Ф4a). */
|
|
88
|
+
export function isExecutionPooling(value) {
|
|
89
|
+
return (typeof value === 'string' && EXECUTION_POOLINGS.includes(value));
|
|
90
|
+
}
|
|
91
|
+
/** Предикат поведения при непригодном профиле (PROP-135 Ф4a). */
|
|
92
|
+
export function isExecutionFallback(value) {
|
|
93
|
+
return (typeof value === 'string' && EXECUTION_FALLBACKS.includes(value));
|
|
94
|
+
}
|
|
95
|
+
/** Предикат провайдера пулов (PROP-135 Ф4b-1). */
|
|
96
|
+
export function isExecutionPoolProvider(value) {
|
|
97
|
+
return (typeof value === 'string' && EXECUTION_POOL_PROVIDERS.includes(value));
|
|
98
|
+
}
|
|
44
99
|
/**
|
|
45
100
|
* Разбор списка адресов исполнителей: строка через запятую (`a, b`) — как у
|
|
46
101
|
* прочих списков конфигурации (`proxy.noProxy`). Пустые элементы отбрасываются.
|
|
@@ -59,6 +114,103 @@ function invalidFailModeMessage(source, value) {
|
|
|
59
114
|
return (`[config] невалидное значение ${source}="${value}": ` +
|
|
60
115
|
`ожидается одно из ${EXECUTION_FAIL_MODES.map((m) => `'${m}'`).join(', ')}`);
|
|
61
116
|
}
|
|
117
|
+
function invalidPoolingMessage(source, value) {
|
|
118
|
+
return (`[config] невалидное значение ${source}="${value}": ` +
|
|
119
|
+
`ожидается одно из ${EXECUTION_POOLINGS.map((m) => `'${m}'`).join(', ')}`);
|
|
120
|
+
}
|
|
121
|
+
function invalidFallbackMessage(source, value) {
|
|
122
|
+
return (`[config] невалидное значение ${source}="${value}": ` +
|
|
123
|
+
`ожидается одно из ${EXECUTION_FALLBACKS.map((m) => `'${m}'`).join(', ')}`);
|
|
124
|
+
}
|
|
125
|
+
function invalidProviderMessage(source, value) {
|
|
126
|
+
return (`[config] невалидное значение ${source}="${value}": ` +
|
|
127
|
+
`ожидается одно из ${EXECUTION_POOL_PROVIDERS.map((m) => `'${m}'`).join(', ')}`);
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* Нормализация списка имён профилей: trim, пустые отбрасываются, дубликаты
|
|
131
|
+
* схлопываются (порядок первого вхождения сохраняется).
|
|
132
|
+
*/
|
|
133
|
+
export function normalizeProfileNameList(names) {
|
|
134
|
+
const list = [];
|
|
135
|
+
for (const raw of names ?? []) {
|
|
136
|
+
const name = String(raw ?? '').trim();
|
|
137
|
+
if (name === '' || list.includes(name))
|
|
138
|
+
continue;
|
|
139
|
+
list.push(name);
|
|
140
|
+
}
|
|
141
|
+
return list;
|
|
142
|
+
}
|
|
143
|
+
/**
|
|
144
|
+
* Эффективный класс профиля (ADR-135, аддендум §11).
|
|
145
|
+
*
|
|
146
|
+
* Порядок:
|
|
147
|
+
* 1. **объявленный** класс профиля (`class`) — важнее всего;
|
|
148
|
+
* 2. legacy-список `browserProfiles` — профиль из списка браузерный;
|
|
149
|
+
* 3. профиль по умолчанию `browserProfile` — браузерный (у браузера свой
|
|
150
|
+
* образ/MCP-сервер);
|
|
151
|
+
* 4. иначе — `exec`.
|
|
152
|
+
*
|
|
153
|
+
* Класс определяет каталоги: exec — `exec|both`, браузерный — `browser|both`.
|
|
154
|
+
*/
|
|
155
|
+
export function effectiveProfileClass(profile, name, browserProfiles, browserProfile) {
|
|
156
|
+
const declared = profile?.class;
|
|
157
|
+
if (declared === 'exec' || declared === 'browser' || declared === 'both')
|
|
158
|
+
return declared;
|
|
159
|
+
const trimmed = name.trim();
|
|
160
|
+
if (trimmed !== '' && (browserProfiles ?? []).includes(trimmed))
|
|
161
|
+
return 'browser';
|
|
162
|
+
if (trimmed !== '' && (browserProfile ?? '').trim() === trimmed)
|
|
163
|
+
return 'browser';
|
|
164
|
+
return 'exec';
|
|
165
|
+
}
|
|
166
|
+
/**
|
|
167
|
+
* Эффективный каталог **браузерных** профилей (PROP-135, браузерный контур).
|
|
168
|
+
*
|
|
169
|
+
* Состав:
|
|
170
|
+
* - профили с классом `browser`/`both`;
|
|
171
|
+
* - legacy-список `execution.remote.browserProfiles` (подсказка класса);
|
|
172
|
+
* - профиль по умолчанию `browserProfile`.
|
|
173
|
+
*
|
|
174
|
+
* Пустой каталог — когда не задано ни одного имени (браузер не настроен).
|
|
175
|
+
*/
|
|
176
|
+
export function resolveBrowserProfileNames(remote) {
|
|
177
|
+
const list = [];
|
|
178
|
+
const push = (name) => {
|
|
179
|
+
const trimmed = (name ?? '').trim();
|
|
180
|
+
if (trimmed === '' || list.includes(trimmed))
|
|
181
|
+
return;
|
|
182
|
+
list.push(trimmed);
|
|
183
|
+
};
|
|
184
|
+
for (const name of normalizeProfileNameList(remote?.browserProfiles))
|
|
185
|
+
push(name);
|
|
186
|
+
for (const [name, profile] of Object.entries(remote?.profiles ?? {})) {
|
|
187
|
+
const cls = effectiveProfileClass(profile, name, remote?.browserProfiles, remote?.browserProfile);
|
|
188
|
+
if (cls === 'browser' || cls === 'both')
|
|
189
|
+
push(name);
|
|
190
|
+
}
|
|
191
|
+
push(remote?.browserProfile);
|
|
192
|
+
return list;
|
|
193
|
+
}
|
|
194
|
+
/**
|
|
195
|
+
* Каталог профилей **исполнения** (exec) — без имён браузерного каталога.
|
|
196
|
+
*
|
|
197
|
+
* В каталог входят профили с классом `exec`/`both` плюс профиль по умолчанию
|
|
198
|
+
* (`defaultProfile` — единственная точка отката exec-контура, даже если он
|
|
199
|
+
* браузерный). Имена из legacy-списка `browserProfiles` и браузерный профиль
|
|
200
|
+
* по умолчанию в exec-каталог **не** входят.
|
|
201
|
+
*/
|
|
202
|
+
export function resolveExecutionProfileNames(remote) {
|
|
203
|
+
const names = Object.keys(remote.profiles ?? {});
|
|
204
|
+
if (!names.includes(remote.defaultProfile) && remote.defaultProfile.trim() !== '') {
|
|
205
|
+
names.push(remote.defaultProfile);
|
|
206
|
+
}
|
|
207
|
+
return names.filter((name) => {
|
|
208
|
+
if (name === remote.defaultProfile)
|
|
209
|
+
return true;
|
|
210
|
+
const cls = effectiveProfileClass(remote.profiles?.[name], name, remote.browserProfiles, remote.browserProfile);
|
|
211
|
+
return cls !== 'browser';
|
|
212
|
+
});
|
|
213
|
+
}
|
|
62
214
|
/**
|
|
63
215
|
* Резолвит режим исполнения. Приоритет: CLI-флаг > env `SYNTH_EXECUTION_MODE` >
|
|
64
216
|
* `config.execution.mode` > `inline`.
|
|
@@ -114,11 +266,315 @@ export function resolveExecutionConfig(config, env = process.env, cli) {
|
|
|
114
266
|
// Токен исполнителя: env > config.yaml > '' (путь/ссылка, НЕ значение).
|
|
115
267
|
const tokenEnv = env[EXECUTION_ENV.token];
|
|
116
268
|
const tokenSecret = tokenEnv !== undefined && tokenEnv !== '' ? tokenEnv : (remoteCfg.tokenSecret ?? '');
|
|
269
|
+
// PROP-135 Ф4a: режим пула, профиль по умолчанию, каталог профилей и
|
|
270
|
+
// поведение при непригодном профиле. Приоритет — как у прочих полей
|
|
271
|
+
// секции: env > config.yaml > дефолт (ADR-023); неизвестное **явное**
|
|
272
|
+
// значение — fail-closed (как `mode`/`failMode`).
|
|
273
|
+
const pooling = resolvePooling(remoteCfg.pooling, env);
|
|
274
|
+
const defaultProfile = resolveDefaultProfile(remoteCfg.defaultProfile, env);
|
|
275
|
+
// Browser-профиль: тот же приоритет (env > config.yaml > дефолт). Пустое
|
|
276
|
+
// значение — «не задано»: берётся следующий источник, иначе `browser`.
|
|
277
|
+
const browserProfile = resolveConfiguredName(EXECUTION_ENV.browserProfile, remoteCfg.browserProfile, DEFAULT_EXECUTION_BROWSER_PROFILE, env);
|
|
278
|
+
// Браузерный контур: явный каталог браузерных профилей. Приоритет — env
|
|
279
|
+
// (csv) > config.yaml > [] (эффективный каталог = `[browserProfile]`).
|
|
280
|
+
const browserProfilesRaw = env[EXECUTION_ENV.browserProfiles];
|
|
281
|
+
const browserProfiles = browserProfilesRaw !== undefined && browserProfilesRaw.trim() !== ''
|
|
282
|
+
? normalizeProfileNameList(browserProfilesRaw.split(','))
|
|
283
|
+
: normalizeProfileNameList(remoteCfg.browserProfiles);
|
|
284
|
+
const browserMcpServer = resolveConfiguredName(EXECUTION_ENV.browserMcpServer, remoteCfg.browserMcpServer, DEFAULT_EXECUTION_BROWSER_MCP_SERVER, env);
|
|
285
|
+
// Таймаут одного вызова браузерного MCP-инструмента: env > config.yaml >
|
|
286
|
+
// дефолт (2 мин). Явное значение вне потолка (600 000 мс) — **fail-closed**:
|
|
287
|
+
// молча обрезанный таймаут выглядел бы как «применилось», а не как ошибка.
|
|
288
|
+
const browserTimeoutMs = resolveBrowserTimeoutMs(remoteCfg.browserTimeoutMs, env);
|
|
289
|
+
const profiles = resolveExecutionProfiles(remoteCfg.profiles, {
|
|
290
|
+
url,
|
|
291
|
+
timeoutMs,
|
|
292
|
+
concurrency,
|
|
293
|
+
failMode,
|
|
294
|
+
});
|
|
295
|
+
const fallback = resolveFallback(remoteCfg.fallback, env);
|
|
296
|
+
// PROP-135 Ф4b-1: провайдер пулов и параметры provisioner'а. Порядок тот
|
|
297
|
+
// же (env > config.yaml > дефолт); неизвестное **явное** значение провайдера
|
|
298
|
+
// — fail-closed (как `mode`/`failMode`/`pooling`).
|
|
299
|
+
const provider = resolvePoolProvider(remoteCfg.provider, env);
|
|
300
|
+
const provisioner = resolveProvisioner(remoteCfg.provisioner, env);
|
|
301
|
+
// Fail-closed: провайдер `http` без адреса provisioner'а — «куда обращаться»
|
|
302
|
+
// не задано. Молчаливый откат на `static` означал бы, что оператор запросил
|
|
303
|
+
// динамические пулы, а получил статические (изоляция пулов нарушена).
|
|
304
|
+
if (provider === 'http' && provisioner.url.trim() === '') {
|
|
305
|
+
throw new Error(`[config] execution.remote.provider="http" требует адрес provisioner'а ` +
|
|
306
|
+
`(execution.remote.provisioner.url / ${EXECUTION_ENV.provisionerUrl})`);
|
|
307
|
+
}
|
|
117
308
|
return {
|
|
118
309
|
mode,
|
|
119
|
-
remote: {
|
|
310
|
+
remote: {
|
|
311
|
+
url,
|
|
312
|
+
timeoutMs,
|
|
313
|
+
concurrency,
|
|
314
|
+
failMode,
|
|
315
|
+
tokenSecret,
|
|
316
|
+
pooling,
|
|
317
|
+
defaultProfile,
|
|
318
|
+
browserProfile,
|
|
319
|
+
browserProfiles,
|
|
320
|
+
browserMcpServer,
|
|
321
|
+
browserTimeoutMs,
|
|
322
|
+
profiles,
|
|
323
|
+
// ADR-135 (аддендум §11): происхождение профилей config-уровня — все
|
|
324
|
+
// они из `config.yaml` (их можно отключить через `disabledProfiles`).
|
|
325
|
+
profileOrigins: Object.fromEntries(Object.keys(profiles).map((name) => [name, 'config'])),
|
|
326
|
+
fallback,
|
|
327
|
+
provider,
|
|
328
|
+
provisioner,
|
|
329
|
+
},
|
|
330
|
+
};
|
|
331
|
+
}
|
|
332
|
+
/**
|
|
333
|
+
* Провайдер пулов: env > config.yaml > `static`.
|
|
334
|
+
* Неизвестное явное значение — **fail-closed**.
|
|
335
|
+
*/
|
|
336
|
+
function resolvePoolProvider(cfgValue, env) {
|
|
337
|
+
const raw = env[EXECUTION_ENV.provider];
|
|
338
|
+
if (raw !== undefined && raw !== '') {
|
|
339
|
+
const trimmed = raw.trim();
|
|
340
|
+
if (isExecutionPoolProvider(trimmed))
|
|
341
|
+
return trimmed;
|
|
342
|
+
throw new Error(invalidProviderMessage(EXECUTION_ENV.provider, raw));
|
|
343
|
+
}
|
|
344
|
+
if (cfgValue !== undefined) {
|
|
345
|
+
if (isExecutionPoolProvider(cfgValue))
|
|
346
|
+
return cfgValue;
|
|
347
|
+
throw new Error(invalidProviderMessage('execution.remote.provider', String(cfgValue)));
|
|
348
|
+
}
|
|
349
|
+
return 'static';
|
|
350
|
+
}
|
|
351
|
+
/**
|
|
352
|
+
* Параметры provisioner'а: env > config.yaml > дефолт (пустой адрес, пустой
|
|
353
|
+
* токен, таймаут 10 с).
|
|
354
|
+
*
|
|
355
|
+
* `tokenSecret` — **путь/ссылка**, НЕ значение (инвариант 13): значение
|
|
356
|
+
* читается из файла в момент обращения к provisioner'у.
|
|
357
|
+
*/
|
|
358
|
+
function resolveProvisioner(cfgValue, env) {
|
|
359
|
+
const rawUrl = env[EXECUTION_ENV.provisionerUrl];
|
|
360
|
+
const url = rawUrl !== undefined && rawUrl !== ''
|
|
361
|
+
? rawUrl.trim()
|
|
362
|
+
: (cfgValue?.url ?? '').trim();
|
|
363
|
+
const rawToken = env[EXECUTION_ENV.provisionerToken];
|
|
364
|
+
const tokenSecret = rawToken !== undefined && rawToken !== ''
|
|
365
|
+
? rawToken
|
|
366
|
+
: (cfgValue?.tokenSecret ?? '');
|
|
367
|
+
const timeoutMs = resolvePositiveInt(env[EXECUTION_ENV.provisionerTimeoutMs], cfgValue?.timeoutMs, EXECUTION_ENV.provisionerTimeoutMs) ?? DEFAULT_EXECUTION_PROVISIONER_TIMEOUT_MS;
|
|
368
|
+
return { url, tokenSecret, timeoutMs };
|
|
369
|
+
}
|
|
370
|
+
/**
|
|
371
|
+
* Режим пула: env > config.yaml > `instance`.
|
|
372
|
+
* Неизвестное явное значение — **fail-closed** (опечатка не должна молча
|
|
373
|
+
* оставить инстанс в instance-пуле).
|
|
374
|
+
*/
|
|
375
|
+
function resolvePooling(cfgValue, env) {
|
|
376
|
+
const raw = env[EXECUTION_ENV.pooling];
|
|
377
|
+
if (raw !== undefined && raw !== '') {
|
|
378
|
+
const trimmed = raw.trim();
|
|
379
|
+
if (isExecutionPooling(trimmed))
|
|
380
|
+
return trimmed;
|
|
381
|
+
throw new Error(invalidPoolingMessage(EXECUTION_ENV.pooling, raw));
|
|
382
|
+
}
|
|
383
|
+
if (cfgValue !== undefined) {
|
|
384
|
+
if (isExecutionPooling(cfgValue))
|
|
385
|
+
return cfgValue;
|
|
386
|
+
throw new Error(invalidPoolingMessage('execution.remote.pooling', String(cfgValue)));
|
|
387
|
+
}
|
|
388
|
+
return 'instance';
|
|
389
|
+
}
|
|
390
|
+
/**
|
|
391
|
+
* Поведение при непригодном профиле: env > config.yaml > `instance`.
|
|
392
|
+
* Неизвестное явное значение — **fail-closed**.
|
|
393
|
+
*/
|
|
394
|
+
function resolveFallback(cfgValue, env) {
|
|
395
|
+
const raw = env[EXECUTION_ENV.fallback];
|
|
396
|
+
if (raw !== undefined && raw !== '') {
|
|
397
|
+
const trimmed = raw.trim();
|
|
398
|
+
if (isExecutionFallback(trimmed))
|
|
399
|
+
return trimmed;
|
|
400
|
+
throw new Error(invalidFallbackMessage(EXECUTION_ENV.fallback, raw));
|
|
401
|
+
}
|
|
402
|
+
if (cfgValue !== undefined) {
|
|
403
|
+
if (isExecutionFallback(cfgValue))
|
|
404
|
+
return cfgValue;
|
|
405
|
+
throw new Error(invalidFallbackMessage('execution.remote.fallback', String(cfgValue)));
|
|
406
|
+
}
|
|
407
|
+
return 'instance';
|
|
408
|
+
}
|
|
409
|
+
/**
|
|
410
|
+
* Имя профиля по умолчанию: env > config.yaml > `default`.
|
|
411
|
+
*
|
|
412
|
+
* Пустое значение (env или config) — «не задано»: берётся следующий
|
|
413
|
+
* источник, иначе `default`. Имя профиля — обычная строка (каталог задаёт
|
|
414
|
+
* ADMIN), поэтому проверяется только непустота.
|
|
415
|
+
*/
|
|
416
|
+
function resolveDefaultProfile(cfgValue, env) {
|
|
417
|
+
return resolveConfiguredName(EXECUTION_ENV.defaultProfile, cfgValue, 'default', env);
|
|
418
|
+
}
|
|
419
|
+
/**
|
|
420
|
+
* Непустое имя из конфигурации: env > config.yaml > `fallback`.
|
|
421
|
+
*
|
|
422
|
+
* Пустое значение (env или config) — «не задано»: берётся следующий источник.
|
|
423
|
+
* Имя профиля/сервера — обычная строка (каталог задаёт ADMIN), поэтому
|
|
424
|
+
* проверяется только непустота.
|
|
425
|
+
*/
|
|
426
|
+
function resolveConfiguredName(envName, cfgValue, fallback, env) {
|
|
427
|
+
const raw = env[envName];
|
|
428
|
+
if (raw !== undefined && raw.trim() !== '')
|
|
429
|
+
return raw.trim();
|
|
430
|
+
const cfgTrimmed = (cfgValue ?? '').trim();
|
|
431
|
+
if (cfgTrimmed !== '')
|
|
432
|
+
return cfgTrimmed;
|
|
433
|
+
return fallback;
|
|
434
|
+
}
|
|
435
|
+
/**
|
|
436
|
+
* Таймаут одного вызова браузерного MCP-инструмента, мс.
|
|
437
|
+
*
|
|
438
|
+
* env > config.yaml > дефолт (120 с). Явное значение проверяется
|
|
439
|
+
* **fail-closed**: не целое/не положительное/выше потолка (600 000 мс) —
|
|
440
|
+
* ошибка конфигурации, а не тихий откат на дефолт (явная настройка
|
|
441
|
+
* оператора не должна молча превращаться в другую).
|
|
442
|
+
*/
|
|
443
|
+
function resolveBrowserTimeoutMs(cfgValue, env) {
|
|
444
|
+
const raw = env[EXECUTION_ENV.browserTimeoutMs];
|
|
445
|
+
if (raw !== undefined && raw.trim() !== '') {
|
|
446
|
+
const value = Number(raw.trim());
|
|
447
|
+
if (!Number.isInteger(value) || value < 1 || value > MAX_EXECUTION_BROWSER_TIMEOUT_MS) {
|
|
448
|
+
throw new Error(`[config] невалидное значение ${EXECUTION_ENV.browserTimeoutMs}="${raw}": ` +
|
|
449
|
+
`ожидается целое от 1 до ${MAX_EXECUTION_BROWSER_TIMEOUT_MS}`);
|
|
450
|
+
}
|
|
451
|
+
return value;
|
|
452
|
+
}
|
|
453
|
+
if (cfgValue !== undefined) {
|
|
454
|
+
if (!Number.isInteger(cfgValue) ||
|
|
455
|
+
cfgValue < 1 ||
|
|
456
|
+
cfgValue > MAX_EXECUTION_BROWSER_TIMEOUT_MS) {
|
|
457
|
+
throw new Error(`[config] невалидное значение execution.remote.browserTimeoutMs="${cfgValue}": ` +
|
|
458
|
+
`ожидается целое от 1 до ${MAX_EXECUTION_BROWSER_TIMEOUT_MS}`);
|
|
459
|
+
}
|
|
460
|
+
return cfgValue;
|
|
461
|
+
}
|
|
462
|
+
return DEFAULT_EXECUTION_BROWSER_TIMEOUT_MS;
|
|
463
|
+
}
|
|
464
|
+
/**
|
|
465
|
+
* Эффективные параметры профилей (PROP-135 Ф4a): профиль **поверх** общих
|
|
466
|
+
* параметров секции.
|
|
467
|
+
*
|
|
468
|
+
* - `url` профиля пуст → наследует общий `execution.remote.url`;
|
|
469
|
+
* - `timeoutMs`/`concurrency`/`failMode` не заданы → наследуют общие.
|
|
470
|
+
*
|
|
471
|
+
* Профили задаются **только** в `config.yaml` (env-переопределение каталога
|
|
472
|
+
* профилей на этом шаге не заводим).
|
|
473
|
+
*/
|
|
474
|
+
function resolveExecutionProfiles(cfgProfiles, common) {
|
|
475
|
+
const out = {};
|
|
476
|
+
for (const [name, profile] of Object.entries(cfgProfiles ?? {})) {
|
|
477
|
+
const profileUrl = (profile.url ?? []).map((u) => u.trim()).filter((u) => u.length > 0);
|
|
478
|
+
const resolved = {
|
|
479
|
+
url: profileUrl.length > 0 ? profileUrl : [...common.url],
|
|
480
|
+
timeoutMs: profile.timeoutMs ?? common.timeoutMs,
|
|
481
|
+
concurrency: profile.concurrency ?? common.concurrency,
|
|
482
|
+
failMode: profile.failMode ?? common.failMode,
|
|
483
|
+
};
|
|
484
|
+
// Метаданные (не участвуют в маршрутизации): пустые/undefined не задаём.
|
|
485
|
+
const description = profile.description?.trim();
|
|
486
|
+
if (description !== undefined && description !== '')
|
|
487
|
+
resolved.description = description;
|
|
488
|
+
const image = profile.image?.trim();
|
|
489
|
+
if (image !== undefined && image !== '')
|
|
490
|
+
resolved.image = image;
|
|
491
|
+
if (profile.network !== undefined)
|
|
492
|
+
resolved.network = profile.network;
|
|
493
|
+
const resources = resolveProfileResources(profile.resources);
|
|
494
|
+
if (resources !== undefined)
|
|
495
|
+
resolved.resources = resources;
|
|
496
|
+
const runtimeClass = profile.runtimeClass?.trim();
|
|
497
|
+
if (runtimeClass !== undefined && runtimeClass !== '')
|
|
498
|
+
resolved.runtimeClass = runtimeClass;
|
|
499
|
+
// Placement профиля (аннотации/метки/отбор нод) — уходит в pod spec
|
|
500
|
+
// пула; пустые блоки не задаём (метаданные не должны шуметь).
|
|
501
|
+
const annotations = normalizeStringMap(profile.annotations);
|
|
502
|
+
if (annotations !== undefined)
|
|
503
|
+
resolved.annotations = annotations;
|
|
504
|
+
const labels = normalizeStringMap(profile.labels);
|
|
505
|
+
if (labels !== undefined)
|
|
506
|
+
resolved.labels = labels;
|
|
507
|
+
const nodeSelector = normalizeStringMap(profile.nodeSelector);
|
|
508
|
+
if (nodeSelector !== undefined)
|
|
509
|
+
resolved.nodeSelector = nodeSelector;
|
|
510
|
+
if (profile.tolerations !== undefined && profile.tolerations.length > 0) {
|
|
511
|
+
resolved.tolerations = profile.tolerations.map((toleration) => ({ ...toleration }));
|
|
512
|
+
}
|
|
513
|
+
if (profile.affinity !== undefined && Object.keys(profile.affinity).length > 0) {
|
|
514
|
+
resolved.affinity = { ...profile.affinity };
|
|
515
|
+
}
|
|
516
|
+
// Объявленный класс профиля (ADR-135, аддендум §11): эффективный класс
|
|
517
|
+
// выводится из него, legacy-списка `browserProfiles` и `browserProfile`.
|
|
518
|
+
if (profile.class !== undefined)
|
|
519
|
+
resolved.class = profile.class;
|
|
520
|
+
// Config-уровень хранит только **имена** MCP-серверов (команда — в
|
|
521
|
+
// runtime-каталоге): нормализуем в `{ name }`.
|
|
522
|
+
const mcpServers = (profile.mcpServers ?? [])
|
|
523
|
+
.map((s) => s.trim())
|
|
524
|
+
.filter((s) => s.length > 0)
|
|
525
|
+
.map((name) => ({ name }));
|
|
526
|
+
if (mcpServers.length > 0)
|
|
527
|
+
resolved.mcpServers = mcpServers;
|
|
528
|
+
out[name] = resolved;
|
|
529
|
+
}
|
|
530
|
+
return out;
|
|
531
|
+
}
|
|
532
|
+
/**
|
|
533
|
+
* Карта строковых значений профиля (аннотации/метки/селектор): копия без
|
|
534
|
+
* пустых ключей и значений; пустая карта — `undefined` (поле не задано).
|
|
535
|
+
*/
|
|
536
|
+
function normalizeStringMap(map) {
|
|
537
|
+
if (map === undefined)
|
|
538
|
+
return undefined;
|
|
539
|
+
const out = {};
|
|
540
|
+
for (const [key, value] of Object.entries(map)) {
|
|
541
|
+
const trimmedKey = key.trim();
|
|
542
|
+
const trimmedValue = typeof value === 'string' ? value.trim() : '';
|
|
543
|
+
if (trimmedKey === '' || trimmedValue === '')
|
|
544
|
+
continue;
|
|
545
|
+
out[trimmedKey] = trimmedValue;
|
|
546
|
+
}
|
|
547
|
+
return Object.keys(out).length > 0 ? out : undefined;
|
|
548
|
+
}
|
|
549
|
+
/**
|
|
550
|
+
* Ресурсы профиля: копируются только заданные непустые строки; пустой объект
|
|
551
|
+
* (ни одного значения) → `undefined`, чтобы метаданные не шумели в ответе.
|
|
552
|
+
*/
|
|
553
|
+
function resolveProfileResources(resources) {
|
|
554
|
+
if (resources === undefined)
|
|
555
|
+
return undefined;
|
|
556
|
+
const requests = resolveResourceList(resources.requests);
|
|
557
|
+
const limits = resolveResourceList(resources.limits);
|
|
558
|
+
if (requests === undefined && limits === undefined)
|
|
559
|
+
return undefined;
|
|
560
|
+
return {
|
|
561
|
+
...(requests !== undefined ? { requests } : {}),
|
|
562
|
+
...(limits !== undefined ? { limits } : {}),
|
|
120
563
|
};
|
|
121
564
|
}
|
|
565
|
+
function resolveResourceList(list) {
|
|
566
|
+
if (list === undefined)
|
|
567
|
+
return undefined;
|
|
568
|
+
// Список **произвольный** (`nvidia.com/gpu` и пр.) — копируются все ключи,
|
|
569
|
+
// а не только cpu/memory/ephemeralStorage.
|
|
570
|
+
const out = {};
|
|
571
|
+
for (const [key, value] of Object.entries(list)) {
|
|
572
|
+
const trimmed = typeof value === 'string' ? value.trim() : '';
|
|
573
|
+
if (trimmed !== '')
|
|
574
|
+
out[key] = trimmed;
|
|
575
|
+
}
|
|
576
|
+
return Object.keys(out).length > 0 ? out : undefined;
|
|
577
|
+
}
|
|
122
578
|
function resolveFailMode(cfgValue, env) {
|
|
123
579
|
const raw = env[EXECUTION_ENV.failMode];
|
|
124
580
|
if (raw !== undefined && raw !== '') {
|
package/dist/config/index.d.ts
CHANGED
|
@@ -4,7 +4,10 @@ export * from './loader.js';
|
|
|
4
4
|
export * from './env-overrides.js';
|
|
5
5
|
export * from './merge.js';
|
|
6
6
|
export * from './resolve.js';
|
|
7
|
+
export * from './redact.js';
|
|
7
8
|
export * from './execution.js';
|
|
9
|
+
export * from './security.js';
|
|
10
|
+
export * from './execution-runtime.js';
|
|
8
11
|
export * from './tls.js';
|
|
9
12
|
export * from './tls-runtime.js';
|
|
10
13
|
export * from './proxy.js';
|
package/dist/config/index.js
CHANGED
|
@@ -4,7 +4,10 @@ export * from './loader.js';
|
|
|
4
4
|
export * from './env-overrides.js';
|
|
5
5
|
export * from './merge.js';
|
|
6
6
|
export * from './resolve.js';
|
|
7
|
+
export * from './redact.js';
|
|
7
8
|
export * from './execution.js';
|
|
9
|
+
export * from './security.js';
|
|
10
|
+
export * from './execution-runtime.js';
|
|
8
11
|
export * from './tls.js';
|
|
9
12
|
export * from './tls-runtime.js';
|
|
10
13
|
export * from './proxy.js';
|
package/dist/config/loader.d.ts
CHANGED
|
@@ -6,5 +6,13 @@ export interface LoadConfigOptions {
|
|
|
6
6
|
overrides?: Partial<SynthConfig>;
|
|
7
7
|
/** ADR-023: источник env для оверрайдов; по умолчанию `process.env` (в тестах — свой env). */
|
|
8
8
|
env?: NodeJS.ProcessEnv;
|
|
9
|
+
/**
|
|
10
|
+
* Дефолты профиля (например, backend/managed): глубокий мёрж **после**
|
|
11
|
+
* общего `defaultConfig` и **до** `config.yaml`/env/CLI. Позволяет профилю
|
|
12
|
+
* поднять дефолт (`llmGateway.enabled: true`), не перебивая явную
|
|
13
|
+
* конфигурацию (приоритет: CLI > env > config.yaml > профиль-дефолт >
|
|
14
|
+
* общий дефолт).
|
|
15
|
+
*/
|
|
16
|
+
baseDefaults?: Record<string, unknown>;
|
|
9
17
|
}
|
|
10
18
|
export declare function loadConfig(options?: LoadConfigOptions): Promise<SynthConfig>;
|
package/dist/config/loader.js
CHANGED
|
@@ -74,7 +74,12 @@ export async function loadConfig(options = {}) {
|
|
|
74
74
|
}
|
|
75
75
|
}
|
|
76
76
|
warnLegacyKeys(fileConfig, options.env ?? process.env);
|
|
77
|
-
|
|
77
|
+
// Профильные дефолты (backend/managed) — выше общего `defaultConfig`, но ниже
|
|
78
|
+
// `config.yaml`/env/CLI: явная настройка всегда перебивает профиль.
|
|
79
|
+
const withBaseDefaults = options.baseDefaults
|
|
80
|
+
? deepMerge(defaultConfig, options.baseDefaults)
|
|
81
|
+
: defaultConfig;
|
|
82
|
+
const merged = deepMerge(withBaseDefaults, fileConfig);
|
|
78
83
|
// ADR-023: env-оверрайды скалярных ключей вложенных секций применяются одним
|
|
79
84
|
// местом — поверх defaults + config.yaml и ниже CLI-overrides
|
|
80
85
|
// (приоритет: CLI > env > config.yaml > defaults).
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Редактирование секретов в дампе конфигурации (`synth config show`).
|
|
3
|
+
*
|
|
4
|
+
* `SynthConfig` может содержать значения секретов (`core.apiKey`,
|
|
5
|
+
* `security.secretKey`, `remote.auth.apiKey`, `auth.oidc.clientSecret`,
|
|
6
|
+
* `storage.postgres.password` и т.п.). Печатать такой дамп целиком нельзя:
|
|
7
|
+
* это утечка в журнал/терминал/CI. Хелпер возвращает **глубокую копию** с
|
|
8
|
+
* замаскированными непустыми значениями секретных ключей — исходный объект не
|
|
9
|
+
* мутируется.
|
|
10
|
+
*
|
|
11
|
+
* Маскируются только ключи с **точным** (case-insensitive) именем из списка;
|
|
12
|
+
* `timeout`, `tokenizer`, `apiKeyRoles` и другие похожие по подстроке ключи
|
|
13
|
+
* остаются как есть. Значение-маска — строка `'***'`.
|
|
14
|
+
*/
|
|
15
|
+
import type { SynthConfig } from './types.js';
|
|
16
|
+
/**
|
|
17
|
+
* Вернуть копию конфигурации с замаскированными секретами.
|
|
18
|
+
*
|
|
19
|
+
* Копирование — `structuredClone` (конфиг состоит из JSON-совместимых данных);
|
|
20
|
+
* fallback на JSON-клон для сред без `structuredClone`.
|
|
21
|
+
*/
|
|
22
|
+
export declare function redactConfigSecrets(config: SynthConfig): SynthConfig;
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/** Имена ключей, значения которых считаются секретами (без учёта регистра). */
|
|
2
|
+
const SECRET_KEY_NAMES = new Set([
|
|
3
|
+
'apiKey',
|
|
4
|
+
'tokenSecret',
|
|
5
|
+
'secretKey',
|
|
6
|
+
'password',
|
|
7
|
+
'token',
|
|
8
|
+
'clientSecret',
|
|
9
|
+
'privateKey',
|
|
10
|
+
'passphrase',
|
|
11
|
+
'secret',
|
|
12
|
+
'signingKey',
|
|
13
|
+
'webhookSecret',
|
|
14
|
+
].map((key) => key.toLowerCase()));
|
|
15
|
+
/** Строка-маска для скрытого значения. */
|
|
16
|
+
const MASK = '***';
|
|
17
|
+
/** Непустое значение (пустая строка/пробелы, null и undefined — не секрет). */
|
|
18
|
+
function isNonEmpty(value) {
|
|
19
|
+
if (value === undefined || value === null)
|
|
20
|
+
return false;
|
|
21
|
+
if (typeof value === 'string')
|
|
22
|
+
return value.trim().length > 0;
|
|
23
|
+
return true;
|
|
24
|
+
}
|
|
25
|
+
/** Рекурсивно замаскировать секретные ключи в копии значения. */
|
|
26
|
+
function maskSecrets(value) {
|
|
27
|
+
if (Array.isArray(value))
|
|
28
|
+
return value.map(maskSecrets);
|
|
29
|
+
if (value && typeof value === 'object') {
|
|
30
|
+
const source = value;
|
|
31
|
+
const result = {};
|
|
32
|
+
for (const [key, child] of Object.entries(source)) {
|
|
33
|
+
result[key] =
|
|
34
|
+
SECRET_KEY_NAMES.has(key.toLowerCase()) && isNonEmpty(child)
|
|
35
|
+
? MASK
|
|
36
|
+
: maskSecrets(child);
|
|
37
|
+
}
|
|
38
|
+
return result;
|
|
39
|
+
}
|
|
40
|
+
return value;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Вернуть копию конфигурации с замаскированными секретами.
|
|
44
|
+
*
|
|
45
|
+
* Копирование — `structuredClone` (конфиг состоит из JSON-совместимых данных);
|
|
46
|
+
* fallback на JSON-клон для сред без `structuredClone`.
|
|
47
|
+
*/
|
|
48
|
+
export function redactConfigSecrets(config) {
|
|
49
|
+
const clone = typeof structuredClone === 'function'
|
|
50
|
+
? structuredClone(config)
|
|
51
|
+
: JSON.parse(JSON.stringify(config));
|
|
52
|
+
return maskSecrets(clone);
|
|
53
|
+
}
|