aicodingsession

type Agent struct {
	Name    string `json:"name"`
	Version string `json:"version,omitempty"`
}

type CodeChanges struct {
	FilesModified     int          `json:"files_modified,omitempty"`
	FilesCreated      int          `json:"files_created,omitempty"`
	FilesDeleted      int          `json:"files_deleted,omitempty"`
	LinesAdded        int          `json:"lines_added,omitempty"`
	LinesRemoved      int          `json:"lines_removed,omitempty"`
	AILinesAdded      int          `json:"ai_lines_added,omitempty"`
	AILinesRemoved    int          `json:"ai_lines_removed,omitempty"`
	HumanLinesAdded   int          `json:"human_lines_added,omitempty"`
	HumanLinesRemoved int          `json:"human_lines_removed,omitempty"`
	Files             []FileChange `json:"files,omitempty"`
}

type Conversation struct {
	TotalMessages     int `json:"total_messages,omitempty"`
	UserMessages      int `json:"user_messages,omitempty"`
	AssistantMessages int `json:"assistant_messages,omitempty"`
}

type Data struct {
	SchemaVersion string  `json:"schema_version"`
	Agent         Agent   `json:"agent"`
	Session       Session `json:"session"`
	// Spec is what the session was asked to build, one entry per source the
	// agent resolved. Empty for a session that captured none.
	Spec         []SpecEntry                  `json:"spec,omitempty"`
	GitContext   *GitContext                  `json:"git_context,omitempty"`
	CodeChanges  *CodeChanges                 `json:"code_changes,omitempty"`
	Model        *Model                       `json:"model,omitempty"`
	Usage        *Usage                       `json:"usage,omitempty"`
	ToolsUsed    *ToolsUsed                   `json:"tools_used,omitempty"`
	Conversation *Conversation                `json:"conversation,omitempty"`
	Subagents    []Subagent                   `json:"subagents,omitempty"`
	RawSession   map[string][]json.RawMessage `json:"raw_session,omitempty"`
	Warnings     []string                     `json:"warnings,omitempty"`
}

type Evidence struct {
	ID     string `json:"chainloop.material.evidence.id"`
	Schema string `json:"schema"`
	Data   Data   `json:"data"`
}

type FileChange struct {
	Path         string      `json:"path"`
	Status       string      `json:"status"`
	LinesAdded   int         `json:"lines_added,omitempty"`
	LinesRemoved int         `json:"lines_removed,omitempty"`
	Attribution  string      `json:"attribution,omitempty"`
	LineRanges   []LineRange `json:"line_ranges,omitempty"`
	SessionIDs   []string    `json:"session_ids,omitempty"`
}

type GitContext struct {
	Repository  string   `json:"repository,omitempty"`
	Branch      string   `json:"branch,omitempty"`
	WorkDir     string   `json:"work_dir,omitempty"`
	CommitStart string   `json:"commit_start,omitempty"`
	CommitEnd   string   `json:"commit_end,omitempty"`
	Commits     []string `json:"commits,omitempty"`
	CommitCount int      `json:"commit_count,omitempty"`
}

type LineRange struct {
	Start int `json:"start"`
	End   int `json:"end"`
}

type Model struct {
	Primary    string   `json:"primary,omitempty"`
	Provider   string   `json:"provider,omitempty"`
	ModelsUsed []string `json:"models_used,omitempty"`
}

type Session struct {
	ID   string `json:"id"`
	Slug string `json:"slug,omitempty"`
	// Mode is one of the Mode* constants. Empty means ModeCoding.
	Mode            string `json:"mode,omitempty"`
	StartedAt       string `json:"started_at"`
	EndedAt         string `json:"ended_at,omitempty"`
	DurationSeconds int    `json:"duration_seconds"`
}

type SpecEntry struct {
	// Kind is one of the SpecKind* constants.
	Kind string `json:"kind"`
	// Role is one of the SpecRole* constants. Empty when the agent stated no
	// role, or one outside the vocabulary.
	Role string `json:"role,omitempty"`
	// Title is a short name for the source, as the agent wrote it.
	Title string `json:"title,omitempty"`
	// Description says in one or two sentences what the source holds, as the
	// agent wrote it.
	Description string `json:"description,omitempty"`
	// URI is where the text came from. Empty when the task was stated in the
	// session itself and there is no external source to point at.
	URI string `json:"uri,omitempty"`
	// Digest identifies the EVIDENCE material holding the spec text, as
	// "sha256:<hex>".
	Digest string `json:"digest"`
	// CapturedAt is when the agent wrote this entry, RFC3339. It comes from the
	// file's modification time, so it is the last write rather than the first,
	// and it is trivially forgeable: not a trusted timestamp. For a skill, it
	// is the time of the first use in the transcript.
	CapturedAt string `json:"captured_at"`
	// Metadata holds data that depends on the kind. Only skill entries have
	// it.
	Metadata *SpecMetadata `json:"metadata,omitempty"`
}

type SpecMetadata struct {
	// Source is one of the SkillSource* constants.
	Source string `json:"source,omitempty"`
	// PackageDigest identifies the EVIDENCE material that holds an archive
	// of the full skill folder, as "sha256:<hex>". Absent when the archive was
	// not uploaded, for example because it was too large.
	PackageDigest string `json:"package_digest,omitempty"`
	// InvocationCount is the number of times the session used the skill. It
	// is ByModel plus ByUser.
	InvocationCount int `json:"invocation_count"`
	// ByModel is the number of uses that the model started with a tool call.
	ByModel int `json:"by_model"`
	// ByUser is the number of uses that the user started with a slash
	// command.
	ByUser int `json:"by_user"`
	// InSubagents is the number of uses, of either start, that came from
	// subagents.
	InSubagents int `json:"in_subagents"`
}

type Subagent struct {
	ID          string         `json:"id"`
	Type        string         `json:"type"`
	Description string         `json:"description"`
	Tokens      SubagentTokens `json:"tokens"`
}

type SubagentTokens struct {
	Input  int `json:"input"`
	Output int `json:"output"`
}

type ToolSummary struct {
	ToolName        string `json:"tool_name"`
	InvocationCount int    `json:"invocation_count"`
}

type ToolsUsed struct {
	Summary          []ToolSummary `json:"summary,omitempty"`
	TotalInvocations int           `json:"total_invocations,omitempty"`
}

type Usage struct {
	InputTokens              int     `json:"input_tokens,omitempty"`
	OutputTokens             int     `json:"output_tokens,omitempty"`
	TotalTokens              int     `json:"total_tokens,omitempty"`
	CacheReadInputTokens     int     `json:"cache_read_input_tokens,omitempty"`
	CacheCreationInputTokens int     `json:"cache_creation_input_tokens,omitempty"`
	EstimatedCostUSD         float64 `json:"estimated_cost_usd,omitempty"`
}