Skip to content

Build and run agents you can see, understand and trust.

fix(workspace): offload nested media from context archives (#3201)

kino34457377b291
diff --git a/src/agentscope/workspace/_base.py b/src/agentscope/workspace/_base.py
index 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_path
from ..mcp import MCPClient
from ..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`` (one
message 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.py
index 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.