agent

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

type CacheCause string

type CacheLifetimeReporter interface {
	CacheLifetime() time.Duration
}

type CacheReading struct {
	ReadTokens int
	At         time.Time
}

type CacheUsage struct {
	ReadTokens  int `json:"read_tokens"`
	WriteTokens int `json:"write_tokens,omitempty"`
}

type CallFaulted interface {
	error

	FaultedCall() ToolCall
}

type Delta struct {
	Kind Kind
	Text string
}

type Event struct {
	FallbackRendering

	Kind      Kind                  `json:"kind"`
	Text      string                `json:"text,omitempty"`
	Failure   *Failure              `json:"failure,omitempty"`
	ID        string                `json:"id,omitempty"`
	Name      string                `json:"name,omitempty"`
	Arguments string                `json:"arguments,omitempty"`
	Status    Status                `json:"status,omitempty"`
	Took      time.Duration         `json:"took,omitempty"`
	Attempt   int                   `json:"attempt,omitempty"`
	Metrics   *tool.ToolCallMetrics `json:"stats,omitempty"`
	Picture   *Picture              `json:"picture,omitempty"`
	State     json.RawMessage       `json:"state,omitempty"`
	Usage     *Usage                `json:"usage,omitempty"`
}

type Failure struct {
	Kind       FailureKind `json:"kind"`
	Context    string      `json:"context,omitempty"`
	Message    string      `json:"message,omitempty"`
	HTTPStatus int         `json:"http_status,omitempty"`
	Code       string      `json:"code,omitempty"`
	Body       string      `json:"body,omitempty"`
	MediaType  string      `json:"media_type,omitempty"`
}

type FailureKind string

type FallbackRendering struct {
	RenderingKind string               `json:"rendering_kind,omitempty"`
	Subject       string               `json:"render,omitempty"`
	Note          string               `json:"detail,omitempty"`
	PathLine      string               `json:"path_line,omitempty"`
	Emphasis      tool.Emphasis        `json:"emphasis,omitzero"`
	Continuation  []tool.CallRendering `json:"continuation,omitempty"`
	Intent        string               `json:"intent,omitempty"`
	Introduces    string               `json:"introduces,omitempty"`
	Mentions      []string             `json:"mentions,omitempty"`
	ShowOutput    bool                 `json:"show_output,omitempty"`
	ReadOnly      bool                 `json:"read_only,omitempty"`
	MarksSuccess  bool                 `json:"marks_success,omitempty"`
}

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

type Kind string

type Lister interface {
	Models(context context.Context) ([]Model, error)
}

type Model struct {
	ID                  string       `json:"id"`
	Name                string       `json:"name,omitempty"`
	EffortLevels        []string     `json:"efforts,omitempty"`
	IsEffortless        bool         `json:"effortless,omitempty"`
	ContextWindowTokens int          `json:"context,omitempty"`
	MaxOutputTokens     int          `json:"output,omitempty"`
	Prices              *TokenPrices `json:"prices,omitempty"`
}

type Output struct {
	Kind       Kind
	Text       string
	Done       bool
	AwaitUsage bool
	Usage      *Usage
}

type Picture struct {
	Digest    string `json:"digest"`
	MediaType string `json:"mediaType"`
	Width     int    `json:"width,omitempty"`
	Height    int    `json:"height,omitempty"`
}

type PriceTier int

type Provider interface {
	Configure(systemPrompt string, tools []tool.Definition)
	AddUserMessage(text string)
	AddToolResults(toolResults []ToolCallResult)
	Send(ctx context.Context, yield Yield) (Reply, error)
}

type Reply struct {
	Calls         []ToolCall
	Usage         Usage
	PrefixRewrite string
}

type Resumable interface {
	error

	Resumable() bool
}

type Retriable interface {
	error

	Retriable() bool
	RetryAfter() time.Duration
}

type State interface {
	Dump() []json.RawMessage
	Load(items []json.RawMessage)
}

type Status string

type TitleState struct {
	Title string `json:"title"`
}

type TokenPrices struct {
	Input      float64 `json:"input,omitempty"`
	Output     float64 `json:"output,omitempty"`
	CacheRead  float64 `json:"cache_read,omitempty"`
	CacheWrite float64 `json:"cache_write,omitempty"`
}

type ToolCall struct {
	ID        string
	Name      string
	Arguments string
}

type ToolCallResult struct {
	ID      string
	Output  string
	Image   tool.Image
	IsError bool
}

type Update struct {
	Delta *Delta
	Event *Event
}

type Usage struct {
	InputTokens  int         `json:"input_tokens,omitempty"`
	OutputTokens int         `json:"output_tokens,omitempty"`
	Cache        *CacheUsage `json:"cache,omitempty"`
}

type UsageAvailability int

type UsageLimitError struct {
	Cause   error
	Windows []UsageWindow
}

type UsageProbe struct {
	Windows      []UsageWindow
	Availability UsageAvailability
	RefreshAfter time.Duration
}

type UsageProber interface {
	ProbeUsage(context context.Context) (UsageProbe, error)
}

type UsageReporter interface {
	IsAvailable() bool
	UsageWindows(context context.Context) ([]UsageWindow, error)
}

type UsageWindow struct {
	Duration  time.Duration `json:"duration"`
	Percent   float64       `json:"percent"`
	ResetsAt  time.Time     `json:"resets_at"`
	Scope     string        `json:"scope,omitempty"`
	IsLimited bool          `json:"limited,omitempty"`
}

type Yield func(Output) bool