@ai-dev-orchestrator/schemas 0.1.3 → 0.1.5

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.
@@ -1,4 +1,863 @@
1
1
  import { z } from 'zod/v4';
2
+ export declare const entryActionContinuationSchema: z.ZodObject<{
3
+ stateId: z.ZodString;
4
+ completedResults: z.ZodReadonly<z.ZodArray<z.ZodCustom<{
5
+ action: {
6
+ type: "dispatch_worker";
7
+ params: {
8
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
9
+ parallel?: boolean | undefined;
10
+ branchId?: string | undefined;
11
+ stateId?: string | undefined;
12
+ };
13
+ } | {
14
+ type: "dispatch_parallel_workers";
15
+ params: {
16
+ roles: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[];
17
+ docsOnlyRoles?: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[] | undefined;
18
+ };
19
+ } | {
20
+ type: "dispatch_dynamic_workers";
21
+ params: {
22
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
23
+ sourceArtifact: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
24
+ itemsPath: string;
25
+ };
26
+ } | {
27
+ type: "run_script";
28
+ params: {
29
+ script: string;
30
+ timeout?: number | undefined;
31
+ env?: Record<string, string> | undefined;
32
+ storeOutput?: {
33
+ artifactType: string;
34
+ producedBy: string;
35
+ } | undefined;
36
+ };
37
+ } | {
38
+ type: "store_artifact";
39
+ params: {
40
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
41
+ content: string;
42
+ name?: string | undefined;
43
+ };
44
+ } | {
45
+ type: "record_journal";
46
+ params: {
47
+ event: "run_started" | "run_completed" | "run_failed" | "run_aborted";
48
+ };
49
+ } | {
50
+ type: "generate_agreement";
51
+ params: {
52
+ type: "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_agreement";
53
+ };
54
+ } | {
55
+ type: "notify_human";
56
+ params: {
57
+ reason?: string | undefined;
58
+ };
59
+ } | {
60
+ type: "produce_manifest";
61
+ params: Record<string, never>;
62
+ };
63
+ success: boolean;
64
+ error?: string | undefined;
65
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
66
+ artifactRef?: {
67
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
68
+ name: string;
69
+ version: number;
70
+ checksum: string;
71
+ } | undefined;
72
+ artifactRefs?: readonly {
73
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
74
+ name: string;
75
+ version: number;
76
+ checksum: string;
77
+ }[] | undefined;
78
+ workerResults?: readonly {
79
+ role: string;
80
+ success: boolean;
81
+ error?: string | undefined;
82
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
83
+ artifactRef?: {
84
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
85
+ name: string;
86
+ version: number;
87
+ checksum: string;
88
+ } | undefined;
89
+ model?: string | undefined;
90
+ taskId?: string | undefined;
91
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
92
+ sessionRef?: {
93
+ sessionId: string;
94
+ runId: string;
95
+ stateId: string;
96
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
97
+ transport: "stdio" | "remote";
98
+ } | undefined;
99
+ pendingRequest?: {
100
+ requestId: string;
101
+ kind: "permission";
102
+ createdAt: string;
103
+ payload: {
104
+ [x: string]: unknown;
105
+ action: string;
106
+ resource: string;
107
+ detail?: string | undefined;
108
+ riskLevel?: "high" | "medium" | "low" | undefined;
109
+ externalRequestId?: string | undefined;
110
+ toolInput?: string | undefined;
111
+ granted?: boolean | undefined;
112
+ reason?: string | undefined;
113
+ timedOut?: boolean | undefined;
114
+ aborted?: boolean | undefined;
115
+ };
116
+ } | {
117
+ requestId: string;
118
+ kind: "clarification";
119
+ createdAt: string;
120
+ payload: {
121
+ [x: string]: unknown;
122
+ question: string;
123
+ context?: string | undefined;
124
+ options?: readonly string[] | undefined;
125
+ answer?: string | undefined;
126
+ };
127
+ } | undefined;
128
+ }[] | undefined;
129
+ usageSnapshot?: {
130
+ totalInputTokens: number;
131
+ totalOutputTokens: number;
132
+ byRole: Record<string, {
133
+ inputTokens: number;
134
+ outputTokens: number;
135
+ durationMs: number;
136
+ }>;
137
+ } | undefined;
138
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
139
+ sessionRef?: {
140
+ sessionId: string;
141
+ runId: string;
142
+ stateId: string;
143
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
144
+ transport: "stdio" | "remote";
145
+ } | undefined;
146
+ pendingRequest?: {
147
+ requestId: string;
148
+ kind: "permission";
149
+ createdAt: string;
150
+ payload: {
151
+ [x: string]: unknown;
152
+ action: string;
153
+ resource: string;
154
+ detail?: string | undefined;
155
+ riskLevel?: "high" | "medium" | "low" | undefined;
156
+ externalRequestId?: string | undefined;
157
+ toolInput?: string | undefined;
158
+ granted?: boolean | undefined;
159
+ reason?: string | undefined;
160
+ timedOut?: boolean | undefined;
161
+ aborted?: boolean | undefined;
162
+ };
163
+ } | {
164
+ requestId: string;
165
+ kind: "clarification";
166
+ createdAt: string;
167
+ payload: {
168
+ [x: string]: unknown;
169
+ question: string;
170
+ context?: string | undefined;
171
+ options?: readonly string[] | undefined;
172
+ answer?: string | undefined;
173
+ };
174
+ } | undefined;
175
+ scriptResult?: {
176
+ exitCode: number;
177
+ stdout: string;
178
+ stderr: string;
179
+ durationMs: number;
180
+ output?: {
181
+ message?: string | undefined;
182
+ directives?: {
183
+ repoRoot?: string | undefined;
184
+ } | undefined;
185
+ } | undefined;
186
+ } | undefined;
187
+ confidenceReport?: {
188
+ score: number;
189
+ criteriaResults: {
190
+ criterionId: string;
191
+ met: boolean;
192
+ evidence: string;
193
+ }[];
194
+ rationale: string;
195
+ } | undefined;
196
+ }, {
197
+ action: {
198
+ type: "dispatch_worker";
199
+ params: {
200
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
201
+ parallel?: boolean | undefined;
202
+ branchId?: string | undefined;
203
+ stateId?: string | undefined;
204
+ };
205
+ } | {
206
+ type: "dispatch_parallel_workers";
207
+ params: {
208
+ roles: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[];
209
+ docsOnlyRoles?: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[] | undefined;
210
+ };
211
+ } | {
212
+ type: "dispatch_dynamic_workers";
213
+ params: {
214
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
215
+ sourceArtifact: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
216
+ itemsPath: string;
217
+ };
218
+ } | {
219
+ type: "run_script";
220
+ params: {
221
+ script: string;
222
+ timeout?: number | undefined;
223
+ env?: Record<string, string> | undefined;
224
+ storeOutput?: {
225
+ artifactType: string;
226
+ producedBy: string;
227
+ } | undefined;
228
+ };
229
+ } | {
230
+ type: "store_artifact";
231
+ params: {
232
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
233
+ content: string;
234
+ name?: string | undefined;
235
+ };
236
+ } | {
237
+ type: "record_journal";
238
+ params: {
239
+ event: "run_started" | "run_completed" | "run_failed" | "run_aborted";
240
+ };
241
+ } | {
242
+ type: "generate_agreement";
243
+ params: {
244
+ type: "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_agreement";
245
+ };
246
+ } | {
247
+ type: "notify_human";
248
+ params: {
249
+ reason?: string | undefined;
250
+ };
251
+ } | {
252
+ type: "produce_manifest";
253
+ params: Record<string, never>;
254
+ };
255
+ success: boolean;
256
+ error?: string | undefined;
257
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
258
+ artifactRef?: {
259
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
260
+ name: string;
261
+ version: number;
262
+ checksum: string;
263
+ } | undefined;
264
+ artifactRefs?: readonly {
265
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
266
+ name: string;
267
+ version: number;
268
+ checksum: string;
269
+ }[] | undefined;
270
+ workerResults?: readonly {
271
+ role: string;
272
+ success: boolean;
273
+ error?: string | undefined;
274
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
275
+ artifactRef?: {
276
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
277
+ name: string;
278
+ version: number;
279
+ checksum: string;
280
+ } | undefined;
281
+ model?: string | undefined;
282
+ taskId?: string | undefined;
283
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
284
+ sessionRef?: {
285
+ sessionId: string;
286
+ runId: string;
287
+ stateId: string;
288
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
289
+ transport: "stdio" | "remote";
290
+ } | undefined;
291
+ pendingRequest?: {
292
+ requestId: string;
293
+ kind: "permission";
294
+ createdAt: string;
295
+ payload: {
296
+ [x: string]: unknown;
297
+ action: string;
298
+ resource: string;
299
+ detail?: string | undefined;
300
+ riskLevel?: "high" | "medium" | "low" | undefined;
301
+ externalRequestId?: string | undefined;
302
+ toolInput?: string | undefined;
303
+ granted?: boolean | undefined;
304
+ reason?: string | undefined;
305
+ timedOut?: boolean | undefined;
306
+ aborted?: boolean | undefined;
307
+ };
308
+ } | {
309
+ requestId: string;
310
+ kind: "clarification";
311
+ createdAt: string;
312
+ payload: {
313
+ [x: string]: unknown;
314
+ question: string;
315
+ context?: string | undefined;
316
+ options?: readonly string[] | undefined;
317
+ answer?: string | undefined;
318
+ };
319
+ } | undefined;
320
+ }[] | undefined;
321
+ usageSnapshot?: {
322
+ totalInputTokens: number;
323
+ totalOutputTokens: number;
324
+ byRole: Record<string, {
325
+ inputTokens: number;
326
+ outputTokens: number;
327
+ durationMs: number;
328
+ }>;
329
+ } | undefined;
330
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
331
+ sessionRef?: {
332
+ sessionId: string;
333
+ runId: string;
334
+ stateId: string;
335
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
336
+ transport: "stdio" | "remote";
337
+ } | undefined;
338
+ pendingRequest?: {
339
+ requestId: string;
340
+ kind: "permission";
341
+ createdAt: string;
342
+ payload: {
343
+ [x: string]: unknown;
344
+ action: string;
345
+ resource: string;
346
+ detail?: string | undefined;
347
+ riskLevel?: "high" | "medium" | "low" | undefined;
348
+ externalRequestId?: string | undefined;
349
+ toolInput?: string | undefined;
350
+ granted?: boolean | undefined;
351
+ reason?: string | undefined;
352
+ timedOut?: boolean | undefined;
353
+ aborted?: boolean | undefined;
354
+ };
355
+ } | {
356
+ requestId: string;
357
+ kind: "clarification";
358
+ createdAt: string;
359
+ payload: {
360
+ [x: string]: unknown;
361
+ question: string;
362
+ context?: string | undefined;
363
+ options?: readonly string[] | undefined;
364
+ answer?: string | undefined;
365
+ };
366
+ } | undefined;
367
+ scriptResult?: {
368
+ exitCode: number;
369
+ stdout: string;
370
+ stderr: string;
371
+ durationMs: number;
372
+ output?: {
373
+ message?: string | undefined;
374
+ directives?: {
375
+ repoRoot?: string | undefined;
376
+ } | undefined;
377
+ } | undefined;
378
+ } | undefined;
379
+ confidenceReport?: {
380
+ score: number;
381
+ criteriaResults: {
382
+ criterionId: string;
383
+ met: boolean;
384
+ evidence: string;
385
+ }[];
386
+ rationale: string;
387
+ } | undefined;
388
+ }>>>;
389
+ nextActionIndex: z.ZodNumber;
390
+ waitRequestingState: z.ZodOptional<z.ZodString>;
391
+ completedExitResults: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodCustom<{
392
+ action: {
393
+ type: "dispatch_worker";
394
+ params: {
395
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
396
+ parallel?: boolean | undefined;
397
+ branchId?: string | undefined;
398
+ stateId?: string | undefined;
399
+ };
400
+ } | {
401
+ type: "dispatch_parallel_workers";
402
+ params: {
403
+ roles: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[];
404
+ docsOnlyRoles?: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[] | undefined;
405
+ };
406
+ } | {
407
+ type: "dispatch_dynamic_workers";
408
+ params: {
409
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
410
+ sourceArtifact: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
411
+ itemsPath: string;
412
+ };
413
+ } | {
414
+ type: "run_script";
415
+ params: {
416
+ script: string;
417
+ timeout?: number | undefined;
418
+ env?: Record<string, string> | undefined;
419
+ storeOutput?: {
420
+ artifactType: string;
421
+ producedBy: string;
422
+ } | undefined;
423
+ };
424
+ } | {
425
+ type: "store_artifact";
426
+ params: {
427
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
428
+ content: string;
429
+ name?: string | undefined;
430
+ };
431
+ } | {
432
+ type: "record_journal";
433
+ params: {
434
+ event: "run_started" | "run_completed" | "run_failed" | "run_aborted";
435
+ };
436
+ } | {
437
+ type: "generate_agreement";
438
+ params: {
439
+ type: "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_agreement";
440
+ };
441
+ } | {
442
+ type: "notify_human";
443
+ params: {
444
+ reason?: string | undefined;
445
+ };
446
+ } | {
447
+ type: "produce_manifest";
448
+ params: Record<string, never>;
449
+ };
450
+ success: boolean;
451
+ error?: string | undefined;
452
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
453
+ artifactRef?: {
454
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
455
+ name: string;
456
+ version: number;
457
+ checksum: string;
458
+ } | undefined;
459
+ artifactRefs?: readonly {
460
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
461
+ name: string;
462
+ version: number;
463
+ checksum: string;
464
+ }[] | undefined;
465
+ workerResults?: readonly {
466
+ role: string;
467
+ success: boolean;
468
+ error?: string | undefined;
469
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
470
+ artifactRef?: {
471
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
472
+ name: string;
473
+ version: number;
474
+ checksum: string;
475
+ } | undefined;
476
+ model?: string | undefined;
477
+ taskId?: string | undefined;
478
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
479
+ sessionRef?: {
480
+ sessionId: string;
481
+ runId: string;
482
+ stateId: string;
483
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
484
+ transport: "stdio" | "remote";
485
+ } | undefined;
486
+ pendingRequest?: {
487
+ requestId: string;
488
+ kind: "permission";
489
+ createdAt: string;
490
+ payload: {
491
+ [x: string]: unknown;
492
+ action: string;
493
+ resource: string;
494
+ detail?: string | undefined;
495
+ riskLevel?: "high" | "medium" | "low" | undefined;
496
+ externalRequestId?: string | undefined;
497
+ toolInput?: string | undefined;
498
+ granted?: boolean | undefined;
499
+ reason?: string | undefined;
500
+ timedOut?: boolean | undefined;
501
+ aborted?: boolean | undefined;
502
+ };
503
+ } | {
504
+ requestId: string;
505
+ kind: "clarification";
506
+ createdAt: string;
507
+ payload: {
508
+ [x: string]: unknown;
509
+ question: string;
510
+ context?: string | undefined;
511
+ options?: readonly string[] | undefined;
512
+ answer?: string | undefined;
513
+ };
514
+ } | undefined;
515
+ }[] | undefined;
516
+ usageSnapshot?: {
517
+ totalInputTokens: number;
518
+ totalOutputTokens: number;
519
+ byRole: Record<string, {
520
+ inputTokens: number;
521
+ outputTokens: number;
522
+ durationMs: number;
523
+ }>;
524
+ } | undefined;
525
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
526
+ sessionRef?: {
527
+ sessionId: string;
528
+ runId: string;
529
+ stateId: string;
530
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
531
+ transport: "stdio" | "remote";
532
+ } | undefined;
533
+ pendingRequest?: {
534
+ requestId: string;
535
+ kind: "permission";
536
+ createdAt: string;
537
+ payload: {
538
+ [x: string]: unknown;
539
+ action: string;
540
+ resource: string;
541
+ detail?: string | undefined;
542
+ riskLevel?: "high" | "medium" | "low" | undefined;
543
+ externalRequestId?: string | undefined;
544
+ toolInput?: string | undefined;
545
+ granted?: boolean | undefined;
546
+ reason?: string | undefined;
547
+ timedOut?: boolean | undefined;
548
+ aborted?: boolean | undefined;
549
+ };
550
+ } | {
551
+ requestId: string;
552
+ kind: "clarification";
553
+ createdAt: string;
554
+ payload: {
555
+ [x: string]: unknown;
556
+ question: string;
557
+ context?: string | undefined;
558
+ options?: readonly string[] | undefined;
559
+ answer?: string | undefined;
560
+ };
561
+ } | undefined;
562
+ scriptResult?: {
563
+ exitCode: number;
564
+ stdout: string;
565
+ stderr: string;
566
+ durationMs: number;
567
+ output?: {
568
+ message?: string | undefined;
569
+ directives?: {
570
+ repoRoot?: string | undefined;
571
+ } | undefined;
572
+ } | undefined;
573
+ } | undefined;
574
+ confidenceReport?: {
575
+ score: number;
576
+ criteriaResults: {
577
+ criterionId: string;
578
+ met: boolean;
579
+ evidence: string;
580
+ }[];
581
+ rationale: string;
582
+ } | undefined;
583
+ }, {
584
+ action: {
585
+ type: "dispatch_worker";
586
+ params: {
587
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
588
+ parallel?: boolean | undefined;
589
+ branchId?: string | undefined;
590
+ stateId?: string | undefined;
591
+ };
592
+ } | {
593
+ type: "dispatch_parallel_workers";
594
+ params: {
595
+ roles: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[];
596
+ docsOnlyRoles?: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[] | undefined;
597
+ };
598
+ } | {
599
+ type: "dispatch_dynamic_workers";
600
+ params: {
601
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
602
+ sourceArtifact: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
603
+ itemsPath: string;
604
+ };
605
+ } | {
606
+ type: "run_script";
607
+ params: {
608
+ script: string;
609
+ timeout?: number | undefined;
610
+ env?: Record<string, string> | undefined;
611
+ storeOutput?: {
612
+ artifactType: string;
613
+ producedBy: string;
614
+ } | undefined;
615
+ };
616
+ } | {
617
+ type: "store_artifact";
618
+ params: {
619
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
620
+ content: string;
621
+ name?: string | undefined;
622
+ };
623
+ } | {
624
+ type: "record_journal";
625
+ params: {
626
+ event: "run_started" | "run_completed" | "run_failed" | "run_aborted";
627
+ };
628
+ } | {
629
+ type: "generate_agreement";
630
+ params: {
631
+ type: "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_agreement";
632
+ };
633
+ } | {
634
+ type: "notify_human";
635
+ params: {
636
+ reason?: string | undefined;
637
+ };
638
+ } | {
639
+ type: "produce_manifest";
640
+ params: Record<string, never>;
641
+ };
642
+ success: boolean;
643
+ error?: string | undefined;
644
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
645
+ artifactRef?: {
646
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
647
+ name: string;
648
+ version: number;
649
+ checksum: string;
650
+ } | undefined;
651
+ artifactRefs?: readonly {
652
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
653
+ name: string;
654
+ version: number;
655
+ checksum: string;
656
+ }[] | undefined;
657
+ workerResults?: readonly {
658
+ role: string;
659
+ success: boolean;
660
+ error?: string | undefined;
661
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
662
+ artifactRef?: {
663
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
664
+ name: string;
665
+ version: number;
666
+ checksum: string;
667
+ } | undefined;
668
+ model?: string | undefined;
669
+ taskId?: string | undefined;
670
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
671
+ sessionRef?: {
672
+ sessionId: string;
673
+ runId: string;
674
+ stateId: string;
675
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
676
+ transport: "stdio" | "remote";
677
+ } | undefined;
678
+ pendingRequest?: {
679
+ requestId: string;
680
+ kind: "permission";
681
+ createdAt: string;
682
+ payload: {
683
+ [x: string]: unknown;
684
+ action: string;
685
+ resource: string;
686
+ detail?: string | undefined;
687
+ riskLevel?: "high" | "medium" | "low" | undefined;
688
+ externalRequestId?: string | undefined;
689
+ toolInput?: string | undefined;
690
+ granted?: boolean | undefined;
691
+ reason?: string | undefined;
692
+ timedOut?: boolean | undefined;
693
+ aborted?: boolean | undefined;
694
+ };
695
+ } | {
696
+ requestId: string;
697
+ kind: "clarification";
698
+ createdAt: string;
699
+ payload: {
700
+ [x: string]: unknown;
701
+ question: string;
702
+ context?: string | undefined;
703
+ options?: readonly string[] | undefined;
704
+ answer?: string | undefined;
705
+ };
706
+ } | undefined;
707
+ }[] | undefined;
708
+ usageSnapshot?: {
709
+ totalInputTokens: number;
710
+ totalOutputTokens: number;
711
+ byRole: Record<string, {
712
+ inputTokens: number;
713
+ outputTokens: number;
714
+ durationMs: number;
715
+ }>;
716
+ } | undefined;
717
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
718
+ sessionRef?: {
719
+ sessionId: string;
720
+ runId: string;
721
+ stateId: string;
722
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
723
+ transport: "stdio" | "remote";
724
+ } | undefined;
725
+ pendingRequest?: {
726
+ requestId: string;
727
+ kind: "permission";
728
+ createdAt: string;
729
+ payload: {
730
+ [x: string]: unknown;
731
+ action: string;
732
+ resource: string;
733
+ detail?: string | undefined;
734
+ riskLevel?: "high" | "medium" | "low" | undefined;
735
+ externalRequestId?: string | undefined;
736
+ toolInput?: string | undefined;
737
+ granted?: boolean | undefined;
738
+ reason?: string | undefined;
739
+ timedOut?: boolean | undefined;
740
+ aborted?: boolean | undefined;
741
+ };
742
+ } | {
743
+ requestId: string;
744
+ kind: "clarification";
745
+ createdAt: string;
746
+ payload: {
747
+ [x: string]: unknown;
748
+ question: string;
749
+ context?: string | undefined;
750
+ options?: readonly string[] | undefined;
751
+ answer?: string | undefined;
752
+ };
753
+ } | undefined;
754
+ scriptResult?: {
755
+ exitCode: number;
756
+ stdout: string;
757
+ stderr: string;
758
+ durationMs: number;
759
+ output?: {
760
+ message?: string | undefined;
761
+ directives?: {
762
+ repoRoot?: string | undefined;
763
+ } | undefined;
764
+ } | undefined;
765
+ } | undefined;
766
+ confidenceReport?: {
767
+ score: number;
768
+ criteriaResults: {
769
+ criterionId: string;
770
+ met: boolean;
771
+ evidence: string;
772
+ }[];
773
+ rationale: string;
774
+ } | undefined;
775
+ }>>>>;
776
+ humanFeedback: z.ZodOptional<z.ZodString>;
777
+ previousReviewContent: z.ZodOptional<z.ZodString>;
778
+ iterationCount: z.ZodOptional<z.ZodNumber>;
779
+ resumeInput: z.ZodOptional<z.ZodCustom<{
780
+ type: "text" | "approval" | "rejection";
781
+ content: string;
782
+ artifactRef?: {
783
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
784
+ name: string;
785
+ version: number;
786
+ checksum: string;
787
+ } | undefined;
788
+ sessionId?: string | undefined;
789
+ requestId?: string | undefined;
790
+ waitIdentity?: {
791
+ stateId: string;
792
+ requestingState: string;
793
+ waitingSince: string;
794
+ } | undefined;
795
+ }, {
796
+ type: "text" | "approval" | "rejection";
797
+ content: string;
798
+ artifactRef?: {
799
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
800
+ name: string;
801
+ version: number;
802
+ checksum: string;
803
+ } | undefined;
804
+ sessionId?: string | undefined;
805
+ requestId?: string | undefined;
806
+ waitIdentity?: {
807
+ stateId: string;
808
+ requestingState: string;
809
+ waitingSince: string;
810
+ } | undefined;
811
+ }>>;
812
+ resumeWaitingContext: z.ZodOptional<z.ZodCustom<{
813
+ reason: string;
814
+ requiredInput: string;
815
+ requestingState: string;
816
+ autoResumeSafe: boolean;
817
+ presentedArtifacts: readonly {
818
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
819
+ name: string;
820
+ version: number;
821
+ checksum: string;
822
+ }[];
823
+ waitingSince: string;
824
+ budgetExhaustion?: {
825
+ limitType: "token";
826
+ current: number;
827
+ limit: number;
828
+ cumulativeTokens: number;
829
+ role?: string | undefined;
830
+ } | undefined;
831
+ liveSessionId?: string | undefined;
832
+ pendingRequestId?: string | undefined;
833
+ liveRequestType?: "permission" | "clarification" | undefined;
834
+ sessionTransport?: "stdio" | "remote" | undefined;
835
+ }, {
836
+ reason: string;
837
+ requiredInput: string;
838
+ requestingState: string;
839
+ autoResumeSafe: boolean;
840
+ presentedArtifacts: readonly {
841
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
842
+ name: string;
843
+ version: number;
844
+ checksum: string;
845
+ }[];
846
+ waitingSince: string;
847
+ budgetExhaustion?: {
848
+ limitType: "token";
849
+ current: number;
850
+ limit: number;
851
+ cumulativeTokens: number;
852
+ role?: string | undefined;
853
+ } | undefined;
854
+ liveSessionId?: string | undefined;
855
+ pendingRequestId?: string | undefined;
856
+ liveRequestType?: "permission" | "clarification" | undefined;
857
+ sessionTransport?: "stdio" | "remote" | undefined;
858
+ }>>;
859
+ }, z.core.$strip>;
860
+ export type EntryActionContinuation = z.infer<typeof entryActionContinuationSchema>;
2
861
  export declare const budgetExhaustionContextSchema: z.ZodObject<{
3
862
  limitType: z.ZodLiteral<"token">;
4
863
  current: z.ZodNumber;
@@ -239,6 +1098,10 @@ export declare const persistedStateSchema: z.ZodObject<{
239
1098
  cumulativeInputTokens: z.ZodOptional<z.ZodNumber>;
240
1099
  cumulativeOutputTokens: z.ZodOptional<z.ZodNumber>;
241
1100
  hasReceivedUsage: z.ZodOptional<z.ZodBoolean>;
1101
+ budgetApproved: z.ZodOptional<z.ZodBoolean>;
1102
+ executionPaused: z.ZodOptional<z.ZodBoolean>;
1103
+ pendingTerminalState: z.ZodOptional<z.ZodString>;
1104
+ terminalRecoveryState: z.ZodOptional<z.ZodString>;
242
1105
  governanceDecisionCount: z.ZodOptional<z.ZodNumber>;
243
1106
  escalationCount: z.ZodOptional<z.ZodNumber>;
244
1107
  workerMetricsByRole: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -251,6 +1114,12 @@ export declare const persistedStateSchema: z.ZodObject<{
251
1114
  dispatchCounter: z.ZodOptional<z.ZodNumber>;
252
1115
  firedThresholdIndex: z.ZodOptional<z.ZodNumber>;
253
1116
  lastHumanFeedback: z.ZodOptional<z.ZodString>;
1117
+ lastHumanAnswer: z.ZodOptional<z.ZodObject<{
1118
+ stateId: z.ZodString;
1119
+ requestingState: z.ZodString;
1120
+ waitingSince: z.ZodString;
1121
+ content: z.ZodString;
1122
+ }, z.core.$strip>>;
254
1123
  lastReviewContent: z.ZodOptional<z.ZodString>;
255
1124
  lastTrigger: z.ZodOptional<z.ZodString>;
256
1125
  stateTimestamps: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -344,6 +1213,44 @@ export declare const persistedStateSchema: z.ZodObject<{
344
1213
  checksum: string;
345
1214
  } | undefined;
346
1215
  model?: string | undefined;
1216
+ taskId?: string | undefined;
1217
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
1218
+ sessionRef?: {
1219
+ sessionId: string;
1220
+ runId: string;
1221
+ stateId: string;
1222
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
1223
+ transport: "stdio" | "remote";
1224
+ } | undefined;
1225
+ pendingRequest?: {
1226
+ requestId: string;
1227
+ kind: "permission";
1228
+ createdAt: string;
1229
+ payload: {
1230
+ [x: string]: unknown;
1231
+ action: string;
1232
+ resource: string;
1233
+ detail?: string | undefined;
1234
+ riskLevel?: "high" | "medium" | "low" | undefined;
1235
+ externalRequestId?: string | undefined;
1236
+ toolInput?: string | undefined;
1237
+ granted?: boolean | undefined;
1238
+ reason?: string | undefined;
1239
+ timedOut?: boolean | undefined;
1240
+ aborted?: boolean | undefined;
1241
+ };
1242
+ } | {
1243
+ requestId: string;
1244
+ kind: "clarification";
1245
+ createdAt: string;
1246
+ payload: {
1247
+ [x: string]: unknown;
1248
+ question: string;
1249
+ context?: string | undefined;
1250
+ options?: readonly string[] | undefined;
1251
+ answer?: string | undefined;
1252
+ };
1253
+ } | undefined;
347
1254
  }[] | undefined;
348
1255
  usageSnapshot?: {
349
1256
  totalInputTokens: number;
@@ -498,6 +1405,44 @@ export declare const persistedStateSchema: z.ZodObject<{
498
1405
  checksum: string;
499
1406
  } | undefined;
500
1407
  model?: string | undefined;
1408
+ taskId?: string | undefined;
1409
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
1410
+ sessionRef?: {
1411
+ sessionId: string;
1412
+ runId: string;
1413
+ stateId: string;
1414
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
1415
+ transport: "stdio" | "remote";
1416
+ } | undefined;
1417
+ pendingRequest?: {
1418
+ requestId: string;
1419
+ kind: "permission";
1420
+ createdAt: string;
1421
+ payload: {
1422
+ [x: string]: unknown;
1423
+ action: string;
1424
+ resource: string;
1425
+ detail?: string | undefined;
1426
+ riskLevel?: "high" | "medium" | "low" | undefined;
1427
+ externalRequestId?: string | undefined;
1428
+ toolInput?: string | undefined;
1429
+ granted?: boolean | undefined;
1430
+ reason?: string | undefined;
1431
+ timedOut?: boolean | undefined;
1432
+ aborted?: boolean | undefined;
1433
+ };
1434
+ } | {
1435
+ requestId: string;
1436
+ kind: "clarification";
1437
+ createdAt: string;
1438
+ payload: {
1439
+ [x: string]: unknown;
1440
+ question: string;
1441
+ context?: string | undefined;
1442
+ options?: readonly string[] | undefined;
1443
+ answer?: string | undefined;
1444
+ };
1445
+ } | undefined;
501
1446
  }[] | undefined;
502
1447
  usageSnapshot?: {
503
1448
  totalInputTokens: number;
@@ -567,6 +1512,864 @@ export declare const persistedStateSchema: z.ZodObject<{
567
1512
  rationale: string;
568
1513
  } | undefined;
569
1514
  }>>>>;
1515
+ entryActionContinuation: z.ZodOptional<z.ZodObject<{
1516
+ stateId: z.ZodString;
1517
+ completedResults: z.ZodReadonly<z.ZodArray<z.ZodCustom<{
1518
+ action: {
1519
+ type: "dispatch_worker";
1520
+ params: {
1521
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
1522
+ parallel?: boolean | undefined;
1523
+ branchId?: string | undefined;
1524
+ stateId?: string | undefined;
1525
+ };
1526
+ } | {
1527
+ type: "dispatch_parallel_workers";
1528
+ params: {
1529
+ roles: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[];
1530
+ docsOnlyRoles?: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[] | undefined;
1531
+ };
1532
+ } | {
1533
+ type: "dispatch_dynamic_workers";
1534
+ params: {
1535
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
1536
+ sourceArtifact: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
1537
+ itemsPath: string;
1538
+ };
1539
+ } | {
1540
+ type: "run_script";
1541
+ params: {
1542
+ script: string;
1543
+ timeout?: number | undefined;
1544
+ env?: Record<string, string> | undefined;
1545
+ storeOutput?: {
1546
+ artifactType: string;
1547
+ producedBy: string;
1548
+ } | undefined;
1549
+ };
1550
+ } | {
1551
+ type: "store_artifact";
1552
+ params: {
1553
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
1554
+ content: string;
1555
+ name?: string | undefined;
1556
+ };
1557
+ } | {
1558
+ type: "record_journal";
1559
+ params: {
1560
+ event: "run_started" | "run_completed" | "run_failed" | "run_aborted";
1561
+ };
1562
+ } | {
1563
+ type: "generate_agreement";
1564
+ params: {
1565
+ type: "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_agreement";
1566
+ };
1567
+ } | {
1568
+ type: "notify_human";
1569
+ params: {
1570
+ reason?: string | undefined;
1571
+ };
1572
+ } | {
1573
+ type: "produce_manifest";
1574
+ params: Record<string, never>;
1575
+ };
1576
+ success: boolean;
1577
+ error?: string | undefined;
1578
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
1579
+ artifactRef?: {
1580
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
1581
+ name: string;
1582
+ version: number;
1583
+ checksum: string;
1584
+ } | undefined;
1585
+ artifactRefs?: readonly {
1586
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
1587
+ name: string;
1588
+ version: number;
1589
+ checksum: string;
1590
+ }[] | undefined;
1591
+ workerResults?: readonly {
1592
+ role: string;
1593
+ success: boolean;
1594
+ error?: string | undefined;
1595
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
1596
+ artifactRef?: {
1597
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
1598
+ name: string;
1599
+ version: number;
1600
+ checksum: string;
1601
+ } | undefined;
1602
+ model?: string | undefined;
1603
+ taskId?: string | undefined;
1604
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
1605
+ sessionRef?: {
1606
+ sessionId: string;
1607
+ runId: string;
1608
+ stateId: string;
1609
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
1610
+ transport: "stdio" | "remote";
1611
+ } | undefined;
1612
+ pendingRequest?: {
1613
+ requestId: string;
1614
+ kind: "permission";
1615
+ createdAt: string;
1616
+ payload: {
1617
+ [x: string]: unknown;
1618
+ action: string;
1619
+ resource: string;
1620
+ detail?: string | undefined;
1621
+ riskLevel?: "high" | "medium" | "low" | undefined;
1622
+ externalRequestId?: string | undefined;
1623
+ toolInput?: string | undefined;
1624
+ granted?: boolean | undefined;
1625
+ reason?: string | undefined;
1626
+ timedOut?: boolean | undefined;
1627
+ aborted?: boolean | undefined;
1628
+ };
1629
+ } | {
1630
+ requestId: string;
1631
+ kind: "clarification";
1632
+ createdAt: string;
1633
+ payload: {
1634
+ [x: string]: unknown;
1635
+ question: string;
1636
+ context?: string | undefined;
1637
+ options?: readonly string[] | undefined;
1638
+ answer?: string | undefined;
1639
+ };
1640
+ } | undefined;
1641
+ }[] | undefined;
1642
+ usageSnapshot?: {
1643
+ totalInputTokens: number;
1644
+ totalOutputTokens: number;
1645
+ byRole: Record<string, {
1646
+ inputTokens: number;
1647
+ outputTokens: number;
1648
+ durationMs: number;
1649
+ }>;
1650
+ } | undefined;
1651
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
1652
+ sessionRef?: {
1653
+ sessionId: string;
1654
+ runId: string;
1655
+ stateId: string;
1656
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
1657
+ transport: "stdio" | "remote";
1658
+ } | undefined;
1659
+ pendingRequest?: {
1660
+ requestId: string;
1661
+ kind: "permission";
1662
+ createdAt: string;
1663
+ payload: {
1664
+ [x: string]: unknown;
1665
+ action: string;
1666
+ resource: string;
1667
+ detail?: string | undefined;
1668
+ riskLevel?: "high" | "medium" | "low" | undefined;
1669
+ externalRequestId?: string | undefined;
1670
+ toolInput?: string | undefined;
1671
+ granted?: boolean | undefined;
1672
+ reason?: string | undefined;
1673
+ timedOut?: boolean | undefined;
1674
+ aborted?: boolean | undefined;
1675
+ };
1676
+ } | {
1677
+ requestId: string;
1678
+ kind: "clarification";
1679
+ createdAt: string;
1680
+ payload: {
1681
+ [x: string]: unknown;
1682
+ question: string;
1683
+ context?: string | undefined;
1684
+ options?: readonly string[] | undefined;
1685
+ answer?: string | undefined;
1686
+ };
1687
+ } | undefined;
1688
+ scriptResult?: {
1689
+ exitCode: number;
1690
+ stdout: string;
1691
+ stderr: string;
1692
+ durationMs: number;
1693
+ output?: {
1694
+ message?: string | undefined;
1695
+ directives?: {
1696
+ repoRoot?: string | undefined;
1697
+ } | undefined;
1698
+ } | undefined;
1699
+ } | undefined;
1700
+ confidenceReport?: {
1701
+ score: number;
1702
+ criteriaResults: {
1703
+ criterionId: string;
1704
+ met: boolean;
1705
+ evidence: string;
1706
+ }[];
1707
+ rationale: string;
1708
+ } | undefined;
1709
+ }, {
1710
+ action: {
1711
+ type: "dispatch_worker";
1712
+ params: {
1713
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
1714
+ parallel?: boolean | undefined;
1715
+ branchId?: string | undefined;
1716
+ stateId?: string | undefined;
1717
+ };
1718
+ } | {
1719
+ type: "dispatch_parallel_workers";
1720
+ params: {
1721
+ roles: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[];
1722
+ docsOnlyRoles?: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[] | undefined;
1723
+ };
1724
+ } | {
1725
+ type: "dispatch_dynamic_workers";
1726
+ params: {
1727
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
1728
+ sourceArtifact: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
1729
+ itemsPath: string;
1730
+ };
1731
+ } | {
1732
+ type: "run_script";
1733
+ params: {
1734
+ script: string;
1735
+ timeout?: number | undefined;
1736
+ env?: Record<string, string> | undefined;
1737
+ storeOutput?: {
1738
+ artifactType: string;
1739
+ producedBy: string;
1740
+ } | undefined;
1741
+ };
1742
+ } | {
1743
+ type: "store_artifact";
1744
+ params: {
1745
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
1746
+ content: string;
1747
+ name?: string | undefined;
1748
+ };
1749
+ } | {
1750
+ type: "record_journal";
1751
+ params: {
1752
+ event: "run_started" | "run_completed" | "run_failed" | "run_aborted";
1753
+ };
1754
+ } | {
1755
+ type: "generate_agreement";
1756
+ params: {
1757
+ type: "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_agreement";
1758
+ };
1759
+ } | {
1760
+ type: "notify_human";
1761
+ params: {
1762
+ reason?: string | undefined;
1763
+ };
1764
+ } | {
1765
+ type: "produce_manifest";
1766
+ params: Record<string, never>;
1767
+ };
1768
+ success: boolean;
1769
+ error?: string | undefined;
1770
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
1771
+ artifactRef?: {
1772
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
1773
+ name: string;
1774
+ version: number;
1775
+ checksum: string;
1776
+ } | undefined;
1777
+ artifactRefs?: readonly {
1778
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
1779
+ name: string;
1780
+ version: number;
1781
+ checksum: string;
1782
+ }[] | undefined;
1783
+ workerResults?: readonly {
1784
+ role: string;
1785
+ success: boolean;
1786
+ error?: string | undefined;
1787
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
1788
+ artifactRef?: {
1789
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
1790
+ name: string;
1791
+ version: number;
1792
+ checksum: string;
1793
+ } | undefined;
1794
+ model?: string | undefined;
1795
+ taskId?: string | undefined;
1796
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
1797
+ sessionRef?: {
1798
+ sessionId: string;
1799
+ runId: string;
1800
+ stateId: string;
1801
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
1802
+ transport: "stdio" | "remote";
1803
+ } | undefined;
1804
+ pendingRequest?: {
1805
+ requestId: string;
1806
+ kind: "permission";
1807
+ createdAt: string;
1808
+ payload: {
1809
+ [x: string]: unknown;
1810
+ action: string;
1811
+ resource: string;
1812
+ detail?: string | undefined;
1813
+ riskLevel?: "high" | "medium" | "low" | undefined;
1814
+ externalRequestId?: string | undefined;
1815
+ toolInput?: string | undefined;
1816
+ granted?: boolean | undefined;
1817
+ reason?: string | undefined;
1818
+ timedOut?: boolean | undefined;
1819
+ aborted?: boolean | undefined;
1820
+ };
1821
+ } | {
1822
+ requestId: string;
1823
+ kind: "clarification";
1824
+ createdAt: string;
1825
+ payload: {
1826
+ [x: string]: unknown;
1827
+ question: string;
1828
+ context?: string | undefined;
1829
+ options?: readonly string[] | undefined;
1830
+ answer?: string | undefined;
1831
+ };
1832
+ } | undefined;
1833
+ }[] | undefined;
1834
+ usageSnapshot?: {
1835
+ totalInputTokens: number;
1836
+ totalOutputTokens: number;
1837
+ byRole: Record<string, {
1838
+ inputTokens: number;
1839
+ outputTokens: number;
1840
+ durationMs: number;
1841
+ }>;
1842
+ } | undefined;
1843
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
1844
+ sessionRef?: {
1845
+ sessionId: string;
1846
+ runId: string;
1847
+ stateId: string;
1848
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
1849
+ transport: "stdio" | "remote";
1850
+ } | undefined;
1851
+ pendingRequest?: {
1852
+ requestId: string;
1853
+ kind: "permission";
1854
+ createdAt: string;
1855
+ payload: {
1856
+ [x: string]: unknown;
1857
+ action: string;
1858
+ resource: string;
1859
+ detail?: string | undefined;
1860
+ riskLevel?: "high" | "medium" | "low" | undefined;
1861
+ externalRequestId?: string | undefined;
1862
+ toolInput?: string | undefined;
1863
+ granted?: boolean | undefined;
1864
+ reason?: string | undefined;
1865
+ timedOut?: boolean | undefined;
1866
+ aborted?: boolean | undefined;
1867
+ };
1868
+ } | {
1869
+ requestId: string;
1870
+ kind: "clarification";
1871
+ createdAt: string;
1872
+ payload: {
1873
+ [x: string]: unknown;
1874
+ question: string;
1875
+ context?: string | undefined;
1876
+ options?: readonly string[] | undefined;
1877
+ answer?: string | undefined;
1878
+ };
1879
+ } | undefined;
1880
+ scriptResult?: {
1881
+ exitCode: number;
1882
+ stdout: string;
1883
+ stderr: string;
1884
+ durationMs: number;
1885
+ output?: {
1886
+ message?: string | undefined;
1887
+ directives?: {
1888
+ repoRoot?: string | undefined;
1889
+ } | undefined;
1890
+ } | undefined;
1891
+ } | undefined;
1892
+ confidenceReport?: {
1893
+ score: number;
1894
+ criteriaResults: {
1895
+ criterionId: string;
1896
+ met: boolean;
1897
+ evidence: string;
1898
+ }[];
1899
+ rationale: string;
1900
+ } | undefined;
1901
+ }>>>;
1902
+ nextActionIndex: z.ZodNumber;
1903
+ waitRequestingState: z.ZodOptional<z.ZodString>;
1904
+ completedExitResults: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodCustom<{
1905
+ action: {
1906
+ type: "dispatch_worker";
1907
+ params: {
1908
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
1909
+ parallel?: boolean | undefined;
1910
+ branchId?: string | undefined;
1911
+ stateId?: string | undefined;
1912
+ };
1913
+ } | {
1914
+ type: "dispatch_parallel_workers";
1915
+ params: {
1916
+ roles: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[];
1917
+ docsOnlyRoles?: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[] | undefined;
1918
+ };
1919
+ } | {
1920
+ type: "dispatch_dynamic_workers";
1921
+ params: {
1922
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
1923
+ sourceArtifact: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
1924
+ itemsPath: string;
1925
+ };
1926
+ } | {
1927
+ type: "run_script";
1928
+ params: {
1929
+ script: string;
1930
+ timeout?: number | undefined;
1931
+ env?: Record<string, string> | undefined;
1932
+ storeOutput?: {
1933
+ artifactType: string;
1934
+ producedBy: string;
1935
+ } | undefined;
1936
+ };
1937
+ } | {
1938
+ type: "store_artifact";
1939
+ params: {
1940
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
1941
+ content: string;
1942
+ name?: string | undefined;
1943
+ };
1944
+ } | {
1945
+ type: "record_journal";
1946
+ params: {
1947
+ event: "run_started" | "run_completed" | "run_failed" | "run_aborted";
1948
+ };
1949
+ } | {
1950
+ type: "generate_agreement";
1951
+ params: {
1952
+ type: "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_agreement";
1953
+ };
1954
+ } | {
1955
+ type: "notify_human";
1956
+ params: {
1957
+ reason?: string | undefined;
1958
+ };
1959
+ } | {
1960
+ type: "produce_manifest";
1961
+ params: Record<string, never>;
1962
+ };
1963
+ success: boolean;
1964
+ error?: string | undefined;
1965
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
1966
+ artifactRef?: {
1967
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
1968
+ name: string;
1969
+ version: number;
1970
+ checksum: string;
1971
+ } | undefined;
1972
+ artifactRefs?: readonly {
1973
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
1974
+ name: string;
1975
+ version: number;
1976
+ checksum: string;
1977
+ }[] | undefined;
1978
+ workerResults?: readonly {
1979
+ role: string;
1980
+ success: boolean;
1981
+ error?: string | undefined;
1982
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
1983
+ artifactRef?: {
1984
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
1985
+ name: string;
1986
+ version: number;
1987
+ checksum: string;
1988
+ } | undefined;
1989
+ model?: string | undefined;
1990
+ taskId?: string | undefined;
1991
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
1992
+ sessionRef?: {
1993
+ sessionId: string;
1994
+ runId: string;
1995
+ stateId: string;
1996
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
1997
+ transport: "stdio" | "remote";
1998
+ } | undefined;
1999
+ pendingRequest?: {
2000
+ requestId: string;
2001
+ kind: "permission";
2002
+ createdAt: string;
2003
+ payload: {
2004
+ [x: string]: unknown;
2005
+ action: string;
2006
+ resource: string;
2007
+ detail?: string | undefined;
2008
+ riskLevel?: "high" | "medium" | "low" | undefined;
2009
+ externalRequestId?: string | undefined;
2010
+ toolInput?: string | undefined;
2011
+ granted?: boolean | undefined;
2012
+ reason?: string | undefined;
2013
+ timedOut?: boolean | undefined;
2014
+ aborted?: boolean | undefined;
2015
+ };
2016
+ } | {
2017
+ requestId: string;
2018
+ kind: "clarification";
2019
+ createdAt: string;
2020
+ payload: {
2021
+ [x: string]: unknown;
2022
+ question: string;
2023
+ context?: string | undefined;
2024
+ options?: readonly string[] | undefined;
2025
+ answer?: string | undefined;
2026
+ };
2027
+ } | undefined;
2028
+ }[] | undefined;
2029
+ usageSnapshot?: {
2030
+ totalInputTokens: number;
2031
+ totalOutputTokens: number;
2032
+ byRole: Record<string, {
2033
+ inputTokens: number;
2034
+ outputTokens: number;
2035
+ durationMs: number;
2036
+ }>;
2037
+ } | undefined;
2038
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
2039
+ sessionRef?: {
2040
+ sessionId: string;
2041
+ runId: string;
2042
+ stateId: string;
2043
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
2044
+ transport: "stdio" | "remote";
2045
+ } | undefined;
2046
+ pendingRequest?: {
2047
+ requestId: string;
2048
+ kind: "permission";
2049
+ createdAt: string;
2050
+ payload: {
2051
+ [x: string]: unknown;
2052
+ action: string;
2053
+ resource: string;
2054
+ detail?: string | undefined;
2055
+ riskLevel?: "high" | "medium" | "low" | undefined;
2056
+ externalRequestId?: string | undefined;
2057
+ toolInput?: string | undefined;
2058
+ granted?: boolean | undefined;
2059
+ reason?: string | undefined;
2060
+ timedOut?: boolean | undefined;
2061
+ aborted?: boolean | undefined;
2062
+ };
2063
+ } | {
2064
+ requestId: string;
2065
+ kind: "clarification";
2066
+ createdAt: string;
2067
+ payload: {
2068
+ [x: string]: unknown;
2069
+ question: string;
2070
+ context?: string | undefined;
2071
+ options?: readonly string[] | undefined;
2072
+ answer?: string | undefined;
2073
+ };
2074
+ } | undefined;
2075
+ scriptResult?: {
2076
+ exitCode: number;
2077
+ stdout: string;
2078
+ stderr: string;
2079
+ durationMs: number;
2080
+ output?: {
2081
+ message?: string | undefined;
2082
+ directives?: {
2083
+ repoRoot?: string | undefined;
2084
+ } | undefined;
2085
+ } | undefined;
2086
+ } | undefined;
2087
+ confidenceReport?: {
2088
+ score: number;
2089
+ criteriaResults: {
2090
+ criterionId: string;
2091
+ met: boolean;
2092
+ evidence: string;
2093
+ }[];
2094
+ rationale: string;
2095
+ } | undefined;
2096
+ }, {
2097
+ action: {
2098
+ type: "dispatch_worker";
2099
+ params: {
2100
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
2101
+ parallel?: boolean | undefined;
2102
+ branchId?: string | undefined;
2103
+ stateId?: string | undefined;
2104
+ };
2105
+ } | {
2106
+ type: "dispatch_parallel_workers";
2107
+ params: {
2108
+ roles: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[];
2109
+ docsOnlyRoles?: readonly ("judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer")[] | undefined;
2110
+ };
2111
+ } | {
2112
+ type: "dispatch_dynamic_workers";
2113
+ params: {
2114
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
2115
+ sourceArtifact: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
2116
+ itemsPath: string;
2117
+ };
2118
+ } | {
2119
+ type: "run_script";
2120
+ params: {
2121
+ script: string;
2122
+ timeout?: number | undefined;
2123
+ env?: Record<string, string> | undefined;
2124
+ storeOutput?: {
2125
+ artifactType: string;
2126
+ producedBy: string;
2127
+ } | undefined;
2128
+ };
2129
+ } | {
2130
+ type: "store_artifact";
2131
+ params: {
2132
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
2133
+ content: string;
2134
+ name?: string | undefined;
2135
+ };
2136
+ } | {
2137
+ type: "record_journal";
2138
+ params: {
2139
+ event: "run_started" | "run_completed" | "run_failed" | "run_aborted";
2140
+ };
2141
+ } | {
2142
+ type: "generate_agreement";
2143
+ params: {
2144
+ type: "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_agreement";
2145
+ };
2146
+ } | {
2147
+ type: "notify_human";
2148
+ params: {
2149
+ reason?: string | undefined;
2150
+ };
2151
+ } | {
2152
+ type: "produce_manifest";
2153
+ params: Record<string, never>;
2154
+ };
2155
+ success: boolean;
2156
+ error?: string | undefined;
2157
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
2158
+ artifactRef?: {
2159
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
2160
+ name: string;
2161
+ version: number;
2162
+ checksum: string;
2163
+ } | undefined;
2164
+ artifactRefs?: readonly {
2165
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
2166
+ name: string;
2167
+ version: number;
2168
+ checksum: string;
2169
+ }[] | undefined;
2170
+ workerResults?: readonly {
2171
+ role: string;
2172
+ success: boolean;
2173
+ error?: string | undefined;
2174
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
2175
+ artifactRef?: {
2176
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
2177
+ name: string;
2178
+ version: number;
2179
+ checksum: string;
2180
+ } | undefined;
2181
+ model?: string | undefined;
2182
+ taskId?: string | undefined;
2183
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
2184
+ sessionRef?: {
2185
+ sessionId: string;
2186
+ runId: string;
2187
+ stateId: string;
2188
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
2189
+ transport: "stdio" | "remote";
2190
+ } | undefined;
2191
+ pendingRequest?: {
2192
+ requestId: string;
2193
+ kind: "permission";
2194
+ createdAt: string;
2195
+ payload: {
2196
+ [x: string]: unknown;
2197
+ action: string;
2198
+ resource: string;
2199
+ detail?: string | undefined;
2200
+ riskLevel?: "high" | "medium" | "low" | undefined;
2201
+ externalRequestId?: string | undefined;
2202
+ toolInput?: string | undefined;
2203
+ granted?: boolean | undefined;
2204
+ reason?: string | undefined;
2205
+ timedOut?: boolean | undefined;
2206
+ aborted?: boolean | undefined;
2207
+ };
2208
+ } | {
2209
+ requestId: string;
2210
+ kind: "clarification";
2211
+ createdAt: string;
2212
+ payload: {
2213
+ [x: string]: unknown;
2214
+ question: string;
2215
+ context?: string | undefined;
2216
+ options?: readonly string[] | undefined;
2217
+ answer?: string | undefined;
2218
+ };
2219
+ } | undefined;
2220
+ }[] | undefined;
2221
+ usageSnapshot?: {
2222
+ totalInputTokens: number;
2223
+ totalOutputTokens: number;
2224
+ byRole: Record<string, {
2225
+ inputTokens: number;
2226
+ outputTokens: number;
2227
+ durationMs: number;
2228
+ }>;
2229
+ } | undefined;
2230
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
2231
+ sessionRef?: {
2232
+ sessionId: string;
2233
+ runId: string;
2234
+ stateId: string;
2235
+ role: "judge" | "requirements_analyst" | "context_analyst" | "codebase_analyst" | "planner" | "plan_reviewer" | "implementer" | "test_engineer" | "static_reviewer" | "security_reviewer" | "performance_reviewer" | "adversarial_reviewer" | "design_reviewer" | "docs_reviewer" | "ux_reviewer" | "report_synthesizer" | "remediation_triage" | "verifier" | "summary_writer" | "review_findings_writer" | "acceptance_validator" | "breakdown_analyst" | "decomposer" | "decomposition_reviewer" | "task_spec_writer";
2236
+ transport: "stdio" | "remote";
2237
+ } | undefined;
2238
+ pendingRequest?: {
2239
+ requestId: string;
2240
+ kind: "permission";
2241
+ createdAt: string;
2242
+ payload: {
2243
+ [x: string]: unknown;
2244
+ action: string;
2245
+ resource: string;
2246
+ detail?: string | undefined;
2247
+ riskLevel?: "high" | "medium" | "low" | undefined;
2248
+ externalRequestId?: string | undefined;
2249
+ toolInput?: string | undefined;
2250
+ granted?: boolean | undefined;
2251
+ reason?: string | undefined;
2252
+ timedOut?: boolean | undefined;
2253
+ aborted?: boolean | undefined;
2254
+ };
2255
+ } | {
2256
+ requestId: string;
2257
+ kind: "clarification";
2258
+ createdAt: string;
2259
+ payload: {
2260
+ [x: string]: unknown;
2261
+ question: string;
2262
+ context?: string | undefined;
2263
+ options?: readonly string[] | undefined;
2264
+ answer?: string | undefined;
2265
+ };
2266
+ } | undefined;
2267
+ scriptResult?: {
2268
+ exitCode: number;
2269
+ stdout: string;
2270
+ stderr: string;
2271
+ durationMs: number;
2272
+ output?: {
2273
+ message?: string | undefined;
2274
+ directives?: {
2275
+ repoRoot?: string | undefined;
2276
+ } | undefined;
2277
+ } | undefined;
2278
+ } | undefined;
2279
+ confidenceReport?: {
2280
+ score: number;
2281
+ criteriaResults: {
2282
+ criterionId: string;
2283
+ met: boolean;
2284
+ evidence: string;
2285
+ }[];
2286
+ rationale: string;
2287
+ } | undefined;
2288
+ }>>>>;
2289
+ humanFeedback: z.ZodOptional<z.ZodString>;
2290
+ previousReviewContent: z.ZodOptional<z.ZodString>;
2291
+ iterationCount: z.ZodOptional<z.ZodNumber>;
2292
+ resumeInput: z.ZodOptional<z.ZodCustom<{
2293
+ type: "text" | "approval" | "rejection";
2294
+ content: string;
2295
+ artifactRef?: {
2296
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
2297
+ name: string;
2298
+ version: number;
2299
+ checksum: string;
2300
+ } | undefined;
2301
+ sessionId?: string | undefined;
2302
+ requestId?: string | undefined;
2303
+ waitIdentity?: {
2304
+ stateId: string;
2305
+ requestingState: string;
2306
+ waitingSince: string;
2307
+ } | undefined;
2308
+ }, {
2309
+ type: "text" | "approval" | "rejection";
2310
+ content: string;
2311
+ artifactRef?: {
2312
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
2313
+ name: string;
2314
+ version: number;
2315
+ checksum: string;
2316
+ } | undefined;
2317
+ sessionId?: string | undefined;
2318
+ requestId?: string | undefined;
2319
+ waitIdentity?: {
2320
+ stateId: string;
2321
+ requestingState: string;
2322
+ waitingSince: string;
2323
+ } | undefined;
2324
+ }>>;
2325
+ resumeWaitingContext: z.ZodOptional<z.ZodCustom<{
2326
+ reason: string;
2327
+ requiredInput: string;
2328
+ requestingState: string;
2329
+ autoResumeSafe: boolean;
2330
+ presentedArtifacts: readonly {
2331
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
2332
+ name: string;
2333
+ version: number;
2334
+ checksum: string;
2335
+ }[];
2336
+ waitingSince: string;
2337
+ budgetExhaustion?: {
2338
+ limitType: "token";
2339
+ current: number;
2340
+ limit: number;
2341
+ cumulativeTokens: number;
2342
+ role?: string | undefined;
2343
+ } | undefined;
2344
+ liveSessionId?: string | undefined;
2345
+ pendingRequestId?: string | undefined;
2346
+ liveRequestType?: "permission" | "clarification" | undefined;
2347
+ sessionTransport?: "stdio" | "remote" | undefined;
2348
+ }, {
2349
+ reason: string;
2350
+ requiredInput: string;
2351
+ requestingState: string;
2352
+ autoResumeSafe: boolean;
2353
+ presentedArtifacts: readonly {
2354
+ type: "intake_requirements" | "canonical_specification" | "clarification_questions" | "clarification_answers" | "plan" | "plan_review" | "test_plan" | "implementation" | "static_review" | "security_review" | "performance_review" | "adversarial_review" | "design_review" | "docs_review" | "ux_review" | "review_report" | "remediation_plan" | "verification" | "judge_decision" | "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_summary" | "release_agreement" | "escalation_context" | "run_manifest" | "codebase_context" | "test_suite" | "acceptance_validation" | "review_findings" | "task_breakdown" | "decomposition_review" | "task_specifications" | "pr_diff_context";
2355
+ name: string;
2356
+ version: number;
2357
+ checksum: string;
2358
+ }[];
2359
+ waitingSince: string;
2360
+ budgetExhaustion?: {
2361
+ limitType: "token";
2362
+ current: number;
2363
+ limit: number;
2364
+ cumulativeTokens: number;
2365
+ role?: string | undefined;
2366
+ } | undefined;
2367
+ liveSessionId?: string | undefined;
2368
+ pendingRequestId?: string | undefined;
2369
+ liveRequestType?: "permission" | "clarification" | undefined;
2370
+ sessionTransport?: "stdio" | "remote" | undefined;
2371
+ }>>;
2372
+ }, z.core.$strip>>;
570
2373
  }, z.core.$strip>;
571
2374
  export type PersistedState = z.infer<typeof persistedStateSchema>;
572
2375
  export declare const stateValidationResultSchema: z.ZodObject<{
@@ -581,5 +2384,6 @@ export declare const lockHandleSchema: z.ZodObject<{
581
2384
  acquiredAt: z.ZodString;
582
2385
  lockPath: z.ZodString;
583
2386
  hostname: z.ZodString;
2387
+ ownershipToken: z.ZodOptional<z.ZodUUID>;
584
2388
  }, z.core.$strip>;
585
2389
  export type LockHandle = z.infer<typeof lockHandleSchema>;