adapters

type Adapter interface {
	// Name returns the adapter name (e.g., "claude-code")
	Name() string

	// Detect checks if this adapter can handle the current environment
	// Returns true if the agent's session files are present and readable
	Detect() bool

	// FindSessionFile locates the session file for correlation.
	// Called after ox agent prime to find the matching agent session.
	// The lookup struct carries all needed context (repoRoot, agentID, since)
	// so the adapter never needs to derive repoRoot from ambient state.
	FindSessionFile(lookup SessionLookup) (string, error)

	// Read reads all entries from a session file
	// Returns entries in chronological order
	Read(sessionPath string) ([]RawEntry, error)

	// ReadMetadata extracts session metadata (agent version, model) from a session file.
	// Returns nil if metadata cannot be determined.
	ReadMetadata(sessionPath string) (*SessionMetadata, error)

	// Watch monitors a session file for new entries (for real-time capture)
	// The returned channel receives entries as they appear
	// The channel is closed when ctx is canceled or an error occurs
	Watch(ctx context.Context, sessionPath string) (<-chan RawEntry, error)
}

type BatchTransformFunc func([]RawEntry) []RawEntry

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

type ExternalAdapterInfo struct {
	Name            string   `json:"name"`
	DisplayName     string   `json:"display_name"`
	Version         string   `json:"version"`
	Type            string   `json:"type"`
	BinaryPath      string   `json:"binary_path"`
	ProtocolVersion int      `json:"protocol_version"`
	Capabilities    []string `json:"capabilities"`
	ServeMode       bool     `json:"serve_mode"`
}

type GenericJSONLAdapter struct{}

type IncrementalReader interface {
	ReadFromOffset(path string, offset int64) ([]RawEntry, int64, error)
}

type ParseLineFunc func([]byte) ([]RawEntry, error)

type RawEntry struct {
	// Timestamp when this entry was created
	Timestamp time.Time

	// Role identifies the speaker: "user", "assistant", "system", "tool"
	Role string

	// Content is the message text or tool output
	Content string

	// ToolName is the name of the tool invoked (only for role="tool")
	ToolName string

	// ToolInput is the input provided to the tool (only for role="tool")
	ToolInput string

	// ToolOutput is the output from the tool (only for role="tool").
	// Only populated for error results to keep recordings lean.
	ToolOutput string

	// IsError indicates the tool call failed (only for role="tool")
	IsError bool

	// CallID correlates function_call with function_call_output (adapter-specific)
	CallID string

	// Raw contains the original data for debugging and auditing
	Raw json.RawMessage
}

type SessionLookup struct {
	RepoRoot       string    // absolute path to the project root (required, validated)
	AgentID        string    // agent identifier (required)
	Since          time.Time // filter to sessions created after this time (required)
	AgentSessionID string    // adapter-native session UUID if known (optional)
}

type SessionMetadata struct {
	// AgentVersion is the version of the coding agent (e.g., "1.0.3" for Claude Code)
	AgentVersion string

	// Model is the LLM model used (e.g., "claude-sonnet-4-20250514")
	Model string
}

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