enhance - add sys.file.stat built in tool

created a built in tool that stats a file and returns the size, mode
and mod time.

Signed-off-by: Bill Maxwell <[email protected]>

Author: cloudnautique

pkg/builtin/builtin.go

@@ -118,6 +118,15 @@ var tools = map[string]types.Tool{
 		},
 		BuiltinFunc: SysRemove,
 	},
+	"sys.file.stat": {
+		Parameters: types.Parameters{
+			Description: "Gets size, modfied time, and mode of the specified file",
+			Arguments: types.ObjectSchema(
+				"filepath", "The complete path and filename of the file",
+			),
+		},
+		BuiltinFunc: SysFileStat,
+	},
 }
 
 func SysProgram() *types.Program {
@@ -377,6 +386,22 @@ func SysRemove(ctx context.Context, env []string, input string) (string, error)
 	return fmt.Sprintf("Removed file: %s", params.Location), os.Remove(params.Location)
 }
 
+func SysFileStat(ctx context.Context, env []string, input string) (string, error) {
+	var params struct {
+		Filepath string `json:"filepath,omitempty"`
+	}
+	if err := json.Unmarshal([]byte(input), &params); err != nil {
+		return "", err
+	}
+
+	stat, err := os.Stat(params.Filepath)
+	if err != nil {
+		return "", err
+	}
+
+	return fmt.Sprintf("File %s mode: %s, size: %d bytes, modtime: %s", params.Filepath, stat.Mode().String(), stat.Size(), stat.ModTime().String()), nil
+}
+
 func SysDownload(ctx context.Context, env []string, input string) (_ string, err error) {
 	var params struct {
 		URL      string `json:"url,omitempty"`