event

type AssistantDeltaPayload struct {
	Text string `json:"text"`
}

type AssistantMessagePayload struct {
	Text       string         `json:"text"`
	ToolCalls  []llm.ToolCall `json:"tool_calls,omitempty"`
	Incomplete bool           `json:"incomplete"`
	// ParentCallID is the call_id of the "agent" tool call that produced this
	// event inside a sub-agent run; empty for the main agent.
	ParentCallID string `json:"parent_call_id,omitempty"`
}

type BudgetWarningPayload struct {
	Used int64 `json:"used"`
	Max  int64 `json:"max"`
}

type CRAReportPayload struct {
	ID   string `json:"id"`
	Kind string `json:"kind"`
	Step string `json:"step"`
	At   string `json:"at"`
}

type CRAScanPayload struct {
	SBOMs       int    `json:"sboms"`
	Components  int    `json:"components"`
	Open        int    `json:"open"`
	ToVerify    int    `json:"to_verify"`
	NotAffected int    `json:"not_affected"`
	Fixed       int    `json:"fixed"`
	DBDate      string `json:"db_date"`
	Unchecked   int    `json:"unchecked,omitempty"`
	Conflicts   int    `json:"conflicts,omitempty"`
}

type ClientInfo struct {
	Name    string `json:"name"`
	Version string `json:"version"`
}

type ContextCompactedPayload struct {
	Summary      string `json:"summary"`
	Replaced     int    `json:"replaced"`
	TokensBefore int    `json:"tokens_before"`
	TokensAfter  int    `json:"tokens_after"`
	// HookContext is the additional context the SessionStart hooks (source
	// "compact") returned after the compaction, if any.
	HookContext string `json:"hook_context,omitempty"`
	// ParentCallID is the call_id of the "agent" tool call that produced this
	// event inside a sub-agent run; empty for the main agent.
	ParentCallID string `json:"parent_call_id,omitempty"`
}

type ContextShapedPayload struct {
	Masked       []string `json:"masked"`
	Deduplicated []string `json:"deduplicated"`
	SavedTokens  int      `json:"saved_tokens"`
	// ParentCallID is the call_id of the "agent" tool call that produced this
	// event inside a sub-agent run; empty for the main agent.
	ParentCallID string `json:"parent_call_id,omitempty"`
}

type ErrorPayload struct {
	Code    string `json:"code"`
	Message string `json:"message"`
	// ParentCallID is the call_id of the "agent" tool call that produced this
	// event inside a sub-agent run; empty for the main agent.
	ParentCallID string `json:"parent_call_id,omitempty"`
}

type Event struct {
	ID      string          `json:"id"` // "<session>-<seq>"
	Session string          `json:"session"`
	Seq     uint64          `json:"seq"`
	TS      time.Time       `json:"ts"`
	Type    Type            `json:"type"`
	Payload json.RawMessage `json:"payload"`
}

type HookCompletedPayload struct {
	RunID         string          `json:"run_id"`
	HookID        string          `json:"hook_id"`
	Event         string          `json:"event"`
	Status        string          `json:"status"`
	ExitCode      *int            `json:"exit_code,omitempty"`
	Decision      string          `json:"decision,omitempty"`
	Reason        string          `json:"reason,omitempty"`
	UpdatedInput  json.RawMessage `json:"updated_input,omitempty"`
	SystemMessage string          `json:"system_message,omitempty"`
	Stop          bool            `json:"stop,omitempty"`
	StopReason    string          `json:"stop_reason,omitempty"`
	Error         string          `json:"error,omitempty"`
	DurationMS    int64           `json:"duration_ms"`
	Stdout        string          `json:"stdout,omitempty"`
	Stderr        string          `json:"stderr,omitempty"`
	CallID        string          `json:"call_id,omitempty"`
	// ParentCallID is the call_id of the "agent" tool call that produced this
	// event inside a sub-agent run; empty for the main agent.
	ParentCallID string `json:"parent_call_id,omitempty"`
}

type HookStartedPayload struct {
	RunID   string `json:"run_id"`
	HookID  string `json:"hook_id"`
	Event   string `json:"event"`
	Type    string `json:"type"`
	Command string `json:"command,omitempty"`
	Prompt  string `json:"prompt,omitempty"`
	CallID  string `json:"call_id,omitempty"`
	// ParentCallID is the call_id of the "agent" tool call that produced this
	// event inside a sub-agent run; empty for the main agent.
	ParentCallID string `json:"parent_call_id,omitempty"`
}

type JurisdictionWarningPayload struct {
	Provider llm.ProviderInfo `json:"provider"`
	// ParentCallID is the call_id of the "agent" tool call that produced this
	// event inside a sub-agent run; empty for the main agent.
	ParentCallID string `json:"parent_call_id,omitempty"`
}

type MCPServerInfo struct {
	ID           string           `json:"id"`
	Jurisdiction llm.Jurisdiction `json:"jurisdiction"`
	Country      string           `json:"country,omitempty"`
	// Sandbox records how a stdio server was started (omitted for http).
	Sandbox *SandboxUse `json:"sandbox,omitempty"`
}

type McpServerDownPayload struct {
	Server string `json:"server"`
	Error  string `json:"error"`
	// ParentCallID is the call_id of the "agent" tool call that produced this
	// event inside a sub-agent run; empty for the main agent.
	ParentCallID string `json:"parent_call_id,omitempty"`
}

type MemoryForgottenPayload struct {
	Scope string `json:"scope"`
	ID    string `json:"id"`
	By    string `json:"by"`
}

type MemoryReadPayload struct {
	Scope     string `json:"scope"`
	ID        string `json:"id"`
	Sensitive bool   `json:"sensitive"`
}

type MemoryTrustedPayload struct {
	ID     string `json:"id"`
	SHA256 string `json:"sha256"`
}

type MemoryWrittenPayload struct {
	Scope     string `json:"scope"`
	ID        string `json:"id"`
	SHA256    string `json:"sha256"`
	Author    string `json:"author"`
	Sensitive bool   `json:"sensitive"`
	Redacted  bool   `json:"redacted"`
}

type PermissionRequestedPayload struct {
	PermissionID string            `json:"permission_id"`
	Kind         string            `json:"kind"`
	Tool         string            `json:"tool"`
	Paths        []string          `json:"paths,omitempty"`
	Command      string            `json:"command"`
	Provider     *llm.ProviderInfo `json:"provider,omitempty"`
	// HookReason is the reason a PreToolUse hook gave for asking, if any.
	HookReason string `json:"hook_reason,omitempty"`
	// Args holds the arguments that will run when a PreToolUse hook's
	// updatedInput changed them (omitted otherwise): UIs preview these
	// instead of the model's original arguments.
	Args json.RawMessage `json:"args,omitempty"`
	// Sandboxed is true when the shell command will run confined: UIs then
	// offer "Allow with network" besides "Allow".
	Sandboxed bool `json:"sandboxed,omitempty"`
	// RuleNetwork is true when the matched permission rule grants network:
	// approving the request then runs the command with network access.
	RuleNetwork bool `json:"rule_network,omitempty"`
	// ParentCallID is the call_id of the "agent" tool call that produced this
	// event inside a sub-agent run; empty for the main agent.
	ParentCallID string `json:"parent_call_id,omitempty"`
}

type PermissionResolvedPayload struct {
	PermissionID string `json:"permission_id"`
	Allowed      bool   `json:"allowed"`
	Remember     bool   `json:"remember"`
	// Network is true when the allowed command runs with network access, granted
	// by the reply ("Allow with network") or by the matched rule; a reply alone
	// never grants it to a tool that is not a confined shell command.
	Network bool `json:"network,omitempty"`
	// ParentCallID is the call_id of the "agent" tool call that produced this
	// event inside a sub-agent run; empty for the main agent.
	ParentCallID string `json:"parent_call_id,omitempty"`
}

type PolicyRef struct {
	ID      string `json:"id"`
	Version int    `json:"version"`
	KeyID   string `json:"key_id"`
}

type ProviderSelectedPayload struct {
	Provider llm.ProviderInfo `json:"provider"`
	Reason   string           `json:"reason"`
	Error    string           `json:"error,omitempty"`
	// Purpose is "compaction" or "subagent" when the selection comes from a
	// dedicated router (a small model): not a switch of the session provider.
	// Empty for the turns.
	Purpose string `json:"purpose,omitempty"`
}

type RedactionAppliedPayload struct {
	Counts map[string]int `json:"counts"`
	// ParentCallID is the call_id of the "agent" tool call that produced this
	// event inside a sub-agent run; empty for the main agent.
	ParentCallID string `json:"parent_call_id,omitempty"`
}

type RewoundFile struct {
	Path   string `json:"path"`
	Action string `json:"action"`
	Status string `json:"status"`
	Hash   string `json:"hash,omitempty"`
	Error  string `json:"error,omitempty"`
}

type RewoundPayload struct {
	ToSeq          uint64        `json:"to_seq"`
	Mode           string        `json:"mode"`
	Files          []RewoundFile `json:"files,omitempty"`
	UntrackedCalls int           `json:"untracked_calls,omitempty"`
	Note           string        `json:"note,omitempty"`
}

type RoutingInfo struct {
	Local    string   `json:"local,omitempty"`
	Fallback []string `json:"fallback,omitempty"`
}

type SandboxInfo struct {
	Mode      string `json:"mode"`
	Mechanism string `json:"mechanism"`
	Network   string `json:"network"`
	Reason    string `json:"reason,omitempty"`
}

type SandboxUse struct {
	// Confined: the command ran confined by the system sandbox.
	Confined bool `json:"confined"`
	// Network: the command had network access (always true when not confined).
	Network bool `json:"network"`
}

type SessionClassifiedPayload struct {
	Reason string `json:"reason"`
	Source string `json:"source"`
	CallID string `json:"call_id,omitempty"`
	Path   string `json:"path,omitempty"`
	Marker string `json:"marker,omitempty"`
}

type SessionStartedPayload struct {
	Provider    llm.ProviderInfo `json:"provider"`
	ProjectRoot string           `json:"project_root"`
	// Resumed is true when the session was rebuilt from its persisted events.
	Resumed bool `json:"resumed,omitempty"`
	// Instructions lists the project instruction files loaded (e.g. AGENTS.md).
	Instructions []string `json:"instructions,omitempty"`
	// MCP lists the MCP servers active for the session (omitted when none).
	MCP []MCPServerInfo `json:"mcp,omitempty"`
	// Profile est le profil de conformité actif (omis sans profil).
	Profile string `json:"profile,omitempty"`
	// Policy identifie la politique d'organisation active (omis sans politique).
	Policy *PolicyRef `json:"policy,omitempty"`
	// Sandbox décrit l'isolation des commandes de la session (omis si inconnue).
	Sandbox *SandboxInfo `json:"sandbox,omitempty"`
	// Routing décrit le routage configuré ([routing]) : omis sans lui.
	Routing *RoutingInfo `json:"routing,omitempty"`
	// Kind distingue les sessions courtes hors conversation (« cra »,
	// « memory ») ; omis pour une conversation.
	Kind string `json:"kind,omitempty"`
	// Client identifie l'éditeur qui pilote la session (ACP) ; omis sinon.
	Client *ClientInfo `json:"client,omitempty"`
	// Transport vaut « acp » pour une session pilotée par un éditeur ; omis
	// pour une session en ligne de commande.
	Transport string `json:"transport,omitempty"`
}

type Sink interface {
	Write(e Event) error
}

type SubagentCompletedPayload struct {
	CallID     string `json:"call_id"`
	Status     string `json:"status"`
	Iterations int    `json:"iterations"`
}

type SubagentStartedPayload struct {
	CallID      string `json:"call_id"`
	Agent       string `json:"agent"`
	Description string `json:"description"`
}

type ToolCallRequestedPayload struct {
	CallID string          `json:"call_id"`
	Tool   string          `json:"tool"`
	Args   json.RawMessage `json:"args"`
	// ParentCallID is the call_id of the "agent" tool call that produced this
	// event inside a sub-agent run; empty for the main agent.
	ParentCallID string `json:"parent_call_id,omitempty"`
}

type ToolResultPayload struct {
	CallID     string `json:"call_id"`
	Tool       string `json:"tool"`
	Content    string `json:"content"`
	IsError    bool   `json:"is_error"`
	Path       string `json:"path"`
	HashBefore string `json:"hash_before"`
	HashAfter  string `json:"hash_after"`
	Denied     string `json:"denied,omitempty"`
	// NoCheckpoint is true when the call changed files but no checkpoint could be saved for them.
	NoCheckpoint bool `json:"no_checkpoint,omitempty"`
	// Untracked is true when the call may have changed files outside the checkpoint tracking (e.g. bash).
	Untracked bool `json:"untracked,omitempty"`
	// Sandbox records how a shell command ran (omitted for other tools).
	Sandbox *SandboxUse `json:"sandbox,omitempty"`
	// ParentCallID is the call_id of the "agent" tool call that produced this
	// event inside a sub-agent run; empty for the main agent.
	ParentCallID string `json:"parent_call_id,omitempty"`
}

type TurnCompletedPayload struct {
	Iterations int    `json:"iterations"`
	Reason     string `json:"reason"`
}

type Type string

type UsagePayload struct {
	Provider  string `json:"provider"`
	Model     string `json:"model"`
	Purpose   string `json:"purpose"`
	Input     int    `json:"input"`
	Output    int    `json:"output"`
	Cached    int    `json:"cached"`
	Estimated bool   `json:"estimated"`
	// Window is the context window of the provider that answered, in
	// estimated tokens (0 in events written before it was recorded).
	Window int `json:"window,omitempty"`
	// ProviderName and Jurisdiction describe the provider that answered
	// (empty in events written before they were recorded).
	ProviderName string           `json:"provider_name,omitempty"`
	Jurisdiction llm.Jurisdiction `json:"jurisdiction,omitempty"`
	// ParentCallID is the call_id of the "agent" tool call that produced this
	// event inside a sub-agent run (or the run id of an agent hook); empty
	// for the main agent.
	ParentCallID string `json:"parent_call_id,omitempty"`
}

type UserMessagePayload struct {
	// Text is what the model receives.
	Text string `json:"text"`
	// Typed is what the user actually typed; UIs show it instead of Text when set.
	Typed string `json:"typed,omitempty"`
	// Skill is the name of the skill that produced Text, if any.
	Skill string `json:"skill,omitempty"`
	// SkillSHA256 is the hash of the skill file content used, if any.
	SkillSHA256 string `json:"skill_sha256,omitempty"`
	// HookContext is the additional context a hook returned for the model, if any.
	HookContext string `json:"hook_context,omitempty"`
	// Blocked is true when a hook blocked the message (feedback message).
	Blocked bool `json:"blocked,omitempty"`
	// Hook names the event that produced a feedback message: "Stop" or "SubagentStop".
	Hook string `json:"hook,omitempty"`
	// ParentCallID is the call_id of the "agent" tool call whose sub-agent
	// received this message (SubagentStop feedback); empty for the main agent.
	ParentCallID string `json:"parent_call_id,omitempty"`
}