Skip to content

Type Alias: DraftFunctionResponse

@kortexya/reasoninglayer


@kortexya/reasoninglayer / DraftFunctionResponse

DraftFunctionResponse = { questions: AuthoringClarificationQuestionDto[]; sessionId: string; status: "needs_clarification"; understood: object; } | { draft: FunctionDraftDto; explanation?: string | null; generationTimeMs: number; status: "complete"; warnings: string[]; }

Defined in: src/types/functions.ts:342

Response for an AI function draft.

{ questions: AuthoringClarificationQuestionDto[]; sessionId: string; status: "needs_clarification"; understood: object; }

questions: AuthoringClarificationQuestionDto[]

Clarification questions the user must answer.

sessionId: string

Session ID to echo back in the follow-up request.

status: "needs_clarification"

Discriminator: clarification is needed.

understood: object

What the model already understood from the description.


{ draft: FunctionDraftDto; explanation?: string | null; generationTimeMs: number; status: "complete"; warnings: string[]; }

draft: FunctionDraftDto

The draft — a RegisterFunctionRequest, which registerFunction takes as is.

optional explanation?: string | null

Plain-language summary of what the drafted function does.

generationTimeMs: number

Wall-clock generation time in milliseconds.

status: "complete"

Discriminator: the draft is ready.

warnings: string[]

Non-fatal issues the user should see (e.g., unknown function references).

Discriminated union by status:

  • "needs_clarification" — the model needs more information; answer questions and call again with sessionId.
  • "complete" — draft holds a validated FunctionDraftDto, which is a RegisterFunctionRequest: pass it straight to registerFunction.