Skip to content

Tools and approval policy

The contracts and tool manifest define 38 agent-callable names. Definitions declare schemas, risk traits, availability, and parallel/sequential execution. Executors return bounded content plus artifacts/transcripts when needed.

Local executors cover files/search, finite Bash/Python, Web, Jira, and Confluence. Host-mediated tools cover questions, to-dos, background tasks, Explore, and plan review because they need durable Workbench state or suspend the run.

Every dispatch produces requested, started, output, completed, or failed lifecycle records. File mutations serialize per path; shell/Python can stream but remain finite; supervised task processes are separate.

The server evaluates mode, permission, risk, tool availability, and request details:

  • read-only denies non-read actions and all ordinary network/child spawning;
  • supervised requests approval for non-read risks, with optional read autoapproval;
  • autonomous permits allowed risks without normal approval;
  • planning adds path-constrained writes, tool omissions, and shell guardrails.

Approval can authorize a policy-permitted action. It cannot override a hard read-only or planning denial.

Git/GitHub Workbench actions are HTTP routes, not manifest tools. Agents use Git through Bash. Agent Browser is imported skill guidance, not a tool. UI confirmations for direct Git/PR actions are outside agent tool lifecycle.