feat: add template versioning with tags support for JS and Python SDKs

[dobrac]

Summary

Add template versioning support using tags to the JS and Python SDKs. Templates can now be built with multiple tags (in name:tag format), and tags can be assigned or deleted from existing builds.

Features

Template Building with Tags

Build templates with one or more tags to enable versioning and environment-based deployments.

• Supports single string, array of strings, or options object
• Multiple tags can reference the same build artifact
• Backward compatible with existing alias parameter

Tag Management

Manage tags on existing template builds:

• assignTag - Assign new tag(s) to an existing build
• removeTag - Remove a tag from a template

---

SDK Usage

JavaScript/TypeScript

// Build with single tag
await Template.build(tmpl, "web-server:v1.0")

// Build with multiple tags
await Template.build(tmpl, "web-server", { tags: ["v1.1.0", "stable"] })

// Assign tag(s) to existing build
await Template.assignTags("web-server:v1.1.0", "production")
await Template.assignTags("web-server:v1.1.0", ["production", "latest"])

// Remove a tag
await Template.removeTags("web-server", "production")

Python

# Build with single tag
Template.build(config, "web-server:v1.0")

# Build with multiple tags
Template.build(config, "web-server", tags=["v1.1.0", "stable"])

# Assign tag(s) to existing build
Template.assign_tags("web-server:v1.1.0", "production")
Template.assign_tags("web-server:v1.1.0", tags=["production", "default"])

# Remove a tag
Template.remove_tags("web-server", "production")

---

Based on infra PR #1524

---

Note

Introduces tag-based template versioning across JS and Python SDKs and updates the build API.

• Template builds now accept name or name:tag; multiple tags supported; alias remains for backward compatibility (normalized internally)
• New tag management APIs: Template.assignTags()/assign_tags() and Template.removeTags()/remove_tags(); adds /templates/tags endpoints and generated models/types
• JS SDK: refactors build request to name/tags, maps build status/reason/log entries to new types, exposes tag helpers
• Python SDK: parallel changes in async/sync APIs, adds status/reason dataclasses, tag helpers, and argument normalization
• CLI templates/tests updated to new Template.build(template, "name") signature; extensive unit/integration tests added
• OpenAPI schema/codegen updated to include tags and deprecations (e.g., alias in v3 request), scripts include tags spec

^{Written by Cursor Bugbot for commit c8f54f9. This will update automatically on new commits. Configure here.}

[changeset-bot]

🦋 Changeset detected

Latest commit: c8f54f9

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages

Name	Type
@e2b/cli	Patch
e2b	Minor
@e2b/python-sdk	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[mishushakov]

reorder some stuff, improve python tests, add more explicits checks for name length, logs array

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is ON. A Cloud Agent has been kicked off to fix the reported issue.}

[cursor]

Bugbot Autofix prepared a fix for the bug found in the latest run.

• ✅ Fixed: LogEntry step field lost when forwarding build logs
  • Added logEntry.step as the 4th argument to LogEntry constructor to preserve step information when forwarding build logs.

Preview (5a7e357)

diff --git a/packages/js-sdk/src/template/buildApi.ts b/packages/js-sdk/src/template/buildApi.ts
--- a/packages/js-sdk/src/template/buildApi.ts
+++ b/packages/js-sdk/src/template/buildApi.ts
@@ -293,7 +293,8 @@ export async function waitForBuildFinish(
         new LogEntry(
           logEntry.timestamp,
           logEntry.level,
-          stripAnsi(logEntry.message)
+          stripAnsi(logEntry.message),
+          logEntry.step
         )
       )
     )

[mishushakov]

minor nits, but overall looks good, happy to merge

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is ON. A Cloud Agent has been kicked off to fix the reported issue.}

[cursor]

Bugbot Autofix prepared a fix for the bug found in the latest run.

• ✅ Fixed: Unset log_entries in reason may cause iteration error
  • Updated log_entries handling to explicitly check for Unset type before iteration, matching the pattern used for the step field.

Preview (984da47)

diff --git a/packages/python-sdk/e2b/template_async/build_api.py b/packages/python-sdk/e2b/template_async/build_api.py
--- a/packages/python-sdk/e2b/template_async/build_api.py
+++ b/packages/python-sdk/e2b/template_async/build_api.py
@@ -158,7 +158,7 @@ def _map_build_status_reason(reason) -> Optional[BuildStatusReason]:
     return BuildStatusReason(
         message=reason.message,
         step=reason.step if not isinstance(reason.step, Unset) else None,
-        log_entries=[_map_log_entry(e) for e in (reason.log_entries or [])],
+        log_entries=[_map_log_entry(e) for e in (reason.log_entries if not isinstance(reason.log_entries, Unset) and reason.log_entries else [])],
     )
 
 

diff --git a/packages/python-sdk/e2b/template_sync/build_api.py b/packages/python-sdk/e2b/template_sync/build_api.py
--- a/packages/python-sdk/e2b/template_sync/build_api.py
+++ b/packages/python-sdk/e2b/template_sync/build_api.py
@@ -157,7 +157,7 @@ def _map_build_status_reason(reason) -> Optional[BuildStatusReason]:
     return BuildStatusReason(
         message=reason.message,
         step=reason.step if not isinstance(reason.step, Unset) else None,
-        log_entries=[_map_log_entry(e) for e in (reason.log_entries or [])],
+        log_entries=[_map_log_entry(e) for e in (reason.log_entries if not isinstance(reason.log_entries, Unset) and reason.log_entries else [])],
     )