compile

type BackendInfo struct {
	Features []string
}

type Capability struct {
	Resource   string   `json:"resource"` // memory:<k>, connection:<k>, workspace:<k>
	Operations []string `json:"operations"`
	Targets    []string `json:"targets,omitempty"`
	Sources    []string `json:"sources"` // grant:<k>, implicit:personal_memory, team:<k>/shared_memory, ...
}

type Catalog struct {
	Harnesses    map[string]HarnessInfo
	Backends     map[string]BackendInfo
	Connectors   map[string]ConnectorInfo
	IdlePolicies map[string]string // idle policy -> required backend feature
}

type ConnectorInfo struct {
	// Operations a grant may name on a connection of this adapter.
	Operations []string
	// Kind is communication, tracker or model.
	Kind string
	// ManagedOwnership means the adapter can create and own external resources.
	ManagedOwnership bool
	// ModelAPIs are the APIs a model connection serves when it declares
	// none. Empty for a model adapter means the connection must declare them.
	ModelAPIs []string
	// DefaultAuth is how a model connection sends its credential by default.
	DefaultAuth string
}

type Errors []FieldError

type FieldError struct {
	Path    string `json:"path"`
	Message string `json:"message"`
}

type HarnessInfo struct {
	Capabilities []string
	// NeedsModel means the harness requires a model.
	NeedsModel bool
	// APIs are the model APIs the harness speaks, in order of preference.
	APIs []string
	// Settings are the model.settings keys the harness accepts.
	Settings map[string]harnesses.Setting
}

type InstructionSource struct {
	Ref   string `json:"ref"`
	Scope string `json:"scope"` // organisation, team:<key>, role, seat
	Order int    `json:"order"`
}

type Manifest struct {
	SchemaVersion   string                  `json:"schema_version"`
	DefaultsVersion int                     `json:"defaults_version"`
	Spec            spec.OrganizationSpec   `json:"spec"`
	Seats           map[string]SeatManifest `json:"seats"`
	// TemplateLineage maps team key to the template chain it was resolved from, base first.
	TemplateLineage map[string][]string `json:"template_lineage,omitempty"`
	Digest          string              `json:"digest"`
}

type ModelUse struct {
	ID  string
	API string
}

type RouteEdge struct {
	Seat   string   `json:"seat"`
	Reply  bool     `json:"reply"`
	Routes []string `json:"routes"`
}

type SeatManifest struct {
	// PoolTeam is runtime provenance, never a declarative seat membership field.
	PoolTeam         string                `json:"pool_team,omitempty"`
	Key              string                `json:"key"`
	DisplayName      string                `json:"display_name"`
	RoleRef          string                `json:"role_ref"`
	Teams            []string              `json:"teams,omitempty"`
	HarnessProfile   string                `json:"harness_profile"`
	ExecutionProfile string                `json:"execution_profile"`
	SandboxProfile   string                `json:"sandbox_profile"`
	Harness          spec.HarnessProfile   `json:"harness"`
	Execution        spec.ExecutionProfile `json:"execution"`
	Sandbox          spec.SandboxProfile   `json:"sandbox"`
	PersonalMemory   string                `json:"personal_memory,omitempty"`
	Workspace        spec.WorkspaceBinding `json:"workspace"`
	Instructions     []InstructionSource   `json:"instructions"`
	Capabilities     []Capability          `json:"capabilities"`
	SendTo           []RouteEdge           `json:"send_to,omitempty"`
	ReceiveFrom      []RouteEdge           `json:"receive_from,omitempty"`
	ChannelBindings  []string              `json:"channel_bindings,omitempty"`
	AdoptFrom        string                `json:"adopt_from,omitempty"`
	IsRepresentative bool                  `json:"is_representative"`
	// Timezone is where the seat reads and schedules times of day: its
	// human's for a representative, otherwise the organisation's.
	Timezone string            `json:"timezone"`
	Context  *spec.TeamContext `json:"context,omitempty"`
	// Access is what the seat may do from its sandbox (access profiles).
	Access         *access.SeatAccess `json:"access,omitempty"`
	ConfigRevision string             `json:"config_revision"`
}