withruntime 0.8.4__tar.gz → 0.10.0__tar.gz

{withruntime-0.8.4 → withruntime-0.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: withruntime
-Version: 0.8.4
+Version: 0.10.0
 Summary: Runtime Cloud: one client (sync and async) for every Runtime product. Sandboxes first.
 License: Apache-2.0
 Project-URL: Homepage, https://withruntime.com
@@ -11,6 +11,8 @@ Keywords: sandbox,ai-agents,agents,microvm,firecracker,code-execution,code-inter
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Provides-Extra: e2b
+Requires-Dist: httpx<1.0.0,>=0.27.0; extra == "e2b"
 Provides-Extra: openai-agents
 Requires-Dist: openai-agents>=0.22.3; extra == "openai-agents"
 Provides-Extra: deepagents
@@ -42,7 +44,8 @@ command-line argument.
 from withruntime import Sandbox
 
 with Sandbox.create() as sbx:
-    result = sbx.exec("python3 -c 'print(6 * 7)'")
+    sbx.files.write("/workspace/invoice.py", "print(sum([125, 250, 375]))\n")
+    result = sbx.exec("python3 /workspace/invoice.py")
     print(result.exit_code, result.stdout)
 ```
 
@@ -51,6 +54,8 @@ leaving the `with` block stops it. With no arguments you get the free trial
 while it lasts: 100 free hours, no card, up to eight sandboxes running at once.
 The current default image includes NumPy, pandas and matplotlib; see the
 [sandbox environment](https://withruntime.com/docs/sandbox-environment).
+Omitting `funding` can use prepaid credit after the trial is exhausted. Use
+`Sandbox.create(funding="trial")` for free use only; it never falls back to paid.
 `AsyncRuntime` is the same client for asyncio, method for method:
 
 ```python
@@ -70,22 +75,31 @@ asyncio.run(main())
 A sandbox has `exec`, `exec_stream`, `spawn`, `terminal`, `forward_port` (any
 TCP port in the sandbox on a local port), `files` (read, write,
 list, glob, stat, move, remove, upload and download directories), `pause`,
-`wake`, `extend`, `update`, `keep_alive`, `fork` and `snapshot`, and the
+`wake`, `extend`, `update` (its name, environment and settings), `keep_alive`,
+`fork`, `snapshot`, `switch_image` (move it to a new image keeping /workspace)
+and `delete` (remove it for good), and the
 `interpreter`, `network`, `previews`, `desktop`, `mounts` (your S3, R2 or Google
-Cloud Storage bucket as a folder), `metrics` and `mcp` (servers from the MCP
-catalog, run in the sandbox) products. A paused sandbox
+Cloud Storage bucket as a folder), `tailscale` (a paid sandbox on your own
+tailnet), `metrics` and `mcp` (servers from the MCP catalog, run in the
+sandbox) products. A paused sandbox
 also wakes by itself on the next call, and `Sandbox.get_or_create(name)` returns
 the sandbox with that name or creates it. A sandbox pauses itself after 60 seconds
 with nothing happening in it, keeping its memory and processes, so an
 idle sandbox costs no compute; `idle_pause_seconds` sets 10 to 86,400, or 0 for
-never. The client has `sandboxes`, `images`, `volumes`, `snapshots`,
+never. `runtime.sandbox`, `snapshot`, `image`, `volume`, `job`, `domain`,
+`port` and `address` name the products as the CLI does. Their existing plural
+names remain aliases of the same product clients. The client has `sandboxes`, `images`, `volumes`, `snapshots`, `jobs`,
 `secrets`, `limits`, `feedback` and `support`; `webhooks`, `events`, `otel` and
 `audit` to watch the account; `domains`, `ports`, `addresses`, `tunnel` and
 `network` to connect sandboxes to your own world (paid accounts); and `mcp`,
 `sso`, `billing`, `referrals` and `switching`. `runtime.limits.get()` (0.3.1 and later) says whether the key is read-only and
 what its agent may still spend today. Every write carries an
 idempotency key, so retries never do anything twice; errors are typed and carry
-`code`, `hint` and `request_id`.
+`code`, `hint` and `request_id`. `RuntimeAPIError` and
+`RuntimeConnectionError` name the SDK errors without shadowing Python's built-in
+errors; the previous `RuntimeError` and `ConnectionError` exports remain aliases.
+`runtime.usage_requests("7d")` reads the account's API call counts and error rates;
+counts are exact decimal strings, and an empty window has `errorPercent: None`.
 
 ## Behind a proxy
 
@@ -104,7 +118,7 @@ proxy http://proxy.internal:3128 (HTTPS_PROXY).`
 
 ## Code written for E2B
 
-`withruntime.e2b` runs code written for E2B's Python SDK on Runtime. Change
+`withruntime.e2b` translates supported E2B Python sandbox calls. Change
 the import and set `RUNTIME_API_KEY`:
 
 ```python no-run
@@ -142,7 +156,7 @@ JavaScript package list every mapping and gap.
 
 ## Code written for Blaxel
 
-`withruntime.blaxel` runs code written for Blaxel's Python SDK (`blaxel`
+`withruntime.blaxel` translates supported Blaxel Python sandbox calls (`blaxel`
 0.4.11) on Runtime. Change the import and set `RUNTIME_API_KEY`, or run
 `npx withruntime login` once:
 

{withruntime-0.8.4 → withruntime-0.10.0}/README.md

@@ -19,7 +19,8 @@ command-line argument.
 from withruntime import Sandbox
 
 with Sandbox.create() as sbx:
-    result = sbx.exec("python3 -c 'print(6 * 7)'")
+    sbx.files.write("/workspace/invoice.py", "print(sum([125, 250, 375]))\n")
+    result = sbx.exec("python3 /workspace/invoice.py")
     print(result.exit_code, result.stdout)
 ```
 
@@ -28,6 +29,8 @@ leaving the `with` block stops it. With no arguments you get the free trial
 while it lasts: 100 free hours, no card, up to eight sandboxes running at once.
 The current default image includes NumPy, pandas and matplotlib; see the
 [sandbox environment](https://withruntime.com/docs/sandbox-environment).
+Omitting `funding` can use prepaid credit after the trial is exhausted. Use
+`Sandbox.create(funding="trial")` for free use only; it never falls back to paid.
 `AsyncRuntime` is the same client for asyncio, method for method:
 
 ```python
@@ -47,22 +50,31 @@ asyncio.run(main())
 A sandbox has `exec`, `exec_stream`, `spawn`, `terminal`, `forward_port` (any
 TCP port in the sandbox on a local port), `files` (read, write,
 list, glob, stat, move, remove, upload and download directories), `pause`,
-`wake`, `extend`, `update`, `keep_alive`, `fork` and `snapshot`, and the
+`wake`, `extend`, `update` (its name, environment and settings), `keep_alive`,
+`fork`, `snapshot`, `switch_image` (move it to a new image keeping /workspace)
+and `delete` (remove it for good), and the
 `interpreter`, `network`, `previews`, `desktop`, `mounts` (your S3, R2 or Google
-Cloud Storage bucket as a folder), `metrics` and `mcp` (servers from the MCP
-catalog, run in the sandbox) products. A paused sandbox
+Cloud Storage bucket as a folder), `tailscale` (a paid sandbox on your own
+tailnet), `metrics` and `mcp` (servers from the MCP catalog, run in the
+sandbox) products. A paused sandbox
 also wakes by itself on the next call, and `Sandbox.get_or_create(name)` returns
 the sandbox with that name or creates it. A sandbox pauses itself after 60 seconds
 with nothing happening in it, keeping its memory and processes, so an
 idle sandbox costs no compute; `idle_pause_seconds` sets 10 to 86,400, or 0 for
-never. The client has `sandboxes`, `images`, `volumes`, `snapshots`,
+never. `runtime.sandbox`, `snapshot`, `image`, `volume`, `job`, `domain`,
+`port` and `address` name the products as the CLI does. Their existing plural
+names remain aliases of the same product clients. The client has `sandboxes`, `images`, `volumes`, `snapshots`, `jobs`,
 `secrets`, `limits`, `feedback` and `support`; `webhooks`, `events`, `otel` and
 `audit` to watch the account; `domains`, `ports`, `addresses`, `tunnel` and
 `network` to connect sandboxes to your own world (paid accounts); and `mcp`,
 `sso`, `billing`, `referrals` and `switching`. `runtime.limits.get()` (0.3.1 and later) says whether the key is read-only and
 what its agent may still spend today. Every write carries an
 idempotency key, so retries never do anything twice; errors are typed and carry
-`code`, `hint` and `request_id`.
+`code`, `hint` and `request_id`. `RuntimeAPIError` and
+`RuntimeConnectionError` name the SDK errors without shadowing Python's built-in
+errors; the previous `RuntimeError` and `ConnectionError` exports remain aliases.
+`runtime.usage_requests("7d")` reads the account's API call counts and error rates;
+counts are exact decimal strings, and an empty window has `errorPercent: None`.
 
 ## Behind a proxy
 
@@ -81,7 +93,7 @@ proxy http://proxy.internal:3128 (HTTPS_PROXY).`
 
 ## Code written for E2B
 
-`withruntime.e2b` runs code written for E2B's Python SDK on Runtime. Change
+`withruntime.e2b` translates supported E2B Python sandbox calls. Change
 the import and set `RUNTIME_API_KEY`:
 
 ```python no-run
@@ -119,7 +131,7 @@ JavaScript package list every mapping and gap.
 
 ## Code written for Blaxel
 
-`withruntime.blaxel` runs code written for Blaxel's Python SDK (`blaxel`
+`withruntime.blaxel` translates supported Blaxel Python sandbox calls (`blaxel`
 0.4.11) on Runtime. Change the import and set `RUNTIME_API_KEY`, or run
 `npx withruntime login` once:
 

{withruntime-0.8.4 → withruntime-0.10.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "withruntime"
-version = "0.8.4"
+version = "0.10.0"
 description = "Runtime Cloud: one client (sync and async) for every Runtime product. Sandboxes first."
 readme = "README.md"
 license = { text = "Apache-2.0" }
@@ -19,6 +19,8 @@ Source = "https://github.com/withruntime/runtime/tree/main/sdks/python"
 Issues = "https://github.com/withruntime/runtime/issues"
 
 [project.optional-dependencies]
+# Preserve E2B's HTTP file-transfer timeout exception types.
+e2b = ["httpx>=0.27.0,<1.0.0"]
 # withruntime.openai_agents: a sandbox client for the OpenAI Agents SDK's SandboxAgent.
 openai-agents = ["openai-agents>=0.22.3"]
 # withruntime.deepagents: a LangChain Deep Agents sandbox backend.
@@ -34,3 +36,6 @@ withruntime = "withruntime.inspect_ai"
 [tool.setuptools.packages.find]
 where = ["."]
 include = ["withruntime*"]
+
+[tool.setuptools.package-data]
+withruntime = ["py.typed"]