@openapi-flow/core 0.2.0 → 0.3.1

package/dist/types/workflow-api-input-readiness.d.ts

@@ -0,0 +1,8 @@
+import type { ReviewableWorkflowApiMaterial } from './reviewable-workflow.js';
+export interface WorkflowApiInputDeferral {
+    /** Exact current OAS-derived input slot IDs explicitly deferred by the caller. */
+    deferredApiInputIds?: string[];
+}
+export interface WorkflowApiInputReadinessInput extends WorkflowApiInputDeferral {
+    materials: ReviewableWorkflowApiMaterial[];
+}

package/dist/types/workflow-api-input-readiness.js

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

package/dist/types/workflow-clarification-answer-revision.d.ts

@@ -0,0 +1,43 @@
+import type { WorkflowPlanningContext } from './planning-evidence.js';
+import type { WorkflowClarificationQuestion, WorkflowClarificationReply } from './workflow-clarification.js';
+import type { WorkflowDraftClarification } from './workflow-draft-clarification.js';
+import type { WorkflowSourceMessage } from './workflow-draft.js';
+export type WorkflowClarificationAnswerChange = {
+    kind: 'replace-answer';
+    reply: WorkflowClarificationReply;
+} | {
+    kind: 'reopen-question';
+    questionId: string;
+};
+export interface WorkflowClarificationAnswerRevisionDescription {
+    fingerprint: string;
+    roundId: string;
+    questions: WorkflowClarificationQuestion[];
+    replies: WorkflowClarificationReply[];
+}
+export interface ReviseWorkflowClarificationAnswersInput {
+    context: WorkflowPlanningContext;
+    fingerprint: string;
+    messageId: string;
+    changes: WorkflowClarificationAnswerChange[];
+}
+/** An immutable transition receipt, not a replacement workflow or an executable edit. */
+export interface WorkflowClarificationAnswerRevision {
+    id: string;
+    fingerprint: string;
+    message: WorkflowSourceMessage;
+    changes: WorkflowClarificationAnswerChange[];
+    before: WorkflowDraftClarification;
+    after: WorkflowDraftClarification;
+    supersededAnswerMessageIds: string[];
+}
+export interface WorkflowClarificationAnswerRevisionResult {
+    revision: WorkflowClarificationAnswerRevision;
+    /** Previous answer evidence is removed, original request evidence is preserved. */
+    activeMessages: WorkflowSourceMessage[];
+}
+export interface ValidateWorkflowClarificationAnswerRevisionInput {
+    /** The trusted, original pre-change context; never reconstruct it from a client receipt. */
+    context: WorkflowPlanningContext;
+    revision: WorkflowClarificationAnswerRevision;
+}

package/dist/types/workflow-clarification-answer-revision.js

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

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

@@ -0,0 +1,153 @@
+import type { WorkflowPlanningContext, WorkflowPlanningEvidence, WorkflowMessageEvidence } from './planning-evidence.js';
+import type { WorkflowSourceMessage } from './workflow-draft.js';
+export interface ClarificationQuestionLimits {
+    maxCategories: number;
+    maxQuestionsPerCategory: number;
+    maxChoicesPerQuestion: number;
+    maxQuestionsPerRound: number;
+}
+export interface WorkflowClarificationOptions {
+    includeExplanations?: boolean;
+    includeSuggestions?: boolean;
+}
+export interface ResolvedWorkflowClarificationOptions {
+    includeExplanations: boolean;
+    includeSuggestions: boolean;
+}
+export interface WorkflowDecisionExplanation<Evidence = WorkflowPlanningEvidence> {
+    reason: string;
+    evidence: Evidence[];
+}
+export interface ProposedRequirementStatement<Evidence = WorkflowPlanningEvidence> {
+    text: string;
+    sources: WorkflowMessageEvidence[];
+    explanation?: WorkflowDecisionExplanation<Evidence>;
+}
+export interface ProposedClarificationChoice<Evidence = WorkflowPlanningEvidence> {
+    label: string;
+    explanation?: WorkflowDecisionExplanation<Evidence>;
+}
+export type ProposedClarificationAnswer<Evidence = WorkflowPlanningEvidence> = {
+    kind: 'text';
+} | {
+    kind: 'single-choice' | 'multiple-choice';
+    choices: ProposedClarificationChoice<Evidence>[];
+};
+export interface ProposedClarificationQuestion<Evidence = WorkflowPlanningEvidence> {
+    message: string;
+    answer: ProposedClarificationAnswer<Evidence>;
+    explanation?: WorkflowDecisionExplanation<Evidence>;
+}
+export interface ProposedClarificationCategory<Evidence = WorkflowPlanningEvidence> {
+    title: string;
+    questions: ProposedClarificationQuestion<Evidence>[];
+    explanation?: WorkflowDecisionExplanation<Evidence>;
+}
+export interface ProposedWorkflowSuggestion<Evidence = WorkflowPlanningEvidence> {
+    text: string;
+    explanation?: WorkflowDecisionExplanation<Evidence>;
+}
+export interface WorkflowRequirementsProposal<Evidence = WorkflowPlanningEvidence> {
+    statements: ProposedRequirementStatement<Evidence>[];
+    categories: ProposedClarificationCategory<Evidence>[];
+    suggestions?: ProposedWorkflowSuggestion<Evidence>[];
+}
+export interface WorkflowClarificationChoice extends ProposedClarificationChoice {
+    id: string;
+}
+export type WorkflowClarificationAnswer = {
+    kind: 'text';
+} | {
+    kind: 'single-choice' | 'multiple-choice';
+    choices: WorkflowClarificationChoice[];
+};
+export interface WorkflowClarificationQuestion extends Omit<ProposedClarificationQuestion, 'answer'> {
+    id: string;
+    answer: WorkflowClarificationAnswer;
+}
+export interface WorkflowClarificationCategory extends Omit<ProposedClarificationCategory, 'questions'> {
+    id: string;
+    questions: WorkflowClarificationQuestion[];
+}
+export interface WorkflowClarificationStatement extends ProposedRequirementStatement {
+    id: string;
+}
+export interface WorkflowClarificationSuggestion extends ProposedWorkflowSuggestion {
+    id: string;
+}
+export interface WorkflowClarificationRound {
+    id: string;
+    contextFingerprint: string;
+    sourceMessages: WorkflowSourceMessage[];
+    limits: ClarificationQuestionLimits;
+    options: ResolvedWorkflowClarificationOptions;
+    statements: WorkflowClarificationStatement[];
+    categories: WorkflowClarificationCategory[];
+    suggestions?: WorkflowClarificationSuggestion[];
+}
+export interface CreateWorkflowClarificationRoundInput {
+    context: WorkflowPlanningContext;
+    limits: ClarificationQuestionLimits;
+    options?: WorkflowClarificationOptions;
+    proposal: WorkflowRequirementsProposal;
+}
+export interface WorkflowClarificationRoundInput {
+    round: WorkflowClarificationRound;
+    context: WorkflowPlanningContext;
+}
+export type WorkflowClarificationReply = {
+    kind: 'single-choice';
+    questionId: string;
+    choiceId: string;
+} | {
+    kind: 'multiple-choice';
+    questionId: string;
+    choiceIds: string[];
+} | {
+    kind: 'text';
+    questionId: string;
+    text: string;
+} | {
+    kind: 'defer';
+    questionId: string;
+};
+export interface WorkflowAnswerEvidence {
+    kind: 'clarification-answer';
+    roundId: string;
+    questionId: string;
+}
+export interface WorkflowRequirementFact {
+    id: string;
+    text: string;
+    sources: (WorkflowMessageEvidence | WorkflowAnswerEvidence)[];
+}
+export interface WorkflowClarificationResolution {
+    roundId: string;
+    contextFingerprint: string;
+    sourceMessages: WorkflowSourceMessage[];
+    replies: WorkflowClarificationReply[];
+    facts: WorkflowRequirementFact[];
+    pendingQuestionIds: string[];
+    deferredQuestionIds: string[];
+    readyForPlanning: boolean;
+    requirementsPrompt: string;
+}
+export interface ResolveWorkflowClarificationRepliesInput {
+    round: WorkflowClarificationRound;
+    context: WorkflowPlanningContext;
+    replies: WorkflowClarificationReply[];
+    previous?: WorkflowClarificationResolution;
+}
+export interface WorkflowClarificationResolutionInput {
+    round: WorkflowClarificationRound;
+    replies: WorkflowClarificationReply[];
+}
+export interface WorkflowRequirementsPromptInput {
+    sourceMessages: WorkflowSourceMessage[];
+    facts: WorkflowRequirementFact[];
+    pendingQuestions: WorkflowClarificationQuestion[];
+    deferredQuestions: WorkflowClarificationQuestion[];
+}
+export interface IdentifiedClarificationPart {
+    id: string;
+}

package/dist/types/workflow-clarification.js

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

package/dist/types/workflow-connection-planning.d.ts

@@ -0,0 +1,94 @@
+import type { ReviewableWorkflowApiMaterial, ReviewableWorkflowGraphPlan, ReviewableWorkflowGraphProposal, WorkflowReviewGap, BlockedWorkflowCall } from './reviewable-workflow.js';
+import type { PlannedNativeNode, WorkflowCapability, WorkflowPlanEdge, WorkflowPlanNodeContract } from './workflow-plan.js';
+import type { PreparedNativeNodeMaterial } from './native-node-planning.js';
+import type { WorkflowPlanningSourceEvidence } from './workflow-planning-materials.js';
+import type { WorkflowApiInputDeferral } from './workflow-api-input-readiness.js';
+import type { DeferredApiInputSlot } from './deferred-api-inputs.js';
+export interface WorkflowConnectionMaterialInput extends WorkflowApiInputDeferral {
+    materials?: ReviewableWorkflowApiMaterial[];
+    capabilities?: WorkflowCapability[];
+    nativeNodes?: PlannedNativeNode[];
+    gaps?: WorkflowReviewGap[];
+    edges?: WorkflowPlanEdge[];
+}
+export interface WorkflowConnectionPlanningInput extends WorkflowConnectionMaterialInput {
+    scenario: string;
+}
+export interface WorkflowConnectionMaterials extends WorkflowApiInputDeferral {
+    materials: ReviewableWorkflowApiMaterial[];
+    capabilities: WorkflowCapability[];
+    nativeNodes: PlannedNativeNode[];
+    gaps: WorkflowReviewGap[];
+    edges: WorkflowPlanEdge[];
+    contracts: WorkflowPlanNodeContract[];
+    deferredApiInputs?: DeferredApiInputSlot[];
+}
+export interface WorkflowConnectionApiRole {
+    callId: string;
+    purpose: string;
+}
+export interface WorkflowNativeParameterReadiness {
+    nodeId: string;
+    planTimeStatus: 'validated';
+    /** Explicit runtime ownership, not missing plan-time values or unresolved graph gaps. */
+    executionInputPointers: string[];
+}
+export interface WorkflowConnectionPlanningContext {
+    scenario: string;
+    nodes: WorkflowPlanNodeContract[];
+    nativeNodes?: PreparedNativeNodeMaterial[];
+    nativeParameterReadiness?: WorkflowNativeParameterReadiness[];
+    edges: WorkflowPlanEdge[];
+    gaps: WorkflowReviewGap[];
+    readyCallIds: string[];
+    apiRoles: WorkflowConnectionApiRole[];
+    /** Code-derived missing values, never missing API capabilities or generated literals. */
+    deferredApiInputs?: DeferredApiInputSlot[];
+}
+export interface WorkflowConnectionPlanningSnapshot extends WorkflowConnectionMaterials {
+    scenario: string;
+}
+export interface WorkflowConnectionPlanningDescription {
+    input: WorkflowConnectionPlanningSnapshot;
+    context: WorkflowConnectionPlanningContext;
+    sources: WorkflowPlanningSourceEvidence;
+}
+export type WorkflowConnectionProposal = Omit<ReviewableWorkflowGraphProposal, 'nativeNodes'>;
+export interface ExplainedWorkflowConnection extends WorkflowPlanEdge {
+    reason: string;
+}
+export interface ExplainedWorkflowBlockedCall extends BlockedWorkflowCall {
+    reason: string;
+}
+export interface WorkflowConnectionDecision {
+    reason: string;
+    edges: ExplainedWorkflowConnection[];
+    blockedCalls: ExplainedWorkflowBlockedCall[];
+    additionalGaps: ReviewableWorkflowGraphProposal['additionalGaps'];
+}
+export type WorkflowConnectionPlanningResult = Pick<ReviewableWorkflowGraphPlan, 'nativeNodes' | 'edges' | 'gaps' | 'blockedCalls' | 'starts'>;
+export interface WorkflowConnectionPlanningRecord {
+    kind: 'proposed-connections';
+    decision: WorkflowConnectionDecision;
+    plan: WorkflowConnectionPlanningResult;
+    evidence: {
+        kind: 'supplied-connection-materials';
+        context: WorkflowConnectionPlanningContext;
+        sources: WorkflowPlanningSourceEvidence;
+    };
+    /** Code-derived final contracts, including newly blocked calls and gap placeholders. */
+    verification: {
+        contracts: WorkflowPlanNodeContract[];
+    };
+}
+export interface CreateWorkflowConnectionPlanInput extends WorkflowConnectionPlanningInput {
+    proposal: WorkflowConnectionProposal;
+}
+export interface CreateWorkflowConnectionPlanningRecordInput extends WorkflowConnectionPlanningInput {
+    plan: WorkflowConnectionPlanningResult;
+    decision: WorkflowConnectionDecision;
+}
+export interface ValidateWorkflowConnectionPlanningRecordInput extends WorkflowConnectionPlanningInput {
+    plan: WorkflowConnectionPlanningResult;
+    record: WorkflowConnectionPlanningRecord;
+}

package/dist/types/workflow-connection-planning.js

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

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

@@ -0,0 +1,42 @@
+import type { ApiOperationKey } from './api-catalog.js';
+import type { BindingSchema } from './api-bindings.js';
+import type { ResolvedWorkflowDraftSourceEvidence } from './workflow-draft-source-evidence.js';
+export interface ProposedWorkflowDraftApiBindingSource {
+    sourceNodeId: string;
+    sourcePointer: string;
+}
+export type ProposedWorkflowDraftApiBindingQuestion = {
+    kind: 'binding-intent';
+    targetPointer: string;
+} | {
+    kind: 'choose-source';
+    targetPointer: string;
+    candidates: ProposedWorkflowDraftApiBindingSource[];
+};
+export interface WorkflowDraftApiBindingSourceChoice extends ProposedWorkflowDraftApiBindingSource {
+    id: string;
+    label: string;
+}
+export interface WorkflowDraftApiCallPlanningQuestion extends ResolvedWorkflowDraftSourceEvidence {
+    id: string;
+    nodeId: string;
+    operation: ApiOperationKey;
+    method: string;
+    path: string;
+    kind: ProposedWorkflowDraftApiBindingQuestion['kind'];
+    targetPointer: string;
+    targetSchemas: BindingSchema[];
+    message: string;
+    choices: WorkflowDraftApiBindingSourceChoice[];
+}
+export type WorkflowDraftApiBindingAnswer = {
+    kind: 'choose-source';
+    questionId: string;
+    choiceId: string;
+} | ({
+    kind: 'bind-source';
+    questionId: string;
+} & ProposedWorkflowDraftApiBindingSource) | {
+    kind: 'no-binding';
+    questionId: string;
+};

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

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

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

@@ -0,0 +1,98 @@
+import type { ApiOperationContract } from './api-operation.js';
+import type { NativeOutputContract } from './node-output.js';
+import type { PrepareWorkflowDraftEditInput, StagedWorkflowDraftEdit, WorkflowDraftEditResolution, WorkflowDraftEditRepair } from './workflow-draft-edit-assembly.js';
+import type { WorkflowDraftApiCall, WorkflowSourceMessage, WorkflowDraftRequirement } from './workflow-draft.js';
+import type { WorkflowMessageEvidence } from './planning-evidence.js';
+import type { WorkflowDecisionExplanation } from './workflow-clarification.js';
+import type { JsonObject } from './openapi.js';
+import type { ApiResponsePointerCatalog } from './api-response-pointers.js';
+import type { WorkflowDraftApiSourcePreparation } from './workflow-draft-api-response-sources.js';
+export type WorkflowDraftApiBindingEditScope = {
+    kind: 'step';
+    stepId: string;
+} | {
+    kind: 'repair';
+    taskId: string;
+};
+export interface WorkflowDraftApiBindingEditInput extends PrepareWorkflowDraftEditInput {
+    scope: WorkflowDraftApiBindingEditScope;
+}
+export type WorkflowDraftApiBindingEditSource = {
+    nodeId: string;
+    kind: 'api';
+    operation: ApiOperationContract;
+    responsePointerCatalog: ApiResponsePointerCatalog[];
+    preparation: WorkflowDraftApiSourcePreparation;
+    requirements: WorkflowDraftRequirement[];
+} | {
+    nodeId: string;
+    kind: 'native';
+    schema: NativeOutputContract['schema'];
+    requirements: WorkflowDraftRequirement[];
+};
+export interface WorkflowDraftApiBindingEditDescription {
+    fingerprint: string;
+    stage: StagedWorkflowDraftEdit;
+    scope: WorkflowDraftApiBindingEditScope;
+    instruction: string;
+    call: WorkflowDraftApiCall;
+    operation: ApiOperationContract;
+    requestSchema: JsonObject;
+    sourceCandidates: WorkflowDraftApiBindingEditSource[];
+    /** Repair scopes must explicitly decide each affected existing target. */
+    requiredTargetPointers: string[];
+    messages: WorkflowSourceMessage[];
+    backgroundMessages: WorkflowSourceMessage[];
+    includeExplanations: boolean;
+}
+export type ProposedWorkflowDraftApiBindingEdit = {
+    targetPointer: string;
+    sources: WorkflowMessageEvidence[];
+    explanation?: WorkflowDecisionExplanation<WorkflowMessageEvidence>;
+} & ({
+    kind: 'bind' | 'replace-literal-with-binding';
+    sourceNodeId: string;
+    sourcePointer: string;
+} | {
+    kind: 'unbind';
+} | {
+    kind: 'keep';
+} | {
+    kind: 'needs-clarification';
+    message: string;
+});
+export interface WorkflowDraftApiBindingEditProposal {
+    decisions: ProposedWorkflowDraftApiBindingEdit[];
+}
+export interface ResolveWorkflowDraftApiBindingEditInput extends WorkflowDraftApiBindingEditInput {
+    fingerprint: string;
+    proposal: WorkflowDraftApiBindingEditProposal;
+}
+export interface WorkflowDraftApiBindingEditQuestion {
+    id: string;
+    nodeId: string;
+    targetPointer: string;
+    message: string;
+    sources: WorkflowMessageEvidence[];
+    explanation?: WorkflowDecisionExplanation<WorkflowMessageEvidence>;
+}
+export interface WorkflowDraftApiBindingEditResultFields {
+    fingerprint: string;
+    proposal: WorkflowDraftApiBindingEditProposal;
+}
+export type WorkflowDraftApiBindingEditResult = WorkflowDraftApiBindingEditResultFields & ({
+    status: 'ready';
+    kind: 'step';
+    resolution: Extract<WorkflowDraftEditResolution, {
+        kind: 'api-bindings';
+    }>;
+} | {
+    status: 'ready';
+    kind: 'repair';
+    repair: Extract<WorkflowDraftEditRepair, {
+        kind: 'api-bindings';
+    }>;
+} | {
+    status: 'needs-clarification';
+    questions: WorkflowDraftApiBindingEditQuestion[];
+});

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

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

package/dist/types/workflow-draft-api-binding-intent.d.ts

@@ -0,0 +1,28 @@
+import type { JsonObject } from './openapi.js';
+import type { ApiOperationContract } from './api-operation.js';
+import type { WorkflowSourceMessage } from './workflow-draft.js';
+import type { ProposedWorkflowDraftSourceEvidence, ResolvedWorkflowDraftSourceEvidence, WorkflowDraftSourceEvidenceDescription } from './workflow-draft-source-evidence.js';
+import type { WorkflowDraftApiCallPlanningInput } from './workflow-draft-api-call-planning.js';
+/** Select requested response-to-request targets, not their sources or values. */
+export interface WorkflowDraftApiBindingIntentProposal extends ProposedWorkflowDraftSourceEvidence {
+    targets: string[];
+}
+export interface WorkflowDraftApiBindingIntent extends ResolvedWorkflowDraftSourceEvidence {
+    fingerprint: string;
+    proposal: WorkflowDraftApiBindingIntentProposal;
+    targets: string[];
+}
+export interface ResolveWorkflowDraftApiBindingIntentInput extends WorkflowDraftApiCallPlanningInput {
+    fingerprint: string;
+    proposal: WorkflowDraftApiBindingIntentProposal;
+}
+export interface WorkflowDraftApiBindingIntentDescription extends WorkflowDraftSourceEvidenceDescription {
+    fingerprint: string;
+    instruction: string;
+    operation: ApiOperationContract;
+    requestSchema: JsonObject;
+    requestMediaType?: string;
+    backgroundMessages: WorkflowSourceMessage[];
+    hasRequestInputs: boolean;
+    hasPotentialPredecessors: boolean;
+}

package/dist/types/workflow-draft-api-binding-intent.js

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

package/dist/types/workflow-draft-api-call-planning-internal.d.ts

@@ -0,0 +1,7 @@
+import type { ApiArgumentGenerationContract } from './api-argument-generation.js';
+import type { WorkflowDraftApiCallPlanningDescription } from './workflow-draft-api-call-planning.js';
+export interface WorkflowDraftApiCallArgumentsContext {
+    description: WorkflowDraftApiCallPlanningDescription;
+    contract: ApiArgumentGenerationContract;
+    fingerprint: string;
+}

package/dist/types/workflow-draft-api-call-planning-internal.js

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

package/dist/types/workflow-draft-api-call-planning.d.ts

@@ -0,0 +1,127 @@
+import type { ApiArgumentValues, ApiCallArguments, OutputBinding } from './api-arguments.js';
+import type { ApiInputRequirement, ConfirmedApiInput } from './api-clarification.js';
+import type { ApiOperationContract } from './api-operation.js';
+import type { JsonObject } from './openapi.js';
+import type { WorkflowDraftApiLiteralSource, VerifiedWorkflowDraftApiLiteralSource } from './workflow-draft-api-literal-sources.js';
+import type { PrepareWorkflowDraftEditInput, StagedWorkflowDraftEdit, WorkflowDraftEditResolution } from './workflow-draft-edit-assembly.js';
+import type { WorkflowDraftApiCall, WorkflowSourceMessage } from './workflow-draft.js';
+import type { ProposedWorkflowDraftSourceEvidence, ResolvedWorkflowDraftSourceEvidence, WorkflowDraftSourceEvidenceDescription } from './workflow-draft-source-evidence.js';
+import type { ProposedWorkflowDraftApiBindingQuestion, WorkflowDraftApiBindingAnswer, WorkflowDraftApiCallPlanningQuestion } from './workflow-draft-api-binding-clarification.js';
+import type { WorkflowDraftApiBindingIntent } from './workflow-draft-api-binding-intent.js';
+import type { BindingSchema } from './api-bindings.js';
+/** One operation already selected by an add-api-call or replace-api-operation decision. */
+export interface WorkflowDraftApiCallPlanningInput extends PrepareWorkflowDraftEditInput {
+    stepId: string;
+    requestMediaType?: string;
+}
+export interface WorkflowDraftApiCallPlanningDescription extends WorkflowDraftSourceEvidenceDescription {
+    fingerprint: string;
+    stage: StagedWorkflowDraftEdit;
+    kind: 'add-api-call' | 'replace-api-operation';
+    nodeId: string;
+    operation: ApiOperationContract;
+    previousCall?: WorkflowDraftApiCall;
+    instruction: string;
+    requestMediaType?: string;
+    requestSchema: JsonObject;
+    requestInputRoots: string[];
+    hasRequestInputs: boolean;
+    /** Includes selected but not-yet-materialized producers; absence is not missing contract readiness. */
+    hasOtherSelectedNodes: boolean;
+    backgroundMessages: WorkflowSourceMessage[];
+}
+export interface ProposedWorkflowDraftApiCallMapping {
+    targetPointer: string;
+    sourceNodeId: string;
+    sourcePointer: string;
+}
+export interface WorkflowDraftApiCallBindingsInput extends WorkflowDraftApiCallPlanningInput {
+    inputIntent?: WorkflowDraftApiBindingIntent;
+}
+export interface WorkflowDraftApiBindingTarget {
+    targetPointer: string;
+    schemas: BindingSchema[];
+}
+export interface WorkflowDraftApiCallBindingsDescription extends WorkflowDraftApiCallPlanningDescription {
+    inputIntent?: WorkflowDraftApiBindingIntent;
+    bindingTargets?: WorkflowDraftApiBindingTarget[];
+}
+export type WorkflowDraftApiCallBindingChoice = {
+    status: 'provided';
+    mappings: ProposedWorkflowDraftApiCallMapping[];
+} | {
+    status: 'needs-clarification';
+    mappings: ProposedWorkflowDraftApiCallMapping[];
+    questions: ProposedWorkflowDraftApiBindingQuestion[];
+};
+export type ProposedWorkflowDraftApiCallBindingChoice = {
+    status: 'provided';
+    mappings?: ProposedWorkflowDraftApiCallMapping[];
+} | {
+    status: 'needs-clarification';
+    mappings?: ProposedWorkflowDraftApiCallMapping[];
+    questions: ProposedWorkflowDraftApiBindingQuestion[];
+};
+export interface WorkflowDraftApiCallBindingProposal {
+    decision: ProposedWorkflowDraftApiCallBindingChoice & ProposedWorkflowDraftSourceEvidence;
+}
+export interface ResolveWorkflowDraftApiCallBindingsInput extends WorkflowDraftApiCallBindingsInput {
+    fingerprint: string;
+    proposal: WorkflowDraftApiCallBindingProposal;
+    /** Explicit host/user decisions, never model-generated state or inferred mappings. */
+    answers?: WorkflowDraftApiBindingAnswer[];
+}
+export interface WorkflowDraftApiCallBindingResultFields {
+    inputIntent?: WorkflowDraftApiBindingIntent;
+    fingerprint: string;
+    proposal: WorkflowDraftApiCallBindingProposal;
+    decision: WorkflowDraftApiCallBindingChoice & ResolvedWorkflowDraftSourceEvidence;
+    answers?: WorkflowDraftApiBindingAnswer[];
+}
+export interface ReadyWorkflowDraftApiCallBindings extends WorkflowDraftApiCallBindingResultFields {
+    status: 'ready';
+    bindings: OutputBinding[];
+}
+export interface PendingWorkflowDraftApiCallBindings extends WorkflowDraftApiCallBindingResultFields {
+    status: 'needs-clarification';
+    questions: WorkflowDraftApiCallPlanningQuestion[];
+}
+export type WorkflowDraftApiCallBindingResult = ReadyWorkflowDraftApiCallBindings | PendingWorkflowDraftApiCallBindings;
+export interface WorkflowDraftApiCallArgumentsInput extends WorkflowDraftApiCallPlanningInput {
+    bindingPlan: ReadyWorkflowDraftApiCallBindings;
+    confirmedInputs?: ConfirmedApiInput[];
+    /** Explicitly defer missing values to typed n8n inputs; never invent placeholder data. */
+    allowRuntimeInputs?: boolean;
+    /** Ask the existing argument model for scenario-requested input paths, including unknown optional literals. */
+    trackRequestedInputs?: boolean;
+}
+export interface WorkflowDraftApiCallArgumentsProposal extends ProposedWorkflowDraftSourceEvidence {
+    values: ApiArgumentValues;
+    requestedInputs?: string[];
+    /** Required coverage for every proposed literal; absent only when no values are proposed. */
+    literalSources?: WorkflowDraftApiLiteralSource[];
+}
+export interface WorkflowDraftApiCallArgumentsDescription extends WorkflowDraftApiCallPlanningDescription {
+    literalInputSchema: JsonObject;
+    hasLiteralInputs: boolean;
+}
+export interface ResolveWorkflowDraftApiCallArgumentsInput extends WorkflowDraftApiCallArgumentsInput {
+    fingerprint: string;
+    proposal: WorkflowDraftApiCallArgumentsProposal;
+}
+export interface WorkflowDraftApiCallArgumentsResultFields extends ResolvedWorkflowDraftSourceEvidence {
+    fingerprint: string;
+    proposal: WorkflowDraftApiCallArgumentsProposal;
+    literalSources: VerifiedWorkflowDraftApiLiteralSource[];
+    arguments: ApiCallArguments;
+    requirements: ApiInputRequirement[];
+}
+export type WorkflowDraftApiCallArgumentsResult = (WorkflowDraftApiCallArgumentsResultFields & {
+    status: 'ready';
+    inputMode: 'provided' | 'runtime-inputs';
+    resolution: Extract<WorkflowDraftEditResolution, {
+        kind: 'api-call';
+    }>;
+}) | (WorkflowDraftApiCallArgumentsResultFields & {
+    status: 'needs-input';
+});

package/dist/types/workflow-draft-api-call-planning.js

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