Tools

The Tools module provides execution capabilities used by AI agents and workflows.

Tools represent callable operations that agents may invoke to interact with external systems, infrastructure resources, or internal workspace services.

Tool Contracts

Each tool is defined by a contract containing:

Field

Description

tool_id

Unique tool identifier

capability_required

Required capability permission

risk_tier

Risk classification level

execution_environment

Where the tool runs

timeout

Maximum execution time

idempotency

Whether re-execution is safe

Execution Environments

Sandbox execution — secure isolated environments for data processing, script execution, and lightweight computation.

Browser automation — tools that control browser sessions for web automation, scraping, and web application interaction.

Connector execution — tools that interact with external APIs through connectors such as Gmail, Slack, CRM systems, and payment APIs.

Tool Registry

The tool registry stores available tools within the workspace environment. Agents may discover tools through the registry.