Skip to content

CubeLoop — a Pythonic, async-native agent harness core designed for high performance, readability, and production-grade persistence.

feat(compaction): include tool call arguments in summariser transcript

xf gong9f01ebbdf5fa
diff --git a/cubepi/middleware/compaction/summarizer.py b/cubepi/middleware/compaction/summarizer.py
index 2a8854f..2d9146a 100644
--- a/cubepi/middleware/compaction/summarizer.py
+++ b/cubepi/middleware/compaction/summarizer.py
@@ -1,6 +1,7 @@
from __future__ import annotations
import asyncio
+import json
from cubepi.middleware.compaction.state import CompactionState, message_refs
from cubepi.providers.base import (
@@ -12,6 +13,9 @@ from cubepi.providers.base import (
UserMessage,
)
+_ARG_VALUE_CHARS = 200
+_ARG_REPR_MAX = 500
+
SUMMARIZER_SYSTEM_PROMPT = """\
You compress a chat transcript into a brief, faithful narrative for an AI assistant
@@ -34,6 +38,39 @@ A previous summary already covers earlier turns:
Merge it with the new turns below. Output the updated summary."""
+def _shrink_strings(obj: object) -> object:
+ """Recursively shrink long string leaves; preserve everything else."""
+ if isinstance(obj, str):
+ if len(obj) <= _ARG_VALUE_CHARS:
+ return obj
+ return obj[:_ARG_VALUE_CHARS] + "...[truncated]"
+ if isinstance(obj, dict):
+ return {k: _shrink_strings(v) for k, v in obj.items()}
+ if isinstance(obj, list):
+ return [_shrink_strings(v) for v in obj]
+ return obj
+
+
+def _format_arguments(arguments: object) -> str:
+ """Render a ToolCall arguments dict as a compact JSON-ish suffix.
+
+ Long string field values are shrunk individually so short fields (file
+ paths, command names, query strings) survive intact. The full repr is
+ additionally capped at ``_ARG_REPR_MAX`` chars as a last-line defence
+ against pathological inputs (e.g. thousands of small fields).
+ """
+ if not arguments:
+ return ""
+ try:
+ shrunk = _shrink_strings(arguments)
+ serialised = json.dumps(shrunk, ensure_ascii=False)
+ except (TypeError, ValueError):
+ serialised = str(arguments)
+ if len(serialised) > _ARG_REPR_MAX:
+ serialised = serialised[:_ARG_REPR_MAX] + "..."
+ return " " + serialised
+
+
def _format_message_for_summary(message: Message) -> str:
role = message.__class__.__name__.removesuffix("Message").lower() or "message"
parts: list[str] = []
@@ -41,7 +78,7 @@ def _format_message_for_summary(message: Message) -> str:
if isinstance(block, TextContent):
parts.append(block.text)
elif isinstance(block, ToolCall):
- parts.append(f"[tool_call:{block.name}]")
+ parts.append(f"[tool_call:{block.name}]{_format_arguments(block.arguments)}")
elif hasattr(block, "text"):
parts.append(str(getattr(block, "text", "")))
return f"[{role}] " + " ".join(parts)
diff --git a/tests/middleware/compaction/test_summarizer.py b/tests/middleware/compaction/test_summarizer.py
index bf6e3cc..e05f986 100644
--- a/tests/middleware/compaction/test_summarizer.py
+++ b/tests/middleware/compaction/test_summarizer.py
@@ -154,3 +154,73 @@ def test_format_message_for_summary_includes_tool_calls_and_text_like_blocks() -
assert "checking" in formatted
assert "[tool_call:lookup]" in formatted
assert "extra text" in formatted
+
+
+def test_tool_call_arguments_included() -> None:
+ msg = AssistantMessage(
+ content=[
+ ToolCall(
+ id="c1",
+ name="read_file",
+ arguments={"path": "/home/user/config.py"},
+ ),
+ ]
+ )
+ formatted = _format_message_for_summary(msg)
+ assert "read_file" in formatted
+ assert "/home/user/config.py" in formatted
+
+
+def test_tool_call_long_string_value_truncated() -> None:
+ big_content = "x" * 1000
+ msg = AssistantMessage(
+ content=[
+ ToolCall(
+ id="c1",
+ name="write_file",
+ arguments={"path": "out.py", "content": big_content},
+ ),
+ ]
+ )
+ formatted = _format_message_for_summary(msg)
+ # Short field survives intact
+ assert "out.py" in formatted
+ # Long field gets truncated
+ assert big_content not in formatted
+ assert "truncated" in formatted
+
+
+def test_tool_call_short_arguments_kept_intact() -> None:
+ msg = AssistantMessage(
+ content=[
+ ToolCall(id="c1", name="bash", arguments={"command": "ls -la"}),
+ ]
+ )
+ formatted = _format_message_for_summary(msg)
+ assert "bash" in formatted
+ assert "ls -la" in formatted
+
+
+def test_tool_call_repr_max_chars_enforced() -> None:
+ # Many small fields — each individually under the per-field limit, but
+ # the total serialised JSON would balloon. Cap at _ARG_REPR_MAX.
+ msg = AssistantMessage(
+ content=[
+ ToolCall(
+ id="c1",
+ name="search",
+ arguments={f"k{i}": f"v{i}" * 20 for i in range(40)},
+ ),
+ ]
+ )
+ formatted = _format_message_for_summary(msg)
+ # Total formatted message must stay bounded.
+ assert len(formatted) < 1000
+
+
+def test_tool_call_empty_arguments() -> None:
+ msg = AssistantMessage(
+ content=[ToolCall(id="c1", name="ping", arguments={})]
+ )
+ formatted = _format_message_for_summary(msg)
+ assert "[tool_call:ping]" in formatted