@itphx/synth-shared 0.10.0 → 0.10.1

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