feat(templates): template list pagination via GET /v2/templates

[huv1k]

Summary

Adds support for listing templates with pagination via the new GET /v2/templates endpoint (added to spec/openapi.yml; clients regenerated). The JS and Python SDKs gain a Template.list() paginator that yields TemplateInfo and is built on the shared paginator base from #1491 (Paginator in JS, PaginatorBase in Python), mirroring Sandbox.list(). The CLI's e2b template list pages through results behind a -l, --limit option (default 1000, 100 per page, 0 for no limit) with a "Showing first N…" hint — aligned with e2b sandbox list. Pagination uses the limit/nextToken query params and the X-Next-Token response header. The API key is team-scoped, so listing takes no team identifier.

What's included

• Spec/codegen: GET /v2/templates (limit + nextToken, Template[]), regenerated JS + Python clients.
• JS SDK (e2b): Template.list() → TemplatePaginator (hasNext / nextItems()) returning TemplateInfo. Lives in src/template/templateApi.ts and depends only on shared infra (Paginator, ConnectionOpts).
• Python SDK (@e2b/python-sdk): Template.list() / AsyncTemplate.list() → TemplatePaginator / AsyncTemplatePaginator returning TemplateInfo, living in the template package (e2b/template/template_api.py, e2b/template_{sync,async}/paginator.py) and built on the shared PaginatorBase.
• CLI (@e2b/cli): e2b template list pagination matching sandbox list; the delete/publish --select flows consume the same helper.
• Tests: integration tests (no mocks) for JS, CLI, and Python sync + async — they build a template and assert it shows up via Template.list() against the live API.
• Changeset: minor bump for e2b, @e2b/python-sdk, @e2b/cli.

Usage

CLI:

e2b template list                 # up to 1000 templates (100 per page)
e2b template list --limit 20      # cap at 20; prints "Showing first 20… Use --limit to change."
e2b template list --limit 0 -f json   # no cap, JSON output

JS SDK:

import { Template } from 'e2b'

const paginator = Template.list({ limit: 100 })
while (paginator.hasNext) {
  const templates = await paginator.nextItems()
  console.log(templates)
}

Python SDK:

from e2b import Template  # or AsyncTemplate

paginator = Template.list(limit=100)
while paginator.has_next:
    for template in paginator.next_items():
        print(template.template_id)

Notes

• TemplatePaginator.nextItems() returns [] when exhausted (the sandbox/snapshot paginators still throw — to be unified separately).
• Resolves EN-603.

[linear-code]

EN-603

[changeset-bot]

🦋 Changeset detected

Latest commit: d6c9939

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

This PR includes changesets to release 3 packages

Name	Type
@e2b/python-sdk	Minor
e2b	Minor
@e2b/cli	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

[github-actions]

Package Artifacts

Built from 1cb1172. Download artifacts from this workflow run.

JS SDK (e2b@2.31.1-templates-list-pagination-for-cli-en-603.0):

npm install ./e2b-2.31.1-templates-list-pagination-for-cli-en-603.0.tgz

CLI (@e2b/cli@2.13.1-templates-list-pagination-for-cli-en-603.0):

npm install ./e2b-cli-2.13.1-templates-list-pagination-for-cli-en-603.0.tgz

Python SDK (e2b==2.30.0+templates-list-pagination-for-cli-en-603):

pip install ./e2b-2.30.0+templates.list.pagination.for.cli.en.603-py3-none-any.whl

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 760d988327

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[mishushakov]

move template method to template and shared classes to utils

[mishushakov]

also, no tests for the Python SDKs?

[mishushakov]

more CLI feedback