@openapi-flow/core 0.3.1 → 0.3.2

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.2**. 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.2.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/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-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/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.2",
   "license": "MIT",
   "description": "Engine-independent OpenAPI catalogs, operation contracts and typed request schemas",
   "keywords": [