CubeLoop — a Pythonic, async-native agent harness core designed for high performance, readability, and production-grade persistence.
Python agent-frameworkagent-harnessagent-runtimeagentic-aiai-agentsai-frameworkanthropicharnessharness-engineeringharness-frameworklanggraphlanggraph-alternativellmmcpopenaipi-agentpi-agent-corepythonpython-agent
import pytest
from cubeloop.agent.agent import Agent
from cubeloop.checkpointer.memory import MemoryCheckpointer
from cubeloop.providers.base import AssistantMessage, TextContent
from cubeloop.providers.faux import FauxProvider
def _ok_faux() -> FauxProvider:
p = FauxProvider()
p.set_responses(
[AssistantMessage(content=[TextContent(text="ok")], stop_reason="end_turn")]
)
return p
@pytest.mark.asyncio
async def test_agent_fork_delegates_to_checkpointer():
cp = MemoryCheckpointer()
a = Agent(
model=_ok_faux().model("faux-model"),
checkpointer=cp,
thread_id="src",
)
await a.prompt("hello", run_id="R1") # creates src + R1 marker
await a.fork("src", "dst", after_run_id="R1")
loaded = await cp.load("dst")
assert loaded.parent_thread_id == "src"
@pytest.mark.asyncio
async def test_agent_fork_no_checkpointer_raises():
a = Agent(model=_ok_faux().model("faux-model"))
with pytest.raises(RuntimeError, match="checkpointer"):
await a.fork("src", "dst", after_run_id="R1")
@pytest.mark.asyncio
async def test_agent_fork_does_not_mutate_self_thread_id():
cp = MemoryCheckpointer()
a = Agent(
model=_ok_faux().model("faux-model"),
checkpointer=cp,
thread_id="src",
)
await a.prompt("hello", run_id="R1")
await a.fork("src", "dst", after_run_id="R1")
assert a.thread_id == "src"
@pytest.mark.asyncio
async def test_agent_fork_v3_only_checkpointer_raises_CheckpointerError():
"""A pre-v4 checkpointer (no claim_run / mark_run_complete) is in
'degraded mode': vanilla prompt() works but fork() must surface
CheckpointerError so callers know the backend cannot support fork.
"""
from cubeloop.checkpointer.exceptions import CheckpointerError
class _V3Only:
async def load(self, thread_id):
return None
async def append(self, thread_id, msgs):
pass
async def save_extra(self, thread_id, extra):
pass
async def save_pending_request(self, thread_id, req, *, run_id=None):
pass
async def load_pending_request(self, thread_id):
return None
# No claim_run / mark_run_complete → not _run_aware.
a = Agent(
model=_ok_faux().model("faux-model"),
checkpointer=_V3Only(),
thread_id="src",
)
with pytest.raises(CheckpointerError, match="does not support fork"):
await a.fork("src", "dst", after_run_id="R1")