shared

type AccountInfo struct {
	Email            string `json:"email,omitempty"`
	Organization     string `json:"organization,omitempty"`
	SubscriptionType string `json:"subscriptionType,omitempty"`
	TokenSource      string `json:"tokenSource,omitempty"`
	ApiKeySource     string `json:"apiKeySource,omitempty"`
}

type AgentDefinition struct {
	Description                        string               `json:"description"`
	Tools                              []string             `json:"tools,omitempty"`
	DisallowedTools                    []string             `json:"disallowedTools,omitempty"`
	Prompt                             string               `json:"prompt"`
	Model                              AgentModel           `json:"model,omitempty"`
	McpServers                         []AgentMcpServerSpec `json:"mcpServers,omitempty"`
	CriticalSystemReminderExperimental string               `json:"criticalSystemReminder_EXPERIMENTAL,omitempty"`
}

type AgentMcpServerSpec struct {
	Name    string                          `json:"name,omitempty"`
	Servers map[string]McpStdioServerConfig `json:"servers,omitempty"`
}

type AgentModel string

type AlwaysAvailableCLIChecker struct{}

type ApiKeySource string

type AssistantMessage struct {
	MessageType string                 `json:"type"`
	Content     []ContentBlock         `json:"content"`
	Model       string                 `json:"model"`
	Error       *AssistantMessageError `json:"error,omitempty"`
}

type AssistantMessageError string

type AsyncHookOutput struct {
	Async        bool `json:"async"`
	AsyncTimeout int  `json:"asyncTimeout,omitempty"` // seconds
}

type AuthStatusMessage struct {
	MessageType      string   `json:"type"` // always "auth_status"
	IsAuthenticating bool     `json:"isAuthenticating"`
	Output           []string `json:"output"`
	Error            *string  `json:"error,omitempty"`
	UUID             string   `json:"uuid"`
	SessionID        string   `json:"session_id"`
}

type BaseError struct {
	Reason string
	Inner  error
}

type BaseHookInput struct {
	SessionID      string `json:"session_id"`
	TranscriptPath string `json:"transcript_path"`
	Cwd            string `json:"cwd"`
	PermissionMode string `json:"permission_mode,omitempty"`
}

type BaseOptionFunc func(*BaseOptions)

type BaseOptions struct {
	// Model specifies the Claude model to use.
	Model string

	// SystemPrompt sets the system prompt. Replaces any existing system prompt.
	SystemPrompt string

	// AppendSystemPrompt appends to the system prompt.
	// Useful for adding domain-specific instructions to the base prompt.
	AppendSystemPrompt string

	// AllowedTools restricts which tools Claude can use.
	AllowedTools []string

	// PermissionMode sets the permission mode for file operations.
	PermissionMode string

	// ContextFiles provides files to include in the context.
	ContextFiles []string

	// CustomArgs provides additional CLI arguments.
	CustomArgs []string

	// Env contains environment variables to set for the subprocess.
	Env map[string]string

	// Cwd sets the working directory for the subprocess.
	// If empty, inherits parent process working directory.
	Cwd string

	// Tools configures tool availability.
	// Can be a preset ("claude_code") or explicit tool list.
	Tools *ToolsConfig

	// Stderr is a callback invoked for each stderr line from subprocess.
	// If nil, stderr goes to parent process stderr.
	Stderr func(line string)

	// CanUseTool is a callback for runtime permission checks.
	// Invoked before each tool use when permission mode requires it.
	CanUseTool CanUseToolCallback

	// Continue continues the most recent conversation.
	Continue bool

	// Resume is the session ID to resume.
	Resume string

	// ResumeSessionAt resumes at a specific message UUID.
	ResumeSessionAt string

	// ForkSession forks instead of continuing on resume.
	ForkSession bool

	// PersistSession saves sessions to disk (default: true).
	// Pointer to distinguish unset from false.
	PersistSession *bool

	// DisallowedTools are tools explicitly disallowed.
	DisallowedTools []string

	// MaxThinkingTokens limits thinking tokens.
	MaxThinkingTokens *int

	// MaxTurns limits conversation turns.
	MaxTurns *int

	// MaxBudgetUSD is the USD budget limit.
	MaxBudgetUSD *float64

	// FallbackModel is used if primary fails.
	FallbackModel string

	// AdditionalDirectories are extra accessible directories.
	AdditionalDirectories []string

	// Agent is the main thread agent name.
	Agent string

	// Agents are custom subagent definitions.
	Agents map[string]AgentDefinition

	// Betas are beta features to enable.
	Betas []string

	// EnableFileCheckpointing tracks file changes.
	EnableFileCheckpointing bool

	// OutputFormat is for structured responses.
	OutputFormat *OutputFormat

	// Plugins are plugin configurations.
	Plugins []PluginConfig

	// SdkPluginConfig is the full SDK plugin configuration.
	// Provides complete control over plugin behavior including
	// timeouts, concurrency limits, and custom configuration.
	SdkPluginConfig *SdkPluginConfig

	// SettingSources controls which settings to load.
	SettingSources []SettingSource

	// Sandbox is sandbox configuration.
	Sandbox *SandboxSettings

	// StrictMcpConfig enables strict MCP validation.
	StrictMcpConfig bool

	// AllowDangerouslySkipPermissions is required for bypass mode.
	AllowDangerouslySkipPermissions bool

	// PermissionPromptToolName is the MCP tool for permission prompts.
	PermissionPromptToolName string

	// McpServers are MCP server configurations.
	McpServers map[string]McpServerConfig

	// ExtraArgs are additional CLI arguments.
	ExtraArgs map[string]string

	// DebugWriter specifies where to write debug output from the CLI subprocess.
	// If nil (default), stderr is suppressed or isolated.
	// Common values: os.Stderr, io.Discard, or a custom io.Writer.
	DebugWriter io.Writer
}

type BufferOptionFunc func(*BufferOptions)

type BufferOptions struct {
	// BufferSize is the buffer size for message channels.
	BufferSize int

	// MaxMessages is the maximum number of messages to process.
	MaxMessages int
}

type CLIChecker interface {
	IsCLIAvailable() bool
}

type CLICheckerFunc func() bool

type CLINotFoundError struct {
	Path        string // Path that was checked
	Command     string // Command that failed to execute
	Suggestions []string
}

type CanUseToolCallback func(
	ctx context.Context,
	toolName string,
	toolInput map[string]any,
	opts CanUseToolOptions,
) (PermissionResult, error)

type CanUseToolOptions struct {
	Suggestions    []PermissionUpdate `json:"suggestions,omitempty"`
	BlockedPath    string             `json:"blockedPath,omitempty"`
	DecisionReason string             `json:"decisionReason,omitempty"`
	ToolUseID      string             `json:"toolUseID"`
	AgentID        string             `json:"agentID,omitempty"`
}

type CircuitBreaker interface {
	// Execute runs the given function if the circuit breaker allows it.
	Execute(ctx context.Context, fn func() error) error
	// State returns the current state of the circuit breaker.
	State() State
	// Reset manually resets the circuit breaker.
	Reset()
	// RecordFailure records a failure and potentially trips the circuit.
	RecordFailure()
	// RecordSuccess records a success and potentially resets the circuit.
	RecordSuccess()
}

type CircuitBreakerConfig struct {
	// FailureThreshold is the number of failures before tripping the circuit.
	FailureThreshold int
	// RecoveryTimeout is the time to wait before transitioning to half-open state.
	RecoveryTimeout time.Duration
	// HalfOpenMaxRequests is the maximum requests allowed in half-open state.
	HalfOpenMaxRequests int
}

type CompactBoundaryMessage struct {
	MessageType     string           `json:"type"`    // always "system"
	Subtype         string           `json:"subtype"` // always "compact_boundary"
	CompactMetadata *CompactMetadata `json:"compact_metadata,omitempty"`
	UUID            string           `json:"uuid"`
	SessionID       string           `json:"session_id"`
}

type CompactMetadata struct {
	Trigger   string `json:"trigger"` // "manual" | "auto"
	PreTokens int    `json:"pre_tokens"`
}

type ConfigScope string

type ConfigurationError struct {
	BaseError
	Field string
	Value string
}

type ConnectionError struct {
	BaseError
}

type ConnectionOptionFunc func(*ConnectionOptions)

type ConnectionOptions struct {
	// CLIPath specifies the path to the Claude CLI executable.
	// If empty, the CLI will be discovered in PATH.
	CLIPath string

	// CLICommand specifies the command to run the Claude CLI.
	// If empty, defaults to "claude".
	CLICommand string

	// Timeout specifies the timeout for operations.
	Timeout string

	// Env contains environment variables to set for the subprocess.
	Env map[string]string
}

type ConstructorFunc[T any, O any] func(opts *O) (T, error)

type ContentBlock interface {
	BlockType() string
}

type ContextKey string

type ContextResult[T any] struct {
	Value T
	Err   error
}

type DebugOptionFunc func(*DebugOptions)

type DebugOptions struct {
	// Trace enables detailed tracing of protocol messages.
	Trace bool

	// DisableCache disables message caching.
	DisableCache bool

	// CacheTTL sets the cache expiration time.
	CacheTTL string

	// Logger interface for logging operations.
	Logger Logger

	// EnableMetrics enables performance metrics collection.
	EnableMetrics bool
}

type DefaultFactoryHolder[T any, O any] struct {
	// contains filtered or unexported fields
}

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

type ExitReason string

type Factory[T any, O any] interface {
	// New creates a new instance of T with the given options.
	New(opts ...func(*O)) (T, error)
}

type FactoryFunc[T any, O any] func(opts ...func(*O)) (T, error)

type HookConfig struct {
	// Event is the hook event type this handler responds to.
	Event HookEvent
	// Matcher is an optional regex pattern to match tool names.
	// Only applies to tool-related events (PreToolUse, PostToolUse, etc.).
	// Empty string matches all tools.
	Matcher string
	// Handler is the function to execute when the hook fires.
	Handler HookHandler
	// Timeout overrides the default hook timeout (30s).
	// If zero, the default timeout is used.
	Timeout time.Duration
}

type HookEvent string

type HookEventMessage struct {
	Type           string         `json:"type"` // "hook_event"
	HookEventName  string         `json:"hook_event_name"`
	SessionID      string         `json:"session_id"`
	TranscriptPath string         `json:"transcript_path"`
	Cwd            string         `json:"cwd"`
	PermissionMode string         `json:"permission_mode,omitempty"`
	ToolName       string         `json:"tool_name,omitempty"`
	ToolInput      map[string]any `json:"tool_input,omitempty"`
	ToolUseID      string         `json:"tool_use_id,omitempty"`
	ToolResponse   any            `json:"tool_response,omitempty"`
	Error          string         `json:"error,omitempty"`

	// UserPromptSubmit fields
	Prompt string `json:"prompt,omitempty"`

	// Stop/SubagentStop fields
	StopHookActive bool `json:"stop_hook_active,omitempty"`

	// PreCompact fields
	Trigger            string  `json:"trigger,omitempty"`
	CustomInstructions *string `json:"custom_instructions,omitempty"`

	// SessionStart fields
	Source    string `json:"source,omitempty"`
	AgentType string `json:"agent_type,omitempty"`
	Model     string `json:"model,omitempty"`

	// SessionEnd fields
	Reason string `json:"reason,omitempty"`

	// Notification fields
	Message          string `json:"message,omitempty"`
	Title            string `json:"title,omitempty"`
	NotificationType string `json:"notification_type,omitempty"`

	// SubagentStart/SubagentStop fields
	AgentID             string `json:"agent_id,omitempty"`
	AgentTranscriptPath string `json:"agent_transcript_path,omitempty"`
}

type HookHandler func(ctx context.Context, input any) (*SyncHookOutput, error)

type HookOutput struct {
	Type           string `json:"type"` // "hook_response"
	ToolUseID      string `json:"tool_use_id,omitempty"`
	Continue       bool   `json:"continue"`
	SuppressOutput bool   `json:"suppress_output,omitempty"`
	Decision       string `json:"decision,omitempty"` // "approve" | "block"
	StopReason     string `json:"stop_reason,omitempty"`
	SystemMessage  string `json:"system_message,omitempty"`
	Reason         string `json:"reason,omitempty"`
}

type HookResponseMessage struct {
	MessageType string `json:"type"`    // always "system"
	Subtype     string `json:"subtype"` // always "hook_response"
	HookName    string `json:"hook_name"`
	HookEvent   string `json:"hook_event"`
	Stdout      string `json:"stdout"`
	Stderr      string `json:"stderr"`
	ExitCode    *int   `json:"exit_code,omitempty"`
	UUID        string `json:"uuid"`
	SessionID   string `json:"session_id"`
}

type JSONDecodeError struct {
	BaseError
	Line          int   // Line number where parsing failed
	Position      int   // Character position within the line
	OriginalError error // The underlying JSON decoder error
}

type Logger interface {
	Debugf(format string, args ...any)
	Infof(format string, args ...any)
	Warnf(format string, args ...any)
	Errorf(format string, args ...any)
}

type McpHttpServerConfig struct {
	Type    string            `json:"type"` // "http"
	URL     string            `json:"url"`
	Headers map[string]string `json:"headers,omitempty"`
}

type McpSSEServerConfig struct {
	Type    string            `json:"type"` // "sse"
	URL     string            `json:"url"`
	Headers map[string]string `json:"headers,omitempty"`
}

type McpSdkServerConfig struct {
	Type     string `json:"type"` // "sdk"
	Name     string `json:"name"`
	Instance any    `json:"-"` // MCP Server instance (not serialized)
}

type McpServerConfig interface {
	// contains filtered or unexported methods
}

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

type McpServerStatus struct {
	Name       string         `json:"name"`
	Status     string         `json:"status"` // "connected" | "failed" | "needs-auth" | "pending"
	ServerInfo *McpServerInfo `json:"serverInfo,omitempty"`
	Error      string         `json:"error,omitempty"`
}

type McpSetServersResult struct {
	Added   []string          `json:"added"`
	Removed []string          `json:"removed"`
	Errors  map[string]string `json:"errors"`
}

type McpStdioServerConfig struct {
	Type    string            `json:"type,omitempty"` // "stdio" (default)
	Command string            `json:"command"`
	Args    []string          `json:"args,omitempty"`
	Env     map[string]string `json:"env,omitempty"`
}

type Message interface {
	Type() string
}

type MessageIterator interface {
	// Next returns the next message in the stream.
	// Returns ErrNoMoreMessages when the stream is exhausted.
	// Returns context.Canceled or context.DeadlineExceeded if the context is cancelled.
	Next(ctx context.Context) (Message, error)
	// Close releases any resources held by the iterator.
	Close() error
}

type MessageParseError struct {
	BaseError
	Data        any    // The data that failed to parse
	MessageType string // Expected message type (if known)
}

type ModelError struct {
	BaseError
	Model           string   // The model that failed
	SupportedModels []string // List of supported models (if known)
}

type ModelInfo struct {
	Value       string `json:"value"`
	DisplayName string `json:"displayName"`
	Description string `json:"description"`
}

type ModelOptionFunc func(*ModelOptions)

type ModelOptions struct {
	// Model specifies the Claude model to use.
	Model string

	// PermissionMode sets the permission mode for file operations.
	PermissionMode string

	// ContextFiles specifies files to include in the context.
	ContextFiles []string

	// CustomArgs provides additional arguments for the Claude CLI.
	CustomArgs []string
}

type ModelUsage struct {
	InputTokens              int     `json:"inputTokens"`
	OutputTokens             int     `json:"outputTokens"`
	CacheReadInputTokens     int     `json:"cacheReadInputTokens"`
	CacheCreationInputTokens int     `json:"cacheCreationInputTokens"`
	WebSearchRequests        int     `json:"webSearchRequests"`
	CostUSD                  float64 `json:"costUSD"`
	ContextWindow            int     `json:"contextWindow"`
	MaxOutputTokens          int     `json:"maxOutputTokens"`
}

type NeverAvailableCLIChecker struct{}

type NopLogger struct{}

type NotificationHookInput struct {
	BaseHookInput
	HookEventName    string `json:"hook_event_name"` // always "Notification"
	Message          string `json:"message"`
	Title            string `json:"title,omitempty"`
	NotificationType string `json:"notification_type"`
}

type Options struct {
	// Model specifies the Claude model to use.
	Model string

	// CLIPath specifies the path to the Claude CLI executable.
	// If empty, the CLI will be discovered in PATH.
	CLIPath string

	// CLICommand specifies the command to run the Claude CLI.
	// If empty, defaults to "claude".
	CLICommand string

	// PermissionMode sets the permission mode for the session.
	PermissionMode string

	// ContextFiles specifies files to include in the context.
	ContextFiles []string

	// IncludePartialMessages enables streaming of partial messages during response generation.
	IncludePartialMessages bool

	// EnableStructuredOutput enables structured output mode.
	EnableStructuredOutput bool

	// Timeout specifies the timeout for operations.
	Timeout string

	// CustomArgs provides additional arguments for the Claude CLI.
	CustomArgs []string

	// Environment variables to set for the subprocess.
	Env map[string]string

	// Maximum number of messages to process before returning an error.
	MaxMessages int

	// Buffer size for message channels.
	BufferSize int

	// Logger interface for logging operations.
	Logger Logger

	// Enable performance metrics collection.
	EnableMetrics bool

	// Trace enables detailed tracing of protocol messages.
	Trace bool

	// DisableCache disables message caching.
	DisableCache bool

	// CacheTTL sets the cache expiration time.
	CacheTTL string
}

type OutputFormat struct {
	Type   string         `json:"type"` // "json_schema"
	Schema map[string]any `json:"schema"`
}

type ParserError struct {
	BaseError
	Line   int    // Line number where parsing failed
	Offset int    // Character offset within the line
	Data   string // Raw data that failed to parse
}

type PermissionBehavior string

type PermissionError struct {
	BaseError
	Tool      string // Tool that was denied (if applicable)
	Path      string // Path that was denied (if applicable)
	Operation string // Operation that was denied (e.g., "read", "write", "execute")
}

type PermissionMode string

type PermissionRequestHookInput struct {
	BaseHookInput
	HookEventName         string             `json:"hook_event_name"` // always "PermissionRequest"
	ToolName              string             `json:"tool_name"`
	ToolInput             any                `json:"tool_input"`
	PermissionSuggestions []PermissionUpdate `json:"permission_suggestions,omitempty"`
}

type PermissionResult struct {
	Behavior           PermissionBehavior `json:"behavior"` // "allow" or "deny"
	UpdatedInput       map[string]any     `json:"updatedInput,omitempty"`
	UpdatedPermissions []PermissionUpdate `json:"updatedPermissions,omitempty"`
	ToolUseID          string             `json:"toolUseID,omitempty"`
	Message            string             `json:"message,omitempty"`   // for deny
	Interrupt          bool               `json:"interrupt,omitempty"` // for deny
}

type PermissionResultOption func(*PermissionResult)

type PermissionRuleValue struct {
	ToolName    string  `json:"toolName"`
	RuleContent *string `json:"ruleContent,omitempty"`
}

type PermissionUpdate struct {
	Type        string                      `json:"type"` // "addRules", "replaceRules", "removeRules", "setMode", "addDirectories", "removeDirectories"
	Rules       []PermissionRuleValue       `json:"rules,omitempty"`
	Behavior    PermissionBehavior          `json:"behavior,omitempty"`
	Destination PermissionUpdateDestination `json:"destination,omitempty"`
	Mode        PermissionMode              `json:"mode,omitempty"`
	Directories []string                    `json:"directories,omitempty"`
}

type PermissionUpdateDestination string

type PluginConfig struct {
	Type string `json:"type"` // "local"
	Path string `json:"path"`
}

type PluginInfo struct {
	Name string `json:"name"`
	Path string `json:"path"`
}

type PostToolUseFailureHookInput struct {
	BaseHookInput
	HookEventName string         `json:"hook_event_name"` // always "PostToolUseFailure"
	ToolName      string         `json:"tool_name"`
	ToolInput     map[string]any `json:"tool_input"`
	ToolUseID     string         `json:"tool_use_id"`
	Error         string         `json:"error"`
	IsInterrupt   bool           `json:"is_interrupt,omitempty"`
}

type PostToolUseHookInput struct {
	BaseHookInput
	HookEventName string         `json:"hook_event_name"` // always "PostToolUse"
	ToolName      string         `json:"tool_name"`
	ToolInput     map[string]any `json:"tool_input"`
	ToolResponse  any            `json:"tool_response"`
	ToolUseID     string         `json:"tool_use_id"`
}

type PreCompactHookInput struct {
	BaseHookInput
	HookEventName      string  `json:"hook_event_name"` // always "PreCompact"
	Trigger            string  `json:"trigger"`         // "manual" | "auto"
	CustomInstructions *string `json:"custom_instructions"`
}

type PreToolUseHookInput struct {
	BaseHookInput
	HookEventName string         `json:"hook_event_name"` // always "PreToolUse"
	ToolName      string         `json:"tool_name"`
	ToolInput     map[string]any `json:"tool_input"`
	ToolUseID     string         `json:"tool_use_id"`
}

type ProcessError struct {
	BaseError
	PID     int
	Command string
	Signal  string // Signal that caused the process to exit (if applicable)
}

type ProtocolError struct {
	BaseError
	MessageType string
}

type RawControlMessage struct {
	MessageType string
	Data        map[string]any
}

type ResultMessage struct {
	MessageType       string                `json:"type"`
	Subtype           string                `json:"subtype"`
	DurationMs        int                   `json:"duration_ms"`
	DurationAPIMs     int                   `json:"duration_api_ms"`
	IsError           bool                  `json:"is_error"`
	NumTurns          int                   `json:"num_turns"`
	SessionID         string                `json:"session_id"`
	TotalCostUSD      *float64              `json:"total_cost_usd,omitempty"`
	Usage             *map[string]any       `json:"usage,omitempty"`
	Result            *string               `json:"result,omitempty"`
	StructuredOutput  any                   `json:"structured_output,omitempty"`
	ModelUsage        map[string]ModelUsage `json:"modelUsage,omitempty"`
	PermissionDenials []SDKPermissionDenial `json:"permission_denials,omitempty"`
	Errors            []string              `json:"errors,omitempty"` // for error subtypes
}

type RewindFilesResult struct {
	CanRewind    bool     `json:"canRewind"`
	Error        string   `json:"error,omitempty"`
	FilesChanged []string `json:"filesChanged,omitempty"`
	Insertions   int      `json:"insertions,omitempty"`
	Deletions    int      `json:"deletions,omitempty"`
}

type RipgrepConfig struct {
	Command string   `json:"command"`
	Args    []string `json:"args,omitempty"`
}

type SDKError interface {
	error
	Type() string
}

type SDKPermissionDenial struct {
	ToolName  string         `json:"tool_name"`
	ToolUseID string         `json:"tool_use_id"`
	ToolInput map[string]any `json:"tool_input"`
}

type SandboxConfig struct {
	Enabled                   bool                  `json:"enabled,omitempty"`
	AutoAllowBashIfSandboxed  bool                  `json:"autoAllowBashIfSandboxed,omitempty"`
	AllowUnsandboxedCommands  bool                  `json:"allowUnsandboxedCommands,omitempty"`
	Network                   *SandboxNetworkConfig `json:"network,omitempty"`
	IgnoreViolations          map[string][]string   `json:"ignoreViolations,omitempty"`
	EnableWeakerNestedSandbox bool                  `json:"enableWeakerNestedSandbox,omitempty"`
	ExcludedCommands          []string              `json:"excludedCommands,omitempty"`
	Ripgrep                   *RipgrepConfig        `json:"ripgrep,omitempty"`
}

type SandboxNetworkConfig struct {
	AllowedDomains      []string `json:"allowedDomains,omitempty"`
	AllowUnixSockets    []string `json:"allowUnixSockets,omitempty"`
	AllowAllUnixSockets bool     `json:"allowAllUnixSockets,omitempty"`
	AllowLocalBinding   bool     `json:"allowLocalBinding,omitempty"`
	HttpProxyPort       int      `json:"httpProxyPort,omitempty"`
	SocksProxyPort      int      `json:"socksProxyPort,omitempty"`
}

type SandboxSettings struct {
	Enabled    bool              `json:"enabled"`
	Type       string            `json:"type,omitempty"` // "docker", "nsjail", etc.
	Image      string            `json:"image,omitempty"`
	Options    map[string]string `json:"options,omitempty"`
	WorkingDir string            `json:"workingDir,omitempty"`
}

type SdkBeta string

type SdkPluginConfig struct {
	// Enabled controls whether the plugin is active.
	Enabled bool `json:"enabled"`

	// PluginPath is the filesystem path to the plugin.
	PluginPath string `json:"pluginPath"`

	// Config contains plugin-specific configuration.
	Config map[string]any `json:"config,omitempty"`

	// Timeout is the maximum time allowed for each plugin call.
	// Zero means no timeout.
	Timeout time.Duration `json:"timeout,omitempty"`

	// MaxConcurrent is the maximum number of concurrent plugin calls.
	// Zero means unlimited.
	MaxConcurrent int `json:"maxConcurrent,omitempty"`
}

type SessionEndHookInput struct {
	BaseHookInput
	HookEventName string `json:"hook_event_name"` // always "SessionEnd"
	Reason        string `json:"reason"`
}

type SessionStartHookInput struct {
	BaseHookInput
	HookEventName string `json:"hook_event_name"` // always "SessionStart"
	Source        string `json:"source"`          // "startup" | "resume" | "clear" | "compact"
	AgentType     string `json:"agent_type,omitempty"`
	Model         string `json:"model,omitempty"`
}

type SettingSource string

type SlashCommand struct {
	Name         string `json:"name"`
	Description  string `json:"description"`
	ArgumentHint string `json:"argumentHint"`
}

type State int

type StatusMessage struct {
	MessageType string  `json:"type"`    // always "system"
	Subtype     string  `json:"subtype"` // always "status"
	Status      *string `json:"status"`  // "compacting" | null
	UUID        string  `json:"uuid"`
	SessionID   string  `json:"session_id"`
}

type StopHookInput struct {
	BaseHookInput
	HookEventName  string `json:"hook_event_name"` // always "Stop"
	StopHookActive bool   `json:"stop_hook_active"`
}

type StreamEvent struct {
	UUID            string         `json:"uuid"`
	SessionID       string         `json:"session_id"`
	Event           map[string]any `json:"event"`
	ParentToolUseID *string        `json:"parent_tool_use_id,omitempty"`
}

type StreamIssue struct {
	UUID   string
	Type   string
	Detail string
}

type StreamStats struct {
	TotalMessages   int
	PartialMessages int
	Errors          int
	ProcessingTime  string // Duration in human-readable format
}

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

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

type SubagentStartHookInput struct {
	BaseHookInput
	HookEventName string `json:"hook_event_name"` // always "SubagentStart"
	AgentID       string `json:"agent_id"`
	AgentType     string `json:"agent_type"`
}

type SubagentStopHookInput struct {
	BaseHookInput
	HookEventName       string `json:"hook_event_name"` // always "SubagentStop"
	StopHookActive      bool   `json:"stop_hook_active"`
	AgentID             string `json:"agent_id"`
	AgentTranscriptPath string `json:"agent_transcript_path"`
}

type SyncHookOutput struct {
	Continue           bool           `json:"continue,omitempty"`
	SuppressOutput     bool           `json:"suppressOutput,omitempty"`
	StopReason         string         `json:"stopReason,omitempty"`
	Decision           string         `json:"decision,omitempty"` // "approve" | "block"
	SystemMessage      string         `json:"systemMessage,omitempty"`
	Reason             string         `json:"reason,omitempty"`
	HookSpecificOutput map[string]any `json:"hookSpecificOutput,omitempty"`
}

type SystemMessage struct {
	MessageType       string         `json:"type"`
	Subtype           string         `json:"subtype"`
	Data              map[string]any `json:"-"` // Preserve all original data
	Agents            []string       `json:"-"` // Populated when subtype is "init"
	Betas             []string       `json:"-"` // Populated when subtype is "init"
	ClaudeCodeVersion string         `json:"-"` // Populated when subtype is "init"
	Skills            []string       `json:"-"` // Populated when subtype is "init"
	Plugins           []PluginInfo   `json:"-"` // Populated when subtype is "init"
}

type TextBlock struct {
	MessageType string `json:"type"`
	Text        string `json:"text"`
}

type ThinkingBlock struct {
	MessageType string `json:"type"`
	Thinking    string `json:"thinking"`
	Signature   string `json:"signature"`
}

type TimeoutError struct {
	BaseError
	Operation string
	Timeout   string
}

type ToolProgressMessage struct {
	MessageType        string  `json:"type"` // always "tool_progress"
	ToolUseID          string  `json:"tool_use_id"`
	ToolName           string  `json:"tool_name"`
	ParentToolUseID    *string `json:"parent_tool_use_id,omitempty"`
	ElapsedTimeSeconds float64 `json:"elapsed_time_seconds"`
	UUID               string  `json:"uuid"`
	SessionID          string  `json:"session_id"`
}

type ToolResultBlock struct {
	MessageType string `json:"type"`
	ToolUseID   string `json:"tool_use_id"`
	Content     any    `json:"content"` // string or structured data
	IsError     *bool  `json:"is_error,omitempty"`
}

type ToolUseBlock struct {
	MessageType string         `json:"type"`
	ToolUseID   string         `json:"tool_use_id"`
	Name        string         `json:"name"`
	Input       map[string]any `json:"input"`
}

type ToolsConfig struct {
	Type   string   // "preset" | "explicit"
	Preset string   // "claude_code" (when Type == "preset")
	Tools  []string // Tool names (when Type == "explicit")
}

type UserMessage struct {
	MessageType     string  `json:"type"`
	Content         any     `json:"content"` // string or []ContentBlock
	UUID            *string `json:"uuid,omitempty"`
	ParentToolUseID *string `json:"parent_tool_use_id,omitempty"`
}

type UserPromptSubmitHookInput struct {
	BaseHookInput
	HookEventName string `json:"hook_event_name"` // always "UserPromptSubmit"
	Prompt        string `json:"prompt"`
}