substrate-ai 0.19.31 → 0.19.32

package/dist/index.d.ts

@@ -673,6 +673,42 @@ interface VerificationStoryCompleteEvent {
   /** Total duration of all checks in milliseconds */
   duration_ms: number;
 }
+/**
+ * Emitted at most once per run when cumulative pipeline cost crosses 80% of
+ * the --cost-ceiling threshold.
+ */
+interface CostWarningEvent {
+  type: 'cost:warning';
+  /** ISO-8601 timestamp generated at emit time */
+  ts: string;
+  /** Cumulative pipeline cost in USD at the time of the check */
+  cumulative_cost: number;
+  /** Configured cost ceiling in USD */
+  ceiling: number;
+  /** (cumulative / ceiling) * 100, rounded to two decimal places */
+  percent_used: number;
+}
+/**
+ * Emitted between story dispatches when cumulative cost ≥ 100% of the
+ * --cost-ceiling. Remaining undispatched stories are skipped.
+ */
+interface CostCeilingReachedEvent {
+  type: 'cost:ceiling-reached';
+  /** ISO-8601 timestamp generated at emit time */
+  ts: string;
+  /** Cumulative pipeline cost in USD at the time of the check */
+  cumulative_cost: number;
+  /** Configured cost ceiling in USD */
+  ceiling: number;
+  /** --halt-on value in effect ('none', 'all', or 'critical') */
+  halt_on: string;
+  /** 'stopped' for all halt-on modes in this story; interactive prompt is Epic 54 scope */
+  action: string;
+  /** Story keys skipped because budget was exhausted */
+  skipped_stories: string[];
+  /** 'critical' when halt_on is 'all' or 'critical'; absent when 'none' */
+  severity?: string;
+}
 /**
  * Discriminated union of all pipeline event types.
  *
@@ -685,7 +721,7 @@ interface VerificationStoryCompleteEvent {
  * }
  * ```
  */
-type PipelineEvent = PipelineStartEvent | PipelineCompleteEvent | PipelinePreFlightFailureEvent | PipelineProfileStaleEvent | PipelineContractMismatchEvent | PipelineContractVerificationSummaryEvent | StoryPhaseEvent | StoryDoneEvent | StoryEscalationEvent | StoryWarnEvent | StoryLogEvent | PipelineHeartbeatEvent | StoryStallEvent | StoryZeroDiffEscalationEvent | StoryBuildVerificationFailedEvent | StoryBuildVerificationPassedEvent | StoryInterfaceChangeWarningEvent | StoryMetricsEvent | SupervisorPollEvent | SupervisorKillEvent | SupervisorRestartEvent | SupervisorAbortEvent | SupervisorSummaryEvent | SupervisorAnalysisCompleteEvent | SupervisorAnalysisErrorEvent | SupervisorExperimentStartEvent | SupervisorExperimentSkipEvent | SupervisorExperimentRecommendationsEvent | SupervisorExperimentCompleteEvent | SupervisorExperimentErrorEvent | RoutingModelSelectedEvent | PipelinePhaseStartEvent | PipelinePhaseCompleteEvent | StoryAutoApprovedEvent | VerificationCheckCompleteEvent | VerificationStoryCompleteEvent; //#endregion
+type PipelineEvent = PipelineStartEvent | PipelineCompleteEvent | PipelinePreFlightFailureEvent | PipelineProfileStaleEvent | PipelineContractMismatchEvent | PipelineContractVerificationSummaryEvent | StoryPhaseEvent | StoryDoneEvent | StoryEscalationEvent | StoryWarnEvent | StoryLogEvent | PipelineHeartbeatEvent | StoryStallEvent | StoryZeroDiffEscalationEvent | StoryBuildVerificationFailedEvent | StoryBuildVerificationPassedEvent | StoryInterfaceChangeWarningEvent | StoryMetricsEvent | SupervisorPollEvent | SupervisorKillEvent | SupervisorRestartEvent | SupervisorAbortEvent | SupervisorSummaryEvent | SupervisorAnalysisCompleteEvent | SupervisorAnalysisErrorEvent | SupervisorExperimentStartEvent | SupervisorExperimentSkipEvent | SupervisorExperimentRecommendationsEvent | SupervisorExperimentCompleteEvent | SupervisorExperimentErrorEvent | RoutingModelSelectedEvent | PipelinePhaseStartEvent | PipelinePhaseCompleteEvent | StoryAutoApprovedEvent | VerificationCheckCompleteEvent | VerificationStoryCompleteEvent | CostWarningEvent | CostCeilingReachedEvent; //#endregion
 //#region packages/core/dist/types.d.ts
 
 /**
@@ -1642,6 +1678,7 @@ declare const SubstrateConfigSchema: z.ZodObject<{
   }, z.core.$strict>>;
   default_agent: z.ZodOptional<z.ZodString>;
   supervisor_poll_interval_seconds: z.ZodOptional<z.ZodNumber>;
+  retry_budget: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 type SubstrateConfig = z.infer<typeof SubstrateConfigSchema>;
 
@@ -2032,6 +2069,10 @@ interface OrchestratorEvents {
     lastVerdict: string;
     reviewCycles: number;
     issues: unknown[];
+    /** Retry budget at time of escalation — present when escalation reason is retry_budget_exhausted (Story 53-4) */
+    retryBudget?: number;
+    /** Retry count at time of escalation — present when escalation reason is retry_budget_exhausted (Story 53-4) */
+    retryCount?: number;
     /** Structured diagnosis with classification and recommended action (Story 22-3) */
     diagnosis?: {
       issueDistribution: 'concentrated' | 'widespread';
@@ -2206,6 +2247,21 @@ interface OrchestratorEvents {
     phase: string;
     ts: string;
   };
+  /** Cumulative pipeline cost has crossed 80% of the --cost-ceiling threshold (emitted at most once per run) */
+  'cost:warning': {
+    cumulative_cost: number;
+    ceiling: number;
+    percent_used: number;
+  };
+  /** Cost ceiling reached — remaining undispatched stories are skipped */
+  'cost:ceiling-reached': {
+    cumulative_cost: number;
+    ceiling: number;
+    halt_on: string;
+    action: string;
+    skipped_stories: string[];
+    severity?: string;
+  };
   /**
    * Emitted when a dev-story timeout has partial work on disk and the
    * orchestrator captures it as a checkpoint for retry (Story 39-5).