@ai-dev-orchestrator/schemas 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,10 +1,10 @@
1
1
  import { z } from 'zod/v4';
2
2
  export declare const runStatusSchema: z.ZodEnum<{
3
+ completed: "completed";
4
+ aborted: "aborted";
3
5
  running: "running";
4
6
  paused: "paused";
5
- completed: "completed";
6
7
  failed: "failed";
7
- aborted: "aborted";
8
8
  waiting: "waiting";
9
9
  interrupted: "interrupted";
10
10
  }>;
@@ -99,11 +99,11 @@ export type DashboardSessionView = z.infer<typeof dashboardSessionViewSchema>;
99
99
  export declare const runStateViewSchema: z.ZodObject<{
100
100
  runId: z.ZodString;
101
101
  status: z.ZodEnum<{
102
+ completed: "completed";
103
+ aborted: "aborted";
102
104
  running: "running";
103
105
  paused: "paused";
104
- completed: "completed";
105
106
  failed: "failed";
106
- aborted: "aborted";
107
107
  waiting: "waiting";
108
108
  interrupted: "interrupted";
109
109
  }>;
@@ -56,8 +56,8 @@ export declare const runHistoryEntrySchema: z.ZodObject<{
56
56
  outcome: z.ZodEnum<{
57
57
  escalated: "escalated";
58
58
  completed: "completed";
59
- failed: "failed";
60
59
  aborted: "aborted";
60
+ failed: "failed";
61
61
  }>;
62
62
  compressed: z.ZodBoolean;
63
63
  keyFindings: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -75,8 +75,8 @@ export declare const runHistorySchema: z.ZodObject<{
75
75
  outcome: z.ZodEnum<{
76
76
  escalated: "escalated";
77
77
  completed: "completed";
78
- failed: "failed";
79
78
  aborted: "aborted";
79
+ failed: "failed";
80
80
  }>;
81
81
  compressed: z.ZodBoolean;
82
82
  keyFindings: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -258,6 +258,315 @@ export declare const persistedStateSchema: z.ZodObject<{
258
258
  enteredAt: z.ZodString;
259
259
  exitedAt: z.ZodString;
260
260
  }, z.core.$strip>>>>;
261
+ interruptedActionResults: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodCustom<{
262
+ action: {
263
+ type: "dispatch_worker";
264
+ params: {
265
+ 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";
266
+ parallel?: boolean | undefined;
267
+ branchId?: string | undefined;
268
+ stateId?: string | undefined;
269
+ };
270
+ } | {
271
+ type: "dispatch_parallel_workers";
272
+ params: {
273
+ 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")[];
274
+ 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;
275
+ };
276
+ } | {
277
+ type: "dispatch_dynamic_workers";
278
+ params: {
279
+ 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";
280
+ 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";
281
+ itemsPath: string;
282
+ };
283
+ } | {
284
+ type: "run_script";
285
+ params: {
286
+ script: string;
287
+ timeout?: number | undefined;
288
+ env?: Record<string, string> | undefined;
289
+ storeOutput?: {
290
+ artifactType: string;
291
+ producedBy: string;
292
+ } | undefined;
293
+ };
294
+ } | {
295
+ type: "store_artifact";
296
+ params: {
297
+ 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";
298
+ content: string;
299
+ name?: string | undefined;
300
+ };
301
+ } | {
302
+ type: "record_journal";
303
+ params: {
304
+ event: "run_started" | "run_completed" | "run_failed" | "run_aborted";
305
+ };
306
+ } | {
307
+ type: "generate_agreement";
308
+ params: {
309
+ type: "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_agreement";
310
+ };
311
+ } | {
312
+ type: "notify_human";
313
+ params: {
314
+ reason?: string | undefined;
315
+ };
316
+ } | {
317
+ type: "produce_manifest";
318
+ params: Record<string, never>;
319
+ };
320
+ success: boolean;
321
+ error?: string | undefined;
322
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
323
+ artifactRef?: {
324
+ 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";
325
+ name: string;
326
+ version: number;
327
+ checksum: string;
328
+ } | undefined;
329
+ artifactRefs?: readonly {
330
+ 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";
331
+ name: string;
332
+ version: number;
333
+ checksum: string;
334
+ }[] | undefined;
335
+ workerResults?: readonly {
336
+ role: string;
337
+ success: boolean;
338
+ error?: string | undefined;
339
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
340
+ artifactRef?: {
341
+ 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";
342
+ name: string;
343
+ version: number;
344
+ checksum: string;
345
+ } | undefined;
346
+ model?: string | undefined;
347
+ }[] | undefined;
348
+ usageSnapshot?: {
349
+ totalInputTokens: number;
350
+ totalOutputTokens: number;
351
+ byRole: Record<string, {
352
+ inputTokens: number;
353
+ outputTokens: number;
354
+ durationMs: number;
355
+ }>;
356
+ } | undefined;
357
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
358
+ sessionRef?: {
359
+ sessionId: string;
360
+ runId: string;
361
+ stateId: string;
362
+ 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";
363
+ transport: "stdio" | "remote";
364
+ } | undefined;
365
+ pendingRequest?: {
366
+ requestId: string;
367
+ kind: "permission";
368
+ createdAt: string;
369
+ payload: {
370
+ [x: string]: unknown;
371
+ action: string;
372
+ resource: string;
373
+ detail?: string | undefined;
374
+ riskLevel?: "high" | "medium" | "low" | undefined;
375
+ externalRequestId?: string | undefined;
376
+ toolInput?: string | undefined;
377
+ granted?: boolean | undefined;
378
+ reason?: string | undefined;
379
+ timedOut?: boolean | undefined;
380
+ aborted?: boolean | undefined;
381
+ };
382
+ } | {
383
+ requestId: string;
384
+ kind: "clarification";
385
+ createdAt: string;
386
+ payload: {
387
+ [x: string]: unknown;
388
+ question: string;
389
+ context?: string | undefined;
390
+ options?: readonly string[] | undefined;
391
+ answer?: string | undefined;
392
+ };
393
+ } | undefined;
394
+ scriptResult?: {
395
+ exitCode: number;
396
+ stdout: string;
397
+ stderr: string;
398
+ durationMs: number;
399
+ output?: {
400
+ message?: string | undefined;
401
+ directives?: {
402
+ repoRoot?: string | undefined;
403
+ } | undefined;
404
+ } | undefined;
405
+ } | undefined;
406
+ confidenceReport?: {
407
+ score: number;
408
+ criteriaResults: {
409
+ criterionId: string;
410
+ met: boolean;
411
+ evidence: string;
412
+ }[];
413
+ rationale: string;
414
+ } | undefined;
415
+ }, {
416
+ action: {
417
+ type: "dispatch_worker";
418
+ params: {
419
+ 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";
420
+ parallel?: boolean | undefined;
421
+ branchId?: string | undefined;
422
+ stateId?: string | undefined;
423
+ };
424
+ } | {
425
+ type: "dispatch_parallel_workers";
426
+ params: {
427
+ 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")[];
428
+ 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;
429
+ };
430
+ } | {
431
+ type: "dispatch_dynamic_workers";
432
+ params: {
433
+ 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";
434
+ 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";
435
+ itemsPath: string;
436
+ };
437
+ } | {
438
+ type: "run_script";
439
+ params: {
440
+ script: string;
441
+ timeout?: number | undefined;
442
+ env?: Record<string, string> | undefined;
443
+ storeOutput?: {
444
+ artifactType: string;
445
+ producedBy: string;
446
+ } | undefined;
447
+ };
448
+ } | {
449
+ type: "store_artifact";
450
+ params: {
451
+ 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";
452
+ content: string;
453
+ name?: string | undefined;
454
+ };
455
+ } | {
456
+ type: "record_journal";
457
+ params: {
458
+ event: "run_started" | "run_completed" | "run_failed" | "run_aborted";
459
+ };
460
+ } | {
461
+ type: "generate_agreement";
462
+ params: {
463
+ type: "planning_agreement" | "implementation_agreement" | "verification_agreement" | "release_agreement";
464
+ };
465
+ } | {
466
+ type: "notify_human";
467
+ params: {
468
+ reason?: string | undefined;
469
+ };
470
+ } | {
471
+ type: "produce_manifest";
472
+ params: Record<string, never>;
473
+ };
474
+ success: boolean;
475
+ error?: string | undefined;
476
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
477
+ artifactRef?: {
478
+ 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";
479
+ name: string;
480
+ version: number;
481
+ checksum: string;
482
+ } | undefined;
483
+ artifactRefs?: readonly {
484
+ 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";
485
+ name: string;
486
+ version: number;
487
+ checksum: string;
488
+ }[] | undefined;
489
+ workerResults?: readonly {
490
+ role: string;
491
+ success: boolean;
492
+ error?: string | undefined;
493
+ errorType?: "timeout" | "agent_error" | "invalid_output" | "schema_violation" | "ownership_violation" | "cancelled" | undefined;
494
+ artifactRef?: {
495
+ 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";
496
+ name: string;
497
+ version: number;
498
+ checksum: string;
499
+ } | undefined;
500
+ model?: string | undefined;
501
+ }[] | undefined;
502
+ usageSnapshot?: {
503
+ totalInputTokens: number;
504
+ totalOutputTokens: number;
505
+ byRole: Record<string, {
506
+ inputTokens: number;
507
+ outputTokens: number;
508
+ durationMs: number;
509
+ }>;
510
+ } | undefined;
511
+ sessionOutcome?: "completed" | "awaiting_human" | "session_active" | undefined;
512
+ sessionRef?: {
513
+ sessionId: string;
514
+ runId: string;
515
+ stateId: string;
516
+ 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";
517
+ transport: "stdio" | "remote";
518
+ } | undefined;
519
+ pendingRequest?: {
520
+ requestId: string;
521
+ kind: "permission";
522
+ createdAt: string;
523
+ payload: {
524
+ [x: string]: unknown;
525
+ action: string;
526
+ resource: string;
527
+ detail?: string | undefined;
528
+ riskLevel?: "high" | "medium" | "low" | undefined;
529
+ externalRequestId?: string | undefined;
530
+ toolInput?: string | undefined;
531
+ granted?: boolean | undefined;
532
+ reason?: string | undefined;
533
+ timedOut?: boolean | undefined;
534
+ aborted?: boolean | undefined;
535
+ };
536
+ } | {
537
+ requestId: string;
538
+ kind: "clarification";
539
+ createdAt: string;
540
+ payload: {
541
+ [x: string]: unknown;
542
+ question: string;
543
+ context?: string | undefined;
544
+ options?: readonly string[] | undefined;
545
+ answer?: string | undefined;
546
+ };
547
+ } | undefined;
548
+ scriptResult?: {
549
+ exitCode: number;
550
+ stdout: string;
551
+ stderr: string;
552
+ durationMs: number;
553
+ output?: {
554
+ message?: string | undefined;
555
+ directives?: {
556
+ repoRoot?: string | undefined;
557
+ } | undefined;
558
+ } | undefined;
559
+ } | undefined;
560
+ confidenceReport?: {
561
+ score: number;
562
+ criteriaResults: {
563
+ criterionId: string;
564
+ met: boolean;
565
+ evidence: string;
566
+ }[];
567
+ rationale: string;
568
+ } | undefined;
569
+ }>>>>;
261
570
  }, z.core.$strip>;
262
571
  export type PersistedState = z.infer<typeof persistedStateSchema>;
263
572
  export declare const stateValidationResultSchema: z.ZodObject<{
@@ -68,6 +68,8 @@ export const persistedStateSchema = z.object({
68
68
  }))
69
69
  .readonly()
70
70
  .optional(),
71
+ /** Action results completed before a post-action budget pause. */
72
+ interruptedActionResults: z.array(z.custom()).readonly().optional(),
71
73
  });
72
74
  export const stateValidationResultSchema = z.object({
73
75
  valid: z.boolean(),
@@ -3,6 +3,7 @@ export declare const BUILT_IN_CODING_RUNNER_ID: {
3
3
  readonly CLAUDE_CODE: "claude-code";
4
4
  readonly CODEX: "codex";
5
5
  readonly CURSOR: "cursor";
6
+ readonly OPENCODE: "opencode";
6
7
  };
7
8
  export type BuiltInCodingRunnerId = (typeof BUILT_IN_CODING_RUNNER_ID)[keyof typeof BUILT_IN_CODING_RUNNER_ID];
8
9
  export declare const BUILT_IN_CODING_RUNNER_IDS: readonly BuiltInCodingRunnerId[];
@@ -3,9 +3,11 @@ export const BUILT_IN_CODING_RUNNER_ID = {
3
3
  CLAUDE_CODE: 'claude-code',
4
4
  CODEX: 'codex',
5
5
  CURSOR: 'cursor',
6
+ OPENCODE: 'opencode',
6
7
  };
7
8
  export const BUILT_IN_CODING_RUNNER_IDS = [
8
9
  BUILT_IN_CODING_RUNNER_ID.CLAUDE_CODE,
9
10
  BUILT_IN_CODING_RUNNER_ID.CODEX,
10
11
  BUILT_IN_CODING_RUNNER_ID.CURSOR,
12
+ BUILT_IN_CODING_RUNNER_ID.OPENCODE,
11
13
  ];
@@ -1,13 +1,13 @@
1
1
  import { z } from 'zod/v4';
2
2
  import { type AgentStreamEventType } from '../shared/string-enums';
3
3
  export declare const agentSessionStateSchema: z.ZodEnum<{
4
- running: "running";
4
+ completed: "completed";
5
5
  awaiting_human: "awaiting_human";
6
+ aborted: "aborted";
7
+ running: "running";
6
8
  paused: "paused";
7
9
  reconnecting: "reconnecting";
8
- completed: "completed";
9
10
  failed: "failed";
10
- aborted: "aborted";
11
11
  orphaned: "orphaned";
12
12
  }>;
13
13
  export type AgentSessionState = z.infer<typeof agentSessionStateSchema>;
@@ -172,13 +172,13 @@ export declare const agentSessionSnapshotSchema: z.ZodObject<{
172
172
  }>;
173
173
  }, z.core.$strip>;
174
174
  state: z.ZodEnum<{
175
- running: "running";
175
+ completed: "completed";
176
176
  awaiting_human: "awaiting_human";
177
+ aborted: "aborted";
178
+ running: "running";
177
179
  paused: "paused";
178
180
  reconnecting: "reconnecting";
179
- completed: "completed";
180
181
  failed: "failed";
181
- aborted: "aborted";
182
182
  orphaned: "orphaned";
183
183
  }>;
184
184
  pendingRequests: z.ZodReadonly<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -271,13 +271,13 @@ export declare const agentSessionHandleSchema: z.ZodObject<{
271
271
  }>;
272
272
  }, z.core.$strip>;
273
273
  state: z.ZodEnum<{
274
- running: "running";
274
+ completed: "completed";
275
275
  awaiting_human: "awaiting_human";
276
+ aborted: "aborted";
277
+ running: "running";
276
278
  paused: "paused";
277
279
  reconnecting: "reconnecting";
278
- completed: "completed";
279
280
  failed: "failed";
280
- aborted: "aborted";
281
281
  orphaned: "orphaned";
282
282
  }>;
283
283
  pendingRequests: z.ZodReadonly<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -314,8 +314,8 @@ export declare const agentSessionHandleSchema: z.ZodObject<{
314
314
  }, z.core.$strip>;
315
315
  export type AgentSessionHandle = z.infer<typeof agentSessionHandleSchema>;
316
316
  export declare const sessionDispatchOutcomeSchema: z.ZodEnum<{
317
- awaiting_human: "awaiting_human";
318
317
  completed: "completed";
318
+ awaiting_human: "awaiting_human";
319
319
  session_active: "session_active";
320
320
  }>;
321
321
  export type SessionDispatchOutcome = z.infer<typeof sessionDispatchOutcomeSchema>;
@@ -848,8 +848,8 @@ export declare const dispatchResultSchema: z.ZodObject<{
848
848
  modelUsed: z.ZodString;
849
849
  }, z.core.$strip>;
850
850
  sessionOutcome: z.ZodOptional<z.ZodEnum<{
851
- awaiting_human: "awaiting_human";
852
851
  completed: "completed";
852
+ awaiting_human: "awaiting_human";
853
853
  session_active: "session_active";
854
854
  }>>;
855
855
  sessionRef: z.ZodOptional<z.ZodObject<{
@@ -951,8 +951,8 @@ export declare const workerStatusSchema: z.ZodObject<{
951
951
  task_spec_writer: "task_spec_writer";
952
952
  }>;
953
953
  state: z.ZodEnum<{
954
- running: "running";
955
954
  completed: "completed";
955
+ running: "running";
956
956
  failed: "failed";
957
957
  pending: "pending";
958
958
  "timed-out": "timed-out";
@@ -1675,6 +1675,7 @@ export declare const agentResultSchema: z.ZodObject<{
1675
1675
  }>;
1676
1676
  artifactContent: z.ZodOptional<z.ZodString>;
1677
1677
  error: z.ZodOptional<z.ZodString>;
1678
+ recoverable: z.ZodOptional<z.ZodBoolean>;
1678
1679
  durationMs: z.ZodNumber;
1679
1680
  tokenUsage: z.ZodOptional<z.ZodObject<{
1680
1681
  inputTokens: z.ZodNumber;
@@ -1697,8 +1698,8 @@ export declare const submitResponseSchema: z.ZodObject<{
1697
1698
  export type SubmitResponse = z.infer<typeof submitResponseSchema>;
1698
1699
  export declare const pollResponseSchema: z.ZodObject<{
1699
1700
  status: z.ZodEnum<{
1700
- running: "running";
1701
1701
  completed: "completed";
1702
+ running: "running";
1702
1703
  failed: "failed";
1703
1704
  }>;
1704
1705
  result: z.ZodOptional<z.ZodObject<{
@@ -1710,6 +1711,7 @@ export declare const pollResponseSchema: z.ZodObject<{
1710
1711
  }>;
1711
1712
  artifactContent: z.ZodOptional<z.ZodString>;
1712
1713
  error: z.ZodOptional<z.ZodString>;
1714
+ recoverable: z.ZodOptional<z.ZodBoolean>;
1713
1715
  durationMs: z.ZodNumber;
1714
1716
  tokenUsage: z.ZodOptional<z.ZodObject<{
1715
1717
  inputTokens: z.ZodNumber;
@@ -238,6 +238,7 @@ export const agentResultSchema = z.object({
238
238
  status: z.enum(['success', 'failure', 'timeout']),
239
239
  artifactContent: z.string().optional(),
240
240
  error: z.string().optional(),
241
+ recoverable: z.boolean().optional(),
241
242
  durationMs: z.number(),
242
243
  tokenUsage: agentTokenUsageSchema.optional(),
243
244
  });
@@ -58,8 +58,8 @@ export declare const actionTypeSchema: z.ZodEnum<{
58
58
  store_artifact: "store_artifact";
59
59
  record_journal: "record_journal";
60
60
  generate_agreement: "generate_agreement";
61
- produce_manifest: "produce_manifest";
62
61
  notify_human: "notify_human";
62
+ produce_manifest: "produce_manifest";
63
63
  }>;
64
64
  export type ActionType = z.infer<typeof actionTypeSchema>;
65
65
  export declare const artifactExistsGuardSchema: z.ZodObject<{
@@ -242,8 +242,8 @@ export declare const previousRunPatternGuardSchema: z.ZodObject<{
242
242
  outcome: z.ZodEnum<{
243
243
  escalated: "escalated";
244
244
  completed: "completed";
245
- failed: "failed";
246
245
  aborted: "aborted";
246
+ failed: "failed";
247
247
  }>;
248
248
  workflowVariant: z.ZodOptional<z.ZodString>;
249
249
  minOccurrences: z.ZodOptional<z.ZodNumber>;
@@ -424,8 +424,8 @@ export declare const guardSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
424
424
  outcome: z.ZodEnum<{
425
425
  escalated: "escalated";
426
426
  completed: "completed";
427
- failed: "failed";
428
427
  aborted: "aborted";
428
+ failed: "failed";
429
429
  }>;
430
430
  workflowVariant: z.ZodOptional<z.ZodString>;
431
431
  minOccurrences: z.ZodOptional<z.ZodNumber>;
@@ -1132,8 +1132,8 @@ export declare const transitionDefinitionSchema: z.ZodObject<{
1132
1132
  outcome: z.ZodEnum<{
1133
1133
  escalated: "escalated";
1134
1134
  completed: "completed";
1135
- failed: "failed";
1136
1135
  aborted: "aborted";
1136
+ failed: "failed";
1137
1137
  }>;
1138
1138
  workflowVariant: z.ZodOptional<z.ZodString>;
1139
1139
  minOccurrences: z.ZodOptional<z.ZodNumber>;
@@ -1845,8 +1845,8 @@ export declare const stateDefinitionSchema: z.ZodObject<{
1845
1845
  outcome: z.ZodEnum<{
1846
1846
  escalated: "escalated";
1847
1847
  completed: "completed";
1848
- failed: "failed";
1849
1848
  aborted: "aborted";
1849
+ failed: "failed";
1850
1850
  }>;
1851
1851
  workflowVariant: z.ZodOptional<z.ZodString>;
1852
1852
  minOccurrences: z.ZodOptional<z.ZodNumber>;
@@ -2567,8 +2567,8 @@ export declare const workflowDefinitionSchema: z.ZodObject<{
2567
2567
  outcome: z.ZodEnum<{
2568
2568
  escalated: "escalated";
2569
2569
  completed: "completed";
2570
- failed: "failed";
2571
2570
  aborted: "aborted";
2571
+ failed: "failed";
2572
2572
  }>;
2573
2573
  workflowVariant: z.ZodOptional<z.ZodString>;
2574
2574
  minOccurrences: z.ZodOptional<z.ZodNumber>;
@@ -3662,8 +3662,8 @@ export declare const workflowRunConfigSchema: z.ZodObject<{
3662
3662
  outcome: z.ZodEnum<{
3663
3663
  escalated: "escalated";
3664
3664
  completed: "completed";
3665
- failed: "failed";
3666
3665
  aborted: "aborted";
3666
+ failed: "failed";
3667
3667
  }>;
3668
3668
  workflowVariant: z.ZodOptional<z.ZodString>;
3669
3669
  minOccurrences: z.ZodOptional<z.ZodNumber>;
@@ -3992,8 +3992,8 @@ export declare const guardResultSchema: z.ZodObject<{
3992
3992
  outcome: z.ZodEnum<{
3993
3993
  escalated: "escalated";
3994
3994
  completed: "completed";
3995
- failed: "failed";
3996
3995
  aborted: "aborted";
3996
+ failed: "failed";
3997
3997
  }>;
3998
3998
  workflowVariant: z.ZodOptional<z.ZodString>;
3999
3999
  minOccurrences: z.ZodOptional<z.ZodNumber>;
@@ -4211,8 +4211,8 @@ export declare const evaluatedTransitionSchema: z.ZodObject<{
4211
4211
  outcome: z.ZodEnum<{
4212
4212
  escalated: "escalated";
4213
4213
  completed: "completed";
4214
- failed: "failed";
4215
4214
  aborted: "aborted";
4215
+ failed: "failed";
4216
4216
  }>;
4217
4217
  workflowVariant: z.ZodOptional<z.ZodString>;
4218
4218
  minOccurrences: z.ZodOptional<z.ZodNumber>;
@@ -4413,8 +4413,8 @@ export declare const evaluatedTransitionSchema: z.ZodObject<{
4413
4413
  outcome: z.ZodEnum<{
4414
4414
  escalated: "escalated";
4415
4415
  completed: "completed";
4416
- failed: "failed";
4417
4416
  aborted: "aborted";
4417
+ failed: "failed";
4418
4418
  }>;
4419
4419
  workflowVariant: z.ZodOptional<z.ZodString>;
4420
4420
  minOccurrences: z.ZodOptional<z.ZodNumber>;
@@ -4641,8 +4641,8 @@ export declare const transitionRecordSchema: z.ZodObject<{
4641
4641
  outcome: z.ZodEnum<{
4642
4642
  escalated: "escalated";
4643
4643
  completed: "completed";
4644
- failed: "failed";
4645
4644
  aborted: "aborted";
4645
+ failed: "failed";
4646
4646
  }>;
4647
4647
  workflowVariant: z.ZodOptional<z.ZodString>;
4648
4648
  minOccurrences: z.ZodOptional<z.ZodNumber>;
@@ -5102,8 +5102,8 @@ export declare const transitionRecordSchema: z.ZodObject<{
5102
5102
  }, z.core.$strip>>;
5103
5103
  }, z.core.$strip>>;
5104
5104
  sessionOutcome: z.ZodOptional<z.ZodEnum<{
5105
- awaiting_human: "awaiting_human";
5106
5105
  completed: "completed";
5106
+ awaiting_human: "awaiting_human";
5107
5107
  session_active: "session_active";
5108
5108
  }>>;
5109
5109
  sessionRef: z.ZodOptional<z.ZodObject<{
@@ -5692,8 +5692,8 @@ export declare const actionResultSchema: z.ZodObject<{
5692
5692
  }, z.core.$strip>>;
5693
5693
  }, z.core.$strip>>;
5694
5694
  sessionOutcome: z.ZodOptional<z.ZodEnum<{
5695
- awaiting_human: "awaiting_human";
5696
5695
  completed: "completed";
5696
+ awaiting_human: "awaiting_human";
5697
5697
  session_active: "session_active";
5698
5698
  }>>;
5699
5699
  sessionRef: z.ZodOptional<z.ZodObject<{
@@ -24,8 +24,8 @@ export declare const workflowSchema: z.ZodObject<{
24
24
  store_artifact: "store_artifact";
25
25
  record_journal: "record_journal";
26
26
  generate_agreement: "generate_agreement";
27
- produce_manifest: "produce_manifest";
28
27
  notify_human: "notify_human";
28
+ produce_manifest: "produce_manifest";
29
29
  }>;
30
30
  params: z.ZodCatch<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
31
31
  }, z.core.$strip>, z.ZodTransform<{
@@ -49,6 +49,17 @@ export declare const workflowSchema: z.ZodObject<{
49
49
  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";
50
50
  itemsPath: string;
51
51
  };
52
+ } | {
53
+ type: "run_script";
54
+ params: {
55
+ script: string;
56
+ timeout?: number | undefined;
57
+ env?: Record<string, string> | undefined;
58
+ storeOutput?: {
59
+ artifactType: string;
60
+ producedBy: string;
61
+ } | undefined;
62
+ };
52
63
  } | {
53
64
  type: "store_artifact";
54
65
  params: {
@@ -71,22 +82,11 @@ export declare const workflowSchema: z.ZodObject<{
71
82
  params: {
72
83
  reason?: string | undefined;
73
84
  };
74
- } | {
75
- type: "run_script";
76
- params: {
77
- script: string;
78
- timeout?: number | undefined;
79
- env?: Record<string, string> | undefined;
80
- storeOutput?: {
81
- artifactType: string;
82
- producedBy: string;
83
- } | undefined;
84
- };
85
85
  } | {
86
86
  type: "produce_manifest";
87
87
  params: Record<string, never>;
88
88
  }, {
89
- type: "dispatch_worker" | "dispatch_parallel_workers" | "dispatch_dynamic_workers" | "run_script" | "store_artifact" | "record_journal" | "generate_agreement" | "produce_manifest" | "notify_human";
89
+ type: "dispatch_worker" | "dispatch_parallel_workers" | "dispatch_dynamic_workers" | "run_script" | "store_artifact" | "record_journal" | "generate_agreement" | "notify_human" | "produce_manifest";
90
90
  params: Record<string, unknown>;
91
91
  }>>>>;
92
92
  exitActions: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
@@ -98,8 +98,8 @@ export declare const workflowSchema: z.ZodObject<{
98
98
  store_artifact: "store_artifact";
99
99
  record_journal: "record_journal";
100
100
  generate_agreement: "generate_agreement";
101
- produce_manifest: "produce_manifest";
102
101
  notify_human: "notify_human";
102
+ produce_manifest: "produce_manifest";
103
103
  }>;
104
104
  params: z.ZodCatch<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
105
105
  }, z.core.$strip>, z.ZodTransform<{
@@ -123,6 +123,17 @@ export declare const workflowSchema: z.ZodObject<{
123
123
  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";
124
124
  itemsPath: string;
125
125
  };
126
+ } | {
127
+ type: "run_script";
128
+ params: {
129
+ script: string;
130
+ timeout?: number | undefined;
131
+ env?: Record<string, string> | undefined;
132
+ storeOutput?: {
133
+ artifactType: string;
134
+ producedBy: string;
135
+ } | undefined;
136
+ };
126
137
  } | {
127
138
  type: "store_artifact";
128
139
  params: {
@@ -145,22 +156,11 @@ export declare const workflowSchema: z.ZodObject<{
145
156
  params: {
146
157
  reason?: string | undefined;
147
158
  };
148
- } | {
149
- type: "run_script";
150
- params: {
151
- script: string;
152
- timeout?: number | undefined;
153
- env?: Record<string, string> | undefined;
154
- storeOutput?: {
155
- artifactType: string;
156
- producedBy: string;
157
- } | undefined;
158
- };
159
159
  } | {
160
160
  type: "produce_manifest";
161
161
  params: Record<string, never>;
162
162
  }, {
163
- type: "dispatch_worker" | "dispatch_parallel_workers" | "dispatch_dynamic_workers" | "run_script" | "store_artifact" | "record_journal" | "generate_agreement" | "produce_manifest" | "notify_human";
163
+ type: "dispatch_worker" | "dispatch_parallel_workers" | "dispatch_dynamic_workers" | "run_script" | "store_artifact" | "record_journal" | "generate_agreement" | "notify_human" | "produce_manifest";
164
164
  params: Record<string, unknown>;
165
165
  }>>>>;
166
166
  transitions: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -289,7 +289,7 @@ export declare const workflowSchema: z.ZodObject<{
289
289
  } | {
290
290
  type: "previous_run_pattern";
291
291
  params: {
292
- outcome: "escalated" | "completed" | "failed" | "aborted";
292
+ outcome: "escalated" | "completed" | "aborted" | "failed";
293
293
  waitForAll?: boolean | undefined;
294
294
  workflowVariant?: string | undefined;
295
295
  minOccurrences?: number | undefined;
@@ -2,11 +2,11 @@ import { z } from 'zod/v4';
2
2
  export declare const JOURNAL_EVENT_TYPES: readonly ["run_started", "run_completed", "run_failed", "run_aborted", "run_resumed", "state_transition", "worker_dispatched", "worker_completed", "worker_failed", "worker_retried", "script_started", "script_completed", "artifact_stored", "artifact_staleness_detected", "governance_decision", "agreement_produced", "escalation", "finding_raised", "finding_resolved", "human_input_requested", "human_input_received", "human_approval", "human_rejection", "error", "model_escalation"];
3
3
  export declare const journalEventTypeSchema: z.ZodEnum<{
4
4
  error: "error";
5
- escalation: "escalation";
6
5
  run_started: "run_started";
7
6
  run_completed: "run_completed";
8
7
  run_failed: "run_failed";
9
8
  run_aborted: "run_aborted";
9
+ escalation: "escalation";
10
10
  run_resumed: "run_resumed";
11
11
  state_transition: "state_transition";
12
12
  worker_dispatched: "worker_dispatched";
@@ -487,11 +487,11 @@ export type JournalEvent = {
487
487
  export declare const journalFilterSchema: z.ZodObject<{
488
488
  eventType: z.ZodOptional<z.ZodEnum<{
489
489
  error: "error";
490
- escalation: "escalation";
491
490
  run_started: "run_started";
492
491
  run_completed: "run_completed";
493
492
  run_failed: "run_failed";
494
493
  run_aborted: "run_aborted";
494
+ escalation: "escalation";
495
495
  run_resumed: "run_resumed";
496
496
  state_transition: "state_transition";
497
497
  worker_dispatched: "worker_dispatched";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ai-dev-orchestrator/schemas",
3
- "version": "0.1.1",
3
+ "version": "0.1.3",
4
4
  "license": "MIT",
5
5
  "repository": {
6
6
  "type": "git",
@@ -21,7 +21,7 @@
21
21
  "dist"
22
22
  ],
23
23
  "dependencies": {
24
- "zod": "^4.5.4"
24
+ "zod": "^4.6.5"
25
25
  },
26
26
  "devDependencies": {
27
27
  "vitest": "^4.1.11",