fs-list

name	fs-list
type	python
description	List files and directories under scenarios/<world_name>/fs; returns one Note whose body is a text listing (like ls).
schema_hint	{"path":"string (relative)","recursive":"bool","include_files":"bool","include_dirs":"bool","max_entries":"int"}

fs-list

List files and directories within the filesystem sandbox for the current world.

Input

• path: Relative path under scenarios/<world_name>/fs (default: root)
• recursive: Whether to recurse into subdirectories (default: false)
• include_files: Include files (default: true)
• include_dirs: Include subdirectory lines in the listing (default: true)
• max_entries: Max lines to emit before truncation (default: 200)

Output

Success returns:

• resource_id: Note ID (not a Collection)
• The Note's text body is a human-readable directory listing:
  • First line: the listed path (relative)
  • Directories: dirname/ (trailing slash)
  • Files: filename (size) — e.g. readme.md (2.1K), note.txt (219B)
  • Truncation line if max_entries reached

Read the listing with get_text("$your_out_var"). Do not use get_items — that is only for Collections.

How to interpret the text for a given goal is left to the planner.

Examples

{"type":"fs-list","path":".","out":"$root"}
{"type":"fs-list","path":"docs","recursive":true,"out":"$docs_tree"}

After out="$root", read the body with get_text("$root").