cline

type Array[T any] struct {
	// Name is the file's name in the task directory; empty when the
	// task has no such file.
	Name string
	// Elems are the elements read, in order.
	Elems []T
	// Err is set when the file could not be read whole: it does not
	// parse, it is not an array, or it is cut short. Elems then holds
	// the elements that end before the fault. The file counts one
	// malformed unit for it.
	Err error
}

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

	// text, Roo plain reasoning
	Text string `json:"text"`
	// thinking
	Thinking  string `json:"thinking"`
	Signature string `json:"signature"`
	// redacted_thinking
	Data string `json:"data"`
	// tool_use; id is also a Roo reasoning item's
	ID    string          `json:"id"`
	Name  string          `json:"name"`
	Input json.RawMessage `json:"input"`
	// tool_result
	ToolUseID string   `json:"tool_use_id"`
	Content   *Content `json:"content"`
	IsError   bool     `json:"is_error"`
	// image, document
	Source *MediaSource `json:"source"`
	// Roo encrypted reasoning
	EncryptedContent string `json:"encrypted_content"`
	// Roo thoughtSignature
	ThoughtSignature string `json:"thoughtSignature"`

	Members

	// Raw and Err are set for a block that is not an object, or whose
	// members do not decode as declared; Type is read when it can be.
	Raw json.RawMessage `json:"-"`
	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 ContextUpdate struct {
	Message  int
	EditType json.RawMessage
	Block    int
	TS       json.RawMessage
	// Kind is the update's type; Cline writes "text" alone.
	Kind string
	// Text is the new text; Cline writes one.
	Text     []string
	Metadata json.RawMessage
	// Raw is the update as read, and Err why it does not decode. A
	// message or block entry that does not decode is one update with
	// Err set and Message or Block -1.
	Raw json.RawMessage
	Err error
}

type Environment struct {
	TS           json.RawMessage `json:"ts"`
	ClineVersion string          `json:"cline_version"`

	Members
}

type HistoryItem struct {
	ID                              string          `json:"id"`
	TS                              json.RawMessage `json:"ts"`
	Task                            string          `json:"task"`
	ConversationHistoryDeletedRange json.RawMessage `json:"conversationHistoryDeletedRange"`
	CWDOnTaskInitialization         string          `json:"cwdOnTaskInitialization"`
	ShadowGitConfigWorkTree         string          `json:"shadowGitConfigWorkTree"`
	ModelID                         string          `json:"modelId"`
	// Roo.
	RootTaskID              string   `json:"rootTaskId"`
	ParentTaskID            string   `json:"parentTaskId"`
	Workspace               string   `json:"workspace"`
	Mode                    string   `json:"mode"`
	APIConfigName           string   `json:"apiConfigName"`
	Status                  string   `json:"status"`
	ChildIDs                []string `json:"childIds"`
	CompletionResultSummary string   `json:"completionResultSummary"`

	Members

	// Raw is the item as read.
	Raw json.RawMessage `json:"-"`
}

type MediaSource struct {
	Type      string `json:"type"`
	MediaType string `json:"media_type"`
	Data      string `json:"data"`
	URL       string `json:"url"`

	Members
}

type Members = jsonline.Members

type Message struct {
	Role    string          `json:"role"`
	Content Content         `json:"content"`
	ID      string          `json:"id"`
	TS      json.RawMessage `json:"ts"`

	// Cline classic, on an assistant message.
	ModelInfo *ModelInfo `json:"modelInfo"`
	Metrics   *Metrics   `json:"metrics"`

	// Roo.
	IsSummary          bool            `json:"isSummary"`
	CondenseID         string          `json:"condenseId"`
	CondenseParent     string          `json:"condenseParent"`
	TruncationID       string          `json:"truncationId"`
	TruncationParent   string          `json:"truncationParent"`
	IsTruncationMarker bool            `json:"isTruncationMarker"`
	Type               string          `json:"type"`
	EncryptedContent   string          `json:"encrypted_content"`
	Summary            json.RawMessage `json:"summary"`
	ReasoningDetails   json.RawMessage `json:"reasoning_details"`
	ReasoningContent   json.RawMessage `json:"reasoning_content"`

	Members

	// Raw is the element as read, and Err why it did not decode, for an
	// element that is not an object; nothing else is then set.
	Raw json.RawMessage `json:"-"`
	Err error           `json:"-"`
}

type MetricTokens struct {
	Prompt     json.RawMessage `json:"prompt"`
	Completion json.RawMessage `json:"completion"`
	Cached     json.RawMessage `json:"cached"`

	Members
}

type Metrics struct {
	Tokens *MetricTokens   `json:"tokens"`
	Cost   json.RawMessage `json:"cost"`

	Members
}

type ModelInfo struct {
	ModelID    string `json:"modelId"`
	ProviderID string `json:"providerId"`
	Mode       string `json:"mode"`

	Members
}

type ModelUsage struct {
	TS              json.RawMessage `json:"ts"`
	ModelID         string          `json:"model_id"`
	ModelProviderID string          `json:"model_provider_id"`
	Mode            string          `json:"mode"`

	Members
}

type ReqInfo struct {
	Request                string          `json:"request"`
	TokensIn               json.RawMessage `json:"tokensIn"`
	TokensOut              json.RawMessage `json:"tokensOut"`
	CacheWrites            json.RawMessage `json:"cacheWrites"`
	CacheReads             json.RawMessage `json:"cacheReads"`
	Cost                   json.RawMessage `json:"cost"`
	CancelReason           string          `json:"cancelReason"`
	StreamingFailedMessage string          `json:"streamingFailedMessage"`
	APIProtocol            string          `json:"apiProtocol"`

	Members
}

type Task struct {
	// Dir is the task directory, and ID its name, the task's ID.
	Dir string
	ID  string
	// Variant is which agent wrote the task; VariantBy says how it was
	// told, and Guessed that it was told by shape rather than by the
	// storage directory's name.
	Variant   Variant
	VariantBy string
	Guessed   bool

	API Array[*Message]
	UI  Array[*UIMessage]
	// Context holds context_history.json's updates, each a unit.
	Context Array[*ContextUpdate]

	// Metadata is task_metadata.json; MetadataErr why it did not read.
	Metadata    *TaskMetadata
	MetadataRaw json.RawMessage
	MetadataErr error
	HasMetadata bool

	// Settings is settings.json as read, a per-task settings snapshot
	// some classic releases write; SettingsErr why it did not parse.
	Settings    json.RawMessage
	SettingsErr error
	HasSettings bool

	// History is the task's index entry: Roo's history_item.json, or
	// the element of classic's state/taskHistory.json naming this task.
	// HistoryFile is where it was read from, relative to the storage
	// directory; HistoryErr why it did not read. A history_item.json is
	// a unit of the task; an entry of taskHistory.json is one when it
	// was found.
	History     *HistoryItem
	HistoryFile string
	HistoryErr  error
	HistoryUnit bool

	// Others lists the other files in the task directory, each a unit
	// the converter does not read: a hook's leftover transcript, a
	// temporary file, a newer release's. Dirs lists its directories.
	Others []string
	Dirs   []string
}

type TaskMetadata struct {
	FilesInContext     json.RawMessage `json:"files_in_context"`
	ModelUsage         []*ModelUsage   `json:"model_usage"`
	EnvironmentHistory []*Environment  `json:"environment_history"`

	Members
}

type UIMessage struct {
	TS                              json.RawMessage `json:"ts"`
	Type                            string          `json:"type"`
	Ask                             string          `json:"ask"`
	Say                             string          `json:"say"`
	Text                            string          `json:"text"`
	Partial                         bool            `json:"partial"`
	ConversationHistoryIndex        json.RawMessage `json:"conversationHistoryIndex"`
	ConversationHistoryDeletedRange json.RawMessage `json:"conversationHistoryDeletedRange"`
	// Roo.
	APIProtocol       string          `json:"apiProtocol"`
	ContextCondense   json.RawMessage `json:"contextCondense"`
	ContextTruncation json.RawMessage `json:"contextTruncation"`

	Members

	Raw json.RawMessage `json:"-"`
	Err error           `json:"-"`
}

type Variant string

type XMLToolCall struct {
	Name   string            `json:"name"`
	Params map[string]string `json:"params,omitempty"`
	// Partial says the call has no closing tag: the text ends inside
	// it.
	Partial bool `json:"partial,omitempty"`
}