@openapi-flow/core 0.1.0 → 0.3.0

package/dist/types/native-node-planning.js

@@ -0,0 +1 @@
+export {};

package/dist/types/native-parameter-reference.d.ts

@@ -0,0 +1,17 @@
+import type { WorkflowValueReference, PlannedNativeNode, WorkflowCapability } from './workflow-plan.js';
+export interface WorkflowExclusiveOutputReference {
+    source: 'exclusive-output';
+    nodeId: string;
+}
+export type WorkflowNativeParameterReference = WorkflowValueReference | WorkflowExclusiveOutputReference;
+/** Implementation-owned locations; never discovered by matching property names or values. */
+export interface WorkflowNativeReferenceBinding {
+    nodeIdPointer: string;
+    /** Omitted means the implementation owns a fixed value pointer, not a model field. */
+    valuePointer?: string;
+    reference: WorkflowNativeParameterReference;
+}
+export interface DescribeNativeReferenceBindingsInput {
+    node: PlannedNativeNode;
+    capability: WorkflowCapability;
+}

package/dist/types/native-parameter-reference.js

@@ -0,0 +1 @@
+export {};

package/dist/types/native-producer-dependencies.d.ts

@@ -0,0 +1,9 @@
+export interface NativeProducerDependencyTarget {
+    nodeId: string;
+    description: string;
+    sourceNodeIds: string[];
+}
+export interface NativeProducerDependencySchemaInput {
+    targets: NativeProducerDependencyTarget[];
+    includeExplanations: boolean;
+}

package/dist/types/native-producer-dependencies.js

@@ -0,0 +1 @@
+export {};

package/dist/types/native-producer-eligibility.d.ts

@@ -0,0 +1,11 @@
+import type { WorkflowCapability } from './workflow-plan.js';
+import type { WorkflowNativeParameterReference } from './native-parameter-reference.js';
+export interface NativeParameterProducerCandidate {
+    nodeId: string;
+    referenceSources: WorkflowNativeParameterReference['source'][];
+}
+export interface SelectNativeParameterProducersInput {
+    nodeId: string;
+    capability: WorkflowCapability;
+    producers: NativeParameterProducerCandidate[];
+}

package/dist/types/native-producer-eligibility.js

@@ -0,0 +1 @@
+export {};

package/dist/types/native-reference-validation.d.ts

@@ -0,0 +1,12 @@
+import type { WorkflowNativeParameterReference } from './native-parameter-reference.js';
+import type { WorkflowDraftReferenceSources } from './workflow-draft-reference-sources.js';
+import type { PlannedNativeNode, WorkflowCapability } from './workflow-plan.js';
+export interface ValidateWorkflowDraftNativeReferenceInput {
+    reference: WorkflowNativeParameterReference;
+    sources: WorkflowDraftReferenceSources;
+}
+export interface ValidateWorkflowDraftNativeReferencesInput {
+    node: PlannedNativeNode;
+    capability: WorkflowCapability;
+    sources: WorkflowDraftReferenceSources;
+}

package/dist/types/native-reference-validation.js

@@ -0,0 +1 @@
+export {};

package/dist/types/native-runtime-inputs.d.ts

@@ -0,0 +1,53 @@
+import type { JsonValue } from './api-arguments.js';
+import type { BindingSchema, RequestContainerKind } from './api-bindings.js';
+import type { JsonValueObject } from './api-arguments.js';
+import type { PlannedNativeNode, WorkflowCapability } from './workflow-plan.js';
+import type { DeferredApiInputSlot } from './deferred-api-inputs.js';
+export interface NativeRuntimeInputSlot {
+    kind: 'native-parameters-input';
+    state: 'deferred';
+    id: string;
+    nodeId: string;
+    capability: string;
+    targetPointer: string;
+    schema: BindingSchema;
+    description: string;
+}
+export interface NativeRuntimeParameterInputSource {
+    id: string;
+    targetPointer: string;
+    containerKinds: Record<string, RequestContainerKind>;
+}
+export interface NativeRuntimeParameterMaterialization {
+    nodeId: string;
+    parameters: JsonValueObject;
+    schema: BindingSchema;
+    inputs: NativeRuntimeParameterInputSource[];
+}
+export type WorkflowRuntimeInputSlot = DeferredApiInputSlot | NativeRuntimeInputSlot;
+export type NativeRuntimeInputValues = Record<string, JsonValue>;
+export interface CollectNativeRuntimeInputSlotsInput {
+    nativeNodes: PlannedNativeNode[];
+    capabilities: WorkflowCapability[];
+}
+export interface InspectNativeRuntimeInputsInput extends CollectNativeRuntimeInputSlotsInput {
+    inputValues: NativeRuntimeInputValues;
+}
+export interface NativeRuntimeInputIssue {
+    code: 'missing-input' | 'unknown-input' | 'invalid-value';
+    inputId: string;
+    nodeId?: string;
+    message: string;
+}
+export interface ReadyNativeRuntimeInputs {
+    status: 'ready';
+    slots: NativeRuntimeInputSlot[];
+    nativeNodes: PlannedNativeNode[];
+    issues: NativeRuntimeInputIssue[];
+}
+export interface PendingNativeRuntimeInputs {
+    status: 'needs-input' | 'invalid-input';
+    slots: NativeRuntimeInputSlot[];
+    issues: NativeRuntimeInputIssue[];
+}
+export type NativeRuntimeInputInspection = ReadyNativeRuntimeInputs | PendingNativeRuntimeInputs;

package/dist/types/native-runtime-inputs.js

@@ -0,0 +1 @@
+export {};

package/dist/types/node-output.d.ts

@@ -0,0 +1,11 @@
+import type { BindingSchema } from './api-bindings.js';
+import type { PlannedNativeNode, WorkflowCapability } from './workflow-plan.js';
+/** A native node's JSON item contract, not an HTTP response envelope. */
+export interface NativeOutputContract {
+    nodeId: string;
+    schema: BindingSchema;
+}
+export interface CreateNativeOutputContractsInput {
+    nativeNodes: PlannedNativeNode[];
+    capabilities: WorkflowCapability[];
+}

package/dist/types/node-output.js

@@ -0,0 +1 @@
+export {};

package/dist/types/oas-value-validation.d.ts

@@ -0,0 +1,8 @@
+import type { createValidator } from '@scalar/json-schema-validator';
+import type { JsonObject } from './openapi.js';
+export type OasValueSchema = JsonObject | boolean;
+export type OasValueValidation = ReturnType<typeof createValidator>;
+export interface OasValueValidator {
+    schema: JsonObject;
+    validate: OasValueValidation;
+}

package/dist/types/oas-value-validation.js

@@ -0,0 +1 @@
+export {};

package/dist/types/openapi.d.ts

@@ -1,6 +1,11 @@
+import type { Document as OpenApi30Document } from '@scalar/openapi-types/3.0';
+import type { Document as OpenApi31Document } from '@scalar/openapi-types/3.1';
+import type { Document as OpenApi32Document } from '@scalar/openapi-types/3.2';
+export type OpenApiDocument = OpenApi30Document | OpenApi31Document | OpenApi32Document;
 export type JsonObject = Record<string, unknown>;
 export type Scalar = string | number | boolean;
 export type OperationMethod = string;
+export type OperationSourceKind = 'paths' | 'webhooks' | 'callbacks';
 export interface OperationEntry {
     method: string;
     key: string;
@@ -10,38 +15,17 @@ export interface ScalarSchema {
     type: string;
     enum?: Scalar[];
 }
-export type ScalarProperties = Record<string, ScalarSchema>;
-export interface OperationParameter {
-    name: string;
-    in: 'path' | 'query';
-    required: boolean;
-    schema: ScalarSchema;
-}
-export interface OperationBody {
-    required: boolean;
-    requiredProperties: string[];
-    properties: ScalarProperties;
-}
 export interface OperationMetadata {
     operationId?: string;
     summary: string;
     description: string;
     tags: string[];
 }
-export interface Operation extends OperationMetadata {
+export interface OperationCandidate extends OperationMetadata {
+    source: OperationSourceKind;
     operationRef: string;
     method: OperationMethod;
     path: string;
-    effect: 'read' | 'write' | 'unknown';
-    status: number;
-    parameters: OperationParameter[];
-    body?: OperationBody;
-    responseProperties: ScalarProperties;
-}
-export type OperationCandidate = Pick<Operation, 'operationRef' | 'operationId' | 'method' | 'path' | 'summary' | 'description' | 'tags'>;
-export interface ObjectSchemaProperties {
-    properties: JsonObject;
-    required: string[];
 }
 export interface ParsedDocument {
     spec: JsonObject;

package/dist/types/planning-evidence.d.ts

@@ -0,0 +1,56 @@
+import type { ApiOperationContract } from './api-operation.js';
+import type { ApiOperationKey } from './api-catalog.js';
+import type { WorkflowCapability } from './workflow-plan.js';
+import type { WorkflowSourceMessage } from './workflow-draft.js';
+import type { BindingSchema } from './api-bindings.js';
+import type { WorkflowDraftClarification, WorkflowDraftClarificationDescription } from './workflow-draft-clarification.js';
+export interface WorkflowMessageEvidence {
+    kind: 'message';
+    messageId: string;
+    quote: string;
+}
+export interface WorkflowOasEvidence {
+    kind: 'oas';
+    operation: ApiOperationKey;
+    /** RFC 6901 pointer into the supplied resolved Operation Object. */
+    pointer: string;
+}
+export interface WorkflowNativeEvidence {
+    kind: 'native';
+    capability: string;
+}
+export interface WorkflowEntryPointContract {
+    kind: string;
+    description: string;
+}
+export interface WorkflowEntryPointEvidence {
+    kind: 'entrypoint';
+    entrypoint: string;
+}
+export type WorkflowPlanningEvidence = WorkflowMessageEvidence | WorkflowOasEvidence | WorkflowNativeEvidence | WorkflowEntryPointEvidence;
+export interface WorkflowPlanningContext {
+    messages: WorkflowSourceMessage[];
+    planningMessageIds?: string[];
+    operations?: ApiOperationContract[];
+    capabilities?: WorkflowCapability[];
+    entrypoint?: WorkflowEntryPointContract;
+    clarification?: WorkflowDraftClarification;
+}
+export interface DescribedWorkflowCapability {
+    name: string;
+    description: string;
+    parametersSchema: BindingSchema;
+    supportsRuntimeParameters?: true;
+    materialRequirements?: WorkflowCapability['materialRequirements'];
+}
+export interface WorkflowPlanningContextDescription {
+    messages: WorkflowSourceMessage[];
+    operations: ApiOperationContract[];
+    capabilities: DescribedWorkflowCapability[];
+    entrypoint?: WorkflowEntryPointContract;
+    clarification?: WorkflowDraftClarificationDescription;
+}
+export interface ValidateWorkflowPlanningEvidenceInput {
+    context: WorkflowPlanningContext;
+    evidence: WorkflowPlanningEvidence[];
+}

package/dist/types/planning-evidence.js

@@ -0,0 +1 @@
+export {};

package/dist/types/request.d.ts

@@ -0,0 +1,41 @@
+import type { JsonObject, OperationCandidate, OperationEntry, OperationMetadata, OperationMethod } from './openapi.js';
+export interface OperationSource {
+    candidate: OperationCandidate;
+    pathItem: JsonObject;
+    entry: OperationEntry;
+}
+export type ResponseProperties = Record<string, JsonObject | boolean>;
+export type OperationResponses = Record<string, ResponseProperties>;
+export interface OperationParameter {
+    name: string;
+    in: 'path' | 'query' | 'header' | 'cookie';
+    required: boolean;
+    schema: JsonObject | boolean;
+    style: string;
+    explode: boolean;
+    allowReserved: boolean;
+    contentMediaType?: string;
+}
+export interface OperationBody {
+    required: boolean;
+    mediaTypes: Record<string, OperationBodyMedia>;
+}
+export interface OperationBodyMedia {
+    schema?: JsonObject | boolean;
+    properties: JsonObject;
+    encoding?: JsonObject;
+}
+export interface OperationAuthentication {
+    schemeName: string;
+    credentialType: 'httpBearerAuth';
+}
+export interface Operation extends OperationMetadata {
+    source: 'paths';
+    operationRef: string;
+    method: OperationMethod;
+    path: string;
+    authentication?: OperationAuthentication;
+    parameters: OperationParameter[];
+    body?: OperationBody;
+    responses: OperationResponses;
+}

package/dist/types/request.js

@@ -0,0 +1 @@
+export {};

package/dist/types/requested-api-inputs.d.ts

@@ -0,0 +1,8 @@
+import type { ApiArgumentValues, JsonValue } from './api-arguments.js';
+/** Presence required by the workflow request, separately from OAS requiredness. */
+export interface RequestedApiInputPresenceInput {
+    source: string;
+    rootPointer: string;
+    value: ApiArgumentValues | JsonValue | undefined;
+    requestedInputs?: string[];
+}

package/dist/types/requested-api-inputs.js

@@ -0,0 +1 @@
+export {};

package/dist/types/reviewable-workflow.d.ts

@@ -0,0 +1,57 @@
+import type { ApiOperationContract } from './api-operation.js';
+import type { ApiOperationKey } from './api-catalog.js';
+import type { OutputBinding } from './api-arguments.js';
+import type { WorkflowConnectionPlanningRecord } from './workflow-connection-planning.js';
+import type { WorkflowApiMaterial, WorkflowCapability, WorkflowGraphPlan, PlannedNativeNode, WorkflowPlanEdge } from './workflow-plan.js';
+export interface WorkflowReviewGap {
+    id: string;
+    stage: 'api-selection' | 'api-bindings' | 'workflow-graph';
+    description: string;
+    operation?: ApiOperationKey;
+    callId?: string;
+    targetPointer?: string;
+}
+export interface ReadyWorkflowApiMaterial extends WorkflowApiMaterial {
+    status: 'ready';
+}
+export interface BlockedWorkflowApiMaterial {
+    status: 'blocked';
+    callId: string;
+    operation: ApiOperationContract;
+    purpose?: string;
+    requestMediaType?: string;
+    bindings: OutputBinding[];
+    gapIds: string[];
+}
+export type ReviewableWorkflowApiMaterial = ReadyWorkflowApiMaterial | BlockedWorkflowApiMaterial;
+export interface BlockedWorkflowCall {
+    callId: string;
+    gapIds: string[];
+}
+export interface ProposedWorkflowGap {
+    id: string;
+    description: string;
+}
+export interface ReviewableWorkflowGraphProposal {
+    nativeNodes: PlannedNativeNode[];
+    edges: WorkflowPlanEdge[];
+    additionalGaps: ProposedWorkflowGap[];
+    blockedCalls: BlockedWorkflowCall[];
+}
+export interface ReviewableWorkflowGraphPlan extends WorkflowGraphPlan {
+    gaps: WorkflowReviewGap[];
+    blockedCalls: BlockedWorkflowCall[];
+    /** Optional original connection-only decision and supplied-material evidence. */
+    connectionPlanning?: WorkflowConnectionPlanningRecord;
+}
+export interface ReviewableWorkflowPlanningContext {
+    materials: ReviewableWorkflowApiMaterial[];
+    capabilities: WorkflowCapability[];
+}
+export interface CreateReviewableWorkflowGraphPlanInput extends ReviewableWorkflowPlanningContext {
+    gaps: WorkflowReviewGap[];
+    proposal: ReviewableWorkflowGraphProposal;
+}
+export interface ValidateReviewableWorkflowGraphPlanInput extends ReviewableWorkflowPlanningContext {
+    plan: ReviewableWorkflowGraphPlan;
+}

package/dist/types/reviewable-workflow.js

@@ -0,0 +1 @@
+export {};

package/dist/types/schema-dialect.d.ts

@@ -0,0 +1 @@
+export type SchemaDialect = 'openapi-3.0' | 'draft-2020-12';

package/dist/types/schema-dialect.js

@@ -0,0 +1 @@
+export {};

package/dist/types/schema-json.d.ts

@@ -0,0 +1,4 @@
+export type SchemaJsonValue = null | boolean | number | string | SchemaJsonValue[] | SchemaJsonObject;
+export interface SchemaJsonObject {
+    [key: string]: SchemaJsonValue;
+}

package/dist/types/schema-json.js

@@ -0,0 +1 @@
+export {};

package/dist/types/schema-resource.d.ts

@@ -0,0 +1,18 @@
+import type { BindingSchema } from './api-bindings.js';
+export type SchemaDeclaredType = string | string[] | undefined;
+export interface SchemaResourceLocation {
+    reference: string;
+    baseUri: string;
+}
+export interface SchemaResourceContext {
+    root: BindingSchema;
+    reference: (schema: BindingSchema) => BindingSchema;
+    resolve: (schema: BindingSchema) => BindingSchema;
+    bundle: (projection: BindingSchema) => BindingSchema;
+    /** Compile reachable static schemas into direct named components; preserve all assertions. */
+    bundleStaticProjections: (projections: Record<string, BindingSchema>) => StaticSchemaProjectionBundle;
+}
+export interface StaticSchemaProjectionBundle {
+    projections: Record<string, BindingSchema>;
+    definitions: Record<string, BindingSchema>;
+}

package/dist/types/schema-resource.js

@@ -0,0 +1 @@
+export {};

package/dist/types/security.d.ts

@@ -0,0 +1,17 @@
+import type { ApiSecurityRequirement } from './api-operation.js';
+import type { JsonObject } from './openapi.js';
+export interface ResolveOpenApiSecurityInput {
+    operationRef: string;
+    security: ApiSecurityRequirement[];
+    securitySchemes: JsonObject;
+    requirementIndex?: number;
+}
+export interface ResolvedSecurityScheme {
+    name: string;
+    scopes: string[];
+    definition: JsonObject;
+}
+export interface ResolvedOpenApiSecurity {
+    requirementIndex: number;
+    schemes: ResolvedSecurityScheme[];
+}

package/dist/types/security.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,10 @@
+import type { WorkflowCapability, PlannedNativeNode } from './workflow-plan.js';
+export interface WorkflowCapabilityPlanningContext {
+    apiCallIds: string[];
+}
+export interface WorkflowCapabilityPlanningInput extends WorkflowCapabilityPlanningContext {
+    capabilities: WorkflowCapability[];
+}
+export interface ValidateNativeApiResponseReferencesInput extends WorkflowCapabilityPlanningInput {
+    nativeNodes: PlannedNativeNode[];
+}

package/dist/types/workflow-capability-planning.js

@@ -0,0 +1 @@
+export {};

package/dist/types/workflow-clarification-answer-revision.d.ts

@@ -0,0 +1,43 @@
+import type { WorkflowPlanningContext } from './planning-evidence.js';
+import type { WorkflowClarificationQuestion, WorkflowClarificationReply } from './workflow-clarification.js';
+import type { WorkflowDraftClarification } from './workflow-draft-clarification.js';
+import type { WorkflowSourceMessage } from './workflow-draft.js';
+export type WorkflowClarificationAnswerChange = {
+    kind: 'replace-answer';
+    reply: WorkflowClarificationReply;
+} | {
+    kind: 'reopen-question';
+    questionId: string;
+};
+export interface WorkflowClarificationAnswerRevisionDescription {
+    fingerprint: string;
+    roundId: string;
+    questions: WorkflowClarificationQuestion[];
+    replies: WorkflowClarificationReply[];
+}
+export interface ReviseWorkflowClarificationAnswersInput {
+    context: WorkflowPlanningContext;
+    fingerprint: string;
+    messageId: string;
+    changes: WorkflowClarificationAnswerChange[];
+}
+/** An immutable transition receipt, not a replacement workflow or an executable edit. */
+export interface WorkflowClarificationAnswerRevision {
+    id: string;
+    fingerprint: string;
+    message: WorkflowSourceMessage;
+    changes: WorkflowClarificationAnswerChange[];
+    before: WorkflowDraftClarification;
+    after: WorkflowDraftClarification;
+    supersededAnswerMessageIds: string[];
+}
+export interface WorkflowClarificationAnswerRevisionResult {
+    revision: WorkflowClarificationAnswerRevision;
+    /** Previous answer evidence is removed, original request evidence is preserved. */
+    activeMessages: WorkflowSourceMessage[];
+}
+export interface ValidateWorkflowClarificationAnswerRevisionInput {
+    /** The trusted, original pre-change context; never reconstruct it from a client receipt. */
+    context: WorkflowPlanningContext;
+    revision: WorkflowClarificationAnswerRevision;
+}

package/dist/types/workflow-clarification-answer-revision.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,153 @@
+import type { WorkflowPlanningContext, WorkflowPlanningEvidence, WorkflowMessageEvidence } from './planning-evidence.js';
+import type { WorkflowSourceMessage } from './workflow-draft.js';
+export interface ClarificationQuestionLimits {
+    maxCategories: number;
+    maxQuestionsPerCategory: number;
+    maxChoicesPerQuestion: number;
+    maxQuestionsPerRound: number;
+}
+export interface WorkflowClarificationOptions {
+    includeExplanations?: boolean;
+    includeSuggestions?: boolean;
+}
+export interface ResolvedWorkflowClarificationOptions {
+    includeExplanations: boolean;
+    includeSuggestions: boolean;
+}
+export interface WorkflowDecisionExplanation<Evidence = WorkflowPlanningEvidence> {
+    reason: string;
+    evidence: Evidence[];
+}
+export interface ProposedRequirementStatement<Evidence = WorkflowPlanningEvidence> {
+    text: string;
+    sources: WorkflowMessageEvidence[];
+    explanation?: WorkflowDecisionExplanation<Evidence>;
+}
+export interface ProposedClarificationChoice<Evidence = WorkflowPlanningEvidence> {
+    label: string;
+    explanation?: WorkflowDecisionExplanation<Evidence>;
+}
+export type ProposedClarificationAnswer<Evidence = WorkflowPlanningEvidence> = {
+    kind: 'text';
+} | {
+    kind: 'single-choice' | 'multiple-choice';
+    choices: ProposedClarificationChoice<Evidence>[];
+};
+export interface ProposedClarificationQuestion<Evidence = WorkflowPlanningEvidence> {
+    message: string;
+    answer: ProposedClarificationAnswer<Evidence>;
+    explanation?: WorkflowDecisionExplanation<Evidence>;
+}
+export interface ProposedClarificationCategory<Evidence = WorkflowPlanningEvidence> {
+    title: string;
+    questions: ProposedClarificationQuestion<Evidence>[];
+    explanation?: WorkflowDecisionExplanation<Evidence>;
+}
+export interface ProposedWorkflowSuggestion<Evidence = WorkflowPlanningEvidence> {
+    text: string;
+    explanation?: WorkflowDecisionExplanation<Evidence>;
+}
+export interface WorkflowRequirementsProposal<Evidence = WorkflowPlanningEvidence> {
+    statements: ProposedRequirementStatement<Evidence>[];
+    categories: ProposedClarificationCategory<Evidence>[];
+    suggestions?: ProposedWorkflowSuggestion<Evidence>[];
+}
+export interface WorkflowClarificationChoice extends ProposedClarificationChoice {
+    id: string;
+}
+export type WorkflowClarificationAnswer = {
+    kind: 'text';
+} | {
+    kind: 'single-choice' | 'multiple-choice';
+    choices: WorkflowClarificationChoice[];
+};
+export interface WorkflowClarificationQuestion extends Omit<ProposedClarificationQuestion, 'answer'> {
+    id: string;
+    answer: WorkflowClarificationAnswer;
+}
+export interface WorkflowClarificationCategory extends Omit<ProposedClarificationCategory, 'questions'> {
+    id: string;
+    questions: WorkflowClarificationQuestion[];
+}
+export interface WorkflowClarificationStatement extends ProposedRequirementStatement {
+    id: string;
+}
+export interface WorkflowClarificationSuggestion extends ProposedWorkflowSuggestion {
+    id: string;
+}
+export interface WorkflowClarificationRound {
+    id: string;
+    contextFingerprint: string;
+    sourceMessages: WorkflowSourceMessage[];
+    limits: ClarificationQuestionLimits;
+    options: ResolvedWorkflowClarificationOptions;
+    statements: WorkflowClarificationStatement[];
+    categories: WorkflowClarificationCategory[];
+    suggestions?: WorkflowClarificationSuggestion[];
+}
+export interface CreateWorkflowClarificationRoundInput {
+    context: WorkflowPlanningContext;
+    limits: ClarificationQuestionLimits;
+    options?: WorkflowClarificationOptions;
+    proposal: WorkflowRequirementsProposal;
+}
+export interface WorkflowClarificationRoundInput {
+    round: WorkflowClarificationRound;
+    context: WorkflowPlanningContext;
+}
+export type WorkflowClarificationReply = {
+    kind: 'single-choice';
+    questionId: string;
+    choiceId: string;
+} | {
+    kind: 'multiple-choice';
+    questionId: string;
+    choiceIds: string[];
+} | {
+    kind: 'text';
+    questionId: string;
+    text: string;
+} | {
+    kind: 'defer';
+    questionId: string;
+};
+export interface WorkflowAnswerEvidence {
+    kind: 'clarification-answer';
+    roundId: string;
+    questionId: string;
+}
+export interface WorkflowRequirementFact {
+    id: string;
+    text: string;
+    sources: (WorkflowMessageEvidence | WorkflowAnswerEvidence)[];
+}
+export interface WorkflowClarificationResolution {
+    roundId: string;
+    contextFingerprint: string;
+    sourceMessages: WorkflowSourceMessage[];
+    replies: WorkflowClarificationReply[];
+    facts: WorkflowRequirementFact[];
+    pendingQuestionIds: string[];
+    deferredQuestionIds: string[];
+    readyForPlanning: boolean;
+    requirementsPrompt: string;
+}
+export interface ResolveWorkflowClarificationRepliesInput {
+    round: WorkflowClarificationRound;
+    context: WorkflowPlanningContext;
+    replies: WorkflowClarificationReply[];
+    previous?: WorkflowClarificationResolution;
+}
+export interface WorkflowClarificationResolutionInput {
+    round: WorkflowClarificationRound;
+    replies: WorkflowClarificationReply[];
+}
+export interface WorkflowRequirementsPromptInput {
+    sourceMessages: WorkflowSourceMessage[];
+    facts: WorkflowRequirementFact[];
+    pendingQuestions: WorkflowClarificationQuestion[];
+    deferredQuestions: WorkflowClarificationQuestion[];
+}
+export interface IdentifiedClarificationPart {
+    id: string;
+}