@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.
- package/dist/config/defaults.js +60 -14
- package/dist/config/env-overrides.d.ts +7 -4
- package/dist/config/env-overrides.js +46 -13
- package/dist/config/index.d.ts +3 -0
- package/dist/config/index.js +3 -0
- package/dist/config/loader.d.ts +2 -2
- package/dist/config/loader.js +23 -4
- package/dist/config/proxy.d.ts +415 -0
- package/dist/config/proxy.js +1565 -0
- package/dist/config/resolve.d.ts +77 -10
- package/dist/config/resolve.js +203 -17
- package/dist/config/tls-runtime.d.ts +78 -0
- package/dist/config/tls-runtime.js +356 -0
- package/dist/config/tls.d.ts +215 -0
- package/dist/config/tls.js +394 -0
- package/dist/config/types.d.ts +1820 -334
- package/dist/config/types.js +320 -54
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +18 -10
- package/dist/index.d.ts +11 -2
- package/dist/index.js +11 -2
- package/dist/interfaces/index.d.ts +3 -3
- package/dist/protocols/index.d.ts +0 -1
- package/dist/schemas/index.d.ts +230 -105
- package/dist/schemas/index.js +121 -74
- package/dist/skills/frontmatter.js +1 -1
- package/dist/types/agent.d.ts +30 -0
- package/dist/types/agent.js +1 -0
- package/dist/types/analytics.d.ts +113 -0
- package/dist/types/analytics.js +61 -0
- package/dist/types/bus-events.d.ts +7 -0
- package/dist/types/bus-events.js +1 -0
- package/dist/types/commands.d.ts +10 -10
- package/dist/types/commands.js +2 -2
- package/dist/types/decision.d.ts +16 -16
- package/dist/types/decision.js +4 -4
- package/dist/types/egress.d.ts +114 -0
- package/dist/types/egress.js +68 -0
- package/dist/types/events.d.ts +22 -23
- package/dist/types/fs.d.ts +55 -0
- package/dist/types/fs.js +27 -0
- package/dist/types/git.d.ts +63 -0
- package/dist/types/git.js +1 -0
- package/dist/types/hooks.d.ts +24 -4
- package/dist/types/index.d.ts +15 -1165
- package/dist/types/index.js +44 -244
- package/dist/types/llm.d.ts +32 -0
- package/dist/types/llm.js +8 -0
- package/dist/types/maintenance.d.ts +39 -0
- package/dist/types/maintenance.js +11 -0
- package/dist/types/mcp.d.ts +169 -0
- package/dist/types/mcp.js +119 -0
- package/dist/types/message.d.ts +63 -0
- package/dist/types/message.js +12 -0
- package/dist/types/permission.d.ts +9 -7
- package/dist/types/permission.js +1 -1
- package/dist/types/project.d.ts +134 -0
- package/dist/types/project.js +67 -0
- package/dist/types/prompt.d.ts +237 -0
- package/dist/types/prompt.js +15 -0
- package/dist/types/provider.d.ts +84 -0
- package/dist/types/provider.js +35 -0
- package/dist/types/schedules.d.ts +8 -8
- package/dist/types/schedules.js +1 -1
- package/dist/types/service-keys.d.ts +10 -10
- package/dist/types/service-keys.js +3 -3
- package/dist/types/session.d.ts +268 -0
- package/dist/types/session.js +13 -0
- package/dist/types/skills.d.ts +11 -11
- package/dist/types/skills.js +6 -6
- package/dist/types/tools.d.ts +3 -3
- package/dist/types/user.d.ts +113 -0
- package/dist/types/user.js +31 -0
- package/dist/types/webhooks.d.ts +6 -6
- package/dist/types/webhooks.js +1 -1
- package/dist/utils/glob.d.ts +1 -1
- package/dist/utils/glob.js +1 -1
- package/dist/utils/index.d.ts +15 -0
- package/dist/utils/index.js +55 -2
- package/dist/utils/workspace.js +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
package/dist/types/events.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/** Нормализованное тело: текст, ссылки на вложения (
|
|
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
|
-
/**
|
|
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
|
-
/** Шаблон агента/скилла для создания/настройки сессии (
|
|
53
|
+
/** Шаблон агента/скилла для создания/настройки сессии (ADR-046). */
|
|
54
54
|
agentTemplate?: string;
|
|
55
|
-
/** `projectId` — контейнер сессии (
|
|
55
|
+
/** `projectId` — контейнер сессии (ADR-014). */
|
|
56
56
|
project?: string;
|
|
57
57
|
}
|
|
58
|
-
/**
|
|
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
|
-
* Опциональный лимит запросов в минуту для этого ключа (
|
|
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
|
-
*
|
|
81
|
+
* ADR-052 (задел): ISO-8601 срок действия ключа. Заполнен и уже прошёл —
|
|
82
82
|
* ключ недействителен (`resolveBySecret` → `null`). Не задан — бессрочно.
|
|
83
83
|
*/
|
|
84
84
|
expiresAt?: string;
|
|
85
85
|
/**
|
|
86
|
-
*
|
|
86
|
+
* ADR-052 (задел): ISO-8601 отзыв ключа (мягкое удаление). Заполнен —
|
|
87
87
|
* ключ недействителен независимо от срока (`EventApiKeyStore.revoke`).
|
|
88
88
|
*/
|
|
89
89
|
revokedAt?: string;
|
|
90
90
|
}
|
|
91
|
-
/**
|
|
91
|
+
/** ADR-089: ответ создания ключа — метаданные + однократно показываемый секрет. */
|
|
92
92
|
export interface EventBindingApiKeyCreated extends EventBindingApiKey {
|
|
93
93
|
/** Plaintext-секрет; возвращается единственный раз при создании. */
|
|
94
94
|
key: string;
|
|
95
95
|
}
|
|
96
96
|
/**
|
|
97
|
-
*
|
|
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
|
-
*
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
*
|
|
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
|
-
/**
|
|
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
|
-
*
|
|
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
|
-
/**
|
|
189
|
+
/** ADR-089: решение Router — куда направить событие (или отложить/отбросить). */
|
|
190
190
|
export type RouteDecision = RouteDecisionKind & RouteDecisionMeta;
|
|
191
|
-
/**
|
|
191
|
+
/** ADR-089: инициатор запроса на сессию. */
|
|
192
192
|
export type EventInitiator = 'user' | 'agent' | 'external' | 'system';
|
|
193
193
|
/**
|
|
194
|
-
*
|
|
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;
|
package/dist/types/fs.js
ADDED
|
@@ -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 {};
|
package/dist/types/hooks.d.ts
CHANGED
|
@@ -1,23 +1,34 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
2
|
+
* ADR-030: контракты hook-шины событий агента и интеграций. Система хуков не
|
|
3
3
|
* реализована в рантайме (Plugin SDK — отдельный этап), здесь только типы:
|
|
4
4
|
* имена хуков, режим выполнения, результат и карта контекстов.
|
|
5
5
|
*/
|
|
6
6
|
import type { SynthEvent, EventInitiator } from './events.js';
|
|
7
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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;
|