@openapi-flow/core 0.1.0 → 0.3.0

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 {};

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

@@ -0,0 +1,110 @@
+import type { z } from 'zod';
+import type { ApiOperationKey } from './api-catalog.js';
+import type { WorkflowDraft, WorkflowDraftInput, WorkflowDraftRequirement } from './workflow-draft.js';
+import type { WorkflowDraftClarificationOwner } from './workflow-draft-clarification-ownership.js';
+import type { WorkflowMessageEvidence, WorkflowPlanningContextDescription, WorkflowPlanningEvidence } from './planning-evidence.js';
+import type { WorkflowDecisionExplanation } from './workflow-clarification.js';
+import type { WorkflowDraftCapabilityGapFinding } from './workflow-draft-capability-gap.js';
+import type { WorkflowPlanNodeContract } from './workflow-plan.js';
+export interface WorkflowDraftEditOptions {
+    includeExplanations?: boolean;
+}
+export interface ResolvedWorkflowDraftEditOptions {
+    includeExplanations: boolean;
+}
+export interface WorkflowDraftEditDecisionFields<Evidence> {
+    instruction: string;
+    sources: WorkflowMessageEvidence[];
+    explanation?: WorkflowDecisionExplanation<Evidence>;
+}
+export type WorkflowDraftEditDecision<Operation = ApiOperationKey, Evidence = WorkflowPlanningEvidence> = WorkflowDraftEditDecisionFields<Evidence> & ({
+    kind: 'add-api-call';
+    operation: Operation;
+} | {
+    kind: 'replace-api-operation';
+    nodeId: string;
+    operation: Operation;
+} | {
+    kind: 'add-native-node';
+    capability: string;
+} | {
+    kind: 'report-capability-gap';
+    finding: WorkflowDraftCapabilityGapFinding<Operation>;
+} | {
+    kind: 'revise-api-inputs' | 'revise-api-bindings';
+    nodeId: string;
+} | {
+    kind: 'revise-native-node';
+    nodeId: string;
+} | {
+    kind: 'remove-node';
+    nodeId: string;
+} | {
+    kind: 'revise-connections';
+    nodeIds: string[];
+} | {
+    kind: 'revise-requirement' | 'remove-requirement' | 'restore-requirement';
+    requirementId: string;
+} | {
+    kind: 'needs-clarification';
+    owner: WorkflowDraftClarificationOwner;
+} | {
+    kind: 'no-change';
+});
+export interface WorkflowDraftEditProposal<Operation = ApiOperationKey, Evidence = WorkflowPlanningEvidence> {
+    decisions: WorkflowDraftEditDecision<Operation, Evidence>[];
+}
+export interface WorkflowDraftEditInput extends WorkflowDraftInput {
+    /** The current edit request, not arbitrary earlier accepted conversation turns. */
+    requestMessageIds: string[];
+}
+export interface WorkflowDraftEditContextDescription {
+    draft: WorkflowDraft;
+    /** Code-derived actual ports, references and join semantics; not model-owned output. */
+    nodeContracts: WorkflowPlanNodeContract[];
+    nodeContractsFingerprint: string;
+    /** Latest removed heads only, supplied as reference choices, never replacement values. */
+    removedRequirements: WorkflowDraftRequirement[];
+    planning: WorkflowPlanningContextDescription;
+    requestMessageIds: string[];
+    draftFingerprint: string;
+    contextFingerprint: string;
+}
+export type WorkflowDraftEditStage = 'requirements' | 'resolve-contracts' | 'native-parameters' | 'api-bindings' | 'api-arguments' | 'connections' | 'clarification';
+export interface WorkflowDraftEditStep {
+    id: string;
+    decision: WorkflowDraftEditDecision;
+    /** Allocated by code only for a new API/native instance. */
+    newNodeId?: string;
+    stages: WorkflowDraftEditStage[];
+}
+export interface WorkflowDraftEditPlan {
+    id: string;
+    draftId: string;
+    baseRevision: number;
+    draftFingerprint: string;
+    contextFingerprint: string;
+    nodeContractsFingerprint: string;
+    requestMessageIds: string[];
+    options: ResolvedWorkflowDraftEditOptions;
+    status: 'ready-for-planning' | 'needs-clarification' | 'no-change';
+    steps: WorkflowDraftEditStep[];
+}
+export interface CreateWorkflowDraftEditPlanInput extends WorkflowDraftEditInput {
+    options?: WorkflowDraftEditOptions;
+    proposal: WorkflowDraftEditProposal;
+}
+export interface ValidateWorkflowDraftEditPlanInput extends WorkflowDraftEditInput {
+    plan: WorkflowDraftEditPlan;
+}
+export interface WorkflowDraftEditSchemaSources<Operation, Evidence> {
+    operationSchema?: z.ZodType<Operation>;
+    apiNodeIds: string[];
+    nativeNodeIds: string[];
+    gapNodeIds?: string[];
+    capabilityNames: string[];
+    requirementIds: string[];
+    removedRequirementIds: string[];
+    messageSchema: z.ZodType<WorkflowMessageEvidence>;
+    evidenceSchema: z.ZodType<Evidence>;
+}

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

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

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

@@ -0,0 +1,43 @@
+import type { NativeInstanceDependencyProposal } from './native-instance-dependencies.js';
+import type { PrepareWorkflowDraftEditInput } from './workflow-draft-edit-assembly.js';
+import type { ValidateWorkflowDraftEditPlanInput, WorkflowDraftEditPlan } from './workflow-draft-edit.js';
+import type { ResolvedWorkflowDraftClarificationScopes } from './workflow-draft-clarification.js';
+import type { WorkflowSourceMessage } from './workflow-draft.js';
+import type { WorkflowDraftReferenceSources } from './workflow-draft-reference-sources.js';
+import type { WorkflowCapability } from './workflow-plan.js';
+export interface WorkflowDraftNativeDependenciesInput extends ValidateWorkflowDraftEditPlanInput {
+    clarificationScopes?: ResolvedWorkflowDraftClarificationScopes;
+}
+export interface WorkflowDraftNativeDependencyRole {
+    nodeId: string;
+    stepId: string;
+    capability: string;
+    description: string;
+    instruction: string;
+    parameterReferenceSources: NonNullable<WorkflowCapability['parameterReferenceSources']>;
+}
+export interface WorkflowDraftNativeDependencyContext {
+    plan: WorkflowDraftEditPlan;
+    /** Immutable pre-configuration contracts, not a capture of accumulated value-stage results. */
+    sources: WorkflowDraftReferenceSources;
+    roles: WorkflowDraftNativeDependencyRole[];
+    pendingNativeSources: WorkflowDraftNativeDependencyRole[];
+    sourceCandidatesByNodeId: Record<string, string[]>;
+    messages: WorkflowSourceMessage[];
+    backgroundMessages: WorkflowSourceMessage[];
+    includeExplanations: boolean;
+}
+export interface WorkflowDraftNativeDependencies {
+    id: string;
+    context: WorkflowDraftNativeDependencyContext;
+    proposal: NativeInstanceDependencyProposal;
+}
+export interface ResolveWorkflowDraftNativeDependenciesInput extends WorkflowDraftNativeDependenciesInput {
+    proposal: NativeInstanceDependencyProposal;
+}
+export interface ValidateWorkflowDraftNativeDependenciesInput extends WorkflowDraftNativeDependenciesInput {
+    producerDependencies: WorkflowDraftNativeDependencies;
+}
+export interface ValidateWorkflowDraftNativeDependencyResolutionsInput extends PrepareWorkflowDraftEditInput {
+    producerDependencies: WorkflowDraftNativeDependencies;
+}

package/dist/types/workflow-draft-native-dependencies.js

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

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

@@ -0,0 +1,9 @@
+import type { WorkflowDraftContent, WorkflowDraftContext } from './workflow-draft.js';
+import type { NativeOutputContract } from './node-output.js';
+export interface ResolveWorkflowDraftNativeSnapshotInput {
+    content: WorkflowDraftContent;
+    context: WorkflowDraftContext;
+    deferredNodeIds: string[];
+    unavailableApiNodeIds: string[];
+    shouldDeferNode?: (nodeId: string, availableOutputs: NativeOutputContract[], resolvedNodeIds: string[]) => boolean;
+}

package/dist/types/workflow-draft-native-materials.js

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

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

@@ -0,0 +1,25 @@
+import type { z } from 'zod';
+import type { JsonValueObject } from './api-arguments.js';
+import type { WorkflowCapability } from './workflow-plan.js';
+import type { WorkflowDraftNativeNodeAdditionDescription } from './workflow-draft-native-node-addition.js';
+import type { StagedWorkflowDraftEdit } from './workflow-draft-edit-assembly.js';
+import type { WorkflowDraftReferenceSources } from './workflow-draft-reference-sources.js';
+import type { MissingWorkflowNativeMaterialRequirement } from './native-material-snapshot.js';
+import type { NativeNodeConfigurationDependencies } from './native-instance-dependencies.js';
+import type { WorkflowDraftNativeDependencyRole } from './workflow-draft-native-dependencies.js';
+export interface WorkflowDraftNativeAdditionMaterials {
+    stage: StagedWorkflowDraftEdit;
+    nodeId: string;
+    instruction: string;
+    definition: WorkflowCapability;
+    sources: WorkflowDraftReferenceSources;
+    missingContext: MissingWorkflowNativeMaterialRequirement[];
+    pendingSourceNodeIds: string[];
+    sourceDependencies?: NativeNodeConfigurationDependencies;
+    plannedNativeRoles?: WorkflowDraftNativeDependencyRole[];
+}
+export interface WorkflowDraftNativeNodeAdditionContext {
+    description: WorkflowDraftNativeNodeAdditionDescription;
+    capability: WorkflowCapability;
+    parametersSchema: z.ZodType<JsonValueObject>;
+}

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

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