Skip to content

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

2.5 KB
Raw Blame
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")