runtimeapi

type AccessResponse struct {
	SeatID  string              `json:"seat_id"`
	SeatKey string              `json:"seat_key"`
	Egress  []access.EgressRule `json:"egress"`
	// Browser is true while the seat may use its browser.
	Browser bool `json:"browser"`
	// BrowserSession is the browser_session connection to load, if any.
	BrowserSession string `json:"browser_session,omitempty"`
	// GitHub lists the seat's github connections with sandbox delivery.
	GitHub []GitHubSandbox `json:"github,omitempty"`
}

type Bootstrap struct {
	Self Self `json:"self"`
	// Instructions is the rendered, ordered instruction text.
	Instructions string `json:"instructions"`
	// Guidance is platform guidance on memory retrieval and progress keeping.
	Guidance string   `json:"guidance"`
	Recovery Recovery `json:"recovery"`
}

type CheckResult struct {
	OK     bool   `json:"ok"`
	Detail string `json:"detail,omitempty"`
}

type Checkpoint struct {
	HarnessAdapter string `json:"harness_adapter"`
	FormatVersion  string `json:"format_version"`
	CheckpointRef  string `json:"checkpoint_ref"`
	// Guarantee is application_checkpoint or process_snapshot (§6.4).
	Guarantee string `json:"guarantee"`
}

type ConnectionInfo struct {
	Key        string   `json:"key"`
	Adapter    string   `json:"adapter"`
	Operations []string `json:"operations"`
}

type ConsoleActivity struct {
	Items []ConsoleActivityItem `json:"items"`
}

type ConsoleActivityItem struct {
	// Key identifies the item for de-duplication across overlapping polls.
	Key            string    `json:"key"`
	Kind           string    `json:"kind"`
	At             time.Time `json:"at"`
	SeatKey        string    `json:"seat_key,omitempty"`
	PeerSeat       string    `json:"peer_seat,omitempty"`
	Peer           string    `json:"peer,omitempty"` // binding or connection for non-seat peers
	ExecutionID    string    `json:"execution_id,omitempty"`
	MessageID      string    `json:"message_id,omitempty"`
	ConversationID string    `json:"conversation_id,omitempty"`
	Status         string    `json:"status,omitempty"`
	Summary        string    `json:"summary"`
}

type ConsoleArtifact struct {
	ID            string    `json:"id"`
	OwnerSeat     string    `json:"owner_seat,omitempty"`
	Store         string    `json:"store,omitempty"`
	Location      string    `json:"location"`
	ContentDigest string    `json:"content_digest"`
	SizeBytes     int64     `json:"size_bytes"`
	CreatedAt     time.Time `json:"created_at"`
}

type ConsoleArtifactList struct {
	Artifacts []ConsoleArtifact `json:"artifacts"`
}

type ConsoleCapability struct {
	Resource   string   `json:"resource"`
	Operations []string `json:"operations"`
	Sources    []string `json:"sources,omitempty"`
}

type ConsoleChannelBinding struct {
	Key        string `json:"key"`
	Connection string `json:"connection"`
	Seat       string `json:"seat"`
}

type ConsoleCheck struct {
	OK        bool      `json:"ok"`
	Detail    string    `json:"detail,omitempty"`
	CheckedAt time.Time `json:"checked_at"`
	// Credential is the credential refresh state at the last check.
	Credential CredentialStatus `json:"credential"`
}

type ConsoleConnection struct {
	Key        string        `json:"key"`
	Adapter    string        `json:"adapter"`
	Required   bool          `json:"required"`
	SecretKind string        `json:"secret_kind,omitempty"`
	SecretPath string        `json:"secret_path,omitempty"`
	Check      *ConsoleCheck `json:"check,omitempty"`
}

type ConsoleConversation struct {
	ID           string    `json:"id"`
	Kind         string    `json:"kind"`
	Binding      string    `json:"binding,omitempty"`
	Participants []string  `json:"participants"`
	Messages     int       `json:"messages"`
	CreatedAt    time.Time `json:"created_at"`
	LastAt       time.Time `json:"last_message_at"`
}

type ConsoleConversationDetail struct {
	Conversation ConsoleConversation `json:"conversation"`
	Messages     []ConsoleMessage    `json:"messages"`
}

type ConsoleConversationList struct {
	Conversations []ConsoleConversation `json:"conversations"`
}

type ConsoleDelivery struct {
	SeatKey     string `json:"seat_key"`
	State       string `json:"state"` // pending, leased, done, dead
	Attempts    int    `json:"attempts"`
	ExecutionID string `json:"execution_id,omitempty"`
	LastError   string `json:"last_error,omitempty"`
}

type ConsoleEvent struct {
	ID            int64           `json:"id"`
	Kind          string          `json:"kind"`
	CorrelationID string          `json:"correlation_id,omitempty"`
	Data          json.RawMessage `json:"data,omitempty"`
	CreatedAt     time.Time       `json:"created_at"`
}

type ConsoleExecution struct {
	ID               string     `json:"id"`
	SeatID           string     `json:"seat_id"`
	SeatKey          string     `json:"seat_key"`
	LeaseGeneration  int64      `json:"lease_generation"`
	ConfigRevision   string     `json:"config_revision"`
	HarnessAdapter   string     `json:"harness_adapter"`
	TriggerMessageID string     `json:"trigger_message_id,omitempty"`
	TriggerSummary   string     `json:"trigger_summary,omitempty"`
	TriggerOrigin    string     `json:"trigger_origin,omitempty"`
	State            string     `json:"state"`
	Error            string     `json:"error,omitempty"`
	StartedAt        time.Time  `json:"started_at"`
	FinishedAt       *time.Time `json:"finished_at,omitempty"`
	Events           int        `json:"events"`
}

type ConsoleExecutionDetail struct {
	Execution  ConsoleExecution   `json:"execution"`
	Trigger    *ConsoleMessage    `json:"trigger,omitempty"`
	Events     []ConsoleEvent     `json:"events"`
	Operations []ConsoleOperation `json:"operations"`
	Sent       []ConsoleMessage   `json:"sent"`
}

type ConsoleExecutionList struct {
	Executions []ConsoleExecution `json:"executions"`
}

type ConsoleMemoryStore struct {
	Key           string     `json:"key"`
	Personal      bool       `json:"personal"`
	Records       int        `json:"records"`
	LastUpdatedAt *time.Time `json:"last_updated_at,omitempty"`
}

type ConsoleMessage struct {
	ID               string            `json:"id"`
	ConversationID   string            `json:"conversation_id"`
	ConversationKind string            `json:"conversation_kind"`
	Origin           string            `json:"origin"`
	SenderSeat       string            `json:"sender_seat,omitempty"`
	RecipientSeat    string            `json:"recipient_seat,omitempty"`
	RecipientBinding string            `json:"recipient_binding,omitempty"`
	Route            string            `json:"route,omitempty"`
	ParentID         string            `json:"parent_id,omitempty"`
	CorrelationID    string            `json:"correlation_id,omitempty"`
	Body             string            `json:"body"`
	CreatedAt        time.Time         `json:"created_at"`
	Deliveries       []ConsoleDelivery `json:"deliveries,omitempty"`
	// Outbox is the external delivery state of a reply to a human.
	Outbox string `json:"outbox,omitempty"`
}

type ConsoleOperation struct {
	Operation
	SeatKey     string    `json:"seat_key,omitempty"`
	ExecutionID string    `json:"execution_id,omitempty"`
	Attempts    int       `json:"attempts"`
	UpdatedAt   time.Time `json:"updated_at"`
}

type ConsoleOperationList struct {
	Operations []ConsoleOperation `json:"operations"`
}

type ConsoleOrganization struct {
	ID          string                  `json:"id"`
	Key         string                  `json:"key"`
	Namespace   string                  `json:"namespace"`
	DisplayName string                  `json:"display_name"`
	Revision    string                  `json:"revision"`
	Teams       []string                `json:"teams"`
	Seats       []ConsoleSeatConfig     `json:"seats"`
	Connections []ConsoleConnection     `json:"connections"`
	Bindings    []ConsoleChannelBinding `json:"channel_bindings,omitempty"`
}

type ConsoleSeatConfig struct {
	SeatID              string              `json:"seat_id"`
	OrganizationID      string              `json:"organization_id"`
	Key                 string              `json:"key"`
	DisplayName         string              `json:"display_name"`
	RoleRef             string              `json:"role_ref"`
	Teams               []string            `json:"teams,omitempty"`
	IsRepresentative    bool                `json:"is_representative"`
	HarnessAdapter      string              `json:"harness_adapter"`
	Model               string              `json:"model,omitempty"`
	ConfigRevision      string              `json:"config_revision"`
	PolicyRevision      int64               `json:"policy_revision"`
	PersistentWorkspace bool                `json:"persistent_workspace"`
	SharedWorkspaces    []string            `json:"shared_workspaces,omitempty"`
	PersonalMemory      string              `json:"personal_memory,omitempty"`
	SendTo              []string            `json:"send_to,omitempty"`
	ChannelBindings     []string            `json:"channel_bindings,omitempty"`
	Capabilities        []ConsoleCapability `json:"capabilities,omitempty"`
	CreatedAt           time.Time           `json:"created_at"`
	AdoptedFrom         string              `json:"adopted_from,omitempty"`
	// RetiredAt is set for a retired seat, whose history stays readable.
	RetiredAt *time.Time `json:"retired_at,omitempty"`
}

type ConsoleSeatDetail struct {
	Config     ConsoleSeatConfig    `json:"config"`
	Status     ConsoleSeatStatus    `json:"status"`
	Handoff    *Handoff             `json:"handoff,omitempty"`
	Checkpoint *Checkpoint          `json:"checkpoint,omitempty"`
	Memory     []ConsoleMemoryStore `json:"memory,omitempty"`
	Executions []ConsoleExecution   `json:"executions"`
}

type ConsoleSeatList struct {
	Seats []ConsoleSeatStatus `json:"seats"`
}

type ConsoleSeatStatus struct {
	SeatRuntime
	// Current is the running execution, if any.
	Current *ConsoleExecution `json:"current,omitempty"`
	// LastProgressAt is the time of the seat's latest tool result or output,
	// as distinct from lease liveness.
	LastProgressAt *time.Time `json:"last_progress_at,omitempty"`
	// Unknown counts the seat's connector operations with unknown outcome.
	UnknownOperations int `json:"unknown_operations"`
}

type ConsoleWorkItem struct {
	RecordID     string                   `json:"record_id"`
	Store        string                   `json:"store"`
	Revision     int                      `json:"revision"`
	ID           string                   `json:"id"`
	Objective    string                   `json:"objective"`
	Creator      string                   `json:"creator"`
	Owner        string                   `json:"owner,omitempty"`
	Status       string                   `json:"status"`
	Blocker      string                   `json:"blocker,omitempty"`
	Plan         []ConsoleWorkStep        `json:"plan,omitempty"`
	DependsOn    []string                 `json:"depends_on,omitempty"`
	Acceptance   []string                 `json:"acceptance,omitempty"`
	Evidence     []string                 `json:"evidence,omitempty"`
	Links        []string                 `json:"links,omitempty"`
	UpdatedAt    time.Time                `json:"updated_at"`
	Publications []ConsoleWorkPublication `json:"publications,omitempty"`
}

type ConsoleWorkList struct {
	Work []ConsoleWorkItem `json:"work"`
}

type ConsoleWorkPublication struct {
	Connection        string `json:"connection"`
	State             string `json:"state"`
	ExternalID        string `json:"external_id,omitempty"`
	ExternalURL       string `json:"external_url,omitempty"`
	PublishedRevision int    `json:"published_revision"`
	LastError         string `json:"last_error,omitempty"`
}

type ConsoleWorkStep struct {
	Step   string `json:"step"`
	Status string `json:"status"`
}

type CredentialResponse struct {
	Connection string `json:"connection"`
	// Username for git (x-access-token for GitHub).
	Username string `json:"username"`
	Token    string `json:"token"`
	// ExpiresAt is zero for credentials that do not expire (a PAT).
	ExpiresAt time.Time `json:"expires_at,omitzero"`
	// Revocable reports whether Steadmesh can invalidate the credential.
	Revocable bool `json:"revocable"`
	// Data carries non-token credentials, e.g. a browser storage state.
	Data json.RawMessage `json:"data,omitempty"`
}

type CredentialStatus struct {
	State string `json:"state"`
	// SecretVersion is the store's version of the secret in use
	// (Kubernetes resourceVersion or Vault KV version).
	SecretVersion string     `json:"secret_version,omitempty"`
	RefreshedAt   *time.Time `json:"refreshed_at,omitempty"`
	// Error explains a degraded or unavailable state.
	Error string `json:"error,omitempty"`
	// PreviousUntil is when a previous credential stops being used.
	PreviousUntil *time.Time `json:"previous_until,omitempty"`
	// FailingSince is when refresh started failing.
	FailingSince *time.Time `json:"failing_since,omitempty"`
}

type Envelope struct {
	MessageID      string `json:"message_id"`
	OrganizationID string `json:"organization_id"`
	ConversationID string `json:"conversation_id"`
	Origin         string `json:"origin"` // human, seat, system, schedule, probe
	// For human origin: the binding key and verified external user.
	Binding        string    `json:"binding,omitempty"`
	ExternalUserID string    `json:"external_user_id,omitempty"`
	SenderSeat     string    `json:"sender_seat,omitempty"`
	SenderSeatID   string    `json:"sender_seat_id,omitempty"`
	RecipientSeat  string    `json:"recipient_seat"`
	ParentID       string    `json:"parent_id,omitempty"`
	CorrelationID  string    `json:"correlation_id,omitempty"`
	Body           string    `json:"body"`
	CreatedAt      time.Time `json:"created_at"`
	// ReplyRoute describes how to reply: "binding:<key>" or "seat:<key>".
	ReplyRoute string `json:"reply_route,omitempty"`
}

type Error struct {
	Code    string `json:"code"` // unauthenticated, forbidden, fenced, conflict, not_found, invalid, blocked, unavailable
	Message string `json:"message"`
}

type ExecutionEvent struct {
	Kind          string          `json:"kind"` // progress, tool_request, tool_result, output, completion, error
	CorrelationID string          `json:"correlation_id,omitempty"`
	Data          json.RawMessage `json:"data,omitempty"`
	Time          time.Time       `json:"time"`
}

type FenceRequest struct {
	// ExpectedGeneration must match the current generation; the platform then
	// increments it so the previous holder's calls are rejected.
	ExpectedGeneration int64 `json:"expected_generation"`
}

type GitHubSandbox struct {
	Connection string `json:"connection"`
	// Host is the git host the credential is for.
	Host string `json:"host"`
}

type Handoff struct {
	Objective         string   `json:"objective"`
	Unresolved        []string `json:"unresolved,omitempty"`
	RecordIDs         []string `json:"record_ids,omitempty"`
	PendingMessageIDs []string `json:"pending_message_ids,omitempty"`
	OperationIDs      []string `json:"operation_ids,omitempty"`
	Notes             string   `json:"notes,omitempty"`
}

type InboxAckRequest struct {
	ExecutionID string `json:"execution_id"`
	Outcome     string `json:"outcome"` // completed, failed
	Error       string `json:"error,omitempty"`
}

type InboxDelivery struct {
	DeliveryID  int64    `json:"delivery_id"`
	ExecutionID string   `json:"execution_id"`
	Attempt     int      `json:"attempt"`
	Message     Envelope `json:"message"`
	// Passive are messages sent with wake=false that were waiting for this
	// seat's next turn. They are delivered with this turn and need no ack.
	Passive []Envelope `json:"passive,omitempty"`
}

type InstructionInfo struct {
	Ref   string `json:"ref"`
	Scope string `json:"scope"`
	Order int    `json:"order"`
}

type LeaseAcquireRequest struct {
	// Holder is informational; the platform records the Pod UID from the token.
	Holder string `json:"holder,omitempty"`
}

type LeaseRenewRequest struct {
	Generation int64 `json:"generation"`
}

type LeaseResponse struct {
	SeatID     string    `json:"seat_id"`
	Generation int64     `json:"generation"`
	ExpiresAt  time.Time `json:"expires_at"`
	// TTL is how long the lease lasts without renewal.
	TTLSeconds int `json:"ttl_seconds"`
}

type MemoryStoreInfo struct {
	Key        string   `json:"key"`
	Personal   bool     `json:"personal"`
	Operations []string `json:"operations"`
}

type ModelRequest struct {
	Connection   string `json:"connection"`
	API          string `json:"api"`
	Model        string `json:"model,omitempty"`
	UpstreamHost string `json:"upstream_host"`
	Status       int    `json:"status"`
	Stream       bool   `json:"stream,omitempty"`
	DurationMS   int64  `json:"duration_ms"`
	// Usage is the token usage the endpoint reported, when it did.
	Usage map[string]int64 `json:"usage,omitempty"`
	// Rejected is why the platform refused the request before sending it.
	Rejected string `json:"rejected,omitempty"`
	// CredentialRefreshed is true when the request was retried after the
	// connection's credential was refreshed.
	CredentialRefreshed bool `json:"credential_refreshed,omitempty"`
}

type Operation struct {
	ID              string          `json:"id"`
	Connection      string          `json:"connection"`
	Operation       string          `json:"operation"`
	Target          string          `json:"target,omitempty"`
	IdempotencyKey  string          `json:"idempotency_key"`
	Status          string          `json:"status"` // pending, succeeded, failed, unknown
	ExternalReceipt string          `json:"external_receipt,omitempty"`
	Result          json.RawMessage `json:"result,omitempty"`
	Error           string          `json:"error,omitempty"`
	CreatedAt       time.Time       `json:"created_at"`
}

type ProbeResponse struct {
	ProbeID string `json:"probe_id"`
	// Status is pending, passed or failed.
	Status string            `json:"status"`
	Checks map[string]string `json:"checks,omitempty"`
	Error  string            `json:"error,omitempty"`
}

type ProbeResult struct {
	OK     bool              `json:"ok"`
	Checks map[string]string `json:"checks"`
}

type RecipientInfo struct {
	Seat        string `json:"seat"`
	DisplayName string `json:"display_name"`
	CanReply    bool   `json:"can_reply"`
}

type Recovery struct {
	// Session is the harness checkpoint, if any.
	Session *Checkpoint `json:"session,omitempty"`
	Handoff *Handoff    `json:"handoff,omitempty"`
	// PendingMessages is the number of undelivered inbox messages.
	PendingMessages int `json:"pending_messages"`
	// UnknownOperations are external operations whose outcome is unknown and
	// must be reconciled by the agent before being reissued (§6.3).
	UnknownOperations []Operation `json:"unknown_operations,omitempty"`
	// Work lists the unfinished work items this seat owns, so it can pick
	// them up again after a restart.
	Work []WorkSummary `json:"work,omitempty"`
	// Note explains the recovery state, e.g. "native session not convertible;
	// resumed from portable handoff" (§6.4).
	Note string `json:"note,omitempty"`
}

type RetiringSeat struct {
	SeatID   string    `json:"seat_id"`
	RetireBy time.Time `json:"retire_by"`
}

type RuntimeResponse struct {
	Seats map[string]SeatRuntime `json:"seats"`
}

type SeatIdentity struct {
	SeatID         string `json:"seat_id"`
	ServiceAccount string `json:"service_account"`
	PolicyRevision int64  `json:"policy_revision"`
}

type SeatRuntime struct {
	SeatID            string     `json:"seat_id"`
	SeatKey           string     `json:"seat_key"`
	PendingDeliveries int        `json:"pending_deliveries"`
	OldestPendingAge  float64    `json:"oldest_pending_age_seconds"`
	LeaseGeneration   int64      `json:"lease_generation"`
	LeaseHolder       string     `json:"lease_holder,omitempty"`
	LeaseExpiresAt    time.Time  `json:"lease_expires_at"`
	State             string     `json:"state"`
	StateDetail       string     `json:"state_detail,omitempty"`
	AdoptedRevision   string     `json:"adopted_revision,omitempty"`
	LastActivity      *time.Time `json:"last_activity,omitempty"`
	LatestCheckpoint  string     `json:"latest_checkpoint,omitempty"`
	DeadDeliveries    int        `json:"dead_deliveries"`
	// RetireBy is set while the seat is retiring: removed from the
	// declaration and winding down until then.
	RetireBy *time.Time `json:"retire_by,omitempty"`
}

type Self struct {
	OrganizationID   string            `json:"organization_id"`
	OrganizationKey  string            `json:"organization_key"`
	OrganizationName string            `json:"organization_name"`
	SeatID           string            `json:"seat_id"`
	SeatKey          string            `json:"seat_key"`
	DisplayName      string            `json:"display_name"`
	Teams            []string          `json:"teams,omitempty"`
	IsRepresentative bool              `json:"is_representative"`
	ConfigRevision   string            `json:"config_revision"`
	PolicyRevision   int64             `json:"policy_revision"`
	Instructions     []InstructionInfo `json:"instructions"`
	MemoryStores     []MemoryStoreInfo `json:"memory_stores"`
	Recipients       []RecipientInfo   `json:"recipients"`
	Connections      []ConnectionInfo  `json:"connections"`
	ChannelBindings  []string          `json:"channel_bindings,omitempty"`
	// RetiringUntil is set while the seat is retiring: it was removed from
	// the declaration, takes no new messages and stops at this time.
	RetiringUntil *time.Time `json:"retiring_until,omitempty"`
}

type StateRequest struct {
	Generation int64  `json:"generation"`
	State      string `json:"state"` // Warm, Executing, Quiescing, Stopped
	Detail     string `json:"detail,omitempty"`
	// AdoptedRevision is the config revision the runner is executing with.
	AdoptedRevision string `json:"adopted_revision,omitempty"`
}

type SyncRequest struct {
	Namespace string `json:"namespace"`
	Key       string `json:"key"`
	SourceUID string `json:"source_uid"`
	// Manifest is a compile.Manifest serialised as JSON.
	Manifest json.RawMessage `json:"manifest"`
}

type SyncResponse struct {
	OrganizationID string                  `json:"organization_id"`
	Seats          map[string]SeatIdentity `json:"seats"`
	// Retiring lists seats removed from the declaration that are winding
	// down: they take no new messages, get one retirement notice turn and
	// are retired at RetireBy at the latest.
	Retiring map[string]RetiringSeat `json:"retiring,omitempty"`
}

type ToolCallRequest struct {
	Arguments json.RawMessage `json:"arguments"`
}

type ToolCallResult struct {
	// Content is the bounded JSON result.
	Content json.RawMessage `json:"content"`
	// IsError marks a tool-level failure the agent should see (denied,
	// conflict, invalid). Transport errors use HTTP status codes instead.
	IsError bool `json:"is_error,omitempty"`
}

type ToolDescriptor struct {
	Name        string          `json:"name"` // dotted, e.g. memory.search
	Description string          `json:"description"`
	InputSchema json.RawMessage `json:"input_schema"`
}

type ToolList struct {
	Tools []ToolDescriptor `json:"tools"`
}

type VerifyResponse struct {
	Connections map[string]CheckResult `json:"connections"`
	Ingress     map[string]CheckResult `json:"ingress"`
	Bindings    map[string]CheckResult `json:"bindings"`
	// Credentials reports the refresh state of each connection's secret.
	Credentials map[string]CredentialStatus `json:"credentials,omitempty"`
}

type WorkSummary struct {
	WorkID      string `json:"work_id"`
	Objective   string `json:"objective"`
	Status      string `json:"status"`
	Revision    int    `json:"revision"`
	CurrentStep string `json:"current_step,omitempty"`
	LastNote    string `json:"last_note,omitempty"`
}