@itphx/synth-shared 0.11.3 → 0.12.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 +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,440 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-101 (Pipeline Engine): контракты пайплайна как **второго движка**.
|
|
3
|
+
*
|
|
4
|
+
* Формат и устройство — [docs/PIPELINES.md](../../../../docs/PIPELINES.md)
|
|
5
|
+
* (Spec, часть II) и сам ADR-101. Здесь только типы и zod-схемы
|
|
6
|
+
* (browser-safe, без `node:*`): исполнение пайплайнов (движок, виды шагов,
|
|
7
|
+
* журнал, порты хранилища) — в core (этапы Э2–Э5).
|
|
8
|
+
*
|
|
9
|
+
* Модуль **не заменяет** контракты ADR-100 (`types/pipeline.ts`): они
|
|
10
|
+
* объявляют пайплайн как «декларация + учёт прогона» и уходят в Э2–Э3,
|
|
11
|
+
* поэтому имена новых схем не пересекаются с legacy (`pipelineSpec*`/
|
|
12
|
+
* `pipelineRun*`).
|
|
13
|
+
*/
|
|
14
|
+
import { z } from 'zod';
|
|
15
|
+
import { pipelineArtifactSchema } from './pipeline.js';
|
|
16
|
+
// --- Режимы и виды ---
|
|
17
|
+
/**
|
|
18
|
+
* Режим пайплайна (`plan`/`act`/`yolo`) — объявляется спецификацией и
|
|
19
|
+
* применяется permission-слоем (ADR-025/ADR-028/ADR-029), не хардкодом в
|
|
20
|
+
* тулах.
|
|
21
|
+
*/
|
|
22
|
+
export const PIPELINE_MODES = ['plan', 'act', 'yolo'];
|
|
23
|
+
export const pipelineModeSchema = z.enum(PIPELINE_MODES);
|
|
24
|
+
/**
|
|
25
|
+
* Вид узла пайплайна:
|
|
26
|
+
* - `agent` — свой Tool-Use-цикл внутри движка (LLM — только через
|
|
27
|
+
* `GatewayProvider`, ADR-036);
|
|
28
|
+
* - `script` — только через shell-policy (не голой `child_process`);
|
|
29
|
+
* - `tool` — через `ToolRegistry` + `executeToolDef`;
|
|
30
|
+
* - `human` — HITL-гейт: прогон встаёт на паузу и ждёт действия человека.
|
|
31
|
+
*/
|
|
32
|
+
export const pipelineNodeKindSchema = z.enum(['agent', 'script', 'tool', 'human']);
|
|
33
|
+
/**
|
|
34
|
+
* Вид выхода пайплайна: `session` (создать/продолжить сессию), `file`
|
|
35
|
+
* (артефакт в workspace проекта), `gateway` (событие/webhook наружу),
|
|
36
|
+
* `none` (прогон завершается без внешнего следа).
|
|
37
|
+
*/
|
|
38
|
+
export const pipelineExitKindSchema = z.enum(['session', 'file', 'gateway', 'none']);
|
|
39
|
+
/**
|
|
40
|
+
* Оператор условия перехода — **структурированный DSL, никакого `eval`**:
|
|
41
|
+
* `eq`/`ne` — равенство/неравенство, `in` — вхождение в массив, `exists` —
|
|
42
|
+
* наличие значения по пути, `gt`/`lt` — сравнение чисел.
|
|
43
|
+
*/
|
|
44
|
+
export const pipelineConditionOpSchema = z.enum(['eq', 'ne', 'in', 'exists', 'gt', 'lt']);
|
|
45
|
+
/** Схема границы пайплайна (JSON Schema в урезанном виде). */
|
|
46
|
+
export const jsonSchemaLikeSchema = z.lazy(() => z
|
|
47
|
+
.object({
|
|
48
|
+
type: z.string().optional(),
|
|
49
|
+
properties: z.record(z.string(), jsonSchemaLikeSchema).optional(),
|
|
50
|
+
required: z.array(z.string()).optional(),
|
|
51
|
+
})
|
|
52
|
+
.passthrough());
|
|
53
|
+
// --- Условия и переходы ---
|
|
54
|
+
/** Скалярное значение условия (литерал, без вложенных объектов). */
|
|
55
|
+
const pipelineConditionScalarSchema = z.union([
|
|
56
|
+
z.string(),
|
|
57
|
+
z.number(),
|
|
58
|
+
z.boolean(),
|
|
59
|
+
z.null(),
|
|
60
|
+
]);
|
|
61
|
+
/**
|
|
62
|
+
* Значение условия — скаляр или массив скаляров (литерал; произвольные
|
|
63
|
+
* объекты в условии не допускаются).
|
|
64
|
+
*/
|
|
65
|
+
const pipelineConditionValueSchema = z.union([
|
|
66
|
+
pipelineConditionScalarSchema,
|
|
67
|
+
z.array(pipelineConditionScalarSchema),
|
|
68
|
+
]);
|
|
69
|
+
/**
|
|
70
|
+
* Условие перехода `{ path, op, value }`.
|
|
71
|
+
*
|
|
72
|
+
* `path` — точечный путь к данным прогона: `prev.output.x` (выход
|
|
73
|
+
* предыдущего узла), `trigger.payload.y` (payload триггера), `vars.z`
|
|
74
|
+
* (переменная спецификации). Сравнение тип-строгое: при несовпадении типов
|
|
75
|
+
* условие не выполнено (fail-soft, без исключения прогона).
|
|
76
|
+
*/
|
|
77
|
+
export const pipelineConditionSchema = z.object({
|
|
78
|
+
/** Путь к значению (`prev.output.x` / `trigger.payload.y` / `vars.z`). */
|
|
79
|
+
path: z.string().min(1),
|
|
80
|
+
/** Оператор сравнения. */
|
|
81
|
+
op: pipelineConditionOpSchema,
|
|
82
|
+
/** Литерал сравнения (не нужен для `exists`). */
|
|
83
|
+
value: pipelineConditionValueSchema.optional(),
|
|
84
|
+
});
|
|
85
|
+
/**
|
|
86
|
+
* Условный переход из узла: при выполнении условия `when` прогон идёт в узел
|
|
87
|
+
* `then`.
|
|
88
|
+
*/
|
|
89
|
+
export const pipelineSpecEdgeSchema = z.object({
|
|
90
|
+
/** Условие перехода. */
|
|
91
|
+
when: pipelineConditionSchema,
|
|
92
|
+
/** Идентификатор узла-цели (должен существовать в спецификации). */
|
|
93
|
+
then: z.string().min(1),
|
|
94
|
+
});
|
|
95
|
+
// --- Узел ---
|
|
96
|
+
/**
|
|
97
|
+
* Узел пайплайна (шаг графа).
|
|
98
|
+
*
|
|
99
|
+
* Вход узла задаётся **маппингом** (`input`): в запрос к LLM попадает не
|
|
100
|
+
* вся история, а только отображённое маппингом — выход предыдущего узла
|
|
101
|
+
* (`prev.output.*`), payload триггера (`trigger.payload.*`) и явно заданные
|
|
102
|
+
* переменные (`vars.*`).
|
|
103
|
+
*/
|
|
104
|
+
export const pipelineSpecNodeSchema = z.object({
|
|
105
|
+
/** Идентификатор узла (уникален в пределах спецификации). */
|
|
106
|
+
id: z.string().min(1),
|
|
107
|
+
/** Вид узла (исполнение и границы — по виду). */
|
|
108
|
+
kind: pipelineNodeKindSchema,
|
|
109
|
+
/** Человекочитаемое название узла. */
|
|
110
|
+
title: z.string().optional(),
|
|
111
|
+
/** Агент, исполняющий узел (для вида `agent`). */
|
|
112
|
+
agent: z.string().optional(),
|
|
113
|
+
/** Скилл, используемый узлом. */
|
|
114
|
+
skill: z.string().optional(),
|
|
115
|
+
/** Промпт/задание для узла. */
|
|
116
|
+
prompt: z.string().optional(),
|
|
117
|
+
/** Инструмент узла (для вида `tool`). */
|
|
118
|
+
tool: z.string().optional(),
|
|
119
|
+
/** Аргументы инструмента. */
|
|
120
|
+
toolArgs: z.record(z.string(), z.unknown()).optional(),
|
|
121
|
+
/** Команда узла (для вида `script`; исполняется только через shell-policy). */
|
|
122
|
+
command: z.string().optional(),
|
|
123
|
+
/** Аргументы команды. */
|
|
124
|
+
args: z.array(z.string()).optional(),
|
|
125
|
+
/** Маппинг входа узла — пути (`prev.output.report`, `trigger.payload.issue`). */
|
|
126
|
+
input: z.array(z.string().min(1)).optional(),
|
|
127
|
+
/** Таймаут узла в секундах (для `human` — время ожидания человека). */
|
|
128
|
+
timeoutSec: z.number().int().positive().optional(),
|
|
129
|
+
/** Политика повторов узла. */
|
|
130
|
+
retry: z
|
|
131
|
+
.object({
|
|
132
|
+
/** Максимум повторов (0 — без повторов). */
|
|
133
|
+
max: z.number().int().min(0),
|
|
134
|
+
/** Пауза перед повтором в секундах. */
|
|
135
|
+
backoffSec: z.number().int().positive().optional(),
|
|
136
|
+
})
|
|
137
|
+
.optional(),
|
|
138
|
+
/** Условные переходы из узла. */
|
|
139
|
+
on: z.array(pipelineSpecEdgeSchema).optional(),
|
|
140
|
+
});
|
|
141
|
+
// --- Выход пайплайна ---
|
|
142
|
+
/**
|
|
143
|
+
* Выход пайплайна — что движок делает по завершении прогона.
|
|
144
|
+
*
|
|
145
|
+
* Требования к полям по виду (`session` — `agent` или `sessionId`; `file` —
|
|
146
|
+
* `path`; `gateway` — `event` или `webhookId`) проверяет
|
|
147
|
+
* `validatePipelineSpec`: схема описывает **форму**, валидатор — **смысл**.
|
|
148
|
+
*/
|
|
149
|
+
export const pipelineExitSchema = z.object({
|
|
150
|
+
/** Вид выхода. */
|
|
151
|
+
kind: pipelineExitKindSchema,
|
|
152
|
+
/** Выход в сессию (создать/продолжить). */
|
|
153
|
+
session: z
|
|
154
|
+
.object({
|
|
155
|
+
/** Агент, которому передаётся результат. */
|
|
156
|
+
agent: z.string().optional(),
|
|
157
|
+
/** Существующая сессия, которую нужно продолжить. */
|
|
158
|
+
sessionId: z.string().optional(),
|
|
159
|
+
})
|
|
160
|
+
.optional(),
|
|
161
|
+
/** Выход в файл (артефакт в workspace проекта). */
|
|
162
|
+
file: z
|
|
163
|
+
.object({
|
|
164
|
+
/** Путь файла в workspace проекта. */
|
|
165
|
+
path: z.string().optional(),
|
|
166
|
+
/** Путь к содержимому (`prev.output.report` и т.п.). */
|
|
167
|
+
contentFrom: z.string().optional(),
|
|
168
|
+
})
|
|
169
|
+
.optional(),
|
|
170
|
+
/** Выход наружу (событие/webhook — ADR-087/ADR-052). */
|
|
171
|
+
gateway: z
|
|
172
|
+
.object({
|
|
173
|
+
/** Тип публикуемого события. */
|
|
174
|
+
event: z.string().optional(),
|
|
175
|
+
/** Идентификатор подписки (webhook). */
|
|
176
|
+
webhookId: z.string().optional(),
|
|
177
|
+
/** Путь к payload публикации. */
|
|
178
|
+
payloadFrom: z.string().optional(),
|
|
179
|
+
})
|
|
180
|
+
.optional(),
|
|
181
|
+
});
|
|
182
|
+
// --- Спецификация ---
|
|
183
|
+
/**
|
|
184
|
+
* Спецификация пайплайна (`pipelineId@version`) — источник истины в
|
|
185
|
+
* JSON/YAML; формат — [docs/PIPELINES.md](../../../../docs/PIPELINES.md)
|
|
186
|
+
* §2.2, решение — ADR-101.
|
|
187
|
+
*
|
|
188
|
+
* Инварианты версионирования (ADR-101 §7): `draft` редактируется,
|
|
189
|
+
* `published` — неизменяемая версия; прогон всегда ссылается на конкретную
|
|
190
|
+
* `pipelineId@version`.
|
|
191
|
+
*/
|
|
192
|
+
export const pipelineSpecSchema = z.object({
|
|
193
|
+
/** Идентификатор пайплайна. */
|
|
194
|
+
id: z.string().min(1),
|
|
195
|
+
/** Человекочитаемое имя. */
|
|
196
|
+
name: z.string().min(1),
|
|
197
|
+
/** Краткое описание. */
|
|
198
|
+
description: z.string().optional(),
|
|
199
|
+
/** Версия спецификации (целое ≥ 1). */
|
|
200
|
+
version: z.number().int().min(1),
|
|
201
|
+
/** Статус версии: `draft` редактируется, `published` — неизменяемая. */
|
|
202
|
+
status: z.enum(['draft', 'published']),
|
|
203
|
+
/** Режим пайплайна (применяется permission-слоем). */
|
|
204
|
+
mode: pipelineModeSchema,
|
|
205
|
+
/** Владелец-проект (ADR-014); шаблоны из пакетов — инстансные. */
|
|
206
|
+
projectId: z.string().optional(),
|
|
207
|
+
/** Границы входа/выхода (JSON Schema); без `io` границы нестрогие. */
|
|
208
|
+
io: z
|
|
209
|
+
.object({
|
|
210
|
+
/** Схема входа. */
|
|
211
|
+
input: jsonSchemaLikeSchema.optional(),
|
|
212
|
+
/** Схема выхода. */
|
|
213
|
+
output: jsonSchemaLikeSchema.optional(),
|
|
214
|
+
})
|
|
215
|
+
.optional(),
|
|
216
|
+
/**
|
|
217
|
+
* Явно заданные переменные для маппинга входа: имя → путь к значению
|
|
218
|
+
* (напр. `branch: 'trigger.payload.branch'`).
|
|
219
|
+
*/
|
|
220
|
+
vars: z.record(z.string(), z.string()).optional(),
|
|
221
|
+
/** Узлы графа; минимум один. */
|
|
222
|
+
nodes: z.array(pipelineSpecNodeSchema).min(1, 'пайплайн: нужен хотя бы один узел'),
|
|
223
|
+
/** Выходы пайплайна; минимум один. */
|
|
224
|
+
exits: z.array(pipelineExitSchema).min(1, 'пайплайн: нужен хотя бы один выход'),
|
|
225
|
+
});
|
|
226
|
+
// --- Вход прогона ---
|
|
227
|
+
/**
|
|
228
|
+
* Вход прогона — единый триггер пайплайна (ADR-101 §3).
|
|
229
|
+
*
|
|
230
|
+
* Имя `PipelineRunTrigger` (а не `PipelineTrigger`): имя `PipelineTrigger`
|
|
231
|
+
* уже занято legacy-контрактом ADR-100 в `types/pipeline.ts` (его
|
|
232
|
+
* заменяет этот контракт в Э2–Э3, но до тех пор переименование ломало бы
|
|
233
|
+
* существующих потребителей).
|
|
234
|
+
*/
|
|
235
|
+
export const pipelineRunTriggerSchema = z.object({
|
|
236
|
+
/** Вид запуска. */
|
|
237
|
+
kind: z.enum(['user', 'gateway', 'schedule', 'tool', 'webhook', 'manual']),
|
|
238
|
+
/** Источник (напр. `ci`, `tg`, `cron`). */
|
|
239
|
+
source: z.string().optional(),
|
|
240
|
+
/** Тип события (напр. `release_published`). */
|
|
241
|
+
type: z.string().optional(),
|
|
242
|
+
/** Данные запуска (вход маппинга `trigger.payload.*`). */
|
|
243
|
+
payload: z.record(z.string(), z.unknown()).optional(),
|
|
244
|
+
/** Ключ дедупликации: повторный триггер не создаёт новый прогон. */
|
|
245
|
+
dedupKey: z.string().optional(),
|
|
246
|
+
});
|
|
247
|
+
// --- Выход узла ---
|
|
248
|
+
/**
|
|
249
|
+
* Результат исполнения узла — единый выход шага (ADR-101 §3).
|
|
250
|
+
*/
|
|
251
|
+
export const pipelineStepResultSchema = z.object({
|
|
252
|
+
/** Итог узла. */
|
|
253
|
+
status: z.enum(['ok', 'failed', 'skipped', 'awaiting_human']),
|
|
254
|
+
/** Выход узла (источник `prev.output.*` для следующего узла). */
|
|
255
|
+
output: z.record(z.string(), z.unknown()).optional(),
|
|
256
|
+
/** Произведённые артефакты (контракт артефакта — ADR-100, `types/pipeline.ts`). */
|
|
257
|
+
artifacts: z.array(pipelineArtifactSchema).optional(),
|
|
258
|
+
/** Ошибка узла. */
|
|
259
|
+
error: z
|
|
260
|
+
.object({
|
|
261
|
+
/** Машиночитаемый код ошибки. */
|
|
262
|
+
code: z.string().min(1),
|
|
263
|
+
/** Текст ошибки. */
|
|
264
|
+
message: z.string().min(1),
|
|
265
|
+
})
|
|
266
|
+
.optional(),
|
|
267
|
+
/** ISO-время старта узла. */
|
|
268
|
+
startedAt: z.string().optional(),
|
|
269
|
+
/** ISO-время завершения узла. */
|
|
270
|
+
finishedAt: z.string().optional(),
|
|
271
|
+
/** Длительность узла в миллисекундах. */
|
|
272
|
+
durationMs: z.number().int().min(0).optional(),
|
|
273
|
+
/** Номер попытки (нумерация с 1). */
|
|
274
|
+
attempt: z.number().int().min(1),
|
|
275
|
+
});
|
|
276
|
+
// --- Прогон ---
|
|
277
|
+
/** Статус прогона. */
|
|
278
|
+
export const pipelineRunStatusSchema = z.enum([
|
|
279
|
+
'pending',
|
|
280
|
+
'running',
|
|
281
|
+
'awaiting_human',
|
|
282
|
+
'done',
|
|
283
|
+
'failed',
|
|
284
|
+
'cancelled',
|
|
285
|
+
]);
|
|
286
|
+
/**
|
|
287
|
+
* Прогон пайплайна — заголовок журнала (ADR-101 §8, журнал append-only).
|
|
288
|
+
*
|
|
289
|
+
* Прогон всегда ссылается на конкретную версию спецификации
|
|
290
|
+
* (`pipelineId@version`): изменение черновика не влияет на идущие и
|
|
291
|
+
* завершённые прогоны.
|
|
292
|
+
*/
|
|
293
|
+
export const pipelineRunSchema = z.object({
|
|
294
|
+
/** Идентификатор прогона. */
|
|
295
|
+
id: z.string().min(1),
|
|
296
|
+
/** Идентификатор пайплайна. */
|
|
297
|
+
pipelineId: z.string().min(1),
|
|
298
|
+
/** Версия спецификации, по которой идёт прогон. */
|
|
299
|
+
version: z.number().int().min(1),
|
|
300
|
+
/** Проект-владелец прогона. */
|
|
301
|
+
projectId: z.string().optional(),
|
|
302
|
+
/** Статус прогона. */
|
|
303
|
+
status: pipelineRunStatusSchema,
|
|
304
|
+
/** Текущий узел (исполняемый/ожидающий). */
|
|
305
|
+
currentNode: z.string().optional(),
|
|
306
|
+
/** Триггер, породивший прогон. */
|
|
307
|
+
trigger: pipelineRunTriggerSchema.optional(),
|
|
308
|
+
/** ISO-время старта прогона. */
|
|
309
|
+
startedAt: z.string().optional(),
|
|
310
|
+
/** ISO-время завершения прогона. */
|
|
311
|
+
finishedAt: z.string().optional(),
|
|
312
|
+
/** Текст ошибки прогона. */
|
|
313
|
+
error: z.string().optional(),
|
|
314
|
+
});
|
|
315
|
+
/**
|
|
316
|
+
* Тип события прогона — журнал шагов и переходов (ADR-101 §8).
|
|
317
|
+
* Наружу события публикуются как `pipeline.run.*` в существующей шине
|
|
318
|
+
* (ADR-024/ADR-089) — новых каналов не заводим.
|
|
319
|
+
*/
|
|
320
|
+
export const pipelineRunEventTypeSchema = z.enum([
|
|
321
|
+
'run.started',
|
|
322
|
+
'node.started',
|
|
323
|
+
'node.finished',
|
|
324
|
+
'edge.taken',
|
|
325
|
+
'gate.awaiting',
|
|
326
|
+
'run.finished',
|
|
327
|
+
'run.failed',
|
|
328
|
+
]);
|
|
329
|
+
/** Событие прогона — запись журнала (append-only). */
|
|
330
|
+
export const pipelineRunEventSchema = z.object({
|
|
331
|
+
/** Идентификатор события. */
|
|
332
|
+
id: z.string().optional(),
|
|
333
|
+
/** Идентификатор прогона. */
|
|
334
|
+
runId: z.string().min(1),
|
|
335
|
+
/** ISO-время события. */
|
|
336
|
+
ts: z.string(),
|
|
337
|
+
/** Тип события. */
|
|
338
|
+
type: pipelineRunEventTypeSchema,
|
|
339
|
+
/** Данные события (узел, переход, причина и т.п.). */
|
|
340
|
+
payload: z.record(z.string(), z.unknown()).optional(),
|
|
341
|
+
});
|
|
342
|
+
/** Непустая строка (пробелы не считаются значением). */
|
|
343
|
+
function hasText(value) {
|
|
344
|
+
return typeof value === 'string' && value.trim() !== '';
|
|
345
|
+
}
|
|
346
|
+
/**
|
|
347
|
+
* Проверка целостности спецификации — **список проблем строками, без throw**
|
|
348
|
+
* (по образцу `validatePackManifest` из `types/pack.ts`).
|
|
349
|
+
*
|
|
350
|
+
* Разделение ответственности: `pipelineSpecSchema` — **структура** (форма
|
|
351
|
+
* полей, типы, enum'ы), `validatePipelineSpec` — **семантика** графа:
|
|
352
|
+
* 1. непустой список узлов;
|
|
353
|
+
* 2. уникальность идентификаторов узлов;
|
|
354
|
+
* 3. `on[].then` ссылается на существующий узел;
|
|
355
|
+
* 4. `exits` непуст, и у каждого выхода заполнены поля, нужные его виду
|
|
356
|
+
* (`file` — `path`, `session` — `agent` или `sessionId`, `gateway` —
|
|
357
|
+
* `event` или `webhookId`);
|
|
358
|
+
* 5. у узла задано поле, обязательное для его вида (`agent` — `agent`,
|
|
359
|
+
* `tool` — `tool`, `script` — `command`);
|
|
360
|
+
* 6. `mode` — из допустимых значений.
|
|
361
|
+
*
|
|
362
|
+
* Функция работает по **уже распарсенной** спецификации (после
|
|
363
|
+
* `pipelineSpecSchema.safeParse`), поэтому не отбрасывает спецификацию
|
|
364
|
+
* целиком: все проблемы перечисляются за один проход.
|
|
365
|
+
*/
|
|
366
|
+
export function validatePipelineSpec(spec) {
|
|
367
|
+
const problems = [];
|
|
368
|
+
// 1/2/5. Узлы: наличие, уникальность id, поля по виду.
|
|
369
|
+
const nodes = Array.isArray(spec.nodes) ? spec.nodes : [];
|
|
370
|
+
if (nodes.length === 0) {
|
|
371
|
+
problems.push('nodes: нужен хотя бы один узел');
|
|
372
|
+
}
|
|
373
|
+
const nodeIds = new Set();
|
|
374
|
+
nodes.forEach((node, index) => {
|
|
375
|
+
const id = node?.id;
|
|
376
|
+
if (!hasText(id)) {
|
|
377
|
+
problems.push(`nodes[${index}]: узел без поля «id»`);
|
|
378
|
+
return;
|
|
379
|
+
}
|
|
380
|
+
if (nodeIds.has(id)) {
|
|
381
|
+
problems.push(`nodes[${index}]: дубликат id узла «${id}»`);
|
|
382
|
+
return;
|
|
383
|
+
}
|
|
384
|
+
nodeIds.add(id);
|
|
385
|
+
if (node.kind === 'agent' && !hasText(node.agent)) {
|
|
386
|
+
problems.push(`nodes[${index}] («${id}»): узел вида «agent» требует поле «agent»`);
|
|
387
|
+
}
|
|
388
|
+
if (node.kind === 'tool' && !hasText(node.tool)) {
|
|
389
|
+
problems.push(`nodes[${index}] («${id}»): узел вида «tool» требует поле «tool»`);
|
|
390
|
+
}
|
|
391
|
+
if (node.kind === 'script' && !hasText(node.command)) {
|
|
392
|
+
problems.push(`nodes[${index}] («${id}»): узел вида «script» требует поле «command»`);
|
|
393
|
+
}
|
|
394
|
+
});
|
|
395
|
+
// 3. Переходы: цель должна существовать (ссылка вперёд допустима — поэтому
|
|
396
|
+
// второй проход, после сбора всех id).
|
|
397
|
+
nodes.forEach((node, index) => {
|
|
398
|
+
const transitions = Array.isArray(node?.on) ? node.on : [];
|
|
399
|
+
transitions.forEach((transition, transitionIndex) => {
|
|
400
|
+
const target = transition?.then;
|
|
401
|
+
if (!hasText(target)) {
|
|
402
|
+
problems.push(`nodes[${index}].on[${transitionIndex}]: переход без поля «then»`);
|
|
403
|
+
return;
|
|
404
|
+
}
|
|
405
|
+
if (!nodeIds.has(target)) {
|
|
406
|
+
problems.push(`nodes[${index}].on[${transitionIndex}]: переход ведёт на несуществующий узел «${target}»`);
|
|
407
|
+
}
|
|
408
|
+
});
|
|
409
|
+
});
|
|
410
|
+
// 4. Выходы: список непуст, поля по виду выхода.
|
|
411
|
+
const exits = Array.isArray(spec.exits) ? spec.exits : [];
|
|
412
|
+
if (exits.length === 0) {
|
|
413
|
+
problems.push('exits: нужен хотя бы один выход');
|
|
414
|
+
}
|
|
415
|
+
exits.forEach((exit, index) => {
|
|
416
|
+
if (exit?.kind === 'session') {
|
|
417
|
+
const session = exit.session;
|
|
418
|
+
if (!session || (!hasText(session.agent) && !hasText(session.sessionId))) {
|
|
419
|
+
problems.push(`exits[${index}]: выход вида «session» требует «session.agent» или «session.sessionId»`);
|
|
420
|
+
}
|
|
421
|
+
}
|
|
422
|
+
else if (exit?.kind === 'file') {
|
|
423
|
+
if (!exit.file || !hasText(exit.file.path)) {
|
|
424
|
+
problems.push(`exits[${index}]: выход вида «file» требует «file.path»`);
|
|
425
|
+
}
|
|
426
|
+
}
|
|
427
|
+
else if (exit?.kind === 'gateway') {
|
|
428
|
+
const gateway = exit.gateway;
|
|
429
|
+
if (!gateway || (!hasText(gateway.event) && !hasText(gateway.webhookId))) {
|
|
430
|
+
problems.push(`exits[${index}]: выход вида «gateway» требует «gateway.event» или «gateway.webhookId»`);
|
|
431
|
+
}
|
|
432
|
+
}
|
|
433
|
+
});
|
|
434
|
+
// 6. Режим пайплайна (схема уже ограничивает значения — проверка нужна для
|
|
435
|
+
// спецификаций, собранных вручную).
|
|
436
|
+
if (!PIPELINE_MODES.includes(spec.mode)) {
|
|
437
|
+
problems.push(`mode: неизвестный режим пайплайна «${String(spec.mode)}» (допустимо: ${PIPELINE_MODES.join('|')})`);
|
|
438
|
+
}
|
|
439
|
+
return problems.length === 0 ? { ok: true } : { ok: false, problems };
|
|
440
|
+
}
|