runtimeapi

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"`
}

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"`
}

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 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 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"`
}

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 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"`
	// Note explains the recovery state, e.g. "native session not convertible;
	// resumed from portable handoff" (§6.4).
	Note string `json:"note,omitempty"`
}

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"`
}

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"`
}

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"`
	// Retired lists seat keys retired by this sync.
	Retired []string `json:"retired,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"`
}