Help us shape the future of Go! Take the 2026 Go Developer Survey

adminclient

package
v0.6.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 1, 2026 License: Apache-2.0 Imports: 25 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type ACPCloseThreadResponse added in v0.3.0

type ACPCloseThreadResponse struct {
	Closed int `json:"closed"`
}

type ACPInFlightTurn added in v0.3.0

type ACPInFlightTurn = acphost.InFlightTurn

type ACPPendingPermissionInfo added in v0.3.0

type ACPPendingPermissionInfo = acphost.PendingPermissionInfo

type ACPPooledInstanceInfo added in v0.3.0

type ACPPooledInstanceInfo = acphost.PooledInstanceInfo

type ACPRuntimeView added in v0.3.0

type ACPRuntimeView struct {
	InFlight           []ACPInFlightTurn          `json:"in_flight"`
	Instances          []ACPPooledInstanceInfo    `json:"instances"`
	PendingPermissions []ACPPendingPermissionInfo `json:"pending_permissions"`
}

type AgentConfig added in v0.4.0

type AgentConfig = agentpkg.Agent

type AgentRouteConfig added in v0.5.0

type AgentRouteConfig = agentroute.AgentRouteConfig

type AgentRouteView added in v0.5.0

type AgentRouteView = adminapi.AgentRouteView

type AgentView added in v0.4.0

type AgentView = adminapi.AgentView

type BuiltinInFlightTurn added in v0.5.0

type BuiltinInFlightTurn = builtinhost.InFlightTurnView

type BuiltinRuntimeView added in v0.5.0

type BuiltinRuntimeView = builtinhost.RuntimeView

type Client

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

func New

func New(cfg Config) *Client

func (*Client) BaseURL

func (c *Client) BaseURL() string

func (*Client) CallMCPServiceTool added in v0.1.0

func (c *Client) CallMCPServiceTool(ctx context.Context, id string, req MCPToolCallRequest) (*MCPToolResult, error)

func (*Client) CancelAgentRun added in v0.5.0

func (c *Client) CancelAgentRun(ctx context.Context, id, runID string, mode agentruntime.CancelMode) (json.RawMessage, error)

func (*Client) CloseACPThread added in v0.3.0

func (c *Client) CloseACPThread(ctx context.Context, agentID, threadID string) (*ACPCloseThreadResponse, error)

func (*Client) CreateAgent added in v0.4.0

func (c *Client) CreateAgent(ctx context.Context, cfg AgentConfig) (*AgentView, error)

func (*Client) CreateAgentRoute added in v0.5.0

func (c *Client) CreateAgentRoute(ctx context.Context, cfg AgentRouteConfig) (*AgentRouteView, error)

func (*Client) CreateCredential

func (c *Client) CreateCredential(ctx context.Context, req CreateCredentialRequest) (*ManagedCredential, error)

func (*Client) CreateLLMRoute added in v0.1.0

func (c *Client) CreateLLMRoute(ctx context.Context, route LLMRouteConfig) (*LLMRouteConfig, error)

func (*Client) CreateMCPRoute added in v0.1.0

func (c *Client) CreateMCPRoute(ctx context.Context, cfg MCPRouteConfig) (*MCPRouteView, error)

func (*Client) CreateMCPService added in v0.1.0

func (c *Client) CreateMCPService(ctx context.Context, cfg MCPServiceConfig) (*MCPServiceView, error)

func (*Client) CreateManagedModel

func (c *Client) CreateManagedModel(ctx context.Context, model modelcatalog.ManagedModel) (*ManagedModel, error)

func (*Client) CreateProvider

func (c *Client) CreateProvider(ctx context.Context, cfg ProviderConfig) (*Provider, error)

func (*Client) CreateVirtualKey

func (c *Client) CreateVirtualKey(ctx context.Context, key VirtualKeyConfig) (*VirtualKeyConfig, error)

func (*Client) DeleteAgent added in v0.4.0

func (c *Client) DeleteAgent(ctx context.Context, id string) (*StatusResponse, error)

func (*Client) DeleteAgentRoute added in v0.5.0

func (c *Client) DeleteAgentRoute(ctx context.Context, id string) (*StatusResponse, error)

func (*Client) DeleteCredential

func (c *Client) DeleteCredential(ctx context.Context, id string) (*StatusResponse, error)

func (*Client) DeleteLLMRoute added in v0.1.0

func (c *Client) DeleteLLMRoute(ctx context.Context, id string) (*StatusResponse, error)

func (*Client) DeleteMCPRoute added in v0.1.0

func (c *Client) DeleteMCPRoute(ctx context.Context, id string) (*StatusResponse, error)

func (*Client) DeleteMCPService added in v0.1.0

func (c *Client) DeleteMCPService(ctx context.Context, id string) (*StatusResponse, error)

func (*Client) DeleteManagedModel

func (c *Client) DeleteManagedModel(ctx context.Context, providerID, upstreamModel string) (*StatusResponse, error)

func (*Client) DeleteProvider

func (c *Client) DeleteProvider(ctx context.Context, id string) (*StatusResponse, error)

func (*Client) DeleteVirtualKey

func (c *Client) DeleteVirtualKey(ctx context.Context, id string) (*StatusResponse, error)

func (*Client) DisableLLMRoute added in v0.1.0

func (c *Client) DisableLLMRoute(ctx context.Context, id string) (*LLMRoute, error)

func (*Client) DisableProvider

func (c *Client) DisableProvider(ctx context.Context, id string) (*Provider, error)

func (*Client) DisableVirtualKey

func (c *Client) DisableVirtualKey(ctx context.Context, id string) (*VirtualKey, error)

func (*Client) EnableLLMRoute added in v0.1.0

func (c *Client) EnableLLMRoute(ctx context.Context, id string) (*LLMRoute, error)

func (*Client) EnableProvider

func (c *Client) EnableProvider(ctx context.Context, id string) (*Provider, error)

func (*Client) EnableVirtualKey

func (c *Client) EnableVirtualKey(ctx context.Context, id string) (*VirtualKey, error)

func (*Client) GetACPRuntime added in v0.3.0

func (c *Client) GetACPRuntime(ctx context.Context) (*ACPRuntimeView, error)

func (*Client) GetAgent added in v0.4.0

func (c *Client) GetAgent(ctx context.Context, id string) (*AgentView, error)

func (*Client) GetAgentActivity added in v0.4.0

func (c *Client) GetAgentActivity(ctx context.Context, id string) (json.RawMessage, error)

func (*Client) GetAgentCapabilities added in v0.5.0

func (c *Client) GetAgentCapabilities(ctx context.Context, id string) (json.RawMessage, error)

func (*Client) GetAgentHealth added in v0.4.0

func (c *Client) GetAgentHealth(ctx context.Context, id string) (json.RawMessage, error)

func (*Client) GetAgentInteractions added in v0.4.0

func (c *Client) GetAgentInteractions(ctx context.Context, id string) (json.RawMessage, error)

func (*Client) GetAgentResources added in v0.4.0

func (c *Client) GetAgentResources(ctx context.Context, id string) (json.RawMessage, error)

func (*Client) GetAgentRoute added in v0.5.0

func (c *Client) GetAgentRoute(ctx context.Context, id string) (*AgentRouteView, error)

func (*Client) GetAgentTranscript added in v0.5.0

func (c *Client) GetAgentTranscript(ctx context.Context, id, sessionID, cwd string) (json.RawMessage, error)

func (*Client) GetAgentUsage added in v0.4.0

func (c *Client) GetAgentUsage(ctx context.Context, id string) (json.RawMessage, error)

func (*Client) GetAgentWorkspace added in v0.4.0

func (c *Client) GetAgentWorkspace(ctx context.Context, id string) (json.RawMessage, error)

GetAgentWorkspace returns the raw workspace summary/index for an agent. The response is the management read model assembled by the gateway; it is decoded as a generic object because it composes references across subsystems.

func (*Client) GetBuiltinRuntime added in v0.5.0

func (c *Client) GetBuiltinRuntime(ctx context.Context) (*BuiltinRuntimeView, error)

func (*Client) GetCredential

func (c *Client) GetCredential(ctx context.Context, id string) (*Credential, error)

func (*Client) GetLLMRoute added in v0.1.0

func (c *Client) GetLLMRoute(ctx context.Context, id string) (*LLMRoute, error)

func (*Client) GetMCPRoute added in v0.1.0

func (c *Client) GetMCPRoute(ctx context.Context, id string) (*MCPRouteView, error)

func (*Client) GetMCPRuntime added in v0.1.0

func (c *Client) GetMCPRuntime(ctx context.Context) (*MCPRuntimeView, error)

func (*Client) GetMCPService added in v0.1.0

func (c *Client) GetMCPService(ctx context.Context, id string) (*MCPServiceView, error)

func (*Client) GetMCPServiceCapabilities added in v0.1.0

func (c *Client) GetMCPServiceCapabilities(ctx context.Context, id string) (*MCPServiceCapabilities, error)

func (*Client) GetMCPServicePrompt added in v0.1.0

func (c *Client) GetMCPServicePrompt(ctx context.Context, id string, req MCPPromptGetRequest) (*MCPPromptResult, error)

func (*Client) GetMCPServiceSession added in v0.1.0

func (c *Client) GetMCPServiceSession(ctx context.Context, id string) (*MCPServiceSessionView, error)

func (*Client) GetManagedModel

func (c *Client) GetManagedModel(ctx context.Context, providerID, upstreamModel string) (*ManagedModel, error)

func (*Client) GetProvider

func (c *Client) GetProvider(ctx context.Context, id string) (*Provider, error)

func (*Client) GetVirtualKey

func (c *Client) GetVirtualKey(ctx context.Context, id string) (*VirtualKey, error)

func (*Client) ListACPRuntimeInFlight added in v0.3.0

func (c *Client) ListACPRuntimeInFlight(ctx context.Context) ([]ACPInFlightTurn, error)

func (*Client) ListAgentPermissions added in v0.5.0

func (c *Client) ListAgentPermissions(ctx context.Context, id string) (json.RawMessage, error)

func (*Client) ListAgentRoutes added in v0.5.0

func (c *Client) ListAgentRoutes(ctx context.Context) ([]AgentRouteView, error)

func (*Client) ListAgentRuns added in v0.5.0

func (c *Client) ListAgentRuns(ctx context.Context, id string) (json.RawMessage, error)

func (*Client) ListAgentSessions added in v0.5.0

func (c *Client) ListAgentSessions(ctx context.Context, id, cwd, cursor string) (json.RawMessage, error)

func (*Client) ListAgents added in v0.4.0

func (c *Client) ListAgents(ctx context.Context) ([]AgentView, error)

func (*Client) ListBuiltinInFlight added in v0.5.0

func (c *Client) ListBuiltinInFlight(ctx context.Context) ([]BuiltinInFlightTurn, error)

func (*Client) ListCredentials

func (c *Client) ListCredentials(ctx context.Context, opts CredentialListOptions) ([]Credential, error)

func (*Client) ListDiscoveredModels

func (c *Client) ListDiscoveredModels(ctx context.Context, providerID string) ([]DiscoveredModel, error)

func (*Client) ListLLMAPIHandlerTypes

func (c *Client) ListLLMAPIHandlerTypes(ctx context.Context) ([]LLMAPIHandlerType, error)

func (*Client) ListLLMRoutes added in v0.1.0

func (c *Client) ListLLMRoutes(ctx context.Context, opts LLMRouteListOptions) ([]LLMRoute, error)

func (*Client) ListMCPRoutes added in v0.1.0

func (c *Client) ListMCPRoutes(ctx context.Context) ([]MCPRouteView, error)

func (*Client) ListMCPRuntimeHistory added in v0.1.0

func (c *Client) ListMCPRuntimeHistory(ctx context.Context, routeID string) ([]MCPRuntimeCompletedRequest, error)

func (*Client) ListMCPRuntimeInFlight added in v0.1.0

func (c *Client) ListMCPRuntimeInFlight(ctx context.Context) ([]MCPRuntimeInFlightRequest, error)

func (*Client) ListMCPRuntimeProgress added in v0.1.0

func (c *Client) ListMCPRuntimeProgress(ctx context.Context) ([]MCPRuntimeProgressNotification, error)

func (*Client) ListMCPServicePrompts added in v0.1.0

func (c *Client) ListMCPServicePrompts(ctx context.Context, id string) ([]MCPPrompt, error)

func (*Client) ListMCPServiceResourceTemplates added in v0.1.0

func (c *Client) ListMCPServiceResourceTemplates(ctx context.Context, id string) ([]MCPResourceTemplate, error)

func (*Client) ListMCPServiceResources added in v0.1.0

func (c *Client) ListMCPServiceResources(ctx context.Context, id string) ([]MCPResource, error)

func (*Client) ListMCPServiceTools added in v0.1.0

func (c *Client) ListMCPServiceTools(ctx context.Context, id string) ([]MCPTool, error)

func (*Client) ListMCPServices added in v0.1.0

func (c *Client) ListMCPServices(ctx context.Context) ([]MCPServiceView, error)

func (*Client) ListManagedModels

func (c *Client) ListManagedModels(ctx context.Context, opts ManagedModelListOptions) ([]ManagedModel, error)

func (*Client) ListProviderTypes

func (c *Client) ListProviderTypes(ctx context.Context) ([]ProviderType, error)

func (*Client) ListProviders

func (c *Client) ListProviders(ctx context.Context, opts ProviderListOptions) ([]Provider, error)

func (*Client) ListVirtualKeys

func (c *Client) ListVirtualKeys(ctx context.Context, opts VirtualKeyListOptions) ([]VirtualKey, error)

func (*Client) ReadMCPServiceResource added in v0.1.0

func (c *Client) ReadMCPServiceResource(ctx context.Context, id string, req MCPResourceReadRequest) (*MCPResourceReadResult, error)

func (*Client) RefreshProviderModels

func (c *Client) RefreshProviderModels(ctx context.Context, providerID string) (*RefreshDiscoveredModelsResponse, error)

func (*Client) ResolveAgentPermission added in v0.5.0

func (c *Client) ResolveAgentPermission(ctx context.Context, id, requestID string, decision agentruntime.PermissionDecision) (json.RawMessage, error)

func (*Client) UpdateAgent added in v0.4.0

func (c *Client) UpdateAgent(ctx context.Context, id string, cfg AgentConfig) (*AgentView, error)

func (*Client) UpdateAgentRoute added in v0.5.0

func (c *Client) UpdateAgentRoute(ctx context.Context, id string, cfg AgentRouteConfig) (*AgentRouteView, error)

func (*Client) UpdateCredential

func (c *Client) UpdateCredential(ctx context.Context, id string, req UpdateCredentialRequest) (*ManagedCredential, error)

func (*Client) UpdateLLMRoute added in v0.1.0

func (c *Client) UpdateLLMRoute(ctx context.Context, id string, route LLMRouteConfig) (*LLMRouteConfig, error)

func (*Client) UpdateMCPRoute added in v0.1.0

func (c *Client) UpdateMCPRoute(ctx context.Context, id string, cfg MCPRouteConfig) (*MCPRouteView, error)

func (*Client) UpdateMCPService added in v0.1.0

func (c *Client) UpdateMCPService(ctx context.Context, id string, cfg MCPServiceConfig) (*MCPServiceView, error)

func (*Client) UpdateManagedModel

func (c *Client) UpdateManagedModel(ctx context.Context, providerID, upstreamModel string, model modelcatalog.ManagedModel) (*ManagedModel, error)

func (*Client) UpdateProvider

func (c *Client) UpdateProvider(ctx context.Context, id string, cfg ProviderConfig) (*Provider, error)

func (*Client) UpdateVirtualKey

func (c *Client) UpdateVirtualKey(ctx context.Context, id string, req VirtualKeyConfig) (*VirtualKeyConfig, error)

type Config

type Config struct {
	BaseURL    string
	BasicAuth  string
	Token      string
	Headers    []string
	HTTPClient *http.Client
}

type CreateCredentialRequest

type CreateCredentialRequest struct {
	ID           string            `json:"id,omitempty"`
	Type         string            `json:"type"`
	ProviderType string            `json:"provider_type,omitempty"`
	ProviderID   string            `json:"provider_id"`
	Scope        string            `json:"scope,omitempty"`
	Label        string            `json:"label,omitempty"`
	Attributes   map[string]string `json:"attributes,omitempty"`
	Metadata     map[string]any    `json:"metadata,omitempty"`
	Disabled     bool              `json:"disabled,omitempty"`
}

type Credential

type Credential = adminapi.CredentialView

type CredentialListOptions

type CredentialListOptions struct {
	ProviderType string
	ProviderID   string
	Type         string
}

type Error

type Error struct {
	StatusCode int
	Message    string
	Body       []byte
}

func (*Error) Error

func (e *Error) Error() string

type LLMAPIHandlerType

type LLMAPIHandlerType = adminapi.LLMApiHandlerTypeView

type LLMRoute added in v0.1.0

type LLMRoute = adminapi.LLMRouteView

type LLMRouteConfig added in v0.1.0

type LLMRouteConfig = llmroutepkg.LLMRouteConfig

type LLMRouteListOptions added in v0.1.0

type LLMRouteListOptions struct {
	Tag       string
	TagPrefix string
}

type MCPPrompt added in v0.1.0

type MCPPrompt = basemcp.Prompt

type MCPPromptGetRequest added in v0.1.0

type MCPPromptGetRequest = adminapi.MCPPromptGetRequest

type MCPPromptResult added in v0.1.0

type MCPPromptResult = basemcp.PromptResult

type MCPResource added in v0.1.0

type MCPResource = basemcp.Resource

type MCPResourceReadRequest added in v0.1.0

type MCPResourceReadRequest = adminapi.MCPResourceReadRequest

type MCPResourceReadResult added in v0.1.0

type MCPResourceReadResult = basemcp.ResourceReadResult

type MCPResourceTemplate added in v0.1.0

type MCPResourceTemplate = basemcp.ResourceTemplate

type MCPRouteConfig added in v0.1.0

type MCPRouteConfig = mcproute.MCPRouteConfig

type MCPRouteView added in v0.1.0

type MCPRouteView = adminapi.MCPRouteView

type MCPRuntimeCompletedRequest added in v0.1.0

type MCPRuntimeCompletedRequest = mcpruntime.CompletedRequest

type MCPRuntimeInFlightRequest added in v0.1.0

type MCPRuntimeInFlightRequest = mcpruntime.InFlightRequest

type MCPRuntimeProgressNotification added in v0.1.0

type MCPRuntimeProgressNotification = mcpruntime.ProgressNotification

type MCPRuntimeView added in v0.1.0

type MCPRuntimeView = adminapi.MCPDispatcherRuntimeView

type MCPServiceCapabilities added in v0.1.0

type MCPServiceCapabilities = map[string]any

type MCPServiceConfig added in v0.1.0

type MCPServiceConfig = mcpservice.MCPServiceConfig

type MCPServiceSessionView added in v0.1.0

type MCPServiceSessionView = adminapi.GatewaySessionView

type MCPServiceView added in v0.1.0

type MCPServiceView = adminapi.MCPServiceView

type MCPTool added in v0.1.0

type MCPTool = basemcp.Tool

type MCPToolCallRequest added in v0.1.0

type MCPToolCallRequest = adminapi.MCPToolCallRequest

type MCPToolResult added in v0.1.0

type MCPToolResult = basemcp.ToolResult

type ManagedCredential

type ManagedCredential = credential.ManagedCredential

type ManagedModelListOptions

type ManagedModelListOptions struct {
	ProviderID string
}

type Provider

type Provider = adminapi.ProviderView

type ProviderConfig

type ProviderConfig = provider.ProviderConfig

type ProviderListOptions

type ProviderListOptions struct {
	ProviderType string
}

type ProviderType

type ProviderType = adminapi.ProviderTypeView

type RefreshDiscoveredModelsResponse

type RefreshDiscoveredModelsResponse struct {
	ProviderID string            `json:"provider_id"`
	Items      []DiscoveredModel `json:"items"`
}

type StatusResponse

type StatusResponse struct {
	Status string `json:"status"`
	ID     string `json:"id,omitempty"`
	Key    string `json:"key,omitempty"`
}

type UpdateCredentialRequest

type UpdateCredentialRequest struct {
	Type         string            `json:"type,omitempty"`
	ProviderType string            `json:"provider_type,omitempty"`
	ProviderID   string            `json:"provider_id,omitempty"`
	Scope        string            `json:"scope,omitempty"`
	Label        string            `json:"label,omitempty"`
	Attributes   map[string]string `json:"attributes,omitempty"`
	Metadata     map[string]any    `json:"metadata,omitempty"`
	Disabled     bool              `json:"disabled,omitempty"`
}

type VirtualKey

type VirtualKey = adminapi.VirtualKeyView

type VirtualKeyConfig

type VirtualKeyConfig struct {
	ID              string                              `json:"id,omitempty"`
	Tag             string                              `json:"tag,omitempty"`
	Description     string                              `json:"description,omitempty"`
	Disabled        bool                                `json:"disabled,omitempty"`
	AllowedRouteIDs []string                            `json:"allowed_route_ids,omitempty"`
	RateLimits      *virtualkeypkg.VirtualKeyRateLimits `json:"rate_limits,omitempty"`
	StatusMessage   string                              `json:"status_message,omitempty"`
	ExpiresAt       time.Time                           `json:"expires_at,omitempty"`
}

type VirtualKeyListOptions

type VirtualKeyListOptions struct {
	Tag string
}

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL