@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.
Files changed (92) hide show
  1. package/dist/config/defaults.js +126 -3
  2. package/dist/config/env-overrides.d.ts +29 -0
  3. package/dist/config/env-overrides.js +155 -2
  4. package/dist/config/execution.d.ts +66 -0
  5. package/dist/config/execution.js +146 -0
  6. package/dist/config/index.d.ts +1 -0
  7. package/dist/config/index.js +1 -0
  8. package/dist/config/proxy.js +3 -1
  9. package/dist/config/resolve.d.ts +8 -8
  10. package/dist/config/resolve.js +7 -7
  11. package/dist/config/types.d.ts +1287 -4037
  12. package/dist/config/types.js +461 -68
  13. package/dist/i18n/index.d.ts +1 -1
  14. package/dist/i18n/index.js +277 -0
  15. package/dist/index.d.ts +14 -2
  16. package/dist/index.js +16 -2
  17. package/dist/model-metadata.d.ts +10 -0
  18. package/dist/schemas/index.d.ts +980 -2322
  19. package/dist/schemas/index.js +183 -22
  20. package/dist/types/analytics.d.ts +6 -6
  21. package/dist/types/analytics.js +4 -4
  22. package/dist/types/authority.d.ts +464 -0
  23. package/dist/types/authority.js +445 -0
  24. package/dist/types/background.d.ts +96 -0
  25. package/dist/types/background.js +24 -0
  26. package/dist/types/bus-events.d.ts +23 -1
  27. package/dist/types/catalog.d.ts +349 -0
  28. package/dist/types/catalog.js +393 -0
  29. package/dist/types/decision.d.ts +28 -337
  30. package/dist/types/egress.d.ts +1 -1
  31. package/dist/types/egress.js +1 -1
  32. package/dist/types/events.d.ts +54 -1
  33. package/dist/types/external-credentials.d.ts +352 -0
  34. package/dist/types/external-credentials.js +200 -0
  35. package/dist/types/hooks.d.ts +33 -12
  36. package/dist/types/index.d.ts +20 -0
  37. package/dist/types/index.js +50 -1
  38. package/dist/types/llm-filters.d.ts +150 -0
  39. package/dist/types/llm-filters.js +54 -0
  40. package/dist/types/mcp.d.ts +33 -2
  41. package/dist/types/mcp.js +44 -1
  42. package/dist/types/message.d.ts +45 -1
  43. package/dist/types/pack.d.ts +1102 -0
  44. package/dist/types/pack.js +1003 -0
  45. package/dist/types/permission.d.ts +25 -11
  46. package/dist/types/permission.js +1 -1
  47. package/dist/types/pipeline-engine.d.ts +453 -0
  48. package/dist/types/pipeline-engine.js +440 -0
  49. package/dist/types/pipeline.d.ts +275 -0
  50. package/dist/types/pipeline.js +212 -0
  51. package/dist/types/plugin-audit.d.ts +110 -0
  52. package/dist/types/plugin-audit.js +185 -0
  53. package/dist/types/plugin-hybrid.d.ts +85 -0
  54. package/dist/types/plugin-hybrid.js +68 -0
  55. package/dist/types/plugin-lock.d.ts +95 -0
  56. package/dist/types/plugin-lock.js +1 -0
  57. package/dist/types/plugin-protocol.d.ts +221 -0
  58. package/dist/types/plugin-protocol.js +322 -0
  59. package/dist/types/plugin-runtime.d.ts +25 -0
  60. package/dist/types/plugin-runtime.js +11 -0
  61. package/dist/types/plugin-scan.d.ts +159 -0
  62. package/dist/types/plugin-scan.js +166 -0
  63. package/dist/types/plugin-tools.d.ts +51 -0
  64. package/dist/types/plugin-tools.js +72 -0
  65. package/dist/types/project.d.ts +14 -0
  66. package/dist/types/prompt-blocks.d.ts +102 -0
  67. package/dist/types/prompt-blocks.js +24 -0
  68. package/dist/types/prompt.d.ts +45 -3
  69. package/dist/types/provider.d.ts +11 -0
  70. package/dist/types/question.d.ts +153 -0
  71. package/dist/types/question.js +65 -0
  72. package/dist/types/schedules.d.ts +26 -3
  73. package/dist/types/semver.d.ts +48 -0
  74. package/dist/types/semver.js +218 -0
  75. package/dist/types/service-keys.d.ts +41 -3
  76. package/dist/types/service-keys.js +44 -2
  77. package/dist/types/session.d.ts +54 -0
  78. package/dist/types/steering.d.ts +74 -0
  79. package/dist/types/steering.js +75 -0
  80. package/dist/types/tools.d.ts +125 -5
  81. package/dist/types/tools.js +75 -0
  82. package/dist/types/trust.d.ts +31 -0
  83. package/dist/types/trust.js +27 -0
  84. package/dist/types/worktree.d.ts +170 -0
  85. package/dist/types/worktree.js +101 -0
  86. package/dist/utils/index.d.ts +31 -1
  87. package/dist/utils/index.js +92 -12
  88. package/dist/utils/reasoning.d.ts +16 -0
  89. package/dist/utils/reasoning.js +37 -0
  90. package/dist/version.d.ts +1 -1
  91. package/dist/version.js +1 -1
  92. package/package.json +2 -2
@@ -4,7 +4,11 @@ import { z } from 'zod';
4
4
  * Модель OpenCode: allow/deny/ask для каждого тула + glob-паттерны для файлов.
5
5
  */
6
6
  export declare const PERMISSION_ACTIONS: readonly ["allow", "deny", "ask"];
7
- export declare const permissionActionSchema: z.ZodEnum<["allow", "deny", "ask"]>;
7
+ export declare const permissionActionSchema: z.ZodEnum<{
8
+ allow: "allow";
9
+ deny: "deny";
10
+ ask: "ask";
11
+ }>;
8
12
  export type PermissionAction = z.infer<typeof permissionActionSchema>;
9
13
  /**
10
14
  * Значение правила:
@@ -12,18 +16,28 @@ export type PermissionAction = z.infer<typeof permissionActionSchema>;
12
16
  * - объект — файловые glob-паттерны → действие (для read/edit/external_directory и
13
17
  * для тул-специфичных файловых правил, например `write_file: {"*.env": "deny"}`)
14
18
  */
15
- export declare const permissionRuleSchema: z.ZodUnion<[z.ZodEnum<["allow", "deny", "ask"]>, z.ZodRecord<z.ZodString, z.ZodEnum<["allow", "deny", "ask"]>>]>;
19
+ export declare const permissionRuleSchema: z.ZodUnion<readonly [z.ZodEnum<{
20
+ allow: "allow";
21
+ deny: "deny";
22
+ ask: "ask";
23
+ }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
24
+ allow: "allow";
25
+ deny: "deny";
26
+ ask: "ask";
27
+ }>>]>;
16
28
  export type PermissionRule = z.infer<typeof permissionRuleSchema>;
17
29
  export declare const permissionConfigSchema: z.ZodObject<{
18
- rules: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodEnum<["allow", "deny", "ask"]>, z.ZodRecord<z.ZodString, z.ZodEnum<["allow", "deny", "ask"]>>]>>>;
30
+ rules: z.ZodPrefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodEnum<{
31
+ allow: "allow";
32
+ deny: "deny";
33
+ ask: "ask";
34
+ }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
35
+ allow: "allow";
36
+ deny: "deny";
37
+ ask: "ask";
38
+ }>>]>>>;
19
39
  askTimeoutMs: z.ZodDefault<z.ZodNumber>;
20
- }, "strip", z.ZodTypeAny, {
21
- rules: Record<string, "allow" | "deny" | "ask" | Record<string, "allow" | "deny" | "ask">>;
22
- askTimeoutMs: number;
23
- }, {
24
- rules?: Record<string, "allow" | "deny" | "ask" | Record<string, "allow" | "deny" | "ask">> | undefined;
25
- askTimeoutMs?: number | undefined;
26
- }>;
40
+ }, z.core.$strip>;
27
41
  export type PermissionConfig = z.infer<typeof permissionConfigSchema>;
28
42
  /** Результат проверки одного tool_call. */
29
43
  export interface PermissionDecision {
@@ -40,7 +54,7 @@ export interface PermissionDecision {
40
54
  * ADR-070 §2.9.1: тул недоступен не по жёсткому запрету, а из-за текущего
41
55
  * режима (`mode`), роли агента (`role`), отсутствия внешней программы
42
56
  * окружения (`dependency`), не заданного рабочего каталога проекта
43
- * (`workspace`) или недоступного хранилища (`storage`, PROP-032 W5 —
57
+ * (`workspace`) или недоступного хранилища (`storage`, ADR-098 W5 —
44
58
  * деградированный read-only режим). Отличие от `deny`-политики: доступ
45
59
  * открывается переключением режима / делегированием / установкой программы /
46
60
  * заданием workspace / восстановлением хранилища, поэтому модель получает
@@ -16,6 +16,6 @@ export const permissionRuleSchema = z.union([
16
16
  z.record(z.string(), permissionActionSchema),
17
17
  ]);
18
18
  export const permissionConfigSchema = z.object({
19
- rules: z.record(z.string(), permissionRuleSchema).default({}),
19
+ rules: z.record(z.string(), permissionRuleSchema).prefault({}),
20
20
  askTimeoutMs: z.number().int().min(0).default(30_000),
21
21
  });
@@ -0,0 +1,453 @@
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
+ /**
16
+ * Режим пайплайна (`plan`/`act`/`yolo`) — объявляется спецификацией и
17
+ * применяется permission-слоем (ADR-025/ADR-028/ADR-029), не хардкодом в
18
+ * тулах.
19
+ */
20
+ export declare const PIPELINE_MODES: readonly ["plan", "act", "yolo"];
21
+ export declare const pipelineModeSchema: z.ZodEnum<{
22
+ plan: "plan";
23
+ act: "act";
24
+ yolo: "yolo";
25
+ }>;
26
+ export type PipelineMode = z.infer<typeof pipelineModeSchema>;
27
+ /**
28
+ * Вид узла пайплайна:
29
+ * - `agent` — свой Tool-Use-цикл внутри движка (LLM — только через
30
+ * `GatewayProvider`, ADR-036);
31
+ * - `script` — только через shell-policy (не голой `child_process`);
32
+ * - `tool` — через `ToolRegistry` + `executeToolDef`;
33
+ * - `human` — HITL-гейт: прогон встаёт на паузу и ждёт действия человека.
34
+ */
35
+ export declare const pipelineNodeKindSchema: z.ZodEnum<{
36
+ agent: "agent";
37
+ tool: "tool";
38
+ script: "script";
39
+ human: "human";
40
+ }>;
41
+ export type PipelineNodeKind = z.infer<typeof pipelineNodeKindSchema>;
42
+ /**
43
+ * Вид выхода пайплайна: `session` (создать/продолжить сессию), `file`
44
+ * (артефакт в workspace проекта), `gateway` (событие/webhook наружу),
45
+ * `none` (прогон завершается без внешнего следа).
46
+ */
47
+ export declare const pipelineExitKindSchema: z.ZodEnum<{
48
+ file: "file";
49
+ none: "none";
50
+ session: "session";
51
+ gateway: "gateway";
52
+ }>;
53
+ export type PipelineExitKind = z.infer<typeof pipelineExitKindSchema>;
54
+ /**
55
+ * Оператор условия перехода — **структурированный DSL, никакого `eval`**:
56
+ * `eq`/`ne` — равенство/неравенство, `in` — вхождение в массив, `exists` —
57
+ * наличие значения по пути, `gt`/`lt` — сравнение чисел.
58
+ */
59
+ export declare const pipelineConditionOpSchema: z.ZodEnum<{
60
+ in: "in";
61
+ eq: "eq";
62
+ ne: "ne";
63
+ exists: "exists";
64
+ gt: "gt";
65
+ lt: "lt";
66
+ }>;
67
+ export type PipelineConditionOp = z.infer<typeof pipelineConditionOpSchema>;
68
+ /**
69
+ * Минимальный тип JSON Schema — полноценного JSON Schema-типа в репозитории
70
+ * нет, а пайплайну нужен лишь «скелет» схемы границы (`type`/`properties`/
71
+ * `required`) плюс произвольные ключи спецификации JSON Schema.
72
+ */
73
+ export type JsonSchemaLike = {
74
+ type?: string;
75
+ properties?: Record<string, JsonSchemaLike>;
76
+ required?: string[];
77
+ [key: string]: unknown;
78
+ };
79
+ /** Схема границы пайплайна (JSON Schema в урезанном виде). */
80
+ export declare const jsonSchemaLikeSchema: z.ZodType<JsonSchemaLike>;
81
+ /**
82
+ * Условие перехода `{ path, op, value }`.
83
+ *
84
+ * `path` — точечный путь к данным прогона: `prev.output.x` (выход
85
+ * предыдущего узла), `trigger.payload.y` (payload триггера), `vars.z`
86
+ * (переменная спецификации). Сравнение тип-строгое: при несовпадении типов
87
+ * условие не выполнено (fail-soft, без исключения прогона).
88
+ */
89
+ export declare const pipelineConditionSchema: z.ZodObject<{
90
+ path: z.ZodString;
91
+ op: z.ZodEnum<{
92
+ in: "in";
93
+ eq: "eq";
94
+ ne: "ne";
95
+ exists: "exists";
96
+ gt: "gt";
97
+ lt: "lt";
98
+ }>;
99
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>>;
100
+ }, z.core.$strip>;
101
+ export type PipelineCondition = z.infer<typeof pipelineConditionSchema>;
102
+ /**
103
+ * Условный переход из узла: при выполнении условия `when` прогон идёт в узел
104
+ * `then`.
105
+ */
106
+ export declare const pipelineSpecEdgeSchema: z.ZodObject<{
107
+ when: z.ZodObject<{
108
+ path: z.ZodString;
109
+ op: z.ZodEnum<{
110
+ in: "in";
111
+ eq: "eq";
112
+ ne: "ne";
113
+ exists: "exists";
114
+ gt: "gt";
115
+ lt: "lt";
116
+ }>;
117
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>>;
118
+ }, z.core.$strip>;
119
+ then: z.ZodString;
120
+ }, z.core.$strip>;
121
+ export type PipelineTransition = z.infer<typeof pipelineSpecEdgeSchema>;
122
+ /**
123
+ * Узел пайплайна (шаг графа).
124
+ *
125
+ * Вход узла задаётся **маппингом** (`input`): в запрос к LLM попадает не
126
+ * вся история, а только отображённое маппингом — выход предыдущего узла
127
+ * (`prev.output.*`), payload триггера (`trigger.payload.*`) и явно заданные
128
+ * переменные (`vars.*`).
129
+ */
130
+ export declare const pipelineSpecNodeSchema: z.ZodObject<{
131
+ id: z.ZodString;
132
+ kind: z.ZodEnum<{
133
+ agent: "agent";
134
+ tool: "tool";
135
+ script: "script";
136
+ human: "human";
137
+ }>;
138
+ title: z.ZodOptional<z.ZodString>;
139
+ agent: z.ZodOptional<z.ZodString>;
140
+ skill: z.ZodOptional<z.ZodString>;
141
+ prompt: z.ZodOptional<z.ZodString>;
142
+ tool: z.ZodOptional<z.ZodString>;
143
+ toolArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
144
+ command: z.ZodOptional<z.ZodString>;
145
+ args: z.ZodOptional<z.ZodArray<z.ZodString>>;
146
+ input: z.ZodOptional<z.ZodArray<z.ZodString>>;
147
+ timeoutSec: z.ZodOptional<z.ZodNumber>;
148
+ retry: z.ZodOptional<z.ZodObject<{
149
+ max: z.ZodNumber;
150
+ backoffSec: z.ZodOptional<z.ZodNumber>;
151
+ }, z.core.$strip>>;
152
+ on: z.ZodOptional<z.ZodArray<z.ZodObject<{
153
+ when: z.ZodObject<{
154
+ path: z.ZodString;
155
+ op: z.ZodEnum<{
156
+ in: "in";
157
+ eq: "eq";
158
+ ne: "ne";
159
+ exists: "exists";
160
+ gt: "gt";
161
+ lt: "lt";
162
+ }>;
163
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>>;
164
+ }, z.core.$strip>;
165
+ then: z.ZodString;
166
+ }, z.core.$strip>>>;
167
+ }, z.core.$strip>;
168
+ export type PipelineNode = z.infer<typeof pipelineSpecNodeSchema>;
169
+ /**
170
+ * Выход пайплайна — что движок делает по завершении прогона.
171
+ *
172
+ * Требования к полям по виду (`session` — `agent` или `sessionId`; `file` —
173
+ * `path`; `gateway` — `event` или `webhookId`) проверяет
174
+ * `validatePipelineSpec`: схема описывает **форму**, валидатор — **смысл**.
175
+ */
176
+ export declare const pipelineExitSchema: z.ZodObject<{
177
+ kind: z.ZodEnum<{
178
+ file: "file";
179
+ none: "none";
180
+ session: "session";
181
+ gateway: "gateway";
182
+ }>;
183
+ session: z.ZodOptional<z.ZodObject<{
184
+ agent: z.ZodOptional<z.ZodString>;
185
+ sessionId: z.ZodOptional<z.ZodString>;
186
+ }, z.core.$strip>>;
187
+ file: z.ZodOptional<z.ZodObject<{
188
+ path: z.ZodOptional<z.ZodString>;
189
+ contentFrom: z.ZodOptional<z.ZodString>;
190
+ }, z.core.$strip>>;
191
+ gateway: z.ZodOptional<z.ZodObject<{
192
+ event: z.ZodOptional<z.ZodString>;
193
+ webhookId: z.ZodOptional<z.ZodString>;
194
+ payloadFrom: z.ZodOptional<z.ZodString>;
195
+ }, z.core.$strip>>;
196
+ }, z.core.$strip>;
197
+ export type PipelineExit = z.infer<typeof pipelineExitSchema>;
198
+ /**
199
+ * Спецификация пайплайна (`pipelineId@version`) — источник истины в
200
+ * JSON/YAML; формат — [docs/PIPELINES.md](../../../../docs/PIPELINES.md)
201
+ * §2.2, решение — ADR-101.
202
+ *
203
+ * Инварианты версионирования (ADR-101 §7): `draft` редактируется,
204
+ * `published` — неизменяемая версия; прогон всегда ссылается на конкретную
205
+ * `pipelineId@version`.
206
+ */
207
+ export declare const pipelineSpecSchema: z.ZodObject<{
208
+ id: z.ZodString;
209
+ name: z.ZodString;
210
+ description: z.ZodOptional<z.ZodString>;
211
+ version: z.ZodNumber;
212
+ status: z.ZodEnum<{
213
+ draft: "draft";
214
+ published: "published";
215
+ }>;
216
+ mode: z.ZodEnum<{
217
+ plan: "plan";
218
+ act: "act";
219
+ yolo: "yolo";
220
+ }>;
221
+ projectId: z.ZodOptional<z.ZodString>;
222
+ io: z.ZodOptional<z.ZodObject<{
223
+ input: z.ZodOptional<z.ZodType<JsonSchemaLike, unknown, z.core.$ZodTypeInternals<JsonSchemaLike, unknown>>>;
224
+ output: z.ZodOptional<z.ZodType<JsonSchemaLike, unknown, z.core.$ZodTypeInternals<JsonSchemaLike, unknown>>>;
225
+ }, z.core.$strip>>;
226
+ vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
227
+ nodes: z.ZodArray<z.ZodObject<{
228
+ id: z.ZodString;
229
+ kind: z.ZodEnum<{
230
+ agent: "agent";
231
+ tool: "tool";
232
+ script: "script";
233
+ human: "human";
234
+ }>;
235
+ title: z.ZodOptional<z.ZodString>;
236
+ agent: z.ZodOptional<z.ZodString>;
237
+ skill: z.ZodOptional<z.ZodString>;
238
+ prompt: z.ZodOptional<z.ZodString>;
239
+ tool: z.ZodOptional<z.ZodString>;
240
+ toolArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
241
+ command: z.ZodOptional<z.ZodString>;
242
+ args: z.ZodOptional<z.ZodArray<z.ZodString>>;
243
+ input: z.ZodOptional<z.ZodArray<z.ZodString>>;
244
+ timeoutSec: z.ZodOptional<z.ZodNumber>;
245
+ retry: z.ZodOptional<z.ZodObject<{
246
+ max: z.ZodNumber;
247
+ backoffSec: z.ZodOptional<z.ZodNumber>;
248
+ }, z.core.$strip>>;
249
+ on: z.ZodOptional<z.ZodArray<z.ZodObject<{
250
+ when: z.ZodObject<{
251
+ path: z.ZodString;
252
+ op: z.ZodEnum<{
253
+ in: "in";
254
+ eq: "eq";
255
+ ne: "ne";
256
+ exists: "exists";
257
+ gt: "gt";
258
+ lt: "lt";
259
+ }>;
260
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>>;
261
+ }, z.core.$strip>;
262
+ then: z.ZodString;
263
+ }, z.core.$strip>>>;
264
+ }, z.core.$strip>>;
265
+ exits: z.ZodArray<z.ZodObject<{
266
+ kind: z.ZodEnum<{
267
+ file: "file";
268
+ none: "none";
269
+ session: "session";
270
+ gateway: "gateway";
271
+ }>;
272
+ session: z.ZodOptional<z.ZodObject<{
273
+ agent: z.ZodOptional<z.ZodString>;
274
+ sessionId: z.ZodOptional<z.ZodString>;
275
+ }, z.core.$strip>>;
276
+ file: z.ZodOptional<z.ZodObject<{
277
+ path: z.ZodOptional<z.ZodString>;
278
+ contentFrom: z.ZodOptional<z.ZodString>;
279
+ }, z.core.$strip>>;
280
+ gateway: z.ZodOptional<z.ZodObject<{
281
+ event: z.ZodOptional<z.ZodString>;
282
+ webhookId: z.ZodOptional<z.ZodString>;
283
+ payloadFrom: z.ZodOptional<z.ZodString>;
284
+ }, z.core.$strip>>;
285
+ }, z.core.$strip>>;
286
+ }, z.core.$strip>;
287
+ export type PipelineSpec = z.infer<typeof pipelineSpecSchema>;
288
+ /**
289
+ * Вход прогона — единый триггер пайплайна (ADR-101 §3).
290
+ *
291
+ * Имя `PipelineRunTrigger` (а не `PipelineTrigger`): имя `PipelineTrigger`
292
+ * уже занято legacy-контрактом ADR-100 в `types/pipeline.ts` (его
293
+ * заменяет этот контракт в Э2–Э3, но до тех пор переименование ломало бы
294
+ * существующих потребителей).
295
+ */
296
+ export declare const pipelineRunTriggerSchema: z.ZodObject<{
297
+ kind: z.ZodEnum<{
298
+ user: "user";
299
+ tool: "tool";
300
+ schedule: "schedule";
301
+ manual: "manual";
302
+ gateway: "gateway";
303
+ webhook: "webhook";
304
+ }>;
305
+ source: z.ZodOptional<z.ZodString>;
306
+ type: z.ZodOptional<z.ZodString>;
307
+ payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
308
+ dedupKey: z.ZodOptional<z.ZodString>;
309
+ }, z.core.$strip>;
310
+ export type PipelineRunTrigger = z.infer<typeof pipelineRunTriggerSchema>;
311
+ /**
312
+ * Результат исполнения узла — единый выход шага (ADR-101 §3).
313
+ */
314
+ export declare const pipelineStepResultSchema: z.ZodObject<{
315
+ status: z.ZodEnum<{
316
+ ok: "ok";
317
+ failed: "failed";
318
+ skipped: "skipped";
319
+ awaiting_human: "awaiting_human";
320
+ }>;
321
+ output: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
322
+ artifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
323
+ kind: z.ZodString;
324
+ id: z.ZodOptional<z.ZodString>;
325
+ from: z.ZodOptional<z.ZodString>;
326
+ source: z.ZodOptional<z.ZodString>;
327
+ type: z.ZodOptional<z.ZodString>;
328
+ path: z.ZodOptional<z.ZodString>;
329
+ mime: z.ZodOptional<z.ZodString>;
330
+ size: z.ZodOptional<z.ZodNumber>;
331
+ name: z.ZodOptional<z.ZodString>;
332
+ payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
333
+ }, z.core.$strip>>>;
334
+ error: z.ZodOptional<z.ZodObject<{
335
+ code: z.ZodString;
336
+ message: z.ZodString;
337
+ }, z.core.$strip>>;
338
+ startedAt: z.ZodOptional<z.ZodString>;
339
+ finishedAt: z.ZodOptional<z.ZodString>;
340
+ durationMs: z.ZodOptional<z.ZodNumber>;
341
+ attempt: z.ZodNumber;
342
+ }, z.core.$strip>;
343
+ export type StepResult = z.infer<typeof pipelineStepResultSchema>;
344
+ /** Статус прогона. */
345
+ export declare const pipelineRunStatusSchema: z.ZodEnum<{
346
+ pending: "pending";
347
+ cancelled: "cancelled";
348
+ failed: "failed";
349
+ running: "running";
350
+ done: "done";
351
+ awaiting_human: "awaiting_human";
352
+ }>;
353
+ export type PipelineRunStatus = z.infer<typeof pipelineRunStatusSchema>;
354
+ /**
355
+ * Прогон пайплайна — заголовок журнала (ADR-101 §8, журнал append-only).
356
+ *
357
+ * Прогон всегда ссылается на конкретную версию спецификации
358
+ * (`pipelineId@version`): изменение черновика не влияет на идущие и
359
+ * завершённые прогоны.
360
+ */
361
+ export declare const pipelineRunSchema: z.ZodObject<{
362
+ id: z.ZodString;
363
+ pipelineId: z.ZodString;
364
+ version: z.ZodNumber;
365
+ projectId: z.ZodOptional<z.ZodString>;
366
+ status: z.ZodEnum<{
367
+ pending: "pending";
368
+ cancelled: "cancelled";
369
+ failed: "failed";
370
+ running: "running";
371
+ done: "done";
372
+ awaiting_human: "awaiting_human";
373
+ }>;
374
+ currentNode: z.ZodOptional<z.ZodString>;
375
+ trigger: z.ZodOptional<z.ZodObject<{
376
+ kind: z.ZodEnum<{
377
+ user: "user";
378
+ tool: "tool";
379
+ schedule: "schedule";
380
+ manual: "manual";
381
+ gateway: "gateway";
382
+ webhook: "webhook";
383
+ }>;
384
+ source: z.ZodOptional<z.ZodString>;
385
+ type: z.ZodOptional<z.ZodString>;
386
+ payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
387
+ dedupKey: z.ZodOptional<z.ZodString>;
388
+ }, z.core.$strip>>;
389
+ startedAt: z.ZodOptional<z.ZodString>;
390
+ finishedAt: z.ZodOptional<z.ZodString>;
391
+ error: z.ZodOptional<z.ZodString>;
392
+ }, z.core.$strip>;
393
+ export type PipelineRun = z.infer<typeof pipelineRunSchema>;
394
+ /**
395
+ * Тип события прогона — журнал шагов и переходов (ADR-101 §8).
396
+ * Наружу события публикуются как `pipeline.run.*` в существующей шине
397
+ * (ADR-024/ADR-089) — новых каналов не заводим.
398
+ */
399
+ export declare const pipelineRunEventTypeSchema: z.ZodEnum<{
400
+ "run.started": "run.started";
401
+ "node.started": "node.started";
402
+ "node.finished": "node.finished";
403
+ "edge.taken": "edge.taken";
404
+ "gate.awaiting": "gate.awaiting";
405
+ "run.finished": "run.finished";
406
+ "run.failed": "run.failed";
407
+ }>;
408
+ export type PipelineRunEventType = z.infer<typeof pipelineRunEventTypeSchema>;
409
+ /** Событие прогона — запись журнала (append-only). */
410
+ export declare const pipelineRunEventSchema: z.ZodObject<{
411
+ id: z.ZodOptional<z.ZodString>;
412
+ runId: z.ZodString;
413
+ ts: z.ZodString;
414
+ type: z.ZodEnum<{
415
+ "run.started": "run.started";
416
+ "node.started": "node.started";
417
+ "node.finished": "node.finished";
418
+ "edge.taken": "edge.taken";
419
+ "gate.awaiting": "gate.awaiting";
420
+ "run.finished": "run.finished";
421
+ "run.failed": "run.failed";
422
+ }>;
423
+ payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
424
+ }, z.core.$strip>;
425
+ export type PipelineRunEvent = z.infer<typeof pipelineRunEventSchema>;
426
+ /** Итог проверки спецификации. */
427
+ export type PipelineSpecValidationResult = {
428
+ ok: true;
429
+ } | {
430
+ ok: false;
431
+ problems: string[];
432
+ };
433
+ /**
434
+ * Проверка целостности спецификации — **список проблем строками, без throw**
435
+ * (по образцу `validatePackManifest` из `types/pack.ts`).
436
+ *
437
+ * Разделение ответственности: `pipelineSpecSchema` — **структура** (форма
438
+ * полей, типы, enum'ы), `validatePipelineSpec` — **семантика** графа:
439
+ * 1. непустой список узлов;
440
+ * 2. уникальность идентификаторов узлов;
441
+ * 3. `on[].then` ссылается на существующий узел;
442
+ * 4. `exits` непуст, и у каждого выхода заполнены поля, нужные его виду
443
+ * (`file` — `path`, `session` — `agent` или `sessionId`, `gateway` —
444
+ * `event` или `webhookId`);
445
+ * 5. у узла задано поле, обязательное для его вида (`agent` — `agent`,
446
+ * `tool` — `tool`, `script` — `command`);
447
+ * 6. `mode` — из допустимых значений.
448
+ *
449
+ * Функция работает по **уже распарсенной** спецификации (после
450
+ * `pipelineSpecSchema.safeParse`), поэтому не отбрасывает спецификацию
451
+ * целиком: все проблемы перечисляются за один проход.
452
+ */
453
+ export declare function validatePipelineSpec(spec: PipelineSpec): PipelineSpecValidationResult;