anthropic

type CacheControl struct {
	Type CacheControlType `json:"type"`
}

type CacheControlSetter interface {
	SetCacheControl(cacheControl *CacheControl)
}

type CacheControlType string

type CharLocation struct {
	Type           string `json:"type"` // "char_location"
	CitedText      string `json:"cited_text,omitempty"`
	DocumentIndex  int    `json:"document_index,omitempty"`
	DocumentTitle  string `json:"document_title,omitempty"`
	StartCharIndex int    `json:"start_char_index,omitempty"`
	EndCharIndex   int    `json:"end_char_index,omitempty"`
}

type Citation interface {
	IsCitation() bool
}

type CitationSettings struct {
	Enabled bool `json:"enabled"`
}

type CitationType string

type Client struct {
	SystemPrompt       string                   `json:"system_prompt,omitempty"`
	Tools              []ToolInterface          `json:"tools,omitempty"`
	ToolChoice         *ToolChoice              `json:"tool_choice,omitempty"`
	ParallelToolCalls  *bool                    `json:"parallel_tool_calls,omitempty"`
	MCPServers         []MCPServerConfig        `json:"mcp_servers,omitempty"`
	Prefill            string                   `json:"prefill,omitempty"`
	PrefillClosingTag  string                   `json:"prefill_closing_tag,omitempty"`
	MaxTokens          *int                     `json:"max_tokens,omitempty"`
	Temperature        *float64                 `json:"temperature,omitempty"`
	PresencePenalty    *float64                 `json:"presence_penalty,omitempty"`
	FrequencyPenalty   *float64                 `json:"frequency_penalty,omitempty"`
	ReasoningBudget    *int                     `json:"reasoning_budget,omitempty"`
	ReasoningEffort    ReasoningEffort          `json:"reasoning_effort,omitempty"`
	Features           []string                 `json:"features,omitempty"`
	RequestHeaders     http.Header              `json:"request_headers,omitempty"`
	Caching            *bool                    `json:"caching,omitempty"`
	PreviousResponseID string                   `json:"previous_response_id,omitempty"`
	ServiceTier        string                   `json:"service_tier,omitempty"`
	ClientOptions      map[string]interface{}   `json:"client_options,omitempty"`
	ResponseFormat     *ResponseFormat          `json:"response_format,omitempty"`
	Messages           Messages                 `json:"messages"`
	Client             *http.Client             `json:"-"`
	SSECallback        ServerSentEventsCallback `json:"-"`
	// contains filtered or unexported fields
}

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

type CodeExecutionResult struct {
	Type       string `json:"type"`
	Stdout     string `json:"stdout"`
	Stderr     string `json:"stderr"`
	ReturnCode int    `json:"return_code"`
}

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

type CodeExecutionToolOptions struct {
	Type string
}

type CodeExecutionToolResultContent struct {
	ToolUseID string              `json:"tool_use_id"`
	Content   CodeExecutionResult `json:"content"`
}

type Content interface {
	Type() ContentType
}

type ContentChunk struct {
	Type string `json:"type"`
	Text string `json:"text,omitempty"`
}

type ContentSource struct {
	// Type is the type of the content source ("base64", "url", "text", or "file")
	Type ContentSourceType `json:"type"`

	// MediaType is the media type of the content. E.g. "image/jpeg", "application/pdf"
	MediaType string `json:"media_type,omitempty"`

	// Data is base64 encoded data (used with ContentSourceTypeBase64)
	Data string `json:"data,omitempty"`

	// URL is the URL of the content (used with ContentSourceTypeURL)
	URL string `json:"url,omitempty"`

	// FileID is the file ID from the Files API (used with ContentSourceTypeFile)
	FileID string `json:"file_id,omitempty"`

	// Chunks of content. Only use if chunking on the client side, for use
	// within a DocumentContent block.
	Content []*ContentChunk `json:"content,omitempty"`

	// GenerationID is an ID associated with the generation of this content,
	// if any. This may be set on content returned from image generation, for
	// example. Used for OpenAI image generation results.
	GenerationID string `json:"generation_id,omitempty"`

	// GenerationStatus is the status of the generation of this content,
	// if any. This may be set on content returned from image generation, for
	// example. Used for OpenAI image generation results.
	GenerationStatus string `json:"generation_status,omitempty"`
}

type ContentSourceType string

type ContentType string

type DocumentContent struct {
	Source       *ContentSource    `json:"source"`
	Title        string            `json:"title,omitempty"`
	Context      string            `json:"context,omitempty"`
	Citations    *CitationSettings `json:"citations,omitempty"`
	CacheControl *CacheControl     `json:"cache_control,omitempty"`
}

type Event struct {
	Type         EventType          `json:"type"`
	Index        *int               `json:"index,omitempty"`
	Message      *Response          `json:"message,omitempty"`
	ContentBlock *EventContentBlock `json:"content_block,omitempty"`
	Delta        *EventDelta        `json:"delta,omitempty"`
	Usage        *Usage             `json:"usage,omitempty"`
}

type EventContentBlock struct {
	Type      ContentType     `json:"type"`
	Text      string          `json:"text,omitempty"`
	ID        string          `json:"id,omitempty"`
	Name      string          `json:"name,omitempty"`
	Input     json.RawMessage `json:"input,omitempty"`
	Thinking  string          `json:"thinking,omitempty"`
	Signature string          `json:"signature,omitempty"`
}

type EventDelta struct {
	Type         EventDeltaType `json:"type,omitempty"`
	Text         string         `json:"text,omitempty"`
	Index        int            `json:"index,omitempty"`
	StopReason   string         `json:"stop_reason,omitempty"`
	StopSequence string         `json:"stop_sequence,omitempty"`
	PartialJSON  string         `json:"partial_json,omitempty"`
	Thinking     string         `json:"thinking,omitempty"`
	Signature    string         `json:"signature,omitempty"`
}

type EventDeltaType string

type EventType string

type ImageContent struct {
	Source       *ContentSource `json:"source"`
	CacheControl *CacheControl  `json:"cache_control,omitempty"`
}

type ImageSource struct {
	Type      string `json:"type"`
	MediaType string `json:"media_type"`
	Data      string `json:"data"`
}

type MCPApprovalRequestContent struct {
	ID          string `json:"id"`
	Arguments   string `json:"arguments"`
	Name        string `json:"name"`
	ServerLabel string `json:"server_label"`
}

type MCPApprovalResponseContent struct {
	ApprovalRequestID string `json:"approval_request_id"`
	Approve           bool   `json:"approve"`
	Reason            string `json:"reason,omitempty"`
}

type MCPListToolsContent struct {
	ServerLabel string               `json:"server_label"`
	Tools       []*MCPToolDefinition `json:"tools"`
}

type MCPServerConfig struct {
	Type               string                 `json:"type"`
	URL                string                 `json:"url"`
	Name               string                 `json:"name,omitempty"`
	AuthorizationToken string                 `json:"authorization_token,omitempty"`
	ToolConfiguration  *MCPToolConfiguration  `json:"tool_configuration,omitempty"`
	Headers            map[string]string      `json:"headers,omitempty"`
	ToolApproval       string                 `json:"tool_approval,omitempty"`
	ToolApprovalFilter *MCPToolApprovalFilter `json:"tool_approval_filter,omitempty"`
}

type MCPToolApprovalFilter struct {
	Always []string `json:"always,omitempty"`
	Never  []string `json:"never,omitempty"`
}

type MCPToolConfiguration struct {
	Enabled      bool     `json:"enabled"`
	AllowedTools []string `json:"allowed_tools,omitempty"`
}

type MCPToolDefinition struct {
	Name        string                 `json:"name"`
	Description string                 `json:"description,omitempty"`
	InputSchema map[string]interface{} `json:"input_schema,omitempty"`
}

type MCPToolResultContent struct {
	ToolUseID string          `json:"tool_use_id"`
	IsError   bool            `json:"is_error,omitempty"`
	Content   []*ContentChunk `json:"content,omitempty"`
}

type MCPToolUseContent struct {
	ID         string          `json:"id"`
	Name       string          `json:"name"`
	ServerName string          `json:"server_name"`
	Input      json.RawMessage `json:"input"`
}

type Message struct {
	ID      string    `json:"id,omitempty"`
	Role    Role      `json:"role"`
	Content []Content `json:"content"`
}

type Messages []*Message

type Option func(*Client)

type Property struct {
	Type                 SchemaType           `json:"type,omitempty"`
	Description          string               `json:"description,omitempty"`
	Enum                 []string             `json:"enum,omitempty"`
	Items                *Property            `json:"items,omitempty"`
	Required             []string             `json:"required,omitempty"`
	Properties           map[string]*Property `json:"properties,omitempty"`
	AdditionalProperties *bool                `json:"additionalProperties,omitempty"`
	Nullable             *bool                `json:"nullable,omitempty"`
	Pattern              *string              `json:"pattern,omitempty"`
	Format               *string              `json:"format,omitempty"`
	MinItems             *int                 `json:"minItems,omitempty"`
	MaxItems             *int                 `json:"maxItems,omitempty"`
	MinLength            *int                 `json:"minLength,omitempty"`
	MaxLength            *int                 `json:"maxLength,omitempty"`
	Minimum              *float64             `json:"minimum,omitempty"`
	Maximum              *float64             `json:"maximum,omitempty"`
}

type ReasoningEffort string

type RedactedThinkingContent struct {
	Data string `json:"data"`
}

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

type Request struct {
	Model       string            `json:"model"`
	Messages    []*Message        `json:"messages"`
	MaxTokens   *int              `json:"max_tokens,omitempty"`
	Temperature *float64          `json:"temperature,omitempty"`
	System      string            `json:"system,omitempty"`
	Stream      bool              `json:"stream,omitempty"`
	Tools       []map[string]any  `json:"tools,omitempty"`
	ToolChoice  *ToolChoice       `json:"tool_choice,omitempty"`
	Thinking    *Thinking         `json:"thinking,omitempty"`
	MCPServers  []MCPServerConfig `json:"mcp_servers,omitempty"`
}

type Response struct {
	ID           string    `json:"id"`
	Model        string    `json:"model"`
	Role         Role      `json:"role"`
	Content      []Content `json:"content"`
	StopReason   string    `json:"stop_reason"`
	StopSequence *string   `json:"stop_sequence,omitempty"`
	Type         string    `json:"type"`
	Usage        Usage     `json:"usage"`
}

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

type ResponseFormat struct {
	// Type indicates the format type ("text", "json_object", or "json_schema")
	Type ResponseFormatType `json:"type"`

	// Schema provides a JSON schema to guide the model's output
	Schema *Schema `json:"schema,omitempty"`

	// Name provides a name for the output to guide the model
	Name string `json:"name,omitempty"`

	// Description provides additional context to guide the model
	Description string `json:"description,omitempty"`
}

type ResponseFormatType string

type Role string

type Schema struct {
	Type                 SchemaType           `json:"type"`
	Properties           map[string]*Property `json:"properties"`
	Required             []string             `json:"required,omitempty"`
	AdditionalProperties *bool                `json:"additionalProperties,omitempty"`
}

type SchemaType string

type ServerSentEventsCallback func(line string) error

type ServerSentEventsReader[T any] struct {
	// contains filtered or unexported fields
}

type ServerToolUseContent struct {
	ID    string         `json:"id"`
	Name  string         `json:"name"`
	Input map[string]any `json:"input"`
}

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

type TextContent struct {
	Text         string        `json:"text"`
	CacheControl *CacheControl `json:"cache_control,omitempty"`
	Citations    []Citation    `json:"citations,omitempty"`
}

type Thinking struct {
	Type         string `json:"type"` // "enabled"
	BudgetTokens int    `json:"budget_tokens"`
}

type ThinkingContent struct {
	ID        string `json:"id,omitempty"`
	Thinking  string `json:"thinking"`
	Signature string `json:"signature,omitempty"`
}

type Tool struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	InputSchema Schema `json:"input_schema"`
}

type ToolAnnotations struct {
	Title           string         `json:"title,omitempty"`
	ReadOnlyHint    bool           `json:"readOnlyHint,omitempty"`
	DestructiveHint bool           `json:"destructiveHint,omitempty"`
	IdempotentHint  bool           `json:"idempotentHint,omitempty"`
	OpenWorldHint   bool           `json:"openWorldHint,omitempty"`
	Extra           map[string]any `json:"extra,omitempty"`
}

type ToolCallResult struct {
	ID     string
	Name   string
	Input  any
	Result *ToolUseResult
	Error  error
}

type ToolChoice struct {
	Type                   ToolChoiceType `json:"type"`
	Name                   string         `json:"name,omitempty"`
	DisableParallelToolUse bool           `json:"disable_parallel_tool_use,omitempty"`
}

type ToolChoiceType string

type ToolConfiguration interface {
	// ToolConfiguration returns a map of configuration for the tool, when used
	// with the given provider.
	ToolConfiguration(providerName string) map[string]any
}

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

type ToolInterface interface {
	// Name of the tool.
	Name() string

	// Description of the tool.
	Description() string

	// Schema describes the parameters used to call the tool.
	Schema() *Schema
}

type ToolResult struct {
	Content []*ToolResultContents `json:"content"`
	IsError bool                  `json:"isError,omitempty"`
}

type ToolResultContent struct {
	ToolUseID    string        `json:"tool_use_id"`
	Content      any           `json:"content"`
	IsError      bool          `json:"is_error,omitempty"`
	CacheControl *CacheControl `json:"cache_control,omitempty"`
}

type ToolResultContentType string

type ToolResultContents struct {
	Type        ToolResultContentType `json:"type"`
	Text        string                `json:"text,omitempty"`
	Data        string                `json:"data,omitempty"`
	MimeType    string                `json:"mimeType,omitempty"`
	Annotations map[string]any        `json:"annotations,omitempty"`
}

type ToolUseContent struct {
	ID    string          `json:"id"`
	Name  string          `json:"name"`
	Input json.RawMessage `json:"input"`
}

type ToolUseResult struct {
	ToolUseID string `json:"tool_use_id"`
	Output    string `json:"output,omitempty"`
	Error     error  `json:"error,omitempty"`
}

type TypedTool[T any] interface {
	// Name of the tool.
	Name() string

	// Description of the tool.
	Description() string

	// Schema describes the parameters used to call the tool.
	Schema() *Schema

	// Annotations returns optional properties that describe tool behavior.
	Annotations() *ToolAnnotations

	// Call is the function that is called to use the tool.
	Call(ctx context.Context, input T) (*ToolResult, error)
}

type TypedToolAdapter[T any] struct {
	// contains filtered or unexported fields
}

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

type UserLocation struct {
	Type     string `json:"type"`     // "approximate"
	City     string `json:"city"`     // "San Francisco"
	Region   string `json:"region"`   // "California"
	Country  string `json:"country"`  // "US"
	Timezone string `json:"timezone"` // "America/Los_Angeles"
}

type WebSearchResult struct {
	Type             string `json:"type"`
	URL              string `json:"url"`
	Title            string `json:"title"`
	EncryptedContent string `json:"encrypted_content"`
	PageAge          string `json:"page_age"`
}

type WebSearchResultLocation struct {
	Type           string `json:"type"` // "web_search_result_location"
	URL            string `json:"url"`
	Title          string `json:"title"`
	EncryptedIndex string `json:"encrypted_index,omitempty"`
	CitedText      string `json:"cited_text,omitempty"`
}

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

type WebSearchToolOptions struct {
	Type           string
	MaxUses        int
	AllowedDomains []string
	BlockedDomains []string
	UserLocation   *UserLocation
}

type WebSearchToolResultContent struct {
	ToolUseID string             `json:"tool_use_id"`
	Content   []*WebSearchResult `json:"content"`
	ErrorCode string             `json:"error_code,omitempty"`
}