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
from __future__ import annotations
from cubeloop.deferred._catalog import render_catalog, render_static_catalog
from cubeloop.deferred.types import DeferredToolGroup
class TestDeferredToolGroup:
def test_basic_construction(self) -> None:
async def _loader():
return []
group = DeferredToolGroup(
group_id="mcp:github",
display_name="GitHub",
description="Code hosting: issues, PRs, repos",
tool_names=["create_issue", "search_repos"],
loader=_loader,
)
assert group.group_id == "mcp:github"
assert group.display_name == "GitHub"
assert group.description == "Code hosting: issues, PRs, repos"
assert group.tool_names == ["create_issue", "search_repos"]
assert group.loader is _loader
def _make_group(
group_id: str,
display_name: str,
description: str,
tool_names: list[str],
) -> DeferredToolGroup:
async def _noop_loader():
return []
return DeferredToolGroup(
group_id=group_id,
display_name=display_name,
description=description,
tool_names=tool_names,
loader=_noop_loader,
)
class TestRenderCatalog:
def test_no_groups_returns_empty(self) -> None:
result = render_catalog(groups=[], expanded={})
assert result == ""
def test_single_group_no_expansion(self) -> None:
groups = [
_make_group(
"mcp:github", "GitHub", "Code hosting", ["create_issue", "search_repos"]
)
]
result = render_catalog(groups=groups, expanded={})
assert "mcp:github" in result
assert "GitHub" in result
assert "Code hosting" in result
assert "2 tools" in result
assert "create_issue" in result
assert "search_repos" in result
def test_sorted_by_group_id(self) -> None:
groups = [
_make_group("z:last", "Last", "desc", ["t1"]),
_make_group("a:first", "First", "desc", ["t2"]),
]
result = render_catalog(groups=groups, expanded={})
a_pos = result.index("a:first")
z_pos = result.index("z:last")
assert a_pos < z_pos
def test_byte_stable_across_input_orderings(self) -> None:
g1 = _make_group("mcp:a", "A", "desc", ["t1"])
g2 = _make_group("mcp:b", "B", "desc", ["t2"])
result_ab = render_catalog(groups=[g1, g2], expanded={})
result_ba = render_catalog(groups=[g2, g1], expanded={})
assert result_ab == result_ba
def test_fully_expanded_group_omitted(self) -> None:
groups = [
_make_group(
"mcp:github", "GitHub", "Code hosting", ["create_issue", "search_repos"]
),
_make_group("mcp:linear", "Linear", "Issues", ["create_issue"]),
]
expanded: dict[str, list[str] | None] = {"mcp:github": None}
result = render_catalog(groups=groups, expanded=expanded)
assert "mcp:github" not in result
assert "mcp:linear" in result
def test_partially_expanded_shows_remaining(self) -> None:
groups = [
_make_group(
"mcp:github",
"GitHub",
"Code hosting",
["create_issue", "search_repos", "create_pr"],
)
]
expanded: dict[str, list[str] | None] = {"mcp:github": ["create_issue"]}
result = render_catalog(groups=groups, expanded=expanded)
assert "2 remaining tools" in result
assert "create_issue" not in result
assert "search_repos" in result
assert "create_pr" in result
def test_all_groups_fully_expanded_returns_empty(self) -> None:
groups = [_make_group("mcp:github", "GitHub", "desc", ["t1"])]
expanded: dict[str, list[str] | None] = {"mcp:github": None}
result = render_catalog(groups=groups, expanded=expanded)
assert result == ""
def test_custom_header(self) -> None:
groups = [_make_group("mcp:a", "A", "desc", ["t1"])]
result = render_catalog(groups=groups, expanded={}, header="Custom header text")
assert "Custom header text" in result
class TestStaticCatalog:
def test_lists_all_tools_sorted_by_group_id(self) -> None:
out = render_static_catalog(
groups=[
_make_group("b", "B", "b tools", ["t2"]),
_make_group("a", "A", "a tools", ["t1"]),
],
header="HDR",
)
assert out.index("`a`") < out.index("`b`")
assert "t1" in out and "t2" in out
def test_no_remaining_counts(self) -> None:
out = render_static_catalog(
groups=[_make_group("a", "A", "a tools", ["t1", "t2"])], header="HDR"
)
assert "remaining" not in out
def test_deterministic(self) -> None:
groups = [
_make_group("a", "A", "a tools", ["t1"]),
_make_group("b", "B", "b tools", ["t2"]),
]
assert render_static_catalog(groups=groups, header="HDR") == (
render_static_catalog(groups=list(reversed(groups)), header="HDR")
)
def test_no_groups_returns_empty(self) -> None:
assert render_static_catalog(groups=[], header="HDR") == ""