BaseEnvironment

The environment is the interface your agent uses to discover and call tools at runtime.

Methods

Method	Description
`async alist_tools(tool_server=None)`	Returns tool definitions (all servers, or a specific one)
`async acall_tool(tool_server, tool_name, parameters)`	Invokes a tool and returns a `ToolCallResult`
`list_tool_namespaces()`	Returns `list[ToolNamespace]` describing available tool servers and their transports
`list_tools(tool_server=None)`	Deprecated (removal in 0.4.0) — sync wrapper around `alist_tools()`
`call_tool(tool_server, tool_name, parameters)`	Deprecated (removal in 0.4.0) — sync wrapper around `acall_tool()`

Since BaseAgent.setup() and run() are synchronous, the deprecated sync wrappers (list_tools, call_tool) are still usable from agent code. They run the async methods internally via a compatibility shim.

UnifiedToolEnvironment

SimLab ships UnifiedToolEnvironment, which implements BaseEnvironment over HTTP and MCP transports against the Tool Server Protocol.

from simlab.agents import UnifiedToolEnvironment

env = UnifiedToolEnvironment(
    tool_servers={
        "email": "https://<environment-url>/email",
        "calendar": "https://<environment-url>/calendar",
    },
    timeout_seconds=30.0,
)

tools = env.list_tools()
result = env.call_tool("email", "send_email", {"to": "...", "subject": "...", "body": "..."})

BaseAgent RunArtifacts

API Reference

Agent SDK

Verifiers

Methods

UnifiedToolEnvironment

​Methods

​UnifiedToolEnvironment

Methods

UnifiedToolEnvironment