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

tools

package

Go to main page

Versions in this module

v0

v0.35.0

Aug 3, 2026

v0.34.3

Jun 23, 2026

v0.34.2

Jun 9, 2026

v0.34.1

Jun 7, 2026

v0.34.0

Jun 7, 2026

v0.33.4

Jun 2, 2026

v0.33.3

Jun 2, 2026

v0.33.2

Jun 2, 2026

v0.33.1

Jun 2, 2026

v0.33.0

May 30, 2026

v0.32.72

May 21, 2026

Changes in this version

+ const RegistryScopeAny

+ const RegistryScopePulse

+ const RegistryScopeReflection

+ const RegistryScopeUser

+ const StreamStderr

+ const StreamStdout

+ func CanonicalToolName(name string) string

+ func ExpandToolGroups(groupNames []string, known map[string]struct{}) (validGroups []string, expandedTools []string, unknownGroups []string)

+ func ExpandToolPatterns(patterns []string, known map[string]struct{}) (validPatterns []string, matchedTools []string, invalidPatterns []string)

+ func IsExecToolName(name string) bool

+ func IsHighRiskToolName(name string) bool

+ func KnownToolGroupNames() []string

+ func KnownToolGroups(known map[string]struct{}) map[string][]string

+ func MustJSON(value any) json.RawMessage

+ func NormalizeToolGroupName(name string) string

+ func ToolGroupForName(name string) string

+ func ToolNameAliases() map[string]string

+ func WithLineEmitter(ctx context.Context, emitter LineEmitter) context.Context

+ func WithToolOutputStreamer(ctx context.Context, streamer ToolOutputStreamer) context.Context

+ type BlockedToolError = internal.BlockedToolError

+ func ParseBlockedToolError(err error) (BlockedToolError, bool)

+ type ContentBlock = internal.ContentBlock

+ type ExecToolOptions = internal.ExecToolOptions

+ type LineEmitter = internal.LineEmitter

+ func LineEmitterFromContext(ctx context.Context) LineEmitter

+ type PathPolicy = internal.PathPolicy

+ func NewPathPolicy(workspaceDir string, workDirs []string, currentDir string) PathPolicy

+ func SingleDirPolicy(workspaceDir string) PathPolicy

+ type Policy = internal.Policy

+ type PolicyResolution = internal.PolicyResolution

+ type ProcessManager = internal.ProcessManager

+ func NewProcessManager() *ProcessManager

+ type ProcessSnapshot = internal.ProcessSnapshot

+ type Registry = internal.Registry

+ func NewRegistry() *Registry

+ func NewRegistryWithScope(scope RegistryScope) *Registry

+ type RegistryScope = internal.RegistryScope

+ type Result = internal.Result

+ func JSONTextResult(value any, isError bool) Result

+ type Tool = internal.Tool

+ func NewApplyPatchTool(workspaceDir string, enabled bool) Tool

+ func NewEditFileTool(workspaceDir string) Tool

+ func NewEditFileToolWithPolicy(policy PathPolicy) Tool

+ func NewEditTool(workspaceDir string) Tool

+ func NewExecTool(workspaceDir string) Tool

+ func NewExecToolWithManager(workspaceDir string, manager *ProcessManager) Tool

+ func NewExecToolWithOptions(policy PathPolicy, manager *ProcessManager, opts ExecToolOptions) Tool

+ func NewExecToolWithPolicy(policy PathPolicy, manager *ProcessManager) Tool

+ func NewGlobTool(workspaceDir string) Tool

+ func NewGlobToolWithPolicy(policy PathPolicy) Tool

+ func NewListDirTool(workspaceDir string) Tool

+ func NewListDirToolWithPolicy(policy PathPolicy) Tool

+ func NewMemoryGetTool(workspaceDir string, backend internalmemory.Backend) Tool

+ func NewMemorySaveTool(backend internalmemory.Backend, nowFn func() time.Time) Tool

+ func NewMemorySearchTool(workspaceDir string, backend internalmemory.Backend) Tool

+ func NewMemoryTool(workspaceDir string, backend internalmemory.Backend, nowFn func() time.Time) Tool

+ func NewProcessTool(manager *ProcessManager) Tool

+ func NewProjectSkillToolWithPolicy(policy PathPolicy) Tool

+ func NewReadFileTool(workspaceDir string) Tool

+ func NewReadFileToolWithPolicy(policy PathPolicy) Tool

+ func NewReadTool(workspaceDir string) Tool

+ func NewWebFetchTool(enabled bool) Tool

+ func NewWebFetchToolWithOptions(opts WebFetchOptions) Tool

+ func NewWebSearchTool(enabled bool, apiKey string) Tool

+ func NewWebSearchToolWithOptions(opts WebSearchOptions) Tool

+ func NewWriteFileTool(workspaceDir string) Tool

+ func NewWriteFileToolWithPolicy(policy PathPolicy) Tool

+ func NewWriteTool(workspaceDir string) Tool

+ type ToolOutputStreamer = internal.ToolOutputStreamer

+ func BindLineEmitter(emitter LineEmitter, toolCallID string) ToolOutputStreamer

+ func ToolOutputStreamerFromContext(ctx context.Context) ToolOutputStreamer

+ type WebFetchOptions = internal.WebFetchOptions

+ type WebSearchOptions = internal.WebSearchOptions