agenthooks

package module

Go to main page

Versions in this module

v0

v0.5.0

Aug 7, 2026

Changes in this version

type EventKind

+ const KindMCPInventory

+ type MCPInventoryEvent struct

+ Complete bool

+ Servers []MCPServer

+ type MCPServer struct

+ Command string

+ Name string

+ URL string

type Runner

+ func (r *Runner) OnMCPInventory(hs ...func(context.Context, *MCPInventoryEvent) error)

v0.4.1

Aug 5, 2026

Changes in this version

+ func All[E any, D decision](hs ...func(context.Context, *E) (D, error)) func(context.Context, *E) (D, error)

+ func Any[E any, D decision](hs ...func(context.Context, *E) (D, error)) func(context.Context, *E) (D, error)

+ func When[E any, D decision](m Matcher, h func(context.Context, *E) (D, error)) func(context.Context, *E) (D, error)

+ type Decision interface

+ Blocks func() bool

+ Context func() []string

+ Kind func() DecisionKind

+ Reason func() string

+ StopsAgent func() (reason string, ok bool)

+ SystemMessage func() string

+ type DecisionKind int

+ const DecisionAcceptPrompt

+ const DecisionAllow

+ const DecisionAsk

+ const DecisionBlockPrompt

+ const DecisionContinue

+ const DecisionContinueSession

+ const DecisionDeny

+ const DecisionFinish

+ const DecisionFlagOutput

+ const DecisionNoDecision

+ const DecisionObserved

+ const DecisionReplaceOutput

+ func (k DecisionKind) String() string

type Event

+ Ext map[string]any

+ type Interceptor func(ctx context.Context, typed any, next Next) (Decision, error)

+ type Matcher interface

+ Matches func(ToolCall) bool

+ type Next func(ctx context.Context, typed any) (Decision, error)

type PromptDecision

+ func (d PromptDecision) Blocks() bool

+ func (d PromptDecision) Context() []string

+ func (d PromptDecision) Kind() DecisionKind

+ func (d PromptDecision) Reason() string

+ func (d PromptDecision) StopsAgent() (string, bool)

+ func (d PromptDecision) SystemMessage() string

+ func (d PromptDecision) WithBlockReason(candidates ...string) PromptDecision

type Runner

+ func (r *Runner) Decide(ctx context.Context, typed any) (Decision, error)

+ func (r *Runner) Use(i Interceptor)

+ func (r *Runner) Walk(fn func(StageInfo) error) error

type SessionStartDecision

+ func (d SessionStartDecision) Blocks() bool

+ func (d SessionStartDecision) Context() []string

+ func (d SessionStartDecision) Kind() DecisionKind

+ func (d SessionStartDecision) Reason() string

+ func (d SessionStartDecision) StopsAgent() (string, bool)

+ func (d SessionStartDecision) SystemMessage() string

+ type StageInfo struct

+ Kind EventKind

+ Name string

+ Native string

+ Pos int

+ Type StageType

+ type StageType string

+ const StageHandler

+ const StageMiddleware

+ const StageObserver

type StopDecision

+ func (d StopDecision) Blocks() bool

+ func (d StopDecision) Context() []string

+ func (d StopDecision) Instruction() string

+ func (d StopDecision) Kind() DecisionKind

+ func (d StopDecision) Reason() string

+ func (d StopDecision) StopsAgent() (string, bool)

+ func (d StopDecision) SystemMessage() string

type ToolMatcher

+ func MatchCanonical(classes ...CanonicalTool) ToolMatcher

+ func MatchMCP(globs ...string) ToolMatcher

+ func MatchTools(names ...string) ToolMatcher

type ToolPostDecision

+ func (d ToolPostDecision) Blocks() bool

+ func (d ToolPostDecision) Context() []string

+ func (d ToolPostDecision) Kind() DecisionKind

+ func (d ToolPostDecision) Reason() string

+ func (d ToolPostDecision) ReplacedOutput() (any, bool)

+ func (d ToolPostDecision) StopsAgent() (string, bool)

+ func (d ToolPostDecision) SystemMessage() string

type ToolPreDecision

+ func (d ToolPreDecision) Blocks() bool

+ func (d ToolPreDecision) Context() []string

+ func (d ToolPreDecision) Kind() DecisionKind

+ func (d ToolPreDecision) Reason() string

+ func (d ToolPreDecision) StopsAgent() (string, bool)

+ func (d ToolPreDecision) SystemMessage() string

+ func (d ToolPreDecision) UpdatedInput() (any, bool)

+ func (d ToolPreDecision) WithBlockReason(candidates ...string) ToolPreDecision

v0.4.1-ordered-mcp-inventory.1

Aug 6, 2026

v0.4.1-ordered-mcp-inventory.0

Aug 6, 2026

v0.4.0

Jul 27, 2026

v0.3.0

Jul 24, 2026

v0.2.1

Jul 23, 2026

v0.2.0

Jul 23, 2026

v0.1.0

Jul 4, 2026

Changes in this version

+ const DefaultContinuationCap

+ var ErrLossyUpdate = errors.New("agenthooks: updated input removes keys; provider merge is shallow (lossy)")

+ var ErrUnsupportedDecision = errors.New("agenthooks: decision unsupported by provider")

+ func CompileMatcher(p Provider, m ToolMatcher) (expr string, ok bool)

+ func Logger(ctx context.Context) *slog.Logger

+ func Main(r *Runner)

+ func SynthesizeToolID(sessionID, turnID, toolName string, input []byte) string

+ type AgentInfo struct

+ ID string

+ Type string

+ type AskFallback int

+ const FallbackDeny

+ const FallbackNoDecision

+ type CanonicalTool string

+ const ToolFetch

+ const ToolFileEdit

+ const ToolFileRead

+ const ToolFileWrite

+ const ToolMCP

+ const ToolOther

+ const ToolSearch

+ const ToolShell

+ const ToolTask

+ func CanonicalToolFor(name string) CanonicalTool

+ type CapSet map[Capability]bool

+ func Capabilities(p Provider, v Variant, k EventKind) CapSet

+ func (s CapSet) Has(c Capability) bool

+ type Capability string

+ const CapAddContext

+ const CapAllow

+ const CapAsk

+ const CapContinueAgent

+ const CapDeny

+ const CapReplaceOutput

+ const CapStopAgent

+ const CapSystemMessage

+ const CapUpdateInput

+ type CompactEvent struct

+ Instructions string

+ Trigger string

+ type DegradeMode int

+ const Degrade

+ const Strict

+ type DetectionConfidence string

+ const DetectionConfig

+ const DetectionEnv

+ const DetectionShape

+ type Event struct

+ Agent *AgentInfo

+ Backfilled bool

+ DetectionConfidence DetectionConfidence

+ Kind EventKind

+ NativeName string

+ Provider Provider

+ Raw json.RawMessage

+ Session SessionInfo

+ Time time.Time

+ Variant Variant

+ func EventOf(typed any) *Event

+ func (e *Event) Can(c Capability) bool

+ func (e *Event) RawField(path string) json.RawMessage

+ type EventKind string

+ const KindCompactPost

+ const KindCompactPre

+ const KindFileEdited

+ const KindModelRequest

+ const KindModelResponse

+ const KindNotification

+ const KindOther

+ const KindPermission

+ const KindPromptSubmitted

+ const KindSessionEnd

+ const KindSessionStart

+ const KindStop

+ const KindSubagentStart

+ const KindSubagentStop

+ const KindToolError

+ const KindToolPost

+ const KindToolPre

+ type FailMode int

+ const FailClosed

+ const FailOpen

+ type FileEditedEvent struct

+ Path string

+ type MCPCall struct

+ Command string

+ FromConfig bool

+ Server string

+ Tool string

+ URL string

+ func ParseMCPName(name string) *MCPCall

+ type ModelEvent struct

+ type NotificationEvent struct

+ Message string

+ type Option func(*Runner)

+ func WithDedupDir(dir string) Option

+ func WithLogger(l *slog.Logger) Option

+ func WithPolicy(p Policy) Option

+ func WithPolicyFunc(f PolicyFunc) Option

+ func WithoutBackfill() Option

+ func WithoutDedup() Option

+ func WithoutMCPListFallback() Option

+ func WithoutMCPResolution() Option

+ type PermissionEvent struct

+ Tool ToolCall

+ type Policy struct

+ AskFallback AskFallback

+ ContinuationCap int

+ Fail FailMode

+ Timeout time.Duration

+ Unsupported DegradeMode

+ type PolicyFunc func(*Event) Policy

+ type PromptDecision struct

+ func AcceptPrompt() PromptDecision

+ func BlockPrompt(reason string) PromptDecision

+ func (d PromptDecision) StopAgent(reason string) PromptDecision

+ func (d PromptDecision) WithContext(s string) PromptDecision

+ func (d PromptDecision) WithSystemMessage(s string) PromptDecision

+ type PromptEvent struct

+ Prompt string

+ type Provider string

+ const ProviderClaudeCode

+ const ProviderCodex

+ const ProviderCursor

+ const ProviderGemini

+ const ProviderKimi

+ const ProviderOpenCode

+ type Quirk struct

+ Behavior string

+ Capability Capability

+ Event EventKind

+ ID int

+ Mitigation string

+ Provider Provider

+ Reference string

+ Versions string

+ func Quirks() []Quirk

+ func QuirksFor(p Provider) []Quirk

+ type Runner struct

+ func New(opts ...Option) *Runner

+ func (r *Runner) OnAny(fn func(context.Context, *Event) error)

+ func (r *Runner) OnCompactPost(fn func(context.Context, *CompactEvent) error)

+ func (r *Runner) OnCompactPre(fn func(context.Context, *CompactEvent) error)

+ func (r *Runner) OnFileEdited(fn func(context.Context, *FileEditedEvent) error)

+ func (r *Runner) OnModelRequest(fn func(context.Context, *ModelEvent) error)

+ func (r *Runner) OnModelResponse(fn func(context.Context, *ModelEvent) error)

+ func (r *Runner) OnNotification(fn func(context.Context, *NotificationEvent) error)

+ func (r *Runner) OnOther(nativeName string, fn func(context.Context, *Event) error)

+ func (r *Runner) OnPermission(fn func(context.Context, *PermissionEvent) (ToolPreDecision, error))

+ func (r *Runner) OnPromptSubmitted(fn func(context.Context, *PromptEvent) (PromptDecision, error))

+ func (r *Runner) OnSessionEnd(fn func(context.Context, *SessionEndEvent) error)

+ func (r *Runner) OnSessionStart(fn func(context.Context, *SessionStartEvent) (SessionStartDecision, error))

+ func (r *Runner) OnStop(fn func(context.Context, *StopEvent) (StopDecision, error))

+ func (r *Runner) OnSubagentStart(fn func(context.Context, *SubagentStartEvent) error)

+ func (r *Runner) OnSubagentStop(fn func(context.Context, *StopEvent) (StopDecision, error))

+ func (r *Runner) OnToolError(fn func(context.Context, *ToolPostEvent) (ToolPostDecision, error))

+ func (r *Runner) OnToolPost(fn func(context.Context, *ToolPostEvent) (ToolPostDecision, error))

+ func (r *Runner) OnToolPre(fn func(context.Context, *ToolPreEvent) (ToolPreDecision, error))

+ func (r *Runner) Run(ctx context.Context, args []string, stdin io.Reader, stdout, stderr io.Writer) int

+ type SessionEndEvent struct

+ Reason string

+ type SessionInfo struct

+ CWD string

+ ID string

+ Model string

+ PermissionMode string

+ TranscriptPath string

+ TurnID string

+ UserEmail string

+ WorkspaceRoots []string

+ type SessionStartDecision struct

+ func ContinueSession() SessionStartDecision

+ func (d SessionStartDecision) WithContext(s string) SessionStartDecision

+ func (d SessionStartDecision) WithSystemMessage(s string) SessionStartDecision

+ type SessionStartEvent struct

+ Source string

+ type StopDecision struct

+ func ContinueWith(instruction string) StopDecision

+ func Finish() StopDecision

+ func (d StopDecision) WithSystemMessage(s string) StopDecision

+ type StopEvent struct

+ FinalMessage string

+ LoopCount int

+ PreviouslyContinued bool

+ Usage *Usage

+ type SubagentStartEvent struct

+ type ToolCall struct

+ Canonical CanonicalTool

+ ID string

+ Input json.RawMessage

+ MCP *MCPCall

+ Name string

+ RawInput json.RawMessage

+ Synthesized bool

+ type ToolMatcher struct

+ Canonical []CanonicalTool

+ MCP []string

+ Names []string

+ func ParseToolMatcher(s string) (ToolMatcher, error)

+ func (m ToolMatcher) Encode() string

+ func (m ToolMatcher) IsEmpty() bool

+ func (m ToolMatcher) Matches(t ToolCall) bool

+ type ToolPostDecision struct

+ func FlagOutput(reason string) ToolPostDecision

+ func Observed() ToolPostDecision

+ func ReplaceOutput(v any) ToolPostDecision

+ func (d ToolPostDecision) StopAgent(reason string) ToolPostDecision

+ func (d ToolPostDecision) WithContext(s string) ToolPostDecision

+ func (d ToolPostDecision) WithSystemMessage(s string) ToolPostDecision

+ type ToolPostEvent struct

+ DurationMS *float64

+ Error string

+ Failed bool

+ Output json.RawMessage

+ Tool ToolCall

+ type ToolPreDecision struct

+ func Allow() ToolPreDecision

+ func AskUser(reason string) ToolPreDecision

+ func Deny(reason string) ToolPreDecision

+ func NoDecision() ToolPreDecision

+ func (d ToolPreDecision) StopAgent(reason string) ToolPreDecision

+ func (d ToolPreDecision) WithContext(s string) ToolPreDecision

+ func (d ToolPreDecision) WithSystemMessage(s string) ToolPreDecision

+ func (d ToolPreDecision) WithUpdatedInput(v any) ToolPreDecision

+ type ToolPreEvent struct

+ Tool ToolCall

+ type Usage struct

+ CacheReadTokens *int

+ CacheWriteTokens *int

+ Cost *float64

+ InputTokens *int

+ LoopCount *int

+ OutputTokens *int

+ Status string

+ type Variant string

+ const VariantCLI

+ const VariantCloud

+ const VariantCowork

+ const VariantIDE

+ const VariantRemote

+ const VariantUnknown

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL