Skip to main content
For the setup steps, see Run eve agents in sandboxes.

Exports

The package works with eve 1.0. Its name in eve is vms.

Environment options

VmsSandbox.environment(options) takes these options. Each option is optional. environment.open(options) takes size and labels. They apply only when the call starts a new sandbox. The labels of open() go on top of the environment labels.

Sandbox name

The name is eve- and the first 32 hexadecimal characters of the SHA-256 hash of the namespace, a zero byte, and the session ID. For example, eve-3f9a1c2e7b4d0a6e8c5f1b2d9e7a4c3b. To find the sandbox of a session, send GET /v1/sandboxes with name and the states that hold a name: creating, starting, running, stopping, stopped, and error.
TypeScript

Template name

The template name is eve-template- and the first 32 hexadecimal characters of the template key of eve. For example, eve-template-8d2f6a1c9e4b7d3a0f5c2e8b1a6d9f4c. The provider gives eve provider, version, namespace, workspaceRoot, and env for the key. eve adds the workspace files, the skills, and the source of the sandbox file. The artifact of the build is { templateId }: the ID of the template, or null when the agent has no setup.

Session state

eve saves { id, name } with the session: the sandbox ID and its name. The sandbox of a live session has the extension sandboxId, which ctx.getSandbox(environment) gives.

API calls of each step

Errors and retries

Each API key can send 1,200 requests each minute. Each step of a session sends about 3 requests in addition to its commands and file calls.