@alexeiled/pi-fusion 0.6.2 → 0.8.0

package/src/types.ts

@@ -15,6 +15,7 @@ export const JUDGE_AGENT = "pi-fusion.fusion-judge";
 export const COMPOSER_AGENT = "pi-fusion.fusion-composer";
 
 export type FusionContextMode = "fresh" | "fork";
+export type CallerOutputContract = "plan-review-v1";
 
 /**
  * How panel answers become one report.
@@ -44,11 +45,41 @@ export interface JudgeConfig {
   thinking?: ThinkingLevel;
 }
 
+export type MinimumSuccessfulPanelists = "majority" | "all" | number;
+
+/** Per-run deadline overrides accepted by CLI, tool, and RPC starts. */
+export interface FusionTimeoutOverrides {
+  panelistTimeoutMs?: number;
+  panelTimeoutMs?: number;
+  panelGraceMs?: number;
+  judgeTimeoutMs?: number;
+}
+
+export interface EffectiveFusionTimeouts {
+  panelistTimeoutMs: number;
+  panelTimeoutMs: number;
+  panelGraceMs: number;
+  judgeTimeoutMs: number;
+  /** True when the legacy shared timeout supplied one or more deadline values. */
+  usesLegacyTimeout: boolean;
+}
+
 export interface FusionProfile {
   panel: PanelMemberConfig[];
   judge: JudgeConfig;
   concurrency?: number;
+  /** Legacy shared wall-clock timeout used when a stage timeout is absent. */
   timeoutMs?: number;
+  /** Per-child deadline. It is capped below the enclosing panel deadline. */
+  panelistTimeoutMs?: number;
+  /** Wall-clock timeout for the complete panel workflow. */
+  panelTimeoutMs?: number;
+  /** Time reserved between child and enclosing panel deadlines. */
+  panelGraceMs?: number;
+  /** Wall-clock timeout for the synthesis workflow. */
+  judgeTimeoutMs?: number;
+  /** Successful panel outputs required for synthesis. Defaults to a majority. */
+  minimumSuccessfulPanelists?: MinimumSuccessfulPanelists;
   context?: FusionContextMode;
   stopWhenPanelAgrees?: boolean;
   /**
@@ -57,6 +88,11 @@ export interface FusionProfile {
    * content is compared. The report always restores the real labels.
    */
   blindPanelLabels?: boolean;
+  /**
+   * Caps each panelist's tool calls. `soft` nudges; `hard` blocks further tool
+   * use so the panelist still finalises before the workflow timeout.
+   */
+  panelToolBudget?: ToolBudget;
   /**
    * Caps the tool calls the judge may spend verifying contested claims.
    * `soft` nudges, `hard` blocks further tool use so the judge still finalises.
@@ -110,6 +146,7 @@ export function resolveSynthesisMode(
 export interface ToolBudget {
   soft?: number;
   hard?: number;
+  block?: "*" | string[];
 }
 
 export type PanelConfidence = "low" | "medium" | "high";
@@ -157,8 +194,10 @@ export interface ParsedFusionArgs {
   prompt: string;
   profile?: string;
   operationId?: string;
+  outputContract?: CallerOutputContract;
   /** Inline panel entries from `--panel`: `<model>` or `<agent>:<model>`. */
   panel?: string[];
+  timeoutOverrides?: FusionTimeoutOverrides;
 }
 
 export interface PanelOutput {
@@ -197,6 +236,43 @@ export interface FailedPanelSummary {
 export type FusionPhase =
   "panel" | "chain" | "judge" | "done" | "failed" | "cancelled";
 
+export type CompletionQuality = "complete" | "partial";
+
+/**
+ * The start-time settings required after a process restart. This intentionally
+ * excludes panel execution-only values (concurrency, panel tool budget, and
+ * raw timeout fields): the panel is already running, while resolved deadlines
+ * are persisted separately in `effectiveTimeouts`.
+ */
+export interface FusionProfileSnapshot {
+  panel: PanelMemberConfig[];
+  judge: JudgeConfig;
+  minimumSuccessfulPanelists: number;
+  context?: FusionContextMode;
+  stopWhenPanelAgrees?: boolean;
+  blindPanelLabels?: boolean;
+  judgeToolBudget?: ToolBudget;
+  synthesis?: FusionSynthesisMode;
+}
+
+/** Persisted recovery metadata for a terminal run. Failed-only retry is not
+ * yet exposed, so this records exactly which slots a future explicit retry may
+ * safely target without replaying verified completed work. */
+export interface FusionRecoveryState {
+  retryDeferred: true;
+  failedPanelIndices: number[];
+}
+
+/**
+ * Durable record written before a public RPC spawn. The public API cannot
+ * query by this correlation token, so a restored intent without its returned
+ * run ID is deliberately failed instead of risking a duplicate remote run.
+ */
+export interface FusionSpawnIntent {
+  stage: "panel" | "judge";
+  requestedAt: number;
+}
+
 export interface FusionRun {
   id: string;
   prompt: string;
@@ -210,6 +286,17 @@ export interface FusionRun {
   /** Name of the config profile the inline panel was layered onto. */
   baseProfileName?: string;
   operationId?: string;
+  outputContract?: CallerOutputContract;
+  /** Persisted start policy so recovery is not changed by later config edits. */
+  minimumSuccessfulPanelists?: MinimumSuccessfulPanelists;
+  /**
+   * Additive start-time profile snapshot. Old sessions omit it and retain the
+   * legacy config lookup fallback during restore.
+   */
+  profileSnapshot?: FusionProfileSnapshot;
+  timeoutOverrides?: FusionTimeoutOverrides;
+  effectiveTimeouts?: EffectiveFusionTimeouts;
+  completionQuality?: CompletionQuality;
   phase: FusionPhase;
   createdAt: number;
   updatedAt: number;
@@ -224,6 +311,8 @@ export interface FusionRun {
   judgeObservation?: RunObservation;
   panelOutputs?: PanelOutput[];
   panelFailures?: FailedPanelSummary[];
+  recovery?: FusionRecoveryState;
+  spawnIntent?: FusionSpawnIntent;
   report?: string;
   error?: string;
 }