session

type AgentPartData struct {
	Handle    string `json:"handle"`
	Direction string `json:"direction"` // "in" | "out"
	Seq       int64  `json:"seq"`
	Kind      string `json:"kind,omitempty"`
	Topic     string `json:"topic,omitempty"`
	Text      string `json:"text"`
	// To is the recipient handle for an outbound post; empty means everyone.
	To string `json:"to,omitempty"`
	// SessionID is the peer's session, so the UI can link to it.
	SessionID string `json:"sessionId,omitempty"`
}

type CatalogModel struct {
	ID              string  `json:"id"`
	Name            string  `json:"name"`
	ProviderID      string  `json:"providerId"`
	ActiveByDefault bool    `json:"activeByDefault"`
	SupportsImages  bool    `json:"supportsImages"`
	ContextWindow   int     `json:"contextWindow"`
	MaxOutputTokens int     `json:"maxOutputTokens"`
	Collection      string  `json:"collection"`
	InputPricePerM  float64 `json:"inputPricePerM"`
	OutputPricePerM float64 `json:"outputPricePerM"`
	// Per-million USD cache rates the provider published; 0 when it publishes
	// none.
	CacheReadPricePerM  float64 `json:"cacheReadPricePerM"`
	CacheWritePricePerM float64 `json:"cacheWritePricePerM"`
	// Efforts and DefaultEffort are the reasoning levels the host reported for
	// the model (empty when it reported none).
	Efforts       []string `json:"efforts,omitempty"`
	DefaultEffort string   `json:"defaultEffort,omitempty"`
}

type Delivery struct {
	// DispatchedAt is when the StreamChat attempt that succeeded left for the
	// provider. Re-stamped on every attempt so that retry backoff, which can run
	// to seconds, never lands inside TTFTMs.
	DispatchedAt int64 `json:"dispatchedAt,omitempty"`
	// ConnectedAt is when the provider answered 200 and the stream opened. This
	// is the moment the request is known to have reached the model.
	ConnectedAt int64 `json:"connectedAt,omitempty"`
	// FirstTokenAt is when the first content event of any kind arrived — text,
	// reasoning or a tool call. Reasoning counts: on a thinking model it is what
	// arrives first, and waiting for text instead would report the whole
	// thinking phase as latency.
	FirstTokenAt int64 `json:"firstTokenAt,omitempty"`
	// TTFTMs is FirstTokenAt − DispatchedAt: time to first token, the model's
	// own queue and prefill, free of ogcode's prompt building and of backoff.
	TTFTMs int64 `json:"ttftMs,omitempty"`
	// QueuedMs is DispatchedAt − the prompt's CreatedAt: everything ogcode did
	// before the request left, which is prompt building, memory retrieval and
	// compaction. Kept apart from TTFTMs so a slow turn can be attributed.
	QueuedMs int64 `json:"queuedMs,omitempty"`
	// Attempts is how many StreamChat tries the connection took. Above 1 means
	// the stream was opened more than once before it held.
	Attempts int `json:"attempts,omitempty"`
	// FirstTokenKind is what opened the response: "text", "reasoning" or "tool".
	FirstTokenKind string `json:"firstTokenKind,omitempty"`
}

type ImagePartData struct {
	MediaType string `json:"mediaType"`
	Data      string `json:"data"`
	Name      string `json:"name,omitempty"`
}

type IntentStep struct {
	Step   string `json:"step"`
	Status string `json:"status"` // one of the Intent* constants
	// Description says what the step actually involves — the files, the library,
	// the command. It is never shown to the user: a matcher reads it to suggest
	// the skills and MCP tools likely to help with the step. Optional, so a plan
	// written before the field existed still parses.
	Description string `json:"description,omitempty"`
	// MatchedSkills and MatchedMCPs count what the turn's plan matcher paired
	// with this step: skills it could load, MCP servers whose tools it could
	// call. Zero means nothing matched — or that the step was never routed,
	// which is what a step with no description gets. Written by the agent loop
	// from the routing answer, never by the tool the agent calls.
	MatchedSkills int `json:"matchedSkills,omitempty"`
	MatchedMCPs   int `json:"matchedMCPs,omitempty"`
	// MatchedSkillNames and MatchedMCPNames name what those counts stand for, so
	// the plan chip can say which skill or MCP server a count is about on hover.
	// They are the routed, capped set — one entry per counted match, in the
	// order the matcher named them. Absent when nothing matched.
	MatchedSkillNames []string `json:"matchedSkillNames,omitempty"`
	MatchedMCPNames   []string `json:"matchedMCPNames,omitempty"`
}

type InterruptReason string

type Interruption struct {
	Reason    InterruptReason `json:"reason"`
	Resumable bool            `json:"resumable"`
	// Detail is a short human-facing sentence naming what to do about it. The
	// raw provider error stays in Error.
	Detail string `json:"detail,omitempty"`
	// RetryAfter is the unix second the provider said to come back at, or 0
	// where it said nothing. Only a rate limit tends to carry one.
	RetryAfter int64 `json:"retryAfter,omitempty"`
	// Step is the loop step the turn died on, for the UI to say how far it got.
	Step int `json:"step,omitempty"`
}

type MessageID = id.MessageID

type MessageInfo struct {
	ID        MessageID    `json:"id"`
	SessionID SessionID    `json:"sessionId"`
	Role      MessageRole  `json:"role"`
	Agent     string       `json:"agent,omitempty"`
	ParentID  *MessageID   `json:"parentId,omitempty"`
	Finish    *string      `json:"finish,omitempty"`
	Cost      float64      `json:"cost,omitempty"`
	Tokens    *TokenCounts `json:"tokens,omitempty"`
	Error     *string      `json:"error,omitempty"`
	// Interrupted is set when a loop stopped part-way through this turn rather
	// than because the model finished. It is what a resume decides from.
	Interrupted *Interruption `json:"interrupted,omitempty"`
	// Delivery records how far this turn got on its way to the model and how
	// long the model took to start answering. Set on assistant messages only,
	// and nil on any written before the field existed.
	Delivery *Delivery `json:"delivery,omitempty"`
	// DisplayOnly marks a message that belongs in the transcript but must never
	// be sent to a model. Mid-loop guidance is the case it exists for: the text
	// is already folded into the running turn's user message, so persisting it
	// as an ordinary message would deliver it twice on the next request and
	// insert a second user row beside one the model is still answering — which
	// both APIs reject as a break in user/assistant alternation. Recording it
	// display-only keeps the user's own words in the conversation they typed
	// them into without changing what any model receives.
	DisplayOnly bool  `json:"displayOnly,omitempty"`
	CreatedAt   int64 `json:"createdAt"`
	// Model and Provider are the endpoint that produced an assistant message,
	// stamped when its step starts. A session can switch models between turns,
	// so the session's own Model says only what it runs on now; pricing a turn
	// needs the one that answered it. Empty on messages written before the
	// fields existed, which are priced at the session's model instead.
	Model    string `json:"model,omitempty"`
	Provider string `json:"provider,omitempty"`
}

type MessageRole string

type MessageWithParts struct {
	Info  MessageInfo `json:"info"`
	Parts []Part      `json:"parts"`
}

type ModelCapability struct {
	ModelID        string `json:"modelId"`
	SupportsImages bool   `json:"supportsImages"`
	ProbedAt       int64  `json:"probedAt"`
	ContextWindow  int    `json:"contextWindow"`
}

type ModelPreference struct {
	ID          string `json:"id"`
	Enabled     bool   `json:"enabled"`
	ProviderID  string `json:"providerId"`
	DisplayName string `json:"displayName"`
	IsCustom    bool   `json:"isCustom"`
	// Collection is an optional group name for custom models so OpenAI-compatible
	// providers added through the OpenAI provider (Gemini, DeepSeek, Groq, …) can
	// be grouped together in the UI instead of all collapsing under "OpenAI".
	// Empty for built-in models and legacy custom models (falls back to providerId).
	Collection string `json:"collection"`
	// The rest is what the user told us about a custom model no catalogue knows.
	// Each zero value (or false) means "not configured", so that field falls
	// back to a catalogue or provider fact instead of overriding it.
	ContextWindow       int     `json:"contextWindow"`
	MaxOutputTokens     int     `json:"maxOutputTokens"`
	InputPricePerM      float64 `json:"inputPricePerM"`
	OutputPricePerM     float64 `json:"outputPricePerM"`
	CacheReadPricePerM  float64 `json:"cacheReadPricePerM"`
	CacheWritePricePerM float64 `json:"cacheWritePricePerM"`
	// SupportsImages can only ever force image support ON: a bool has no way to
	// say "yes" from "unconfigured", and catalogue facts outrank a false.
	SupportsImages bool  `json:"supportsImages"`
	CreatedAt      int64 `json:"createdAt"`
	UpdatedAt      int64 `json:"updatedAt"`
}

type ModelPreferenceStore struct{}

type OGXAccount struct {
	Token         string `json:"token"`
	Email         string `json:"email"`
	Plan          string `json:"plan"`
	TimeConnected int64  `json:"timeConnected"`
}

type Part struct {
	ID        PartID          `json:"id"`
	MessageID MessageID       `json:"messageId"`
	SessionID SessionID       `json:"sessionId"`
	Type      PartType        `json:"type"`
	Data      json.RawMessage `json:"data"`
	CreatedAt int64           `json:"createdAt"`
	UpdatedAt int64           `json:"updatedAt"`
}

type PartID = id.PartID

type PartType string

type PermissionID = id.PermissionID

type ProviderConfig struct {
	ProviderID string `json:"providerId"`
	APIKey     string `json:"apiKey"`
	BaseURL    string `json:"baseUrl"`
	UpdatedAt  int64  `json:"updatedAt"`
}

type ReasoningPartData struct {
	Text      string `json:"text"`
	Signature string `json:"signature,omitempty"`
	// RedactedData is the opaque payload of an Anthropic redacted_thinking
	// block. Such a block has no readable text, and dropping it — or replaying
	// it as an ordinary thinking block — breaks the round-trip the API
	// requires within a tool-use turn.
	RedactedData string `json:"redactedData,omitempty"`
	// Model is the model that produced this block. Thinking blocks are tied to
	// the model that generated them: replayed to any other model they are
	// silently ignored but still billed as input, and an unsigned block from an
	// OpenAI-family model is rejected outright. Recording the origin lets the
	// conversion drop what the current model cannot use.
	Model string `json:"model,omitempty"`
}

type SearchConfig struct {
	Enabled bool `json:"enabled"`
	// Provider selects the search backend: "native" (default) or "tavily".
	Provider string `json:"provider"`
	// TavilyAPIKey is the token for the Tavily provider. Masked to MaskedAPIKey
	// on read so it never reaches the UI in the clear.
	TavilyAPIKey string `json:"tavilyApiKey"`
	// FetchTopK is how many ranked URLs the native engine reads in full before
	// synthesising an answer.
	FetchTopK int `json:"fetchTopK"`
	// PageChars is the per-page character cap fed into synthesis.
	PageChars int `json:"pageChars"`
	// Browser selects which native engine leads: "native", "safari" or
	// "chrome", or "" for the built-in ordering (HTTP first, the browser as the
	// fallback).
	Browser   string `json:"browser"`
	UpdatedAt int64  `json:"updatedAt"`
}

type Session struct {
	ID                SessionID    `json:"id"`
	ProjectID         string       `json:"projectId"`
	Directory         string       `json:"directory"`
	Title             string       `json:"title"`
	Model             string       `json:"model,omitempty"`
	Provider          string       `json:"provider,omitempty"`
	Effort            string       `json:"effort,omitempty"` // reasoning effort the loop requests (internal/provider/effort.go); empty = the vendor's default
	SessionType       string       `json:"sessionType,omitempty"`
	Permission        string       `json:"permission,omitempty"`
	CompactionSummary string       `json:"compactionSummary,omitempty"`
	UtilityTokens     *TokenCounts `json:"utilityTokens,omitempty"`
	// Status is the session's in-flight turn state, shown as a dot in the
	// session list: StatusRunning while a turn is running, StatusFailed if the
	// last turn ended in an error, and "" (idle or finished cleanly) otherwise.
	Status string `json:"status,omitempty"`
	// Intent is the forward-looking plan for the current turn: the steps the
	// agent is working through, each with a status. Written by the update_intent
	// tool and cleared when the next turn starts, so it describes the turn in
	// flight rather than the session's history.
	Intent    *SessionIntent `json:"intent,omitempty"`
	CreatedAt int64          `json:"createdAt"`
	UpdatedAt int64          `json:"updatedAt"`
}

type SessionID = id.SessionID

type SessionIntent struct {
	Steps []IntentStep `json:"steps"`
}

type StepUsage struct {
	MessageID MessageID
	SessionID SessionID
	Model     string
	Provider  string
	Tokens    TokenCounts
	CreatedAt int64
}

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

type TextPartData struct {
	Text string `json:"text"`
}

type TokenCounts struct {
	Total      int `json:"total,omitempty"`
	Input      int `json:"input,omitempty"`
	Output     int `json:"output,omitempty"`
	Reasoning  int `json:"reasoning,omitempty"`
	CacheRead  int `json:"cacheRead,omitempty"`
	CacheWrite int `json:"cacheWrite,omitempty"`
}

type ToolImage struct {
	MediaType string `json:"mediaType"`
	Data      string `json:"data"`
}

type ToolPartData struct {
	Tool   string `json:"tool"`
	CallID string `json:"callId"`
	// Extra is an opaque per-tool-call payload the host attached and requires
	// replayed verbatim on the assistant message (Gemini's
	// extra_content/thought_signature). Empty for every other host.
	Extra json.RawMessage `json:"extra,omitempty"`
	State ToolState       `json:"state"`
}

type ToolState struct {
	Status   ToolStatus      `json:"status"`
	Input    json.RawMessage `json:"input"`
	Output   *string         `json:"output,omitempty"`
	Error    *string         `json:"error,omitempty"`
	Title    *string         `json:"title,omitempty"`
	Metadata json.RawMessage `json:"metadata,omitempty"`
	Image    *ToolImage      `json:"image,omitempty"`
	Time     ToolTime        `json:"time"`
}

type ToolStatus string

type ToolTime struct {
	Start int64 `json:"start,omitempty"`
	End   int64 `json:"end,omitempty"`
}