tools

package

Go to main page

Versions in this module

v0

v0.6.16

Aug 24, 2026

Changes in this version

+ type ImageViewResult struct

+ Bytes int

+ MIMEType string

+ OriginalHeight int

+ OriginalWidth int

+ OutputHeight int

+ OutputWidth int

+ Path string

+ Resized bool

type Tool

+ RequiredInputs []llm.ModelInput

+ func (t Tool) Supports(model llm.Model) bool

v0.6.15

Aug 21, 2026

Changes in this version

+ const ToolNameExitPlanMode

+ const ToolNameTodoWrite

+ type PlanExitOutcome struct

+ Approved bool

+ type PlanModeState interface

+ ExitPlanMode func(context.Context) error

+ PlanModeActive func() bool

type Question

+ Detail string

+ Intent QuestionIntent

+ type QuestionIntent string

+ const QuestionIntentPlanReview

+ type TodoItem struct

+ Content string

+ Status TodoStatus

+ type TodoSnapshot struct

+ Todos []TodoItem

+ type TodoStatus string

+ const TodoCompleted

+ const TodoInProgress

+ const TodoPending

type Tool

+ func ExitPlanMode(asker Asker, state PlanModeState) Tool

v0.6.14

Aug 16, 2026

v0.6.13

Aug 13, 2026

v0.6.12

Aug 12, 2026

v0.6.11

Aug 12, 2026

v0.6.10

Aug 11, 2026

v0.6.9

Aug 10, 2026

Changes in this version

+ func CoreTools(root string) ([]Tool, *TaskManager)

v0.6.8

Aug 9, 2026

v0.6.7

Aug 6, 2026

v0.6.6

Aug 6, 2026

v0.6.5

Aug 5, 2026

v0.6.4

Aug 5, 2026

v0.6.3

Aug 3, 2026

v0.6.2

Aug 2, 2026

Changes in this version

type ExecOps

+ Start func(command string, dir string, out io.Writer) (Process, error)

type LocalOps

+ func (LocalOps) Start(command string, dir string, out io.Writer) (Process, error)

+ type Process interface

+ Kill func() error

+ Stop func() error

+ Wait func() (exitCode int, err error)

v0.6.1

Jul 30, 2026

v0.6.0

Jul 30, 2026

Changes in this version

+ const DefaultBashTimeout

+ const DefaultMaxBytes

+ const DefaultMaxLines

+ const FailureAmbiguous

+ const FailureChanged

+ const FailureIO

+ const FailureInput

+ const FailureNotFound

+ const FailureNotRead

+ const MaxBrowserInspectionTextRunes

+ const MaxHeaderRunes

+ const MaxOptions

+ const MaxQuestions

+ const MinOptions

+ const MinQuestions

+ const ToolNameAskUserQuestion

+ var ErrFileChanged = errors.New("file has changed since it was read")

+ var ErrFileNotRead = errors.New("file has not been read")

+ var ErrNoAsker = errors.New("no interactive surface is available to ask the user")

+ var ErrTaskNotFound = errors.New("background task not found")

+ func AgentTools(tools []Tool) []agent.AgentTool

+ func CheckPreview(ctx context.Context, raw string) (string, error)

+ func CoreToolsWithTasks(root string, ops Ops) ([]Tool, *TaskManager)

+ func InternalAccess(map[string]any) []permission.Access

+ func ResolvePreviewAsset(root, path string) (string, string, error)

+ func ResolvePreviewDocument(root, path string) (string, string, error)

+ type Answer struct

+ Question string

+ Values []string

+ type Asker interface

+ Ask func(context.Context, []Question) ([]Answer, error)

+ type BrowserControlCapability string

+ const BrowserControlInteract

+ const BrowserControlNavigate

+ const BrowserControlRead

+ type BrowserControlledTab struct

+ Capabilities []BrowserControlCapability

+ TabID string

+ type BrowserController interface

+ OpenBrowser func(context.Context, BrowserRequest) (BrowserResult, error)

+ type BrowserDisposition string

+ const BrowserNewBackgroundTab

+ const BrowserNewForegroundTab

+ const BrowserReuseAgentTab

+ type BrowserInspectionResult struct

+ Error string

+ ID string

+ PageStatus BrowserPageStatus

+ Revision int

+ Status BrowserInspectionStatus

+ Title string

+ Truncated bool

+ URL string

+ VisibleText string

+ type BrowserInspectionStatus string

+ const BrowserInspectionCancelled

+ const BrowserInspectionCompleted

+ const BrowserInspectionFailed

+ const BrowserInspectionTimeout

+ type BrowserInspector interface

+ InspectBrowser func(context.Context, string) (BrowserInspectionResult, error)

+ type BrowserOpenTab struct

+ Status BrowserTabStatus

+ TabID string

+ Title string

+ URL string

+ type BrowserPageStatus string

+ const BrowserPageFailed

+ const BrowserPageNavigating

+ const BrowserPageReady

+ type BrowserRequest struct

+ Disposition BrowserDisposition

+ Preview PreviewRequest

+ type BrowserResult struct

+ CommittedURL string

+ Error string

+ ID string

+ Preview PreviewRequest

+ RequestedURL string

+ Status BrowserResultStatus

+ Title string

+ type BrowserResultStatus string

+ const BrowserCancelled

+ const BrowserCommitted

+ const BrowserFailed

+ const BrowserTimeout

+ type BrowserTabStatus string

+ const BrowserTabFailed

+ const BrowserTabIdle

+ const BrowserTabNavigating

+ const BrowserTabReady

+ type BrowserTabsProvider interface

+ BrowserTabs func(context.Context) (BrowserTabsResult, error)

+ type BrowserTabsResult struct

+ ControlledTabs []BrowserControlledTab

+ Error string

+ ID string

+ OpenTabs []BrowserOpenTab

+ Selected string

+ Status BrowserTabsStatus

+ type BrowserTabsStatus string

+ const BrowserTabsCancelled

+ const BrowserTabsCompleted

+ const BrowserTabsFailed

+ const BrowserTabsTimeout

+ type ChangeKind string

+ const ChangeCreate

+ const ChangeUpdate

+ type ExecOps interface

+ Exec func(ctx context.Context, command string, dir string) (ExecResult, error)

+ type ExecResult struct

+ ExitCode int

+ Output string

+ type FileChange struct

+ Additions int

+ Bytes int

+ Deletions int

+ Hunks []Hunk

+ Kind ChangeKind

+ Path string

+ type FileOps interface

+ MkdirAll func(ctx context.Context, path string, perm os.FileMode) error

+ Open func(ctx context.Context, path string) (io.ReadCloser, error)

+ ReadDir func(ctx context.Context, path string) ([]os.DirEntry, error)

+ ReadFile func(ctx context.Context, path string) ([]byte, error)

+ Stat func(ctx context.Context, path string) (os.FileInfo, error)

+ WriteFile func(ctx context.Context, path string, data []byte, perm os.FileMode) error

+ type FileStateStore struct

+ func NewFileStateStore() *FileStateStore

+ func (s *FileStateStore) Check(path string, info os.FileInfo) error

+ func (s *FileStateStore) Delete(path string)

+ func (s *FileStateStore) Record(path string, info os.FileInfo)

+ type FileVersion struct

+ ModTime time.Time

+ Size int64

+ func (v FileVersion) Equal(other FileVersion) bool

+ type Hunk struct

+ Lines []string

+ NewLines int

+ NewStart int

+ OldLines int

+ OldStart int

+ type LocalOps struct

+ func (LocalOps) Exec(ctx context.Context, command string, dir string) (ExecResult, error)

+ func (LocalOps) MkdirAll(ctx context.Context, path string, perm os.FileMode) error

+ func (LocalOps) Open(ctx context.Context, path string) (io.ReadCloser, error)

+ func (LocalOps) ReadDir(_ context.Context, path string) ([]os.DirEntry, error)

+ func (LocalOps) ReadFile(_ context.Context, path string) ([]byte, error)

+ func (LocalOps) Stat(_ context.Context, path string) (os.FileInfo, error)

+ func (LocalOps) WriteFile(ctx context.Context, path string, data []byte, perm os.FileMode) error

+ type MutationFailure struct

+ Detail string

+ Path string

+ Reason string

+ type Ops interface

+ type Option struct

+ Description string

+ Label string

+ type PreviewRequest struct

+ GrantID string

+ Path string

+ PreviewPath string

+ RelativePath string

+ Title string

+ URL string

+ type Question struct

+ Header string

+ MultiSelect bool

+ Options []Option

+ Question string

+ type QuestionAnswers struct

+ Answers []Answer

+ Questions []Question

+ type ReadResult struct

+ Content string

+ HasMore bool

+ Limit int

+ LineCount int

+ NextOffset int

+ Path string

+ StartLine int

+ type TaskInfo struct

+ Command string

+ Description string

+ ID string

+ OutputPath string

+ StartedAt time.Time

+ type TaskManager struct

+ func NewTaskManager() *TaskManager

+ func (m *TaskManager) Completed() []TaskState

+ func (m *TaskManager) OwnsOutputPath(path string) bool

+ func (m *TaskManager) ReadOutput(id string, maxBytes int64) (TaskOutput, error)

+ func (m *TaskManager) Shutdown()

+ func (m *TaskManager) Snapshot() []TaskState

+ func (m *TaskManager) Start(command, description, dir string) (TaskInfo, error)

+ func (m *TaskManager) Stop(id string) error

+ func (m *TaskManager) Subscribe(listener func(TaskState)) func()

+ type TaskOutput struct

+ Content string

+ Truncated bool

+ type TaskState struct

+ CompletedAt time.Time

+ ExitCode *int

+ Status TaskStatus

+ type TaskStatus string

+ const TaskFailed

+ const TaskRunning

+ const TaskStopped

+ const TaskSucceeded

+ type Tool struct

+ AccessFor func(args map[string]any) []permission.Access

+ Guidelines []string

+ func AskUserQuestion(asker Asker) Tool

+ func Bash(root string, ops ExecOps, tasks *TaskManager) Tool

+ func BrowserTabs(providers ...BrowserTabsProvider) Tool

+ func BrowserTools(root string, browserControllers ...BrowserController) []Tool

+ func Edit(root string, ops FileOps, files *FileStateStore) Tool

+ func Glob(root string, ops FileOps) Tool

+ func Grep(root string, ops FileOps) Tool

+ func InspectBrowser(inspectors ...BrowserInspector) Tool

+ func OpenPreview(root string, controllers ...BrowserController) Tool

+ func Read(root string, ops FileOps, files *FileStateStore, ...) Tool

+ func TaskStop(tasks *TaskManager) Tool

+ func Write(root string, ops FileOps, files *FileStateStore) Tool

+ func (t Tool) Accesses(args map[string]any) []permission.Access

+ func (t Tool) Name() string

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