v1alpha1

type AgentOrganization struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   AgentOrganizationSpec   `json:"spec,omitempty"`
	Status AgentOrganizationStatus `json:"status,omitempty"`
}

type AgentOrganizationList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []AgentOrganization `json:"items"`
}

type AgentOrganizationSpec struct {
	spec.OrganizationSpec `json:",inline"`
}

type AgentOrganizationStatus struct {
	ObservedGeneration int64              `json:"observedGeneration,omitempty"`
	OrganizationID     string             `json:"organizationID,omitempty"`
	EffectiveRevision  string             `json:"effectiveRevision,omitempty"`
	DefaultsVersion    int                `json:"defaultsVersion,omitempty"`
	Conditions         []metav1.Condition `json:"conditions,omitempty"`
	// +optional
	Seats map[string]SeatSummary `json:"seats,omitempty"`
	// +optional
	ConnectionDetails *ConnectionDetails `json:"connectionDetails,omitempty"`
	// LastVerifiedTime is the time of the last successful synthetic verification.
	// +optional
	LastVerifiedTime *metav1.Time `json:"lastVerifiedTime,omitempty"`
}

type AgentSeat struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   AgentSeatSpec   `json:"spec,omitempty"`
	Status AgentSeatStatus `json:"status,omitempty"`
}

type AgentSeatList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []AgentSeat `json:"items"`
}

type AgentSeatSpec struct {
	OrganizationName string `json:"organizationName"`
	OrganizationID   string `json:"organizationID"`
	SeatKey          string `json:"seatKey"`
	// SeatID is the immutable durable identity of the seat.
	SeatID           string           `json:"seatID"`
	ConfigRevision   string           `json:"configRevision"`
	HarnessProfile   string           `json:"harnessProfile"`
	ExecutionProfile string           `json:"executionProfile"`
	SandboxProfile   string           `json:"sandboxProfile"`
	Workspace        WorkspaceRef     `json:"workspace"`
	Tools            []ToolCapability `json:"tools,omitempty"`
	// ManifestConfigMap holds the resolved seat manifest and instruction texts.
	ManifestConfigMap string `json:"manifestConfigMap"`
	// Retired is set when the seat is removed from the organisation. The
	// seat keeps running while the platform reports it retiring, then its
	// runtime is removed.
	// +optional
	Retired bool `json:"retired,omitempty"`
	// AdminSuspended is an infrastructure control that stops execution (§14).
	// +optional
	AdminSuspended bool `json:"adminSuspended,omitempty"`
}

type AgentSeatStatus struct {
	ObservedGeneration int64          `json:"observedGeneration,omitempty"`
	ExecutionState     ExecutionState `json:"executionState,omitempty"`
	// BackendRef identifies the backend instance (e.g. statefulset/<name>).
	BackendRef string `json:"backendRef,omitempty"`
	// LatestCheckpoint describes the latest recovery checkpoint and its guarantee.
	LatestCheckpoint string `json:"latestCheckpoint,omitempty"`
	LeaseGeneration  int64  `json:"leaseGeneration,omitempty"`
	AdoptedRevision  string `json:"adoptedRevision,omitempty"`
	// +optional
	LastActivityTime *metav1.Time       `json:"lastActivityTime,omitempty"`
	Conditions       []metav1.Condition `json:"conditions,omitempty"`
	// LastError is redacted.
	LastError string `json:"lastError,omitempty"`
	// Probe is the synthetic readiness probe of the current config revision.
	// +optional
	Probe *SeatProbeStatus `json:"probe,omitempty"`
	// RetiringUntil is the end of a retiring seat's grace period.
	// +optional
	RetiringUntil *metav1.Time `json:"retiringUntil,omitempty"`
}

type ConnectionDetails struct {
	OrganizationID  string                            `json:"organizationID,omitempty"`
	Namespace       string                            `json:"namespace,omitempty"`
	StatusEndpoint  string                            `json:"statusEndpoint,omitempty"`
	Representatives map[string]RepresentativeEndpoint `json:"representatives,omitempty"`
}

type ExecutionState string

type RepresentativeEndpoint struct {
	Seat           string `json:"seat"`
	SeatID         string `json:"seatID"`
	Connection     string `json:"connection"`
	Adapter        string `json:"adapter"`
	ExternalUserID string `json:"externalUserID"`
	Mode           string `json:"mode"`
}

type SeatProbeStatus struct {
	ID string `json:"id"`
	// Revision is the config revision the probe verified.
	Revision string `json:"revision"`
	// Nonce is the verify-request nonce the probe answered, if any.
	// +optional
	Nonce string `json:"nonce,omitempty"`
	// Status is pending, passed or failed.
	Status string `json:"status"`
	// +optional
	Detail string `json:"detail,omitempty"`
	// +optional
	StartedTime *metav1.Time `json:"startedTime,omitempty"`
	// +optional
	CompletedTime *metav1.Time `json:"completedTime,omitempty"`
}

type SeatSummary struct {
	SeatID          string         `json:"seatID"`
	State           ExecutionState `json:"state,omitempty"`
	Ready           bool           `json:"ready"`
	ConfigRevision  string         `json:"configRevision,omitempty"`
	AdoptedRevision string         `json:"adoptedRevision,omitempty"`
	Reason          string         `json:"reason,omitempty"`
}

type ToolCapability struct {
	Resource   string   `json:"resource"`
	Operations []string `json:"operations"`
	// +optional
	Targets []string `json:"targets,omitempty"`
}

type WorkspaceRef struct {
	// ClaimName is the seat's persistent workspace claim.
	ClaimName string `json:"claimName"`
	// +optional
	Shared []string `json:"shared,omitempty"`
}