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
"""Attach atomicity: a failed ``Tracer.attach`` / ``Recorder.attach`` must
leave no dangling listener subscriptions behind.
``attach`` wires several subscriptions (agent event listener + three provider
listeners, then an MCP provider registration). If any step raises partway, the
subscriptions registered before it would otherwise leak — the caller never
receives a ``detach`` callable, so it cannot clean them up. These tests pin the
contract: attach is all-or-nothing.
"""
from __future__ import annotations
import pytest
from cubeloop.agent.agent import Agent
from cubeloop.providers.base import Model
from cubeloop.providers.faux import FauxProvider
from cubeloop.tracing import Tracer
MODEL = Model(id="faux-1", provider_id="faux")
def _build_unattached() -> tuple[Agent, FauxProvider, Tracer]:
from opentelemetry.sdk.trace.export import SpanExporter, SpanExportResult
class _NullExporter(SpanExporter):
def export(self, spans): # noqa: ANN001
return SpanExportResult.SUCCESS
def shutdown(self) -> None:
pass
def force_flush(self, timeout_millis: int = 30_000) -> bool:
return True
provider = FauxProvider(provider_id="faux")
agent = Agent(model=provider.model(MODEL.id), system_prompt="t")
tracer = Tracer(
service_name="t",
agent_name="t",
exporters=[_NullExporter()],
atexit_flush=False,
)
return agent, provider, tracer
def _assert_no_listeners(agent: Agent, provider: FauxProvider) -> None:
assert agent._listeners == [], "agent event listener leaked after failed attach"
assert provider._request_listeners == [], "provider request listener leaked"
assert provider._chunk_listeners == [], "provider chunk listener leaked"
assert provider._response_listeners == [], "provider response listener leaked"
async def test_recorder_attach_unwinds_on_partial_provider_subscription_failure():
agent, provider, tracer = _build_unattached()
try:
# subscribe_request succeeds, subscribe_chunk blows up midway.
def _boom(cb): # noqa: ANN001, ANN202
raise RuntimeError("subscribe_chunk failed")
provider.subscribe_chunk = _boom # type: ignore[method-assign]
with pytest.raises(RuntimeError, match="subscribe_chunk failed"):
tracer.attach(agent)
_assert_no_listeners(agent, provider)
finally:
await tracer.shutdown()
async def test_tracer_attach_unwinds_recorder_on_mcp_register_failure(monkeypatch):
agent, provider, tracer = _build_unattached()
try:
import cubeloop.mcp._tracing as mcp_tracing
def _boom(_provider, **_kwargs): # noqa: ANN001, ANN202
raise RuntimeError("register_provider failed")
monkeypatch.setattr(mcp_tracing, "register_provider", _boom)
with pytest.raises(RuntimeError, match="register_provider failed"):
tracer.attach(agent)
_assert_no_listeners(agent, provider)
finally:
await tracer.shutdown()
async def test_recorder_attach_cleanup_swallows_detacher_errors(monkeypatch):
"""Unwind itself must be fault-tolerant: a detach callable raising during
cleanup is swallowed so the ORIGINAL subscription error is what surfaces."""
agent, provider, tracer = _build_unattached()
try:
def _raising_detacher(): # noqa: ANN202
raise RuntimeError("detacher boom")
def _raising_unsub(): # noqa: ANN202
raise RuntimeError("unsub boom")
# subscribe_request "succeeds" but hands back a detacher that blows up
# during unwind; the agent unsubscribe also blows up.
monkeypatch.setattr(provider, "subscribe_request", lambda cb: _raising_detacher)
monkeypatch.setattr(agent, "subscribe", lambda listener: _raising_unsub)
def _boom_chunk(cb): # noqa: ANN001, ANN202
raise RuntimeError("subscribe_chunk failed")
monkeypatch.setattr(provider, "subscribe_chunk", _boom_chunk)
with pytest.raises(RuntimeError, match="subscribe_chunk failed"):
tracer.attach(agent)
finally:
await tracer.shutdown()
async def test_tracer_attach_cleanup_swallows_recorder_detach_error(monkeypatch):
"""If MCP registration fails AND the recorder's own detach raises during
unwind, the original register error must still surface."""
agent, provider, tracer = _build_unattached()
try:
def _raising_unsub(): # noqa: ANN202
raise RuntimeError("unsub boom")
# recorder.attach succeeds, but its detach will raise (agent unsub
# raises inside the recorder's synchronous cleanup).
monkeypatch.setattr(agent, "subscribe", lambda listener: _raising_unsub)
import cubeloop.mcp._tracing as mcp_tracing
def _boom(_provider, **_kwargs): # noqa: ANN001, ANN202
raise RuntimeError("register_provider failed")
monkeypatch.setattr(mcp_tracing, "register_provider", _boom)
with pytest.raises(RuntimeError, match="register_provider failed"):
tracer.attach(agent)
finally:
await tracer.shutdown()