| name | fs-find |
| type | python |
| description | Find files by filename pattern (glob) under scenarios/<world_name>/fs and return a Collection. |
| schema_hint | {"pattern":"string (glob pattern)","path":"string (relative)","recursive":"bool","max_results":"int"} |
fs-find
Find files by filename pattern (glob) within the filesystem sandbox for the current world.
Input
pattern: Glob pattern for filename matching (required, e.g., ".txt", "Nan_", "Ar")path: Directory to search (default: "." root)recursive: Whether to search subdirectories (default: true)max_results: Maximum files to return (default: 200)
Pattern Matching
- Uses shell-style glob patterns (via Python
fnmatch)
- Matches against filename only (not full path)
- Common patterns:
"*.txt" - all .txt files"Nan_*" - files starting with "Nan_""*Ar*" - files containing "Ar""Nan_Ar.txt" - exact filename match
Note: Pattern cannot contain path separators (/ or \). Use the path parameter to search in specific directories.
Output
Success returns:
resource_id: Collection ID containing matching file Notes- Collection items are placeholder file Notes (path/size/mtime/format in metadata; body
(placeholder) until fs-read)
Examples
{"type":"fs-find","pattern":"*.txt","out":"$txt_files"}
{"type":"fs-find","pattern":"Nan_*","path":"bhagavan","recursive":false,"out":"$matches"}
{"type":"fs-find","pattern":"*Ar*","out":"$ar_files"}
