Quesen — AutoGen Tool

Deterministic A2A risk validation exposed as AutoGen (v0.4+) function tools.

Status: v0.2.0 · tracks Quesen engine v1.10.0 · receipt provenance forwarded. Developer portal: https://senueren.co.za/quesen · Source: https://github.com/Shxnque/quesen

---

Install

pip install quesen-autogen
# or:
pip install git+https://github.com/Shxnque/quesen-autogen.git

30-second usage (AutoGen v0.4+)

from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient
from quesen_autogen import quesen_validate, quesen_simulate, quesen_report

model = OpenAIChatCompletionClient(model="gpt-4o-mini")
agent = AssistantAgent(
    name="defensive_trader",
    model_client=model,
    tools=[quesen_validate, quesen_simulate, quesen_report],
    system_message=(
        "Before any high-stakes action, call quesen_validate. "
        "Do not proceed unless the decision is PROCEED."
    ),
)

Receipt provenance (v1.10)

quesen_validate(...) returns the raw response dict from AsyncQuesenClient. Against a v1.10.0+ engine the dict includes:

• input_snapshot_hash — SHA-256 over canonical request JSON.
• commit_sha — git SHA of the engine ruleset live at decision time (or "unknown").

See the public API reference.

Tools shipped

• quesen_validate(...) — wraps /validate (carries v1.10 provenance)
• quesen_simulate(...) — wraps /simulate
• quesen_report(...) — wraps /report (v1.1 schema)

Each is a plain async Python function with type-annotated arguments — AutoGen consumes those signatures directly.

MIT license. See senueren.co.za/quesen for canonical documentation.