@openapi-flow/core 0.3.6 → 0.3.8

package/README.md

@@ -2,7 +2,7 @@
 
 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.5**. Canonical draft, clarification and runtime-input APIs described below are included in this release source. Original-choice follow-ups now derive their display and typed reply in Core. 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.5.md) for publication and host status.
+Version **0.3.8**. Canonical draft, clarification and runtime-input APIs described below are included in this release source. Original-choice follow-ups derive their display and typed reply in Core. This patch aligns the three libraries for the new n8n response-object capability without adding a Core-specific composition path. 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.8.md) for publication and host status.
 
 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.
 

package/dist/openapi/selection/resolve-api-operation-choice-answer.d.ts

@@ -0,0 +1,4 @@
+import type { ResolveApiOperationChoiceAnswerInput } from '../../types/api-clarification.js';
+import type { SelectedApiOperation } from '../../types/api-catalog.js';
+/** Resolve only the explicitly declared choice mode; prose never determines cardinality. */
+export declare function resolveApiOperationChoiceAnswer(input: ResolveApiOperationChoiceAnswerInput): SelectedApiOperation[];

package/dist/openapi/selection/resolve-api-operation-choice-answer.js

@@ -0,0 +1,38 @@
+import { apiOperationAnswersSchema } from '../../schemas/api-operation-answers-schema.js';
+import { validateApiSelectionQuestion } from './validate-api-selection-question.js';
+import { apiOperationKeyEquals } from '../catalog/api-operation-key-equals.js';
+/** Resolve only the explicitly declared choice mode; prose never determines cardinality. */
+export function resolveApiOperationChoiceAnswer(input) {
+    const { question } = input;
+    validateApiSelectionQuestion(question);
+    const answer = apiOperationAnswersSchema.element.parse(input.answer);
+    if (answer.questionId !== question.id)
+        throw new Error(`Operation answer questionId does not match ${question.id}`);
+    let keys;
+    if (question.kind === 'operation-choice') {
+        if (!('operation' in answer))
+            throw new Error(`Operation question ${question.id} requires one operation`);
+        keys = [answer.operation];
+    }
+    else if (question.kind === 'operation-multiple-choice') {
+        if (!('operations' in answer))
+            throw new Error(`Operation question ${question.id} requires an operations array`);
+        keys = answer.operations;
+        if (keys.length < question.minSelections ||
+            keys.length > question.maxSelections)
+            throw new Error(`Operation question ${question.id} requires ${question.minSelections}..${question.maxSelections} selections`);
+    }
+    else {
+        throw new Error('Operation question has no supported source-owned choice kind');
+    }
+    const seen = [];
+    return keys.map((key) => {
+        if (seen.some((previous) => apiOperationKeyEquals(previous, key)))
+            throw new Error(`Operation answer ${question.id} contains a duplicate selection`);
+        const candidate = question.candidates.find((item) => apiOperationKeyEquals(item.key, key));
+        if (!candidate)
+            throw new Error(`Operation answer ${question.id} does not match a current offered candidate`);
+        seen.push(key);
+        return { key: structuredClone(candidate.key), purpose: question.purpose };
+    });
+}

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

@@ -1,5 +1,5 @@
 import { apiOperationAnswersSchema } from '../../schemas/api-operation-answers-schema.js';
-import { apiOperationKeyEquals } from '../catalog/api-operation-key-equals.js';
+import { resolveApiOperationChoiceAnswer } from './resolve-api-operation-choice-answer.js';
 import { resolveApiOperations } from '../resolve-api-operations.js';
 export async function resolveApiSelectionAnswers(input) {
     const answers = apiOperationAnswersSchema.parse(input.answers);
@@ -13,13 +13,7 @@ export async function resolveApiSelectionAnswers(input) {
         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,
-        });
+        operations.push(...resolveApiOperationChoiceAnswer({ question, answer }));
         answered.add(question.id);
     }
     return {

package/dist/openapi/selection/validate-api-selection-question.d.ts

@@ -0,0 +1,2 @@
+import type { ApiSelectionQuestion } from '../../types/api-clarification.js';
+export declare function validateApiSelectionQuestion(question: ApiSelectionQuestion): void;

package/dist/openapi/selection/validate-api-selection-question.js

@@ -0,0 +1,13 @@
+import { apiOperationChoiceBoundsSchema } from '../../schemas/api-operation-choice-bounds-schema.js';
+export function validateApiSelectionQuestion(question) {
+    if (question.kind === 'operation-choice')
+        return;
+    if (question.kind !== 'operation-multiple-choice')
+        throw new Error('Operation question has no supported source-owned choice kind');
+    const bounds = apiOperationChoiceBoundsSchema.parse({
+        minSelections: question.minSelections,
+        maxSelections: question.maxSelections,
+    });
+    if (bounds.maxSelections > question.candidates.length)
+        throw new Error(`Operation question ${question.id} maxSelections exceeds offered candidates`);
+}

package/dist/public-api.d.ts

@@ -39,6 +39,8 @@ export { inspectApiArgumentRequirements } from './arguments/clarification/inspec
 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 { resolveApiOperationChoiceAnswer } from './openapi/selection/resolve-api-operation-choice-answer.js';
+export { validateApiSelectionQuestion } from './openapi/selection/validate-api-selection-question.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';

package/dist/public-api.js

@@ -29,6 +29,8 @@ export { inspectApiArgumentRequirements } from './arguments/clarification/inspec
 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 { resolveApiOperationChoiceAnswer } from './openapi/selection/resolve-api-operation-choice-answer.js';
+export { validateApiSelectionQuestion } from './openapi/selection/validate-api-selection-question.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';

package/dist/schemas/api-operation-answers-schema.d.ts

@@ -1,9 +1,16 @@
 import { z } from 'zod';
-export declare const apiOperationAnswersSchema: z.ZodArray<z.ZodObject<{
+export declare const apiOperationAnswersSchema: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
     questionId: z.ZodString;
     operation: z.ZodObject<{
         documentId: z.ZodString;
         snapshotId: z.ZodString;
         operationRef: z.ZodString;
     }, z.core.$strict>;
-}, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    questionId: z.ZodString;
+    operations: z.ZodArray<z.ZodObject<{
+        documentId: z.ZodString;
+        snapshotId: z.ZodString;
+        operationRef: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>]>>;

package/dist/schemas/api-operation-answers-schema.js

@@ -1,8 +1,14 @@
 import { z } from 'zod';
 import { apiOperationKeySchema } from './api-operation-key-schema.js';
 export const apiOperationAnswersSchema = z
-    .array(z.strictObject({
-    questionId: z.string().min(1),
-    operation: apiOperationKeySchema,
-}))
+    .array(z.union([
+    z.strictObject({
+        questionId: z.string().min(1),
+        operation: apiOperationKeySchema,
+    }),
+    z.strictObject({
+        questionId: z.string().min(1),
+        operations: z.array(apiOperationKeySchema),
+    }),
+]))
     .min(1);

package/dist/schemas/api-operation-choice-bounds-schema.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare const apiOperationChoiceBoundsSchema: z.ZodObject<{
+    minSelections: z.ZodNumber;
+    maxSelections: z.ZodNumber;
+}, z.core.$strict>;

package/dist/schemas/api-operation-choice-bounds-schema.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export const apiOperationChoiceBoundsSchema = z
+    .strictObject({
+    minSelections: z.number().int().nonnegative().safe(),
+    maxSelections: z.number().int().nonnegative().safe(),
+})
+    .refine((bounds) => bounds.minSelections <= bounds.maxSelections, {
+    message: 'minSelections must not exceed maxSelections',
+});

package/dist/schemas/workflow-review-suggestions-record-schema.d.ts

@@ -5,6 +5,12 @@ export declare const workflowReviewSuggestionsRecordSchema: z.ZodObject<{
     fingerprint: z.ZodString;
     boundaryKey: z.ZodString;
     target: z.ZodObject<{
+        kind: z.ZodEnum<{
+            "requirements-clarification": "requirements-clarification";
+            "selection-review": "selection-review";
+            "planning-questions": "planning-questions";
+            "candidate-review": "candidate-review";
+        }>;
         questions: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             message: z.ZodString;
@@ -19,12 +25,6 @@ export declare const workflowReviewSuggestionsRecordSchema: z.ZodObject<{
                 }, z.core.$strict>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
-        kind: z.ZodEnum<{
-            "requirements-clarification": "requirements-clarification";
-            "selection-review": "selection-review";
-            "planning-questions": "planning-questions";
-            "candidate-review": "candidate-review";
-        }>;
         revision: z.ZodNumber;
         data: z.ZodJSONSchema;
     }, z.core.$strict>;

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

@@ -65,16 +65,30 @@ export interface ApiOperationChoice {
     candidates: ApiOperationCandidate[];
     explanation?: ApiSelectionExplanation;
 }
+export interface ApiOperationMultipleChoice extends Omit<ApiOperationChoice, 'kind'> {
+    kind: 'operation-multiple-choice';
+    minSelections: number;
+    maxSelections: number;
+}
+export type ApiSelectionQuestion = ApiOperationChoice | ApiOperationMultipleChoice;
 export interface ApiSelectionAnalysis {
     selection: ApiSelection;
-    questions: ApiOperationChoice[];
+    questions: ApiSelectionQuestion[];
 }
 export interface ApiOperationAnswer {
     questionId: string;
     operation: ApiOperationKey;
 }
+export interface ApiOperationMultipleAnswer extends Omit<ApiOperationAnswer, 'operation'> {
+    operations: ApiOperationKey[];
+}
+export type ApiSelectionAnswer = ApiOperationAnswer | ApiOperationMultipleAnswer;
+export interface ResolveApiOperationChoiceAnswerInput {
+    question: ApiSelectionQuestion;
+    answer: ApiSelectionAnswer;
+}
 export interface ResolveApiSelectionAnswersInput {
     catalog: ApiCatalog;
     analysis: ApiSelectionAnalysis;
-    answers: ApiOperationAnswer[];
+    answers: ApiSelectionAnswer[];
 }

package/package.json

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