@atom-workflow-agent/cli 0.1.1

package/dist/workflow/workflow-service.d.ts

@@ -0,0 +1,1237 @@
+import { type JsonValue, type RuntimeEvent, type WorkflowCompletionMode } from "@atom-workflow-agent/contracts";
+import { AtomRegistry } from "@atom-workflow-agent/atom-catalog";
+import { DurableWorkflowEngine, LocalArtifactStore, LocalRunStore, LocalWorkflowStore, RuntimeMachine, type RuntimeMachineCommand, type RuntimeSnapshot } from "@atom-workflow-agent/workflow-engine";
+import { type WorkflowInspectorServerHandle } from "@atom-workflow-agent/workflow-ui";
+import { LocalPlanStore, type DurablePlanRecord, type PlanningModelEvent } from "@atom-workflow-agent/workflow-planner";
+import { type LocalProviderName } from "../providers/provider-name.js";
+import { resolveLocalAcpProviderConfig } from "../providers/resolve-provider-config.js";
+import { type AtomDevelopmentExecutionOptions } from "../atoms/atom-development-service.js";
+export interface WorkflowServiceOptions {
+    readonly cwd: string;
+    readonly signal?: AbortSignal;
+    readonly dataDirectory?: string;
+    readonly resolveModel?: (provider: LocalProviderName, cwd: string, signal?: AbortSignal) => Promise<string>;
+    readonly resolveProvider?: typeof resolveLocalAcpProviderConfig;
+    readonly now?: () => Date;
+}
+export type WorkflowServiceProgress = {
+    readonly type: "planner.started";
+    readonly planId: string;
+    readonly providerId: string;
+    readonly model: string;
+} | {
+    readonly type: "runtime.event";
+    readonly event: RuntimeEvent;
+} | {
+    readonly type: "planner.failed";
+    readonly planId: string;
+    readonly code: string;
+    readonly message: string;
+} | {
+    readonly type: "planner.model.event";
+    readonly planId: string;
+    readonly event: PlanningModelEvent;
+} | {
+    readonly type: "planner.phase";
+    readonly planId: string;
+    readonly phase: string;
+    readonly planningTurnsConsumed: number;
+    readonly maxPlanningTurns: number;
+    readonly validationErrorCount: number;
+} | {
+    readonly type: "workflow.finished";
+    readonly runId: string;
+    readonly status: string;
+};
+export interface WorkflowServiceExecutionOptions {
+    readonly onProgress?: (progress: WorkflowServiceProgress) => void;
+}
+/**
+ * The natural-language trigger is executable business input, not only Planner
+ * metadata. Expose it under the conventional request key while allowing an
+ * explicitly supplied request payload to remain authoritative.
+ */
+export declare function workflowInputsWithRequest(goal: string, workflowInputs: Readonly<Record<string, JsonValue>>): Record<string, JsonValue>;
+export declare class WorkflowCliService {
+    readonly store: LocalRunStore;
+    readonly plans: LocalPlanStore;
+    readonly workflows: LocalWorkflowStore;
+    readonly registry: AtomRegistry;
+    readonly artifacts: LocalArtifactStore;
+    readonly runtime: DurableWorkflowEngine;
+    readonly machine: RuntimeMachine;
+    private readonly coordinator;
+    private readonly atomDevelopment;
+    private readonly config;
+    private readonly options;
+    private readonly loadedPackages;
+    private readonly progressListeners;
+    private constructor();
+    static create(options: WorkflowServiceOptions): Promise<WorkflowCliService>;
+    private resolvePlannerTarget;
+    start(raw: unknown, execution?: WorkflowServiceExecutionOptions): Promise<RuntimeSnapshot>;
+    plan(raw: unknown, execution?: WorkflowServiceExecutionOptions): Promise<DurablePlanRecord>;
+    validateWorkflow(raw: unknown, completionMode?: WorkflowCompletionMode): Promise<{
+        valid: boolean;
+        workflowSpecHash: string;
+        workflowIrHash: string;
+        completionMode: "outputs" | "side-effect-only";
+    }>;
+    saveWorkflow(raw: unknown, options?: {
+        workflowId?: string;
+        completionMode?: WorkflowCompletionMode;
+        sourceKind?: "file" | "host";
+    }): Promise<{
+        schemaVersion: "2.0";
+        workflowId: string;
+        workflowRevisionId: string;
+        revision: number;
+        source: {
+            kind: "planner";
+            planId: string;
+        } | {
+            kind: "host";
+            sourceHash: string;
+        } | {
+            kind: "file";
+            sourceHash: string;
+        };
+        workflowSpec: {
+            schemaVersion: "1.2";
+            name: string;
+            inputs: Record<string, JsonValue>;
+            entry: string[];
+            nodes: ({
+                next: {
+                    to: string | string[];
+                    with: Record<string, JsonValue>;
+                    maxTraversals?: number | undefined;
+                };
+                id: string;
+                atom: string;
+                dependsOn: string[];
+                input: JsonValue;
+                kind: "atom";
+                map?: {
+                    items: {
+                        $ref: string;
+                    };
+                    maxItems: number;
+                    maxConcurrency: number;
+                    group?: string | undefined;
+                } | undefined;
+                policy?: {
+                    attemptTimeoutMs?: number | undefined;
+                    lifecycleTickTimeoutMs?: number | undefined;
+                    maxLifecycleTicks?: number | undefined;
+                    retry?: {
+                        maxAttempts?: number | undefined;
+                        strategy?: "fixed" | "exponential" | undefined;
+                        baseDelayMs?: number | undefined;
+                        maxDelayMs?: number | undefined;
+                        jitter?: boolean | undefined;
+                    } | undefined;
+                    cache?: {
+                        enabled?: boolean | undefined;
+                        ttlMs?: number | undefined;
+                    } | undefined;
+                } | undefined;
+            } | {
+                select: {
+                    $ref: string;
+                };
+                branches: Record<string, {
+                    to: string | string[];
+                    with: Record<string, JsonValue>;
+                    maxTraversals?: number | undefined;
+                }>;
+                default: {
+                    to: string | string[];
+                    with: Record<string, JsonValue>;
+                    maxTraversals?: number | undefined;
+                };
+                id: string;
+                atom: string;
+                dependsOn: string[];
+                input: JsonValue;
+                kind: "decision";
+                map?: {
+                    items: {
+                        $ref: string;
+                    };
+                    maxItems: number;
+                    maxConcurrency: number;
+                    group?: string | undefined;
+                } | undefined;
+                policy?: {
+                    attemptTimeoutMs?: number | undefined;
+                    lifecycleTickTimeoutMs?: number | undefined;
+                    maxLifecycleTicks?: number | undefined;
+                    retry?: {
+                        maxAttempts?: number | undefined;
+                        strategy?: "fixed" | "exponential" | undefined;
+                        baseDelayMs?: number | undefined;
+                        maxDelayMs?: number | undefined;
+                        jitter?: boolean | undefined;
+                    } | undefined;
+                    cache?: {
+                        enabled?: boolean | undefined;
+                        ttlMs?: number | undefined;
+                    } | undefined;
+                } | undefined;
+            } | {
+                kind: "merge";
+                id: string;
+                dependsOn: string[];
+                outputSchema: Record<string, JsonValue>;
+                next: {
+                    to: string | string[];
+                    with: Record<string, JsonValue>;
+                    maxTraversals?: number | undefined;
+                };
+            })[];
+            outputs: Record<string, {
+                $ref: string;
+            }>;
+        };
+        workflowSpecHash: string;
+        workflowIrHash: string;
+        compilerVersion: "workflow-ir-1.3";
+        runtimePolicyHash: string;
+        referencedAtoms: {
+            key: string;
+            manifestHash: string;
+            inputSchemaHash: string;
+            outputSchemaHash: string;
+        }[];
+        inputSchema: Record<string, JsonValue>;
+        outputSchema: Record<string, JsonValue>;
+        completionMode: "outputs" | "side-effect-only";
+        scopeConstraints: {
+            projectScope?: string | undefined;
+            allowedHosts?: string[] | undefined;
+        };
+        validation: {
+            status: "valid";
+            validatedAt: string;
+        };
+        createdAt: string;
+        parentRevisionId?: string | undefined;
+        catalogHash?: string | undefined;
+    }>;
+    listPlans(): Promise<readonly {
+        schemaVersion: "1.0";
+        planId: string;
+        status: "ready" | "created" | "failed" | "cancelled" | "superseded" | "blocked_missing_atom" | "blocked_missing_input" | "planning";
+        request: {
+            goal: string;
+            cwd: string;
+            projectScope: string;
+            hostScope: string;
+            initialWorkflowInputs: Record<string, JsonValue>;
+            context: JsonValue;
+        };
+        planner: {
+            provider: string;
+            model: string;
+            maxPlanningTurns?: number | undefined;
+        };
+        catalogHash: string;
+        inputRevisions: {
+            revision: number;
+            patch: Record<string, JsonValue>;
+            effectiveInputsHash: string;
+            createdAt: string;
+        }[];
+        hashes: {
+            draft?: string | undefined;
+            workflowSpec?: string | undefined;
+            workflowIr?: string | undefined;
+        };
+        validationErrors: {
+            code: "WORKFLOW_JSON_INVALID" | "WORKFLOW_SCHEMA_INVALID" | "RUNTIME_POLICY_INVALID" | "ATOM_CATALOG_INVALID" | "ATOM_CATALOG_DUPLICATE" | "NODE_LIMIT_EXCEEDED" | "DEPENDENCY_LIMIT_EXCEEDED" | "ATOM_NOT_FOUND" | "ATOM_UNAVAILABLE" | "DEPRECATED_ATOM_FORBIDDEN" | "ATTEMPT_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_LIMIT_EXCEEDED" | "RETRY_LIMIT_EXCEEDED" | "RETRY_DELAY_LIMIT_EXCEEDED" | "RETRY_POLICY_INVALID" | "NON_IDEMPOTENT_RETRY_FORBIDDEN" | "CACHE_TTL_LIMIT_EXCEEDED" | "CACHE_ENABLE_OVERRIDE_FORBIDDEN" | "MAP_LIMIT_EXCEEDED" | "MAP_GROUP_CONFIG_MISMATCH" | "MAP_COMPLETION_CONFLICT" | "AGENT_PROVIDER_FORBIDDEN" | "AGENT_MODEL_FORBIDDEN" | "AGENT_FALLBACK_LIMIT_EXCEEDED" | "AGENT_FALLBACK_DUPLICATE" | "AGENT_CWD_FORBIDDEN" | "DUPLICATE_NODE_ID" | "DUPLICATE_DEPENDENCY" | "SELF_DEPENDENCY" | "DEPENDENCY_NOT_FOUND" | "DEPENDENCY_CYCLE" | "ENTRY_NODE_NOT_FOUND" | "ENTRY_NODE_DUPLICATE" | "ENTRY_DEPENDENCY_INVALID" | "EDGE_TARGET_NOT_FOUND" | "EDGE_TARGET_DUPLICATE" | "EDGE_TERMINAL_WITH_INPUT_FORBIDDEN" | "EDGE_BACK_EDGE_UNBOUNDED" | "EDGE_TRAVERSAL_LIMIT_EXCEEDED" | "DECISION_SELECT_REFERENCE_INVALID" | "DECISION_SELECT_TYPE_MISMATCH" | "DECISION_BRANCH_ENUM_MISMATCH" | "CONTROL_NODE_UNREACHABLE" | "CONTROL_DEAD_END" | "CONTROL_TERMINAL_UNREACHABLE" | "JOIN_CONTROL_PREDECESSOR_MISSING" | "PARALLEL_FANOUT_NOT_JOINED" | "BRANCH_MERGE_INPUT_MISSING" | "BRANCH_MERGE_SOURCE_INVALID" | "REFERENCE_NOT_FOUND" | "REFERENCE_SOURCE_OPTIONAL" | "REFERENCE_NOT_DEPENDENCY" | "MAP_REFERENCE_OUTSIDE_MAP" | "EDGE_REFERENCE_OUTSIDE_EDGE" | "WORKFLOW_OUTPUT_REFERENCE_INVALID" | "REFERENCE_INVALID" | "REFERENCE_TYPE_MISMATCH" | "INPUT_SCHEMA_MISMATCH" | "INPUT_REQUIRED_PROPERTY_MISSING" | "INPUT_ADDITIONAL_PROPERTY_FORBIDDEN" | "MAP_ITEMS_NOT_ARRAY" | "EDGE_INPUT_SCHEMA_MISMATCH" | "AGENT_CWD_TYPE_MISMATCH" | "PLANNER_DRAFT_SCHEMA_INVALID" | "PLANNER_DRAFT_ATOM_NOT_SELECTED" | "PLANNER_DRAFT_ALIAS_DUPLICATE" | "PLANNER_DRAFT_REFERENCE_INVALID" | "PLANNER_DRAFT_REFERENCE_AMBIGUOUS" | "PLANNER_DRAFT_CONTROL_INVALID" | "PLANNER_DRAFT_NORMALIZATION_FAILED" | "PLANNER_TURN_LIMIT_EXCEEDED" | "PLANNER_CAPABILITY_SCHEMA_INVALID" | "PLANNING_WORKSPACE_ACTION_INVALID" | "PLANNING_CAPABILITY_UNAVAILABLE" | "PLANNING_CAPABILITY_ATOM_UNKNOWN" | "PLANNING_CAPABILITY_SCHEMA_MISMATCH" | "PLANNING_SELECTED_ATOM_LIMIT_EXCEEDED" | "PLANNING_REQUIRED_INPUT_UNAVAILABLE" | "PLANNING_BINDING_SOURCE_OPTIONAL" | "PLANNING_BINDING_AMBIGUOUS" | "PLANNING_BRANCH_RESULT_REQUIRED" | "PLANNING_BRANCH_RESULT_MISMATCH" | "PLANNING_DECISION_NO_EFFECT" | "PLANNING_DRAFT_EMPTY" | "PLANNING_TRANSACTION_INVALID" | "PLANNING_TRANSACTION_LIMIT_EXCEEDED" | "PLANNING_TRANSACTION_VALIDATION_FAILED" | "PLANNING_REVISION_CONFLICT" | "PLANNING_REVISION_LIMIT_EXCEEDED" | "PLANNING_NODE_LIMIT_EXCEEDED" | "PLANNING_OPERATION_CONFLICT" | "PLANNING_BLOCK_DUPLICATE" | "PLANNING_BLOCK_NOT_FOUND" | "PLANNING_FINALIZE_CONFLICT" | "PLANNING_WORKSPACE_NOT_EDITABLE" | "PLANNING_WORKSPACE_NOT_FINALIZABLE" | "PLANNING_ATOM_UNAVAILABLE" | "PLANNING_ATOM_SCHEMA_DESCRIPTION_REQUIRED" | "PLANNING_FINAL_VALIDATION_FAILED" | "PLANNING_WORKFLOW_OUTPUT_REQUIRED" | "PLANNING_REQUIRED_CAPABILITY_NOT_REALIZED" | "PLANNING_FINALIZED_REVISION_MISSING";
+            path: string;
+            message: string;
+            stage?: "json-extract" | "capability-schema" | "capability-resolution" | "draft-schema" | "atom-resolution" | "draft-normalization" | "workflow-schema" | "data-link" | "control-graph" | "runtime-policy" | undefined;
+            hint?: string | undefined;
+            atomId?: string | undefined;
+            expected?: JsonValue | undefined;
+            received?: JsonValue | undefined;
+        }[];
+        createdAt: string;
+        updatedAt: string;
+        workflowRevisionId?: string | undefined;
+        endedAt?: string | undefined;
+        error?: {
+            code: string;
+            message: string;
+            retryable: boolean;
+        } | undefined;
+    }[]>;
+    inspectPlan(planId: string, view?: "summary" | "workspace" | "capabilities" | "gaps" | "bindings" | "workflow" | "validation"): Promise<{
+        schemaVersion: "1.0";
+        kind: "missing-atom" | "missing-input";
+        code: "PLANNING_CAPABILITY_UNAVAILABLE" | "PLANNING_REQUIRED_INPUT_UNAVAILABLE";
+        message: string;
+        paths: string[];
+        resolution: string;
+        requirementId?: string | undefined;
+    } | {
+        schemaVersion: "1.0";
+        workspace: {
+            schemaVersion: "1.0";
+            workspaceId: string;
+            requestId: string;
+            goal: string;
+            workflowName: string;
+            workflowInputs: Record<string, JsonValue>;
+            context: JsonValue;
+            runtimePolicy: {
+                schemaVersion: "1.1";
+                maxNodes: number;
+                maxDependenciesPerNode: number;
+                maxMapItems: number;
+                maxEdgeTraversals: number;
+                maxWorkflowTransitions: number;
+                maxNodeActivations: number;
+                maxLifecycleTicks: number;
+                maxLifecycleTickTimeoutMs: number | null;
+                maxAttemptDurationMs: number | null;
+                maxRetryAttempts: number;
+                maxRetryDelayMs: number;
+                maxCacheTtlMs: number;
+                allowDeprecatedAtoms: boolean;
+                allowCacheEnableOverride: boolean;
+            };
+            catalogHash: string;
+            selectedAtomKeys: string[];
+            requiredAtomKeys: string[];
+            descriptorHashes: Record<string, string>;
+            status: "failed" | "cancelled" | "blocked_missing_atom" | "blocked_missing_input" | "editing" | "finalized";
+            currentRevision: number;
+            currentDraftHash: string;
+            createdAt: string;
+            updatedAt: string;
+            finalizedRevision?: number | undefined;
+        };
+        revisions: {
+            schemaVersion: "1.0";
+            revision: number;
+            parentRevision: number;
+            operationId: string;
+            draftHash: string;
+            blocks: {
+                blockId: string;
+                plan: import("@atom-workflow-agent/contracts").PlanningStep;
+            }[];
+            outputs: Record<string, {
+                source: "workflow";
+                path: string;
+            } | {
+                source: "node";
+                nodeId: string;
+                path: string;
+            } | {
+                source: "item";
+                path: string;
+            } | {
+                source: "value";
+                value: JsonValue;
+            }>;
+            bindingEvidence: {
+                schemaVersion: "1.0";
+                consumerAlias: string;
+                targetPath: string;
+                sourceRef: string;
+                sourceDescription: string;
+                targetDescription: string;
+                sourceSchema: Record<string, JsonValue>;
+                targetSchema: Record<string, JsonValue>;
+                reason: string;
+                confidence: "high";
+            }[];
+            plannerDraft: {
+                schemaVersion: "1.0";
+                kind: "workflow-draft";
+                name: string;
+                flow: import("@atom-workflow-agent/contracts").PlannerDraftStep;
+                outputs: Record<string, JsonValue>;
+            };
+            validation: {
+                workflowName: string;
+                workflowNodeCount: number;
+                workflowIrHash: string;
+            };
+            createdAt: string;
+        }[];
+        transactions: {
+            schemaVersion: "1.0";
+            transaction: {
+                schemaVersion: "1.0";
+                operationId: string;
+                baseRevision: number;
+                baseDraftHash: string;
+                operations: ({
+                    op: "add-region";
+                    block: {
+                        blockId: string;
+                        plan: import("@atom-workflow-agent/contracts").PlanningStep;
+                    };
+                } | {
+                    op: "replace-region";
+                    blockId: string;
+                    plan: import("@atom-workflow-agent/contracts").PlanningStep;
+                } | {
+                    op: "remove-region";
+                    blockId: string;
+                } | {
+                    op: "set-workflow-output";
+                    name: string;
+                    value: {
+                        source: "workflow";
+                        path: string;
+                    } | {
+                        source: "node";
+                        nodeId: string;
+                        path: string;
+                    } | {
+                        source: "item";
+                        path: string;
+                    } | {
+                        source: "value";
+                        value: JsonValue;
+                    };
+                } | {
+                    op: "remove-workflow-output";
+                    name: string;
+                })[];
+            };
+            transactionHash: string;
+            result: {
+                schemaVersion: "1.0";
+                status: "committed";
+                operationId: string;
+                transactionHash: string;
+                replayed: boolean;
+                revision: {
+                    schemaVersion: "1.0";
+                    revision: number;
+                    parentRevision: number;
+                    operationId: string;
+                    draftHash: string;
+                    blocks: {
+                        blockId: string;
+                        plan: import("@atom-workflow-agent/contracts").PlanningStep;
+                    }[];
+                    outputs: Record<string, {
+                        source: "workflow";
+                        path: string;
+                    } | {
+                        source: "node";
+                        nodeId: string;
+                        path: string;
+                    } | {
+                        source: "item";
+                        path: string;
+                    } | {
+                        source: "value";
+                        value: JsonValue;
+                    }>;
+                    bindingEvidence: {
+                        schemaVersion: "1.0";
+                        consumerAlias: string;
+                        targetPath: string;
+                        sourceRef: string;
+                        sourceDescription: string;
+                        targetDescription: string;
+                        sourceSchema: Record<string, JsonValue>;
+                        targetSchema: Record<string, JsonValue>;
+                        reason: string;
+                        confidence: "high";
+                    }[];
+                    plannerDraft: {
+                        schemaVersion: "1.0";
+                        kind: "workflow-draft";
+                        name: string;
+                        flow: import("@atom-workflow-agent/contracts").PlannerDraftStep;
+                        outputs: Record<string, JsonValue>;
+                    };
+                    validation: {
+                        workflowName: string;
+                        workflowNodeCount: number;
+                        workflowIrHash: string;
+                    };
+                    createdAt: string;
+                };
+            } | {
+                schemaVersion: "1.0";
+                status: "rejected";
+                operationId: string;
+                transactionHash: string;
+                code: "WORKFLOW_JSON_INVALID" | "WORKFLOW_SCHEMA_INVALID" | "RUNTIME_POLICY_INVALID" | "ATOM_CATALOG_INVALID" | "ATOM_CATALOG_DUPLICATE" | "NODE_LIMIT_EXCEEDED" | "DEPENDENCY_LIMIT_EXCEEDED" | "ATOM_NOT_FOUND" | "ATOM_UNAVAILABLE" | "DEPRECATED_ATOM_FORBIDDEN" | "ATTEMPT_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_LIMIT_EXCEEDED" | "RETRY_LIMIT_EXCEEDED" | "RETRY_DELAY_LIMIT_EXCEEDED" | "RETRY_POLICY_INVALID" | "NON_IDEMPOTENT_RETRY_FORBIDDEN" | "CACHE_TTL_LIMIT_EXCEEDED" | "CACHE_ENABLE_OVERRIDE_FORBIDDEN" | "MAP_LIMIT_EXCEEDED" | "MAP_GROUP_CONFIG_MISMATCH" | "MAP_COMPLETION_CONFLICT" | "AGENT_PROVIDER_FORBIDDEN" | "AGENT_MODEL_FORBIDDEN" | "AGENT_FALLBACK_LIMIT_EXCEEDED" | "AGENT_FALLBACK_DUPLICATE" | "AGENT_CWD_FORBIDDEN" | "DUPLICATE_NODE_ID" | "DUPLICATE_DEPENDENCY" | "SELF_DEPENDENCY" | "DEPENDENCY_NOT_FOUND" | "DEPENDENCY_CYCLE" | "ENTRY_NODE_NOT_FOUND" | "ENTRY_NODE_DUPLICATE" | "ENTRY_DEPENDENCY_INVALID" | "EDGE_TARGET_NOT_FOUND" | "EDGE_TARGET_DUPLICATE" | "EDGE_TERMINAL_WITH_INPUT_FORBIDDEN" | "EDGE_BACK_EDGE_UNBOUNDED" | "EDGE_TRAVERSAL_LIMIT_EXCEEDED" | "DECISION_SELECT_REFERENCE_INVALID" | "DECISION_SELECT_TYPE_MISMATCH" | "DECISION_BRANCH_ENUM_MISMATCH" | "CONTROL_NODE_UNREACHABLE" | "CONTROL_DEAD_END" | "CONTROL_TERMINAL_UNREACHABLE" | "JOIN_CONTROL_PREDECESSOR_MISSING" | "PARALLEL_FANOUT_NOT_JOINED" | "BRANCH_MERGE_INPUT_MISSING" | "BRANCH_MERGE_SOURCE_INVALID" | "REFERENCE_NOT_FOUND" | "REFERENCE_SOURCE_OPTIONAL" | "REFERENCE_NOT_DEPENDENCY" | "MAP_REFERENCE_OUTSIDE_MAP" | "EDGE_REFERENCE_OUTSIDE_EDGE" | "WORKFLOW_OUTPUT_REFERENCE_INVALID" | "REFERENCE_INVALID" | "REFERENCE_TYPE_MISMATCH" | "INPUT_SCHEMA_MISMATCH" | "INPUT_REQUIRED_PROPERTY_MISSING" | "INPUT_ADDITIONAL_PROPERTY_FORBIDDEN" | "MAP_ITEMS_NOT_ARRAY" | "EDGE_INPUT_SCHEMA_MISMATCH" | "AGENT_CWD_TYPE_MISMATCH" | "PLANNER_DRAFT_SCHEMA_INVALID" | "PLANNER_DRAFT_ATOM_NOT_SELECTED" | "PLANNER_DRAFT_ALIAS_DUPLICATE" | "PLANNER_DRAFT_REFERENCE_INVALID" | "PLANNER_DRAFT_REFERENCE_AMBIGUOUS" | "PLANNER_DRAFT_CONTROL_INVALID" | "PLANNER_DRAFT_NORMALIZATION_FAILED" | "PLANNER_TURN_LIMIT_EXCEEDED" | "PLANNER_CAPABILITY_SCHEMA_INVALID" | "PLANNING_WORKSPACE_ACTION_INVALID" | "PLANNING_CAPABILITY_UNAVAILABLE" | "PLANNING_CAPABILITY_ATOM_UNKNOWN" | "PLANNING_CAPABILITY_SCHEMA_MISMATCH" | "PLANNING_SELECTED_ATOM_LIMIT_EXCEEDED" | "PLANNING_REQUIRED_INPUT_UNAVAILABLE" | "PLANNING_BINDING_SOURCE_OPTIONAL" | "PLANNING_BINDING_AMBIGUOUS" | "PLANNING_BRANCH_RESULT_REQUIRED" | "PLANNING_BRANCH_RESULT_MISMATCH" | "PLANNING_DECISION_NO_EFFECT" | "PLANNING_DRAFT_EMPTY" | "PLANNING_TRANSACTION_INVALID" | "PLANNING_TRANSACTION_LIMIT_EXCEEDED" | "PLANNING_TRANSACTION_VALIDATION_FAILED" | "PLANNING_REVISION_CONFLICT" | "PLANNING_REVISION_LIMIT_EXCEEDED" | "PLANNING_NODE_LIMIT_EXCEEDED" | "PLANNING_OPERATION_CONFLICT" | "PLANNING_BLOCK_DUPLICATE" | "PLANNING_BLOCK_NOT_FOUND" | "PLANNING_FINALIZE_CONFLICT" | "PLANNING_WORKSPACE_NOT_EDITABLE" | "PLANNING_WORKSPACE_NOT_FINALIZABLE" | "PLANNING_ATOM_UNAVAILABLE" | "PLANNING_ATOM_SCHEMA_DESCRIPTION_REQUIRED" | "PLANNING_FINAL_VALIDATION_FAILED" | "PLANNING_WORKFLOW_OUTPUT_REQUIRED" | "PLANNING_REQUIRED_CAPABILITY_NOT_REALIZED" | "PLANNING_FINALIZED_REVISION_MISSING";
+                message: string;
+                retryable: boolean;
+                currentRevision: number;
+                currentDraftHash: string;
+                errors: {
+                    code: "WORKFLOW_JSON_INVALID" | "WORKFLOW_SCHEMA_INVALID" | "RUNTIME_POLICY_INVALID" | "ATOM_CATALOG_INVALID" | "ATOM_CATALOG_DUPLICATE" | "NODE_LIMIT_EXCEEDED" | "DEPENDENCY_LIMIT_EXCEEDED" | "ATOM_NOT_FOUND" | "ATOM_UNAVAILABLE" | "DEPRECATED_ATOM_FORBIDDEN" | "ATTEMPT_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_LIMIT_EXCEEDED" | "RETRY_LIMIT_EXCEEDED" | "RETRY_DELAY_LIMIT_EXCEEDED" | "RETRY_POLICY_INVALID" | "NON_IDEMPOTENT_RETRY_FORBIDDEN" | "CACHE_TTL_LIMIT_EXCEEDED" | "CACHE_ENABLE_OVERRIDE_FORBIDDEN" | "MAP_LIMIT_EXCEEDED" | "MAP_GROUP_CONFIG_MISMATCH" | "MAP_COMPLETION_CONFLICT" | "AGENT_PROVIDER_FORBIDDEN" | "AGENT_MODEL_FORBIDDEN" | "AGENT_FALLBACK_LIMIT_EXCEEDED" | "AGENT_FALLBACK_DUPLICATE" | "AGENT_CWD_FORBIDDEN" | "DUPLICATE_NODE_ID" | "DUPLICATE_DEPENDENCY" | "SELF_DEPENDENCY" | "DEPENDENCY_NOT_FOUND" | "DEPENDENCY_CYCLE" | "ENTRY_NODE_NOT_FOUND" | "ENTRY_NODE_DUPLICATE" | "ENTRY_DEPENDENCY_INVALID" | "EDGE_TARGET_NOT_FOUND" | "EDGE_TARGET_DUPLICATE" | "EDGE_TERMINAL_WITH_INPUT_FORBIDDEN" | "EDGE_BACK_EDGE_UNBOUNDED" | "EDGE_TRAVERSAL_LIMIT_EXCEEDED" | "DECISION_SELECT_REFERENCE_INVALID" | "DECISION_SELECT_TYPE_MISMATCH" | "DECISION_BRANCH_ENUM_MISMATCH" | "CONTROL_NODE_UNREACHABLE" | "CONTROL_DEAD_END" | "CONTROL_TERMINAL_UNREACHABLE" | "JOIN_CONTROL_PREDECESSOR_MISSING" | "PARALLEL_FANOUT_NOT_JOINED" | "BRANCH_MERGE_INPUT_MISSING" | "BRANCH_MERGE_SOURCE_INVALID" | "REFERENCE_NOT_FOUND" | "REFERENCE_SOURCE_OPTIONAL" | "REFERENCE_NOT_DEPENDENCY" | "MAP_REFERENCE_OUTSIDE_MAP" | "EDGE_REFERENCE_OUTSIDE_EDGE" | "WORKFLOW_OUTPUT_REFERENCE_INVALID" | "REFERENCE_INVALID" | "REFERENCE_TYPE_MISMATCH" | "INPUT_SCHEMA_MISMATCH" | "INPUT_REQUIRED_PROPERTY_MISSING" | "INPUT_ADDITIONAL_PROPERTY_FORBIDDEN" | "MAP_ITEMS_NOT_ARRAY" | "EDGE_INPUT_SCHEMA_MISMATCH" | "AGENT_CWD_TYPE_MISMATCH" | "PLANNER_DRAFT_SCHEMA_INVALID" | "PLANNER_DRAFT_ATOM_NOT_SELECTED" | "PLANNER_DRAFT_ALIAS_DUPLICATE" | "PLANNER_DRAFT_REFERENCE_INVALID" | "PLANNER_DRAFT_REFERENCE_AMBIGUOUS" | "PLANNER_DRAFT_CONTROL_INVALID" | "PLANNER_DRAFT_NORMALIZATION_FAILED" | "PLANNER_TURN_LIMIT_EXCEEDED" | "PLANNER_CAPABILITY_SCHEMA_INVALID" | "PLANNING_WORKSPACE_ACTION_INVALID" | "PLANNING_CAPABILITY_UNAVAILABLE" | "PLANNING_CAPABILITY_ATOM_UNKNOWN" | "PLANNING_CAPABILITY_SCHEMA_MISMATCH" | "PLANNING_SELECTED_ATOM_LIMIT_EXCEEDED" | "PLANNING_REQUIRED_INPUT_UNAVAILABLE" | "PLANNING_BINDING_SOURCE_OPTIONAL" | "PLANNING_BINDING_AMBIGUOUS" | "PLANNING_BRANCH_RESULT_REQUIRED" | "PLANNING_BRANCH_RESULT_MISMATCH" | "PLANNING_DECISION_NO_EFFECT" | "PLANNING_DRAFT_EMPTY" | "PLANNING_TRANSACTION_INVALID" | "PLANNING_TRANSACTION_LIMIT_EXCEEDED" | "PLANNING_TRANSACTION_VALIDATION_FAILED" | "PLANNING_REVISION_CONFLICT" | "PLANNING_REVISION_LIMIT_EXCEEDED" | "PLANNING_NODE_LIMIT_EXCEEDED" | "PLANNING_OPERATION_CONFLICT" | "PLANNING_BLOCK_DUPLICATE" | "PLANNING_BLOCK_NOT_FOUND" | "PLANNING_FINALIZE_CONFLICT" | "PLANNING_WORKSPACE_NOT_EDITABLE" | "PLANNING_WORKSPACE_NOT_FINALIZABLE" | "PLANNING_ATOM_UNAVAILABLE" | "PLANNING_ATOM_SCHEMA_DESCRIPTION_REQUIRED" | "PLANNING_FINAL_VALIDATION_FAILED" | "PLANNING_WORKFLOW_OUTPUT_REQUIRED" | "PLANNING_REQUIRED_CAPABILITY_NOT_REALIZED" | "PLANNING_FINALIZED_REVISION_MISSING";
+                    path: string;
+                    message: string;
+                    stage?: "json-extract" | "capability-schema" | "capability-resolution" | "draft-schema" | "atom-resolution" | "draft-normalization" | "workflow-schema" | "data-link" | "control-graph" | "runtime-policy" | undefined;
+                    hint?: string | undefined;
+                    atomId?: string | undefined;
+                    expected?: JsonValue | undefined;
+                    received?: JsonValue | undefined;
+                }[];
+            };
+            recordedAt: string;
+        }[];
+        gapReport?: {
+            schemaVersion: "1.0";
+            kind: "missing-atom" | "missing-input";
+            code: "PLANNING_CAPABILITY_UNAVAILABLE" | "PLANNING_REQUIRED_INPUT_UNAVAILABLE";
+            message: string;
+            paths: string[];
+            resolution: string;
+            requirementId?: string | undefined;
+        } | undefined;
+    } | import("@atom-workflow-agent/workflow-engine").StoredWorkflowRevision | {
+        plan: {
+            schemaVersion: "1.0";
+            planId: string;
+            status: "ready" | "created" | "failed" | "cancelled" | "superseded" | "blocked_missing_atom" | "blocked_missing_input" | "planning";
+            request: {
+                goal: string;
+                cwd: string;
+                projectScope: string;
+                hostScope: string;
+                initialWorkflowInputs: Record<string, JsonValue>;
+                context: JsonValue;
+            };
+            planner: {
+                provider: string;
+                model: string;
+                maxPlanningTurns?: number | undefined;
+            };
+            catalogHash: string;
+            inputRevisions: {
+                revision: number;
+                patch: Record<string, JsonValue>;
+                effectiveInputsHash: string;
+                createdAt: string;
+            }[];
+            hashes: {
+                draft?: string | undefined;
+                workflowSpec?: string | undefined;
+                workflowIr?: string | undefined;
+            };
+            validationErrors: {
+                code: "WORKFLOW_JSON_INVALID" | "WORKFLOW_SCHEMA_INVALID" | "RUNTIME_POLICY_INVALID" | "ATOM_CATALOG_INVALID" | "ATOM_CATALOG_DUPLICATE" | "NODE_LIMIT_EXCEEDED" | "DEPENDENCY_LIMIT_EXCEEDED" | "ATOM_NOT_FOUND" | "ATOM_UNAVAILABLE" | "DEPRECATED_ATOM_FORBIDDEN" | "ATTEMPT_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_LIMIT_EXCEEDED" | "RETRY_LIMIT_EXCEEDED" | "RETRY_DELAY_LIMIT_EXCEEDED" | "RETRY_POLICY_INVALID" | "NON_IDEMPOTENT_RETRY_FORBIDDEN" | "CACHE_TTL_LIMIT_EXCEEDED" | "CACHE_ENABLE_OVERRIDE_FORBIDDEN" | "MAP_LIMIT_EXCEEDED" | "MAP_GROUP_CONFIG_MISMATCH" | "MAP_COMPLETION_CONFLICT" | "AGENT_PROVIDER_FORBIDDEN" | "AGENT_MODEL_FORBIDDEN" | "AGENT_FALLBACK_LIMIT_EXCEEDED" | "AGENT_FALLBACK_DUPLICATE" | "AGENT_CWD_FORBIDDEN" | "DUPLICATE_NODE_ID" | "DUPLICATE_DEPENDENCY" | "SELF_DEPENDENCY" | "DEPENDENCY_NOT_FOUND" | "DEPENDENCY_CYCLE" | "ENTRY_NODE_NOT_FOUND" | "ENTRY_NODE_DUPLICATE" | "ENTRY_DEPENDENCY_INVALID" | "EDGE_TARGET_NOT_FOUND" | "EDGE_TARGET_DUPLICATE" | "EDGE_TERMINAL_WITH_INPUT_FORBIDDEN" | "EDGE_BACK_EDGE_UNBOUNDED" | "EDGE_TRAVERSAL_LIMIT_EXCEEDED" | "DECISION_SELECT_REFERENCE_INVALID" | "DECISION_SELECT_TYPE_MISMATCH" | "DECISION_BRANCH_ENUM_MISMATCH" | "CONTROL_NODE_UNREACHABLE" | "CONTROL_DEAD_END" | "CONTROL_TERMINAL_UNREACHABLE" | "JOIN_CONTROL_PREDECESSOR_MISSING" | "PARALLEL_FANOUT_NOT_JOINED" | "BRANCH_MERGE_INPUT_MISSING" | "BRANCH_MERGE_SOURCE_INVALID" | "REFERENCE_NOT_FOUND" | "REFERENCE_SOURCE_OPTIONAL" | "REFERENCE_NOT_DEPENDENCY" | "MAP_REFERENCE_OUTSIDE_MAP" | "EDGE_REFERENCE_OUTSIDE_EDGE" | "WORKFLOW_OUTPUT_REFERENCE_INVALID" | "REFERENCE_INVALID" | "REFERENCE_TYPE_MISMATCH" | "INPUT_SCHEMA_MISMATCH" | "INPUT_REQUIRED_PROPERTY_MISSING" | "INPUT_ADDITIONAL_PROPERTY_FORBIDDEN" | "MAP_ITEMS_NOT_ARRAY" | "EDGE_INPUT_SCHEMA_MISMATCH" | "AGENT_CWD_TYPE_MISMATCH" | "PLANNER_DRAFT_SCHEMA_INVALID" | "PLANNER_DRAFT_ATOM_NOT_SELECTED" | "PLANNER_DRAFT_ALIAS_DUPLICATE" | "PLANNER_DRAFT_REFERENCE_INVALID" | "PLANNER_DRAFT_REFERENCE_AMBIGUOUS" | "PLANNER_DRAFT_CONTROL_INVALID" | "PLANNER_DRAFT_NORMALIZATION_FAILED" | "PLANNER_TURN_LIMIT_EXCEEDED" | "PLANNER_CAPABILITY_SCHEMA_INVALID" | "PLANNING_WORKSPACE_ACTION_INVALID" | "PLANNING_CAPABILITY_UNAVAILABLE" | "PLANNING_CAPABILITY_ATOM_UNKNOWN" | "PLANNING_CAPABILITY_SCHEMA_MISMATCH" | "PLANNING_SELECTED_ATOM_LIMIT_EXCEEDED" | "PLANNING_REQUIRED_INPUT_UNAVAILABLE" | "PLANNING_BINDING_SOURCE_OPTIONAL" | "PLANNING_BINDING_AMBIGUOUS" | "PLANNING_BRANCH_RESULT_REQUIRED" | "PLANNING_BRANCH_RESULT_MISMATCH" | "PLANNING_DECISION_NO_EFFECT" | "PLANNING_DRAFT_EMPTY" | "PLANNING_TRANSACTION_INVALID" | "PLANNING_TRANSACTION_LIMIT_EXCEEDED" | "PLANNING_TRANSACTION_VALIDATION_FAILED" | "PLANNING_REVISION_CONFLICT" | "PLANNING_REVISION_LIMIT_EXCEEDED" | "PLANNING_NODE_LIMIT_EXCEEDED" | "PLANNING_OPERATION_CONFLICT" | "PLANNING_BLOCK_DUPLICATE" | "PLANNING_BLOCK_NOT_FOUND" | "PLANNING_FINALIZE_CONFLICT" | "PLANNING_WORKSPACE_NOT_EDITABLE" | "PLANNING_WORKSPACE_NOT_FINALIZABLE" | "PLANNING_ATOM_UNAVAILABLE" | "PLANNING_ATOM_SCHEMA_DESCRIPTION_REQUIRED" | "PLANNING_FINAL_VALIDATION_FAILED" | "PLANNING_WORKFLOW_OUTPUT_REQUIRED" | "PLANNING_REQUIRED_CAPABILITY_NOT_REALIZED" | "PLANNING_FINALIZED_REVISION_MISSING";
+                path: string;
+                message: string;
+                stage?: "json-extract" | "capability-schema" | "capability-resolution" | "draft-schema" | "atom-resolution" | "draft-normalization" | "workflow-schema" | "data-link" | "control-graph" | "runtime-policy" | undefined;
+                hint?: string | undefined;
+                atomId?: string | undefined;
+                expected?: JsonValue | undefined;
+                received?: JsonValue | undefined;
+            }[];
+            createdAt: string;
+            updatedAt: string;
+            workflowRevisionId?: string | undefined;
+            endedAt?: string | undefined;
+            error?: {
+                code: string;
+                message: string;
+                retryable: boolean;
+            } | undefined;
+        };
+        metrics: {
+            readonly catalogAtomCount: number;
+            readonly selectedAtomCount: number;
+            readonly catalogIndexBytes: number;
+            readonly planningCatalogBytes: number;
+            readonly promptPayloadBytes: number;
+            readonly capabilityTurns: number;
+            readonly workspaceTurns: number;
+            readonly committedTransactions: number;
+            readonly rejectedTransactions: number;
+            readonly planningTurns: number;
+            readonly maxPlanningTurns: number;
+            readonly totalDurationMs: number;
+            readonly tokenUsage?: import("@atom-workflow-agent/contracts").PlannerTokenUsage;
+        } | undefined;
+        eventStats: {
+            readonly total: number;
+            readonly persisted: number;
+            readonly byType: Readonly<Record<string, number>>;
+        } | undefined;
+        coverage?: never;
+        catalog?: never;
+        draft?: never;
+        validationErrors?: never;
+        validationFeedback?: never;
+    } | {
+        coverage: {
+            schemaVersion: "1.1";
+            status: "covered";
+            catalogHash: string;
+            plan: {
+                schemaVersion: "1.1";
+                kind: "capability-plan";
+                requirements: {
+                    id: string;
+                    description: string;
+                    required: boolean;
+                    resolution: {
+                        kind: "covered";
+                        uses: {
+                            atom: string;
+                            inputs: {
+                                role: string;
+                                field: string;
+                            }[];
+                            outputs: {
+                                role: string;
+                                field: string;
+                            }[];
+                        }[];
+                    } | {
+                        kind: "missing";
+                        desiredInputs: {
+                            name: string;
+                            description: string;
+                            required: boolean;
+                            acceptedTypes: ("string" | "number" | "boolean" | "object" | "null" | "array" | "integer")[];
+                        }[];
+                        desiredOutputs: {
+                            name: string;
+                            description: string;
+                            required: boolean;
+                            acceptedTypes: ("string" | "number" | "boolean" | "object" | "null" | "array" | "integer")[];
+                        }[];
+                    };
+                }[];
+            };
+            selectedAtomKeys: string[];
+        } | {
+            schemaVersion: "1.1";
+            status: "blocked_missing_atom";
+            catalogHash: string;
+            plan: {
+                schemaVersion: "1.1";
+                kind: "capability-plan";
+                requirements: {
+                    id: string;
+                    description: string;
+                    required: boolean;
+                    resolution: {
+                        kind: "covered";
+                        uses: {
+                            atom: string;
+                            inputs: {
+                                role: string;
+                                field: string;
+                            }[];
+                            outputs: {
+                                role: string;
+                                field: string;
+                            }[];
+                        }[];
+                    } | {
+                        kind: "missing";
+                        desiredInputs: {
+                            name: string;
+                            description: string;
+                            required: boolean;
+                            acceptedTypes: ("string" | "number" | "boolean" | "object" | "null" | "array" | "integer")[];
+                        }[];
+                        desiredOutputs: {
+                            name: string;
+                            description: string;
+                            required: boolean;
+                            acceptedTypes: ("string" | "number" | "boolean" | "object" | "null" | "array" | "integer")[];
+                        }[];
+                    };
+                }[];
+            };
+            searchedAtomCount: number;
+            gaps: {
+                requirement: {
+                    id: string;
+                    description: string;
+                    required: boolean;
+                    resolution: {
+                        kind: "covered";
+                        uses: {
+                            atom: string;
+                            inputs: {
+                                role: string;
+                                field: string;
+                            }[];
+                            outputs: {
+                                role: string;
+                                field: string;
+                            }[];
+                        }[];
+                    } | {
+                        kind: "missing";
+                        desiredInputs: {
+                            name: string;
+                            description: string;
+                            required: boolean;
+                            acceptedTypes: ("string" | "number" | "boolean" | "object" | "null" | "array" | "integer")[];
+                        }[];
+                        desiredOutputs: {
+                            name: string;
+                            description: string;
+                            required: boolean;
+                            acceptedTypes: ("string" | "number" | "boolean" | "object" | "null" | "array" | "integer")[];
+                        }[];
+                    };
+                };
+                code: "PLANNING_CAPABILITY_UNAVAILABLE" | "PLANNING_CAPABILITY_ATOM_UNKNOWN" | "PLANNING_CAPABILITY_SCHEMA_MISMATCH";
+                message: string;
+                nearMatches: {
+                    atomKey: string;
+                    title: string;
+                    purpose: string;
+                    score: number;
+                    rejectedBecause: string;
+                }[];
+                suggestedAtomContract: {
+                    suggestedId: string;
+                    description: string;
+                    inputFields: {
+                        name: string;
+                        description: string;
+                        required: boolean;
+                        acceptedTypes: ("string" | "number" | "boolean" | "object" | "null" | "array" | "integer")[];
+                    }[];
+                    outputFields: {
+                        name: string;
+                        description: string;
+                        required: boolean;
+                        acceptedTypes: ("string" | "number" | "boolean" | "object" | "null" | "array" | "integer")[];
+                    }[];
+                };
+                fieldIssues?: {
+                    atomKey: string;
+                    direction: "output" | "input";
+                    field: string;
+                    reason: "field-not-found" | "required-input-not-declared";
+                    availableFields: string[];
+                }[] | undefined;
+            }[];
+        } | null;
+        catalog: {
+            schemaVersion: "1.0";
+            hash: string;
+            atoms: {
+                key: string;
+                descriptor: {
+                    schemaVersion: "1.0";
+                    hash: string;
+                    key: string;
+                    title: string;
+                    purpose: string;
+                    inputSchema: Record<string, JsonValue>;
+                    outputSchema: Record<string, JsonValue>;
+                };
+            }[];
+        } | null;
+        plan?: never;
+        metrics?: never;
+        eventStats?: never;
+        draft?: never;
+        validationErrors?: never;
+        validationFeedback?: never;
+    } | {
+        draft: {
+            schemaVersion: "1.0";
+            kind: "workflow-draft";
+            name: string;
+            flow: import("@atom-workflow-agent/contracts").PlannerDraftStep;
+            outputs: Record<string, JsonValue>;
+        } | null;
+        validationErrors: readonly {
+            code: "WORKFLOW_JSON_INVALID" | "WORKFLOW_SCHEMA_INVALID" | "RUNTIME_POLICY_INVALID" | "ATOM_CATALOG_INVALID" | "ATOM_CATALOG_DUPLICATE" | "NODE_LIMIT_EXCEEDED" | "DEPENDENCY_LIMIT_EXCEEDED" | "ATOM_NOT_FOUND" | "ATOM_UNAVAILABLE" | "DEPRECATED_ATOM_FORBIDDEN" | "ATTEMPT_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_LIMIT_EXCEEDED" | "RETRY_LIMIT_EXCEEDED" | "RETRY_DELAY_LIMIT_EXCEEDED" | "RETRY_POLICY_INVALID" | "NON_IDEMPOTENT_RETRY_FORBIDDEN" | "CACHE_TTL_LIMIT_EXCEEDED" | "CACHE_ENABLE_OVERRIDE_FORBIDDEN" | "MAP_LIMIT_EXCEEDED" | "MAP_GROUP_CONFIG_MISMATCH" | "MAP_COMPLETION_CONFLICT" | "AGENT_PROVIDER_FORBIDDEN" | "AGENT_MODEL_FORBIDDEN" | "AGENT_FALLBACK_LIMIT_EXCEEDED" | "AGENT_FALLBACK_DUPLICATE" | "AGENT_CWD_FORBIDDEN" | "DUPLICATE_NODE_ID" | "DUPLICATE_DEPENDENCY" | "SELF_DEPENDENCY" | "DEPENDENCY_NOT_FOUND" | "DEPENDENCY_CYCLE" | "ENTRY_NODE_NOT_FOUND" | "ENTRY_NODE_DUPLICATE" | "ENTRY_DEPENDENCY_INVALID" | "EDGE_TARGET_NOT_FOUND" | "EDGE_TARGET_DUPLICATE" | "EDGE_TERMINAL_WITH_INPUT_FORBIDDEN" | "EDGE_BACK_EDGE_UNBOUNDED" | "EDGE_TRAVERSAL_LIMIT_EXCEEDED" | "DECISION_SELECT_REFERENCE_INVALID" | "DECISION_SELECT_TYPE_MISMATCH" | "DECISION_BRANCH_ENUM_MISMATCH" | "CONTROL_NODE_UNREACHABLE" | "CONTROL_DEAD_END" | "CONTROL_TERMINAL_UNREACHABLE" | "JOIN_CONTROL_PREDECESSOR_MISSING" | "PARALLEL_FANOUT_NOT_JOINED" | "BRANCH_MERGE_INPUT_MISSING" | "BRANCH_MERGE_SOURCE_INVALID" | "REFERENCE_NOT_FOUND" | "REFERENCE_SOURCE_OPTIONAL" | "REFERENCE_NOT_DEPENDENCY" | "MAP_REFERENCE_OUTSIDE_MAP" | "EDGE_REFERENCE_OUTSIDE_EDGE" | "WORKFLOW_OUTPUT_REFERENCE_INVALID" | "REFERENCE_INVALID" | "REFERENCE_TYPE_MISMATCH" | "INPUT_SCHEMA_MISMATCH" | "INPUT_REQUIRED_PROPERTY_MISSING" | "INPUT_ADDITIONAL_PROPERTY_FORBIDDEN" | "MAP_ITEMS_NOT_ARRAY" | "EDGE_INPUT_SCHEMA_MISMATCH" | "AGENT_CWD_TYPE_MISMATCH" | "PLANNER_DRAFT_SCHEMA_INVALID" | "PLANNER_DRAFT_ATOM_NOT_SELECTED" | "PLANNER_DRAFT_ALIAS_DUPLICATE" | "PLANNER_DRAFT_REFERENCE_INVALID" | "PLANNER_DRAFT_REFERENCE_AMBIGUOUS" | "PLANNER_DRAFT_CONTROL_INVALID" | "PLANNER_DRAFT_NORMALIZATION_FAILED" | "PLANNER_TURN_LIMIT_EXCEEDED" | "PLANNER_CAPABILITY_SCHEMA_INVALID" | "PLANNING_WORKSPACE_ACTION_INVALID" | "PLANNING_CAPABILITY_UNAVAILABLE" | "PLANNING_CAPABILITY_ATOM_UNKNOWN" | "PLANNING_CAPABILITY_SCHEMA_MISMATCH" | "PLANNING_SELECTED_ATOM_LIMIT_EXCEEDED" | "PLANNING_REQUIRED_INPUT_UNAVAILABLE" | "PLANNING_BINDING_SOURCE_OPTIONAL" | "PLANNING_BINDING_AMBIGUOUS" | "PLANNING_BRANCH_RESULT_REQUIRED" | "PLANNING_BRANCH_RESULT_MISMATCH" | "PLANNING_DECISION_NO_EFFECT" | "PLANNING_DRAFT_EMPTY" | "PLANNING_TRANSACTION_INVALID" | "PLANNING_TRANSACTION_LIMIT_EXCEEDED" | "PLANNING_TRANSACTION_VALIDATION_FAILED" | "PLANNING_REVISION_CONFLICT" | "PLANNING_REVISION_LIMIT_EXCEEDED" | "PLANNING_NODE_LIMIT_EXCEEDED" | "PLANNING_OPERATION_CONFLICT" | "PLANNING_BLOCK_DUPLICATE" | "PLANNING_BLOCK_NOT_FOUND" | "PLANNING_FINALIZE_CONFLICT" | "PLANNING_WORKSPACE_NOT_EDITABLE" | "PLANNING_WORKSPACE_NOT_FINALIZABLE" | "PLANNING_ATOM_UNAVAILABLE" | "PLANNING_ATOM_SCHEMA_DESCRIPTION_REQUIRED" | "PLANNING_FINAL_VALIDATION_FAILED" | "PLANNING_WORKFLOW_OUTPUT_REQUIRED" | "PLANNING_REQUIRED_CAPABILITY_NOT_REALIZED" | "PLANNING_FINALIZED_REVISION_MISSING";
+            path: string;
+            message: string;
+            stage?: "json-extract" | "capability-schema" | "capability-resolution" | "draft-schema" | "atom-resolution" | "draft-normalization" | "workflow-schema" | "data-link" | "control-graph" | "runtime-policy" | undefined;
+            hint?: string | undefined;
+            atomId?: string | undefined;
+            expected?: JsonValue | undefined;
+            received?: JsonValue | undefined;
+        }[];
+        plan?: never;
+        metrics?: never;
+        eventStats?: never;
+        coverage?: never;
+        catalog?: never;
+        validationFeedback?: never;
+    } | {
+        validationErrors: readonly {
+            code: "WORKFLOW_JSON_INVALID" | "WORKFLOW_SCHEMA_INVALID" | "RUNTIME_POLICY_INVALID" | "ATOM_CATALOG_INVALID" | "ATOM_CATALOG_DUPLICATE" | "NODE_LIMIT_EXCEEDED" | "DEPENDENCY_LIMIT_EXCEEDED" | "ATOM_NOT_FOUND" | "ATOM_UNAVAILABLE" | "DEPRECATED_ATOM_FORBIDDEN" | "ATTEMPT_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_LIMIT_EXCEEDED" | "RETRY_LIMIT_EXCEEDED" | "RETRY_DELAY_LIMIT_EXCEEDED" | "RETRY_POLICY_INVALID" | "NON_IDEMPOTENT_RETRY_FORBIDDEN" | "CACHE_TTL_LIMIT_EXCEEDED" | "CACHE_ENABLE_OVERRIDE_FORBIDDEN" | "MAP_LIMIT_EXCEEDED" | "MAP_GROUP_CONFIG_MISMATCH" | "MAP_COMPLETION_CONFLICT" | "AGENT_PROVIDER_FORBIDDEN" | "AGENT_MODEL_FORBIDDEN" | "AGENT_FALLBACK_LIMIT_EXCEEDED" | "AGENT_FALLBACK_DUPLICATE" | "AGENT_CWD_FORBIDDEN" | "DUPLICATE_NODE_ID" | "DUPLICATE_DEPENDENCY" | "SELF_DEPENDENCY" | "DEPENDENCY_NOT_FOUND" | "DEPENDENCY_CYCLE" | "ENTRY_NODE_NOT_FOUND" | "ENTRY_NODE_DUPLICATE" | "ENTRY_DEPENDENCY_INVALID" | "EDGE_TARGET_NOT_FOUND" | "EDGE_TARGET_DUPLICATE" | "EDGE_TERMINAL_WITH_INPUT_FORBIDDEN" | "EDGE_BACK_EDGE_UNBOUNDED" | "EDGE_TRAVERSAL_LIMIT_EXCEEDED" | "DECISION_SELECT_REFERENCE_INVALID" | "DECISION_SELECT_TYPE_MISMATCH" | "DECISION_BRANCH_ENUM_MISMATCH" | "CONTROL_NODE_UNREACHABLE" | "CONTROL_DEAD_END" | "CONTROL_TERMINAL_UNREACHABLE" | "JOIN_CONTROL_PREDECESSOR_MISSING" | "PARALLEL_FANOUT_NOT_JOINED" | "BRANCH_MERGE_INPUT_MISSING" | "BRANCH_MERGE_SOURCE_INVALID" | "REFERENCE_NOT_FOUND" | "REFERENCE_SOURCE_OPTIONAL" | "REFERENCE_NOT_DEPENDENCY" | "MAP_REFERENCE_OUTSIDE_MAP" | "EDGE_REFERENCE_OUTSIDE_EDGE" | "WORKFLOW_OUTPUT_REFERENCE_INVALID" | "REFERENCE_INVALID" | "REFERENCE_TYPE_MISMATCH" | "INPUT_SCHEMA_MISMATCH" | "INPUT_REQUIRED_PROPERTY_MISSING" | "INPUT_ADDITIONAL_PROPERTY_FORBIDDEN" | "MAP_ITEMS_NOT_ARRAY" | "EDGE_INPUT_SCHEMA_MISMATCH" | "AGENT_CWD_TYPE_MISMATCH" | "PLANNER_DRAFT_SCHEMA_INVALID" | "PLANNER_DRAFT_ATOM_NOT_SELECTED" | "PLANNER_DRAFT_ALIAS_DUPLICATE" | "PLANNER_DRAFT_REFERENCE_INVALID" | "PLANNER_DRAFT_REFERENCE_AMBIGUOUS" | "PLANNER_DRAFT_CONTROL_INVALID" | "PLANNER_DRAFT_NORMALIZATION_FAILED" | "PLANNER_TURN_LIMIT_EXCEEDED" | "PLANNER_CAPABILITY_SCHEMA_INVALID" | "PLANNING_WORKSPACE_ACTION_INVALID" | "PLANNING_CAPABILITY_UNAVAILABLE" | "PLANNING_CAPABILITY_ATOM_UNKNOWN" | "PLANNING_CAPABILITY_SCHEMA_MISMATCH" | "PLANNING_SELECTED_ATOM_LIMIT_EXCEEDED" | "PLANNING_REQUIRED_INPUT_UNAVAILABLE" | "PLANNING_BINDING_SOURCE_OPTIONAL" | "PLANNING_BINDING_AMBIGUOUS" | "PLANNING_BRANCH_RESULT_REQUIRED" | "PLANNING_BRANCH_RESULT_MISMATCH" | "PLANNING_DECISION_NO_EFFECT" | "PLANNING_DRAFT_EMPTY" | "PLANNING_TRANSACTION_INVALID" | "PLANNING_TRANSACTION_LIMIT_EXCEEDED" | "PLANNING_TRANSACTION_VALIDATION_FAILED" | "PLANNING_REVISION_CONFLICT" | "PLANNING_REVISION_LIMIT_EXCEEDED" | "PLANNING_NODE_LIMIT_EXCEEDED" | "PLANNING_OPERATION_CONFLICT" | "PLANNING_BLOCK_DUPLICATE" | "PLANNING_BLOCK_NOT_FOUND" | "PLANNING_FINALIZE_CONFLICT" | "PLANNING_WORKSPACE_NOT_EDITABLE" | "PLANNING_WORKSPACE_NOT_FINALIZABLE" | "PLANNING_ATOM_UNAVAILABLE" | "PLANNING_ATOM_SCHEMA_DESCRIPTION_REQUIRED" | "PLANNING_FINAL_VALIDATION_FAILED" | "PLANNING_WORKFLOW_OUTPUT_REQUIRED" | "PLANNING_REQUIRED_CAPABILITY_NOT_REALIZED" | "PLANNING_FINALIZED_REVISION_MISSING";
+            path: string;
+            message: string;
+            stage?: "json-extract" | "capability-schema" | "capability-resolution" | "draft-schema" | "atom-resolution" | "draft-normalization" | "workflow-schema" | "data-link" | "control-graph" | "runtime-policy" | undefined;
+            hint?: string | undefined;
+            atomId?: string | undefined;
+            expected?: JsonValue | undefined;
+            received?: JsonValue | undefined;
+        }[];
+        validationFeedback: readonly (readonly {
+            code: "WORKFLOW_JSON_INVALID" | "WORKFLOW_SCHEMA_INVALID" | "RUNTIME_POLICY_INVALID" | "ATOM_CATALOG_INVALID" | "ATOM_CATALOG_DUPLICATE" | "NODE_LIMIT_EXCEEDED" | "DEPENDENCY_LIMIT_EXCEEDED" | "ATOM_NOT_FOUND" | "ATOM_UNAVAILABLE" | "DEPRECATED_ATOM_FORBIDDEN" | "ATTEMPT_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_LIMIT_EXCEEDED" | "RETRY_LIMIT_EXCEEDED" | "RETRY_DELAY_LIMIT_EXCEEDED" | "RETRY_POLICY_INVALID" | "NON_IDEMPOTENT_RETRY_FORBIDDEN" | "CACHE_TTL_LIMIT_EXCEEDED" | "CACHE_ENABLE_OVERRIDE_FORBIDDEN" | "MAP_LIMIT_EXCEEDED" | "MAP_GROUP_CONFIG_MISMATCH" | "MAP_COMPLETION_CONFLICT" | "AGENT_PROVIDER_FORBIDDEN" | "AGENT_MODEL_FORBIDDEN" | "AGENT_FALLBACK_LIMIT_EXCEEDED" | "AGENT_FALLBACK_DUPLICATE" | "AGENT_CWD_FORBIDDEN" | "DUPLICATE_NODE_ID" | "DUPLICATE_DEPENDENCY" | "SELF_DEPENDENCY" | "DEPENDENCY_NOT_FOUND" | "DEPENDENCY_CYCLE" | "ENTRY_NODE_NOT_FOUND" | "ENTRY_NODE_DUPLICATE" | "ENTRY_DEPENDENCY_INVALID" | "EDGE_TARGET_NOT_FOUND" | "EDGE_TARGET_DUPLICATE" | "EDGE_TERMINAL_WITH_INPUT_FORBIDDEN" | "EDGE_BACK_EDGE_UNBOUNDED" | "EDGE_TRAVERSAL_LIMIT_EXCEEDED" | "DECISION_SELECT_REFERENCE_INVALID" | "DECISION_SELECT_TYPE_MISMATCH" | "DECISION_BRANCH_ENUM_MISMATCH" | "CONTROL_NODE_UNREACHABLE" | "CONTROL_DEAD_END" | "CONTROL_TERMINAL_UNREACHABLE" | "JOIN_CONTROL_PREDECESSOR_MISSING" | "PARALLEL_FANOUT_NOT_JOINED" | "BRANCH_MERGE_INPUT_MISSING" | "BRANCH_MERGE_SOURCE_INVALID" | "REFERENCE_NOT_FOUND" | "REFERENCE_SOURCE_OPTIONAL" | "REFERENCE_NOT_DEPENDENCY" | "MAP_REFERENCE_OUTSIDE_MAP" | "EDGE_REFERENCE_OUTSIDE_EDGE" | "WORKFLOW_OUTPUT_REFERENCE_INVALID" | "REFERENCE_INVALID" | "REFERENCE_TYPE_MISMATCH" | "INPUT_SCHEMA_MISMATCH" | "INPUT_REQUIRED_PROPERTY_MISSING" | "INPUT_ADDITIONAL_PROPERTY_FORBIDDEN" | "MAP_ITEMS_NOT_ARRAY" | "EDGE_INPUT_SCHEMA_MISMATCH" | "AGENT_CWD_TYPE_MISMATCH" | "PLANNER_DRAFT_SCHEMA_INVALID" | "PLANNER_DRAFT_ATOM_NOT_SELECTED" | "PLANNER_DRAFT_ALIAS_DUPLICATE" | "PLANNER_DRAFT_REFERENCE_INVALID" | "PLANNER_DRAFT_REFERENCE_AMBIGUOUS" | "PLANNER_DRAFT_CONTROL_INVALID" | "PLANNER_DRAFT_NORMALIZATION_FAILED" | "PLANNER_TURN_LIMIT_EXCEEDED" | "PLANNER_CAPABILITY_SCHEMA_INVALID" | "PLANNING_WORKSPACE_ACTION_INVALID" | "PLANNING_CAPABILITY_UNAVAILABLE" | "PLANNING_CAPABILITY_ATOM_UNKNOWN" | "PLANNING_CAPABILITY_SCHEMA_MISMATCH" | "PLANNING_SELECTED_ATOM_LIMIT_EXCEEDED" | "PLANNING_REQUIRED_INPUT_UNAVAILABLE" | "PLANNING_BINDING_SOURCE_OPTIONAL" | "PLANNING_BINDING_AMBIGUOUS" | "PLANNING_BRANCH_RESULT_REQUIRED" | "PLANNING_BRANCH_RESULT_MISMATCH" | "PLANNING_DECISION_NO_EFFECT" | "PLANNING_DRAFT_EMPTY" | "PLANNING_TRANSACTION_INVALID" | "PLANNING_TRANSACTION_LIMIT_EXCEEDED" | "PLANNING_TRANSACTION_VALIDATION_FAILED" | "PLANNING_REVISION_CONFLICT" | "PLANNING_REVISION_LIMIT_EXCEEDED" | "PLANNING_NODE_LIMIT_EXCEEDED" | "PLANNING_OPERATION_CONFLICT" | "PLANNING_BLOCK_DUPLICATE" | "PLANNING_BLOCK_NOT_FOUND" | "PLANNING_FINALIZE_CONFLICT" | "PLANNING_WORKSPACE_NOT_EDITABLE" | "PLANNING_WORKSPACE_NOT_FINALIZABLE" | "PLANNING_ATOM_UNAVAILABLE" | "PLANNING_ATOM_SCHEMA_DESCRIPTION_REQUIRED" | "PLANNING_FINAL_VALIDATION_FAILED" | "PLANNING_WORKFLOW_OUTPUT_REQUIRED" | "PLANNING_REQUIRED_CAPABILITY_NOT_REALIZED" | "PLANNING_FINALIZED_REVISION_MISSING";
+            path: string;
+            message: string;
+            stage?: "json-extract" | "capability-schema" | "capability-resolution" | "draft-schema" | "atom-resolution" | "draft-normalization" | "workflow-schema" | "data-link" | "control-graph" | "runtime-policy" | undefined;
+            hint?: string | undefined;
+            atomId?: string | undefined;
+            expected?: JsonValue | undefined;
+            received?: JsonValue | undefined;
+        }[])[];
+        plan?: never;
+        metrics?: never;
+        eventStats?: never;
+        coverage?: never;
+        catalog?: never;
+        draft?: never;
+    } | null>;
+    cancelPlan(planId: string): Promise<{
+        status: "cancelled";
+        updatedAt: string;
+        endedAt: string;
+        schemaVersion: "1.0";
+        planId: string;
+        request: {
+            goal: string;
+            cwd: string;
+            projectScope: string;
+            hostScope: string;
+            initialWorkflowInputs: Record<string, JsonValue>;
+            context: JsonValue;
+        };
+        planner: {
+            provider: string;
+            model: string;
+            maxPlanningTurns?: number | undefined;
+        };
+        catalogHash: string;
+        inputRevisions: {
+            revision: number;
+            patch: Record<string, JsonValue>;
+            effectiveInputsHash: string;
+            createdAt: string;
+        }[];
+        hashes: {
+            draft?: string | undefined;
+            workflowSpec?: string | undefined;
+            workflowIr?: string | undefined;
+        };
+        validationErrors: {
+            code: "WORKFLOW_JSON_INVALID" | "WORKFLOW_SCHEMA_INVALID" | "RUNTIME_POLICY_INVALID" | "ATOM_CATALOG_INVALID" | "ATOM_CATALOG_DUPLICATE" | "NODE_LIMIT_EXCEEDED" | "DEPENDENCY_LIMIT_EXCEEDED" | "ATOM_NOT_FOUND" | "ATOM_UNAVAILABLE" | "DEPRECATED_ATOM_FORBIDDEN" | "ATTEMPT_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_TIMEOUT_LIMIT_EXCEEDED" | "LIFECYCLE_TICK_LIMIT_EXCEEDED" | "RETRY_LIMIT_EXCEEDED" | "RETRY_DELAY_LIMIT_EXCEEDED" | "RETRY_POLICY_INVALID" | "NON_IDEMPOTENT_RETRY_FORBIDDEN" | "CACHE_TTL_LIMIT_EXCEEDED" | "CACHE_ENABLE_OVERRIDE_FORBIDDEN" | "MAP_LIMIT_EXCEEDED" | "MAP_GROUP_CONFIG_MISMATCH" | "MAP_COMPLETION_CONFLICT" | "AGENT_PROVIDER_FORBIDDEN" | "AGENT_MODEL_FORBIDDEN" | "AGENT_FALLBACK_LIMIT_EXCEEDED" | "AGENT_FALLBACK_DUPLICATE" | "AGENT_CWD_FORBIDDEN" | "DUPLICATE_NODE_ID" | "DUPLICATE_DEPENDENCY" | "SELF_DEPENDENCY" | "DEPENDENCY_NOT_FOUND" | "DEPENDENCY_CYCLE" | "ENTRY_NODE_NOT_FOUND" | "ENTRY_NODE_DUPLICATE" | "ENTRY_DEPENDENCY_INVALID" | "EDGE_TARGET_NOT_FOUND" | "EDGE_TARGET_DUPLICATE" | "EDGE_TERMINAL_WITH_INPUT_FORBIDDEN" | "EDGE_BACK_EDGE_UNBOUNDED" | "EDGE_TRAVERSAL_LIMIT_EXCEEDED" | "DECISION_SELECT_REFERENCE_INVALID" | "DECISION_SELECT_TYPE_MISMATCH" | "DECISION_BRANCH_ENUM_MISMATCH" | "CONTROL_NODE_UNREACHABLE" | "CONTROL_DEAD_END" | "CONTROL_TERMINAL_UNREACHABLE" | "JOIN_CONTROL_PREDECESSOR_MISSING" | "PARALLEL_FANOUT_NOT_JOINED" | "BRANCH_MERGE_INPUT_MISSING" | "BRANCH_MERGE_SOURCE_INVALID" | "REFERENCE_NOT_FOUND" | "REFERENCE_SOURCE_OPTIONAL" | "REFERENCE_NOT_DEPENDENCY" | "MAP_REFERENCE_OUTSIDE_MAP" | "EDGE_REFERENCE_OUTSIDE_EDGE" | "WORKFLOW_OUTPUT_REFERENCE_INVALID" | "REFERENCE_INVALID" | "REFERENCE_TYPE_MISMATCH" | "INPUT_SCHEMA_MISMATCH" | "INPUT_REQUIRED_PROPERTY_MISSING" | "INPUT_ADDITIONAL_PROPERTY_FORBIDDEN" | "MAP_ITEMS_NOT_ARRAY" | "EDGE_INPUT_SCHEMA_MISMATCH" | "AGENT_CWD_TYPE_MISMATCH" | "PLANNER_DRAFT_SCHEMA_INVALID" | "PLANNER_DRAFT_ATOM_NOT_SELECTED" | "PLANNER_DRAFT_ALIAS_DUPLICATE" | "PLANNER_DRAFT_REFERENCE_INVALID" | "PLANNER_DRAFT_REFERENCE_AMBIGUOUS" | "PLANNER_DRAFT_CONTROL_INVALID" | "PLANNER_DRAFT_NORMALIZATION_FAILED" | "PLANNER_TURN_LIMIT_EXCEEDED" | "PLANNER_CAPABILITY_SCHEMA_INVALID" | "PLANNING_WORKSPACE_ACTION_INVALID" | "PLANNING_CAPABILITY_UNAVAILABLE" | "PLANNING_CAPABILITY_ATOM_UNKNOWN" | "PLANNING_CAPABILITY_SCHEMA_MISMATCH" | "PLANNING_SELECTED_ATOM_LIMIT_EXCEEDED" | "PLANNING_REQUIRED_INPUT_UNAVAILABLE" | "PLANNING_BINDING_SOURCE_OPTIONAL" | "PLANNING_BINDING_AMBIGUOUS" | "PLANNING_BRANCH_RESULT_REQUIRED" | "PLANNING_BRANCH_RESULT_MISMATCH" | "PLANNING_DECISION_NO_EFFECT" | "PLANNING_DRAFT_EMPTY" | "PLANNING_TRANSACTION_INVALID" | "PLANNING_TRANSACTION_LIMIT_EXCEEDED" | "PLANNING_TRANSACTION_VALIDATION_FAILED" | "PLANNING_REVISION_CONFLICT" | "PLANNING_REVISION_LIMIT_EXCEEDED" | "PLANNING_NODE_LIMIT_EXCEEDED" | "PLANNING_OPERATION_CONFLICT" | "PLANNING_BLOCK_DUPLICATE" | "PLANNING_BLOCK_NOT_FOUND" | "PLANNING_FINALIZE_CONFLICT" | "PLANNING_WORKSPACE_NOT_EDITABLE" | "PLANNING_WORKSPACE_NOT_FINALIZABLE" | "PLANNING_ATOM_UNAVAILABLE" | "PLANNING_ATOM_SCHEMA_DESCRIPTION_REQUIRED" | "PLANNING_FINAL_VALIDATION_FAILED" | "PLANNING_WORKFLOW_OUTPUT_REQUIRED" | "PLANNING_REQUIRED_CAPABILITY_NOT_REALIZED" | "PLANNING_FINALIZED_REVISION_MISSING";
+            path: string;
+            message: string;
+            stage?: "json-extract" | "capability-schema" | "capability-resolution" | "draft-schema" | "atom-resolution" | "draft-normalization" | "workflow-schema" | "data-link" | "control-graph" | "runtime-policy" | undefined;
+            hint?: string | undefined;
+            atomId?: string | undefined;
+            expected?: JsonValue | undefined;
+            received?: JsonValue | undefined;
+        }[];
+        createdAt: string;
+        workflowRevisionId?: string | undefined;
+        error?: {
+            code: string;
+            message: string;
+            retryable: boolean;
+        } | undefined;
+    }>;
+    resumePlan(planId: string, patch: Readonly<Record<string, JsonValue>>, execution?: WorkflowServiceExecutionOptions): Promise<DurablePlanRecord>;
+    listWorkflows(): Promise<readonly {
+        schemaVersion: "1.0";
+        workflowId: string;
+        name: string;
+        latestRevisionId: string;
+        revisionIds: string[];
+        createdAt: string;
+        updatedAt: string;
+    }[]>;
+    inspectWorkflow(reference: string): Promise<import("@atom-workflow-agent/workflow-engine").StoredWorkflowRevision | {
+        readonly definition: import("@atom-workflow-agent/contracts").WorkflowDefinition;
+        readonly revisions: readonly import("@atom-workflow-agent/contracts").WorkflowRevision[];
+    }>;
+    exportWorkflow(reference: string): Promise<{
+        workflowId: string;
+        workflowRevisionId: string;
+        revision: number;
+        workflowSpec: {
+            schemaVersion: "1.2";
+            name: string;
+            inputs: Record<string, JsonValue>;
+            entry: string[];
+            nodes: ({
+                next: {
+                    to: string | string[];
+                    with: Record<string, JsonValue>;
+                    maxTraversals?: number | undefined;
+                };
+                id: string;
+                atom: string;
+                dependsOn: string[];
+                input: JsonValue;
+                kind: "atom";
+                map?: {
+                    items: {
+                        $ref: string;
+                    };
+                    maxItems: number;
+                    maxConcurrency: number;
+                    group?: string | undefined;
+                } | undefined;
+                policy?: {
+                    attemptTimeoutMs?: number | undefined;
+                    lifecycleTickTimeoutMs?: number | undefined;
+                    maxLifecycleTicks?: number | undefined;
+                    retry?: {
+                        maxAttempts?: number | undefined;
+                        strategy?: "fixed" | "exponential" | undefined;
+                        baseDelayMs?: number | undefined;
+                        maxDelayMs?: number | undefined;
+                        jitter?: boolean | undefined;
+                    } | undefined;
+                    cache?: {
+                        enabled?: boolean | undefined;
+                        ttlMs?: number | undefined;
+                    } | undefined;
+                } | undefined;
+            } | {
+                select: {
+                    $ref: string;
+                };
+                branches: Record<string, {
+                    to: string | string[];
+                    with: Record<string, JsonValue>;
+                    maxTraversals?: number | undefined;
+                }>;
+                default: {
+                    to: string | string[];
+                    with: Record<string, JsonValue>;
+                    maxTraversals?: number | undefined;
+                };
+                id: string;
+                atom: string;
+                dependsOn: string[];
+                input: JsonValue;
+                kind: "decision";
+                map?: {
+                    items: {
+                        $ref: string;
+                    };
+                    maxItems: number;
+                    maxConcurrency: number;
+                    group?: string | undefined;
+                } | undefined;
+                policy?: {
+                    attemptTimeoutMs?: number | undefined;
+                    lifecycleTickTimeoutMs?: number | undefined;
+                    maxLifecycleTicks?: number | undefined;
+                    retry?: {
+                        maxAttempts?: number | undefined;
+                        strategy?: "fixed" | "exponential" | undefined;
+                        baseDelayMs?: number | undefined;
+                        maxDelayMs?: number | undefined;
+                        jitter?: boolean | undefined;
+                    } | undefined;
+                    cache?: {
+                        enabled?: boolean | undefined;
+                        ttlMs?: number | undefined;
+                    } | undefined;
+                } | undefined;
+            } | {
+                kind: "merge";
+                id: string;
+                dependsOn: string[];
+                outputSchema: Record<string, JsonValue>;
+                next: {
+                    to: string | string[];
+                    with: Record<string, JsonValue>;
+                    maxTraversals?: number | undefined;
+                };
+            })[];
+            outputs: Record<string, {
+                $ref: string;
+            }>;
+        };
+    }>;
+    diffWorkflows(from: string, to: string): Promise<{
+        from: string;
+        to: string;
+        identical: boolean;
+        nodes: {
+            added: string[];
+            removed: string[];
+            changed: {
+                nodeId: string;
+                fromKind: "atom" | "decision" | "merge";
+                toKind: "atom" | "decision" | "merge";
+                fromAtom: string | null;
+                toAtom: string | null;
+            }[];
+        };
+        inputsChanged: boolean;
+        outputsChanged: boolean;
+        entryChanged: boolean;
+    }>;
+    topology(reference: string, format?: "json" | "terminal"): Promise<string | {
+        schemaVersion: "1.0";
+        workflowRevisionId: string;
+        irHash: string;
+        nodes: {
+            id: string;
+            kind: "join" | "map" | "atom" | "merge" | "switch";
+            atom?: string | undefined;
+            mapScope?: string | undefined;
+        }[];
+        controlEdges: {
+            id: string;
+            source: string;
+            targets: string[];
+            kind: string;
+            backEdge: boolean;
+            branch?: string | undefined;
+            terminal?: string | undefined;
+            maxTraversals?: number | undefined;
+        }[];
+        dataEdges: {
+            source: string;
+            target: string;
+            targetPath: string;
+            reference: string;
+        }[];
+        groups: {
+            entries: string[];
+            forks: {
+                edgeId: string;
+                targets: string[];
+            }[];
+            joins: {
+                nodeId: string;
+                dependencies: string[];
+            }[];
+            maps: {
+                nodeId: string;
+                maxItems: number;
+                maxConcurrency: number;
+                bodyNodeIds: string[];
+            }[];
+            switches: {
+                nodeId: string;
+                cases: string[];
+                hasDefault: boolean;
+            }[];
+        };
+    }>;
+    graph(resourceId: string): Promise<{
+        schemaVersion: "1.0";
+        workflowRevisionId: string;
+        irHash: string;
+        lastEventSequence: number;
+        nodes: {
+            id: string;
+            kind: "output" | "input" | "join" | "map" | "atom" | "merge" | "terminal" | "switch";
+            label: string;
+            atom?: string | undefined;
+            capability?: {
+                schemaVersion: "1.0";
+                hash: string;
+                key: string;
+                id: string;
+                version: string;
+                title: string;
+                description: string;
+                inputSchema: Record<string, JsonValue>;
+                outputSchema: Record<string, JsonValue>;
+            } | undefined;
+            mapScope?: string | undefined;
+            runtime?: {
+                status: "ready" | "succeeded" | "failed" | "cancelled" | "running" | "awaiting_signal" | "awaiting_host" | "interrupted" | "unknown_outcome" | "retry_wait";
+                activeDurationMs: number;
+                attemptCount: number;
+                retryCount: number;
+                latestActivation: {
+                    activationId: string;
+                    activationIndex: number;
+                    status: "ready" | "succeeded" | "failed" | "cancelled" | "running" | "awaiting_signal" | "awaiting_host" | "interrupted" | "unknown_outcome" | "retry_wait";
+                    attemptCount: number;
+                    retryCount: number;
+                    activeDurationMs: number;
+                    artifacts: {
+                        id: string;
+                        kind: string;
+                        hash?: string | undefined;
+                    }[];
+                    mapRunId?: string | undefined;
+                    mapIndex?: number | undefined;
+                    mapItem?: JsonValue | undefined;
+                    createdAt?: string | undefined;
+                    startedAt?: string | undefined;
+                    endedAt?: string | undefined;
+                    error?: {
+                        code: string;
+                        message: string;
+                        retryable: boolean;
+                    } | undefined;
+                    input?: JsonValue | undefined;
+                    output?: JsonValue | undefined;
+                };
+                activationCount: number;
+                artifactCount: number;
+                activations: {
+                    activationId: string;
+                    activationIndex: number;
+                    status: "ready" | "succeeded" | "failed" | "cancelled" | "running" | "awaiting_signal" | "awaiting_host" | "interrupted" | "unknown_outcome" | "retry_wait";
+                    attemptCount: number;
+                    retryCount: number;
+                    activeDurationMs: number;
+                    artifacts: {
+                        id: string;
+                        kind: string;
+                        hash?: string | undefined;
+                    }[];
+                    mapRunId?: string | undefined;
+                    mapIndex?: number | undefined;
+                    mapItem?: JsonValue | undefined;
+                    createdAt?: string | undefined;
+                    startedAt?: string | undefined;
+                    endedAt?: string | undefined;
+                    error?: {
+                        code: string;
+                        message: string;
+                        retryable: boolean;
+                    } | undefined;
+                    input?: JsonValue | undefined;
+                    output?: JsonValue | undefined;
+                }[];
+                waitingKind?: "signal" | "host" | undefined;
+            } | undefined;
+        }[];
+        edges: ({
+            id: string;
+            kind: "control";
+            source: string;
+            targets: string[];
+            controlKind: string;
+            backEdge: boolean;
+            branch?: string | undefined;
+            terminal?: string | undefined;
+            maxTraversals?: number | undefined;
+            runtime?: {
+                traversalCount: number;
+                selected: boolean;
+                lastTraversedAt?: string | undefined;
+            } | undefined;
+        } | {
+            id: string;
+            kind: "data";
+            source: string;
+            target: string;
+            targetPath: string;
+            reference: string;
+        })[];
+        groups: {
+            entries: string[];
+            forks: {
+                edgeId: string;
+                targets: string[];
+            }[];
+            joins: {
+                nodeId: string;
+                dependencies: string[];
+            }[];
+            maps: {
+                nodeId: string;
+                maxItems: number;
+                maxConcurrency: number;
+                bodyNodeIds: string[];
+            }[];
+            switches: {
+                nodeId: string;
+                cases: string[];
+                hasDefault: boolean;
+            }[];
+        };
+        decisions: {
+            nodeId: string;
+            activationId: string;
+            selectedBranch: string;
+            matched: boolean;
+            edgeId: string;
+            selectedAt: string;
+        }[];
+        maps: {
+            mapRunId: string;
+            nodeId: string;
+            status: "succeeded" | "failed" | "running";
+            itemCount: number;
+            completedCount: number;
+            activeCount: number;
+        }[];
+        artifacts: {
+            id: string;
+            attemptId: string;
+            kind: string;
+            hash: string;
+            contentKind: "file" | "inline" | "empty";
+            metadata: Record<string, JsonValue>;
+            createdAt: string;
+            activationId?: string | undefined;
+            nodeId?: string | undefined;
+            path?: string | undefined;
+        }[];
+        pending: {
+            signals: number;
+            hostTasks: number;
+        };
+        run?: {
+            runId: string;
+            status: "created" | "succeeded" | "failed" | "cancelled" | "running" | "planning" | "awaiting_signal" | "awaiting_host" | "interrupted" | "unknown_outcome";
+            goal: string;
+            createdAt: string;
+            updatedAt: string;
+            outputs?: JsonValue | undefined;
+            error?: {
+                code: string;
+                message: string;
+                retryable: boolean;
+            } | undefined;
+            startedAt?: string | undefined;
+            endedAt?: string | undefined;
+        } | undefined;
+    }>;
+    startInspector(resourceId: string, options?: {
+        readonly host?: string;
+        readonly port?: number;
+        readonly pollIntervalMs?: number;
+        readonly signal?: AbortSignal;
+    }): Promise<WorkflowInspectorServerHandle>;
+    verifyWorkflowRevision(workflowRevisionId: string, cwd?: string, hostScope?: string): Promise<import("@atom-workflow-agent/workflow-engine").StoredWorkflowRevision>;
+    runWorkflowRevision(workflowRevisionId: string, input?: {
+        runId?: string;
+        goal?: string;
+        cwd?: string;
+        projectScope?: string;
+        hostScope?: string;
+        inputs?: Readonly<Record<string, JsonValue>>;
+    }): Promise<RuntimeSnapshot>;
+    execute(command: RuntimeMachineCommand, execution?: WorkflowServiceExecutionOptions): Promise<unknown>;
+    private withProgress;
+    dispose(): Promise<void>;
+    listAtoms(): JsonValue;
+    listAtomSources(): JsonValue;
+    describeAtom(key: string): JsonValue;
+    runAtom(key: string, input: JsonValue, execution?: AtomDevelopmentExecutionOptions): Promise<import("../atoms/atom-development-service.js").AtomDevelopmentResult>;
+    resumeAtom(attemptId: string, value: JsonValue, execution?: AtomDevelopmentExecutionOptions): Promise<import("../atoms/atom-development-service.js").AtomDevelopmentResult>;
+    inspectAtomAttempt(attemptId: string): Promise<JsonValue>;
+    listAtomAttemptEvents(attemptId: string, after?: number, limit?: number): Promise<readonly import("../atoms/atom-development-store.js").AtomDevelopmentEvent[]>;
+}
+//# sourceMappingURL=workflow-service.d.ts.map