agents

type APIClient interface {
	API() *api.Client
	APIKey() string
	BaseURL() string
}

type APIError struct {
	StatusCode int
	Message    string
}

type Agent struct {
	// AgentID is the unique identifier for the agent.
	AgentID string

	// Name is the display name of the agent.
	Name string

	// Tags are labels used to categorize the agent.
	Tags []string

	// CreatedAtUnixSecs is the creation time in unix seconds.
	CreatedAtUnixSecs int64

	// Archived indicates whether the agent is archived.
	Archived bool
}

type AgentBranch struct {
	// ID is the unique identifier for the branch.
	ID string

	// Name is the display name of the branch.
	Name string

	// Description is the description of the branch.
	Description string

	// AgentID is the ID of the agent this branch belongs to.
	AgentID string

	// CreatedAt is the creation time in unix seconds.
	CreatedAt int64

	// LastCommittedAt is the time of the last commit in unix seconds.
	LastCommittedAt int64

	// IsArchived indicates whether the branch is archived.
	IsArchived bool

	// CurrentLivePercentage is the percentage of traffic this branch receives.
	CurrentLivePercentage float64

	// ParentBranchID is the ID of the parent branch, nil if none.
	ParentBranchID *string

	// ParentBranchName is the name of the parent branch, nil if none.
	ParentBranchName *string
}

type AgentLink struct {
	// AgentID is the ID of the agent.
	AgentID string

	// SignedURL is the signed URL for accessing the agent.
	SignedURL string

	// ExpiresAtUnixMillis is when the link expires.
	ExpiresAtUnixMillis int64
}

type AgentSummary struct {
	// AgentID is the unique identifier for the agent.
	AgentID string

	// Name is the display name of the agent.
	Name string

	// Tags are labels used to categorize the agent.
	Tags []string

	// Archived indicates whether the agent is archived.
	Archived bool

	// CreatedAtUnixSecs is the creation time in unix seconds.
	CreatedAtUnixSecs int64

	// LastCallTimeUnixSecs is the time of the most recent call, nil if no calls.
	LastCallTimeUnixSecs *int64
}

type AgentTopic struct {
	// TopicID is the unique identifier for the topic.
	TopicID string

	// Label is the display label for the topic.
	Label string

	// Description is the description of the topic.
	Description string

	// ConversationCount is the number of conversations with this topic.
	ConversationCount int

	// ParentTopicID is the ID of the parent topic, nil if none.
	ParentTopicID *string
}

type BatchCall struct {
	// ID is the unique identifier for the batch call.
	ID string

	// Name is the display name of the batch call.
	Name string

	// AgentID is the ID of the agent used for the calls.
	AgentID string

	// AgentName is the name of the agent.
	AgentName string

	// BranchID is the branch ID if applicable.
	BranchID string

	// BranchName is the branch name if applicable.
	BranchName string

	// Status is the batch call status: "pending", "running", "completed", "failed", "cancelled".
	Status string

	// TotalCallsScheduled is the total number of calls scheduled.
	TotalCallsScheduled int

	// TotalCallsDispatched is the number of calls dispatched.
	TotalCallsDispatched int

	// TotalCallsFinished is the number of finished calls.
	TotalCallsFinished int

	// RetryCount is the number of retries performed.
	RetryCount int

	// CreatedAtUnix is the creation time in unix seconds.
	CreatedAtUnix int

	// LastUpdatedAtUnix is the last update time in unix seconds.
	LastUpdatedAtUnix int

	// ScheduledTimeUnix is the scheduled start time in unix seconds.
	ScheduledTimeUnix int
}

type BatchCallDetail struct {
	BatchCall

	// Recipients contains information about each call recipient.
	Recipients []*BatchCallRecipientStatus
}

type BatchCallRecipient struct {
	// PhoneNumber is the recipient's phone number in E.164 format.
	PhoneNumber string

	// ID is an optional custom identifier for this recipient.
	ID string

	// DynamicVariables are optional context variables for this recipient.
	DynamicVariables map[string]any
}

type BatchCallRecipientStatus struct {
	// ID is the unique identifier for this recipient.
	ID string

	// PhoneNumber is the recipient's phone number.
	PhoneNumber string

	// ConversationID is the ID of the conversation created for this call.
	ConversationID string

	// Status is the recipient call status.
	Status string

	// CreatedAtUnix is the creation time in unix seconds.
	CreatedAtUnix int

	// UpdatedAtUnix is the last update time in unix seconds.
	UpdatedAtUnix int
}

type BulkMoveTestsRequest struct {
	TestIDs        []string
	TargetFolderID string
}

type Conversation struct {
	ConversationID         string
	AgentID                string
	AgentName              string
	BranchID               string
	Status                 string
	StartTimeUnixSecs      int
	CallDurationSecs       int
	MessageCount           int
	CallSuccessful         string
	CallSummaryTitle       string
	TranscriptSummary      string
	Rating                 *float64
	MainLanguage           string
	TerminationReason      string
	Direction              string
	ConversationInitiation string
	ToolNames              []string
	VersionID              string
}

type ConversationAnalysis struct {
	CallSuccessful    string
	TranscriptSummary string
	CallSummaryTitle  string
}

type ConversationDetail struct {
	Conversation
	Transcript []TranscriptMessage
	Metadata   map[string]any
	Analysis   *ConversationAnalysis
	HasAudio   bool
	TagIDs     []string
}

type CreateAgentRequest struct {
	// Name is the display name for the agent.
	Name string `json:"name,omitempty"`

	// Tags are labels for categorizing the agent.
	Tags []string `json:"tags,omitempty"`

	// ConversationConfig is the agent's conversation configuration.
	// This is a flexible map to accommodate the complex nested schema.
	ConversationConfig map[string]any `json:"conversation_config,omitempty"`

	// PlatformSettings are optional platform-specific settings.
	PlatformSettings map[string]any `json:"platform_settings,omitempty"`
}

type CreateBatchCallRequest struct {
	// AgentID is the ID of the agent to use for calls.
	AgentID string

	// Name is the display name for the batch call.
	Name string

	// Recipients is the list of call recipients.
	Recipients []BatchCallRecipient

	// AgentPhoneNumberID is the phone number ID to use for outbound calls.
	AgentPhoneNumberID string

	// BranchID specifies a specific branch to use.
	BranchID string

	// Environment specifies the environment for variable resolution.
	Environment string

	// ScheduledTimeUnix is an optional scheduled start time in unix seconds.
	ScheduledTimeUnix *int

	// TargetConcurrencyLimit limits the number of parallel calls.
	TargetConcurrencyLimit *int

	// Timezone for scheduling.
	Timezone string
}

type CreateBranchRequest struct {
	// Name is the display name for the branch.
	Name string `json:"name"`

	// Description is an optional description.
	Description string `json:"description,omitempty"`

	// BaseBranchID is the ID of the branch to fork from.
	BaseBranchID string `json:"base_branch_id,omitempty"`
}

type CreateFileDocumentRequest struct {
	// Name is the display name for the document.
	Name string

	// File is the file content to upload.
	File io.Reader

	// Filename is the original filename.
	Filename string

	// FolderID is the optional parent folder.
	FolderID string
}

type CreateKnowledgeBaseFolderRequest struct {
	// Name is the display name for the folder.
	Name string

	// ParentFolderID is the optional parent folder.
	ParentFolderID string
}

type CreateTestFolderRequest struct {
	Name           string
	ParentFolderID string
}

type CreateTextDocumentRequest struct {
	// Name is the display name for the document.
	Name string

	// Content is the text content.
	Content string

	// FolderID is the optional parent folder.
	FolderID string
}

type CreateURLDocumentRequest struct {
	// Name is the display name for the document.
	Name string

	// URL is the source URL to crawl.
	URL string

	// FolderID is the optional parent folder.
	FolderID string

	// EnableAutoSync enables auto-sync for URL documents.
	EnableAutoSync bool

	// AutoRemove removes the document if URL becomes unavailable.
	AutoRemove bool
}

type DependentAgent struct {
	// ID is the ID of the dependent agent.
	ID string

	// Name is the name of the agent.
	Name string

	// Type is the agent type.
	Type string
}

type DeploymentRequest struct {
	// BranchID is the ID of the branch to deploy.
	BranchID string

	// Percentage is the traffic percentage for this branch (0-100).
	Percentage float64
}

type Document struct {
	// ID is the unique identifier for the document.
	ID string

	// Name is the display name of the document.
	Name string

	// Type is the document type: "file", "text", "url", or "folder".
	Type string

	// FolderPath contains the path segment IDs to the document's folder.
	FolderPath []string
}

type DocumentChunk struct {
	// ID is the unique identifier for the chunk.
	ID string

	// Name is the chunk name.
	Name string

	// Content is the chunk text content.
	Content string
}

type DocumentSummary struct {
	// ID is the unique identifier.
	ID string

	// Name is the display name.
	Name string

	// Type is the document type.
	Type string

	// FolderParentID is the ID of the parent folder.
	FolderParentID string
}

type KnowledgeBaseFolder struct {
	// ID is the unique identifier for the folder.
	ID string

	// Name is the display name of the folder.
	Name string

	// FolderPath contains the path segment IDs to the folder.
	FolderPath []string
}

type ListAgentsOptions struct {
	// PageSize is the maximum number of agents to return (max 100, default 30).
	PageSize int

	// Search filters by agent name.
	Search string

	// Archived filters by archived status.
	Archived *bool

	// SortBy specifies the field to sort by ("name", "created_at", etc.).
	SortBy string

	// SortDirection specifies the sort direction ("asc" or "desc").
	SortDirection string

	// Cursor is the pagination cursor from a previous response.
	Cursor string

	// CreatedByUserID filters to agents created by a specific user.
	// Use "@me" to filter to the authenticated user.
	CreatedByUserID string
}

type ListAgentsResponse struct {
	// Agents is the list of agent summaries.
	Agents []*AgentSummary

	// HasMore indicates if there are more results.
	HasMore bool

	// NextCursor is the cursor for the next page.
	NextCursor string
}

type ListBatchCallsOptions struct {
	// PageSize is the maximum number of batch calls to return (max 100).
	PageSize int

	// Cursor is the pagination cursor from a previous response.
	Cursor string

	// AgentID filters to a specific agent.
	AgentID string

	// Status filters by batch status.
	Status string
}

type ListBatchCallsResponse struct {
	// BatchCalls is the list of batch calls.
	BatchCalls []*BatchCall

	// HasMore indicates if there are more results.
	HasMore bool

	// NextCursor is the cursor for the next page.
	NextCursor string
}

type ListConversationsOptions struct {
	// Cursor for pagination
	Cursor string
	// Filter by agent ID
	AgentID string
	// Filter by call success result: "success", "failure", "unknown"
	CallSuccessful string
	// Filter conversations before this Unix timestamp
	CallStartBeforeUnix *int
	// Filter conversations after this Unix timestamp
	CallStartAfterUnix *int
	// Minimum call duration in seconds
	CallDurationMinSecs *int
	// Maximum call duration in seconds
	CallDurationMaxSecs *int
	// Minimum rating (1-5)
	RatingMin *int
	// Maximum rating (1-5)
	RatingMax *int
	// Filter by presence of feedback comments
	HasFeedbackComment *bool
	// Filter by user ID
	UserID string
	// Filter by branch ID
	BranchID string
	// Filter by topic IDs
	TopicIDs []string
	// Filter by tool names used
	ToolNames []string
	// Filter by main languages
	MainLanguages []string
	// Exclude conversations with these statuses
	ExcludeStatuses []string
	// Maximum conversations to return (max 100, default 30)
	PageSize int
	// Whether to include transcript summaries
	IncludeSummary bool
}

type ListConversationsResponse struct {
	Conversations []*Conversation
	HasMore       bool
	NextCursor    string
}

type ListDocumentsOptions struct {
	// PageSize is the maximum number of documents to return (max 100).
	PageSize int

	// Search filters by document name prefix.
	Search string
}

type ListDocumentsResponse struct {
	// Documents is the list of document summaries.
	Documents []*DocumentSummary

	// HasMore indicates if there are more results.
	HasMore bool

	// NextCursor is the cursor for the next page.
	NextCursor string
}

type ListTestsOptions struct {
	PageSize       int
	Cursor         string
	ParentFolderID string
	Search         string
}

type ListTestsResponse struct {
	Tests      []*TestSummary
	HasMore    bool
	NextCursor string
}

type ResponseTest struct {
	ID       string
	Name     string
	Type     string // "llm", "tool", "simulation"
	FolderID string
}

type ResponseTestSummary struct {
	ID       string
	Name     string
	FolderID string
}

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

type SimulateConversationOptions struct {
	// SimulationPersona describes the simulated user persona.
	SimulationPersona string

	// InitialMessage is the first message to send.
	InitialMessage string

	// MaxTurns limits the conversation length.
	MaxTurns int

	// IncludeAudio requests audio output.
	IncludeAudio bool
}

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

type SimulationMessage struct {
	// Role indicates who sent the message ("user" or "agent").
	Role string

	// Content is the text content of the message.
	Content string

	// Audio contains optional audio data (base64 encoded).
	Audio []byte

	// Metadata contains additional message metadata.
	Metadata map[string]any
}

type TestFolder struct {
	ID            string
	Name          string
	ChildrenCount int
	Path          []TestFolderSegment
}

type TestFolderSegment struct {
	ID   string
	Name string
}

type TestSummary struct {
	ID            string
	Name          string
	FolderID      string
	CreatedAtUnix int
	EntityType    string
	Path          []TestFolderSegment
}

type ToolCall struct {
	ToolName  string
	RequestID string
	Params    map[string]any
}

type TranscriptMessage struct {
	Role           string
	Message        string
	TimeInCallSecs int
	Interrupted    bool
	ToolCalls      []ToolCall
}

type UpdateAgentRequest struct {
	// Name is the new display name for the agent.
	Name string `json:"name,omitempty"`

	// Tags are the new labels for the agent.
	Tags []string `json:"tags,omitempty"`

	// ConversationConfig is the agent's conversation configuration.
	ConversationConfig map[string]any `json:"conversation_config,omitempty"`

	// PlatformSettings are optional platform-specific settings.
	PlatformSettings map[string]any `json:"platform_settings,omitempty"`
}

type UpdateBranchRequest struct {
	// Name is the new display name for the branch.
	Name string `json:"name,omitempty"`

	// Description is the new description.
	Description string `json:"description,omitempty"`

	// IsArchived sets the archived status.
	IsArchived *bool `json:"is_archived,omitempty"`
}

type UpdateTestFolderRequest struct {
	Name string
}

type WidgetConfig struct {
	// AgentID is the ID of the agent.
	AgentID string `json:"agent_id"`

	// WidgetConfig contains widget settings.
	WidgetConfig map[string]any `json:"widget_config,omitempty"`
}