@osolmaz/pi-workflows 0.12.0 → 0.13.0

package/dist/builtins/plan-change.workflow.d.ts

@@ -0,0 +1,449 @@
+import type { WorkflowNodeContext } from "../workflows/types.js";
+import { type AutodocInput, type DocumentedPlan } from "./autodoc.workflow.js";
+import { type AutoplanInput, type AutoplanReady } from "./autoplan.workflow.js";
+import { type PlanApprovalContinue, type NormalizedPlanApprovalInput, type PlanApprovalPolicy, type PlanApprovalResolution, type ResolvedPlanApprovalPolicy } from "./plan-approval.workflow.js";
+export type PlanChangeInput = {
+    task: string;
+    scope?: string;
+    constraints?: string[];
+    repository?: string;
+    documents?: string[];
+    previousPlan?: unknown;
+    newEvidence?: unknown;
+    approval?: PlanApprovalPolicy;
+};
+export type NormalizedPlanChangeInput = Omit<PlanChangeInput, "approval"> & {
+    approval: ResolvedPlanApprovalPolicy;
+};
+export type PlanChangeReady = {
+    status: "ready";
+    plan: unknown;
+    planDigest: string;
+    documents: string[];
+    revision: number;
+    approval: PlanApprovalResolution;
+    documentation: DocumentedPlan["documentation"];
+};
+export type PlanChangeBlocked = {
+    status: "blocked";
+    reason: string;
+    evidence: unknown;
+};
+export declare const planChangeWorkflow: import("../workflows/types.js").WorkflowDefinition<NormalizedPlanChangeInput, {
+    readonly ready: {
+        readonly from: "finalize";
+        readonly validate: (value: unknown) => PlanChangeReady;
+    };
+    readonly blocked: {
+        readonly from: "blocked";
+        readonly validate: (value: unknown) => PlanChangeBlocked;
+    };
+}, {
+    readonly design: import("../workflows/types.js").WorkflowIncludeDefinition<import("../workflows/types.js").WorkflowDefinition<AutoplanInput, {
+        readonly ready: {
+            readonly from: "finalize";
+            readonly validate: (value: unknown) => AutoplanReady;
+        };
+        readonly blocked: {
+            readonly from: "blocked";
+            readonly validate: (value: unknown) => import("./autoplan.workflow.js").AutoplanBlocked;
+        };
+    }, {
+        readonly readySummary: import("../workflows/types.js").WorkflowIncludeDefinition<import("../workflows/types.js").WorkflowDefinition<import("./plain-summary.workflow.js").PlainSummaryInput, {
+            readonly completed: {
+                readonly from: "finish";
+                readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+            };
+        }, import("../workflows/types.js").WorkflowIncludeMap> & {
+            nodes: {
+                readonly summarize: import("../workflows/types.js").AssistantAgentNodeDefinition;
+                readonly finish: import("../workflows/types.js").ComputeNodeDefinition;
+            };
+            includes?: import("../workflows/types.js").WorkflowIncludeMap;
+            exits?: {
+                readonly completed: {
+                    readonly from: "finish";
+                    readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+                };
+            };
+        }>;
+        readonly blockedSummary: import("../workflows/types.js").WorkflowIncludeDefinition<import("../workflows/types.js").WorkflowDefinition<import("./plain-summary.workflow.js").PlainSummaryInput, {
+            readonly completed: {
+                readonly from: "finish";
+                readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+            };
+        }, import("../workflows/types.js").WorkflowIncludeMap> & {
+            nodes: {
+                readonly summarize: import("../workflows/types.js").AssistantAgentNodeDefinition;
+                readonly finish: import("../workflows/types.js").ComputeNodeDefinition;
+            };
+            includes?: import("../workflows/types.js").WorkflowIncludeMap;
+            exits?: {
+                readonly completed: {
+                    readonly from: "finish";
+                    readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+                };
+            };
+        }>;
+    }> & {
+        nodes: {
+            readonly frame: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+            readonly propose: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+            readonly ideal: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+            readonly choose: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+            readonly plan: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+            readonly blocked: import("../workflows/types.js").ComputeNodeDefinition;
+            readonly finalize: import("../workflows/types.js").ComputeNodeDefinition;
+        };
+        includes?: {
+            readonly readySummary: import("../workflows/types.js").WorkflowIncludeDefinition<import("../workflows/types.js").WorkflowDefinition<import("./plain-summary.workflow.js").PlainSummaryInput, {
+                readonly completed: {
+                    readonly from: "finish";
+                    readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+                };
+            }, import("../workflows/types.js").WorkflowIncludeMap> & {
+                nodes: {
+                    readonly summarize: import("../workflows/types.js").AssistantAgentNodeDefinition;
+                    readonly finish: import("../workflows/types.js").ComputeNodeDefinition;
+                };
+                includes?: import("../workflows/types.js").WorkflowIncludeMap;
+                exits?: {
+                    readonly completed: {
+                        readonly from: "finish";
+                        readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+                    };
+                };
+            }>;
+            readonly blockedSummary: import("../workflows/types.js").WorkflowIncludeDefinition<import("../workflows/types.js").WorkflowDefinition<import("./plain-summary.workflow.js").PlainSummaryInput, {
+                readonly completed: {
+                    readonly from: "finish";
+                    readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+                };
+            }, import("../workflows/types.js").WorkflowIncludeMap> & {
+                nodes: {
+                    readonly summarize: import("../workflows/types.js").AssistantAgentNodeDefinition;
+                    readonly finish: import("../workflows/types.js").ComputeNodeDefinition;
+                };
+                includes?: import("../workflows/types.js").WorkflowIncludeMap;
+                exits?: {
+                    readonly completed: {
+                        readonly from: "finish";
+                        readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+                    };
+                };
+            }>;
+        };
+        exits?: {
+            readonly ready: {
+                readonly from: "finalize";
+                readonly validate: (value: unknown) => AutoplanReady;
+            };
+            readonly blocked: {
+                readonly from: "blocked";
+                readonly validate: (value: unknown) => import("./autoplan.workflow.js").AutoplanBlocked;
+            };
+        };
+    }>;
+    readonly documentation: import("../workflows/types.js").WorkflowIncludeDefinition<import("../workflows/types.js").WorkflowDefinition<AutodocInput, {
+        readonly ready: {
+            readonly from: "finalize";
+            readonly validate: (value: unknown) => DocumentedPlan;
+        };
+        readonly blocked: {
+            readonly from: "blocked";
+            readonly validate: (value: unknown) => import("./autodoc.workflow.js").AutodocBlocked;
+        };
+    }, import("../workflows/types.js").WorkflowIncludeMap> & {
+        nodes: {
+            readonly prepare: import("../workflows/types.js").ComputeNodeDefinition;
+            readonly locatePlan: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+            readonly inspectDocumentation: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+            readonly updateDocumentation: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+            readonly verifyDocumentation: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+            readonly finalize: import("../workflows/types.js").ComputeNodeDefinition;
+            readonly blocked: import("../workflows/types.js").ComputeNodeDefinition;
+        };
+        includes?: import("../workflows/types.js").WorkflowIncludeMap;
+        exits?: {
+            readonly ready: {
+                readonly from: "finalize";
+                readonly validate: (value: unknown) => DocumentedPlan;
+            };
+            readonly blocked: {
+                readonly from: "blocked";
+                readonly validate: (value: unknown) => import("./autodoc.workflow.js").AutodocBlocked;
+            };
+        };
+    }>;
+    readonly approval: import("../workflows/types.js").WorkflowIncludeDefinition<import("../workflows/types.js").WorkflowDefinition<NormalizedPlanApprovalInput, {
+        readonly continue: {
+            readonly from: "continued";
+            readonly validate: (value: unknown) => PlanApprovalContinue;
+        };
+        readonly stop: {
+            readonly from: "stopped";
+            readonly validate: (value: unknown) => import("./plan-approval.workflow.js").PlanApprovalStop;
+        };
+        readonly replan: {
+            readonly from: "replan";
+            readonly validate: (value: unknown) => import("./plan-approval.workflow.js").PlanApprovalReplan;
+        };
+    }, import("../workflows/types.js").WorkflowIncludeMap> & {
+        nodes: {
+            readonly routePolicy: import("../workflows/types.js").ComputeNodeDefinition;
+            readonly approve: import("../workflows/types.js").WorkflowNodeCommon & {
+                nodeType: "checkpoint";
+                summary?: string;
+                run?: (context: WorkflowNodeContext) => import("../workflows/types.js").MaybePromise<unknown>;
+                humanDecision?: import("../workflows/types.js").HumanDecisionNodeContract;
+            } & {
+                readonly __humanChoices?: {
+                    readonly continue: {
+                        readonly label: "Yes, continue";
+                    };
+                    readonly stop: {
+                        readonly label: "No, stop";
+                    };
+                    readonly replan: {
+                        readonly label: "Replan";
+                        readonly input: import("../workflows/types.js").HumanDecisionTextInput & {
+                            name: "instructions";
+                        };
+                    };
+                };
+            };
+            readonly continued: import("../workflows/types.js").ComputeNodeDefinition;
+            readonly stopped: import("../workflows/types.js").ComputeNodeDefinition;
+            readonly replan: import("../workflows/types.js").ComputeNodeDefinition;
+        };
+        includes?: import("../workflows/types.js").WorkflowIncludeMap;
+        exits?: {
+            readonly continue: {
+                readonly from: "continued";
+                readonly validate: (value: unknown) => PlanApprovalContinue;
+            };
+            readonly stop: {
+                readonly from: "stopped";
+                readonly validate: (value: unknown) => import("./plan-approval.workflow.js").PlanApprovalStop;
+            };
+            readonly replan: {
+                readonly from: "replan";
+                readonly validate: (value: unknown) => import("./plan-approval.workflow.js").PlanApprovalReplan;
+            };
+        };
+    }>;
+}> & {
+    nodes: {
+        readonly start: import("../workflows/types.js").ComputeNodeDefinition;
+        readonly assessPlan: import("../workflows/types.js").ComputeNodeDefinition;
+        readonly replanGuard: import("../workflows/types.js").ComputeNodeDefinition;
+        readonly finalize: import("../workflows/types.js").ComputeNodeDefinition;
+        readonly blocked: import("../workflows/types.js").ComputeNodeDefinition;
+    };
+    includes?: {
+        readonly design: import("../workflows/types.js").WorkflowIncludeDefinition<import("../workflows/types.js").WorkflowDefinition<AutoplanInput, {
+            readonly ready: {
+                readonly from: "finalize";
+                readonly validate: (value: unknown) => AutoplanReady;
+            };
+            readonly blocked: {
+                readonly from: "blocked";
+                readonly validate: (value: unknown) => import("./autoplan.workflow.js").AutoplanBlocked;
+            };
+        }, {
+            readonly readySummary: import("../workflows/types.js").WorkflowIncludeDefinition<import("../workflows/types.js").WorkflowDefinition<import("./plain-summary.workflow.js").PlainSummaryInput, {
+                readonly completed: {
+                    readonly from: "finish";
+                    readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+                };
+            }, import("../workflows/types.js").WorkflowIncludeMap> & {
+                nodes: {
+                    readonly summarize: import("../workflows/types.js").AssistantAgentNodeDefinition;
+                    readonly finish: import("../workflows/types.js").ComputeNodeDefinition;
+                };
+                includes?: import("../workflows/types.js").WorkflowIncludeMap;
+                exits?: {
+                    readonly completed: {
+                        readonly from: "finish";
+                        readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+                    };
+                };
+            }>;
+            readonly blockedSummary: import("../workflows/types.js").WorkflowIncludeDefinition<import("../workflows/types.js").WorkflowDefinition<import("./plain-summary.workflow.js").PlainSummaryInput, {
+                readonly completed: {
+                    readonly from: "finish";
+                    readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+                };
+            }, import("../workflows/types.js").WorkflowIncludeMap> & {
+                nodes: {
+                    readonly summarize: import("../workflows/types.js").AssistantAgentNodeDefinition;
+                    readonly finish: import("../workflows/types.js").ComputeNodeDefinition;
+                };
+                includes?: import("../workflows/types.js").WorkflowIncludeMap;
+                exits?: {
+                    readonly completed: {
+                        readonly from: "finish";
+                        readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+                    };
+                };
+            }>;
+        }> & {
+            nodes: {
+                readonly frame: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+                readonly propose: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+                readonly ideal: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+                readonly choose: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+                readonly plan: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+                readonly blocked: import("../workflows/types.js").ComputeNodeDefinition;
+                readonly finalize: import("../workflows/types.js").ComputeNodeDefinition;
+            };
+            includes?: {
+                readonly readySummary: import("../workflows/types.js").WorkflowIncludeDefinition<import("../workflows/types.js").WorkflowDefinition<import("./plain-summary.workflow.js").PlainSummaryInput, {
+                    readonly completed: {
+                        readonly from: "finish";
+                        readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+                    };
+                }, import("../workflows/types.js").WorkflowIncludeMap> & {
+                    nodes: {
+                        readonly summarize: import("../workflows/types.js").AssistantAgentNodeDefinition;
+                        readonly finish: import("../workflows/types.js").ComputeNodeDefinition;
+                    };
+                    includes?: import("../workflows/types.js").WorkflowIncludeMap;
+                    exits?: {
+                        readonly completed: {
+                            readonly from: "finish";
+                            readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+                        };
+                    };
+                }>;
+                readonly blockedSummary: import("../workflows/types.js").WorkflowIncludeDefinition<import("../workflows/types.js").WorkflowDefinition<import("./plain-summary.workflow.js").PlainSummaryInput, {
+                    readonly completed: {
+                        readonly from: "finish";
+                        readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+                    };
+                }, import("../workflows/types.js").WorkflowIncludeMap> & {
+                    nodes: {
+                        readonly summarize: import("../workflows/types.js").AssistantAgentNodeDefinition;
+                        readonly finish: import("../workflows/types.js").ComputeNodeDefinition;
+                    };
+                    includes?: import("../workflows/types.js").WorkflowIncludeMap;
+                    exits?: {
+                        readonly completed: {
+                            readonly from: "finish";
+                            readonly validate: (value: unknown) => import("./plain-summary.workflow.js").PlainSummaryResult;
+                        };
+                    };
+                }>;
+            };
+            exits?: {
+                readonly ready: {
+                    readonly from: "finalize";
+                    readonly validate: (value: unknown) => AutoplanReady;
+                };
+                readonly blocked: {
+                    readonly from: "blocked";
+                    readonly validate: (value: unknown) => import("./autoplan.workflow.js").AutoplanBlocked;
+                };
+            };
+        }>;
+        readonly documentation: import("../workflows/types.js").WorkflowIncludeDefinition<import("../workflows/types.js").WorkflowDefinition<AutodocInput, {
+            readonly ready: {
+                readonly from: "finalize";
+                readonly validate: (value: unknown) => DocumentedPlan;
+            };
+            readonly blocked: {
+                readonly from: "blocked";
+                readonly validate: (value: unknown) => import("./autodoc.workflow.js").AutodocBlocked;
+            };
+        }, import("../workflows/types.js").WorkflowIncludeMap> & {
+            nodes: {
+                readonly prepare: import("../workflows/types.js").ComputeNodeDefinition;
+                readonly locatePlan: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+                readonly inspectDocumentation: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+                readonly updateDocumentation: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+                readonly verifyDocumentation: import("../workflows/types.js").SubmittedAgentNodeDefinition;
+                readonly finalize: import("../workflows/types.js").ComputeNodeDefinition;
+                readonly blocked: import("../workflows/types.js").ComputeNodeDefinition;
+            };
+            includes?: import("../workflows/types.js").WorkflowIncludeMap;
+            exits?: {
+                readonly ready: {
+                    readonly from: "finalize";
+                    readonly validate: (value: unknown) => DocumentedPlan;
+                };
+                readonly blocked: {
+                    readonly from: "blocked";
+                    readonly validate: (value: unknown) => import("./autodoc.workflow.js").AutodocBlocked;
+                };
+            };
+        }>;
+        readonly approval: import("../workflows/types.js").WorkflowIncludeDefinition<import("../workflows/types.js").WorkflowDefinition<NormalizedPlanApprovalInput, {
+            readonly continue: {
+                readonly from: "continued";
+                readonly validate: (value: unknown) => PlanApprovalContinue;
+            };
+            readonly stop: {
+                readonly from: "stopped";
+                readonly validate: (value: unknown) => import("./plan-approval.workflow.js").PlanApprovalStop;
+            };
+            readonly replan: {
+                readonly from: "replan";
+                readonly validate: (value: unknown) => import("./plan-approval.workflow.js").PlanApprovalReplan;
+            };
+        }, import("../workflows/types.js").WorkflowIncludeMap> & {
+            nodes: {
+                readonly routePolicy: import("../workflows/types.js").ComputeNodeDefinition;
+                readonly approve: import("../workflows/types.js").WorkflowNodeCommon & {
+                    nodeType: "checkpoint";
+                    summary?: string;
+                    run?: (context: WorkflowNodeContext) => import("../workflows/types.js").MaybePromise<unknown>;
+                    humanDecision?: import("../workflows/types.js").HumanDecisionNodeContract;
+                } & {
+                    readonly __humanChoices?: {
+                        readonly continue: {
+                            readonly label: "Yes, continue";
+                        };
+                        readonly stop: {
+                            readonly label: "No, stop";
+                        };
+                        readonly replan: {
+                            readonly label: "Replan";
+                            readonly input: import("../workflows/types.js").HumanDecisionTextInput & {
+                                name: "instructions";
+                            };
+                        };
+                    };
+                };
+                readonly continued: import("../workflows/types.js").ComputeNodeDefinition;
+                readonly stopped: import("../workflows/types.js").ComputeNodeDefinition;
+                readonly replan: import("../workflows/types.js").ComputeNodeDefinition;
+            };
+            includes?: import("../workflows/types.js").WorkflowIncludeMap;
+            exits?: {
+                readonly continue: {
+                    readonly from: "continued";
+                    readonly validate: (value: unknown) => PlanApprovalContinue;
+                };
+                readonly stop: {
+                    readonly from: "stopped";
+                    readonly validate: (value: unknown) => import("./plan-approval.workflow.js").PlanApprovalStop;
+                };
+                readonly replan: {
+                    readonly from: "replan";
+                    readonly validate: (value: unknown) => import("./plan-approval.workflow.js").PlanApprovalReplan;
+                };
+            };
+        }>;
+    };
+    exits?: {
+        readonly ready: {
+            readonly from: "finalize";
+            readonly validate: (value: unknown) => PlanChangeReady;
+        };
+        readonly blocked: {
+            readonly from: "blocked";
+            readonly validate: (value: unknown) => PlanChangeBlocked;
+        };
+    };
+};
+export default planChangeWorkflow;