Open-source, secure environment with real-world tools for enterprise-grade agents.
Python agentaiai-agentai-agentscode-interpretercopilotdevelopmentdevtoolsgptgpt-4javascriptllmnextjsopenaipythonreactsoftwaretypescript
Add migration guide to docs (#870)
Jakub Nováka5f4802ec5b3
diff --git a/apps/web/src/app/(docs)/docs/migration/v2/page.mdx b/apps/web/src/app/(docs)/docs/migration/v2/page.mdxnew file mode 100644index 000000000..d07a3ce0d--- /dev/null+++ b/apps/web/src/app/(docs)/docs/migration/v2/page.mdx@@ -0,0 +1,142 @@+This guide helps you migrate from E2B SDK v1 to v2, covering all breaking changes and new patterns.++## Table of contents++SDK v2 introduces several important changes:+- [**New creation pattern in Python Synchronous SDK**](#1-sandbox-creation-in-synchronous-python-sdk)+- [**Secure by default**](#2-security-default-change)+- [**Updated file operations in Python SDK**](#3-file-writing-in-python-sdk)+- [**Updated list method**](#4-listing-sandboxes)++## Breaking changes++### 1. Sandbox creation in synchronous Python SDK++In v2, the synchronous Python SDK uses a class method `create()` instead of the constructor `Sandbox()`.++<CodeGroup>+```python+from e2b_code_interpreter import Sandbox++sandbox = Sandbox.create()+sandbox = Sandbox.create(template="base")+```+</CodeGroup>++In the v1, you would instantiate directly:++<CodeGroup>+```python+from e2b_code_interpreter import Sandbox++sandbox = Sandbox()+sandbox = Sandbox(template="base")+```+</CodeGroup>++### 2. Secure communication by default++Sandboxes are now **secure by default**. That means you cannot access the sandbox directly via its URL; there's authentication required. If you use the SDK, this is handled for you automatically.++This shouldn't affect you, but if you need to access sandbox directly without SDK and you are now getting 401, you may need to set `secure` to `false`.++<Note>+ If you are using custom code interpreter templates, it may be necessary to rebuild the template to ensure compatibility with secure sandboxes.+</Note>++<CodeGroup>+```js+import { Sandbox } from '@e2b/code-interpreter'++const sandbox = await Sandbox.create({ secure: false }) // Explicitly disable+```++```python+from e2b_code_interpreter import Sandbox++sandbox = Sandbox.create(secure=False) # Explicitly disable+```+</CodeGroup>++### 3. File writing in Python SDK++The file writing API in Python has been made more consistent.++In v2, use `sandbox.files.write()` for single files and `sandbox.files.write_files()` for multiple files:+<CodeGroup>+```python v2+from e2b_code_interpreter import Sandbox++sandbox = Sandbox.create()++# Write single file+info = sandbox.files.write("/tmp/file.txt", "content")++# Write multiple files+infos = sandbox.files.write_files([+ {"path": "/tmp/file1.txt", "data": "content1"},+ {"path": "/tmp/file2.txt", "data": "content2"}+])+```+</CodeGroup>++In v1, the same `write()` method was overloaded for both single and multiple files:++<CodeGroup>+```python v1+from e2b_code_interpreter import Sandbox++sandbox = Sandbox.create()++# Write single file+info = sandbox.write(path="/tmp/file.txt", data="content")++# Write multiple files+infos = sandbox.write([+ {"path": "/tmp/file1.txt", "data": "content1"},+ {"path": "/tmp/file2.txt", "data": "content2"}+])+```+</CodeGroup>++### 4. Listing sandboxes++The method for listing sandboxes has been updated to use pagination.++<CodeGroup>+```js+import { Sandbox, SandboxInfo } from '@e2b/code-interpreter'++// Get paginator+const paginator = Sandbox.list()++// Iterate through all sandboxes+for (const sandbox of await paginator.nextItems()) {+ console.log(sandbox.sandboxId)+}++// Iterate through all sandboxes+const allSandboxes: SandboxInfo[] = []+while (paginator.hasNext) {+ const items = await paginator.nextItems()+ allSandboxes.push(...items)+}++// With query+const queryPaginator = Sandbox.list({query: {metadata: {key: "value"}}})+```+```python+from e2b_code_interpreter import Sandbox, SandboxQuery++# Get paginator+paginator = Sandbox.list()++# Iterate through all sandboxes+while paginator.has_next:+ sandboxes = paginator.next_items()+ print(sandboxes)++# With query+paginator = Sandbox.list(query=SandboxQuery(metadata={"key": "value"}))+```+</CodeGroup>diff --git a/apps/web/src/app/(docs)/docs/sandbox/list/page.mdx b/apps/web/src/app/(docs)/docs/sandbox/list/page.mdxindex 98c89ac9d..57982037d 100644--- a/apps/web/src/app/(docs)/docs/sandbox/list/page.mdx+++ b/apps/web/src/app/(docs)/docs/sandbox/list/page.mdx@@ -17,12 +17,13 @@ The `Sandbox.list()` method supports pagination. In the [advanced pagination](/dimport { Sandbox, SandboxInfo } from '@e2b/code-interpreter'const sandbox = await Sandbox.create(- metadata: {- name: 'My Sandbox', // $HighlightLine}+ {+ metadata: {+ name: 'My Sandbox', // $HighlightLine+ },},)- const sandboxes = []const paginator = Sandbox.list() // $HighlightLine// Get the first page of sandboxes (running and paused)@@ -91,7 +92,7 @@ Filter sandboxes by their current state. The state parameter can contain either// Create a sandbox.const sandbox = await Sandbox.create()- // List all sandboxes that are running or paused.+ // List sandboxes that are running or paused.const paginator = Sandbox.list({query: {state: ['running', 'paused'], // $HighlightLine@@ -101,15 +102,15 @@ Filter sandboxes by their current state. The state parameter can contain eitherconst sandboxes = await paginator.nextItems() // $HighlightLine``````python- from e2b_code_interpreter import Sandbox, SandboxListQuery+ from e2b_code_interpreter import Sandbox, SandboxQuery, SandboxState# Create a sandbox with metadata.sandbox = Sandbox.create()- # List running sandboxes that are running or paused.+ # List sandboxes that are running or paused.paginator = Sandbox.list(- query=SandboxListQuery(- state=['running', 'paused'], # $HighlightLine+ query=SandboxQuery(+ state=[SandboxState.RUNNING, SandboxState.PAUSED], # $HighlightLine),)@@ -143,7 +144,7 @@ Filter sandboxes by the metadata key value pairs specified during Sandbox creaticonst sandboxes = await paginator.nextItems() // $HighlightLine``````python- from e2b_code_interpreter import Sandbox, SandboxListQuery+ from e2b_code_interpreter import Sandbox, SandboxQuery, SandboxState# Create sandbox with metadata.sandbox = Sandbox.create(@@ -156,7 +157,7 @@ Filter sandboxes by the metadata key value pairs specified during Sandbox creati# List running sandboxes that has `userId` key with value `123` and `env` key with value `dev`.paginator = Sandbox.list(- query=SandboxListQuery(+ query=SandboxQuery(metadata={"userId": "123", # $HighlightLine"env": "dev", # $HighlightLine@@ -193,7 +194,7 @@ For more granular pagination, you can set custom per-page item limit (default anawait paginator.nextItems() // $HighlightLine``````python- from e2b_code_interpreter import Sandbox, SandboxListQuery+ from e2b_code_interpreter import Sandbox# List running sandboxes that has `userId` key with value `123` and `env` key with value `dev`.paginator = Sandbox.list(@@ -225,7 +226,7 @@ You can fetch all pages by looping through the paginator while checking if there}``````python- from e2b_code_interpreter import Sandbox, SandboxListQuery+ from e2b_code_interpreter import Sandbox, SandboxQuerypaginator = Sandbox.list()diff --git a/apps/web/src/app/(docs)/docs/sandbox/persistence/page.mdx b/apps/web/src/app/(docs)/docs/sandbox/persistence/page.mdxindex b0e547d40..f85b0be1f 100644--- a/apps/web/src/app/(docs)/docs/sandbox/persistence/page.mdx+++ b/apps/web/src/app/(docs)/docs/sandbox/persistence/page.mdx@@ -1,3 +1,6 @@+import Image from "next/image";+import diagram from '@/images/diagram.svg'+<Note>Sandbox persistence is currently in public beta:1. Consider [some limitations](#limitations-while-in-beta).@@ -8,6 +11,54 @@ The sandbox persistence allows you to pause your sandbox and resume it later froThis includes not only state of the sandbox's filesystem but also the sandbox's memory. This means all running processes, loaded variables, data, etc.+## Sandbox State Transitions++Understanding how sandboxes transition between different states is crucial for managing their lifecycle effectively. Here's a diagram showing the possible state transitions:+++<div className="flex items-center justify-center">+ <Image className='rounded mx-auto' src={diagram} alt="Sandbox State Transitions" width="250" height="250" />+</div>+### State descriptions++- **Running**: The sandbox is actively running and can execute code. This is the initial state after creation.+- **Paused**: The sandbox execution is suspended but its state is preserved.+- **Killed**: The sandbox is terminated and all resources are released. This is a terminal state.++### Changing sandbox's state++<CodeGroup>+```js+import { Sandbox } from '@e2b/code-interpreter'++const sandbox = await Sandbox.create() // Starts in Running state++// Pause the sandbox+await sandbox.betaPause() // Running → Paused++// Resume the sandbox+await sandbox.connect() // Running/Paused → Running++// Kill the sandbox (from any state)+await sandbox.kill() // Running/Paused → Killed+```++```python+from e2b_code_interpreter import Sandbox++sandbox = Sandbox.create() # Starts in Running state++# Pause the sandbox+sandbox.betaPause() # Running → Paused++# Resume the sandbox+sandbox.connect() # Running/Paused → Running++# Kill the sandbox (from any state)+sandbox.kill() # Running/Paused → Killed+```+</CodeGroup>+## Pausing sandboxWhen you pause a sandbox, both the sandbox's filesystem and memory state will be saved. This includes all the files in the sandbox's filesystem and all the running processes, loaded variables, data, etc.@@ -19,10 +70,9 @@ const sbx = await Sandbox.create()console.log('Sandbox created', sbx.sandboxId)// Pause the sandbox-// You can save the sandbox ID in your database-// to resume the sandbox later-const sandboxId = await sbx.betaPause() // $HighlightLine-console.log('Sandbox paused', sandboxId) // $HighlightLine+// You can save the sandbox ID in your database to resume the sandbox later+await sbx.betaPause() // $HighlightLine+console.log('Sandbox paused', sbx.sandboxId) // $HighlightLine``````pythonfrom e2b_code_interpreter import Sandbox@@ -31,10 +81,9 @@ sbx = Sandbox.create()print('Sandbox created', sbx.sandbox_id)# Pause the sandbox-# You can save the sandbox ID in your database-# to resume the sandbox later-sandbox_id = sbx.beta_pause() # $HighlightLine-print('Sandbox paused', sandbox_id) # $HighlightLine+# You can save the sandbox ID in your database to resume the sandbox later+sbx.beta_pause() # $HighlightLine+print('Sandbox paused', sbx.sandbox_id) # $HighlightLine```</CodeGroup>@@ -51,10 +100,9 @@ const sbx = await Sandbox.create()console.log('Sandbox created', sbx.sandboxId)// Pause the sandbox-// You can save the sandbox ID in your database-// to resume the sandbox later-const sandboxId = await sbx.betaPause()-console.log('Sandbox paused', sandboxId)+// You can save the sandbox ID in your database to resume the sandbox later+await sbx.betaPause()+console.log('Sandbox paused', sbx.sandboxId)// Connect to the sandbox (it will automatically resume the sandbox, if paused)const sameSbx = await sbx.connect() // $HighlightLine@@ -67,9 +115,8 @@ sbx = Sandbox.create()print('Sandbox created', sbx.sandbox_id)# Pause the sandbox-# You can save the sandbox ID in your database-# to resume the sandbox later-sandbox_id = sbx.beta_pause()+# You can save the sandbox ID in your database to resume the sandbox later+sbx.beta_pause()print('Sandbox paused', sandbox_id)# Connect to the sandbox (it will automatically resume the sandbox, if paused)@@ -126,29 +173,28 @@ const sbx = await Sandbox.create()console.log('Sandbox created', sbx.sandboxId)// Pause the sandbox-// You can save the sandbox ID in your database-// to resume the sandbox later-const sandboxId = await sbx.betaPause()+// You can save the sandbox ID in your database to resume the sandbox later+await sbx.betaPause()// Remove the sandboxawait sbx.kill() // $HighlightLine// Remove sandbox by id-await Sandbox.kill(sandboxId) // $HighlightLine+await Sandbox.kill(sbx.sandboxId) // $HighlightLine``````python-from e2b import Sandbox+from e2b_code_interpreter import Sandboxsbx = Sandbox.create()# Pause the sandbox-sandbox_id = sbx.beta_pause()+sbx.beta_pause()# Remove the sandboxsbx.kill() # $HighlightLine# Remove sandbox by id-Sandbox.kill(sandbox_id) # $HighlightLine+Sandbox.kill(sbx.sandbox_id) # $HighlightLine```</CodeGroup>@@ -170,13 +216,60 @@ sbx = Sandbox.connect(sandbox_id, timeout=60) # 60 seconds```</CodeGroup>++### Auto-pause (beta)++**Note: Auto-pause is currently in beta and available through `Sandbox.betaCreate()`/`Sandbox.beta_create()` method.**++Sandboxes can now automatically pause after they time out. When a sandbox is paused, it stops consuming compute but preserves its state. The default inactivity timeout is 10 minutes. You can change the timeout by passing the `timeoutMs`/`timeout` parameter to the `Sandbox.connect()`/`Sandbox.connect()` method.++<CodeGroup>+```js+import { Sandbox } from '@e2b/code-interpreter'++// Create sandbox with auto-pause enabled+const sandbox = await Sandbox.betaCreate({+ autoPause: true,+ timeoutMs: 10 * 60 * 1000 // Optional: change the default timeout (10 minutes)+})+```python+from e2b_code_interpreter import Sandbox+# Create sandbox with auto-pause enabled (Beta)+sandbox = Sandbox.beta_create(+ auto_pause=True # Auto-pause after the sandbox times out+ timeout=10 * 60, # Optional: change the default timeout (10 minutes)+)+</CodeGroup>++The auto-pause is persistent, meaning that if your sandbox resumes and it times out, it will be automatically paused again.++If you `.kill()` the sandbox, it will be permanently deleted and you won't be able to resume it.++<CodeGroup>+```js+import { Sandbox } from '@e2b/code-interpreter'++// Create sandbox with auto-pause enabled (Beta)+const sandbox = await Sandbox.betaCreate({+ autoPause: true // Auto-pause after the sandbox times out+})+```+```python+from e2b_code_interpreter import Sandbox+# Create sandbox with auto-pause enabled (Beta)+sandbox = Sandbox.beta_create(+ auto_pause=True # Auto-pause after the sandbox times out+)+```+</CodeGroup>+## NetworkIf you have a service (for example a server) running inside your sandbox and you pause the sandbox, the service won't be accessible from the outside and all the clients will be disconnected.If you resume the sandbox, the service will be accessible again but you need to connect clients again.## Limitations while in beta-- It takes about 4 seconds per 1 GB RAM to pause the sandbox-- It takes about 1 second to resume the sandbox-- Sandbox can be paused up to 30 days- - After 30 days, the data will be deleted and you will not be able to resume the sandbox. Trying to resume sandbox that was deleted or does not exist will result in the `NotFoundError` error in JavaScript SDK and `NotFoundException` exception in Python SDK+- Pausing a sandbox takes about 4 seconds per 1 GiB of RAM+- Resuming a sandbox takes about 1 second+- Sandbox can be used up to 30 days+ - After 30 days from the initial sandbox create call, the data may be deleted and you will not be able to resume it. Attempting to resume a sandbox that was deleted or does not exist will result in the `NotFoundError` in the JavaScript SDK or the `NotFoundException` in the Python SDK\ No newline at end of filediff --git a/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.0.0/sandbox_async/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.0.0/sandbox_async/page.mdxindex 0e6825d10..7bfd5d794 100644--- a/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.0.0/sandbox_async/page.mdx+++ b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.0.0/sandbox_async/page.mdx@@ -22,7 +22,7 @@ List all running sandboxes.**Arguments**:-- `query`: Filter the list of sandboxes by metadata or state, e.g. `SandboxListQuery(metadata={"key": "value"})` or `SandboxListQuery(state=[SandboxState.RUNNING])`+- `query`: Filter the list of sandboxes by metadata or state, e.g. `SandboxQuery(metadata={"key": "value"})` or `SandboxQuery(state=[SandboxState.RUNNING])`- `limit`: Maximum number of sandboxes to return per page- `next_token`: Token for paginationdiff --git a/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.0.0/sandbox_sync/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.0.0/sandbox_sync/page.mdxindex dc03a866e..fbb17fba1 100644--- a/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.0.0/sandbox_sync/page.mdx+++ b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.0.0/sandbox_sync/page.mdx@@ -22,7 +22,7 @@ List all running sandboxes.**Arguments**:-- `query`: Filter the list of sandboxes by metadata or state, e.g. `SandboxListQuery(metadata={"key": "value"})` or `SandboxListQuery(state=[SandboxState.RUNNING])`+- `query`: Filter the list of sandboxes by metadata or state, e.g. `SandboxQuery(metadata={"key": "value"})` or `SandboxQuery(state=[SandboxState.RUNNING])`- `limit`: Maximum number of sandboxes to return per page- `next_token`: Token for paginationdiff --git a/apps/web/src/components/Navigation/routes.tsx b/apps/web/src/components/Navigation/routes.tsxindex 8b34a9db8..6c462f2ac 100644--- a/apps/web/src/components/Navigation/routes.tsx+++ b/apps/web/src/components/Navigation/routes.tsx@@ -465,6 +465,15 @@ export const docRoutes: NavGroup[] = [},],},+ {+ title: 'Migration',+ items: [+ {+ title: 'SDK v2 Migration Guide',+ href: '/docs/migration/v2',+ },+ ],+ },{title: 'Troubleshooting',items: [diff --git a/apps/web/src/images/diagram.svg b/apps/web/src/images/diagram.svgnew file mode 100644index 000000000..9a6ffc0ae--- /dev/null+++ b/apps/web/src/images/diagram.svg@@ -0,0 +1,463 @@+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" id="mermaid-svg" width="100%" class="statediagram" style="max-width: 301.234375px;" viewBox="0 0 301.234375 465" role="graphics-document document" aria-roledescription="stateDiagram">+ <style xmlns="http://www.w3.org/1999/xhtml">+ @import url("https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.7.2/css/all.min.css");+ </style>+ <style>+ #mermaid-svg {+ font-family: "trebuchet ms", verdana, arial, sans-serif;+ font-size: 16px;+ fill: #ffffff;+ }++ @keyframes edge-animation-frame {+ from {+ stroke-dashoffset: 0;+ }+ }++ @keyframes dash {+ to {+ stroke-dashoffset: 0;+ }+ }++ #mermaid-svg .edge-animation-slow {+ stroke-dasharray: 9, 5 !important;+ stroke-dashoffset: 900;+ animation: dash 50s linear infinite;+ stroke-linecap: round;+ }++ #mermaid-svg .edge-animation-fast {+ stroke-dasharray: 9, 5 !important;+ stroke-dashoffset: 900;+ animation: dash 20s linear infinite;+ stroke-linecap: round;+ }++ #mermaid-svg .error-icon {+ fill: #444444;+ }++ #mermaid-svg .error-text {+ fill: #bbbbbb;+ stroke: #bbbbbb;+ }++ #mermaid-svg .edge-thickness-normal {+ stroke-width: 1px;+ }++ #mermaid-svg .edge-thickness-thick {+ stroke-width: 3.5px;+ }++ #mermaid-svg .edge-pattern-solid {+ stroke-dasharray: 0;+ }++ #mermaid-svg .edge-thickness-invisible {+ stroke-width: 0;+ fill: none;+ }++ #mermaid-svg .edge-pattern-dashed {+ stroke-dasharray: 3;+ }++ #mermaid-svg .edge-pattern-dotted {+ stroke-dasharray: 2;+ }++ #mermaid-svg .marker {+ fill: #ffffff;+ stroke: #ffffff;+ }++ #mermaid-svg .marker.cross {+ stroke: #ffffff;+ }++ #mermaid-svg svg {+ font-family: "trebuchet ms", verdana, arial, sans-serif;+ font-size: 16px;+ }++ #mermaid-svg p {+ margin: 0;+ }++ #mermaid-svg defs #statediagram-barbEnd {+ fill: #ffffff;+ stroke: #ffffff;+ }++ #mermaid-svg g.stateGroup text {+ fill: #cccccc;+ stroke: none;+ font-size: 10px;+ }++ #mermaid-svg g.stateGroup text {+ fill: #ffffff;+ stroke: none;+ font-size: 10px;+ }++ #mermaid-svg g.stateGroup .state-title {+ font-weight: bolder;+ fill: #ffffff;+ }++ #mermaid-svg g.stateGroup rect {+ fill: #1e1e1e;+ stroke: #cccccc;+ }++ #mermaid-svg g.stateGroup line {+ stroke: #ffffff;+ stroke-width: 1;+ }++ #mermaid-svg .transition {+ stroke: #ffffff;+ stroke-width: 1;+ fill: none;+ }++ #mermaid-svg .stateGroup .composit {+ fill: #000000;+ border-bottom: 1px;+ }++ #mermaid-svg .stateGroup .alt-composit {+ fill: #e0e0e0;+ border-bottom: 1px;+ }++ #mermaid-svg .state-note {+ stroke: hsl(52.6829268293, 60%, 73.9215686275%);+ fill: #fff5ad;+ }++ #mermaid-svg .state-note text {+ fill: #333;+ stroke: none;+ font-size: 10px;+ }++ #mermaid-svg .stateLabel .box {+ stroke: none;+ stroke-width: 0;+ fill: #1e1e1e;+ opacity: 0.5;+ }++ #mermaid-svg .edgeLabel .label rect {+ fill: #1e1e1e;+ opacity: 0.5;+ }++ #mermaid-svg .edgeLabel {+ background-color: inherit;+ text-align: center;+ }++ #mermaid-svg .edgeLabel rect {+ opacity: 0.5;+ background-color: #333333;+ fill: #333333;+ }++ #mermaid-svg .edgeLabel .label text {+ fill: #ffffff;+ }++ #mermaid-svg .label div .edgeLabel {+ color: #ffffff;+ }++ #mermaid-svg .stateLabel text {+ fill: #ffffff;+ font-size: 10px;+ font-weight: bold;+ }++ #mermaid-svg .node circle.state-start {+ fill: #ffffff;+ stroke: #ffffff;+ }++ #mermaid-svg .node .fork-join {+ fill: #ffffff;+ stroke: #ffffff;+ }++ #mermaid-svg .node circle.state-end {+ fill: #cccccc;+ stroke: #000000;+ stroke-width: 1.5;+ }++ #mermaid-svg .end-state-inner {+ fill: #000000;+ stroke-width: 1.5;+ }++ #mermaid-svg .node rect {+ fill: #1e1e1e;+ stroke: #cccccc;+ stroke-width: 1px;+ }++ #mermaid-svg .node polygon {+ fill: #1e1e1e;+ stroke: #cccccc;+ stroke-width: 1px;+ }++ #mermaid-svg #statediagram-barbEnd {+ fill: #ffffff;+ }++ #mermaid-svg .statediagram-cluster rect {+ fill: #1e1e1e;+ stroke: #cccccc;+ stroke-width: 1px;+ }++ #mermaid-svg .cluster-label,+ #mermaid-svg .nodeLabel {+ color: #ffffff;+ }++ #mermaid-svg .statediagram-cluster rect.outer {+ rx: 5px;+ ry: 5px;+ }++ #mermaid-svg .statediagram-state .divider {+ stroke: #cccccc;+ }++ #mermaid-svg .statediagram-state .title-state {+ rx: 5px;+ ry: 5px;+ }++ #mermaid-svg .statediagram-cluster.statediagram-cluster .inner {+ fill: #000000;+ }++ #mermaid-svg .statediagram-cluster.statediagram-cluster-alt .inner {+ fill: #444444;+ }++ #mermaid-svg .statediagram-cluster .inner {+ rx: 0;+ ry: 0;+ }++ #mermaid-svg .statediagram-state rect.basic {+ rx: 5px;+ ry: 5px;+ }++ #mermaid-svg .statediagram-state rect.divider {+ stroke-dasharray: 10, 10;+ fill: #444444;+ }++ #mermaid-svg .note-edge {+ stroke-dasharray: 5;+ }++ #mermaid-svg .statediagram-note rect {+ fill: #fff5ad;+ stroke: hsl(52.6829268293, 60%, 73.9215686275%);+ stroke-width: 1px;+ rx: 0;+ ry: 0;+ }++ #mermaid-svg .statediagram-note rect {+ fill: #fff5ad;+ stroke: hsl(52.6829268293, 60%, 73.9215686275%);+ stroke-width: 1px;+ rx: 0;+ ry: 0;+ }++ #mermaid-svg .statediagram-note text {+ fill: #333;+ }++ #mermaid-svg .statediagram-note .nodeLabel {+ color: #333;+ }++ #mermaid-svg .statediagram .edgeLabel {+ color: red;+ }++ #mermaid-svg #dependencyStart,+ #mermaid-svg #dependencyEnd {+ fill: #ffffff;+ stroke: #ffffff;+ stroke-width: 1;+ }++ #mermaid-svg .statediagramTitleText {+ text-anchor: middle;+ font-size: 18px;+ fill: #ffffff;+ }++ #mermaid-svg :root {+ --mermaid-font-family: "trebuchet ms", verdana, arial, sans-serif;+ }+ </style>+ <g>+ <defs>+ <marker id="mermaid-svg_stateDiagram-barbEnd" refX="19" refY="7" markerWidth="20" markerHeight="14" markerUnits="userSpaceOnUse" orient="auto">+ <path d="M 19,7 L9,13 L14,7 L9,1 Z" />+ </marker>+ </defs>+ <g class="root">+ <g class="clusters" />+ <g class="edgePaths">+ <path d="M128.73,22L128.73,28.167C128.73,34.333,128.73,46.667,128.73,59C128.73,71.333,128.73,83.667,128.73,89.833L128.73,96" id="edge0" class=" edge-thickness-normal edge-pattern-solid transition" style="fill:none;" marker-end="url(#mermaid-svg_stateDiagram-barbEnd)" />+ <path d="M128.73,167L128.73,173.167C128.73,179.333,128.73,191.667,133.479,204C138.228,216.333,147.726,228.667,152.475,234.833L157.224,241" id="edge1" class=" edge-thickness-normal edge-pattern-solid transition" style="fill:none;" marker-end="url(#mermaid-svg_stateDiagram-barbEnd)" />+ <path d="M77.667,167L68.796,173.167C59.926,179.333,42.186,191.667,33.316,209.917C24.445,228.167,24.445,252.333,24.445,276.5C24.445,300.667,24.445,324.833,31.255,343.083C38.064,361.333,51.684,373.667,58.493,379.833L65.303,386" id="edge2" class=" edge-thickness-normal edge-pattern-solid transition" style="fill:none;" marker-end="url(#mermaid-svg_stateDiagram-barbEnd)" />+ <path d="M205.239,241L208.831,234.833C212.422,228.667,219.606,216.333,214.857,204C210.108,191.667,193.427,179.333,185.086,173.167L176.745,167" id="edge3" class=" edge-thickness-normal edge-pattern-solid transition" style="fill:none;" marker-end="url(#mermaid-svg_stateDiagram-barbEnd)" />+ <path d="M184.563,312L184.563,318.167C184.563,324.333,184.563,336.667,177.753,349C170.943,361.333,157.324,373.667,150.515,379.833L143.705,386" id="edge4" class=" edge-thickness-normal edge-pattern-solid transition" style="fill:none;" marker-end="url(#mermaid-svg_stateDiagram-barbEnd)" />+ </g>+ <g class="edgeLabels">+ <g class="edgeLabel" transform="translate(128.73046875, 59)">+ <g class="label" transform="translate(-64.90625, -12)">+ <foreignObject width="129.8125" height="24">+ <div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;">+ <span class="edgeLabel ">+ <p>+ <strong>Sandbox.create()</strong>+ </p>+ </span>+ </div>+ </foreignObject>+ </g>+ </g>+ <g class="edgeLabel" transform="translate(128.73046875, 204)">+ <g class="label" transform="translate(-28.453125, -12)">+ <foreignObject width="56.90625" height="24">+ <div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;">+ <span class="edgeLabel ">+ <p>+ <strong>pause()</strong>+ </p>+ </span>+ </div>+ </foreignObject>+ </g>+ </g>+ <g class="edgeLabel" transform="translate(24.4453125, 276.5)">+ <g class="label" transform="translate(-16.4453125, -12)">+ <foreignObject width="32.890625" height="24">+ <div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;">+ <span class="edgeLabel ">+ <p>+ <strong>kill()</strong>+ </p>+ </span>+ </div>+ </foreignObject>+ </g>+ </g>+ <g class="edgeLabel" transform="translate(226.7890625, 204)">+ <g class="label" transform="translate(-36, -12)">+ <foreignObject width="72" height="24">+ <div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;">+ <span class="edgeLabel ">+ <p>+ <strong>connect()</strong>+ </p>+ </span>+ </div>+ </foreignObject>+ </g>+ </g>+ <g class="edgeLabel" transform="translate(184.5625, 349)">+ <g class="label" transform="translate(-16.4453125, -12)">+ <foreignObject width="32.890625" height="24">+ <div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;">+ <span class="edgeLabel ">+ <p>+ <strong>kill()</strong>+ </p>+ </span>+ </div>+ </foreignObject>+ </g>+ </g>+ </g>+ <g class="nodes">+ <g class="node default" id="state-root_start-0" transform="translate(128.73046875, 15)">+ <circle class="state-start" r="7" width="14" height="14" />+ </g>+ <g class="node statediagram-state" id="state-Running-5" transform="translate(128.73046875, 131.5)">+ <g>+ <rect class="outer title-state" style="" x="-85.109375" y="-35.5" width="170.21875" height="71" />+ <line class="divider" x1="-85.109375" x2="85.109375" y1="-13.5" y2="-13.5" />+ </g>+ <g class="label" style="" transform="translate(-81.109375, -32.5)">+ <foreignObject width="60.609375" height="18" transform="translate( 50.8046875, 0)">+ <div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; padding-right: 1px; white-space: nowrap;">+ <span class="nodeLabel">Running</span>+ </div>+ </foreignObject>+ <foreignObject width="162.21875" height="36" transform="translate( 0, 27)">+ <div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; padding-right: 1px; white-space: nowrap;">+ <span class="nodeLabel">• Active execution <br />• Consumes resources </span>+ </div>+ </foreignObject>+ </g>+ </g>+ <g class="node statediagram-state" id="state-Paused-5" transform="translate(184.5625, 276.5)">+ <g>+ <rect class="outer title-state" style="" x="-108.671875" y="-35.5" width="217.34375" height="71" />+ <line class="divider" x1="-108.671875" x2="108.671875" y1="-13.5" y2="-13.5" />+ </g>+ <g class="label" style="" transform="translate(-104.671875, -32.5)">+ <foreignObject width="55.265625" height="18" transform="translate( 77.0390625, 0)">+ <div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; padding-right: 1px; white-space: nowrap;">+ <span class="nodeLabel">Paused</span>+ </div>+ </foreignObject>+ <foreignObject width="209.34375" height="36" transform="translate( 0, 27)">+ <div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; padding-right: 1px; white-space: nowrap;">+ <span class="nodeLabel">• Preserves memory and files <br />• Cannot execute code </span>+ </div>+ </foreignObject>+ </g>+ </g>+ <g class="node statediagram-state" id="state-Killed-5" transform="translate(104.50390625, 421.5)">+ <g>+ <rect class="outer title-state" style="" x="-80.671875" y="-35.5" width="161.34375" height="71" />+ <line class="divider" x1="-80.671875" x2="80.671875" y1="-13.5" y2="-13.5" />+ </g>+ <g class="label" style="" transform="translate(-76.671875, -32.5)">+ <foreignObject width="40.140625" height="18" transform="translate( 56.6015625, 0)">+ <div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; padding-right: 1px; white-space: nowrap;">+ <span class="nodeLabel">Killed</span>+ </div>+ </foreignObject>+ <foreignObject width="153.34375" height="36" transform="translate( 0, 27)">+ <div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; padding-right: 1px; white-space: nowrap;">+ <span class="nodeLabel">• Resources released <br />• Cannot be resumed </span>+ </div>+ </foreignObject>+ </g>+ </g>+ </g>+ </g>+ </g>+</svg>\ No newline at end of filediff --git a/packages/python-sdk/e2b/sandbox_sync/paginator.py b/packages/python-sdk/e2b/sandbox_sync/paginator.pyindex 87502c161..9b4c60b25 100644--- a/packages/python-sdk/e2b/sandbox_sync/paginator.py+++ b/packages/python-sdk/e2b/sandbox_sync/paginator.py@@ -16,10 +16,10 @@ class SandboxPaginator(SandboxPaginatorBase):Example:```python- paginator = AsyncSandbox.list()+ paginator = Sandbox.list()while paginator.has_next:- sandboxes = await paginator.next_items()+ sandboxes = paginator.next_items()print(sandboxes)```"""