CopperTide/Environments

Worlds built from your systems

An environment holds working copies of your systems, seed data and a clock. Each run starts from a fresh copy, and the engine saves each step with a state change.

Connectors

Five actions per connector

Each connector runs as a small separate program, and the engine sends the connector five kinds of request.

Write a connector in any language. Rust and Python kits handle the plumbing, and a checker tests each new connector before use.

CallWhat the connector does
startBrings up a fresh instance of its system for one run
actExecutes a tool call and returns the result
saveCaptures the system’s state at a step
restorePuts a saved state back, exactly or by replay
compareReports the difference between two saved states

What a world holds

Any system your agent touches

Real software where a test allows, simulators elsewhere. Reports label each simulated system.

Data

Databases

SQL and NoSQL stores, saved and restored per run.

Services

Containerized services

Any service in a container, started fresh for each run.

Apps

Business apps

ERP, CRM, EHR and ticketing systems, real or simulated.

Files

Folders and documents

Shared drives and document stores.

Messaging

Email, chat and webhooks

Sealed inside the world. Nothing leaves.

Partners

Simulated people

Customers, suppliers and counterparties replying on the world clock.

Physical

Plants and devices

Simulators for machines, lines and sensors.

Custom

Your own code

Write a connector for anything else in Rust or Python.

Restores

Restore modes, declared per connector

A fork needing a restore mode the connector lacks refuses to start and names the system.

ModeMeaning
Exact saveThe connector saves and loads state exactly, as with a database dump.
ReplayThe connector restarts from the same seed and repeats each step up to the restore point.
ApproximateClose to the saved state. Runs using an approximate restore carry a label in the run view, the run list and comparisons.
NoneNo restore. Forks needing a restore refuse to start and name the system.
Next

Industries

→