agent

type AgentConfig struct {
	// Identity
	Name        string // unique name: "orchestrator", "researcher", "coder"
	Description string // shown to parent agent for routing decisions

	// Prompt — REQUIRED. User's base prompt. Gets concatenated with governance prompts.
	// Final prompt = [governance base] + [governance tool usage] + [Prompt] + [loaded skills] + [sub-agent descriptions]
	Prompt string

	// Model configuration — supports "provider:model" format (e.g. "anthropic:claude-sonnet-4-5-20250929")
	// If Provider is empty, it is auto-detected from Model string.
	Provider    string  // explicit provider: "openai", "anthropic", "ollama", "google" (optional)
	Model       string  // model name or "provider:model" format
	APIKey      string  // provider API key (falls back to env vars if empty)
	BaseURL     string  // optional custom API base URL
	Temperature float64 // 0.0 - 1.0

	// Capabilities
	Tools   []tools.Tool // langchaingo standard tool interface
	Skills  []Skill      // loaded skill definitions (constructed, not paths)
	MaxIter int          // max ReAct loop iterations (0 = default 25)

	// Recursive — sub-agents use the SAME struct
	SubAgents []AgentConfig

	// Infrastructure (typically set at top-level, inherited downward)
	Middleware []Middleware
	Backend    Backend
	Store      Store
	Governance *Governance // nil = use package defaults

	// Flexible key-value config per agent
	Config map[string]any
}

type AnthropicSanitizeMiddleware struct {
	BaseMiddleware
}

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

type Backend interface {
	afero.Fs
	Grep(pattern, path string) ([]GrepMatch, error)
	Summarize(path string) (string, error) // LLM-powered file summary
}

type BaseMiddleware struct{}

type CompositeRoute struct {
	Prefix  string
	Backend Backend
}

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

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

type Governance struct {
	Base              string // always prepended
	ToolUsage         string // when agent has tools
	ContextManagement string // when VFS backend is available
	Planning          string // when agent has sub-agents
	Aggregation       string // for result synthesis
	SubAgentDefault   string // default sub-agent governance
}

type GrepMatch struct {
	Path string `json:"path"`
	Line int    `json:"line"`
	Text string `json:"text"`
}

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

type InvokeContext struct {
	AgentName string
	Iteration int
	ThreadID  string
	RunID     string
	Input     string
	Output    string
	Metadata  map[string]any
	Stop      bool // middleware can set this to halt execution
}

type LoggingMiddleware struct {
	BaseMiddleware
	// contains filtered or unexported fields
}

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

type Middleware interface {
	Name() string
	Init(cfg map[string]any) error
	BeforeInvoke(ctx *InvokeContext) error
	AfterInvoke(ctx *InvokeContext) error
	BeforeToolCall(ctx *ToolCallContext) error
	AfterToolCall(ctx *ToolCallContext) error
	Tools() []ToolDef     // middleware can inject its own tools
	SystemPrompt() string // appended to the agent's system prompt
}

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

type ModelConfig struct {
	Provider string // "openai", "anthropic", "ollama", "google" — auto-detected if empty
	Model    string // model name, or "provider:model" format (e.g. "anthropic:claude-sonnet-4-5-20250929")
	APIKey   string // provider API key — falls back to env vars if empty
	BaseURL  string // custom base URL (useful for proxies, Azure, local endpoints)

	// Provider-specific options
	OllamaServerURL string         // Ollama server URL (default: http://localhost:11434)
	Options         map[string]any // additional provider-specific options
}

type ReactEvent struct {
	Type      ReactEventType
	Agent     string
	Iteration int
	ToolName  string
	ToolInput string
	Content   string // LLM output or tool output
}

type ReactEventType string

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

type ReactResult struct {
	Output     string
	ToolCalls  int
	Iterations int
	Duration   time.Duration
}

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

type Skill struct {
	Name         string         `yaml:"name"`
	Description  string         `yaml:"description"`
	Instructions string         `yaml:"-"` // the markdown body after frontmatter
	AllowedTools []string       `yaml:"allowed-tools"`
	Metadata     map[string]any `yaml:"metadata"`
}

type Store interface {
	// Threads
	CreateThread(ctx context.Context, t *protocol.Thread) error
	GetThread(ctx context.Context, id string) (*protocol.Thread, error)
	DeleteThread(ctx context.Context, id string) error
	SetThreadStatus(ctx context.Context, id string, status protocol.ThreadStatus) error
	AppendMessage(ctx context.Context, threadID string, msg protocol.Message) error
	SearchThreads(ctx context.Context, userID string, limit, offset int) ([]*protocol.Thread, error)

	// Checkpoints
	SaveCheckpoint(ctx context.Context, cp *protocol.Checkpoint) error
	GetLatestCheckpoint(ctx context.Context, threadID string) (*protocol.Checkpoint, error)
	ListCheckpoints(ctx context.Context, threadID string, limit int, before string) ([]*protocol.Checkpoint, error)

	// Runs
	CreateRun(ctx context.Context, r *protocol.Run) error
	GetRun(ctx context.Context, id string) (*protocol.Run, error)
	UpdateRun(ctx context.Context, r *protocol.Run) error
}

type SummarizationMiddleware struct {
	BaseMiddleware
	// contains filtered or unexported fields
}

type SummarizeConfig struct {
	TriggerAfterMessages int // summarize after this many iterations (default 20)
	MaxContextTokens     int // approximate token limit before summarization (default 50000)
}

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

type ThreadConfig struct {
	ThreadID string                 // explicit thread ID (auto-generated if empty)
	UserID   string                 // user identifier, stored in metadata
	Metadata map[string]interface{} // additional metadata
}

type TodoItem struct {
	ID      string `json:"id"`
	Content string `json:"content"`
	Status  string `json:"status"` // "pending", "in_progress", "completed"
}

type TodoListMiddleware struct {
	BaseMiddleware
	// contains filtered or unexported fields
}

type ToolCallContext struct {
	InvokeContext
	ToolName   string
	ToolInput  string
	ToolOutput string
}

type ToolDef = llms.Tool

type ToolDefiner interface {
	ToolDefinition() llms.Tool
}

type ToolProvider interface {
	ExecutableTools() []tools.Tool
}

type VFSFileInfo struct {
	Path       string    `json:"path"`
	IsDir      bool      `json:"is_dir"`
	Size       int64     `json:"size"`
	ModifiedAt time.Time `json:"modified_at"`
}

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

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