Skip to content

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

5.1 KB
Raw Blame
"""MySQLCheckpointer snapshot/fork tests — mirrors test_postgres_fork.py."""

from __future__ import annotations

import asyncio

import pytest

from cubeloop.checkpointer.exceptions import (
    RunNotCompletedError,
    ThreadAlreadyExistsError,
    ThreadNotFoundError,
)
from cubeloop.checkpointer.mysql import MySQLCheckpointer
from cubeloop.providers.base import TextContent, UserMessage


def _msg(run_id: str | None, text: str) -> UserMessage:
    return UserMessage(content=[TextContent(text=text)], run_id=run_id)


@pytest.mark.asyncio
async def test_fork_copies_completed_runs_only(mysql_v4_dsn) -> None:
    async with MySQLCheckpointer(mysql_v4_dsn) as cp:
        await cp.claim_run("src", "A")
        await cp.append("src", [_msg("A", "a1"), _msg("A", "a2")])
        await cp.mark_run_complete("src", "A")
        await cp.claim_run("src", "B")
        await cp.append("src", [_msg("B", "b1")])
        await cp.mark_run_complete("src", "B")
        # An in-flight run C — must be excluded.
        await cp.claim_run("src", "C")
        await cp.append("src", [_msg("C", "c1")])
        await cp.fork("src", "dst", after_run_id="B")
        loaded = await cp.load("dst")
        assert loaded is not None
        texts = [m.content[0].text for m in loaded.messages]
        assert texts == ["a1", "a2", "b1"]
        assert loaded.parent_thread_id == "src"


@pytest.mark.asyncio
async def test_fork_includes_legacy_null_run_id_prefix(mysql_v4_dsn) -> None:
    async with MySQLCheckpointer(mysql_v4_dsn) as cp:
        await cp.append("src", [_msg(None, "legacy")])
        await cp.claim_run("src", "A")
        await cp.append("src", [_msg("A", "a1")])
        await cp.mark_run_complete("src", "A")
        await cp.fork("src", "dst", after_run_id="A")
        loaded = await cp.load("dst")
        assert loaded is not None
        assert [m.content[0].text for m in loaded.messages] == ["legacy", "a1"]


@pytest.mark.asyncio
async def test_fork_unknown_src_raises_thread_not_found(mysql_v4_dsn) -> None:
    async with MySQLCheckpointer(mysql_v4_dsn) as cp:
        with pytest.raises(ThreadNotFoundError):
            await cp.fork("missing", "dst", after_run_id="X")


@pytest.mark.asyncio
async def test_fork_unknown_run_id_raises_not_completed(mysql_v4_dsn) -> None:
    async with MySQLCheckpointer(mysql_v4_dsn) as cp:
        await cp.append("src", [_msg(None, "x")])
        with pytest.raises(RunNotCompletedError):
            await cp.fork("src", "dst", after_run_id="missing")


@pytest.mark.asyncio
async def test_fork_destination_collision_raises_already_exists(mysql_v4_dsn) -> None:
    async with MySQLCheckpointer(mysql_v4_dsn) as cp:
        await cp.claim_run("src", "A")
        await cp.append("src", [_msg("A", "a1")])
        await cp.mark_run_complete("src", "A")
        await cp.fork("src", "dst", after_run_id="A")
        with pytest.raises(ThreadAlreadyExistsError):
            await cp.fork("src", "dst", after_run_id="A")


@pytest.mark.asyncio
async def test_fork_carries_extra_and_writes_metadata(mysql_v4_dsn) -> None:
    async with MySQLCheckpointer(mysql_v4_dsn) as cp:
        await cp.save_extra("src", {"original": "x"})
        await cp.claim_run("src", "A")
        await cp.append("src", [_msg("A", "a1")])
        await cp.mark_run_complete("src", "A")
        await cp.fork("src", "dst", after_run_id="A", metadata={"source": "test"})
        loaded = await cp.load("dst")
        assert loaded is not None
        assert loaded.extra["original"] == "x"
        assert loaded.extra["fork"] == {"source": "test"}


@pytest.mark.asyncio
async def test_snapshot_matches_fork_messages(mysql_v4_dsn) -> None:
    async with MySQLCheckpointer(mysql_v4_dsn) as cp:
        await cp.claim_run("src", "A")
        await cp.append("src", [_msg("A", "a1")])
        await cp.mark_run_complete("src", "A")
        msgs = await cp.snapshot("src", after_run_id="A")
        assert [m.content[0].text for m in msgs] == ["a1"]


@pytest.mark.asyncio
async def test_fork_serialized_with_concurrent_append(mysql_v4_dsn) -> None:
    """The fork's per-thread SELECT FOR UPDATE must serialize with append.

    Without it, an append racing the fork could leak a partial in-flight
    run into the destination's messages. We assert the destination ONLY
    contains the completed prefix regardless of who runs first.
    """
    async with MySQLCheckpointer(mysql_v4_dsn, min_pool_size=2, max_pool_size=4) as cp:
        await cp.claim_run("src", "A")
        await cp.append("src", [_msg("A", "a1")])
        await cp.mark_run_complete("src", "A")
        # Start an in-flight run B that an append targets.
        await cp.claim_run("src", "B")

        async def do_fork() -> None:
            await cp.fork("src", "dst", after_run_id="A")

        async def do_append() -> None:
            await cp.append("src", [_msg("B", "b1")])

        await asyncio.gather(do_fork(), do_append())
        loaded = await cp.load("dst")
        assert loaded is not None
        # Destination must NOT contain b1 — only the completed prefix.
        texts = [m.content[0].text for m in loaded.messages]
        assert texts == ["a1"]