Documentation
¶
Overview ¶
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
Index ¶
- func AgentProfilesSPA(vm AgentProfilesSPAVM) templ.Component
- func AgentsApp(vm AgentsAppVM) templ.Component
- func AgentsLayout(vm AgentsLayoutVM) templ.Component
- func AirouterPage(vm AirouterVM) templ.Component
- func BuildReproVariants(providerType, binary string, argv, env []string, prompt string) map[string]string
- func ChannelConfigPage(vm ChannelConfigVM) templ.Component
- func ChannelListPage(vm ChannelListVM) templ.Component
- func ConnectorsPage(vm ConnectorsSPAVM) templ.Component
- func Conversation(vm ConversationVM) templ.Component
- func DataTableDetailPage(vm DataTableDetailVM) templ.Component
- func DataTablesPage(vm DataTablesVM) templ.Component
- func HasResumeArgv(providerType string, argv []string) bool
- func InteractiveArgv(providerType string, argv []string) []string
- func IsRunningStatus(status string) bool
- func NewSessionSPA(vm NewSessionSPAVM) templ.Component
- func OverviewSPA(vm OverviewSPAVM) templ.Component
- func PresetsSPA(vm PresetsSPAVM) templ.Component
- func ProjectSettingsSPA(vm ProjectSettingsSPAVM) templ.Component
- func PromptSupported(providerType string) bool
- func ProvidersSPA(vm ProvidersSPAVM) templ.Component
- func RelativeAge(lastMs, nowMs int64) string
- func ReproKey(shell string, interactive, short, resume bool) string
- func ResourcesSPA(vm ResourcesSPAVM) templ.Component
- func RestDocs(vm RestDocsVM) templ.Component
- func ScheduledSPA(vm ScheduledSPAVM) templ.Component
- func SettingsPage(vm SettingsVM) templ.Component
- func ShellReproduceBash(binary string, argv, env []string, short bool, stdin string) string
- func ShellReproduceCmd(binary string, argv, env []string, short bool, stdin string) string
- func ShellReproducePwsh(binary string, argv, env []string, short bool, stdin string) string
- func SidebarLastActiveMs(sess session.Session, lc SessionLifecycleVM) int64
- func SidebarRowStatus(sess session.Session, lc SessionLifecycleVM) string
- func SkillsSPA(vm SkillsSPAVM) templ.Component
- func StatusDotClass(status string) string
- func StreamJSONUserLine(text string) string
- func StripResumeArgv(providerType string, argv []string) []string
- type AgentProfilesSPAVM
- type AgentsAppVM
- type AgentsLayoutVM
- type AgentsNavItem
- type AirouterVM
- type ChannelConfigVM
- type ChannelListVM
- type ChannelVM
- type ConnectorsSPAVM
- type ConversationVM
- type DataTableDetailVM
- type DataTableRow
- type DataTablesVM
- type FilterChip
- type GateStatusVM
- type LiveProcessVM
- type MCPClientStatusVM
- type MCPStatusVM
- type ModelChoiceVM
- type NewSessionSPAVM
- type OverviewSPAVM
- type PresetsSPAVM
- type ProjectSettingsSPAVM
- type ProviderCapVM
- type ProviderChoiceVM
- type ProvidersSPAVM
- type ResourcesSPAVM
- type RestDocsVM
- type ScheduledSPAVM
- type SessionLifecycleVM
- type SettingsVM
- type SkillsSPAVM
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AgentProfilesSPA ¶ added in v0.36.0
func AgentProfilesSPA(vm AgentProfilesSPAVM) templ.Component
AgentProfilesSPA renders the sub-agent roles shell. The SPA reads data-base from the #app div and uses it as the prefix for all API calls (e.g. ${base}/api/agent-profiles).
func AgentsApp ¶ added in v1.14.0
func AgentsApp(vm AgentsAppVM) templ.Component
AgentsApp renders the Agents app shell. Deliberately WITHOUT AgentsLayout: the app has its own roster sidebar, and the wick sidebar beside it would be two navigation columns for one screen. The page chrome (head, CSS, theme) still comes from the app-wide renderer, so light/dark and fonts match every other page.
func AgentsLayout ¶
func AgentsLayout(vm AgentsLayoutVM) templ.Component
AgentsLayout wraps every Agents page with a full-screen Claude-style shell: sidebar left (nav + recent sessions) and flex-1 main content area.
func AirouterPage ¶ added in v0.31.0
func AirouterPage(vm AirouterVM) templ.Component
AirouterPage renders the AI Router SPA shell inside the agents chrome. The SPA reads data-base from the #app div, then drives the router switcher and per-router tabs client-side.
func BuildReproVariants ¶ added in v0.28.1
func BuildReproVariants(providerType, binary string, argv, env []string, prompt string) map[string]string
BuildReproVariants renders all 24 reproduce commands (3 shells × headless/ interactive × full/short path × keep/strip resume) for the given binary, argv, and env. The same function serves the masked page render and the unmasked reveal endpoint — callers pass masked vs unmasked env so the keys line up exactly.
prompt is the first user message the command should carry. Empty renders the bare command (what the spawn log used to show), which for a stdin provider starts a CLI with nothing to say — claude then reports "No deferred tool marker found in the resumed session". Non-empty is delivered per the provider's ReproSpec: piped into stdin as a stream-json line for the long-lived-stdin CLIs, appended as a positional arg in interactive mode.
func ChannelConfigPage ¶
func ChannelConfigPage(vm ChannelConfigVM) templ.Component
ChannelConfigPage shows config fields for one channel.
func ChannelListPage ¶
func ChannelListPage(vm ChannelListVM) templ.Component
ChannelListPage shows available channels as cards.
func ConnectorsPage ¶ added in v0.22.2
func ConnectorsPage(vm ConnectorsSPAVM) templ.Component
ConnectorsPage renders the manager SPA mount point inside AgentsLayout. data-base is the manager client-route prefix, so the SPA boots straight into its connectors view and stays self-consistent.
func Conversation ¶ added in v0.19.0
func Conversation(vm ConversationVM) templ.Component
Conversation renders the conversation SPA shell inside the agents chrome. The SPA reads data-base from the #app div and uses it as the prefix for all API calls (e.g. ${base}/api/sessions).
func DataTableDetailPage ¶ added in v0.13.1
func DataTableDetailPage(vm DataTableDetailVM) templ.Component
func DataTablesPage ¶ added in v0.13.1
func DataTablesPage(vm DataTablesVM) templ.Component
func HasResumeArgv ¶ added in v0.28.1
HasResumeArgv reports whether argv carries a resume-session token for the provider — i.e. whether the Keep/Fresh toggle would make any difference. The first spawn of a session has no resume id, so the toggle should be hidden.
func InteractiveArgv ¶ added in v0.28.1
InteractiveArgv strips the headless/programmatic tokens wick adds (per provider.ReproSpec) so the command runs in the CLI's normal interactive chat mode instead of emitting a JSON stream. Everything else (--mcp-config, --add-dir, --resume, …) is kept so the session context is identical.
func IsRunningStatus ¶ added in v1.2.9
IsRunningStatus reports whether an effectiveStatus value means "work is happening or about to": those rows sort to the top of the sidebar and carry the accent border. Idle is a warm process with nothing to do, so it sorts by age like everything else.
MIRRORED in fe/agents/shell/src/sidebarOrder.ts (isRunningStatus).
func NewSessionSPA ¶ added in v0.19.0
func NewSessionSPA(vm NewSessionSPAVM) templ.Component
NewSessionSPA renders the new-session compose SPA shell inside the agents chrome. The SPA reads data-base from the #app div and uses it as the prefix for all API calls (e.g. ${base}/providers/options).
func OverviewSPA ¶ added in v0.19.0
func OverviewSPA(vm OverviewSPAVM) templ.Component
OverviewSPA renders the overview SPA shell inside the agents chrome. The SPA reads data-base from the #app div and uses it as the prefix for all API calls (e.g. ${base}/api/overview).
func PresetsSPA ¶ added in v0.19.0
func PresetsSPA(vm PresetsSPAVM) templ.Component
PresetsSPA renders the presets SPA shell inside the agents chrome. The SPA reads data-base from the #app div and uses it as the prefix for all API calls (e.g. ${base}/api/presets).
func ProjectSettingsSPA ¶ added in v0.19.0
func ProjectSettingsSPA(vm ProjectSettingsSPAVM) templ.Component
ProjectSettingsSPA renders the project-settings SPA shell inside the agents chrome. The SPA reads data-base and data-project-id from the #app div.
func PromptSupported ¶ added in v1.2.9
PromptSupported reports whether the Prompt control is meaningful for this provider — false when the spawn's argv already carries the message, so the UI can hide a toggle that would only duplicate it.
func ProvidersSPA ¶ added in v0.19.0
func ProvidersSPA(vm ProvidersSPAVM) templ.Component
ProvidersSPA renders the providers SPA shell inside the agents chrome. The SPA reads data-base from the #app div and uses it as the prefix for all API calls (e.g. ${base}/api/providers).
func RelativeAge ¶ added in v1.2.9
RelativeAge is the compact "last update" label on a sidebar row: "now", "3m", "2h", "5d". Deliberately terse — the row is 15rem wide and the title is the thing worth reading; the age only has to answer "is this the one I touched a minute ago or last week".
MIRRORED in fe/agents/shell/src/sidebarOrder.ts (relativeAge) — the island refreshes this label every 30s. Change both together.
func ReproKey ¶ added in v0.28.1
ReproKey names a reproduce variant by its four axes. Used as the map key in BuildReproVariants and mirrored by the front-end / reveal keys.
shell: "bash" | "powershell" | "cmd" interactive: headless "h" vs interactive "i" short: full path "full" vs basename "short" resume: keep resume "res" vs fresh session "new"
func ResourcesSPA ¶ added in v0.39.0
func ResourcesSPA(vm ResourcesSPAVM) templ.Component
ResourcesSPA renders the resource-usage SPA shell inside the agents chrome. The SPA reads data-base from the #app div and uses it as the prefix for all API calls (e.g. ${base}/api/memory).
func RestDocs ¶ added in v0.10.0
func RestDocs(vm RestDocsVM) templ.Component
RestDocs renders usage docs for the three OpenAI-compatible routes the REST channel exposes. Top section is the common contract (base URL, auth, streaming, approvals); below it a tab strip jumps between per-endpoint examples.
func ScheduledSPA ¶ added in v0.29.0
func ScheduledSPA(vm ScheduledSPAVM) templ.Component
ScheduledSPA renders the scheduled-messages monitor SPA shell inside the agents chrome. The SPA reads data-base from the #app div and uses it as the prefix for all API calls (e.g. ${base}/scheduled/all).
func SettingsPage ¶ added in v0.10.0
func SettingsPage(vm SettingsVM) templ.Component
SettingsPage renders agents settings inside AgentsLayout. The system_prompt row is broken out into its own panel so the textarea can render full-height and carry a Reset-to-default button. Remaining rows fall back to the generic ConfigsTable. POSTs target /manager/tools/agents/configs/{key}.
Every card starts closed: the page has grown past the point where scrolling through expanded groups finds anything, so the search box is the way in — type a key or a word from its description and only the cards holding a match stay on screen, already open.
func ShellReproduceBash ¶ added in v0.28.1
ShellReproduceBash renders a POSIX/bash command: inline VAR='v' assignments on continuation lines, then the quoted command. short=true uses the binary basename (rely on PATH); otherwise the full path is rewritten to MSYS form (C:\… → /c/…) so it resolves in git-bash/msys2.
func ShellReproduceCmd ¶ added in v0.28.1
ShellReproduceCmd renders a cmd.exe command: one `set "KEY=v"` per line, then the command with double-quote quoting. NOTE: cmd.exe reproduction is best-effort — a JSON arg like --mcp-config contains double-quotes which must be doubled ("") inside a quoted arg, and cmd's quoting/escaping is finicky. PowerShell or bash reproduce such args more reliably.
func ShellReproducePwsh ¶ added in v0.28.1
ShellReproducePwsh renders a PowerShell command: one $env:KEY='v' statement per line, then the command with PowerShell single-quote quoting. The binary is invoked with the call operator `&` — a quoted string on its own is just a literal in PowerShell (it echoes, doesn't execute); `& 'path'` runs it.
func SidebarLastActiveMs ¶ added in v1.2.9
func SidebarLastActiveMs(sess session.Session, lc SessionLifecycleVM) int64
SidebarLastActiveMs is the newest activity we know of for a row: the session's persisted LastActive or the pool's in-memory one, whichever is later. The pool's moves on every turn event, the meta's only when it is saved, so taking the max keeps the label honest mid-turn.
func SidebarRowStatus ¶ added in v1.2.9
func SidebarRowStatus(sess session.Session, lc SessionLifecycleVM) string
SidebarRowStatus is the status a sidebar row renders, from the same inputs the dot uses.
func SkillsSPA ¶ added in v0.19.0
func SkillsSPA(vm SkillsSPAVM) templ.Component
SkillsSPA renders the skills SPA shell inside the agents chrome. The SPA reads data-base from the #app div and uses it as the prefix for all API calls (e.g. ${base}/api/skills).
func StatusDotClass ¶ added in v0.36.1
StatusDotClass maps a lifecycle to the indicator's classes.
Spinning, not just coloured, for working/spawning: a static dot in a list of dots does not read as "this one is busy right now", which is the single thing someone scanning the sidebar wants to know.
MIRRORED in fe/agents/shell/src/main.ts (statusDotClass) — the island re-renders this same node from live events. Change both together.
func StreamJSONUserLine ¶ added in v1.2.9
StreamJSONUserLine renders one stream-json user message — the exact line provider.Agent.Send writes to the subprocess stdin. Kept byte-identical to that envelope: reproducing a spawn means feeding the CLI what wick feeds it, not an approximation. Always a single line (json escapes any newline), which is what lets the bash/PowerShell heredocs below use a fixed delimiter.
func StripResumeArgv ¶ added in v0.28.1
StripResumeArgv drops the resume-session tokens (per provider.ReproSpec) so the command starts a fresh session instead of continuing the logged one.
Types ¶
type AgentProfilesSPAVM ¶ added in v0.36.0
type AgentProfilesSPAVM struct {
Layout AgentsLayoutVM
Base string
AssetURL string
}
AgentProfilesSPAVM feeds the thin shell that hosts the sub-agent roles SPA inside the standard agents layout. AssetURL is the hashed Vite bundle path resolved at boot via spaAssetURL("agent-profiles").
type AgentsAppVM ¶ added in v1.14.0
type AgentsAppVM struct {
Base string
AssetURL string
ScmAsset string
IdleTimeoutMs int
RailPrefs string
ViewerID string
ViewerName string
// Theme feeds the account menu's Light/Dark switch, which posts to the
// existing /theme endpoint: the mode on screen and the user's paired
// light and dark theme ids. Empty for a signed-out viewer.
ThemeMode string
ThemeLight string
ThemeDark string
}
AgentsAppVM feeds the full-screen Team app (/team; "Agents app" in code). It hosts the same conversation bundle as the session pages, switched into its agents mode by data-mode, so a chat with an agent is the ordinary conversation view and not a second implementation of it.
type AgentsLayoutVM ¶ added in v0.10.0
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
// its owner's name, for the sidebar's hover-only shared icon. Absent = theirs.
SharedOwners map[string]string
// SidebarOwner is the sidebar session list's scope: "me" (default)
// shows only the caller's sessions, "all" everything they may see.
// The two hrefs re-render the CURRENT page with ?sb= set — the toggle
// is a pair of plain links, no script.
SidebarOwner string
SidebarOwnerMeHref string
SidebarOwnerAllHref string
// ScopedProjectID, when set, highlights the active project row +
// drives the scoped breadcrumb.
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
// ProvidersVisible controls the "Providers" sidebar entry. True for
// admins, and for anyone holding a manage tag on at least one
// provider instance. A menu that opens onto an empty page is worse
// than no menu, so the entry is hidden rather than shown-and-empty.
ProvidersVisible bool
}
AgentsLayoutVM carries sidebar data for the full-screen Claude-style shell.
func (AgentsLayoutVM) NewSessionHref ¶ added in v0.14.21
func (vm AgentsLayoutVM) NewSessionHref() string
NewSessionHref is the "New session" nav target. When the sidebar is scoped to a project, it carries `?project=<id>` so the compose form auto-selects that project (mockup ②). Unscoped it carries ?view=classic: the bare landing is what "Open Team when I open Agents" sends to Team, and a click on New session from inside Agents must stay in Agents.
func (AgentsLayoutVM) ProjectIcon ¶ added in v0.14.21
func (vm AgentsLayoutVM) ProjectIcon(id string) string
ProjectIcon returns the emoji icon for a project id (📁 fallback).
func (AgentsLayoutVM) ProjectName ¶ added in v0.14.21
func (vm AgentsLayoutVM) ProjectName(id string) string
ProjectName returns the display name for a project id, or the id itself when unknown. Used by sidebar / session rows.
type AgentsNavItem ¶ added in v1.2.9
type AgentsNavItem struct {
}
AgentsNavItem is one row in the More group.
func AgentsMoreItems ¶ added in v1.2.9
func AgentsMoreItems(vm AgentsLayoutVM, user *entity.User) []AgentsNavItem
AgentsMoreItems returns the More group's rows in display order, already filtered by what this user may see.
Ordered by use-frequency: monitoring + everyday tools first, config/infra last.
type AirouterVM ¶ added in v0.31.0
type AirouterVM struct {
Layout AgentsLayoutVM
Base string // /tools/agents
AssetURL string
}
AirouterVM feeds the thin-shell that hosts the AI Router SPA inside the standard agents layout. AssetURL is the hashed Vite bundle path resolved at boot via spaAssetURL("airouter"). The SPA fetches the router list + each router's status/toggles from /tools/agents/airouter/* itself.
type ChannelConfigVM ¶
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
}
ChannelConfigVM is the view model for a single channel's config page.
type ChannelListVM ¶
type ChannelListVM struct {
Layout AgentsLayoutVM
Base string
Channels []ChannelVM
}
ChannelListVM is the view model for the Channels index page.
type 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
}
ChannelVM is one channel card on the channels list page.
type ConnectorsSPAVM ¶ added in v0.22.2
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
}
ConnectorsSPAVM hosts the manager SPA inside the Agents chrome. Base + AssetURL come from manager.SPAMount() — the SAME bundle the /manager pages serve, with the client router still rooted at /manager. Mounting it here just swaps the outer shell (Agents sidebar instead of the manager navbar); every in-SPA API call and link keeps resolving against the live /manager/* routes, so no connector code moves.
type ConversationVM ¶ added in v0.19.0
type ConversationVM struct {
Layout AgentsLayoutVM
Base string
AssetURL string
ScmAsset string
InitialSession string
IdleTimeoutMs int
RailPrefs string
// ViewerID is the wick user reading this page. The SPA compares it
// against each turn's sender to decide whose message is whose: a turn
// this person sent needs no name, and one from anybody else does — which
// is the whole point in a session several people write into.
ViewerID string
}
ConversationVM feeds the thin-shell that hosts the conversation SPA inside the standard agents layout. AssetURL is the hashed Vite bundle path resolved at boot via spaAssetURL("conversation"); ScmAsset is the hashed SCM bundle path used by the docked source-control panel. InitialSession, when non-empty, causes the SPA to deep-link directly to that session on load via the #app data-initial-session attribute. IdleTimeoutMs is the agents idle_timeout_sec × 1000, used by the SPA idle lifecycle badge for the "kill in Ns" countdown.
RailPrefs is the caller's saved rail layout as JSON, inlined so the strip is drawn correctly on the FIRST paint. Fetching it left the rail rendering its default and then collapsing a request later, which read as the saved layout not having stuck. This is the same profile record the API serves, delivered earlier — not a second source: the SPA still writes through the API, and a page it did not render falls back to fetching.
type DataTableDetailVM ¶ added in v0.13.1
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
}
DataTableDetailVM is the per-table page model.
SortCol/SortDir + Filters drive the spreadsheet header indicators (active sort arrow + funnel highlight) and let the filter popover pre-fill its inputs from the live URL. Both are populated by the handler from query params; an empty SortCol means "default id ASC".
type DataTableRow ¶ added in v0.13.1
type DataTableRow struct {
Slug string
Name string
RowCount int
Columns int
SizeBytes int64
UpdatedAt time.Time
CreatedAt time.Time
}
DataTableRow summarises one data table on the list page.
type DataTablesVM ¶ added in v0.13.1
type DataTablesVM struct {
Layout AgentsLayoutVM
Base string
Tables []DataTableRow
Flash string
}
DataTablesVM is the model for the Data Tables list page.
type FilterChip ¶ added in v0.13.1
FilterChip is one applied filter for a column. Op is one of the datatable.Op* constants; Value is "" for is_empty / is_not_empty.
type GateStatusVM ¶
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
}
GateStatusVM is the umbrella "what is the gate doing right now?" card on the Providers page. Gate covers two sub-policies — the permission prompt and the ask_user MCP tool — so the VM carries both, plus the boot-time binary resolution state for the permission hook.
type LiveProcessVM ¶ added in v0.15.2
type LiveProcessVM struct {
SessionID string
AgentName string
PID int
Lifecycle string // "spawning" | "working" | "idle" | "killed"
Substate string
}
LiveProcessVM is one row in the Active Processes panel on the Providers page.
type MCPClientStatusVM ¶ added in v0.13.0
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)
}
MCPClientStatusVM is one row in the MCP Wick card — one per detected MCP client (Claude Desktop, Cursor, Gemini CLI, etc.).
type MCPStatusVM ¶ added in v0.13.0
type MCPStatusVM struct {
AppName string
Clients []MCPClientStatusVM
}
MCPStatusVM is the aggregate for the MCP Wick card on the Providers page.
type ModelChoiceVM ¶ added in v0.34.0
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
}
ModelChoiceVM is one selectable model under a wick provider instance.
type NewSessionSPAVM ¶ added in v0.19.0
type NewSessionSPAVM struct {
Layout AgentsLayoutVM
Base string
AssetURL string
}
NewSessionSPAVM feeds the thin-shell that hosts the new-session compose SPA inside the standard agents layout. AssetURL is the hashed Vite bundle path resolved at boot via spaAssetURL("new-session").
type OverviewSPAVM ¶ added in v0.19.0
type OverviewSPAVM struct {
Layout AgentsLayoutVM
Base string
AssetURL string
}
OverviewSPAVM feeds the thin-shell that hosts the overview SPA inside the standard agents layout. AssetURL is the hashed Vite bundle path resolved at boot via spaAssetURL("overview").
type PresetsSPAVM ¶ added in v0.19.0
type PresetsSPAVM struct {
Layout AgentsLayoutVM
Base string
AssetURL string
}
PresetsSPAVM feeds the thin-shell that hosts the presets SPA inside the standard agents layout. AssetURL is the hashed Vite bundle path resolved at boot via spaAssetURL("presets").
type ProjectSettingsSPAVM ¶ added in v0.19.0
type ProjectSettingsSPAVM struct {
Layout AgentsLayoutVM
Base string
ProjectID string
AssetURL string
}
ProjectSettingsSPAVM feeds the thin-shell that hosts the project-settings SPA inside the standard agents layout. AssetURL is the hashed Vite bundle path resolved at boot via spaAssetURL("project-settings").
type ProviderCapVM ¶ added in v0.15.2
ProviderCapVM is the used / effective-max slot count for one provider instance, shown on its card as "<Used> / <Max>" — or "<Used> / ∞" when Unlimited (no finite cap at provider or global scope).
type ProviderChoiceVM ¶
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
// ModelsAt / ModelsSource stamp an omp/opencode live list (zero when
// Models is the curated one): the picker shows "Updated … · files"
// from the first paint.
ModelsAt time.Time
ModelsSource string
}
ProviderChoiceVM is one healthy provider row — what the New Session picker offers. Disabled / unprobed / version-failed providers never reach the UI.
type ProvidersSPAVM ¶ added in v0.19.0
type ProvidersSPAVM struct {
Layout AgentsLayoutVM
Base string
AssetURL string
}
ProvidersSPAVM feeds the thin-shell that hosts the providers SPA inside the standard agents layout. AssetURL is the hashed Vite bundle path resolved at boot via spaAssetURL("providers").
type ResourcesSPAVM ¶ added in v0.39.0
type ResourcesSPAVM struct {
Layout AgentsLayoutVM
Base string
AssetURL string
}
ResourcesSPAVM feeds the thin-shell that hosts the resources SPA inside the standard agents layout. AssetURL is the hashed Vite bundle path resolved at boot via spaAssetURL("resources").
type RestDocsVM ¶ added in v0.10.0
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
}
RestDocsVM is the view model for the REST channel's docs panel.
APIBase is the SDK base_url (no trailing slash). The three endpoint fields are full URLs derived from it — handler precomputes them so the templ stays free of string concat noise.
type ScheduledSPAVM ¶ added in v0.29.0
type ScheduledSPAVM struct {
Layout AgentsLayoutVM
Base string
AssetURL string
}
ScheduledSPAVM feeds the thin-shell that hosts the scheduled-messages monitor SPA inside the standard agents layout. AssetURL is the hashed Vite bundle path resolved at boot via spaAssetURL("scheduled").
type SessionLifecycleVM ¶
type SessionLifecycleVM struct {
Lifecycle string
PID int
LastActiveMs int64
// SubAgent is the busiest lifecycle among this session's sub-agents
// ("working" / "spawning"), or "" when none of them is doing anything.
// Rolled up from the pool because a child runs under its OWN session
// id, which never appears in the sidebar — without this the row goes
// dark the moment the leader idles, even though work continues.
SubAgent string
}
SessionLifecycleVM is the per-row lifecycle snapshot the sessions list table renders. PID + LastActiveMs feed the countdown ring; Lifecycle is the colour key.
type SettingsVM ¶ added in v0.10.0
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
}
SettingsVM is the view model for the embedded settings page.
type SkillsSPAVM ¶ added in v0.19.0
type SkillsSPAVM struct {
Layout AgentsLayoutVM
Base string
AssetURL string
}
SkillsSPAVM feeds the thin-shell that hosts the skills SPA inside the standard agents layout. AssetURL is the hashed Vite bundle path resolved at boot via spaAssetURL("skills").
Source Files
¶
- agent_profiles_spa_templ.go
- agents_app_templ.go
- airouter_templ.go
- channels_templ.go
- connectors_templ.go
- conversation_templ.go
- datatables_templ.go
- helpers.go
- layout_templ.go
- models.go
- nav_more.go
- new_session_spa_templ.go
- overview_spa_templ.go
- presets_spa_templ.go
- project_settings_spa_templ.go
- providers_spa_templ.go
- reproduce.go
- resources_spa_templ.go
- scheduled_spa_templ.go
- settings_templ.go
- sidebar_resize_templ.go
- sidebar_time.go
- skills_spa_templ.go