api

type APIError struct {
	Type    string `json:"type"`
	Message string `json:"message"`
}

type APIErrorEnvelope struct {
	Type  string   `json:"type"`
	Error APIError `json:"error"`
}

type CacheControl struct {
	Type  string `json:"type"`            // "ephemeral"
	TTL   string `json:"ttl,omitempty"`   // "5m" | "1h"
	Scope string `json:"scope,omitempty"` // "global" (optional)
}

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

type Config struct {
	// BaseURL is the API origin, e.g. https://api.anthropic.com. No trailing slash.
	BaseURL string
	// AuthToken is the OAuth bearer token. Required when APIKey is empty.
	// Mutually exclusive with APIKey at runtime — set exactly one.
	AuthToken string
	// APIKey is the legacy x-api-key. Set this xor AuthToken.
	APIKey string
	// BetaHeaders are joined into the `anthropic-beta` header.
	// For OAuth-Max users include "oauth-2025-04-20".
	BetaHeaders []string
	// SessionID becomes the X-Claude-Code-Session-Id header.
	SessionID string
	// UserAgent overrides the default User-Agent. Leave empty for default.
	UserAgent string
	// ClaudeCodeID is the value of the `x-app` header. Defaults to "cli".
	ClaudeCodeID string
	// OnAuth401 is called when the API returns 401 to refresh credentials.
	// It must update the same Client's AuthToken and return nil to retry,
	// or return an error to surface to the caller. The retry is done at
	// most once per outbound request. Reference: decoded/4500.js:32-44.
	OnAuth401 func(ctx context.Context) error
	// ExtraHeaders are merged into every request after the standard set.
	// Use for headers like `anthropic-dangerous-direct-browser-access` that
	// the real CLI sends but aren't part of the canonical core set.
	ExtraHeaders map[string]string
}

type ContentBlock struct {
	// Common
	Type string `json:"type"` // "text" | "image" | "document" | "tool_use" | "tool_result"

	// type=text
	Text string `json:"text,omitempty"`

	// type=image or type=document (user-sent content — clipboard paste, file attach)
	// For documents: source.media_type = "application/pdf"
	Source *ImageSource `json:"source,omitempty"`

	// type=tool_use (assistant → us)
	ID    string         `json:"id,omitempty"`    // tool use ID, e.g. "toolu_01..."
	Name  string         `json:"name,omitempty"`  // tool name
	Input map[string]any `json:"input,omitempty"` // parsed tool input

	// type=tool_result (us → assistant, in a user-role message)
	ToolUseID string `json:"tool_use_id,omitempty"` // matches ID from tool_use block
	IsError   bool   `json:"is_error,omitempty"`
	// Content for tool_result: string or []ContentBlock. We send string for simplicity.
	ResultContent string `json:"content,omitempty"`
}

type ImageSource struct {
	Type      string `json:"type"`       // "base64"
	MediaType string `json:"media_type"` // "image/png" | "image/jpeg" | "image/gif" | "image/webp"
	Data      string `json:"data"`       // base64-encoded bytes
}

type Message struct {
	Role    string         `json:"role"` // "user" | "assistant"
	Content []ContentBlock `json:"content"`
}

type MessageRequest struct {
	Model     string         `json:"model"`
	MaxTokens int            `json:"max_tokens"`
	System    []SystemBlock  `json:"system,omitempty"`
	Messages  []Message      `json:"messages"`
	Stream    bool           `json:"stream,omitempty"`
	Tools     []ToolDef      `json:"tools,omitempty"`
	Metadata  map[string]any `json:"metadata,omitempty"`
	// Thinking enables extended thinking (interleaved-thinking-2025-05-14 beta).
	// When non-nil, sent as {"type":"enabled","budget_tokens":N}.
	Thinking *ThinkingConfig `json:"thinking,omitempty"`
}

type MessageResponse struct {
	ID         string         `json:"id"`
	Type       string         `json:"type"`
	Role       string         `json:"role"`
	Model      string         `json:"model"`
	Content    []ContentBlock `json:"content"`
	StopReason string         `json:"stop_reason"`
	Usage      Usage          `json:"usage"`
}

type Stream struct {

	// ResponseHeader holds the HTTP response headers from the initial connection.
	// Use this to read rate-limit headers (anthropic-ratelimit-*).
	ResponseHeader http.Header
	// contains filtered or unexported fields
}

type SystemBlock struct {
	Type         string        `json:"type"`
	Text         string        `json:"text"`
	CacheControl *CacheControl `json:"cache_control,omitempty"`
}

type ThinkingConfig struct {
	Type         string `json:"type"`          // always "enabled"
	BudgetTokens int    `json:"budget_tokens"` // token budget for thinking
}

type ToolDef struct {
	// Type is the tool type. Empty means standard custom tool. Examples of
	// native types: "web_search_20250305".
	Type        string         `json:"type,omitempty"`
	Name        string         `json:"name,omitempty"`
	Description string         `json:"description,omitempty"`
	InputSchema map[string]any `json:"input_schema,omitempty"`

	// Extra holds additional native-tool fields (e.g. max_uses, allowed_domains).
	// Keys from Extra are merged into the JSON output via custom MarshalJSON.
	Extra map[string]any `json:"-"`
}

type Usage struct {
	InputTokens              int `json:"input_tokens"`
	OutputTokens             int `json:"output_tokens"`
	CacheCreationInputTokens int `json:"cache_creation_input_tokens,omitempty"`
	CacheReadInputTokens     int `json:"cache_read_input_tokens,omitempty"`
}