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.1.4

Sep 20, 2026

v0.1.3

Sep 18, 2026

Changes in this version

+ const ApplyPatchName

+ const PlanCatalogID

+ func NewCatalog(tree *workspace.Tree, limits Limits, options ...CatalogOption) (*catalog.Catalog, error)

+ func NewTaskCatalog() (*catalog.Catalog, error)

+ type CatalogOption func(*catalogConfig) error

+ func WithControlledShell(tool agent.Tool) CatalogOption

+ func WithPlanFile(file PlanFile) CatalogOption

+ type Limits struct

+ FileBytes int64

+ GlobEntries int

+ GlobTimeout time.Duration

+ GrepFiles int

+ GrepLineBytes int

+ GrepMatches int

+ GrepTimeout time.Duration

+ ListEntries int

+ OutputBytes int

+ PatchBytes int

+ PatchFiles int

+ PatchTimeout time.Duration

+ PatchTotalBytes int64

+ ReadLines int

+ ScanEntries int

+ func DefaultLimits() Limits

+ type PlanFile struct

+ Admitted func() bool

+ Path func() string

+ Read func(context.Context) (string, error)

+ Write func(context.Context, string) error

+ type RecoveryError struct

+ Applied bool

+ RecoveryPaths []string

+ func (e *RecoveryError) Error() string

+ func (e *RecoveryError) Unwrap() error

+ type ResultCounts struct

+ Bytes int

+ Entries int

+ Files int

+ Lines int

+ Matches int

+ Scanned int

+ Skipped int

+ TruncatedLines int

+ type ResultExecution struct

+ DurationMS int64

+ ExitCode *int

+ Signal string

+ Status string

+ Stderr ResultExecutionStream

+ Stdout ResultExecutionStream

+ type ResultExecutionStream struct

+ Bytes int64

+ Sanitized bool

+ Truncated bool

+ type ResultHeader struct

+ Code string

+ Counts ResultCounts

+ Diagnostic *execution.SandboxDiagnostic

+ Execution *ResultExecution

+ Next ResultNext

+ OK bool

+ Problem *ResultProblem

+ Reason string

+ Schema string

+ Tool string

+ Truncated bool

+ func ParseResult(value string) (ResultHeader, string, error)

+ type ResultNext struct

+ Offset *int

+ type ResultProblem struct

+ Field string

+ Hint string

+ Retryable bool

+ type ShellHandler struct

+ func NewShellHandler() *ShellHandler

+ func NewShellHandlerForNetwork(mode config.SandboxNetworkMode) *ShellHandler

+ func NewShellHandlerForSandbox(sandbox config.SandboxMode, networkMode config.SandboxNetworkMode) *ShellHandler

+ func (h *ShellHandler) Decl() ai.Tool

+ func (h *ShellHandler) Operation(ctx context.Context, call agent.ToolCall) (execution.OperationSpec, error)

+ func (h *ShellHandler) Render(result execution.Result, runErr error) ([]ai.Part, error)

v0.1.2

Sep 15, 2026

v0.1.1

Sep 15, 2026

v0.1.0

Aug 12, 2026