merge upstream main into crypto-analysis-mvp

tradingagents/agents/utils/agent_utils.py

@@ -19,6 +19,36 @@ from tradingagents.agents.utils.news_data_tools import (
     get_global_news
 )
 
+
+def get_language_instruction() -> str:
+    """Return a prompt instruction for the configured output language.
+
+    Returns empty string when English (default), so no extra tokens are used.
+    Only applied to user-facing agents (analysts, portfolio manager).
+    Internal debate agents stay in English for reasoning quality.
+    """
+    from tradingagents.dataflows.config import get_config
+    lang = get_config().get("output_language", "English")
+    if lang.strip().lower() == "english":
+        return ""
+    return f" Write your entire response in {lang}."
+
+
+def build_instrument_context(ticker: str, asset_type: str = "stock") -> str:
+    """Describe the exact instrument so agents preserve exchange-qualified tickers."""
+    instrument_label = "asset" if asset_type == "crypto" else "instrument"
+    extra_hint = (
+        " Treat it as a crypto asset rather than a company, and do not assume company fundamentals are available."
+        if asset_type == "crypto"
+        else ""
+    )
+    return (
+        f"The {instrument_label} to analyze is `{ticker}`. "
+        "Use this exact ticker in every tool call, report, and recommendation, "
+        "preserving any exchange suffix (e.g. `.TO`, `.L`, `.HK`, `.T`, `-USD`)."
+        + extra_hint
+    )
+
 def create_msg_delete():
     def delete_messages(state):
         """Clear messages and add placeholder for Anthropic compatibility"""
@@ -35,4 +65,4 @@ def create_msg_delete():
     return delete_messages
 
 
-        
+