Documentation
¶
Index ¶
- type ServerStatus
- type ServerStatusSnapshot
- type ToolInfo
- type View
- func (v *View) Count() int
- func (v *View) CountByState(state string) int
- func (v *View) CountConnected() int
- func (v *View) GetAll() map[string]*ServerStatus
- func (v *View) GetServer(name string) (*ServerStatus, bool)
- func (v *View) RemoveServer(name string)
- func (v *View) Snapshot() *ServerStatusSnapshot
- func (v *View) UpdateServer(name string, fn func(*ServerStatus))
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type ServerStatus ¶
type ServerStatus struct {
Name string
Config *config.ServerConfig
State string // Actor state: idle, connecting, connected, error, etc.
Enabled bool
Quarantined bool
Connected bool
LastError string
LastErrorTime *time.Time
ConnectedAt *time.Time
DisconnectedAt *time.Time
RetryCount int
ToolCount int
Tools []ToolInfo // Phase 7.1: Cached tool list for lock-free reads
// ToolsDiscovered reports that a discovery pass has COMPLETED for this
// connection and Tools is its authoritative result — including an
// authoritative EMPTY result for an upstream that lists zero tools. It is
// stamped by the supervisor when discovery publishes the tool set
// (RefreshToolsFromDiscovery / RefreshServerToolsFromDiscovery) and
// cleared together with Tools on disconnect, so a freshly connected server
// whose discovery has not run yet reads Connected=true, Tools=nil,
// ToolsDiscovered=false. Spec 105 FR-009 (research D4) keys tool-identity
// resolution on it rather than on len(Tools) > 0: the connect→discovery
// window and a genuinely tool-less server both fail CLOSED instead of
// admitting any name with the destructive-tier fallback.
ToolsDiscovered bool
// DiscoveryEpoch is the live client's connection-instance token
// (managed.Client.ConnectionEpoch) captured BEFORE the tools/list that
// produced Tools, stamped together with ToolsDiscovered. Identity
// resolution compares it with the client's current token: a mismatch
// means the connection changed since discovery ran — its events dropped
// or lagging, no reconcile edge observed yet — and the stamp certifies
// nothing for the live connection (Spec 105 FR-009; astra r2 C3). Zero
// when no discovery has been published for this connection.
DiscoveryEpoch int64
Metadata map[string]interface{}
// Diagnostic is the most recent classified failure for this server, or nil
// when the server is healthy (or the last failure has not yet been classified).
// Spec 044.
Diagnostic *diagnostics.DiagnosticError
// RetryStopped reports that automatic reconnection has been given up for
// good: the classifier proved the failure deterministic and unrecoverable,
// so re-dialing cannot succeed until a human changes something (GH #1145).
// It is NOT the ordinary exponential backoff — that keeps retrying.
//
// The three fields exist as first-class status so the REST API, the CLI and
// the tray all read the same thing; without them a parked server would look
// like any other error and the user would wait forever for a retry that is
// never coming.
RetryStopped bool
// RetryStoppedCode is the stable MCPX_* code that justified stopping.
RetryStoppedCode string
// RetryStoppedReason is the human-readable cause, taken from the diagnostics
// catalog entry for RetryStoppedCode (falling back to the raw error).
RetryStoppedReason string
}
ServerStatus represents the runtime status of an upstream server.
type ServerStatusSnapshot ¶
type ServerStatusSnapshot struct {
Servers map[string]*ServerStatus
Timestamp time.Time
}
ServerStatusSnapshot is an immutable snapshot of all server statuses.
type ToolInfo ¶
type ToolInfo struct {
Name string
Description string
InputSchema map[string]interface{}
Annotations *config.ToolAnnotations
// OutputSchemaJSON is the tool's declared output schema (raw JSON), empty
// when the tool declares none. Used for output-schema validation (Spec 056).
OutputSchemaJSON string
}
ToolInfo represents a cached tool definition.
type View ¶
type View struct {
// contains filtered or unexported fields
}
View provides a read-only view of server statuses. It maintains an in-memory snapshot updated via supervisor events.
func (*View) CountByState ¶
CountByState returns the number of servers in a specific state (lock-free).
func (*View) CountConnected ¶
CountConnected returns the number of connected servers (lock-free).
func (*View) GetAll ¶
func (v *View) GetAll() map[string]*ServerStatus
GetAll returns all server statuses (lock-free).
func (*View) GetServer ¶
func (v *View) GetServer(name string) (*ServerStatus, bool)
GetServer returns the status for a specific server (lock-free).
func (*View) RemoveServer ¶
RemoveServer removes a server from the view.
func (*View) Snapshot ¶
func (v *View) Snapshot() *ServerStatusSnapshot
Snapshot returns the current immutable snapshot of all server statuses. This is a lock-free read operation.
func (*View) UpdateServer ¶
func (v *View) UpdateServer(name string, fn func(*ServerStatus))
UpdateServer updates or creates a server status entry.