From 3ca4f4ce7241d714978e2972f7aae4c7b7e28cde Mon Sep 17 00:00:00 2001
From: bearsyankees <bearsyankees@gmail.com>
Date: Fri, 28 Aug 2026 09:51:21 -0400
Subject: [PATCH] Clarify chat file path handling

---
 strix/interface/cloud/spec.py | 8 +++++++-
 tests/test_cloud_cli.py       | 6 ++++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/strix/interface/cloud/spec.py b/strix/interface/cloud/spec.py
index 22ff0f78..693bba6c 100644
--- a/strix/interface/cloud/spec.py
+++ b/strix/interface/cloud/spec.py
@@ -710,7 +710,13 @@ SPEC: dict[str, dict[str, Cmd]] = {
             "GET",
             "/chat/{chatId}/files/download",
             "Download one file of a chat session.",
-            query=(P("path", required=True, help="File path inside the session."),),
+            query=(
+                P(
+                    "path",
+                    required=True,
+                    help="Relative path in the session, or an absolute path under /workspace.",
+                ),
+            ),
             binary=True,
         ),
         "files archive": Cmd(
diff --git a/tests/test_cloud_cli.py b/tests/test_cloud_cli.py
index 4073353d..660cb65d 100644
--- a/tests/test_cloud_cli.py
+++ b/tests/test_cloud_cli.py
@@ -1272,6 +1272,12 @@ def test_corrected_help_distinguishes_inboxes_reports_and_self_hosted_commands()
     assert "triaged" not in vulnerability_update["status"]
     assert "false_positive" not in vulnerability_update["status"]
 
+    chat_download = {
+        param.name: param.help for param in SPEC["chat"]["files download"].query
+    }
+    assert "Relative path" in chat_download["path"]
+    assert "/workspace" in chat_download["path"]
+
     report = {param.name: param.help for param in SPEC["scans"]["report"].query}
     assert "Report content" in report["format"]
     assert "file type" in report["type"]