agent

type AgentAttachPayload struct {
	// Workspace namespace
	Namespace string
	// Workspace name
	Name string
	// Viewer-chosen participant label, echoed in session records. Not an
	// authorization boundary
	Participant *string
}

type AgentRelease struct {
	// Whether the session is gone (unknown ids report ok: best-effort release)
	OK bool
}

type AgentRenew struct {
	// Renewed lifetime in milliseconds
	TTLMs int
	// Agent ticket/API revision
	Protocol int
}

type AgentStatus struct {
	// Whether at least one live agent session is bound to this workspace
	Active bool
	// Live (unexpired) session count for this workspace
	Sessions int
	// Agent ticket/API revision
	Protocol int
}

type AgentTicket struct {
	// Opaque server-side session identifier for renew/release correlation. Never
	// sent to the guest
	ID string
	// Signed bearer ticket (id.payload.signature) to present in the agent attach
	// message
	Ticket string
	// Ticket/session lifetime in milliseconds; renew at half of it
	TTLMs int
	// Agent ticket/API revision
	Protocol int
}

type Client struct {
	AttachEndpoint  goa.Endpoint
	RenewEndpoint   goa.Endpoint
	StatusEndpoint  goa.Endpoint
	ReleaseEndpoint goa.Endpoint
}

type Endpoints struct {
	Attach  goa.Endpoint
	Renew   goa.Endpoint
	Status  goa.Endpoint
	Release goa.Endpoint
}

type Forbidden string

type Invalid string

type NotFound string

type ReleasePayload struct {
	// Workspace namespace
	Namespace string
	// Workspace name
	Name string
	// Server-side session identifier from attach
	SessionID string
}

type RenewPayload struct {
	// Workspace namespace
	Namespace string
	// Workspace name
	Name string
	// Server-side session identifier from attach
	SessionID string
}

type Service interface {
	// Attach a controller to a workspace's guest agent session, minting a
	// short-lived ticket
	Attach(context.Context, *AgentAttachPayload) (res *AgentTicket, err error)
	// Renew a workspace guest agent session by its server-side id
	// (X-KW-Agent-Session header)
	Renew(context.Context, *RenewPayload) (res *AgentRenew, err error)
	// Report live agent session state for a workspace
	Status(context.Context, *StatusPayload) (res *AgentStatus, err error)
	// Release a workspace guest agent session by its server-side id (best-effort;
	// unknown ids report ok)
	Release(context.Context, *ReleasePayload) (res *AgentRelease, err error)
}

type StatusPayload struct {
	// Workspace namespace
	Namespace string
	// Workspace name
	Name string
}

type Unauthorized string