app

type APIError struct {
	StatusCode int
	Body       string
}

type AudioClient interface {
	TranscribeAudio(ctx context.Context, audioPath string, opts TranscriptionOptions) (*TranscriptionResponse, error)
}

type CacheStats struct {
	TotalEntries   int    `json:"total_entries"`
	ExpiredEntries int    `json:"expired_entries"`
	SizeBytes      int64  `json:"size_bytes"`
	CacheDir       string `json:"cache_dir"`
}

type ChatClient interface {
	Chat(ctx context.Context, prompt string, opts ChatOptions) (string, error)
}

type ChatOptions struct {
	Model       string   // Override default model
	Temperature *float64 // Override default temperature
	MaxTokens   *int     // Override default max tokens
	TopP        *float64 // Override default top_p
	Thinking    *bool    // Enable thinking mode
	WebEnabled  *bool    // Enable web content fetching
	WebTimeout  *int     // Web fetch timeout in seconds

	// Legacy fields for backward compatibility
	FilePath     string    // Optional file to include in context
	Context      []Message // Previous messages for context
	Think        bool      // Enable thinking/reasoning mode (legacy)
	SystemPrompt string    // Custom system prompt
}

type ChatRequest struct {
	Model       string    `json:"model"`
	Messages    []Message `json:"messages"`
	Stream      bool      `json:"stream"` // Reserved for future streaming API support
	Temperature float64   `json:"temperature,omitempty"`
	MaxTokens   int       `json:"max_tokens,omitempty"`
	TopP        float64   `json:"top_p,omitempty"`
	Thinking    *Thinking `json:"thinking,omitempty"`
}

type ChatResponse struct {
	ID      string   `json:"id"`
	Object  string   `json:"object"`
	Created int64    `json:"created"`
	Model   string   `json:"model"`
	Choices []Choice `json:"choices"`
	Usage   Usage    `json:"usage"`
}

type Choice struct {
	Index        int     `json:"index"`
	Message      Message `json:"message"`
	FinishReason string  `json:"finish_reason"`
}

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

type CircuitBreakerState int

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

type ClientConfig struct {
	APIKey         string
	BaseURL        string
	CodingBaseURL  string
	Model          string
	Timeout        time.Duration
	Verbose        bool
	RateLimit      RateLimitConfig
	RetryConfig    RetryConfig
	CircuitBreaker config.CircuitBreakerConfig
}

type ClientDeps struct {
	HTTPClient HTTPDoer
	FileReader FileReader
}

type ContentPart struct {
	Type     string           `json:"type"` // "text" or "image_url"
	Text     string           `json:"text,omitempty"`
	ImageURL *ImageURLContent `json:"image_url,omitempty"`
}

type DownloadResult struct {
	FilePath string
	Size     int64
	Error    error
}

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

type FileReader = utils.FileReader

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

type FullClient interface {
	ChatClient
	VisionClient
	ImageClient
	ModelClient
	WebReaderClient
	WebSearchClient
	AudioClient
	VideoClient
}

type HTTPDoer interface {
	Do(req *http.Request) (*http.Response, error)
}

type HistoryEntry struct {
	ID         string      `json:"id,omitempty"`
	Timestamp  time.Time   `json:"timestamp"`
	Prompt     string      `json:"prompt"`
	Response   interface{} `json:"response"` // Support string or complex response
	Model      string      `json:"model"`
	TokenUsage Usage       `json:"token_usage,omitempty"`

	// Image generation fields
	ImageURL    string `json:"image_url,omitempty"`
	ImageSize   string `json:"image_size,omitempty"`
	ImageFormat string `json:"image_format,omitempty"`
	Type        string `json:"type"` // "chat", "image", or "web"

	// Web reader fields
	WebSources []string `json:"web_sources,omitempty"`
}

type HistoryStore interface {
	Save(entry HistoryEntry) error
	GetRecent(limit int) ([]HistoryEntry, error)
}

type ImageClient interface {
	GenerateImage(ctx context.Context, prompt string, opts ImageOptions) (*ImageResponse, error)
}

type ImageData struct {
	URL           string `json:"url"`
	RevisedPrompt string `json:"revised_prompt,omitempty"`
	Width         int    `json:"width"`
	Height        int    `json:"height"`
	Format        string `json:"format"`
}

type ImageGenerationRequest struct {
	Model   string `json:"model"` // "glm-image"
	Prompt  string `json:"prompt"`
	Quality string `json:"quality,omitempty"` // "hd" or "standard"
	Size    string `json:"size,omitempty"`    // "1024x1024"
	UserID  string `json:"user_id,omitempty"` // Optional
}

type ImageModel struct {
	ID          string `json:"id"`
	Object      string `json:"object"`
	Created     int64  `json:"created"`
	OwnedBy     string `json:"owned_by"`
	Description string `json:"description,omitempty"`
}

type ImageOptions struct {
	Quality string // "hd" or "standard"
	Size    string // "widthxheight" format
	UserID  string // Optional user ID for analytics
	Model   string // Override default model
}

type ImageResponse struct {
	ID      string      `json:"id"`
	Object  string      `json:"object"`
	Created int64       `json:"created"`
	Model   string      `json:"model"`
	Data    []ImageData `json:"data"`
	Usage   Usage       `json:"usage,omitempty"`
}

type ImageURLContent struct {
	URL string `json:"url"`
}

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

type Message struct {
	Role    string `json:"role"`
	Content string `json:"content"`
}

type Model struct {
	ID      string `json:"id"`
	Object  string `json:"object"`
	Created int64  `json:"created"`
	OwnedBy string `json:"owned_by"`
}

type ModelClient interface {
	ListModels(ctx context.Context) ([]Model, error)
}

type ModelsResponse struct {
	Object string  `json:"object"`
	Data   []Model `json:"data"`
}

type OSFileReader = utils.OSFileReader

type RateLimitConfig struct {
	RequestsPerSecond int
	Burst             int
}

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

type ReaderResult struct {
	Content           string                 `json:"content"`
	Description       string                 `json:"description"`
	Title             string                 `json:"title"`
	URL               string                 `json:"url"`
	ExternalResources map[string]interface{} `json:"external_resources,omitempty"`
	Metadata          map[string]interface{} `json:"metadata,omitempty"`
}

type RetryConfig struct {
	MaxAttempts    int           // Maximum number of retry attempts (default: 3)
	InitialBackoff time.Duration // Initial backoff duration (default: 1s)
	MaxBackoff     time.Duration // Maximum backoff duration (default: 30s)
}

type SearchCache interface {
	Get(query string, opts SearchOptions) ([]SearchResult, bool)
	Set(query string, opts SearchOptions, results []SearchResult, ttl time.Duration) error
	Clear() error
	Cleanup() error // Remove expired entries
}

type SearchCacheEntry struct {
	Query     string         `json:"query"`
	Results   []SearchResult `json:"results"`
	CachedAt  time.Time      `json:"cached_at"`
	ExpiresAt time.Time      `json:"expires_at"`
	Hash      string         `json:"hash"` // SHA256 of query + options
}

type SearchOptions struct {
	Count         int    // Number of results (1-50)
	DomainFilter  string // Limit to specific domain
	RecencyFilter string // Time filter: oneDay, oneWeek, oneMonth, oneYear, noLimit
	RequestID     string // Unique request ID
	UserID        string // User ID for analytics
}

type SearchOutputFormat string

type SearchResult struct {
	Title       string `json:"title"`
	Content     string `json:"content"`
	Link        string `json:"link"`
	Media       string `json:"media"`
	Icon        string `json:"icon"`
	Refer       string `json:"refer"`
	PublishDate string `json:"publish_date"`
}

type Thinking struct {
	Type string `json:"type"`
}

type TranscriptionOptions struct {
	Model     string   // Override default model (default: glm-asr-2512)
	Prompt    string   // Context from prior transcriptions (max 8000 chars)
	Hotwords  []string // Domain vocabulary (max 100 items)
	Stream    bool     // Enable streaming via Event Stream
	UserID    string   // End user ID (6-128 characters)
	RequestID string   // Client-provided unique identifier
}

type TranscriptionResponse struct {
	ID        string `json:"id"`
	Created   int64  `json:"created"`
	RequestID string `json:"request_id,omitempty"`
	Model     string `json:"model"`
	Text      string `json:"text"`
}

type Usage struct {
	PromptTokens     int `json:"prompt_tokens"`
	CompletionTokens int `json:"completion_tokens"`
	TotalTokens      int `json:"total_tokens"`
}

type VideoClient interface {
	GenerateVideo(ctx context.Context, prompt string, opts VideoOptions) (*VideoGenerationResponse, error)
	RetrieveVideoResult(ctx context.Context, taskID string) (*VideoResultResponse, error)
}

type VideoGenerationRequest struct {
	Model     string   `json:"model"`                // "cogvideox-3"
	Prompt    string   `json:"prompt,omitempty"`     // Text description (max 512 chars)
	ImageURL  []string `json:"image_url,omitempty"`  // URL or base64, 1-2 images (first/last frame)
	Quality   string   `json:"quality,omitempty"`    // "quality" or "speed" (default: speed)
	WithAudio bool     `json:"with_audio,omitempty"` // AI sound effects (default: false)
	Size      string   `json:"size,omitempty"`       // 1280x720, 1920x1080, 3840x2160, etc.
	FPS       int      `json:"fps,omitempty"`        // 30 or 60 (default: 30)
	Duration  int      `json:"duration,omitempty"`   // 5 or 10 seconds (default: 5)
	RequestID string   `json:"request_id,omitempty"`
	UserID    string   `json:"user_id,omitempty"`
}

type VideoGenerationResponse struct {
	ID         string `json:"id"` // Task ID for polling
	Model      string `json:"model"`
	RequestID  string `json:"request_id"`
	TaskStatus string `json:"task_status"` // PROCESSING, SUCCESS, FAIL
}

type VideoOptions struct {
	Model     string   // Override default model
	Quality   string   // "quality" or "speed"
	Size      string   // Resolution
	FPS       int      // Frame rate
	Duration  int      // Duration in seconds
	WithAudio bool     // Include AI sound effects
	ImageURLs []string // First/last frame images
	UserID    string   // User ID for analytics
	RequestID string   // Unique request ID
}

type VideoResult struct {
	URL           string `json:"url"`             // Video URL
	CoverImageURL string `json:"cover_image_url"` // Thumbnail URL
}

type VideoResultResponse struct {
	Model       string        `json:"model"`
	VideoResult []VideoResult `json:"video_result"`
	TaskStatus  string        `json:"task_status"` // PROCESSING, SUCCESS, FAIL
	RequestID   string        `json:"request_id"`
}

type VisionClient interface {
	Vision(ctx context.Context, prompt string, imageBase64 string, opts VisionOptions) (string, error)
}

type VisionMessage struct {
	Role    string        `json:"role"`
	Content []ContentPart `json:"content"`
}

type VisionOptions struct {
	Model       string   // Override default model (e.g., "glm-4.6v")
	Temperature *float64 // Override default temperature
	MaxTokens   *int     // Override default max tokens
	TopP        *float64 // Override default top_p
}

type VisionRequest struct {
	Model       string          `json:"model"`
	Messages    []VisionMessage `json:"messages"`
	Stream      bool            `json:"stream"` // Reserved for future streaming API support
	Temperature float64         `json:"temperature,omitempty"`
	MaxTokens   int             `json:"max_tokens,omitempty"`
	TopP        float64         `json:"top_p,omitempty"`
}

type WebReaderClient interface {
	FetchWebContent(ctx context.Context, url string, opts *WebReaderOptions) (*WebReaderResponse, error)
}

type WebReaderOptions struct {
	Timeout           *int
	NoCache           *bool
	ReturnFormat      string // "markdown" or "text"
	RetainImages      *bool
	NoGFM             *bool
	KeepImgDataURL    *bool
	WithImagesSummary *bool
	WithLinksSummary  *bool
}

type WebReaderRequest struct {
	URL               string `json:"url"`
	Timeout           *int   `json:"timeout,omitempty"`             // default: 20
	NoCache           *bool  `json:"no_cache,omitempty"`            // default: false
	ReturnFormat      string `json:"return_format,omitempty"`       // default: "markdown"
	RetainImages      *bool  `json:"retain_images,omitempty"`       // default: true
	NoGFM             *bool  `json:"no_gfm,omitempty"`              // default: false
	KeepImgDataURL    *bool  `json:"keep_img_data_url,omitempty"`   // default: false
	WithImagesSummary *bool  `json:"with_images_summary,omitempty"` // default: false
	WithLinksSummary  *bool  `json:"with_links_summary,omitempty"`  // default: false
}

type WebReaderResponse struct {
	ID           string       `json:"id"`
	Created      int64        `json:"created"`
	ReaderResult ReaderResult `json:"reader_result"`
}

type WebSearchClient interface {
	SearchWeb(ctx context.Context, query string, opts SearchOptions) (*WebSearchResponse, error)
}

type WebSearchRequest struct {
	SearchEngine        string  `json:"search_engine"` // "search-prime"
	SearchQuery         string  `json:"search_query"`
	Count               *int    `json:"count,omitempty"` // 1-50, default 10
	SearchDomainFilter  *string `json:"search_domain_filter,omitempty"`
	SearchRecencyFilter *string `json:"search_recency_filter,omitempty"` // oneDay/oneWeek/oneMonth/oneYear/noLimit
	RequestID           *string `json:"request_id,omitempty"`
	UserID              *string `json:"user_id,omitempty"`
}

type WebSearchResponse struct {
	ID           string         `json:"id"`
	Created      int64          `json:"created"`
	SearchResult []SearchResult `json:"search_result"`
}