@openapi-flow/core 0.2.0 → 0.3.0

package/dist/openapi/catalog/create-api-catalog.js

@@ -2,8 +2,8 @@ import { createHash } from 'node:crypto';
 import { validateOpenApi, validateAndResolveOpenApiDocument, } from '../common/validate-spec.js';
 import { operationsFromDocument } from '../request/parse-request-operations.js';
 export async function createApiCatalog(sources) {
-    if (!Array.isArray(sources) || sources.length === 0)
-        throw new Error('sources must contain at least one OpenAPI document');
+    if (!Array.isArray(sources))
+        throw new Error('sources must be an array');
     const catalog = { documents: [], operations: [] };
     for (const [index, source] of sources.entries()) {
         if (!source || typeof source.id !== 'string' || !source.id.trim())

package/dist/openapi/selection/evidence/create-api-selection-explanation.d.ts

@@ -0,0 +1,3 @@
+import type { ApiSelectionExplanation, CreateApiSelectionExplanationInput } from '../../../types/api-selection-evidence.js';
+/** Code attaches sources; the model supplies only its short user-facing reason. */
+export declare function createApiSelectionExplanation(input: CreateApiSelectionExplanationInput): ApiSelectionExplanation;

package/dist/openapi/selection/evidence/create-api-selection-explanation.js

@@ -0,0 +1,29 @@
+import { apiSelectionExplanationBasisSchema } from '../../../schemas/api-selection-evidence-schema.js';
+import { planningEvidenceTextSchema } from '../../../schemas/planning-evidence-schema.js';
+import { describeApiSelectionContext } from './describe-api-selection-context.js';
+import { apiOperationKeyEquals } from '../../catalog/api-operation-key-equals.js';
+/** Code attaches sources; the model supplies only its short user-facing reason. */
+export function createApiSelectionExplanation(input) {
+    const context = describeApiSelectionContext(input.context);
+    const reason = planningEvidenceTextSchema.parse(input.reason);
+    const basis = apiSelectionExplanationBasisSchema.parse(input.basis);
+    const candidates = basis.kind === 'catalog'
+        ? context.operations
+        : basis.operations.map((key, index) => {
+            if (basis.operations
+                .slice(0, index)
+                .some((prior) => apiOperationKeyEquals(prior, key)))
+                throw new Error('API selection explanation repeats a candidate');
+            const candidate = context.operations.find((item) => apiOperationKeyEquals(item.key, key));
+            if (!candidate)
+                throw new Error(`API selection explanation references an unavailable candidate: ${key.documentId}${key.operationRef}`);
+            return candidate;
+        });
+    return {
+        reason,
+        evidence: [
+            { kind: 'scenario', text: context.scenario },
+            { kind: 'discovery', candidates },
+        ],
+    };
+}

package/dist/openapi/selection/evidence/describe-api-selection-context.d.ts

@@ -0,0 +1,3 @@
+import type { ApiSelectionContext } from '../../../types/api-selection-evidence.js';
+/** Snapshot exactly the supplied discovery boundary before an asynchronous call. */
+export declare function describeApiSelectionContext(input: ApiSelectionContext): ApiSelectionContext;

package/dist/openapi/selection/evidence/describe-api-selection-context.js

@@ -0,0 +1,12 @@
+import { apiSelectionContextSchema } from '../../../schemas/api-selection-evidence-schema.js';
+import { apiOperationKeyEquals } from '../../catalog/api-operation-key-equals.js';
+/** Snapshot exactly the supplied discovery boundary before an asynchronous call. */
+export function describeApiSelectionContext(input) {
+    const context = apiSelectionContextSchema.parse(input);
+    for (const [index, candidate] of context.operations.entries())
+        if (context.operations
+            .slice(0, index)
+            .some((prior) => apiOperationKeyEquals(prior.key, candidate.key)))
+            throw new Error(`API selection context.operations[${index}].key duplicates a discovery candidate`);
+    return context;
+}

package/dist/openapi/selection/evidence/validate-api-selection-explanation.d.ts

@@ -0,0 +1,3 @@
+import type { ValidateApiSelectionExplanationInput } from '../../../types/api-selection-evidence.js';
+/** Exact provenance is checked; semantic entailment of the reason is not proved. */
+export declare function validateApiSelectionExplanation(input: ValidateApiSelectionExplanationInput): void;

package/dist/openapi/selection/evidence/validate-api-selection-explanation.js

@@ -0,0 +1,14 @@
+import { isDeepStrictEqual } from 'node:util';
+import { apiSelectionExplanationSchema } from '../../../schemas/api-selection-evidence-schema.js';
+import { createApiSelectionExplanation } from './create-api-selection-explanation.js';
+/** Exact provenance is checked; semantic entailment of the reason is not proved. */
+export function validateApiSelectionExplanation(input) {
+    const explanation = apiSelectionExplanationSchema.parse(input.explanation);
+    const expected = createApiSelectionExplanation({
+        context: input.context,
+        basis: input.basis,
+        reason: explanation.reason,
+    });
+    if (!isDeepStrictEqual(expected, explanation))
+        throw new Error('API selection explanation evidence differs from the supplied scenario or discovery basis');
+}

package/dist/openapi/selection/resolve-api-selection-answers.d.ts

@@ -0,0 +1,2 @@
+import type { ResolveApiSelectionAnswersInput, ApiSelectionAnalysis } from '../../types/api-clarification.js';
+export declare function resolveApiSelectionAnswers(input: ResolveApiSelectionAnswersInput): Promise<ApiSelectionAnalysis>;

package/dist/openapi/selection/resolve-api-selection-answers.js

@@ -0,0 +1,32 @@
+import { apiOperationAnswersSchema } from '../../schemas/api-operation-answers-schema.js';
+import { apiOperationKeyEquals } from '../catalog/api-operation-key-equals.js';
+import { resolveApiOperations } from '../resolve-api-operations.js';
+export async function resolveApiSelectionAnswers(input) {
+    const answers = apiOperationAnswersSchema.parse(input.answers);
+    await resolveApiOperations(input.catalog, [
+        ...input.analysis.selection.operations.map((item) => item.key),
+        ...input.analysis.questions.flatMap((question) => question.candidates.map((candidate) => candidate.key)),
+    ]);
+    const operations = structuredClone(input.analysis.selection.operations);
+    const answered = new Set();
+    for (const answer of answers) {
+        const question = input.analysis.questions.find((item) => item.id === answer.questionId);
+        if (!question || answered.has(answer.questionId))
+            throw new Error(`Unknown or duplicate operation question ${answer.questionId}`);
+        const candidate = question.candidates.find((item) => apiOperationKeyEquals(item.key, answer.operation));
+        if (!candidate)
+            throw new Error(`Operation answer ${answer.questionId} does not match a current offered candidate`);
+        operations.push({
+            key: structuredClone(candidate.key),
+            purpose: question.purpose,
+        });
+        answered.add(question.id);
+    }
+    return {
+        selection: {
+            operations,
+            gaps: structuredClone(input.analysis.selection.gaps),
+        },
+        questions: input.analysis.questions.filter((question) => !answered.has(question.id)),
+    };
+}

package/dist/planning/evidence/describe-workflow-planning-context.d.ts

@@ -0,0 +1,3 @@
+import type { WorkflowPlanningContext, WorkflowPlanningContextDescription } from '../../types/planning-evidence.js';
+/** Source declarations, never placeholders or fabricated native parameters. */
+export declare function describeWorkflowPlanningContext(input: WorkflowPlanningContext): WorkflowPlanningContextDescription;

package/dist/planning/evidence/describe-workflow-planning-context.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+import { apiOperationKeySchema } from '../../schemas/api-operation-key-schema.js';
+import { workflowEntryPointContractSchema } from '../../schemas/planning-evidence-schema.js';
+import { describeWorkflowDraftClarification } from '../../requirements/clarification/describe-workflow-draft-clarification.js';
+import { nativeMaterialRequirementsSchema } from '../../schemas/native-material-requirements-schema.js';
+import { resolveWorkflowPlanningMessages } from './resolve-workflow-planning-messages.js';
+/** Source declarations, never placeholders or fabricated native parameters. */
+export function describeWorkflowPlanningContext(input) {
+    const messages = resolveWorkflowPlanningMessages(input);
+    const operations = input.operations === undefined ? [] : input.operations;
+    const entrypoint = workflowEntryPointContractSchema
+        .optional()
+        .safeParse(input.entrypoint);
+    if (!entrypoint.success)
+        throw new Error('planning context.entrypoint is invalid', {
+            cause: entrypoint.error,
+        });
+    const capabilities = input.capabilities === undefined ? [] : input.capabilities;
+    if (!Array.isArray(operations) || !Array.isArray(capabilities))
+        throw new Error('planning context.operations and capabilities must be arrays when supplied');
+    const keys = operations.map((operation, index) => {
+        const key = apiOperationKeySchema.safeParse(operation?.key);
+        if (!key.success)
+            throw new Error(`planning context.operations[${index}].key is invalid`, {
+                cause: key.error,
+            });
+        return JSON.stringify(key.data);
+    });
+    if (new Set(keys).size !== keys.length)
+        throw new Error('planning context.operations requires distinct operation keys and snapshots');
+    if (capabilities.some((capability) => !capability ||
+        typeof capability.name !== 'string' ||
+        !capability.name.trim() ||
+        typeof capability.description !== 'string' ||
+        !capability.description.trim()) ||
+        new Set(capabilities.map((capability) => capability.name)).size !==
+            capabilities.length)
+        throw new Error('planning context.capabilities requires distinct non-empty names and descriptions');
+    const clarification = describeWorkflowDraftClarification({
+        ...input,
+        messages,
+    });
+    return {
+        messages,
+        ...(clarification === undefined ? {} : { clarification }),
+        ...(entrypoint.data === undefined ? {} : { entrypoint: entrypoint.data }),
+        operations: structuredClone(operations),
+        capabilities: capabilities.map((capability) => {
+            try {
+                return {
+                    name: capability.name,
+                    description: capability.description,
+                    ...(capability.materialRequirements === undefined
+                        ? {}
+                        : {
+                            materialRequirements: nativeMaterialRequirementsSchema.parse(capability.materialRequirements),
+                        }),
+                    ...(capability.supportsRuntimeParameters === true
+                        ? { supportsRuntimeParameters: true }
+                        : {}),
+                    parametersSchema: z.toJSONSchema(capability.parametersSchema, {
+                        io: 'input',
+                    }),
+                };
+            }
+            catch (error) {
+                throw new Error(`Native capability ${capability.name} cannot describe its input contract`, { cause: error });
+            }
+        }),
+    };
+}

package/dist/planning/evidence/resolve-workflow-planning-messages.d.ts

@@ -0,0 +1,4 @@
+import type { WorkflowPlanningContext } from '../../types/planning-evidence.js';
+import type { WorkflowSourceMessage } from '../../types/workflow-draft.js';
+/** Audit messages remain declared; only explicitly active IDs enter model/evidence payloads. */
+export declare function resolveWorkflowPlanningMessages(context: WorkflowPlanningContext): WorkflowSourceMessage[];

package/dist/planning/evidence/resolve-workflow-planning-messages.js

@@ -0,0 +1,24 @@
+import { workflowPlanningMessagesSchema, workflowSourceMessagesSchema, } from '../../schemas/planning-evidence-schema.js';
+import { workflowPlanningMessageIdsSchema } from '../../schemas/workflow-planning-message-ids-schema.js';
+/** Audit messages remain declared; only explicitly active IDs enter model/evidence payloads. */
+export function resolveWorkflowPlanningMessages(context) {
+    const parsed = workflowSourceMessagesSchema.safeParse(context?.messages);
+    if (!parsed.success)
+        throw new Error('planning context.messages requires distinct non-empty IDs and string text', { cause: parsed.error });
+    if (context.planningMessageIds === undefined) {
+        const active = workflowPlanningMessagesSchema.safeParse(parsed.data);
+        if (!active.success)
+            throw new Error('planning context.messages requires at least one message with non-empty text when planningMessageIds is omitted', { cause: active.error });
+        return active.data;
+    }
+    const ids = workflowPlanningMessageIdsSchema.parse(context.planningMessageIds);
+    return ids.map((id) => {
+        const message = parsed.data.find((entry) => entry.id === id);
+        if (!message)
+            throw new Error(`planningMessageIds references unknown message ${id}`);
+        const selected = workflowPlanningMessagesSchema.element.safeParse(message);
+        if (!selected.success)
+            throw new Error(`planning context.messages selected message ${id} requires non-empty text`, { cause: selected.error });
+        return selected.data;
+    });
+}

package/dist/planning/evidence/validate-workflow-planning-evidence.d.ts

@@ -0,0 +1,5 @@
+import type { ValidateWorkflowPlanningEvidenceInput, WorkflowPlanningContextDescription, WorkflowPlanningEvidence } from '../../types/planning-evidence.js';
+/** Existence and exact-source checks are not proof of semantic entailment. */
+export declare function validateWorkflowPlanningEvidence(input: ValidateWorkflowPlanningEvidenceInput): void;
+/** Reuse one validated source description across a whole clarification round. */
+export declare function validateDescribedWorkflowPlanningEvidence(context: WorkflowPlanningContextDescription, supplied: WorkflowPlanningEvidence[]): void;

package/dist/planning/evidence/validate-workflow-planning-evidence.js

@@ -0,0 +1,38 @@
+import { workflowPlanningEvidenceSchema } from '../../schemas/planning-evidence-schema.js';
+import { describeWorkflowPlanningContext } from './describe-workflow-planning-context.js';
+import { apiOperationKeyEquals } from '../../openapi/catalog/api-operation-key-equals.js';
+import { pointerValue } from '../../bindings/json-pointer.js';
+/** Existence and exact-source checks are not proof of semantic entailment. */
+export function validateWorkflowPlanningEvidence(input) {
+    const context = describeWorkflowPlanningContext(input.context);
+    validateDescribedWorkflowPlanningEvidence(context, input.evidence);
+}
+/** Reuse one validated source description across a whole clarification round. */
+export function validateDescribedWorkflowPlanningEvidence(context, supplied) {
+    const evidence = workflowPlanningEvidenceSchema
+        .array()
+        .min(1)
+        .parse(supplied);
+    if (new Set(evidence.map((item) => JSON.stringify(item))).size !==
+        evidence.length)
+        throw new Error('Planning evidence must not repeat an identical source');
+    for (const item of evidence) {
+        if (item.kind === 'message') {
+            const message = context.messages.find((message) => message.id === item.messageId);
+            if (!message || !message.text.includes(item.quote))
+                throw new Error(`Planning evidence references an unknown message or fabricated quote: ${item.messageId}`);
+        }
+        else if (item.kind === 'oas') {
+            const operation = context.operations.find((operation) => apiOperationKeyEquals(operation.key, item.operation));
+            if (!operation ||
+                pointerValue(operation.operation, item.pointer) === undefined)
+                throw new Error(`Planning evidence references a stale operation or undeclared OAS pointer: ${item.operation.documentId}${item.pointer}`);
+        }
+        else if (item.kind === 'native') {
+            if (!context.capabilities.some((capability) => capability.name === item.capability))
+                throw new Error(`Planning evidence references an unavailable native capability: ${item.capability}`);
+        }
+        else if (context.entrypoint?.kind !== item.entrypoint)
+            throw new Error(`Planning evidence references an unavailable entrypoint: ${item.entrypoint}`);
+    }
+}

package/dist/planning/evidence/workflow-planning-context-fingerprint.d.ts

@@ -0,0 +1,3 @@
+import type { WorkflowPlanningContext, WorkflowPlanningContextDescription } from '../../types/planning-evidence.js';
+export declare function workflowPlanningContextFingerprint(context: WorkflowPlanningContext): string;
+export declare function workflowPlanningContextFingerprintFromDescription(described: WorkflowPlanningContextDescription): string;

package/dist/planning/evidence/workflow-planning-context-fingerprint.js

@@ -0,0 +1,9 @@
+import { createHash } from 'node:crypto';
+import { describeWorkflowPlanningContext } from './describe-workflow-planning-context.js';
+export function workflowPlanningContextFingerprint(context) {
+    const described = describeWorkflowPlanningContext(context);
+    return workflowPlanningContextFingerprintFromDescription(described);
+}
+export function workflowPlanningContextFingerprintFromDescription(described) {
+    return createHash('sha256').update(JSON.stringify(described)).digest('hex');
+}

package/dist/public-api.d.ts

@@ -6,26 +6,223 @@ export { createApiCatalog } from './openapi/catalog/create-api-catalog.js';
 export { listApiOperations } from './openapi/catalog/list-api-operations.js';
 export { resolveApiOperations } from './openapi/resolve-api-operations.js';
 export type * from './types/api-catalog.js';
+export type * from './types/api-selection-evidence.js';
+export { describeApiSelectionContext } from './openapi/selection/evidence/describe-api-selection-context.js';
+export { createApiSelectionExplanation } from './openapi/selection/evidence/create-api-selection-explanation.js';
+export { validateApiSelectionExplanation } from './openapi/selection/evidence/validate-api-selection-explanation.js';
 export type * from './types/api-operation.js';
 export { createApiArgumentsSchema } from './schemas/create-api-arguments-schema.js';
 export { createApiArgumentGenerationContract } from './schemas/create-api-argument-generation-contract.js';
 export type * from './types/api-argument-generation.js';
+export type * from './types/api-literal-generation.js';
+export { describeApiLiteralGeneration } from './arguments/generation/describe-api-literal-generation.js';
+export { createApiLiteralGenerationRecord } from './arguments/generation/create-api-literal-generation-record.js';
+export { validateApiLiteralGenerationRecord } from './arguments/generation/validate-api-literal-generation-record.js';
+export type * from './types/api-clarification.js';
+export type * from './types/requested-api-inputs.js';
+export type * from './types/workflow-draft-capability-gap.js';
+export { createWorkflowDraftCapabilityGap } from './draft/gaps/create-workflow-draft-capability-gap.js';
+export { inspectWorkflowDraftCapabilityGap } from './draft/gaps/inspect-workflow-draft-capability-gap.js';
+export { describeWorkflowDraftCapabilityGap } from './draft/gaps/describe-workflow-draft-capability-gap.js';
+export { listMissingRequestedApiInputs } from './arguments/clarification/list-missing-requested-api-inputs.js';
+export type * from './types/api-input-answer-extraction.js';
+export type * from './types/api-input-source-selection.js';
+export { describeApiInputSources } from './arguments/sources/describe-api-input-sources.js';
+export { resolveApiInputSourceSelections } from './arguments/clarification/extraction/resolve-api-input-source-selections.js';
+export { createApiInputSourceSelectionSchema } from './schemas/api-input-source-selection-schema.js';
+export { captureApiInputAnswerContext } from './arguments/clarification/extraction/capture-api-input-answer-context.js';
+export { resolveApiInputAnswerSources } from './arguments/clarification/extraction/resolve-api-input-answer-sources.js';
+export { createApiInputAnswerExtractionRecord } from './arguments/clarification/extraction/create-api-input-answer-extraction-record.js';
+export { validateApiInputAnswerExtractionRecord } from './arguments/clarification/extraction/validate-api-input-answer-extraction-record.js';
+export { applyConfirmedApiInputs } from './arguments/clarification/apply-confirmed-api-inputs.js';
+export { inspectApiArgumentRequirements } from './arguments/clarification/inspect-api-argument-requirements.js';
+export { validateApiInputAnswers } from './arguments/clarification/validate-api-input-answers.js';
+export { createApiInputAnswersSchema } from './schemas/create-api-input-answers-schema.js';
+export { resolveApiSelectionAnswers } from './openapi/selection/resolve-api-selection-answers.js';
+export type * from './types/deferred-api-inputs.js';
+export { collectDeferredApiInputSlots } from './inputs/collect-deferred-api-input-slots.js';
+export { createDeferredApiInputsSchema } from './schemas/create-deferred-api-inputs-schema.js';
+export { inspectDeferredApiInputs } from './inputs/inspect-deferred-api-inputs.js';
+export { materializeDeferredApiInputs } from './inputs/materialize-deferred-api-inputs.js';
+export { DeferredApiInputError } from './inputs/deferred-api-input-error.js';
+export type * from './types/workflow-draft.js';
+export type * from './types/workflow-draft-changes.js';
+export type * from './types/workflow-draft-edit.js';
+export type * from './types/workflow-draft-clarification-ownership.js';
+export { describeWorkflowDraftClarificationOwnership } from './draft/edits/clarification/describe-workflow-draft-clarification-ownership.js';
+export type * from './types/workflow-draft-edit-assembly.js';
+export type * from './types/workflow-draft-api-binding-edit.js';
+export type * from './types/workflow-draft-connection-edit.js';
+export type * from './types/workflow-draft-native-parameter-edit.js';
+export type * from './types/workflow-draft-native-reference-repair.js';
+export type * from './types/workflow-draft-reference-sources.js';
+export type * from './types/workflow-draft-api-response-sources.js';
+export type * from './types/workflow-draft-clarification.js';
+export type * from './types/workflow-draft-selected-nodes.js';
+export type * from './types/workflow-draft-requirement-edit.js';
+export { describeWorkflowDraftSelectedNodes } from './draft/edits/describe-workflow-draft-selected-nodes.js';
+export { describeWorkflowDraftRequirementEdit } from './draft/requirements/describe-workflow-draft-requirement-edit.js';
+export { createWorkflowDraftRequirementAnswerSchema } from './schemas/create-workflow-draft-requirement-answer-schema.js';
+export { clarificationQuestionLimitsSchema } from './schemas/workflow-clarification-settings-schema.js';
+export { workflowClarificationRepliesSchema } from './schemas/workflow-clarification-reply-schema.js';
+export { workflowClarificationAnswerChangesSchema } from './schemas/workflow-clarification-answer-revision-schema.js';
+export { describeWorkflowClarificationAnswerRevision } from './requirements/clarification/revisions/describe-workflow-clarification-answer-revision.js';
+export { reviseWorkflowClarificationAnswers } from './requirements/clarification/revisions/revise-workflow-clarification-answers.js';
+export { validateWorkflowClarificationAnswerRevision } from './requirements/clarification/revisions/validate-workflow-clarification-answer-revision.js';
+export type * from './types/workflow-clarification-answer-revision.js';
+export type * from './types/workflow-draft-api-binding-clarification.js';
+export { workflowDraftApiBindingAnswersSchema } from './schemas/workflow-draft-api-binding-answer-schema.js';
+export { prepareWorkflowDraftClarification } from './requirements/clarification/prepare-workflow-draft-clarification.js';
+export { describeWorkflowDraftClarification } from './requirements/clarification/describe-workflow-draft-clarification.js';
+export { describeWorkflowDraftClarificationScopes } from './draft/requirements/describe-workflow-draft-clarification-scopes.js';
+export { createWorkflowDraftClarificationScopeSchema } from './schemas/create-workflow-draft-clarification-scope-schema.js';
+export { resolveWorkflowDraftClarificationScopes } from './draft/requirements/resolve-workflow-draft-clarification-scopes.js';
+export { describeWorkflowDraftNativeReferenceRepair } from './draft/edits/native/repairs/describe-workflow-draft-native-reference-repair.js';
+export { resolveWorkflowDraftNativeReferenceRepair } from './draft/edits/native/repairs/resolve-workflow-draft-native-reference-repair.js';
+export { createWorkflowDraftNativeReferenceRepairSchema } from './schemas/workflow-draft-native-reference-repair-schema.js';
+export { describeWorkflowDraftNativeParameterEdit } from './draft/edits/native/describe-workflow-draft-native-parameter-edit.js';
+export { resolveWorkflowDraftNativeParameterEditTargets } from './draft/edits/native/resolve-workflow-draft-native-parameter-edit-targets.js';
+export { validateWorkflowDraftNativeParameterEditContract } from './draft/edits/native/validate-workflow-draft-native-parameter-edit-contract.js';
+export { resolveWorkflowDraftNativeParameterEdits } from './draft/edits/native/resolve-workflow-draft-native-parameter-edits.js';
+export { createWorkflowDraftNativeParameterEditProposalSchema } from './schemas/workflow-draft-native-parameter-edit-schema.js';
+export { createWorkflowDraftNativeParameterEditValuesSchema } from './schemas/create-workflow-draft-native-parameter-edit-values-schema.js';
+export { describeWorkflowDraftConnectionEdit } from './draft/edits/connections/describe-workflow-draft-connection-edit.js';
+export { resolveWorkflowDraftConnectionEdit } from './draft/edits/connections/resolve-workflow-draft-connection-edit.js';
+export { resolveWorkflowDraftTerminalRemoval } from './draft/edits/connections/resolve-workflow-draft-terminal-removal.js';
+export type * from './types/workflow-draft-terminal-removal.js';
+export { createWorkflowDraftConnectionEditProposalSchema } from './schemas/workflow-draft-connection-edit-schema.js';
+export { stageWorkflowDraftEdit } from './draft/edits/stage-workflow-draft-edit.js';
+export { describeWorkflowDraftApiBindingEdit } from './draft/edits/bindings/describe-workflow-draft-api-binding-edit.js';
+export { resolveWorkflowDraftApiBindingEdit } from './draft/edits/bindings/resolve-workflow-draft-api-binding-edit.js';
+export { createWorkflowDraftApiBindingEditProposalSchema } from './schemas/workflow-draft-api-binding-edit-schema.js';
+export type * from './types/workflow-draft-api-input-edit.js';
+export { describeWorkflowDraftApiInputEdit } from './draft/edits/inputs/describe-workflow-draft-api-input-edit.js';
+export { createWorkflowDraftApiInputEditContract } from './draft/edits/inputs/create-workflow-draft-api-input-edit-contract.js';
+export { validateWorkflowDraftApiInputEditContract } from './draft/edits/inputs/validate-workflow-draft-api-input-edit-contract.js';
+export { createWorkflowDraftApiInputEditProposalSchema } from './schemas/workflow-draft-api-input-edit-proposal-schema.js';
+export { createWorkflowDraftApiInputEditValuesSchema } from './schemas/create-workflow-draft-api-input-edit-values-schema.js';
+export { resolveWorkflowDraftApiInputEdits } from './draft/edits/inputs/resolve-workflow-draft-api-input-edits.js';
+export { prepareWorkflowDraftEdit } from './draft/edits/prepare-workflow-draft-edit.js';
+export { assembleWorkflowDraftEdit } from './draft/edits/assemble-workflow-draft-edit.js';
+export { WorkflowDraftEditAssemblyError } from './draft/edits/workflow-draft-edit-assembly-error.js';
+export { describeWorkflowDraftEditContext } from './draft/edits/describe-workflow-draft-edit-context.js';
+export { createWorkflowDraftEditPlan } from './draft/edits/create-workflow-draft-edit-plan.js';
+export { resolveWorkflowDraftEditOptions } from './draft/edits/resolve-workflow-draft-edit-options.js';
+export { validateWorkflowDraftEditPlan } from './draft/edits/validate-workflow-draft-edit-plan.js';
+export { createWorkflowDraftEditProposalSchema } from './schemas/create-workflow-draft-edit-proposal-schema.js';
+export { createWorkflowDraft } from './draft/create-workflow-draft.js';
+export { validateWorkflowDraft } from './draft/validate-workflow-draft.js';
+export { resolveWorkflowDraftMaterials } from './draft/resolve-workflow-draft-materials.js';
+export { inspectDraftReadiness } from './draft/inspect-draft-readiness.js';
+export { analyzeDraftChangeImpact } from './draft/impact/analyze-draft-change-impact.js';
+export { applyDraftChangeSet } from './draft/changes/apply-draft-change-set.js';
+export { approveWorkflowDraft } from './draft/approve-workflow-draft.js';
+export type * from './types/planning-evidence.js';
+export type * from './types/workflow-clarification.js';
+export { describeWorkflowPlanningContext } from './planning/evidence/describe-workflow-planning-context.js';
+export { validateWorkflowPlanningEvidence } from './planning/evidence/validate-workflow-planning-evidence.js';
+export { createWorkflowRequirementsProposalSchema } from './schemas/create-workflow-requirements-proposal-schema.js';
+export { readClarificationQuestionLimits } from './requirements/configuration/read-clarification-question-limits.js';
+export { resolveWorkflowClarificationOptions } from './requirements/configuration/resolve-workflow-clarification-options.js';
+export { createWorkflowClarificationRound } from './requirements/clarification/create-workflow-clarification-round.js';
+export { validateWorkflowClarificationRound } from './requirements/clarification/validate-workflow-clarification-round.js';
+export { resolveWorkflowClarificationReplies } from './requirements/clarification/resolve-workflow-clarification-replies.js';
 export type * from './types/api-arguments.js';
 export { validateApiArguments } from './arguments/validate-api-arguments.js';
-export { listApiRequestMediaTypes } from './arguments/list-api-request-media-types.js';
-export { selectDefaultApiRequestMediaType } from './arguments/select-default-api-request-media-type.js';
+export { listApiRequestMediaTypes } from './arguments/media/list-api-request-media-types.js';
+export { selectDefaultApiRequestMediaType } from './arguments/media/select-default-api-request-media-type.js';
+export type * from './types/api-request-media-type-decision.js';
+export { describeApiRequestMediaTypeContext } from './arguments/media/describe-api-request-media-type-context.js';
+export { createApiRequestMediaTypeDecision } from './arguments/media/create-api-request-media-type-decision.js';
+export { validateApiRequestMediaTypeDecision } from './arguments/media/validate-api-request-media-type-decision.js';
 export type * from './types/openapi.js';
 export type * from './types/inbound.js';
 export type * from './types/workflow-plan.js';
+export type * from './types/native-parameter-reference.js';
+export { describeNativeReferenceBindings } from './workflow/describe-native-reference-bindings.js';
+export { inspectNativeReferenceStructure } from './workflow/inspect-native-reference-structure.js';
+export { resolveNativeMaterialSnapshot } from './workflow/resolve-native-material-snapshot.js';
+export { inspectNativeNodeConfigurationReadiness } from './workflow/planning/resolve-native-configuration-materials.js';
+export { describeNativeInstanceDependencies, resolveNativeInstanceDependencies, validateNativeInstanceDependencies, } from './workflow/planning/resolve-native-instance-dependencies.js';
+export { createNativeInstanceDependenciesSchema } from './schemas/native-instance-dependencies-schema.js';
+export type * from './types/native-instance-dependencies.js';
+export { resolveWorkflowDraftNativeSnapshot } from './draft/resolve-workflow-draft-native-snapshot.js';
+export { describeWorkflowDraftNativeNodeAddition } from './draft/edits/native/additions/describe-workflow-draft-native-node-addition.js';
+export { describeWorkflowDraftNativeNodeAdditionReadiness } from './draft/edits/native/additions/describe-workflow-draft-native-node-addition-readiness.js';
+export { describeWorkflowDraftRequirementHistory } from './draft/requirements/history/describe-workflow-draft-requirement-history.js';
+export { createWorkflowDraftEditCandidateContext } from './draft/requirements/create-workflow-draft-edit-candidate-context.js';
+export { resolveWorkflowPlanningMessages } from './planning/evidence/resolve-workflow-planning-messages.js';
+export type * from './types/workflow-draft-requirement-history.js';
+export { createWorkflowDraftNativeNodeAdditionSchema } from './schemas/workflow-draft-native-node-addition-schema.js';
+export { createWorkflowDraftNativeNodeParameterOwnershipSchema } from './schemas/workflow-draft-native-node-addition-schema.js';
+export { resolveWorkflowDraftNativeNodeParameterOwnership, validateWorkflowDraftNativeNodeParameterOwnershipContract, } from './draft/edits/native/additions/resolve-workflow-draft-native-node-parameter-ownership.js';
+export { resolveWorkflowDraftNativeNodeAddition } from './draft/edits/native/additions/resolve-workflow-draft-native-node-addition.js';
+export type * from './types/workflow-draft-native-node-addition.js';
+export type * from './types/workflow-draft-native-dependencies.js';
+export { createWorkflowDraftNativeDependenciesSchema } from './schemas/workflow-draft-native-dependencies-schema.js';
+export { describeWorkflowDraftNativeDependencies, resolveWorkflowDraftNativeDependencies, validateWorkflowDraftNativeDependencies, validateWorkflowDraftNativeDependencyResolutions, } from './draft/edits/native/additions/resolve-workflow-draft-native-dependencies.js';
+export type * from './types/workflow-draft-api-call-planning.js';
+export type * from './types/workflow-draft-api-binding-intent.js';
+export { describeWorkflowDraftApiBindingIntent } from './draft/edits/api/describe-workflow-draft-api-binding-intent.js';
+export { createWorkflowDraftApiBindingIntentSchema } from './schemas/workflow-draft-api-binding-intent-schema.js';
+export { resolveWorkflowDraftApiBindingIntent } from './draft/edits/api/resolve-workflow-draft-api-binding-intent.js';
+export { describeWorkflowDraftApiCallBindings } from './draft/edits/api/describe-workflow-draft-api-call-bindings.js';
+export type * from './types/workflow-draft-api-literal-sources.js';
+export { describeWorkflowDraftApiCallPlanning } from './draft/edits/api/describe-workflow-draft-api-call-planning.js';
+export { createWorkflowDraftApiCallBindingsSchema } from './schemas/workflow-draft-api-call-bindings-schema.js';
+export { resolveWorkflowDraftApiCallBindings } from './draft/edits/api/resolve-workflow-draft-api-call-bindings.js';
+export { describeWorkflowDraftApiCallArguments } from './draft/edits/api/describe-workflow-draft-api-call-arguments.js';
+export { createWorkflowDraftApiCallArgumentsSchema } from './schemas/workflow-draft-api-call-arguments-schema.js';
+export { resolveWorkflowDraftApiCallArguments } from './draft/edits/api/resolve-workflow-draft-api-call-arguments.js';
+export type * from './types/workflow-draft-source-evidence.js';
+export type * from './types/workflow-draft-native-materials.js';
+export { NativeMaterialResolutionError } from './workflow/native-material-resolution-error.js';
+export type * from './types/native-material-snapshot.js';
 export { validateWorkflowGraphPlan } from './workflow/validate-workflow-graph-plan.js';
 export { createWorkflowGraphPlan } from './workflow/create-workflow-graph-plan.js';
 export type * from './types/api-bindings.js';
+export type * from './types/api-binding-planning.js';
+export type * from './types/native-node-planning.js';
+export type * from './types/workflow-connection-planning.js';
+export type * from './types/workflow-planning-materials.js';
+export type * from './types/workflow-graph-planning.js';
+export { describeWorkflowGraphPlanning } from './workflow/graphs/describe-workflow-graph-planning.js';
+export { createWorkflowGraphPlanningResult } from './workflow/graphs/create-workflow-graph-planning-result.js';
+export { createWorkflowGraphPlanningRecord } from './workflow/graphs/create-workflow-graph-planning-record.js';
+export { validateWorkflowGraphPlanningRecord } from './workflow/graphs/validate-workflow-graph-planning-record.js';
+export { prepareWorkflowConnectionMaterials } from './workflow/connections/prepare-workflow-connection-materials.js';
+export { describeWorkflowConnectionPlanning } from './workflow/connections/describe-workflow-connection-planning.js';
+export { createWorkflowConnectionPlan } from './workflow/connections/create-workflow-connection-plan.js';
+export { projectWorkflowConnectionDecision } from './workflow/connections/project-workflow-connection-decision.js';
+export { createWorkflowConnectionPlanningRecord } from './workflow/connections/create-workflow-connection-planning-record.js';
+export { validateWorkflowConnectionPlanningRecord } from './workflow/connections/validate-workflow-connection-planning-record.js';
+export { describeNativeNodePlanning } from './workflow/planning/describe-native-node-planning.js';
+export { createNativePlanningCapabilityMaterial } from './workflow/planning/create-native-planning-capability-material.js';
+export { captureNativePlanningCapability } from './workflow/planning/capture-native-planning-capability.js';
+export { createPreparedNativeNodeMaterials } from './workflow/planning/create-prepared-native-node-materials.js';
+export { assembleNativeNodeMaterials } from './workflow/planning/assemble-native-node-materials.js';
+export { createNativeNodePlan } from './workflow/planning/create-native-node-plan.js';
+export { resolveNativeInstanceSelection, describeNativeInstanceSelection, } from './workflow/planning/resolve-native-instance-selection.js';
+export { describeNativeNodeConfiguration, resolveNativeNodeParameters, } from './workflow/planning/describe-native-node-configuration.js';
+export { createNativeInstanceSelectionSchema, createNativeNodeParametersSchema, } from './schemas/native-instance-planning-schema.js';
+export { createNativeNodePlanningRecord } from './workflow/planning/create-native-node-planning-record.js';
+export { validateNativeNodePlanningRecord } from './workflow/planning/validate-native-node-planning-record.js';
+export { describeApiBindingPlanning } from './bindings/planning/describe-api-binding-planning.js';
+export { createApiBindingPlanningRecord } from './bindings/planning/create-api-binding-planning-record.js';
+export { validateApiBindingPlanningRecord } from './bindings/planning/validate-api-binding-planning-record.js';
 export type * from './types/node-output.js';
 export { createNativeOutputContracts } from './workflow/create-native-output-contracts.js';
 export { createReviewableNodeContracts } from './workflow/create-reviewable-node-contracts.js';
 export { validateWorkflowEdges } from './workflow/validate-workflow-edges.js';
 export { validateNativeOutputContracts } from './bindings/validate-native-output-contracts.js';
 export { parseNativeNodeParameters } from './workflow/parse-native-node-parameters.js';
+export { resolveNativeStructureParameters } from './workflow/resolve-native-structure-parameters.js';
+export type * from './types/native-runtime-inputs.js';
+export { collectNativeRuntimeInputSlots } from './inputs/native/collect-native-runtime-input-slots.js';
+export { inspectNativeRuntimeInputs } from './inputs/native/inspect-native-runtime-inputs.js';
+export { createNativeRuntimeParameterMaterializations } from './inputs/native/create-native-runtime-parameter-materialization.js';
+export { materializeNativeRuntimeParameters } from './inputs/native/materialize-native-runtime-parameters.js';
+export { createWorkflowRuntimeInputsSchema } from './schemas/create-workflow-runtime-inputs-schema.js';
 export { createWorkflowPlanningCapabilities } from './workflow/create-workflow-planning-capabilities.js';
 export { validateNativeApiResponseReferences } from './workflow/validate-native-api-response-references.js';
 export type * from './types/workflow-capability-planning.js';
@@ -33,6 +230,7 @@ export { validateApiBindingPlan } from './bindings/validate-api-binding-plan.js'
 export { materializeApiArguments } from './bindings/materialize-api-arguments.js';
 export { createApiRequestSchema } from './schemas/create-api-request-schema.js';
 export { validateApiBindingAssignments } from './bindings/validate-api-binding-assignments.js';
+export { validateApiBindingAssignment } from './bindings/validate-api-binding-assignment.js';
 export { validateApiBindingGaps } from './bindings/validate-api-binding-gaps.js';
 export type * from './types/reviewable-workflow.js';
 export { createReviewableWorkflowGraphPlan } from './workflow/create-reviewable-workflow-graph-plan.js';
@@ -47,3 +245,11 @@ export { createNativeArrayItemSchema } from './bindings/create-native-array-item
 export { createResponseValueSchema } from './openapi/response/create-response-value-schema.js';
 export { listApiResponsePointers } from './openapi/response/list-api-response-pointers.js';
 export type * from './types/api-response-pointers.js';
+export type * from './types/workflow-review-suggestions.js';
+export { describeWorkflowReviewSuggestions } from './review/suggestions/describe-workflow-review-suggestions.js';
+export { createWorkflowReviewSuggestions } from './review/suggestions/create-workflow-review-suggestions.js';
+export { validateWorkflowReviewSuggestions } from './review/suggestions/validate-workflow-review-suggestions.js';
+export { adoptWorkflowReviewSuggestion } from './review/suggestions/adopt-workflow-review-suggestion.js';
+export { readWorkflowReviewSuggestionLimits } from './review/suggestions/read-workflow-review-suggestion-limits.js';
+export { createWorkflowReviewSuggestionsProposalSchema } from './schemas/create-workflow-review-suggestions-proposal-schema.js';
+export { workflowReviewSuggestionLimitsSchema, workflowReviewSuggestionOptionsSchema, } from './schemas/workflow-review-suggestion-settings-schema.js';