@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.
Files changed (83) hide show
  1. package/dist/config/defaults.js +60 -14
  2. package/dist/config/env-overrides.d.ts +7 -4
  3. package/dist/config/env-overrides.js +46 -13
  4. package/dist/config/index.d.ts +3 -0
  5. package/dist/config/index.js +3 -0
  6. package/dist/config/loader.d.ts +2 -2
  7. package/dist/config/loader.js +23 -4
  8. package/dist/config/proxy.d.ts +415 -0
  9. package/dist/config/proxy.js +1565 -0
  10. package/dist/config/resolve.d.ts +77 -10
  11. package/dist/config/resolve.js +203 -17
  12. package/dist/config/tls-runtime.d.ts +78 -0
  13. package/dist/config/tls-runtime.js +356 -0
  14. package/dist/config/tls.d.ts +215 -0
  15. package/dist/config/tls.js +394 -0
  16. package/dist/config/types.d.ts +1820 -334
  17. package/dist/config/types.js +320 -54
  18. package/dist/i18n/index.d.ts +1 -1
  19. package/dist/i18n/index.js +18 -10
  20. package/dist/index.d.ts +11 -2
  21. package/dist/index.js +11 -2
  22. package/dist/interfaces/index.d.ts +3 -3
  23. package/dist/protocols/index.d.ts +0 -1
  24. package/dist/schemas/index.d.ts +230 -105
  25. package/dist/schemas/index.js +121 -74
  26. package/dist/skills/frontmatter.js +1 -1
  27. package/dist/types/agent.d.ts +30 -0
  28. package/dist/types/agent.js +1 -0
  29. package/dist/types/analytics.d.ts +113 -0
  30. package/dist/types/analytics.js +61 -0
  31. package/dist/types/bus-events.d.ts +7 -0
  32. package/dist/types/bus-events.js +1 -0
  33. package/dist/types/commands.d.ts +10 -10
  34. package/dist/types/commands.js +2 -2
  35. package/dist/types/decision.d.ts +16 -16
  36. package/dist/types/decision.js +4 -4
  37. package/dist/types/egress.d.ts +114 -0
  38. package/dist/types/egress.js +68 -0
  39. package/dist/types/events.d.ts +22 -23
  40. package/dist/types/fs.d.ts +55 -0
  41. package/dist/types/fs.js +27 -0
  42. package/dist/types/git.d.ts +63 -0
  43. package/dist/types/git.js +1 -0
  44. package/dist/types/hooks.d.ts +24 -4
  45. package/dist/types/index.d.ts +15 -1165
  46. package/dist/types/index.js +44 -244
  47. package/dist/types/llm.d.ts +32 -0
  48. package/dist/types/llm.js +8 -0
  49. package/dist/types/maintenance.d.ts +39 -0
  50. package/dist/types/maintenance.js +11 -0
  51. package/dist/types/mcp.d.ts +169 -0
  52. package/dist/types/mcp.js +119 -0
  53. package/dist/types/message.d.ts +63 -0
  54. package/dist/types/message.js +12 -0
  55. package/dist/types/permission.d.ts +9 -7
  56. package/dist/types/permission.js +1 -1
  57. package/dist/types/project.d.ts +134 -0
  58. package/dist/types/project.js +67 -0
  59. package/dist/types/prompt.d.ts +237 -0
  60. package/dist/types/prompt.js +15 -0
  61. package/dist/types/provider.d.ts +84 -0
  62. package/dist/types/provider.js +35 -0
  63. package/dist/types/schedules.d.ts +8 -8
  64. package/dist/types/schedules.js +1 -1
  65. package/dist/types/service-keys.d.ts +10 -10
  66. package/dist/types/service-keys.js +3 -3
  67. package/dist/types/session.d.ts +268 -0
  68. package/dist/types/session.js +13 -0
  69. package/dist/types/skills.d.ts +11 -11
  70. package/dist/types/skills.js +6 -6
  71. package/dist/types/tools.d.ts +3 -3
  72. package/dist/types/user.d.ts +113 -0
  73. package/dist/types/user.js +31 -0
  74. package/dist/types/webhooks.d.ts +6 -6
  75. package/dist/types/webhooks.js +1 -1
  76. package/dist/utils/glob.d.ts +1 -1
  77. package/dist/utils/glob.js +1 -1
  78. package/dist/utils/index.d.ts +15 -0
  79. package/dist/utils/index.js +55 -2
  80. package/dist/utils/workspace.js +1 -1
  81. package/dist/version.d.ts +1 -1
  82. package/dist/version.js +1 -1
  83. package/package.json +1 -1
@@ -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
- // AD-071 §2.4: сессионный скоуп MCP (явно включённые / opt-out).
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 (AD-025) ===
64
+ // === Plan/Act (ADR-025) ===
65
65
  planMode: z.enum(['auto', 'strict', 'off']).optional(),
66
- // === Скиллы (AD-046 §4.5) ===
66
+ // === Скиллы (ADR-046 §4.5) ===
67
67
  skills: z.array(z.string()).optional(),
68
68
  skillsDisabled: z.array(z.string()).optional(),
69
- // === Микро-слой (AD-035/AD-084) ===
70
- /** AD-084: per-session гейт decision-уровня микро-каскада (undefined → config.decision.enabled). */
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
- * AD-076: запись реестра git-репозиториев. `path` обязателен, остальные поля
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
- * AD-076: нормализация legacy-значения `repos` к `GitRepoConfig`.
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
- /** AD-076: тело создания SSH-ключа (`POST /api/v2/ssh-keys`). */
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
- /** AD-076: тело обновления SSH-ключа (без id/createdAt). */
147
+ /** ADR-076: тело обновления SSH-ключа (без id/createdAt). */
150
148
  export const sshKeyUpdateSchema = sshKeyCreateSchema.partial();
151
149
  /**
152
- * AD-071 §2.4: проектный скоуп MCP (ссылки на реестр по имени).
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
- * AD-075: тело `PUT /api/v2/settings/workspace-policy` — политика для
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
- * AD-075: запрос навигации по корню workspace (`GET /fs/workspace-root/browse`,
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
- /** AD-075: тело `POST /fs/workspace-root/mkdir` — создание каталога в корне workspace. */
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
- * AD-076: тело `POST /api/v2/git/repos/register` — upsert записи реестра
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
- * AD-076: тело `POST /api/v2/git/repos/remove` — удаление записи реестра;
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
- /** AD-076: тело `POST /api/v2/git/repos/fetch` — обязателен `id` либо `path`. */
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
- * AD-071 §2.6: фабрика схемы `tools.disabled` (единый источник значений
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
- * AD-071 §2.6: тело `PUT /api/v2/settings/tools-disabled`. Неизвестная
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
- * AD-071 §2.4: базовый контракт MCP-скоупа сессии (ссылки на реестр по имени).
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
- * AD-071 §2.4: тело `PUT /api/v2/sessions/:id/mcp`: точечный toggle
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
- // --- Скиллы (AD-046) ---
341
- /** AD-046 §3.2: имя скилла — 1–64, `^[a-z0-9]+(-[a-z0-9]+)*$`. */
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
- /** AD-046 §3.2: длина `description`. */
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
- * AD-046 §4.5: per-session enable/disable скиллов (по образцу MCP-скоупа).
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 (AD-046 §7) ---
381
- /** AD-046 §7.3: тело `POST/PATCH /api/v2/skill-bundles` (YAML-группа скиллов). */
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
- /** AD-046 §7.4: тело `PUT /api/v2/settings/skills-disabled` (группы/имена). */
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
- * AD-046 §4.5: тело `PUT /api/v2/settings/skills` — системные настройки:
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
- * AD-046 §4.5: тело `PUT /api/v2/sessions/:id/skills`: точечный toggle
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
- /** AD-046 §4.5: тело `PUT /api/v2/projects/:id/skills`. */
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
- // --- Внешние события (AD-089) ---
425
- /** AD-089: схема идентичности отправителя внешнего события. */
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
- /** AD-089: схема нормализованного внешнего события (`payload` не типизируется). */
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
- /** AD-089: режимы доставки `EventBinding` (без `drop`). */
440
+ /** ADR-089: режимы доставки `EventBinding` (без `drop`). */
443
441
  const eventDeliveryModeSchema = z.enum(['bound', 'ephemeral', 'queue']);
444
- /** AD-089: схема устойчивой привязки внешнего адреса к сессии/шаблону. */
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
- /** AD-089: схема запроса создания/привязки сессии — единый funnel. */
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
- * AD-089: вход приёма внешнего события (`POST /api/v2/events`). `id`/`dedupKey`/`ts`
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
- /** AD-089: вход upsert биндинга (`POST /api/v2/events/bindings`) — без `id`. */
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
- * AD-089/AD-052: метаданные API-ключа привязки для приёма событий.
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
- // AD-052 (задел): срок действия / отзыв ключа.
508
+ // ADR-052 (задел): срок действия / отзыв ключа.
512
509
  expiresAt: z.string().optional(),
513
510
  revokedAt: z.string().optional(),
514
511
  });
515
- /** AD-089/AD-052: тело создания API-ключа привязки — обязательная уникальная `label`. */
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
- * AD-089/AD-052: тело обновления API-ключа привязки. Все поля опциональны;
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
- /** AD-089: ответ создания ключа — метаданные + plaintext-секрет (единожды). */
529
+ /** ADR-089: ответ создания ключа — метаданные + plaintext-секрет (единожды). */
533
530
  export const eventBindingApiKeyCreatedSchema = eventBindingApiKeySchema.extend({
534
531
  key: z.string().min(1),
535
532
  });
536
533
  /**
537
- * AD-089: вход `POST /events` при аутентификации API-ключом привязки. Как
534
+ * ADR-089: вход `POST /events` при аутентификации API-ключом привязки. Как
538
535
  * `eventIngestSchema`, но `source` опционален — источник берётся из привязки.
539
536
  */
540
537
  export const eventKeyIngestSchema = eventIngestSchema.partial({ source: true });
541
- // --- Service-key (AD-052, этап I) ---
538
+ // --- Service-key (ADR-052, этап I) ---
542
539
  /**
543
- * AD-052: каталог скоупов service-key + wildcard-семейства. Глобальный `*` не
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
- * AD-052: метаданные service-key (ответы API). Секрет (`key`) и его хеш здесь
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
- /** AD-052: тело создания service-key. `roles` не заданы — дефолт хранилища. */
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
- * AD-052: тело обновления service-key. Все поля опциональны; `null` для
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
- /** AD-052: ответ создания service-key — метаданные + plaintext-секрет (единожды). */
590
+ /** ADR-052: ответ создания service-key — метаданные + plaintext-секрет (единожды). */
594
591
  export const serviceApiKeyCreatedSchema = serviceApiKeySchema.extend({
595
592
  key: z.string().min(1),
596
593
  });
597
- // --- Webhooks (AD-052, этап II) ---
598
- /** AD-052 (этап II): паттерн события подписки — exact либо `prefix.*`. */
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
- /** AD-052 (этап II): целевой URL — только http/https (SSRF-политика — в core). */
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
- * AD-052 (этап II): метаданные подписки (ответы API). Секрет (`secret`) и его
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
- /** AD-052 (этап II): тело создания подписки. `enabled` не задан — активна. */
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
- * AD-052 (этап II): тело обновления подписки. Все поля опциональны; `null` для
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
- /** AD-052 (этап II): ответ создания/ротации подписки — метаданные + секрет (единожды). */
642
+ /** ADR-052 (этап II): ответ создания/ротации подписки — метаданные + секрет (единожды). */
646
643
  export const webhookSubscriptionCreatedSchema = webhookSubscriptionSchema.extend({
647
644
  secret: z.string().min(1),
648
645
  });
649
- /** AD-052 (этап II): запись журнала доставки. */
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
- /** AD-051/AD-089: цель расписания (дискриминированный союз по `mode`). */
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
- * AD-089: цель правила маршрутизации — дискриминированный союз по `mode`
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
- // AD-089 (auto-bind): цель закрепляет внешний адрес за сессией (binding создаёт Router).
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
- /** AD-089: условие срабатывания правила (AND по заполненным полям). */
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
- /** AD-089: полная сущность правила маршрутизации событий (ответы API). */
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
- /** AD-089: вход создания/обновления правила (`upsert`) — без `id`. */
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
- * AD-089: тело upsert-запроса правила — вход + необязательный `id` (обновление
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
- * AD-051/AD-089: ровно одно из `cron` / `every` задано. Пустые строки
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
- /** AD-051/AD-089: вход создания/обновления расписания (`ScheduleInput`). */
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
- /** AD-051/AD-089: полная сущность расписания (ответы API). */
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
- /** AD-051: триггер срабатывания расписания в Job-истории. */
773
+ /** ADR-051: триггер срабатывания расписания в Job-истории. */
777
774
  export const scheduleJobTriggerSchema = z.enum(['cron', 'manual', 'catchup']);
778
- /** AD-051: запись Job-истории (ответы `GET /api/v2/schedules/:id/jobs`). */
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
- * AD-046 §3.1: толерантный парсер YAML-frontmatter `SKILL.md`.
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 {};