tools

type AppliedEditsResult struct {
	BaseContent string `json:"baseContent"`
	NewContent  string `json:"newContent"`
}

type BashExecOptions struct {
	OnData  func([]byte)
	Timeout *float64
	Env     map[string]string
}

type BashExecResult struct {
	// ExitCode must be set when Exec succeeds. A nil value is a failed command.
	ExitCode *int
}

type BashOperations interface {
	Exec(context.Context, string, string, BashExecOptions) (BashExecResult, error)
}

type BashResult struct {
	Output         string `json:"output"`
	ExitCode       *int   `json:"exitCode,omitempty"`
	Cancelled      bool   `json:"cancelled"`
	Truncated      bool   `json:"truncated"`
	FullOutputPath string `json:"fullOutputPath,omitempty"`
}

type BashSessionEnvironment struct {
	SessionID      string
	SessionFile    string
	Provider       string
	Model          string
	ReasoningLevel string
}

type BashSessionEnvironmentBinder interface {
	BindSessionEnvironment(BashSessionEnvironmentSource)
}

type BashSessionEnvironmentSource func() *BashSessionEnvironment

type BashSpawnContext struct {
	Command string
	Cwd     string
	Env     map[string]string
}

type BashSpawnHook func(BashSpawnContext) BashSpawnContext

type BashToolDetails struct {
	Truncation     *truncate.Result `json:"truncation,omitempty"`
	FullOutputPath string           `json:"fullOutputPath,omitempty"`
}

type BashToolInput struct {
	Command string   `json:"command"`
	Timeout *float64 `json:"timeout,omitempty"`
}

type BashToolOptions struct {
	Operations    BashOperations
	CommandPrefix string
	ShellPath     string
	// ExposeSessionEnvironment exposes current Orb session metadata as ORB_*
	// environment variables. Default: true.
	ExposeSessionEnvironment *bool
	SpawnHook                BashSpawnHook
}

type DiffResult struct {
	Diff             string `json:"diff"`
	FirstChangedLine *int   `json:"firstChangedLine,omitempty"`
}

type Edit struct {
	OldText string `json:"oldText"`
	NewText string `json:"newText"`
}

type EditOperations interface {
	ReadFile(context.Context, string) ([]byte, error)
	WriteFile(context.Context, string, string) error
	Access(context.Context, string) error
}

type EditToolDetails struct {
	Diff             string `json:"diff"`
	Patch            string `json:"patch"`
	FirstChangedLine *int   `json:"firstChangedLine,omitempty"`
}

type EditToolInput struct {
	Path  string `json:"path"`
	Edits []Edit `json:"edits"`
}

type EditToolOptions struct {
	Operations EditOperations
}

type FindGlobOptions struct {
	Ignore []string
	Limit  float64
}

type FindOperations interface {
	Exists(context.Context, string) (bool, error)
	Glob(context.Context, string, string, FindGlobOptions) ([]string, error)
}

type FindToolDetails struct {
	ResultLimitReached *float64         `json:"resultLimitReached,omitempty"`
	Truncation         *truncate.Result `json:"truncation,omitempty"`
}

type FindToolInput struct {
	Pattern string   `json:"pattern"`
	Path    *string  `json:"path,omitempty"`
	Limit   *float64 `json:"limit,omitempty"`
}

type FindToolOptions struct {
	Operations FindOperations
}

type FuzzyMatchResult struct {
	Found                 bool   `json:"found"`
	Index                 int    `json:"index"`
	MatchLength           int    `json:"matchLength"`
	UsedFuzzyMatch        bool   `json:"usedFuzzyMatch"`
	ContentForReplacement string `json:"contentForReplacement"`
}

type GrepOperations interface {
	IsDirectory(context.Context, string) (bool, error)
	ReadFile(context.Context, string) (string, error)
}

type GrepToolDetails struct {
	MatchLimitReached *float64         `json:"matchLimitReached,omitempty"`
	Truncation        *truncate.Result `json:"truncation,omitempty"`
	LinesTruncated    bool             `json:"linesTruncated,omitempty"`
}

type GrepToolInput struct {
	Pattern    string   `json:"pattern"`
	Path       *string  `json:"path,omitempty"`
	Glob       *string  `json:"glob,omitempty"`
	IgnoreCase *bool    `json:"ignoreCase,omitempty"`
	Literal    *bool    `json:"literal,omitempty"`
	Context    *float64 `json:"context,omitempty"`
	Limit      *float64 `json:"limit,omitempty"`
}

type GrepToolOptions struct {
	Operations GrepOperations
}

type ImageResizeOptions struct {
	MaxWidth    int
	MaxHeight   int
	MaxBytes    int
	JPEGQuality int
}

type LocalBashOperationsOptions struct {
	ShellPath string
}

type LsOperations interface {
	Exists(context.Context, string) (bool, error)
	Stat(context.Context, string) (LsPathStat, error)
	ReadDir(context.Context, string) ([]string, error)
}

type LsPathStat struct {
	Directory bool
}

type LsToolDetails struct {
	EntryLimitReached *float64         `json:"entryLimitReached,omitempty"`
	Truncation        *truncate.Result `json:"truncation,omitempty"`
}

type LsToolInput struct {
	Path  *string  `json:"path,omitempty"`
	Limit *float64 `json:"limit,omitempty"`
}

type LsToolOptions struct {
	Operations LsOperations
}

type OutputAccumulator struct {
	// contains filtered or unexported fields
}

type OutputAccumulatorOptions struct {
	MaxLines       *int
	MaxBytes       *int
	TempFilePrefix *string
}

type OutputSnapshot struct {
	Content        string
	Truncation     truncate.Result
	FullOutputPath string
}

type OutputSnapshotOptions struct {
	PersistIfTruncated bool
}

type PlainTextRenderer interface {
	RenderCall(args any) string
	RenderResult(result engine.AgentToolResult) string
}

type ProcessImageOptions struct {
	AutoResizeImages *bool
	ResizeOptions    *ImageResizeOptions
}

type ProcessImageResult struct {
	OK       bool
	Data     string
	MimeType string
	Hints    []string
	Message  string
}

type ReadImageOperations interface {
	DetectImageMimeType(context.Context, string) (string, error)
}

type ReadOperations interface {
	ReadFile(context.Context, string) ([]byte, error)
	Access(context.Context, string) error
}

type ReadToolDetails struct {
	Truncation *truncate.Result `json:"truncation,omitempty"`
}

type ReadToolInput struct {
	Path   string   `json:"path"`
	Offset *float64 `json:"offset,omitempty"`
	Limit  *float64 `json:"limit,omitempty"`
}

type ReadToolOptions struct {
	Operations       ReadOperations
	AutoResizeImages *bool
}

type ResizedImage struct {
	Data           string
	MimeType       string
	OriginalWidth  int
	OriginalHeight int
	Width          int
	Height         int
	WasResized     bool
}

type ToolsOptions struct {
	Read  *ReadToolOptions
	Bash  *BashToolOptions
	Edit  *EditToolOptions
	Write *WriteToolOptions
	Grep  *GrepToolOptions
	Find  *FindToolOptions
	Ls    *LsToolOptions
}

type WriteOperations interface {
	WriteFile(context.Context, string, string) error
	MkdirAll(context.Context, string) error
}

type WriteToolInput struct {
	Path    string `json:"path"`
	Content string `json:"content"`
}

type WriteToolOptions struct {
	Operations WriteOperations
}