Build and run agents you can see, understand and trust.
Python agentchatbotlarge-language-modelsllmllm-agentmcpmulti-agentmulti-modalreact-agentrealtime-agentvoice-agentvoice-assistant
fix(workspace): offload nested media from context archives (#3201)
kino34457377b291
diff --git a/src/agentscope/workspace/_base.py b/src/agentscope/workspace/_base.pyindex 2f782ceba..f60d53b75 100644--- a/src/agentscope/workspace/_base.py+++ b/src/agentscope/workspace/_base.py@@ -80,7 +80,9 @@ from .._utils._common import _generate_id, _normalize_local_pathfrom ..mcp import MCPClientfrom ..message import (Base64Source,+ ContentBlock,DataBlock,+ HintBlock,Msg,TextBlock,ToolResultBlock,@@ -1017,9 +1019,10 @@ class WorkspaceBase:Appends every message in ``msgs`` to``${workdir}/sessions/<session_id>/context.jsonl`` (onemessage per JSONL line). Inline base64- :class:`DataBlock` payloads are extracted into ``data/`` and- rewritten as portable ``workspace://`` URL blocks before- serialisation so the JSONL line size stays bounded.+ :class:`DataBlock` payloads, including those in tool results and+ hints, are extracted into ``data/`` and rewritten as portable+ ``workspace://`` URL sources before serialisation so the JSONL+ line size stays bounded.Args:session_id (`str`):@@ -1038,19 +1041,38 @@ class WorkspaceBase:base = backend.join_path(self._sessions_dir, session_id)path = backend.join_path(base, "context.jsonl")+ async def offload_block(block: ContentBlock) -> ContentBlock:+ """Offload inline media from a copied content block.++ Args:+ block (`ContentBlock`):+ The copied block to inspect.++ Returns:+ `ContentBlock`:+ The block with inline media replaced by workspace URLs.+ """+ if isinstance(block, DataBlock) and isinstance(+ block.source,+ Base64Source,+ ):+ return await self.offload_data_block(block)+ if isinstance(block, ToolResultBlock) and isinstance(+ block.output,+ list,+ ):+ block.output = [+ await offload_block(item) for item in block.output+ ]+ elif isinstance(block, HintBlock) and isinstance(block.hint, list):+ block.hint = [await offload_block(item) for item in block.hint]+ return block+copied = deepcopy(msgs)lines: list[str] = []for msg in copied:if not isinstance(msg.content, str):- content: list = []- for block in msg.content:- if isinstance(block, DataBlock) and isinstance(- block.source,- Base64Source,- ):- block = await self.offload_data_block(block)- content.append(block)- msg.content = content+ msg.content = [await offload_block(b) for b in msg.content]lines.append(msg.model_dump_json())payload = "\n".join(lines) + "\n"diff --git a/tests/workspace_local_test.py b/tests/workspace_local_test.pyindex 725918a91..ecdc8643d 100644--- a/tests/workspace_local_test.py+++ b/tests/workspace_local_test.py@@ -40,6 +40,7 @@ from agentscope.message import (UserMsg,AssistantMsg,DataBlock,+ HintBlock,Base64Source,URLSource,TextBlock,@@ -349,6 +350,62 @@ class TestLocalWorkspaceOffload(IsolatedAsyncioTestCase):expected_msg.model_dump_json(),)+ async def test_offload_context_nested_media(self) -> None:+ """Offload nested media without changing the caller's message."""+ data = base64.b64encode(b"nested media").decode()+ media = DataBlock(+ id="media",+ source=Base64Source(data=data, media_type="image/png"),+ created_at="2026-01-01T00:00:00",+ )+ msg = AssistantMsg(+ name="assistant",+ content=[+ ToolResultBlock(+ id="tool-call",+ name="get_media",+ output=[media],+ state=ToolResultState.SUCCESS,+ created_at="2026-01-01T00:00:00",+ ),+ HintBlock(+ id="hint",+ hint=[media],+ created_at="2026-01-01T00:00:00",+ ),+ ],+ id="message",+ created_at="2026-01-01T00:00:00",+ )+ original = msg.model_dump(mode="json")++ path = await self.workspace.offload_context("nested-media", [msg])+ saved = Msg.model_validate_json(+ await self.workspace.get_backend().read_file(path),+ )++ url = (+ "workspace:///data/"+ f"{hashlib.sha256(data.encode()).hexdigest()}.png"+ )+ expected = msg.model_dump(mode="json")+ for index, field in ((0, "output"), (1, "hint")):+ expected["content"][index][field][0] = {+ "type": "data",+ "id": "media",+ "source": {+ "type": "url",+ "url": url,+ "media_type": "image/png",+ },+ "name": None,+ "created_at": AnyString(),+ "finished_at": None,+ }++ self.assertEqual(saved.model_dump(mode="json"), expected)+ self.assertEqual(msg.model_dump(mode="json"), original)+async def test_offload_data_block_deduplication(self) -> None:"""Test that duplicate DataBlocks are deduplicated.