When an AppWorld task references a file or directory path (e.g. "~/bills/"):
- Recognize that the data lives in the simulated
file_systemapp, not the host shell. Hostls/findon such paths returns "No such file or directory"; do not burn turns probing/,/home,whoami, orecho $HOME. - Retrieve credentials first from the supervisor: call
show_account_passwordsvia the appworld client. - Read the relevant app docs up front:
docs file_system(plusdocs supervisor) andmetadatato learn the exact call names. - Read the file/directory through the file_system API (e.g.
show_directory/show_file) using the retrieved credentials. - Only then act on the returned contents as the task requests.
Trigger check: if the session exposes AppWorld tools (appworld_client metadata/docs/execute) and a mentioned path is absent from the host filesystem, go straight to the app API instead of probing the shell.