agent

type Agent struct {
	// UID is the Agent UID, used as the path parameter of
	// AgentContext.Conversation.
	UID string `json:"uid"`
	// Name is the Agent name.
	Name string `json:"name"`
	// Description is the Agent description.
	Description string `json:"description"`
	// Mode is the Agent mode, e.g. "chat".
	Mode string `json:"mode"`
	// Icon is the icon URL.
	Icon string `json:"icon"`
	// IsPublished reports whether the Agent is published; only published
	// Agents can start conversations.
	IsPublished bool `json:"is_published"`
	// PublishedAt is the publish time, Unix timestamp in seconds; 0 if
	// unpublished.
	PublishedAt int64 `json:"published_at"`
	// CreatedAt is the creation time, Unix timestamp in seconds.
	CreatedAt int64 `json:"created_at"`
	// UpdatedAt is the last updated time, Unix timestamp in seconds.
	UpdatedAt int64 `json:"updated_at"`
}

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

type AgentsResponse struct {
	// Agents is the Agent list.
	Agents []Agent `json:"agents"`
	// Total is the total number of matching Agents.
	Total int32 `json:"total"`
}

type AnswersByToolCall map[string]map[string]string

type ChatFinishedEvent struct {
	// ChatID is the ID of the owning conversation.
	ChatID int64 `json:"chat_id"`
	// ChatUID identifies the conversation.
	ChatUID string `json:"chat_uid"`
	// MessageID is the message ID of this round.
	MessageID string `json:"message_id"`
	// Error has been empty in every run observed so far.
	Error string `json:"error"`
	// ErrorMessage has been empty in every run observed so far.
	ErrorMessage string `json:"error_message"`
}

type ChatStartedEvent struct {
	// ChatUID identifies the conversation.
	ChatUID string `json:"chat_uid"`
	// MessageID is the message ID of this round.
	MessageID string `json:"message_id"`
	// ChatID is the ID of the owning conversation.
	ChatID int64 `json:"chat_id"`
	// Error is the error detail; empty at start.
	Error string `json:"error"`
	// ErrorMessage is the user-facing error message; empty at start.
	ErrorMessage string `json:"error_message"`
}

type ChatTitleUpdatedEvent struct {
	// ChatID is the ID of the owning conversation.
	ChatID int64 `json:"chat_id"`
	// ChatUID identifies the conversation.
	ChatUID string `json:"chat_uid"`
	// Source describes where the title came from, e.g. "ai_generated".
	Source string `json:"source"`
	// Title is the new (possibly truncated) title.
	Title string `json:"title"`
	// UpdatedAt is a Unix timestamp in seconds.
	UpdatedAt int64 `json:"updated_at"`
}

type ConversationError struct {
	// Code is the error code.
	Code int32 `json:"code"`
	// Message is the error message.
	Message string `json:"message"`
}

type ConversationResponse struct {
	// ChatUID identifies the conversation, used for follow-up questions and
	// troubleshooting.
	ChatUID string `json:"chat_uid"`
	// MessageID is the message ID of this round.
	MessageID string `json:"message_id"`
	// Status is the final run status.
	Status ConversationStatus `json:"status"`
	// Answer is the final answer text; valid when Status is
	// ConversationStatusSucceeded.
	Answer string `json:"answer"`
	// References are sources referenced by the answer; nil if none.
	References []Reference `json:"references"`
	// FurtherQuestions are suggested follow-up questions ("you might also
	// ask"); nil if none.
	FurtherQuestions []string `json:"further_questions"`
	// ElapsedTime is the run duration in seconds.
	ElapsedTime float64 `json:"elapsed_time"`
	// Interrupt is present only when Status is ConversationStatusInterrupted.
	Interrupt *Interrupt `json:"interrupt"`
	// Error is present only when the run failed.
	Error *ConversationError `json:"error"`
}

type ConversationStatus string

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

type ConversationStreamEvent interface {
	// contains filtered or unexported methods
}

type GetAgentsOptions struct {
	// Page is the page number, starting at 1. 0 uses the server default.
	Page int32
	// Limit is the page size. 0 uses the server default.
	Limit int32
	// Name fuzzy-searches by Agent name. Empty omits the filter.
	Name string
}

type HumanInteraction struct {
	// ToolCallID is the tool call that requested the interaction.
	ToolCallID string `json:"tool_call_id"`
	// InterruptID is the stable key expected by the answers map when continuing.
	InterruptID string `json:"interrupt_id"`
	// InteractionType is the interaction type such as "ask_human" or
	// "trade_password".
	InteractionType string `json:"type"`
	// ToolName is the human-readable tool name.
	ToolName string `json:"tool_name"`
	// Questions and answer options presented to the user.
	Questions []Question `json:"questions"`
	// ToolArgs is the original tool arguments, retained for host-specific UI
	// rendering.
	ToolArgs json.RawMessage `json:"tool_args"`
}

type HumanInteractionRequiredEvent struct {
	*Interrupt
}

type Interrupt struct {
	// NodeID is the ID of the node that triggered the interrupt.
	NodeID string `json:"node_id"`
	// ToolCallID is the tool call ID of this inquiry; used as the outer key
	// of AnswersByToolCall when continuing.
	ToolCallID string `json:"tool_call_id"`
	// Questions you need to answer.
	Questions []Question `json:"questions"`
	// Interactions are the full interaction descriptors used to render and
	// answer the pause.
	Interactions []HumanInteraction `json:"interactions"`
	// MessageID is the ID of the paused message.
	MessageID int64 `json:"message_id"`
	// ChatID is the ID of the owning conversation.
	ChatID int64 `json:"chat_id"`
}

type MessageEvent struct {
	// Text is the incremental answer text.
	Text string `json:"text"`
}

type OtherEvent struct {
	// Event is the SSE envelope's "event" field (the event type name).
	Event string
	// Data is the SSE envelope's "data" field.
	Data json.RawMessage
}

type PingEvent struct{}

type Question struct {
	// Question is the question text.
	Question string `json:"question"`
	// Options are the answer options; empty means free-form answer.
	Options []QuestionOption `json:"options"`
	// MultiSelect reports whether multiple options may be selected.
	MultiSelect bool `json:"multi_select"`
}

type QuestionOption struct {
	// Label is the short UI label for the option.
	Label string `json:"label"`
	// Description is the option text.
	Description string `json:"description"`
}

type Reference struct {
	// Index is the reference index.
	Index int32 `json:"index"`
	// OriginalIndex is the index in the source list before any reranking.
	OriginalIndex int32 `json:"original_index"`
	// RefType is the reference kind, e.g. "NewsArticle".
	RefType string `json:"type"`
	// ID is the reference id.
	ID string `json:"id"`
	// Title is the reference title. Often empty at the top level — the
	// human-readable title usually lives in Content.
	Title string `json:"title"`
	// URL is the reference URL. Often empty at the top level — see Content.
	URL string `json:"url"`
	// Content is the full reference payload as sent by the server (source,
	// description, published_at, source_url, source_logo, kind, …), kept as
	// raw JSON because the field set varies by RefType. nil if absent.
	Content json.RawMessage `json:"content"`
}

type WorkflowFinishedEvent struct {
	*ConversationResponse
}

type WorkflowStartedEvent struct {
	// HitCache reports whether this run's answer was served from a cache.
	HitCache bool `json:"hit_cache"`
	// Inputs echoes the run's inputs.
	Inputs WorkflowStartedInputs `json:"inputs"`
	// StartedAt is a Unix timestamp in seconds.
	StartedAt int64 `json:"started_at"`
	// WorkflowID is an internal workflow run ID.
	WorkflowID int64 `json:"workflow_id"`
}

type WorkflowStartedInputs struct {
	// ChatID is the ID of the owning conversation.
	ChatID int64 `json:"chat_id"`
	// ChatUID identifies the conversation.
	ChatUID string `json:"chat_uid"`
	// MessageID is the message ID of this round.
	MessageID string `json:"message_id"`
	// Query is the question that was asked.
	Query string `json:"query"`
}

type Workspace struct {
	// ID is the Workspace ID.
	ID string `json:"id"`
	// Name is the Workspace name.
	Name string `json:"name"`
	// CreatedAt is the creation time, Unix timestamp in seconds.
	CreatedAt int64 `json:"created_at"`
	// UpdatedAt is the last updated time, Unix timestamp in seconds.
	UpdatedAt int64 `json:"updated_at"`
}

type WorkspacesResponse struct {
	// Workspaces the current account belongs to.
	Workspaces []Workspace `json:"workspaces"`
}