voidrun 0.2.0__tar.gz → 0.2.2__tar.gz

{voidrun-0.2.0 → voidrun-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: voidrun
-Version: 0.2.0
+Version: 0.2.2
 Summary: Python SDK for VoidRun AI Sandbox
 Project-URL: Homepage, https://voidrun.io
 Project-URL: Documentation, https://docs.voidrun.io
@@ -114,7 +114,7 @@ Exported from `voidrun`:
 
 | Constant | Value | Meaning |
 |----------|-------|---------|
-| `DEFAULT_API_BASE_URL` | `https://platform.void-run.com/api` | Default API host when `VR_API_URL` / `API_URL` are unset. |
+| `DEFAULT_API_BASE_URL` | `https://api.void-run.com/api` | Default API host when `VR_API_URL` / `API_URL` are unset. |
 | `DEFAULT_SANDBOX_IMAGE` | `"code"` | Default image id when creating a sandbox without `image=`. |
 | `DEFAULT_SANDBOX_CPU` | `1` | Default CPU count. |
 | `DEFAULT_SANDBOX_MEM` | `1024` | Default memory in MB. |
@@ -134,12 +134,17 @@ sandbox = vr.create_sandbox(
     mem=1024,
     cpu=1,
     labels={"env": "prod", "team": "api"},
+    publish_ports=[8080],  # expose ports as public URLs (set at create time only)
 )
 
 result = sandbox.exec('echo "Hello from VoidRun"')
 # Exec returns VoidRunResponse whose .data is ExecResponseData
 print(result.data.stdout)
 print(sandbox.labels)
+print(sandbox.publish_ports)
+
+# Public URLs are only available for ports declared at creation
+print(sandbox.get_public_urls())
 
 listed = vr.list_sandboxes(labels={"env": "prod"})
 print(listed.meta.total)
@@ -147,6 +152,11 @@ print(listed.meta.total)
 sandbox.remove()
 ```
 
+`publish_ports` (alias `publishPorts`) must be set at creation to expose ports
+as public HTTPS URLs. Pass up to **4** ports (each `1–65535`, no duplicates);
+the created sandbox echoes them on `sandbox.publish_ports`. Ports not published
+at creation are not reachable via `get_public_urls()`.
+
 ### Async
 
 ```python
@@ -202,7 +212,7 @@ Use the same mental model as `@voidrun/sdk` (or the internal TS client):
 
 **Recommended methods**
 
-- `create_sandbox(...)` → `Sandbox` (optional `labels=`)
+- `create_sandbox(...)` → `Sandbox` (optional `labels=`, `publish_ports=`)
 - `get_sandbox(sandbox_id)` → `Sandbox`
 - `list_sandboxes(page=..., limit=..., labels=...)` → `ListSandboxesResult`
 - `remove_sandbox(sandbox_id)` → `None`
@@ -215,7 +225,7 @@ Create options accept both snake_case and camelCase where noted in code (e.g. `e
 
 ### `Sandbox`
 
-Notable attributes: `id`, `name`, `cpu`, `mem`, `org_id`, `status`, `env_vars`, `image`, `region`, `ref_id`, `auto_sleep`, `disk_mb`, `labels`, `created_at`, `created_by`.
+Notable attributes: `id`, `name`, `cpu`, `mem`, `org_id`, `status`, `env_vars`, `image`, `region`, `ref_id`, `auto_sleep`, `disk_mb`, `labels`, `publish_ports`, `created_at`, `created_by`.
 
 Sub-clients:
 

{voidrun-0.2.0 → voidrun-0.2.2}/README.md

@@ -90,7 +90,7 @@ Exported from `voidrun`:
 
 | Constant | Value | Meaning |
 |----------|-------|---------|
-| `DEFAULT_API_BASE_URL` | `https://platform.void-run.com/api` | Default API host when `VR_API_URL` / `API_URL` are unset. |
+| `DEFAULT_API_BASE_URL` | `https://api.void-run.com/api` | Default API host when `VR_API_URL` / `API_URL` are unset. |
 | `DEFAULT_SANDBOX_IMAGE` | `"code"` | Default image id when creating a sandbox without `image=`. |
 | `DEFAULT_SANDBOX_CPU` | `1` | Default CPU count. |
 | `DEFAULT_SANDBOX_MEM` | `1024` | Default memory in MB. |
@@ -110,12 +110,17 @@ sandbox = vr.create_sandbox(
     mem=1024,
     cpu=1,
     labels={"env": "prod", "team": "api"},
+    publish_ports=[8080],  # expose ports as public URLs (set at create time only)
 )
 
 result = sandbox.exec('echo "Hello from VoidRun"')
 # Exec returns VoidRunResponse whose .data is ExecResponseData
 print(result.data.stdout)
 print(sandbox.labels)
+print(sandbox.publish_ports)
+
+# Public URLs are only available for ports declared at creation
+print(sandbox.get_public_urls())
 
 listed = vr.list_sandboxes(labels={"env": "prod"})
 print(listed.meta.total)
@@ -123,6 +128,11 @@ print(listed.meta.total)
 sandbox.remove()
 ```
 
+`publish_ports` (alias `publishPorts`) must be set at creation to expose ports
+as public HTTPS URLs. Pass up to **4** ports (each `1–65535`, no duplicates);
+the created sandbox echoes them on `sandbox.publish_ports`. Ports not published
+at creation are not reachable via `get_public_urls()`.
+
 ### Async
 
 ```python
@@ -178,7 +188,7 @@ Use the same mental model as `@voidrun/sdk` (or the internal TS client):
 
 **Recommended methods**
 
-- `create_sandbox(...)` → `Sandbox` (optional `labels=`)
+- `create_sandbox(...)` → `Sandbox` (optional `labels=`, `publish_ports=`)
 - `get_sandbox(sandbox_id)` → `Sandbox`
 - `list_sandboxes(page=..., limit=..., labels=...)` → `ListSandboxesResult`
 - `remove_sandbox(sandbox_id)` → `None`
@@ -191,7 +201,7 @@ Create options accept both snake_case and camelCase where noted in code (e.g. `e
 
 ### `Sandbox`
 
-Notable attributes: `id`, `name`, `cpu`, `mem`, `org_id`, `status`, `env_vars`, `image`, `region`, `ref_id`, `auto_sleep`, `disk_mb`, `labels`, `created_at`, `created_by`.
+Notable attributes: `id`, `name`, `cpu`, `mem`, `org_id`, `status`, `env_vars`, `image`, `region`, `ref_id`, `auto_sleep`, `disk_mb`, `labels`, `publish_ports`, `created_at`, `created_by`.
 
 Sub-clients:
 

{voidrun-0.2.0 → voidrun-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "voidrun"
-version = "0.2.0"
+version = "0.2.2"
 description = "Python SDK for VoidRun AI Sandbox"
 readme = "README.md"
 requires-python = ">=3.9"

{voidrun-0.2.0 → voidrun-0.2.2}/voidrun/api_client/configuration.py

@@ -238,7 +238,7 @@ conf = voidrun.api_client.Configuration(
     ) -> None:
         """Constructor
         """
-        self._base_path = "https://platform.void-run.com/api" if host is None else host
+        self._base_path = "https://api.void-run.com/api" if host is None else host
         """Default Base url
         """
         self.server_index = 0 if server_index is None and host is None else server_index
@@ -581,7 +581,7 @@ conf = voidrun.api_client.Configuration(
         """
         return [
             {
-                'url': "https://platform.void-run.com/api",
+                'url': "https://api.void-run.com/api",
                 'description': "Production server",
             }
         ]

{voidrun-0.2.0 → voidrun-0.2.2}/voidrun/api_client/models/sandbox.py

@@ -34,7 +34,7 @@ class Sandbox(BaseModel):
     image: Optional[StrictStr] = Field(default=None, description="Resolved image in `name:ver` format", json_schema_extra={"examples": ["code:1.0.42"]})
     cpu: Optional[StrictInt] = Field(default=None, description="Number of vCPUs allocated", json_schema_extra={"examples": [2]})
     mem: Optional[StrictInt] = Field(default=None, description="Memory in MiB", json_schema_extra={"examples": [2048]})
-    disk_mb: Optional[StrictInt] = Field(default=None, description="Disk size in MiB", alias="diskMB", json_schema_extra={"examples": [5120]})
+    disk_mb: Optional[StrictInt] = Field(default=None, description="Disk size in MiB", alias="diskMB", json_schema_extra={"examples": [10240]})
     status: Optional[StrictStr] = Field(default=None, description="Lifecycle state. Terminal states `killed` and `deleted` may still appear in list responses for historical or cleanup rows.", json_schema_extra={"examples": ["running"]})
     created_at: Optional[datetime] = Field(default=None, alias="createdAt")
     created_by: Optional[StrictStr] = Field(default=None, description="User ID who created the sandbox", alias="createdBy", json_schema_extra={"examples": ["65ae1234567890abcdef1234"]})

{voidrun-0.2.0 → voidrun-0.2.2}/voidrun/client.py

@@ -62,6 +62,7 @@ def _build_create_sandbox_request(
     auto_sleep: Optional[bool],
     region: Optional[str],
     labels: Optional[Dict[str, str]] = None,
+    publish_ports: Optional[List[int]] = None,
 ) -> CreateSandboxRequest:
     default_name = f"sdbx-{int(time.time() * 1000)}"
     org_clean = (org_id or "").strip() or None
@@ -77,6 +78,7 @@ def _build_create_sandbox_request(
         auto_sleep=auto_sleep,
         region=region,
         labels=labels,
+        publish_ports=publish_ports,
     )
 
 
@@ -125,6 +127,8 @@ class VoidRun:
         autoSleep: Optional[bool] = None,
         region: Optional[str] = None,
         labels: Optional[Dict[str, str]] = None,
+        publish_ports: Optional[List[int]] = None,
+        publishPorts: Optional[List[int]] = None,
         _owner: Optional[Any] = None,
     ) -> Sandbox:
         """_owner: internal — AsyncVoidRun passes itself so Sandbox uses the async client."""
@@ -139,6 +143,7 @@ class VoidRun:
         ev = env_vars if env_vars is not None else envVars
         asl = auto_sleep if auto_sleep is not None else autoSleep
         uid = user_id if user_id is not None else userId
+        pp = publish_ports if publish_ports is not None else publishPorts
 
         req = _build_create_sandbox_request(
             name=name,
@@ -152,6 +157,7 @@ class VoidRun:
             auto_sleep=asl,
             region=region,
             labels=labels,
+            publish_ports=pp,
         )
         response = self._sandboxes_api.create_sandbox_with_http_info(
             create_sandbox_request=req,
@@ -244,6 +250,7 @@ class SandboxesFacade:
             auto_sleep=kwargs.get("auto_sleep") or kwargs.get("autoSleep"),
             region=kwargs.get("region"),
             labels=kwargs.get("labels"),
+            publish_ports=kwargs.get("publish_ports") or kwargs.get("publishPorts"),
         )
         response = self._api.create_sandbox_with_http_info(
             create_sandbox_request=req,
@@ -381,6 +388,7 @@ class AsyncSandboxesFacade:
             auto_sleep=kwargs.get("auto_sleep") or kwargs.get("autoSleep"),
             region=kwargs.get("region"),
             labels=kwargs.get("labels"),
+            publish_ports=kwargs.get("publish_ports") or kwargs.get("publishPorts"),
         )
         response = await self._client._run_async(
             self._api.create_sandbox_with_http_info,

{voidrun-0.2.0 → voidrun-0.2.2}/voidrun/constants.py

@@ -10,7 +10,7 @@ DEFAULT_SANDBOX_CPU = 1
 DEFAULT_SANDBOX_MEM = 1024
 
 # Same default host as ts-sdk `BASE_PATH` (hosted VoidRun API).
-DEFAULT_API_BASE_URL = "https://platform.void-run.com/api"
+DEFAULT_API_BASE_URL = "https://api.void-run.com/api"
 
 
 def default_api_key() -> Optional[str]:

{voidrun-0.2.0 → voidrun-0.2.2}/voidrun/sandbox.py

@@ -50,6 +50,7 @@ class Sandbox:
         self.image = model.image
         self.disk_mb = model.disk_mb
         self.labels = model.labels
+        self.publish_ports = model.publish_ports
 
         self.fs = FS(self)
         self.pty = PTY(self)