mirror of
https://github.com/shareAI-lab/learn-claude-code.git
synced 2026-08-26 00:32:06 +00:00
338 lines
13 KiB
Python
338 lines
13 KiB
Python
import importlib.util
|
|
import os
|
|
import sys
|
|
import tempfile
|
|
import types
|
|
import unittest
|
|
from pathlib import Path
|
|
|
|
|
|
REPO_ROOT = Path(__file__).resolve().parents[1]
|
|
MODULES = {
|
|
"s08": REPO_ROOT / "s08_context_compact" / "code.py",
|
|
"s15": REPO_ROOT / "s15_integrated_harness" / "code.py",
|
|
}
|
|
|
|
|
|
def load_module(name: str, path: Path, temp_cwd: Path):
|
|
fake_anthropic = types.ModuleType("anthropic")
|
|
|
|
class FakeAnthropic:
|
|
def __init__(self, *args, **kwargs):
|
|
self.messages = types.SimpleNamespace(create=None)
|
|
|
|
fake_dotenv = types.ModuleType("dotenv")
|
|
setattr(fake_anthropic, "Anthropic", FakeAnthropic)
|
|
setattr(fake_dotenv, "load_dotenv", lambda override=True: None)
|
|
|
|
previous_anthropic = sys.modules.get("anthropic")
|
|
previous_dotenv = sys.modules.get("dotenv")
|
|
previous_cwd = Path.cwd()
|
|
previous_model = os.environ.get("MODEL_ID")
|
|
previous_key = os.environ.get("ANTHROPIC_API_KEY")
|
|
|
|
spec = importlib.util.spec_from_file_location(name, path)
|
|
if spec is None or spec.loader is None:
|
|
raise RuntimeError(f"Unable to load {path}")
|
|
module = importlib.util.module_from_spec(spec)
|
|
|
|
sys.modules["anthropic"] = fake_anthropic
|
|
sys.modules["dotenv"] = fake_dotenv
|
|
os.environ["MODEL_ID"] = "test-model"
|
|
os.environ["ANTHROPIC_API_KEY"] = "test-key"
|
|
try:
|
|
os.chdir(temp_cwd)
|
|
spec.loader.exec_module(module)
|
|
return module
|
|
finally:
|
|
os.chdir(previous_cwd)
|
|
if previous_anthropic is None:
|
|
sys.modules.pop("anthropic", None)
|
|
else:
|
|
sys.modules["anthropic"] = previous_anthropic
|
|
if previous_dotenv is None:
|
|
sys.modules.pop("dotenv", None)
|
|
else:
|
|
sys.modules["dotenv"] = previous_dotenv
|
|
if previous_model is None:
|
|
os.environ.pop("MODEL_ID", None)
|
|
else:
|
|
os.environ["MODEL_ID"] = previous_model
|
|
if previous_key is None:
|
|
os.environ.pop("ANTHROPIC_API_KEY", None)
|
|
else:
|
|
os.environ["ANTHROPIC_API_KEY"] = previous_key
|
|
|
|
|
|
def assistant_text():
|
|
return {"role": "assistant", "content": [types.SimpleNamespace(type="text", text="ok")]}
|
|
|
|
|
|
def user_text():
|
|
return {"role": "user", "content": "continue"}
|
|
|
|
|
|
def tool_use_message(tool_id="tool-1"):
|
|
return {
|
|
"role": "assistant",
|
|
"content": [types.SimpleNamespace(type="tool_use", id=tool_id, name="bash")],
|
|
}
|
|
|
|
|
|
def tool_use_batch(*tool_ids):
|
|
return {
|
|
"role": "assistant",
|
|
"content": [
|
|
types.SimpleNamespace(type="tool_use", id=tool_id, name="bash")
|
|
for tool_id in tool_ids
|
|
],
|
|
}
|
|
|
|
|
|
def tool_result_message(tool_id="tool-1"):
|
|
return {
|
|
"role": "user",
|
|
"content": [{"type": "tool_result", "tool_use_id": tool_id, "content": "ok"}],
|
|
}
|
|
|
|
|
|
def long_tool_result_batch(*tool_ids):
|
|
return {
|
|
"role": "user",
|
|
"content": [
|
|
{"type": "tool_result", "tool_use_id": tool_id,
|
|
"content": f"{tool_id}: " + "x" * 160}
|
|
for tool_id in tool_ids
|
|
],
|
|
}
|
|
|
|
|
|
def message_has_tool_use(message):
|
|
content = message.get("content")
|
|
return (
|
|
message.get("role") == "assistant"
|
|
and isinstance(content, list)
|
|
and any(getattr(block, "type", None) == "tool_use" for block in content)
|
|
)
|
|
|
|
|
|
def assert_no_orphan_tool_results(testcase, messages):
|
|
for idx, message in enumerate(messages):
|
|
content = message.get("content")
|
|
if message.get("role") != "user" or not isinstance(content, list):
|
|
continue
|
|
if not any(isinstance(block, dict) and block.get("type") == "tool_result" for block in content):
|
|
continue
|
|
testcase.assertGreater(idx, 0)
|
|
testcase.assertTrue(message_has_tool_use(messages[idx - 1]), messages)
|
|
|
|
|
|
def compaction_api(module):
|
|
"""Return the chapter's compaction implementation."""
|
|
return getattr(module, "COMPACTOR", module)
|
|
|
|
|
|
class CompactionToolPairTests(unittest.TestCase):
|
|
def test_micro_compact_keeps_unseen_tool_result_batch(self):
|
|
for name, path in MODULES.items():
|
|
with self.subTest(name=name), tempfile.TemporaryDirectory() as tmp:
|
|
messages = [
|
|
tool_use_message("old-1"),
|
|
long_tool_result_batch("old-1"),
|
|
tool_use_message("old-2"),
|
|
long_tool_result_batch("old-2"),
|
|
tool_use_message("old-3"),
|
|
long_tool_result_batch("old-3"),
|
|
tool_use_message("old-4"),
|
|
long_tool_result_batch("old-4"),
|
|
tool_use_batch("latest-1", "latest-2", "latest-3", "latest-4"),
|
|
long_tool_result_batch(
|
|
"latest-1", "latest-2", "latest-3", "latest-4"
|
|
),
|
|
{"role": "user", "content": [
|
|
{"type": "text", "text": "<task_notification>done</task_notification>"}
|
|
]},
|
|
{"role": "user", "content": "<reminder>Update your todos.</reminder>"},
|
|
]
|
|
module = load_module(f"{name}_micro_batch_under_test", path, Path(tmp))
|
|
compacted = compaction_api(module).micro_compact(messages)
|
|
results = {
|
|
block["tool_use_id"]: block["content"]
|
|
for message in compacted
|
|
if isinstance(message["content"], list)
|
|
for block in message["content"]
|
|
if isinstance(block, dict) and block.get("type") == "tool_result"
|
|
}
|
|
self.assertNotIn("old-1: ", results["old-1"])
|
|
for tool_id in ("old-2", "old-3", "old-4",
|
|
"latest-1", "latest-2", "latest-3", "latest-4"):
|
|
self.assertIn(f"{tool_id}: ", results[tool_id])
|
|
|
|
def test_micro_compact_releases_batch_after_model_consumes_it(self):
|
|
for name, path in MODULES.items():
|
|
with self.subTest(name=name), tempfile.TemporaryDirectory() as tmp:
|
|
messages = [
|
|
tool_use_batch("seen-1", "seen-2", "seen-3", "seen-4"),
|
|
long_tool_result_batch("seen-1", "seen-2", "seen-3", "seen-4"),
|
|
assistant_text(),
|
|
user_text(),
|
|
]
|
|
module = load_module(f"{name}_consumed_batch_under_test", path, Path(tmp))
|
|
compacted = compaction_api(module).micro_compact(messages)
|
|
results = {
|
|
block["tool_use_id"]: block["content"]
|
|
for message in compacted
|
|
if isinstance(message["content"], list)
|
|
for block in message["content"]
|
|
if isinstance(block, dict) and block.get("type") == "tool_result"
|
|
}
|
|
self.assertNotIn("seen-1: ", results["seen-1"])
|
|
for tool_id in ("seen-2", "seen-3", "seen-4"):
|
|
self.assertIn(f"{tool_id}: ", results[tool_id])
|
|
|
|
def test_snip_compact_keeps_head_tool_pair(self):
|
|
messages = [
|
|
user_text(),
|
|
assistant_text(),
|
|
tool_use_message("head-tool"),
|
|
tool_result_message("head-tool"),
|
|
assistant_text(),
|
|
user_text(),
|
|
assistant_text(),
|
|
user_text(),
|
|
assistant_text(),
|
|
user_text(),
|
|
]
|
|
|
|
for name, path in MODULES.items():
|
|
with self.subTest(name=name), tempfile.TemporaryDirectory() as tmp:
|
|
module = load_module(f"{name}_head_under_test", path, Path(tmp))
|
|
compacted = compaction_api(module).snip_compact(
|
|
list(messages), max_messages=6
|
|
)
|
|
self.assertEqual(compacted[2], messages[2])
|
|
self.assertEqual(compacted[3], messages[3])
|
|
assert_no_orphan_tool_results(self, compacted)
|
|
|
|
def test_snip_compact_keeps_tail_tool_pair(self):
|
|
messages = [
|
|
user_text(),
|
|
assistant_text(),
|
|
user_text(),
|
|
assistant_text(),
|
|
user_text(),
|
|
assistant_text(),
|
|
tool_use_message("tail-tool"),
|
|
tool_result_message("tail-tool"),
|
|
assistant_text(),
|
|
user_text(),
|
|
]
|
|
|
|
for name, path in MODULES.items():
|
|
with self.subTest(name=name), tempfile.TemporaryDirectory() as tmp:
|
|
module = load_module(f"{name}_under_test", path, Path(tmp))
|
|
compacted = compaction_api(module).snip_compact(
|
|
list(messages), max_messages=6
|
|
)
|
|
assert_no_orphan_tool_results(self, compacted)
|
|
|
|
def test_reactive_compact_keeps_tail_tool_pair(self):
|
|
messages = [
|
|
user_text(),
|
|
assistant_text(),
|
|
user_text(),
|
|
tool_use_message("reactive-tool"),
|
|
tool_result_message("reactive-tool"),
|
|
assistant_text(),
|
|
user_text(),
|
|
assistant_text(),
|
|
user_text(),
|
|
]
|
|
|
|
for name, path in MODULES.items():
|
|
with self.subTest(name=name), tempfile.TemporaryDirectory() as tmp:
|
|
module = load_module(f"{name}_reactive_under_test", path, Path(tmp))
|
|
api = compaction_api(module)
|
|
api.write_transcript = lambda _messages: Path("transcript.jsonl")
|
|
api.summarize_history = lambda _messages: "summary"
|
|
compacted = api.reactive_compact(list(messages), "continue")
|
|
self.assertEqual(compacted[1], messages[3])
|
|
assert_no_orphan_tool_results(self, compacted)
|
|
|
|
def test_reactive_compact_summarizes_only_old_history(self):
|
|
messages = [
|
|
user_text(),
|
|
assistant_text(),
|
|
user_text(),
|
|
assistant_text(),
|
|
user_text(),
|
|
assistant_text(),
|
|
user_text(),
|
|
assistant_text(),
|
|
user_text(),
|
|
]
|
|
|
|
for name, path in MODULES.items():
|
|
with self.subTest(name=name), tempfile.TemporaryDirectory() as tmp:
|
|
module = load_module(f"{name}_reactive_oldhist_under_test", path, Path(tmp))
|
|
api = compaction_api(module)
|
|
api.write_transcript = lambda _messages: Path("transcript.jsonl")
|
|
captured = {}
|
|
|
|
def fake_summarize(passed, _store=captured):
|
|
_store["messages"] = list(passed)
|
|
return "summary"
|
|
|
|
api.summarize_history = fake_summarize
|
|
compacted = api.reactive_compact(list(messages), "continue")
|
|
# The summary must cover only the old history, not the kept tail.
|
|
self.assertEqual(captured["messages"], messages[:4])
|
|
# The recent tail is appended verbatim after the summary message.
|
|
self.assertEqual(compacted[1:], messages[4:])
|
|
assert_no_orphan_tool_results(self, compacted)
|
|
|
|
def test_reactive_compact_summary_excludes_tail_pair_pulled_in(self):
|
|
# A tool_use/tool_result pair straddles the tail boundary, so the
|
|
# adjustment pulls the tool_use into the kept tail. The summary must
|
|
# cover only what stays trimmed (messages[:adjusted_tail_start]), i.e.
|
|
# it must not re-summarize the tool_use that is kept verbatim.
|
|
messages = [
|
|
user_text(),
|
|
assistant_text(),
|
|
user_text(),
|
|
tool_use_message("reactive-tool"),
|
|
tool_result_message("reactive-tool"),
|
|
assistant_text(),
|
|
user_text(),
|
|
assistant_text(),
|
|
user_text(),
|
|
]
|
|
|
|
for name, path in MODULES.items():
|
|
with self.subTest(name=name), tempfile.TemporaryDirectory() as tmp:
|
|
module = load_module(f"{name}_reactive_pairscope_under_test", path, Path(tmp))
|
|
api = compaction_api(module)
|
|
api.write_transcript = lambda _messages: Path("transcript.jsonl")
|
|
captured = {}
|
|
|
|
def fake_summarize(passed, _store=captured):
|
|
_store["messages"] = list(passed)
|
|
return "summary"
|
|
|
|
api.summarize_history = fake_summarize
|
|
compacted = api.reactive_compact(list(messages), "continue")
|
|
# tail_start starts at 4, decrements to 3 to keep the pair intact.
|
|
self.assertEqual(captured["messages"], messages[:3])
|
|
self.assertEqual(compacted[1], messages[3])
|
|
self.assertEqual(compacted[1:], messages[3:])
|
|
assert_no_orphan_tool_results(self, compacted)
|
|
|
|
def test_s15_has_tool_use_still_accepts_content_blocks(self):
|
|
with tempfile.TemporaryDirectory() as tmp:
|
|
module = load_module("s15_has_tool_use_under_test", MODULES["s15"], Path(tmp))
|
|
self.assertTrue(module.has_tool_use([types.SimpleNamespace(type="tool_use")]))
|
|
self.assertFalse(module.has_tool_use([types.SimpleNamespace(type="text")]))
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main()
|