approster

package

v0.10.0 Latest Latest Go to latest Published: Aug 22, 2026 License: MIT Imports: 8 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/hadron-memory/hadron-cli

Links

Open Source Insights

Documentation ¶

Overview ¶

Package approster holds the App-agents read — the AppAgent join (cor:dmo:050:03) that answers "which Agents are installed in this App?".

Under the Worker model (#428, cor:agt:020:01) this is the INSTALL roster: the agents available to cast. The App's STAFF — its named workers — is `hadron team worker list`, which reads the Workers query. `hadron app agent list` is this read's command surface; the former second surface, `hadron team roster`, retired with the persona model (#407/#428).

The DTO is an explicit struct, never a genqlient type, so regeneration cannot move it (it is the one DTO shared across command packages, and deliberately so).

Index ¶

func Render(w io.Writer, r *Result) error
type MemberDTO
type Result
- func Fetch(ctx context.Context, client graphql.Client, appRef string) (*Result, error)

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func Render ¶

func Render(w io.Writer, r *Result) error

Render writes the human table. The ROLE column stays even for an App with no dressed agents: a blank column is the honest answer for a plain single-agent App.

Types ¶

type MemberDTO ¶

type MemberDTO struct {
	ID             string  `json:"id"`
	URN            string  `json:"urn"`
	AgentName      string  `json:"agentName"`
	PersonaRole    *string `json:"personaRole"`
	Description    *string `json:"description"`
	OrganizationID *string `json:"organizationId"`
	CreatedAt      string  `json:"createdAt"`
}

MemberDTO is the stable --json shape of one installed Agent. `personaRole` is the agent's persona DRESSING (null for an undressed agent — a Team Agent, or any agent in a non-team App); named identities are Workers and deliberately not part of this read.

type Result ¶

type Result struct {
	AppName string
	AppURN  string
	Members []MemberDTO
}

Result is one App plus its installed agents.

func Fetch ¶

func Fetch(ctx context.Context, client graphql.Client, appRef string) (*Result, error)

Fetch reads the AppAgent join for one App. No paging: App.agents is the 023-app-shape convenience over App.appAgents, and an App's installed set is small and bounded — unlike agents().

Source Files ¶

View all Source files

approster.go

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