fstool

package
v0.3.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 26, 2026 License: MIT Imports: 12 Imported by: 2

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func ListDirectoryTool

func ListDirectoryTool() spec.Tool

func ReadFile

func ReadFile(ctx context.Context, args ReadFileArgs) ([]spec.ToolStoreOutputUnion, error)

ReadFile reads a file from disk and returns its contents. If Encoding == "binary" the output is base64-encoded.

func ReadFileTool

func ReadFileTool() spec.Tool

func SearchFilesTool

func SearchFilesTool() spec.Tool

func StatPathTool

func StatPathTool() spec.Tool

Types

type ListDirectoryArgs

type ListDirectoryArgs struct {
	Path    string `json:"path,omitempty"`    // default "."
	Pattern string `json:"pattern,omitempty"` // Optional glob
}

type ListDirectoryOut

type ListDirectoryOut struct {
	Entries []string `json:"entries"`
}

func ListDirectory

func ListDirectory(ctx context.Context, args ListDirectoryArgs) (*ListDirectoryOut, error)

ListDirectory lists files / dirs in Path. If Pattern is supplied, the results are filtered via filepath.Match.

type ReadFileArgs

type ReadFileArgs struct {
	Path     string `json:"path"`               // required
	Encoding string `json:"encoding,omitempty"` // "text" (default) | "binary"
}

type SearchFilesArgs

type SearchFilesArgs struct {
	Root       string `json:"root,omitempty"` // default "."
	Pattern    string `json:"pattern"`        // required (RE2)
	MaxResults int    `json:"maxResults,omitempty"`
}

type SearchFilesOut

type SearchFilesOut struct {
	Matches []string `json:"matches"`
}

func SearchFiles

func SearchFiles(ctx context.Context, args SearchFilesArgs) (*SearchFilesOut, error)

SearchFiles walks Root (recursively) and returns up to MaxResults files whose *path* or *UTF-8 text content* match the supplied regexp.

type StatPathArgs

type StatPathArgs struct {
	Path string `json:"path"`
}

type StatPathOut

type StatPathOut struct {
	Exists    bool       `json:"exists"`
	IsDir     bool       `json:"isDir"`
	SizeBytes int64      `json:"sizeBytes,omitempty"`
	ModTime   *time.Time `json:"modTime,omitempty"`
}

func StatPath

func StatPath(ctx context.Context, args StatPathArgs) (*StatPathOut, error)

StatPath returns basic metadata for the supplied path without mutating the file system.

Jump to

Keyboard shortcuts

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