llm

type Backend interface {
	Run(ctx context.Context, req RunRequest) (RunResult, error)
}

type ClaudeConfig struct {
	Command      string
	Timeout      time.Duration
	Env          map[string]string
	WorkspaceDir string
	// ProfileOverrides maps profile name → per-profile runner overrides.
	ProfileOverrides map[string]ProfileRunnerConfig
}

type CodexConfig struct {
	Command            string
	Timeout            time.Duration
	DefaultIdleTimeout time.Duration
	HighIdleTimeout    time.Duration
	XHighIdleTimeout   time.Duration
	Model              string
	ReasoningEffort    string
	Env                map[string]string
	WorkspaceDir       string
	DefaultExecPolicy  ExecPolicyConfig
	// ProfileOverrides maps profile name → per-profile runner overrides.
	ProfileOverrides map[string]ProfileRunnerConfig
}

type ErrUnsupportedProvider string

type ExecPolicyConfig struct {
	Sandbox        string
	AskForApproval string
	AddDirs        []string
}

type FactoryConfig struct {
	Provider string
	Codex    CodexConfig
	Claude   ClaudeConfig
	Kimi     KimiConfig
	OpenCode OpenCodeConfig
}

type InteractiveDriver interface {
	SteerMode() SteerMode
	StartTurn(ctx context.Context, req RunRequest) (TurnRef, error)
	SteerTurn(ctx context.Context, turn TurnRef, req RunRequest) error
	InterruptTurn(ctx context.Context, turn TurnRef) error
	Events() <-chan TurnEvent
	Close() error
}

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

type KimiConfig struct {
	Command      string
	Timeout      time.Duration
	Env          map[string]string
	WorkspaceDir string
	// ProfileOverrides maps profile name → per-profile runner overrides.
	ProfileOverrides map[string]ProfileRunnerConfig
}

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

type OpenCodeConfig struct {
	Command      string
	Timeout      time.Duration
	Model        string
	Variant      string
	Env          map[string]string
	WorkspaceDir string
	// ServerURL connects to an already-running opencode server instead of
	// spawning `opencode serve`.
	ServerURL string
	// ProfileOverrides maps profile name → per-profile runner overrides.
	ProfileOverrides map[string]ProfileRunnerConfig
}

type ProfileRunnerConfig struct {
	Command         string
	Timeout         time.Duration
	ProviderProfile string
	ExecPolicy      ExecPolicyConfig
}

type ProgressFunc func(step string)

type Provider interface {
	Backend() Backend
}

type RawEvent struct {
	// Kind identifies the event category:
	//   "stdout_line" – every raw stdout JSON-line from the CLI
	//   "reasoning"   – a reasoning/thinking block (codex)
	//   "tool_call"   – a command_execution item (codex)
	//   "tool_use"    – a tool/tool_use block in an assistant message (claude, kimi, opencode)
	Kind string
	// Line is the original JSON-lines string from the CLI stdout (always set).
	Line string
	// Detail is a human-readable parsed summary (set for reasoning, tool_call,
	// and tool_use; empty for stdout_line).
	Detail string
}

type RawEventFunc func(event RawEvent)

type RunRequest struct {
	// ThreadID resumes an existing session when non-empty.
	ThreadID string
	// AgentName is informational metadata; not passed to the CLI.
	AgentName string
	// UserText is the fully assembled prompt sent to the CLI.
	UserText string
	// Scene is caller-defined metadata; not passed to the CLI.
	Scene string
	// Provider selects which backend to use when running through a MultiBackend.
	Provider string
	// Model overrides the default model for this request.
	Model string
	// Variant overrides the default variant for this request (e.g. "max", "high", "minimal").
	Variant string
	// Profile selects a named configuration profile defined in the backend config.
	Profile string
	// ReasoningEffort is forwarded to backends that support it (codex).
	ReasoningEffort string
	// Personality is forwarded to backends that accept it as a CLI flag (codex).
	Personality string
	// WorkspaceDir overrides the working directory for this request.
	WorkspaceDir string
	// ExecPolicy overrides sandbox/approval settings for this request (codex).
	ExecPolicy ExecPolicyConfig
	// Env is merged over the process environment before spawning the CLI.
	Env map[string]string
	// OnProgress receives streaming progress updates during execution.
	OnProgress ProgressFunc
	// OnRawEvent optionally receives low-level backend-internal events before
	// any higher-level filtering is applied. See RawEvent for the delivered
	// kinds. Nil disables raw event delivery.
	OnRawEvent RawEventFunc
}

type RunResult struct {
	// Reply is the final assistant message produced by the CLI.
	Reply string
	// NextThreadID is the session/thread ID to pass as ThreadID on the next
	// call to continue the conversation.
	NextThreadID string
	// GoalDone indicates that the agent has signalled goal completion.
	GoalDone bool
	// Usage contains token counts if the backend reported them.
	Usage Usage
}

type SteerMode string

type SubmitMode string

type SubmitResult struct {
	ThreadID   string
	TurnID     string
	Mode       SubmitMode
	QueueDepth int
}

type TurnEvent struct {
	Provider string
	ThreadID string
	TurnID   string
	Kind     TurnEventKind
	Text     string
	Usage    Usage
	Err      error
	Raw      string
}

type TurnEventKind string

type TurnRef struct {
	ThreadID string
	TurnID   string
}

type Usage struct {
	InputTokens       int64
	CachedInputTokens int64
	OutputTokens      int64
}