input

type AdvanceInteractionInput struct {
	BotID     string
	RequestID string
	Op        InteractionOp
}

type AdvanceInteractionResult struct {
	// Handled is false when the request no longer exists or is not pending
	// (already answered, canceled, expired) — callers should tell the user
	// the interaction ended rather than surface an error.
	Handled bool
	// Changed reports whether state was persisted; unchanged ops (same-page
	// nav, replay after completion) need no card re-render.
	Changed bool
	Reject  InteractionReject
	Request Request
}

type AdvanceTextInput struct {
	UILanguage             string
	BotID                  string
	SessionID              string
	ExplicitID             string
	ReplyExternalMessageID string
	Text                   string
}

type AdvanceTextResult struct {
	Handled bool
	Invalid bool
	Request Request
}

type CancelInput struct {
	RequestID              string
	ActorChannelIdentityID string
	Reason                 string
}

type CreatePendingInput struct {
	BotID                        string
	SessionID                    string
	RouteID                      string
	ChannelIdentityID            string
	WorkspaceTargetID            string
	RequestedByChannelIdentityID string
	ToolCallID                   string
	ToolName                     string
	Input                        any
	ProviderMetadata             map[string]any
	SourcePlatform               string
	ReplyTarget                  string
	ConversationType             string
	ExpiresAt                    *time.Time
}

type ElicitationFormMapping struct {
	// contains filtered or unexported fields
}

type FlowRequest struct {
	Input CreatePendingInput
	// ActorChannelIdentityID is recorded on system cancels.
	ActorChannelIdentityID string
	Interactive            bool
	WaitTimeout            time.Duration
	Emit                   func(Request) bool
	NonInteractiveReason   string
	UndeliveredReason      string
	TimeoutReason          string
	AbortReason            string
}

type FlowResult struct {
	Request Request
}

type FlowService interface {
	CreatePending(ctx context.Context, input CreatePendingInput) (Request, error)
	Cancel(ctx context.Context, input CancelInput) (Request, error)
	WaitForRegisteredResponse(ctx context.Context, requestID string) (Request, error)
	RegisterWaiter(requestID string) func()
}

type InteractionOp struct {
	Kind InteractionOpKind
	// QuestionIndex/OptionIndex address buttons for select/toggle; indexes
	// are stable because UIPayload question/option order never changes after
	// CreatePending.
	QuestionIndex int
	OptionIndex   int
	// Page is the navigate target.
	Page int
	// QuestionID binds set_text to the question that requested free text,
	// not to the current cursor — navigation may have moved since the
	// prompt was issued.
	QuestionID string
	Text       string
}

type InteractionOpKind string

type InteractionOutcome struct {
	Changed bool
	Reject  InteractionReject
}

type InteractionReject string

type QuestionAnswer struct {
	QuestionID string   `json:"question_id"`
	OptionIDs  []string `json:"option_ids,omitempty"`
	CustomText string   `json:"custom_text,omitempty"`
	Text       string   `json:"text,omitempty"`
	Skipped    bool     `json:"skipped,omitempty"`
}

type Request struct {
	ID                      string               `json:"id"`
	BotID                   string               `json:"bot_id"`
	SessionID               string               `json:"session_id"`
	RouteID                 string               `json:"route_id,omitempty"`
	ChannelIdentityID       string               `json:"channel_identity_id,omitempty"`
	WorkspaceTargetID       string               `json:"workspace_target_id,omitempty"`
	ToolCallID              string               `json:"tool_call_id"`
	ToolName                string               `json:"tool_name"`
	ShortID                 int                  `json:"short_id"`
	Status                  string               `json:"status"`
	Input                   map[string]any       `json:"input,omitempty"`
	UIPayload               UIPayload            `json:"ui_payload"`
	Interaction             TextInteractionState `json:"interaction"`
	InteractionRevision     int                  `json:"interaction_revision"`
	Result                  map[string]any       `json:"result,omitempty"`
	ProviderMetadata        map[string]any       `json:"-"`
	PromptExternalMessageID string               `json:"prompt_external_message_id,omitempty"`
	SourcePlatform          string               `json:"source_platform,omitempty"`
	ReplyTarget             string               `json:"reply_target,omitempty"`
	ConversationType        string               `json:"conversation_type,omitempty"`
	ExpiresAt               *time.Time           `json:"expires_at,omitempty"`
	CreatedAt               time.Time            `json:"created_at"`
	RespondedAt             *time.Time           `json:"responded_at,omitempty"`
	CanceledAt              *time.Time           `json:"canceled_at,omitempty"`
	RuntimeFenced           bool                 `json:"-"`
}

type ResolveInput struct {
	BotID                  string
	SessionID              string
	ExplicitID             string
	ReplyExternalMessageID string
}

type Service struct {
	// contains filtered or unexported fields
}

type SubmitInput struct {
	RequestID              string
	ActorChannelIdentityID string
	Answers                []QuestionAnswer
}

type TextInteractionState struct {
	QuestionIndex int              `json:"question_index"`
	Answers       []QuestionAnswer `json:"answers,omitempty"`
	Completed     bool             `json:"completed,omitempty"`
}

type UIAnswer struct {
	QuestionID string     `json:"question_id"`
	Question   string     `json:"question"`
	Selected   []UIOption `json:"selected,omitempty"`
	CustomText string     `json:"custom_text,omitempty"`
	Text       string     `json:"text,omitempty"`
	Skipped    bool       `json:"skipped,omitempty"`

} // @name userinput.UIAnswer

type UIOption struct {
	LabelKey    string `json:"label_key,omitempty"`
	ID          string `json:"id"`
	Label       string `json:"label"`
	Description string `json:"description,omitempty"`

} // @name userinput.UIOption

type UIPayload struct {
	Version   int          `json:"version"`
	Questions []UIQuestion `json:"questions"`
}

type UIQuestion struct {
	ID              string     `json:"id"`
	Text            string     `json:"text"`
	Kind            string     `json:"kind"`
	Options         []UIOption `json:"options,omitempty"`
	AllowCustom     bool       `json:"allow_custom,omitempty"`
	CustomExclusive bool       `json:"custom_exclusive,omitempty"`
	// Required is tri-state for compatibility. Legacy/native ask_user payloads
	// omit it and keep their existing surface semantics; ACP forms set it
	// explicitly so false means an optional schema property.
	Required    *bool  `json:"required,omitempty"`
	Placeholder string `json:"placeholder,omitempty"`

} // @name userinput.UIQuestion