fix(hierarchical-swarm): record the director's plan, not its raw tool call

parse_orders already extracts (plan, orders) from the director's tool
call. run_director recorded the unparsed call instead, so every worker
read a rendering of it as prose. Record the plan and the per-agent
assignments; any_to_str has no callers left.

Author: ayaangazali

swarms/structs/hiearchical_swarm.py

@@ -27,7 +27,6 @@
     split_last_turn,
 )
 from swarms.structs.conversation import Conversation
-from swarms.utils.any_to_str import any_to_str
 from swarms.structs.ma_blocks import find_agent_by_name
 from swarms.structs.ma_utils import list_all_agents
 from swarms.structs.omni_agent_types import AgentListType
@@ -686,15 +685,21 @@ def run_director(
                 img=img,
             )
 
-            # A tool-call list stored raw renders as a Python repr in the
-            # history that every later agent reads. Keep it readable.
+            if isinstance(function_call, str):
+                director_record = function_call
+            else:
+                plan, orders = self.parse_orders(function_call)
+                director_record = "\n\n".join(
+                    [plan]
+                    + [
+                        f"{order.agent_name}: {order.task}"
+                        for order in orders
+                    ]
+                )
+
             self.conversation.add(
                 role="Director",
-                content=(
-                    function_call
-                    if isinstance(function_call, str)
-                    else any_to_str(function_call)
-                ),
+                content=director_record,
             )
 
             return function_call

tests/structs/test_hierarchical_swarm.py

@@ -1158,5 +1158,62 @@ def test_the_conversation_starts_clean(self):
         ), f"stale messages loaded from disk: {roles}"
 
 
+def test_director_plan_is_recorded_as_prose_not_a_tool_call():
+    """Workers read the shared history, so the plan must not be a tool-call repr."""
+    import json
+    from unittest.mock import patch
+
+    tool_call = [
+        {
+            "role": "assistant",
+            "content": [
+                {
+                    "function": {
+                        "name": "create_plan",
+                        "arguments": json.dumps(
+                            {
+                                "plan": "Explain the rate hikes.",
+                                "orders": [
+                                    {
+                                        "agent_name": "Markets",
+                                        "task": "Compile an overview.",
+                                    }
+                                ],
+                            }
+                        ),
+                    }
+                }
+            ],
+        }
+    ]
+
+    swarm = HierarchicalSwarm(
+        name="s",
+        description="d",
+        agents=[
+            Agent(
+                agent_name="Markets",
+                model_name="gpt-4o-mini",
+                max_loops=1,
+            )
+        ],
+        max_loops=1,
+    )
+
+    with patch.object(swarm.director, "run", return_value=tool_call):
+        swarm.run_director(task="explain the rate hikes")
+
+    recorded = [
+        m["content"]
+        for m in swarm.conversation.conversation_history
+        if m.get("role") == "Director"
+    ][-1]
+
+    assert "Explain the rate hikes." in recorded
+    assert "Markets: Compile an overview." in recorded
+    assert "arguments" not in recorded
+    assert "create_plan" not in recorded
+
+
 if __name__ == "__main__":
     pytest.main([__file__, "-v"])