approster

package

v0.37.0 Latest Latest Go to latest Published: Nov 5, 2026 License: MIT Imports: 9 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 ImporterDTO
type MemberDTO
type Result
- func Fetch(ctx context.Context, client graphql.Client, appRef string) (*Result, error)
- func FetchInstallations(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 ImporterDTO ¶ added in v0.37.0

type ImporterDTO struct {
	ID   string `json:"id"`
	URN  string `json:"urn"`
	Name string `json:"name"`
}

ImporterDTO identifies the installed Agent supplying a derived installation.

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"`
	// The install's boot-prompt pointer (cli#916 C2, AppAgent.bootPromptRef),
	// joined by agent id. NOT omitempty: both null means unset, withheld, or
	// no readable join row for this Agent.
	BootPromptRef           *string `json:"bootPromptRef"`
	BootPromptTargetDeleted *bool   `json:"bootPromptTargetDeleted"`
	// Explicit nulls preserve the server's whole-App visibility decision.
	InstallMethod *string      `json:"installMethod"`
	Importer      *ImporterDTO `json:"importer"`
}

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().

func FetchInstallations ¶ added in v0.37.0

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

FetchInstallations adds provenance only for the App listing. The role-warning consumer of Fetch keeps its original operation and provider requirements.

Source Files ¶

View all Source files

approster.go

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