From 47ba7950f65b5bcd2f02233ba5586e79ea7aa366 Mon Sep 17 00:00:00 2001 From: philipph-askui Date: Wed, 12 Aug 2026 14:42:47 -0700 Subject: [PATCH] docs: clarify get_file_names_tool returns files only, not folders Make the tool description explicit that the tool lists only regular files and never includes folders/subdirectories, so the agent does not try to use it to discover or navigate directories. Co-Authored-By: Claude Opus 4.8 (1M context) --- .../tools/store/computer/experimental/get_file_names.py | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/src/askui/tools/store/computer/experimental/get_file_names.py b/src/askui/tools/store/computer/experimental/get_file_names.py index 643820fb..dd313f58 100644 --- a/src/askui/tools/store/computer/experimental/get_file_names.py +++ b/src/askui/tools/store/computer/experimental/get_file_names.py @@ -28,9 +28,11 @@ def __init__(self, agent_os: ComputerAgentOS | None = None) -> None: name="get_file_names_tool", description=( "Lists the names of regular files in an absolute directory on the " - "computer under automation. Subdirectories are not included—only " - "files are returned. Use absolute paths as on the target machine. " - "Returns names only; use get_file_tool to read a file's contents." + "computer under automation. IMPORTANT: only files are returned - " + "folders and subdirectories are NOT included in the result and this " + "tool cannot be used to discover or navigate them. Use absolute " + "paths as on the target machine. Returns names only; use " + "get_file_tool to read a file's contents." ), input_schema={ "type": "object",