Interface ClarificationRequest

A request for clarification from a human.

interface ClarificationRequest {
    requestId: string;
    question: string;
    context: string;
    agentId: string;
    clarificationType: "guidance" | "preference" | "ambiguity" | "missing_info" | "verification";
    options?: ClarificationOption[];
    allowFreeform: boolean;
    requestedAt: Date;
    timeoutMs?: number;
}

Properties

requestId question context agentId clarificationType options? allowFreeform requestedAt timeoutMs?

Properties

requestId

requestId: string

Unique request identifier

question

question: string

The question needing clarification

context

context: string

Context for the question

agentId

agentId: string

Agent requesting clarification

clarificationType

clarificationType: "guidance" | "preference" | "ambiguity" | "missing_info" | "verification"

Type of clarification needed

Optional options

options?: ClarificationOption[]

Suggested options (if multiple choice)

allowFreeform

allowFreeform: boolean

Whether free-form response is allowed

requestedAt

requestedAt: Date

Timestamp

Optional timeoutMs

timeoutMs?: number

Timeout (ms)

Settings

Member Visibility

Theme

On This Page

requestIdquestioncontextagentIdclarificationTypeoptionsallowFreeformrequestedAttimeoutMs