@itphx/synth-shared 0.10.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 +11 -11
- package/dist/config/env-overrides.d.ts +3 -3
- package/dist/config/env-overrides.js +9 -9
- package/dist/config/loader.d.ts +2 -2
- package/dist/config/loader.js +4 -4
- package/dist/config/resolve.d.ts +10 -10
- package/dist/config/resolve.js +16 -16
- package/dist/config/types.d.ts +190 -190
- package/dist/config/types.js +47 -47
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +16 -10
- package/dist/interfaces/index.d.ts +3 -3
- package/dist/schemas/index.d.ts +96 -96
- package/dist/schemas/index.js +70 -70
- 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 +16 -16
- package/dist/types/decision.js +4 -4
- package/dist/types/events.d.ts +22 -22
- 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 +4 -4
- package/dist/types/index.d.ts +12 -1165
- package/dist/types/index.js +38 -244
- 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 +8 -8
- package/dist/types/schedules.js +1 -1
- package/dist/types/service-keys.d.ts +10 -10
- package/dist/types/service-keys.js +3 -3
- 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 +3 -3
- package/dist/types/user.d.ts +113 -0
- package/dist/types/user.js +31 -0
- package/dist/types/webhooks.d.ts +5 -5
- package/dist/types/webhooks.js +1 -1
- 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
|
@@ -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,13 +61,13 @@ 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
|
-
// === Микро-слой (
|
|
70
|
-
/**
|
|
69
|
+
// === Микро-слой (ADR-035/ADR-084) ===
|
|
70
|
+
/** ADR-084: per-session гейт decision-уровня микро-каскада (undefined → config.decision.enabled). */
|
|
71
71
|
decisionFirst: z.boolean().optional(),
|
|
72
72
|
});
|
|
73
73
|
export const sessionCreateSchema = z.object({
|
|
@@ -91,7 +91,7 @@ export const sessionUpdateSchema = z.object({
|
|
|
91
91
|
settings: sessionSettingsSchema.partial().passthrough().optional(),
|
|
92
92
|
});
|
|
93
93
|
/**
|
|
94
|
-
*
|
|
94
|
+
* ADR-076: запись реестра git-репозиториев. `path` обязателен, остальные поля
|
|
95
95
|
* опциональны; старые формы (`string` / `{ path }`) принимаются через
|
|
96
96
|
* `normalizeGitRepoConfig` и union в `repos`.
|
|
97
97
|
*/
|
|
@@ -106,7 +106,7 @@ export const gitRepoConfigSchema = z.object({
|
|
|
106
106
|
lastFetch: z.string().optional(),
|
|
107
107
|
});
|
|
108
108
|
/**
|
|
109
|
-
*
|
|
109
|
+
* ADR-076: нормализация legacy-значения `repos` к `GitRepoConfig`.
|
|
110
110
|
* `string` → `{ path }`; объект → прогон через `gitRepoConfigSchema`
|
|
111
111
|
* (невалидный → `null`). Всё прочее → `null`.
|
|
112
112
|
*/
|
|
@@ -138,7 +138,7 @@ export const projectUpdateSchema = z.object({
|
|
|
138
138
|
workspace: z.string().optional(),
|
|
139
139
|
repos: z.array(z.union([z.string(), gitRepoConfigSchema])).optional(),
|
|
140
140
|
});
|
|
141
|
-
/**
|
|
141
|
+
/** ADR-076: тело создания SSH-ключа (`POST /api/v2/ssh-keys`). */
|
|
142
142
|
export const sshKeyCreateSchema = z.object({
|
|
143
143
|
name: z.string().min(1).max(200),
|
|
144
144
|
type: z.string().optional(),
|
|
@@ -146,10 +146,10 @@ export const sshKeyCreateSchema = z.object({
|
|
|
146
146
|
passphrase: z.string().optional(),
|
|
147
147
|
agentIds: z.array(z.string()).optional(),
|
|
148
148
|
});
|
|
149
|
-
/**
|
|
149
|
+
/** ADR-076: тело обновления SSH-ключа (без id/createdAt). */
|
|
150
150
|
export const sshKeyUpdateSchema = sshKeyCreateSchema.partial();
|
|
151
151
|
/**
|
|
152
|
-
*
|
|
152
|
+
* ADR-071 §2.4: проектный скоуп MCP (ссылки на реестр по имени).
|
|
153
153
|
* PUT-семантика: `undefined` ≠ `[]` — отсутствующее поле сохраняет текущее
|
|
154
154
|
* значение, поэтому `.default([])` здесь недопустим.
|
|
155
155
|
*/
|
|
@@ -158,7 +158,7 @@ export const projectMcpUpdateSchema = z.object({
|
|
|
158
158
|
defaultOn: z.array(z.string()).optional(),
|
|
159
159
|
});
|
|
160
160
|
/**
|
|
161
|
-
*
|
|
161
|
+
* ADR-075: тело `PUT /api/v2/settings/workspace-policy` — политика для
|
|
162
162
|
* абсолютного workspace вне `workspacesRoot`.
|
|
163
163
|
*/
|
|
164
164
|
export const workspacePolicySchema = z.object({
|
|
@@ -206,7 +206,7 @@ export const fsDownloadQuerySchema = z.object({
|
|
|
206
206
|
path: z.string().min(1),
|
|
207
207
|
});
|
|
208
208
|
/**
|
|
209
|
-
*
|
|
209
|
+
* ADR-075: запрос навигации по корню workspace (`GET /fs/workspace-root/browse`,
|
|
210
210
|
* `GET /fs/workspace-root`). `includeHidden` принимает строковые `true`/`false`
|
|
211
211
|
* (query-параметры) — `z.coerce.boolean()` не подходит, т.к. `'false'` → `true`.
|
|
212
212
|
*/
|
|
@@ -216,7 +216,7 @@ export const fsWorkspaceBrowseQuerySchema = z.object({
|
|
|
216
216
|
.preprocess((v) => (v === 'true' ? true : v === 'false' ? false : v), z.boolean().optional())
|
|
217
217
|
.default(false),
|
|
218
218
|
});
|
|
219
|
-
/**
|
|
219
|
+
/** ADR-075: тело `POST /fs/workspace-root/mkdir` — создание каталога в корне workspace. */
|
|
220
220
|
export const fsWorkspaceMkdirBodySchema = z.object({
|
|
221
221
|
path: z.string().min(1),
|
|
222
222
|
/** `confirm`-политика: явное подтверждение создания каталога вне `workspacesRoot`. */
|
|
@@ -242,7 +242,7 @@ export const gitCloneBodySchema = z.object({
|
|
|
242
242
|
sshKeyId: z.string().optional(),
|
|
243
243
|
});
|
|
244
244
|
/**
|
|
245
|
-
*
|
|
245
|
+
* ADR-076: тело `POST /api/v2/git/repos/register` — upsert записи реестра
|
|
246
246
|
* (идемпотентно по `path`). Используется UI для добавления уже существующего
|
|
247
247
|
* локально репозитория.
|
|
248
248
|
*/
|
|
@@ -256,7 +256,7 @@ export const gitReposRegisterBodySchema = z.object({
|
|
|
256
256
|
sshKeyId: z.string().optional(),
|
|
257
257
|
});
|
|
258
258
|
/**
|
|
259
|
-
*
|
|
259
|
+
* ADR-076: тело `POST /api/v2/git/repos/remove` — удаление записи реестра;
|
|
260
260
|
* обязателен `id` либо `path`. `deleteLocal` — удалить каталог репозитория.
|
|
261
261
|
*/
|
|
262
262
|
export const gitReposRemoveBodySchema = z
|
|
@@ -267,7 +267,7 @@ export const gitReposRemoveBodySchema = z
|
|
|
267
267
|
deleteLocal: z.boolean().optional(),
|
|
268
268
|
})
|
|
269
269
|
.refine((v) => Boolean(v.id || v.path), { message: 'Требуется id или path' });
|
|
270
|
-
/**
|
|
270
|
+
/** ADR-076: тело `POST /api/v2/git/repos/fetch` — обязателен `id` либо `path`. */
|
|
271
271
|
export const gitReposFetchBodySchema = z
|
|
272
272
|
.object({
|
|
273
273
|
projectId: z.string().min(1),
|
|
@@ -287,7 +287,7 @@ export const gitCommitQuerySchema = z.object({
|
|
|
287
287
|
});
|
|
288
288
|
const toolCapabilityValues = Object.values(ToolCapability);
|
|
289
289
|
/**
|
|
290
|
-
*
|
|
290
|
+
* ADR-071 §2.6: фабрика схемы `tools.disabled` (единый источник значений
|
|
291
291
|
* на базе `ToolCapability`).
|
|
292
292
|
*
|
|
293
293
|
* - `strictCapabilities: true` (API, `PUT /settings/tools-disabled`) — закрытый
|
|
@@ -306,14 +306,14 @@ export function createToolsDisabledSchema(strictCapabilities) {
|
|
|
306
306
|
});
|
|
307
307
|
}
|
|
308
308
|
/**
|
|
309
|
-
*
|
|
309
|
+
* ADR-071 §2.6: тело `PUT /api/v2/settings/tools-disabled`. Неизвестная
|
|
310
310
|
* capability — ошибка (закрытый набор: опечатка молча ничего не отключит).
|
|
311
311
|
* Имена инструментов принимаются как строки (реестр динамический — MCP-тулы
|
|
312
312
|
* регистрируются лениво); непустые.
|
|
313
313
|
*/
|
|
314
314
|
export const toolsDisabledSchema = createToolsDisabledSchema(true);
|
|
315
315
|
/**
|
|
316
|
-
*
|
|
316
|
+
* ADR-071 §2.4: базовый контракт MCP-скоупа сессии (ссылки на реестр по имени).
|
|
317
317
|
* `undefined` ≠ `[]`: отсутствующее поле сохраняет текущее значение.
|
|
318
318
|
*/
|
|
319
319
|
export const sessionMcpScopeSchema = z
|
|
@@ -323,7 +323,7 @@ export const sessionMcpScopeSchema = z
|
|
|
323
323
|
})
|
|
324
324
|
.refine((v) => v.mcpServers !== undefined || v.mcpDisabledServers !== undefined, { message: 'Требуется mcpServers или mcpDisabledServers' });
|
|
325
325
|
/**
|
|
326
|
-
*
|
|
326
|
+
* ADR-071 §2.4: тело `PUT /api/v2/sessions/:id/mcp`: точечный toggle
|
|
327
327
|
* (`{ name, enabled }`, в т.ч. opt-out системного сервера) или полная/частичная
|
|
328
328
|
* замена (`{ mcpServers?, mcpDisabledServers? }`).
|
|
329
329
|
*/
|
|
@@ -337,12 +337,12 @@ export const sessionMcpUpdateSchema = z
|
|
|
337
337
|
.refine((v) => v.name !== undefined
|
|
338
338
|
|| v.mcpServers !== undefined
|
|
339
339
|
|| v.mcpDisabledServers !== undefined, { message: 'Требуется name, mcpServers или mcpDisabledServers' });
|
|
340
|
-
// --- Скиллы (
|
|
341
|
-
/**
|
|
340
|
+
// --- Скиллы (ADR-046) ---
|
|
341
|
+
/** ADR-046 §3.2: имя скилла — 1–64, `^[a-z0-9]+(-[a-z0-9]+)*$`. */
|
|
342
342
|
export const SKILL_NAME_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
|
|
343
343
|
export const SKILL_NAME_MIN = 1;
|
|
344
344
|
export const SKILL_NAME_MAX = 64;
|
|
345
|
-
/**
|
|
345
|
+
/** ADR-046 §3.2: длина `description`. */
|
|
346
346
|
export const SKILL_DESCRIPTION_MIN = 1;
|
|
347
347
|
export const SKILL_DESCRIPTION_MAX = 1024;
|
|
348
348
|
export const skillNameSchema = z
|
|
@@ -370,29 +370,29 @@ export const skillFileWriteSchema = z.object({
|
|
|
370
370
|
content: z.string(),
|
|
371
371
|
});
|
|
372
372
|
/**
|
|
373
|
-
*
|
|
373
|
+
* ADR-046 §4.5: per-session enable/disable скиллов (по образцу MCP-скоупа).
|
|
374
374
|
* `undefined` ≠ `[]`: отсутствующее поле сохраняет текущее значение.
|
|
375
375
|
*/
|
|
376
376
|
export const skillSessionOverrideSchema = z.object({
|
|
377
377
|
skills: z.array(z.string()).optional(),
|
|
378
378
|
skillsDisabled: z.array(z.string()).optional(),
|
|
379
379
|
});
|
|
380
|
-
// --- Slash-команды и bundles (
|
|
381
|
-
/**
|
|
380
|
+
// --- Slash-команды и bundles (ADR-046 §7) ---
|
|
381
|
+
/** ADR-046 §7.3: тело `POST/PATCH /api/v2/skill-bundles` (YAML-группа скиллов). */
|
|
382
382
|
export const skillBundleSchema = z.object({
|
|
383
383
|
name: skillNameSchema,
|
|
384
384
|
description: z.string().min(SKILL_DESCRIPTION_MIN).max(SKILL_DESCRIPTION_MAX),
|
|
385
385
|
skills: z.array(skillNameSchema).min(1),
|
|
386
386
|
instruction: z.string().optional(),
|
|
387
387
|
});
|
|
388
|
-
/**
|
|
388
|
+
/** ADR-046 §7.4: тело `PUT /api/v2/settings/skills-disabled` (группы/имена). */
|
|
389
389
|
export const skillsDisabledSchema = z.object({
|
|
390
390
|
categories: z.array(z.string()).default([]),
|
|
391
391
|
groups: z.array(z.string()).default([]),
|
|
392
392
|
skills: z.array(z.string()).default([]),
|
|
393
393
|
});
|
|
394
394
|
/**
|
|
395
|
-
*
|
|
395
|
+
* ADR-046 §4.5: тело `PUT /api/v2/settings/skills` — системные настройки:
|
|
396
396
|
* - `disabled` — hard-gate: скиллы, недоступные НИГДЕ;
|
|
397
397
|
* - `disabledForNewProjects` — сид для НОВЫХ проектов (снимок при создании);
|
|
398
398
|
* - `policy` — политика доступности (строкой, валидируется роутом).
|
|
@@ -403,7 +403,7 @@ export const skillsSystemSettingsSchema = z.object({
|
|
|
403
403
|
policy: z.string().optional(),
|
|
404
404
|
});
|
|
405
405
|
/**
|
|
406
|
-
*
|
|
406
|
+
* ADR-046 §4.5: тело `PUT /api/v2/sessions/:id/skills`: точечный toggle
|
|
407
407
|
* (`{ name, enabled }`) или полная/частичная замена (`{ skills?, skillsDisabled? }`).
|
|
408
408
|
*/
|
|
409
409
|
export const sessionSkillUpdateSchema = z
|
|
@@ -416,20 +416,20 @@ export const sessionSkillUpdateSchema = z
|
|
|
416
416
|
.refine((v) => v.name !== undefined
|
|
417
417
|
|| v.skills !== undefined
|
|
418
418
|
|| v.skillsDisabled !== undefined, { message: 'Требуется name, skills или skillsDisabled' });
|
|
419
|
-
/**
|
|
419
|
+
/** ADR-046 §4.5: тело `PUT /api/v2/projects/:id/skills`. */
|
|
420
420
|
export const projectSkillUpdateSchema = z.object({
|
|
421
421
|
enabled: z.array(z.string()).optional(),
|
|
422
422
|
defaultOn: z.array(z.string()).optional(),
|
|
423
423
|
});
|
|
424
|
-
// --- Внешние события (
|
|
425
|
-
/**
|
|
424
|
+
// --- Внешние события (ADR-089) ---
|
|
425
|
+
/** ADR-089: схема идентичности отправителя внешнего события. */
|
|
426
426
|
export const eventIdentitySchema = z.object({
|
|
427
427
|
principalId: z.string().optional(),
|
|
428
428
|
chatKey: z.string().optional(),
|
|
429
429
|
threadKey: z.string().optional(),
|
|
430
430
|
roles: z.array(z.string()).optional(),
|
|
431
431
|
});
|
|
432
|
-
/**
|
|
432
|
+
/** ADR-089: схема нормализованного внешнего события (`payload` не типизируется). */
|
|
433
433
|
export const synthEventSchema = z.object({
|
|
434
434
|
id: z.string().min(1),
|
|
435
435
|
source: z.string().min(1),
|
|
@@ -439,9 +439,9 @@ export const synthEventSchema = z.object({
|
|
|
439
439
|
dedupKey: z.string().min(1),
|
|
440
440
|
ts: z.string().min(1),
|
|
441
441
|
});
|
|
442
|
-
/**
|
|
442
|
+
/** ADR-089: режимы доставки `EventBinding` (без `drop`). */
|
|
443
443
|
const eventDeliveryModeSchema = z.enum(['bound', 'ephemeral', 'queue']);
|
|
444
|
-
/**
|
|
444
|
+
/** ADR-089: схема устойчивой привязки внешнего адреса к сессии/шаблону. */
|
|
445
445
|
export const eventBindingSchema = z.object({
|
|
446
446
|
id: z.string().min(1),
|
|
447
447
|
source: z.string().min(1),
|
|
@@ -452,7 +452,7 @@ export const eventBindingSchema = z.object({
|
|
|
452
452
|
agentTemplate: z.string().optional(),
|
|
453
453
|
project: z.string().optional(),
|
|
454
454
|
});
|
|
455
|
-
/**
|
|
455
|
+
/** ADR-089: схема запроса создания/привязки сессии — единый funnel. */
|
|
456
456
|
export const sessionRequestSchema = z.object({
|
|
457
457
|
initiator: z.enum(['user', 'agent', 'external', 'system']),
|
|
458
458
|
intent: z.enum(['explicit', 'event']),
|
|
@@ -473,7 +473,7 @@ export const sessionRequestSchema = z.object({
|
|
|
473
473
|
dedupKey: z.string().optional(),
|
|
474
474
|
});
|
|
475
475
|
/**
|
|
476
|
-
*
|
|
476
|
+
* ADR-089: вход приёма внешнего события (`POST /api/v2/events`). `id`/`dedupKey`/`ts`
|
|
477
477
|
* нормализуются `EventIngress`, поэтому здесь опциональны.
|
|
478
478
|
*/
|
|
479
479
|
export const eventIngestSchema = z.object({
|
|
@@ -484,7 +484,7 @@ export const eventIngestSchema = z.object({
|
|
|
484
484
|
dedupKey: z.string().optional(),
|
|
485
485
|
ts: z.string().optional(),
|
|
486
486
|
});
|
|
487
|
-
/**
|
|
487
|
+
/** ADR-089: вход upsert биндинга (`POST /api/v2/events/bindings`) — без `id`. */
|
|
488
488
|
export const eventBindingInputSchema = z.object({
|
|
489
489
|
source: z.string().min(1),
|
|
490
490
|
chatKey: z.string().optional(),
|
|
@@ -495,7 +495,7 @@ export const eventBindingInputSchema = z.object({
|
|
|
495
495
|
project: z.string().optional(),
|
|
496
496
|
});
|
|
497
497
|
/**
|
|
498
|
-
*
|
|
498
|
+
* ADR-089/ADR-052: метаданные API-ключа привязки для приёма событий.
|
|
499
499
|
* Секрет (`key`) и его хеш здесь отсутствуют — наружу не отдаются.
|
|
500
500
|
*/
|
|
501
501
|
export const eventBindingApiKeySchema = z.object({
|
|
@@ -508,11 +508,11 @@ export const eventBindingApiKeySchema = z.object({
|
|
|
508
508
|
createdAt: z.string().min(1),
|
|
509
509
|
lastUsedAt: z.string().optional(),
|
|
510
510
|
prefix: z.string().min(1),
|
|
511
|
-
//
|
|
511
|
+
// ADR-052 (задел): срок действия / отзыв ключа.
|
|
512
512
|
expiresAt: z.string().optional(),
|
|
513
513
|
revokedAt: z.string().optional(),
|
|
514
514
|
});
|
|
515
|
-
/**
|
|
515
|
+
/** ADR-089/ADR-052: тело создания API-ключа привязки — обязательная уникальная `label`. */
|
|
516
516
|
export const eventBindingApiKeyCreateSchema = z.object({
|
|
517
517
|
label: z.string().min(1),
|
|
518
518
|
description: z.string().optional(),
|
|
@@ -520,7 +520,7 @@ export const eventBindingApiKeyCreateSchema = z.object({
|
|
|
520
520
|
rateLimitPerMinute: z.number().int().min(0).optional(),
|
|
521
521
|
});
|
|
522
522
|
/**
|
|
523
|
-
*
|
|
523
|
+
* ADR-089/ADR-052: тело обновления API-ключа привязки. Все поля опциональны;
|
|
524
524
|
* `null` для `description`/`expiresAt`/`rateLimitPerMinute` — сброс значения.
|
|
525
525
|
*/
|
|
526
526
|
export const eventBindingApiKeyUpdateSchema = z.object({
|
|
@@ -529,18 +529,18 @@ export const eventBindingApiKeyUpdateSchema = z.object({
|
|
|
529
529
|
expiresAt: z.string().nullable().optional(),
|
|
530
530
|
rateLimitPerMinute: z.number().int().min(0).nullable().optional(),
|
|
531
531
|
});
|
|
532
|
-
/**
|
|
532
|
+
/** ADR-089: ответ создания ключа — метаданные + plaintext-секрет (единожды). */
|
|
533
533
|
export const eventBindingApiKeyCreatedSchema = eventBindingApiKeySchema.extend({
|
|
534
534
|
key: z.string().min(1),
|
|
535
535
|
});
|
|
536
536
|
/**
|
|
537
|
-
*
|
|
537
|
+
* ADR-089: вход `POST /events` при аутентификации API-ключом привязки. Как
|
|
538
538
|
* `eventIngestSchema`, но `source` опционален — источник берётся из привязки.
|
|
539
539
|
*/
|
|
540
540
|
export const eventKeyIngestSchema = eventIngestSchema.partial({ source: true });
|
|
541
|
-
// --- Service-key (
|
|
541
|
+
// --- Service-key (ADR-052, этап I) ---
|
|
542
542
|
/**
|
|
543
|
-
*
|
|
543
|
+
* ADR-052: каталог скоупов service-key + wildcard-семейства. Глобальный `*` не
|
|
544
544
|
* принимается (`isKnownScope`).
|
|
545
545
|
*/
|
|
546
546
|
export const serviceScopeSchema = z
|
|
@@ -549,7 +549,7 @@ export const serviceScopeSchema = z
|
|
|
549
549
|
.refine((value) => isKnownScope(value), { message: 'Неизвестный scope' });
|
|
550
550
|
const serviceScopesSchema = z.array(serviceScopeSchema).min(1);
|
|
551
551
|
/**
|
|
552
|
-
*
|
|
552
|
+
* ADR-052: метаданные service-key (ответы API). Секрет (`key`) и его хеш здесь
|
|
553
553
|
* отсутствуют — наружу не отдаются (в списке — `prefix`).
|
|
554
554
|
*/
|
|
555
555
|
export const serviceApiKeySchema = z.object({
|
|
@@ -567,7 +567,7 @@ export const serviceApiKeySchema = z.object({
|
|
|
567
567
|
lastUsedAt: z.string().optional(),
|
|
568
568
|
prefix: z.string().min(1),
|
|
569
569
|
});
|
|
570
|
-
/**
|
|
570
|
+
/** ADR-052: тело создания service-key. `roles` не заданы — дефолт хранилища. */
|
|
571
571
|
export const serviceApiKeyCreateSchema = z.object({
|
|
572
572
|
label: z.string().min(1),
|
|
573
573
|
description: z.string().optional(),
|
|
@@ -578,7 +578,7 @@ export const serviceApiKeyCreateSchema = z.object({
|
|
|
578
578
|
expiresAt: z.string().optional(),
|
|
579
579
|
});
|
|
580
580
|
/**
|
|
581
|
-
*
|
|
581
|
+
* ADR-052: тело обновления service-key. Все поля опциональны; `null` для
|
|
582
582
|
* `description`/`allowedProjects`/`rateLimitPerMinute`/`expiresAt` — сброс.
|
|
583
583
|
*/
|
|
584
584
|
export const serviceApiKeyUpdateSchema = z.object({
|
|
@@ -590,23 +590,23 @@ export const serviceApiKeyUpdateSchema = z.object({
|
|
|
590
590
|
rateLimitPerMinute: z.number().int().min(0).nullable().optional(),
|
|
591
591
|
expiresAt: z.string().nullable().optional(),
|
|
592
592
|
});
|
|
593
|
-
/**
|
|
593
|
+
/** ADR-052: ответ создания service-key — метаданные + plaintext-секрет (единожды). */
|
|
594
594
|
export const serviceApiKeyCreatedSchema = serviceApiKeySchema.extend({
|
|
595
595
|
key: z.string().min(1),
|
|
596
596
|
});
|
|
597
|
-
// --- Webhooks (
|
|
598
|
-
/**
|
|
597
|
+
// --- Webhooks (ADR-052, этап II) ---
|
|
598
|
+
/** ADR-052 (этап II): паттерн события подписки — exact либо `prefix.*`. */
|
|
599
599
|
export const webhookEventPatternSchema = z
|
|
600
600
|
.string()
|
|
601
601
|
.min(1)
|
|
602
602
|
.refine((value) => isWebhookEventPattern(value), { message: 'Некорректный паттерн события' });
|
|
603
|
-
/**
|
|
603
|
+
/** ADR-052 (этап II): целевой URL — только http/https (SSRF-политика — в core). */
|
|
604
604
|
export const webhookUrlSchema = z
|
|
605
605
|
.string()
|
|
606
606
|
.url()
|
|
607
607
|
.refine((value) => /^https?:\/\//i.test(value), { message: 'URL должен быть http(s)' });
|
|
608
608
|
/**
|
|
609
|
-
*
|
|
609
|
+
* ADR-052 (этап II): метаданные подписки (ответы API). Секрет (`secret`) и его
|
|
610
610
|
* хеш здесь отсутствуют — наружу не отдаются (в списке — `secretPrefix`).
|
|
611
611
|
*/
|
|
612
612
|
export const webhookSubscriptionSchema = z.object({
|
|
@@ -623,7 +623,7 @@ export const webhookSubscriptionSchema = z.object({
|
|
|
623
623
|
lastStatus: z.enum(['ok', 'failed']).optional(),
|
|
624
624
|
disabledAt: z.string().optional(),
|
|
625
625
|
});
|
|
626
|
-
/**
|
|
626
|
+
/** ADR-052 (этап II): тело создания подписки. `enabled` не задан — активна. */
|
|
627
627
|
export const webhookSubscriptionCreateSchema = z.object({
|
|
628
628
|
label: z.string().min(1),
|
|
629
629
|
description: z.string().optional(),
|
|
@@ -632,7 +632,7 @@ export const webhookSubscriptionCreateSchema = z.object({
|
|
|
632
632
|
enabled: z.boolean().optional(),
|
|
633
633
|
});
|
|
634
634
|
/**
|
|
635
|
-
*
|
|
635
|
+
* ADR-052 (этап II): тело обновления подписки. Все поля опциональны; `null` для
|
|
636
636
|
* `description` — сброс.
|
|
637
637
|
*/
|
|
638
638
|
export const webhookSubscriptionUpdateSchema = z.object({
|
|
@@ -642,11 +642,11 @@ export const webhookSubscriptionUpdateSchema = z.object({
|
|
|
642
642
|
events: z.array(webhookEventPatternSchema).optional(),
|
|
643
643
|
enabled: z.boolean().optional(),
|
|
644
644
|
});
|
|
645
|
-
/**
|
|
645
|
+
/** ADR-052 (этап II): ответ создания/ротации подписки — метаданные + секрет (единожды). */
|
|
646
646
|
export const webhookSubscriptionCreatedSchema = webhookSubscriptionSchema.extend({
|
|
647
647
|
secret: z.string().min(1),
|
|
648
648
|
});
|
|
649
|
-
/**
|
|
649
|
+
/** ADR-052 (этап II): запись журнала доставки. */
|
|
650
650
|
export const webhookDeliverySchema = z.object({
|
|
651
651
|
id: z.string().min(1),
|
|
652
652
|
subscriptionId: z.string().min(1),
|
|
@@ -658,7 +658,7 @@ export const webhookDeliverySchema = z.object({
|
|
|
658
658
|
createdAt: z.string().min(1),
|
|
659
659
|
completedAt: z.string().optional(),
|
|
660
660
|
});
|
|
661
|
-
/**
|
|
661
|
+
/** ADR-051/ADR-089: цель расписания (дискриминированный союз по `mode`). */
|
|
662
662
|
export const scheduleTargetSchema = z.discriminatedUnion('mode', [
|
|
663
663
|
z.object({ mode: z.literal('bound'), sessionId: z.string().min(1) }),
|
|
664
664
|
z.object({
|
|
@@ -670,7 +670,7 @@ export const scheduleTargetSchema = z.discriminatedUnion('mode', [
|
|
|
670
670
|
z.object({ mode: z.literal('queue'), sessionId: z.string().min(1) }),
|
|
671
671
|
]);
|
|
672
672
|
/**
|
|
673
|
-
*
|
|
673
|
+
* ADR-089: цель правила маршрутизации — дискриминированный союз по `mode`
|
|
674
674
|
* (семантика та же, что у `scheduleTargetSchema`).
|
|
675
675
|
*/
|
|
676
676
|
export const eventRouteTargetSchema = z.discriminatedUnion('mode', [
|
|
@@ -682,14 +682,14 @@ export const eventRouteTargetSchema = z.discriminatedUnion('mode', [
|
|
|
682
682
|
ttl: z.string().optional(),
|
|
683
683
|
}),
|
|
684
684
|
z.object({ mode: z.literal('queue'), sessionId: z.string().min(1) }),
|
|
685
|
-
//
|
|
685
|
+
// ADR-089 (auto-bind): цель закрепляет внешний адрес за сессией (binding создаёт Router).
|
|
686
686
|
z.object({
|
|
687
687
|
mode: z.literal('bind'),
|
|
688
688
|
agentTemplate: z.string().optional(),
|
|
689
689
|
project: z.string().optional(),
|
|
690
690
|
}),
|
|
691
691
|
]);
|
|
692
|
-
/**
|
|
692
|
+
/** ADR-089: условие срабатывания правила (AND по заполненным полям). */
|
|
693
693
|
export const eventRouteMatchSchema = z.object({
|
|
694
694
|
source: z.string().optional(),
|
|
695
695
|
type: z.string().optional(),
|
|
@@ -699,7 +699,7 @@ export const eventRouteMatchSchema = z.object({
|
|
|
699
699
|
label: z.string().optional(),
|
|
700
700
|
keywords: z.array(z.string()).optional(),
|
|
701
701
|
});
|
|
702
|
-
/**
|
|
702
|
+
/** ADR-089: полная сущность правила маршрутизации событий (ответы API). */
|
|
703
703
|
export const eventRouteRuleSchema = z.object({
|
|
704
704
|
id: z.string().min(1),
|
|
705
705
|
name: z.string().optional(),
|
|
@@ -708,7 +708,7 @@ export const eventRouteRuleSchema = z.object({
|
|
|
708
708
|
match: eventRouteMatchSchema,
|
|
709
709
|
target: eventRouteTargetSchema,
|
|
710
710
|
});
|
|
711
|
-
/**
|
|
711
|
+
/** ADR-089: вход создания/обновления правила (`upsert`) — без `id`. */
|
|
712
712
|
export const eventRouteRuleInputSchema = z.object({
|
|
713
713
|
name: z.string().optional(),
|
|
714
714
|
priority: z.number().int().default(0),
|
|
@@ -717,14 +717,14 @@ export const eventRouteRuleInputSchema = z.object({
|
|
|
717
717
|
target: eventRouteTargetSchema,
|
|
718
718
|
});
|
|
719
719
|
/**
|
|
720
|
-
*
|
|
720
|
+
* ADR-089: тело upsert-запроса правила — вход + необязательный `id` (обновление
|
|
721
721
|
* существующего правила; отсутствие — создание нового `rule_<uuid>`).
|
|
722
722
|
*/
|
|
723
723
|
export const eventRouteRuleUpsertSchema = eventRouteRuleInputSchema.extend({
|
|
724
724
|
id: z.string().optional(),
|
|
725
725
|
});
|
|
726
726
|
/**
|
|
727
|
-
*
|
|
727
|
+
* ADR-051/ADR-089: ровно одно из `cron` / `every` задано. Пустые строки
|
|
728
728
|
* трактуются как отсутствие поля.
|
|
729
729
|
*/
|
|
730
730
|
function refineScheduleTrigger(val, ctx) {
|
|
@@ -738,7 +738,7 @@ function refineScheduleTrigger(val, ctx) {
|
|
|
738
738
|
});
|
|
739
739
|
}
|
|
740
740
|
}
|
|
741
|
-
/**
|
|
741
|
+
/** ADR-051/ADR-089: вход создания/обновления расписания (`ScheduleInput`). */
|
|
742
742
|
export const scheduleInputSchema = z
|
|
743
743
|
.object({
|
|
744
744
|
name: z.string().min(1),
|
|
@@ -752,7 +752,7 @@ export const scheduleInputSchema = z
|
|
|
752
752
|
catchUp: z.enum(['skip', 'once']).optional(),
|
|
753
753
|
})
|
|
754
754
|
.superRefine(refineScheduleTrigger);
|
|
755
|
-
/**
|
|
755
|
+
/** ADR-051/ADR-089: полная сущность расписания (ответы API). */
|
|
756
756
|
export const scheduleSchema = z
|
|
757
757
|
.object({
|
|
758
758
|
id: z.string().min(1),
|
|
@@ -773,9 +773,9 @@ export const scheduleSchema = z
|
|
|
773
773
|
lastError: z.string().optional(),
|
|
774
774
|
})
|
|
775
775
|
.superRefine(refineScheduleTrigger);
|
|
776
|
-
/**
|
|
776
|
+
/** ADR-051: триггер срабатывания расписания в Job-истории. */
|
|
777
777
|
export const scheduleJobTriggerSchema = z.enum(['cron', 'manual', 'catchup']);
|
|
778
|
-
/**
|
|
778
|
+
/** ADR-051: запись Job-истории (ответы `GET /api/v2/schedules/:id/jobs`). */
|
|
779
779
|
export const scheduleJobSchema = z.object({
|
|
780
780
|
id: z.string().min(1),
|
|
781
781
|
scheduleId: z.string().min(1),
|
|
@@ -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 {};
|
package/dist/types/commands.d.ts
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
import type { SkillScope, SkillLevel } from './skills.js';
|
|
2
2
|
import type { PermissionConfig } from './permission.js';
|
|
3
3
|
/**
|
|
4
|
-
*
|
|
4
|
+
* ADR-046 §7: slash-команды и bundles — контракты. Здесь только типы (без
|
|
5
5
|
* бизнес-логики движка); резолвинг выполняется в core до обращения к LLM.
|
|
6
6
|
*/
|
|
7
|
-
/** Вид команды (
|
|
7
|
+
/** Вид команды (ADR-046 §7.2). */
|
|
8
8
|
export declare const COMMAND_KINDS: readonly ["builtin", "template", "skill", "bundle"];
|
|
9
9
|
export type CommandKind = (typeof COMMAND_KINDS)[number];
|
|
10
10
|
/** Режим разрешения конфликтов имён (настройка `commands.conflict.mode`). */
|
|
@@ -17,7 +17,7 @@ export type CommandActor = (typeof COMMAND_ACTORS)[number];
|
|
|
17
17
|
export type CommandDiagnosticLevel = 'error' | 'warning' | 'info';
|
|
18
18
|
/** Коды диагностики команд/бандлов (только реально эмитируемые). */
|
|
19
19
|
export type CommandIssueCode = 'invalid-frontmatter' | 'missing-name' | 'shadowed' | 'collision' | 'invalid-bundle' | 'missing-skill' | 'read-error'
|
|
20
|
-
/**
|
|
20
|
+
/** ADR-046 §4.4/§7.1: проектный каталог недоверенный — команда не грузится. */
|
|
21
21
|
| 'untrusted';
|
|
22
22
|
/** Диагностика реестра команд (видна в `GET /api/v2/commands?diagnostics=1`). */
|
|
23
23
|
export interface CommandDiagnostic {
|
|
@@ -30,7 +30,7 @@ export interface CommandDiagnostic {
|
|
|
30
30
|
path?: string;
|
|
31
31
|
}
|
|
32
32
|
/**
|
|
33
|
-
* YAML-группа скиллов (
|
|
33
|
+
* YAML-группа скиллов (ADR-046 §7.3). `/bundle-name` грузит N тел одним
|
|
34
34
|
* сообщением; bundle побеждает одноимённый skill.
|
|
35
35
|
*/
|
|
36
36
|
export interface SkillBundle {
|
|
@@ -59,7 +59,7 @@ export interface CommandSummary {
|
|
|
59
59
|
/** Статус результата резолвинга команды. */
|
|
60
60
|
export type CommandResolveStatus = 'builtin' | 'prompt' | 'template' | 'skill' | 'bundle' | 'summarization' | 'unknown' | 'denied' | 'unavailable';
|
|
61
61
|
/**
|
|
62
|
-
* Результат резолвинга `/`-команды (
|
|
62
|
+
* Результат резолвинга `/`-команды (ADR-046 §7.1).
|
|
63
63
|
*
|
|
64
64
|
* - `builtin` — локальный ответ (`output`), LLM не вызывается; user+assistant
|
|
65
65
|
* сообщения помечаются `ephemeral` и исключаются из LLM-контекста;
|
|
@@ -87,14 +87,14 @@ export interface CommandResolveResult {
|
|
|
87
87
|
/** Причина denied/unavailable. */
|
|
88
88
|
message?: string;
|
|
89
89
|
}
|
|
90
|
-
/**
|
|
90
|
+
/** ADR-046 §7.4: результат исполнения inline shell (`` !`cmd` ``). */
|
|
91
91
|
export interface CommandShellResult {
|
|
92
92
|
output: string;
|
|
93
93
|
isError: boolean;
|
|
94
94
|
}
|
|
95
95
|
/**
|
|
96
|
-
*
|
|
97
|
-
* само проходит `PermissionEvaluator` (
|
|
96
|
+
* ADR-046 §7.4: раннер inline shell. Оркестратор передаёт замыкание, которое
|
|
97
|
+
* само проходит `PermissionEvaluator` (ADR-029) и исполняет команду; сервис
|
|
98
98
|
* команд только вызывает его для подстановки `` !`cmd` ``.
|
|
99
99
|
*/
|
|
100
100
|
export type CommandShellRunner = (command: string) => Promise<CommandShellResult>;
|
|
@@ -109,11 +109,11 @@ export interface CommandRuntimeOpts {
|
|
|
109
109
|
sessionEnabled?: string[];
|
|
110
110
|
sessionDisabled?: string[];
|
|
111
111
|
permissionConfig?: PermissionConfig;
|
|
112
|
-
/**
|
|
112
|
+
/** ADR-046 §7.4: раннер inline shell (только при включённом `skills.inlineShell`). */
|
|
113
113
|
runShell?: CommandShellRunner;
|
|
114
114
|
}
|
|
115
115
|
/**
|
|
116
|
-
*
|
|
116
|
+
* ADR-046 §7.3: рантайм-контракт команд для оркестратора/CLI. Структурно
|
|
117
117
|
* реализуется `CommandService`; прокидывается в `OrchestratorOptions`.
|
|
118
118
|
*/
|
|
119
119
|
export interface CommandRuntime {
|