api

type ActiveFeedState struct {
	FeedID    string          `json:"feedId"`
	Title     string          `json:"title"`
	ItemCount int             `json:"itemCount"`
	Data      json.RawMessage `json:"data,omitempty"`
}

type ApprovalCallback struct {
	ElementID string `json:"elementId,omitempty"`
	Event     string `json:"event,omitempty"`
	Handler   string `json:"handler,omitempty"`
}

type ApprovalCallbackPayload struct {
	Approval     *ApprovalMeta          `json:"approval,omitempty"`
	EditedFields map[string]interface{} `json:"editedFields,omitempty"`
	OriginalArgs map[string]interface{} `json:"originalArgs,omitempty"`
}

type ApprovalCallbackResult struct {
	Allow   bool                   `json:"allow"`
	Message string                 `json:"message,omitempty"`
	Payload map[string]interface{} `json:"payload,omitempty"`
}

type ApprovalEditor struct {
	Name        string            `json:"name"`
	Kind        string            `json:"kind"`
	Path        string            `json:"path,omitempty"`
	Label       string            `json:"label,omitempty"`
	Description string            `json:"description,omitempty"`
	Options     []*ApprovalOption `json:"options,omitempty"`
}

type ApprovalForgeView struct {
	WindowRef    string              `json:"windowRef,omitempty"`
	ContainerRef string              `json:"containerRef,omitempty"`
	DataSource   string              `json:"dataSource,omitempty"`
	Callbacks    []*ApprovalCallback `json:"callbacks,omitempty"`
}

type ApprovalMeta struct {
	Type        string             `json:"type,omitempty"`
	ToolName    string             `json:"toolName,omitempty"`
	Title       string             `json:"title,omitempty"`
	Message     string             `json:"message,omitempty"`
	AcceptLabel string             `json:"acceptLabel,omitempty"`
	RejectLabel string             `json:"rejectLabel,omitempty"`
	CancelLabel string             `json:"cancelLabel,omitempty"`
	Editors     []*ApprovalEditor  `json:"editors,omitempty"`
	Forge       *ApprovalForgeView `json:"forge,omitempty"`
}

type ApprovalOption struct {
	ID          string      `json:"id"`
	Label       string      `json:"label"`
	Description string      `json:"description,omitempty"`
	Item        interface{} `json:"item,omitempty"`
	Selected    bool        `json:"selected"`
}

type AssistantMessageState struct {
	MessageID string `json:"messageId"`
	Content   string `json:"content,omitempty"`
}

type AssistantState struct {
	Preamble *AssistantMessageState `json:"preamble,omitempty"`
	Final    *AssistantMessageState `json:"final,omitempty"`
}

type AsyncOperationState struct {
	OperationID string          `json:"operationId"`
	Status      string          `json:"status,omitempty"`
	Message     string          `json:"message,omitempty"`
	Error       string          `json:"error,omitempty"`
	Response    json.RawMessage `json:"response,omitempty"`
}

type ConversationPage = data.ConversationPage

type ConversationState struct {
	ConversationID string             `json:"conversationId"`
	Turns          []*TurnState       `json:"turns"`
	Feeds          []*ActiveFeedState `json:"feeds,omitempty"`
}

type ConversationStateResponse struct {
	SchemaVersion string             `json:"schemaVersion"`
	Conversation  *ConversationState `json:"conversation"`
	Feeds         []*ActiveFeedState `json:"feeds,omitempty"`
	Usage         *UsageSummary      `json:"usage,omitempty"`
	EventCursor   string             `json:"eventCursor,omitempty"`
}

type CreateConversationInput struct {
	AgentID              string                 `json:"agentId,omitempty"`
	Title                string                 `json:"title,omitempty"`
	Metadata             map[string]interface{} `json:"metadata,omitempty"`
	ParentConversationID string                 `json:"parentConversationId,omitempty"`
	ParentTurnID         string                 `json:"parentTurnId,omitempty"`
}

type DecideToolApprovalInput struct {
	ID            string                 `json:"id,omitempty"`
	Action        string                 `json:"action,omitempty"`
	UserID        string                 `json:"userId,omitempty"`
	Reason        string                 `json:"reason,omitempty"`
	Note          string                 `json:"note,omitempty"`
	Decision      string                 `json:"decision,omitempty"`
	EditedFields  map[string]interface{} `json:"editedFields,omitempty"`
	CallbackState map[string]interface{} `json:"callbackState,omitempty"`
	Payload       map[string]interface{} `json:"payload,omitempty"`
}

type DecideToolApprovalOutput struct {
	Status  string `json:"status"`
	Message string `json:"message,omitempty"`
}

type Direction = data.Direction

type DownloadFileInput struct {
	ConversationID string
	FileID         string
	URI            string
}

type DownloadFileOutput struct {
	Name        string
	ContentType string
	Data        []byte
}

type EditQueuedTurnInput struct {
	ConversationID string `json:"conversationId"`
	TurnID         string `json:"turnId"`
	Content        string `json:"content"`
}

type ElicitationState struct {
	ElicitationID   string            `json:"elicitationId"`
	Status          ElicitationStatus `json:"status"`
	Message         string            `json:"message,omitempty"`
	RequestedSchema json.RawMessage   `json:"requestedSchema,omitempty"`
	CallbackURL     string            `json:"callbackUrl,omitempty"`
	ResponsePayload json.RawMessage   `json:"responsePayload,omitempty"`
}

type ElicitationStatus string

type ExecutionPageState struct {
	PageID                  string            `json:"pageId"`
	AssistantMessageID      string            `json:"assistantMessageId"`
	ParentMessageID         string            `json:"parentMessageId"`
	TurnID                  string            `json:"turnId"`
	Iteration               int               `json:"iteration"`
	Mode                    string            `json:"mode,omitempty"`
	Status                  string            `json:"status,omitempty"`
	ModelSteps              []*ModelStepState `json:"modelSteps,omitempty"`
	ToolSteps               []*ToolStepState  `json:"toolSteps,omitempty"`
	PreambleMessageID       string            `json:"preambleMessageId,omitempty"`
	FinalAssistantMessageID string            `json:"finalAssistantMessageId,omitempty"`
	Preamble                string            `json:"preamble,omitempty"`
	Content                 string            `json:"content,omitempty"`
	FinalResponse           bool              `json:"finalResponse"`
}

type ExecutionState struct {
	Pages          []*ExecutionPageState `json:"pages"`
	ActivePageIdx  int                   `json:"activePageIndex"`
	TotalElapsedMs int64                 `json:"totalElapsedMs"`
}

type ExportResourcesInput struct {
	Kinds []string `json:"kinds,omitempty"`
}

type ExportResourcesOutput struct {
	Data      []byte     `json:"data,omitempty"`
	Resources []Resource `json:"resources,omitempty"`
}

type FeedActivation struct {
	Kind    string `yaml:"kind,omitempty" json:"kind,omitempty"`
	Scope   string `yaml:"scope,omitempty" json:"scope,omitempty"`
	Service string `yaml:"service,omitempty" json:"service,omitempty"`
	Method  string `yaml:"method,omitempty" json:"method,omitempty"`
}

type FeedMatch struct {
	Service string `yaml:"service" json:"service"`
	Method  string `yaml:"method" json:"method"`
}

type FeedSpec struct {
	ID         string                 `yaml:"id" json:"id"`
	Title      string                 `yaml:"title,omitempty" json:"title,omitempty"`
	Match      FeedMatch              `yaml:"match" json:"match"`
	Activation FeedActivation         `yaml:"activation,omitempty" json:"activation,omitempty"`
	DataSource map[string]interface{} `yaml:"dataSource,omitempty" json:"dataSource,omitempty"`
	UI         interface{}            `yaml:"ui,omitempty" json:"ui,omitempty"`
}

type FeedState struct {
	FeedID    string `json:"feedId"`
	Title     string `json:"title"`
	ItemCount int    `json:"itemCount"`
	ToolName  string `json:"toolName,omitempty"`
}

type FileEntry struct {
	ID          string    `json:"id,omitempty"`
	URI         string    `json:"uri"`
	Name        string    `json:"name"`
	Size        int64     `json:"size"`
	IsDir       bool      `json:"isDir"`
	ContentType string    `json:"contentType,omitempty"`
	ModifiedAt  time.Time `json:"modifiedAt,omitempty"`
}

type GetMessagesInput struct {
	ConversationID string
	Page           *PageInput
	ID             string
	TurnID         string
	Roles          []string
	Types          []string
}

type GetResourceOutput struct {
	Kind     string    `json:"kind,omitempty"`
	Name     string    `json:"name,omitempty"`
	Data     []byte    `json:"data,omitempty"`
	Resource *Resource `json:"resource,omitempty"`
}

type GetTemplateInput struct {
	Name            string `json:"name"`
	IncludeDocument *bool  `json:"includeDocument,omitempty"`
}

type GetTemplateOutput struct {
	Name             string                   `json:"name,omitempty"`
	Format           string                   `json:"format,omitempty"`
	Description      string                   `json:"description,omitempty"`
	Instructions     string                   `json:"instructions,omitempty"`
	Fences           []map[string]interface{} `json:"fences,omitempty"`
	Schema           map[string]interface{}   `json:"schema,omitempty"`
	Examples         []map[string]interface{} `json:"examples,omitempty"`
	IncludedDocument bool                     `json:"includedDocument,omitempty"`
}

type GetTranscriptInput struct {
	ConversationID    string
	Since             string
	IncludeModelCalls bool
	IncludeToolCalls  bool
}

type ImportResourcesInput struct {
	Data      []byte     `json:"data,omitempty"`
	Resources []Resource `json:"resources,omitempty"`
	Replace   bool       `json:"replace,omitempty"`
}

type ImportResourcesOutput struct {
	Skipped  int `json:"skipped,omitempty"`
	Imported int `json:"imported"`
}

type LinkedConversationEntry struct {
	ConversationID       string     `json:"conversationId"`
	ParentConversationID string     `json:"parentConversationId,omitempty"`
	ParentTurnID         string     `json:"parentTurnId,omitempty"`
	AgentID              string     `json:"agentId,omitempty"`
	Title                string     `json:"title,omitempty"`
	Status               string     `json:"status,omitempty"`
	Response             string     `json:"response,omitempty"`
	CreatedAt            time.Time  `json:"createdAt"`
	UpdatedAt            *time.Time `json:"updatedAt,omitempty"`
}

type LinkedConversationPage struct {
	Rows       []*LinkedConversationEntry `json:"rows"`
	NextCursor string                     `json:"nextCursor,omitempty"`
	PrevCursor string                     `json:"prevCursor,omitempty"`
	HasMore    bool                       `json:"hasMore"`
}

type LinkedConversationState struct {
	ConversationID       string     `json:"conversationId"`
	ParentConversationID string     `json:"parentConversationId,omitempty"`
	ParentTurnID         string     `json:"parentTurnId,omitempty"`
	ToolCallID           string     `json:"toolCallId,omitempty"`
	AgentID              string     `json:"agentId,omitempty"`
	Title                string     `json:"title,omitempty"`
	Status               string     `json:"status,omitempty"`
	Response             string     `json:"response,omitempty"`
	CreatedAt            time.Time  `json:"createdAt,omitempty"`
	UpdatedAt            *time.Time `json:"updatedAt,omitempty"`
}

type ListConversationsInput struct {
	AgentID          string
	ParentID         string
	ParentTurnID     string
	ExcludeScheduled bool
	Query            string
	Status           string
	Page             *PageInput
}

type ListFilesInput struct {
	ConversationID string
	Prefix         string
	Page           *PageInput
}

type ListFilesOutput struct {
	Files []*FileEntry `json:"files,omitempty"`
	Rows  []*FileEntry `json:"rows,omitempty"`
	Page  *PageInput   `json:"page,omitempty"`
}

type ListLinkedConversationsInput struct {
	ParentConversationID string
	ParentTurnID         string
	Page                 *PageInput
}

type ListPendingElicitationsInput struct {
	ConversationID string
}

type ListPendingToolApprovalsInput struct {
	UserID         string
	ConversationID string
	Status         string
	Limit          int
	Offset         int
}

type ListResourcesInput struct {
	Kind string
}

type ListResourcesOutput struct {
	Names     []string       `json:"names,omitempty"`
	Resources []*ResourceRef `json:"resources"`
}

type ListTemplatesInput struct{}

type ListTemplatesOutput struct {
	Items []TemplateListItem `json:"items"`
}

type MessagePage = data.MessagePage

type ModelStepState struct {
	ModelCallID               string          `json:"modelCallId"`
	AssistantMessageID        string          `json:"assistantMessageId"`
	Provider                  string          `json:"provider,omitempty"`
	Model                     string          `json:"model,omitempty"`
	Status                    string          `json:"status,omitempty"`
	RequestPayloadID          string          `json:"requestPayloadId,omitempty"`
	ResponsePayloadID         string          `json:"responsePayloadId,omitempty"`
	ProviderRequestPayloadID  string          `json:"providerRequestPayloadId,omitempty"`
	ProviderResponsePayloadID string          `json:"providerResponsePayloadId,omitempty"`
	StreamPayloadID           string          `json:"streamPayloadId,omitempty"`
	RequestPayload            json.RawMessage `json:"requestPayload,omitempty"`
	ResponsePayload           json.RawMessage `json:"responsePayload,omitempty"`
	ProviderRequestPayload    json.RawMessage `json:"providerRequestPayload,omitempty"`
	ProviderResponsePayload   json.RawMessage `json:"providerResponsePayload,omitempty"`
	StreamPayload             json.RawMessage `json:"streamPayload,omitempty"`
	StartedAt                 *time.Time      `json:"startedAt,omitempty"`
	CompletedAt               *time.Time      `json:"completedAt,omitempty"`
}

type MoveQueuedTurnInput struct {
	ConversationID string `json:"conversationId"`
	TurnID         string `json:"turnId"`
	Direction      string `json:"direction"`
}

type PageInput = data.PageInput

type PendingElicitation struct {
	ConversationID string                 `json:"conversationId"`
	ElicitationID  string                 `json:"elicitationId"`
	MessageID      string                 `json:"messageId"`
	Status         string                 `json:"status"`
	Role           string                 `json:"role"`
	Type           string                 `json:"type"`
	CreatedAt      time.Time              `json:"createdAt"`
	Content        string                 `json:"content,omitempty"`
	Elicitation    map[string]interface{} `json:"elicitation,omitempty"`
}

type PendingToolApproval struct {
	ID             string                 `json:"id"`
	UserID         string                 `json:"userId"`
	ConversationID string                 `json:"conversationId,omitempty"`
	TurnID         string                 `json:"turnId,omitempty"`
	MessageID      string                 `json:"messageId,omitempty"`
	ToolName       string                 `json:"toolName"`
	Title          string                 `json:"title,omitempty"`
	Arguments      map[string]interface{} `json:"arguments,omitempty"`
	Metadata       map[string]interface{} `json:"metadata,omitempty"`
	Status         string                 `json:"status"`
	Decision       string                 `json:"decision,omitempty"`
	CreatedAt      time.Time              `json:"createdAt"`
	UpdatedAt      *time.Time             `json:"updatedAt,omitempty"`
	ErrorMessage   string                 `json:"errorMessage,omitempty"`
}

type PendingToolApprovalPage struct {
	Rows    []*PendingToolApproval `json:"rows"`
	Total   int                    `json:"total"`
	Limit   int                    `json:"limit"`
	Offset  int                    `json:"offset,omitempty"`
	HasMore bool                   `json:"hasMore,omitempty"`
}

type PlanFeedPayload struct {
	Explanation string      `json:"explanation,omitempty"`
	Steps       []*PlanStep `json:"steps,omitempty"`
}

type PlanStep struct {
	ID      string `json:"id,omitempty"`
	Step    string `json:"step"`
	Status  string `json:"status,omitempty"`
	Details string `json:"details,omitempty"`
}

type QuerySelector struct {
	Path    string `json:"path,omitempty"`
	Limit   int    `json:"limit,omitempty"`
	Offset  int    `json:"offset,omitempty"`
	OrderBy string `json:"orderBy,omitempty"`
}

type ResolveElicitationInput struct {
	ConversationID string
	ElicitationID  string
	Action         string
	Payload        map[string]interface{}
}

type Resource struct {
	Kind        string    `json:"kind"`
	Name        string    `json:"name"`
	Data        []byte    `json:"data,omitempty"`
	ContentType string    `json:"contentType,omitempty"`
	Content     []byte    `json:"content,omitempty"`
	UpdatedAt   time.Time `json:"updatedAt,omitempty"`
}

type ResourceRef struct {
	Kind string `json:"kind"`
	Name string `json:"name"`
}

type SaveResourceInput struct {
	Kind        string
	Name        string
	Data        []byte
	Content     []byte
	ContentType string
}

type StarterTask struct {
	ID          string `json:"id,omitempty"`
	Title       string `json:"title,omitempty"`
	Prompt      string `json:"prompt,omitempty"`
	Description string `json:"description,omitempty"`
	Icon        string `json:"icon,omitempty"`
}

type SteerTurnInput struct {
	ConversationID string `json:"conversationId"`
	TurnID         string `json:"turnId"`
	Content        string `json:"content"`
	Role           string `json:"role,omitempty"`
}

type SteerTurnOutput struct {
	MessageID      string `json:"messageId"`
	TurnID         string `json:"turnId,omitempty"`
	Status         string `json:"status,omitempty"`
	CanceledTurnID string `json:"canceledTurnId,omitempty"`
}

type StreamEventsInput struct {
	ConversationID string
	Filter         streaming.Filter
}

type TemplateListItem struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Format      string `json:"format,omitempty"`
}

type ToolDefinitionInfo struct {
	Name         string                 `json:"name"`
	Description  string                 `json:"description,omitempty"`
	Parameters   map[string]interface{} `json:"parameters,omitempty"`
	Required     []string               `json:"required,omitempty"`
	OutputSchema map[string]interface{} `json:"output_schema,omitempty"`
	Cacheable    bool                   `json:"cacheable,omitempty"`
}

type ToolStepState struct {
	ToolCallID                string               `json:"toolCallId"`
	ToolMessageID             string               `json:"toolMessageId"`
	ToolName                  string               `json:"toolName"`
	OperationID               string               `json:"operationId,omitempty"`
	Status                    string               `json:"status,omitempty"`
	RequestPayloadID          string               `json:"requestPayloadId,omitempty"`
	ResponsePayloadID         string               `json:"responsePayloadId,omitempty"`
	RequestPayload            json.RawMessage      `json:"requestPayload,omitempty"`
	ResponsePayload           json.RawMessage      `json:"responsePayload,omitempty"`
	LinkedConversationID      string               `json:"linkedConversationId,omitempty"`
	LinkedConversationAgentID string               `json:"linkedConversationAgentId,omitempty"`
	LinkedConversationTitle   string               `json:"linkedConversationTitle,omitempty"`
	StartedAt                 *time.Time           `json:"startedAt,omitempty"`
	CompletedAt               *time.Time           `json:"completedAt,omitempty"`
	AsyncOperation            *AsyncOperationState `json:"asyncOperation,omitempty"`
}

type TurnState struct {
	TurnID              string                     `json:"turnId"`
	Status              TurnStatus                 `json:"status"`
	User                *UserMessageState          `json:"user,omitempty"`
	Execution           *ExecutionState            `json:"execution,omitempty"`
	Assistant           *AssistantState            `json:"assistant,omitempty"`
	Elicitation         *ElicitationState          `json:"elicitation,omitempty"`
	LinkedConversations []*LinkedConversationState `json:"linkedConversations,omitempty"`
	CreatedAt           time.Time                  `json:"createdAt,omitempty"`
	QueueSeq            int                        `json:"queueSeq,omitempty"`
	StartedByMessageID  string                     `json:"startedByMessageId,omitempty"`
}

type TurnStatus string

type UpdateConversationInput struct {
	ConversationID string `json:"-"`
	Title          string `json:"title,omitempty"`
	Visibility     string `json:"visibility,omitempty"`
	Shareable      *bool  `json:"shareable,omitempty"`
}

type UploadFileInput struct {
	ConversationID string
	Path           string
	Name           string
	ContentType    string
	Data           []byte
}

type UploadFileOutput struct {
	ID       string `json:"id,omitempty"`
	URI      string `json:"uri"`
	Name     string `json:"name"`
	Size     int64  `json:"size"`
	MimeType string `json:"mimeType,omitempty"`
}

type UsageSummary struct {
	TotalInputTokens  int `json:"totalInputTokens,omitempty"`
	TotalOutputTokens int `json:"totalOutputTokens,omitempty"`
}

type UserMessageState struct {
	MessageID string `json:"messageId"`
	Content   string `json:"content,omitempty"`
}

type WorkspaceAgentInfo struct {
	ID           string        `json:"id,omitempty"`
	Name         string        `json:"name,omitempty"`
	ModelRef     string        `json:"modelRef,omitempty"`
	StarterTasks []StarterTask `json:"starterTasks,omitempty"`
}

type WorkspaceCapabilities struct {
	AgentAutoSelection    bool `json:"agentAutoSelection,omitempty"`
	ModelAutoSelection    bool `json:"modelAutoSelection,omitempty"`
	ToolAutoSelection     bool `json:"toolAutoSelection,omitempty"`
	CompactConversation   bool `json:"compactConversation,omitempty"`
	PruneConversation     bool `json:"pruneConversation,omitempty"`
	AnonymousSession      bool `json:"anonymousSession,omitempty"`
	MessageCursor         bool `json:"messageCursor,omitempty"`
	StructuredElicitation bool `json:"structuredElicitation,omitempty"`
	TurnStartedEvent      bool `json:"turnStartedEvent,omitempty"`
}

type WorkspaceDefaults struct {
	Agent           string `json:"agent,omitempty"`
	Model           string `json:"model,omitempty"`
	Embedder        string `json:"embedder,omitempty"`
	AutoSelectTools bool   `json:"autoSelectTools,omitempty"`
}

type WorkspaceMetadata struct {
	WorkspaceRoot   string                `json:"workspaceRoot,omitempty"`
	DefaultAgent    string                `json:"defaultAgent,omitempty"`
	DefaultModel    string                `json:"defaultModel,omitempty"`
	DefaultEmbedder string                `json:"defaultEmbedder,omitempty"`
	Defaults        *WorkspaceDefaults    `json:"defaults,omitempty"`
	Capabilities    WorkspaceCapabilities `json:"capabilities,omitempty"`
	Agents          []string              `json:"agents,omitempty"`
	Models          []string              `json:"models,omitempty"`
	AgentInfos      []WorkspaceAgentInfo  `json:"agentInfos,omitempty"`
	ModelInfos      []WorkspaceModelInfo  `json:"modelInfos,omitempty"`
	Version         string                `json:"version,omitempty"`
}

type WorkspaceModelInfo struct {
	ID   string `json:"id,omitempty"`
	Name string `json:"name,omitempty"`
}