@openapi-flow/core 0.2.0 → 0.3.0

package/dist/types/workflow-draft-api-input-edit.d.ts

@@ -0,0 +1,91 @@
+import type { z } from 'zod';
+import type { JsonValue } from './api-arguments.js';
+import type { BindingSchema, ApiBindingMaterial } from './api-bindings.js';
+import type { WorkflowMessageEvidence } from './planning-evidence.js';
+import type { WorkflowDecisionExplanation } from './workflow-clarification.js';
+import type { ValidateWorkflowDraftEditPlanInput } from './workflow-draft-edit.js';
+import type { WorkflowDraftEditResolution } from './workflow-draft-edit-assembly.js';
+import type { WorkflowDraftApiCall, WorkflowSourceMessage } from './workflow-draft.js';
+import type { JsonObject } from './openapi.js';
+import type { ApiInputLiteralSource } from './api-input-literal-source.js';
+export interface WorkflowDraftApiInputEditMaterial extends ApiBindingMaterial {
+    requestedInputs?: string[];
+}
+export interface WorkflowDraftApiInputEditInput extends ValidateWorkflowDraftEditPlanInput {
+    stepId: string;
+    /** Omission preserves the call's explicit existing media selection. */
+    requestMediaType?: string;
+}
+export interface ProposedWorkflowDraftApiInputEditTarget {
+    kind: 'set' | 'remove';
+    pointer: string;
+    sources: WorkflowMessageEvidence[];
+    explanation?: WorkflowDecisionExplanation<WorkflowMessageEvidence>;
+}
+export interface WorkflowDraftApiInputEditProposal {
+    targets: ProposedWorkflowDraftApiInputEditTarget[];
+}
+export type WorkflowDraftApiInputEditTarget = Omit<ProposedWorkflowDraftApiInputEditTarget, 'kind'> & {
+    id: string;
+} & ({
+    kind: 'set';
+    schema: BindingSchema;
+} | {
+    kind: 'remove';
+});
+export interface WorkflowDraftApiInputEditDescription {
+    stepId: string;
+    instruction: string;
+    call: WorkflowDraftApiCall;
+    requestSchema: JsonObject;
+    messages: WorkflowSourceMessage[];
+    includeExplanations: boolean;
+}
+export interface CreateWorkflowDraftApiInputEditContractInput extends WorkflowDraftApiInputEditInput {
+    proposal: WorkflowDraftApiInputEditProposal;
+}
+export interface WorkflowDraftApiInputEditContract {
+    id: string;
+    planId: string;
+    stepId: string;
+    nodeId: string;
+    /** Shared original request resource; field schemas refer to it, never duplicate it. */
+    schemaResource: BindingSchema;
+    targets: WorkflowDraftApiInputEditTarget[];
+    requestMediaType?: string;
+}
+export interface WorkflowDraftApiInputEditContractInput extends WorkflowDraftApiInputEditInput {
+    contract: WorkflowDraftApiInputEditContract;
+}
+export interface WorkflowDraftApiInputEditValueSource extends ApiInputLiteralSource {
+    messageId: string;
+}
+export type WorkflowDraftApiInputEditValue = ({
+    status: 'provided';
+    value: JsonValue;
+    source: WorkflowDraftApiInputEditValueSource;
+} | {
+    status: 'needs-input';
+}) & {
+    explanation?: WorkflowDecisionExplanation<WorkflowMessageEvidence>;
+};
+export interface WorkflowDraftApiInputEditValues {
+    values: Record<string, WorkflowDraftApiInputEditValue>;
+}
+export interface ResolveWorkflowDraftApiInputEditsInput extends WorkflowDraftApiInputEditContractInput {
+    output: WorkflowDraftApiInputEditValues;
+}
+export type WorkflowDraftApiInputEditResult = {
+    status: 'ready';
+    contractId: string;
+    values: WorkflowDraftApiInputEditValues;
+    resolution: Extract<WorkflowDraftEditResolution, {
+        kind: 'api-inputs';
+    }>;
+} | {
+    status: 'needs-input';
+    contractId: string;
+    values: WorkflowDraftApiInputEditValues;
+    pendingTargets: WorkflowDraftApiInputEditTarget[];
+};
+export type WorkflowDraftApiInputEditValuesSchema = z.ZodType<WorkflowDraftApiInputEditValues>;

package/dist/types/workflow-draft-api-input-edit.js

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

package/dist/types/workflow-draft-api-literal-sources.d.ts

@@ -0,0 +1,14 @@
+import type { ApiInputLiteralSource } from './api-input-literal-source.js';
+import type { ApiInputAnswerSourceLocation } from './api-input-answer-extraction.js';
+import type { WorkflowDraftApiCallPlanningDescription, WorkflowDraftApiCallArgumentsProposal } from './workflow-draft-api-call-planning.js';
+export interface WorkflowDraftApiLiteralSource extends ApiInputLiteralSource {
+    targetPointer: string;
+    messageId: string;
+}
+export interface VerifiedWorkflowDraftApiLiteralSource extends WorkflowDraftApiLiteralSource {
+    occurrences: ApiInputAnswerSourceLocation[];
+}
+export interface ResolveWorkflowDraftApiLiteralSourcesInput {
+    description: WorkflowDraftApiCallPlanningDescription;
+    proposal: WorkflowDraftApiCallArgumentsProposal;
+}

package/dist/types/workflow-draft-api-literal-sources.js

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

package/dist/types/workflow-draft-api-response-sources.d.ts

@@ -0,0 +1,26 @@
+import type { ApiOperationContract } from './api-operation.js';
+import type { WorkflowDraftApiCall, WorkflowDraftContent, WorkflowDraftContext } from './workflow-draft.js';
+import type { WorkflowDraftEditPlan } from './workflow-draft-edit.js';
+export interface PlannedWorkflowDraftApiSourceRequest {
+    status: 'request-planned';
+    request: WorkflowDraftApiCall;
+}
+export interface PendingWorkflowDraftApiSourceRequest {
+    status: 'request-pending';
+    stepId: string;
+    kind: 'add-api-call' | 'replace-api-operation';
+    instruction: string;
+}
+export type WorkflowDraftApiSourcePreparation = PlannedWorkflowDraftApiSourceRequest | PendingWorkflowDraftApiSourceRequest;
+/** An original selected response contract, not a fabricated request or execution receipt. */
+export interface WorkflowDraftApiResponseSource {
+    nodeId: string;
+    operation: ApiOperationContract;
+    preparation: WorkflowDraftApiSourcePreparation;
+}
+export interface ResolveWorkflowDraftApiResponseSourcesInput {
+    content: WorkflowDraftContent;
+    context: WorkflowDraftContext;
+    plan: WorkflowDraftEditPlan;
+    pendingResolutionStepIds: string[];
+}

package/dist/types/workflow-draft-api-response-sources.js

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

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

@@ -0,0 +1,54 @@
+import type { ApiOperationKey } from './api-catalog.js';
+import type { WorkflowDraftContext } from './workflow-draft.js';
+import type { WorkflowMessageEvidence } from './planning-evidence.js';
+/** A scoped planning finding, never proof that no API exists outside supplied contracts. */
+export type WorkflowDraftCapabilityGapFinding<Operation = ApiOperationKey> = {
+    kind: 'missing-api';
+    reason: string;
+} | {
+    kind: 'api-contract-gap';
+    operation: Operation;
+    reason: string;
+} | {
+    kind: 'unsupported-native';
+    reason: string;
+};
+export interface WorkflowDraftGapCapabilityFingerprint {
+    name: string;
+    fingerprint: string;
+}
+export interface WorkflowDraftGapInventory {
+    operations: ApiOperationKey[];
+    capabilities: WorkflowDraftGapCapabilityFingerprint[];
+}
+export interface WorkflowDraftCapabilityGap {
+    id: string;
+    requestedBehavior: string;
+    finding: WorkflowDraftCapabilityGapFinding;
+    sources: WorkflowMessageEvidence[];
+    inventory: WorkflowDraftGapInventory;
+    fingerprint: string;
+}
+export interface CreateWorkflowDraftCapabilityGapInput {
+    id: string;
+    requestedBehavior: string;
+    finding: WorkflowDraftCapabilityGapFinding;
+    sourceMessageIds: string[];
+    context: WorkflowDraftContext;
+}
+export interface InspectWorkflowDraftCapabilityGapInput {
+    gap: WorkflowDraftCapabilityGap;
+    context: WorkflowDraftContext;
+}
+export interface WorkflowDraftCapabilityGapInspection {
+    inventoryCurrent: boolean;
+}
+export interface WorkflowDraftCapabilityGapDescription extends WorkflowDraftCapabilityGapInspection {
+    id: string;
+    requestedBehavior: string;
+    finding: WorkflowDraftCapabilityGapFinding;
+}
+/** Control-flow placeholder only: it declares no API response or native value output. */
+export interface WorkflowUnresolvedNode {
+    id: string;
+}

package/dist/types/workflow-draft-capability-gap.js

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

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

@@ -0,0 +1,62 @@
+import type { PlannedNativeNode, WorkflowPlanEdge } from './workflow-plan.js';
+import type { WorkflowDraftCapabilityGap } from './workflow-draft-capability-gap.js';
+import type { WorkflowDraft, WorkflowDraftContent, WorkflowDraftApiCall, WorkflowDraftContext, WorkflowDraftRequirement } from './workflow-draft.js';
+export type WorkflowDraftChange = {
+    kind: 'add-api-call';
+    call: WorkflowDraftApiCall;
+} | {
+    kind: 'update-api-call';
+    call: WorkflowDraftApiCall;
+} | {
+    kind: 'add-native-node';
+    node: PlannedNativeNode;
+} | {
+    kind: 'update-native-node';
+    node: PlannedNativeNode;
+} | {
+    kind: 'add-capability-gap';
+    node: WorkflowDraftCapabilityGap;
+} | {
+    kind: 'remove-node';
+    nodeId: string;
+} | {
+    kind: 'add-edge';
+    edge: WorkflowPlanEdge;
+} | {
+    kind: 'remove-edge';
+    edge: WorkflowPlanEdge;
+} | {
+    kind: 'set-requirement';
+    requirement: WorkflowDraftRequirement;
+} | {
+    kind: 'remove-requirement';
+    requirementId: string;
+    sourceMessageIds: string[];
+};
+export interface DraftChangeSet {
+    baseRevision: number;
+    changes: WorkflowDraftChange[];
+}
+export interface DraftChangeImpact {
+    changedNodeIds: string[];
+    addedNodeIds: string[];
+    removedNodeIds: string[];
+    affectedNodeIds: string[];
+    preservedNodeIds: string[];
+    changedRequirementIds: string[];
+    invalidatedApprovalIds: string[];
+}
+export interface AnalyzeDraftChangeImpactInput {
+    before: WorkflowDraft;
+    after: WorkflowDraftContent;
+    context: WorkflowDraftContext;
+}
+export interface ApplyDraftChangeSetInput {
+    draft: WorkflowDraft;
+    changeSet: DraftChangeSet;
+    context: WorkflowDraftContext;
+}
+export interface ApplyDraftChangeSetResult {
+    draft: WorkflowDraft;
+    impact: DraftChangeImpact;
+}

package/dist/types/workflow-draft-changes.js

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

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

@@ -0,0 +1,35 @@
+import type { WorkflowDraftScope } from './workflow-draft.js';
+import type { WorkflowPlanningEvidence } from './planning-evidence.js';
+import type { ValidateWorkflowDraftEditPlanInput, WorkflowDraftEditDecision, WorkflowDraftEditDecisionFields } from './workflow-draft-edit.js';
+export type WorkflowDraftClarificationPlanningStage = 'api-bindings' | 'api-arguments' | 'native-parameters' | 'requirements' | 'connections';
+export type WorkflowDraftClarificationOwner = {
+    kind: 'semantic';
+    scope: WorkflowDraftScope;
+} | {
+    kind: 'planning-step';
+    decisionIndex: number;
+    stage: WorkflowDraftClarificationPlanningStage;
+};
+export interface ResolveWorkflowDraftClarificationOwnerIndexInput {
+    decisions: WorkflowDraftEditDecision[];
+    sourceIndex: number;
+}
+export type ResolvedWorkflowDraftClarificationOwner = {
+    kind: 'semantic';
+    scope: WorkflowDraftScope;
+} | {
+    kind: 'planning-step';
+    stepId: string;
+    nodeId?: string;
+    stage: WorkflowDraftClarificationPlanningStage;
+};
+export interface WorkflowDraftClarificationOwnership extends WorkflowDraftEditDecisionFields<WorkflowPlanningEvidence> {
+    sourceStepId: string;
+    owner: ResolvedWorkflowDraftClarificationOwner;
+}
+export interface DescribeWorkflowDraftClarificationOwnershipInput extends ValidateWorkflowDraftEditPlanInput {
+    /** Omission describes the whole plan. Supplying an ID selects only that actual owner/source step. */
+    stepId?: string;
+    /** Only concerns owned by this exact stage; earlier unresolved-intent text is not replay authority. */
+    stage?: WorkflowDraftClarificationPlanningStage;
+}

package/dist/types/workflow-draft-clarification-ownership.js

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

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

@@ -0,0 +1,64 @@
+import type { WorkflowClarificationRound, WorkflowClarificationResolution, WorkflowRequirementFact, WorkflowClarificationQuestion, WorkflowDecisionExplanation } from './workflow-clarification.js';
+import type { WorkflowPlanningContext, WorkflowMessageEvidence } from './planning-evidence.js';
+import type { WorkflowDraftEditInput, WorkflowDraftEditPlan } from './workflow-draft-edit.js';
+import type { WorkflowSourceMessage, WorkflowDraftScope, WorkflowDraftRequirement } from './workflow-draft.js';
+import type { WorkflowDraftSelectedNode } from './workflow-draft-selected-nodes.js';
+export interface WorkflowDraftClarification {
+    round: WorkflowClarificationRound;
+    resolution: WorkflowClarificationResolution;
+    /** Code-derived evidence receipts for explicit replies, not raw user prose or a model summary. */
+    answerMessages: WorkflowSourceMessage[];
+    /** Verified explicit answers only. Deferral is evidence, but never a confirmed requirement. */
+    confirmedAnswerMessageIds: string[];
+}
+export interface PrepareWorkflowDraftClarificationInput {
+    context: WorkflowPlanningContext;
+    round: WorkflowClarificationRound;
+    resolution: WorkflowClarificationResolution;
+}
+export interface WorkflowDraftClarificationDescription {
+    roundId: string;
+    facts: WorkflowRequirementFact[];
+    pendingQuestions: WorkflowClarificationQuestion[];
+    deferredQuestions: WorkflowClarificationQuestion[];
+    requirementsPrompt: string;
+    answerMessageIds: string[];
+    confirmedAnswerMessageIds: string[];
+}
+export interface WorkflowDraftRequirementOrigin {
+    kind: 'clarification-fact' | 'clarification-question';
+    roundId: string;
+    sourceId: string;
+}
+export interface WorkflowDraftClarificationScopeInput extends WorkflowDraftEditInput {
+    plan: WorkflowDraftEditPlan;
+}
+export type WorkflowDraftClarificationRequirement = Omit<WorkflowDraftRequirement, 'scope'>;
+export interface WorkflowDraftClarificationScopeDescription {
+    fingerprint: string;
+    requirements: WorkflowDraftClarificationRequirement[];
+    nodes: WorkflowDraftSelectedNode[];
+    messages: WorkflowSourceMessage[];
+    includeExplanations: boolean;
+}
+export interface ProposedWorkflowDraftClarificationScope {
+    scope: WorkflowDraftScope | WorkflowDraftUnselectedClarificationScope;
+    explanation?: WorkflowDecisionExplanation<WorkflowMessageEvidence>;
+}
+export interface WorkflowDraftUnselectedClarificationScope {
+    kind: 'unselected-work';
+}
+export interface WorkflowDraftClarificationScopeProposal {
+    scopes: Record<string, ProposedWorkflowDraftClarificationScope>;
+}
+export interface ResolveWorkflowDraftClarificationScopesInput extends WorkflowDraftClarificationScopeInput {
+    fingerprint: string;
+    proposal: WorkflowDraftClarificationScopeProposal;
+}
+export interface ResolvedWorkflowDraftClarificationScopes {
+    fingerprint: string;
+    proposal: WorkflowDraftClarificationScopeProposal;
+    requirements: WorkflowDraftRequirement[];
+    /** Unresolved questions about work that has no selected instance. These never block unrelated nodes or count as completed. */
+    unselectedQuestionIds: string[];
+}

package/dist/types/workflow-draft-clarification.js

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

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

@@ -0,0 +1,96 @@
+import type { PrepareWorkflowDraftEditInput, StagedWorkflowDraftEdit, WorkflowDraftEditConnectionChange, AssembledWorkflowDraftEdit } from './workflow-draft-edit-assembly.js';
+import type { WorkflowDraftEditStep } from './workflow-draft-edit.js';
+import type { WorkflowSourceMessage } from './workflow-draft.js';
+import type { WorkflowPlanEdge, WorkflowPlanNodeContract } from './workflow-plan.js';
+import type { WorkflowMessageEvidence } from './planning-evidence.js';
+import type { WorkflowDecisionExplanation } from './workflow-clarification.js';
+import type { ApiOperationContract } from './api-operation.js';
+import type { WorkflowDraftApiCall } from './workflow-draft.js';
+export type WorkflowDraftConnectionEditInput = PrepareWorkflowDraftEditInput;
+/** A single ready instance cannot have a non-cyclic inter-instance edge. */
+export interface WorkflowDraftSingleNodeConnectionProof {
+    kind: 'single-node-dag';
+    nodeId: string;
+}
+export interface WorkflowDraftConnectionEditDescriptionFields {
+    fingerprint: string;
+    stage: StagedWorkflowDraftEdit;
+    steps: WorkflowDraftEditStep[];
+    messages: WorkflowSourceMessage[];
+    backgroundMessages: WorkflowSourceMessage[];
+    includeExplanations: boolean;
+    structuralProof?: WorkflowDraftSingleNodeConnectionProof;
+}
+export interface WorkflowDraftConnectionEditEdge {
+    id: string;
+    edge: WorkflowPlanEdge;
+    editable: boolean;
+}
+export type WorkflowDraftConnectionEditDescription = WorkflowDraftConnectionEditDescriptionFields & ({
+    status: 'not-required' | 'waiting-for-materials';
+} | {
+    status: 'ready';
+    contracts: WorkflowPlanNodeContract[];
+    apiInstances: WorkflowDraftConnectionEditApiInstance[];
+    affectedNodeIds: string[];
+    existingEdges: WorkflowDraftConnectionEditEdge[];
+});
+export type ReadyWorkflowDraftConnectionEditDescription = Extract<WorkflowDraftConnectionEditDescription, {
+    status: 'ready';
+}>;
+export interface WorkflowDraftConnectionEditEndpoint {
+    nodeId: string;
+    port: string;
+}
+export interface WorkflowDraftConnectionEditApiInstance {
+    nodeId: string;
+    method: ApiOperationContract['method'];
+    path: string;
+    summary?: string;
+    values: WorkflowDraftApiCall['values'];
+    bindings: WorkflowDraftApiCall['bindings'];
+}
+export type ProposedWorkflowDraftConnectionEdit = {
+    sources: WorkflowMessageEvidence[];
+    explanation?: WorkflowDecisionExplanation<WorkflowMessageEvidence>;
+} & ({
+    kind: 'add';
+    source: WorkflowDraftConnectionEditEndpoint;
+    target: WorkflowDraftConnectionEditEndpoint;
+} | {
+    kind: 'remove';
+    edgeId: string;
+} | {
+    kind: 'keep-connections';
+} | {
+    kind: 'needs-clarification';
+    message: string;
+});
+export interface WorkflowDraftConnectionEditProposal {
+    decisions: ProposedWorkflowDraftConnectionEdit[];
+}
+export interface ResolveWorkflowDraftConnectionEditInput extends WorkflowDraftConnectionEditInput {
+    fingerprint: string;
+    proposal: WorkflowDraftConnectionEditProposal;
+}
+export interface WorkflowDraftConnectionEditQuestion {
+    id: string;
+    message: string;
+    sources: WorkflowMessageEvidence[];
+    explanation?: WorkflowDecisionExplanation<WorkflowMessageEvidence>;
+}
+export interface WorkflowDraftConnectionEditResultFields {
+    fingerprint: string;
+    proposal: WorkflowDraftConnectionEditProposal;
+}
+export type WorkflowDraftConnectionEditResult = {
+    status: 'not-required' | 'waiting-for-materials';
+    description: WorkflowDraftConnectionEditDescription;
+} | (WorkflowDraftConnectionEditResultFields & ({
+    status: 'ready';
+    connections: WorkflowDraftEditConnectionChange[];
+    candidate: AssembledWorkflowDraftEdit;
+} | {
+    status: 'needs-clarification';
+    questions: WorkflowDraftConnectionEditQuestion[];
+}));

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

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

package/dist/types/workflow-draft-edit-assembly-internal.d.ts

@@ -0,0 +1,23 @@
+import type { JsonValue } from './api-arguments.js';
+import type { WorkflowDraftChange } from './workflow-draft-changes.js';
+import type { WorkflowDraft, WorkflowDraftContent, WorkflowDraftContext } from './workflow-draft.js';
+import type { WorkflowDraftEditPlan } from './workflow-draft-edit.js';
+import type { PreparedWorkflowDraftEdit, WorkflowDraftValueEdit } from './workflow-draft-edit-assembly.js';
+export interface PrimaryWorkflowDraftEdit extends PreparedWorkflowDraftEdit {
+    changes: WorkflowDraftChange[];
+    pendingResolutionStepIds: string[];
+}
+export type WorkflowDraftEditPreparationMode = 'complete' | 'staged';
+export interface InspectWorkflowDraftEditRepairsInput {
+    before: WorkflowDraft;
+    content: WorkflowDraftContent;
+    context: WorkflowDraftContext;
+    plan: WorkflowDraftEditPlan;
+    acknowledgedTaskIds: Set<string>;
+    pendingResolutionStepIds: string[];
+}
+export interface ApplyWorkflowDraftValueEditsInput {
+    value: JsonValue;
+    edits: WorkflowDraftValueEdit[];
+    source: string;
+}

package/dist/types/workflow-draft-edit-assembly-internal.js

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

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

@@ -0,0 +1,146 @@
+import type { ApiArgumentValues, JsonValue, JsonValueObject, OutputBinding } from './api-arguments.js';
+import type { DraftChangeSet, ApplyDraftChangeSetResult } from './workflow-draft-changes.js';
+import type { WorkflowDraft, WorkflowDraftContent, WorkflowDraftRequirement } from './workflow-draft.js';
+import type { WorkflowDraftEditInput, WorkflowDraftEditPlan } from './workflow-draft-edit.js';
+import type { WorkflowPlanEdge, NativeRuntimeParameterSelection } from './workflow-plan.js';
+import type { WorkflowDraftApiResponseSource } from './workflow-draft-api-response-sources.js';
+import type { ResolvedWorkflowDraftClarificationScopes } from './workflow-draft-clarification.js';
+import type { WorkflowDraftClarificationOwnership } from './workflow-draft-clarification-ownership.js';
+import type { WorkflowDraftNativeParameterChange } from './workflow-draft-native-parameter-edit.js';
+import type { WorkflowDraftNativeDependencies } from './workflow-draft-native-dependencies.js';
+export type WorkflowDraftValueEdit = {
+    kind: 'set';
+    pointer: string;
+    value: JsonValue;
+} | {
+    kind: 'remove';
+    pointer: string;
+};
+export type WorkflowDraftBindingEdit = {
+    kind: 'set';
+    binding: OutputBinding;
+} | {
+    kind: 'remove';
+    targetPointer: string;
+};
+export type WorkflowDraftEditResolution = {
+    stepId: string;
+    kind: 'api-call';
+    values: ApiArgumentValues;
+    requestedInputs?: string[];
+    bindings: OutputBinding[];
+    requestMediaType?: string;
+} | {
+    stepId: string;
+    kind: 'api-inputs';
+    edits: WorkflowDraftValueEdit[];
+    requestMediaType?: string;
+} | {
+    stepId: string;
+    kind: 'api-bindings';
+    edits: WorkflowDraftBindingEdit[];
+    valueEdits: WorkflowDraftValueEdit[];
+} | {
+    stepId: string;
+    kind: 'native-literal';
+    parameters: JsonValueObject;
+} | {
+    stepId: string;
+    kind: 'native-mixed';
+    parameters: JsonValueObject;
+    runtimeParameters: NativeRuntimeParameterSelection;
+} | {
+    stepId: string;
+    kind: 'native-parameters';
+    edits: WorkflowDraftNativeParameterChange[];
+} | {
+    stepId: string;
+    kind: 'native-runtime';
+} | {
+    stepId: string;
+    kind: 'requirement';
+    answerMessageId: string;
+    text: string;
+    state: WorkflowDraftRequirement['state'];
+    scope: WorkflowDraftRequirement['scope'];
+};
+export interface WorkflowDraftEditConnectionChange {
+    stepIds: string[];
+    kind: 'add-edge' | 'remove-edge';
+    edge: WorkflowPlanEdge;
+}
+export interface WorkflowDraftEditRepairTask {
+    id: string;
+    nodeId: string;
+    kind: 'api-bindings' | 'native-parameters';
+    sourceNodeIds: string[];
+    /** API repair edits may only change these existing binding targets. */
+    targetPointers: string[];
+}
+export type WorkflowDraftEditRepair = {
+    taskId: string;
+    kind: 'api-bindings';
+    edits: WorkflowDraftBindingEdit[];
+} | {
+    taskId: string;
+    kind: 'native-parameters';
+    edits: WorkflowDraftValueEdit[];
+};
+export interface PrepareWorkflowDraftEditInput extends WorkflowDraftEditInput {
+    plan: WorkflowDraftEditPlan;
+    resolutions: WorkflowDraftEditResolution[];
+    /** Omission means no explicitly completed dependency repairs. */
+    repairs?: WorkflowDraftEditRepair[];
+    /** Revalidated code-owned projection of the active clarified facts/questions onto actual instance scopes. */
+    clarificationScopes?: ResolvedWorkflowDraftClarificationScopes;
+    /** Optional original producer choice, revalidated at configuration and final assembly. */
+    producerDependencies?: WorkflowDraftNativeDependencies;
+}
+export interface AssembleWorkflowDraftEditInput extends PrepareWorkflowDraftEditInput {
+    /** Omission means preserve all existing connections unchanged. */
+    connections?: WorkflowDraftEditConnectionChange[];
+}
+export interface PreparedWorkflowDraftEdit {
+    kind: 'unvalidated-edit-materials';
+    planId: string;
+    baseRevision: number;
+    content: WorkflowDraftContent;
+    /** Already applied deterministic cleanup for explicitly removed nodes. Never a reconnect proposal. */
+    nodeRemovalConnections: WorkflowDraftEditConnectionChange[];
+    pendingRepairs: WorkflowDraftEditRepairTask[];
+    deferredRequirementIds: string[];
+    pendingClarificationQuestionIds: string[];
+}
+export interface StagedWorkflowDraftEdit {
+    kind: 'unvalidated-edit-stage';
+    fingerprint: string;
+    planId: string;
+    baseRevision: number;
+    content: WorkflowDraftContent;
+    nodeRemovalConnections: WorkflowDraftEditConnectionChange[];
+    pendingResolutionStepIds: string[];
+    /** Declared concerns and their verified owners, not answers or completed-stage assertions. */
+    clarificationOwnership: WorkflowDraftClarificationOwnership[];
+    /** Selected OAS response contracts are independent of request values/readiness. */
+    apiResponseSources: WorkflowDraftApiResponseSource[];
+    /** Unfinished primary materials/requirements. This does not erase a selected API response declaration. */
+    blockedSourceNodeIds: string[];
+    pendingRepairs: WorkflowDraftEditRepairTask[];
+    deferredRequirementIds: string[];
+    pendingClarificationQuestionIds: string[];
+}
+export interface ChangedWorkflowDraftEdit extends ApplyDraftChangeSetResult {
+    status: 'changed';
+    changeSet: DraftChangeSet;
+    deferredRequirementIds: string[];
+}
+export interface UnchangedWorkflowDraftEdit {
+    status: 'no-change';
+    draft: WorkflowDraft;
+}
+export type AssembledWorkflowDraftEdit = ChangedWorkflowDraftEdit | UnchangedWorkflowDraftEdit;
+export interface WorkflowDraftEditAssemblyFailure {
+    stage: 'dependency-repairs' | 'final-validation';
+    pendingRepairs?: WorkflowDraftEditRepairTask[];
+    changeSet?: DraftChangeSet;
+}

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

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