agent

type AnthropicProfile struct {
	BaseProfile
}

type AssistantTurn struct {
	Content    string
	ToolCalls  []llm.ToolCallData
	Reasoning  string
	Usage      llm.Usage
	ResponseID string
	Timestamp  time.Time
}

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

type DirEntry struct {
	Name  string
	IsDir bool
	Size  int64
}

type EnvPolicy string

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

type EventKind string

type ExecResult struct {
	Stdout     string
	Stderr     string
	ExitCode   int
	TimedOut   bool
	DurationMs int
}

type ExecutionEnvironment interface {
	// ReadFile reads a file with line numbers prepended. Offset is 1-based.
	// If limit is 0, a default of 2000 lines is used.
	ReadFile(path string, offset, limit int) (string, error)

	// WriteFile writes content to a file, creating parent directories as needed.
	WriteFile(path string, content string) error

	// FileExists checks whether a file or directory exists at the given path.
	FileExists(path string) (bool, error)

	// ListDirectory returns entries in a directory, optionally recursing to the given depth.
	// A depth of 0 means only the immediate children. A depth of -1 means unlimited.
	ListDirectory(path string, depth int) ([]DirEntry, error)

	// ExecCommand runs a shell command with timeout and environment controls.
	// If workingDir is empty, the environment's working directory is used.
	ExecCommand(command string, timeoutMs int, workingDir string, envVars map[string]string) (*ExecResult, error)

	// Grep searches file contents by regex pattern. Path defaults to the working directory.
	Grep(pattern, path string, opts GrepOptions) (string, error)

	// Glob finds files matching a glob pattern. Path defaults to the working directory.
	Glob(pattern, path string) ([]string, error)

	// Initialize prepares the execution environment (e.g., verifies working directory).
	Initialize() error

	// Cleanup releases resources held by the execution environment.
	Cleanup() error

	// WorkingDirectory returns the root working directory for this environment.
	WorkingDirectory() string

	// Platform returns the OS identifier (e.g., "darwin", "linux", "windows").
	Platform() string

	// OSVersion returns the OS version string (e.g., kernel version from uname -r).
	OSVersion() string
}

type GeminiProfile struct {
	BaseProfile
}

type GrepOptions struct {
	GlobFilter      string
	CaseInsensitive bool
	MaxResults      int
}

type Hunk struct {
	ContextHint  string   // Optional search hint from @@@ ... @@@ or @@ ... markers
	ContextLines []string // Lines prefixed with space (context for matching)
	DeleteLines  []string // Lines prefixed with - (to remove)
	AddLines     []string // Lines prefixed with + (to insert)
	MatchLines   []string // Context + delete lines in original order (for file matching)
	ReplaceLines []string // Context + add lines in original order (replacement content)
}

type LocalExecOption func(*LocalExecutionEnvironment)

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

type OpenAIProfile struct {
	BaseProfile
}

type Patch struct {
	Operations []PatchOperation
}

type PatchOpType string

type PatchOperation struct {
	Type    PatchOpType
	Path    string
	MoveTo  string   // Only used for Move operations
	Content []string // Only used for Add operations (lines without the + prefix)
	Hunks   []Hunk   // Only used for Update operations
}

type PatchResult struct {
	Summary       string
	FilesCreated  int
	FilesDeleted  int
	FilesModified int
	FilesMoved    int
	Details       []string
}

type ProfileOption func(*BaseProfile)

type ProviderProfile interface {
	ID() string
	Model() string
	BuildSystemPrompt(env ExecutionEnvironment, projectDocs []string) string
	Tools() []llm.ToolDefinition
	ProviderOptions() map[string]any
	ToolRegistry() *ToolRegistry
	SupportsParallelToolCalls() bool
	SupportsReasoning() bool
	SupportsStreaming() bool
	ContextWindowSize() int
}

type RegisteredTool struct {
	Definition  llm.ToolDefinition
	Execute     func(args map[string]any, env ExecutionEnvironment) (string, error)
	Description string
}

type Session struct {
	ID           string
	Config       SessionConfig
	History      []Turn
	State        SessionState
	EventEmitter *EventEmitter
	// contains filtered or unexported fields
}

type SessionConfig struct {
	MaxTurns                int            `json:"max_turns"`
	MaxToolRoundsPerInput   int            `json:"max_tool_rounds_per_input"`
	DefaultCommandTimeoutMs int            `json:"default_command_timeout_ms"`
	MaxCommandTimeoutMs     int            `json:"max_command_timeout_ms"`
	ReasoningEffort         string         `json:"reasoning_effort,omitempty"`
	ToolOutputLimits        map[string]int `json:"tool_output_limits,omitempty"`
	EnableLoopDetection     bool           `json:"enable_loop_detection"`
	LoopDetectionWindow     int            `json:"loop_detection_window"`
	MaxSubagentDepth        int            `json:"max_subagent_depth"`
	// FidelityMode controls how much conversation history is carried forward.
	// Valid values map to attractor fidelity modes: "full", "truncate", "compact",
	// "summary:low", "summary:medium", "summary:high". Empty string means no
	// fidelity filtering (equivalent to "full").
	FidelityMode string `json:"fidelity_mode,omitempty"`
	// UserOverride is appended to the system prompt as a "User Instructions"
	// section. This allows pipeline authors to inject per-node or per-pipeline
	// instructions into the coding agent's system prompt.
	UserOverride string `json:"user_override,omitempty"`
}

type SessionEvent struct {
	Kind      EventKind      `json:"kind"`
	Timestamp time.Time      `json:"timestamp"`
	SessionID string         `json:"session_id"`
	Data      map[string]any `json:"data,omitempty"`
}

type SessionState string

type SteeringTurn struct {
	Content   string
	Timestamp time.Time
}

type SubAgentHandle struct {
	ID      string
	Session *Session
	Status  SubAgentStatus
	Env     ExecutionEnvironment
	Profile ProviderProfile
	Client  *llm.Client
	// contains filtered or unexported fields
}

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

type SubAgentResult struct {
	Output    string `json:"output"`
	Success   bool   `json:"success"`
	TurnsUsed int    `json:"turns_used"`
}

type SubAgentStatus string

type SystemTurn struct {
	Content   string
	Timestamp time.Time
}

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

type ToolResultsTurn struct {
	Results   []llm.ToolResult
	Timestamp time.Time
}

type Turn interface {
	// TurnType returns a string discriminator: "user", "assistant", "tool_results", "system", or "steering".
	TurnType() string

	// TurnTimestamp returns the time when the turn was created.
	TurnTimestamp() time.Time
}

type UserTurn struct {
	Content   string
	Timestamp time.Time
}