@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.
- package/dist/config/defaults.js +11 -11
- package/dist/config/env-overrides.d.ts +3 -3
- package/dist/config/env-overrides.js +9 -9
- package/dist/config/loader.d.ts +2 -2
- package/dist/config/loader.js +4 -4
- package/dist/config/resolve.d.ts +10 -10
- package/dist/config/resolve.js +16 -16
- package/dist/config/types.d.ts +190 -190
- package/dist/config/types.js +47 -47
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +16 -10
- package/dist/interfaces/index.d.ts +3 -3
- package/dist/schemas/index.d.ts +96 -96
- package/dist/schemas/index.js +70 -70
- 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/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/events.d.ts +22 -22
- package/dist/types/fs.d.ts +44 -0
- package/dist/types/fs.js +16 -0
- package/dist/types/git.d.ts +63 -0
- package/dist/types/git.js +1 -0
- package/dist/types/hooks.d.ts +4 -4
- package/dist/types/index.d.ts +12 -1165
- package/dist/types/index.js +38 -244
- package/dist/types/llm.d.ts +32 -0
- package/dist/types/llm.js +8 -0
- package/dist/types/mcp.d.ts +104 -0
- package/dist/types/mcp.js +40 -0
- package/dist/types/message.d.ts +63 -0
- package/dist/types/message.js +12 -0
- package/dist/types/permission.d.ts +2 -2
- 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 +236 -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 +269 -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 +5 -5
- 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.js +2 -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/commands.js
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
2
|
+
* ADR-046 §7: slash-команды и bundles — контракты. Здесь только типы (без
|
|
3
3
|
* бизнес-логики движка); резолвинг выполняется в core до обращения к LLM.
|
|
4
4
|
*/
|
|
5
|
-
/** Вид команды (
|
|
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'];
|
package/dist/types/decision.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
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
|
-
*
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
42
|
+
/** ADR-084: типизированный вопрос decision-модели. */
|
|
43
43
|
export type DecisionQuestion = DecisionNoulQuestion | DecisionChoiceQuestion | DecisionScoreQuestion;
|
|
44
|
-
/**
|
|
44
|
+
/** ADR-084: ответ на `noul` — вероятность «да» (`0..1`). */
|
|
45
45
|
export interface DecisionNoulAnswer {
|
|
46
46
|
type: 'noul';
|
|
47
47
|
noul: number;
|
|
48
48
|
}
|
|
49
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
65
|
+
/** ADR-084: типизированный ответ decision-модели. */
|
|
66
66
|
export type DecisionAnswer = DecisionNoulAnswer | DecisionChoiceAnswer | DecisionScoreAnswer;
|
|
67
67
|
/**
|
|
68
|
-
*
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
83
|
+
/** ADR-084: расход токенов decision-запроса (snake_case — как у провайдеров). */
|
|
84
84
|
export interface DecisionUsage {
|
|
85
85
|
input_tokens: number;
|
|
86
86
|
output_tokens: number;
|
|
87
87
|
}
|
|
88
|
-
/**
|
|
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
|
-
*
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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, {
|
package/dist/types/decision.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
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
|
-
*
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
87
|
+
/** ADR-084/PROP-085: медиа-вложения (изображения/видео) — опциональны. */
|
|
88
88
|
images: z.array(z.string()).optional(),
|
|
89
89
|
videos: z.array(z.string()).optional(),
|
|
90
90
|
});
|
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 {
|
|
@@ -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
|
+
}
|
package/dist/types/fs.js
ADDED
|
@@ -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 {};
|
package/dist/types/hooks.d.ts
CHANGED
|
@@ -1,23 +1,23 @@
|
|
|
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
|
+
/** ADR-030: карта контекста по имени хука (минимально необходимые поля). */
|
|
21
21
|
export interface HookContextMap {
|
|
22
22
|
pre_tool_use: {
|
|
23
23
|
tool: string;
|