events

type ActionType string

type CommandExecPayload struct {
	Command       string   `json:"command"`
	Description   string   `json:"description,omitempty"`
	Args          []string `json:"args,omitempty"`
	ExitCode      int      `json:"exit_code"`
	Output        string   `json:"output,omitempty"`
	DurationMs    int64    `json:"duration_ms,omitempty"`
	StdoutPreview string   `json:"stdout_preview,omitempty"`
	StderrPreview string   `json:"stderr_preview,omitempty"`
}

type Event struct {
	// ID is the unique identifier for this event.
	ID uuid.UUID `json:"id"`
	// SessionID links this event to its parent session (deterministic UUID derived from AgentSessionID).
	SessionID uuid.UUID `json:"session_id"`
	// AgentSessionID is the original session ID string from the agent (for correlation).
	AgentSessionID string `json:"agent_session_id,omitempty"`
	// Sequence is the order within the session (1, 2, 3...).
	Sequence int `json:"sequence"`
	// Timestamp is when the action occurred (UTC).
	Timestamp time.Time `json:"timestamp"`
	// DurationMs is how long the action took in milliseconds.
	DurationMs int64 `json:"duration_ms,omitempty"`
	// AgentName is the identifier of the agent (e.g., "claude-code").
	AgentName string `json:"agent_name"`
	// AgentVersion is the version of the agent if detectable.
	AgentVersion string `json:"agent_version,omitempty"`
	// WorkingDirectory may differ from session if agent changed dirs.
	WorkingDirectory string `json:"working_directory,omitempty"`
	// ActionType is the category of action performed.
	ActionType ActionType `json:"action_type"`
	// ToolName is the original tool name from the agent.
	ToolName string `json:"tool_name,omitempty"`
	// ResultStatus is the outcome of the action.
	ResultStatus ResultStatus `json:"result_status"`
	// ErrorMessage contains error details if status is error.
	ErrorMessage string `json:"error_message,omitempty"`
	// Payload contains action-specific data.
	Payload json.RawMessage `json:"payload,omitempty"`
	// DiffContent contains file diff (full logging only, never for sensitive paths).
	DiffContent string `json:"diff_content,omitempty"`
	// RawEvent is the original event from agent (full logging only).
	RawEvent json.RawMessage `json:"raw_event,omitempty"`
	// ConversationContext is the prompt/conversation (full logging only).
	ConversationContext string `json:"conversation_context,omitempty"`
	// TranscriptPath is the path to the agent's transcript file (if provided by the agent).
	// Excluded from JSON export as it is internal to the local machine.
	TranscriptPath string `json:"-"`
	// IsSensitive is true if path matched sensitive_paths pattern.
	IsSensitive bool `json:"is_sensitive"`
	// SubagentID is set when this event was performed by a subagent (empty for main agent).
	SubagentID string `json:"subagent_id,omitempty"`
	// SubagentType is the type of subagent (e.g., "Explore", "Plan", "general-purpose").
	SubagentType string `json:"subagent_type,omitempty"`
}

type EventFilter struct {
	// Since filters events after this time.
	Since *time.Time
	// Until filters events before this time.
	Until *time.Time
	// AgentNames filters by agent name(s).
	AgentNames []string
	// SessionID filters by a specific session.
	SessionID *uuid.UUID
	// ActionTypes filters by action type(s).
	ActionTypes []ActionType
	// ResultStatuses filters by result status(es).
	ResultStatuses []ResultStatus
	// FilePattern is a glob pattern to filter by file path.
	FilePattern string
	// CommandPattern is a glob pattern to filter by command.
	CommandPattern string
	// Sensitive filters to events involving sensitive file access when non-nil.
	Sensitive *bool
	// Limit is the maximum number of results.
	Limit int
	// Offset is the number of results to skip.
	Offset int
	// Sort controls the sort direction (desc by default).
	Sort SortOrder
}

type FileDeletePayload struct {
	Path string `json:"path"`
}

type FileReadPayload struct {
	Path        string `json:"path"`
	Pattern     string `json:"pattern,omitempty"`
	SizeBytes   int64  `json:"size_bytes,omitempty"`
	ContentHash string `json:"content_hash,omitempty"`
}

type FileWritePayload struct {
	Path           string `json:"path"`
	SizeBytes      int64  `json:"size_bytes,omitempty"`
	ContentHash    string `json:"content_hash,omitempty"`
	ContentPreview string `json:"content_preview,omitempty"`
	OldString      string `json:"old_string,omitempty"`
	NewString      string `json:"new_string,omitempty"`
	LinesAdded     int    `json:"lines_added,omitempty"`
	LinesRemoved   int    `json:"lines_removed,omitempty"`
}

type NotificationPayload struct {
	Message string          `json:"message,omitempty"`
	Type    string          `json:"type,omitempty"`
	Details json.RawMessage `json:"details,omitempty"`
}

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

type ResultStatus string

type SessionEndPayload struct {
	Reason string `json:"reason,omitempty"`
}

type SessionPayload struct {
	Source    string `json:"source,omitempty"`
	Model     string `json:"model,omitempty"`
	AgentType string `json:"agent_type,omitempty"`
}

type SortOrder string

type SubagentStartPayload struct {
	AgentID   string `json:"agent_id"`
	AgentType string `json:"agent_type"`
}

type SubagentStopPayload struct {
	AgentID              string `json:"agent_id"`
	AgentType            string `json:"agent_type"`
	AgentTranscriptPath  string `json:"agent_transcript_path,omitempty"`
	LastAssistantMessage string `json:"last_assistant_message,omitempty"`
}

type ToolUsePayload struct {
	ToolName      string          `json:"tool_name"`
	Input         json.RawMessage `json:"input,omitempty"`
	Output        json.RawMessage `json:"output,omitempty"`
	OutputPreview string          `json:"output_preview,omitempty"`
}