Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

dispatch

package

Go to main page

Versions in this module

v0

v0.4.5

Oct 16, 2026

Changes in this version

+ const ActionCreateDirectory

+ const ActionCreateFile

+ const ActionDeleteFile

+ const ActionEditFile

+ const ActionMoveFile

+ const ActionRunCommand

+ const ActionRunTool

+ var ErrPipelineUnsupported = runner.ErrPipelineUnsupported

+ func DispatchPreparedTool(ctx context.Context, prepared PreparedTool, authorizer Authorizer) (tools.Result, error)

+ func DispatchShell(ctx context.Context, input string, home string, processCWD string, ...) (tools.Result, error)

+ func DispatchTool(ctx context.Context, name string, args map[string]any, home string, ...) (tools.Result, error)

+ func InvokeDecided(ctx context.Context, prepared PreparedTool, decision permissions.Decision) (tools.Result, error)

+ type Authorizer interface

+ Authorize func(ctx context.Context, req permissions.MatchRequest, display PromptDisplay, ...) (permissions.Decision, error)

+ type BatchAuthRequest struct

+ Display PromptDisplay

+ ModeCtx permissions.ModeContext

+ Req permissions.MatchRequest

+ type BatchAuthorizer interface

+ AuthorizeBatch func(ctx context.Context, reqs []BatchAuthRequest) ([]permissions.Decision, error)

+ type DeniedError struct

+ Envelope string

+ WrapUp bool

+ func (e *DeniedError) Error() string

+ type IndependentAuthRequest struct

+ Display PromptDisplay

+ ModeCtx permissions.ModeContext

+ PreparedTarget string

+ Req permissions.MatchRequest

+ type IndependentAuthorizer interface

+ AuthorizeIndependent func(ctx context.Context, reqs []IndependentAuthRequest) ([]permissions.Decision, error)

+ type MalformedCommandError struct

+ Err error

+ func (e *MalformedCommandError) Error() string

+ func (e *MalformedCommandError) Unwrap() error

+ type NoSuchToolError struct

+ Name string

+ func (e *NoSuchToolError) Error() string

+ type PipelineRunner interface

+ Pipeline func(ctx context.Context, specs []runner.RunSpec) ([]runner.PipelineResult, error)

+ PreflightPipeline func(ctx context.Context, specs []runner.RunSpec) error

+ type PreparedTool struct

+ func PrepareTool(ctx context.Context, name string, args map[string]any, home string, ...) (PreparedTool, error)

+ func (p PreparedTool) DelegateDeclaredDelete() map[string]bool

+ func (p PreparedTool) DelegateDeclaredWrite() map[string]bool

+ func (p PreparedTool) DelegatePrepared() bool

+ func (p PreparedTool) DelegateRefusal() error

+ func (p PreparedTool) DelegateSchedulerTargets() []string

+ func (p PreparedTool) ExternalRead() bool

+ func (p PreparedTool) IndependentRequest() IndependentAuthRequest

+ func (p PreparedTool) Name() string

+ func (p PreparedTool) PreparedMove() (source, destination string)

+ func (p PreparedTool) PreparedTarget() string

+ func (p PreparedTool) Scope() string

+ type PromptDisplay struct

+ Action string

+ Body string

+ DirectHTTPFallback bool

+ ExceptionalAuthority string

+ GrantStoredSubject string

+ HostRequest string

+ OutOfRootFileWrite bool

+ OutOfRootReadScope bool

+ Pipeline string

+ RequestedTarget string

+ Subject string

+ WholeCommand bool

+ type Runner interface

+ Exec func(ctx context.Context, spec runner.RunSpec) (runner.RunResult, error)

+ NewInvocationID func() string

+ type UnsupportedConstructError struct

+ Construct string

+ func (e *UnsupportedConstructError) Error() string