agent-hooks-sdk 0.1.0a1

Framework-neutral agent control contract: interception points, agent context, verdict, and conformance test kit. Python wrapper over the canonical Rust core.

agent-hooks (Python SDK)

Python implementation of AGENT-HOOKS-0.1: interception-point enums, AgentContext builder, Verdict types, host-side InterceptionEmitter, and the Conformance Test Kit.

# Not yet on PyPI (the name "agent-hooks" is held by an unrelated
# project; the distribution is named agent-hooks-sdk). Install from source:
pip install "agent-hooks-sdk @ git+https://github.com/responsibleai/agent-hooks#subdirectory=sdk/python"

Host (framework adapter) usage

from agent_hooks import AgentContextBuilder, InterceptionEmitter, InterceptionBlocked

builder = AgentContextBuilder(agent_id="...", framework="my-fw", session_id="...")
emitter = InterceptionEmitter().register(my_consumer)

await emitter.emit(builder.agent_startup(tools_registered=[...]))
ctx = builder.pre_tool_call(call_id="tc-1", name="http_get", args={"url": u})
try:
    await emitter.emit(ctx)
except InterceptionBlocked as e:
    return tool_error(e.result.verdict.reason)
result = invoke_tool(ctx["tool_call"]["args"])  # post-transform args

Interceptor usage

from agent_hooks import Interceptor, AgentContext, Verdict, Decision

class MyPolicy:
    def intercept(self, ctx: AgentContext) -> Verdict:
        if ctx["interception_point"] == "pre_tool_call" and ctx["tool_call"]["name"] == "rm":
            return Verdict(Decision.DENY, reason="dangerous")
        return Verdict.ALLOW

Running the CTK against your framework

Implement agent_hooks.ctk.Harness (see conformance/HARNESS.md), then:

pytest --agent-hooks-harness=my_pkg:MyHarness \
       --agent-hooks-vectors=path/to/conformance/vectors