@itphx/synth-shared 0.13.8 → 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.
Files changed (71) hide show
  1. package/dist/config/defaults.js +74 -2
  2. package/dist/config/env-overrides.d.ts +16 -0
  3. package/dist/config/env-overrides.js +103 -3
  4. package/dist/config/execution-runtime.d.ts +89 -0
  5. package/dist/config/execution-runtime.js +506 -0
  6. package/dist/config/execution.d.ts +202 -1
  7. package/dist/config/execution.js +459 -3
  8. package/dist/config/index.d.ts +2 -0
  9. package/dist/config/index.js +2 -0
  10. package/dist/config/security.d.ts +77 -0
  11. package/dist/config/security.js +116 -0
  12. package/dist/config/types.d.ts +466 -34
  13. package/dist/config/types.js +317 -33
  14. package/dist/i18n/index.d.ts +1 -1
  15. package/dist/i18n/index.js +196 -13
  16. package/dist/index.d.ts +5 -4
  17. package/dist/index.js +15 -2
  18. package/dist/schemas/index.d.ts +156 -19
  19. package/dist/schemas/index.js +126 -15
  20. package/dist/skills/frontmatter.js +1 -1
  21. package/dist/types/agent.d.ts +29 -1
  22. package/dist/types/authority.d.ts +10 -0
  23. package/dist/types/authority.js +8 -0
  24. package/dist/types/bus-events.d.ts +87 -1
  25. package/dist/types/catalog.d.ts +1 -1
  26. package/dist/types/catalog.js +1 -1
  27. package/dist/types/command-audit.d.ts +91 -0
  28. package/dist/types/command-audit.js +44 -0
  29. package/dist/types/commands.d.ts +29 -11
  30. package/dist/types/commands.js +2 -2
  31. package/dist/types/egress.d.ts +18 -3
  32. package/dist/types/egress.js +18 -3
  33. package/dist/types/events.d.ts +23 -2
  34. package/dist/types/execution.d.ts +424 -0
  35. package/dist/types/execution.js +355 -0
  36. package/dist/types/file-kind.d.ts +3 -2
  37. package/dist/types/file-kind.js +11 -2
  38. package/dist/types/git.d.ts +48 -0
  39. package/dist/types/index.d.ts +6 -0
  40. package/dist/types/index.js +18 -2
  41. package/dist/types/mentions.d.ts +96 -0
  42. package/dist/types/mentions.js +9 -0
  43. package/dist/types/message.d.ts +24 -1
  44. package/dist/types/message.js +13 -0
  45. package/dist/types/pack.d.ts +21 -21
  46. package/dist/types/pack.js +4 -4
  47. package/dist/types/permission.d.ts +8 -1
  48. package/dist/types/pipeline.d.ts +2 -2
  49. package/dist/types/plugin-protocol.d.ts +203 -4
  50. package/dist/types/plugin-protocol.js +77 -4
  51. package/dist/types/project-access.d.ts +94 -0
  52. package/dist/types/project-access.js +140 -0
  53. package/dist/types/project.d.ts +59 -2
  54. package/dist/types/project.js +20 -0
  55. package/dist/types/schedules.d.ts +49 -3
  56. package/dist/types/schedules.js +50 -1
  57. package/dist/types/scripts.d.ts +98 -0
  58. package/dist/types/scripts.js +14 -0
  59. package/dist/types/service-keys.d.ts +12 -2
  60. package/dist/types/service-keys.js +13 -0
  61. package/dist/types/session.d.ts +60 -3
  62. package/dist/types/skills.d.ts +15 -11
  63. package/dist/types/skills.js +6 -6
  64. package/dist/types/timers.d.ts +402 -0
  65. package/dist/types/timers.js +166 -0
  66. package/dist/types/tools.d.ts +124 -1
  67. package/dist/types/tools.js +22 -0
  68. package/dist/types/user.d.ts +17 -0
  69. package/dist/version.d.ts +1 -1
  70. package/dist/version.js +1 -1
  71. package/package.json +2 -2
@@ -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`) или `failMode` — ошибка, а не тихий выбор дефолта.
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: { url, timeoutMs, concurrency, failMode, tokenSecret },
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 !== '') {
@@ -6,6 +6,8 @@ export * from './merge.js';
6
6
  export * from './resolve.js';
7
7
  export * from './redact.js';
8
8
  export * from './execution.js';
9
+ export * from './security.js';
10
+ export * from './execution-runtime.js';
9
11
  export * from './tls.js';
10
12
  export * from './tls-runtime.js';
11
13
  export * from './proxy.js';
@@ -6,6 +6,8 @@ export * from './merge.js';
6
6
  export * from './resolve.js';
7
7
  export * from './redact.js';
8
8
  export * from './execution.js';
9
+ export * from './security.js';
10
+ export * from './execution-runtime.js';
9
11
  export * from './tls.js';
10
12
  export * from './tls-runtime.js';
11
13
  export * from './proxy.js';
@@ -0,0 +1,77 @@
1
+ /**
2
+ * ADR-023: резолвер защиты от indirect prompt injection (`security.promptInjection`).
3
+ *
4
+ * Приоритет эффективного значения — **env > runtime (`settings.json`/PG) >
5
+ * config.yaml > дефолт схемы** (`enabled: true`, `wrapContent: true`,
6
+ * `mode: 'flag'`).
7
+ *
8
+ * `wrapContent` runtime-настройкой **не управляется**: это deployment-политика
9
+ * обёртки tool-контента (`[CONTENT | SOURCE: … | trust: …]`), она берётся из
10
+ * config.yaml (или дефолта), а не из UI.
11
+ *
12
+ * Env-ключи (`SYNTH_SECURITY_PROMPT_INJECTION_ENABLED`/`…_MODE`) намеренно
13
+ * **не** входят в `ENV_OVERRIDES` (`env-overrides.ts`): там только двухуровневые
14
+ * пути `<section>.<key>`, а у `promptInjection` два поля и нужен
15
+ * `envLockedFields` (фиксация проверяется **по полю**, как у `resolveSshMode`).
16
+ * Невалидное env-значение — warn + игнор (fail-soft).
17
+ */
18
+ import type { PromptInjectionConfig } from './types.js';
19
+ /** Режим детекции подозрительных паттернов (канон схемы). */
20
+ export type PromptInjectionMode = PromptInjectionConfig['mode'];
21
+ /** Канонические режимы (для валидации env/API). */
22
+ export declare const PROMPT_INJECTION_MODES: readonly PromptInjectionMode[];
23
+ /** Поля секции, управляемые runtime-настройкой (и env-фиксацией). */
24
+ export type PromptInjectionField = 'enabled' | 'mode';
25
+ /** Канонический порядок полей (для `envLockedFields` и обхода). */
26
+ export declare const PROMPT_INJECTION_FIELDS: readonly PromptInjectionField[];
27
+ /**
28
+ * Runtime-патч защиты от prompt injection (раздел «Безопасность» в UI).
29
+ *
30
+ * `wrapContent` сюда не входит осознанно — runtime его не перекрывает.
31
+ */
32
+ export interface PromptInjectionRuntimePatch {
33
+ enabled?: boolean;
34
+ mode?: PromptInjectionMode;
35
+ }
36
+ /** Источник эффективного значения (по полям, наиболее специфичный). */
37
+ export type PromptInjectionSource = 'env' | 'runtime' | 'config' | 'default';
38
+ /** Результат резолвинга `security.promptInjection` (env > runtime > config > default). */
39
+ export interface ResolvedPromptInjectionConfig {
40
+ /** Эффективная секция (все поля заданы) — её читают guard и оркестратор. */
41
+ config: PromptInjectionConfig;
42
+ /** Наиболее специфичный источник среди полей `enabled`/`mode`. */
43
+ source: PromptInjectionSource;
44
+ /** Хотя бы одно поле задано через env: runtime его не перекрывает. */
45
+ envLocked: boolean;
46
+ /** Поля, зафиксированные env: из UI они `disabled` и не уходят в `PUT`. */
47
+ envLockedFields: PromptInjectionField[];
48
+ /** База без runtime и env (к чему вернёт сброс) — для `defaults` в ответе API. */
49
+ defaults: PromptInjectionConfig;
50
+ }
51
+ /** Env-имя выключателя защиты (ADR-023). */
52
+ export declare const PROMPT_INJECTION_ENABLED_ENV = "SYNTH_SECURITY_PROMPT_INJECTION_ENABLED";
53
+ /** Env-имя режима детекции (ADR-023). */
54
+ export declare const PROMPT_INJECTION_MODE_ENV = "SYNTH_SECURITY_PROMPT_INJECTION_MODE";
55
+ /** Дефолты схемы — совпадают с `defaultConfig.security.promptInjection`. */
56
+ export declare const DEFAULT_PROMPT_INJECTION_CONFIG: PromptInjectionConfig;
57
+ /** Прочитать boolean из env (`true`/`1`, `false`/`0`); пусто/невалидно — «не задано». */
58
+ export declare function parsePromptInjectionEnabledEnv(env?: NodeJS.ProcessEnv): boolean | undefined;
59
+ /** Прочитать режим из env; невалидное — warn + игнор (fail-soft). */
60
+ export declare function parsePromptInjectionModeEnv(env?: NodeJS.ProcessEnv): PromptInjectionMode | undefined;
61
+ /**
62
+ * Эффективная секция `security.promptInjection` — приоритет
63
+ * **env > runtime > config.yaml > дефолт схемы**.
64
+ *
65
+ * **«Задано явно» vs «дефолт».** Схема конфига префилит секцию
66
+ * (`promptInjectionConfigSchema.prefault({})`), поэтому на чистом инстансе
67
+ * `config` уже равен дефолтам — хотя в `config.yaml` значений нет. Поле,
68
+ * значение которого равно дефолту схемы, отдаётся с `source:'default'`
69
+ * (UI показывает бейдж «по умолчанию»); явное значение в конфиге, совпавшее с
70
+ * дефолтом, неотличимо от его отсутствия — эффективное значение одно и то же
71
+ * (тот же приём, что у `resolveBackgroundConfig`/`resolveSessionOpsPerMinute`).
72
+ *
73
+ * Функция чистая (без I/O): её читают точка сборки (старт процесса), роут
74
+ * `/api/v2/settings/security` и live-применение из UI — расхождений в
75
+ * приоритете быть не должно.
76
+ */
77
+ export declare function resolvePromptInjection(config?: Partial<PromptInjectionConfig>, runtime?: PromptInjectionRuntimePatch, env?: NodeJS.ProcessEnv): ResolvedPromptInjectionConfig;