deer-flow/backend/tests/test_thread_data_middleware.py
greatmengqi 57d36a0977 test(thread_data_middleware): cover run_id stamping on HumanMessage
Two new cases in test_thread_data_middleware.py pin the merge contract
between PR (frozen DeerFlowContext) and release/2.0-rc (HumanMessage
stamping logic):

- test_before_agent_stamps_run_id_and_timestamp_on_last_human_message:
  given DeerFlowContext(run_id="r-stamp"), the trailing HumanMessage
  in state gets additional_kwargs["run_id"] == "r-stamp" and a
  timestamp; id and name are preserved/normalized.

- test_before_agent_stamps_none_run_id_when_context_omits_it:
  run_id is optional on DeerFlowContext, so middleware must stamp
  None gracefully rather than raise.

These were the smoke target for the merge: prior to this commit
the only signal that runtime.context.run_id worked end-to-end was
a manual gateway run.
2026-04-26 12:42:17 +08:00

96 lines
4.3 KiB
Python

import pytest
from deerflow.agents.middlewares.thread_data_middleware import ThreadDataMiddleware
from deerflow.config.app_config import AppConfig
from deerflow.config.deer_flow_context import DeerFlowContext
from deerflow.config.sandbox_config import SandboxConfig
def _as_posix(path: str) -> str:
return path.replace("\\", "/")
def _make_context(thread_id: str, run_id: str | None = None) -> DeerFlowContext:
return DeerFlowContext(
app_config=AppConfig(sandbox=SandboxConfig(use="test")),
thread_id=thread_id,
run_id=run_id,
)
class TestThreadDataMiddleware:
def test_before_agent_returns_paths_when_thread_id_present_in_context(self, tmp_path):
middleware = ThreadDataMiddleware(base_dir=str(tmp_path), lazy_init=True)
from langgraph.runtime import Runtime
result = middleware.before_agent(state={}, runtime=Runtime(context=_make_context("thread-123")))
assert result is not None
assert _as_posix(result["thread_data"]["workspace_path"]).endswith("threads/thread-123/user-data/workspace")
assert _as_posix(result["thread_data"]["uploads_path"]).endswith("threads/thread-123/user-data/uploads")
assert _as_posix(result["thread_data"]["outputs_path"]).endswith("threads/thread-123/user-data/outputs")
def test_before_agent_uses_thread_id_from_context(self, tmp_path):
middleware = ThreadDataMiddleware(base_dir=str(tmp_path), lazy_init=True)
from langgraph.runtime import Runtime
result = middleware.before_agent(state={}, runtime=Runtime(context=_make_context("thread-from-config")))
assert result is not None
assert _as_posix(result["thread_data"]["workspace_path"]).endswith("threads/thread-from-config/user-data/workspace")
def test_before_agent_uses_thread_id_from_typed_context(self, tmp_path):
middleware = ThreadDataMiddleware(base_dir=str(tmp_path), lazy_init=True)
from langgraph.runtime import Runtime
result = middleware.before_agent(state={}, runtime=Runtime(context=_make_context("thread-from-dict")))
assert result is not None
assert _as_posix(result["thread_data"]["uploads_path"]).endswith("threads/thread-from-dict/user-data/uploads")
def test_before_agent_raises_clear_error_when_thread_id_missing(self, tmp_path):
middleware = ThreadDataMiddleware(base_dir=str(tmp_path), lazy_init=True)
from langgraph.runtime import Runtime
with pytest.raises(ValueError, match="Thread ID is required"):
middleware.before_agent(state={}, runtime=Runtime(context=_make_context("")))
def test_before_agent_stamps_run_id_and_timestamp_on_last_human_message(self, tmp_path):
"""Smoke for the release/2.0-rc + PR merge: run_id from typed
DeerFlowContext flows into the trailing HumanMessage's
additional_kwargs alongside an ISO-8601 timestamp."""
from langchain_core.messages import HumanMessage
from langgraph.runtime import Runtime
middleware = ThreadDataMiddleware(base_dir=str(tmp_path), lazy_init=True)
original = HumanMessage(content="hello", id="m-1")
result = middleware.before_agent(
state={"messages": [original]},
runtime=Runtime(context=_make_context("t-stamp", run_id="r-stamp")),
)
assert result is not None
stamped = result["messages"][-1]
assert isinstance(stamped, HumanMessage)
assert stamped.id == "m-1"
assert stamped.name == "user-input"
assert stamped.additional_kwargs["run_id"] == "r-stamp"
assert "timestamp" in stamped.additional_kwargs
def test_before_agent_stamps_none_run_id_when_context_omits_it(self, tmp_path):
"""run_id is optional: middleware must still stamp (with None) rather than crash."""
from langchain_core.messages import HumanMessage
from langgraph.runtime import Runtime
middleware = ThreadDataMiddleware(base_dir=str(tmp_path), lazy_init=True)
result = middleware.before_agent(
state={"messages": [HumanMessage(content="hi", id="m-2")]},
runtime=Runtime(context=_make_context("t-no-run")),
)
assert result is not None
stamped = result["messages"][-1]
assert stamped.additional_kwargs["run_id"] is None