@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/schemas/index.js
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import { MessageRole, GlobalRole, ProjectRole, StatusMessageType, PROJECT_ICON_KEYS, PROJECT_COLOR_KEYS, isKnownScope, isWebhookEventPattern, ANALYTICS_FAMILIES, ANALYTICS_DIMENSIONS, ANALYTICS_EXPORT_FORMATS, STEER_MODES, DEFAULT_STEER_MODE, EFFORT_LEVELS, } from '../types/index.js';
|
|
2
|
+
import { MessageRole, GlobalRole, ProjectRole, StatusMessageType, PROJECT_ICON_KEYS, PROJECT_COLOR_KEYS, isKnownScope, isWebhookEventPattern, ANALYTICS_FAMILIES, ANALYTICS_DIMENSIONS, ANALYTICS_EXPORT_FORMATS, STEER_MODES, DEFAULT_STEER_MODE, EFFORT_LEVELS, SSH_KEY_USAGES, MAX_SSH_ALLOW_HOSTS, MAX_SSH_ALLOW_PORTS, isValidHostRule, HOST_RULE_FORMAT_HINT, MARKDOWN_LIMITS, TODO_STATUSES, TODO_PRIORITIES, } from '../types/index.js';
|
|
3
|
+
import { normalizeProjectAccessRole } from '../types/project-access.js';
|
|
3
4
|
import { ToolCapability } from '../types/tools.js';
|
|
4
5
|
/**
|
|
5
6
|
* Экземпляр zod, которым построены **все** схемы этого пакета.
|
|
@@ -17,6 +18,26 @@ export const statusMessageTypeSchema = z.nativeEnum(StatusMessageType);
|
|
|
17
18
|
/** Zod-схемы канонических ключей иконок/цветов (единые для project и session). */
|
|
18
19
|
export const projectIconKeySchema = z.enum(PROJECT_ICON_KEYS);
|
|
19
20
|
export const projectColorKeySchema = z.enum(PROJECT_COLOR_KEYS);
|
|
21
|
+
/**
|
|
22
|
+
* PROP-133: роль доступа к проекту (входной контракт записи состояния
|
|
23
|
+
* доступа). Неизвестная роль → `400 VALIDATION_ERROR` (fail-closed).
|
|
24
|
+
*/
|
|
25
|
+
export const projectAccessRoleSchema = z.enum(['owner', 'editor', 'viewer']);
|
|
26
|
+
/**
|
|
27
|
+
* PROP-133 §3.1: роль режима «всем пользователям» (`everyone_role`).
|
|
28
|
+
*
|
|
29
|
+
* Только `viewer`/`editor`: роль `owner` всем пользователям не выдаётся
|
|
30
|
+
* (эскалация прав) — роут режет такое значение `400 VALIDATION_ERROR`,
|
|
31
|
+
* значит и схема его не принимает (контракт схемы и роута совпадает).
|
|
32
|
+
*/
|
|
33
|
+
export const projectEveryoneRoleSchema = z.enum(['viewer', 'editor']);
|
|
34
|
+
/**
|
|
35
|
+
* PROP-133: производное состояние видимости проекта — **только чтение/DTO**
|
|
36
|
+
* (во входные схемы не входит: значение выводится из состояния списка доступа).
|
|
37
|
+
*/
|
|
38
|
+
export const projectVisibilitySchema = z.enum(['author', 'selected', 'all']);
|
|
39
|
+
/** PROP-133: карта грантов (субъект → роль). */
|
|
40
|
+
export const projectMembersSchema = z.record(z.string().min(1), projectAccessRoleSchema);
|
|
20
41
|
/** true, если значение — канонический ключ иконки (для записи и чтения). */
|
|
21
42
|
export function isProjectIconKey(value) {
|
|
22
43
|
return typeof value === 'string' && PROJECT_ICON_KEYS.includes(value);
|
|
@@ -42,11 +63,12 @@ export function normalizeColorKey(value) {
|
|
|
42
63
|
/**
|
|
43
64
|
* ADR-106 Ф4: нормализация роли участника сессии. Каноническая роль → как
|
|
44
65
|
* есть; всё прочее — **fail-closed** (`viewer`, только чтение).
|
|
66
|
+
*
|
|
67
|
+
* Канонический нормализатор — `normalizeProjectAccessRole` (PROP-133 §1): один
|
|
68
|
+
* источник истины для ролей проекта и участников сессии.
|
|
45
69
|
*/
|
|
46
70
|
export function normalizeSessionParticipantRole(value) {
|
|
47
|
-
|
|
48
|
-
return value;
|
|
49
|
-
return 'viewer';
|
|
71
|
+
return normalizeProjectAccessRole(value);
|
|
50
72
|
}
|
|
51
73
|
export const tokenUsageSchema = z.object({
|
|
52
74
|
inputTokens: z.number().int().min(0),
|
|
@@ -142,6 +164,17 @@ export const sessionSettingsSchema = z.object({
|
|
|
142
164
|
debugEnabled: z.boolean().default(true),
|
|
143
165
|
streamEnabled: z.boolean().default(true),
|
|
144
166
|
agentRole: z.string().optional(),
|
|
167
|
+
/**
|
|
168
|
+
* PROP-135 Ф4a: имя профиля исполнения сессии (`execution.remote.profiles`).
|
|
169
|
+
* Порт тулов сессии выбирает роутер по этому имени; не задан — профиль по
|
|
170
|
+
* умолчанию (`execution.remote.defaultProfile`).
|
|
171
|
+
*/
|
|
172
|
+
executorProfile: z.string().optional(),
|
|
173
|
+
/**
|
|
174
|
+
* PROP-135 (браузерный контур): профиль браузерного пула сессии. Пустая
|
|
175
|
+
* строка — явный сброс (наследование агент→проект→инстанс).
|
|
176
|
+
*/
|
|
177
|
+
browserProfile: z.string().optional(),
|
|
145
178
|
// ADR-071 §2.4: сессионный скоуп MCP (явно включённые / opt-out).
|
|
146
179
|
mcpServers: z.array(z.string()).optional(),
|
|
147
180
|
mcpDisabledServers: z.array(z.string()).optional(),
|
|
@@ -165,7 +198,7 @@ export const sessionSettingsSchema = z.object({
|
|
|
165
198
|
language: z.string().optional(),
|
|
166
199
|
// === Plan/Act (ADR-025) ===
|
|
167
200
|
planMode: z.enum(['auto', 'strict', 'off']).optional(),
|
|
168
|
-
// === Скиллы (ADR-
|
|
201
|
+
// === Скиллы (ADR-126 §11) ===
|
|
169
202
|
skills: z.array(z.string()).optional(),
|
|
170
203
|
skillsDisabled: z.array(z.string()).optional(),
|
|
171
204
|
// === Микро-слой (ADR-035/ADR-084) ===
|
|
@@ -229,9 +262,30 @@ export const projectCreateSchema = z.object({
|
|
|
229
262
|
color: projectColorKeySchema.optional().nullable(),
|
|
230
263
|
workspace: z.string().optional(),
|
|
231
264
|
repos: z.array(z.union([z.string(), gitRepoConfigSchema])).optional(),
|
|
265
|
+
// PROP-133 §3.1: состояние списка доступа. `everyone_role: null` — проект
|
|
266
|
+
// не опубликован; `visibility` во вход не принимается (производная величина).
|
|
267
|
+
members: projectMembersSchema.optional(),
|
|
268
|
+
group_members: projectMembersSchema.optional(),
|
|
269
|
+
everyone_role: z.union([projectEveryoneRoleSchema, z.null()]).optional(),
|
|
232
270
|
});
|
|
233
271
|
/** ADR-107: проектная политика памяти (undefined — не менять). */
|
|
234
272
|
export const projectMemoryUpdateSchema = z.object({ enabled: z.boolean().optional() });
|
|
273
|
+
/**
|
|
274
|
+
* PROP-135 Ф6a: профиль исполнения проекта (`PUT /api/v2/projects/:id`).
|
|
275
|
+
*
|
|
276
|
+
* `profile`/`allowedProfiles` — `null`/`''` сбрасывают значение (потолок не
|
|
277
|
+
* задан), `[]` — «профилей нет» (ADR-135, аддендум: пустой список = ничего не
|
|
278
|
+
* разрешено). Существование профиля в `execution.remote.profiles` и его
|
|
279
|
+
* вхождение в список разрешённых проверяет роут (если каталог ему доступен).
|
|
280
|
+
*/
|
|
281
|
+
export const projectExecutorUpdateSchema = z.object({
|
|
282
|
+
profile: z.string().nullable().optional(),
|
|
283
|
+
allowedProfiles: z.array(z.string()).nullable().optional(),
|
|
284
|
+
/** PROP-135 (браузерный контур): профиль браузерного пула проекта. */
|
|
285
|
+
browserProfile: z.string().nullable().optional(),
|
|
286
|
+
/** PROP-135 (браузерный контур): потолок браузерных профилей проекта. */
|
|
287
|
+
allowedBrowserProfiles: z.array(z.string()).nullable().optional(),
|
|
288
|
+
});
|
|
235
289
|
export const projectUpdateSchema = z.object({
|
|
236
290
|
name: z.string().min(1).max(200).optional(),
|
|
237
291
|
description: z.string().optional(),
|
|
@@ -242,14 +296,65 @@ export const projectUpdateSchema = z.object({
|
|
|
242
296
|
workspace: z.string().optional(),
|
|
243
297
|
repos: z.array(z.union([z.string(), gitRepoConfigSchema])).optional(),
|
|
244
298
|
memory: projectMemoryUpdateSchema.optional(),
|
|
299
|
+
executor: projectExecutorUpdateSchema.optional(),
|
|
300
|
+
// PROP-133 §3.1: состояние списка доступа (см. `projectCreateSchema`).
|
|
301
|
+
members: projectMembersSchema.optional(),
|
|
302
|
+
group_members: projectMembersSchema.optional(),
|
|
303
|
+
everyone_role: z.union([projectEveryoneRoleSchema, z.null()]).optional(),
|
|
304
|
+
});
|
|
305
|
+
/**
|
|
306
|
+
* ADR-140 Ф3: тело передачи владения проектом
|
|
307
|
+
* (`POST /api/v2/projects/:id/transfer`).
|
|
308
|
+
*
|
|
309
|
+
* `user_id` — id нового владельца (обязателен, непустая строка). Тело
|
|
310
|
+
* **strict**: лишнее поле — ошибка валидации, а не молчаливое игнорирование
|
|
311
|
+
* (опечатка в теле иначе «передала бы владение не туда»).
|
|
312
|
+
*/
|
|
313
|
+
export const projectTransferSchema = z.object({ user_id: z.string().min(1) }).strict();
|
|
314
|
+
/**
|
|
315
|
+
* PROP-124: правило хоста в политике SSH-ключа.
|
|
316
|
+
*
|
|
317
|
+
* Семантика — общая с ADR-099 (`matchTlsHostPattern`/`isValidHostRule`):
|
|
318
|
+
* точный hostname, `*.suffix` (только поддомены), IP-литерал или CIDR.
|
|
319
|
+
* Одиночный `*` («любой хост») недопустим — fail-closed.
|
|
320
|
+
*/
|
|
321
|
+
const sshHostRuleSchema = z
|
|
322
|
+
.string()
|
|
323
|
+
.max(253)
|
|
324
|
+
.refine((value) => isValidHostRule(value), {
|
|
325
|
+
message: `невалидный шаблон хоста: ${HOST_RULE_FORMAT_HINT}`,
|
|
245
326
|
});
|
|
246
|
-
/**
|
|
327
|
+
/**
|
|
328
|
+
* ADR-076: тело создания SSH-ключа (`POST /api/v2/ssh-keys`).
|
|
329
|
+
*
|
|
330
|
+
* PROP-124: дополнительно принимает `usages` (`git`/`ssh`), `allowHosts`
|
|
331
|
+
* (правила хостов) и `allowPorts` (порты 1..65535) — политику ключа для
|
|
332
|
+
* режима инстанса `tools`.
|
|
333
|
+
*/
|
|
247
334
|
export const sshKeyCreateSchema = z.object({
|
|
248
335
|
name: z.string().min(1).max(200),
|
|
249
336
|
type: z.string().optional(),
|
|
250
337
|
privateKey: z.string().min(1),
|
|
251
338
|
passphrase: z.string().optional(),
|
|
252
339
|
agentIds: z.array(z.string()).optional(),
|
|
340
|
+
/**
|
|
341
|
+
* PROP-124: способы использования ключа (`git`/`ssh`).
|
|
342
|
+
*
|
|
343
|
+
* Пустой список **недопустим**: ключ без назначения бесполезен (не годится
|
|
344
|
+
* ни для git, ни для ssh) — это тихая ловушка, в которой можно застрять,
|
|
345
|
+
* сняв оба флажка. Если поле передано — в нём должно быть хотя бы одно
|
|
346
|
+
* значение (`400 VALIDATION_ERROR`).
|
|
347
|
+
*/
|
|
348
|
+
usages: z
|
|
349
|
+
.array(z.enum(SSH_KEY_USAGES))
|
|
350
|
+
.min(1, {
|
|
351
|
+
message: `usages: нужен хотя бы один способ использования (${SSH_KEY_USAGES.join('|')})`,
|
|
352
|
+
})
|
|
353
|
+
.optional(),
|
|
354
|
+
/** PROP-124: правила хостов (режим `tools`); лимит — `MAX_SSH_ALLOW_HOSTS`. */
|
|
355
|
+
allowHosts: z.array(sshHostRuleSchema).max(MAX_SSH_ALLOW_HOSTS).optional(),
|
|
356
|
+
/** PROP-124: порты (режим `tools`); лимит — `MAX_SSH_ALLOW_PORTS`. */
|
|
357
|
+
allowPorts: z.array(z.number().int().min(1).max(65535)).max(MAX_SSH_ALLOW_PORTS).optional(),
|
|
253
358
|
});
|
|
254
359
|
/** ADR-076: тело обновления SSH-ключа (без id/createdAt). */
|
|
255
360
|
export const sshKeyUpdateSchema = sshKeyCreateSchema.partial();
|
|
@@ -402,6 +507,27 @@ export const gitCommitQuerySchema = z.object({
|
|
|
402
507
|
repo_path: z.string().default(''),
|
|
403
508
|
hash: z.string().min(1),
|
|
404
509
|
});
|
|
510
|
+
/** ADR-076 (этап 1): `GET /git/status` — состояние рабочего дерева репозитория(ев). */
|
|
511
|
+
export const gitStatusQuerySchema = z.object({
|
|
512
|
+
project_id: z.string().min(1),
|
|
513
|
+
repo_path: z.string().default(''),
|
|
514
|
+
});
|
|
515
|
+
/**
|
|
516
|
+
* ADR-076 (этап 1): `GET /git/diff` — diff рабочего дерева.
|
|
517
|
+
*
|
|
518
|
+
* `staged` принимает строковые `true`/`false` (query-параметры): `z.coerce.boolean()`
|
|
519
|
+
* не подходит — `'false'` превратился бы в `true` (та же ловушка, что у
|
|
520
|
+
* `fsWorkspaceBrowseQuerySchema`).
|
|
521
|
+
*/
|
|
522
|
+
export const gitDiffQuerySchema = z.object({
|
|
523
|
+
project_id: z.string().min(1),
|
|
524
|
+
repo_path: z.string().default(''),
|
|
525
|
+
path: z.string().min(1).optional(),
|
|
526
|
+
staged: z
|
|
527
|
+
.preprocess((v) => (v === 'true' ? true : v === 'false' ? false : v), z.boolean())
|
|
528
|
+
.default(false),
|
|
529
|
+
context: z.coerce.number().int().min(0).max(10).default(3),
|
|
530
|
+
});
|
|
405
531
|
const toolCapabilityValues = Object.values(ToolCapability);
|
|
406
532
|
/**
|
|
407
533
|
* ADR-071 §2.6: фабрика схемы `tools.disabled` (единый источник значений
|
|
@@ -454,12 +580,12 @@ export const sessionMcpUpdateSchema = z
|
|
|
454
580
|
.refine((v) => v.name !== undefined
|
|
455
581
|
|| v.mcpServers !== undefined
|
|
456
582
|
|| v.mcpDisabledServers !== undefined, { message: 'Требуется name, mcpServers или mcpDisabledServers' });
|
|
457
|
-
// --- Скиллы (ADR-
|
|
458
|
-
/** ADR-
|
|
583
|
+
// --- Скиллы (ADR-126) ---
|
|
584
|
+
/** ADR-126 §13: имя скилла — 1–64, `^[a-z0-9]+(-[a-z0-9]+)*$`. */
|
|
459
585
|
export const SKILL_NAME_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
|
|
460
586
|
export const SKILL_NAME_MIN = 1;
|
|
461
587
|
export const SKILL_NAME_MAX = 64;
|
|
462
|
-
/** ADR-
|
|
588
|
+
/** ADR-126 §13: длина `description`. */
|
|
463
589
|
export const SKILL_DESCRIPTION_MIN = 1;
|
|
464
590
|
export const SKILL_DESCRIPTION_MAX = 1024;
|
|
465
591
|
export const skillNameSchema = z
|
|
@@ -487,29 +613,29 @@ export const skillFileWriteSchema = z.object({
|
|
|
487
613
|
content: z.string(),
|
|
488
614
|
});
|
|
489
615
|
/**
|
|
490
|
-
* ADR-
|
|
616
|
+
* ADR-126 §11: per-session enable/disable скиллов (по образцу MCP-скоупа).
|
|
491
617
|
* `undefined` ≠ `[]`: отсутствующее поле сохраняет текущее значение.
|
|
492
618
|
*/
|
|
493
619
|
export const skillSessionOverrideSchema = z.object({
|
|
494
620
|
skills: z.array(z.string()).optional(),
|
|
495
621
|
skillsDisabled: z.array(z.string()).optional(),
|
|
496
622
|
});
|
|
497
|
-
// --- Slash-команды и bundles (ADR-
|
|
498
|
-
/** ADR-
|
|
623
|
+
// --- Slash-команды и bundles (ADR-126 §1) ---
|
|
624
|
+
/** ADR-126 §14: тело `POST/PATCH /api/v2/skill-bundles` (YAML-группа скиллов). */
|
|
499
625
|
export const skillBundleSchema = z.object({
|
|
500
626
|
name: skillNameSchema,
|
|
501
627
|
description: z.string().min(SKILL_DESCRIPTION_MIN).max(SKILL_DESCRIPTION_MAX),
|
|
502
628
|
skills: z.array(skillNameSchema).min(1),
|
|
503
629
|
instruction: z.string().optional(),
|
|
504
630
|
});
|
|
505
|
-
/** ADR-
|
|
631
|
+
/** ADR-126 §15: тело `PUT /api/v2/settings/skills-disabled` (группы/имена). */
|
|
506
632
|
export const skillsDisabledSchema = z.object({
|
|
507
633
|
categories: z.array(z.string()).default([]),
|
|
508
634
|
groups: z.array(z.string()).default([]),
|
|
509
635
|
skills: z.array(z.string()).default([]),
|
|
510
636
|
});
|
|
511
637
|
/**
|
|
512
|
-
* ADR-
|
|
638
|
+
* ADR-126 §11: тело `PUT /api/v2/settings/skills` — системные настройки:
|
|
513
639
|
* - `disabled` — hard-gate: скиллы, недоступные НИГДЕ;
|
|
514
640
|
* - `disabledForNewProjects` — сид для НОВЫХ проектов (снимок при создании);
|
|
515
641
|
* - `policy` — политика доступности (строкой, валидируется роутом).
|
|
@@ -520,7 +646,7 @@ export const skillsSystemSettingsSchema = z.object({
|
|
|
520
646
|
policy: z.string().optional(),
|
|
521
647
|
});
|
|
522
648
|
/**
|
|
523
|
-
* ADR-
|
|
649
|
+
* ADR-126 §11: тело `PUT /api/v2/sessions/:id/skills`: точечный toggle
|
|
524
650
|
* (`{ name, enabled }`) или полная/частичная замена (`{ skills?, skillsDisabled? }`).
|
|
525
651
|
*/
|
|
526
652
|
export const sessionSkillUpdateSchema = z
|
|
@@ -533,7 +659,7 @@ export const sessionSkillUpdateSchema = z
|
|
|
533
659
|
.refine((v) => v.name !== undefined
|
|
534
660
|
|| v.skills !== undefined
|
|
535
661
|
|| v.skillsDisabled !== undefined, { message: 'Требуется name, skills или skillsDisabled' });
|
|
536
|
-
/** ADR-
|
|
662
|
+
/** ADR-126 §11: тело `PUT /api/v2/projects/:id/skills`. */
|
|
537
663
|
export const projectSkillUpdateSchema = z.object({
|
|
538
664
|
enabled: z.array(z.string()).optional(),
|
|
539
665
|
defaultOn: z.array(z.string()).optional(),
|
|
@@ -826,7 +952,9 @@ export const scheduleTargetSchema = z.discriminatedUnion('mode', [
|
|
|
826
952
|
z.object({
|
|
827
953
|
mode: z.literal('ephemeral'),
|
|
828
954
|
agentTemplate: z.string().optional(),
|
|
829
|
-
|
|
955
|
+
// PROP-141: проект у ephemeral-цели обязателен — инстансных
|
|
956
|
+
// автоматизаций нет (каждая автоматизация принадлежит проекту).
|
|
957
|
+
project: z.string().min(1),
|
|
830
958
|
ttl: z.string().optional(),
|
|
831
959
|
}),
|
|
832
960
|
z.object({ mode: z.literal('queue'), sessionId: z.string().min(1) }),
|
|
@@ -929,6 +1057,10 @@ export const scheduleInputSchema = z
|
|
|
929
1057
|
.object({
|
|
930
1058
|
name: z.string().min(1),
|
|
931
1059
|
enabled: z.boolean().default(true),
|
|
1060
|
+
// PROP-141: проект расписания. В теле необязателен — сервер выводит его
|
|
1061
|
+
// из цели расписания (и сверяет с переданным); в самой записи
|
|
1062
|
+
// (`scheduleSchema`) поле обязательно.
|
|
1063
|
+
projectId: z.string().min(1).optional(),
|
|
932
1064
|
cron: z.string().optional(),
|
|
933
1065
|
every: z.string().optional(),
|
|
934
1066
|
target: scheduleTargetSchema,
|
|
@@ -944,6 +1076,9 @@ export const scheduleSchema = z
|
|
|
944
1076
|
id: z.string().min(1),
|
|
945
1077
|
name: z.string().min(1),
|
|
946
1078
|
enabled: z.boolean(),
|
|
1079
|
+
// PROP-141: проект расписания обязателен (пустая строка — «проект не
|
|
1080
|
+
// определён», легаси-запись без проекта: отключена, `project_required`).
|
|
1081
|
+
projectId: z.string(),
|
|
947
1082
|
cron: z.string().optional(),
|
|
948
1083
|
every: z.string().optional(),
|
|
949
1084
|
target: scheduleTargetSchema,
|
|
@@ -1051,3 +1186,205 @@ export const mediaPartSchema = z.object({
|
|
|
1051
1186
|
durationMs: z.number().int().min(0).optional(),
|
|
1052
1187
|
transcript: z.string().optional(),
|
|
1053
1188
|
});
|
|
1189
|
+
// --- PROP-054: план (ADR-039), ToDo (ADR-039), журнал и инварианты проекта ---
|
|
1190
|
+
//
|
|
1191
|
+
// Контракт «план/ToDo/журнал» (PROP-054, дополнение 2026-11-07): у сущностей
|
|
1192
|
+
// есть Zod-схемы (в shared), а тела мутаций — **strict** (лишнее поле — ошибка
|
|
1193
|
+
// валидации, а не молчаливое игнорирование). При **чтении** (импорт/перенос
|
|
1194
|
+
// между мирами) допустим `passthrough` — старые записи могли нести поля,
|
|
1195
|
+
// которых больше нет в модели.
|
|
1196
|
+
/** Приоритет пункта плана (ADR-039). */
|
|
1197
|
+
export const PLAN_PRIORITIES = ['high', 'medium', 'low'];
|
|
1198
|
+
/** Отношение зависимости пункта плана (ADR-039). */
|
|
1199
|
+
export const PLAN_DEPENDENCY_RELATIONS = ['blocked_by', 'blocks', 'relates_to'];
|
|
1200
|
+
/** Зависимость пункта плана (ADR-039): `projectId` пуст = тот же проект. */
|
|
1201
|
+
export const planDependencySchema = z
|
|
1202
|
+
.object({
|
|
1203
|
+
projectId: z.string().optional(),
|
|
1204
|
+
itemId: z.string().min(1),
|
|
1205
|
+
relation: z.enum(PLAN_DEPENDENCY_RELATIONS),
|
|
1206
|
+
})
|
|
1207
|
+
.passthrough();
|
|
1208
|
+
/** Колонка плана (ADR-039) — статус пункта. */
|
|
1209
|
+
export const planColumnSchema = z
|
|
1210
|
+
.object({
|
|
1211
|
+
id: z.string().min(1),
|
|
1212
|
+
name: z.string().min(1).max(100),
|
|
1213
|
+
order: z.number().int(),
|
|
1214
|
+
wipLimit: z.number().int().min(0).optional(),
|
|
1215
|
+
})
|
|
1216
|
+
.passthrough();
|
|
1217
|
+
/** Пункт плана (ADR-039). `description` — Markdown (лимит `MARKDOWN_LIMITS`). */
|
|
1218
|
+
export const planItemSchema = z
|
|
1219
|
+
.object({
|
|
1220
|
+
id: z.string().min(1),
|
|
1221
|
+
title: z.string().min(1).max(500),
|
|
1222
|
+
description: z.string().max(MARKDOWN_LIMITS.planDescription).optional(),
|
|
1223
|
+
columnId: z.string().min(1),
|
|
1224
|
+
priority: z.enum(PLAN_PRIORITIES),
|
|
1225
|
+
order: z.number().int(),
|
|
1226
|
+
dependsOn: z.array(planDependencySchema).default([]),
|
|
1227
|
+
tags: z.array(z.string()).optional(),
|
|
1228
|
+
createdAt: z.string(),
|
|
1229
|
+
updatedAt: z.string(),
|
|
1230
|
+
})
|
|
1231
|
+
.passthrough();
|
|
1232
|
+
/** План проекта целиком (ADR-039). */
|
|
1233
|
+
export const projectPlanSchema = z
|
|
1234
|
+
.object({
|
|
1235
|
+
version: z.number().int(),
|
|
1236
|
+
updatedAt: z.string(),
|
|
1237
|
+
columns: z.array(planColumnSchema),
|
|
1238
|
+
items: z.array(planItemSchema),
|
|
1239
|
+
})
|
|
1240
|
+
.passthrough();
|
|
1241
|
+
/** Пункт ToDo сессии (ADR-039). `content` — Markdown (лимит `MARKDOWN_LIMITS`). */
|
|
1242
|
+
export const todoItemSchema = z
|
|
1243
|
+
.object({
|
|
1244
|
+
id: z.string().min(1),
|
|
1245
|
+
content: z.string().min(1).max(MARKDOWN_LIMITS.todoContent),
|
|
1246
|
+
status: z.enum(TODO_STATUSES),
|
|
1247
|
+
priority: z.enum(TODO_PRIORITIES),
|
|
1248
|
+
planItemId: z.string().optional(),
|
|
1249
|
+
})
|
|
1250
|
+
.passthrough();
|
|
1251
|
+
/** Запись журнала проекта (PROP-054): `updatedAt`/`updatedBy` — аддитивные. */
|
|
1252
|
+
export const projectLogEntrySchema = z
|
|
1253
|
+
.object({
|
|
1254
|
+
id: z.string().min(1),
|
|
1255
|
+
text: z.string().min(1).max(MARKDOWN_LIMITS.journalEntry),
|
|
1256
|
+
createdAt: z.string(),
|
|
1257
|
+
sessionId: z.string().optional(),
|
|
1258
|
+
author: z.string().optional(),
|
|
1259
|
+
updatedAt: z.string().optional(),
|
|
1260
|
+
updatedBy: z.string().optional(),
|
|
1261
|
+
})
|
|
1262
|
+
.passthrough();
|
|
1263
|
+
// --- Тела HTTP-мутаций плана (PROP-054) — strict ---
|
|
1264
|
+
/** Создание пункта плана. */
|
|
1265
|
+
export const planItemCreateSchema = z
|
|
1266
|
+
.object({
|
|
1267
|
+
title: z.string().min(1).max(500),
|
|
1268
|
+
description: z.string().max(MARKDOWN_LIMITS.planDescription).optional(),
|
|
1269
|
+
columnId: z.string().min(1).optional(),
|
|
1270
|
+
priority: z.enum(PLAN_PRIORITIES).optional(),
|
|
1271
|
+
dependsOn: z.array(planDependencySchema).optional(),
|
|
1272
|
+
tags: z.array(z.string()).optional(),
|
|
1273
|
+
})
|
|
1274
|
+
.strict();
|
|
1275
|
+
/** Точечная правка полей пункта плана (версия не требуется). */
|
|
1276
|
+
export const planItemUpdateSchema = z
|
|
1277
|
+
.object({
|
|
1278
|
+
title: z.string().min(1).max(500).optional(),
|
|
1279
|
+
description: z.string().max(MARKDOWN_LIMITS.planDescription).optional(),
|
|
1280
|
+
priority: z.enum(PLAN_PRIORITIES).optional(),
|
|
1281
|
+
tags: z.array(z.string()).optional(),
|
|
1282
|
+
dependsOn: z.array(planDependencySchema).optional(),
|
|
1283
|
+
})
|
|
1284
|
+
.strict();
|
|
1285
|
+
/**
|
|
1286
|
+
* Перемещение пункта плана: `beforeItemId`/`afterItemId` — соседи-ориентиры
|
|
1287
|
+
* (упорядочивание без ручного `order`); `version` — оптимистичная блокировка.
|
|
1288
|
+
*/
|
|
1289
|
+
export const planItemMoveSchema = z
|
|
1290
|
+
.object({
|
|
1291
|
+
columnId: z.string().min(1),
|
|
1292
|
+
beforeItemId: z.string().min(1).optional(),
|
|
1293
|
+
afterItemId: z.string().min(1).optional(),
|
|
1294
|
+
version: z.number().int().optional(),
|
|
1295
|
+
})
|
|
1296
|
+
.strict();
|
|
1297
|
+
/** Создание колонки плана. */
|
|
1298
|
+
export const planColumnCreateSchema = z
|
|
1299
|
+
.object({
|
|
1300
|
+
name: z.string().min(1).max(100),
|
|
1301
|
+
wipLimit: z.number().int().min(0).optional(),
|
|
1302
|
+
})
|
|
1303
|
+
.strict();
|
|
1304
|
+
/** Правка колонки плана (имя/WIP-лимит). */
|
|
1305
|
+
export const planColumnUpdateSchema = z
|
|
1306
|
+
.object({
|
|
1307
|
+
name: z.string().min(1).max(100).optional(),
|
|
1308
|
+
wipLimit: z.number().int().min(0).optional(),
|
|
1309
|
+
})
|
|
1310
|
+
.strict();
|
|
1311
|
+
/**
|
|
1312
|
+
* Удаление колонки: `moveItemsTo` — куда переносятся её пункты (`null` —
|
|
1313
|
+
* удалить вместе с колонкой); `version` — оптимистичная блокировка.
|
|
1314
|
+
*/
|
|
1315
|
+
export const planColumnDeleteSchema = z
|
|
1316
|
+
.object({
|
|
1317
|
+
moveItemsTo: z.string().min(1).nullable(),
|
|
1318
|
+
version: z.number().int(),
|
|
1319
|
+
})
|
|
1320
|
+
.strict();
|
|
1321
|
+
/** Порядок колонок плана (полный список id) + версия. */
|
|
1322
|
+
export const planColumnsOrderSchema = z
|
|
1323
|
+
.object({
|
|
1324
|
+
order: z.array(z.string().min(1)),
|
|
1325
|
+
version: z.number().int(),
|
|
1326
|
+
})
|
|
1327
|
+
.strict();
|
|
1328
|
+
// --- Тела HTTP-мутаций ToDo (PROP-054) — strict ---
|
|
1329
|
+
/** Создание пункта ToDo. */
|
|
1330
|
+
export const todoCreateSchema = z
|
|
1331
|
+
.object({
|
|
1332
|
+
content: z.string().min(1).max(MARKDOWN_LIMITS.todoContent),
|
|
1333
|
+
status: z.enum(TODO_STATUSES).optional(),
|
|
1334
|
+
priority: z.enum(TODO_PRIORITIES).optional(),
|
|
1335
|
+
planItemId: z.string().min(1).optional(),
|
|
1336
|
+
})
|
|
1337
|
+
.strict();
|
|
1338
|
+
/** Точечная правка пункта ToDo (`planItemId: null` — отвязать от пункта плана). */
|
|
1339
|
+
export const todoUpdateSchema = z
|
|
1340
|
+
.object({
|
|
1341
|
+
content: z.string().min(1).max(MARKDOWN_LIMITS.todoContent).optional(),
|
|
1342
|
+
status: z.enum(TODO_STATUSES).optional(),
|
|
1343
|
+
priority: z.enum(TODO_PRIORITIES).optional(),
|
|
1344
|
+
planItemId: z.string().min(1).nullable().optional(),
|
|
1345
|
+
})
|
|
1346
|
+
.strict();
|
|
1347
|
+
/** Новый порядок пунктов ToDo (только существующие id; новые — в конец). */
|
|
1348
|
+
export const todoOrderSchema = z
|
|
1349
|
+
.object({
|
|
1350
|
+
ids: z.array(z.string().min(1)),
|
|
1351
|
+
})
|
|
1352
|
+
.strict();
|
|
1353
|
+
/** Очистка пунктов ToDo по статусам (по умолчанию — `completed` + `cancelled`). */
|
|
1354
|
+
export const todoClearSchema = z
|
|
1355
|
+
.object({
|
|
1356
|
+
statuses: z.array(z.enum(TODO_STATUSES)).optional(),
|
|
1357
|
+
})
|
|
1358
|
+
.strict();
|
|
1359
|
+
// --- Тело запуска скрипта проекта (ADR-126 §5) — strict ---
|
|
1360
|
+
/**
|
|
1361
|
+
* Тело `POST /sessions/:id/scripts/:name/run`: только аргументы скрипта.
|
|
1362
|
+
*
|
|
1363
|
+
* Аргументы приходят **строкой** — их разбирает лексер скриптов
|
|
1364
|
+
* (`engine/scripts/args.ts`), без shell. Строгая схема: неизвестные поля →
|
|
1365
|
+
* 400 `VALIDATION_ERROR`.
|
|
1366
|
+
*/
|
|
1367
|
+
export const scriptRunRequestSchema = z
|
|
1368
|
+
.object({
|
|
1369
|
+
arguments: z.string().max(10_000).optional(),
|
|
1370
|
+
})
|
|
1371
|
+
.strict();
|
|
1372
|
+
// --- Тела HTTP-мутаций журнала и инвариантов (PROP-054) — strict ---
|
|
1373
|
+
/** Новая запись журнала проекта (Markdown, лимит `MARKDOWN_LIMITS.journalEntry`). */
|
|
1374
|
+
export const projectLogCreateSchema = z
|
|
1375
|
+
.object({
|
|
1376
|
+
text: z.string().min(1).max(MARKDOWN_LIMITS.journalEntry),
|
|
1377
|
+
})
|
|
1378
|
+
.strict();
|
|
1379
|
+
/** Правка текста записи журнала. */
|
|
1380
|
+
export const projectLogUpdateSchema = z
|
|
1381
|
+
.object({
|
|
1382
|
+
text: z.string().min(1).max(MARKDOWN_LIMITS.journalEntry),
|
|
1383
|
+
})
|
|
1384
|
+
.strict();
|
|
1385
|
+
/** Замена текста инвариантов проекта (Markdown, лимит `MARKDOWN_LIMITS.invariants`). */
|
|
1386
|
+
export const projectInvariantsUpdateSchema = z
|
|
1387
|
+
.object({
|
|
1388
|
+
invariants: z.string().max(MARKDOWN_LIMITS.invariants),
|
|
1389
|
+
})
|
|
1390
|
+
.strict();
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { load as parseYaml, dump as dumpYaml } from 'js-yaml';
|
|
2
2
|
/**
|
|
3
|
-
* ADR-
|
|
3
|
+
* ADR-126 §3: толерантный парсер YAML-frontmatter `SKILL.md`.
|
|
4
4
|
*
|
|
5
5
|
* - Неизвестные ключи — не ошибка (совместимость Anthropic/opencode/Claude Code).
|
|
6
6
|
* - Невалидный YAML — фиксируется issue, но не бросает исключение.
|
package/dist/types/agent.d.ts
CHANGED
|
@@ -24,12 +24,40 @@ export interface AgentDefinition {
|
|
|
24
24
|
effort?: EffortLevel;
|
|
25
25
|
agentMode?: AgentMode | AgentMode[];
|
|
26
26
|
maxSteps?: number;
|
|
27
|
+
/**
|
|
28
|
+
* PROP-135 Ф6a: профиль исполнения агента (`execution.remote.profiles`).
|
|
29
|
+
* Приоритет выбора профиля: сессия → агент → проект → `defaultProfile`.
|
|
30
|
+
* Не задан — профиль берётся у проекта/инстанса.
|
|
31
|
+
*/
|
|
32
|
+
executorProfile?: string;
|
|
33
|
+
/**
|
|
34
|
+
* PROP-135 Ф6a: **потолок** профилей исполнения агента: если массив задан,
|
|
35
|
+
* агент не может исполняться на профиле вне списка (нарушение — fail-closed:
|
|
36
|
+
* запрещённый профиль не выбирается, инстанс-дефолт — **не исключение**,
|
|
37
|
+
* вне списка профилей нет вовсе). Пустой массив — «профилей нет»; массив не
|
|
38
|
+
* задан (`undefined`) — потолок области не задан (ограничения нет).
|
|
39
|
+
*/
|
|
40
|
+
allowedProfiles?: string[];
|
|
41
|
+
/**
|
|
42
|
+
* PROP-135 (браузерный контур): профиль браузерного пула агента
|
|
43
|
+
* (`execution.remote.browserProfiles`). Приоритет выбора: сессия → агент →
|
|
44
|
+
* проект → инстанс-дефолт (`execution.remote.browserProfile`). Не задан —
|
|
45
|
+
* наследуется. Отдельный контур: имя проверяется по браузерному каталогу, а
|
|
46
|
+
* не по exec-каталогу (`allowedProfiles`).
|
|
47
|
+
*/
|
|
48
|
+
browserProfile?: string;
|
|
49
|
+
/**
|
|
50
|
+
* PROP-135 (браузерный контур): **потолок** браузерных профилей агента.
|
|
51
|
+
* Заданный список — профиль обязан в него входить (пустой — «профилей
|
|
52
|
+
* нет»); не задан — потолок не задан.
|
|
53
|
+
*/
|
|
54
|
+
allowedBrowserProfiles?: string[];
|
|
27
55
|
isOverridden: boolean;
|
|
28
56
|
icon?: string;
|
|
29
57
|
color?: string;
|
|
30
58
|
description?: string;
|
|
31
59
|
/**
|
|
32
|
-
* ADR-
|
|
60
|
+
* ADR-126 §9: группы агентов для привязки скиллов
|
|
33
61
|
* (`metadata.synth.groups`). Пусто/не задано — скилл с непустым `groups`
|
|
34
62
|
* не привязан к агенту.
|
|
35
63
|
*/
|
|
@@ -114,6 +114,13 @@ export type AuthorityGrantConstraints = z.infer<typeof authorityGrantConstraints
|
|
|
114
114
|
* Принципал — тот, от чьего имени исполняется ход (ADR-106 §«Модель»).
|
|
115
115
|
* `roles[]` — роли, которые носитель принципала предъявляет (содержательные
|
|
116
116
|
* роли приезжают контентом; глобальные роли инстанса — отдельная ось).
|
|
117
|
+
*
|
|
118
|
+
* ADR-140 Ф2: `groups[]` — группы пользователя (снимок claim'а IdP на момент
|
|
119
|
+
* приёма ввода, ADR-106 Ф4). Поле **аддитивное и необязательное**: старое
|
|
120
|
+
* сохранённое сообщение без него парсится (`undefined`), отсутствие поля =
|
|
121
|
+
* «групп нет» (fail-closed); потребители нормализуют `?? []`. На права влияет
|
|
122
|
+
* только через единый резолвер доступа (`resolveProjectAccess`,
|
|
123
|
+
* ADR-140/PROP-133).
|
|
117
124
|
*/
|
|
118
125
|
export declare const authorityPrincipalSchema: z.ZodObject<{
|
|
119
126
|
kind: z.ZodEnum<{
|
|
@@ -125,6 +132,7 @@ export declare const authorityPrincipalSchema: z.ZodObject<{
|
|
|
125
132
|
}>;
|
|
126
133
|
id: z.ZodString;
|
|
127
134
|
roles: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
135
|
+
groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
128
136
|
}, z.core.$strict>;
|
|
129
137
|
export type AuthorityPrincipal = z.infer<typeof authorityPrincipalSchema>;
|
|
130
138
|
/**
|
|
@@ -243,6 +251,7 @@ export declare const authorityTurnSchema: z.ZodObject<{
|
|
|
243
251
|
}>;
|
|
244
252
|
id: z.ZodString;
|
|
245
253
|
roles: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
254
|
+
groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
246
255
|
}, z.core.$strict>;
|
|
247
256
|
agentId: z.ZodOptional<z.ZodString>;
|
|
248
257
|
ceiling: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
@@ -288,6 +297,7 @@ export declare const authorityApprovalSchema: z.ZodObject<{
|
|
|
288
297
|
}>;
|
|
289
298
|
id: z.ZodString;
|
|
290
299
|
roles: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
300
|
+
groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
291
301
|
}, z.core.$strict>;
|
|
292
302
|
action: z.ZodString;
|
|
293
303
|
target: z.ZodObject<{
|
package/dist/types/authority.js
CHANGED
|
@@ -155,12 +155,20 @@ export const authorityGrantConstraintsSchema = z
|
|
|
155
155
|
* Принципал — тот, от чьего имени исполняется ход (ADR-106 §«Модель»).
|
|
156
156
|
* `roles[]` — роли, которые носитель принципала предъявляет (содержательные
|
|
157
157
|
* роли приезжают контентом; глобальные роли инстанса — отдельная ось).
|
|
158
|
+
*
|
|
159
|
+
* ADR-140 Ф2: `groups[]` — группы пользователя (снимок claim'а IdP на момент
|
|
160
|
+
* приёма ввода, ADR-106 Ф4). Поле **аддитивное и необязательное**: старое
|
|
161
|
+
* сохранённое сообщение без него парсится (`undefined`), отсутствие поля =
|
|
162
|
+
* «групп нет» (fail-closed); потребители нормализуют `?? []`. На права влияет
|
|
163
|
+
* только через единый резолвер доступа (`resolveProjectAccess`,
|
|
164
|
+
* ADR-140/PROP-133).
|
|
158
165
|
*/
|
|
159
166
|
export const authorityPrincipalSchema = z
|
|
160
167
|
.object({
|
|
161
168
|
kind: authorityPrincipalKindSchema,
|
|
162
169
|
id: z.string().min(1).max(256),
|
|
163
170
|
roles: z.array(z.string().min(1).max(128)).default([]),
|
|
171
|
+
groups: z.array(z.string().min(1).max(128)).optional(),
|
|
164
172
|
})
|
|
165
173
|
.strict();
|
|
166
174
|
/**
|