Reduce WhatsApp ops tool friction with looser xlsx/file schemas and short-intent playbooks.

Production usage showed schema mismatches and multi-tool loops; accept common arg aliases and route agents to <=3-call alarm recipes.

Co-authored-by: Cursor <cursoragent@cursor.com>

tests/test_write_file_tool_aliases.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+from runtime.tools.public.write_file_tool import write_file_tool
+from runtime.tools.tool_validation import filter_arguments_to_schema, validate_tool_arguments
+
+
+def test_write_file_accepts_filename_alias(tmp_path, monkeypatch) -> None:
+    target = tmp_path / "workspace" / "note.txt"
+    monkeypatch.setattr(
+        "runtime.tools.public.write_file_tool.resolve_workspace_path",
+        lambda raw: target,
+    )
+    spec = write_file_tool()
+    out = spec.handler({"filename": "note.txt", "text": "hello"})
+    assert out.get("ok") is True
+    assert target.read_text(encoding="utf-8") == "hello"
+
+
+def test_write_file_schema_allows_aliases() -> None:
+    spec = write_file_tool()
+    args = {"file": "a.txt", "content": "x"}
+    filtered = filter_arguments_to_schema(spec.parameters, args)
+    ok, err = validate_tool_arguments(spec.parameters, filtered)
+    assert ok, err
+    assert "file" in filtered
+
+
+def test_write_file_path_required_message() -> None:
+    spec = write_file_tool()
+    out = spec.handler({"content": "x"})
+    assert out.get("ok") is False
+    assert out.get("error") == "path_required"
+    assert "example" in out