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
import dataclasses
import pytest
from cubeloop.hitl.types import (
Option,
Question,
ConfirmRequest,
ApproveRequest,
AskRequest,
HitlRequest,
ApproveAnswer,
)
def test_option_default_allow_input_false():
o = Option(label="A", value="a")
assert o.allow_input is False
assert o.description is None
def test_question_defaults():
q = Question(key="color", prompt="Pick:")
assert q.options is None
assert q.multi_select is False
assert q.required is True
def test_confirm_request_kind_literal():
r = ConfirmRequest(prompt="ok?")
assert r.kind == "confirm"
def test_approve_request_kind_literal():
r = ApproveRequest(tool_name="bash", tool_call_id="tc-1", args={"cmd": "ls"})
assert r.kind == "approve"
def test_ask_request_kind_literal():
r = AskRequest(questions=[Question(key="x", prompt="?")])
assert r.kind == "ask"
def test_hitl_request_envelope_round_trip():
req = HitlRequest(
question_id="tc-1",
thread_id="t-7",
payload=ApproveRequest(tool_name="bash", tool_call_id="tc-1", args={}),
created_at=1.0,
timeout_seconds=42.0,
)
raw = req.model_dump_json()
back = HitlRequest.model_validate_json(raw)
assert back == req
assert back.payload.kind == "approve"
def test_hitl_request_discriminated_union_round_trip_for_each_kind():
payloads = [
ConfirmRequest(prompt="ok?"),
ApproveRequest(tool_name="t", tool_call_id="c", args={"a": 1}),
AskRequest(questions=[Question(key="k", prompt="p")]),
]
for p in payloads:
req = HitlRequest(question_id="q", thread_id=None, payload=p, created_at=0.0)
back = HitlRequest.model_validate_json(req.model_dump_json())
assert type(back.payload) is type(p)
def test_approve_answer_decisions():
assert ApproveAnswer(decision="approve").decision == "approve"
assert ApproveAnswer(decision="deny", reason="no").reason == "no"
assert ApproveAnswer(decision="edit", edited_args={"x": 1}).edited_args == {"x": 1}
def test_before_tool_call_result_new_fields():
from cubeloop.agent.types import BeforeToolCallResult
r = BeforeToolCallResult(
edited_args={"x": 1},
deny_reason="forbidden",
hitl_trace={"decision": "edit"},
)
assert r.edited_args == {"x": 1}
assert r.deny_reason == "forbidden"
assert r.hitl_trace == {"decision": "edit"}
# backwards-compat: old call still works
r2 = BeforeToolCallResult(block=True, reason="bad")
assert r2.edited_args is None
assert r2.deny_reason is None
assert r2.hitl_trace is None
def test_approval_decision_dataclasses_frozen():
from cubeloop.hitl.policy import Approve, Deny, AskUser
a = Approve()
d = Deny(reason="forbidden")
u = AskUser(timeout_seconds=10.0)
assert d.reason == "forbidden"
assert u.timeout_seconds == 10.0
with pytest.raises(dataclasses.FrozenInstanceError):
a.foo = "bar" # frozen dataclass