@openapi-flow/core 0.1.0 → 0.3.0

package/dist/types/workflow-draft-native-node-addition.d.ts

@@ -0,0 +1,113 @@
+import type { JsonValueObject } from './api-arguments.js';
+import type { BindingSchema } from './api-bindings.js';
+import type { PrepareWorkflowDraftEditInput, StagedWorkflowDraftEdit, WorkflowDraftEditResolution } from './workflow-draft-edit-assembly.js';
+import type { WorkflowSourceMessage } from './workflow-draft.js';
+import type { MissingWorkflowNativeMaterialRequirement } from './native-material-snapshot.js';
+import type { NativeRuntimeParameterSelection } from './workflow-plan.js';
+import type { NativeNodeConfigurationDependencies } from './native-instance-dependencies.js';
+import type { WorkflowDraftNativeDependencyRole } from './workflow-draft-native-dependencies.js';
+import type { ProposedWorkflowDraftSourceEvidence, ResolvedWorkflowDraftSourceEvidence, WorkflowDraftSourceEvidenceDescription } from './workflow-draft-source-evidence.js';
+export interface WorkflowDraftNativeNodeAdditionInput extends PrepareWorkflowDraftEditInput {
+    stepId: string;
+    allowRuntimeParameters?: boolean;
+    /** A separately validated decision; the value stage cannot select ownership again. */
+    parameterOwnership?: WorkflowDraftNativeNodeParameterOwnershipContract;
+}
+export type WorkflowDraftNativeNodeParameterOwnershipChoice = {
+    status: 'literal';
+} | {
+    status: 'runtime-parameters';
+} | {
+    status: 'runtime-fields';
+    pointers: string[];
+} | {
+    status: 'needs-clarification';
+    message: string;
+};
+export interface WorkflowDraftNativeNodeParameterOwnershipProposal {
+    decision: WorkflowDraftNativeNodeParameterOwnershipChoice & ProposedWorkflowDraftSourceEvidence;
+}
+export interface WorkflowDraftNativeNodeParameterOwnershipContract {
+    id: string;
+    fingerprint: string;
+    stepId: string;
+    nodeId: string;
+    proposal: WorkflowDraftNativeNodeParameterOwnershipProposal;
+    decision: WorkflowDraftNativeNodeParameterOwnershipChoice & ResolvedWorkflowDraftSourceEvidence;
+    literalParametersSchema: BindingSchema;
+    hasLiteralParameters: boolean;
+    runtimeParameters?: true | NativeRuntimeParameterSelection;
+}
+export interface ResolveWorkflowDraftNativeNodeParameterOwnershipInput extends WorkflowDraftNativeNodeAdditionInput {
+    fingerprint: string;
+    proposal: WorkflowDraftNativeNodeParameterOwnershipProposal;
+}
+export type WorkflowDraftNativeNodeParameterOwnershipResult = {
+    status: 'ready';
+    contract: WorkflowDraftNativeNodeParameterOwnershipContract;
+} | {
+    status: 'needs-clarification';
+    fingerprint: string;
+    proposal: WorkflowDraftNativeNodeParameterOwnershipProposal;
+    questions: WorkflowDraftNativeNodeAdditionQuestion[];
+};
+export interface WorkflowDraftNativeNodeAdditionReadiness {
+    status: 'ready' | 'requires-context';
+    nodeId: string;
+    capability: string;
+    missingContext: MissingWorkflowNativeMaterialRequirement[];
+    pendingSourceNodeIds?: string[];
+}
+export interface WorkflowDraftNativeNodeAdditionDescription extends WorkflowDraftSourceEvidenceDescription {
+    fingerprint: string;
+    stage: StagedWorkflowDraftEdit;
+    nodeId: string;
+    capability: {
+        name: string;
+        description: string;
+        supportsRuntimeParameters: boolean;
+    };
+    instruction: string;
+    parametersSchema: BindingSchema;
+    /** The registered input contract proves that {} is its only possible value. */
+    parameterMode: 'fixed-empty' | 'values';
+    backgroundMessages: WorkflowSourceMessage[];
+    allowRuntimeParameters: boolean;
+    sourceDependencies?: NativeNodeConfigurationDependencies;
+    plannedNativeRoles?: WorkflowDraftNativeDependencyRole[];
+}
+export type WorkflowDraftNativeNodeAdditionChoice = {
+    status: 'provided';
+    parameters: JsonValueObject;
+} | {
+    status: 'runtime-parameters';
+} | {
+    status: 'needs-clarification';
+    message: string;
+};
+export interface WorkflowDraftNativeNodeAdditionProposal {
+    decision: WorkflowDraftNativeNodeAdditionChoice & ProposedWorkflowDraftSourceEvidence;
+}
+export interface ResolveWorkflowDraftNativeNodeAdditionInput extends WorkflowDraftNativeNodeAdditionInput {
+    fingerprint: string;
+    proposal: WorkflowDraftNativeNodeAdditionProposal;
+}
+export interface WorkflowDraftNativeNodeAdditionQuestion extends ResolvedWorkflowDraftSourceEvidence {
+    id: string;
+    nodeId: string;
+    message: string;
+}
+export type WorkflowDraftNativeNodeAdditionResult = {
+    fingerprint: string;
+    proposal: WorkflowDraftNativeNodeAdditionProposal;
+    decision: WorkflowDraftNativeNodeAdditionChoice & ResolvedWorkflowDraftSourceEvidence;
+    parameterOwnership?: WorkflowDraftNativeNodeParameterOwnershipContract;
+} & ({
+    status: 'ready';
+    resolution: Extract<WorkflowDraftEditResolution, {
+        kind: 'native-literal' | 'native-runtime' | 'native-mixed';
+    }>;
+} | {
+    status: 'needs-clarification';
+    questions: WorkflowDraftNativeNodeAdditionQuestion[];
+});

package/dist/types/workflow-draft-native-node-addition.js

@@ -0,0 +1 @@
+export {};

package/dist/types/workflow-draft-native-parameter-edit.d.ts

@@ -0,0 +1,129 @@
+import type { BindingSchema } from './api-bindings.js';
+import type { JsonValue } from './api-arguments.js';
+import type { PlannedNativeNode, WorkflowCapability } from './workflow-plan.js';
+import type { WorkflowSourceMessage } from './workflow-draft.js';
+import type { WorkflowDraftReferenceSource, WorkflowDraftExclusiveOutputSource } from './workflow-draft-reference-sources.js';
+import type { WorkflowMessageEvidence } from './planning-evidence.js';
+import type { WorkflowDecisionExplanation } from './workflow-clarification.js';
+import type { PrepareWorkflowDraftEditInput, StagedWorkflowDraftEdit, WorkflowDraftEditResolution, WorkflowDraftValueEdit } from './workflow-draft-edit-assembly.js';
+export type WorkflowDraftNativeParameterChange = WorkflowDraftValueEdit | {
+    kind: 'defer';
+    pointer: string;
+};
+export interface ApplyWorkflowDraftNativeParameterChangesInput {
+    node: PlannedNativeNode;
+    capability: WorkflowCapability;
+    edits: WorkflowDraftNativeParameterChange[];
+    source: string;
+}
+export interface WorkflowDraftNativeParameterEditInput extends PrepareWorkflowDraftEditInput {
+    stepId: string;
+    /** Explicit opt-in to changing whole-object ownership to execution-time input. */
+    allowRuntimeParameters?: boolean;
+}
+export interface WorkflowDraftNativeParameterEditEvidence {
+    sources: WorkflowMessageEvidence[];
+    explanation?: WorkflowDecisionExplanation<WorkflowMessageEvidence>;
+}
+export interface ProposedWorkflowDraftNativeParameterEditTarget extends WorkflowDraftNativeParameterEditEvidence {
+    kind: 'set' | 'remove' | 'defer';
+    pointer: string;
+}
+export type WorkflowDraftNativeParameterEditDecision = {
+    status: 'targets';
+    targets: ProposedWorkflowDraftNativeParameterEditTarget[];
+} | (WorkflowDraftNativeParameterEditEvidence & {
+    status: 'needs-clarification';
+    message: string;
+}) | (WorkflowDraftNativeParameterEditEvidence & {
+    status: 'runtime-parameters';
+});
+export interface WorkflowDraftNativeParameterEditProposal {
+    decision: WorkflowDraftNativeParameterEditDecision;
+}
+export interface WorkflowDraftNativeParameterEditDescription {
+    fingerprint: string;
+    stage: StagedWorkflowDraftEdit;
+    node: PlannedNativeNode;
+    capability: {
+        name: string;
+        description: string;
+        supportsRuntimeParameters: boolean;
+    };
+    parametersSchema: BindingSchema;
+    instruction: string;
+    messages: WorkflowSourceMessage[];
+    backgroundMessages: WorkflowSourceMessage[];
+    sourceCandidates: WorkflowDraftReferenceSource[];
+    exclusiveOutputSources: WorkflowDraftExclusiveOutputSource[];
+    includeExplanations: boolean;
+    allowRuntimeParameters: boolean;
+}
+export type WorkflowDraftNativeParameterEditTarget = ProposedWorkflowDraftNativeParameterEditTarget & {
+    id: string;
+} & ({
+    kind: 'set';
+    schema: BindingSchema;
+} | {
+    kind: 'remove' | 'defer';
+});
+export interface WorkflowDraftNativeParameterEditContract {
+    id: string;
+    fingerprint: string;
+    stepId: string;
+    nodeId: string;
+    schemaResource: BindingSchema;
+    targets: WorkflowDraftNativeParameterEditTarget[];
+}
+export interface ResolveWorkflowDraftNativeParameterEditTargetsInput extends WorkflowDraftNativeParameterEditInput {
+    fingerprint: string;
+    proposal: WorkflowDraftNativeParameterEditProposal;
+}
+export interface WorkflowDraftNativeParameterEditQuestion extends WorkflowDraftNativeParameterEditEvidence {
+    id: string;
+    nodeId: string;
+    message: string;
+    targetId?: string;
+    pointer?: string;
+}
+export type WorkflowDraftNativeParameterEditTargetsResult = {
+    status: 'ready';
+    contract: WorkflowDraftNativeParameterEditContract;
+} | {
+    status: 'needs-clarification';
+    questions: WorkflowDraftNativeParameterEditQuestion[];
+} | {
+    status: 'runtime-parameters';
+    resolution: Extract<WorkflowDraftEditResolution, {
+        kind: 'native-runtime';
+    }>;
+};
+export interface WorkflowDraftNativeParameterEditContractInput extends WorkflowDraftNativeParameterEditInput {
+    contract: WorkflowDraftNativeParameterEditContract;
+}
+export type WorkflowDraftNativeParameterEditValue = WorkflowDraftNativeParameterEditEvidence & ({
+    status: 'provided';
+    value: JsonValue;
+} | {
+    status: 'needs-input';
+    message: string;
+});
+export interface WorkflowDraftNativeParameterEditValues {
+    values: Record<string, WorkflowDraftNativeParameterEditValue>;
+}
+export interface ResolveWorkflowDraftNativeParameterEditsInput extends WorkflowDraftNativeParameterEditContractInput {
+    output: WorkflowDraftNativeParameterEditValues;
+}
+export type WorkflowDraftNativeParameterEditResult = {
+    status: 'ready';
+    contractId: string;
+    values: WorkflowDraftNativeParameterEditValues;
+    resolution: Extract<WorkflowDraftEditResolution, {
+        kind: 'native-parameters';
+    }>;
+} | {
+    status: 'needs-input';
+    contractId: string;
+    values: WorkflowDraftNativeParameterEditValues;
+    questions: WorkflowDraftNativeParameterEditQuestion[];
+};

package/dist/types/workflow-draft-native-parameter-edit.js

@@ -0,0 +1 @@
+export {};

package/dist/types/workflow-draft-native-reference-repair.d.ts

@@ -0,0 +1,84 @@
+import type { PrepareWorkflowDraftEditInput, StagedWorkflowDraftEdit, WorkflowDraftEditRepairTask, WorkflowDraftEditRepair } from './workflow-draft-edit-assembly.js';
+import type { WorkflowNativeReferenceBinding } from './native-parameter-reference.js';
+import type { WorkflowDraftReferenceSources } from './workflow-draft-reference-sources.js';
+import type { PlannedNativeNode, WorkflowCapability } from './workflow-plan.js';
+import type { WorkflowSourceMessage } from './workflow-draft.js';
+import type { WorkflowMessageEvidence, WorkflowPlanningEvidence } from './planning-evidence.js';
+import type { WorkflowDecisionExplanation } from './workflow-clarification.js';
+export interface WorkflowDraftNativeReferenceRepairInput extends PrepareWorkflowDraftEditInput {
+    taskId: string;
+}
+export interface WorkflowDraftNativeRepairBinding extends WorkflowNativeReferenceBinding {
+    id: string;
+}
+export interface WorkflowDraftNativeReferenceRepairDescription {
+    fingerprint: string;
+    stage: StagedWorkflowDraftEdit;
+    task: WorkflowDraftEditRepairTask;
+    node: PlannedNativeNode;
+    bindings: WorkflowDraftNativeRepairBinding[];
+    sources: WorkflowDraftReferenceSources;
+    messages: WorkflowSourceMessage[];
+    backgroundMessages: WorkflowSourceMessage[];
+    instructions: string[];
+    includeExplanations: boolean;
+}
+export type WorkflowDraftNativeRepairEvidence = {
+    kind: 'message';
+    messageId: string;
+} | {
+    kind: 'source';
+    nodeId: string;
+};
+export type WorkflowDraftNativeReferenceRepairChoice = {
+    kind: 'bind';
+    sourceNodeId: string;
+    sourcePointer?: string;
+} | {
+    kind: 'keep';
+} | {
+    kind: 'needs-clarification';
+    message: string;
+};
+export type ProposedWorkflowDraftNativeReferenceRepairDecision = WorkflowDraftNativeReferenceRepairChoice & {
+    sourceMessageIds: string[];
+    explanation?: WorkflowDecisionExplanation<WorkflowDraftNativeRepairEvidence>;
+};
+export interface ResolvedWorkflowDraftNativeRepairEvidence {
+    sources: WorkflowMessageEvidence[];
+    explanation?: WorkflowDecisionExplanation<WorkflowPlanningEvidence>;
+}
+export type ResolvedWorkflowDraftNativeReferenceRepairDecision = WorkflowDraftNativeReferenceRepairChoice & ResolvedWorkflowDraftNativeRepairEvidence;
+export interface ResolveWorkflowDraftNativeRepairEvidenceInput {
+    decision: ProposedWorkflowDraftNativeReferenceRepairDecision;
+    description: WorkflowDraftNativeReferenceRepairDescription;
+    capabilities: WorkflowCapability[];
+}
+export interface WorkflowDraftNativeReferenceRepairProposal {
+    decisions: Record<string, ProposedWorkflowDraftNativeReferenceRepairDecision>;
+}
+export interface ResolveWorkflowDraftNativeReferenceRepairInput extends WorkflowDraftNativeReferenceRepairInput {
+    fingerprint: string;
+    proposal: WorkflowDraftNativeReferenceRepairProposal;
+}
+export interface WorkflowDraftNativeReferenceRepairQuestion {
+    id: string;
+    bindingId: string;
+    nodeId: string;
+    message: string;
+    sources: WorkflowMessageEvidence[];
+    explanation?: WorkflowDecisionExplanation<WorkflowPlanningEvidence>;
+}
+export type WorkflowDraftNativeReferenceRepairResult = {
+    fingerprint: string;
+    proposal: WorkflowDraftNativeReferenceRepairProposal;
+    decisions: Record<string, ResolvedWorkflowDraftNativeReferenceRepairDecision>;
+} & ({
+    status: 'ready';
+    repair: Extract<WorkflowDraftEditRepair, {
+        kind: 'native-parameters';
+    }>;
+} | {
+    status: 'needs-clarification';
+    questions: WorkflowDraftNativeReferenceRepairQuestion[];
+});

package/dist/types/workflow-draft-native-reference-repair.js

@@ -0,0 +1 @@
+export {};

package/dist/types/workflow-draft-reference-sources.d.ts

@@ -0,0 +1,31 @@
+import type { ApiResponsePointerCatalog } from './api-response-pointers.js';
+import type { WorkflowDraftContext } from './workflow-draft.js';
+import type { WorkflowDraftApiResponseSource } from './workflow-draft-api-response-sources.js';
+import type { PlannedNativeNode } from './workflow-plan.js';
+import type { BindingSchema } from './api-bindings.js';
+import type { StagedWorkflowDraftEdit } from './workflow-draft-edit-assembly.js';
+export interface WorkflowDraftApiReferenceSource extends WorkflowDraftApiResponseSource {
+    kind: 'api';
+    responsePointerCatalog: ApiResponsePointerCatalog[];
+}
+export type WorkflowDraftReferenceSource = WorkflowDraftApiReferenceSource | {
+    kind: 'native';
+    nodeId: string;
+    schema: BindingSchema;
+    node: PlannedNativeNode;
+};
+export interface WorkflowDraftExclusiveOutputSource {
+    kind: 'exclusive-output';
+    nodeId: string;
+    node: PlannedNativeNode;
+    outputPorts: string[];
+}
+export interface DescribeWorkflowDraftReferenceSourcesInput {
+    stage: StagedWorkflowDraftEdit;
+    context: WorkflowDraftContext;
+    excludedNodeIds: string[];
+}
+export interface WorkflowDraftReferenceSources {
+    values: WorkflowDraftReferenceSource[];
+    exclusiveOutputs: WorkflowDraftExclusiveOutputSource[];
+}

package/dist/types/workflow-draft-reference-sources.js

@@ -0,0 +1 @@
+export {};

package/dist/types/workflow-draft-requirement-edit.d.ts

@@ -0,0 +1,18 @@
+import type { WorkflowDraftRequirement } from './workflow-draft.js';
+import type { ValidateWorkflowDraftEditPlanInput } from './workflow-draft-edit.js';
+import type { WorkflowDraftEditResolution } from './workflow-draft-edit-assembly.js';
+import type { WorkflowDraftSelectedNode } from './workflow-draft-selected-nodes.js';
+export interface WorkflowDraftRequirementEditInput extends ValidateWorkflowDraftEditPlanInput {
+    stepId: string;
+}
+export interface WorkflowDraftRequirementEditDescription {
+    action: 'revise' | 'restore';
+    planId: string;
+    baseRevision: number;
+    stepId: string;
+    requirement: WorkflowDraftRequirement;
+    nodes: WorkflowDraftSelectedNode[];
+}
+export type WorkflowDraftRequirementAnswer = Pick<Extract<WorkflowDraftEditResolution, {
+    kind: 'requirement';
+}>, 'answerMessageId' | 'text' | 'state' | 'scope'>;

package/dist/types/workflow-draft-requirement-edit.js

@@ -0,0 +1 @@
+export {};

package/dist/types/workflow-draft-requirement-history.d.ts

@@ -0,0 +1,47 @@
+import type { WorkflowMessageEvidence } from './planning-evidence.js';
+import type { WorkflowDraftRequirement, WorkflowSourceMessage, WorkflowDraftContext } from './workflow-draft.js';
+import type { PrepareWorkflowDraftEditInput } from './workflow-draft-edit-assembly.js';
+export interface WorkflowDraftEditCandidateContextInput<Context extends WorkflowDraftContext> extends Omit<PrepareWorkflowDraftEditInput, 'context'> {
+    context: Context;
+}
+export type WorkflowDraftEditCandidateContext<Context extends WorkflowDraftContext> = Omit<Context, 'messages' | 'planningMessageIds'> & Pick<WorkflowDraftContext, 'messages' | 'planningMessageIds'>;
+export interface WorkflowDraftRequirementHistoryFields {
+    id: string;
+    revision: number;
+    requirementId: string;
+    previousEntryId?: string;
+    evidence: WorkflowMessageEvidence[];
+}
+export type WorkflowDraftRequirementHistoryEntry = WorkflowDraftRequirementHistoryFields & ({
+    kind: 'created' | 'restored';
+    after: WorkflowDraftRequirement;
+} | {
+    kind: 'revised';
+    before: WorkflowDraftRequirement;
+    after: WorkflowDraftRequirement;
+} | {
+    kind: 'removed';
+    before: WorkflowDraftRequirement;
+});
+export interface AppendWorkflowDraftRequirementHistoryInput {
+    draftId: string;
+    revision: number;
+    history: WorkflowDraftRequirementHistoryEntry[];
+    before?: WorkflowDraftRequirement;
+    after?: WorkflowDraftRequirement;
+    sourceMessageIds: string[];
+    messages: WorkflowSourceMessage[];
+}
+export interface WorkflowDraftRequirementHistoryDescription {
+    draftId: string;
+    revision: number;
+    entries: WorkflowDraftRequirementHistoryEntry[];
+    current: {
+        requirementId: string;
+        entryId: string;
+    }[];
+    removed: {
+        requirementId: string;
+        entryId: string;
+    }[];
+}

package/dist/types/workflow-draft-requirement-history.js

@@ -0,0 +1 @@
+export {};

package/dist/types/workflow-draft-selected-nodes.d.ts

@@ -0,0 +1,20 @@
+import type { ApiOperationContract } from './api-operation.js';
+/** Selected identity and original contract, not executable parameters or readiness. */
+export interface WorkflowDraftSelectedApiNode {
+    id: string;
+    kind: 'api';
+    operation: ApiOperationContract;
+    instruction?: string;
+}
+export interface WorkflowDraftSelectedNativeNode {
+    id: string;
+    kind: 'native';
+    capability: string;
+    instruction?: string;
+}
+export type WorkflowDraftSelectedNode = WorkflowDraftSelectedApiNode | WorkflowDraftSelectedNativeNode | WorkflowDraftSelectedGapNode;
+export interface WorkflowDraftSelectedGapNode {
+    id: string;
+    kind: 'capability-gap';
+    instruction: string;
+}

package/dist/types/workflow-draft-selected-nodes.js

@@ -0,0 +1 @@
+export {};

package/dist/types/workflow-draft-source-evidence.d.ts

@@ -0,0 +1,30 @@
+import type { WorkflowDraftReferenceSources } from './workflow-draft-reference-sources.js';
+import type { WorkflowSourceMessage } from './workflow-draft.js';
+import type { WorkflowCapability } from './workflow-plan.js';
+import type { WorkflowMessageEvidence, WorkflowPlanningEvidence } from './planning-evidence.js';
+import type { WorkflowDecisionExplanation } from './workflow-clarification.js';
+export type WorkflowDraftSourceEvidence = {
+    kind: 'message';
+    messageId: string;
+} | {
+    kind: 'source';
+    nodeId: string;
+};
+export interface ProposedWorkflowDraftSourceEvidence {
+    sourceMessageIds: string[];
+    explanation?: WorkflowDecisionExplanation<WorkflowDraftSourceEvidence>;
+}
+export interface WorkflowDraftSourceEvidenceDescription {
+    sources: WorkflowDraftReferenceSources;
+    messages: WorkflowSourceMessage[];
+    includeExplanations: boolean;
+}
+export interface ResolvedWorkflowDraftSourceEvidence {
+    sources: WorkflowMessageEvidence[];
+    explanation?: WorkflowDecisionExplanation<WorkflowPlanningEvidence>;
+}
+export interface ResolveWorkflowDraftSourceEvidenceInput {
+    decision: ProposedWorkflowDraftSourceEvidence;
+    description: WorkflowDraftSourceEvidenceDescription;
+    capabilities: WorkflowCapability[];
+}

package/dist/types/workflow-draft-source-evidence.js

@@ -0,0 +1 @@
+export {};

package/dist/types/workflow-draft-terminal-removal.d.ts

@@ -0,0 +1,16 @@
+import type { PrepareWorkflowDraftEditInput, WorkflowDraftEditConnectionChange, AssembledWorkflowDraftEdit } from './workflow-draft-edit-assembly.js';
+export type WorkflowDraftTerminalRemovalInput = PrepareWorkflowDraftEditInput;
+/** Code-owned structural proof; never a model proposal or a human approval. */
+export interface WorkflowDraftTerminalRemoval {
+    kind: 'terminal-node-removal';
+    fingerprint: string;
+    removedNodeIds: string[];
+    connections: WorkflowDraftEditConnectionChange[];
+    candidate: AssembledWorkflowDraftEdit;
+}
+export type WorkflowDraftTerminalRemovalResult = {
+    status: 'not-applicable';
+} | {
+    status: 'ready';
+    result: WorkflowDraftTerminalRemoval;
+};

package/dist/types/workflow-draft-terminal-removal.js

@@ -0,0 +1 @@
+export {};

package/dist/types/workflow-draft.d.ts

@@ -0,0 +1,108 @@
+import type { ApiOperationContract } from './api-operation.js';
+import type { ApiOperationKey } from './api-catalog.js';
+import type { ApiArgumentValues, OutputBinding } from './api-arguments.js';
+import type { WorkflowCapability, PlannedNativeNode, WorkflowPlanEdge } from './workflow-plan.js';
+import type { DeferredApiInputMaterial, DeferredApiInputSlot } from './deferred-api-inputs.js';
+import type { NativeRuntimeInputSlot, WorkflowRuntimeInputSlot } from './native-runtime-inputs.js';
+import type { WorkflowDraftClarification, WorkflowDraftRequirementOrigin } from './workflow-draft-clarification.js';
+import type { WorkflowEntryPointContract } from './planning-evidence.js';
+import type { WorkflowDraftRequirementHistoryEntry } from './workflow-draft-requirement-history.js';
+import type { WorkflowDraftCapabilityGap } from './workflow-draft-capability-gap.js';
+export interface WorkflowDraftApiCall {
+    id: string;
+    requestedInputs?: string[];
+    operation: ApiOperationKey;
+    values: ApiArgumentValues;
+    bindings: OutputBinding[];
+    requestMediaType?: string;
+}
+export type WorkflowDraftNode = WorkflowDraftApiCall | PlannedNativeNode | WorkflowDraftCapabilityGap;
+export type WorkflowDraftScope = {
+    kind: 'workflow';
+} | {
+    kind: 'nodes';
+    nodeIds: string[];
+};
+export interface WorkflowDraftRequirement {
+    id: string;
+    text: string;
+    state: 'confirmed' | 'needs-clarification' | 'deferred';
+    scope: WorkflowDraftScope;
+    sourceMessageIds: string[];
+    /** Creation lineage; current sources and code-owned requirementHistory retain later revisions separately. */
+    origin?: WorkflowDraftRequirementOrigin;
+}
+export interface WorkflowSourceMessage {
+    id: string;
+    text: string;
+}
+export interface WorkflowDraftApproval {
+    id: string;
+    revision: number;
+    nodeIds: string[];
+    invalidatedNodeIds: string[];
+}
+export interface WorkflowDraftContent {
+    id: string;
+    requirements: WorkflowDraftRequirement[];
+    apiCalls: WorkflowDraftApiCall[];
+    nativeNodes: PlannedNativeNode[];
+    /** Explicit unresolved roles, not native capabilities or fabricated OAS operations. */
+    gapNodes?: WorkflowDraftCapabilityGap[];
+    edges: WorkflowPlanEdge[];
+}
+export interface WorkflowDraft extends WorkflowDraftContent {
+    revision: number;
+    approvals: WorkflowDraftApproval[];
+    requirementHistory: WorkflowDraftRequirementHistoryEntry[];
+}
+export interface WorkflowDraftContext {
+    operations: ApiOperationContract[];
+    capabilities: WorkflowCapability[];
+    messages: WorkflowSourceMessage[];
+    /** Explicit active evidence view. Omission permits all supplied messages, including caller-owned history. */
+    planningMessageIds?: string[];
+    entrypoint?: WorkflowEntryPointContract;
+    clarification?: WorkflowDraftClarification;
+}
+export interface CreateWorkflowDraftInput {
+    content: WorkflowDraftContent;
+    context: WorkflowDraftContext;
+}
+export interface WorkflowDraftInput {
+    draft: WorkflowDraft;
+    context: WorkflowDraftContext;
+}
+export interface ResolveWorkflowDraftApiMaterialsInput {
+    content: WorkflowDraftContent;
+    context: WorkflowDraftContext;
+}
+export interface WorkflowDraftMaterials {
+    materials: DeferredApiInputMaterial[];
+    slots: DeferredApiInputSlot[];
+    nativeSlots: NativeRuntimeInputSlot[];
+}
+export interface WorkflowDraftNodeReadiness {
+    nodeId: string;
+    planningStatus: 'ready' | 'blocked-by-decision' | 'blocked-by-capability';
+    requestInputStatus: 'ready' | 'needs-input' | 'blocked-by-decision' | 'blocked-by-capability';
+    runtimeInputStatus: 'ready' | 'needs-input' | 'blocked-by-decision' | 'blocked-by-capability';
+    blockingGapNodeIds?: string[];
+    unresolvedRequirementIds: string[];
+    inputSlotIds: string[];
+    dependencyNodeIds: string[];
+    reviewed: boolean;
+}
+export interface WorkflowDraftReadiness {
+    designReady: boolean;
+    requestInputsReady: boolean;
+    nativeInputsReady: boolean;
+    runtimeInputsReady: boolean;
+    reviewed: boolean;
+    nodes: WorkflowDraftNodeReadiness[];
+    slots: WorkflowRuntimeInputSlot[];
+}
+export interface ApproveWorkflowDraftInput extends WorkflowDraftInput {
+    expectedRevision: number;
+    nodeIds: string[];
+}

package/dist/types/workflow-draft.js

@@ -0,0 +1 @@
+export {};