tools

type DTMFEvent string

type DTMFPublisher interface {
	PublishDTMF(context.Context, uint32, string) error
}

type DtmfEvent = DTMFEvent

type EndCallJob interface {
	AddShutdownCallback(func(context.Context, string) error) error
	DeleteRoom(context.Context, string) error
	Shutdown(string)
}

type EndCallSession interface {
	Subscribe(voice.EventSubscriptionOptions) (*voice.EventSubscription, error)
	AgentState() voice.AgentState
	Close(context.Context, ...voice.CloseOptions) error
}

type EndCallToolCalledEvent[UserData any] struct {
	Context   *llm.RunContext
	Arguments struct{}
}

type EndCallToolCompletedEvent[UserData any] struct {
	Context *llm.RunContext
	Output  *EndCallToolOutput
}

type EndCallToolOptions[UserData any] struct {
	ExtraDescription string
	// Nil preserves the agents-js default (true).
	DeleteRoom *bool
	// Zero inherits "say goodbye to the user". Disable maps to null.
	EndInstructions agents.Override[string]
	IgnoreOnEnter   bool
	OnToolCalled    func(context.Context, EndCallToolCalledEvent[UserData]) error
	OnToolCompleted func(context.Context, EndCallToolCompletedEvent[UserData]) error
	Job             EndCallJob
	ReplyTimeout    time.Duration
	ShutdownTimeout time.Duration
	OnError         func(error)
}

type EndCallToolOutput struct{ Type, Value string }

type LocalParticipantDTMFPublisher struct{ Participant *lksdk.LocalParticipant }

type SendDTMFEventsInput struct {
	Events []DTMFEvent `json:"events"`
}

type SendDTMFEventsToolOptions struct {
	Publisher        DTMFPublisher
	ResolvePublisher func(llm.ToolOptions) (DTMFPublisher, error)
	PublishDelay     time.Duration
}

type SendDTMFOptions struct{ PublishDelay time.Duration }