Skip to content

armgit / E2B

Public Imported from GitHub
0

Open-source, secure environment with real-world tools for enterprise-grade agents.

1.7 KB
Raw Blame

API specs

Most files in this directory are owned by other repositories and are synced here with Copybara (config in ../copy.bara.sky) — don't edit them by hand; change them in their source repository and re-sync:

  • openapi.yml, envd/envd.yaml, envd/filesystem/, envd/process/ are owned by the runtime repository, pinned by runtime-ref.
  • openapi-volumecontent.yml is owned by the private belt repository, pinned by belt-ref.

Fetches authenticate with a GitHub token when available (GITHUB_TOKEN, or being logged in with gh auth login); the public runtime specs also fetch anonymously, while the volume-content spec needs a token with read access to belt. When a fetch fails, make codegen warns and falls back to the tracked copy.

make codegen re-fetches all of them at their pinned commits before generating the clients, and the generated-files CI check fails if the tracked copies don't match the pins. The files are stored byte-identical to upstream. To update the specs, point the pin at a newer commit and re-run make codegen. To fetch without regenerating:

pnpm fetch:api-spec     # openapi.yml
pnpm fetch:envd-spec    # envd spec
pnpm fetch:volume-spec  # openapi-volumecontent.yml
E2B_RUNTIME_REF=main pnpm fetch:api-spec     # try the latest without moving the pin
E2B_BELT_REF=main pnpm fetch:volume-spec

The remaining files (mcp-server.json, envd/buf-*.gen.yaml) are owned by this repository. The SDK generate pipelines filter openapi.yml down to the tags each SDK exposes with Redocly CLI (see ../redocly.yaml) before generating the clients.