agent

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

type AssistantMessage struct {
	Content []MessageBlock `json:"content"`
}

type ChatCompleter interface {
	// Complete performs a chat completion request and returns the response.
	Complete(ctx context.Context, req CompletionRequest) (*CompletionResponse, error)
}

type Chunk struct {
	Type         StreamChunkType
	Index        int
	Text         string      // For text and thinking deltas
	Call         *ToolCall   // For tool calls (both user and server tools)
	Signature    string      // For thinking signature
	Result       *ToolResult // For inline tool results
	Usage        *CompletionUsage
	FinishReason FinishReason
}

type CompletionRequest struct {
	Model             string
	Messages          []Message
	Tools             []Tool
	ToolChoice        ToolChoice
	ParallelToolCalls bool
	MaxTokens         *int64
	Temperature       *float32
	TopP              *float32
	TopK              *int32
	UseCache          *bool
	Container         *Container
	Betas             []string
	Reasoning         *Reasoning
	StreamCallback    func(ctx context.Context, chunk Chunk) error
}

type CompletionResponse struct {
	Content      []MessageBlock
	FinishReason FinishReason
	Usage        CompletionUsage
	Model        string
}

type CompletionUsage struct {
	PromptTokens       int `json:"prompt_tokens,omitempty"`
	CompletionTokens   int `json:"completion_tokens,omitempty"`
	ThinkingTokens     int `json:"thinking_tokens,omitempty"`
	TotalTokens        int `json:"total_tokens,omitempty"`
	CachedPromptTokens int `json:"cached_prompt_tokens,omitempty"`
}

type Container struct {
	ID     string
	Skills []Skill
}

type FinishReason int

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

type Handoff struct {
	Agent *Agent
}

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

type Memory interface {
	List() []Message
	Append(ctx context.Context, m Message) error
}

type Message interface {
	// contains filtered or unexported methods
}

type MessageBlock struct {
	Type       MessageBlockType `json:"type"`
	Text       string           `json:"text,omitempty"`
	Signature  string           `json:"signature,omitempty"`
	ToolCall   *ToolCall        `json:"toolcall,omitempty"`
	ToolResult *ToolResult      `json:"tool_result,omitempty"`
}

type MessageBlockType string

type Option func(*Agent)

type OptionLoader func(ctx context.Context, agent *Agent) error

type Output struct {
	Payload any
}

type Reasoning struct {
	Enabled bool
	Budget  int
	Effort  string // "low", "medium", "high" (OpenAI specific)
}

type Skill struct {
	SkillID string
	Type    string
	Version string
}

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

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

type Storage interface {
	Exists(ctx context.Context, filename string) (bool, error)
	Read(ctx context.Context, filename string) ([]byte, error)
	Write(ctx context.Context, filename string, content []byte) error
	Delete(ctx context.Context, filename string) error
}

type StreamChunkType int

type Streamer interface {
	Stream(ctx context.Context, chunk Chunk) error
}

type SystemMessage struct {
	Content string `json:"content"`
}

type Tool struct {
	Name         string
	Type         string
	Description  string
	InputSchema  *jsonschema.Schema
	OutputSchema *jsonschema.Schema
	DeferLoading bool
}

type ToolApprovalRequest struct {
	Calls []ToolCall `json:"calls,omitempty"`
}

type ToolCall struct {
	ID        string `json:"id,omitempty"`
	Name      string `json:"name,omitempty"`
	Arguments string `json:"arguments,omitempty"`
}

type ToolCallApproval int

type ToolChoice int

type ToolError struct {
	CallID string `json:"call_id"`
	Error  string `json:"error"`
}

type ToolHandlerFunc func(context.Context, []byte) (any, error)

type ToolResult struct {
	CallID string `json:"call_id"`
	Result any    `json:"result"`
}

type Toolset interface {
	Call(ctx context.Context, function string, args []byte) (any, error)
	List() []Tool
}

type UserMessage struct {
	Content string `json:"content"`
}