statusclient

Documentation

Overview

Package statusclient is the CLI's HTTP client for a running kram-gateway's /admin/status: real per-provider telemetry and combo definitions, used to draw the footer and the expanded strategy panel. Nothing here is simulated — every number comes straight from the gateway's own counters.

Index

• type Client
  • func New(baseURL string) *Client
  • func (c *Client) Fetch(ctx context.Context) (Status, error)
  • func (c *Client) SetStrategy(ctx context.Context, combo, strategy string) (Combo, error)
• type Combo
• type Provider
• type ProviderStats
• type Status

Types

type Client

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

Client talks to a kram-gateway instance's status endpoint.

func New

func New(baseURL string) *Client

New builds a client pointed at a running gateway (e.g. http://127.0.0.1:20128).

func (*Client) Fetch

func (c *Client) Fetch(ctx context.Context) (Status, error)

Fetch retrieves the current status snapshot.

func (*Client) SetStrategy

func (c *Client) SetStrategy(ctx context.Context, combo, strategy string) (Combo, error)

SetStrategy changes combo's runtime strategy for future model calls. The gateway intentionally exposes this mutation only to loopback clients.

type Combo

type Combo struct {
	ID        string   `json:"id"`
	Strategy  string   `json:"strategy"`
	Providers []string `json:"providers"`
}

Combo is one entry in the gateway's status response.

type Provider

type Provider struct {
	ID          string        `json:"id"`
	Kind        string        `json:"kind"`
	BreakerOpen bool          `json:"breaker_open"`
	Stats       ProviderStats `json:"stats"`
}

Provider is one entry in the gateway's status response.

type ProviderStats

type ProviderStats struct {
	Requests         int64   `json:"requests"`
	Failures         int64   `json:"failures"`
	PromptTokens     int64   `json:"prompt_tokens"`
	CompletionTokens int64   `json:"completion_tokens"`
	AvgLatencyMS     int64   `json:"avg_latency_ms"`
	SuccessRate      float64 `json:"success_rate"`
}

ProviderStats mirrors the gateway's telemetry.ProviderStats.

type Status

type Status struct {
	Providers  []Provider `json:"providers"`
	Combos     []Combo    `json:"combos"`
	Strategies []string   `json:"strategies"`
}

Status is the full /admin/status payload.