api

type AgentInfo struct {
	ID        string `json:"id"`
	Name      string `json:"name"`
	Color     string `json:"color"`
	Spawnable bool   `json:"spawnable"`
}

type AgentsListParams struct {
	NodeID string `json:"node_id,omitempty"` // gateway routing key; empty = sole node
}

type AgentsListResult struct {
	Agents []AgentInfo `json:"agents"`
}

type CaptureResult struct {
	Screen string `json:"screen"`
}

type Client struct {
	// contains filtered or unexported fields
}

type ClientRemoveParams struct {
	Token string `json:"token"`
}

type ClientTokenInfo struct {
	Token     string `json:"token"`
	CreatedAt string `json:"created_at"`
}

type Dialer func(ctx context.Context) (net.Conn, error)

type DispatchFunc func(ctx context.Context, method string, params json.RawMessage) (any, error)

type ExportBundleParams struct {
	NodeID         string          `json:"node_id,omitempty"` // gateway routing
	Agent          string          `json:"agent"`
	TranscriptPath string          `json:"transcript_path"`
	Metadata       bundle.Metadata `json:"metadata"`
}

type ExportBundleResult struct {
	Filename string `json:"filename"`
	Data     []byte `json:"data"`
}

type HandlerFunc func(ctx context.Context, params json.RawMessage) (any, error)

type HistorySessionsParams struct {
	NodeID     string `json:"node_id,omitempty"`
	ProjectDir string `json:"project_dir"` // cwd merge key (node-local) shared across agents
	Limit      int    `json:"limit,omitempty"`
	Offset     int    `json:"offset,omitempty"`
}

type HistoryToolDetailParams struct {
	NodeID         string `json:"node_id,omitempty"`
	Agent          string `json:"agent,omitempty"` // owning agent; selects the adapter
	TranscriptPath string `json:"transcript_path"`
	AgentID        string `json:"agent_id,omitempty"`
	ToolID         string `json:"tool_id"`
}

type HistoryTranscriptParams struct {
	NodeID         string `json:"node_id,omitempty"`
	Agent          string `json:"agent,omitempty"` // owning agent; selects the adapter
	TranscriptPath string `json:"transcript_path"`
	AgentID        string `json:"agent_id,omitempty"`
}

type HookResult struct {
	Output string `json:"output,omitempty"`
}

type IdentifyResult struct {
	ID           string           `json:"id"`
	Label        string           `json:"label"`
	Version      string           `json:"version"` // node's binary version
	Capabilities NodeCapabilities `json:"capabilities"`
}

type InputParams struct {
	SessionID string `json:"session_id"`
	Text      string `json:"text"`
	Submit    bool   `json:"submit"`
	Prepare   bool   `json:"prepare"`
}

type KeyParams struct {
	SessionID string   `json:"session_id"`
	Keys      []string `json:"keys"`
}

type NodeCapabilities struct {
	// SpawnSession reports whether the node can spawn sessions (tmux present).
	SpawnSession bool `json:"spawn_session"`
}

type NodeInfo struct {
	ID           string           `json:"id"`
	Label        string           `json:"label"`
	Version      string           `json:"version"` // node's binary version
	Capabilities NodeCapabilities `json:"capabilities"`
}

type Notification struct {
	Method string
	Params json.RawMessage
}

type Notifier interface {
	Notify(method string, params any) error
}

type PairAwaitParams struct {
	Token string `json:"token"`
}

type PairAwaitResult struct {
	Connected bool `json:"connected"`
}

type PairStartResult struct {
	Token string `json:"token"`
	URL   string `json:"url"`
}

type Peer struct {
	// contains filtered or unexported fields
}

type PeerOptions struct {
	// Dispatch handles requests the remote end issues. Nil means this peer serves
	// no methods (every inbound request gets method-not-found).
	Dispatch DispatchFunc
	// OnNotify receives notifications the remote end sends. Nil drops them.
	OnNotify func(Notification)
	// BaseContext is the parent of each served request's context (so values like
	// an auth Principal flow to handlers). Defaults to context.Background().
	BaseContext context.Context
	// KeepaliveInterval > 0 pings the remote every interval; used to detect a
	// half-open link that never errors on read. Zero disables keepalive.
	KeepaliveInterval time.Duration
	// KeepaliveTimeout bounds each ping's wait for a reply. Defaults to KeepaliveInterval.
	KeepaliveTimeout time.Duration
	// KeepaliveFailureThreshold is how many consecutive failed pings close the
	// peer; an answered ping resets the count. Defaults to 1.
	KeepaliveFailureThreshold int
	// WriteTimeout bounds how long a single frame write may block, so one stuck
	// consumer can't wedge a shared writer (e.g. a slow terminal viewer blocking
	// the node uplink). Exceeding it errors and closes the peer. Zero uses
	// defaultWriteTimeout; a negative value disables the deadline.
	WriteTimeout time.Duration
}

type Principal struct {
	Admin bool
}

type PushDeviceRef struct {
	DeviceID string `json:"device_id"`
}

type PushRegisterParams struct {
	DeviceID string `json:"device_id"`
	Endpoint string `json:"endpoint,omitempty"`
	P256dh   string `json:"p256dh,omitempty"`
	Auth     string `json:"auth,omitempty"`
}

type PushVAPIDKey struct {
	Key string `json:"key,omitempty"`
}

type RPCError struct {
	Code    int    `json:"code"`
	Message string `json:"message"`
}

type ReconnectingClient struct {
	// contains filtered or unexported fields
}

type RespondParams struct {
	SessionID string `json:"session_id"`

	// Structured hook decision (PermissionRequest path).
	Behavior string         `json:"behavior,omitempty"` // "allow" | "deny"
	Reason   string         `json:"reason,omitempty"`   // deny message
	Answers  map[string]any `json:"answers,omitempty"`  // AskUserQuestion: question -> label|[label]|text
	// QuestionAction is a non-answer action on an AskUserQuestion prompt.
	// "" = normal answer submit; "chat" = reject with a clarify request.
	QuestionAction string `json:"question_action,omitempty"`
	// SetMode, on an allow decision (e.g. ExitPlanMode approval), switches the
	// session's permission mode: "acceptEdits" | "default" | "auto".
	SetMode string `json:"set_mode,omitempty"`
	// OptionValue echoes a server-built DecisionOption.Value. Node maps it:
	// "deny" → deny; "allow" → plain allow; any other → allow + setMode <value>.
	OptionValue string `json:"option_value,omitempty"`

	// Keystroke fallback (no parked hook / idle).
	Kind        string `json:"kind,omitempty"`
	OptionIndex int    `json:"option_index,omitempty"`
	Text        string `json:"text,omitempty"`
}

type ResumeParams struct {
	NodeID         string `json:"node_id,omitempty"` // gateway routing key; ignored node-side
	Agent          string `json:"agent"`             // owning agent id
	AgentSessionID string `json:"agent_session_id"`  // the tool's own session id to resume
	Cwd            string `json:"cwd"`               // original working directory
}

type ResumeResult struct {
	SessionID string `json:"session_id"`
}

type Server struct {
	// contains filtered or unexported fields
}

type ServerInfo struct {
	Version string     `json:"version"`
	Nodes   []NodeInfo `json:"nodes"`
}

type SessionRef struct {
	SessionID string `json:"session_id"`
}

type SpawnParams struct {
	NodeID  string `json:"node_id,omitempty"` // gateway routing key; ignored node-side
	Name    string `json:"name,omitempty"`    // tmux session name; blank = node-generated default
	Cwd     string `json:"cwd,omitempty"`
	Agent   string `json:"agent,omitempty"`   // node resolves to a command; blank = default
	Command string `json:"command,omitempty"` // explicit launch command; overrides Agent when set
	Prompt  string `json:"prompt,omitempty"`  // initial prompt; how it reaches the CLI is agent-specific (an argument, or a flag like --prompt-interactive)
}

type SpawnResult struct {
	SessionID string `json:"session_id"`
	PaneID    string `json:"pane_id"`
}

type TerminalCloseParams struct {
	TermID string `json:"term_id"`
}

type TerminalExited struct {
	TermID string `json:"term_id"`
	// Reason is why the attach ended; empty is treated as TermExitedProcess.
	Reason string `json:"reason,omitempty"`
}

type TerminalInputParams struct {
	TermID string `json:"term_id"`
	Data   string `json:"data"`
}

type TerminalOpenParams struct {
	TermID    string `json:"term_id"`
	SessionID string `json:"session_id"`
	Cols      int    `json:"cols"`
	Rows      int    `json:"rows"`
	// ClientPane is the caller's own tmux pane ($TMUX_PANE) when co-located on the
	// session's server; empty otherwise (e.g. the mobile app). The node uses it to
	// refuse an open that would share the agent pane's window.
	ClientPane string `json:"client_pane,omitempty"`
}

type TerminalOutput struct {
	TermID string `json:"term_id"`
	Data   string `json:"data"`
}

type TerminalResizeParams struct {
	TermID string `json:"term_id"`
	Cols   int    `json:"cols"`
	Rows   int    `json:"rows"`
}

type ToolDetail struct {
	ToolInput     string `json:"toolInput,omitempty"`
	Result        string `json:"result,omitempty"`
	ResultIsError bool   `json:"resultIsError,omitempty"`
}

type ToolDetailParams struct {
	SessionID string `json:"session_id"`
	AgentID   string `json:"agent_id,omitempty"`
	ToolID    string `json:"tool_id"`
}

type TranscriptDelta struct {
	SubID     string             `json:"sub_id"`
	FromIndex int                `json:"from_index"`
	Chunks    []transcript.Chunk `json:"chunks"`
}

type TranscriptParams = SessionRef

type TranscriptSubscribeParams struct {
	SubID      string `json:"sub_id"`
	SessionID  string `json:"session_id"`
	AgentID    string `json:"agent_id,omitempty"`
	HaveChunks int    `json:"have_chunks"`
}

type TranscriptUnsubscribeParams struct {
	SubID string `json:"sub_id"`
}