Hosted control plane
Scope: current hosted production uses organization workspaces. Personal workspaces and owner self-review require a later control-plane upgrade; self-hosted installations depend on their actual version and identity configuration.
With the hosted control plane, we run the control plane and you run the agents.
| We run | You run |
|---|---|
| The control plane: projects, members, policies and their versions, reviews, approval tickets, events, the control audit log | Your agents, with the Guard SDK or the MCP proxy |
| The console | Your tools, MCP servers and business systems |
| The private SDK index | Any HTTP broker or isolated MCP proxy you deploy |
Every decision is made in your environment, from a cached copy of the policy. The control plane receives redacted events only. See Security.
Getting started
We set up your organization with you, or you create it yourself by signing in with a Yi Labs account. Then follow Quickstart: hosted control plane.
If your agents reach the internet through a company proxy, or you need to trust your own root certificate, set PREWORLD_GUARD_PROXY and PREWORLD_GUARD_CA_BUNDLE, or pass proxy= and ca_bundle= to GuardClient. They apply only to the SDK's traffic to the control plane.
Timings
| What | How long |
|---|---|
| A published policy reaching executors | About 15 seconds (the heartbeat interval) |
| A revoked connection cutting off its agent | At the agent's next contact with the control plane, usually within seconds |
| Session in the console | 15 minutes, not extended |
| Executor credential | 90 days by default |
| SDK download token | 1 to 365 days, your choice |
| Claiming a space we set up for you | 7 days |
| Approval ticket | 1 hour |
Current limits
- One node, no high availability. Backups run daily, so in the worst case up to 24 hours of data can be lost. There is no 24×7 alerting.
- Upgrade windows. Upgrading the control plane makes it unavailable for 1 to 3 minutes. We tell you in advance. During that time:
- Executors keep deciding with their cached policy.
- New approvals can't be filed or used.
- An executor that can't reach the control plane for more than 5 minutes blocks every protected action until it can.
- Capacity. Each project keeps up to 100,000 events for 30 days. Ask us when you need an export.
- Organizations. An organization can create up to 100 projects.
Leaving the hosted service
When your organization stops using the hosted control plane:
- Every executor credential, session and SDK download token stops working at once.
- Pending approvals are cancelled.
- Your data is deleted if you ask. Copies in backups are deleted as those backups expire, within 30 days.
For account recovery, use your Yi Labs account. For an export, a data deletion or leaving the service, use our contact page.