hooks

type AfterToolCallPayload struct {
	BasePayload
	ToolName   string                         `json:"tool_name"`
	ToolInput  json.RawMessage                `json:"tool_input"`
	ToolOutput tooltypes.StructuredToolResult `json:"tool_output"`
	ToolUserID string                         `json:"tool_user_id"`
}

type AfterToolCallResult struct {
	Output *tooltypes.StructuredToolResult `json:"output,omitempty"`
}

type AgentStopPayload struct {
	BasePayload
	Messages []llmtypes.Message `json:"messages"`
}

type AgentStopResult struct {
	// FollowUpMessages contains optional messages to append to the conversation.
	// This enables LLM-based hooks to provide feedback, ask clarifying questions,
	// or request additional actions based on the agent's work.
	FollowUpMessages []string `json:"follow_up_messages,omitempty"`
}

type BaseBuiltinHandler struct{}

type BasePayload struct {
	Event      HookType  `json:"event"`
	ConvID     string    `json:"conv_id"`
	CWD        string    `json:"cwd"`
	InvokedBy  InvokedBy `json:"invoked_by"`
	RecipeName string    `json:"recipe_name,omitempty"` // Active recipe name, empty if none
}

type BeforeToolCallPayload struct {
	BasePayload
	ToolName   string          `json:"tool_name"`
	ToolInput  json.RawMessage `json:"tool_input"`
	ToolUserID string          `json:"tool_user_id"`
}

type BeforeToolCallResult struct {
	Blocked bool            `json:"blocked"`
	Reason  string          `json:"reason,omitempty"`
	Input   json.RawMessage `json:"input,omitempty"`
}

type BuiltinHandler interface {
	// Name returns the handler identifier used in recipe metadata
	Name() string

	// HandleBeforeToolCall is called when before_tool_call event fires.
	// Returns nil if this handler doesn't implement before_tool_call.
	HandleBeforeToolCall(ctx context.Context, thread llmtypes.Thread, payload BeforeToolCallPayload) (*BeforeToolCallResult, error)

	// HandleAfterToolCall is called when after_tool_call event fires.
	// Returns nil if this handler doesn't implement after_tool_call.
	HandleAfterToolCall(ctx context.Context, thread llmtypes.Thread, payload AfterToolCallPayload) (*AfterToolCallResult, error)

	// HandleUserMessageSend is called when user_message_send event fires.
	// Returns nil if this handler doesn't implement user_message_send.
	HandleUserMessageSend(ctx context.Context, thread llmtypes.Thread, payload UserMessageSendPayload) (*UserMessageSendResult, error)

	// HandleAgentStop is called when agent_stop event fires.
	// Returns nil if this handler doesn't implement agent_stop.
	HandleAgentStop(ctx context.Context, thread llmtypes.Thread, payload AgentStopPayload) (*AgentStopResult, error)

	// HandleTurnEnd is called when turn_end event fires.
	// Returns nil if this handler doesn't implement turn_end.
	HandleTurnEnd(ctx context.Context, thread llmtypes.Thread, payload TurnEndPayload) (*TurnEndResult, error)
}

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

type ContextSwapper interface {
	// SwapContext replaces the current message history with a summary
	SwapContext(ctx context.Context, summary string) error
}

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

type DiscoveryOption func(*Discovery) error

type Hook struct {
	Name     string   // Filename of the executable
	Path     string   // Full path to the executable
	HookType HookType // Type returned by "hook" command
}

type HookDirConfig struct {
	Dir    string // Directory path
	Prefix string // Prefix for hook names (e.g., "org/repo/" for plugins)
}

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

type HookType string

type InvokedBy string

type SwapContextHandler struct {
	BaseBuiltinHandler
}

type ToolCallContext struct {
	ToolName   string
	ToolInput  string
	ToolUserID string
	ToolOutput *tooltypes.StructuredToolResult // Only for after_tool_call
}

type Trigger struct {
	Manager        HookManager
	ConversationID string
	IsSubAgent     bool
	WorkingDir     string
	RecipeName     string // Active recipe name, empty if none
}

type TurnEndPayload struct {
	BasePayload
	Response   string `json:"response"`    // The assistant's response text
	TurnNumber int    `json:"turn_number"` // Which turn in the conversation (1-indexed)
}

type TurnEndResult struct {
}

type UserMessageSendPayload struct {
	BasePayload
	Message string `json:"message"`
}

type UserMessageSendResult struct {
	Blocked bool   `json:"blocked"`
	Reason  string `json:"reason,omitempty"`
}