cursortranscript

package
v0.1.0-rc.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Nov 3, 2026 License: MIT Imports: 13 Imported by: 0

Documentation

Overview

Package cursortranscript reads Cursor's global SQLite conversation store as typed records. It classifies source records but does not decide what they mean in the shared session model; the cursorsession package owns that mapping.

Index

Constants

View Source 
const (
	BubbleTypeUser      = 1
	BubbleTypeAssistant = 2
)
View Source 
const TreePayloadVersion = "1"

Variables

This section is empty.

Functions

func DefaultStorePath 

func DefaultStorePath() string

DefaultStorePath returns Cursor's global conversation database path.

func EncodeTreePayload 

func EncodeTreePayload(tree *Tree) ([]byte, error)

Types

type AdditionalData 

type AdditionalData struct {
	Status             string          `json:"status,omitempty"`
	TerminationReason  string          `json:"terminationReason,omitempty"`
	SubagentComposerID string          `json:"subagentComposerId,omitempty"`
	Raw                json.RawMessage `json:"-"`
}

func (AdditionalData) MarshalJSON 

func (a AdditionalData) MarshalJSON() ([]byte, error)

func (*AdditionalData) UnmarshalJSON 

func (a *AdditionalData) UnmarshalJSON(raw []byte) error

type Bubble 

type Bubble struct {
	Key                           string               `json:"key"`
	ComposerID                    string               `json:"composer_id"`
	BubbleID                      string               `json:"bubbleId"`
	Type                          int                  `json:"type"`
	Version                       int                  `json:"_v"`
	Text                          string               `json:"text"`
	RichText                      json.RawMessage      `json:"richText"`
	Thinking                      json.RawMessage      `json:"thinking"`
	TokenCount                    *TokenCount          `json:"tokenCount"`
	ModelInfo                     *ModelInfo           `json:"modelInfo"`
	CapabilityType                *int                 `json:"capabilityType"`
	SubagentSpawnTaskToolCallID   string               `json:"subagentSpawnTaskToolCallId"`
	CreatedAt                     string               `json:"createdAt"`
	ErrorDetails                  json.RawMessage      `json:"errorDetails"`
	Context                       json.RawMessage      `json:"context"`
	ContextWindowStatusAtCreation *ContextWindowStatus `json:"contextWindowStatusAtCreation"`
	Tool                          *ToolRecord          `json:"toolFormerData"`
}

Bubble is one bubbleId:<composer-id>:<bubble-id> record.

func DecodeBubble 

func DecodeBubble(raw []byte) (*Bubble, error)

type BubbleRef 

type BubbleRef struct {
	BubbleID string `json:"bubbleId"`
	Type     int    `json:"type"`
}

type CodeBlockData 

type CodeBlockData []CodeBlockRef

CodeBlockData is the diff-bearing subset of composerData.codeBlockData.

func (*CodeBlockData) UnmarshalJSON 

func (d *CodeBlockData) UnmarshalJSON(raw []byte) error

type CodeBlockDiff 

type CodeBlockDiff struct {
	DiffID                 string     `json:"diff_id"`
	NewModelDiffWrtV0      []DiffHunk `json:"newModelDiffWrtV0"`
	OriginalModelDiffWrtV0 []DiffHunk `json:"originalModelDiffWrtV0"`
}

CodeBlockDiff is one codeBlockDiff:<composer-id>:<diff-id> record.

func DecodeCodeBlockDiff 

func DecodeCodeBlockDiff(raw []byte) (*CodeBlockDiff, error)

func (*CodeBlockDiff) UnmarshalJSON 

func (d *CodeBlockDiff) UnmarshalJSON(raw []byte) error

type CodeBlockRef 

type CodeBlockRef struct {
	BubbleID    string      `json:"bubbleId"`
	CodeBlockID string      `json:"codeblockId"`
	DiffID      string      `json:"diffId"`
	Status      string      `json:"status"`
	URI         ResourceURI `json:"uri"`
}

CodeBlockRef joins one structured diff to its bubble and file.

type Composer 

type Composer struct {
	Header   *Header          `json:"header,omitempty"`
	Data     *ComposerData    `json:"data"`
	Bubbles  []*Bubble        `json:"bubbles"`
	Unlisted []*Bubble        `json:"unlisted_bubbles,omitempty"`
	Diffs    []*CodeBlockDiff `json:"-"`
}

Composer is one materialized composer and its ordered/unordered bubbles.

type ComposerData 

type ComposerData struct {
	ComposerID           string               `json:"composerId"`
	Version              int                  `json:"_v"`
	Status               string               `json:"status"`
	Headers              []BubbleRef          `json:"fullConversationHeadersOnly"`
	CreatedAt            int64                `json:"createdAt"`
	LastUpdatedAt        *int64               `json:"lastUpdatedAt"`
	UnifiedMode          string               `json:"unifiedMode"`
	SubComposerIDs       []string             `json:"subComposerIds"`
	SubagentComposerIDs  []string             `json:"subagentComposerIds"`
	ModelConfig          *ModelConfig         `json:"modelConfig"`
	ContextTokensUsed    *int64               `json:"contextTokensUsed"`
	ContextTokenLimit    *int64               `json:"contextTokenLimit"`
	PromptTokenBreakdown json.RawMessage      `json:"promptTokenBreakdown"`
	WorkspaceIdentifier  *WorkspaceIdentifier `json:"workspaceIdentifier"`
	CreatedOnBranch      string               `json:"createdOnBranch"`
	CommittedToBranch    string               `json:"committedToBranch"`
	Name                 string               `json:"name"`
	AgentBackend         string               `json:"agentBackend"`
	CodeBlocks           CodeBlockData        `json:"codeBlockData,omitempty"`
}

ComposerData is one composerData:<composer-id> snapshot.

func DecodeComposerData 

func DecodeComposerData(raw []byte) (*ComposerData, error)

func (ComposerData) MarshalJSON 

func (d ComposerData) MarshalJSON() ([]byte, error)

type ContextWindowStatus 

type ContextWindowStatus struct {
	TokensUsed int64 `json:"tokensUsed"`
	TokenLimit int64 `json:"tokenLimit"`
}

type DiffHunk 

type DiffHunk struct {
	Original DiffRange `json:"original"`
	Modified []string  `json:"modified"`
}

func (*DiffHunk) UnmarshalJSON 

func (h *DiffHunk) UnmarshalJSON(raw []byte) error

type DiffRange 

type DiffRange struct {
	StartLineNumber        int `json:"startLineNumber"`
	EndLineNumberExclusive int `json:"endLineNumberExclusive"`
}

func (*DiffRange) UnmarshalJSON 

func (r *DiffRange) UnmarshalJSON(raw []byte) error

type Discovery 

type Discovery struct {
	Sessions []SessionRef `json:"sessions"`
	JunkRows int          `json:"junk_rows"`
	// contains filtered or unexported fields
}

Discovery is the deduplicated union of composerHeaders and composerData keys.

func (*Discovery) Roots 

func (d *Discovery) Roots() []SessionRef

Roots returns composers not classified as listed or header-flagged subagents.

func (*Discovery) Session 

func (d *Discovery) Session(composerID string) (SessionRef, bool)
type Header struct {
	ComposerID    string      `json:"composer_id"`
	WorkspaceID   string      `json:"workspace_id,omitempty"`
	CreatedAt     int64       `json:"created_at,omitempty"`
	LastUpdatedAt int64       `json:"last_updated_at,omitempty"`
	IsArchived    bool        `json:"is_archived"`
	IsSubagent    bool        `json:"is_subagent"`
	Value         HeaderValue `json:"value"`
}

Header is one composerHeaders index row and its denormalized JSON value.

type HeaderValue 

type HeaderValue struct {
	Name                string               `json:"name,omitempty"`
	WorkspaceIdentifier *WorkspaceIdentifier `json:"workspaceIdentifier,omitempty"`
}

type ModelConfig 

type ModelConfig struct {
	ModelName string          `json:"modelName,omitempty"`
	Raw       json.RawMessage `json:"-"`
}

func (ModelConfig) MarshalJSON 

func (m ModelConfig) MarshalJSON() ([]byte, error)

func (*ModelConfig) UnmarshalJSON 

func (m *ModelConfig) UnmarshalJSON(raw []byte) error

type ModelInfo 

type ModelInfo struct {
	ModelName string `json:"modelName"`
}

type PortableBlock 

type PortableBlock struct {
	Index int               `json:"index"`
	Kind  PortableBlockKind `json:"kind"`
	Text  string            `json:"text,omitempty"`
	Tool  *PortableToolUse  `json:"tool_use,omitempty"`
	Raw   json.RawMessage   `json:"raw"`
}

type PortableBlockKind 

type PortableBlockKind string
const (
	PortableText      PortableBlockKind = "text"
	PortableToolBlock PortableBlockKind = "tool_use"
)

type PortableRecord 

type PortableRecord struct {
	Ordinal int                `json:"ordinal"`
	Kind    PortableRecordKind `json:"kind"`
	Blocks  []PortableBlock    `json:"blocks,omitempty"`
	Status  string             `json:"status,omitempty"`
	Error   json.RawMessage    `json:"error,omitempty"`
	Raw     json.RawMessage    `json:"raw"`
}

func DecodePortable 

func DecodePortable(r io.Reader) ([]PortableRecord, error)

type PortableRecordKind 

type PortableRecordKind string
const (
	PortableUser      PortableRecordKind = "user"
	PortableAssistant PortableRecordKind = "assistant"
	PortableTurnEnd   PortableRecordKind = "turn_ended"
)

type PortableToolUse 

type PortableToolUse struct {
	Name  string          `json:"name"`
	Input json.RawMessage `json:"input"`
}

type ResourceURI 

type ResourceURI struct {
	FSPath string `json:"fsPath,omitempty"`
	Path   string `json:"path,omitempty"`
	Scheme string `json:"scheme,omitempty"`
}

func (ResourceURI) FilePath 

func (u ResourceURI) FilePath() string

type SessionRef 

type SessionRef struct {
	ComposerID          string               `json:"composer_id"`
	Title               string               `json:"title,omitempty"`
	WorkspaceID         string               `json:"workspace_id,omitempty"`
	WorkspaceIdentifier *WorkspaceIdentifier `json:"-"`
	CreatedAt           int64                `json:"created_at,omitempty"`
	LastUpdatedAt       int64                `json:"last_updated_at,omitempty"`
	HasHeader           bool                 `json:"has_header"`
	HasData             bool                 `json:"has_data"`
	IsSubagent          bool                 `json:"is_subagent"`
	Header              *Header              `json:"-"`
}

SessionRef is the store index entry for one composer.

type Shape 

type Shape struct {
	Headers                    int            `json:"headers"`
	ComposerVersions           map[string]int `json:"composer_versions"`
	BubbleVersions             map[string]int `json:"bubble_versions"`
	BubbleTypes                map[string]int `json:"bubble_types"`
	ToolStatuses               map[string]int `json:"tool_statuses"`
	KeyFamilies                map[string]int `json:"key_families"`
	ComposersWithBubblesNoData int            `json:"composers_with_bubbles_without_data"`
	BubblesWithoutComposerData int            `json:"bubbles_without_composer_data"`
	JunkRows                   int            `json:"junk_rows"`
}

Shape counts the source variants observed while decoding a store.

type Store 

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

Store is an open, read-only Cursor global store.

func Open 

func Open(path string) (*Store, error)

Open opens path read-only. SQLite applies the live WAL through sqliteread; this package never opens Cursor's stale .backup file.

func (*Store) Close 

func (s *Store) Close() error

Close releases the read-only database handle.

func (*Store) Discover 

func (s *Store) Discover() (*Discovery, error)

Discover indexes the DB-backed Cursor sessions in this store.

func (*Store) Survey 

func (s *Store) Survey() (Shape, error)

func (*Store) Tree 

func (s *Store) Tree(composerID string) (*Tree, error)

Tree reads one composer tree in authoritative header order.

type TokenCount 

type TokenCount struct {
	InputTokens  int64 `json:"inputTokens"`
	OutputTokens int64 `json:"outputTokens"`
}

func (*TokenCount) HasUsage 

func (t *TokenCount) HasUsage() bool

type ToolRecord 

type ToolRecord struct {
	Tool           json.RawMessage `json:"tool"`
	Name           *string         `json:"name"`
	ToolCallID     string          `json:"toolCallId"`
	ModelCallID    string          `json:"modelCallId"`
	Status         string          `json:"status"`
	Params         json.RawMessage `json:"params"`
	RawArgs        json.RawMessage `json:"rawArgs"`
	Result         json.RawMessage `json:"result"`
	ToolIndex      *int            `json:"toolIndex"`
	UserDecision   string          `json:"userDecision"`
	Error          json.RawMessage `json:"error"`
	AdditionalData *AdditionalData `json:"additionalData"`
}

ToolRecord is Cursor's call-and-result record embedded in one bubble.

func (*ToolRecord) Degenerate 

func (t *ToolRecord) Degenerate() bool

func (*ToolRecord) ToolName 

func (t *ToolRecord) ToolName() string

type Tree 

type Tree struct {
	Composer         *Composer `json:"composer"`
	Children         []*Tree   `json:"children,omitempty"`
	DanglingChildren []string  `json:"dangling_children,omitempty"`
}

Tree is one composer and every materialized child listed beneath it.

func DecodeHostedTreePayload 

func DecodeHostedTreePayload(body []byte) (*Tree, error)

DecodeHostedTreePayload applies the appliance's validation of untrusted upload nodes before restoring raw fields. Local payload decoding retains its contract.

func DecodeTreePayload 

func DecodeTreePayload(body []byte) (*Tree, error)

func (*Tree) ComposerID 

func (t *Tree) ComposerID() string

func (*Tree) Composers 

func (t *Tree) Composers() []*Composer

Composers returns the tree in parent-first order.

type TreePayload 

type TreePayload struct {
	SchemaVersion string            `json:"schema_version"`
	Tree          *Tree             `json:"tree"`
	RawFields     map[string]string `json:"raw_fields,omitempty"`
}

type WorkspaceIdentifier 

type WorkspaceIdentifier struct {
	ID  string          `json:"id,omitempty"`
	URI ResourceURI     `json:"uri"`
	Raw json.RawMessage `json:"-"`
}

func (WorkspaceIdentifier) MarshalJSON 

func (w WorkspaceIdentifier) MarshalJSON() ([]byte, error)

func (*WorkspaceIdentifier) UnmarshalJSON 

func (w *WorkspaceIdentifier) UnmarshalJSON(raw []byte) error

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.