protocol

type Actor struct {
	Type      string `json:"type"`
	ID        string `json:"id"`
	Name      string `json:"name,omitempty"`
	NetworkID string `json:"network_id,omitempty"`
	FQID      string `json:"fqid,omitempty"`
}

type AgentEvent struct {
	AgentID   string  `json:"agent_id"`
	NetworkID string  `json:"network_id,omitempty"`
	FQID      string  `json:"fqid,omitempty"`
	Name      string  `json:"name,omitempty"`
	MessageID string  `json:"message_id,omitempty"`
	Reason    string  `json:"reason,omitempty"`
	Target    *Target `json:"target,omitempty"`
	Error     string  `json:"error,omitempty"`
}

type AgentPage struct {
	Agents []AgentSummary `json:"agents"`
	Page   PageInfo       `json:"page"`
}

type AgentRegistration struct {
	NetworkID     string    `json:"network_id"`
	AgentID       string    `json:"agent_id"`
	ActorUID      string    `json:"actor_uid"`
	ActorURI      string    `json:"actor_uri"`
	DisplayName   string    `json:"display_name,omitempty"`
	AgentToken    string    `json:"agent_token,omitempty"`
	CredentialKey string    `json:"-"`
	CreatedAt     time.Time `json:"created_at,omitempty"`
	UpdatedAt     time.Time `json:"updated_at,omitempty"`
}

type AgentSummary struct {
	ID        string   `json:"id"`
	Name      string   `json:"name,omitempty"`
	ActorUID  string   `json:"actor_uid,omitempty"`
	FQID      string   `json:"fqid,omitempty"`
	NetworkID string   `json:"network_id"`
	Rooms     []string `json:"rooms,omitempty"`
	Connected bool     `json:"connected"`
}

type Artifact struct {
	ID        string    `json:"id"`
	NetworkID string    `json:"network_id,omitempty"`
	FQID      string    `json:"fqid,omitempty"`
	MessageID string    `json:"message_id"`
	Target    Target    `json:"target"`
	PartIndex int       `json:"part_index"`
	Kind      string    `json:"kind"`
	MediaType string    `json:"media_type,omitempty"`
	Filename  string    `json:"filename,omitempty"`
	URL       string    `json:"url,omitempty"`
	CreatedAt time.Time `json:"created_at"`
}

type ArtifactFilter struct {
	RoomID   string
	ThreadID string
	DMID     string
}

type ArtifactPage struct {
	Artifacts []Artifact `json:"artifacts"`
	Page      PageInfo   `json:"page"`
}

type AttachmentCapabilities struct {
	Rooms     bool `json:"rooms,omitempty"`
	Threads   bool `json:"threads,omitempty"`
	DMs       bool `json:"dms,omitempty"`
	Artifacts bool `json:"artifacts,omitempty"`
}

type AttachmentFrame struct {
	Op                  string                 `json:"op"`
	Version             string                 `json:"version,omitempty"`
	HeartbeatIntervalMS int                    `json:"heartbeat_interval_ms,omitempty"`
	NetworkID           string                 `json:"network_id,omitempty"`
	Agent               *Actor                 `json:"agent,omitempty"`
	AgentID             string                 `json:"agent_id,omitempty"`
	ActorUID            string                 `json:"actor_uid,omitempty"`
	ActorURI            string                 `json:"actor_uri,omitempty"`
	AgentToken          string                 `json:"agent_token,omitempty"`
	Capabilities        AttachmentCapabilities `json:"capabilities,omitempty"`
	Cursor              string                 `json:"cursor,omitempty"`
	Event               *Event                 `json:"event,omitempty"`
	Error               string                 `json:"error,omitempty"`
}

type CreateRoomRequest struct {
	ID          string   `json:"id"`
	Name        string   `json:"name,omitempty"`
	Members     []string `json:"members,omitempty"`
	Visibility  string   `json:"visibility,omitempty"`
	WritePolicy string   `json:"write_policy,omitempty"`
}

type DirectConversation struct {
	ID             string    `json:"id"`
	NetworkID      string    `json:"network_id,omitempty"`
	FQID           string    `json:"fqid,omitempty"`
	ParticipantIDs []string  `json:"participant_ids,omitempty"`
	MessageCount   int       `json:"message_count"`
	LastMessageAt  time.Time `json:"last_message_at,omitempty"`
}

type DirectConversationPage struct {
	DMs  []DirectConversation `json:"dms"`
	Page PageInfo             `json:"page"`
}

type Event struct {
	ID        string              `json:"id"`
	Type      string              `json:"type"`
	NetworkID string              `json:"network_id"`
	Agent     *AgentEvent         `json:"agent,omitempty"`
	Message   *Message            `json:"message,omitempty"`
	Room      *Room               `json:"room,omitempty"`
	Thread    *Thread             `json:"thread,omitempty"`
	DM        *DirectConversation `json:"dm,omitempty"`
	Pairing   *Pairing            `json:"pairing,omitempty"`
	ReplayGap *ReplayGap          `json:"replay_gap,omitempty"`
	CreatedAt time.Time           `json:"created_at"`
}

type Message struct {
	ID        string        `json:"id"`
	NetworkID string        `json:"network_id"`
	Origin    MessageOrigin `json:"origin,omitempty"`
	Target    Target        `json:"target"`
	From      Actor         `json:"from"`
	Parts     []Part        `json:"parts"`
	Mentions  []string      `json:"mentions,omitempty"`
	CreatedAt time.Time     `json:"created_at"`
}

type MessageAccepted struct {
	MessageID     string `json:"message_id"`
	EventID       string `json:"event_id"`
	Accepted      bool   `json:"accepted"`
	ThreadCreated bool   `json:"thread_created"`
	DMCreated     bool   `json:"dm_created"`
}

type MessageOrigin struct {
	NetworkID string `json:"network_id"`
	MessageID string `json:"message_id"`
}

type MessagePage struct {
	Messages []Message `json:"messages"`
	Page     PageInfo  `json:"page"`
}

type Network struct {
	ID           string              `json:"id"`
	Name         string              `json:"name"`
	Version      string              `json:"version"`
	Protocols    NetworkProtocols    `json:"protocols,omitempty"`
	Capabilities NetworkCapabilities `json:"capabilities,omitempty"`
	Console      *NetworkConsole     `json:"console,omitempty"`
	Warnings     []NetworkWarning    `json:"warnings,omitempty"`
}

type NetworkCapabilities struct {
	EventStream        string `json:"event_stream,omitempty"`
	AttachmentProtocol string `json:"attachment_protocol,omitempty"`
	PublicRead         bool   `json:"public_read"`
	AgentRegistration  string `json:"agent_registration,omitempty"`
	DebugEvents        bool   `json:"debug_events,omitempty"`
	HumanIngress       bool   `json:"human_ingress"`
	DirectMessages     bool   `json:"direct_messages"`
	MessagePagination  string `json:"message_pagination,omitempty"`
	Pairings           bool   `json:"pairings"`
}

type NetworkConsole struct {
	CanSendHuman bool `json:"can_send_human"`
}

type NetworkProtocols struct {
	HTTP   []string `json:"http,omitempty"`
	Attach []string `json:"attach,omitempty"`
	Pair   []string `json:"pair,omitempty"`
}

type NetworkWarning struct {
	Severity string `json:"severity"`
	Code     string `json:"code"`
	Message  string `json:"message"`
	Action   string `json:"action,omitempty"`
	DocsURL  string `json:"docs_url,omitempty"`
}

type PageInfo struct {
	HasMore    bool   `json:"has_more"`
	NextBefore string `json:"next_before,omitempty"`
	NextAfter  string `json:"next_after,omitempty"`
}

type PageRequest struct {
	Before string `json:"before,omitempty"`
	After  string `json:"after,omitempty"`
	Limit  int    `json:"limit,omitempty"`
}

type Pairing struct {
	ID                string              `json:"id" yaml:"id"`
	RemoteNetworkID   string              `json:"remote_network_id" yaml:"remote_network_id"`
	RemoteNetworkName string              `json:"remote_network_name,omitempty" yaml:"remote_network_name,omitempty"`
	RemoteBaseURL     string              `json:"remote_base_url,omitempty" yaml:"remote_base_url,omitempty"`
	Status            string              `json:"status,omitempty" yaml:"status,omitempty"`
	Diagnostics       *PairingDiagnostics `json:"diagnostics,omitempty" yaml:"diagnostics,omitempty"`
	Token             string              `json:"token,omitempty" yaml:"token,omitempty"`
}

type PairingDiagnostics struct {
	CheckedAt       time.Time        `json:"checked_at,omitempty" yaml:"checked_at,omitempty"`
	RemoteVersion   string           `json:"remote_version,omitempty" yaml:"remote_version,omitempty"`
	RemoteNetworkID string           `json:"remote_network_id,omitempty" yaml:"remote_network_id,omitempty"`
	RemoteProtocols NetworkProtocols `json:"remote_protocols,omitempty" yaml:"remote_protocols,omitempty"`
	Reason          string           `json:"reason,omitempty" yaml:"reason,omitempty"`
	Message         string           `json:"message,omitempty" yaml:"message,omitempty"`
}

type PairingPage struct {
	Pairings []Pairing `json:"pairings"`
	Page     PageInfo  `json:"page"`
}

type Part struct {
	Kind      string         `json:"kind"`
	Text      string         `json:"text,omitempty"`
	MediaType string         `json:"media_type,omitempty"`
	URL       string         `json:"url,omitempty"`
	Filename  string         `json:"filename,omitempty"`
	Data      map[string]any `json:"data,omitempty"`
}

type RegisterAgentRequest struct {
	RequestedAgentID string `json:"requested_agent_id,omitempty"`
	Name             string `json:"name,omitempty"`
}

type RemoveResult struct {
	Removed bool   `json:"removed"`
	Kind    string `json:"kind"`
	ID      string `json:"id"`
	Mode    string `json:"mode"`
}

type ReplayGap struct {
	RequestedEventID string `json:"requested_event_id,omitempty"`
	OldestEventID    string `json:"oldest_event_id,omitempty"`
	NewestEventID    string `json:"newest_event_id,omitempty"`
}

type Room struct {
	ID          string      `json:"id"`
	NetworkID   string      `json:"network_id,omitempty"`
	FQID        string      `json:"fqid,omitempty"`
	Name        string      `json:"name"`
	Members     []string    `json:"members,omitempty"`
	Visibility  string      `json:"visibility,omitempty"`
	WritePolicy string      `json:"write_policy,omitempty"`
	Access      *RoomAccess `json:"access,omitempty"`
	CreatedAt   time.Time   `json:"created_at"`
}

type RoomAccess struct {
	CanRead  bool   `json:"can_read"`
	CanWrite bool   `json:"can_write"`
	Reason   string `json:"reason,omitempty"`
}

type RoomPage struct {
	Rooms []Room   `json:"rooms"`
	Page  PageInfo `json:"page"`
}

type SendMessageRequest struct {
	ID       string        `json:"id,omitempty"`
	Origin   MessageOrigin `json:"origin,omitempty"`
	Target   Target        `json:"target"`
	From     Actor         `json:"from"`
	Parts    []Part        `json:"parts"`
	Mentions []string      `json:"mentions,omitempty"`
}

type Target struct {
	Kind            string   `json:"kind"`
	RoomID          string   `json:"room_id,omitempty"`
	ThreadID        string   `json:"thread_id,omitempty"`
	ParentMessageID string   `json:"parent_message_id,omitempty"`
	DMID            string   `json:"dm_id,omitempty"`
	ParticipantIDs  []string `json:"participant_ids,omitempty"`
}

type Thread struct {
	ID              string    `json:"id"`
	NetworkID       string    `json:"network_id,omitempty"`
	FQID            string    `json:"fqid,omitempty"`
	RoomID          string    `json:"room_id"`
	ParentMessageID string    `json:"parent_message_id,omitempty"`
	MessageCount    int       `json:"message_count"`
	LastMessageAt   time.Time `json:"last_message_at,omitempty"`
}

type ThreadPage struct {
	Threads []Thread `json:"threads"`
	Page    PageInfo `json:"page"`
}

type UpdateRoomMembersRequest struct {
	Add    []string `json:"add,omitempty"`
	Remove []string `json:"remove,omitempty"`
}