conversations

type CompactedSegment struct {
	RawMessages json.RawMessage           `json:"rawMessages"`
	Marker      llmtypes.CompactionMarker `json:"marker"`
}

type CompactionHistory struct {
	Segments           []CompactedSegment `json:"segments"`
	ActiveDisplayStart int                `json:"activeDisplayStart"`
}

type ConversationForkInitiator struct {
	Type        string `json:"type"`
	ExtensionID string `json:"extension_id,omitempty"`
	ToolName    string `json:"tool_name,omitempty"`
}

type ConversationForkMetadata struct {
	Version              int                        `json:"version"`
	SourceConversationID string                     `json:"source_conversation_id"`
	RootConversationID   string                     `json:"root_conversation_id"`
	Depth                int                        `json:"depth"`
	Mode                 ConversationForkMode       `json:"mode"`
	Initiator            *ConversationForkInitiator `json:"initiator,omitempty"`
}

type ConversationForkMode string

type ConversationForkOptions struct {
	Mode      ConversationForkMode
	Initiator *ConversationForkInitiator
	AsChild   bool
}

type ConversationRecord struct {
	ID                string                                `json:"id"`
	CWD               string                                `json:"cwd,omitempty"`
	RawMessages       json.RawMessage                       `json:"rawMessages"` // Raw LLM provider messages
	CompactionHistory *CompactionHistory                    `json:"compactionHistory,omitempty"`
	Provider          string                                `json:"provider"` // e.g., "anthropic"
	Usage             llmtypes.Usage                        `json:"usage"`
	Summary           string                                `json:"summary,omitempty"`
	CreatedAt         time.Time                             `json:"createdAt"`
	UpdatedAt         time.Time                             `json:"updatedAt"`
	Metadata          map[string]any                        `json:"metadata,omitempty"`
	ToolResults       map[string]tools.StructuredToolResult `json:"toolResults,omitempty"` // Maps tool_call_id to structured result
}

type ConversationSearchResult struct {
	MatchCount int           `json:"matchCount"`
	Matches    []SearchMatch `json:"matches,omitempty"`
}

type ConversationSummary struct {
	ID                   string                    `json:"id"`
	ParentConversationID string                    `json:"parentConversationId,omitempty"`
	CWD                  string                    `json:"cwd,omitempty"`
	MessageCount         int                       `json:"messageCount"`
	FirstMessage         string                    `json:"firstMessage"`
	Summary              string                    `json:"summary,omitempty"`
	Provider             string                    `json:"provider"`
	Metadata             map[string]any            `json:"metadata,omitempty"`
	Usage                llmtypes.Usage            `json:"usage"`
	CreatedAt            time.Time                 `json:"createdAt"`
	UpdatedAt            time.Time                 `json:"updatedAt"`
	IsRunning            bool                      `json:"isRunning,omitempty"`
	Search               *ConversationSearchResult `json:"search,omitempty"`
}

type QueryOptions struct {
	StartDate *time.Time
	EndDate   *time.Time
	// SearchTerm covers titles, IDs, CWDs, messages, tool inputs, and compaction
	// summaries. Bare words match prefixes; quoted text is exact. All terms
	// must match one entry.
	SearchTerm    string
	SearchMatches int // Highlighted matches to return per conversation when searching
	Provider      string
	CWD           string // Filter by canonical working directory
	RunnerID      string // Filter by durable runner affinity
	Limit         int
	Offset        int
	SortBy        string // Field to sort by; "relevance" requires a search term
	SortOrder     string // "asc" or "desc"
}

type QueryResult struct {
	ConversationSummaries []ConversationSummary `json:"conversationSummaries"`
	Total                 int                   `json:"total"`          // Represents the total number of the entries that match the query without pagination
	CWDs                  []string              `json:"cwds,omitempty"` // All distinct persisted working directories, independent of pagination
	QueryOptions
}

type SearchDocument struct {
	ConversationID string
	// SourceUpdatedAt is the conversation's updated_at value the entries were extracted from.
	SourceUpdatedAt time.Time
	// Version identifies the extraction rules; a different version forces a rebuild.
	Version     int
	ContentHash string
	Entries     []SearchEntry
}

type SearchEntry struct {
	// EntryIndex is the entry's position in the full display transcript; the title uses -1.
	EntryIndex int
	Role       string
	Kind       string
	Payload    string
}

type SearchIndexCandidate struct {
	ID        string    `db:"id"`
	UpdatedAt time.Time `db:"updated_at"`
}

type SearchMatch struct {
	EntryIndex int    `json:"entryIndex"`
	Role       string `json:"role,omitempty"`
	Kind       string `json:"kind"`
	Snippet    string `json:"snippet"`
}

type TurnAdmission struct {
	ConversationID     string
	RunID              string
	RunnerID           string
	EnvironmentProfile string
}