Skip to content

TradingAgents: Multi-Agents LLM Financial Trading Framework

refactor: move the decision log to tradingagents/decision_log.py

Yijia-Xiaoe7354d8af496
diff --git a/tests/test_backtest.py b/tests/test_backtest.py
index fb32e66ec..e86d40973 100644
--- a/tests/test_backtest.py
+++ b/tests/test_backtest.py
@@ -10,8 +10,8 @@ from __future__ import annotations
import pytest
-from tradingagents.agents.utils.memory import TradingMemoryLog
from tradingagents.backtest import iter_grid, run_backtest, summarize
+from tradingagents.decision_log import TradingMemoryLog
DECISION = "Rating: Buy\n\nbuy it"
diff --git a/tests/test_cli_decision_log.py b/tests/test_cli_decision_log.py
index c381ce7a8..d58c0d962 100644
--- a/tests/test_cli_decision_log.py
+++ b/tests/test_cli_decision_log.py
@@ -11,7 +11,7 @@ from __future__ import annotations
import pytest
-from tradingagents.agents.utils.memory import TradingMemoryLog
+from tradingagents.decision_log import TradingMemoryLog
from tradingagents.graph.trading_graph import TradingAgentsGraph
diff --git a/tests/test_memory_log.py b/tests/test_memory_log.py
index 015d2d0a9..a92cd10bb 100644
--- a/tests/test_memory_log.py
+++ b/tests/test_memory_log.py
@@ -7,7 +7,7 @@ import pytest
from tradingagents.agents.managers.portfolio_manager import create_portfolio_manager
from tradingagents.agents.schemas import PortfolioDecision, PortfolioRating
-from tradingagents.agents.utils.memory import TradingMemoryLog
+from tradingagents.decision_log import TradingMemoryLog
from tradingagents.graph.propagation import Propagator
from tradingagents.graph.reflection import Reflector
from tradingagents.graph.trading_graph import TradingAgentsGraph
@@ -886,12 +886,12 @@ class TestLegacyRemoval:
def test_financial_situation_memory_removed(self):
"""FinancialSituationMemory must not be importable from the memory module."""
- import tradingagents.agents.utils.memory as m
+ import tradingagents.decision_log as m
assert not hasattr(m, "FinancialSituationMemory")
def test_bm25_not_imported(self):
"""rank_bm25 must not be present in the memory module namespace."""
- import tradingagents.agents.utils.memory as m
+ import tradingagents.decision_log as m
assert not hasattr(m, "BM25Okapi")
def test_reflect_and_remember_removed(self):
@@ -957,7 +957,7 @@ class TestLegacyRemoval:
def test_a_failed_reflection_leaves_the_entry_pending_and_lets_the_run_start(tmp_path, monkeypatch):
"""Settling past decisions happens on the way into a new run, and reflection
calls an LLM. A transient failure there must not stop the new analysis."""
- from tradingagents.agents.utils.memory import TradingMemoryLog
+ from tradingagents.decision_log import TradingMemoryLog
from tradingagents.graph.trading_graph import TradingAgentsGraph
graph = object.__new__(TradingAgentsGraph)
@@ -990,7 +990,7 @@ def test_a_failed_reflection_leaves_the_entry_pending_and_lets_the_run_start(tmp
def test_the_holding_window_is_configurable(tmp_path, monkeypatch):
"""A decision written for months should not be graded at a week without the
operator choosing that window."""
- from tradingagents.agents.utils.memory import TradingMemoryLog
+ from tradingagents.decision_log import TradingMemoryLog
from tradingagents.graph.trading_graph import TradingAgentsGraph
graph = object.__new__(TradingAgentsGraph)
diff --git a/tests/test_memory_pointintime.py b/tests/test_memory_pointintime.py
index 8d312c7c5..6adaf082d 100644
--- a/tests/test_memory_pointintime.py
+++ b/tests/test_memory_pointintime.py
@@ -10,7 +10,7 @@ from __future__ import annotations
import pytest
-from tradingagents.agents.utils.memory import TradingMemoryLog
+from tradingagents.decision_log import TradingMemoryLog
def _log(tmp_path):
diff --git a/tests/test_portfolio_context.py b/tests/test_portfolio_context.py
index dbf5f80eb..f467fe441 100644
--- a/tests/test_portfolio_context.py
+++ b/tests/test_portfolio_context.py
@@ -76,7 +76,7 @@ def test_load_reads_a_valid_file(tmp_path):
# --- threading through the graph --------------------------------------------
def _bare_graph(tmp_path):
- from tradingagents.agents.utils.memory import TradingMemoryLog
+ from tradingagents.decision_log import TradingMemoryLog
from tradingagents.graph.propagation import Propagator
from tradingagents.graph.trading_graph import TradingAgentsGraph
diff --git a/tests/test_rating_integrity.py b/tests/test_rating_integrity.py
index 77e8f14b9..78625f9f7 100644
--- a/tests/test_rating_integrity.py
+++ b/tests/test_rating_integrity.py
@@ -63,7 +63,7 @@ def test_the_scale_quoted_in_a_prompt_does_not_become_the_rating():
@pytest.mark.unit
def test_the_memory_log_records_review_rather_than_a_tradeable_hold(tmp_path):
- from tradingagents.agents.utils.memory import TradingMemoryLog
+ from tradingagents.decision_log import TradingMemoryLog
log = TradingMemoryLog({"memory_log_path": str(tmp_path / "m.md")})
log.store_decision("NVDA", "2026-01-05", REFUSAL)
@@ -75,7 +75,7 @@ def test_the_memory_log_records_review_rather_than_a_tradeable_hold(tmp_path):
@pytest.mark.unit
def test_the_signal_and_the_log_agree_on_the_same_decision(tmp_path):
from tradingagents.agents.rating import parse_rating
- from tradingagents.agents.utils.memory import TradingMemoryLog
+ from tradingagents.decision_log import TradingMemoryLog
log = TradingMemoryLog({"memory_log_path": str(tmp_path / "m.md")})
for text in (INVERTED, REFUSAL, "**Rating**: Buy\n\nAccumulate."):
@@ -89,8 +89,8 @@ def test_the_signal_and_the_log_agree_on_the_same_decision(tmp_path):
@pytest.mark.unit
def test_an_unscored_decision_is_left_out_of_the_backtest_figures(tmp_path):
"""REVIEW has no direction, so it cannot count for or against the system."""
- from tradingagents.agents.utils.memory import TradingMemoryLog
from tradingagents.backtest import summarize
+ from tradingagents.decision_log import TradingMemoryLog
log = TradingMemoryLog({"memory_log_path": str(tmp_path / "m.md")})
log.store_decision("NVDA", "2026-01-05", "**Rating**: Buy\n\nx")
diff --git a/tradingagents/backtest.py b/tradingagents/backtest.py
index afa0b409b..65c4d9a6a 100644
--- a/tradingagents/backtest.py
+++ b/tradingagents/backtest.py
@@ -22,9 +22,9 @@ from datetime import datetime, timedelta
from pathlib import Path
from tradingagents.agents.rating import RATING_REVIEW
-from tradingagents.agents.utils.memory import TradingMemoryLog
from tradingagents.dataflows.date_window import get_current_date
from tradingagents.dataflows.symbols import safe_ticker_component
+from tradingagents.decision_log import TradingMemoryLog
from tradingagents.graph.trading_graph import TradingAgentsGraph
logger = logging.getLogger(__name__)
diff --git a/tradingagents/agents/utils/memory.py b/tradingagents/decision_log.py
similarity index 100%
rename from tradingagents/agents/utils/memory.py
rename to tradingagents/decision_log.py
diff --git a/tradingagents/graph/trading_graph.py b/tradingagents/graph/trading_graph.py
index 247f9ec59..7a0c77ced 100644
--- a/tradingagents/graph/trading_graph.py
+++ b/tradingagents/graph/trading_graph.py
@@ -10,11 +10,11 @@ from typing import Any
from tradingagents.agents.context import build_instrument_context, resolve_instrument_identity
from tradingagents.agents.rating import parse_rating
-from tradingagents.agents.utils.memory import TradingMemoryLog
from tradingagents.dataflows.config import run_config, set_config
from tradingagents.dataflows.date_window import get_current_date
from tradingagents.dataflows.symbols import safe_ticker_component
from tradingagents.dataflows.vendors.yahoo.market import get_closes
+from tradingagents.decision_log import TradingMemoryLog
from tradingagents.default_config import DEFAULT_CONFIG
from tradingagents.llm_clients import create_llm_client
from tradingagents.reporting import write_report_tree