agent

type Action struct {
	Name             string `json:"name"`
	Reason           string `json:"reason"`
	Command          string `json:"command"`
	ModifiesResource string `json:"modifies_resource"`
}

type Agent struct {
	// Input is the channel to receive user input.
	Input chan any

	// Output is the channel to send messages to the UI.
	Output chan any

	// RunOnce indicates if the agent should run only once.
	// If true, the agent will run only once and then exit.
	// If false, the agent will run in a loop until the context is done.
	RunOnce bool

	// CloseOutputOnDone closes Output and exits the agent loop when the agent reaches Done.
	// This is useful for "one prompt -> multi-step -> stream -> end" workflows that still
	// need interactive permission prompts (WaitingForInput).
	CloseOutputOnDone bool

	// InitialQuery is the initial query to the agent.
	// If provided, the agent will run only once and then exit.
	InitialQuery string

	// HostInfo is an optional, short host/environment summary injected into the
	// system prompt (e.g. OS distro, package manager). It MUST NOT contain secrets.
	HostInfo string

	LLM gollm.Client

	// PromptTemplateFile allows specifying a custom template file
	PromptTemplateFile string
	// ExtraPromptPaths allows specifying additional prompt templates
	// to be combined with PromptTemplateFile
	ExtraPromptPaths []string
	Model            string
	Provider         string

	RemoveWorkDir bool

	MaxIterations int

	// Kubeconfig is the path to the kubeconfig file.
	Kubeconfig string
	// Sandbox indicates whether to execute tools in a sandbox environment
	Sandbox string

	// SandboxImage is the container image to use for the sandbox
	SandboxImage string

	SkipPermissions bool

	Tools tools.Tools

	EnableToolUseShim bool

	// MCPClientEnabled indicates whether MCP client mode is enabled
	MCPClientEnabled bool

	// Recorder captures events for diagnostics
	Recorder journal.Recorder

	// Session optionally provides a session to use.
	// This is used by the UI to track the state of the agent and the conversation.
	Session *api.Session

	// ChatMessageStore is the underlying session persistence layer.
	ChatMessageStore api.ChatMessageStore

	// SessionBackend is the configured backend for session persistence (e.g., memory, filesystem).
	SessionBackend string
	// contains filtered or unexported fields
}

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

type Factory func(context.Context) (*Agent, error)

type PromptData struct {
	Query string
	Tools tools.Tools

	EnableToolUseShim    bool
	SessionIsInteractive bool
	HostInfo             string
}

type ReActResponse struct {
	Thought string  `json:"thought"`
	Answer  string  `json:"answer,omitempty"`
	Action  *Action `json:"action,omitempty"`
}

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

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

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

type ToolCallAnalysis struct {
	FunctionCall        gollm.FunctionCall
	ParsedToolCall      *tools.ToolCall
	IsInteractive       bool
	IsInteractiveError  error
	ModifiesResourceStr string
	RequiresApproval    bool
	SafetyErr           *safety.SafetyError
}