@itphx/synth-shared 0.10.0 → 0.11.3
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 +60 -14
- package/dist/config/env-overrides.d.ts +7 -4
- package/dist/config/env-overrides.js +46 -13
- package/dist/config/index.d.ts +3 -0
- package/dist/config/index.js +3 -0
- package/dist/config/loader.d.ts +2 -2
- package/dist/config/loader.js +23 -4
- package/dist/config/proxy.d.ts +415 -0
- package/dist/config/proxy.js +1565 -0
- package/dist/config/resolve.d.ts +77 -10
- package/dist/config/resolve.js +203 -17
- package/dist/config/tls-runtime.d.ts +78 -0
- package/dist/config/tls-runtime.js +356 -0
- package/dist/config/tls.d.ts +215 -0
- package/dist/config/tls.js +394 -0
- package/dist/config/types.d.ts +1820 -334
- package/dist/config/types.js +320 -54
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +18 -10
- package/dist/index.d.ts +11 -2
- package/dist/index.js +11 -2
- package/dist/interfaces/index.d.ts +3 -3
- package/dist/protocols/index.d.ts +0 -1
- package/dist/schemas/index.d.ts +230 -105
- package/dist/schemas/index.js +121 -74
- 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/analytics.d.ts +113 -0
- package/dist/types/analytics.js +61 -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/egress.d.ts +114 -0
- package/dist/types/egress.js +68 -0
- package/dist/types/events.d.ts +22 -23
- package/dist/types/fs.d.ts +55 -0
- package/dist/types/fs.js +27 -0
- package/dist/types/git.d.ts +63 -0
- package/dist/types/git.js +1 -0
- package/dist/types/hooks.d.ts +24 -4
- package/dist/types/index.d.ts +15 -1165
- package/dist/types/index.js +44 -244
- package/dist/types/llm.d.ts +32 -0
- package/dist/types/llm.js +8 -0
- package/dist/types/maintenance.d.ts +39 -0
- package/dist/types/maintenance.js +11 -0
- package/dist/types/mcp.d.ts +169 -0
- package/dist/types/mcp.js +119 -0
- package/dist/types/message.d.ts +63 -0
- package/dist/types/message.js +12 -0
- package/dist/types/permission.d.ts +9 -7
- 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 +237 -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 +268 -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 +6 -6
- 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.d.ts +15 -0
- package/dist/utils/index.js +55 -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, isKnownScope, isWebhookEventPattern, } 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, } 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,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({
|
|
@@ -76,7 +76,6 @@ export const sessionCreateSchema = z.object({
|
|
|
76
76
|
icon: projectIconKeySchema.optional().nullable(),
|
|
77
77
|
color: projectColorKeySchema.optional().nullable(),
|
|
78
78
|
projectId: z.string().optional(),
|
|
79
|
-
engine: z.enum(['synth', 'opencode', 'cline']).default('synth'),
|
|
80
79
|
settings: sessionSettingsSchema.optional(),
|
|
81
80
|
});
|
|
82
81
|
export const sessionUpdateSchema = z.object({
|
|
@@ -84,14 +83,13 @@ export const sessionUpdateSchema = z.object({
|
|
|
84
83
|
icon: projectIconKeySchema.optional().nullable(),
|
|
85
84
|
color: projectColorKeySchema.optional().nullable(),
|
|
86
85
|
projectId: z.string().optional(),
|
|
87
|
-
engine: z.enum(['synth', 'opencode', 'cline']).optional(),
|
|
88
86
|
// passthrough: настройки сессии содержат поля вне sessionSettingsSchema
|
|
89
87
|
// (mcpServers, routing*, microFirst, embedding*, permission, mcpToolSettings, llmGateway),
|
|
90
88
|
// их нельзя терять при PATCH — известные поля валидируются, неизвестные пропускаются.
|
|
91
89
|
settings: sessionSettingsSchema.partial().passthrough().optional(),
|
|
92
90
|
});
|
|
93
91
|
/**
|
|
94
|
-
*
|
|
92
|
+
* ADR-076: запись реестра git-репозиториев. `path` обязателен, остальные поля
|
|
95
93
|
* опциональны; старые формы (`string` / `{ path }`) принимаются через
|
|
96
94
|
* `normalizeGitRepoConfig` и union в `repos`.
|
|
97
95
|
*/
|
|
@@ -106,7 +104,7 @@ export const gitRepoConfigSchema = z.object({
|
|
|
106
104
|
lastFetch: z.string().optional(),
|
|
107
105
|
});
|
|
108
106
|
/**
|
|
109
|
-
*
|
|
107
|
+
* ADR-076: нормализация legacy-значения `repos` к `GitRepoConfig`.
|
|
110
108
|
* `string` → `{ path }`; объект → прогон через `gitRepoConfigSchema`
|
|
111
109
|
* (невалидный → `null`). Всё прочее → `null`.
|
|
112
110
|
*/
|
|
@@ -138,7 +136,7 @@ export const projectUpdateSchema = z.object({
|
|
|
138
136
|
workspace: z.string().optional(),
|
|
139
137
|
repos: z.array(z.union([z.string(), gitRepoConfigSchema])).optional(),
|
|
140
138
|
});
|
|
141
|
-
/**
|
|
139
|
+
/** ADR-076: тело создания SSH-ключа (`POST /api/v2/ssh-keys`). */
|
|
142
140
|
export const sshKeyCreateSchema = z.object({
|
|
143
141
|
name: z.string().min(1).max(200),
|
|
144
142
|
type: z.string().optional(),
|
|
@@ -146,10 +144,10 @@ export const sshKeyCreateSchema = z.object({
|
|
|
146
144
|
passphrase: z.string().optional(),
|
|
147
145
|
agentIds: z.array(z.string()).optional(),
|
|
148
146
|
});
|
|
149
|
-
/**
|
|
147
|
+
/** ADR-076: тело обновления SSH-ключа (без id/createdAt). */
|
|
150
148
|
export const sshKeyUpdateSchema = sshKeyCreateSchema.partial();
|
|
151
149
|
/**
|
|
152
|
-
*
|
|
150
|
+
* ADR-071 §2.4: проектный скоуп MCP (ссылки на реестр по имени).
|
|
153
151
|
* PUT-семантика: `undefined` ≠ `[]` — отсутствующее поле сохраняет текущее
|
|
154
152
|
* значение, поэтому `.default([])` здесь недопустим.
|
|
155
153
|
*/
|
|
@@ -158,7 +156,7 @@ export const projectMcpUpdateSchema = z.object({
|
|
|
158
156
|
defaultOn: z.array(z.string()).optional(),
|
|
159
157
|
});
|
|
160
158
|
/**
|
|
161
|
-
*
|
|
159
|
+
* ADR-075: тело `PUT /api/v2/settings/workspace-policy` — политика для
|
|
162
160
|
* абсолютного workspace вне `workspacesRoot`.
|
|
163
161
|
*/
|
|
164
162
|
export const workspacePolicySchema = z.object({
|
|
@@ -206,7 +204,7 @@ export const fsDownloadQuerySchema = z.object({
|
|
|
206
204
|
path: z.string().min(1),
|
|
207
205
|
});
|
|
208
206
|
/**
|
|
209
|
-
*
|
|
207
|
+
* ADR-075: запрос навигации по корню workspace (`GET /fs/workspace-root/browse`,
|
|
210
208
|
* `GET /fs/workspace-root`). `includeHidden` принимает строковые `true`/`false`
|
|
211
209
|
* (query-параметры) — `z.coerce.boolean()` не подходит, т.к. `'false'` → `true`.
|
|
212
210
|
*/
|
|
@@ -216,7 +214,7 @@ export const fsWorkspaceBrowseQuerySchema = z.object({
|
|
|
216
214
|
.preprocess((v) => (v === 'true' ? true : v === 'false' ? false : v), z.boolean().optional())
|
|
217
215
|
.default(false),
|
|
218
216
|
});
|
|
219
|
-
/**
|
|
217
|
+
/** ADR-075: тело `POST /fs/workspace-root/mkdir` — создание каталога в корне workspace. */
|
|
220
218
|
export const fsWorkspaceMkdirBodySchema = z.object({
|
|
221
219
|
path: z.string().min(1),
|
|
222
220
|
/** `confirm`-политика: явное подтверждение создания каталога вне `workspacesRoot`. */
|
|
@@ -242,7 +240,7 @@ export const gitCloneBodySchema = z.object({
|
|
|
242
240
|
sshKeyId: z.string().optional(),
|
|
243
241
|
});
|
|
244
242
|
/**
|
|
245
|
-
*
|
|
243
|
+
* ADR-076: тело `POST /api/v2/git/repos/register` — upsert записи реестра
|
|
246
244
|
* (идемпотентно по `path`). Используется UI для добавления уже существующего
|
|
247
245
|
* локально репозитория.
|
|
248
246
|
*/
|
|
@@ -256,7 +254,7 @@ export const gitReposRegisterBodySchema = z.object({
|
|
|
256
254
|
sshKeyId: z.string().optional(),
|
|
257
255
|
});
|
|
258
256
|
/**
|
|
259
|
-
*
|
|
257
|
+
* ADR-076: тело `POST /api/v2/git/repos/remove` — удаление записи реестра;
|
|
260
258
|
* обязателен `id` либо `path`. `deleteLocal` — удалить каталог репозитория.
|
|
261
259
|
*/
|
|
262
260
|
export const gitReposRemoveBodySchema = z
|
|
@@ -267,7 +265,7 @@ export const gitReposRemoveBodySchema = z
|
|
|
267
265
|
deleteLocal: z.boolean().optional(),
|
|
268
266
|
})
|
|
269
267
|
.refine((v) => Boolean(v.id || v.path), { message: 'Требуется id или path' });
|
|
270
|
-
/**
|
|
268
|
+
/** ADR-076: тело `POST /api/v2/git/repos/fetch` — обязателен `id` либо `path`. */
|
|
271
269
|
export const gitReposFetchBodySchema = z
|
|
272
270
|
.object({
|
|
273
271
|
projectId: z.string().min(1),
|
|
@@ -287,7 +285,7 @@ export const gitCommitQuerySchema = z.object({
|
|
|
287
285
|
});
|
|
288
286
|
const toolCapabilityValues = Object.values(ToolCapability);
|
|
289
287
|
/**
|
|
290
|
-
*
|
|
288
|
+
* ADR-071 §2.6: фабрика схемы `tools.disabled` (единый источник значений
|
|
291
289
|
* на базе `ToolCapability`).
|
|
292
290
|
*
|
|
293
291
|
* - `strictCapabilities: true` (API, `PUT /settings/tools-disabled`) — закрытый
|
|
@@ -306,14 +304,14 @@ export function createToolsDisabledSchema(strictCapabilities) {
|
|
|
306
304
|
});
|
|
307
305
|
}
|
|
308
306
|
/**
|
|
309
|
-
*
|
|
307
|
+
* ADR-071 §2.6: тело `PUT /api/v2/settings/tools-disabled`. Неизвестная
|
|
310
308
|
* capability — ошибка (закрытый набор: опечатка молча ничего не отключит).
|
|
311
309
|
* Имена инструментов принимаются как строки (реестр динамический — MCP-тулы
|
|
312
310
|
* регистрируются лениво); непустые.
|
|
313
311
|
*/
|
|
314
312
|
export const toolsDisabledSchema = createToolsDisabledSchema(true);
|
|
315
313
|
/**
|
|
316
|
-
*
|
|
314
|
+
* ADR-071 §2.4: базовый контракт MCP-скоупа сессии (ссылки на реестр по имени).
|
|
317
315
|
* `undefined` ≠ `[]`: отсутствующее поле сохраняет текущее значение.
|
|
318
316
|
*/
|
|
319
317
|
export const sessionMcpScopeSchema = z
|
|
@@ -323,7 +321,7 @@ export const sessionMcpScopeSchema = z
|
|
|
323
321
|
})
|
|
324
322
|
.refine((v) => v.mcpServers !== undefined || v.mcpDisabledServers !== undefined, { message: 'Требуется mcpServers или mcpDisabledServers' });
|
|
325
323
|
/**
|
|
326
|
-
*
|
|
324
|
+
* ADR-071 §2.4: тело `PUT /api/v2/sessions/:id/mcp`: точечный toggle
|
|
327
325
|
* (`{ name, enabled }`, в т.ч. opt-out системного сервера) или полная/частичная
|
|
328
326
|
* замена (`{ mcpServers?, mcpDisabledServers? }`).
|
|
329
327
|
*/
|
|
@@ -337,12 +335,12 @@ export const sessionMcpUpdateSchema = z
|
|
|
337
335
|
.refine((v) => v.name !== undefined
|
|
338
336
|
|| v.mcpServers !== undefined
|
|
339
337
|
|| v.mcpDisabledServers !== undefined, { message: 'Требуется name, mcpServers или mcpDisabledServers' });
|
|
340
|
-
// --- Скиллы (
|
|
341
|
-
/**
|
|
338
|
+
// --- Скиллы (ADR-046) ---
|
|
339
|
+
/** ADR-046 §3.2: имя скилла — 1–64, `^[a-z0-9]+(-[a-z0-9]+)*$`. */
|
|
342
340
|
export const SKILL_NAME_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
|
|
343
341
|
export const SKILL_NAME_MIN = 1;
|
|
344
342
|
export const SKILL_NAME_MAX = 64;
|
|
345
|
-
/**
|
|
343
|
+
/** ADR-046 §3.2: длина `description`. */
|
|
346
344
|
export const SKILL_DESCRIPTION_MIN = 1;
|
|
347
345
|
export const SKILL_DESCRIPTION_MAX = 1024;
|
|
348
346
|
export const skillNameSchema = z
|
|
@@ -370,29 +368,29 @@ export const skillFileWriteSchema = z.object({
|
|
|
370
368
|
content: z.string(),
|
|
371
369
|
});
|
|
372
370
|
/**
|
|
373
|
-
*
|
|
371
|
+
* ADR-046 §4.5: per-session enable/disable скиллов (по образцу MCP-скоупа).
|
|
374
372
|
* `undefined` ≠ `[]`: отсутствующее поле сохраняет текущее значение.
|
|
375
373
|
*/
|
|
376
374
|
export const skillSessionOverrideSchema = z.object({
|
|
377
375
|
skills: z.array(z.string()).optional(),
|
|
378
376
|
skillsDisabled: z.array(z.string()).optional(),
|
|
379
377
|
});
|
|
380
|
-
// --- Slash-команды и bundles (
|
|
381
|
-
/**
|
|
378
|
+
// --- Slash-команды и bundles (ADR-046 §7) ---
|
|
379
|
+
/** ADR-046 §7.3: тело `POST/PATCH /api/v2/skill-bundles` (YAML-группа скиллов). */
|
|
382
380
|
export const skillBundleSchema = z.object({
|
|
383
381
|
name: skillNameSchema,
|
|
384
382
|
description: z.string().min(SKILL_DESCRIPTION_MIN).max(SKILL_DESCRIPTION_MAX),
|
|
385
383
|
skills: z.array(skillNameSchema).min(1),
|
|
386
384
|
instruction: z.string().optional(),
|
|
387
385
|
});
|
|
388
|
-
/**
|
|
386
|
+
/** ADR-046 §7.4: тело `PUT /api/v2/settings/skills-disabled` (группы/имена). */
|
|
389
387
|
export const skillsDisabledSchema = z.object({
|
|
390
388
|
categories: z.array(z.string()).default([]),
|
|
391
389
|
groups: z.array(z.string()).default([]),
|
|
392
390
|
skills: z.array(z.string()).default([]),
|
|
393
391
|
});
|
|
394
392
|
/**
|
|
395
|
-
*
|
|
393
|
+
* ADR-046 §4.5: тело `PUT /api/v2/settings/skills` — системные настройки:
|
|
396
394
|
* - `disabled` — hard-gate: скиллы, недоступные НИГДЕ;
|
|
397
395
|
* - `disabledForNewProjects` — сид для НОВЫХ проектов (снимок при создании);
|
|
398
396
|
* - `policy` — политика доступности (строкой, валидируется роутом).
|
|
@@ -403,7 +401,7 @@ export const skillsSystemSettingsSchema = z.object({
|
|
|
403
401
|
policy: z.string().optional(),
|
|
404
402
|
});
|
|
405
403
|
/**
|
|
406
|
-
*
|
|
404
|
+
* ADR-046 §4.5: тело `PUT /api/v2/sessions/:id/skills`: точечный toggle
|
|
407
405
|
* (`{ name, enabled }`) или полная/частичная замена (`{ skills?, skillsDisabled? }`).
|
|
408
406
|
*/
|
|
409
407
|
export const sessionSkillUpdateSchema = z
|
|
@@ -416,20 +414,20 @@ export const sessionSkillUpdateSchema = z
|
|
|
416
414
|
.refine((v) => v.name !== undefined
|
|
417
415
|
|| v.skills !== undefined
|
|
418
416
|
|| v.skillsDisabled !== undefined, { message: 'Требуется name, skills или skillsDisabled' });
|
|
419
|
-
/**
|
|
417
|
+
/** ADR-046 §4.5: тело `PUT /api/v2/projects/:id/skills`. */
|
|
420
418
|
export const projectSkillUpdateSchema = z.object({
|
|
421
419
|
enabled: z.array(z.string()).optional(),
|
|
422
420
|
defaultOn: z.array(z.string()).optional(),
|
|
423
421
|
});
|
|
424
|
-
// --- Внешние события (
|
|
425
|
-
/**
|
|
422
|
+
// --- Внешние события (ADR-089) ---
|
|
423
|
+
/** ADR-089: схема идентичности отправителя внешнего события. */
|
|
426
424
|
export const eventIdentitySchema = z.object({
|
|
427
425
|
principalId: z.string().optional(),
|
|
428
426
|
chatKey: z.string().optional(),
|
|
429
427
|
threadKey: z.string().optional(),
|
|
430
428
|
roles: z.array(z.string()).optional(),
|
|
431
429
|
});
|
|
432
|
-
/**
|
|
430
|
+
/** ADR-089: схема нормализованного внешнего события (`payload` не типизируется). */
|
|
433
431
|
export const synthEventSchema = z.object({
|
|
434
432
|
id: z.string().min(1),
|
|
435
433
|
source: z.string().min(1),
|
|
@@ -439,9 +437,9 @@ export const synthEventSchema = z.object({
|
|
|
439
437
|
dedupKey: z.string().min(1),
|
|
440
438
|
ts: z.string().min(1),
|
|
441
439
|
});
|
|
442
|
-
/**
|
|
440
|
+
/** ADR-089: режимы доставки `EventBinding` (без `drop`). */
|
|
443
441
|
const eventDeliveryModeSchema = z.enum(['bound', 'ephemeral', 'queue']);
|
|
444
|
-
/**
|
|
442
|
+
/** ADR-089: схема устойчивой привязки внешнего адреса к сессии/шаблону. */
|
|
445
443
|
export const eventBindingSchema = z.object({
|
|
446
444
|
id: z.string().min(1),
|
|
447
445
|
source: z.string().min(1),
|
|
@@ -452,7 +450,7 @@ export const eventBindingSchema = z.object({
|
|
|
452
450
|
agentTemplate: z.string().optional(),
|
|
453
451
|
project: z.string().optional(),
|
|
454
452
|
});
|
|
455
|
-
/**
|
|
453
|
+
/** ADR-089: схема запроса создания/привязки сессии — единый funnel. */
|
|
456
454
|
export const sessionRequestSchema = z.object({
|
|
457
455
|
initiator: z.enum(['user', 'agent', 'external', 'system']),
|
|
458
456
|
intent: z.enum(['explicit', 'event']),
|
|
@@ -464,7 +462,6 @@ export const sessionRequestSchema = z.object({
|
|
|
464
462
|
title: z.string().optional(),
|
|
465
463
|
icon: projectIconKeySchema.optional(),
|
|
466
464
|
color: projectColorKeySchema.optional(),
|
|
467
|
-
engine: z.enum(['synth', 'opencode', 'cline']).optional(),
|
|
468
465
|
sessionOrigin: z.enum(['user', 'fork', 'subagent']).optional(),
|
|
469
466
|
// Настройки сессии валидируются собственной схемой при создании; здесь —
|
|
470
467
|
// толерантный контейнер, чтобы не дублировать SessionSettings.
|
|
@@ -473,7 +470,7 @@ export const sessionRequestSchema = z.object({
|
|
|
473
470
|
dedupKey: z.string().optional(),
|
|
474
471
|
});
|
|
475
472
|
/**
|
|
476
|
-
*
|
|
473
|
+
* ADR-089: вход приёма внешнего события (`POST /api/v2/events`). `id`/`dedupKey`/`ts`
|
|
477
474
|
* нормализуются `EventIngress`, поэтому здесь опциональны.
|
|
478
475
|
*/
|
|
479
476
|
export const eventIngestSchema = z.object({
|
|
@@ -484,7 +481,7 @@ export const eventIngestSchema = z.object({
|
|
|
484
481
|
dedupKey: z.string().optional(),
|
|
485
482
|
ts: z.string().optional(),
|
|
486
483
|
});
|
|
487
|
-
/**
|
|
484
|
+
/** ADR-089: вход upsert биндинга (`POST /api/v2/events/bindings`) — без `id`. */
|
|
488
485
|
export const eventBindingInputSchema = z.object({
|
|
489
486
|
source: z.string().min(1),
|
|
490
487
|
chatKey: z.string().optional(),
|
|
@@ -495,7 +492,7 @@ export const eventBindingInputSchema = z.object({
|
|
|
495
492
|
project: z.string().optional(),
|
|
496
493
|
});
|
|
497
494
|
/**
|
|
498
|
-
*
|
|
495
|
+
* ADR-089/ADR-052: метаданные API-ключа привязки для приёма событий.
|
|
499
496
|
* Секрет (`key`) и его хеш здесь отсутствуют — наружу не отдаются.
|
|
500
497
|
*/
|
|
501
498
|
export const eventBindingApiKeySchema = z.object({
|
|
@@ -508,11 +505,11 @@ export const eventBindingApiKeySchema = z.object({
|
|
|
508
505
|
createdAt: z.string().min(1),
|
|
509
506
|
lastUsedAt: z.string().optional(),
|
|
510
507
|
prefix: z.string().min(1),
|
|
511
|
-
//
|
|
508
|
+
// ADR-052 (задел): срок действия / отзыв ключа.
|
|
512
509
|
expiresAt: z.string().optional(),
|
|
513
510
|
revokedAt: z.string().optional(),
|
|
514
511
|
});
|
|
515
|
-
/**
|
|
512
|
+
/** ADR-089/ADR-052: тело создания API-ключа привязки — обязательная уникальная `label`. */
|
|
516
513
|
export const eventBindingApiKeyCreateSchema = z.object({
|
|
517
514
|
label: z.string().min(1),
|
|
518
515
|
description: z.string().optional(),
|
|
@@ -520,7 +517,7 @@ export const eventBindingApiKeyCreateSchema = z.object({
|
|
|
520
517
|
rateLimitPerMinute: z.number().int().min(0).optional(),
|
|
521
518
|
});
|
|
522
519
|
/**
|
|
523
|
-
*
|
|
520
|
+
* ADR-089/ADR-052: тело обновления API-ключа привязки. Все поля опциональны;
|
|
524
521
|
* `null` для `description`/`expiresAt`/`rateLimitPerMinute` — сброс значения.
|
|
525
522
|
*/
|
|
526
523
|
export const eventBindingApiKeyUpdateSchema = z.object({
|
|
@@ -529,18 +526,18 @@ export const eventBindingApiKeyUpdateSchema = z.object({
|
|
|
529
526
|
expiresAt: z.string().nullable().optional(),
|
|
530
527
|
rateLimitPerMinute: z.number().int().min(0).nullable().optional(),
|
|
531
528
|
});
|
|
532
|
-
/**
|
|
529
|
+
/** ADR-089: ответ создания ключа — метаданные + plaintext-секрет (единожды). */
|
|
533
530
|
export const eventBindingApiKeyCreatedSchema = eventBindingApiKeySchema.extend({
|
|
534
531
|
key: z.string().min(1),
|
|
535
532
|
});
|
|
536
533
|
/**
|
|
537
|
-
*
|
|
534
|
+
* ADR-089: вход `POST /events` при аутентификации API-ключом привязки. Как
|
|
538
535
|
* `eventIngestSchema`, но `source` опционален — источник берётся из привязки.
|
|
539
536
|
*/
|
|
540
537
|
export const eventKeyIngestSchema = eventIngestSchema.partial({ source: true });
|
|
541
|
-
// --- Service-key (
|
|
538
|
+
// --- Service-key (ADR-052, этап I) ---
|
|
542
539
|
/**
|
|
543
|
-
*
|
|
540
|
+
* ADR-052: каталог скоупов service-key + wildcard-семейства. Глобальный `*` не
|
|
544
541
|
* принимается (`isKnownScope`).
|
|
545
542
|
*/
|
|
546
543
|
export const serviceScopeSchema = z
|
|
@@ -549,7 +546,7 @@ export const serviceScopeSchema = z
|
|
|
549
546
|
.refine((value) => isKnownScope(value), { message: 'Неизвестный scope' });
|
|
550
547
|
const serviceScopesSchema = z.array(serviceScopeSchema).min(1);
|
|
551
548
|
/**
|
|
552
|
-
*
|
|
549
|
+
* ADR-052: метаданные service-key (ответы API). Секрет (`key`) и его хеш здесь
|
|
553
550
|
* отсутствуют — наружу не отдаются (в списке — `prefix`).
|
|
554
551
|
*/
|
|
555
552
|
export const serviceApiKeySchema = z.object({
|
|
@@ -567,7 +564,7 @@ export const serviceApiKeySchema = z.object({
|
|
|
567
564
|
lastUsedAt: z.string().optional(),
|
|
568
565
|
prefix: z.string().min(1),
|
|
569
566
|
});
|
|
570
|
-
/**
|
|
567
|
+
/** ADR-052: тело создания service-key. `roles` не заданы — дефолт хранилища. */
|
|
571
568
|
export const serviceApiKeyCreateSchema = z.object({
|
|
572
569
|
label: z.string().min(1),
|
|
573
570
|
description: z.string().optional(),
|
|
@@ -578,7 +575,7 @@ export const serviceApiKeyCreateSchema = z.object({
|
|
|
578
575
|
expiresAt: z.string().optional(),
|
|
579
576
|
});
|
|
580
577
|
/**
|
|
581
|
-
*
|
|
578
|
+
* ADR-052: тело обновления service-key. Все поля опциональны; `null` для
|
|
582
579
|
* `description`/`allowedProjects`/`rateLimitPerMinute`/`expiresAt` — сброс.
|
|
583
580
|
*/
|
|
584
581
|
export const serviceApiKeyUpdateSchema = z.object({
|
|
@@ -590,23 +587,23 @@ export const serviceApiKeyUpdateSchema = z.object({
|
|
|
590
587
|
rateLimitPerMinute: z.number().int().min(0).nullable().optional(),
|
|
591
588
|
expiresAt: z.string().nullable().optional(),
|
|
592
589
|
});
|
|
593
|
-
/**
|
|
590
|
+
/** ADR-052: ответ создания service-key — метаданные + plaintext-секрет (единожды). */
|
|
594
591
|
export const serviceApiKeyCreatedSchema = serviceApiKeySchema.extend({
|
|
595
592
|
key: z.string().min(1),
|
|
596
593
|
});
|
|
597
|
-
// --- Webhooks (
|
|
598
|
-
/**
|
|
594
|
+
// --- Webhooks (ADR-052, этап II) ---
|
|
595
|
+
/** ADR-052 (этап II): паттерн события подписки — exact либо `prefix.*`. */
|
|
599
596
|
export const webhookEventPatternSchema = z
|
|
600
597
|
.string()
|
|
601
598
|
.min(1)
|
|
602
599
|
.refine((value) => isWebhookEventPattern(value), { message: 'Некорректный паттерн события' });
|
|
603
|
-
/**
|
|
600
|
+
/** ADR-052 (этап II): целевой URL — только http/https (SSRF-политика — в core). */
|
|
604
601
|
export const webhookUrlSchema = z
|
|
605
602
|
.string()
|
|
606
603
|
.url()
|
|
607
604
|
.refine((value) => /^https?:\/\//i.test(value), { message: 'URL должен быть http(s)' });
|
|
608
605
|
/**
|
|
609
|
-
*
|
|
606
|
+
* ADR-052 (этап II): метаданные подписки (ответы API). Секрет (`secret`) и его
|
|
610
607
|
* хеш здесь отсутствуют — наружу не отдаются (в списке — `secretPrefix`).
|
|
611
608
|
*/
|
|
612
609
|
export const webhookSubscriptionSchema = z.object({
|
|
@@ -623,7 +620,7 @@ export const webhookSubscriptionSchema = z.object({
|
|
|
623
620
|
lastStatus: z.enum(['ok', 'failed']).optional(),
|
|
624
621
|
disabledAt: z.string().optional(),
|
|
625
622
|
});
|
|
626
|
-
/**
|
|
623
|
+
/** ADR-052 (этап II): тело создания подписки. `enabled` не задан — активна. */
|
|
627
624
|
export const webhookSubscriptionCreateSchema = z.object({
|
|
628
625
|
label: z.string().min(1),
|
|
629
626
|
description: z.string().optional(),
|
|
@@ -632,7 +629,7 @@ export const webhookSubscriptionCreateSchema = z.object({
|
|
|
632
629
|
enabled: z.boolean().optional(),
|
|
633
630
|
});
|
|
634
631
|
/**
|
|
635
|
-
*
|
|
632
|
+
* ADR-052 (этап II): тело обновления подписки. Все поля опциональны; `null` для
|
|
636
633
|
* `description` — сброс.
|
|
637
634
|
*/
|
|
638
635
|
export const webhookSubscriptionUpdateSchema = z.object({
|
|
@@ -642,11 +639,11 @@ export const webhookSubscriptionUpdateSchema = z.object({
|
|
|
642
639
|
events: z.array(webhookEventPatternSchema).optional(),
|
|
643
640
|
enabled: z.boolean().optional(),
|
|
644
641
|
});
|
|
645
|
-
/**
|
|
642
|
+
/** ADR-052 (этап II): ответ создания/ротации подписки — метаданные + секрет (единожды). */
|
|
646
643
|
export const webhookSubscriptionCreatedSchema = webhookSubscriptionSchema.extend({
|
|
647
644
|
secret: z.string().min(1),
|
|
648
645
|
});
|
|
649
|
-
/**
|
|
646
|
+
/** ADR-052 (этап II): запись журнала доставки. */
|
|
650
647
|
export const webhookDeliverySchema = z.object({
|
|
651
648
|
id: z.string().min(1),
|
|
652
649
|
subscriptionId: z.string().min(1),
|
|
@@ -658,7 +655,7 @@ export const webhookDeliverySchema = z.object({
|
|
|
658
655
|
createdAt: z.string().min(1),
|
|
659
656
|
completedAt: z.string().optional(),
|
|
660
657
|
});
|
|
661
|
-
/**
|
|
658
|
+
/** ADR-051/ADR-089: цель расписания (дискриминированный союз по `mode`). */
|
|
662
659
|
export const scheduleTargetSchema = z.discriminatedUnion('mode', [
|
|
663
660
|
z.object({ mode: z.literal('bound'), sessionId: z.string().min(1) }),
|
|
664
661
|
z.object({
|
|
@@ -670,7 +667,7 @@ export const scheduleTargetSchema = z.discriminatedUnion('mode', [
|
|
|
670
667
|
z.object({ mode: z.literal('queue'), sessionId: z.string().min(1) }),
|
|
671
668
|
]);
|
|
672
669
|
/**
|
|
673
|
-
*
|
|
670
|
+
* ADR-089: цель правила маршрутизации — дискриминированный союз по `mode`
|
|
674
671
|
* (семантика та же, что у `scheduleTargetSchema`).
|
|
675
672
|
*/
|
|
676
673
|
export const eventRouteTargetSchema = z.discriminatedUnion('mode', [
|
|
@@ -682,14 +679,14 @@ export const eventRouteTargetSchema = z.discriminatedUnion('mode', [
|
|
|
682
679
|
ttl: z.string().optional(),
|
|
683
680
|
}),
|
|
684
681
|
z.object({ mode: z.literal('queue'), sessionId: z.string().min(1) }),
|
|
685
|
-
//
|
|
682
|
+
// ADR-089 (auto-bind): цель закрепляет внешний адрес за сессией (binding создаёт Router).
|
|
686
683
|
z.object({
|
|
687
684
|
mode: z.literal('bind'),
|
|
688
685
|
agentTemplate: z.string().optional(),
|
|
689
686
|
project: z.string().optional(),
|
|
690
687
|
}),
|
|
691
688
|
]);
|
|
692
|
-
/**
|
|
689
|
+
/** ADR-089: условие срабатывания правила (AND по заполненным полям). */
|
|
693
690
|
export const eventRouteMatchSchema = z.object({
|
|
694
691
|
source: z.string().optional(),
|
|
695
692
|
type: z.string().optional(),
|
|
@@ -699,7 +696,7 @@ export const eventRouteMatchSchema = z.object({
|
|
|
699
696
|
label: z.string().optional(),
|
|
700
697
|
keywords: z.array(z.string()).optional(),
|
|
701
698
|
});
|
|
702
|
-
/**
|
|
699
|
+
/** ADR-089: полная сущность правила маршрутизации событий (ответы API). */
|
|
703
700
|
export const eventRouteRuleSchema = z.object({
|
|
704
701
|
id: z.string().min(1),
|
|
705
702
|
name: z.string().optional(),
|
|
@@ -708,7 +705,7 @@ export const eventRouteRuleSchema = z.object({
|
|
|
708
705
|
match: eventRouteMatchSchema,
|
|
709
706
|
target: eventRouteTargetSchema,
|
|
710
707
|
});
|
|
711
|
-
/**
|
|
708
|
+
/** ADR-089: вход создания/обновления правила (`upsert`) — без `id`. */
|
|
712
709
|
export const eventRouteRuleInputSchema = z.object({
|
|
713
710
|
name: z.string().optional(),
|
|
714
711
|
priority: z.number().int().default(0),
|
|
@@ -717,14 +714,14 @@ export const eventRouteRuleInputSchema = z.object({
|
|
|
717
714
|
target: eventRouteTargetSchema,
|
|
718
715
|
});
|
|
719
716
|
/**
|
|
720
|
-
*
|
|
717
|
+
* ADR-089: тело upsert-запроса правила — вход + необязательный `id` (обновление
|
|
721
718
|
* существующего правила; отсутствие — создание нового `rule_<uuid>`).
|
|
722
719
|
*/
|
|
723
720
|
export const eventRouteRuleUpsertSchema = eventRouteRuleInputSchema.extend({
|
|
724
721
|
id: z.string().optional(),
|
|
725
722
|
});
|
|
726
723
|
/**
|
|
727
|
-
*
|
|
724
|
+
* ADR-051/ADR-089: ровно одно из `cron` / `every` задано. Пустые строки
|
|
728
725
|
* трактуются как отсутствие поля.
|
|
729
726
|
*/
|
|
730
727
|
function refineScheduleTrigger(val, ctx) {
|
|
@@ -738,7 +735,7 @@ function refineScheduleTrigger(val, ctx) {
|
|
|
738
735
|
});
|
|
739
736
|
}
|
|
740
737
|
}
|
|
741
|
-
/**
|
|
738
|
+
/** ADR-051/ADR-089: вход создания/обновления расписания (`ScheduleInput`). */
|
|
742
739
|
export const scheduleInputSchema = z
|
|
743
740
|
.object({
|
|
744
741
|
name: z.string().min(1),
|
|
@@ -752,7 +749,7 @@ export const scheduleInputSchema = z
|
|
|
752
749
|
catchUp: z.enum(['skip', 'once']).optional(),
|
|
753
750
|
})
|
|
754
751
|
.superRefine(refineScheduleTrigger);
|
|
755
|
-
/**
|
|
752
|
+
/** ADR-051/ADR-089: полная сущность расписания (ответы API). */
|
|
756
753
|
export const scheduleSchema = z
|
|
757
754
|
.object({
|
|
758
755
|
id: z.string().min(1),
|
|
@@ -773,9 +770,9 @@ export const scheduleSchema = z
|
|
|
773
770
|
lastError: z.string().optional(),
|
|
774
771
|
})
|
|
775
772
|
.superRefine(refineScheduleTrigger);
|
|
776
|
-
/**
|
|
773
|
+
/** ADR-051: триггер срабатывания расписания в Job-истории. */
|
|
777
774
|
export const scheduleJobTriggerSchema = z.enum(['cron', 'manual', 'catchup']);
|
|
778
|
-
/**
|
|
775
|
+
/** ADR-051: запись Job-истории (ответы `GET /api/v2/schedules/:id/jobs`). */
|
|
779
776
|
export const scheduleJobSchema = z.object({
|
|
780
777
|
id: z.string().min(1),
|
|
781
778
|
scheduleId: z.string().min(1),
|
|
@@ -792,3 +789,53 @@ export const scheduleJobSchema = z.object({
|
|
|
792
789
|
sessionId: z.string().optional(),
|
|
793
790
|
error: z.string().optional(),
|
|
794
791
|
});
|
|
792
|
+
/** PROP-102: семейство роллапов аналитики (`usage`/`activity`/`decision`/`prompt`). */
|
|
793
|
+
export const analyticsFamilySchema = z.enum(ANALYTICS_FAMILIES);
|
|
794
|
+
/** PROP-102: ось измерения роллапа (`day`/`user`/`project`/`model`/`agent`/`provider`). */
|
|
795
|
+
export const analyticsDimensionSchema = z.enum(ANALYTICS_DIMENSIONS);
|
|
796
|
+
/** PROP-102: сутки UTC в формате `YYYY-MM-DD`. */
|
|
797
|
+
export const analyticsDaySchema = z.string().regex(/^\d{4}-\d{2}-\d{2}$/);
|
|
798
|
+
/** PROP-102: пред-агрегированный бакет роллапа (запись через порт хранения). */
|
|
799
|
+
export const analyticsRollupBucketSchema = z.object({
|
|
800
|
+
family: analyticsFamilySchema,
|
|
801
|
+
day: analyticsDaySchema,
|
|
802
|
+
dimensions: z.record(z.string(), z.string()).default({}),
|
|
803
|
+
measures: z.record(z.string(), z.number()),
|
|
804
|
+
costByCurrency: z.record(z.string(), z.number()).optional(),
|
|
805
|
+
});
|
|
806
|
+
/** PROP-102: запрос среза/серии роллапов (только чтение). */
|
|
807
|
+
export const analyticsRollupQuerySchema = z.object({
|
|
808
|
+
family: analyticsFamilySchema,
|
|
809
|
+
from: analyticsDaySchema.optional(),
|
|
810
|
+
to: analyticsDaySchema.optional(),
|
|
811
|
+
dimensions: z.record(z.string(), z.string()).optional(),
|
|
812
|
+
groupBy: z.array(analyticsDimensionSchema).optional(),
|
|
813
|
+
});
|
|
814
|
+
/**
|
|
815
|
+
* PROP-102: строка отчёта — оси группировки + меры (сырые счётчики и
|
|
816
|
+
* дериваты `ANALYTICS_DERIVED_MEASURES`). `costByCurrency` опускается, если пусто.
|
|
817
|
+
*/
|
|
818
|
+
export const analyticsReportRowSchema = z.object({
|
|
819
|
+
dimensions: z.record(z.string(), z.string()).default({}),
|
|
820
|
+
measures: z.record(z.string(), z.number()),
|
|
821
|
+
costByCurrency: z.record(z.string(), z.number()).optional(),
|
|
822
|
+
});
|
|
823
|
+
/** PROP-102: отчёт по семейству за период (только чтение, данные без i18n). */
|
|
824
|
+
export const analyticsReportSchema = z.object({
|
|
825
|
+
report: analyticsFamilySchema,
|
|
826
|
+
from: analyticsDaySchema,
|
|
827
|
+
to: analyticsDaySchema,
|
|
828
|
+
groupBy: z.array(analyticsDimensionSchema),
|
|
829
|
+
rows: z.array(analyticsReportRowSchema),
|
|
830
|
+
});
|
|
831
|
+
/** PROP-102: формат выгрузки отчёта (`csv`/`json`; только данные). */
|
|
832
|
+
export const analyticsExportFormatSchema = z.enum(ANALYTICS_EXPORT_FORMATS);
|
|
833
|
+
/** PROP-102: сводка инстанса за период — агрегаты `usage`/`activity`/`decision`. */
|
|
834
|
+
export const analyticsSummarySchema = z.object({
|
|
835
|
+
from: analyticsDaySchema,
|
|
836
|
+
to: analyticsDaySchema,
|
|
837
|
+
usage: z.record(z.string(), z.number()),
|
|
838
|
+
activity: z.record(z.string(), z.number()),
|
|
839
|
+
decision: z.record(z.string(), z.number()),
|
|
840
|
+
costByCurrency: z.record(z.string(), z.number()).optional(),
|
|
841
|
+
});
|
|
@@ -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 {};
|