approval

package

Go to main page

Versions in this module

v0

v0.3.1

Aug 2, 2026

v0.3.0

Jul 31, 2026

Changes in this version

type Engine

+ func (e *Engine) FilesystemRoots() FilesystemRoots

+ func (e *Engine) SetInteract(fn InteractFunc)

+ type InteractFunc func(ctx context.Context, args json.RawMessage) (updated json.RawMessage, err error)

v0.2.2

Jun 14, 2026

Changes in this version

+ const ModeAuto

v0.2.0

Jun 5, 2026

v0.1.3

May 24, 2026

Changes in this version

+ func CheckDangerousPath(workspace string, req permission.Request) string

+ func DestructiveCommandWarning(cmd string) string

type Engine

+ func (e *Engine) AsToolGate() agentcore.ToolGate

+ func (e *Engine) SetPlanContentProvider(fn func() (string, error))

v0.1.2

Apr 23, 2026

v0.1.1

Apr 17, 2026

v0.1.0

Apr 8, 2026

Changes in this version

type Engine

+ func (e *Engine) Decide(ctx context.Context, req permission.Request) (*permission.Decision, error)

+ func (e *Engine) SetPlanAllowedCommands(prefixes []string)

v0.0.4

Mar 25, 2026

Changes in this version

+ type ApproverFunc func(ctx context.Context, prompt Prompt) (Choice, error)

+ type AuditEntry struct

+ Allow bool

+ Capability Capability

+ Decision string

+ Mode Mode

+ PlanMode bool

+ Reason string

+ Summary string

+ Time time.Time

+ Tool string

+ type Capability string

+ const CapExec

+ const CapHook

+ const CapInternal

+ const CapNetwork

+ const CapRead

+ const CapSubagent

+ const CapUnknown

+ const CapWrite

+ type Choice string

+ const ChoiceAllowAlways

+ const ChoiceAllowOnce

+ const ChoiceAllowSession

+ const ChoiceDeny

+ type CommandCategory string

+ const CommandCategoryConfig

+ const CommandCategoryExit

+ const CommandCategoryInfo

+ const CommandCategoryPlan

+ const CommandCategoryPrompt

+ const CommandCategorySession

+ func NormalizeCommandCategory(raw string) CommandCategory

+ type CommandRequest struct

+ Category CommandCategory

+ IsRunning bool

+ Name string

+ NeedsIdle bool

+ Preview string

+ Summary string

+ type Engine struct

+ func NewEngine(cwd string, mode Mode, rules *RuleSet, onAudit func(AuditEntry)) (*Engine, error)

+ func (e *Engine) ApproveCommand(_ context.Context, req CommandRequest) error

+ func (e *Engine) ApproveHook(ctx context.Context, req HookRequest) error

+ func (e *Engine) ApproveTool(ctx context.Context, req agentcore.ToolApprovalRequest) (*agentcore.ToolApprovalResult, error)

+ func (e *Engine) Mode() Mode

+ func (e *Engine) PlanMode() bool

+ func (e *Engine) ReplaceToolMetadata(tools []agentcore.Tool)

+ func (e *Engine) SetApprover(fn ApproverFunc)

+ func (e *Engine) SetFilesystemRoots(roots FilesystemRoots)

+ func (e *Engine) SetMode(mode Mode)

+ func (e *Engine) SetPlanMode(active bool)

+ func (e *Engine) SetSkillAllows(rawTools []string)

+ type FilesystemRoots struct

+ ReadRoots []string

+ WriteRoots []string

+ type HookRequest struct

+ Blocking bool

+ Command string

+ Event string

+ Tool string

+ type Mode string

+ const ModeAcceptEdits

+ const ModeBalanced

+ const ModePlan

+ const ModeStrict

+ const ModeTrust

+ func ParseMode(raw string) (Mode, error)

+ type Prompt struct

+ Capability Capability

+ OutsideRoots bool

+ Preview string

+ Reason string

+ Summary string

+ Tool string

+ type Rule struct

+ Kind string

+ Pattern string

+ Raw string

+ func ParseRule(raw string) (Rule, error)

+ type RuleSet struct

+ Allow []Rule

+ Deny []Rule

+ func ParseRuleSet(allow, deny []string) (*RuleSet, error)

+ func (rs *RuleSet) Evaluate(info toolInfo) (ruleAction, bool)

+ type Store struct

+ func NewStore(path string) (*Store, error)

+ func (s *Store) Add(entry storedEntry) error

+ func (s *Store) Has(key string) bool

+ type ToolMetadata struct

+ Capability Capability

+ KeyPrefix string

+ Reason string

+ SummaryHint string

+ ToolName string

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