embedded

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

type Event struct {
	Type    string // "delta", "tool_start", "tool_result", "done", "error"
	Content string
	Tool    string
	ToolID  string
	Args    map[string]any
	Output  string
	Success *bool
	Error   string
	// Usage stats (populated on "done" events)
	InputTokens  int
	OutputTokens int
}

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

type LLMProvider interface {
	// Chat sends messages to the LLM and returns the complete response.
	Chat(ctx context.Context, messages []Message, tools []ToolDef, model string, opts map[string]any) (*Response, error)

	// ChatStream sends messages and calls onDelta for each text chunk.
	// Tool calls are accumulated and returned in the final Response.
	ChatStream(ctx context.Context, messages []Message, tools []ToolDef, model string, opts map[string]any, onDelta func(delta string)) (*Response, error)
}

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

type LogEntry struct {
	Timestamp time.Time
	Level     string
	Message   string
}

type LoopConfig struct {
	// MaxIterations caps the number of LLM round-trips per turn.
	// Default: 20. Prevents infinite tool-call loops.
	MaxIterations int

	// TurnTimeout is the hard deadline for an entire turn.
	// Default: 5 minutes.
	TurnTimeout time.Duration

	// ToolTimeout is the per-tool execution timeout.
	// Default: 60 seconds.
	ToolTimeout time.Duration

	// MaxContextTokens is the approximate token budget. When exceeded,
	// the oldest messages (after system) are dropped. 0 = no limit.
	MaxContextTokens int
}

type Message struct {
	Role       string     `json:"role"` // "system", "user", "assistant", "tool"
	Content    string     `json:"content,omitempty"`
	ToolCalls  []ToolCall `json:"tool_calls,omitempty"`
	ToolCallID string     `json:"tool_call_id,omitempty"` // set when Role == "tool"
	Name       string     `json:"name,omitempty"`
}

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

type Response struct {
	Content      string     `json:"content"`
	ToolCalls    []ToolCall `json:"tool_calls,omitempty"`
	FinishReason string     `json:"finish_reason"`
	InputTokens  int        `json:"input_tokens,omitempty"`
	OutputTokens int        `json:"output_tokens,omitempty"`
}

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

type Tool struct {
	Name        string
	Description string
	Parameters  map[string]any
	Execute     func(ctx context.Context, args map[string]any) (string, error)
}

type ToolCall struct {
	ID       string `json:"id"`
	Type     string `json:"type"` // "function"
	Function struct {
		Name      string `json:"name"`
		Arguments string `json:"arguments"` // raw JSON string
	} `json:"function"`
}

type ToolDef struct {
	Type     string       `json:"type"` // always "function"
	Function ToolFunction `json:"function"`
}

type ToolFunction struct {
	Name        string         `json:"name"`
	Description string         `json:"description"`
	Parameters  map[string]any `json:"parameters"`
}

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