llm

type AbortError struct {
	SDKError
}

type AccessDeniedError struct {
	ProviderError
}

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 FailoverEvent struct {
	From Target // the exhausted lane
	To   Target // the lane being tried next
	Err  error  // the error that triggered the switch
}

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 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"`
	// CacheReadMultiplier and CacheWriteMultiplier price cached prompt tokens
	// as a fraction of InputCostPerM. They live per model because the discount
	// is not a provider-wide convention: cached reads are 0.1x on Anthropic,
	// Gemini, and the GPT-5 family, 0.25x on GPT-4.1, and 0.5x on gpt-4o-mini.
	// Zero means "use the default" — see defaultCacheReadMultiplier — so a new
	// catalog entry prices cache traffic sanely without having to state both.
	CacheReadMultiplier  float64 `json:"cache_read_multiplier,omitempty"`
	CacheWriteMultiplier float64 `json:"cache_write_multiplier,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 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 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"`
	// RequestRaw is the verbatim wire body the adapter sent, carried on the
	// EventRequestSent event that EmitRequestSent emits below. EventStreamStart
	// only ever sees it via TraceBuilder's fallback, never set by an adapter.
	// The normalized Request records what tracker asked for; this records what
	// actually went out after provider-specific translation and ProviderOptions
	// merging — which is what a post-hoc reader needs to reproduce the call.
	RequestRaw json.RawMessage `json:"request_raw,omitempty"`
}

type StreamEventType string

type Target struct {
	Provider string
	Model    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
	// CallID groups every event belonging to one LLM request. Two log paths
	// record LLM activity — the agent session re-emits trace events as agent
	// llm_* events, and the client-level writer catches calls no session sees
	// (the autopilot interviewer, for one) — so one call can legitimately
	// appear twice. Both paths are kept because their coverage differs; this
	// is what lets a reader collapse the overlap rather than double-count
	// usage when aggregating.
	CallID string
	// RequestRaw is the verbatim wire body, set on TraceRequestStart. The
	// normalized Request says what tracker asked for; this says what actually
	// went out after provider translation and ProviderOptions merging.
	RequestRaw json.RawMessage
	// ToolArguments is the untruncated tool-call arguments, set on
	// TraceToolPrepare. Preview holds the same value clipped to 80 chars,
	// which is enough to render but not enough to reconstruct the call.
	ToolArguments json.RawMessage
	// ProviderRaw is the untruncated provider chunk, set on TraceProviderRaw
	// (verbose only). RawPreview holds the clipped form.
	ProviderRaw json.RawMessage
	// 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
	// CallID identifies the one request this builder traces. It is stamped
	// onto every event the builder emits so a reader can group them, and —
	// more importantly — collapse the overlap between the two log paths that
	// both record LLM activity (see TraceEvent.CallID).
	CallID string
}

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"`
}