Add AgentOS daemon control plane and maintenance tooling

This commit is contained in:
-Puter
2026-07-19 06:29:51 +05:30
parent a37e0cc3c9
commit ec84c52155
621 changed files with 97578 additions and 15 deletions

View File

@@ -0,0 +1,62 @@
# Agent Computer
> Source: `docs/deploy/agentcomputer.mdx`
> Canonical URL: https://sandboxagent.dev/docs/deploy/agentcomputer
> Description: Run Sandbox Agent on Agent Computer managed workers.
---
## Prerequisites
- `COMPUTER_API_KEY` or `AGENTCOMPUTER_API_KEY`
- An Agent Computer managed-worker image, or default machine source, that already has your coding agent authenticated
The platform image already includes Sandbox Agent, Claude Code, and Codex. Agent credentials still live inside the machine, so make sure your image or workspace bootstrap has already handled agent login.
## TypeScript example
```bash
npm install sandbox-agent@0.4.x
```
```typescript
import { SandboxAgent } from "sandbox-agent";
import { agentcomputer } from "sandbox-agent/agentcomputer";
const sdk = await SandboxAgent.start({
sandbox: agentcomputer(),
});
try {
const health = await sdk.getHealth();
console.log(health.status);
console.log(sdk.inspectorUrl);
const agents = await sdk.listAgents();
console.log(agents.agents.map((agent) => agent.id));
} finally {
await sdk.destroySandbox();
}
```
The `agentcomputer` provider creates a managed-worker computer, waits until browser access is ready, and routes SDK requests through the machine's authenticated web host. `sdk.inspectorUrl` is already a browser-ready URL, so it opens the built-in Inspector directly.
By default, the provider creates:
- `runtimeFamily: "managed-worker"`
- `usePlatformDefault: true`
Pass `create` when you want to override the handle, workspace name, or other machine-create settings:
```typescript
const sdk = await SandboxAgent.start({
sandbox: agentcomputer({
create: {
handle: "sandbox-agent-demo",
workspaceName: "sandbox-agent-demo",
usePlatformDefault: false,
},
}),
});
```
Set `apiUrl` when you are targeting a self-hosted or local Agent Computer API instead of `https://api.computer.agentcomputer.ai`.