view

type AgentsLayoutVM struct {
	Base             string
	ActivePage       string
	SidebarIDs       []string
	SidebarSessions  map[string]session.Session
	SidebarLifecycle map[string]SessionLifecycleVM
	SidebarLabels    map[string]string // session id → first user message preview
	ActiveSessionID  string
	IdleTimeoutMs    int64
}

type ChannelConfigVM struct {
	Layout      AgentsLayoutVM
	Base        string
	ChannelName string
	ChannelSlug string
	Rows        []entity.Config
	ActionBase  string
	// Docs is an optional component rendered below the config table.
	// Channels use it to surface usage notes, sample requests, or links
	// to related pages (e.g. PAT management for REST).
	Docs templ.Component
}

type ChannelListVM struct {
	Layout   AgentsLayoutVM
	Base     string
	Channels []ChannelVM
}

type ChannelVM struct {
	Name        string
	Slug        string // "slack" | "telegram"
	Icon        string
	Description string
	Configured  bool   // true when the required credential is set
	HRef        string // link to config page
}

type GateStatusVM struct {
	Enabled bool
	Binary  string // absolute path (when enabled)
	Source  string // "sibling" | "embed" | "path" — debug aid
	Reason  string // why disabled, when Enabled=false
	Note    string // human-readable behavior summary; rendered as-is

	// BypassLocked is true when agents.bypass_permissions=true. In that
	// state the gate is forced off (spawner strips the hook config) and
	// the UI must hide the toggle / per-provider enable buttons so the
	// operator can't trigger no-op actions. Mutually exclusive with
	// Enabled — never both true at once.
	BypassLocked bool
}

type OverviewVM struct {
	Layout        AgentsLayoutVM
	Base          string
	Active        int
	QueueLen      int
	PoolMax       int
	SessionIDs    []string
	Sessions      map[string]session.Session
	Lifecycle     map[string]SessionLifecycleVM
	IdleTimeoutMs int64
	Queued        []QueuedEntryVM
}

type PresetDetailVM struct {
	Layout AgentsLayoutVM
	Base   string
	Name   string
	Body   string
}

type PresetsVM struct {
	Layout AgentsLayoutVM
	Base   string
	Names  []string
}

type ProviderChoiceVM struct {
	Type    string
	Name    string
	Version string
}

type ProviderSpawnDetailVM struct {
	Layout AgentsLayoutVM
	Base   string
	File   provider.SpawnLogFile
	Events []provider.SpawnEvent
}

type ProvidersVM struct {
	Layout        AgentsLayoutVM
	Base          string
	Statuses      []provider.Status
	Spawns        []provider.SpawnLogFile
	Page          int
	HasNext       bool
	PoolActive    int
	PoolQueueLen  int
	PoolMax       int
	SupportedKeys []string
	Gate          GateStatusVM
	AutoRescan    bool
}

type QueuedEntryVM struct {
	SessionID string
	AgentName string
	WaitingMs int64
}

type RestDocsVM struct {
	Base       string // wick base (for /profile/tokens link)
	Endpoint   string // full URL of the chat completions endpoint
	SampleUser string // session key shown in samples
}

type SessionDetailVM struct {
	Layout          AgentsLayoutVM
	Base            string
	Session         session.Session
	Tab             string // "conversation" | "commands" | "raw"
	Turns           []TurnVM
	CmdLines        []string
	Lifecycle       string
	PID             int
	LastActiveMs    int64
	IdleTimeoutMs   int64
	Gate            GateStatusVM
	Providers       []ProviderChoiceVM
	ActiveProvider  string
	WorkspaceList   []string
	ActiveWorkspace string
}

type SessionLifecycleVM struct {
	Lifecycle    string
	PID          int
	LastActiveMs int64
}

type SessionsListVM struct {
	Layout        AgentsLayoutVM
	Base          string
	IDs           []string
	Sessions      map[string]session.Session
	Labels        map[string]string // id → first user message preview
	Workspaces    map[string]workspace.Workspace
	WorkspaceList []string
	PresetList    []string
	Providers     []ProviderChoiceVM
	Lifecycle     map[string]SessionLifecycleVM
	IdleTimeoutMs int64
	Page          int
	HasNext       bool
}

type SessionsTableVM struct {
	Base          string
	IDs           []string
	Sessions      map[string]session.Session
	Lifecycle     map[string]SessionLifecycleVM
	IdleTimeoutMs int64
	EmptyText     string
	ShowPaging    bool
	Page          int
	HasNext       bool
}

type SettingsVM struct {
	Layout AgentsLayoutVM
	Base   string
	Rows   []entity.Config
}

type TurnVM struct {
	Role      string // "user" | "assistant" | "system"
	Agent     string
	Text      string
	Truncated bool
	Time      time.Time
}

type WorkspacesVM struct {
	Layout        AgentsLayoutVM
	Base          string
	WorkspaceList []string
	Workspaces    map[string]workspace.Workspace
	PresetList    []string
}