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 ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
Types ¶
type ImporterDTO ¶ added in v0.37.0
ImporterDTO identifies the installed Agent supplying a derived installation.
type MemberDTO ¶
type MemberDTO struct {
bootpreview.Fields
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"`
// contains filtered or unexported fields
}
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
// Withheld is independent of the known installation count.
Withheld bool
Installed *int
Hidden int
}
Result is one App plus its installed agents.
func Fetch ¶
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 FetchEffective ¶ added in v0.40.0
FetchEffective opts only the listing into next-bind projection. The legacy operation is issued at most once, only for the exact initial missing-field validation refusal from the old provider.
func FetchInstallations ¶ added in v0.37.0
FetchInstallations adds provenance only for the App listing. The role-warning consumer of Fetch keeps its original operation and provider requirements.
Source Files