@itphx/synth-shared 0.9.0 → 0.10.1

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