Skip to main content
Firedrill separates the local framework from hosted control clients.

Local TypeScript

Run the complete individual-developer loop on your machine.

Cloud TypeScript

Use the generated Control API client and hosted lifecycle helpers.

Cloud Python

Use synchronous or asynchronous hosted clients and helpers.

​
The agent stays yours

Neither SDK embeds or hosts the agent you are testing. The local SDK invokes the target you declare or the callback you supply. The Cloud SDK coordinates a managed world and gives your runner a short-lived binding when agent work is required. This separation keeps model credentials, application secrets, and agent lifecycle in your process. Firedrill evaluates the recorded world consequences.

​
Generated and handwritten surfaces

The Cloud SDKs contain:
  • a generated client that maps the public Control API;
  • small lifecycle helpers for owned sessions and drill runs;
  • evidence paging and continuity checks;
  • explicit capture and attachment helpers; and
  • Node-only Cloud CLI adapters in the TypeScript package’s /cli export.
Generated files carry API provenance and should not be edited manually. The helper layer does not reimplement authorization, world behavior, compilation, or verdicts.
Installation commands on the Cloud SDK pages describe the package names reserved for release. The packages are not available from npm or PyPI yet.