@openapi-flow/core 0.3.9 → 0.3.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/dist/arguments/clarification/api-input-requirement-dialect.d.ts +4 -0
  2. package/dist/arguments/clarification/api-input-requirement-dialect.js +8 -0
  3. package/dist/arguments/clarification/extraction/capture-api-input-answer-context.js +2 -3
  4. package/dist/arguments/clarification/extraction/create-api-input-answer-extraction-record.js +8 -2
  5. package/dist/arguments/clarification/extraction/resolve-api-input-answer-interpretations.d.ts +3 -0
  6. package/dist/arguments/clarification/extraction/resolve-api-input-answer-interpretations.js +51 -0
  7. package/dist/arguments/clarification/extraction/resolve-api-input-answer-sources.js +2 -3
  8. package/dist/arguments/clarification/extraction/validate-api-input-answer-analysis.d.ts +3 -0
  9. package/dist/arguments/clarification/extraction/validate-api-input-answer-analysis.js +55 -0
  10. package/dist/arguments/clarification/extraction/validate-api-input-answer-extraction-record.js +3 -0
  11. package/dist/arguments/enum/describe-api-input-enum-answer-choices.d.ts +4 -0
  12. package/dist/arguments/enum/describe-api-input-enum-answer-choices.js +23 -0
  13. package/dist/arguments/enum/list-api-input-enum-candidates.d.ts +3 -0
  14. package/dist/arguments/enum/list-api-input-enum-candidates.js +73 -0
  15. package/dist/draft/edits/api/describe-workflow-draft-api-enum-choices.d.ts +3 -0
  16. package/dist/draft/edits/api/describe-workflow-draft-api-enum-choices.js +70 -0
  17. package/dist/draft/edits/api/resolve-workflow-draft-api-call-arguments.js +9 -5
  18. package/dist/draft/edits/api/resolve-workflow-draft-api-enum-selections.d.ts +4 -0
  19. package/dist/draft/edits/api/resolve-workflow-draft-api-enum-selections.js +38 -0
  20. package/dist/draft/edits/enum/verify-workflow-draft-api-enum-selection.d.ts +3 -0
  21. package/dist/draft/edits/enum/verify-workflow-draft-api-enum-selection.js +23 -0
  22. package/dist/draft/edits/inputs/describe-workflow-draft-api-input-edit-answer-requirements.d.ts +4 -0
  23. package/dist/draft/edits/inputs/describe-workflow-draft-api-input-edit-answer-requirements.js +30 -0
  24. package/dist/draft/edits/inputs/describe-workflow-draft-api-input-edit-enum-choices.d.ts +4 -0
  25. package/dist/draft/edits/inputs/describe-workflow-draft-api-input-edit-enum-choices.js +42 -0
  26. package/dist/draft/edits/inputs/resolve-workflow-draft-api-input-edit-reply.d.ts +3 -0
  27. package/dist/draft/edits/inputs/resolve-workflow-draft-api-input-edit-reply.js +24 -0
  28. package/dist/draft/edits/inputs/resolve-workflow-draft-api-input-edits.js +20 -0
  29. package/dist/openapi/common/create-oas-value-validation-cache.d.ts +3 -0
  30. package/dist/openapi/common/create-oas-value-validation-cache.js +46 -0
  31. package/dist/openapi/common/create-oas-value-validator.js +12 -3
  32. package/dist/public-api.d.ts +11 -0
  33. package/dist/public-api.js +8 -0
  34. package/dist/schemas/api-input-answer-extraction-schema.d.ts +15 -0
  35. package/dist/schemas/api-input-answer-extraction-schema.js +4 -0
  36. package/dist/schemas/api-input-enum-answer-selection-schema.d.ts +25 -0
  37. package/dist/schemas/api-input-enum-answer-selection-schema.js +11 -0
  38. package/dist/schemas/create-workflow-draft-api-input-edit-values-schema.js +11 -2
  39. package/dist/schemas/workflow-draft-api-enum-choice-schema.d.ts +5 -0
  40. package/dist/schemas/workflow-draft-api-enum-choice-schema.js +25 -0
  41. package/dist/schemas/workflow-draft-api-enum-selection-schema.d.ts +4 -0
  42. package/dist/schemas/workflow-draft-api-enum-selection-schema.js +14 -0
  43. package/dist/schemas/workflow-draft-api-input-edit-proposal-schema.js +3 -1
  44. package/dist/types/api-clarification.d.ts +2 -0
  45. package/dist/types/api-input-answer-extraction.d.ts +9 -2
  46. package/dist/types/api-input-enum-answers.d.ts +25 -0
  47. package/dist/types/api-input-enum-answers.js +1 -0
  48. package/dist/types/api-input-enum.d.ts +26 -0
  49. package/dist/types/api-input-enum.js +1 -0
  50. package/dist/types/oas-value-validation.d.ts +13 -0
  51. package/dist/types/workflow-draft-api-call-planning.d.ts +4 -0
  52. package/dist/types/workflow-draft-api-enum-selection.d.ts +39 -0
  53. package/dist/types/workflow-draft-api-enum-selection.js +1 -0
  54. package/dist/types/workflow-draft-api-input-edit.d.ts +15 -2
  55. package/package.json +1 -1
@@ -9,6 +9,8 @@ import type { ApiOperationContract } from './api-operation.js';
9
9
  import type { WorkflowDraftApiCall, WorkflowSourceMessage } from './workflow-draft.js';
10
10
  import type { JsonObject } from './openapi.js';
11
11
  import type { ApiInputLiteralSource } from './api-input-literal-source.js';
12
+ import type { ApiInputAnswerAnalysis } from './api-input-answer-extraction.js';
13
+ import type { WorkflowDraftApiEnumSelection, VerifiedWorkflowDraftApiEnumSelection } from './workflow-draft-api-enum-selection.js';
12
14
  import type { workflowDraftApiInputEditAnswerSchema, workflowDraftApiInputEditAnswersSchema } from '../schemas/workflow-draft-api-input-edit-answers-schema.js';
13
15
  export interface WorkflowDraftApiInputEditMaterial extends ApiBindingMaterial {
14
16
  requestedInputs?: string[];
@@ -63,6 +65,8 @@ export interface WorkflowDraftApiInputEditContract {
63
65
  }
64
66
  export interface WorkflowDraftApiInputEditContractInput extends WorkflowDraftApiInputEditInput {
65
67
  contract: WorkflowDraftApiInputEditContract;
68
+ /** Enable ID-only interpretation of declared OAS enum choices, with separate provenance. */
69
+ selectOasEnums?: boolean;
66
70
  }
67
71
  export interface WorkflowDraftApiInputEditValueSource extends ApiInputLiteralSource {
68
72
  messageId: string;
@@ -73,6 +77,9 @@ export type WorkflowDraftApiInputEditValue = ({
73
77
  source: WorkflowDraftApiInputEditValueSource;
74
78
  } | {
75
79
  status: 'needs-input';
80
+ } | {
81
+ status: 'oas-enum';
82
+ selection: WorkflowDraftApiEnumSelection;
76
83
  }) & {
77
84
  explanation?: WorkflowDecisionExplanation<WorkflowMessageEvidence>;
78
85
  };
@@ -85,9 +92,13 @@ export interface WorkflowDraftApiInputEditAnswerSchemaInput extends WorkflowDraf
85
92
  output: WorkflowDraftApiInputEditValues;
86
93
  }
87
94
  export interface ResolveWorkflowDraftApiInputEditsInput extends WorkflowDraftApiInputEditAnswerSchemaInput {
88
- /** Explicit user answers to pending targets, separate from the unchanged model output. */
95
+ /** Validated user answer values, separate from the unchanged model output. Retain natural-answer analysis independently. */
89
96
  confirmedAnswers?: WorkflowDraftApiInputEditAnswers;
90
97
  }
98
+ export interface ResolveWorkflowDraftApiInputEditReplyInput extends ResolveWorkflowDraftApiInputEditsInput {
99
+ reply: string;
100
+ analysis: ApiInputAnswerAnalysis;
101
+ }
91
102
  export type WorkflowDraftApiInputEditResult = ({
92
103
  status: 'ready';
93
104
  contractId: string;
@@ -101,8 +112,10 @@ export type WorkflowDraftApiInputEditResult = ({
101
112
  values: WorkflowDraftApiInputEditValues;
102
113
  pendingTargets: WorkflowDraftApiInputEditTarget[];
103
114
  }) & {
104
- /** Present only when the caller supplied an explicit typed reply. */
115
+ /** Present when validated user answer values were supplied; natural provenance belongs to the separate answer analysis. */
105
116
  confirmedAnswers?: WorkflowDraftApiInputEditAnswers;
117
+ /** Original OAS values and human intent, not user-provided literal attribution. */
118
+ enumSelections?: VerifiedWorkflowDraftApiEnumSelection[];
106
119
  };
107
120
  export type WorkflowDraftApiInputEditValuesSchema = z.ZodType<WorkflowDraftApiInputEditValues>;
108
121
  export type WorkflowDraftApiInputEditAnswersSchema = z.ZodType<WorkflowDraftApiInputEditAnswers>;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@openapi-flow/core",
3
- "version": "0.3.9",
3
+ "version": "0.3.11",
4
4
  "license": "MIT",
5
5
  "description": "Engine-independent OpenAPI catalogs, operation contracts and typed request schemas",
6
6
  "keywords": [