agent

type Agent struct {
	UpdatedAt      time.Time    `json:"updated_at"`
	StartedAt      time.Time    `json:"started_at"`
	CreatedAt      time.Time    `json:"created_at"`
	StoppedAt      *time.Time   `json:"stopped_at,omitempty"`
	DeletedAt      *time.Time   `json:"deleted_at,omitempty"`
	RolePrompt     *AgentMemory `json:"memory,omitempty"`
	Workspace      string       `json:"workspace"`
	ID             string       `json:"id"`
	Name           string       `json:"name"`
	Task           string       `json:"task,omitempty"`
	Session        string       `json:"session"`
	SessionID      string       `json:"session_id,omitempty"` // For session resume (#1939)
	Tool           string       `json:"tool,omitempty"`
	ParentID       string       `json:"parent_id,omitempty"`
	HookedWork     string       `json:"hooked_work,omitempty"`
	WorktreeDir    string       `json:"worktree_dir,omitempty"`
	LogFile        string       `json:"log_file,omitempty"`
	Team           string       `json:"team,omitempty"`
	RecoveredFrom  string       `json:"recovered_from,omitempty"`
	EnvFile        string       `json:"env_file,omitempty"`
	RuntimeBackend string       `json:"runtime_backend,omitempty"`
	LastCrashTime  *time.Time   `json:"last_crash_time,omitempty"`
	Role           Role         `json:"role"`
	State          State        `json:"state"`
	Children       []string     `json:"children,omitempty"`
	CrashCount     int          `json:"crash_count,omitempty"`
	IsRoot         bool         `json:"is_root,omitempty"`
}

type AgentMemory struct {
	// LoadedAt is when the memory was loaded.
	LoadedAt time.Time `json:"loaded_at,omitempty"`
	// RolePrompt is the full content of the role's prompt file.
	RolePrompt string `json:"role_prompt,omitempty"`
	// Plugins lists Claude Code plugin names to install on agent start (#1959).
	Plugins []string `json:"plugins,omitempty"`
}

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

type AgentState struct {
	StartedAt time.Time `json:"started_at"`
	UpdatedAt time.Time `json:"updated_at"`
	Name      string    `json:"name"`
	Tool      string    `json:"tool,omitempty"`
	Team      string    `json:"team,omitempty"`
	Parent    string    `json:"parent,omitempty"`
	Worktree  string    `json:"worktree,omitempty"`
	Session   string    `json:"session,omitempty"`
	Role      Role      `json:"role"`
	State     State     `json:"state"`
}

type AgentStatsRecord struct {
	CollectedAt  time.Time `json:"collected_at"`
	AgentName    string    `json:"agent_name"`
	CPUPct       float64   `json:"cpu_pct"`
	MemUsedMB    float64   `json:"mem_used_mb"`
	MemLimitMB   float64   `json:"mem_limit_mb"`
	NetRxMB      float64   `json:"net_rx_mb"`
	NetTxMB      float64   `json:"net_tx_mb"`
	BlockReadMB  float64   `json:"block_read_mb"`
	BlockWriteMB float64   `json:"block_write_mb"`
}

type Capability string

type CostQuerier interface {
	AgentCostSummary(agentID string) (*CostSummary, error)
}

type CostSummary struct {
	AgentID      string  `json:"agent_id"`
	InputTokens  int64   `json:"input_tokens"`
	OutputTokens int64   `json:"output_tokens"`
	TotalTokens  int64   `json:"total_tokens"`
	TotalCostUSD float64 `json:"total_cost_usd"`
	RequestCount int64   `json:"request_count"`
}

type CreateOptions struct {
	Name    string
	Role    Role
	Tool    string
	EnvFile string
	Runtime string
	Parent  string
	Team    string
}

type DeleteOptions struct {
	// Placeholder for future options.
	Force bool
}

type EventPublisher interface {
	Publish(eventType string, data map[string]any)
}

type HookEvent string

type HookPayload struct {
	ToolInput    any       `json:"tool_input,omitempty"`
	SubagentID   string    `json:"subagent_id,omitempty"`
	Channel      string    `json:"channel,omitempty"`
	State        string    `json:"state,omitempty"`
	Task         string    `json:"task,omitempty"`
	ToolName     string    `json:"tool_name,omitempty"`
	Command      string    `json:"command,omitempty"`
	Error        string    `json:"error,omitempty"`
	Model        string    `json:"model,omitempty"`
	Event        HookEvent `json:"event"`
	Sender       string    `json:"sender,omitempty"`
	SubagentType string    `json:"subagent_type,omitempty"`
	Message      string    `json:"message,omitempty"`
	File         string    `json:"file,omitempty"`
	Mentions     []string  `json:"mentions,omitempty"`
	CostUSD      float64   `json:"cost_usd,omitempty"`
	InputTokens  int64     `json:"input_tokens,omitempty"`
	OutputTokens int64     `json:"output_tokens,omitempty"`
}

type ListOptions struct {
	Role   string // Filter by role (empty = all)
	Status string // Filter by status/state (empty = all)
}

type Manager struct {

	// BootstrapDelay is the time to wait before sending bootstrap prompts.
	// If zero, DefaultBootstrapDelay is used.
	BootstrapDelay time.Duration
	// contains filtered or unexported fields
}

type Permission string

type Role string

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

type SendResult struct {
	Matched []string `json:"matched"`
	Sent    int      `json:"sent"`
	Skipped int      `json:"skipped"`
	Failed  int      `json:"failed"`
}

type SessionEntry struct {
	Timestamp time.Time `json:"timestamp,omitempty"`
	ID        string    `json:"id"`
	Current   bool      `json:"current,omitempty"`
}

type SpawnOptions struct {
	Name      string
	Role      Role
	Workspace string
	ParentID  string
	Tool      string
	EnvFile   string
	Runtime   string // override runtime backend ("tmux" or "docker"); empty uses manager default
	Team      string // optional team assignment
	SessionID string // Explicit session ID to resume (overrides stored session_id)
}

type StartOptions struct {
	Runtime  string // Runtime backend override
	ResumeID string // Explicit session ID to resume
}

type State string