types.go

package relay

// -----------------------------------------------------------------------------
// Core Identity Types
// -----------------------------------------------------------------------------

// AgentID uniquely identifies an agent in the mesh.
// Agents are the remote endpoints that provide access to resources (shells, tunnels, etc.).
type AgentID string

// ClientID uniquely identifies a connected client.
// Clients are the callers that request sessions with agents.
type ClientID string

// SessionID uniquely identifies an active session between a client and an agent.
// Sessions are multiplexed over a single agent connection.
type SessionID string

// Capability represents a specific feature or resource an agent can provide.
type Capability string

// Common capabilities for agents.
// These are the three fundamental primitives that all other features are built on.
const (
	CapabilityPTY       Capability = "pty"        // Interactive terminal
	CapabilityTCPTunnel Capability = "tunnel:tcp" // TCP port forwarding
	CapabilityUDPTunnel Capability = "tunnel:udp" // UDP port forwarding
)

// SessionType identifies the kind of session being established.
type SessionType string

// Defined session types - the three fundamental primitives.
const (
	SessionTypePTY       SessionType = "pty"        // Interactive terminal
	SessionTypeTCPTunnel SessionType = "tunnel:tcp" // TCP port forwarding
	SessionTypeUDPTunnel SessionType = "tunnel:udp" // UDP port forwarding
)