hooks

type DecisionHookConfig struct {
	Name     string
	Matcher  DecisionMatcher
	Priority int // Lower = earlier evaluation
}

type DecisionHookFn func(event string, data map[string]interface{}) *HookDecision

type DecisionMatcher struct {
	Events    []string // Event types to match (e.g., "pre_tool", "post_tool")
	ToolNames []string // Tool names to match (e.g., "Bash", "Write", "Edit")
}

type Diagnostic struct {
	Line     int
	Column   int
	Severity int // 1=error, 2=warning, 3=info, 4=hint
	Code     string
	Message  string
}

type EnvelopeFn func(ctx context.Context, envelope EventEnvelope) error

type Event struct {
	Name      string
	Timestamp time.Time
	Data      map[string]interface{}
	Source    string
}

type EventBus struct {
	Hooks      map[string][]*LifecycleHook
	Listeners  map[string][]chan Event
	History    []Event
	MaxHistory int
	// contains filtered or unexported fields
}

type EventEnvelope struct {
	Timestamp     time.Time              `json:"timestamp"`
	Source        string                 `json:"source"`         // e.g. "hooks", "mission", "plugin"
	SessionID     string                 `json:"session_id"`     // session that triggered the event
	AgentID       string                 `json:"agent_id"`       // agent that triggered the event
	CorrelationID string                 `json:"correlation_id"` // traces across hook chains
	EventType     EventType              `json:"event_type"`
	Payload       map[string]interface{} `json:"payload"` // event-specific data
}

type EventStats struct {
	TotalEvents int
	ByType      map[string]int
	HookCount   int
	AsyncHooks  int
	AvgHookTime time.Duration
}

type EventType string

type Hook struct {
	Name     string
	Event    EventType
	Priority int                                                          // lower = earlier
	Fn       func(ctx context.Context, data map[string]interface{}) error // legacy
	FnV2     EnvelopeFn                                                   // typed envelope (preferred)
}

type HookDecision struct {
	Action        string          `json:"action"` // "allow", "deny", "modify", "instruct"
	Reason        string          `json:"reason,omitempty"`
	Message       string          `json:"message,omitempty"` // User-facing message (for deny/instruct)
	ModifiedInput json.RawMessage `json:"modified_input,omitempty"`
}

type LSPFeedbackProvider interface {
	// DiagnosticsForFile returns diagnostics for a file path.
	// Returns nil if no LSP server is available for the file type.
	DiagnosticsForFile(ctx context.Context, filePath string) ([]Diagnostic, error)
}

type LifecycleHook struct {
	ID       string
	Name     string
	Event    string
	Handler  func(Event) error
	Priority int
	Async    bool
	Enabled  bool
}

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

type WrappedDecisionHook struct {
	Config DecisionHookConfig
	Fn     DecisionHookFn
}