@osolmaz/pi-workflows 0.2.0 → 0.4.0

package/src/workflows/types.ts

@@ -20,8 +20,11 @@ export type WorkflowNodeContext<TInput = unknown> = {
 };
 
 export type WorkflowNodeCommon = {
-  /** Per-node timeout. Falls back to the engine default (15 minutes). */
-  timeoutMs?: number;
+  /**
+   * Per-node timeout or a callback that derives it from the run context.
+   * Falls back to the engine default (15 minutes).
+   */
+  timeoutMs?: number | ((context: WorkflowNodeContext) => MaybePromise<number>);
   /** Short human-readable label shown in the viewer while the node runs. */
   statusDetail?: string;
 };
@@ -230,6 +233,10 @@ export type WorkflowRunStatus =
   | "timed_out"
   | "cancelled";
 
+export type WorkflowSource =
+  | { kind: "builtin"; id: string; revision: string }
+  | { kind: "file"; path: string; hash: string };
+
 export type WorkflowRunState = {
   schema: "pi-workflows.run-state.v1";
   /**
@@ -240,8 +247,20 @@ export type WorkflowRunState = {
   traceSeq: number;
   runId: string;
   workflowName: string;
+  /** Set on continuation runs: the checkpointed run this one carries forward. */
+  parentRunId?: string;
+  /**
+   * Steps carried from the parent at continuation start. Steps beyond this
+   * count were recorded by this run itself; resume uses it to tell a
+   * carried checkpoint from this run's own.
+   */
+  carriedStepCount?: number;
   runTitle?: string;
+  /** Stable built-in identity or immutable file source used by this run. */
+  workflowSource?: WorkflowSource;
+  /** Legacy fields accepted only by the bounded built-in migration. */
   workflowPath?: string;
+  workflowHash?: string;
   startedAt: string;
   finishedAt?: string;
   updatedAt: string;
@@ -367,7 +386,7 @@ export type WorkflowRunManifest = {
   runId: string;
   workflowName: string;
   runTitle?: string;
-  workflowPath?: string;
+  workflowSource?: WorkflowSource;
   startedAt: string;
   finishedAt?: string;
   status: WorkflowRunStatus;