claudecode

type AgentDefinition struct {
	Description string   `json:"description"`
	Prompt      string   `json:"prompt"`
	Tools       []string `json:"tools,omitzero"`
	Model       string   `json:"model,omitzero"` // "sonnet", "opus", "haiku", "inherit"
}

type AssistantMessage struct {
	Content         []ContentBlock        `json:"content"`
	Model           string                `json:"model"`
	ParentToolUseID string                `json:"parent_tool_use_id,omitzero"`
	Error           AssistantMessageError `json:"error,omitzero"`
}

type AssistantMessageError string

type BaseHookInput struct {
	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,omitzero"`
}

type Beta string

type CanUseToolFunc func(ctx context.Context, toolName string, input map[string]any, permCtx ToolPermissionContext) (PermissionResult, error)

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

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

type ControlCancelRequest struct {
	Type      string `json:"type"`
	RequestID string `json:"request_id"`
}

type ControlRequest struct {
	Type      string          `json:"type"`
	RequestID string          `json:"request_id"`
	Request   json.RawMessage `json:"request"`
}

type ControlResponse struct {
	Type     string          `json:"type"`
	Response json.RawMessage `json:"response"`
}

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

type HookCallback func(ctx context.Context, input HookInput, toolUseID *string) (HookOutput, error)

type HookEvent string

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

type HookMatcher struct {
	// Matcher is a tool name pattern (e.g., "Bash", "Write|MultiEdit|Edit").
	Matcher string
	// Hooks are the callback functions to invoke.
	Hooks []HookCallback
	// Timeout is the maximum time to wait for the hook (default: 60s).
	Timeout time.Duration
}

type HookOutput struct {
	// Async execution (mutually exclusive with sync fields)
	Async        bool `json:"async,omitzero"`
	AsyncTimeout int  `json:"asyncTimeout,omitzero"` // milliseconds

	// Sync control fields
	// Continue is nil to use protocol default (true), or explicitly set to control flow.
	// The protocol specifies that omitting this field means "continue".
	Continue       *bool  `json:"continue,omitzero"`
	SuppressOutput bool   `json:"suppressOutput,omitzero"`
	StopReason     string `json:"stopReason,omitzero"`

	// Decision fields
	Decision      string `json:"decision,omitzero"` // "block"
	SystemMessage string `json:"systemMessage,omitzero"`
	Reason        string `json:"reason,omitzero"`

	// Event-specific output
	HookSpecificOutput any `json:"hookSpecificOutput,omitzero"`
}

type InputContent struct {
	Role    string `json:"role"`
	Content string `json:"content"`
}

type InputMessage struct {
	Type            string       `json:"type"`
	Message         InputContent `json:"message"`
	ParentToolUseID string       `json:"parent_tool_use_id,omitzero"`
	SessionID       string       `json:"session_id,omitzero"`
}

type JSONDecodeError struct {
	Line          string
	OriginalError error
}

type MCPHTTPConfig struct {
	URL     string            `json:"url"`
	Headers map[string]string `json:"headers,omitzero"`
}

type MCPSDKConfig struct {
	Name  string
	Tools []chat.Tool
}

type MCPSSEConfig struct {
	URL     string            `json:"url"`
	Headers map[string]string `json:"headers,omitzero"`
}

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

type MCPStdioConfig struct {
	Command string            `json:"command"`
	Args    []string          `json:"args,omitzero"`
	Env     map[string]string `json:"env,omitzero"`
}

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

type MessageOrError struct {
	Message Message
	Raw     []byte
	Err     error
}

type MessageParseError struct {
	Message string
	Data    map[string]any
}

type NotificationInput struct {
	BaseHookInput
	Message          string `json:"message"`
	Title            string `json:"title"`
	NotificationType string `json:"notification_type"`
}

type NotificationSpecificOutput struct {
	HookEventName     string `json:"hookEventName"` // "Notification"
	AdditionalContext string `json:"additionalContext,omitzero"`
}

type Option func(*Options)

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

type PermissionAllow struct {
	UpdatedInput       map[string]any
	UpdatedPermissions []PermissionUpdate
}

type PermissionDeny struct {
	Message   string
	Interrupt bool
}

type PermissionMode string

type PermissionRequestInput struct {
	BaseHookInput
	ToolName              string         `json:"tool_name"`
	ToolInput             map[string]any `json:"tool_input"`
	PermissionSuggestions []any          `json:"permission_suggestions,omitzero"`
}

type PermissionRequestSpecificOutput struct {
	HookEventName string         `json:"hookEventName"` // "PermissionRequest"
	Decision      map[string]any `json:"decision,omitzero"`
}

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

type PermissionRuleValue struct {
	ToolName    string
	RuleContent string
}

type PermissionUpdate struct {
	Type        string // "addRules", "replaceRules", "removeRules", "setMode", "addDirectories", "removeDirectories"
	Rules       []PermissionRuleValue
	Behavior    string // "allow", "deny", "ask"
	Mode        PermissionMode
	Directories []string
	Destination string // "userSettings", "projectSettings", "localSettings", "session"
}

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

type PostToolUseFailureInput struct {
	BaseHookInput
	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"`
}

type PostToolUseFailureSpecificOutput struct {
	HookEventName     string `json:"hookEventName"` // "PostToolUseFailure"
	AdditionalContext string `json:"additionalContext,omitzero"`
}

type PostToolUseInput struct {
	BaseHookInput
	ToolName     string         `json:"tool_name"`
	ToolInput    map[string]any `json:"tool_input"`
	ToolResponse any            `json:"tool_response"`
	ToolUseID    string         `json:"tool_use_id"`
}

type PostToolUseSpecificOutput struct {
	HookEventName        string `json:"hookEventName"` // "PostToolUse"
	AdditionalContext    string `json:"additionalContext,omitzero"`
	UpdatedMCPToolOutput any    `json:"updatedMCPToolOutput,omitzero"`
}

type PreCompactInput struct {
	BaseHookInput
	Trigger            string `json:"trigger"` // "manual" or "auto"
	CustomInstructions string `json:"custom_instructions,omitzero"`
}

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

type PreToolUseSpecificOutput struct {
	HookEventName            string         `json:"hookEventName"`               // "PreToolUse"
	PermissionDecision       string         `json:"permissionDecision,omitzero"` // "allow", "deny", "ask"
	PermissionDecisionReason string         `json:"permissionDecisionReason,omitzero"`
	UpdatedInput             map[string]any `json:"updatedInput,omitzero"`
	AdditionalContext        string         `json:"additionalContext,omitzero"`
}

type ProcessError struct {
	ExitCode int
	Stderr   string
}

type ResultMessage struct {
	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,omitzero"`
	Usage            *UsageStats `json:"usage,omitzero"`
	Result           string      `json:"result,omitzero"`
	StructuredOutput any         `json:"structured_output,omitzero"`
}

type SandboxIgnoreViolations struct {
	File    []string `json:"file,omitzero"`
	Network []string `json:"network,omitzero"`
}

type SandboxNetworkConfig struct {
	AllowUnixSockets    []string `json:"allowUnixSockets,omitzero"`
	AllowAllUnixSockets bool     `json:"allowAllUnixSockets,omitzero"`
	AllowLocalBinding   bool     `json:"allowLocalBinding,omitzero"`
	HTTPProxyPort       int      `json:"httpProxyPort,omitzero"`
	SOCKSProxyPort      int      `json:"socksProxyPort,omitzero"`
}

type SandboxOptions struct {
	// VirtualEnvPath is the absolute path to a Python virtualenv to activate.
	// When set, the sandbox will:
	//   - Set VIRTUAL_ENV to this path
	//   - Prepend the virtualenv's bin directory to PATH
	//   - Mount the virtualenv directory as read-only
	// This enables Python scripts executed by Claude Code's Bash tool to use
	// packages installed in the virtualenv.
	VirtualEnvPath string

	// SessionDisplayDir is the host path to a session-specific directory for
	// generated images and visualizations. When set, the sandbox will mount
	// this directory as read-write at <workDir>/session-display/. Claude Code
	// can then save images to session-display/ which will be accessible via
	// the Display tool.
	SessionDisplayDir string

	// MplConfigDir is the absolute path to a matplotlib configuration directory.
	// When set, the sandbox will:
	//   - Mount this directory as read-write
	//   - Set the MPLCONFIGDIR environment variable
	// This prevents matplotlib from trying to write to ~/.matplotlib (which
	// is not writable in the sandbox) and allows font cache persistence.
	MplConfigDir string
}

type SandboxSettings struct {
	Enabled                   bool                     `json:"enabled,omitzero"`
	AutoAllowBashIfSandboxed  bool                     `json:"autoAllowBashIfSandboxed,omitzero"`
	ExcludedCommands          []string                 `json:"excludedCommands,omitzero"`
	AllowUnsandboxedCommands  bool                     `json:"allowUnsandboxedCommands,omitzero"`
	Network                   *SandboxNetworkConfig    `json:"network,omitzero"`
	IgnoreViolations          *SandboxIgnoreViolations `json:"ignoreViolations,omitzero"`
	EnableWeakerNestedSandbox bool                     `json:"enableWeakerNestedSandbox,omitzero"`
}

type SettingSource string

type StopInput struct {
	BaseHookInput
	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,omitzero"`
}

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

type SubagentStartSpecificOutput struct {
	HookEventName     string `json:"hookEventName"` // "SubagentStart"
	AdditionalContext string `json:"additionalContext,omitzero"`
}

type SubagentStopInput struct {
	BaseHookInput
	StopHookActive      bool   `json:"stop_hook_active"`
	AgentID             string `json:"agent_id"`
	AgentTranscriptPath string `json:"agent_transcript_path"`
	AgentType           string `json:"agent_type"`
}

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

type SystemMessage struct {
	Subtype string         `json:"subtype"`
	Data    map[string]any `json:"data,omitzero"`
}

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

type ThinkingAdaptive struct{}

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

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

type ThinkingDisabled struct{}

type ThinkingEnabled struct {
	BudgetTokens int
}

type ToolPermissionContext struct {
	Suggestions []PermissionUpdate
	BlockedPath string // path that triggered the permission check
}

type ToolResultBlock struct {
	ToolUseID string `json:"tool_use_id"`
	Content   any    `json:"content,omitzero"` // string or []ContentBlock
	IsError   bool   `json:"is_error,omitzero"`
}

type ToolUseBlock struct {
	ID    string         `json:"id"`
	Name  string         `json:"name"`
	Input map[string]any `json:"input"`
}

type Transport interface {
	// Connect establishes the connection to Claude Code.
	Connect(ctx context.Context) error

	// Write sends data to the transport.
	Write(ctx context.Context, data string) error

	// ReadMessages returns a channel that yields messages from the transport.
	// The channel is closed when the transport is closed or an error occurs.
	ReadMessages(ctx context.Context) <-chan MessageOrError

	// EndInput signals the end of input (closes stdin for process transports).
	EndInput(ctx context.Context) error

	// Close closes the transport and releases resources.
	Close(ctx context.Context) error

	// IsReady returns true if the transport is ready for communication.
	IsReady() bool
}

type UnknownContentBlock struct {
	Type string         `json:"type"`
	Data map[string]any `json:"-"` // Raw data preserved for inspection
}

type UsageStats struct {
	InputTokens  int `json:"input_tokens"`
	OutputTokens int `json:"output_tokens"`
	CacheRead    int `json:"cache_read,omitzero"`
	CacheWrite   int `json:"cache_write,omitzero"`
}

type UserMessage struct {
	Content         any    `json:"-"` // string or []ContentBlock
	UUID            string `json:"uuid,omitzero"`
	ParentToolUseID string `json:"parent_tool_use_id,omitzero"`
	ToolUseResult   any    `json:"tool_use_result,omitzero"` // map[string]any or []any
}

type UserPromptSubmitInput struct {
	BaseHookInput
	Prompt string `json:"prompt"`
}

type UserPromptSubmitSpecificOutput struct {
	HookEventName     string `json:"hookEventName"` // "UserPromptSubmit"
	AdditionalContext string `json:"additionalContext,omitzero"`
}