@itphx/synth-shared 0.11.3 → 0.12.4
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 +126 -3
- package/dist/config/env-overrides.d.ts +29 -0
- package/dist/config/env-overrides.js +155 -2
- package/dist/config/execution.d.ts +66 -0
- package/dist/config/execution.js +146 -0
- package/dist/config/index.d.ts +1 -0
- package/dist/config/index.js +1 -0
- package/dist/config/proxy.js +3 -1
- package/dist/config/resolve.d.ts +8 -8
- package/dist/config/resolve.js +7 -7
- package/dist/config/types.d.ts +1287 -4037
- package/dist/config/types.js +461 -68
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +277 -0
- package/dist/index.d.ts +14 -2
- package/dist/index.js +16 -2
- package/dist/model-metadata.d.ts +10 -0
- package/dist/schemas/index.d.ts +980 -2322
- package/dist/schemas/index.js +183 -22
- package/dist/types/analytics.d.ts +6 -6
- package/dist/types/analytics.js +4 -4
- package/dist/types/authority.d.ts +464 -0
- package/dist/types/authority.js +445 -0
- package/dist/types/background.d.ts +96 -0
- package/dist/types/background.js +24 -0
- package/dist/types/bus-events.d.ts +23 -1
- package/dist/types/catalog.d.ts +349 -0
- package/dist/types/catalog.js +393 -0
- package/dist/types/decision.d.ts +28 -337
- package/dist/types/egress.d.ts +1 -1
- package/dist/types/egress.js +1 -1
- package/dist/types/events.d.ts +54 -1
- package/dist/types/external-credentials.d.ts +352 -0
- package/dist/types/external-credentials.js +200 -0
- package/dist/types/hooks.d.ts +33 -12
- package/dist/types/index.d.ts +20 -0
- package/dist/types/index.js +50 -1
- package/dist/types/llm-filters.d.ts +150 -0
- package/dist/types/llm-filters.js +54 -0
- package/dist/types/mcp.d.ts +33 -2
- package/dist/types/mcp.js +44 -1
- package/dist/types/message.d.ts +45 -1
- package/dist/types/pack.d.ts +1102 -0
- package/dist/types/pack.js +1003 -0
- package/dist/types/permission.d.ts +25 -11
- package/dist/types/permission.js +1 -1
- package/dist/types/pipeline-engine.d.ts +453 -0
- package/dist/types/pipeline-engine.js +440 -0
- package/dist/types/pipeline.d.ts +275 -0
- package/dist/types/pipeline.js +212 -0
- package/dist/types/plugin-audit.d.ts +110 -0
- package/dist/types/plugin-audit.js +185 -0
- package/dist/types/plugin-hybrid.d.ts +85 -0
- package/dist/types/plugin-hybrid.js +68 -0
- package/dist/types/plugin-lock.d.ts +95 -0
- package/dist/types/plugin-lock.js +1 -0
- package/dist/types/plugin-protocol.d.ts +221 -0
- package/dist/types/plugin-protocol.js +322 -0
- package/dist/types/plugin-runtime.d.ts +25 -0
- package/dist/types/plugin-runtime.js +11 -0
- package/dist/types/plugin-scan.d.ts +159 -0
- package/dist/types/plugin-scan.js +166 -0
- package/dist/types/plugin-tools.d.ts +51 -0
- package/dist/types/plugin-tools.js +72 -0
- package/dist/types/project.d.ts +14 -0
- package/dist/types/prompt-blocks.d.ts +102 -0
- package/dist/types/prompt-blocks.js +24 -0
- package/dist/types/prompt.d.ts +45 -3
- package/dist/types/provider.d.ts +11 -0
- package/dist/types/question.d.ts +153 -0
- package/dist/types/question.js +65 -0
- package/dist/types/schedules.d.ts +26 -3
- package/dist/types/semver.d.ts +48 -0
- package/dist/types/semver.js +218 -0
- package/dist/types/service-keys.d.ts +41 -3
- package/dist/types/service-keys.js +44 -2
- package/dist/types/session.d.ts +54 -0
- package/dist/types/steering.d.ts +74 -0
- package/dist/types/steering.js +75 -0
- package/dist/types/tools.d.ts +125 -5
- package/dist/types/tools.js +75 -0
- package/dist/types/trust.d.ts +31 -0
- package/dist/types/trust.js +27 -0
- package/dist/types/worktree.d.ts +170 -0
- package/dist/types/worktree.js +101 -0
- package/dist/utils/index.d.ts +31 -1
- package/dist/utils/index.js +92 -12
- package/dist/utils/reasoning.d.ts +16 -0
- package/dist/utils/reasoning.js +37 -0
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +2 -2
|
@@ -0,0 +1,275 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-051 (шедулер и пайплайны) + ADR-100 (Pipeline Automation): контракт
|
|
3
|
+
* пайплайна — определение, шаг, состояние шага и экземпляр автомата.
|
|
4
|
+
*
|
|
5
|
+
* Здесь только типы и zod-схемы (browser-safe, без `node:*`): сам рантайм
|
|
6
|
+
* пайплайнов (создание экземпляра, доставка шага, HITL-гейты) ещё не
|
|
7
|
+
* реализован — он в объёме ADR-100. Контракт заводится заранее, чтобы
|
|
8
|
+
* манифест расширения (`synth.pack`, ADR-086 §5) мог объявлять пайплайны.
|
|
9
|
+
*/
|
|
10
|
+
import { z } from 'zod';
|
|
11
|
+
/**
|
|
12
|
+
* Вид шага пайплайна:
|
|
13
|
+
* - `agent` — шаг с агентом (основной вид, значение по умолчанию);
|
|
14
|
+
* - `loop` — резерв под Loop Engine (PROP-057, вне объёма сейчас).
|
|
15
|
+
*/
|
|
16
|
+
export declare const pipelineStepKindSchema: z.ZodEnum<{
|
|
17
|
+
agent: "agent";
|
|
18
|
+
loop: "loop";
|
|
19
|
+
}>;
|
|
20
|
+
export type PipelineStepKind = z.infer<typeof pipelineStepKindSchema>;
|
|
21
|
+
/**
|
|
22
|
+
* Совпадение с внешним событием — триггер шага/пайплайна.
|
|
23
|
+
*
|
|
24
|
+
* Форма — **сужение** `eventRouteMatchSchema` (ADR-089, `schemas/index.ts`)
|
|
25
|
+
* до полей, осмысленных для автомата: `source` + `type`. Полную схему правил
|
|
26
|
+
* маршрутизации здесь не переиспользуем намеренно:
|
|
27
|
+
* - она несёт поля смысла роутера (`chatKey`/`threadKey`/`principalId`/
|
|
28
|
+
* `label`/`keywords`), а не триггера пайплайна;
|
|
29
|
+
* - она лежит в `schemas/`, который импортирует `types/` — прямой импорт
|
|
30
|
+
* дал бы цикл `types → schemas → types`.
|
|
31
|
+
*/
|
|
32
|
+
export declare const eventMatchSchema: z.ZodObject<{
|
|
33
|
+
source: z.ZodOptional<z.ZodString>;
|
|
34
|
+
type: z.ZodOptional<z.ZodString>;
|
|
35
|
+
}, z.core.$strip>;
|
|
36
|
+
export type EventMatch = z.infer<typeof eventMatchSchema>;
|
|
37
|
+
/**
|
|
38
|
+
* Вид артефакта-объекта blob-хранилища (ADR-101 §9, ADR-116 §3).
|
|
39
|
+
*
|
|
40
|
+
* Байты артефакта прогона лежат в общем blob-порте, `path` — путь объекта
|
|
41
|
+
* (`artifacts/<runId>/<name>`); учёт ссылок — `blob_refs`
|
|
42
|
+
* (`ownerKind: 'pipeline-run'`). Отдельного хранилища артефактов нет
|
|
43
|
+
* (решение 2026-10-27, ADR-101 §«Открытые вопросы»).
|
|
44
|
+
*/
|
|
45
|
+
export declare const PIPELINE_ARTIFACT_BLOB_KIND = "blob";
|
|
46
|
+
/**
|
|
47
|
+
* Артефакт шага (ADR-100: передача артефактов между шагами): что шаг
|
|
48
|
+
* произвёл (`kind`) и откуда взялось (`from`).
|
|
49
|
+
*
|
|
50
|
+
* Поля `path`/`mime`/`size`/`name` — **аддитивное** расширение для
|
|
51
|
+
* артефакта-объекта (`kind: 'blob'`, ADR-116): старые записи без них
|
|
52
|
+
* остаются валидными.
|
|
53
|
+
*/
|
|
54
|
+
export declare const pipelineArtifactSchema: z.ZodObject<{
|
|
55
|
+
kind: z.ZodString;
|
|
56
|
+
id: z.ZodOptional<z.ZodString>;
|
|
57
|
+
from: z.ZodOptional<z.ZodString>;
|
|
58
|
+
source: z.ZodOptional<z.ZodString>;
|
|
59
|
+
type: z.ZodOptional<z.ZodString>;
|
|
60
|
+
path: z.ZodOptional<z.ZodString>;
|
|
61
|
+
mime: z.ZodOptional<z.ZodString>;
|
|
62
|
+
size: z.ZodOptional<z.ZodNumber>;
|
|
63
|
+
name: z.ZodOptional<z.ZodString>;
|
|
64
|
+
payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
65
|
+
}, z.core.$strip>;
|
|
66
|
+
export type PipelineArtifact = z.infer<typeof pipelineArtifactSchema>;
|
|
67
|
+
/** Артефакт-объект blob-хранилища: `kind: 'blob'` и известный путь. */
|
|
68
|
+
export type PipelineBlobArtifact = PipelineArtifact & {
|
|
69
|
+
kind: typeof PIPELINE_ARTIFACT_BLOB_KIND;
|
|
70
|
+
path: string;
|
|
71
|
+
};
|
|
72
|
+
/** Является ли артефакт объектом blob-хранилища (`kind: 'blob'` + `path`). */
|
|
73
|
+
export declare function isBlobPipelineArtifact(artifact: PipelineArtifact | null | undefined): artifact is PipelineBlobArtifact;
|
|
74
|
+
/**
|
|
75
|
+
* Шаг пайплайна.
|
|
76
|
+
*
|
|
77
|
+
* `waitsFor` — событие, которое **продвигает** автомат к этому шагу.
|
|
78
|
+
* Семантика:
|
|
79
|
+
* - **первый** шаг с `waitsFor` определяет **триггер** пайплайна: по приходу
|
|
80
|
+
* совпавшего события создаётся новый экземпляр автомата;
|
|
81
|
+
* - **последующие** шаги с `waitsFor` — **гейты**: событие означает сигнал
|
|
82
|
+
* «предыдущий шаг завершён (и подтверждён человеком)» — автомат ждёт его,
|
|
83
|
+
* чтобы перейти дальше (HITL, ADR-089/ADR-051).
|
|
84
|
+
*/
|
|
85
|
+
export declare const pipelineStepSchema: z.ZodObject<{
|
|
86
|
+
id: z.ZodString;
|
|
87
|
+
kind: z.ZodDefault<z.ZodEnum<{
|
|
88
|
+
agent: "agent";
|
|
89
|
+
loop: "loop";
|
|
90
|
+
}>>;
|
|
91
|
+
title: z.ZodOptional<z.ZodString>;
|
|
92
|
+
agent: z.ZodOptional<z.ZodString>;
|
|
93
|
+
skill: z.ZodOptional<z.ZodString>;
|
|
94
|
+
prompt: z.ZodOptional<z.ZodString>;
|
|
95
|
+
waitsFor: z.ZodOptional<z.ZodObject<{
|
|
96
|
+
source: z.ZodOptional<z.ZodString>;
|
|
97
|
+
type: z.ZodOptional<z.ZodString>;
|
|
98
|
+
}, z.core.$strip>>;
|
|
99
|
+
artifact: z.ZodOptional<z.ZodObject<{
|
|
100
|
+
kind: z.ZodString;
|
|
101
|
+
id: z.ZodOptional<z.ZodString>;
|
|
102
|
+
from: z.ZodOptional<z.ZodString>;
|
|
103
|
+
source: z.ZodOptional<z.ZodString>;
|
|
104
|
+
type: z.ZodOptional<z.ZodString>;
|
|
105
|
+
path: z.ZodOptional<z.ZodString>;
|
|
106
|
+
mime: z.ZodOptional<z.ZodString>;
|
|
107
|
+
size: z.ZodOptional<z.ZodNumber>;
|
|
108
|
+
name: z.ZodOptional<z.ZodString>;
|
|
109
|
+
payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
110
|
+
}, z.core.$strip>>;
|
|
111
|
+
timeoutSec: z.ZodOptional<z.ZodNumber>;
|
|
112
|
+
}, z.core.$strip>;
|
|
113
|
+
export type PipelineStep = z.infer<typeof pipelineStepSchema>;
|
|
114
|
+
/** Политика пайплайна при ошибке шага. */
|
|
115
|
+
export declare const pipelineErrorPolicySchema: z.ZodEnum<{
|
|
116
|
+
fail: "fail";
|
|
117
|
+
retry: "retry";
|
|
118
|
+
rollback: "rollback";
|
|
119
|
+
}>;
|
|
120
|
+
export type PipelineErrorPolicy = z.infer<typeof pipelineErrorPolicySchema>;
|
|
121
|
+
/**
|
|
122
|
+
* Определение пайплайна — декларация автомата (шаги, гейты, политика ошибок).
|
|
123
|
+
* Тот же контракт используется в `provides.pipelines` манифеста `synth.pack`
|
|
124
|
+
* (ADR-086 §5) — inline-определение вкладывается без преобразований.
|
|
125
|
+
*/
|
|
126
|
+
export declare const pipelineDefinitionSchema: z.ZodObject<{
|
|
127
|
+
id: z.ZodString;
|
|
128
|
+
name: z.ZodString;
|
|
129
|
+
description: z.ZodOptional<z.ZodString>;
|
|
130
|
+
version: z.ZodOptional<z.ZodString>;
|
|
131
|
+
steps: z.ZodArray<z.ZodObject<{
|
|
132
|
+
id: z.ZodString;
|
|
133
|
+
kind: z.ZodDefault<z.ZodEnum<{
|
|
134
|
+
agent: "agent";
|
|
135
|
+
loop: "loop";
|
|
136
|
+
}>>;
|
|
137
|
+
title: z.ZodOptional<z.ZodString>;
|
|
138
|
+
agent: z.ZodOptional<z.ZodString>;
|
|
139
|
+
skill: z.ZodOptional<z.ZodString>;
|
|
140
|
+
prompt: z.ZodOptional<z.ZodString>;
|
|
141
|
+
waitsFor: z.ZodOptional<z.ZodObject<{
|
|
142
|
+
source: z.ZodOptional<z.ZodString>;
|
|
143
|
+
type: z.ZodOptional<z.ZodString>;
|
|
144
|
+
}, z.core.$strip>>;
|
|
145
|
+
artifact: z.ZodOptional<z.ZodObject<{
|
|
146
|
+
kind: z.ZodString;
|
|
147
|
+
id: z.ZodOptional<z.ZodString>;
|
|
148
|
+
from: z.ZodOptional<z.ZodString>;
|
|
149
|
+
source: z.ZodOptional<z.ZodString>;
|
|
150
|
+
type: z.ZodOptional<z.ZodString>;
|
|
151
|
+
path: z.ZodOptional<z.ZodString>;
|
|
152
|
+
mime: z.ZodOptional<z.ZodString>;
|
|
153
|
+
size: z.ZodOptional<z.ZodNumber>;
|
|
154
|
+
name: z.ZodOptional<z.ZodString>;
|
|
155
|
+
payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
156
|
+
}, z.core.$strip>>;
|
|
157
|
+
timeoutSec: z.ZodOptional<z.ZodNumber>;
|
|
158
|
+
}, z.core.$strip>>;
|
|
159
|
+
onError: z.ZodOptional<z.ZodEnum<{
|
|
160
|
+
fail: "fail";
|
|
161
|
+
retry: "retry";
|
|
162
|
+
rollback: "rollback";
|
|
163
|
+
}>>;
|
|
164
|
+
maxAttempts: z.ZodOptional<z.ZodNumber>;
|
|
165
|
+
ttl: z.ZodOptional<z.ZodString>;
|
|
166
|
+
}, z.core.$strip>;
|
|
167
|
+
export type PipelineDefinition = z.infer<typeof pipelineDefinitionSchema>;
|
|
168
|
+
/** Статус экземпляра пайплайна. */
|
|
169
|
+
export declare const pipelineInstanceStatusSchema: z.ZodEnum<{
|
|
170
|
+
pending: "pending";
|
|
171
|
+
cancelled: "cancelled";
|
|
172
|
+
failed: "failed";
|
|
173
|
+
running: "running";
|
|
174
|
+
waiting: "waiting";
|
|
175
|
+
done: "done";
|
|
176
|
+
}>;
|
|
177
|
+
export type PipelineInstanceStatus = z.infer<typeof pipelineInstanceStatusSchema>;
|
|
178
|
+
/** Статус шага внутри экземпляра. */
|
|
179
|
+
export declare const pipelineStepStatusSchema: z.ZodEnum<{
|
|
180
|
+
pending: "pending";
|
|
181
|
+
failed: "failed";
|
|
182
|
+
skipped: "skipped";
|
|
183
|
+
running: "running";
|
|
184
|
+
done: "done";
|
|
185
|
+
}>;
|
|
186
|
+
export type PipelineStepStatus = z.infer<typeof pipelineStepStatusSchema>;
|
|
187
|
+
/** Состояние шага в экземпляре пайплайна. */
|
|
188
|
+
export declare const pipelineStepStateSchema: z.ZodObject<{
|
|
189
|
+
id: z.ZodString;
|
|
190
|
+
status: z.ZodEnum<{
|
|
191
|
+
pending: "pending";
|
|
192
|
+
failed: "failed";
|
|
193
|
+
skipped: "skipped";
|
|
194
|
+
running: "running";
|
|
195
|
+
done: "done";
|
|
196
|
+
}>;
|
|
197
|
+
sessionId: z.ZodOptional<z.ZodString>;
|
|
198
|
+
startedAt: z.ZodOptional<z.ZodString>;
|
|
199
|
+
finishedAt: z.ZodOptional<z.ZodString>;
|
|
200
|
+
error: z.ZodOptional<z.ZodString>;
|
|
201
|
+
artifact: z.ZodOptional<z.ZodObject<{
|
|
202
|
+
kind: z.ZodString;
|
|
203
|
+
id: z.ZodOptional<z.ZodString>;
|
|
204
|
+
from: z.ZodOptional<z.ZodString>;
|
|
205
|
+
source: z.ZodOptional<z.ZodString>;
|
|
206
|
+
type: z.ZodOptional<z.ZodString>;
|
|
207
|
+
path: z.ZodOptional<z.ZodString>;
|
|
208
|
+
mime: z.ZodOptional<z.ZodString>;
|
|
209
|
+
size: z.ZodOptional<z.ZodNumber>;
|
|
210
|
+
name: z.ZodOptional<z.ZodString>;
|
|
211
|
+
payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
212
|
+
}, z.core.$strip>>;
|
|
213
|
+
}, z.core.$strip>;
|
|
214
|
+
export type PipelineStepState = z.infer<typeof pipelineStepStateSchema>;
|
|
215
|
+
/** Триггер, породивший экземпляр пайплайна. */
|
|
216
|
+
export declare const pipelineTriggerSchema: z.ZodObject<{
|
|
217
|
+
source: z.ZodOptional<z.ZodString>;
|
|
218
|
+
type: z.ZodOptional<z.ZodString>;
|
|
219
|
+
dedupKey: z.ZodOptional<z.ZodString>;
|
|
220
|
+
payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
221
|
+
}, z.core.$strip>;
|
|
222
|
+
export type PipelineTrigger = z.infer<typeof pipelineTriggerSchema>;
|
|
223
|
+
/** Экземпляр пайплайна — конкретный прогон автомата. */
|
|
224
|
+
export declare const pipelineInstanceSchema: z.ZodObject<{
|
|
225
|
+
id: z.ZodString;
|
|
226
|
+
pipelineId: z.ZodString;
|
|
227
|
+
pipelineVersion: z.ZodOptional<z.ZodString>;
|
|
228
|
+
status: z.ZodEnum<{
|
|
229
|
+
pending: "pending";
|
|
230
|
+
cancelled: "cancelled";
|
|
231
|
+
failed: "failed";
|
|
232
|
+
running: "running";
|
|
233
|
+
waiting: "waiting";
|
|
234
|
+
done: "done";
|
|
235
|
+
}>;
|
|
236
|
+
trigger: z.ZodOptional<z.ZodObject<{
|
|
237
|
+
source: z.ZodOptional<z.ZodString>;
|
|
238
|
+
type: z.ZodOptional<z.ZodString>;
|
|
239
|
+
dedupKey: z.ZodOptional<z.ZodString>;
|
|
240
|
+
payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
241
|
+
}, z.core.$strip>>;
|
|
242
|
+
steps: z.ZodArray<z.ZodObject<{
|
|
243
|
+
id: z.ZodString;
|
|
244
|
+
status: z.ZodEnum<{
|
|
245
|
+
pending: "pending";
|
|
246
|
+
failed: "failed";
|
|
247
|
+
skipped: "skipped";
|
|
248
|
+
running: "running";
|
|
249
|
+
done: "done";
|
|
250
|
+
}>;
|
|
251
|
+
sessionId: z.ZodOptional<z.ZodString>;
|
|
252
|
+
startedAt: z.ZodOptional<z.ZodString>;
|
|
253
|
+
finishedAt: z.ZodOptional<z.ZodString>;
|
|
254
|
+
error: z.ZodOptional<z.ZodString>;
|
|
255
|
+
artifact: z.ZodOptional<z.ZodObject<{
|
|
256
|
+
kind: z.ZodString;
|
|
257
|
+
id: z.ZodOptional<z.ZodString>;
|
|
258
|
+
from: z.ZodOptional<z.ZodString>;
|
|
259
|
+
source: z.ZodOptional<z.ZodString>;
|
|
260
|
+
type: z.ZodOptional<z.ZodString>;
|
|
261
|
+
path: z.ZodOptional<z.ZodString>;
|
|
262
|
+
mime: z.ZodOptional<z.ZodString>;
|
|
263
|
+
size: z.ZodOptional<z.ZodNumber>;
|
|
264
|
+
name: z.ZodOptional<z.ZodString>;
|
|
265
|
+
payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
266
|
+
}, z.core.$strip>>;
|
|
267
|
+
}, z.core.$strip>>;
|
|
268
|
+
currentStep: z.ZodOptional<z.ZodString>;
|
|
269
|
+
attempts: z.ZodNumber;
|
|
270
|
+
payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
271
|
+
error: z.ZodOptional<z.ZodString>;
|
|
272
|
+
createdAt: z.ZodString;
|
|
273
|
+
updatedAt: z.ZodString;
|
|
274
|
+
}, z.core.$strip>;
|
|
275
|
+
export type PipelineInstance = z.infer<typeof pipelineInstanceSchema>;
|
|
@@ -0,0 +1,212 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-051 (шедулер и пайплайны) + ADR-100 (Pipeline Automation): контракт
|
|
3
|
+
* пайплайна — определение, шаг, состояние шага и экземпляр автомата.
|
|
4
|
+
*
|
|
5
|
+
* Здесь только типы и zod-схемы (browser-safe, без `node:*`): сам рантайм
|
|
6
|
+
* пайплайнов (создание экземпляра, доставка шага, HITL-гейты) ещё не
|
|
7
|
+
* реализован — он в объёме ADR-100. Контракт заводится заранее, чтобы
|
|
8
|
+
* манифест расширения (`synth.pack`, ADR-086 §5) мог объявлять пайплайны.
|
|
9
|
+
*/
|
|
10
|
+
import { z } from 'zod';
|
|
11
|
+
/**
|
|
12
|
+
* Вид шага пайплайна:
|
|
13
|
+
* - `agent` — шаг с агентом (основной вид, значение по умолчанию);
|
|
14
|
+
* - `loop` — резерв под Loop Engine (PROP-057, вне объёма сейчас).
|
|
15
|
+
*/
|
|
16
|
+
export const pipelineStepKindSchema = z.enum(['agent', 'loop']);
|
|
17
|
+
/**
|
|
18
|
+
* Совпадение с внешним событием — триггер шага/пайплайна.
|
|
19
|
+
*
|
|
20
|
+
* Форма — **сужение** `eventRouteMatchSchema` (ADR-089, `schemas/index.ts`)
|
|
21
|
+
* до полей, осмысленных для автомата: `source` + `type`. Полную схему правил
|
|
22
|
+
* маршрутизации здесь не переиспользуем намеренно:
|
|
23
|
+
* - она несёт поля смысла роутера (`chatKey`/`threadKey`/`principalId`/
|
|
24
|
+
* `label`/`keywords`), а не триггера пайплайна;
|
|
25
|
+
* - она лежит в `schemas/`, который импортирует `types/` — прямой импорт
|
|
26
|
+
* дал бы цикл `types → schemas → types`.
|
|
27
|
+
*/
|
|
28
|
+
export const eventMatchSchema = z.object({
|
|
29
|
+
/** Источник события (напр. `ci`, `tg`, `cron`). */
|
|
30
|
+
source: z.string().optional(),
|
|
31
|
+
/** Тип события (напр. `release.created`). */
|
|
32
|
+
type: z.string().optional(),
|
|
33
|
+
});
|
|
34
|
+
/**
|
|
35
|
+
* Вид артефакта-объекта blob-хранилища (ADR-101 §9, ADR-116 §3).
|
|
36
|
+
*
|
|
37
|
+
* Байты артефакта прогона лежат в общем blob-порте, `path` — путь объекта
|
|
38
|
+
* (`artifacts/<runId>/<name>`); учёт ссылок — `blob_refs`
|
|
39
|
+
* (`ownerKind: 'pipeline-run'`). Отдельного хранилища артефактов нет
|
|
40
|
+
* (решение 2026-10-27, ADR-101 §«Открытые вопросы»).
|
|
41
|
+
*/
|
|
42
|
+
export const PIPELINE_ARTIFACT_BLOB_KIND = 'blob';
|
|
43
|
+
/**
|
|
44
|
+
* Артефакт шага (ADR-100: передача артефактов между шагами): что шаг
|
|
45
|
+
* произвёл (`kind`) и откуда взялось (`from`).
|
|
46
|
+
*
|
|
47
|
+
* Поля `path`/`mime`/`size`/`name` — **аддитивное** расширение для
|
|
48
|
+
* артефакта-объекта (`kind: 'blob'`, ADR-116): старые записи без них
|
|
49
|
+
* остаются валидными.
|
|
50
|
+
*/
|
|
51
|
+
export const pipelineArtifactSchema = z.object({
|
|
52
|
+
/** Вид артефакта (напр. `draft`, `report`, `blob`). */
|
|
53
|
+
kind: z.string().min(1),
|
|
54
|
+
/** Идентификатор артефакта (если он адресуем). */
|
|
55
|
+
id: z.string().optional(),
|
|
56
|
+
/** Источник артефакта (путь/ссылка/идентификатор предыдущего шага). */
|
|
57
|
+
from: z.string().optional(),
|
|
58
|
+
/** Источник события, породившего артефакт (для артефакта-события). */
|
|
59
|
+
source: z.string().optional(),
|
|
60
|
+
/** Тип события, породившего артефакт (для артефакта-события). */
|
|
61
|
+
type: z.string().optional(),
|
|
62
|
+
/** Путь объекта в blob-хранилище (`kind: 'blob'`, ADR-116). */
|
|
63
|
+
path: z.string().optional(),
|
|
64
|
+
/** MIME-тип содержимого артефакта-объекта. */
|
|
65
|
+
mime: z.string().optional(),
|
|
66
|
+
/** Размер содержимого артефакта-объекта, байт. */
|
|
67
|
+
size: z.number().int().min(0).optional(),
|
|
68
|
+
/** Имя файла артефакта-объекта (для раздачи/`Content-Disposition`). */
|
|
69
|
+
name: z.string().optional(),
|
|
70
|
+
/**
|
|
71
|
+
* Данные артефакта (напр. payload события, которым шаг продвинул автомат).
|
|
72
|
+
* Именно это «содержимое» получает следующий шаг пайплайна.
|
|
73
|
+
*/
|
|
74
|
+
payload: z.record(z.string(), z.unknown()).optional(),
|
|
75
|
+
});
|
|
76
|
+
/** Является ли артефакт объектом blob-хранилища (`kind: 'blob'` + `path`). */
|
|
77
|
+
export function isBlobPipelineArtifact(artifact) {
|
|
78
|
+
return (!!artifact &&
|
|
79
|
+
artifact.kind === PIPELINE_ARTIFACT_BLOB_KIND &&
|
|
80
|
+
typeof artifact.path === 'string' &&
|
|
81
|
+
artifact.path.length > 0);
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Шаг пайплайна.
|
|
85
|
+
*
|
|
86
|
+
* `waitsFor` — событие, которое **продвигает** автомат к этому шагу.
|
|
87
|
+
* Семантика:
|
|
88
|
+
* - **первый** шаг с `waitsFor` определяет **триггер** пайплайна: по приходу
|
|
89
|
+
* совпавшего события создаётся новый экземпляр автомата;
|
|
90
|
+
* - **последующие** шаги с `waitsFor` — **гейты**: событие означает сигнал
|
|
91
|
+
* «предыдущий шаг завершён (и подтверждён человеком)» — автомат ждёт его,
|
|
92
|
+
* чтобы перейти дальше (HITL, ADR-089/ADR-051).
|
|
93
|
+
*/
|
|
94
|
+
export const pipelineStepSchema = z.object({
|
|
95
|
+
/** Идентификатор шага (уникален в пределах определения). */
|
|
96
|
+
id: z.string().min(1),
|
|
97
|
+
/** Вид шага; по умолчанию — `agent`. */
|
|
98
|
+
kind: pipelineStepKindSchema.default('agent'),
|
|
99
|
+
/** Человекочитаемое название шага. */
|
|
100
|
+
title: z.string().optional(),
|
|
101
|
+
/** Агент, исполняющий шаг (id агента инстанса/пака). */
|
|
102
|
+
agent: z.string().optional(),
|
|
103
|
+
/** Скилл, используемый шагом. */
|
|
104
|
+
skill: z.string().optional(),
|
|
105
|
+
/** Промпт/задание для агента. */
|
|
106
|
+
prompt: z.string().optional(),
|
|
107
|
+
/** Событие-продвижение (триггер пайплайна или гейт). */
|
|
108
|
+
waitsFor: eventMatchSchema.optional(),
|
|
109
|
+
/** Артефакт, который шаг производит (или потребляет). */
|
|
110
|
+
artifact: pipelineArtifactSchema.optional(),
|
|
111
|
+
/** Таймаут шага в секундах. */
|
|
112
|
+
timeoutSec: z.number().int().positive().optional(),
|
|
113
|
+
});
|
|
114
|
+
/** Политика пайплайна при ошибке шага. */
|
|
115
|
+
export const pipelineErrorPolicySchema = z.enum(['fail', 'retry', 'rollback']);
|
|
116
|
+
/**
|
|
117
|
+
* Определение пайплайна — декларация автомата (шаги, гейты, политика ошибок).
|
|
118
|
+
* Тот же контракт используется в `provides.pipelines` манифеста `synth.pack`
|
|
119
|
+
* (ADR-086 §5) — inline-определение вкладывается без преобразований.
|
|
120
|
+
*/
|
|
121
|
+
export const pipelineDefinitionSchema = z.object({
|
|
122
|
+
/** Идентификатор пайплайна (уникален в пределах пака/инстанса). */
|
|
123
|
+
id: z.string().min(1),
|
|
124
|
+
/** Человекочитаемое имя. */
|
|
125
|
+
name: z.string().min(1),
|
|
126
|
+
/** Краткое описание. */
|
|
127
|
+
description: z.string().optional(),
|
|
128
|
+
/** Версия определения (semver-строка). */
|
|
129
|
+
version: z.string().optional(),
|
|
130
|
+
/** Шаги пайплайна; минимум один. */
|
|
131
|
+
steps: z.array(pipelineStepSchema).min(1, 'пайплайн: нужен хотя бы один шаг'),
|
|
132
|
+
/** Что делать при ошибке шага. */
|
|
133
|
+
onError: pipelineErrorPolicySchema.optional(),
|
|
134
|
+
/** Максимум попыток перезапуска экземпляра. */
|
|
135
|
+
maxAttempts: z.number().int().positive().optional(),
|
|
136
|
+
/** TTL экземпляра (строка-длительность, как у `Schedule.target.ttl`). */
|
|
137
|
+
ttl: z.string().optional(),
|
|
138
|
+
});
|
|
139
|
+
/** Статус экземпляра пайплайна. */
|
|
140
|
+
export const pipelineInstanceStatusSchema = z.enum([
|
|
141
|
+
'pending',
|
|
142
|
+
'running',
|
|
143
|
+
'waiting',
|
|
144
|
+
'done',
|
|
145
|
+
'failed',
|
|
146
|
+
'cancelled',
|
|
147
|
+
]);
|
|
148
|
+
/** Статус шага внутри экземпляра. */
|
|
149
|
+
export const pipelineStepStatusSchema = z.enum([
|
|
150
|
+
'pending',
|
|
151
|
+
'running',
|
|
152
|
+
'done',
|
|
153
|
+
'failed',
|
|
154
|
+
'skipped',
|
|
155
|
+
]);
|
|
156
|
+
/** Состояние шага в экземпляре пайплайна. */
|
|
157
|
+
export const pipelineStepStateSchema = z.object({
|
|
158
|
+
/** Идентификатор шага (совпадает с `PipelineStep.id`). */
|
|
159
|
+
id: z.string().min(1),
|
|
160
|
+
status: pipelineStepStatusSchema,
|
|
161
|
+
/** Сессия агента, исполнявшая шаг. */
|
|
162
|
+
sessionId: z.string().optional(),
|
|
163
|
+
/** ISO-время старта шага. */
|
|
164
|
+
startedAt: z.string().optional(),
|
|
165
|
+
/** ISO-время завершения шага. */
|
|
166
|
+
finishedAt: z.string().optional(),
|
|
167
|
+
/** Текст ошибки (при `status: 'failed'`). */
|
|
168
|
+
error: z.string().optional(),
|
|
169
|
+
/** Произведённый артефакт. */
|
|
170
|
+
artifact: pipelineArtifactSchema.optional(),
|
|
171
|
+
});
|
|
172
|
+
/** Триггер, породивший экземпляр пайплайна. */
|
|
173
|
+
export const pipelineTriggerSchema = z.object({
|
|
174
|
+
/** Источник события (напр. `ci`). */
|
|
175
|
+
source: z.string().optional(),
|
|
176
|
+
/** Тип события (напр. `release.created`). */
|
|
177
|
+
type: z.string().optional(),
|
|
178
|
+
/** Ключ дедупликации (повторное событие не создаёт новый экземпляр). */
|
|
179
|
+
dedupKey: z.string().optional(),
|
|
180
|
+
/** Payload события, породившего (продвинувшего) автомат. */
|
|
181
|
+
payload: z.record(z.string(), z.unknown()).optional(),
|
|
182
|
+
});
|
|
183
|
+
/** Экземпляр пайплайна — конкретный прогон автомата. */
|
|
184
|
+
export const pipelineInstanceSchema = z.object({
|
|
185
|
+
/** Идентификатор экземпляра. */
|
|
186
|
+
id: z.string().min(1),
|
|
187
|
+
/** Идентификатор определения пайплайна. */
|
|
188
|
+
pipelineId: z.string().min(1),
|
|
189
|
+
/** Версия определения, по которой запущен экземпляр. */
|
|
190
|
+
pipelineVersion: z.string().optional(),
|
|
191
|
+
status: pipelineInstanceStatusSchema,
|
|
192
|
+
/** Событие, породившее экземпляр. */
|
|
193
|
+
trigger: pipelineTriggerSchema.optional(),
|
|
194
|
+
/** Состояния шагов. */
|
|
195
|
+
steps: z.array(pipelineStepStateSchema),
|
|
196
|
+
/** Идентификатор текущего (исполняемого/ожидающего) шага. */
|
|
197
|
+
currentStep: z.string().optional(),
|
|
198
|
+
/** Число попыток перезапуска. */
|
|
199
|
+
attempts: z.number().int().min(0),
|
|
200
|
+
/**
|
|
201
|
+
* Payload исходного события-триггера (неизменяемый). Актуальный payload
|
|
202
|
+
* продвижения лежит в `trigger.payload` — он перезаписывается на каждом
|
|
203
|
+
* гейте, а этот — хранит исходный.
|
|
204
|
+
*/
|
|
205
|
+
payload: z.record(z.string(), z.unknown()).optional(),
|
|
206
|
+
/** Текст ошибки экземпляра. */
|
|
207
|
+
error: z.string().optional(),
|
|
208
|
+
/** ISO-время создания. */
|
|
209
|
+
createdAt: z.string(),
|
|
210
|
+
/** ISO-время последнего обновления. */
|
|
211
|
+
updatedAt: z.string(),
|
|
212
|
+
});
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-090: журнал аудита плагинов — **отдельный** тип и **отдельный** scope.
|
|
3
|
+
*
|
|
4
|
+
* Чем отличается от `SecurityAuditEntry` (`types/egress.ts`): security-аудит
|
|
5
|
+
* фиксирует **изменение политики** (scope `tools|webhooks|mcp|proxy|tls`,
|
|
6
|
+
* actions `update|reset`), а журнал плагинов — **жизненный цикл расширения**
|
|
7
|
+
* (активация/деактивация) с доверием, вердиктом скана и целостностью.
|
|
8
|
+
* Семантики разные ⇒ `SECURITY_AUDIT_SCOPES` **не расширяется** (это было бы
|
|
9
|
+
* смешением «изменение политики» и «событие расширения» в одном журнале).
|
|
10
|
+
*
|
|
11
|
+
* Хранилище — доменный порт `PluginAuditRepository` (ADR-096), файловая
|
|
12
|
+
* реализация — `{dataDir}/audit/plugins.jsonl` (append-only JSONL).
|
|
13
|
+
* Секреты в журнал не пишутся (инвариант 13).
|
|
14
|
+
*/
|
|
15
|
+
import type { PackPluginMode } from './pack.js';
|
|
16
|
+
import type { CatalogTrustLevel } from './trust.js';
|
|
17
|
+
/**
|
|
18
|
+
* Виды операций журнала плагинов (ADR-090).
|
|
19
|
+
*
|
|
20
|
+
* Ф1 реализовал `activate`/`deactivate`; Ф2 добавил `scan` (сканер и
|
|
21
|
+
* install-policy — вердикт и число находок пишутся отдельной записью, чтобы по
|
|
22
|
+
* журналу было видно, **чем** решена активация); Ф3б добавил `filter` —
|
|
23
|
+
* события решений фильтров LLM-вызовов (точка `llmFilters`): понижение вето
|
|
24
|
+
* недоверенного фильтра, блокировка вызова доверенным фильтром, сбой/таймаут
|
|
25
|
+
* фильтра. Ф5а добавил `install`/`uninstall` — события установки
|
|
26
|
+
* (`PluginInstaller`: манифест → скан → trust-floor → install-policy →
|
|
27
|
+
* раскладка → lock) и снятия (деактивация → lock → каталог). Долги Д2
|
|
28
|
+
* добавили `rollback` — явный откат на предыдущую версию (в журнале он
|
|
29
|
+
* отличается от установки: `install` фиксирует новую версию, `rollback` —
|
|
30
|
+
* возврат). Ф7 добавил `token` — выдача server-scoped токена плагину (Уровень 2
|
|
31
|
+
* гибридного режима): в журнале — имя плагина и факт выдачи, секрет токена не
|
|
32
|
+
* пишется (инвариант 13).
|
|
33
|
+
*
|
|
34
|
+
* Порядок — жизненный цикл расширения: установка → активация → деактивация →
|
|
35
|
+
* откат версии → снятие, затем диагностические действия (`scan`/`filter`) и
|
|
36
|
+
* выдача токена (`token`).
|
|
37
|
+
*/
|
|
38
|
+
export declare const PLUGIN_AUDIT_ACTIONS: readonly ["install", "activate", "deactivate", "rollback", "uninstall", "scan", "filter", "token"];
|
|
39
|
+
export type PluginAuditAction = (typeof PLUGIN_AUDIT_ACTIONS)[number];
|
|
40
|
+
/**
|
|
41
|
+
* Итог операции журнала плагинов:
|
|
42
|
+
* - `ok` — плагин активен (активация состоялась / деактивация выполнена);
|
|
43
|
+
* - `rejected` — активация **не состоялась** (отказ по гейту или остановка).
|
|
44
|
+
*/
|
|
45
|
+
export declare const PLUGIN_AUDIT_OUTCOMES: readonly ["ok", "rejected"];
|
|
46
|
+
export type PluginAuditOutcome = (typeof PLUGIN_AUDIT_OUTCOMES)[number];
|
|
47
|
+
/**
|
|
48
|
+
* Вердикт статического сканера (PROP-068 §4.3: `severity → verdict`).
|
|
49
|
+
* Сканер появляется в Ф2; перечень verdict'ов уже зафиксирован канонически.
|
|
50
|
+
*/
|
|
51
|
+
export declare const PLUGIN_SCAN_VERDICTS: readonly ["safe", "caution", "dangerous"];
|
|
52
|
+
export type PluginScanVerdict = (typeof PLUGIN_SCAN_VERDICTS)[number];
|
|
53
|
+
/**
|
|
54
|
+
* Машиночитаемые коды причин в журнале плагинов.
|
|
55
|
+
*
|
|
56
|
+
* Источник истины — загрузчик `PluginHost`
|
|
57
|
+
* (`packages/core/src/engine/plugins/plugin-host.ts`): каждый отказ пайплайна
|
|
58
|
+
* активации даёт свой код, поэтому по журналу видно, **на каком гейте**
|
|
59
|
+
* плагин не прошёл.
|
|
60
|
+
*/
|
|
61
|
+
export declare const PLUGIN_AUDIT_REASONS: readonly ["plugin.not_found", "plugin.source_unavailable", "plugin.rollback_unavailable", "plugin.manifest_invalid", "plugin.integrity_mismatch", "plugin.integrity_unverifiable", "plugin.contract_mismatch", "plugin.host_mismatch", "plugin.trust_below_floor", "plugin.scan_rejected", "plugin.approval_required", "plugin.approval_expired", "plugin.approval_stale", "plugin.disabled", "plugin.not_allowlisted", "plugin.denylisted", "plugin.runtime_install_denied", "plugin.scan_disabled_with_execution", "plugin.execution_disabled", "plugin.loader_unavailable", "plugin.module_invalid", "plugin.remote_entry_missing", "plugin.already_active", "plugin.not_active", "plugin.disposer_failed", "plugin.provides_mismatch", "plugin_filter.deny_downgraded", "plugin_filter.denied", "plugin_filter.unavailable", "plugin.managed_readonly", "plugin.hybrid_not_allowed"];
|
|
62
|
+
export type PluginAuditReason = (typeof PLUGIN_AUDIT_REASONS)[number];
|
|
63
|
+
/**
|
|
64
|
+
* Одна запись журнала аудита плагинов (append-only).
|
|
65
|
+
*
|
|
66
|
+
* `id` формирует вызывающий (`pa_<uuid>`), `ts` — ISO-8601. `actor` —
|
|
67
|
+
* инициатор (`userId` при API/UI, `'cli'` при командной строке, `'startup'` при
|
|
68
|
+
* активации на старте). При `outcome: 'ok'` поле `reason` — примечание
|
|
69
|
+
* (сейчас — `plugin.disposer_failed`); при `outcome: 'rejected'` — код отказа.
|
|
70
|
+
*/
|
|
71
|
+
export interface PluginAuditEntry {
|
|
72
|
+
/** `pa_<uuid>`, уникален в пределах инстанса. */
|
|
73
|
+
id: string;
|
|
74
|
+
/** Метка события, ISO-8601. */
|
|
75
|
+
ts: string;
|
|
76
|
+
/** Инициатор операции. */
|
|
77
|
+
actor: string;
|
|
78
|
+
/** Scope журнала — всегда `plugin` (отдельная семантика от security-аудита). */
|
|
79
|
+
scope: 'plugin';
|
|
80
|
+
/** Вид операции: установка/активация/деактивация/откат/снятие/скан/фильтр. */
|
|
81
|
+
action: PluginAuditAction;
|
|
82
|
+
/** Имя плагина (из манифеста `synth.pack`). */
|
|
83
|
+
plugin: string;
|
|
84
|
+
/** Версия плагина (semver). */
|
|
85
|
+
version: string;
|
|
86
|
+
/** Фактический уровень доверия (резолвится по источнику, не по манифесту). */
|
|
87
|
+
trustLevel?: CatalogTrustLevel;
|
|
88
|
+
/** Вердикт статического сканера (Ф2+). */
|
|
89
|
+
scanVerdict?: PluginScanVerdict;
|
|
90
|
+
/**
|
|
91
|
+
* Число находок сканера (Ф2). Заполняется в записях действия `scan`.
|
|
92
|
+
*/
|
|
93
|
+
scanFindings?: number;
|
|
94
|
+
/**
|
|
95
|
+
* Выполнялся ли скан (Ф2). `false` — скан **выключен политикой**
|
|
96
|
+
* (`plugins.scan: 'disabled'`) или сканировать было нечего; вердикт в этом
|
|
97
|
+
* случае по умолчанию `safe`, но по журналу видно, что скана не было.
|
|
98
|
+
*/
|
|
99
|
+
scanPerformed?: boolean;
|
|
100
|
+
/** Content-hash бандла (sha256 от отсортированного набора файлов). */
|
|
101
|
+
contentHash?: string;
|
|
102
|
+
/** Режим исполнения, объявленный манифестом (`inline`/`remote`/`both`). */
|
|
103
|
+
mode?: PackPluginMode;
|
|
104
|
+
/** Итог операции. */
|
|
105
|
+
outcome: PluginAuditOutcome;
|
|
106
|
+
/** Код причины (машиночитаемый). */
|
|
107
|
+
reason?: PluginAuditReason;
|
|
108
|
+
/** Источник установки (`npm`/`local`/`catalog`/`builtin`/…). */
|
|
109
|
+
source?: string;
|
|
110
|
+
}
|