llm

type AbortError struct {
	SDKError
}

type AccessDeniedError struct {
	ProviderError
}

type ActivityCallback func(ActivityEvent)

type ActivityEvent struct {
	Timestamp time.Time
	Model     string
	Provider  string
	// Request info
	ToolCount    int
	MessageCount int
	// Response info (empty on error)
	ResponseSnippet string
	ToolCalls       []string // names of tools called by the model
	InputTokens     int
	OutputTokens    int
	Latency         time.Duration
	// Error info
	Err error
}

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

type AudioData struct {
	URL       string `json:"url,omitempty"`
	Data      []byte `json:"data,omitempty"`
	MediaType string `json:"media_type,omitempty"`
}

type AuthenticationError struct {
	ProviderError
}

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

type ClientOption func(*clientConfig)

type CompleteHandler func(ctx context.Context, req *Request) (*Response, error)

type ConfigurationError struct {
	SDKError
}

type ContentFilterError struct {
	ProviderError
}

type ContentKind string

type ContentPart struct {
	Kind       ContentKind     `json:"kind"`
	Text       string          `json:"text,omitempty"`
	Image      *ImageData      `json:"image,omitempty"`
	Audio      *AudioData      `json:"audio,omitempty"`
	Document   *DocumentData   `json:"document,omitempty"`
	ToolCall   *ToolCallData   `json:"tool_call,omitempty"`
	ToolResult *ToolResultData `json:"tool_result,omitempty"`
	Thinking   *ThinkingData   `json:"thinking,omitempty"`
}

type ContextLengthError struct {
	ProviderError
}

type DocumentData struct {
	URL       string `json:"url,omitempty"`
	Data      []byte `json:"data,omitempty"`
	MediaType string `json:"media_type,omitempty"`
	FileName  string `json:"file_name,omitempty"`
}

type FinishReason struct {
	Reason string `json:"reason"`
	Raw    string `json:"raw,omitempty"`
}

type ImageData struct {
	URL       string `json:"url,omitempty"`
	Data      []byte `json:"data,omitempty"`
	MediaType string `json:"media_type,omitempty"`
	Detail    string `json:"detail,omitempty"`
}

type InvalidRequestError struct {
	ProviderError
}

type InvalidToolCallError struct {
	SDKError
}

type Message struct {
	Role       Role          `json:"role"`
	Content    []ContentPart `json:"content"`
	Name       string        `json:"name,omitempty"`
	ToolCallID string        `json:"tool_call_id,omitempty"`
}

type Middleware interface {
	WrapComplete(next CompleteHandler) CompleteHandler
}

type MiddlewareFunc func(next CompleteHandler) CompleteHandler

type ModelInfo struct {
	ID                string   `json:"id"`
	Provider          string   `json:"provider"`
	DisplayName       string   `json:"display_name"`
	ContextWindow     int      `json:"context_window"`
	MaxOutput         int      `json:"max_output"`
	SupportsTools     bool     `json:"supports_tools"`
	SupportsVision    bool     `json:"supports_vision"`
	SupportsReasoning bool     `json:"supports_reasoning"`
	InputCostPerM     float64  `json:"input_cost_per_m"`
	OutputCostPerM    float64  `json:"output_cost_per_m"`
	Aliases           []string `json:"aliases,omitempty"`
}

type ModelResolver func(provider string) string

type NetworkError struct {
	SDKError
}

type NoObjectGeneratedError struct {
	SDKError
}

type NotFoundError struct {
	ProviderError
}

type ProviderAdapter interface {
	// Name returns the provider's identifier (e.g. "openai", "anthropic").
	Name() string

	// Complete sends a request and returns the full response.
	Complete(ctx context.Context, req *Request) (*Response, error)

	// Stream sends a request and returns a channel of streaming events.
	Stream(ctx context.Context, req *Request) <-chan StreamEvent

	// Close releases any resources held by the adapter.
	Close() error
}

type ProviderCost struct {
	Usage Usage
	Model string
	USD   float64
}

type ProviderError struct {
	SDKError
	Provider   string
	StatusCode int
	ErrorCode  string
	RetryAfter *float64
	RawBody    json.RawMessage
}

type ProviderErrorInterface interface {
	error
	Retryable() bool
	GetProvider() string
	GetStatusCode() int
}

type QuotaExceededError struct {
	ProviderError
}

type RateLimitError struct {
	ProviderError
}

type RateLimitInfo struct {
	RequestsRemaining *int       `json:"requests_remaining,omitempty"`
	RequestsLimit     *int       `json:"requests_limit,omitempty"`
	TokensRemaining   *int       `json:"tokens_remaining,omitempty"`
	TokensLimit       *int       `json:"tokens_limit,omitempty"`
	ResetAt           *time.Time `json:"reset_at,omitempty"`
}

type Request struct {
	Model           string            `json:"model"`
	Messages        []Message         `json:"messages"`
	Provider        string            `json:"provider,omitempty"`
	Tools           []ToolDefinition  `json:"tools,omitempty"`
	ToolChoice      *ToolChoice       `json:"tool_choice,omitempty"`
	ResponseFormat  *ResponseFormat   `json:"response_format,omitempty"`
	Temperature     *float64          `json:"temperature,omitempty"`
	TopP            *float64          `json:"top_p,omitempty"`
	MaxTokens       *int              `json:"max_tokens,omitempty"`
	StopSequences   []string          `json:"stop_sequences,omitempty"`
	ReasoningEffort string            `json:"reasoning_effort,omitempty"`
	Metadata        map[string]string `json:"metadata,omitempty"`
	ProviderOptions map[string]any    `json:"provider_options,omitempty"`
	TraceObservers  []TraceObserver   `json:"-"`
}

type RequestTimeoutError struct {
	ProviderError
}

type RequestTransformFunc func(req *Request)

type Response struct {
	ID           string          `json:"id"`
	Model        string          `json:"model"`
	Provider     string          `json:"provider"`
	Message      Message         `json:"message"`
	FinishReason FinishReason    `json:"finish_reason"`
	Usage        Usage           `json:"usage"`
	Latency      time.Duration   `json:"latency"`
	Raw          json.RawMessage `json:"raw,omitempty"`
	Warnings     []Warning       `json:"warnings,omitempty"`
	RateLimit    *RateLimitInfo  `json:"rate_limit,omitempty"`
}

type ResponseFormat struct {
	Type       string          `json:"type"`
	JSONSchema json.RawMessage `json:"json_schema,omitempty"`
	Strict     bool            `json:"strict,omitempty"`
}

type ResponseTransformFunc func(resp *Response)

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

type RetryOption func(*RetryMiddleware)

type Role string

type SDKError struct {
	Msg   string
	Cause error
}

type ServerError struct {
	ProviderError
}

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

type StreamError struct {
	SDKError
}

type StreamEvent struct {
	Type               StreamEventType `json:"type"`
	Delta              string          `json:"delta,omitempty"`
	TextID             string          `json:"text_id,omitempty"`
	ReasoningDelta     string          `json:"reasoning_delta,omitempty"`
	ReasoningSignature string          `json:"reasoning_signature,omitempty"`
	ToolCall           *ToolCallData   `json:"tool_call,omitempty"`
	FinishReason       *FinishReason   `json:"finish_reason,omitempty"`
	Usage              *Usage          `json:"usage,omitempty"`
	FullResponse       *Response       `json:"full_response,omitempty"`
	Err                error           `json:"-"`
	Raw                json.RawMessage `json:"raw,omitempty"`
}

type StreamEventType string

type ThinkingData struct {
	Text      string `json:"text"`
	Signature string `json:"signature,omitempty"`
	Redacted  bool   `json:"redacted,omitempty"`
}

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

type ToolCallData struct {
	ID             string          `json:"id"`
	Name           string          `json:"name"`
	Arguments      json.RawMessage `json:"arguments"`
	ThoughtSigData string          `json:"thought_signature,omitempty"`
}

type ToolChoice struct {
	Mode     string `json:"mode"`
	ToolName string `json:"tool_name,omitempty"`
}

type ToolDefinition struct {
	Name        string          `json:"name"`
	Description string          `json:"description"`
	Parameters  json.RawMessage `json:"parameters"`
}

type ToolResultData struct {
	ToolCallID     string `json:"tool_call_id"`
	Name           string `json:"name,omitempty"`
	Content        string `json:"content"`
	IsError        bool   `json:"is_error"`
	ImageData      []byte `json:"image_data,omitempty"`
	ImageMediaType string `json:"image_media_type,omitempty"`
}

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

type TraceEvent struct {
	Kind          TraceKind
	Provider      string
	Model         string
	ToolName      string
	Preview       string
	ProviderEvent string
	RawPreview    string
	FinishReason  string
	Usage         Usage
	// SessionOwned is true when the originating request carried
	// request-level TraceObservers — in tracker only the agent session
	// registers those, and it re-emits every trace event as an agent
	// llm_* event. Activity-log writers listening at the client level
	// skip SessionOwned events to avoid logging the same stream twice
	// (issue #354); non-session calls (e.g. the autopilot interviewer)
	// stay SessionOwned=false so the trace path remains their only,
	// and therefore kept, log surface.
	SessionOwned bool
}

type TraceKind string

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

type TraceLoggerOptions struct {
	Verbose bool
}

type TraceObserver interface {
	HandleTraceEvent(evt TraceEvent)
}

type TraceObserverFunc func(evt TraceEvent)

type TraceOptions struct {
	Provider string
	Model    string
	Verbose  bool
}

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

type TransformOption func(*TransformMiddleware)

type Usage struct {
	InputTokens      int     `json:"input_tokens"`
	OutputTokens     int     `json:"output_tokens"`
	TotalTokens      int     `json:"total_tokens"`
	ReasoningTokens  *int    `json:"reasoning_tokens,omitempty"`
	CacheReadTokens  *int    `json:"cache_read_tokens,omitempty"`
	CacheWriteTokens *int    `json:"cache_write_tokens,omitempty"`
	EstimatedCost    float64 `json:"estimated_cost,omitempty"`
	Raw              any     `json:"raw,omitempty"`
}

type Warning struct {
	Message string `json:"message"`
	Code    string `json:"code,omitempty"`
}