@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/types.js
CHANGED
|
@@ -4,6 +4,13 @@ import { contextDefaultsSchema, createToolsDisabledSchema, globalRoleSchema, ser
|
|
|
4
4
|
import { TOOLS_POLICIES, MCP_NETWORK_POLICY_MODES, COMMAND_CONFLICT_MODES, DEFAULT_MCP_PRIVATE_CIDRS, DEFAULT_MCP_NETWORK_POLICY, DEFAULT_EGRESS_TOOLS_POLICY, DEFAULT_EGRESS_WEBHOOKS_POLICY, DEFAULT_EGRESS_LOG, EGRESS_POLICY_MODES, WEBHOOKS_EGRESS_POLICY_MODES, DEFAULT_LLM_GATEWAY_RATE_LIMIT, DEFAULT_LLM_FILTER_TIMEOUT_MS, MIN_UPLOAD_BYTES, MAX_UPLOAD_BYTES_LIMIT, MIN_READ_BYTES, MAX_READ_BYTES_LIMIT, MIN_PREVIEW_BYTES, MAX_PREVIEW_BYTES_LIMIT, ToolCapability, } from '../types/index.js';
|
|
5
5
|
import { catalogTrustLevelSchema } from '../types/trust.js';
|
|
6
6
|
import { PLUGIN_HYBRID_MODES } from '../types/plugin-hybrid.js';
|
|
7
|
+
import { GlobalRole } from '../types/user.js';
|
|
8
|
+
// ADR-135: канонические перечисления секции `execution` — browser-safe
|
|
9
|
+
// (`types/execution.ts`), здесь импортируются для схемы конфигурации.
|
|
10
|
+
import { DEFAULT_EXECUTION_BROWSER_MCP_SERVER, DEFAULT_EXECUTION_BROWSER_PROFILE, DEFAULT_EXECUTION_PROVISIONER_TIMEOUT_MS, DEFAULT_EXECUTION_TIMEOUT_MS, EXECUTION_FAIL_MODES, EXECUTION_FALLBACKS, EXECUTION_MODES, EXECUTION_POOLINGS, EXECUTION_POOL_PROVIDERS, EXECUTION_PROFILE_NETWORKS, EXECUTION_PROFILE_CLASSES, MAX_EXECUTION_BROWSER_TIMEOUT_MS, executionAffinitySchema, executionAnnotationValueSchema, executionLabelValueSchema, executionPodKeySchema, executionResourceListSchema, executionTolerationSchema, } from '../types/execution.js';
|
|
11
|
+
// PROP-124: режимы инстанса для SSH-ключей (`ssh.mode`) — канонический список
|
|
12
|
+
// в типах (browser-safe), чтобы UI и ядро читали один источник.
|
|
13
|
+
import { SSH_MODES } from '../types/git.js';
|
|
7
14
|
const toolCapabilityValues = Object.values(ToolCapability);
|
|
8
15
|
// --- SynthConfig: единый конфиг для всех компонентов ---
|
|
9
16
|
export const serverConfigSchema = z.object({
|
|
@@ -118,32 +125,19 @@ export const storageConfigSchema = z.object({
|
|
|
118
125
|
});
|
|
119
126
|
// --- Исполнение (ADR-077) ---
|
|
120
127
|
/**
|
|
121
|
-
* ADR-077:
|
|
128
|
+
* ADR-077/ADR-135: канонические перечисления и константы секции `execution`
|
|
129
|
+
* живут в **browser-safe** модуле `types/execution.ts` — их читает и ядро, и
|
|
130
|
+
* UI (админка «Исполнение»). Здесь — реэкспорт (обратная совместимость
|
|
131
|
+
* импортов `@itphx/synth-shared/config`).
|
|
122
132
|
*
|
|
123
|
-
*
|
|
124
|
-
*
|
|
125
|
-
* -
|
|
126
|
-
*
|
|
127
|
-
*
|
|
128
|
-
*
|
|
129
|
-
* рестартом процесса (инвариант 24 — process-глобальные решения не
|
|
130
|
-
* переинициализируются на лету). Значение `mode` — **fail-closed**: неизвестное
|
|
131
|
-
* явное значение (опечатка `inlne`) валит старт, а не молча выбирает дефолт
|
|
132
|
-
* (как `storage.backend`).
|
|
133
|
-
*/
|
|
134
|
-
export const EXECUTION_MODES = ['inline', 'remote'];
|
|
135
|
-
/**
|
|
136
|
-
* Поведение при недоступном исполнителе:
|
|
137
|
-
* - `fail` (дефолт) — fail-closed: инструмент недоступен с явной причиной;
|
|
138
|
-
* - `inline-fallback` — backend исполняет команду сам; **только явной настройкой**
|
|
139
|
-
* (в managed-контуре это обход изоляции).
|
|
133
|
+
* Топология исполнения — переключатель запуска (`execution.mode`):
|
|
134
|
+
* `inline` (дефолт) — исполнение в процессе control plane; `remote` —
|
|
135
|
+
* отдельные исполнители (ADR-077). Секция — **параметр запуска**, а не
|
|
136
|
+
* runtime-настройка: смена режима — только рестартом процесса (инвариант 24).
|
|
137
|
+
* Значение `mode` — **fail-closed**: неизвестное явное значение (опечатка
|
|
138
|
+
* `inlne`) валит старт, а не молча выбирает дефолт (как `storage.backend`).
|
|
140
139
|
*/
|
|
141
|
-
export
|
|
142
|
-
/**
|
|
143
|
-
* Таймаут exec-вызова по умолчанию (30 с — как у нынешних тулов: shell/search/git).
|
|
144
|
-
* Больший лимит для shell (до 120 с) — свойство тула, не конфига.
|
|
145
|
-
*/
|
|
146
|
-
export const DEFAULT_EXECUTION_TIMEOUT_MS = 30_000;
|
|
140
|
+
export { EXECUTION_MODES, EXECUTION_FAIL_MODES, EXECUTION_POOLINGS, EXECUTION_FALLBACKS, EXECUTION_POOL_PROVIDERS, EXECUTION_PROFILE_NETWORKS, EXECUTION_PROFILE_CLASSES, DEFAULT_EXECUTION_PROVISIONER_TIMEOUT_MS, DEFAULT_EXECUTION_TIMEOUT_MS, DEFAULT_EXECUTION_BROWSER_PROFILE, DEFAULT_EXECUTION_BROWSER_MCP_SERVER, DEFAULT_EXECUTION_BROWSER_TIMEOUT_MS, MAX_EXECUTION_BROWSER_TIMEOUT_MS, } from '../types/execution.js';
|
|
147
141
|
/**
|
|
148
142
|
* Параметры удалённого исполнителя (`execution.remote`).
|
|
149
143
|
*
|
|
@@ -164,6 +158,125 @@ export const executionRemoteConfigSchema = z.object({
|
|
|
164
158
|
failMode: z.enum(EXECUTION_FAIL_MODES).default('fail'),
|
|
165
159
|
/** Путь/ссылка на токен исполнителя (НЕ значение — инвариант 13). */
|
|
166
160
|
tokenSecret: z.string().default(''),
|
|
161
|
+
/**
|
|
162
|
+
* PROP-135 Ф4a: режим пула исполнителей. `instance` — общий порт на
|
|
163
|
+
* процесс (прежнее поведение); `project`/`session` — порт на профиль.
|
|
164
|
+
*/
|
|
165
|
+
pooling: z.enum(EXECUTION_POOLINGS).default('instance'),
|
|
166
|
+
/** Имя профиля по умолчанию (каталог профилей задаёт ADMIN). */
|
|
167
|
+
defaultProfile: z.string().default('default'),
|
|
168
|
+
/**
|
|
169
|
+
* Имя профиля для пула класса `browser` (браузер — проектный пул со своим
|
|
170
|
+
* образом). Используется, когда цель вызова класс `browser` и профиль не
|
|
171
|
+
* задан явно; `defaultProfile` для браузера **не** применяется.
|
|
172
|
+
*/
|
|
173
|
+
browserProfile: z.string().default(DEFAULT_EXECUTION_BROWSER_PROFILE),
|
|
174
|
+
/**
|
|
175
|
+
* PROP-135 (браузерный контур): явный каталог **браузерных** профилей.
|
|
176
|
+
*
|
|
177
|
+
* Имена из этого списка доступны только браузерному пулу (`class: 'browser'`)
|
|
178
|
+
* и **исключаются** из exec-каталога (`router.profiles()`); metadata-записи в
|
|
179
|
+
* `execution.remote.profiles` для них остаются (описание/сеть/mcpServers для
|
|
180
|
+
* details). Пусто — каталог равен `[browserProfile]` (обратная совместимость).
|
|
181
|
+
* Env — `SYNTH_EXECUTION_BROWSER_PROFILES` (csv).
|
|
182
|
+
*/
|
|
183
|
+
browserProfiles: z.array(z.string()).default([]),
|
|
184
|
+
/**
|
|
185
|
+
* Имя MCP-сервера браузера в поде исполнителя (встроенные `browser_*`-тулы
|
|
186
|
+
* адресуют вызов этому серверу).
|
|
187
|
+
*/
|
|
188
|
+
browserMcpServer: z.string().default(DEFAULT_EXECUTION_BROWSER_MCP_SERVER),
|
|
189
|
+
/**
|
|
190
|
+
* Таймаут одного вызова браузерного MCP-инструмента, мс.
|
|
191
|
+
*
|
|
192
|
+
* У тулов `browser_*` переопределяется параметром `timeout`; потолок —
|
|
193
|
+
* 600 000 мс (`MAX_EXECUTION_BROWSER_TIMEOUT_MS`). Не задан — дефолт
|
|
194
|
+
* 120 000 мс (`DEFAULT_EXECUTION_BROWSER_TIMEOUT_MS`).
|
|
195
|
+
*/
|
|
196
|
+
browserTimeoutMs: z
|
|
197
|
+
.number()
|
|
198
|
+
.int()
|
|
199
|
+
.min(1)
|
|
200
|
+
.max(MAX_EXECUTION_BROWSER_TIMEOUT_MS)
|
|
201
|
+
.optional(),
|
|
202
|
+
/**
|
|
203
|
+
* Каталог профилей исполнения (PROP-135 Ф4a): имя → параметры профиля.
|
|
204
|
+
* Профиль **поверх** общих параметров: пустой `url` наследует
|
|
205
|
+
* `execution.remote.url`, незаданные `timeoutMs`/`concurrency`/`failMode` —
|
|
206
|
+
* общие значения секции.
|
|
207
|
+
*/
|
|
208
|
+
profiles: z
|
|
209
|
+
.record(z.string(), z.object({
|
|
210
|
+
url: z.array(z.string()).default([]),
|
|
211
|
+
timeoutMs: z.number().int().min(1).optional(),
|
|
212
|
+
concurrency: z.number().int().min(1).optional(),
|
|
213
|
+
failMode: z.enum(EXECUTION_FAIL_MODES).optional(),
|
|
214
|
+
/**
|
|
215
|
+
* Метаданные профиля (для admin-API/UI): аддитивные поля, на
|
|
216
|
+
* маршрутизацию и создание портов **не** влияют.
|
|
217
|
+
*/
|
|
218
|
+
description: z.string().max(500).optional(),
|
|
219
|
+
image: z.string().optional(),
|
|
220
|
+
network: z.enum(EXECUTION_PROFILE_NETWORKS).optional(),
|
|
221
|
+
resources: z
|
|
222
|
+
.object({
|
|
223
|
+
requests: executionResourceListSchema.optional(),
|
|
224
|
+
limits: executionResourceListSchema.optional(),
|
|
225
|
+
})
|
|
226
|
+
.optional(),
|
|
227
|
+
/**
|
|
228
|
+
* Произвольные аннотации пода (`metadata.annotations`); служебные
|
|
229
|
+
* `synth.io/*` приоритетнее.
|
|
230
|
+
*/
|
|
231
|
+
annotations: z
|
|
232
|
+
.record(executionPodKeySchema, executionAnnotationValueSchema)
|
|
233
|
+
.optional(),
|
|
234
|
+
/** Пользовательские метки пода (`metadata.labels`). */
|
|
235
|
+
labels: z.record(executionPodKeySchema, executionLabelValueSchema).optional(),
|
|
236
|
+
/** `spec.nodeSelector` пода — отбор нод по меткам. */
|
|
237
|
+
nodeSelector: z.record(executionPodKeySchema, executionLabelValueSchema).optional(),
|
|
238
|
+
/** `spec.tolerations` пода — правила размещения на «tainted» нодах. */
|
|
239
|
+
tolerations: z.array(executionTolerationSchema).optional(),
|
|
240
|
+
/** `spec.affinity` пода — passthrough (JSON, ≤8 КиБ). */
|
|
241
|
+
affinity: executionAffinitySchema.optional(),
|
|
242
|
+
runtimeClass: z.string().optional(),
|
|
243
|
+
/**
|
|
244
|
+
* Класс профиля (ADR-135, аддендум §11): `exec` (дефолт) | `browser` |
|
|
245
|
+
* `both`. Профиль из legacy-списка `browserProfiles` получает
|
|
246
|
+
* эффективный класс `browser`, если класс не задан явно.
|
|
247
|
+
*/
|
|
248
|
+
class: z.enum(EXECUTION_PROFILE_CLASSES).optional(),
|
|
249
|
+
/** **Только имена** MCP-серверов профиля (без команд/env). */
|
|
250
|
+
mcpServers: z.array(z.string()).optional(),
|
|
251
|
+
}))
|
|
252
|
+
.default({}),
|
|
253
|
+
/**
|
|
254
|
+
* Поведение роутера при непригодном профиле: `instance` — откат на
|
|
255
|
+
* instance-порт; `fail` — fail-closed (старт прерывается).
|
|
256
|
+
*/
|
|
257
|
+
fallback: z.enum(EXECUTION_FALLBACKS).default('instance'),
|
|
258
|
+
/**
|
|
259
|
+
* Провайдер пулов исполнения (PROP-135 Ф4b-1): `static` — пулы из
|
|
260
|
+
* конфигурации (адреса профиля, порт на старте); `http` — пулы запрашиваются
|
|
261
|
+
* у provisioner'а (`execution.remote.provisioner.url`).
|
|
262
|
+
*/
|
|
263
|
+
provider: z.enum(EXECUTION_POOL_PROVIDERS).default('static'),
|
|
264
|
+
/**
|
|
265
|
+
* Параметры provisioner'а пулов (PROP-135 Ф4b-1).
|
|
266
|
+
*
|
|
267
|
+
* - `url` — адрес provisioner'а; пусто при `provider: http` → **fail-closed**
|
|
268
|
+
* на старте (провайдер задан, но куда обращаться — не указано);
|
|
269
|
+
* - `tokenSecret` — **путь/ссылка** на токен provisioner'а, НЕ значение
|
|
270
|
+
* (инвариант 13);
|
|
271
|
+
* - `timeoutMs` — таймаут обращения к provisioner'у.
|
|
272
|
+
*/
|
|
273
|
+
provisioner: z
|
|
274
|
+
.object({
|
|
275
|
+
url: z.string().default(''),
|
|
276
|
+
tokenSecret: z.string().default(''),
|
|
277
|
+
timeoutMs: z.number().int().min(1).default(DEFAULT_EXECUTION_PROVISIONER_TIMEOUT_MS),
|
|
278
|
+
})
|
|
279
|
+
.prefault({}),
|
|
167
280
|
});
|
|
168
281
|
/** ADR-077: секция `execution` — топология исполнения (параметр запуска). */
|
|
169
282
|
export const executionConfigSchema = z.object({
|
|
@@ -173,6 +286,12 @@ export const executionConfigSchema = z.object({
|
|
|
173
286
|
export const authConfigSchema = z.object({
|
|
174
287
|
debugMode: z.boolean().default(false),
|
|
175
288
|
apiKey: z.string().optional(),
|
|
289
|
+
/**
|
|
290
|
+
* Роли пользователя единого API-ключа (`auth.apiKey`, вне debug/OIDC).
|
|
291
|
+
* Дефолт — `USER`: права ADMIN не выдаются по факту наличия ключа, только
|
|
292
|
+
* явной настройкой (fail-closed). Env — `SYNTH_API_KEY_ROLES` (csv).
|
|
293
|
+
*/
|
|
294
|
+
apiKeyRoles: z.array(globalRoleSchema).default([GlobalRole.USER]),
|
|
176
295
|
testUsers: z
|
|
177
296
|
.array(z.object({
|
|
178
297
|
username: z.string(),
|
|
@@ -191,6 +310,17 @@ export const authConfigSchema = z.object({
|
|
|
191
310
|
redirectUri: z.string().default('http://localhost:5002/auth/callback'),
|
|
192
311
|
/** Public client_id для локального CLI/core (ROPC/device flow). Не секрет. */
|
|
193
312
|
cliClientId: z.string().default('synth-cli'),
|
|
313
|
+
/**
|
|
314
|
+
* ADR-140: источник групп пользователя — claim IdP + allowlist имён.
|
|
315
|
+
* Секция опциональна (старые конфиги без неё валидны); пустой allowlist —
|
|
316
|
+
* групп нет (fail-closed).
|
|
317
|
+
*/
|
|
318
|
+
groups: z
|
|
319
|
+
.object({
|
|
320
|
+
claim: z.string().min(1).default('groups'),
|
|
321
|
+
allow: z.array(z.string().min(1)).default([]),
|
|
322
|
+
})
|
|
323
|
+
.optional(),
|
|
194
324
|
})
|
|
195
325
|
.optional(),
|
|
196
326
|
});
|
|
@@ -396,9 +526,9 @@ export const toolsConfigSchema = z.object({
|
|
|
396
526
|
*/
|
|
397
527
|
outputMaxBytes: z.number().int().min(1).default(DEFAULT_TOOL_OUTPUT_MAX_BYTES),
|
|
398
528
|
});
|
|
399
|
-
// --- Скиллы (ADR-
|
|
529
|
+
// --- Скиллы (ADR-126) ---
|
|
400
530
|
/**
|
|
401
|
-
* ADR-
|
|
531
|
+
* ADR-126 §7/§4.4/§7.4: конфигурация механизма скиллов.
|
|
402
532
|
* `paths` — дополнительные пользовательские каталоги; `trustedProjectDirs` —
|
|
403
533
|
* доверенные проектные каталоги (бинарный trust); `inlineShell` — выключатель
|
|
404
534
|
* `!`cmd`` в шаблонных командах (по умолчанию выключено).
|
|
@@ -409,24 +539,24 @@ export const toolsConfigSchema = z.object({
|
|
|
409
539
|
* попадают, тело не грузится). Установка/доверие/подписи/`lock.json` — PROP-068.
|
|
410
540
|
*
|
|
411
541
|
* Внешние локальные каталоги совместимости (`.opencode`, `.claude`, `.agents`,
|
|
412
|
-
* `~/.config/opencode`) подключаются как read-only discovery в core (ADR-
|
|
542
|
+
* `~/.config/opencode`) подключаются как read-only discovery в core (ADR-126 §7).
|
|
413
543
|
*/
|
|
414
544
|
export const skillsConfigSchema = z.object({
|
|
415
545
|
paths: z.array(z.string()).default([]),
|
|
416
|
-
/** ADR-
|
|
546
|
+
/** ADR-126 §7/§4.3: удалённые каталоги — read-only индексация (`trusted: false`). */
|
|
417
547
|
urls: z.array(z.string()).default([]),
|
|
418
548
|
trustedProjectDirs: z.array(z.string()).default([]),
|
|
419
549
|
inlineShell: z.boolean().default(false),
|
|
420
550
|
/**
|
|
421
|
-
* ADR-
|
|
551
|
+
* ADR-126 §13/§12: именованные группы тулов → capabilities. Используется
|
|
422
552
|
* для экспансии `metadata.synth.requires_toolsets` в проверку доступности
|
|
423
553
|
* скилла (union с `requires_capabilities`).
|
|
424
554
|
*/
|
|
425
555
|
toolsets: z.record(z.string(), z.array(z.enum(toolCapabilityValues))).prefault({}),
|
|
426
556
|
});
|
|
427
|
-
// --- Slash-команды (ADR-
|
|
557
|
+
// --- Slash-команды (ADR-126 §1) ---
|
|
428
558
|
/**
|
|
429
|
-
* ADR-
|
|
559
|
+
* ADR-126 §1/§9.4: конфигурация slash-команд. `paths` — дополнительные каталоги
|
|
430
560
|
* шаблонных `.md`-команд; `bundlesPath` — подкаталог `{dataDir}` для YAML-бандлов;
|
|
431
561
|
* `conflict` — режим разрешения конфликтов имён (см. resolver).
|
|
432
562
|
*/
|
|
@@ -442,6 +572,18 @@ export const commandsConfigSchema = z.object({
|
|
|
442
572
|
maxArgumentsLength: z.number().int().min(1).default(10_000),
|
|
443
573
|
maxRenderedBytes: z.number().int().min(1).default(200_000),
|
|
444
574
|
});
|
|
575
|
+
// --- Скрипты проекта (ADR-126 §5) ---
|
|
576
|
+
/**
|
|
577
|
+
* ADR-126 §5: конфигурация реестра скриптов проекта (`!`-запуск).
|
|
578
|
+
*
|
|
579
|
+
* `paths` — дополнительные каталоги-источники деклараций `.synth/scripts`.
|
|
580
|
+
* Приоритет источников: проект (`{project.workspace}/.synth/scripts`) >
|
|
581
|
+
* инстанс (`{dataDir}/scripts`) > `config.scripts.paths` — как у команд и
|
|
582
|
+
* скиллов (ADR-126 §9).
|
|
583
|
+
*/
|
|
584
|
+
export const scriptsConfigSchema = z.object({
|
|
585
|
+
paths: z.array(z.string()).prefault([]),
|
|
586
|
+
});
|
|
445
587
|
// --- Внешние события (ADR-089) ---
|
|
446
588
|
/**
|
|
447
589
|
* ADR-089: конфигурация приёма внешних событий.
|
|
@@ -657,6 +799,23 @@ export const gitConfigSchema = z.object({
|
|
|
657
799
|
localTimeoutMs: z.number().int().min(0).default(120_000),
|
|
658
800
|
networkTimeoutMs: z.number().int().min(0).default(300_000),
|
|
659
801
|
});
|
|
802
|
+
// --- SSH-доступ агента (PROP-124) ---
|
|
803
|
+
/**
|
|
804
|
+
* PROP-124: режим работы инстанса с SSH-ключами.
|
|
805
|
+
*
|
|
806
|
+
* - `tools` — ключ попадает к потребителю через argv адресных тулов (`-i` на
|
|
807
|
+
* время вызова); политика хостов/портов на ключе обязательна;
|
|
808
|
+
* - `agent` — ключ выдаётся через эфемерный `ssh-agent` на время вызова
|
|
809
|
+
* (`SSH_AUTH_SOCK`); фильтрация по хостам не применяется, ограничение —
|
|
810
|
+
* на стороне хоста (`authorized_keys`).
|
|
811
|
+
*
|
|
812
|
+
* Дефолт — **`tools`** (fail-closed: без явного выбора ключ в окружение
|
|
813
|
+
* команд не попадает). Переключение режима — runtime-настройка инстанса
|
|
814
|
+
* (`/api/v2/settings/ssh`), применяется без рестарта.
|
|
815
|
+
*/
|
|
816
|
+
export const sshConfigSchema = z.object({
|
|
817
|
+
mode: z.enum(SSH_MODES).default('tools'),
|
|
818
|
+
});
|
|
660
819
|
// --- Вопросы пользователю (этап 1 roadmap 0.13 — блок 3) ---
|
|
661
820
|
/**
|
|
662
821
|
* Конфигурация подсистемы «вопрос пользователю» (`ask_user`).
|
|
@@ -699,6 +858,28 @@ export const backgroundConfigSchema = z.object({
|
|
|
699
858
|
logMaxBytes: z.number().int().min(0).default(10_485_760),
|
|
700
859
|
retentionDays: z.number().int().default(7),
|
|
701
860
|
});
|
|
861
|
+
// --- Автовосстановление прерванных ходов (PROP-142 §3) ---
|
|
862
|
+
/**
|
|
863
|
+
* Секция `recovery` — бюджет автовосстановления прерванных ходов после
|
|
864
|
+
* рестарта инстанса (PROP-142 §3).
|
|
865
|
+
*
|
|
866
|
+
* - `autoResume` — мастер-выключатель автовосстановления: при `false` инстанс
|
|
867
|
+
* не возобновляет прерванные ходы сам (деградация к «терминализировать»);
|
|
868
|
+
* - `maxAttempts` — максимум автовосстановлений **одного хода**: превышен →
|
|
869
|
+
* ход терминализируется (`failed`), владельцу уходит уведомление;
|
|
870
|
+
* - `crashLoop.windowMinutes` — окно детекта crash-loop (минуты);
|
|
871
|
+
* - `crashLoop.maxRestarts` — сколько рестартов в окне считаются crash-loop'ом.
|
|
872
|
+
*
|
|
873
|
+
* Решение владельца (2026-11-18): «попытки на ход + детект crash-loop».
|
|
874
|
+
*/
|
|
875
|
+
export const recoveryConfigSchema = z.object({
|
|
876
|
+
autoResume: z.boolean().default(true),
|
|
877
|
+
maxAttempts: z.number().int().min(1).default(3),
|
|
878
|
+
crashLoop: z.object({
|
|
879
|
+
windowMinutes: z.number().int().min(1).default(10),
|
|
880
|
+
maxRestarts: z.number().int().min(1).default(3),
|
|
881
|
+
}).prefault({}),
|
|
882
|
+
});
|
|
702
883
|
// --- Агенты: предохранители прогонов ---
|
|
703
884
|
/**
|
|
704
885
|
* Дефолт предохранителя по объёму промпта саб-агента
|
|
@@ -732,6 +913,22 @@ export const agentsConfigSchema = z.object({
|
|
|
732
913
|
subagentMaxInputTokens: z.number().int().min(0).default(DEFAULT_SUBAGENT_MAX_INPUT_TOKENS),
|
|
733
914
|
subagentDepth: z.number().int().min(0).default(DEFAULT_SUBAGENT_DEPTH),
|
|
734
915
|
});
|
|
916
|
+
// --- Лимиты тяжёлых операций с сессиями ---
|
|
917
|
+
/**
|
|
918
|
+
* Дефолт лимита тяжёлых операций с сессиями (import/export/fork/merge) в
|
|
919
|
+
* минуту на креду: 10. `0` — **без ограничения**.
|
|
920
|
+
*/
|
|
921
|
+
export const DEFAULT_SESSION_OPS_PER_MINUTE = 10;
|
|
922
|
+
/**
|
|
923
|
+
* Секция `limits` — instance-wide лимиты тяжёлых операций.
|
|
924
|
+
*
|
|
925
|
+
* - `sessionOpsPerMinute` — число тяжёлых операций с сессиями (import/export/
|
|
926
|
+
* fork/merge) в минуту на креду. Применяется ко всем четырём операциям;
|
|
927
|
+
* `0` — без ограничения.
|
|
928
|
+
*/
|
|
929
|
+
export const limitsConfigSchema = z.object({
|
|
930
|
+
sessionOpsPerMinute: z.number().int().min(0).default(DEFAULT_SESSION_OPS_PER_MINUTE),
|
|
931
|
+
});
|
|
735
932
|
// --- Authority-слой (ADR-106) ---
|
|
736
933
|
/**
|
|
737
934
|
* ADR-106 Ф1: конфигурация Authority-слоя.
|
|
@@ -945,6 +1142,33 @@ export const attachmentsConfigSchema = z.object({
|
|
|
945
1142
|
*/
|
|
946
1143
|
maxActiveUploads: z.number().int().min(1).default(256),
|
|
947
1144
|
});
|
|
1145
|
+
// --- Обновления пакета (ADR-133) ---
|
|
1146
|
+
/**
|
|
1147
|
+
* ADR-133: канал обновлений — значение настройки `updates.channel`.
|
|
1148
|
+
*
|
|
1149
|
+
* - `auto` (дефолт) — канал выводится из установленной версии: `-beta.` в
|
|
1150
|
+
* `SYNTH_VERSION` ⇒ `beta`, иначе `stable` (файл-маркер не заводится);
|
|
1151
|
+
* - `stable`/`beta` — явный override (в т.ч. для смены канала вручную).
|
|
1152
|
+
*/
|
|
1153
|
+
export const UPDATE_CHANNEL_CHOICES = ['auto', 'stable', 'beta'];
|
|
1154
|
+
/**
|
|
1155
|
+
* ADR-133: секция `updates` — каналы и проверка обновлений.
|
|
1156
|
+
*
|
|
1157
|
+
* - `check` — автопроверка обновлений в фоне (**по умолчанию выключена**:
|
|
1158
|
+
* офлайн-инстансы не должны шуметь запросами к реестрам);
|
|
1159
|
+
* - `channel` — `auto` (по установленной версии) | `stable` | `beta`;
|
|
1160
|
+
* - `intervalHours` — TTL успешной проверки, часы (ошибка кэшируется на 1 ч);
|
|
1161
|
+
* - `stableRegistry` — реестр стабильного канала (`latest`);
|
|
1162
|
+
* - `betaRegistry` — реестр бета-канала (`beta`; Gitea читается без токена,
|
|
1163
|
+
* токен нужен только публикации).
|
|
1164
|
+
*/
|
|
1165
|
+
export const updatesConfigSchema = z.object({
|
|
1166
|
+
check: z.boolean().default(false),
|
|
1167
|
+
channel: z.enum(['auto', 'stable', 'beta']).default('auto'),
|
|
1168
|
+
intervalHours: z.number().int().min(1).default(24),
|
|
1169
|
+
stableRegistry: z.string().default('https://registry.npmjs.org'),
|
|
1170
|
+
betaRegistry: z.string().default('https://git.itphx.ru/api/packages/itphx/npm/'),
|
|
1171
|
+
});
|
|
948
1172
|
// --- Наблюдаемость: Prometheus-метрики (ADR-094) ---
|
|
949
1173
|
/**
|
|
950
1174
|
* ADR-094: конфигурация экспорта метрик.
|
|
@@ -958,6 +1182,60 @@ export const attachmentsConfigSchema = z.object({
|
|
|
958
1182
|
export const metricsConfigSchema = z.object({
|
|
959
1183
|
enabled: z.boolean().default(false),
|
|
960
1184
|
});
|
|
1185
|
+
// --- Терминалы (PROP-132) ---
|
|
1186
|
+
/**
|
|
1187
|
+
* PROP-132: конфигурация интерактивных терминалов.
|
|
1188
|
+
*
|
|
1189
|
+
* - `enabled` — мастер-выключатель терминального контура: `false` — весь
|
|
1190
|
+
* контур `/api/v2/terminals*` отвечает `403 TERMINALS_DISABLED`, живые
|
|
1191
|
+
* терминалы закрываются, новые не создаются.
|
|
1192
|
+
*
|
|
1193
|
+
* Флаг **необязателен** в схеме намеренно: «не задано в config.yaml» должно
|
|
1194
|
+
* отличаться от «явно задано `true`» — по этому различаются источники
|
|
1195
|
+
* значения в API (`config` против `default`). Само значение по умолчанию
|
|
1196
|
+
* (`enabled: true`) живёт в резолвере ядра (`DEFAULT_TERMINAL_ENABLED`).
|
|
1197
|
+
*
|
|
1198
|
+
* - `autoRestore` — восстанавливать ли терминалы после рестарта ядра из
|
|
1199
|
+
* снимков (`terminals/<id>/meta.json` + `terminals/<id>/output.txt` в
|
|
1200
|
+
* blob-хранилище, ADR-096/ADR-116): `false` — снимки не поднимаются, их
|
|
1201
|
+
* убирает reaper. По умолчанию `true` (`DEFAULT_TERMINAL_AUTO_RESTORE`).
|
|
1202
|
+
*
|
|
1203
|
+
* PROP-132 (параметры выполнения): секция описывает не только мастер-флаги, но
|
|
1204
|
+
* и **параметры выполнения** терминалов, редактируемые из админки:
|
|
1205
|
+
*
|
|
1206
|
+
* - `idleMinutes` — простой (минуты) до закрытия терминала; он же TTL
|
|
1207
|
+
* снимков. Границы 30…10080, дефолт `2880` (2 дня);
|
|
1208
|
+
* - `maxPerProject` — предел живых терминалов на проект. Границы 1…64,
|
|
1209
|
+
* дефолт `8`;
|
|
1210
|
+
* - `maxPerInstance` — предел живых терминалов на инстанс. Границы 1…256,
|
|
1211
|
+
* дефолт `32`;
|
|
1212
|
+
* - `shell` — имя программы или абсолютный путь оболочки терминала
|
|
1213
|
+
* (`^[A-Za-z0-9._/+-]{1,200}$`, без пробелов). **Не задано** —
|
|
1214
|
+
* платформенный дефолт (`$SHELL` → `/bin/bash`);
|
|
1215
|
+
* - `auditInput` — писать ли `terminal.input` в журнал исполнений команд
|
|
1216
|
+
* (ADR-136). Дефолт `true`.
|
|
1217
|
+
*
|
|
1218
|
+
* Все поля **необязательны** (без `.default()`): «не задано в config.yaml» ≠
|
|
1219
|
+
* «задано значение по умолчанию» — по этому различаются источники значения в
|
|
1220
|
+
* API (`config` против `default`). Сами дефолты, границы и нормализация живут в
|
|
1221
|
+
* резолвере ядра (`engine/terminal/config.ts`) — единственном источнике истины.
|
|
1222
|
+
*
|
|
1223
|
+
* Env-оверрайды — `SYNTH_TERMINAL_*` (`ENABLED`, `AUTO_RESTORE`,
|
|
1224
|
+
* `IDLE_MINUTES`, `MAX_PER_PROJECT`, `MAX_PER_INSTANCE`, `SHELL`,
|
|
1225
|
+
* `AUDIT_INPUT`; общее правило секций, ADR-023).
|
|
1226
|
+
*/
|
|
1227
|
+
export const terminalConfigSchema = z.object({
|
|
1228
|
+
enabled: z.boolean().optional(),
|
|
1229
|
+
autoRestore: z.boolean().optional(),
|
|
1230
|
+
idleMinutes: z.number().int().min(30).max(10080).optional(),
|
|
1231
|
+
maxPerProject: z.number().int().min(1).max(64).optional(),
|
|
1232
|
+
maxPerInstance: z.number().int().min(1).max(256).optional(),
|
|
1233
|
+
shell: z
|
|
1234
|
+
.string()
|
|
1235
|
+
.regex(/^[A-Za-z0-9._/+-]{1,200}$/, 'terminal.shell: ожидается имя программы или абсолютный путь без пробелов (допустимы A-Za-z0-9._/+-), 1…200 символов')
|
|
1236
|
+
.optional(),
|
|
1237
|
+
auditInput: z.boolean().optional(),
|
|
1238
|
+
});
|
|
961
1239
|
// --- Webhooks (ADR-052, этап II) ---
|
|
962
1240
|
/**
|
|
963
1241
|
* ADR-052 (этап II): конфигурация исходящих webhooks.
|
|
@@ -1246,9 +1524,79 @@ export const securityTlsConfigSchema = z.object({
|
|
|
1246
1524
|
/** Проверять сертификат сервера (по умолчанию `true`). */
|
|
1247
1525
|
rejectUnauthorized: z.boolean().optional(),
|
|
1248
1526
|
});
|
|
1527
|
+
/**
|
|
1528
|
+
* PROP-136: append-only аудит исполнений `execute_shell`/`sandbox_exec`.
|
|
1529
|
+
*
|
|
1530
|
+
* `enabled` — мастер-выключатель: выключен — журнал не пишется и команда не
|
|
1531
|
+
* блокируется; включён — **сбой записи блокирует выполнение** (запись `started`
|
|
1532
|
+
* делается до запуска). Профильный дефолт: backend/managed — включён,
|
|
1533
|
+
* standalone — выключен. Env:
|
|
1534
|
+
* `SYNTH_COMMAND_AUDIT_ENABLED`, `SYNTH_COMMAND_AUDIT_RETENTION_DAYS`
|
|
1535
|
+
* (читаются `resolveCommandAuditConfig` в core — приоритет env > config).
|
|
1536
|
+
*
|
|
1537
|
+
* `path` — путь журнала; пусто → `{dataDir}/audit/commands.jsonl`.
|
|
1538
|
+
*/
|
|
1539
|
+
export const commandAuditConfigSchema = z.object({
|
|
1540
|
+
enabled: z.boolean().default(false),
|
|
1541
|
+
/** Срок хранения журнала, дней (`prune`); `<= 0` — без ограничения. */
|
|
1542
|
+
retentionDays: z.number().int().default(30),
|
|
1543
|
+
/** Путь журнала (пусто — `{dataDir}/audit/commands.jsonl`). */
|
|
1544
|
+
path: z.string().default(''),
|
|
1545
|
+
});
|
|
1546
|
+
/** PROP-136b: провайдер внешнего чекера команд (`off` — проверки нет). */
|
|
1547
|
+
export const COMMAND_POLICY_PROVIDERS = ['http', 'opa'];
|
|
1548
|
+
/** Поведение при недоступном чекере команд (PROP-136b). */
|
|
1549
|
+
export const COMMAND_POLICY_FAIL_MODES = ['closed', 'open'];
|
|
1550
|
+
/**
|
|
1551
|
+
* PROP-136b (слайс 136b-2a): **зеркальный** внешний чекер команд в control
|
|
1552
|
+
* plane (`security.commandPolicy`).
|
|
1553
|
+
*
|
|
1554
|
+
* Точка принуждения — исполнитель (`command-policy.ts` пакета executor:
|
|
1555
|
+
* проверка до `spawn`). Здесь — ранний отказ/UX и запись вердикта в аудит
|
|
1556
|
+
* исполнений: тот же чекер судит текст команды, но решение **не** является
|
|
1557
|
+
* границей безопасности (её нет у control plane — команда исполняется на
|
|
1558
|
+
* исполнителе). `enabled: false` (дефолт) — поведение прежнее, провайдер не
|
|
1559
|
+
* создаётся.
|
|
1560
|
+
*
|
|
1561
|
+
* `tokenSecret` — **путь** к файлу bearer-токена (инвариант 13), не значение;
|
|
1562
|
+
* читается `readExecutorToken` при первом обращении. `failMode` по умолчанию
|
|
1563
|
+
* `open` (standalone), backend/managed поднимает до `closed` профильным
|
|
1564
|
+
* дефолтом. `enabled: true` без `url` — ошибка старта (fail-closed).
|
|
1565
|
+
*
|
|
1566
|
+
* Env (по общему правилу ADR-023, читаются `applyObjectEnvOverrides`):
|
|
1567
|
+
* `SYNTH_COMMAND_POLICY_ENABLED`, `_PROVIDER`, `_URL`, `_TOKEN`, `_FAIL_MODE`,
|
|
1568
|
+
* `_TIMEOUT_MS`, `_OPA_PATH`.
|
|
1569
|
+
*/
|
|
1570
|
+
export const commandPolicyConfigSchema = z
|
|
1571
|
+
.object({
|
|
1572
|
+
enabled: z.boolean().default(false),
|
|
1573
|
+
provider: z.enum(COMMAND_POLICY_PROVIDERS).default('http'),
|
|
1574
|
+
/** Адрес чекера (обязателен при `enabled: true`). */
|
|
1575
|
+
url: z.string().default(''),
|
|
1576
|
+
/** Путь к файлу bearer-токена чекера (не значение). */
|
|
1577
|
+
tokenSecret: z.string().default(''),
|
|
1578
|
+
failMode: z.enum(COMMAND_POLICY_FAIL_MODES).default('open'),
|
|
1579
|
+
/** Таймаут запроса к чекеру, мс. */
|
|
1580
|
+
timeoutMs: z.number().int().min(1).default(2_000),
|
|
1581
|
+
/** Путь OPA-решения (`provider: opa`). */
|
|
1582
|
+
opaPath: z.string().default('/v1/data/synth/exec/decision'),
|
|
1583
|
+
})
|
|
1584
|
+
.superRefine((cfg, ctx) => {
|
|
1585
|
+
if (cfg.enabled && cfg.url.trim() === '') {
|
|
1586
|
+
ctx.addIssue({
|
|
1587
|
+
code: z.ZodIssueCode.custom,
|
|
1588
|
+
path: ['url'],
|
|
1589
|
+
message: 'security.commandPolicy.url обязателен при enabled: true (fail-closed)',
|
|
1590
|
+
});
|
|
1591
|
+
}
|
|
1592
|
+
});
|
|
1249
1593
|
export const securityConfigSchema = z.object({
|
|
1250
1594
|
promptInjection: promptInjectionConfigSchema.prefault({}),
|
|
1251
1595
|
protectedPaths: protectedPathsConfigSchema.prefault({}),
|
|
1596
|
+
/** PROP-136: журнал исполнений shell/песочных команд. */
|
|
1597
|
+
commandAudit: commandAuditConfigSchema.prefault({}),
|
|
1598
|
+
/** PROP-136b: зеркальный внешний чекер команд (опционален; выключен — прежнее поведение). */
|
|
1599
|
+
commandPolicy: commandPolicyConfigSchema.prefault({}),
|
|
1252
1600
|
/** ADR-099: единый механизм доверия TLS/CA для исходящих соединений. */
|
|
1253
1601
|
tls: securityTlsConfigSchema.optional(),
|
|
1254
1602
|
/**
|
|
@@ -1381,8 +1729,8 @@ export const llmGatewayAuditConfigSchema = z.object({
|
|
|
1381
1729
|
logPath: z.string().default(''), // по умолчанию {dataDir}/audit/llm-gateway.jsonl
|
|
1382
1730
|
});
|
|
1383
1731
|
export const llmGatewayConfigSchema = z.object({
|
|
1384
|
-
/** Глобальный выключатель LLM Gateway. */
|
|
1385
|
-
enabled: z.boolean().default(
|
|
1732
|
+
/** Глобальный выключатель LLM Gateway (ADR-147: единый дефолт — включён). */
|
|
1733
|
+
enabled: z.boolean().default(true),
|
|
1386
1734
|
/** Режим Input Guard: obfuscate (замена на плейсхолдер) | block (запрос блокируется). */
|
|
1387
1735
|
inputMode: z.enum(['obfuscate', 'block']).default('obfuscate'),
|
|
1388
1736
|
/** Полное логирование запросов и ответов LLM (после обфускации) в JSONL. */
|
|
@@ -1495,17 +1843,26 @@ export const synthConfigSchema = z.object({
|
|
|
1495
1843
|
tools: toolsConfigSchema.prefault({}),
|
|
1496
1844
|
skills: skillsConfigSchema.prefault({}),
|
|
1497
1845
|
commands: commandsConfigSchema.prefault({}),
|
|
1846
|
+
scripts: scriptsConfigSchema.prefault({}),
|
|
1498
1847
|
events: eventsConfigSchema.prefault({}),
|
|
1499
1848
|
scheduler: schedulerConfigSchema.prefault({}),
|
|
1500
1849
|
decision: decisionConfigSchema.prefault({}),
|
|
1501
1850
|
oauth: oauthConfigSchema.prefault({}),
|
|
1502
1851
|
analytics: analyticsConfigSchema.prefault({}),
|
|
1503
1852
|
git: gitConfigSchema.prefault({}),
|
|
1853
|
+
ssh: sshConfigSchema.prefault({}),
|
|
1504
1854
|
questions: questionsConfigSchema.prefault({}),
|
|
1505
1855
|
background: backgroundConfigSchema.prefault({}),
|
|
1856
|
+
recovery: recoveryConfigSchema.prefault({}),
|
|
1506
1857
|
agents: agentsConfigSchema.prefault({}),
|
|
1858
|
+
limits: limitsConfigSchema.prefault({}),
|
|
1507
1859
|
attachments: attachmentsConfigSchema.prefault({}),
|
|
1508
1860
|
metrics: metricsConfigSchema.prefault({}),
|
|
1861
|
+
// PROP-132: секция `terminal` — мастер-выключатель терминалов. Секция
|
|
1862
|
+
// необязательна: отсутствие = «не задано в config.yaml» (дефолт `enabled:
|
|
1863
|
+
// true` живёт в резолвере ядра).
|
|
1864
|
+
terminal: terminalConfigSchema.optional(),
|
|
1865
|
+
updates: updatesConfigSchema.prefault({}),
|
|
1509
1866
|
authority: authorityConfigSchema.prefault({}),
|
|
1510
1867
|
plugins: pluginsConfigSchema.prefault({}),
|
|
1511
1868
|
egress: egressConfigSchema.prefault({}),
|