config

type AgentID string

type AssetContext struct {
	Agent      AgentID
	PluginRoot string
	LookupEnv  func(string) (string, bool)
}

type CircuitBreakerConfig struct {
	Enabled          bool   `json:"enabled"`
	FailureThreshold int    `json:"failureThreshold"` // failures before opening
	Timeout          string `json:"timeout"`          // time to wait in open state, e.g. "30s"
	SuccessThreshold int    `json:"successThreshold"` // successes needed in half-open
}

type Code string

type Config struct {
	Notifications NotificationsConfig   `json:"notifications"`
	Statuses      map[string]StatusInfo `json:"statuses"`
	Debug         DebugConfig           `json:"debug,omitempty"`
}

type DebugConfig struct {
	Benchmark bool `json:"benchmark"` // Enable benchmark timing output to log file
}

type DesktopConfig struct {
	Enabled          bool    `json:"enabled"`
	Sound            bool    `json:"sound"`
	TerminalBell     *bool   `json:"terminalBell"`          // Send BEL to /dev/tty for terminal tab indicators (default: true)
	Volume           float64 `json:"volume"`                // Volume level 0.0-1.0, default 1.0 (full volume)
	AudioDevice      string  `json:"audioDevice"`           // Audio output device name (empty = system default)
	AppIcon          string  `json:"appIcon"`               // Path to app icon
	ClickToFocus     bool    `json:"clickToFocus"`          // macOS/Linux/Windows: activate the originating terminal window on notification click (default: true)
	ShowSessionLabel *bool   `json:"showSessionLabel"`      // Include the "[name id]" session label in the notification title (default: true)
	TerminalBundleID string  `json:"terminalBundleId"`      // macOS: override auto-detected terminal bundle ID (empty = auto)
	ZellijFocus      string  `json:"zellijFocus,omitempty"` // Linux: "auto" (default), "pane" (zellij 0.44.1+), "tab" (legacy), "off"
}

type Diagnostic struct {
	Code Code   `json:"code"`
	Path string `json:"path,omitempty"`
}

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

type EditRequest struct {
	Env            EnvSnapshot
	Assets         AssetContext
	ExpectRevision string
	Edits          Edits
}

type Edits struct {
	Set    map[string]json.RawMessage `json:"set,omitempty"`
	Remove []string                   `json:"remove,omitempty"`
}

type EnvSnapshot struct {
	GOOS    string
	Vars    map[string]string
	Lstat   func(string) (fs.FileInfo, error)
	ReadDir func(string) ([]fs.DirEntry, error)
	// Canonicalize resolves existing ancestors while preserving the final entry.
	Canonicalize func(string) (string, error)
	// contains filtered or unexported fields
}

type Error struct {
	Code    Code
	Path    string
	Pointer string `json:"-"`
	Offset  int64
	// contains filtered or unexported fields
}

type HistoricalCandidate struct {
	Path            string `json:"path"`
	BaselinePath    string `json:"baselinePath,omitempty"`
	BaselineSHA256  string `json:"baselineSHA256,omitempty"`
	TrustedBaseline []byte `json:"-"`
}

type InitRequest struct {
	Env    EnvSnapshot
	Assets AssetContext
	Legacy LegacyContext
	// From is an explicit raw import source, used only for an absent target.
	From string
}

type Inspection struct {
	Selection     Selection     `json:"selection"`
	Revision      string        `json:"revision,omitempty"`
	SchemaVersion int           `json:"schemaVersion,omitempty"`
	Valid         bool          `json:"valid"`
	ErrorCode     Code          `json:"errorCode,omitempty"`
	Settings      *SafeSettings `json:"settings,omitempty"`
}

type LegacyContext struct{ Candidates []HistoricalCandidate }

type NotificationsConfig struct {
	Desktop                                     DesktopConfig    `json:"desktop"`
	Webhook                                     WebhookConfig    `json:"webhook"`
	SuppressQuestionAfterTaskCompleteSeconds    *int             `json:"suppressQuestionAfterTaskCompleteSeconds"`
	SuppressQuestionAfterAnyNotificationSeconds *int             `json:"suppressQuestionAfterAnyNotificationSeconds"`
	NotifyOnSubagentStop                        bool             `json:"notifyOnSubagentStop"`          // Send notifications when subagents (Task tool) complete, default: false. Requires suppressForSubagents=false to take effect.
	SuppressForSubagents                        *bool            `json:"suppressForSubagents"`          // Suppress subagent (SubagentStop) notifications, and Stop notifications whose transcript_path is a subagent/teammate transcript; default: true. Overrides notifyOnSubagentStop.
	NotifyOnTextResponse                        *bool            `json:"notifyOnTextResponse"`          // Send notifications for text-only responses (no tools), default: true
	RespectJudgeMode                            *bool            `json:"respectJudgeMode"`              // Honor CLAUDE_HOOK_JUDGE_MODE=true env var to suppress notifications, default: true
	SuppressFilters                             []SuppressFilter `json:"suppressFilters,omitempty"`     // Rules for suppressing notifications by status/branch/folder
	TeamMode                                    string           `json:"teamMode,omitempty"`            // Team mode: "always" (no suppression, default), "wait-all" (suppress lead, notify when all idle), "never" (silent in team mode)
	NotifyOnlyWhenUnfocused                     *bool            `json:"notifyOnlyWhenUnfocused"`       // Suppress desktop notifications while the terminal window running Claude Code has OS focus, default: false
	NotifyDelaySeconds                          *int             `json:"notifyDelaySeconds"`            // Wait N seconds before delivering a desktop notification (paired with notifyOnlyWhenUnfocused, it re-checks focus after the wait), default: 0
	RespectDoNotDisturb                         *string          `json:"respectDoNotDisturb,omitempty"` // How to treat the desktop's Do Not Disturb state: "off" (default), "silent" (deliver the banner, skip the sound), "suppress" (skip the notification entirely)
	RespectDisplaySleep                         *bool            `json:"respectDisplaySleep"`           // Skip the plugin's own sound while every display is asleep (macOS only), default: false
}

type PrepareGlobalResult struct {
	Source         string
	Changed, Ready bool
}

type RateLimitConfig struct {
	Enabled           bool `json:"enabled"`
	RequestsPerMinute int  `json:"requestsPerMinute"`
}

type ReadRequest struct {
	Env          EnvSnapshot
	Assets       AssetContext
	Legacy       LegacyContext
	ReadSnapshot func(path string, limit int) (Snapshot, error)
}

type Result struct {
	Selection  Selection `json:"selection"`
	Revision   string    `json:"revision,omitempty"`
	Changed    bool      `json:"changed"`
	BackupPath string    `json:"backupPath,omitempty"`
}

type RetryConfig struct {
	Enabled        bool   `json:"enabled"`
	MaxAttempts    int    `json:"maxAttempts"`
	InitialBackoff string `json:"initialBackoff"` // e.g. "1s"
	MaxBackoff     string `json:"maxBackoff"`     // e.g. "10s"
}

type SafeSettings struct {
	DesktopEnabled bool                  `json:"desktopEnabled"`
	DesktopSound   bool                  `json:"desktopSound"`
	Volume         float64               `json:"volume"`
	Statuses       map[string]SafeStatus `json:"statuses"`
}

type SafeStatus struct {
	Enabled        *bool `json:"enabled"`
	DesktopEnabled *bool `json:"desktopEnabled"`
	WebhookEnabled *bool `json:"webhookEnabled"`
}

type Selection struct {
	Path        string       `json:"path"`
	Source      string       `json:"source"`
	Exists      bool         `json:"exists"`
	Diagnostics []Diagnostic `json:"diagnostics,omitempty"`
}

type Snapshot struct {
	Bytes        []byte
	PhysicalPath string
}

type StatusChannelConfig struct {
	Enabled *bool `json:"enabled,omitempty"` // nil = inherit default enabled behavior
}

type StatusInfo struct {
	Enabled *bool                `json:"enabled,omitempty"` // nil = true (default for backward compatibility)
	Desktop *StatusChannelConfig `json:"desktop,omitempty"`
	Webhook *StatusChannelConfig `json:"webhook,omitempty"`
	Title   string               `json:"title"`
	Sound   string               `json:"sound"`
}

type SuppressFilter struct {
	Name      string  `json:"name,omitempty"`
	Status    *string `json:"status,omitempty"`
	GitBranch *string `json:"gitBranch"` // no omitempty — nil means "any", "" means "no branch"
	Folder    *string `json:"folder,omitempty"`
}

type UpdatePreflightRequest struct {
	Env                  EnvSnapshot           `json:"-"`
	Assets               AssetContext          `json:"-"`
	ActiveBundleRoots    []string              `json:"activeBundleRoots"`
	RefreshDirs          []string              `json:"refreshDirs"`
	ProtectedPaths       []string              `json:"protectedPaths"`
	HistoricalCandidates []HistoricalCandidate `json:"historicalCandidates"`
}

type UpdatePreflightResult struct {
	Status      string       `json:"status"`
	Selection   Selection    `json:"selection"`
	Diagnostics []Diagnostic `json:"diagnostics,omitempty"`
}

type WebhookConfig struct {
	Enabled        bool                   `json:"enabled"`
	Preset         string                 `json:"preset"`
	URL            string                 `json:"url"`
	ChatID         string                 `json:"chat_id"`
	Format         string                 `json:"format"`
	Headers        map[string]string      `json:"headers"`
	PayloadFields  map[string]interface{} `json:"payloadFields,omitempty"`
	Retry          RetryConfig            `json:"retry"`
	CircuitBreaker CircuitBreakerConfig   `json:"circuitBreaker"`
	RateLimit      RateLimitConfig        `json:"rateLimit"`
}