clinesdk

type Block struct {
	Type string `json:"type"`

	// text; a thinking block's and a tool_use's Gemini thought
	// signature, a thinking block's Anthropic signature.
	Text      string `json:"text"`
	Signature string `json:"signature"`
	// file: content and path; tool_result: content, a string or an
	// array of text, image and file blocks or structured results.
	Content json.RawMessage `json:"content"`
	Path    string          `json:"path"`
	// image (base64 data and its media type); redacted_thinking's data.
	Data      string `json:"data"`
	MediaType string `json:"mediaType"`
	// media: model-generated media.
	Media json.RawMessage `json:"media"`
	// tool_use
	ID     string          `json:"id"`
	CallID string          `json:"call_id"`
	Name   string          `json:"name"`
	Input  json.RawMessage `json:"input"`
	// tool_result
	ToolUseID string `json:"tool_use_id"`
	IsError   bool   `json:"is_error"`
	// thinking
	Thinking string          `json:"thinking"`
	Details  json.RawMessage `json:"details"`
	Summary  json.RawMessage `json:"summary"`

	Members

	// Raw and Err are set for a block that is not an object, or whose
	// members do not decode as declared.
	Raw json.RawMessage `json:"-"`
	Err error           `json:"-"`
}

type Compaction struct {
	Version              json.RawMessage `json:"version"`
	UpdatedAt            string          `json:"updated_at"`
	ConversationID       string          `json:"conversation_id"`
	SourceMessageCount   json.RawMessage `json:"source_message_count"`
	SourcePrefixHash     string          `json:"source_prefix_hash"`
	SourceLastMessageKey string          `json:"source_last_message_key"`
	SystemPrompt         *string         `json:"system_prompt"`

	Members

	// Name is the file's name.
	Name string `json:"-"`
	// Messages are the compacted context's messages.
	Messages    []*Message `json:"-"`
	HasMessages bool       `json:"-"`
	// Err is set when the file could not be read whole.
	Err error `json:"-"`
}

type Content struct {
	Text   string
	IsText bool
	Blocks []*Block
	// Raw and Err are set for content that is neither: a number, an
	// object, null. Raw is written back.
	Raw json.RawMessage
	Err error
}

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

type Fork struct {
	// From is forkedFromSessionId, At forkedAt (ISO), Source the
	// source session's source.
	From, At, Source string
	// Raw is the member as written.
	Raw json.RawMessage
}

type Index interface {
	// Name names the index in findings: its file name.
	Name() string
	// Family returns the rows of root and of every session whose
	// parent is root, or whose ID starts with root and "__".
	Family(root string) ([]*Row, error)
	// Close releases the index.
	Close() error
}

type Manifest struct {
	Version        json.RawMessage `json:"version"`
	SessionID      string          `json:"session_id"`
	Source         string          `json:"source"`
	PID            json.RawMessage `json:"pid"`
	StartedAt      string          `json:"started_at"`
	EndedAt        string          `json:"ended_at"`
	ExitCode       json.RawMessage `json:"exit_code"`
	Status         string          `json:"status"`
	Interactive    json.RawMessage `json:"interactive"`
	Provider       string          `json:"provider"`
	Model          string          `json:"model"`
	CWD            string          `json:"cwd"`
	WorkspaceRoot  string          `json:"workspace_root"`
	TeamName       string          `json:"team_name"`
	EnableTools    json.RawMessage `json:"enable_tools"`
	EnableSpawn    json.RawMessage `json:"enable_spawn"`
	EnableTeams    json.RawMessage `json:"enable_teams"`
	Prompt         string          `json:"prompt"`
	Metadata       json.RawMessage `json:"metadata"`
	MessagesPath   string          `json:"messages_path"`
	CompactionPath string          `json:"compaction_path"`

	Members
}

type Members = jsonline.Members

type Message struct {
	Role      string          `json:"role"`
	Content   Content         `json:"content"`
	ID        string          `json:"id"`
	Agent     string          `json:"agent"`
	SessionID string          `json:"sessionId"`
	Metadata  json.RawMessage `json:"metadata"`
	ModelInfo *ModelInfo      `json:"modelInfo"`
	Metrics   *Metrics        `json:"metrics"`
	TS        json.RawMessage `json:"ts"`

	Members

	// Elem is the element as read, whatever it holds.
	Elem json.RawMessage `json:"-"`
	// Err is why the element did not decode: it is not an object, or
	// its members do not fit; nothing else is then set.
	Err error `json:"-"`
	// contains filtered or unexported fields
}

type MessagesFile struct {
	// Name is the file's name in the session directory.
	Name string `json:"-"`

	Version      json.RawMessage `json:"version"`
	UpdatedAt    string          `json:"updated_at"`
	Agent        string          `json:"agent"`
	SessionID    string          `json:"sessionId"`
	TaskType     string          `json:"taskType"`
	Origin       *Origin         `json:"origin"`
	SystemPrompt *string         `json:"system_prompt"`

	Members

	// Bare says the file is a bare array of messages, with no envelope.
	Bare bool `json:"-"`
	// Messages are the elements of the messages array, in order.
	Messages []*Message `json:"-"`
	// HasMessages says the envelope has a messages member that is an
	// array.
	HasMessages bool `json:"-"`
	// Err is set when the file could not be read whole: it does not
	// parse, it is not an object or an array, or it is cut short.
	// Messages then holds the elements that end before the fault.
	Err error `json:"-"`
}

type Metrics struct {
	InputTokens      json.RawMessage `json:"inputTokens"`
	OutputTokens     json.RawMessage `json:"outputTokens"`
	CacheReadTokens  json.RawMessage `json:"cacheReadTokens"`
	CacheWriteTokens json.RawMessage `json:"cacheWriteTokens"`
	Cost             json.RawMessage `json:"cost"`

	Members
}

type ModelInfo struct {
	ID       string `json:"id"`
	Provider string `json:"provider"`
	Family   string `json:"family"`

	Members
}

type Origin struct {
	Source         string `json:"source"`
	Mode           string `json:"mode"`
	SessionID      string `json:"sessionId"`
	ParentThreadID string `json:"parentThreadId"`
	Subagent       string `json:"subagent"`
	Version        string `json:"version"`
	Trigger        string `json:"trigger"`

	Members
}

type Projection struct {
	// Applies says Cline would project the sidecar: the context is its
	// messages, then the canonical history after its source.
	Applies bool
	// By says what matched: "hash", or "boundary" for a sidecar older
	// than the hash; Why says why it did not apply.
	By, Why string
	// Count is source_message_count; Unhashed is set when the history
	// holds a message the hash here cannot reproduce, so the hash was
	// not compared.
	Count    int
	Unhashed error
}

type Row struct {
	SessionID       string
	Source          string
	StartedAt       string
	EndedAt         string
	Status          string
	ParentSessionID string
	ParentAgentID   string
	AgentID         string
	ConversationID  string
	IsSubagent      bool
	Prompt          string
	MessagesPath    string
	// Metadata is the row's metadata, JSON.
	Metadata json.RawMessage
	// Unit names the row in findings.
	Unit string
	// Raw is the whole row as a JSON object, its columns by name.
	Raw json.RawMessage
}

type Session struct {
	// Dir is the session directory, and ID its name, the session's ID.
	Dir string
	ID  string

	// Manifest is <id>.json; ManifestErr why it did not read.
	Manifest    *Manifest
	ManifestErr error
	HasManifest bool

	// Messages is the session's own history, nil when the directory
	// holds none.
	Messages *MessagesFile
	// Compaction is the compaction sidecar, nil when there is none.
	Compaction *Compaction
	// Agents are the histories of the sub-agents and team tasks the
	// session ran, by file name.
	Agents []*MessagesFile

	// Others lists the other files of the directory, each a unit the
	// converter does not read; Dirs its directories.
	Others []string
	Dirs   []string
}

type TeamTask struct {
	Root, Agent, Task string
}