interrupt

type ChildWaiting struct {
	Kind    string `json:"kind"`
	Message string `json:"message,omitempty"`
}

type Interrupt interface {
	// TypeName returns a stable, unique name for this interrupt type. It is
	// used as the JSON discriminator when persisting interrupts to session
	// storage and as the lookup key in the interrupt registry.
	TypeName() string
	// Serialize the interrupt to a byte slice for transmission.
	Serialize() ([]byte, error)
	// Return the interrupt to the agent workflow with a serialized
	// payload of the interrupt result.
	Return([]byte) error
	// Error makes Interrupt compatible with the error interface.
	Error() string
}

type PayloadInitializer interface {
	InitFromPayload([]byte) error
}

type PayloadValidator interface {
	ValidatePayload([]byte) error
}

type PermissionOption struct {
	OptionID string `json:"optionId"`
	Name     string `json:"name"`
	Kind     string `json:"kind"`
}

type ToolPermissionInterrupt struct {
	ToolName string             `json:"toolName,omitempty"`
	Title    string             `json:"title,omitempty"` // human-readable invocation label
	Options  []PermissionOption `json:"options"`

	// Set by Return after the consumer selects an option. Checkpointed so a
	// later activity can TakeResolved and see the decision. Serialize omits
	// these so the client park payload stays unresolved.
	SelectedOptionID string `json:"selectedOptionId,omitempty"`
	SelectedKind     string `json:"selectedKind,omitempty"`
	Allowed          bool   `json:"allowed,omitempty"`
}

type ToolPermissionPayload struct {
	InterruptId string `json:"interruptId,omitempty"`
	OptionID    string `json:"optionId"`
}

type UserChoice struct {
	Title         string `json:"title"`
	Description   string `json:"description"`
	IsRecommended bool   `json:"isRecommended"`
}

type UserSelectionInterrupt struct {
	Question        string       `json:"question,omitempty"`
	Options         []UserChoice `json:"options"`
	ConfirmedChoice *UserChoice
}

type UserSelectionPayload struct {
	InterruptId  string `json:"interruptId"`
	SelectionIdx int    `json:"selectionIdx"`
}