@openapi-flow/core 0.1.0 → 0.3.0

package/dist/types/workflow-clarification.js

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

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

@@ -0,0 +1,89 @@
+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';
+export interface WorkflowConnectionMaterialInput {
+    materials?: ReviewableWorkflowApiMaterial[];
+    capabilities?: WorkflowCapability[];
+    nativeNodes?: PlannedNativeNode[];
+    gaps?: WorkflowReviewGap[];
+    edges?: WorkflowPlanEdge[];
+}
+export interface WorkflowConnectionPlanningInput extends WorkflowConnectionMaterialInput {
+    scenario: string;
+}
+export interface WorkflowConnectionMaterials {
+    materials: ReviewableWorkflowApiMaterial[];
+    capabilities: WorkflowCapability[];
+    nativeNodes: PlannedNativeNode[];
+    gaps: WorkflowReviewGap[];
+    edges: WorkflowPlanEdge[];
+    contracts: WorkflowPlanNodeContract[];
+}
+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[];
+}
+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 {};

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