esengine--deepseek-reasonix/internal/tool/builtin/ls.go

package builtin

import (
	"context"
	"encoding/json"
	"fmt"
	"os"
	"path/filepath"
	"strings"

	"reasonix/internal/tool"
)

func init() { tool.RegisterBuiltin(listDir{}) }

// listDir lists a directory. workDir, when non-empty, is the directory a
// relative path resolves against (see resolveIn). paths resolves session-scoped
// read aliases for external folder refs. forbidRoots lists directories the tool
// may not list or recurse into.
type listDir struct {
	workDir     string
	paths       *PathResolver
	forbidRoots []string
}

func (listDir) Name() string { return "ls" }

func (listDir) Description() string {
	return "List the entries of a directory. Directories are shown with a trailing slash; files show their byte size. Set recursive=true to list all nested files depth-first (skips .git/node_modules)."
}

func (listDir) Schema() json.RawMessage {
	return json.RawMessage(`{"type":"object","properties":{"path":{"type":"string","description":"Directory path (default \".\")"},"recursive":{"type":"boolean","description":"When true, recursively list all nested files (default false)"}}}`)
}

func (listDir) ReadOnly() bool { return true }

// SnipHint keeps a long head and short tail like grep/glob: the first entries
// matter most, the tail confirms scope.
func (listDir) SnipHint() tool.SnipHint {
	return tool.SnipHint{Head: 80, Tail: 8, HeadChars: 10000, TailChars: 1000}
}

func (l listDir) Execute(ctx context.Context, args json.RawMessage) (string, error) {
	p := struct {
		Path      string `json:"path"`
		Recursive bool   `json:"recursive"`
	}{Path: "."}
	if len(args) > 0 {
		if err := json.Unmarshal(args, &p); err != nil {
			return "", fmt.Errorf("invalid args: %w", err)
		}
	}
	if p.Path == "" {
		p.Path = "."
	}
	rp := resolveReadablePath(l.workDir, p.Path, l.paths)
	p.Path = rp.Path
	if confineRead(l.forbidRoots, p.Path) {
		return "(empty directory)", nil
	}

	// Recursive mode: walk the whole tree depth-first.
	if p.Recursive {
		return l.listRecursive(p.Path, rp)
	}

	entries, err := os.ReadDir(p.Path)
	if err != nil {
		if rp.External {
			return "", fmt.Errorf("ls %s: %s", rp.DisplayPath, rp.ErrorText(err))
		}
		return "", fmt.Errorf("ls %s: %w", rp.DisplayPath, err)
	}

	var b strings.Builder
	for _, e := range entries {
		if e.IsDir() {
			fmt.Fprintf(&b, "%s/\n", e.Name())
			continue
		}
		size := int64(-1)
		if info, err := e.Info(); err == nil {
			size = info.Size()
		}
		fmt.Fprintf(&b, "%s\t%d\n", e.Name(), size)
	}
	if b.Len() == 0 {
		return "(empty directory)", nil
	}
	return b.String(), nil
}

// listRecursive walks a directory tree depth-first, skipping noise dirs.
// Depth is capped to guard against symlink loops.
func (l listDir) listRecursive(root string, rp ResolvedPath) (string, error) {
	var b strings.Builder
	err := filepath.WalkDir(root, func(p string, d os.DirEntry, wErr error) error {
		if wErr != nil {
			return wErr
		}
		if p == root {
			return nil
		}
		if d.IsDir() {
			switch d.Name() {
			case ".git", "node_modules", ".DS_Store", "__pycache__", ".idea", ".vscode":
				return filepath.SkipDir
			}
			if skipForbidDir(p, l.forbidRoots) {
				return filepath.SkipDir
			}
		}
		rel, rErr := filepath.Rel(root, p)
		if rErr != nil {
			rel = p
		}
		// Guard against excessive depth.
		if strings.Count(rel, string(os.PathSeparator)) > 50 {
			if d.IsDir() {
				return filepath.SkipDir
			}
			return nil
		}
		rel = filepath.ToSlash(rel)
		if d.IsDir() {
			rel += "/"
		} else if info, iErr := d.Info(); iErr == nil {
			rel += fmt.Sprintf("\t%d", info.Size())
		}
		b.WriteString(rel + "\n")
		return nil
	})
	if err != nil {
		if rp.External {
			return "", fmt.Errorf("ls -R %s: %s", rp.DisplayPath, rp.ErrorText(err))
		}
		return "", fmt.Errorf("ls -R %s: %w", rp.DisplayPath, err)
	}
	if b.Len() == 0 {
		return "(empty directory tree)", nil
	}
	return b.String(), nil
}