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
"""Task 38: cross-backend fork happy path E2E.
Drives ``Agent.prompt`` twice (R1 then R2) on every backend, then forks
``after_run_id="R1"`` and verifies the destination thread contains R1's
messages only, carries ``parent_thread_id`` and the fork metadata.
The four backends (memory / sqlite / postgres / mysql) share one helper
``_run_happy_path`` so the assertions stay identical. Postgres/MySQL share
the DSN fixtures from ``tests/checkpointer/conftest.py`` (re-exported via
``tests/e2e/conftest.py``'s ``pytest_plugins``) which auto-skip when the
backend is unreachable.
"""
from __future__ import annotations
import pytest
from cubeloop.agent.agent import Agent
from cubeloop.providers.base import AssistantMessage, TextContent
from cubeloop.providers.faux import FauxProvider
def _ok_faux() -> FauxProvider:
"""Two-turn faux provider — one assistant message per prompt."""
p = FauxProvider()
p.set_responses(
[
AssistantMessage(content=[TextContent(text="r1")], stop_reason="end_turn"),
AssistantMessage(content=[TextContent(text="r2")], stop_reason="end_turn"),
]
)
return p
async def _run_happy_path(cp) -> None:
"""Shared body — same assertions across all four backends."""
p = _ok_faux()
a = Agent(
model=p.model("faux-model"),
checkpointer=cp,
thread_id="src",
)
r1 = await a.prompt("first", run_id="R1")
assert r1 == "R1"
r2 = await a.prompt("second", run_id="R2")
assert r2 == "R2"
await a.fork("src", "dst", after_run_id="R1", metadata={"label": "branch"})
loaded = await cp.load("dst")
assert loaded is not None
assert loaded.parent_thread_id == "src"
assert loaded.extra["fork"] == {"label": "branch"}
# dst contains R1's messages only, not R2's.
run_ids = {m.run_id for m in loaded.messages if m.run_id}
assert run_ids == {"R1"}
@pytest.mark.asyncio
async def test_fork_e2e_memory():
from cubeloop.checkpointer.memory import MemoryCheckpointer
await _run_happy_path(MemoryCheckpointer())
@pytest.mark.asyncio
async def test_fork_e2e_sqlite(tmp_path):
from cubeloop.checkpointer.sqlite import SQLiteCheckpointer
async with SQLiteCheckpointer(str(tmp_path / "x.db")) as cp:
await _run_happy_path(cp)
@pytest.mark.asyncio
async def test_fork_e2e_postgres(pg_v4_dsn):
from cubeloop.checkpointer.postgres.checkpointer import PostgresCheckpointer
async with PostgresCheckpointer(pg_v4_dsn) as cp:
await _run_happy_path(cp)
@pytest.mark.asyncio
async def test_fork_e2e_mysql(mysql_v4_dsn):
from cubeloop.checkpointer.mysql.checkpointer import MySQLCheckpointer
async with MySQLCheckpointer(mysql_v4_dsn) as cp:
await _run_happy_path(cp)