feat(agent): align the document tools with the harness-trained shape — ls, read(path), grep(pattern, path?)

tests/integration/test_api.py

@@ -300,11 +300,12 @@ def test_ui_chrome_has_no_emoji(client, path: str) -> None:
     Phase 37 revision (owner permission 2026-08-26, PLAN §4): the agent's
     ``.tool-call`` line carries the CONTENT marks — 🔎 (list) and 📄
     (read) — the only emoji in the whole frontend, and only as the exact
-    tool-line template strings in app.js. Phase 68 revision: the
-    ``search_documents`` tool line adds the third template literal
-    ("🔎 Searching for "). The guard strips precisely those three
-    literals; any other emoji, or those marks anywhere else, still
-    fails."""
+    tool-line template strings in app.js. Phase 68 revision: the search
+    tool line (the ``grep`` tool, phase 70) adds the third template
+    literal ("🔎 Searching for "). Phase 70 revision: the scoped ``ls``
+    tool line adds the fourth ("🔎 Listing documents in "). The guard strips
+    precisely those four literals; any other emoji, or those marks
+    anywhere else, still fails."""
     r = client.get(path)
     assert r.status_code == 200
     text = r.text
@@ -312,6 +313,7 @@ def test_ui_chrome_has_no_emoji(client, path: str) -> None:
         text = text.replace('"🔎 Listing documents"', "")
         text = text.replace('"📄 Reading "', "")
         text = text.replace('"🔎 Searching for "', "")
+        text = text.replace('"🔎 Listing documents in "', "")
     assert _find_emoji(text) == [], f"emoji found in {path}: {_find_emoji(text)!r}"