@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
  /**
2
- * AD-089: домен внешних событий — нормализованное `Event`, устойчивая `Binding`
2
+ * ADR-089: домен внешних событий — нормализованное `Event`, устойчивая `Binding`
3
3
  * и решение Router. Контракты без бизнес-логики: сам Router/приём событий живут
4
4
  * в core, здесь только типы.
5
5
  */
@@ -13,7 +13,7 @@ export type EventSource = string;
13
13
  export type EventMode = 'bound' | 'ephemeral' | 'queue' | 'drop';
14
14
  /** Режим доставки события в `EventBinding` (без `drop`). */
15
15
  export type EventDeliveryMode = Exclude<EventMode, 'drop'>;
16
- /** AD-089: идентичность отправителя события (маппинг на RBAC — AD-029/AD-043). */
16
+ /** ADR-089: идентичность отправителя события (маппинг на RBAC — ADR-029/ADR-043). */
17
17
  export interface EventIdentity {
18
18
  /** Внешний идентификатор пользователя. */
19
19
  principalId?: string;
@@ -24,14 +24,14 @@ export interface EventIdentity {
24
24
  /** Роли для маппинга на RBAC. */
25
25
  roles?: string[];
26
26
  }
27
- /** AD-089: нормализованное внешнее событие (источник-специфика — в `payload`). */
27
+ /** ADR-089: нормализованное внешнее событие (источник-специфика — в `payload`). */
28
28
  export interface SynthEvent {
29
29
  /** `'evt_<uuid>'`, уникален в пределах инстанса. */
30
30
  id: string;
31
31
  source: string;
32
32
  /** `'message' | 'callback' | 'webhook' | 'schedule' | 'ci_event' | 'session.requested'`. */
33
33
  type: string;
34
- /** Нормализованное тело: текст, ссылки на вложения (AD-085), метаданные. */
34
+ /** Нормализованное тело: текст, ссылки на вложения (PROP-085), метаданные. */
35
35
  payload: unknown;
36
36
  identity: EventIdentity;
37
37
  /** Стабильный ключ идемпотентности. */
@@ -39,7 +39,7 @@ export interface SynthEvent {
39
39
  /** Время события, ISO-8601. */
40
40
  ts: string;
41
41
  }
42
- /** AD-089: устойчивая привязка внешнего адреса к сессии/шаблону. */
42
+ /** ADR-089: устойчивая привязка внешнего адреса к сессии/шаблону. */
43
43
  export interface EventBinding {
44
44
  id: string;
45
45
  source: string;
@@ -50,12 +50,12 @@ export interface EventBinding {
50
50
  /** Конкретная постоянная сессия (mode=`bound`). */
51
51
  sessionId?: string;
52
52
  mode: EventDeliveryMode;
53
- /** Шаблон агента/скилла для создания/настройки сессии (AD-046). */
53
+ /** Шаблон агента/скилла для создания/настройки сессии (ADR-046). */
54
54
  agentTemplate?: string;
55
- /** `projectId` — контейнер сессии (AD-014). */
55
+ /** `projectId` — контейнер сессии (ADR-014). */
56
56
  project?: string;
57
57
  }
58
- /** AD-089/AD-052: API-ключ привязки для аутентификации приёма событий. */
58
+ /** ADR-089/ADR-052: API-ключ привязки для аутентификации приёма событий. */
59
59
  export interface EventBindingApiKey {
60
60
  /** `eak_<uuid>`. */
61
61
  id: string;
@@ -65,7 +65,7 @@ export interface EventBindingApiKey {
65
65
  /** Опциональное описание назначения ключа. */
66
66
  description?: string;
67
67
  /**
68
- * Опциональный лимит запросов в минуту для этого ключа (AD-089/AD-052).
68
+ * Опциональный лимит запросов в минуту для этого ключа (ADR-089/ADR-052).
69
69
  * Не задан — глобальный дефолт `events.keyRateLimitPerMinute`; `0` — без лимита.
70
70
  */
71
71
  rateLimitPerMinute?: number;
@@ -78,23 +78,23 @@ export interface EventBindingApiKey {
78
78
  /** Префикс ключа для идентификации в UI (секрет наружу не отдаётся). */
79
79
  prefix: string;
80
80
  /**
81
- * AD-052 (задел): ISO-8601 срок действия ключа. Заполнен и уже прошёл —
81
+ * ADR-052 (задел): ISO-8601 срок действия ключа. Заполнен и уже прошёл —
82
82
  * ключ недействителен (`resolveBySecret` → `null`). Не задан — бессрочно.
83
83
  */
84
84
  expiresAt?: string;
85
85
  /**
86
- * AD-052 (задел): ISO-8601 отзыв ключа (мягкое удаление). Заполнен —
86
+ * ADR-052 (задел): ISO-8601 отзыв ключа (мягкое удаление). Заполнен —
87
87
  * ключ недействителен независимо от срока (`EventApiKeyStore.revoke`).
88
88
  */
89
89
  revokedAt?: string;
90
90
  }
91
- /** AD-089: ответ создания ключа — метаданные + однократно показываемый секрет. */
91
+ /** ADR-089: ответ создания ключа — метаданные + однократно показываемый секрет. */
92
92
  export interface EventBindingApiKeyCreated extends EventBindingApiKey {
93
93
  /** Plaintext-секрет; возвращается единственный раз при создании. */
94
94
  key: string;
95
95
  }
96
96
  /**
97
- * AD-089: цель правила маршрутизации (та же семантика, что у
97
+ * ADR-089: цель правила маршрутизации (та же семантика, что у
98
98
  * `EventBinding`/`ScheduleTarget`).
99
99
  */
100
100
  export type EventRouteTarget = {
@@ -110,7 +110,7 @@ export type EventRouteTarget = {
110
110
  sessionId: string;
111
111
  }
112
112
  /**
113
- * AD-089 (auto-bind): правило закрепляет внешний адрес события
113
+ * ADR-089 (auto-bind): правило закрепляет внешний адрес события
114
114
  * (`chatKey`/`threadKey`) за сессией — Router создаёт `EventBinding`
115
115
  * (`mode='bound'`) при первой доставке.
116
116
  */
@@ -119,7 +119,7 @@ export type EventRouteTarget = {
119
119
  agentTemplate?: string;
120
120
  project?: string;
121
121
  };
122
- /** AD-089: условие срабатывания правила (AND по заполненным полям). */
122
+ /** ADR-089: условие срабатывания правила (AND по заполненным полям). */
123
123
  export interface EventRouteMatch {
124
124
  source?: string;
125
125
  type?: string;
@@ -131,7 +131,7 @@ export interface EventRouteMatch {
131
131
  /** Подстроки в тексте события (регистронезависимо; достаточно одного). */
132
132
  keywords?: string[];
133
133
  }
134
- /** AD-089: правило маршрутизации событий «событие → сессия» (проектные/инстанс-правила). */
134
+ /** ADR-089: правило маршрутизации событий «событие → сессия» (проектные/инстанс-правила). */
135
135
  export interface EventRouteRule {
136
136
  /** `rule_<uuid>`, уникален в пределах инстанса. */
137
137
  id: string;
@@ -143,7 +143,7 @@ export interface EventRouteRule {
143
143
  target: EventRouteTarget;
144
144
  }
145
145
  /**
146
- * AD-089/AD-084: диагностическая мета решения Router. Необязательные поля,
146
+ * ADR-089/ADR-084: диагностическая мета решения Router. Необязательные поля,
147
147
  * не ломают дискриминант `kind`; заполняются decision-слоем (`confidence`)
148
148
  * и маршрутизацией (`signals`) — попадают в ответ `POST /events` и в журнал.
149
149
  */
@@ -156,7 +156,7 @@ export interface RouteDecisionMeta {
156
156
  */
157
157
  signals?: string[];
158
158
  }
159
- /** AD-089: вариант решения Router без меты (дискриминант `kind`). */
159
+ /** ADR-089: вариант решения Router без меты (дискриминант `kind`). */
160
160
  type RouteDecisionKind = {
161
161
  kind: 'bound';
162
162
  sessionId: string;
@@ -175,7 +175,7 @@ type RouteDecisionKind = {
175
175
  audited: true;
176
176
  }
177
177
  /**
178
- * AD-089 (auto-bind): Router решает закрепить событие за новой сессией —
178
+ * ADR-089 (auto-bind): Router решает закрепить событие за новой сессией —
179
179
  * `RequestSessionService` создаёт сессию без `expiresAt` и `EventBinding`
180
180
  * (`mode='bound'`), после чего доставляет событие. Источник решения — фоллбек
181
181
  * при `events.autoBind` и наличии `identity.chatKey|threadKey`, либо правило
@@ -186,12 +186,12 @@ type RouteDecisionKind = {
186
186
  agentTemplate: string;
187
187
  project?: string;
188
188
  };
189
- /** AD-089: решение Router — куда направить событие (или отложить/отбросить). */
189
+ /** ADR-089: решение Router — куда направить событие (или отложить/отбросить). */
190
190
  export type RouteDecision = RouteDecisionKind & RouteDecisionMeta;
191
- /** AD-089: инициатор запроса на сессию. */
191
+ /** ADR-089: инициатор запроса на сессию. */
192
192
  export type EventInitiator = 'user' | 'agent' | 'external' | 'system';
193
193
  /**
194
- * AD-089: намерение создать/привязать сессию — единый funnel. Создание сессии
194
+ * ADR-089: намерение создать/привязать сессию — единый funnel. Создание сессии
195
195
  * обрабатывается тем же Router'ом, независимо от инициатора.
196
196
  */
197
197
  export interface SessionRequest {
@@ -208,7 +208,6 @@ export interface SessionRequest {
208
208
  icon?: string;
209
209
  /** Канонический ключ цвета (PROJECT_COLOR_KEYS). */
210
210
  color?: string;
211
- engine?: string;
212
211
  /** Происхождение сессии (`user`/`fork`/`subagent`) — паритет с createSession. */
213
212
  sessionOrigin?: SessionOrigin;
214
213
  settings?: Partial<SessionSettings>;
@@ -0,0 +1,55 @@
1
+ export declare enum FsErrorCode {
2
+ PATH_TRAVERSAL = "PATH_TRAVERSAL",
3
+ NOT_FOUND = "NOT_FOUND",
4
+ NOT_A_DIRECTORY = "NOT_A_DIRECTORY",
5
+ IS_DIRECTORY = "IS_DIRECTORY",
6
+ BINARY_FILE = "BINARY_FILE",
7
+ WORKSPACE_NOT_SET = "WORKSPACE_NOT_SET",
8
+ WORKSPACE_NOT_FOUND = "WORKSPACE_NOT_FOUND",
9
+ PERMISSION_DENIED = "PERMISSION_DENIED",
10
+ ALREADY_EXISTS = "ALREADY_EXISTS",
11
+ DIR_NOT_EMPTY = "DIR_NOT_EMPTY",
12
+ /** ADR-075: путь вне `workspacesRoot` запрещён политикой (managed). */
13
+ WORKSPACE_OUTSIDE_ROOT_DENIED = "WORKSPACE_OUTSIDE_ROOT_DENIED"
14
+ }
15
+ export interface FileEntry {
16
+ name: string;
17
+ path: string;
18
+ isDirectory: boolean;
19
+ size: number;
20
+ modifiedAt: number;
21
+ }
22
+ export interface DirectoryListResult {
23
+ path: string;
24
+ entries: FileEntry[];
25
+ }
26
+ export interface FileReadResult {
27
+ path: string;
28
+ content: string;
29
+ size: number;
30
+ encoding: 'utf-8' | 'binary';
31
+ }
32
+ export interface FileWriteBody {
33
+ projectId: string;
34
+ path: string;
35
+ content: string;
36
+ }
37
+ export interface FileMkdirBody {
38
+ projectId: string;
39
+ path: string;
40
+ }
41
+ export interface FsError {
42
+ error: string;
43
+ code: FsErrorCode;
44
+ }
45
+ /**
46
+ * Лимит загрузки файла (`POST /api/v2/fs/upload`) по умолчанию, байт: 100 МиБ.
47
+ * Щедро, но ограничивает DoS (тело буферизуется в память целиком). Переопределяется
48
+ * конфигом (`storage.maxUploadBytes` / env `SYNTH_MAX_UPLOAD_BYTES`) или опцией
49
+ * фабрики `createFsRoutes` (`FsRoutesOptions.maxUploadBytes`, для тестов).
50
+ */
51
+ export declare const DEFAULT_MAX_UPLOAD_BYTES: number;
52
+ /** Нижняя граница настраиваемого лимита загрузки (байт) — нельзя «залимитировать всё». */
53
+ export declare const MIN_UPLOAD_BYTES = 1024;
54
+ /** Верхняя граница настраиваемого лимита загрузки (байт): 2 ГиБ (тело буферизуется в память). */
55
+ export declare const MAX_UPLOAD_BYTES_LIMIT: number;
@@ -0,0 +1,27 @@
1
+ // --- File System ---
2
+ export var FsErrorCode;
3
+ (function (FsErrorCode) {
4
+ FsErrorCode["PATH_TRAVERSAL"] = "PATH_TRAVERSAL";
5
+ FsErrorCode["NOT_FOUND"] = "NOT_FOUND";
6
+ FsErrorCode["NOT_A_DIRECTORY"] = "NOT_A_DIRECTORY";
7
+ FsErrorCode["IS_DIRECTORY"] = "IS_DIRECTORY";
8
+ FsErrorCode["BINARY_FILE"] = "BINARY_FILE";
9
+ FsErrorCode["WORKSPACE_NOT_SET"] = "WORKSPACE_NOT_SET";
10
+ FsErrorCode["WORKSPACE_NOT_FOUND"] = "WORKSPACE_NOT_FOUND";
11
+ FsErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
12
+ FsErrorCode["ALREADY_EXISTS"] = "ALREADY_EXISTS";
13
+ FsErrorCode["DIR_NOT_EMPTY"] = "DIR_NOT_EMPTY";
14
+ /** ADR-075: путь вне `workspacesRoot` запрещён политикой (managed). */
15
+ FsErrorCode["WORKSPACE_OUTSIDE_ROOT_DENIED"] = "WORKSPACE_OUTSIDE_ROOT_DENIED";
16
+ })(FsErrorCode || (FsErrorCode = {}));
17
+ /**
18
+ * Лимит загрузки файла (`POST /api/v2/fs/upload`) по умолчанию, байт: 100 МиБ.
19
+ * Щедро, но ограничивает DoS (тело буферизуется в память целиком). Переопределяется
20
+ * конфигом (`storage.maxUploadBytes` / env `SYNTH_MAX_UPLOAD_BYTES`) или опцией
21
+ * фабрики `createFsRoutes` (`FsRoutesOptions.maxUploadBytes`, для тестов).
22
+ */
23
+ export const DEFAULT_MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
24
+ /** Нижняя граница настраиваемого лимита загрузки (байт) — нельзя «залимитировать всё». */
25
+ export const MIN_UPLOAD_BYTES = 1024;
26
+ /** Верхняя граница настраиваемого лимита загрузки (байт): 2 ГиБ (тело буферизуется в память). */
27
+ export const MAX_UPLOAD_BYTES_LIMIT = 2 * 1024 * 1024 * 1024;
@@ -0,0 +1,63 @@
1
+ /**
2
+ * ADR-076: запись реестра git-репозиториев проекта. Старые данные (`repos` как
3
+ * `string[]` либо `{ path }`) нормализуются через `normalizeGitRepoConfig`.
4
+ */
5
+ export interface GitRepoConfig {
6
+ /** Стабильный id записи реестра (uuid); отсутствует у обнаруженных scan-ом. */
7
+ id?: string;
8
+ name?: string;
9
+ url?: string;
10
+ type?: 'https' | 'ssh';
11
+ /** Относительный путь ВНУТРИ project.workspace (допускает вложенность). */
12
+ path: string;
13
+ defaultBranch?: string;
14
+ sshKeyId?: string;
15
+ lastFetch?: string;
16
+ }
17
+ /**
18
+ * ADR-076: SSH-ключ агента — отдельная сущность реестра (не в
19
+ * `AgentDefinition`). Секреты `privateKey`/`passphrase` шифруются at-rest
20
+ * (AES-256-GCM; реализация — в core) и НИКОГДА не отдаются через API.
21
+ */
22
+ export interface SSHKey {
23
+ id: string;
24
+ name: string;
25
+ /** Метка типа ключа, дефолт `'user'`. */
26
+ type?: string;
27
+ privateKey: string;
28
+ passphrase?: string;
29
+ /** Привязка к агентам: один ключ может обслуживать несколько агентов. */
30
+ agentIds: string[];
31
+ createdAt: string;
32
+ updatedAt?: string;
33
+ }
34
+ /** Публичное представление ключа (без `privateKey`/`passphrase`). */
35
+ export type SSHKeyMeta = Omit<SSHKey, 'privateKey' | 'passphrase'>;
36
+ export interface RepoStatus {
37
+ path: string;
38
+ isRepo: boolean;
39
+ currentBranch?: string;
40
+ lastCommitAt?: string;
41
+ lastCommitSubject?: string;
42
+ }
43
+ export interface CommitInfo {
44
+ hash: string;
45
+ shortHash: string;
46
+ subject: string;
47
+ message: string;
48
+ author: string;
49
+ authorEmail: string;
50
+ date: string;
51
+ relativeDate: string;
52
+ branch: string;
53
+ }
54
+ export interface CommitFileInfo {
55
+ path: string;
56
+ status: 'added' | 'modified' | 'deleted' | 'renamed';
57
+ additions: number;
58
+ deletions: number;
59
+ }
60
+ export interface CommitDetail extends CommitInfo {
61
+ files: CommitFileInfo[];
62
+ diff: string;
63
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -1,23 +1,34 @@
1
1
  /**
2
- * AD-030: контракты hook-шины событий агента и интеграций. Система хуков не
2
+ * ADR-030: контракты hook-шины событий агента и интеграций. Система хуков не
3
3
  * реализована в рантайме (Plugin SDK — отдельный этап), здесь только типы:
4
4
  * имена хуков, режим выполнения, результат и карта контекстов.
5
5
  */
6
6
  import type { SynthEvent, EventInitiator } from './events.js';
7
- /** AD-030: имена хуков жизненного цикла агента и интеграций (AD-089). */
7
+ /** ADR-030: имена хуков жизненного цикла агента и интеграций (ADR-089). */
8
8
  export type HookName = 'pre_tool_use' | 'post_tool_use' | 'session_start' | 'session_end' | 'plan_approved' | 'plan_rejected' | 'agent_spawned' | 'agent_completed' | 'agent_failed' | 'permission_denied' | 'external_event' | 'message_received' | 'callback' | 'session_requested' | 'schedule_fired';
9
9
  /**
10
10
  * Режим выполнения хука: `sync` — блокирующий (можно `block`/`patch`),
11
11
  * `async` — fire-and-forget (тяжёлые операции: CI, нотификации).
12
12
  */
13
13
  export type HookMode = 'sync' | 'async';
14
- /** AD-030: результат хука. `block`/`reason` — только для `sync`. */
14
+ /** ADR-030: результат хука. `block`/`reason` — только для `sync`. */
15
15
  export interface HookResult {
16
16
  block?: boolean;
17
17
  reason?: string;
18
18
  patch?: Record<string, unknown>;
19
19
  }
20
- /** AD-030: карта контекста по имени хука (минимально необходимые поля). */
20
+ /**
21
+ * PROP-102: оси атрибуции для сборщиков аналитики (`user`/`project`) — заполняются
22
+ * на месте эмита, где значения уже под рукой (без чтения сессии в подписчике).
23
+ * Необязательны: без них подписчик резолвит сессию по id (если она ещё есть).
24
+ */
25
+ export interface HookAnalyticsAxes {
26
+ /** Владелец/пользователь сессии (`Session.userId`), ось `user`. */
27
+ userId?: string;
28
+ /** Проект сессии (`Session.projectId`), ось `project`. */
29
+ projectId?: string;
30
+ }
31
+ /** ADR-030: карта контекста по имени хука (минимально необходимые поля). */
21
32
  export interface HookContextMap {
22
33
  pre_tool_use: {
23
34
  tool: string;
@@ -29,15 +40,24 @@ export interface HookContextMap {
29
40
  input: unknown;
30
41
  output?: unknown;
31
42
  duration: number;
43
+ /** PROP-102: сессия вызова и оси атрибуции активности (ADR-030). */
44
+ sessionId?: string;
45
+ userId?: string;
46
+ projectId?: string;
32
47
  };
33
48
  session_start: {
34
49
  sessionId: string;
35
50
  projectId?: string;
36
51
  agent?: string;
52
+ userId?: string;
37
53
  };
38
54
  session_end: {
39
55
  sessionId: string;
40
56
  summary?: string;
57
+ userId?: string;
58
+ projectId?: string;
59
+ /** PROP-102: сессия архивирована (а не удалена) — мера `sessions_archived`. */
60
+ archived?: boolean;
41
61
  };
42
62
  plan_approved: {
43
63
  sessionId: string;