@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
@@ -1,8 +1,8 @@
1
1
  /**
2
- * AD-046 §7: slash-команды и bundles — контракты. Здесь только типы (без
2
+ * ADR-046 §7: slash-команды и bundles — контракты. Здесь только типы (без
3
3
  * бизнес-логики движка); резолвинг выполняется в core до обращения к LLM.
4
4
  */
5
- /** Вид команды (AD-046 §7.2). */
5
+ /** Вид команды (ADR-046 §7.2). */
6
6
  export const COMMAND_KINDS = ['builtin', 'template', 'skill', 'bundle'];
7
7
  /** Режим разрешения конфликтов имён (настройка `commands.conflict.mode`). */
8
8
  export const COMMAND_CONFLICT_MODES = ['bundle-wins', 'conservative', 'namespace'];
@@ -1,5 +1,5 @@
1
1
  /**
2
- * AD-084: decision-модели (System One: Clef/Jev/Decision-1/…) как единый
2
+ * ADR-084: decision-модели (System One: Clef/Jev/Decision-1/…) как единый
3
3
  * примитив — `state` (текст/JSON) + типизированные вопросы → вероятности за
4
4
  * один forward-pass. Здесь только контракты без бизнес-логики: сами адаптеры и
5
5
  * вызовы живут в core (`providers/decision.ts`, `GatewayProvider.decide`).
@@ -16,7 +16,7 @@ export type DecisionQuestionType = 'noul' | 'choice' | 'score';
16
16
  export declare const DECISION_CRITERIA_MIN = 2;
17
17
  export declare const DECISION_CRITERIA_MAX = 26;
18
18
  /**
19
- * AD-084: бинарный вопрос. `criteria` — подписи веток `true`/`false` (опц.),
19
+ * ADR-084: бинарный вопрос. `criteria` — подписи веток `true`/`false` (опц.),
20
20
  * `instructions` — пояснение для модели (опц.).
21
21
  */
22
22
  export interface DecisionNoulQuestion {
@@ -27,33 +27,33 @@ export interface DecisionNoulQuestion {
27
27
  false?: string;
28
28
  };
29
29
  }
30
- /** AD-084: вопрос-выбор. `criteria` — карта «вариант → пояснение|null» (2..26). */
30
+ /** ADR-084: вопрос-выбор. `criteria` — карта «вариант → пояснение|null» (2..26). */
31
31
  export interface DecisionChoiceQuestion {
32
32
  type: 'choice';
33
33
  instructions: string;
34
34
  criteria: Record<string, string | null>;
35
35
  }
36
- /** AD-084: вопрос-шкала. `criteria` — упорядоченный список позиций (2..26). */
36
+ /** ADR-084: вопрос-шкала. `criteria` — упорядоченный список позиций (2..26). */
37
37
  export interface DecisionScoreQuestion {
38
38
  type: 'score';
39
39
  instructions: string;
40
40
  criteria: string[];
41
41
  }
42
- /** AD-084: типизированный вопрос decision-модели. */
42
+ /** ADR-084: типизированный вопрос decision-модели. */
43
43
  export type DecisionQuestion = DecisionNoulQuestion | DecisionChoiceQuestion | DecisionScoreQuestion;
44
- /** AD-084: ответ на `noul` — вероятность «да» (`0..1`). */
44
+ /** ADR-084: ответ на `noul` — вероятность «да» (`0..1`). */
45
45
  export interface DecisionNoulAnswer {
46
46
  type: 'noul';
47
47
  noul: number;
48
48
  }
49
- /** AD-084: ответ на `choice` — выбранный вариант + вероятности по всем. */
49
+ /** ADR-084: ответ на `choice` — выбранный вариант + вероятности по всем. */
50
50
  export interface DecisionChoiceAnswer {
51
51
  type: 'choice';
52
52
  choice: string;
53
53
  confidence: number;
54
54
  probabilities: Record<string, number>;
55
55
  }
56
- /** AD-084: ответ на `score` — позиция на шкале + вероятности по всем. */
56
+ /** ADR-084: ответ на `score` — позиция на шкале + вероятности по всем. */
57
57
  export interface DecisionScoreAnswer {
58
58
  type: 'score';
59
59
  score: number;
@@ -62,10 +62,10 @@ export interface DecisionScoreAnswer {
62
62
  /** Подписи позиций шкалы (если модель/провайдер их отдаёт). */
63
63
  legend?: Record<string, string>;
64
64
  }
65
- /** AD-084: типизированный ответ decision-модели. */
65
+ /** ADR-084: типизированный ответ decision-модели. */
66
66
  export type DecisionAnswer = DecisionNoulAnswer | DecisionChoiceAnswer | DecisionScoreAnswer;
67
67
  /**
68
- * AD-084: медиа-вложения decision-запроса (AD-085 задел). Источник изображений/
68
+ * ADR-084: медиа-вложения decision-запроса (PROP-085 задел). Источник изображений/
69
69
  * видео — мультимодальный ввод (пока не реализован), здесь только контракт-
70
70
  * plumbing: значения прокидываются в тело decision-запроса, если непусты.
71
71
  */
@@ -73,19 +73,19 @@ export interface DecisionMediaInput {
73
73
  images?: string[];
74
74
  videos?: string[];
75
75
  }
76
- /** AD-084: запрос `state + questions → answers`. */
76
+ /** ADR-084: запрос `state + questions → answers`. */
77
77
  export interface DecisionRequest extends DecisionMediaInput {
78
78
  model: string;
79
79
  /** Текст или JSON-совместимая структура (System One понимает оба). */
80
80
  state: unknown;
81
81
  questions: Record<string, DecisionQuestion>;
82
82
  }
83
- /** AD-084: расход токенов decision-запроса (snake_case — как у провайдеров). */
83
+ /** ADR-084: расход токенов decision-запроса (snake_case — как у провайдеров). */
84
84
  export interface DecisionUsage {
85
85
  input_tokens: number;
86
86
  output_tokens: number;
87
87
  }
88
- /** AD-084: ответ decision-модели. */
88
+ /** ADR-084: ответ decision-модели. */
89
89
  export interface DecisionResponse {
90
90
  id?: string;
91
91
  model?: string;
@@ -93,7 +93,7 @@ export interface DecisionResponse {
93
93
  usage?: DecisionUsage;
94
94
  }
95
95
  /**
96
- * AD-084: универсальная схема вопроса. Границы `choice`/`score` (2..26)
96
+ * ADR-084: универсальная схема вопроса. Границы `choice`/`score` (2..26)
97
97
  * проверяются отдельно — иначе `discriminatedUnion` не принимает
98
98
  * `ZodEffects`-обёртки внутри вариантов.
99
99
  */
@@ -224,7 +224,7 @@ export declare const decisionScoreAnswerSchema: z.ZodObject<{
224
224
  probabilities: Record<string, number>;
225
225
  legend?: Record<string, string> | undefined;
226
226
  }>;
227
- /** AD-084: схема ответа decision-модели. */
227
+ /** ADR-084: схема ответа decision-модели. */
228
228
  export declare const decisionAnswerSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
229
229
  type: z.ZodLiteral<"noul">;
230
230
  noul: z.ZodNumber;
@@ -353,7 +353,7 @@ export declare const decisionRequestSchema: z.ZodObject<{
353
353
  instructions: string;
354
354
  criteria: string[];
355
355
  }>>;
356
- /** AD-084/AD-085: медиа-вложения (изображения/видео) — опциональны. */
356
+ /** ADR-084/PROP-085: медиа-вложения (изображения/видео) — опциональны. */
357
357
  images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
358
358
  videos: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
359
359
  }, "strip", z.ZodTypeAny, {
@@ -1,5 +1,5 @@
1
1
  /**
2
- * AD-084: decision-модели (System One: Clef/Jev/Decision-1/…) как единый
2
+ * ADR-084: decision-модели (System One: Clef/Jev/Decision-1/…) как единый
3
3
  * примитив — `state` (текст/JSON) + типизированные вопросы → вероятности за
4
4
  * один forward-pass. Здесь только контракты без бизнес-логики: сами адаптеры и
5
5
  * вызовы живут в core (`providers/decision.ts`, `GatewayProvider.decide`).
@@ -27,7 +27,7 @@ const decisionScoreQuestionSchema = z.object({
27
27
  criteria: z.array(z.string()),
28
28
  });
29
29
  /**
30
- * AD-084: универсальная схема вопроса. Границы `choice`/`score` (2..26)
30
+ * ADR-084: универсальная схема вопроса. Границы `choice`/`score` (2..26)
31
31
  * проверяются отдельно — иначе `discriminatedUnion` не принимает
32
32
  * `ZodEffects`-обёртки внутри вариантов.
33
33
  */
@@ -74,7 +74,7 @@ export const decisionScoreAnswerSchema = z.object({
74
74
  probabilities: z.record(z.string(), z.number()),
75
75
  legend: z.record(z.string(), z.string()).optional(),
76
76
  });
77
- /** AD-084: схема ответа decision-модели. */
77
+ /** ADR-084: схема ответа decision-модели. */
78
78
  export const decisionAnswerSchema = z.discriminatedUnion('type', [
79
79
  decisionNoulAnswerSchema,
80
80
  decisionChoiceAnswerSchema,
@@ -84,7 +84,7 @@ export const decisionRequestSchema = z.object({
84
84
  model: z.string(),
85
85
  state: z.unknown(),
86
86
  questions: z.record(z.string(), decisionQuestionSchema),
87
- /** AD-084/AD-085: медиа-вложения (изображения/видео) — опциональны. */
87
+ /** ADR-084/PROP-085: медиа-вложения (изображения/видео) — опциональны. */
88
88
  images: z.array(z.string()).optional(),
89
89
  videos: z.array(z.string()).optional(),
90
90
  });
@@ -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 {
@@ -0,0 +1,44 @@
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
+ }
@@ -0,0 +1,16 @@
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 = {}));
@@ -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,23 @@
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
+ /** ADR-030: карта контекста по имени хука (минимально необходимые поля). */
21
21
  export interface HookContextMap {
22
22
  pre_tool_use: {
23
23
  tool: string;