api

type Config struct {
	// ListenAddr is the address to listen on (e.g., ":8081")
	ListenAddr string

	// VectorDriver for semantic search (optional, enables MCP server)
	VectorDriver vector.Driver

	// Embedder for converting query text to vectors (optional, enables MCP server)
	Embedder embeddings.Embedder

	// Pricing is the model pricing table used by /v1/sessions/summary to
	// compute per-session cost. When nil, sessions.DefaultPricing() is used.
	Pricing sessions.PricingTable

	// EnableWebUI serves the minimal browser UI at /. It is disabled by default
	// so API-only servers do not expose a human-facing development UI unless
	// explicitly requested.
	EnableWebUI bool
}

type GraphLink struct {
	Source string `json:"source"`
	Target string `json:"target"`
}

type GraphNode struct {
	ID            string     `json:"id"`
	ParentID      *string    `json:"parent_id,omitempty"`
	ParentHash    *string    `json:"parent_hash,omitempty"`
	Type          string     `json:"type,omitempty"`
	Role          string     `json:"role,omitempty"`
	Preview       string     `json:"preview,omitempty"`
	Model         string     `json:"model,omitempty"`
	Provider      string     `json:"provider,omitempty"`
	AgentName     string     `json:"agent_name,omitempty"`
	Project       string     `json:"project,omitempty"`
	StopReason    string     `json:"stop_reason,omitempty"`
	Usage         *llm.Usage `json:"usage,omitempty"`
	CreatedAt     time.Time  `json:"created_at,omitzero"`
	Depth         int        `json:"depth"`
	ChildrenCount int        `json:"children_count"`
	IsRoot        bool       `json:"is_root"`
	IsLeaf        bool       `json:"is_leaf"`
	IsBranchPoint bool       `json:"is_branch_point"`
	Selected      bool       `json:"selected"`
}

type GraphResponse struct {
	// Hash is the session/node hash requested by the caller.
	Hash string `json:"hash"`

	// RootHash is the top-most resolvable node included in the response.
	RootHash string `json:"root_hash"`

	// Scope describes which portion of the graph was loaded: root, branch, or ancestry.
	Scope string `json:"scope"`

	// NodeLimit is the maximum number of nodes the server will include.
	NodeLimit int `json:"node_limit"`

	// Nodes is the flat node list consumed by graph visualizers.
	Nodes []GraphNode `json:"nodes"`

	// Links contains parent -> child edges between included nodes.
	Links []GraphLink `json:"links"`

	// Leaves names included nodes that have no children in storage.
	Leaves []string `json:"leaves"`

	// BranchPoints names included nodes with more than one child in storage.
	BranchPoints []string `json:"branch_points"`

	// Truncated is true when the graph hit NodeLimit or the ancestry chain is incomplete.
	Truncated bool `json:"truncated,omitempty"`

	// MissingParent names the unresolved parent hash when the ancestry is incomplete.
	MissingParent string `json:"missing_parent,omitempty"`

	// CycleDetected is true when storage guarded the ancestry walk out of a cycle.
	CycleDetected bool `json:"cycle_detected,omitempty"`
}

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

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

type SessionDetailResponse struct {
	Session SessionItem   `json:"session"`
	Turns   []Turn        `json:"turns"`
	Stems   []StemSummary `json:"stems"`
}

type SessionItem struct {
	ID                string         `json:"id"`
	HarnessID         string         `json:"harness_id"`
	HarnessSessionID  string         `json:"harness_session_id"`
	Name              string         `json:"name,omitempty"`
	Cwd               string         `json:"cwd,omitempty"`
	HarnessVersion    string         `json:"harness_version,omitempty"`
	ParentSessionID   string         `json:"parent_session_id,omitempty"`
	StartedAt         time.Time      `json:"started_at"`
	LastSeenAt        time.Time      `json:"last_seen_at"`
	EndedAt           *time.Time     `json:"ended_at,omitempty"`
	TurnCount         int            `json:"turn_count"`
	TotalInputTokens  int64          `json:"total_input_tokens"`
	TotalOutputTokens int64          `json:"total_output_tokens"`
	TotalCostUsd      float64        `json:"total_cost_usd"`
	DerivedStatus     string         `json:"derived_status"`
	HarnessMetadata   map[string]any `json:"harness_metadata,omitempty"`
	Preview           string         `json:"preview,omitempty"`
	// AuthSubject is the gateway-stamped JWT subject (WorkOS user id)
	// captured at ingest; empty for rows captured before the edge began
	// stamping it.
	AuthSubject string `json:"auth_subject,omitempty"`
}

type SessionListResponse struct {
	Items      []SessionItem `json:"items"`
	NextCursor string        `json:"next_cursor,omitempty"`
}

type StatsResponse struct {
	SessionCount    int     `json:"session_count"`
	StemCount       int     `json:"stem_count"`
	TurnCount       int     `json:"turn_count"`
	RootCount       int     `json:"root_count"`
	CompletedCount  int     `json:"completed_count"`
	TotalCost       float64 `json:"total_cost"`
	InputTokens     int64   `json:"input_tokens"`
	OutputTokens    int64   `json:"output_tokens"`
	TotalDurationNs int64   `json:"total_duration_ns"`
	ToolCalls       int     `json:"tool_calls"`
}

type StemListResponse struct {
	Items      []sessions.SessionSummary `json:"items"`
	NextCursor string                    `json:"next_cursor,omitempty"`
}

type StemResponse struct {
	// Hash is the head of the returned chain (== the requested hash).
	Hash string `json:"hash"`

	// HarnessID and HarnessSessionID identify the upstream agent session when
	// session tracking metadata is available. For Claude Code, HarnessID is
	// "claude" and HarnessSessionID is Claude's session id.
	HarnessID        string `json:"harness_id,omitempty"`
	HarnessSessionID string `json:"harness_session_id,omitempty"`

	// Depth is the total number of turns in the full ancestry of Hash.
	// When the client passes ?depth=N, the Turns array may contain fewer
	// than Depth items.
	Depth int `json:"depth"`

	// Turns contains the chain in chronological order (root-first).
	// When ?depth=N is supplied, only the last N turns (head + N-1 ancestors)
	// are returned, still in chronological order.
	Turns []Turn `json:"turns"`

	// Truncated is true when the ancestry walk stopped at a parent_hash
	// that could not be resolved in the current store. MissingParent
	// names that hash. This is an expected edge case on stores that
	// trim older data, merge foreign content, or offload history to
	// another source — not an error.
	Truncated     bool   `json:"truncated,omitempty"`
	MissingParent string `json:"missing_parent,omitempty"`
}

type StemSummary struct {
	RootHash string `json:"root_hash"`
	Length   int    `json:"length"`
	Preview  string `json:"preview,omitempty"`
	Model    string `json:"model,omitempty"`
}

type Turn struct {
	Hash       string             `json:"hash"`
	ParentHash *string            `json:"parent_hash,omitempty"`
	Role       string             `json:"role"`
	Content    []llm.ContentBlock `json:"content"`
	Model      string             `json:"model,omitempty"`
	Provider   string             `json:"provider,omitempty"`
	AgentName  string             `json:"agent_name,omitempty"`
	StopReason string             `json:"stop_reason,omitempty"`
	Usage      *llm.Usage         `json:"usage,omitempty"`
	CreatedAt  time.Time          `json:"created_at,omitzero"`
}