sessions

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

type CommitRef struct {
	// SHA is the commit hash as the session saw it, abbreviated or full.
	SHA string `json:"sha"`
	// Repo is the root of the repository that holds the commit, when it could be resolved.
	Repo string `json:"repo,omitempty"`
	// Relation is created or referenced.
	Relation CommitRelation `json:"relation"`
	// Subject is the commit's first message line, when it could be read from git.
	Subject string `json:"subject,omitempty"`
	// At is when the session created or referenced the commit.
	At time.Time `json:"at,omitzero"`
}

type CommitRelation string

type Config struct {
	// WorkspaceRoots are directories that hold repositories, such as ~/go/src. The repository
	// index scans them for repositories. A leading ~ means the home directory.
	WorkspaceRoots []string `json:"workspaceRoots,omitempty"`
	// WorkRefRules replace the default work-reference rules when present. Omit it to match
	// initiative and roadmap-item IDs.
	WorkRefRules []WorkRefRule `json:"workRefRules,omitempty"`
}

type Evidence struct {
	// Repos are the repositories the session worked in, read, modified, or mentioned.
	Repos []RepoActivity `json:"repos,omitempty"`
	// Files are the files the session read or modified through the harness's own tools.
	Files []FileActivity `json:"files,omitempty"`
	// Commits are the commits the session created or referenced.
	Commits []CommitRef `json:"commits,omitempty"`
	// WorkRefs are work-tracking identifiers, such as initiative and roadmap-item IDs,
	// found in the session.
	WorkRefs []WorkRef `json:"workRefs,omitempty"`
}

type FileActivity struct {
	// Path is the absolute path of the file.
	Path string `json:"path"`
	// Read is set when the session read the file through a harness tool.
	Read bool `json:"read,omitempty"`
	// Modified is set when the session wrote or edited the file.
	Modified bool `json:"modified,omitempty"`
	// LastSeen is when the session last touched the file.
	LastSeen time.Time `json:"lastSeen,omitzero"`
}

type Harness string

type ListOptions struct {
	// Since drops sessions whose last activity is before this time.
	Since time.Time
	// IncludeArchived includes sessions the harness marks archived.
	IncludeArchived bool
	// NoContent suppresses prompt-derived fields (title text, prompts).
	NoContent bool
}

type Prompt struct {
	// At is when the prompt was sent.
	At time.Time `json:"at"`
	// Text is the prompt text, truncated.
	Text string `json:"text"`
}

type Reader interface {
	Harness() Harness
	List(ctx context.Context, opts ListOptions) ([]Session, []omnidevx.Diagnostic, error)
}

type Repo struct {
	// Root is the repository's root directory, the one that holds .git.
	Root string `json:"root"`
	// ID identifies the repository, such as github.com/org/repo, derived from its origin
	// remote. It is empty when the repository has no usable remote.
	ID string `json:"id,omitempty"`
}

type RepoActivity struct {
	// Root is the repository's root directory.
	Root string `json:"root"`
	// ID identifies the repository, such as github.com/org/repo, derived from its origin
	// remote. It is empty when the repository has no remote.
	ID string `json:"id,omitempty"`
	// CWD is set when the session started in this repository.
	CWD bool `json:"cwd,omitempty"`
	// Executed is set when a command ran with this repository as its working directory.
	Executed bool `json:"executed,omitempty"`
	// Read is set when the session read a file in this repository through a harness tool.
	Read bool `json:"read,omitempty"`
	// Modified is set when the session wrote or edited a file in this repository.
	Modified bool `json:"modified,omitempty"`
	// Mentioned is set when the repository was named in a prompt but not otherwise observed.
	Mentioned bool `json:"mentioned,omitempty"`
	// FileCount is the number of distinct files read or modified in this repository.
	FileCount int `json:"fileCount,omitempty"`
	// FirstSeen is the earliest observed activity in this repository.
	FirstSeen time.Time `json:"firstSeen,omitzero"`
	// LastSeen is the latest observed activity in this repository.
	LastSeen time.Time `json:"lastSeen,omitzero"`
}

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

type RepoIndexOptions struct {
	// MaxDepth is how many levels below each root to search. Zero means DefaultRepoScanDepth.
	MaxDepth int
}

type ResumeSpec struct {
	// Argv is the command and arguments that resume the session.
	Argv []string `json:"argv"`
	// Dir is the directory to run the command from.
	Dir string `json:"dir"`
}

type Runtime struct {
	// PID is the operating-system process ID of the harness.
	PID int `json:"pid,omitempty"`
}

type Session struct {
	// Harness is the coding-agent tool that owns the session: claude-code or codex.
	Harness Harness `json:"harness"`
	// ID is the harness's own session identifier, durable across process exit and reboot.
	ID string `json:"id"`

	// CWD is the directory the session was started in. Resuming must happen from here.
	CWD string `json:"cwd"`
	// GitBranch is the git branch recorded for the session, when the harness records one.
	GitBranch string `json:"gitBranch,omitempty"`
	// GitOrigin is the normalized origin remote, such as github.com/org/repo, when recorded.
	GitOrigin string `json:"gitOrigin,omitempty"`

	// CreatedAt is when the session started.
	CreatedAt time.Time `json:"createdAt"`
	// LastActivityAt is the last activity of any kind, including agent work.
	LastActivityAt time.Time `json:"lastActivityAt"`
	// LastHumanActivityAt is the last prompt a person typed. It is absent when none was found.
	// A large gap after LastActivityAt means the agent kept working unattended.
	LastHumanActivityAt time.Time `json:"lastHumanActivityAt,omitzero"`

	// Title names the session. It comes from the harness when it records one.
	Title string `json:"title,omitempty"`
	// TitleSource says where Title came from: harness, first-prompt, or cwd.
	TitleSource string `json:"titleSource,omitempty"`
	// RecentPrompts are the latest prompts a person typed, truncated. They are omitted when
	// prompt content is suppressed.
	RecentPrompts []Prompt `json:"recentPrompts,omitempty"`

	// Archived is set when the harness marks the session archived.
	Archived bool `json:"archived,omitempty"`
	// State is running, resumable, or unknown.
	State State `json:"state"`
	// Runtime describes the live process when State is running.
	Runtime *Runtime `json:"runtime,omitempty"`

	// Resume says how to resume the session.
	Resume ResumeSpec `json:"resume"`

	// Evidence is what the session touched. It is populated only when requested, because it
	// needs a full transcript parse.
	Evidence *Evidence `json:"evidence,omitempty"`
}

type State string

type WorkRef struct {
	// ID is the identifier as written, such as RMI-EXAMPLE-012.
	ID string `json:"id"`
	// Kind is the name of the rule that matched it, such as initiative or rmi.
	Kind string `json:"kind"`
	// Sources lists where it was found.
	Sources []WorkRefSource `json:"sources"`
	// Title is the identifier's title when a resolver supplied one.
	Title string `json:"title,omitempty"`
}

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

type WorkRefResolver interface {
	// Titles returns the title of each identifier it knows. Unknown
	// identifiers are left out of the result rather than treated as errors.
	Titles(ctx context.Context, ids []string) (map[string]string, error)
}

type WorkRefRule struct {
	// Name is the rule's name and the Kind of every reference it matches, such as rmi.
	Name string `json:"name"`
	// Pattern is a regular expression that matches the identifier as written.
	Pattern string `json:"pattern"`
}

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

type WorkRefSource string