@itphx/synth-shared 0.9.0 → 0.10.1
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 +51 -1
- package/dist/config/env-overrides.d.ts +68 -0
- package/dist/config/env-overrides.js +165 -0
- package/dist/config/index.d.ts +1 -0
- package/dist/config/index.js +1 -0
- package/dist/config/loader.d.ts +3 -1
- package/dist/config/loader.js +12 -4
- package/dist/config/resolve.d.ts +23 -6
- package/dist/config/resolve.js +33 -12
- package/dist/config/types.d.ts +699 -146
- package/dist/config/types.js +195 -28
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +50 -8
- package/dist/index.d.ts +4 -2
- package/dist/index.js +3 -2
- package/dist/interfaces/index.d.ts +8 -1
- package/dist/schemas/index.d.ts +1723 -45
- package/dist/schemas/index.js +403 -29
- package/dist/skills/frontmatter.js +1 -1
- package/dist/types/agent.d.ts +30 -0
- package/dist/types/agent.js +1 -0
- package/dist/types/bus-events.d.ts +7 -0
- package/dist/types/bus-events.js +1 -0
- package/dist/types/commands.d.ts +10 -10
- package/dist/types/commands.js +2 -2
- package/dist/types/decision.d.ts +502 -0
- package/dist/types/decision.js +98 -0
- package/dist/types/events.d.ts +219 -0
- package/dist/types/events.js +1 -0
- package/dist/types/fs.d.ts +44 -0
- package/dist/types/fs.js +16 -0
- package/dist/types/git.d.ts +63 -0
- package/dist/types/git.js +1 -0
- package/dist/types/hooks.d.ts +96 -0
- package/dist/types/hooks.js +1 -0
- package/dist/types/index.d.ts +18 -1097
- package/dist/types/index.js +44 -215
- package/dist/types/llm.d.ts +32 -0
- package/dist/types/llm.js +8 -0
- package/dist/types/mcp.d.ts +104 -0
- package/dist/types/mcp.js +40 -0
- package/dist/types/message.d.ts +63 -0
- package/dist/types/message.js +12 -0
- package/dist/types/permission.d.ts +2 -2
- package/dist/types/permission.js +1 -1
- package/dist/types/project.d.ts +134 -0
- package/dist/types/project.js +67 -0
- package/dist/types/prompt.d.ts +236 -0
- package/dist/types/prompt.js +15 -0
- package/dist/types/provider.d.ts +84 -0
- package/dist/types/provider.js +35 -0
- package/dist/types/schedules.d.ts +109 -0
- package/dist/types/schedules.js +9 -0
- package/dist/types/service-keys.d.ts +106 -0
- package/dist/types/service-keys.js +72 -0
- package/dist/types/session.d.ts +269 -0
- package/dist/types/session.js +13 -0
- package/dist/types/skills.d.ts +11 -11
- package/dist/types/skills.js +6 -6
- package/dist/types/tools.d.ts +4 -3
- package/dist/types/tools.js +2 -0
- package/dist/types/user.d.ts +113 -0
- package/dist/types/user.js +31 -0
- package/dist/types/webhooks.d.ts +97 -0
- package/dist/types/webhooks.js +53 -0
- package/dist/utils/glob.d.ts +1 -1
- package/dist/utils/glob.js +1 -1
- package/dist/utils/index.js +2 -2
- package/dist/utils/workspace.js +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
package/dist/schemas/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import { MessageRole, GlobalRole, ProjectRole, StatusMessageType, PROJECT_ICON_KEYS, PROJECT_COLOR_KEYS, } from '../types/index.js';
|
|
2
|
+
import { MessageRole, GlobalRole, ProjectRole, StatusMessageType, PROJECT_ICON_KEYS, PROJECT_COLOR_KEYS, isKnownScope, isWebhookEventPattern, } from '../types/index.js';
|
|
3
3
|
import { ToolCapability } from '../types/tools.js';
|
|
4
4
|
export const messageRoleSchema = z.nativeEnum(MessageRole);
|
|
5
5
|
export const globalRoleSchema = z.nativeEnum(GlobalRole);
|
|
@@ -45,7 +45,7 @@ export const sessionSettingsSchema = z.object({
|
|
|
45
45
|
debugEnabled: z.boolean().default(true),
|
|
46
46
|
streamEnabled: z.boolean().default(true),
|
|
47
47
|
agentRole: z.string().optional(),
|
|
48
|
-
//
|
|
48
|
+
// ADR-071 §2.4: сессионный скоуп MCP (явно включённые / opt-out).
|
|
49
49
|
mcpServers: z.array(z.string()).optional(),
|
|
50
50
|
mcpDisabledServers: z.array(z.string()).optional(),
|
|
51
51
|
contextOptimization: z.enum(['none', 'sliding_window', 'summarization', 'sticky_notes']).default('none'),
|
|
@@ -61,11 +61,14 @@ export const sessionSettingsSchema = z.object({
|
|
|
61
61
|
showInterview: z.boolean().default(true),
|
|
62
62
|
websocketEnabled: z.boolean().default(true),
|
|
63
63
|
language: z.string().optional(),
|
|
64
|
-
// === Plan/Act (
|
|
64
|
+
// === Plan/Act (ADR-025) ===
|
|
65
65
|
planMode: z.enum(['auto', 'strict', 'off']).optional(),
|
|
66
|
-
// === Скиллы (
|
|
66
|
+
// === Скиллы (ADR-046 §4.5) ===
|
|
67
67
|
skills: z.array(z.string()).optional(),
|
|
68
68
|
skillsDisabled: z.array(z.string()).optional(),
|
|
69
|
+
// === Микро-слой (ADR-035/ADR-084) ===
|
|
70
|
+
/** ADR-084: per-session гейт decision-уровня микро-каскада (undefined → config.decision.enabled). */
|
|
71
|
+
decisionFirst: z.boolean().optional(),
|
|
69
72
|
});
|
|
70
73
|
export const sessionCreateSchema = z.object({
|
|
71
74
|
name: z.string().min(1).max(200).optional(),
|
|
@@ -88,7 +91,7 @@ export const sessionUpdateSchema = z.object({
|
|
|
88
91
|
settings: sessionSettingsSchema.partial().passthrough().optional(),
|
|
89
92
|
});
|
|
90
93
|
/**
|
|
91
|
-
*
|
|
94
|
+
* ADR-076: запись реестра git-репозиториев. `path` обязателен, остальные поля
|
|
92
95
|
* опциональны; старые формы (`string` / `{ path }`) принимаются через
|
|
93
96
|
* `normalizeGitRepoConfig` и union в `repos`.
|
|
94
97
|
*/
|
|
@@ -103,7 +106,7 @@ export const gitRepoConfigSchema = z.object({
|
|
|
103
106
|
lastFetch: z.string().optional(),
|
|
104
107
|
});
|
|
105
108
|
/**
|
|
106
|
-
*
|
|
109
|
+
* ADR-076: нормализация legacy-значения `repos` к `GitRepoConfig`.
|
|
107
110
|
* `string` → `{ path }`; объект → прогон через `gitRepoConfigSchema`
|
|
108
111
|
* (невалидный → `null`). Всё прочее → `null`.
|
|
109
112
|
*/
|
|
@@ -135,7 +138,7 @@ export const projectUpdateSchema = z.object({
|
|
|
135
138
|
workspace: z.string().optional(),
|
|
136
139
|
repos: z.array(z.union([z.string(), gitRepoConfigSchema])).optional(),
|
|
137
140
|
});
|
|
138
|
-
/**
|
|
141
|
+
/** ADR-076: тело создания SSH-ключа (`POST /api/v2/ssh-keys`). */
|
|
139
142
|
export const sshKeyCreateSchema = z.object({
|
|
140
143
|
name: z.string().min(1).max(200),
|
|
141
144
|
type: z.string().optional(),
|
|
@@ -143,10 +146,10 @@ export const sshKeyCreateSchema = z.object({
|
|
|
143
146
|
passphrase: z.string().optional(),
|
|
144
147
|
agentIds: z.array(z.string()).optional(),
|
|
145
148
|
});
|
|
146
|
-
/**
|
|
149
|
+
/** ADR-076: тело обновления SSH-ключа (без id/createdAt). */
|
|
147
150
|
export const sshKeyUpdateSchema = sshKeyCreateSchema.partial();
|
|
148
151
|
/**
|
|
149
|
-
*
|
|
152
|
+
* ADR-071 §2.4: проектный скоуп MCP (ссылки на реестр по имени).
|
|
150
153
|
* PUT-семантика: `undefined` ≠ `[]` — отсутствующее поле сохраняет текущее
|
|
151
154
|
* значение, поэтому `.default([])` здесь недопустим.
|
|
152
155
|
*/
|
|
@@ -155,7 +158,7 @@ export const projectMcpUpdateSchema = z.object({
|
|
|
155
158
|
defaultOn: z.array(z.string()).optional(),
|
|
156
159
|
});
|
|
157
160
|
/**
|
|
158
|
-
*
|
|
161
|
+
* ADR-075: тело `PUT /api/v2/settings/workspace-policy` — политика для
|
|
159
162
|
* абсолютного workspace вне `workspacesRoot`.
|
|
160
163
|
*/
|
|
161
164
|
export const workspacePolicySchema = z.object({
|
|
@@ -203,7 +206,7 @@ export const fsDownloadQuerySchema = z.object({
|
|
|
203
206
|
path: z.string().min(1),
|
|
204
207
|
});
|
|
205
208
|
/**
|
|
206
|
-
*
|
|
209
|
+
* ADR-075: запрос навигации по корню workspace (`GET /fs/workspace-root/browse`,
|
|
207
210
|
* `GET /fs/workspace-root`). `includeHidden` принимает строковые `true`/`false`
|
|
208
211
|
* (query-параметры) — `z.coerce.boolean()` не подходит, т.к. `'false'` → `true`.
|
|
209
212
|
*/
|
|
@@ -213,7 +216,7 @@ export const fsWorkspaceBrowseQuerySchema = z.object({
|
|
|
213
216
|
.preprocess((v) => (v === 'true' ? true : v === 'false' ? false : v), z.boolean().optional())
|
|
214
217
|
.default(false),
|
|
215
218
|
});
|
|
216
|
-
/**
|
|
219
|
+
/** ADR-075: тело `POST /fs/workspace-root/mkdir` — создание каталога в корне workspace. */
|
|
217
220
|
export const fsWorkspaceMkdirBodySchema = z.object({
|
|
218
221
|
path: z.string().min(1),
|
|
219
222
|
/** `confirm`-политика: явное подтверждение создания каталога вне `workspacesRoot`. */
|
|
@@ -239,7 +242,7 @@ export const gitCloneBodySchema = z.object({
|
|
|
239
242
|
sshKeyId: z.string().optional(),
|
|
240
243
|
});
|
|
241
244
|
/**
|
|
242
|
-
*
|
|
245
|
+
* ADR-076: тело `POST /api/v2/git/repos/register` — upsert записи реестра
|
|
243
246
|
* (идемпотентно по `path`). Используется UI для добавления уже существующего
|
|
244
247
|
* локально репозитория.
|
|
245
248
|
*/
|
|
@@ -253,7 +256,7 @@ export const gitReposRegisterBodySchema = z.object({
|
|
|
253
256
|
sshKeyId: z.string().optional(),
|
|
254
257
|
});
|
|
255
258
|
/**
|
|
256
|
-
*
|
|
259
|
+
* ADR-076: тело `POST /api/v2/git/repos/remove` — удаление записи реестра;
|
|
257
260
|
* обязателен `id` либо `path`. `deleteLocal` — удалить каталог репозитория.
|
|
258
261
|
*/
|
|
259
262
|
export const gitReposRemoveBodySchema = z
|
|
@@ -264,7 +267,7 @@ export const gitReposRemoveBodySchema = z
|
|
|
264
267
|
deleteLocal: z.boolean().optional(),
|
|
265
268
|
})
|
|
266
269
|
.refine((v) => Boolean(v.id || v.path), { message: 'Требуется id или path' });
|
|
267
|
-
/**
|
|
270
|
+
/** ADR-076: тело `POST /api/v2/git/repos/fetch` — обязателен `id` либо `path`. */
|
|
268
271
|
export const gitReposFetchBodySchema = z
|
|
269
272
|
.object({
|
|
270
273
|
projectId: z.string().min(1),
|
|
@@ -284,7 +287,7 @@ export const gitCommitQuerySchema = z.object({
|
|
|
284
287
|
});
|
|
285
288
|
const toolCapabilityValues = Object.values(ToolCapability);
|
|
286
289
|
/**
|
|
287
|
-
*
|
|
290
|
+
* ADR-071 §2.6: фабрика схемы `tools.disabled` (единый источник значений
|
|
288
291
|
* на базе `ToolCapability`).
|
|
289
292
|
*
|
|
290
293
|
* - `strictCapabilities: true` (API, `PUT /settings/tools-disabled`) — закрытый
|
|
@@ -303,14 +306,14 @@ export function createToolsDisabledSchema(strictCapabilities) {
|
|
|
303
306
|
});
|
|
304
307
|
}
|
|
305
308
|
/**
|
|
306
|
-
*
|
|
309
|
+
* ADR-071 §2.6: тело `PUT /api/v2/settings/tools-disabled`. Неизвестная
|
|
307
310
|
* capability — ошибка (закрытый набор: опечатка молча ничего не отключит).
|
|
308
311
|
* Имена инструментов принимаются как строки (реестр динамический — MCP-тулы
|
|
309
312
|
* регистрируются лениво); непустые.
|
|
310
313
|
*/
|
|
311
314
|
export const toolsDisabledSchema = createToolsDisabledSchema(true);
|
|
312
315
|
/**
|
|
313
|
-
*
|
|
316
|
+
* ADR-071 §2.4: базовый контракт MCP-скоупа сессии (ссылки на реестр по имени).
|
|
314
317
|
* `undefined` ≠ `[]`: отсутствующее поле сохраняет текущее значение.
|
|
315
318
|
*/
|
|
316
319
|
export const sessionMcpScopeSchema = z
|
|
@@ -320,7 +323,7 @@ export const sessionMcpScopeSchema = z
|
|
|
320
323
|
})
|
|
321
324
|
.refine((v) => v.mcpServers !== undefined || v.mcpDisabledServers !== undefined, { message: 'Требуется mcpServers или mcpDisabledServers' });
|
|
322
325
|
/**
|
|
323
|
-
*
|
|
326
|
+
* ADR-071 §2.4: тело `PUT /api/v2/sessions/:id/mcp`: точечный toggle
|
|
324
327
|
* (`{ name, enabled }`, в т.ч. opt-out системного сервера) или полная/частичная
|
|
325
328
|
* замена (`{ mcpServers?, mcpDisabledServers? }`).
|
|
326
329
|
*/
|
|
@@ -334,12 +337,12 @@ export const sessionMcpUpdateSchema = z
|
|
|
334
337
|
.refine((v) => v.name !== undefined
|
|
335
338
|
|| v.mcpServers !== undefined
|
|
336
339
|
|| v.mcpDisabledServers !== undefined, { message: 'Требуется name, mcpServers или mcpDisabledServers' });
|
|
337
|
-
// --- Скиллы (
|
|
338
|
-
/**
|
|
340
|
+
// --- Скиллы (ADR-046) ---
|
|
341
|
+
/** ADR-046 §3.2: имя скилла — 1–64, `^[a-z0-9]+(-[a-z0-9]+)*$`. */
|
|
339
342
|
export const SKILL_NAME_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
|
|
340
343
|
export const SKILL_NAME_MIN = 1;
|
|
341
344
|
export const SKILL_NAME_MAX = 64;
|
|
342
|
-
/**
|
|
345
|
+
/** ADR-046 §3.2: длина `description`. */
|
|
343
346
|
export const SKILL_DESCRIPTION_MIN = 1;
|
|
344
347
|
export const SKILL_DESCRIPTION_MAX = 1024;
|
|
345
348
|
export const skillNameSchema = z
|
|
@@ -367,29 +370,29 @@ export const skillFileWriteSchema = z.object({
|
|
|
367
370
|
content: z.string(),
|
|
368
371
|
});
|
|
369
372
|
/**
|
|
370
|
-
*
|
|
373
|
+
* ADR-046 §4.5: per-session enable/disable скиллов (по образцу MCP-скоупа).
|
|
371
374
|
* `undefined` ≠ `[]`: отсутствующее поле сохраняет текущее значение.
|
|
372
375
|
*/
|
|
373
376
|
export const skillSessionOverrideSchema = z.object({
|
|
374
377
|
skills: z.array(z.string()).optional(),
|
|
375
378
|
skillsDisabled: z.array(z.string()).optional(),
|
|
376
379
|
});
|
|
377
|
-
// --- Slash-команды и bundles (
|
|
378
|
-
/**
|
|
380
|
+
// --- Slash-команды и bundles (ADR-046 §7) ---
|
|
381
|
+
/** ADR-046 §7.3: тело `POST/PATCH /api/v2/skill-bundles` (YAML-группа скиллов). */
|
|
379
382
|
export const skillBundleSchema = z.object({
|
|
380
383
|
name: skillNameSchema,
|
|
381
384
|
description: z.string().min(SKILL_DESCRIPTION_MIN).max(SKILL_DESCRIPTION_MAX),
|
|
382
385
|
skills: z.array(skillNameSchema).min(1),
|
|
383
386
|
instruction: z.string().optional(),
|
|
384
387
|
});
|
|
385
|
-
/**
|
|
388
|
+
/** ADR-046 §7.4: тело `PUT /api/v2/settings/skills-disabled` (группы/имена). */
|
|
386
389
|
export const skillsDisabledSchema = z.object({
|
|
387
390
|
categories: z.array(z.string()).default([]),
|
|
388
391
|
groups: z.array(z.string()).default([]),
|
|
389
392
|
skills: z.array(z.string()).default([]),
|
|
390
393
|
});
|
|
391
394
|
/**
|
|
392
|
-
*
|
|
395
|
+
* ADR-046 §4.5: тело `PUT /api/v2/settings/skills` — системные настройки:
|
|
393
396
|
* - `disabled` — hard-gate: скиллы, недоступные НИГДЕ;
|
|
394
397
|
* - `disabledForNewProjects` — сид для НОВЫХ проектов (снимок при создании);
|
|
395
398
|
* - `policy` — политика доступности (строкой, валидируется роутом).
|
|
@@ -400,7 +403,7 @@ export const skillsSystemSettingsSchema = z.object({
|
|
|
400
403
|
policy: z.string().optional(),
|
|
401
404
|
});
|
|
402
405
|
/**
|
|
403
|
-
*
|
|
406
|
+
* ADR-046 §4.5: тело `PUT /api/v2/sessions/:id/skills`: точечный toggle
|
|
404
407
|
* (`{ name, enabled }`) или полная/частичная замена (`{ skills?, skillsDisabled? }`).
|
|
405
408
|
*/
|
|
406
409
|
export const sessionSkillUpdateSchema = z
|
|
@@ -413,8 +416,379 @@ export const sessionSkillUpdateSchema = z
|
|
|
413
416
|
.refine((v) => v.name !== undefined
|
|
414
417
|
|| v.skills !== undefined
|
|
415
418
|
|| v.skillsDisabled !== undefined, { message: 'Требуется name, skills или skillsDisabled' });
|
|
416
|
-
/**
|
|
419
|
+
/** ADR-046 §4.5: тело `PUT /api/v2/projects/:id/skills`. */
|
|
417
420
|
export const projectSkillUpdateSchema = z.object({
|
|
418
421
|
enabled: z.array(z.string()).optional(),
|
|
419
422
|
defaultOn: z.array(z.string()).optional(),
|
|
420
423
|
});
|
|
424
|
+
// --- Внешние события (ADR-089) ---
|
|
425
|
+
/** ADR-089: схема идентичности отправителя внешнего события. */
|
|
426
|
+
export const eventIdentitySchema = z.object({
|
|
427
|
+
principalId: z.string().optional(),
|
|
428
|
+
chatKey: z.string().optional(),
|
|
429
|
+
threadKey: z.string().optional(),
|
|
430
|
+
roles: z.array(z.string()).optional(),
|
|
431
|
+
});
|
|
432
|
+
/** ADR-089: схема нормализованного внешнего события (`payload` не типизируется). */
|
|
433
|
+
export const synthEventSchema = z.object({
|
|
434
|
+
id: z.string().min(1),
|
|
435
|
+
source: z.string().min(1),
|
|
436
|
+
type: z.string().min(1),
|
|
437
|
+
payload: z.unknown(),
|
|
438
|
+
identity: eventIdentitySchema.default({}),
|
|
439
|
+
dedupKey: z.string().min(1),
|
|
440
|
+
ts: z.string().min(1),
|
|
441
|
+
});
|
|
442
|
+
/** ADR-089: режимы доставки `EventBinding` (без `drop`). */
|
|
443
|
+
const eventDeliveryModeSchema = z.enum(['bound', 'ephemeral', 'queue']);
|
|
444
|
+
/** ADR-089: схема устойчивой привязки внешнего адреса к сессии/шаблону. */
|
|
445
|
+
export const eventBindingSchema = z.object({
|
|
446
|
+
id: z.string().min(1),
|
|
447
|
+
source: z.string().min(1),
|
|
448
|
+
chatKey: z.string().optional(),
|
|
449
|
+
threadKey: z.string().optional(),
|
|
450
|
+
sessionId: z.string().optional(),
|
|
451
|
+
mode: eventDeliveryModeSchema,
|
|
452
|
+
agentTemplate: z.string().optional(),
|
|
453
|
+
project: z.string().optional(),
|
|
454
|
+
});
|
|
455
|
+
/** ADR-089: схема запроса создания/привязки сессии — единый funnel. */
|
|
456
|
+
export const sessionRequestSchema = z.object({
|
|
457
|
+
initiator: z.enum(['user', 'agent', 'external', 'system']),
|
|
458
|
+
intent: z.enum(['explicit', 'event']),
|
|
459
|
+
projectId: z.string().optional(),
|
|
460
|
+
parentId: z.string().optional(),
|
|
461
|
+
agentTemplate: z.string().optional(),
|
|
462
|
+
mode: eventDeliveryModeSchema.optional(),
|
|
463
|
+
ttl: z.string().optional(),
|
|
464
|
+
title: z.string().optional(),
|
|
465
|
+
icon: projectIconKeySchema.optional(),
|
|
466
|
+
color: projectColorKeySchema.optional(),
|
|
467
|
+
engine: z.enum(['synth', 'opencode', 'cline']).optional(),
|
|
468
|
+
sessionOrigin: z.enum(['user', 'fork', 'subagent']).optional(),
|
|
469
|
+
// Настройки сессии валидируются собственной схемой при создании; здесь —
|
|
470
|
+
// толерантный контейнер, чтобы не дублировать SessionSettings.
|
|
471
|
+
settings: z.unknown().optional(),
|
|
472
|
+
sourceEventId: z.string().optional(),
|
|
473
|
+
dedupKey: z.string().optional(),
|
|
474
|
+
});
|
|
475
|
+
/**
|
|
476
|
+
* ADR-089: вход приёма внешнего события (`POST /api/v2/events`). `id`/`dedupKey`/`ts`
|
|
477
|
+
* нормализуются `EventIngress`, поэтому здесь опциональны.
|
|
478
|
+
*/
|
|
479
|
+
export const eventIngestSchema = z.object({
|
|
480
|
+
source: z.string().min(1),
|
|
481
|
+
type: z.string().min(1),
|
|
482
|
+
payload: z.unknown().optional(),
|
|
483
|
+
identity: eventIdentitySchema.optional(),
|
|
484
|
+
dedupKey: z.string().optional(),
|
|
485
|
+
ts: z.string().optional(),
|
|
486
|
+
});
|
|
487
|
+
/** ADR-089: вход upsert биндинга (`POST /api/v2/events/bindings`) — без `id`. */
|
|
488
|
+
export const eventBindingInputSchema = z.object({
|
|
489
|
+
source: z.string().min(1),
|
|
490
|
+
chatKey: z.string().optional(),
|
|
491
|
+
threadKey: z.string().optional(),
|
|
492
|
+
sessionId: z.string().optional(),
|
|
493
|
+
mode: eventDeliveryModeSchema,
|
|
494
|
+
agentTemplate: z.string().optional(),
|
|
495
|
+
project: z.string().optional(),
|
|
496
|
+
});
|
|
497
|
+
/**
|
|
498
|
+
* ADR-089/ADR-052: метаданные API-ключа привязки для приёма событий.
|
|
499
|
+
* Секрет (`key`) и его хеш здесь отсутствуют — наружу не отдаются.
|
|
500
|
+
*/
|
|
501
|
+
export const eventBindingApiKeySchema = z.object({
|
|
502
|
+
id: z.string().min(1),
|
|
503
|
+
bindingId: z.string().min(1),
|
|
504
|
+
label: z.string().min(1),
|
|
505
|
+
description: z.string().optional(),
|
|
506
|
+
rateLimitPerMinute: z.number().int().min(0).optional(),
|
|
507
|
+
createdBy: z.string().min(1),
|
|
508
|
+
createdAt: z.string().min(1),
|
|
509
|
+
lastUsedAt: z.string().optional(),
|
|
510
|
+
prefix: z.string().min(1),
|
|
511
|
+
// ADR-052 (задел): срок действия / отзыв ключа.
|
|
512
|
+
expiresAt: z.string().optional(),
|
|
513
|
+
revokedAt: z.string().optional(),
|
|
514
|
+
});
|
|
515
|
+
/** ADR-089/ADR-052: тело создания API-ключа привязки — обязательная уникальная `label`. */
|
|
516
|
+
export const eventBindingApiKeyCreateSchema = z.object({
|
|
517
|
+
label: z.string().min(1),
|
|
518
|
+
description: z.string().optional(),
|
|
519
|
+
expiresAt: z.string().optional(),
|
|
520
|
+
rateLimitPerMinute: z.number().int().min(0).optional(),
|
|
521
|
+
});
|
|
522
|
+
/**
|
|
523
|
+
* ADR-089/ADR-052: тело обновления API-ключа привязки. Все поля опциональны;
|
|
524
|
+
* `null` для `description`/`expiresAt`/`rateLimitPerMinute` — сброс значения.
|
|
525
|
+
*/
|
|
526
|
+
export const eventBindingApiKeyUpdateSchema = z.object({
|
|
527
|
+
label: z.string().min(1).optional(),
|
|
528
|
+
description: z.string().nullable().optional(),
|
|
529
|
+
expiresAt: z.string().nullable().optional(),
|
|
530
|
+
rateLimitPerMinute: z.number().int().min(0).nullable().optional(),
|
|
531
|
+
});
|
|
532
|
+
/** ADR-089: ответ создания ключа — метаданные + plaintext-секрет (единожды). */
|
|
533
|
+
export const eventBindingApiKeyCreatedSchema = eventBindingApiKeySchema.extend({
|
|
534
|
+
key: z.string().min(1),
|
|
535
|
+
});
|
|
536
|
+
/**
|
|
537
|
+
* ADR-089: вход `POST /events` при аутентификации API-ключом привязки. Как
|
|
538
|
+
* `eventIngestSchema`, но `source` опционален — источник берётся из привязки.
|
|
539
|
+
*/
|
|
540
|
+
export const eventKeyIngestSchema = eventIngestSchema.partial({ source: true });
|
|
541
|
+
// --- Service-key (ADR-052, этап I) ---
|
|
542
|
+
/**
|
|
543
|
+
* ADR-052: каталог скоупов service-key + wildcard-семейства. Глобальный `*` не
|
|
544
|
+
* принимается (`isKnownScope`).
|
|
545
|
+
*/
|
|
546
|
+
export const serviceScopeSchema = z
|
|
547
|
+
.string()
|
|
548
|
+
.min(1)
|
|
549
|
+
.refine((value) => isKnownScope(value), { message: 'Неизвестный scope' });
|
|
550
|
+
const serviceScopesSchema = z.array(serviceScopeSchema).min(1);
|
|
551
|
+
/**
|
|
552
|
+
* ADR-052: метаданные service-key (ответы API). Секрет (`key`) и его хеш здесь
|
|
553
|
+
* отсутствуют — наружу не отдаются (в списке — `prefix`).
|
|
554
|
+
*/
|
|
555
|
+
export const serviceApiKeySchema = z.object({
|
|
556
|
+
id: z.string().min(1),
|
|
557
|
+
label: z.string().min(1),
|
|
558
|
+
description: z.string().optional(),
|
|
559
|
+
roles: z.array(globalRoleSchema),
|
|
560
|
+
scopes: z.array(z.string().min(1)),
|
|
561
|
+
allowedProjects: z.array(z.string().min(1)).optional(),
|
|
562
|
+
rateLimitPerMinute: z.number().int().min(0).optional(),
|
|
563
|
+
expiresAt: z.string().optional(),
|
|
564
|
+
revokedAt: z.string().optional(),
|
|
565
|
+
createdBy: z.string().min(1),
|
|
566
|
+
createdAt: z.string().min(1),
|
|
567
|
+
lastUsedAt: z.string().optional(),
|
|
568
|
+
prefix: z.string().min(1),
|
|
569
|
+
});
|
|
570
|
+
/** ADR-052: тело создания service-key. `roles` не заданы — дефолт хранилища. */
|
|
571
|
+
export const serviceApiKeyCreateSchema = z.object({
|
|
572
|
+
label: z.string().min(1),
|
|
573
|
+
description: z.string().optional(),
|
|
574
|
+
roles: z.array(globalRoleSchema).optional(),
|
|
575
|
+
scopes: serviceScopesSchema,
|
|
576
|
+
allowedProjects: z.array(z.string().min(1)).optional(),
|
|
577
|
+
rateLimitPerMinute: z.number().int().min(0).optional(),
|
|
578
|
+
expiresAt: z.string().optional(),
|
|
579
|
+
});
|
|
580
|
+
/**
|
|
581
|
+
* ADR-052: тело обновления service-key. Все поля опциональны; `null` для
|
|
582
|
+
* `description`/`allowedProjects`/`rateLimitPerMinute`/`expiresAt` — сброс.
|
|
583
|
+
*/
|
|
584
|
+
export const serviceApiKeyUpdateSchema = z.object({
|
|
585
|
+
label: z.string().min(1).optional(),
|
|
586
|
+
description: z.string().nullable().optional(),
|
|
587
|
+
roles: z.array(globalRoleSchema).optional(),
|
|
588
|
+
scopes: serviceScopesSchema.optional(),
|
|
589
|
+
allowedProjects: z.array(z.string().min(1)).nullable().optional(),
|
|
590
|
+
rateLimitPerMinute: z.number().int().min(0).nullable().optional(),
|
|
591
|
+
expiresAt: z.string().nullable().optional(),
|
|
592
|
+
});
|
|
593
|
+
/** ADR-052: ответ создания service-key — метаданные + plaintext-секрет (единожды). */
|
|
594
|
+
export const serviceApiKeyCreatedSchema = serviceApiKeySchema.extend({
|
|
595
|
+
key: z.string().min(1),
|
|
596
|
+
});
|
|
597
|
+
// --- Webhooks (ADR-052, этап II) ---
|
|
598
|
+
/** ADR-052 (этап II): паттерн события подписки — exact либо `prefix.*`. */
|
|
599
|
+
export const webhookEventPatternSchema = z
|
|
600
|
+
.string()
|
|
601
|
+
.min(1)
|
|
602
|
+
.refine((value) => isWebhookEventPattern(value), { message: 'Некорректный паттерн события' });
|
|
603
|
+
/** ADR-052 (этап II): целевой URL — только http/https (SSRF-политика — в core). */
|
|
604
|
+
export const webhookUrlSchema = z
|
|
605
|
+
.string()
|
|
606
|
+
.url()
|
|
607
|
+
.refine((value) => /^https?:\/\//i.test(value), { message: 'URL должен быть http(s)' });
|
|
608
|
+
/**
|
|
609
|
+
* ADR-052 (этап II): метаданные подписки (ответы API). Секрет (`secret`) и его
|
|
610
|
+
* хеш здесь отсутствуют — наружу не отдаются (в списке — `secretPrefix`).
|
|
611
|
+
*/
|
|
612
|
+
export const webhookSubscriptionSchema = z.object({
|
|
613
|
+
id: z.string().min(1),
|
|
614
|
+
label: z.string().min(1),
|
|
615
|
+
description: z.string().optional(),
|
|
616
|
+
url: webhookUrlSchema,
|
|
617
|
+
events: z.array(webhookEventPatternSchema),
|
|
618
|
+
enabled: z.boolean(),
|
|
619
|
+
secretPrefix: z.string().min(1),
|
|
620
|
+
createdBy: z.string().min(1),
|
|
621
|
+
createdAt: z.string().min(1),
|
|
622
|
+
lastDeliveryAt: z.string().optional(),
|
|
623
|
+
lastStatus: z.enum(['ok', 'failed']).optional(),
|
|
624
|
+
disabledAt: z.string().optional(),
|
|
625
|
+
});
|
|
626
|
+
/** ADR-052 (этап II): тело создания подписки. `enabled` не задан — активна. */
|
|
627
|
+
export const webhookSubscriptionCreateSchema = z.object({
|
|
628
|
+
label: z.string().min(1),
|
|
629
|
+
description: z.string().optional(),
|
|
630
|
+
url: webhookUrlSchema,
|
|
631
|
+
events: z.array(webhookEventPatternSchema).optional(),
|
|
632
|
+
enabled: z.boolean().optional(),
|
|
633
|
+
});
|
|
634
|
+
/**
|
|
635
|
+
* ADR-052 (этап II): тело обновления подписки. Все поля опциональны; `null` для
|
|
636
|
+
* `description` — сброс.
|
|
637
|
+
*/
|
|
638
|
+
export const webhookSubscriptionUpdateSchema = z.object({
|
|
639
|
+
label: z.string().min(1).optional(),
|
|
640
|
+
description: z.string().nullable().optional(),
|
|
641
|
+
url: webhookUrlSchema.optional(),
|
|
642
|
+
events: z.array(webhookEventPatternSchema).optional(),
|
|
643
|
+
enabled: z.boolean().optional(),
|
|
644
|
+
});
|
|
645
|
+
/** ADR-052 (этап II): ответ создания/ротации подписки — метаданные + секрет (единожды). */
|
|
646
|
+
export const webhookSubscriptionCreatedSchema = webhookSubscriptionSchema.extend({
|
|
647
|
+
secret: z.string().min(1),
|
|
648
|
+
});
|
|
649
|
+
/** ADR-052 (этап II): запись журнала доставки. */
|
|
650
|
+
export const webhookDeliverySchema = z.object({
|
|
651
|
+
id: z.string().min(1),
|
|
652
|
+
subscriptionId: z.string().min(1),
|
|
653
|
+
eventType: z.string().min(1),
|
|
654
|
+
status: z.enum(['ok', 'failed', 'pending']),
|
|
655
|
+
attempts: z.number().int().min(0),
|
|
656
|
+
responseStatus: z.number().int().optional(),
|
|
657
|
+
error: z.string().optional(),
|
|
658
|
+
createdAt: z.string().min(1),
|
|
659
|
+
completedAt: z.string().optional(),
|
|
660
|
+
});
|
|
661
|
+
/** ADR-051/ADR-089: цель расписания (дискриминированный союз по `mode`). */
|
|
662
|
+
export const scheduleTargetSchema = z.discriminatedUnion('mode', [
|
|
663
|
+
z.object({ mode: z.literal('bound'), sessionId: z.string().min(1) }),
|
|
664
|
+
z.object({
|
|
665
|
+
mode: z.literal('ephemeral'),
|
|
666
|
+
agentTemplate: z.string().optional(),
|
|
667
|
+
project: z.string().optional(),
|
|
668
|
+
ttl: z.string().optional(),
|
|
669
|
+
}),
|
|
670
|
+
z.object({ mode: z.literal('queue'), sessionId: z.string().min(1) }),
|
|
671
|
+
]);
|
|
672
|
+
/**
|
|
673
|
+
* ADR-089: цель правила маршрутизации — дискриминированный союз по `mode`
|
|
674
|
+
* (семантика та же, что у `scheduleTargetSchema`).
|
|
675
|
+
*/
|
|
676
|
+
export const eventRouteTargetSchema = z.discriminatedUnion('mode', [
|
|
677
|
+
z.object({ mode: z.literal('bound'), sessionId: z.string().min(1) }),
|
|
678
|
+
z.object({
|
|
679
|
+
mode: z.literal('ephemeral'),
|
|
680
|
+
agentTemplate: z.string().optional(),
|
|
681
|
+
project: z.string().optional(),
|
|
682
|
+
ttl: z.string().optional(),
|
|
683
|
+
}),
|
|
684
|
+
z.object({ mode: z.literal('queue'), sessionId: z.string().min(1) }),
|
|
685
|
+
// ADR-089 (auto-bind): цель закрепляет внешний адрес за сессией (binding создаёт Router).
|
|
686
|
+
z.object({
|
|
687
|
+
mode: z.literal('bind'),
|
|
688
|
+
agentTemplate: z.string().optional(),
|
|
689
|
+
project: z.string().optional(),
|
|
690
|
+
}),
|
|
691
|
+
]);
|
|
692
|
+
/** ADR-089: условие срабатывания правила (AND по заполненным полям). */
|
|
693
|
+
export const eventRouteMatchSchema = z.object({
|
|
694
|
+
source: z.string().optional(),
|
|
695
|
+
type: z.string().optional(),
|
|
696
|
+
chatKey: z.string().optional(),
|
|
697
|
+
threadKey: z.string().optional(),
|
|
698
|
+
principalId: z.string().optional(),
|
|
699
|
+
label: z.string().optional(),
|
|
700
|
+
keywords: z.array(z.string()).optional(),
|
|
701
|
+
});
|
|
702
|
+
/** ADR-089: полная сущность правила маршрутизации событий (ответы API). */
|
|
703
|
+
export const eventRouteRuleSchema = z.object({
|
|
704
|
+
id: z.string().min(1),
|
|
705
|
+
name: z.string().optional(),
|
|
706
|
+
priority: z.number().int().default(0),
|
|
707
|
+
enabled: z.boolean().default(true),
|
|
708
|
+
match: eventRouteMatchSchema,
|
|
709
|
+
target: eventRouteTargetSchema,
|
|
710
|
+
});
|
|
711
|
+
/** ADR-089: вход создания/обновления правила (`upsert`) — без `id`. */
|
|
712
|
+
export const eventRouteRuleInputSchema = z.object({
|
|
713
|
+
name: z.string().optional(),
|
|
714
|
+
priority: z.number().int().default(0),
|
|
715
|
+
enabled: z.boolean().default(true),
|
|
716
|
+
match: eventRouteMatchSchema,
|
|
717
|
+
target: eventRouteTargetSchema,
|
|
718
|
+
});
|
|
719
|
+
/**
|
|
720
|
+
* ADR-089: тело upsert-запроса правила — вход + необязательный `id` (обновление
|
|
721
|
+
* существующего правила; отсутствие — создание нового `rule_<uuid>`).
|
|
722
|
+
*/
|
|
723
|
+
export const eventRouteRuleUpsertSchema = eventRouteRuleInputSchema.extend({
|
|
724
|
+
id: z.string().optional(),
|
|
725
|
+
});
|
|
726
|
+
/**
|
|
727
|
+
* ADR-051/ADR-089: ровно одно из `cron` / `every` задано. Пустые строки
|
|
728
|
+
* трактуются как отсутствие поля.
|
|
729
|
+
*/
|
|
730
|
+
function refineScheduleTrigger(val, ctx) {
|
|
731
|
+
const hasCron = typeof val.cron === 'string' && val.cron.trim().length > 0;
|
|
732
|
+
const hasEvery = typeof val.every === 'string' && val.every.trim().length > 0;
|
|
733
|
+
if (hasCron === hasEvery) {
|
|
734
|
+
ctx.addIssue({
|
|
735
|
+
code: z.ZodIssueCode.custom,
|
|
736
|
+
message: 'Ровно одно из полей cron/every должно быть задано',
|
|
737
|
+
path: ['cron'],
|
|
738
|
+
});
|
|
739
|
+
}
|
|
740
|
+
}
|
|
741
|
+
/** ADR-051/ADR-089: вход создания/обновления расписания (`ScheduleInput`). */
|
|
742
|
+
export const scheduleInputSchema = z
|
|
743
|
+
.object({
|
|
744
|
+
name: z.string().min(1),
|
|
745
|
+
enabled: z.boolean().default(true),
|
|
746
|
+
cron: z.string().optional(),
|
|
747
|
+
every: z.string().optional(),
|
|
748
|
+
target: scheduleTargetSchema,
|
|
749
|
+
prompt: z.string().optional(),
|
|
750
|
+
payload: z.record(z.unknown()).optional(),
|
|
751
|
+
ownerId: z.string().optional(),
|
|
752
|
+
catchUp: z.enum(['skip', 'once']).optional(),
|
|
753
|
+
})
|
|
754
|
+
.superRefine(refineScheduleTrigger);
|
|
755
|
+
/** ADR-051/ADR-089: полная сущность расписания (ответы API). */
|
|
756
|
+
export const scheduleSchema = z
|
|
757
|
+
.object({
|
|
758
|
+
id: z.string().min(1),
|
|
759
|
+
name: z.string().min(1),
|
|
760
|
+
enabled: z.boolean(),
|
|
761
|
+
cron: z.string().optional(),
|
|
762
|
+
every: z.string().optional(),
|
|
763
|
+
target: scheduleTargetSchema,
|
|
764
|
+
prompt: z.string().optional(),
|
|
765
|
+
payload: z.record(z.unknown()).optional(),
|
|
766
|
+
ownerId: z.string().optional(),
|
|
767
|
+
catchUp: z.enum(['skip', 'once']).optional(),
|
|
768
|
+
createdAt: z.string().min(1),
|
|
769
|
+
updatedAt: z.string().min(1),
|
|
770
|
+
lastRunAt: z.string().optional(),
|
|
771
|
+
nextRunAt: z.string().optional(),
|
|
772
|
+
lastStatus: z.enum(['ok', 'error', 'skipped']).optional(),
|
|
773
|
+
lastError: z.string().optional(),
|
|
774
|
+
})
|
|
775
|
+
.superRefine(refineScheduleTrigger);
|
|
776
|
+
/** ADR-051: триггер срабатывания расписания в Job-истории. */
|
|
777
|
+
export const scheduleJobTriggerSchema = z.enum(['cron', 'manual', 'catchup']);
|
|
778
|
+
/** ADR-051: запись Job-истории (ответы `GET /api/v2/schedules/:id/jobs`). */
|
|
779
|
+
export const scheduleJobSchema = z.object({
|
|
780
|
+
id: z.string().min(1),
|
|
781
|
+
scheduleId: z.string().min(1),
|
|
782
|
+
scheduleName: z.string(),
|
|
783
|
+
trigger: scheduleJobTriggerSchema,
|
|
784
|
+
status: z.enum(['ok', 'error', 'skipped']),
|
|
785
|
+
startedAt: z.string().min(1),
|
|
786
|
+
finishedAt: z.string().min(1),
|
|
787
|
+
durationMs: z.number(),
|
|
788
|
+
target: scheduleTargetSchema,
|
|
789
|
+
dedupKey: z.string().optional(),
|
|
790
|
+
decision: z.enum(['bound', 'queue', 'ephemeral', 'bind', 'drop']).optional(),
|
|
791
|
+
reason: z.string().optional(),
|
|
792
|
+
sessionId: z.string().optional(),
|
|
793
|
+
error: z.string().optional(),
|
|
794
|
+
});
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { load as parseYaml, dump as dumpYaml } from 'js-yaml';
|
|
2
2
|
/**
|
|
3
|
-
*
|
|
3
|
+
* ADR-046 §3.1: толерантный парсер YAML-frontmatter `SKILL.md`.
|
|
4
4
|
*
|
|
5
5
|
* - Неизвестные ключи — не ошибка (совместимость Anthropic/opencode/Claude Code).
|
|
6
6
|
* - Невалидный YAML — фиксируется issue, но не бросает исключение.
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import type { ToolCapability } from './tools.js';
|
|
2
|
+
import type { ReasoningLevel } from './session.js';
|
|
3
|
+
export type AgentMode = 'primary' | 'subagent' | 'system';
|
|
4
|
+
export interface AgentDefinition {
|
|
5
|
+
id: string;
|
|
6
|
+
displayName: string;
|
|
7
|
+
contextFile?: string;
|
|
8
|
+
capabilities: ToolCapability[];
|
|
9
|
+
enabled: boolean;
|
|
10
|
+
provider?: string;
|
|
11
|
+
model?: string;
|
|
12
|
+
temperature?: number;
|
|
13
|
+
topP?: number;
|
|
14
|
+
topK?: number;
|
|
15
|
+
/** Уровень размышлений агента. Не задано — используется session.settings.reasoningLevel. */
|
|
16
|
+
reasoningLevel?: ReasoningLevel;
|
|
17
|
+
agentMode?: AgentMode | AgentMode[];
|
|
18
|
+
subagentPrompt?: string;
|
|
19
|
+
maxSteps?: number;
|
|
20
|
+
isOverridden: boolean;
|
|
21
|
+
icon?: string;
|
|
22
|
+
color?: string;
|
|
23
|
+
description?: string;
|
|
24
|
+
/**
|
|
25
|
+
* ADR-046 §6.2: группы агентов для привязки скиллов
|
|
26
|
+
* (`metadata.synth.groups`). Пусто/не задано — скилл с непустым `groups`
|
|
27
|
+
* не привязан к агенту.
|
|
28
|
+
*/
|
|
29
|
+
groups?: string[];
|
|
30
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export type EventType = 'session.created' | 'session.updated' | 'session.deleted' | 'session.renamed' | 'session.forked' | 'session.fork.created' | 'session.reference.added' | 'session.reference.removed' | 'session.messages.merged' | 'session.moved' | 'project.updated' | 'fs.changed' | 'message.added' | 'message.updated' | 'child.message.added' | 'child.session.updated' | 'stream.start' | 'stream.chunk' | 'stream.usage' | 'stream.done' | 'stream.ended' | 'stream.cancelled' | 'stream.error' | 'stream.retry' | 'queue.stalled' | 'message.queued' | 'permission.asked' | 'permission.replied' | 'permission.hold' | 'question.asked' | 'question.replied' | 'context.summarization_pending' | 'context.summarized' | 'context.sliding_window_applied' | 'context.limit_warning' | 'context.sticky_note_added' | 'context.sticky_note_updated' | 'context.sticky_note_deleted' | 'context.instructions_loaded' | 'tool_call.started' | 'tool_call.result' | 'tool_call.loop' | 'subagent.progress' | 'subagent.retry' | 'subagent.resume.started' | 'subagent.resume.finished' | 'permission.asked' | 'permission.replied' | 'permission.denied' | 'message.quality_check' | 'session.routing_category' | 'plan.approved' | 'todos.updated' | 'skill.invoked' | 'command.invoked' | 'command.inline_shell' | 'event.received' | 'event.routed' | 'binding.changed' | 'error';
|
|
2
|
+
export interface BusEvent {
|
|
3
|
+
type: EventType;
|
|
4
|
+
sessionId: string;
|
|
5
|
+
data: Record<string, unknown>;
|
|
6
|
+
timestamp: string;
|
|
7
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|