types

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

type APIChunkType string

type APIProvider string

type APIRequest struct {
	// Model is the model to use
	Model ModelIdentifier `json:"model"`

	// Messages are the messages to send
	Messages []Message `json:"messages"`

	// SystemPrompt is the legacy flattened system prompt.
	// When SystemPromptBlocks is provided, request builders should prefer the
	// structured representation and use this field only as a fallback.
	SystemPrompt string `json:"system_prompt,omitempty"`

	// SystemPromptBlocks carries the canonical prompt split.
	SystemPromptBlocks []SystemPromptBlock `json:"system_prompt_blocks,omitempty"`

	// Tools is the stable provider-facing tool surface.
	Tools []APIToolDefinition `json:"tools,omitempty"`

	// MaxTokens is the maximum tokens to generate
	MaxTokens int `json:"max_tokens"`

	// Temperature controls randomness (0-1)
	Temperature *float64 `json:"temperature,omitempty"`

	// TopK controls diversity
	TopK *int `json:"top_k,omitempty"`

	// TopP controls nucleus sampling
	TopP *float64 `json:"top_p,omitempty"`

	// StopSequences are sequences that will stop generation
	StopSequences []string `json:"stop_sequences,omitempty"`

	// Stream enables streaming responses
	Stream bool `json:"stream,omitempty"`

	// Metadata contains additional request metadata
	Metadata map[string]any `json:"metadata,omitempty"`

	// OutputSchema, when set, constrains the model to return JSON matching the
	// given schema. Providers with native support (OpenAI, Gemini) use their
	// structured-output API. Other providers receive a system message injection.
	OutputSchema *schema.StructuredOutputInfo `json:"output_schema,omitempty"`
}

type APIResponse struct {
	// Role is always "assistant" for responses
	Role Role `json:"role"`

	// Content is the response content
	Content []ContentBlock `json:"content"`

	// StopReason is why generation stopped
	StopReason string `json:"stop_reason"`

	// StopSequence is the sequence that caused the stop (if applicable)
	StopSequence *string `json:"stop_sequence,omitempty"`

	// Usage is token usage information
	Usage TokenUsage `json:"usage"`

	// Model is the model that was used
	Model ModelIdentifier `json:"model"`

	// ID is the response ID
	ID string `json:"id"`
}

type APIResponseChunk struct {
	// Type is the type of chunk
	Type APIChunkType `json:"type"`

	// Delta is the text delta (for text chunks)
	Delta string `json:"delta,omitempty"`

	// DeltaType identifies the provider delta payload variant.
	DeltaType string `json:"delta_type,omitempty"`

	// PartialJSON carries an incremental tool_use input payload.
	PartialJSON string `json:"partial_json,omitempty"`

	// ContentBlock is a complete content block
	ContentBlock ContentBlock `json:"content_block,omitempty"`

	// StopReason is why generation stopped
	StopReason *string `json:"stop_reason,omitempty"`

	// StopSequence is the stop sequence emitted by the provider, if any.
	StopSequence *string `json:"stop_sequence,omitempty"`

	// Usage is token usage information
	Usage *TokenUsage `json:"usage,omitempty"`

	// Error contains any error
	Error *EngineError `json:"error,omitempty"`
}

type APIStream <-chan APIResponseChunk

type APIStreamResult struct {
	Response APIResponse        `json:"response"`
	Chunks   []APIResponseChunk `json:"chunks,omitempty"`
}

type APIToolDefinition struct {
	Name        string                `json:"name"`
	Description string                `json:"description"`
	InputSchema toolschema.JSONSchema `json:"input_schema,omitempty"`
	// CacheControl, when set, instructs Anthropic to cache all content up to
	// and including this tool definition. Set on the last tool in the list.
	CacheControl *PromptCacheControl `json:"cache_control,omitempty"`
}

type AgentID string

type AgentRuntimeEvent struct {
	// CallID is the tool_use ID of the spawning / waiting / interaction call.
	CallID string `json:"call_id"`
	// AgentID is the stable agent identifier (returned by spawn_agent).
	AgentID string `json:"agent_id"`
	// AgentNickname is the optional random human-friendly name (e.g. "Orion").
	AgentNickname string `json:"agent_nickname,omitempty"`
	// AgentRole is the optional role the agent was spawned with (e.g. "reviewer").
	AgentRole string `json:"agent_role,omitempty"`
	// Prompt is the initial or follow-up prompt (may be empty to prevent leaking CoT).
	Prompt string `json:"prompt,omitempty"`
	// Status is the last known CollabAgentStatus of the agent.
	Status string `json:"status,omitempty"`
	// Message is the inter-agent message text for interaction events.
	Message string `json:"message,omitempty"`
	// StartedAtMs is the Unix millisecond timestamp for begin events.
	StartedAtMs int64 `json:"started_at_ms,omitempty"`
	// CompletedAtMs is the Unix millisecond timestamp for end events.
	CompletedAtMs int64 `json:"completed_at_ms,omitempty"`
}

type BrowserRuntimeEvent struct {
	Action string `json:"action,omitempty"`

	PageID       string `json:"page_id,omitempty"`
	URL          string `json:"url,omitempty"`
	Title        string `json:"title,omitempty"`
	ActivePageID string `json:"active_page_id,omitempty"`

	PageCount    int `json:"page_count,omitempty"`
	ActionCount  int `json:"action_count,omitempty"`
	ElementCount int `json:"element_count,omitempty"`
	HeadingCount int `json:"heading_count,omitempty"`
	TextLength   int `json:"text_length,omitempty"`

	Bytes         int    `json:"bytes,omitempty"`
	PersistedPath string `json:"persisted_path,omitempty"`
	PersistedSize int    `json:"persisted_size,omitempty"`
	FullPage      bool   `json:"full_page,omitempty"`
}

type CanUseToolFn func(ctx context.Context, request ToolPermissionRequest) PermissionResult

type CompactionMetadata struct {
	Kind                    string    `json:"kind,omitempty"`
	PreCompactTokens        int       `json:"pre_compact_tokens,omitempty"`
	PostCompactTokens       int       `json:"post_compact_tokens,omitempty"`
	TargetTokens            int       `json:"target_tokens,omitempty"`
	PreservedMessages       int       `json:"preserved_messages,omitempty"`
	PreservedTurns          int       `json:"preserved_turns,omitempty"`
	PreservedToolPairs      int       `json:"preserved_tool_pairs,omitempty"`
	BoundaryVersion         int       `json:"boundary_version,omitempty"`
	FirstPreservedMessageID MessageID `json:"first_preserved_message_id,omitempty"`
	LastPreservedMessageID  MessageID `json:"last_preserved_message_id,omitempty"`
	PreservedTailHash       string    `json:"preserved_tail_hash,omitempty"`
}

type ContentBlock interface {
	ContentType() ContentType
}

type ContentReplacementState struct {
	// OriginalSize is the original size in bytes
	OriginalSize int64 `json:"original_size"`

	// ReplacedSize is the size after replacement
	ReplacedSize int64 `json:"replaced_size"`

	// ReplacementType indicates what type of replacement occurred
	ReplacementType ContentReplacementType `json:"replacement_type"`

	// Preview is a preview of the original content
	Preview string `json:"preview,omitempty"`

	// FilePath is where the content was stored (if applicable)
	FilePath string `json:"file_path,omitempty"`
}

type ContentReplacementType string

type ContentType string

type ContextChangeData struct {
	OldValue string `json:"old_value,omitempty"`
	NewValue string `json:"new_value"`
	Reason   string `json:"reason,omitempty"`
}

type ContextWindow struct {
	// MaxTokens is the maximum tokens for the model
	MaxTokens int `json:"max_tokens"`

	// MaxOutputTokens is the maximum tokens that can be generated
	MaxOutputTokens int `json:"max_output_tokens"`
}

type DangerousPattern struct {
	// ToolName is the tool this pattern applies to. Empty means all tools.
	ToolName string `json:"tool_name"`

	// Pattern is a substring match in the input (key or value).
	Pattern string `json:"pattern"`

	// Reason explains why this pattern is dangerous.
	Reason string `json:"reason"`

	// CheckType identifies the check source.
	CheckType string `json:"check_type"`
}

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

type DenialLimitConfig struct {
	// MaxConsecutiveDenials triggers fallback when reached.
	// A value of 0 means no limit.
	MaxConsecutiveDenials int `json:"max_consecutive_denials"`

	// MaxTotalDenials triggers fallback when reached.
	// A value of 0 means no limit.
	MaxTotalDenials int `json:"max_total_denials"`

	// ResetAfterSeconds without a denial resets consecutive counter.
	// A value of 0 means no time-based reset.
	ResetAfterSeconds int `json:"reset_after_seconds"`
}

type DenialTrackingState struct {

	// ConsecutiveDenials counts refusals in a row since the last success.
	ConsecutiveDenials int `json:"consecutive_denials"`

	// TotalDenials is the cumulative count of denials in this session.
	TotalDenials int `json:"total_denials"`

	// LastDeniedAt records when the most recent denial occurred.
	LastDeniedAt *time.Time `json:"last_denied_at,omitempty"`

	// LastAllowedAt records when the most recent allowance occurred.
	LastAllowedAt *time.Time `json:"last_allowed_at,omitempty"`
	// contains filtered or unexported fields
}

type ElicitationData struct {
	RequestID string           `json:"request_id"`
	Prompt    string           `json:"prompt"`
	Options   []map[string]any `json:"options,omitempty"`
}

type EngineError struct {
	// Code is the error code
	Code ErrorCode `json:"code"`

	// Message is a human-readable message
	Message string `json:"message"`

	// Err is the underlying error
	Err error `json:"-"`

	// Context contains additional error context
	Context map[string]any `json:"context,omitempty"`
}

type EntryType string

type ErrorCode string

type ExecutionOrigin string

type GoalRuntimeEvent struct {
	// SessionID identifies the session this goal belongs to.
	SessionID string `json:"session_id"`
	// Objective is the current goal objective text.
	Objective string `json:"objective"`
	// Status is the current ThreadGoalStatus string.
	Status string `json:"status"`
	// TokenBudget is the optional max token budget.
	TokenBudget *int64 `json:"token_budget,omitempty"`
	// TokensUsed is the cumulative tokens consumed so far.
	TokensUsed int64 `json:"tokens_used"`
	// TimeUsedSeconds is the elapsed wall-clock time since goal creation.
	TimeUsedSeconds int64 `json:"time_used_seconds"`
	// CreatedAt is the Unix millisecond timestamp when the goal was created.
	CreatedAt int64 `json:"created_at"`
	// UpdatedAt is the Unix millisecond timestamp of the last update.
	UpdatedAt int64 `json:"updated_at"`
}

type GranularConfig struct {
	// SandboxApproval controls whether sandbox approval prompts are allowed.
	// When true, commands that match sandbox policy can request approval.
	// When false, sandbox prompts are auto-denied.
	SandboxApproval bool `json:"sandbox_approval,omitempty"`

	// RulesApproval controls whether exec-policy "prompt" rules trigger approval prompts.
	// When true, rules with behavior=ask can prompt for approval.
	// When false, rule-based prompts are auto-denied.
	RulesApproval bool `json:"rules_approval,omitempty"`

	// SkillApproval controls whether skill script execution triggers approval prompts.
	// When true, skill scripts can request additional permissions.
	// When false, skill approval prompts are auto-denied.
	SkillApproval bool `json:"skill_approval,omitempty"`

	// RequestPermissionsApproval controls whether request_permissions tool triggers prompts.
	// When true, users can request additional permissions via tool.
	// When false, permission requests are auto-denied.
	RequestPermissionsApproval bool `json:"request_permissions_approval,omitempty"`
}

type Hook interface {
	// Execute runs the hook and returns the result.
	Execute(ctx context.Context, stage HookStage, toolName string, toolInput map[string]any, metadata map[string]any) HookResult

	// Priority determines hook execution order (higher = earlier).
	Priority() int

	// Name identifies the hook.
	Name() string
}

type HookAction string

type HookEvent string

type HookHandler func(ctx context.Context, progress HookProgress) (*HookResult, error)

type HookProgress struct {
	// Event is the hook event type
	Event HookEvent `json:"event"`

	// Message is a human-readable message
	Message string `json:"message,omitempty"`

	// Data contains event-specific data
	Data map[string]any `json:"data,omitempty"`
}

type HookRegistration struct {
	// Event is the event this hook is registered for
	Event HookEvent `json:"event"`

	// Stage is when this hook should be called
	Stage HookStage `json:"stage"`

	// Handler is the function to call
	Handler HookHandler `json:"-"`

	// Priority determines order (higher = earlier)
	Priority int `json:"priority"`

	// ID uniquely identifies this hook registration
	ID string `json:"id"`
}

type HookResult struct {
	// Action indicates what action to take.
	Action HookAction `json:"action"`

	// UpdatedInput contains modified input from the hook.
	UpdatedInput map[string]any `json:"updated_input,omitempty"`

	// Message contains a message to display to the user.
	Message string `json:"message,omitempty"`

	// Retry indicates that the tool should be retried.
	Retry bool `json:"retry,omitempty"`

	// Metadata contains additional hook-specific data.
	Metadata map[string]any `json:"metadata,omitempty"`
}

type HookStage string

type ImageContent struct {
	Source struct {
		Type      string `json:"type"`
		MediaType string `json:"media_type"`
		Data      string `json:"data"`
	} `json:"source"`
}

type Message struct {
	ID        MessageID        `json:"id"`
	Role      Role             `json:"role"`
	Content   []ContentBlock   `json:"content"`
	Timestamp time.Time        `json:"timestamp"`
	Metadata  *MessageMetadata `json:"metadata,omitempty"`
}

type MessageID string

type MessageMetadata struct {
	TurnID string `json:"turn_id,omitempty"`

	StopReason string `json:"stop_reason,omitempty"`

	StopSequence *string `json:"stop_sequence,omitempty"`

	Usage *TokenUsage `json:"usage,omitempty"`

	Compaction *CompactionMetadata `json:"compaction,omitempty"`
}

type ModelIdentifier struct {
	// Provider is the API provider
	Provider APIProvider `json:"provider"`

	// Model is the model name (e.g., "claude-3-5-sonnet-20241022")
	Model string `json:"model"`

	// Version is the optional version
	Version string `json:"version,omitempty"`
}

type NotificationData struct {
	Level   string `json:"level"` // info, warning, error
	Message string `json:"message"`
	Source  string `json:"source,omitempty"`
}

type PermissionBehavior string

type PermissionContext struct {
	// Mode is the current permission mode (who approves)
	Mode PermissionMode `json:"mode"`

	// ExecutionMode is the current execution mode (what agent does: execute, plan, pair_programming, browse)
	ExecutionMode string `json:"execution_mode,omitempty"`

	// PrePlanMode stores the mode before entering plan mode for restoration
	PrePlanMode PermissionMode `json:"pre_plan_mode,omitempty"`

	// IsBypassPermissionsModeAvailable indicates if bypass permissions were available before plan mode
	IsBypassPermissionsModeAvailable bool `json:"is_bypass_permissions_mode_available,omitempty"`

	// IsAutoModeAvailable indicates if auto mode is available for this session
	IsAutoModeAvailable bool `json:"is_auto_mode_available,omitempty"`

	// StrippedDangerousRules stores permissions that were stripped for auto mode safety
	StrippedDangerousRules map[string][]string `json:"stripped_dangerous_rules,omitempty"`
}

type PermissionDecisionReason struct {
	Type PermissionDecisionReasonType `json:"type"`

	// Source identifies the subsystem or rule source that produced the decision.
	Source string `json:"source,omitempty"`

	// Reason is a human-readable detail for the decision.
	Reason string `json:"reason,omitempty"`

	// RuleBehavior is set when Type is "rule" to indicate the original rule behavior
	// (allow, deny, ask). This lets the pipeline distinguish a content-specific
	// ask-rule from a passthrough ask, and treat ask-rules as bypass-immune.
	RuleBehavior PermissionBehavior `json:"rule_behavior,omitempty"`

	// ClassifierApprovable is set on safetyCheck decisions to indicate that
	// the auto-mode classifier may override this decision. Non-approvable
	// safety checks stay immune to ALL auto-approve paths.
	ClassifierApprovable bool `json:"classifier_approvable,omitempty"`

	// SubcommandResults contains results for each subcommand in a complex command.
	// Used by tools like bash that can execute multiple operations in a single call.
	// Aligned with OpenClaude's subcommandResults (permissions.ts:165-188).
	SubcommandResults map[string]PermissionResult `json:"subcommand_results,omitempty"`

	// Reasons contains detailed reasons for each subcommand when Type is "subcommandResults".
	// Aligned with OpenClaude's decisionReason.reasons (permissions.ts:167).
	Reasons map[string]PermissionDecisionReason `json:"reasons,omitempty"`
}

type PermissionDecisionReasonType string

type PermissionDeniedData struct {
	ToolName     string         `json:"tool_name"`
	Input        map[string]any `json:"input"`
	Reason       string         `json:"reason"`
	RetryAllowed bool           `json:"retry_allowed"`
}

type PermissionMode string

type PermissionRequestData struct {
	ToolName       string         `json:"tool_name"`
	Input          map[string]any `json:"input"`
	PermissionMode string         `json:"permission_mode"`
	Context        map[string]any `json:"context,omitempty"`
}

type PermissionResolver interface {
	ResolvePermission(ctx context.Context, request ToolPermissionRequest) PermissionResult
}

type PermissionResult struct {
	Behavior PermissionBehavior `json:"behavior"`

	// Reason provides a human-readable explanation.
	Reason string `json:"reason,omitempty"`

	// UpdatedInput contains normalized or rewritten input approved by permissions.
	UpdatedInput map[string]any `json:"updated_input,omitempty"`

	// Confidence indicates confidence in the decision (0-1).
	// Only applicable in auto mode with classifier.
	Confidence *float64 `json:"confidence,omitempty"`

	// Metadata contains additional information.
	Metadata map[string]any `json:"metadata,omitempty"`

	// DecisionReason captures the structured reason for this decision.
	DecisionReason *PermissionDecisionReason `json:"decision_reason,omitempty"`

	// DenialTracking tracks denial state when available.
	// Used for auto-mode fallback behavior.
	DenialTracking *DenialTrackingState `json:"denial_tracking,omitempty"`
}

type PermissionRuleSource string

type PermissionRuleValue struct {
	// ToolName identifies the tool this rule targets.
	ToolName string `json:"tool_name"`

	// RuleContent carries optional content-specific matching handled by the tool.
	RuleContent string `json:"rule_content,omitempty"`
}

type PermissionUpdate struct {
	// Type is the update type.
	Type PermissionUpdateType `json:"type"`

	// Rules are the permission rule values to update.
	Rules []PermissionRuleValue `json:"rules"`

	// Behavior is the permission behavior.
	Behavior PermissionBehavior `json:"behavior"`

	// Destination is where to apply the rules.
	Destination PermissionRuleSource `json:"destination"`
}

type PermissionUpdateType string

type PlanRuntimeEvent struct {
	PlanID   string `json:"plan_id"`
	Slug     string `json:"slug"`
	Filename string `json:"filename"`
	Status   string `json:"status"`
	Version  int    `json:"version"`
	Content  string `json:"content,omitempty"`
}

type ProgressStream <-chan ToolProgress

type PromptCacheControl struct {
	Type  string `json:"type"`
	Scope string `json:"scope,omitempty"`
	TTL   string `json:"ttl,omitempty"`
}

type PromptFn func(ctx context.Context, request PromptRequest) (PromptResponse, error)

type PromptOption struct {
	// Label is the human-readable label
	Label string `json:"label"`

	// Value is the value to return if selected
	Value any `json:"value"`

	// Description is an optional description
	Description string `json:"description,omitempty"`
}

type PromptRequest struct {
	// Type is the type of prompt
	Type PromptType `json:"type"`

	// Message is the message to show the user
	Message string `json:"message"`

	// Options are the available options (for choice prompts)
	Options []PromptOption `json:"options,omitempty"`

	// Default is the default value
	Default any `json:"default,omitempty"`

	// Metadata contains additional information
	Metadata map[string]any `json:"metadata,omitempty"`
}

type PromptResponse struct {
	// Value is the user's response
	Value any `json:"value"`

	// Cancelled indicates if the user cancelled
	Cancelled bool `json:"cancelled"`

	// Metadata contains additional information
	Metadata map[string]any `json:"metadata,omitempty"`
}

type PromptType string

type RetryConfig struct {
	// MaxAttempts is the maximum number of attempts
	MaxAttempts int `json:"max_attempts"`

	// InitialBackoff is the initial backoff duration in milliseconds
	InitialBackoff int64 `json:"initial_backoff_ms"`

	// MaxBackoff is the maximum backoff duration in milliseconds
	MaxBackoff int64 `json:"max_backoff_ms"`

	// BackoffMultiplier multiplies the backoff after each attempt
	BackoffMultiplier float64 `json:"backoff_multiplier"`

	// RetryableErrors is a set of error codes that are retryable
	RetryableErrors map[ErrorCode]bool `json:"retryable_errors,omitempty"`
}

type Role string

type RuntimeEvent struct {
	Type RuntimeEventType `json:"type"`

	SessionID SessionID `json:"session_id,omitempty"`
	TurnID    TurnID    `json:"turn_id,omitempty"`

	// TurnNumber is 1-indexed for the active turn being processed.
	TurnNumber int `json:"turn_number,omitempty"`

	Timestamp time.Time `json:"timestamp,omitempty"`

	StopReason    string      `json:"stop_reason,omitempty"`
	ExecutionMode string      `json:"execution_mode,omitempty"`
	Usage         *TokenUsage `json:"usage,omitempty"`

	Chunk             *APIResponseChunk      `json:"chunk,omitempty"`
	ToolProgress      *ToolProgress          `json:"tool_progress,omitempty"`
	Browser           *BrowserRuntimeEvent   `json:"browser,omitempty"`
	PermissionRequest *ToolPermissionRequest `json:"permission_request,omitempty"`
	PromptRequest     *PromptRequest         `json:"prompt_request,omitempty"`
	PlanEvent         *PlanRuntimeEvent      `json:"plan_event,omitempty"`
	TaskEvent         *TaskRuntimeEvent      `json:"task_event,omitempty"`

	// AgentToolUseID is set when this event originates from a sub-agent.
	// It identifies the parent agent tool_use block that spawned the sub-agent.
	AgentToolUseID string `json:"agent_tool_use_id,omitempty"`

	// GoalEvent carries structured payload for goal.updated events.
	GoalEvent *GoalRuntimeEvent `json:"goal_event,omitempty"`

	// AgentEvent carries structured payload for multi-agent collab events.
	AgentEvent *AgentRuntimeEvent `json:"agent_event,omitempty"`

	Error string `json:"error,omitempty"`
}

type RuntimeEventType string

type SafetyCheckResult struct {
	// IsDangerous indicates the pattern is unsafe.
	IsDangerous bool `json:"is_dangerous"`

	// Reason explains why the pattern is dangerous.
	Reason string `json:"reason"`

	// CheckType identifies which safety check produced this result.
	CheckType string `json:"check_type"`
}

type SafetyChecker interface {
	// CheckSafety evaluates whether a tool use is unsafe regardless of permission mode.
	CheckSafety(toolName string, input map[string]any) SafetyCheckResult
}

type SessionID string

type SessionMetadata struct {
	// ID is the unique session identifier
	ID SessionID `json:"id"`

	// Title is the human-readable session name (e.g. "untitled_session_1").
	// Generated once at creation; never reassigned automatically.
	Title string `json:"title,omitempty"`

	// Status is the current status
	Status SessionStatus `json:"status"`

	// CreatedAt is when the session was created
	CreatedAt time.Time `json:"created_at"`

	// UpdatedAt is when the session was last updated
	UpdatedAt time.Time `json:"updated_at"`

	// RootPath is the working directory for this session
	RootPath string `json:"root_path,omitempty"`

	// Model is the model being used
	Model string `json:"model,omitempty"`

	// TotalTurns is the total number of turns completed
	TotalTurns int `json:"total_turns"`

	// TotalTokens is the total tokens used across all turns
	TotalTokens int `json:"total_tokens"`

	// MaxTokens is the context window for the current model
	MaxTokens int `json:"max_tokens,omitempty"`

	// CompactCount tracks how many times we've compacted
	CompactCount int `json:"compact_count"`

	// LastCompactedAt tracks when we last compacted
	LastCompactedAt *time.Time `json:"last_compacted_at,omitempty"`

	// Additional metadata
	Additional map[string]any `json:"additional,omitempty"`

	// SchemaVersion is the schema version of this persisted metadata.
	// Zero means pre-versioning (treat as v0 / legacy).
	SchemaVersion int `json:"schema_version,omitempty"`
}

type SessionStatus string

type SetupData struct {
	SessionID      string `json:"session_id"`
	InitialMessage string `json:"initial_message,omitempty"`
}

type StopFailureData struct {
	Reason string `json:"reason"`
	Error  error  `json:"error,omitempty"`
}

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

type SubagentData struct {
	AgentID   string `json:"agent_id"`
	AgentName string `json:"agent_name"`
	ParentID  string `json:"parent_id,omitempty"`
	TaskType  string `json:"task_type,omitempty"`
	IsFork    bool   `json:"is_fork"`
}

type SystemPromptBlock struct {
	Type         string              `json:"type"`
	Text         string              `json:"text"`
	CacheControl *PromptCacheControl `json:"cache_control,omitempty"`
}

type TaskData struct {
	TaskID   string `json:"task_id"`
	TaskType string `json:"task_type"`
	TaskName string `json:"task_name"`
	Status   string `json:"status"`
	Result   any    `json:"result,omitempty"`
	Error    error  `json:"error,omitempty"`
}

type TaskRuntimeEvent struct {
	TaskID  string `json:"task_id"`
	Action  string `json:"action"`
	Status  string `json:"status,omitempty"`
	Subject string `json:"subject,omitempty"`
}

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

type ThinkingContent struct {
	Thinking string `json:"thinking"`
}

type TokenUsage struct {
	InputTokens  int `json:"input_tokens"`
	OutputTokens int `json:"output_tokens"`

	// CachedTokens represents tokens served from cache (OpenAI style).
	CachedTokens int `json:"cached_tokens,omitempty"`

	// CacheReadInputTokens is the number of tokens read from the Anthropic
	// prompt cache (served at reduced cost). Set by Anthropic responses.
	CacheReadInputTokens int `json:"cache_read_input_tokens,omitempty"`

	// CacheCreationInputTokens is the number of tokens written into the
	// Anthropic prompt cache (billed at a 25% premium on first write).
	CacheCreationInputTokens int `json:"cache_creation_input_tokens,omitempty"`
}

type ToolOutput interface {
	// Bytes returns the output as bytes
	Bytes() []byte

	// String returns the output as a string
	String() string

	// Reader returns a reader for the output
	Reader() io.Reader
}

type ToolPermissionIntent string

type ToolPermissionRequest struct {
	// ToolName is the name of the tool being checked.
	ToolName string `json:"tool_name"`

	// Description is a human-readable explanation for the approval UI.
	Description string `json:"description,omitempty"`

	// ToolInput is the candidate tool input.
	ToolInput map[string]any `json:"tool_input"`

	// ToolUseID identifies the tool use when available.
	ToolUseID string `json:"tool_use_id,omitempty"`

	// SessionID identifies the session when available.
	SessionID SessionID `json:"session_id,omitempty"`

	// TurnID identifies the turn when available.
	TurnID TurnID `json:"turn_id,omitempty"`

	// PermissionMode is the active permission mode.
	PermissionMode PermissionMode `json:"permission_mode,omitempty"`

	// WorkingDirectory is the working directory visible to the tool runtime.
	WorkingDirectory string `json:"working_directory,omitempty"`

	// IsToolRunningInSandbox indicates whether the tool will run inside a sandbox.
	// Used for sandbox auto-allow logic.
	IsToolRunningInSandbox bool `json:"is_tool_running_in_sandbox,omitempty"`

	// Stage identifies which permission stage is being resolved.
	Stage ToolPermissionStage `json:"stage,omitempty"`

	// Intent identifies the decision kind requested for the stage.
	Intent ToolPermissionIntent `json:"intent,omitempty"`

	// Metadata carries optional runtime metadata.
	Metadata map[string]any `json:"metadata,omitempty"`
}

type ToolPermissionStage string

type ToolProgress struct {
	// ToolName is the name of the tool
	ToolName string `json:"tool_name,omitempty"`

	// ToolUseID identifies the concrete tool call instance when available.
	ToolUseID string `json:"tool_use_id,omitempty"`

	// Stage indicates the current stage
	Stage ToolProgressStage `json:"stage"`

	// Message is a human-readable progress message
	Message string `json:"message,omitempty"`

	// PercentComplete is 0-100
	PercentComplete float64 `json:"percent_complete,omitempty"`

	// Metadata contains additional progress information
	Metadata map[string]any `json:"metadata,omitempty"`
}

type ToolProgressStage string

type ToolResult struct {
	// Data contains the result data
	// The specific type depends on the tool
	Data any `json:"data"`

	// Error contains any error that occurred
	Error error `json:"error,omitempty"`

	// Metadata contains additional result information
	Metadata *ToolResultMetadata `json:"metadata,omitempty"`
}

type ToolResultContent struct {
	ToolUseID string          `json:"tool_use_id"`
	Content   string          `json:"content"`
	IsError   bool            `json:"is_error,omitempty"`
	Metadata  *map[string]any `json:"metadata,omitempty"`
}

type ToolResultMetadata struct {
	// ContentReplacement indicates the result was too large and replaced
	ContentReplacement *ContentReplacementState `json:"content_replacement,omitempty"`

	// ExecutionDuration is how long the tool took to run
	ExecutionDuration int64 `json:"execution_duration_ms,omitempty"`

	// Additional metadata
	Additional map[string]any `json:"additional,omitempty"`
}

type ToolUseContent struct {
	ID       string          `json:"id"`
	Name     string          `json:"name"`
	Input    map[string]any  `json:"input"`
	Metadata *map[string]any `json:"metadata,omitempty"`
}

type TranscriptEntry struct {
	// ID uniquely identifies this entry
	ID MessageID `json:"id"`

	// Type is the type of entry
	Type EntryType `json:"type"`

	// Role is the message role (for message entries)
	Role Role `json:"role,omitempty"`

	// Content is the message content (for message entries)
	Content []ContentBlock `json:"content,omitempty"`

	// Timestamp is when this entry was created
	Timestamp time.Time `json:"timestamp"`

	// TurnID indicates which turn this belongs to
	TurnID TurnID `json:"turn_id,omitempty"`

	// Metadata contains additional information
	Metadata map[string]any `json:"metadata,omitempty"`
}

type TurnID string

type TurnMetadata struct {
	// TurnID is the unique turn identifier
	TurnID TurnID `json:"turn_id"`

	// SessionID is the parent session
	SessionID SessionID `json:"session_id"`

	// TurnNumber is the sequential turn number (1-indexed)
	TurnNumber int `json:"turn_number"`

	// StartedAt is when the turn started
	StartedAt time.Time `json:"started_at"`

	// CompletedAt is when the turn completed
	CompletedAt *time.Time `json:"completed_at,omitempty"`

	// StopReason is why the turn stopped
	StopReason string `json:"stop_reason,omitempty"`

	// ToolUses is the number of tools used in this turn
	ToolUses int `json:"tool_uses,omitempty"`

	// InputTokens is the tokens used for input
	InputTokens int `json:"input_tokens"`

	// OutputTokens is the tokens used for output
	OutputTokens int `json:"output_tokens"`

	// IsCompacted indicates if this turn was after a compaction
	IsCompacted bool `json:"is_compacted"`

	// Additional metadata
	Additional map[string]any `json:"additional,omitempty"`
}

type UserPromptSubmitData struct {
	Prompt         string `json:"prompt"`
	SessionID      string `json:"session_id"`
	IsFirstMessage bool   `json:"is_first_message"`
}

type WorktreeData struct {
	WorktreePath string `json:"worktree_path"`
	BaseBranch   string `json:"base_branch,omitempty"`
}