session

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 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"`
	CreatedAt int64     `json:"createdAt"`
}

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"`
	CreatedAt  int64  `json:"createdAt"`
	UpdatedAt  int64  `json:"updatedAt"`
}

type ModelPreferenceStore struct{}

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    int    `json:"fetchTopK"`
	PageChars    int    `json:"pageChars"`
	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"`
	SessionType       string    `json:"sessionType,omitempty"`
	Permission        string    `json:"permission,omitempty"`
	CompactionSummary string    `json:"compactionSummary,omitempty"`
	MemoryTokensSaved int       `json:"memoryTokensSaved,omitempty"`
	CreatedAt         int64     `json:"createdAt"`
	UpdatedAt         int64     `json:"updatedAt"`
}

type SessionID = id.SessionID

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