Metadata-Version: 2.4
Name: runtimesdk
Version: 0.3.0
Summary: RuntimeComputer SDK and CLI — cloud workspaces from the terminal.
Requires-Python: >=3.11
Requires-Dist: modal<2,>=1.1
Requires-Dist: psycopg<4,>=3.2
Requires-Dist: rich>=12
Requires-Dist: typer<1,>=0.12
Requires-Dist: websockets<16,>=15
Description-Content-Type: text/markdown

# runtimesdk

Provider-agnostic runtime engine backed by Modal.

Install surface:

```bash
uv add runtimesdk
```

The package exposes:

- domain models for workspace specs, records, ports, exec results, and
  console-session requests/results
- RuntimeComputer contracts and enums under the same package boundary
- a `WorkspaceStore` protocol plus a PostgreSQL JSONB implementation
- a thin Modal client/provider layer built around documented Modal lookup and
  sandbox primitives
- a `WorkspaceManager` facade for create, ensure-running, exec, console, ports,
  stop, delete, reset, and clone flows

The internal engine implementation still lives under `workspace_runtime`, but
the supported public package boundary is `runtimesdk` and the bundled CLI
command is `runtime`.

`delete()` is intentionally conservative in this first cut: it removes local
state and terminates running sandboxes, but it does not attempt remote cleanup
of prior Modal volumes.
