@itphx/synth-shared 0.10.1 → 0.12.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 +172 -3
- package/dist/config/env-overrides.d.ts +33 -1
- package/dist/config/env-overrides.js +191 -5
- package/dist/config/execution.d.ts +66 -0
- package/dist/config/execution.js +146 -0
- package/dist/config/index.d.ts +4 -0
- package/dist/config/index.js +4 -0
- package/dist/config/loader.js +19 -0
- package/dist/config/proxy.d.ts +415 -0
- package/dist/config/proxy.js +1567 -0
- package/dist/config/resolve.d.ts +67 -0
- package/dist/config/resolve.js +187 -1
- 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 +1571 -2835
- package/dist/config/types.js +717 -58
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +279 -0
- package/dist/index.d.ts +24 -3
- package/dist/index.js +25 -2
- package/dist/model-metadata.d.ts +10 -0
- package/dist/protocols/index.d.ts +0 -1
- package/dist/schemas/index.d.ts +1014 -2231
- package/dist/schemas/index.js +222 -14
- package/dist/types/analytics.d.ts +113 -0
- package/dist/types/analytics.js +61 -0
- package/dist/types/authority.d.ts +464 -0
- package/dist/types/authority.js +445 -0
- package/dist/types/background.d.ts +96 -0
- package/dist/types/background.js +24 -0
- package/dist/types/bus-events.d.ts +23 -1
- package/dist/types/catalog.d.ts +349 -0
- package/dist/types/catalog.js +393 -0
- package/dist/types/decision.d.ts +28 -337
- package/dist/types/egress.d.ts +114 -0
- package/dist/types/egress.js +68 -0
- package/dist/types/events.d.ts +54 -2
- package/dist/types/external-credentials.d.ts +352 -0
- package/dist/types/external-credentials.js +200 -0
- package/dist/types/fs.d.ts +11 -0
- package/dist/types/fs.js +11 -0
- package/dist/types/hooks.d.ts +50 -9
- package/dist/types/index.d.ts +23 -0
- package/dist/types/index.js +55 -0
- package/dist/types/llm-filters.d.ts +150 -0
- package/dist/types/llm-filters.js +54 -0
- package/dist/types/maintenance.d.ts +39 -0
- package/dist/types/maintenance.js +11 -0
- package/dist/types/mcp.d.ts +101 -5
- package/dist/types/mcp.js +127 -5
- package/dist/types/message.d.ts +45 -1
- package/dist/types/pack.d.ts +1102 -0
- package/dist/types/pack.js +1003 -0
- package/dist/types/permission.d.ts +31 -15
- package/dist/types/permission.js +1 -1
- package/dist/types/pipeline-engine.d.ts +453 -0
- package/dist/types/pipeline-engine.js +440 -0
- package/dist/types/pipeline.d.ts +275 -0
- package/dist/types/pipeline.js +212 -0
- package/dist/types/plugin-audit.d.ts +110 -0
- package/dist/types/plugin-audit.js +185 -0
- package/dist/types/plugin-hybrid.d.ts +85 -0
- package/dist/types/plugin-hybrid.js +68 -0
- package/dist/types/plugin-lock.d.ts +95 -0
- package/dist/types/plugin-lock.js +1 -0
- package/dist/types/plugin-protocol.d.ts +221 -0
- package/dist/types/plugin-protocol.js +322 -0
- package/dist/types/plugin-runtime.d.ts +25 -0
- package/dist/types/plugin-runtime.js +11 -0
- package/dist/types/plugin-scan.d.ts +159 -0
- package/dist/types/plugin-scan.js +166 -0
- package/dist/types/plugin-tools.d.ts +51 -0
- package/dist/types/plugin-tools.js +72 -0
- package/dist/types/project.d.ts +14 -0
- package/dist/types/prompt-blocks.d.ts +102 -0
- package/dist/types/prompt-blocks.js +24 -0
- package/dist/types/prompt.d.ts +47 -4
- package/dist/types/provider.d.ts +11 -0
- package/dist/types/question.d.ts +153 -0
- package/dist/types/question.js +65 -0
- package/dist/types/schedules.d.ts +26 -3
- package/dist/types/semver.d.ts +48 -0
- package/dist/types/semver.js +218 -0
- package/dist/types/service-keys.d.ts +41 -3
- package/dist/types/service-keys.js +44 -2
- package/dist/types/session.d.ts +54 -1
- package/dist/types/steering.d.ts +74 -0
- package/dist/types/steering.js +75 -0
- package/dist/types/tools.d.ts +125 -5
- package/dist/types/tools.js +75 -0
- package/dist/types/trust.d.ts +31 -0
- package/dist/types/trust.js +27 -0
- package/dist/types/webhooks.d.ts +1 -1
- package/dist/types/worktree.d.ts +170 -0
- package/dist/types/worktree.js +101 -0
- package/dist/utils/index.d.ts +46 -1
- package/dist/utils/index.js +145 -12
- package/dist/utils/reasoning.d.ts +16 -0
- package/dist/utils/reasoning.js +37 -0
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +2 -2
package/dist/schemas/index.js
CHANGED
|
@@ -1,6 +1,15 @@
|
|
|
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, STEER_MODES, DEFAULT_STEER_MODE, } from '../types/index.js';
|
|
3
3
|
import { ToolCapability } from '../types/tools.js';
|
|
4
|
+
/**
|
|
5
|
+
* Экземпляр zod, которым построены **все** схемы этого пакета.
|
|
6
|
+
*
|
|
7
|
+
* В zod 4 `extendZodWithOpenApi` навешивает `.openapi()` на прототип
|
|
8
|
+
* **конкретного** экземпляра модуля (а не глобально). Потребителю, который
|
|
9
|
+
* расширяет zod (публичный OpenAPI в core), нужно расширять ровно тот экземпляр,
|
|
10
|
+
* которым созданы shared-схемы, — иначе у них не будет `.openapi()`.
|
|
11
|
+
*/
|
|
12
|
+
export { z as sharedZod };
|
|
4
13
|
export const messageRoleSchema = z.nativeEnum(MessageRole);
|
|
5
14
|
export const globalRoleSchema = z.nativeEnum(GlobalRole);
|
|
6
15
|
export const projectRoleSchema = z.nativeEnum(ProjectRole);
|
|
@@ -30,11 +39,53 @@ export function normalizeIconKey(value) {
|
|
|
30
39
|
export function normalizeColorKey(value) {
|
|
31
40
|
return isProjectColorKey(value) ? value : undefined;
|
|
32
41
|
}
|
|
42
|
+
/**
|
|
43
|
+
* ADR-106 Ф4: нормализация роли участника сессии. Каноническая роль → как
|
|
44
|
+
* есть; всё прочее — **fail-closed** (`viewer`, только чтение).
|
|
45
|
+
*/
|
|
46
|
+
export function normalizeSessionParticipantRole(value) {
|
|
47
|
+
if (value === 'owner' || value === 'editor' || value === 'viewer')
|
|
48
|
+
return value;
|
|
49
|
+
return 'viewer';
|
|
50
|
+
}
|
|
33
51
|
export const tokenUsageSchema = z.object({
|
|
34
52
|
inputTokens: z.number().int().min(0),
|
|
35
53
|
outputTokens: z.number().int().min(0),
|
|
36
54
|
totalTokens: z.number().int().min(0),
|
|
37
55
|
});
|
|
56
|
+
/**
|
|
57
|
+
* Снять у поля патча дефолт (`ZodDefault`/`ZodPrefault`), сохранив валидацию.
|
|
58
|
+
*
|
|
59
|
+
* zod 4 подставляет дефолт даже под `.optional()` (дефолт делает вход
|
|
60
|
+
* опциональным и применяется к `undefined`), поэтому «снять» его можно только
|
|
61
|
+
* развернув обёртку (`unwrap` есть у обоих типов). Пустое значение без обёртки —
|
|
62
|
+
* как есть.
|
|
63
|
+
*/
|
|
64
|
+
function withoutDefault(field) {
|
|
65
|
+
const type = field._zod?.def?.type;
|
|
66
|
+
if (type !== 'default' && type !== 'prefault')
|
|
67
|
+
return field;
|
|
68
|
+
const unwrap = field.unwrap;
|
|
69
|
+
return typeof unwrap === 'function' ? withoutDefault(unwrap.call(field)) : field;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Патч-схема объекта: как `.partial()`, но **без дефолтов**.
|
|
73
|
+
*
|
|
74
|
+
* Для PATCH отсутствующий ключ означает «не менять», а `.partial()` в zod 4
|
|
75
|
+
* протекает дефолтами: `pluginsConfigSchema.partial().parse({})` возвращает
|
|
76
|
+
* объект со всеми значениями по умолчанию, и частичный патч затирает чужие
|
|
77
|
+
* настройки. Поэтому поля берутся из `shape`, у каждого снимается дефолт и
|
|
78
|
+
* навешивается `.optional()`. Набор ключей и правила валидации остаются из
|
|
79
|
+
* исходной схемы (единственный источник правды). `.strict()` вызывается
|
|
80
|
+
* потребителем, если нужен отказ на неизвестный ключ.
|
|
81
|
+
*/
|
|
82
|
+
export function patchObjectSchema(schema) {
|
|
83
|
+
const patchShape = {};
|
|
84
|
+
for (const [key, field] of Object.entries(schema.shape)) {
|
|
85
|
+
patchShape[key] = withoutDefault(field).optional();
|
|
86
|
+
}
|
|
87
|
+
return z.object(patchShape);
|
|
88
|
+
}
|
|
38
89
|
export const sessionSettingsSchema = z.object({
|
|
39
90
|
provider: z.string().optional(),
|
|
40
91
|
model: z.string().optional(),
|
|
@@ -76,7 +127,6 @@ export const sessionCreateSchema = z.object({
|
|
|
76
127
|
icon: projectIconKeySchema.optional().nullable(),
|
|
77
128
|
color: projectColorKeySchema.optional().nullable(),
|
|
78
129
|
projectId: z.string().optional(),
|
|
79
|
-
engine: z.enum(['synth', 'opencode', 'cline']).default('synth'),
|
|
80
130
|
settings: sessionSettingsSchema.optional(),
|
|
81
131
|
});
|
|
82
132
|
export const sessionUpdateSchema = z.object({
|
|
@@ -84,11 +134,12 @@ export const sessionUpdateSchema = z.object({
|
|
|
84
134
|
icon: projectIconKeySchema.optional().nullable(),
|
|
85
135
|
color: projectColorKeySchema.optional().nullable(),
|
|
86
136
|
projectId: z.string().optional(),
|
|
87
|
-
engine: z.enum(['synth', 'opencode', 'cline']).optional(),
|
|
88
137
|
// passthrough: настройки сессии содержат поля вне sessionSettingsSchema
|
|
89
138
|
// (mcpServers, routing*, microFirst, embedding*, permission, mcpToolSettings, llmGateway),
|
|
90
139
|
// их нельзя терять при PATCH — известные поля валидируются, неизвестные пропускаются.
|
|
91
|
-
|
|
140
|
+
// `patchObjectSchema` (а не `.partial()`): отсутствующий ключ не должен получать
|
|
141
|
+
// дефолт из схемы — иначе PATCH сбрасывает настройки, которые не передавали.
|
|
142
|
+
settings: patchObjectSchema(sessionSettingsSchema).passthrough().optional(),
|
|
92
143
|
});
|
|
93
144
|
/**
|
|
94
145
|
* ADR-076: запись реестра git-репозиториев. `path` обязателен, остальные поля
|
|
@@ -128,6 +179,8 @@ export const projectCreateSchema = z.object({
|
|
|
128
179
|
workspace: z.string().optional(),
|
|
129
180
|
repos: z.array(z.union([z.string(), gitRepoConfigSchema])).optional(),
|
|
130
181
|
});
|
|
182
|
+
/** ADR-107: проектная политика памяти (undefined — не менять). */
|
|
183
|
+
export const projectMemoryUpdateSchema = z.object({ enabled: z.boolean().optional() });
|
|
131
184
|
export const projectUpdateSchema = z.object({
|
|
132
185
|
name: z.string().min(1).max(200).optional(),
|
|
133
186
|
description: z.string().optional(),
|
|
@@ -137,6 +190,7 @@ export const projectUpdateSchema = z.object({
|
|
|
137
190
|
color: projectColorKeySchema.optional().nullable(),
|
|
138
191
|
workspace: z.string().optional(),
|
|
139
192
|
repos: z.array(z.union([z.string(), gitRepoConfigSchema])).optional(),
|
|
193
|
+
memory: projectMemoryUpdateSchema.optional(),
|
|
140
194
|
});
|
|
141
195
|
/** ADR-076: тело создания SSH-ключа (`POST /api/v2/ssh-keys`). */
|
|
142
196
|
export const sshKeyCreateSchema = z.object({
|
|
@@ -172,6 +226,18 @@ export const promptRequestSchema = z.object({
|
|
|
172
226
|
provider: z.string().optional(),
|
|
173
227
|
agent: z.string().optional(),
|
|
174
228
|
system: z.string().optional(),
|
|
229
|
+
/**
|
|
230
|
+
* ADR-104: режим отправки. `queue` (по умолчанию) — прежнее поведение;
|
|
231
|
+
* `steer` — инъекция в активный ход без прерывания генерации;
|
|
232
|
+
* `interrupt` — прерывание текущей генерации с продолжением хода.
|
|
233
|
+
*/
|
|
234
|
+
mode: z.enum(STEER_MODES).default(DEFAULT_STEER_MODE),
|
|
235
|
+
/**
|
|
236
|
+
* ADR-115: пути объектов вложений в blob-хранилище (`attachments/<sha2>/<sha256>`),
|
|
237
|
+
* полученные из `POST /sessions/:id/attachments`. Аддитивное поле: без него
|
|
238
|
+
* поведение промпта прежнее. Порядок частей сообщения — текст, затем вложения.
|
|
239
|
+
*/
|
|
240
|
+
attachments: z.array(z.string().min(1)).max(50).optional(),
|
|
175
241
|
});
|
|
176
242
|
export const spaLoginSchema = z.object({
|
|
177
243
|
apiKey: z.string().min(1),
|
|
@@ -429,15 +495,38 @@ export const eventIdentitySchema = z.object({
|
|
|
429
495
|
threadKey: z.string().optional(),
|
|
430
496
|
roles: z.array(z.string()).optional(),
|
|
431
497
|
});
|
|
498
|
+
/**
|
|
499
|
+
* ADR-115 × ADR-089: ссылка на вложение внешнего события.
|
|
500
|
+
*
|
|
501
|
+
* `blobPath` ограничен контуром вложений (`attachments/…`) — через событие нельзя
|
|
502
|
+
* сослаться на произвольный объект blob-хранилища (артефакты, логи, скиллы).
|
|
503
|
+
* `sha256` — 64 hex-символа (content-addressed адрес), `mime`/`size` — непустые.
|
|
504
|
+
*/
|
|
505
|
+
export const eventAttachmentRefSchema = z.object({
|
|
506
|
+
blobPath: z
|
|
507
|
+
.string()
|
|
508
|
+
.min(1)
|
|
509
|
+
.max(512)
|
|
510
|
+
.regex(/^attachments\/[A-Za-z0-9][A-Za-z0-9._/-]*$/, 'blobPath должен быть внутри attachments/')
|
|
511
|
+
// `attachments/../…` формально проходит regex — сегменты `..` запрещены явно
|
|
512
|
+
// (паритет с `isAttachmentPath` ядра: ссылка не должна выходить из контура).
|
|
513
|
+
.refine((value) => !value.includes('..'), 'blobPath не должен содержать «..»'),
|
|
514
|
+
sha256: z.string().regex(/^[0-9a-f]{64}$/, 'sha256 должен быть 64 hex-символа'),
|
|
515
|
+
mime: z.string().min(1).max(255),
|
|
516
|
+
size: z.number().int().positive(),
|
|
517
|
+
name: z.string().min(1).max(200).optional(),
|
|
518
|
+
});
|
|
432
519
|
/** ADR-089: схема нормализованного внешнего события (`payload` не типизируется). */
|
|
433
520
|
export const synthEventSchema = z.object({
|
|
434
521
|
id: z.string().min(1),
|
|
435
522
|
source: z.string().min(1),
|
|
436
523
|
type: z.string().min(1),
|
|
437
524
|
payload: z.unknown(),
|
|
438
|
-
identity: eventIdentitySchema.
|
|
525
|
+
identity: eventIdentitySchema.prefault({}),
|
|
439
526
|
dedupKey: z.string().min(1),
|
|
440
527
|
ts: z.string().min(1),
|
|
528
|
+
// ADR-115 × ADR-089: ссылки на вложения (аддитивно).
|
|
529
|
+
attachments: z.array(eventAttachmentRefSchema).optional(),
|
|
441
530
|
});
|
|
442
531
|
/** ADR-089: режимы доставки `EventBinding` (без `drop`). */
|
|
443
532
|
const eventDeliveryModeSchema = z.enum(['bound', 'ephemeral', 'queue']);
|
|
@@ -464,7 +553,6 @@ export const sessionRequestSchema = z.object({
|
|
|
464
553
|
title: z.string().optional(),
|
|
465
554
|
icon: projectIconKeySchema.optional(),
|
|
466
555
|
color: projectColorKeySchema.optional(),
|
|
467
|
-
engine: z.enum(['synth', 'opencode', 'cline']).optional(),
|
|
468
556
|
sessionOrigin: z.enum(['user', 'fork', 'subagent']).optional(),
|
|
469
557
|
// Настройки сессии валидируются собственной схемой при создании; здесь —
|
|
470
558
|
// толерантный контейнер, чтобы не дублировать SessionSettings.
|
|
@@ -475,15 +563,35 @@ export const sessionRequestSchema = z.object({
|
|
|
475
563
|
/**
|
|
476
564
|
* ADR-089: вход приёма внешнего события (`POST /api/v2/events`). `id`/`dedupKey`/`ts`
|
|
477
565
|
* нормализуются `EventIngress`, поэтому здесь опциональны.
|
|
566
|
+
*
|
|
567
|
+
* ADR-115 × ADR-089: `attachments[]` — до 10 ссылок на вложения (жёсткий предел;
|
|
568
|
+
* фактический лимит `attachments.maxFilesPerMessage` проверяет ingress). Если
|
|
569
|
+
* вложения переданы, `dedupKey` **обязателен**: ключ идемпотентности по умолчанию
|
|
570
|
+
* строится из `payload` и для бинарного содержимого нестабилен.
|
|
478
571
|
*/
|
|
479
|
-
|
|
572
|
+
const eventIngestBaseSchema = z.object({
|
|
480
573
|
source: z.string().min(1),
|
|
481
574
|
type: z.string().min(1),
|
|
482
575
|
payload: z.unknown().optional(),
|
|
483
576
|
identity: eventIdentitySchema.optional(),
|
|
484
|
-
dedupKey: z.string().optional(),
|
|
577
|
+
dedupKey: z.string().min(1).optional(),
|
|
485
578
|
ts: z.string().optional(),
|
|
579
|
+
attachments: z.array(eventAttachmentRefSchema).max(10).optional(),
|
|
486
580
|
});
|
|
581
|
+
/**
|
|
582
|
+
* ADR-115 × ADR-089: вложения без явного `dedupKey` — отказ на уровне схемы
|
|
583
|
+
* (`400 VALIDATION_ERROR`), иначе дедуп-ключ зависел бы от содержимого вложений.
|
|
584
|
+
*/
|
|
585
|
+
function requireDedupKeyForAttachments(value, ctx) {
|
|
586
|
+
if (Array.isArray(value.attachments) && value.attachments.length > 0 && !value.dedupKey) {
|
|
587
|
+
ctx.addIssue({
|
|
588
|
+
code: 'custom',
|
|
589
|
+
path: ['dedupKey'],
|
|
590
|
+
message: 'attachments требуют явного dedupKey',
|
|
591
|
+
});
|
|
592
|
+
}
|
|
593
|
+
}
|
|
594
|
+
export const eventIngestSchema = eventIngestBaseSchema.superRefine(requireDedupKeyForAttachments);
|
|
487
595
|
/** ADR-089: вход upsert биндинга (`POST /api/v2/events/bindings`) — без `id`. */
|
|
488
596
|
export const eventBindingInputSchema = z.object({
|
|
489
597
|
source: z.string().min(1),
|
|
@@ -536,8 +644,11 @@ export const eventBindingApiKeyCreatedSchema = eventBindingApiKeySchema.extend({
|
|
|
536
644
|
/**
|
|
537
645
|
* ADR-089: вход `POST /events` при аутентификации API-ключом привязки. Как
|
|
538
646
|
* `eventIngestSchema`, но `source` опционален — источник берётся из привязки.
|
|
647
|
+
* ADR-115 × ADR-089: правило «вложения требуют `dedupKey`» действует и здесь.
|
|
539
648
|
*/
|
|
540
|
-
export const eventKeyIngestSchema =
|
|
649
|
+
export const eventKeyIngestSchema = eventIngestBaseSchema
|
|
650
|
+
.partial({ source: true })
|
|
651
|
+
.superRefine(requireDedupKeyForAttachments);
|
|
541
652
|
// --- Service-key (ADR-052, этап I) ---
|
|
542
653
|
/**
|
|
543
654
|
* ADR-052: каталог скоупов service-key + wildcard-семейства. Глобальный `*` не
|
|
@@ -668,25 +779,49 @@ export const scheduleTargetSchema = z.discriminatedUnion('mode', [
|
|
|
668
779
|
ttl: z.string().optional(),
|
|
669
780
|
}),
|
|
670
781
|
z.object({ mode: z.literal('queue'), sessionId: z.string().min(1) }),
|
|
782
|
+
// ADR-101: прямой запуск прогона пайплайна (событие в Router не публикуется).
|
|
783
|
+
z.object({
|
|
784
|
+
mode: z.literal('pipeline'),
|
|
785
|
+
projectId: z.string().min(1),
|
|
786
|
+
pipelineId: z.string().min(1),
|
|
787
|
+
version: z.number().int().min(1).optional(),
|
|
788
|
+
payload: z.record(z.string(), z.unknown()).optional(),
|
|
789
|
+
}),
|
|
671
790
|
]);
|
|
791
|
+
/**
|
|
792
|
+
* ADR-089: ссылка на шаг пайплайна — «эта сессия — шаг `step` пайплайна `id`».
|
|
793
|
+
* Допустима только в целях `ephemeral`/`bind` (там, где решение порождает
|
|
794
|
+
* сессию); в `bound`/`queue` сессия фиксирована — поле там отвергается.
|
|
795
|
+
*/
|
|
796
|
+
export const pipelineRefSchema = z.object({
|
|
797
|
+
id: z.string().min(1),
|
|
798
|
+
step: z.string().min(1),
|
|
799
|
+
});
|
|
672
800
|
/**
|
|
673
801
|
* ADR-089: цель правила маршрутизации — дискриминированный союз по `mode`
|
|
674
802
|
* (семантика та же, что у `scheduleTargetSchema`).
|
|
803
|
+
*
|
|
804
|
+
* `pipeline` (ссылка на шаг пайплайна) допустим только в `ephemeral`/`bind`;
|
|
805
|
+
* в `bound`/`queue` сессия фиксирована, поэтому варианты **строгие**
|
|
806
|
+
* (`.strict()`): лишние поля (в т.ч. `pipeline`) там **отвергаются**, а не
|
|
807
|
+
* игнорируются — иначе ошибка конфигурации правила проходила бы молча.
|
|
675
808
|
*/
|
|
676
809
|
export const eventRouteTargetSchema = z.discriminatedUnion('mode', [
|
|
677
|
-
z.object({ mode: z.literal('bound'), sessionId: z.string().min(1) }),
|
|
810
|
+
z.object({ mode: z.literal('bound'), sessionId: z.string().min(1) }).strict(),
|
|
678
811
|
z.object({
|
|
679
812
|
mode: z.literal('ephemeral'),
|
|
680
813
|
agentTemplate: z.string().optional(),
|
|
681
814
|
project: z.string().optional(),
|
|
682
815
|
ttl: z.string().optional(),
|
|
816
|
+
pipeline: pipelineRefSchema.optional(),
|
|
683
817
|
}),
|
|
684
|
-
z.object({ mode: z.literal('queue'), sessionId: z.string().min(1) }),
|
|
818
|
+
z.object({ mode: z.literal('queue'), sessionId: z.string().min(1) }).strict(),
|
|
685
819
|
// ADR-089 (auto-bind): цель закрепляет внешний адрес за сессией (binding создаёт Router).
|
|
686
820
|
z.object({
|
|
687
821
|
mode: z.literal('bind'),
|
|
688
822
|
agentTemplate: z.string().optional(),
|
|
689
823
|
project: z.string().optional(),
|
|
824
|
+
pipeline: pipelineRefSchema.optional(),
|
|
690
825
|
}),
|
|
691
826
|
]);
|
|
692
827
|
/** ADR-089: условие срабатывания правила (AND по заполненным полям). */
|
|
@@ -747,7 +882,7 @@ export const scheduleInputSchema = z
|
|
|
747
882
|
every: z.string().optional(),
|
|
748
883
|
target: scheduleTargetSchema,
|
|
749
884
|
prompt: z.string().optional(),
|
|
750
|
-
payload: z.record(z.unknown()).optional(),
|
|
885
|
+
payload: z.record(z.string(), z.unknown()).optional(),
|
|
751
886
|
ownerId: z.string().optional(),
|
|
752
887
|
catchUp: z.enum(['skip', 'once']).optional(),
|
|
753
888
|
})
|
|
@@ -762,7 +897,7 @@ export const scheduleSchema = z
|
|
|
762
897
|
every: z.string().optional(),
|
|
763
898
|
target: scheduleTargetSchema,
|
|
764
899
|
prompt: z.string().optional(),
|
|
765
|
-
payload: z.record(z.unknown()).optional(),
|
|
900
|
+
payload: z.record(z.string(), z.unknown()).optional(),
|
|
766
901
|
ownerId: z.string().optional(),
|
|
767
902
|
catchUp: z.enum(['skip', 'once']).optional(),
|
|
768
903
|
createdAt: z.string().min(1),
|
|
@@ -787,8 +922,81 @@ export const scheduleJobSchema = z.object({
|
|
|
787
922
|
durationMs: z.number(),
|
|
788
923
|
target: scheduleTargetSchema,
|
|
789
924
|
dedupKey: z.string().optional(),
|
|
790
|
-
|
|
925
|
+
// ADR-101: `pipeline` — пометка прямого запуска прогона (не решение Router).
|
|
926
|
+
decision: z.enum(['bound', 'queue', 'ephemeral', 'bind', 'drop', 'pipeline']).optional(),
|
|
791
927
|
reason: z.string().optional(),
|
|
792
928
|
sessionId: z.string().optional(),
|
|
929
|
+
pipelineId: z.string().optional(),
|
|
930
|
+
runId: z.string().optional(),
|
|
793
931
|
error: z.string().optional(),
|
|
794
932
|
});
|
|
933
|
+
/** ADR-102: семейство роллапов аналитики (`usage`/`activity`/`decision`/`prompt`). */
|
|
934
|
+
export const analyticsFamilySchema = z.enum(ANALYTICS_FAMILIES);
|
|
935
|
+
/** ADR-102: ось измерения роллапа (`day`/`user`/`project`/`model`/`agent`/`provider`). */
|
|
936
|
+
export const analyticsDimensionSchema = z.enum(ANALYTICS_DIMENSIONS);
|
|
937
|
+
/** ADR-102: сутки UTC в формате `YYYY-MM-DD`. */
|
|
938
|
+
export const analyticsDaySchema = z.string().regex(/^\d{4}-\d{2}-\d{2}$/);
|
|
939
|
+
/** ADR-102: пред-агрегированный бакет роллапа (запись через порт хранения). */
|
|
940
|
+
export const analyticsRollupBucketSchema = z.object({
|
|
941
|
+
family: analyticsFamilySchema,
|
|
942
|
+
day: analyticsDaySchema,
|
|
943
|
+
dimensions: z.record(z.string(), z.string()).prefault({}),
|
|
944
|
+
measures: z.record(z.string(), z.number()),
|
|
945
|
+
costByCurrency: z.record(z.string(), z.number()).optional(),
|
|
946
|
+
});
|
|
947
|
+
/** ADR-102: запрос среза/серии роллапов (только чтение). */
|
|
948
|
+
export const analyticsRollupQuerySchema = z.object({
|
|
949
|
+
family: analyticsFamilySchema,
|
|
950
|
+
from: analyticsDaySchema.optional(),
|
|
951
|
+
to: analyticsDaySchema.optional(),
|
|
952
|
+
dimensions: z.record(z.string(), z.string()).optional(),
|
|
953
|
+
groupBy: z.array(analyticsDimensionSchema).optional(),
|
|
954
|
+
});
|
|
955
|
+
/**
|
|
956
|
+
* ADR-102: строка отчёта — оси группировки + меры (сырые счётчики и
|
|
957
|
+
* дериваты `ANALYTICS_DERIVED_MEASURES`). `costByCurrency` опускается, если пусто.
|
|
958
|
+
*/
|
|
959
|
+
export const analyticsReportRowSchema = z.object({
|
|
960
|
+
dimensions: z.record(z.string(), z.string()).prefault({}),
|
|
961
|
+
measures: z.record(z.string(), z.number()),
|
|
962
|
+
costByCurrency: z.record(z.string(), z.number()).optional(),
|
|
963
|
+
});
|
|
964
|
+
/** ADR-102: отчёт по семейству за период (только чтение, данные без i18n). */
|
|
965
|
+
export const analyticsReportSchema = z.object({
|
|
966
|
+
report: analyticsFamilySchema,
|
|
967
|
+
from: analyticsDaySchema,
|
|
968
|
+
to: analyticsDaySchema,
|
|
969
|
+
groupBy: z.array(analyticsDimensionSchema),
|
|
970
|
+
rows: z.array(analyticsReportRowSchema),
|
|
971
|
+
});
|
|
972
|
+
/** ADR-102: формат выгрузки отчёта (`csv`/`json`; только данные). */
|
|
973
|
+
export const analyticsExportFormatSchema = z.enum(ANALYTICS_EXPORT_FORMATS);
|
|
974
|
+
/** ADR-102: сводка инстанса за период — агрегаты `usage`/`activity`/`decision`. */
|
|
975
|
+
export const analyticsSummarySchema = z.object({
|
|
976
|
+
from: analyticsDaySchema,
|
|
977
|
+
to: analyticsDaySchema,
|
|
978
|
+
usage: z.record(z.string(), z.number()),
|
|
979
|
+
activity: z.record(z.string(), z.number()),
|
|
980
|
+
decision: z.record(z.string(), z.number()),
|
|
981
|
+
costByCurrency: z.record(z.string(), z.number()).optional(),
|
|
982
|
+
});
|
|
983
|
+
// --- Медиа-часть сообщения (ADR-115) ---
|
|
984
|
+
/** Медиа-типы части сообщения (ADR-115) — вложение. */
|
|
985
|
+
export const mediaPartTypeSchema = z.enum(['image', 'audio', 'video', 'file']);
|
|
986
|
+
/**
|
|
987
|
+
* ADR-115 §«Модель контента»: данные медиа-части — ссылка на blob в
|
|
988
|
+
* blob-хранилище + метаданные. Обязательны `blobPath`/`sha256`/`mime`/`size`;
|
|
989
|
+
* остальное — необязательные метаданные (имя, размеры, длительность,
|
|
990
|
+
* текстовая расшифровка).
|
|
991
|
+
*/
|
|
992
|
+
export const mediaPartSchema = z.object({
|
|
993
|
+
blobPath: z.string().min(1),
|
|
994
|
+
sha256: z.string().min(1),
|
|
995
|
+
mime: z.string().min(1),
|
|
996
|
+
size: z.number().int().min(0),
|
|
997
|
+
name: z.string().optional(),
|
|
998
|
+
width: z.number().int().min(0).optional(),
|
|
999
|
+
height: z.number().int().min(0).optional(),
|
|
1000
|
+
durationMs: z.number().int().min(0).optional(),
|
|
1001
|
+
transcript: z.string().optional(),
|
|
1002
|
+
});
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-102: аналитика и отчётность инстанса — контракт пред-агрегированных
|
|
3
|
+
* суточных роллапов.
|
|
4
|
+
*
|
|
5
|
+
* Единица роллапа — **сутки в UTC**. Хранилище держит **сырые счётчики**
|
|
6
|
+
* (`measures` + `costByCurrency`); дериваты (`cache_hit_rate`, `output_tps`,
|
|
7
|
+
* итоги по валютам) считает сервис на чтении. Роллапы агрегированы: текстов
|
|
8
|
+
* сообщений, содержимого промптов, ключей и PII в значениях нет.
|
|
9
|
+
*/
|
|
10
|
+
/** Семейства роллапов (ADR-102 §2). */
|
|
11
|
+
export declare const ANALYTICS_FAMILIES: readonly ["usage", "activity", "decision", "prompt"];
|
|
12
|
+
export type AnalyticsFamily = (typeof ANALYTICS_FAMILIES)[number];
|
|
13
|
+
/**
|
|
14
|
+
* Оси измерений роллапа. Короткие ключи `dimensions`; `day` — отдельное поле
|
|
15
|
+
* бакета (`AnalyticsRollupBucket.day`), но участвует в фильтрах и группировке.
|
|
16
|
+
*/
|
|
17
|
+
export declare const ANALYTICS_DIMENSIONS: readonly ["day", "user", "project", "model", "agent", "provider"];
|
|
18
|
+
export type AnalyticsDimension = (typeof ANALYTICS_DIMENSIONS)[number];
|
|
19
|
+
/**
|
|
20
|
+
* Известные меры по семействам. Имена — snake_case (как в `sessions/stats.ts`:
|
|
21
|
+
* `input_tokens`/`output_tokens`/`cost_usd`/…). Список — подсказка/валидация
|
|
22
|
+
* уровня домена: хранилище неизвестные числовые меры не отбрасывает.
|
|
23
|
+
*/
|
|
24
|
+
export declare const ANALYTICS_MEASURES_BY_FAMILY: {
|
|
25
|
+
readonly usage: readonly ["input_tokens", "output_tokens", "cache_read_tokens", "cache_write_tokens", "reasoning_tokens", "requests", "messages", "duration_ms"];
|
|
26
|
+
readonly activity: readonly ["sessions_created", "sessions_archived", "messages_user", "messages_assistant", "messages_tool", "tool_calls", "errors", "aborts", "turns"];
|
|
27
|
+
readonly decision: readonly ["calls", "handled", "fallback", "escalated", "attempts", "rejected"];
|
|
28
|
+
readonly prompt: readonly [];
|
|
29
|
+
};
|
|
30
|
+
/**
|
|
31
|
+
* Пред-агрегированный бакет роллапа. Ключ — `(family, day, dimensions)`
|
|
32
|
+
* (измерения в отсортированном порядке). `increment` — upsert с суммированием,
|
|
33
|
+
* `set` — точная перезапись.
|
|
34
|
+
*/
|
|
35
|
+
export interface AnalyticsRollupBucket {
|
|
36
|
+
family: AnalyticsFamily;
|
|
37
|
+
/** Сутки UTC в формате `YYYY-MM-DD`. */
|
|
38
|
+
day: string;
|
|
39
|
+
/** Значения осей (короткие ключи `AnalyticsDimension`); `day` — отдельное поле. */
|
|
40
|
+
dimensions: Record<string, string>;
|
|
41
|
+
/** Сырые счётчики (snake_case); неизвестные меры сохраняются как есть. */
|
|
42
|
+
measures: Record<string, number>;
|
|
43
|
+
/** Разбивка стоимости по валютам; пустая — поле опускается. */
|
|
44
|
+
costByCurrency?: Record<string, number>;
|
|
45
|
+
}
|
|
46
|
+
/** Запрос среза/серии роллапов: фильтры (семейство/период/оси) + группировка. */
|
|
47
|
+
export interface AnalyticsRollupQuery {
|
|
48
|
+
family: AnalyticsFamily;
|
|
49
|
+
/** Начало периода включительно (`YYYY-MM-DD`, сравнение по строке). */
|
|
50
|
+
from?: string;
|
|
51
|
+
/** Конец периода включительно (`YYYY-MM-DD`). */
|
|
52
|
+
to?: string;
|
|
53
|
+
/** Фильтр по равенству значений осей; для `day` — сравнение с `bucket.day`. */
|
|
54
|
+
dimensions?: Partial<Record<AnalyticsDimension, string>>;
|
|
55
|
+
/** Оси группировки; пусто/не задано — одна итоговая строка (`dimensions: {}`). */
|
|
56
|
+
groupBy?: AnalyticsDimension[];
|
|
57
|
+
}
|
|
58
|
+
/** Строка агрегированного ответа: значения осей группировки + суммы мер. */
|
|
59
|
+
export interface AnalyticsRollupRow {
|
|
60
|
+
/** Значения осей группировки (пусто — итог). */
|
|
61
|
+
dimensions: Record<string, string>;
|
|
62
|
+
measures: Record<string, number>;
|
|
63
|
+
/** Разбивка стоимости по валютам; пустая — поле опускается. */
|
|
64
|
+
costByCurrency?: Record<string, number>;
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Дериваты, которые сервис считает **на чтении** из сырых счётчиков (не
|
|
68
|
+
* персистятся, ADR-102 §2). В строке отчёта лежат рядом с сырыми мерами; при
|
|
69
|
+
* экспорте выносятся отдельными колонками после сырых мер.
|
|
70
|
+
*/
|
|
71
|
+
export declare const ANALYTICS_DERIVED_MEASURES: readonly ["total_tokens", "cache_hit_rate", "reasoning_ratio", "output_tps"];
|
|
72
|
+
export type AnalyticsDerivedMeasure = (typeof ANALYTICS_DERIVED_MEASURES)[number];
|
|
73
|
+
/** Идентификатор отчёта — совпадает с семейством роллапов (ADR-102 §4). */
|
|
74
|
+
export type AnalyticsReportKind = AnalyticsFamily;
|
|
75
|
+
/** Строка отчёта: оси группировки + меры (в т.ч. дериваты) + стоимость. */
|
|
76
|
+
export interface AnalyticsReportRow {
|
|
77
|
+
/** Значения осей группировки (пусто — итог). */
|
|
78
|
+
dimensions: Record<string, string>;
|
|
79
|
+
/** Меры: сырые счётчики + дериваты (`ANALYTICS_DERIVED_MEASURES`). */
|
|
80
|
+
measures: Record<string, number>;
|
|
81
|
+
/** Разбивка стоимости по валютам; пустая — поле опускается. */
|
|
82
|
+
costByCurrency?: Record<string, number>;
|
|
83
|
+
}
|
|
84
|
+
/** Отчёт по семейству за период (только чтение, ADR-102 §4). */
|
|
85
|
+
export interface AnalyticsReport {
|
|
86
|
+
report: AnalyticsReportKind;
|
|
87
|
+
/** Начало периода включительно (`YYYY-MM-DD`, UTC). */
|
|
88
|
+
from: string;
|
|
89
|
+
/** Конец периода включительно (`YYYY-MM-DD`, UTC). */
|
|
90
|
+
to: string;
|
|
91
|
+
/** Оси группировки (порядок важен для экспорта). */
|
|
92
|
+
groupBy: AnalyticsDimension[];
|
|
93
|
+
rows: AnalyticsReportRow[];
|
|
94
|
+
}
|
|
95
|
+
/** Формат выгрузки отчёта (server-side, только данные — ADR-102 §6). */
|
|
96
|
+
export declare const ANALYTICS_EXPORT_FORMATS: readonly ["csv", "json"];
|
|
97
|
+
export type AnalyticsExportFormat = (typeof ANALYTICS_EXPORT_FORMATS)[number];
|
|
98
|
+
/**
|
|
99
|
+
* Сводка инстанса за период: агрегаты по семействам (меры usage с дериватами,
|
|
100
|
+
* меры activity и decision — своими словарями). Без персональных данных.
|
|
101
|
+
*/
|
|
102
|
+
export interface AnalyticsSummary {
|
|
103
|
+
from: string;
|
|
104
|
+
to: string;
|
|
105
|
+
/** Меры `usage` (в т.ч. дериваты) — итог по периоду. */
|
|
106
|
+
usage: Record<string, number>;
|
|
107
|
+
/** Меры `activity` — итог по периоду. */
|
|
108
|
+
activity: Record<string, number>;
|
|
109
|
+
/** Меры `decision` — итог по периоду. */
|
|
110
|
+
decision: Record<string, number>;
|
|
111
|
+
/** Итоговая стоимость по валютам; пустая — поле опускается. */
|
|
112
|
+
costByCurrency?: Record<string, number>;
|
|
113
|
+
}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-102: аналитика и отчётность инстанса — контракт пред-агрегированных
|
|
3
|
+
* суточных роллапов.
|
|
4
|
+
*
|
|
5
|
+
* Единица роллапа — **сутки в UTC**. Хранилище держит **сырые счётчики**
|
|
6
|
+
* (`measures` + `costByCurrency`); дериваты (`cache_hit_rate`, `output_tps`,
|
|
7
|
+
* итоги по валютам) считает сервис на чтении. Роллапы агрегированы: текстов
|
|
8
|
+
* сообщений, содержимого промптов, ключей и PII в значениях нет.
|
|
9
|
+
*/
|
|
10
|
+
/** Семейства роллапов (ADR-102 §2). */
|
|
11
|
+
export const ANALYTICS_FAMILIES = ['usage', 'activity', 'decision', 'prompt'];
|
|
12
|
+
/**
|
|
13
|
+
* Оси измерений роллапа. Короткие ключи `dimensions`; `day` — отдельное поле
|
|
14
|
+
* бакета (`AnalyticsRollupBucket.day`), но участвует в фильтрах и группировке.
|
|
15
|
+
*/
|
|
16
|
+
export const ANALYTICS_DIMENSIONS = ['day', 'user', 'project', 'model', 'agent', 'provider'];
|
|
17
|
+
/**
|
|
18
|
+
* Известные меры по семействам. Имена — snake_case (как в `sessions/stats.ts`:
|
|
19
|
+
* `input_tokens`/`output_tokens`/`cost_usd`/…). Список — подсказка/валидация
|
|
20
|
+
* уровня домена: хранилище неизвестные числовые меры не отбрасывает.
|
|
21
|
+
*/
|
|
22
|
+
export const ANALYTICS_MEASURES_BY_FAMILY = {
|
|
23
|
+
usage: [
|
|
24
|
+
'input_tokens',
|
|
25
|
+
'output_tokens',
|
|
26
|
+
'cache_read_tokens',
|
|
27
|
+
'cache_write_tokens',
|
|
28
|
+
'reasoning_tokens',
|
|
29
|
+
'requests',
|
|
30
|
+
'messages',
|
|
31
|
+
'duration_ms',
|
|
32
|
+
],
|
|
33
|
+
activity: [
|
|
34
|
+
'sessions_created',
|
|
35
|
+
'sessions_archived',
|
|
36
|
+
'messages_user',
|
|
37
|
+
'messages_assistant',
|
|
38
|
+
'messages_tool',
|
|
39
|
+
'tool_calls',
|
|
40
|
+
'errors',
|
|
41
|
+
'aborts',
|
|
42
|
+
'turns',
|
|
43
|
+
],
|
|
44
|
+
// Персистентная замена in-memory снимка `decisionMetrics` (ADR-084); модель — ось, `by_model` не дублируется.
|
|
45
|
+
decision: ['calls', 'handled', 'fallback', 'escalated', 'attempts', 'rejected'],
|
|
46
|
+
// `prompt` — производные от `usage` (`cache_hit_rate`, доля reasoning, output tps): отдельной записи не требует.
|
|
47
|
+
prompt: [],
|
|
48
|
+
};
|
|
49
|
+
/**
|
|
50
|
+
* Дериваты, которые сервис считает **на чтении** из сырых счётчиков (не
|
|
51
|
+
* персистятся, ADR-102 §2). В строке отчёта лежат рядом с сырыми мерами; при
|
|
52
|
+
* экспорте выносятся отдельными колонками после сырых мер.
|
|
53
|
+
*/
|
|
54
|
+
export const ANALYTICS_DERIVED_MEASURES = [
|
|
55
|
+
'total_tokens',
|
|
56
|
+
'cache_hit_rate',
|
|
57
|
+
'reasoning_ratio',
|
|
58
|
+
'output_tps',
|
|
59
|
+
];
|
|
60
|
+
/** Формат выгрузки отчёта (server-side, только данные — ADR-102 §6). */
|
|
61
|
+
export const ANALYTICS_EXPORT_FORMATS = ['csv', 'json'];
|