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
	// Projects powers the sidebar Projects section + per-row project
	// chips. Keyed by project id; ProjectList is the display order.
	Projects    map[string]project.Project
	ProjectList []string
	// ProjectCounts is the number of sessions bound to each project id
	// (sidebar pill). ScopedProjectID, when set, highlights the active
	// project row + drives the scoped breadcrumb.
	ProjectCounts   map[string]int
	ScopedProjectID string
	// PinnedProjectID is the current user's pinned (personal-default)
	// project id, shown with a 📌 in the sidebar. Empty = none.
	PinnedProjectID string
	// FullBleed=true skips the layout's default px-6 py-6 padding
	// wrapper so the page can paint edge-to-edge. The workflow
	// editor needs the full viewport for its canvas; padded pages
	// (sessions, presets, …) leave this false.
	FullBleed bool
	// ShellAssetURL is the hashed bundle URL for the agents-shell island
	// (fe/agents/shell). AgentsLayout emits a <script type="module"> for
	// this URL so every agents page gets pin + drag-to-move sidebar
	// behaviors. Empty when the bundle has not been built yet (dev
	// machine before npm run build).
	ShellAssetURL string
	// AirouterVisible controls the "AI Router" sidebar entry. True when the
	// master switch is on AND the caller may access it (admin) — everyone
	// loses it when the AI routers are disabled.
	AirouterVisible bool
}

type AirouterVM struct {
	Layout   AgentsLayoutVM
	Base     string // /tools/agents
	AssetURL string
}

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 ConnectorsSPAVM struct {
	Layout   AgentsLayoutVM
	Base     string
	AssetURL string
	// Deep is an optional client-route path (e.g. /connectors/slack/123)
	// forwarded by manager's connectors→agents redirect. The SPA router
	// reads it from data-deep on boot to open that view directly, so a
	// reload/deep link of a /manager/connectors URL lands on the same page
	// inside the Agents shell rather than the connectors index.
	Deep string
}

type ConversationVM struct {
	Layout         AgentsLayoutVM
	Base           string
	AssetURL       string
	ScmAsset       string
	InitialSession string
	IdleTimeoutMs  int
}

type DataTableDetailVM struct {
	Layout  AgentsLayoutVM
	Base    string
	Slug    string
	Schema  datatable.Schema
	Rows    []map[string]any
	Flash   string
	SortCol string
	SortDir string                // "asc" | "desc"
	Filters map[string]FilterChip // keyed by column name
}

type DataTableRow struct {
	Slug      string
	Name      string
	RowCount  int
	Columns   int
	SizeBytes int64
	UpdatedAt time.Time
	CreatedAt time.Time
}

type DataTablesVM struct {
	Layout AgentsLayoutVM
	Base   string
	Tables []DataTableRow
	Flash  string
}

type FilterChip struct {
	Op    string
	Value string
}

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

	// PermissionMode is the active value of GateConfig.PermissionMode
	// ("on" | "bypass"). "bypass" means the spawner strips the hook
	// config and runs unguarded — UI surfaces that as a locked badge
	// so operators can't toggle individual provider hooks (no-op).
	PermissionMode string

	// BypassLocked is true when PermissionMode=="bypass". Retained for
	// templ branches that already key off this flag; equivalent to
	// PermissionMode == "bypass".
	BypassLocked bool
}

type LiveProcessVM struct {
	SessionID string
	AgentName string
	PID       int
	Lifecycle string // "spawning" | "working" | "idle" | "killed"
	Substate  string
}

type MCPClientStatusVM struct {
	ID          string // "claude", "cursor", "gemini", "codex", "claude-code"
	Label       string // "Claude Desktop", "Cursor", …
	Detected    bool   // client config dir exists on this host
	Installed   bool   // wick entry present in client's mcpServers
	Blocklisted bool   // user manually uninstalled — skip auto-install
	ConfigPath  string // absolute path to config file (for tooltip)
}

type MCPStatusVM struct {
	AppName string
	Clients []MCPClientStatusVM
}

type ModelChoiceVM struct {
	ID      string
	Label   string
	Default bool
	// Desc is a short human description shown under the model name in the
	// picker (like the CLIs' own /model menu). Empty when unknown.
	Desc string
	// Live marks a LIVE model SET rather than a single model: the picker shows
	// it as an expandable row (a 4th level) resolved by this row's ID — the
	// vendor filter itself stays server-side and is never exposed to the UI.
	Live bool
	// Caps is the vendor's raw "capabilities" object for this model (verbatim
	// JSON), used by the picker to render capability chips. Populated only for
	// live-set drill rows (they come from live discovery); nil for plain
	// registered models, which don't store caps. Raw so any vendor key survives.
	Caps json.RawMessage
}

type NewSessionSPAVM struct {
	Layout   AgentsLayoutVM
	Base     string
	AssetURL string
}

type OverviewSPAVM struct {
	Layout   AgentsLayoutVM
	Base     string
	AssetURL string
}

type PresetsSPAVM struct {
	Layout   AgentsLayoutVM
	Base     string
	AssetURL string
}

type ProjectSettingsSPAVM struct {
	Layout    AgentsLayoutVM
	Base      string
	ProjectID string
	AssetURL  string
}

type ProviderCapVM struct {
	Used      int
	Max       int
	Unlimited bool
}

type ProviderChoiceVM struct {
	Type    string
	Name    string
	Version string
	// UsesAIRouter is true when this instance routes through the embedded
	// AI Router — the composer marks it with a badge.
	UsesAIRouter bool
	// Models lists this instance's selectable models — currently only
	// populated for wick (its custom-model registry). Empty for every
	// other provider type: the composer picker only descends to a 3rd
	// "model" level when there's more than one enabled entry here.
	Models []ModelChoiceVM
}

type ProvidersSPAVM struct {
	Layout   AgentsLayoutVM
	Base     string
	AssetURL string
}

type RestDocsVM struct {
	Base              string // wick external URL (also used for /profile/tokens link)
	APIBase           string // <Base>/integrations/rest/api/v1/openai — what SDK base_url points at
	ChatEndpoint      string // <APIBase>/chat/completions
	ResponsesEndpoint string // <APIBase>/responses
	ModelsEndpoint    string // <APIBase>/models
}

type ScheduledSPAVM struct {
	Layout   AgentsLayoutVM
	Base     string
	AssetURL string
}

type SessionLifecycleVM struct {
	Lifecycle    string
	PID          int
	LastActiveMs int64
}

type SettingsVM struct {
	Layout AgentsLayoutVM
	Base   string
	Rows   []entity.Config
	// SystemPromptCurrent is the live value of `system_prompt`.
	SystemPromptCurrent string
	// SystemPromptDefault is the baseline shipped with wick. Rendered as
	// the target of the Reset button.
	SystemPromptDefault string
}

type SkillsSPAVM struct {
	Layout   AgentsLayoutVM
	Base     string
	AssetURL string
}