@openapi-flow/core 0.3.1 → 0.3.3

package/README.md

@@ -2,7 +2,9 @@
 
 Zod `^4.6.5` is a required peer, shared with the host rather than installed as a separately pinned runtime copy. Development tests use 4.6.5; the strict installed-consumer check also uses the host's 4.6.7. This preserves the public schema type boundary without casts or dependency overrides.
 
-Version **0.3.1**. Canonical draft, clarification and runtime-input APIs described below are included in this release. Ajv 8.20.0 does not correctly validate a declared `properties.__proto__`; generated validation may reject valid data or omit that property's constraints. This previously accepted limitation remains unchanged, without renaming data or skipping its failing regression. See the [release record](https://github.com/carefreelife98/openapi-flow/blob/main/docs/releases/0.3.1.md).
+Version **0.3.3**. Canonical draft, clarification and runtime-input APIs described below are included in this release. Ajv 8.20.0 does not correctly validate a declared `properties.__proto__`; generated validation may reject valid data or omit that property's constraints. This previously accepted limitation remains unchanged, without renaming data or skipping its failing regression. See the [release record](https://github.com/carefreelife98/openapi-flow/blob/main/docs/releases/0.3.3.md).
+
+Native and fixed-material connection planning accept the optional, existing `WorkflowEntryPointContract` as `entrypoint`. Core validates and snapshots this owner-provided start alongside the other inputs; it does not infer one when absent, add a selectable trigger or let model output modify it.
 
 Connection planning accepts explicit current `deferredApiInputIds` derived with `collectDeferredApiInputSlots`. Missing inputs remain absent and require canonical template preflight before execution; supplied values and the full DAG are still validated. See [input deferral](https://github.com/carefreelife98/openapi-flow/blob/main/docs/deferred-connection-planning.md).
 

package/dist/draft/edits/inputs/create-workflow-draft-api-input-edit-contract.js

@@ -62,7 +62,9 @@ export function createWorkflowDraftApiInputEditContract(input) {
     };
     return {
         id: 'api-input-edit:' +
-            createHash('sha256').update(JSON.stringify(fields)).digest('hex'),
+            createHash('sha256')
+                .update(JSON.stringify([described.stageFingerprint, fields]))
+                .digest('hex'),
         ...fields,
     };
 }

package/dist/draft/edits/inputs/describe-workflow-draft-api-input-edit.js

@@ -1,31 +1,39 @@
-import { validateWorkflowDraftEditPlan } from '../validate-workflow-draft-edit-plan.js';
+import { stageWorkflowDraftEdit } from '../stage-workflow-draft-edit.js';
 import { createApiRequestSchema } from '../../../schemas/create-api-request-schema.js';
 import { resolveWorkflowDraftApiMaterials } from '../../resolve-workflow-draft-api-materials.js';
 import { resolveWorkflowPlanningMessages } from '../../../planning/evidence/resolve-workflow-planning-messages.js';
 export function describeWorkflowDraftApiInputEdit(input) {
-    validateWorkflowDraftEditPlan(input);
+    const stage = stageWorkflowDraftEdit({
+        ...input,
+        resolutions: input.resolutions === undefined ? [] : input.resolutions,
+    });
     const step = input.plan.steps.find((step) => step.id === input.stepId);
     if (!step || step.decision.kind !== 'revise-api-inputs')
         throw new Error('API input edit stepId must identify a revise-api-inputs decision');
     const nodeId = step.decision.nodeId;
-    if (input.plan.steps.some((other) => other.decision.kind === 'replace-api-operation' &&
-        other.decision.nodeId === nodeId))
-        throw new Error('API input edit must use a draft after its operation replacement is resolved');
-    const original = input.draft.apiCalls.find((call) => call.id === nodeId);
+    if (!stage.pendingResolutionStepIds.includes(step.id))
+        throw new Error('API input edit step already has a supplied result; remove that result explicitly before replanning');
+    if (stage.blockedSourceNodeIds.includes(nodeId))
+        throw new Error(`API input edit target ${nodeId} is blocked by an unresolved contract or requirement`);
+    const stagedCall = stage.content.apiCalls.find((call) => call.id === nodeId);
+    if (stagedCall === undefined)
+        throw new Error(`API input edit target ${nodeId} has no staged API instance`);
     const material = resolveWorkflowDraftApiMaterials({
-        content: input.draft,
+        content: stage.content,
         context: input.context,
-    }).find((item) => item.callId === original.id);
+    }).find((item) => item.callId === stagedCall.id);
     const call = structuredClone({
-        ...original,
+        ...stagedCall,
         ...(input.requestMediaType === undefined
             ? {}
             : { requestMediaType: input.requestMediaType }),
     });
     return {
+        stageFingerprint: stage.fingerprint,
         stepId: step.id,
         instruction: step.decision.instruction,
         call,
+        operation: structuredClone(material.operation),
         requestSchema: createApiRequestSchema({
             operation: material.operation,
             requestMediaType: call.requestMediaType,

package/dist/draft/edits/inputs/resolve-workflow-draft-api-input-edits.js

@@ -1,8 +1,8 @@
 import { createWorkflowDraftApiInputEditValuesSchema } from '../../../schemas/create-workflow-draft-api-input-edit-values-schema.js';
+import { createWorkflowDraftApiInputEditAnswersSchema } from '../../../schemas/create-workflow-draft-api-input-edit-answers-schema.js';
 import { describeWorkflowDraftApiInputEdit } from './describe-workflow-draft-api-input-edit.js';
 import { validateWorkflowPlanningEvidence } from '../../../planning/evidence/validate-workflow-planning-evidence.js';
 import { applyWorkflowDraftApiInputEdits } from '../values/apply-workflow-draft-api-input-edits.js';
-import { resolveWorkflowDraftApiMaterials } from '../../resolve-workflow-draft-api-materials.js';
 import { validateApiArguments } from '../../../arguments/validate-api-arguments.js';
 import { orderWorkflowDraftValueEdits } from '../values/order-workflow-draft-value-edits.js';
 import { verifyApiInputLiteralSource } from '../../../arguments/sources/verify-api-input-literal-source.js';
@@ -10,6 +10,12 @@ import { verifyApiInputLiteralSource } from '../../../arguments/sources/verify-a
 export function resolveWorkflowDraftApiInputEdits(input) {
     const output = createWorkflowDraftApiInputEditValuesSchema(input).parse(input.output);
     const described = describeWorkflowDraftApiInputEdit(input);
+    const confirmedAnswers = input.confirmedAnswers === undefined
+        ? undefined
+        : structuredClone(createWorkflowDraftApiInputEditAnswersSchema(input).parse(input.confirmedAnswers));
+    const human = confirmedAnswers === undefined
+        ? {}
+        : { confirmedAnswers: structuredClone(confirmedAnswers) };
     const sets = [];
     const removals = [];
     const pendingTargets = [];
@@ -25,7 +31,15 @@ export function resolveWorkflowDraftApiInputEdits(input) {
                 evidence: answer.explanation.evidence,
             });
         if (answer.status === 'needs-input') {
-            pendingTargets.push(structuredClone(target));
+            const confirmed = confirmedAnswers?.answers.find((item) => item.targetId === target.id);
+            if (confirmed === undefined)
+                pendingTargets.push(structuredClone(target));
+            else
+                sets.push({
+                    kind: 'set',
+                    pointer: target.pointer,
+                    value: structuredClone(confirmed.value),
+                });
             continue;
         }
         const message = described.messages.find((message) => message.id === answer.source.messageId);
@@ -45,16 +59,18 @@ export function resolveWorkflowDraftApiInputEdits(input) {
             contractId: input.contract.id,
             values: output,
             pendingTargets,
+            ...human,
         };
     // Targets address the original value. Set before deletion; remove higher array
     // indices first so one deletion does not retarget another original index.
     const edits = orderWorkflowDraftValueEdits([...sets, ...removals]);
-    const material = resolveWorkflowDraftApiMaterials({
-        content: input.draft,
-        context: input.context,
-    }).find((item) => item.callId === described.call.id);
     const selected = {
-        ...material,
+        callId: described.call.id,
+        operation: described.operation,
+        bindings: described.call.bindings,
+        ...(described.call.requestedInputs === undefined
+            ? {}
+            : { requestedInputs: described.call.requestedInputs }),
         requestMediaType: described.call.requestMediaType,
     };
     const values = applyWorkflowDraftApiInputEdits(described.call.values, edits, selected);
@@ -63,6 +79,7 @@ export function resolveWorkflowDraftApiInputEdits(input) {
         status: 'ready',
         contractId: input.contract.id,
         values: output,
+        ...human,
         resolution: {
             stepId: input.stepId,
             kind: 'api-inputs',

package/dist/public-api.d.ts

@@ -101,6 +101,8 @@ export { createWorkflowDraftApiInputEditContract } from './draft/edits/inputs/cr
 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 { createWorkflowDraftApiInputEditAnswersSchema } from './schemas/create-workflow-draft-api-input-edit-answers-schema.js';
+export { workflowDraftApiInputEditAnswersSchema } from './schemas/workflow-draft-api-input-edit-answers-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';

package/dist/public-api.js

@@ -72,6 +72,8 @@ export { createWorkflowDraftApiInputEditContract } from './draft/edits/inputs/cr
 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 { createWorkflowDraftApiInputEditAnswersSchema } from './schemas/create-workflow-draft-api-input-edit-answers-schema.js';
+export { workflowDraftApiInputEditAnswersSchema } from './schemas/workflow-draft-api-input-edit-answers-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';

package/dist/schemas/create-workflow-draft-api-input-edit-answers-schema.d.ts

@@ -0,0 +1,3 @@
+import type { WorkflowDraftApiInputEditAnswerSchemaInput, WorkflowDraftApiInputEditAnswersSchema } from '../types/workflow-draft-api-input-edit.js';
+/** Human replies own values only for targets the original proposal left pending. */
+export declare function createWorkflowDraftApiInputEditAnswersSchema(input: WorkflowDraftApiInputEditAnswerSchemaInput): WorkflowDraftApiInputEditAnswersSchema;

package/dist/schemas/create-workflow-draft-api-input-edit-answers-schema.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import { createWorkflowDraftApiInputEditValuesSchema } from './create-workflow-draft-api-input-edit-values-schema.js';
+import { createWorkflowDraftApiInputEditTargetValueSchema } from './create-workflow-draft-api-input-edit-target-value-schema.js';
+import { createSchemaResourceContext } from '../bindings/resources/create-schema-resource-context.js';
+import { workflowDraftApiInputEditAnswerSchema, workflowDraftApiInputEditAnswersSchema, } from './workflow-draft-api-input-edit-answers-schema.js';
+/** Human replies own values only for targets the original proposal left pending. */
+export function createWorkflowDraftApiInputEditAnswersSchema(input) {
+    const output = createWorkflowDraftApiInputEditValuesSchema(input).parse(input.output);
+    const targets = input.contract.targets
+        .filter((target) => target.kind === 'set')
+        .filter((target) => output.values[target.id].status === 'needs-input');
+    const resources = createSchemaResourceContext(input.contract.schemaResource);
+    const wire = resources.bundleStaticProjections(Object.fromEntries(targets.map((target) => [target.id, target.schema])));
+    const alternatives = targets.map((target) => workflowDraftApiInputEditAnswerSchema.extend({
+        targetId: z
+            .literal(target.id)
+            .describe(`The pending input target ${target.pointer} in this contract.`),
+        value: createWorkflowDraftApiInputEditTargetValueSchema(target, resources, input.contract.nodeId, wire.projections[target.id]),
+    }));
+    const answers = alternatives.length === 0
+        ? z.array(z.never()).max(0)
+        : z
+            .array(alternatives.length === 1 ? alternatives[0] : z.union(alternatives))
+            .superRefine((items, context) => {
+            if (new Set(items.map((item) => item.targetId)).size !== items.length)
+                context.addIssue({
+                    code: 'custom',
+                    message: 'Typed API edit answers require distinct pending target IDs',
+                });
+        });
+    return workflowDraftApiInputEditAnswersSchema
+        .extend({
+        contractId: z.literal(input.contract.id),
+        answers,
+    })
+        .meta({
+        $defs: wire.definitions,
+    });
+}

package/dist/schemas/create-workflow-draft-api-input-edit-target-value-schema.d.ts

@@ -0,0 +1,5 @@
+import type { WorkflowDraftApiInputEditTarget } from '../types/workflow-draft-api-input-edit.js';
+import type { SchemaResourceContext } from '../types/schema-resource.js';
+import type { BindingSchema } from '../types/api-bindings.js';
+/** The same original OAS value assertions for model proposals and explicit typed replies. */
+export declare function createWorkflowDraftApiInputEditTargetValueSchema(target: WorkflowDraftApiInputEditTarget, resources: SchemaResourceContext, nodeId: string, projection: BindingSchema): import("zod").ZodType<import("../public-api.js").JsonValue, unknown, import("zod/v4/core").$ZodTypeInternals<import("../public-api.js").JsonValue, unknown>>;

package/dist/schemas/create-workflow-draft-api-input-edit-target-value-schema.js

@@ -0,0 +1,24 @@
+import { createOasValueValidator } from '../openapi/common/create-oas-value-validator.js';
+import { createOasValueValidationSchema } from './create-oas-value-validation-schema.js';
+/** The same original OAS value assertions for model proposals and explicit typed replies. */
+export function createWorkflowDraftApiInputEditTargetValueSchema(target, resources, nodeId, projection) {
+    if (target.kind !== 'set')
+        throw new Error(`API input edit set target ${target.pointer} has no OAS schema`);
+    const assertions = typeof target.schema === 'boolean'
+        ? target.schema
+            ? {}
+            : { not: {} }
+        : target.schema;
+    const source = `API input edit ${nodeId}${target.pointer}`;
+    const wireAssertions = typeof projection === 'boolean'
+        ? projection
+            ? {}
+            : { not: {} }
+        : projection;
+    return createOasValueValidationSchema(createOasValueValidator({ ...assertions, $defs: { resource: resources.root } }, 'draft-2020-12', source), source).meta(typeof wireAssertions.$ref === 'string'
+        ? wireAssertions
+        : {
+            ...wireAssertions,
+            description: 'The complete actual value explicitly supplied by the current user request. Preserve its type. No examples, defaults, old field values or invented placeholders.',
+        });
+}

package/dist/schemas/create-workflow-draft-api-input-edit-values-schema.js

@@ -1,31 +1,9 @@
 import { z } from 'zod';
 import { validateWorkflowDraftApiInputEditContract } from '../draft/edits/inputs/validate-workflow-draft-api-input-edit-contract.js';
 import { createWorkflowDraftEditMessageFields } from './workflow-draft-edit-message-fields.js';
-import { createOasValueValidator } from '../openapi/common/create-oas-value-validator.js';
-import { createOasValueValidationSchema } from './create-oas-value-validation-schema.js';
+import { createWorkflowDraftApiInputEditTargetValueSchema } from './create-workflow-draft-api-input-edit-target-value-schema.js';
 import { createSchemaResourceContext } from '../bindings/resources/create-schema-resource-context.js';
 import { apiInputLiteralSourceSchema } from './api-input-literal-source-schema.js';
-function targetValueSchema(target, resources, nodeId, projection) {
-    if (target.kind !== 'set')
-        throw new Error(`API input edit set target ${target.pointer} has no OAS schema`);
-    const assertions = typeof target.schema === 'boolean'
-        ? target.schema
-            ? {}
-            : { not: {} }
-        : target.schema;
-    const source = `API input edit ${nodeId}${target.pointer}`;
-    const wireAssertions = typeof projection === 'boolean'
-        ? projection
-            ? {}
-            : { not: {} }
-        : projection;
-    return createOasValueValidationSchema(createOasValueValidator({ ...assertions, $defs: { resource: resources.root } }, 'draft-2020-12', source), source).meta(typeof wireAssertions.$ref === 'string'
-        ? wireAssertions
-        : {
-            ...wireAssertions,
-            description: 'The complete actual value explicitly supplied by the current user request. Preserve its type. No examples, defaults, old field values or invented placeholders.',
-        });
-}
 /** Only selected set-values are model-owned; per-field OAS assertions stay intact. */
 export function createWorkflowDraftApiInputEditValuesSchema(input, messageSchema) {
     validateWorkflowDraftApiInputEditContract(input);
@@ -43,7 +21,7 @@ export function createWorkflowDraftApiInputEditValuesSchema(input, messageSchema
             z.union([
                 z.strictObject({
                     status: z.literal('provided'),
-                    value: targetValueSchema(target, resources, input.contract.nodeId, wire.projections[target.id]),
+                    value: createWorkflowDraftApiInputEditTargetValueSchema(target, resources, input.contract.nodeId, wire.projections[target.id]),
                     source: apiInputLiteralSourceSchema.extend({
                         messageId: z.enum(input.requestMessageIds),
                     }),

package/dist/schemas/create-workflow-draft-edit-proposal-schema.js

@@ -7,7 +7,7 @@ export function createWorkflowDraftEditProposalSchema(options, sources) {
         reason: z
             .string()
             .min(1)
-            .describe('A short user-facing reason, not chain-of-thought.'),
+            .describe("A short user-facing reason in the current user's language, not chain-of-thought. Do not translate identifiers, literal values or source quotations."),
         evidence: z.array(sources.evidenceSchema).min(1),
     });
     const fields = {

package/dist/schemas/native-node-planning-record-schema.d.ts

@@ -4,6 +4,10 @@ export declare const nativeNodePlanningOptionsSchema: z.ZodObject<{
     planId: z.ZodString;
     scenario: z.ZodString;
     allowRuntimeParameters: z.ZodOptional<z.ZodBoolean>;
+    entrypoint: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export declare const nativePlanningProposalSchema: z.ZodObject<{
     nativeNodes: z.ZodArray<z.ZodObject<{

package/dist/schemas/native-node-planning-record-schema.js

@@ -1,10 +1,11 @@
 import { z } from 'zod';
-import { planningEvidenceTextSchema } from './planning-evidence-schema.js';
+import { planningEvidenceTextSchema, workflowEntryPointContractSchema, } from './planning-evidence-schema.js';
 import { workflowDraftNativeNodeSchema } from './workflow-draft-schema.js';
 export const nativeNodePlanningOptionsSchema = z.strictObject({
     planId: planningEvidenceTextSchema,
     scenario: planningEvidenceTextSchema,
     allowRuntimeParameters: z.boolean().optional(),
+    entrypoint: workflowEntryPointContractSchema.optional(),
 });
 export const nativePlanningProposalSchema = z.strictObject({
     nativeNodes: z.array(workflowDraftNativeNodeSchema),

package/dist/schemas/workflow-connection-planning-schema.d.ts

@@ -4,6 +4,10 @@ import type { WorkflowPlanningSourceEvidence } from '../types/workflow-planning-
 import type { WorkflowPlanNodeContract } from '../types/workflow-plan.js';
 export declare const workflowConnectionIdentitySchema: z.ZodObject<{
     scenario: z.ZodString;
+    entrypoint: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export declare const workflowConnectionProposalSchema: z.ZodObject<{
     edges: z.ZodArray<z.ZodObject<{

package/dist/schemas/workflow-connection-planning-schema.js

@@ -1,9 +1,10 @@
 import { z } from 'zod';
-import { planningEvidenceTextSchema } from './planning-evidence-schema.js';
+import { planningEvidenceTextSchema, workflowEntryPointContractSchema, } from './planning-evidence-schema.js';
 import { workflowDraftNativeNodeSchema, workflowDraftEdgeSchema, } from './workflow-draft-schema.js';
 import { workflowReviewGapSchema, workflowBlockedCallSchema, } from './workflow-planning-material-schema.js';
 export const workflowConnectionIdentitySchema = z.strictObject({
     scenario: planningEvidenceTextSchema,
+    entrypoint: workflowEntryPointContractSchema.optional(),
 });
 export const workflowConnectionProposalSchema = z.strictObject({
     edges: z.array(workflowDraftEdgeSchema),

package/dist/schemas/workflow-draft-api-input-edit-answers-schema.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+/** Transport shape only. The contextual factory owns current-target and OAS checks. */
+export declare const workflowDraftApiInputEditAnswerSchema: z.ZodObject<{
+    targetId: z.ZodString;
+    value: z.ZodJSONSchema;
+}, z.core.$strict>;
+export declare const workflowDraftApiInputEditAnswersSchema: z.ZodObject<{
+    contractId: z.ZodString;
+    answers: z.ZodArray<z.ZodObject<{
+        targetId: z.ZodString;
+        value: z.ZodJSONSchema;
+    }, z.core.$strict>>;
+}, z.core.$strict>;

package/dist/schemas/workflow-draft-api-input-edit-answers-schema.js

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+/** Transport shape only. The contextual factory owns current-target and OAS checks. */
+export const workflowDraftApiInputEditAnswerSchema = z.strictObject({
+    targetId: z.string().min(1),
+    value: z.json(),
+});
+export const workflowDraftApiInputEditAnswersSchema = z.strictObject({
+    contractId: z.string().min(1),
+    answers: z.array(workflowDraftApiInputEditAnswerSchema),
+});

package/dist/schemas/workflow-draft-edit-message-fields.js

@@ -25,7 +25,7 @@ export function createWorkflowDraftEditMessageFields(messageIds, includeExplanat
                     reason: z
                         .string()
                         .min(1)
-                        .describe('Short user-facing reason, not chain-of-thought.'),
+                        .describe("Short user-facing reason in the current user's language, not chain-of-thought. Do not translate identifiers, literal values or source quotations."),
                     evidence: z.array(message).min(1),
                 }),
             }

package/dist/schemas/workflow-draft-edit-plan-schema.d.ts

@@ -21,13 +21,13 @@ export declare const workflowDraftEditPlanSchema: z.ZodObject<{
         decision: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
         newNodeId: z.ZodOptional<z.ZodString>;
         stages: z.ZodArray<z.ZodEnum<{
+            clarification: "clarification";
             "api-bindings": "api-bindings";
             "api-arguments": "api-arguments";
             "native-parameters": "native-parameters";
             requirements: "requirements";
             connections: "connections";
             "resolve-contracts": "resolve-contracts";
-            clarification: "clarification";
         }>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;

package/dist/types/native-node-planning.d.ts

@@ -1,4 +1,5 @@
 import type { ApiBindingMaterial } from './api-bindings.js';
+import type { WorkflowPlanningContext } from './planning-evidence.js';
 import type { z } from 'zod';
 import type { JsonValueObject } from './api-arguments.js';
 import type { JsonObject } from './openapi.js';
@@ -8,7 +9,7 @@ import type { NativeInstanceDependencyPlan, NativeNodeConfigurationDependencies
 import type { WorkflowNativeMaterialSources, MissingWorkflowNativeMaterialRequirement, ResolveNativeMaterialSnapshotInput } from './native-material-snapshot.js';
 import type { WorkflowReviewGap } from './reviewable-workflow.js';
 import type { PlannedNativeNode, WorkflowCapability, WorkflowPlanGap, WorkflowPlanNodeContract, NativeRuntimeParameterSelection } from './workflow-plan.js';
-export interface NativeNodePlanningInput {
+export interface NativeNodePlanningInput extends Pick<WorkflowPlanningContext, 'entrypoint'> {
     planId: string;
     scenario: string;
     capabilities?: WorkflowCapability[];
@@ -38,7 +39,7 @@ export interface NativePlanningApiMaterial {
     operation: ApiBindingMaterial['operation']['operation'];
     effective: ApiBindingMaterial['operation']['effective'];
 }
-export interface NativeNodePlanningContext {
+export interface NativeNodePlanningContext extends Pick<WorkflowPlanningContext, 'entrypoint'> {
     scenario: string;
     apiMaterials: NativePlanningApiMaterial[];
     preparedNativeNodes: PreparedNativeNodeMaterial[];

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

@@ -4,6 +4,7 @@ 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';
+import type { WorkflowPlanningContext } from './planning-evidence.js';
 export interface WorkflowConnectionMaterialInput extends WorkflowApiInputDeferral {
     materials?: ReviewableWorkflowApiMaterial[];
     capabilities?: WorkflowCapability[];
@@ -11,7 +12,7 @@ export interface WorkflowConnectionMaterialInput extends WorkflowApiInputDeferra
     gaps?: WorkflowReviewGap[];
     edges?: WorkflowPlanEdge[];
 }
-export interface WorkflowConnectionPlanningInput extends WorkflowConnectionMaterialInput {
+export interface WorkflowConnectionPlanningInput extends WorkflowConnectionMaterialInput, Pick<WorkflowPlanningContext, 'entrypoint'> {
     scenario: string;
 }
 export interface WorkflowConnectionMaterials extends WorkflowApiInputDeferral {
@@ -33,7 +34,7 @@ export interface WorkflowNativeParameterReadiness {
     /** Explicit runtime ownership, not missing plan-time values or unresolved graph gaps. */
     executionInputPointers: string[];
 }
-export interface WorkflowConnectionPlanningContext {
+export interface WorkflowConnectionPlanningContext extends Pick<WorkflowPlanningContext, 'entrypoint'> {
     scenario: string;
     nodes: WorkflowPlanNodeContract[];
     nativeNodes?: PreparedNativeNodeMaterial[];
@@ -45,7 +46,7 @@ export interface WorkflowConnectionPlanningContext {
     /** Code-derived missing values, never missing API capabilities or generated literals. */
     deferredApiInputs?: DeferredApiInputSlot[];
 }
-export interface WorkflowConnectionPlanningSnapshot extends WorkflowConnectionMaterials {
+export interface WorkflowConnectionPlanningSnapshot extends WorkflowConnectionMaterials, Pick<WorkflowPlanningContext, 'entrypoint'> {
     scenario: string;
 }
 export interface WorkflowConnectionPlanningDescription {

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

@@ -4,15 +4,20 @@ 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 { WorkflowDraftEditResolution, WorkflowDraftEditRepair } from './workflow-draft-edit-assembly.js';
+import type { ApiOperationContract } from './api-operation.js';
 import type { WorkflowDraftApiCall, WorkflowSourceMessage } from './workflow-draft.js';
 import type { JsonObject } from './openapi.js';
 import type { ApiInputLiteralSource } from './api-input-literal-source.js';
+import type { workflowDraftApiInputEditAnswerSchema, workflowDraftApiInputEditAnswersSchema } from '../schemas/workflow-draft-api-input-edit-answers-schema.js';
 export interface WorkflowDraftApiInputEditMaterial extends ApiBindingMaterial {
     requestedInputs?: string[];
 }
 export interface WorkflowDraftApiInputEditInput extends ValidateWorkflowDraftEditPlanInput {
     stepId: string;
+    /** Explicit completed materials in this same plan. Omission means none. */
+    resolutions?: WorkflowDraftEditResolution[];
+    repairs?: WorkflowDraftEditRepair[];
     /** Omission preserves the call's explicit existing media selection. */
     requestMediaType?: string;
 }
@@ -34,9 +39,11 @@ export type WorkflowDraftApiInputEditTarget = Omit<ProposedWorkflowDraftApiInput
     kind: 'remove';
 });
 export interface WorkflowDraftApiInputEditDescription {
+    stageFingerprint: string;
     stepId: string;
     instruction: string;
     call: WorkflowDraftApiCall;
+    operation: ApiOperationContract;
     requestSchema: JsonObject;
     messages: WorkflowSourceMessage[];
     includeExplanations: boolean;
@@ -72,10 +79,16 @@ export type WorkflowDraftApiInputEditValue = ({
 export interface WorkflowDraftApiInputEditValues {
     values: Record<string, WorkflowDraftApiInputEditValue>;
 }
-export interface ResolveWorkflowDraftApiInputEditsInput extends WorkflowDraftApiInputEditContractInput {
+export type WorkflowDraftApiInputEditAnswer = z.infer<typeof workflowDraftApiInputEditAnswerSchema>;
+export type WorkflowDraftApiInputEditAnswers = z.infer<typeof workflowDraftApiInputEditAnswersSchema>;
+export interface WorkflowDraftApiInputEditAnswerSchemaInput extends WorkflowDraftApiInputEditContractInput {
     output: WorkflowDraftApiInputEditValues;
 }
-export type WorkflowDraftApiInputEditResult = {
+export interface ResolveWorkflowDraftApiInputEditsInput extends WorkflowDraftApiInputEditAnswerSchemaInput {
+    /** Explicit user answers to pending targets, separate from the unchanged model output. */
+    confirmedAnswers?: WorkflowDraftApiInputEditAnswers;
+}
+export type WorkflowDraftApiInputEditResult = ({
     status: 'ready';
     contractId: string;
     values: WorkflowDraftApiInputEditValues;
@@ -87,5 +100,9 @@ export type WorkflowDraftApiInputEditResult = {
     contractId: string;
     values: WorkflowDraftApiInputEditValues;
     pendingTargets: WorkflowDraftApiInputEditTarget[];
+}) & {
+    /** Present only when the caller supplied an explicit typed reply. */
+    confirmedAnswers?: WorkflowDraftApiInputEditAnswers;
 };
 export type WorkflowDraftApiInputEditValuesSchema = z.ZodType<WorkflowDraftApiInputEditValues>;
+export type WorkflowDraftApiInputEditAnswersSchema = z.ZodType<WorkflowDraftApiInputEditAnswers>;

package/dist/workflow/connections/describe-workflow-connection-planning.js

@@ -8,9 +8,11 @@ import { createNativePlanningCapabilityMaterial } from '../planning/create-nativ
 import { prepareWorkflowConnectionMaterials } from './prepare-workflow-connection-materials.js';
 /** Capture declared data before awaiting the model; never clone opaque callbacks or forward audit metadata. */
 export function describeWorkflowConnectionPlanning(input) {
-    const { scenario } = workflowConnectionIdentitySchema.parse({
+    const identity = workflowConnectionIdentitySchema.parse({
         scenario: input.scenario,
+        ...(input.entrypoint === undefined ? {} : { entrypoint: input.entrypoint }),
     });
+    const { scenario } = identity;
     for (const field of [
         'materials',
         'capabilities',
@@ -37,7 +39,7 @@ export function describeWorkflowConnectionPlanning(input) {
         edges: structuredClone((input.edges === undefined ? [] : input.edges).map((edge) => workflowDraftEdgeSchema.parse(edge))),
     });
     const context = {
-        scenario,
+        ...structuredClone(identity),
         nodes: structuredClone(prepared.contracts),
         ...(prepared.nativeNodes.length
             ? {
@@ -71,7 +73,7 @@ export function describeWorkflowConnectionPlanning(input) {
             : { deferredApiInputs: structuredClone(prepared.deferredApiInputs) }),
     };
     return {
-        input: { ...prepared, scenario },
+        input: { ...prepared, ...identity },
         context,
         sources: structuredClone({
             materials,

package/dist/workflow/planning/describe-native-node-planning.js

@@ -10,6 +10,7 @@ export function describeNativeNodePlanning(input) {
         planId: input.planId,
         scenario: input.scenario,
         allowRuntimeParameters: input.allowRuntimeParameters,
+        ...(input.entrypoint === undefined ? {} : { entrypoint: input.entrypoint }),
     });
     const { capabilities, apiMaterials, preparedNativeNodes: prepared, } = captureWorkflowPlanningMaterials(input);
     const apiIds = apiMaterials.map((material) => material.callId);
@@ -28,6 +29,9 @@ export function describeNativeNodePlanning(input) {
         planningCapabilities,
         context: {
             scenario: options.scenario,
+            ...(options.entrypoint === undefined
+                ? {}
+                : { entrypoint: structuredClone(options.entrypoint) }),
             apiMaterials: apiMaterials.map(({ callId, operation, purpose }) => ({
                 callId,
                 ...(purpose === undefined ? {} : { purpose }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openapi-flow/core",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "license": "MIT",
   "description": "Engine-independent OpenAPI catalogs, operation contracts and typed request schemas",
   "keywords": [