tools

package

Go to main page

Versions in this module

v1

v1.6.1

Jun 30, 2026

v1.6.0

Jun 30, 2026

Changes in this version

+ type BatchApproval struct

+ ExpiresAt time.Time

+ RiskLevel types.RiskLevel

+ ToolName string

type Dispatcher

+ func (d *Dispatcher) ActiveBatchToolNames() string

+ func (d *Dispatcher) ApproveBatch(toolName string, risk types.RiskLevel)

+ func (d *Dispatcher) BatchApprovalCount() int

+ func (d *Dispatcher) PendingPermCount() int

+ func (d *Dispatcher) RevokeBatchApprovals()

+ type PermissionPolicy string

+ const PolicyAllowSafe

+ const PolicyDenyAll

+ const PolicyPrompt

+ func (p PermissionPolicy) IsValid() bool

+ func (p PermissionPolicy) ShouldAutoAllow(toolName string, risk types.RiskLevel) bool

type PermissionRequest

+ Policy PermissionPolicy

+ QueueDepth int

type PermissionResponse

+ ApproveAll bool

v1.5.0

Jun 29, 2026

Changes in this version

+ var DefaultExtensions = []string

type ComplexityReport

+ Languages map[string]int

type Dispatcher

+ func (d *Dispatcher) SetCollector(c *metrics.Collector)

type Edit

+ func (t *Edit) SetCollector(c *metrics.Collector)

+ type TodoRead struct

+ func NewTodoRead(sessionsDir, sessionID string) *TodoRead

+ func (t *TodoRead) Description() string

+ func (t *TodoRead) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *TodoRead) Name() string

+ func (t *TodoRead) ParameterSchema() string

+ func (t *TodoRead) RiskLevel() types.RiskLevel

+ func (t *TodoRead) SetSessionID(id string)

v1.4.0

Jun 25, 2026

Changes in this version

+ const MaxBackupDirSize

+ const MinFreeDiskSpace

+ func ContainedInWorkDir(resolved, workDir string) error

+ func HumanSize(b int64) string

+ func LevenshteinBuf(a, b string, prev, curr []int) int

+ func LevenshteinDistance(a, b string) int

+ func ResolveAndContainPath(path, workDir string) (string, error)

+ func ResolveAndContainPathExists(path, workDir string) (string, error)

+ type DNSCache struct

+ func NewDNSCache(ttl time.Duration, evictThreshold int32) *DNSCache

+ func NewDNSCacheWithMaxSize(ttl time.Duration, evictThreshold int32, maxSize int32) *DNSCache

+ func (dc *DNSCache) Resolve(ctx context.Context, host string) ([]net.IPAddr, error)

+ func (dc *DNSCache) Size() int32

type Dispatcher

+ func (d *Dispatcher) SyncTodoFromTasks(tasks []types.Task) error

+ type SafeFileOp struct

+ func (s *SafeFileOp) OpenAndValidate(path, workDir string, flag int, perm os.FileMode) (*os.File, string, error)

type TodoWrite

+ func (t *TodoWrite) SyncTodoFromTasks(tasks []types.Task) error

v1.3.0

Jun 23, 2026

Changes in this version

+ const DefaultOutputMaxBytes

+ const DefaultOutputMaxLines

+ const OutputRetentionDays

+ type DevServer struct

+ func NewDevServer(workDir string) *DevServer

+ func (d *DevServer) Description() string

+ func (d *DevServer) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (d *DevServer) Name() string

+ func (d *DevServer) ParameterSchema() string

+ func (d *DevServer) RiskLevel() types.RiskLevel

+ func (d *DevServer) StopAll()

type Dispatcher

+ func (d *Dispatcher) SetOutputStore(store *OutputStore)

+ func (d *Dispatcher) Unregister(name string)

+ type HTTPCheck struct

+ func NewHTTPCheck() *HTTPCheck

+ func (h *HTTPCheck) Description() string

+ func (h *HTTPCheck) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (h *HTTPCheck) Name() string

+ func (h *HTTPCheck) ParameterSchema() string

+ func (h *HTTPCheck) RiskLevel() types.RiskLevel

+ type OutputStore struct

+ func NewOutputStore(baseDir string, maxLines, maxBytes int) *OutputStore

+ func (s *OutputStore) Bound(output string) (string, string, bool)

+ func (s *OutputStore) Cleanup(retention time.Duration) (int, error)

+ type PersistentPermissions struct

+ func NewPersistentPermissions() *PersistentPermissions

+ func (p *PersistentPermissions) Load(projectDir string) []config.PermissionRule

+ func (p *PersistentPermissions) Remove(projectDir string) error

+ func (p *PersistentPermissions) Save(projectDir string, rule config.PermissionRule) error

v1.2.0

Jun 21, 2026

Changes in this version

+ const DangerousRateLimitBurst

+ const DangerousRateLimitPerSec

+ const MaxAgentDepth

+ const MaxConcurrentTools

+ type MetricsTool struct

+ func NewMetricsTool(collector *metrics.Collector) *MetricsTool

+ func (t *MetricsTool) Description() string

+ func (t *MetricsTool) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *MetricsTool) Name() string

+ func (t *MetricsTool) ParameterSchema() string

+ func (t *MetricsTool) RiskLevel() types.RiskLevel

v1.1.0

Jun 18, 2026

Changes in this version

+ type CodeComplexity struct

+ func NewCodeComplexity(workDir string, skipDirs []string) *CodeComplexity

+ func (t *CodeComplexity) Description() string

+ func (t *CodeComplexity) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *CodeComplexity) Name() string

+ func (t *CodeComplexity) ParameterSchema() string

+ func (t *CodeComplexity) RiskLevel() types.RiskLevel

+ type ComplexityReport struct

+ Files []FileStat

+ Packages []PackageStat

+ Score string

+ TotalFiles int

+ TotalLines int

type Dispatcher

+ func (d *Dispatcher) SetTodoWriteCallback(fn func(items []TodoItem))

+ type FileStat struct

+ Lines int

+ Path string

+ type PackageStat struct

+ Files int

+ Lines int

+ Path string

+ type TodoItem struct

+ Content string

+ Priority string

+ Status string

type TodoWrite

+ func (t *TodoWrite) SetOnUpdate(fn func(items []TodoItem))

type WebFetch

+ func (wf *WebFetch) Close()

v1.0.2

Jun 15, 2026

Changes in this version

type WebSearch

+ func (t *WebSearch) Close()

v1.0.0

Jun 14, 2026

Changes in this version

+ const BashKillGracePeriod

+ const BashWaitTimeout

+ const DNSCacheTTL

+ const DefaultAgentName

+ const DefaultMaxGrepResults

+ const DefaultMaxSearchResults

+ const DefaultSearchBaseURL

+ const DefaultTimeoutSecs

+ const DirPermission

+ const FilePermission

+ const LevenshteinThreshold

+ const MaxBackupsPerFile

+ const MaxGlobResults

+ const MaxGrepPatternLength

+ const MaxRedirects

+ const MaxSearchQueryLength

+ const MaxSearchResults

+ const MaxTimeoutSecs

+ const MinLinesForFuzzy

+ const PermissionChannelBuffer

+ const QuestionChannelBuffer

+ const ToolRateLimitBurst

+ const ToolRateLimitPerSec

+ var Version atomic.Value

+ func BuildToolDefs(d *Dispatcher) []provider.ToolDefinition

+ func NewDispatcherFactory(backupDir, sessionsDir string, permCfg *config.PermissionsConfig, ...) subagent.DispatcherFactory

+ func SetVersion(v string)

+ type Agent struct

+ func NewAgent(m *subagent.Manager, isChild bool) *Agent

+ func (t *Agent) Description() string

+ func (t *Agent) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *Agent) Name() string

+ func (t *Agent) ParameterSchema() string

+ func (t *Agent) RiskLevel() types.RiskLevel

+ type AskUserQuestion struct

+ func NewAskUserQuestion(requestCh chan QuestionRequest, responseCh chan QuestionResponse, ...) *AskUserQuestion

+ func (t *AskUserQuestion) Description() string

+ func (t *AskUserQuestion) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *AskUserQuestion) Name() string

+ func (t *AskUserQuestion) ParameterSchema() string

+ func (t *AskUserQuestion) RiskLevel() types.RiskLevel

+ type Bash struct

+ func NewBash(workDir string) *Bash

+ func (t *Bash) Description() string

+ func (t *Bash) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *Bash) Name() string

+ func (t *Bash) ParameterSchema() string

+ func (t *Bash) RiskLevel() types.RiskLevel

+ type CodeMap struct

+ func NewCodeMap(workDir string) *CodeMap

+ func (t *CodeMap) Description() string

+ func (t *CodeMap) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *CodeMap) Name() string

+ func (t *CodeMap) ParameterSchema() string

+ func (t *CodeMap) RiskLevel() types.RiskLevel

+ type Dispatcher struct

+ func DefaultDispatcher(workDir, backupDir, sessionsDir string, cfg *config.PermissionsConfig) (*Dispatcher, error)

+ func NewDispatcher(cfg *config.PermissionsConfig) *Dispatcher

+ func (d *Dispatcher) ApprovePermission(requestID int64, allowed bool, remember bool)

+ func (d *Dispatcher) Execute(ctx context.Context, call types.ToolCall) (types.ToolResult, error)

+ func (d *Dispatcher) GetTool(name string) (types.Tool, bool)

+ func (d *Dispatcher) List() []string

+ func (d *Dispatcher) QuestionRequestCh() chan QuestionRequest

+ func (d *Dispatcher) QuestionResponseCh() chan QuestionResponse

+ func (d *Dispatcher) Register(tool types.Tool) error

+ func (d *Dispatcher) RequestCh() chan PermissionRequest

+ func (d *Dispatcher) RespondQuestion(requestID int64, answer string)

+ func (d *Dispatcher) SelectAgent(agent string) error

+ func (d *Dispatcher) SetPermission(toolName string, allowed bool)

+ func (d *Dispatcher) SetSessionID(id string)

+ func (d *Dispatcher) Stop()

+ func (d *Dispatcher) UpdatePermissions(cfg *config.PermissionsConfig)

+ type Edit struct

+ func NewEdit(workDir, backupDir string) *Edit

+ func (t *Edit) Description() string

+ func (t *Edit) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *Edit) Name() string

+ func (t *Edit) ParameterSchema() string

+ func (t *Edit) RiskLevel() types.RiskLevel

+ type FileDelete struct

+ func NewFileDelete(workDir, backupDir string) *FileDelete

+ func (t *FileDelete) Description() string

+ func (t *FileDelete) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *FileDelete) Name() string

+ func (t *FileDelete) ParameterSchema() string

+ func (t *FileDelete) RiskLevel() types.RiskLevel

+ type FileList struct

+ func NewFileList(workDir string) *FileList

+ func (t *FileList) Description() string

+ func (t *FileList) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *FileList) Name() string

+ func (t *FileList) ParameterSchema() string

+ func (t *FileList) RiskLevel() types.RiskLevel

+ type FileMove struct

+ func NewFileMove(workDir string) *FileMove

+ func (t *FileMove) Description() string

+ func (t *FileMove) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *FileMove) Name() string

+ func (t *FileMove) ParameterSchema() string

+ func (t *FileMove) RiskLevel() types.RiskLevel

+ type FileRead struct

+ func NewFileRead(workDir string) *FileRead

+ func (t *FileRead) Description() string

+ func (t *FileRead) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *FileRead) Name() string

+ func (t *FileRead) ParameterSchema() string

+ func (t *FileRead) RiskLevel() types.RiskLevel

+ type FileWrite struct

+ func NewFileWrite(workDir, backupDir string) *FileWrite

+ func (t *FileWrite) Description() string

+ func (t *FileWrite) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *FileWrite) Name() string

+ func (t *FileWrite) ParameterSchema() string

+ func (t *FileWrite) RiskLevel() types.RiskLevel

+ type Glob struct

+ func NewGlob(workDir string) *Glob

+ func (t *Glob) Description() string

+ func (t *Glob) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *Glob) Name() string

+ func (t *Glob) ParameterSchema() string

+ func (t *Glob) RiskLevel() types.RiskLevel

+ type Grep struct

+ func NewGrep(workDir string) *Grep

+ func (t *Grep) Description() string

+ func (t *Grep) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *Grep) Name() string

+ func (t *Grep) ParameterSchema() string

+ func (t *Grep) RiskLevel() types.RiskLevel

+ type PermissionContext struct

+ RuleAction string

+ RulePattern string

+ RuleTool string

+ Source string

+ type PermissionGate interface

+ RequestPermission func(ctx context.Context, req PermissionRequest) (PermissionResponse, error)

+ type PermissionRequest struct

+ Command string

+ ID int64

+ RiskLevel types.RiskLevel

+ RuleAction string

+ RulePattern string

+ RuleTool string

+ TimeoutSecs int

+ ToolName string

+ type PermissionResponse struct

+ Allowed bool

+ Remember bool

+ RequestID int64

+ type QuestionRequest struct

+ AllowCustom bool

+ Header string

+ ID int64

+ Options []string

+ Question string

+ TimeoutSecs int

+ type QuestionResponse struct

+ Answer string

+ type TodoWrite struct

+ func NewTodoWrite(sessionsDir, sessionID string) *TodoWrite

+ func (t *TodoWrite) Description() string

+ func (t *TodoWrite) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *TodoWrite) Name() string

+ func (t *TodoWrite) ParameterSchema() string

+ func (t *TodoWrite) RiskLevel() types.RiskLevel

+ func (t *TodoWrite) SetSessionID(id string)

+ type WebFetch struct

+ func NewWebFetch(sessionsDir string, allowPrivateIPs bool) *WebFetch

+ func (t *WebFetch) Description() string

+ func (t *WebFetch) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *WebFetch) Name() string

+ func (t *WebFetch) ParameterSchema() string

+ func (t *WebFetch) RiskLevel() types.RiskLevel

+ type WebSearch struct

+ func NewWebSearch(baseURL string) *WebSearch

+ func (t *WebSearch) Description() string

+ func (t *WebSearch) Execute(ctx context.Context, input types.ToolInput) (types.ToolResult, error)

+ func (t *WebSearch) Name() string

+ func (t *WebSearch) ParameterSchema() string

+ func (t *WebSearch) RiskLevel() types.RiskLevel

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