agent

type Agent interface {
	// Initialize handles first-run configuration (model/reasoning setup).
	Initialize(ctx context.Context, opts ...InitOption) (*InitResult, error)
	// SendMessage sends a prompt and returns per-turn results.
	SendMessage(ctx context.Context, prompt string, opts ...SendOption) (*AgentResult, error)
	// SendMessageWithRetry wraps SendMessage with interactive retry-on-error UX.
	SendMessageWithRetry(ctx context.Context, prompt string, opts ...SendOption) (*AgentResult, error)
	// ListSessions returns previous sessions for the given working directory.
	ListSessions(ctx context.Context, cwd string) ([]SessionMetadata, error)
	// GetMetrics returns cumulative session metrics (usage + file changes).
	GetMetrics() AgentMetrics
	// GetMessages returns the session event log from the Copilot SDK.
	GetMessages(ctx context.Context) ([]SessionEvent, error)
	// SessionID returns the current session ID, or empty if no session exists.
	SessionID() string
	// Stop terminates the agent and releases resources.
	Stop() error
}

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

type AgentFactory interface {
	// Create builds a new Agent with the given options.
	Create(ctx context.Context, opts ...AgentOption) (Agent, error)
}

type AgentMetrics struct {
	// Usage contains cumulative token and cost metrics.
	Usage UsageMetrics
	// FileChanges contains accumulated file changes across all SendMessage calls.
	FileChanges watch.FileChanges
}

type AgentMode string

type AgentOption func(*CopilotAgent)

type AgentResult struct {
	// SessionID is the session identifier for resuming later.
	SessionID string
	// Usage contains token and cost metrics for this turn.
	Usage UsageMetrics
	// FileChanges contains files created/modified/deleted during this turn.
	FileChanges watch.FileChanges
}

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

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

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

type InitOption func(*initOptions)

type InitResult struct {
	// Model is the selected model name (empty = default).
	Model string
	// ReasoningEffort is the selected reasoning level.
	ReasoningEffort string
	// IsFirstRun is true if the user was prompted for configuration.
	IsFirstRun bool
}

type SendOption func(*sendOptions)

type SessionEvent = copilot.SessionEvent

type SessionMetadata = copilot.SessionMetadata

type UsageMetrics struct {
	Model           string
	InputTokens     float64
	OutputTokens    float64
	BillingRate     float64 // per-request cost multiplier (e.g., 1.0x, 2.0x)
	PremiumRequests float64
	DurationMS      float64
}