runtime-sdk 0.4.17__tar.gz → 0.4.19__tar.gz

{runtime_sdk-0.4.17 → runtime_sdk-0.4.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtime-sdk
-Version: 0.4.17
+Version: 0.4.19
 Summary: Runtime Python SDK and CLI
 Project-URL: Repository, https://github.com/The-Money-Company-Limited/runtimevm
 Project-URL: Issues, https://github.com/The-Money-Company-Limited/runtimevm/issues
@@ -10,6 +10,9 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Environment :: Console
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: POSIX :: Linux
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 Requires-Dist: httpx>=0.28.1
@@ -23,6 +26,10 @@ Python SDK and CLI for Runtime.
 
 ## Install
 
+Supported host OS for the CLI: **macOS and Linux only**.
+
+Windows is **not supported** at this time.
+
 ```bash
 uv tool install runtime-sdk
 ```
@@ -59,8 +66,12 @@ runtime login --api-key rt_live_...
 runtime api-keys list
 runtime api-keys create "my laptop"
 runtime api-keys revoke 123
+runtime integrations connect github
 
 # Computers
+runtime switch --repo owner/repo feature/login      # open or create the branch workspace computer
+runtime switch -c feature/login --repo owner/repo   # create a new branch workspace from the repo default branch
+runtime checkout --repo owner/repo feature/login    # alias for switch
 runtime create                       # creates a computer with the starter app already published
 runtime create myapp --command "python3 app.py" --cwd /home/ubuntu --port 3000
 runtime enter <name-or-id>         # accepts slug/name like test, or the computer id
@@ -150,6 +161,28 @@ show|clear` expose that same durable app state directly. The low-level
 `runtime run` stays one-shot: the filesystem is restored after going cold, but
 that ad-hoc process is not.
 
+## GitHub branch workspaces
+
+`runtime switch` gives a repo branch its own Runtime computer so you can jump
+between parallel tasks without local worktrees.
+
+```bash
+runtime integrations connect github
+runtime switch --repo owner/repo feature/login
+runtime switch -c feature/search --repo owner/repo --from main
+```
+
+Rules:
+- GitHub must already be connected with `runtime integrations connect github`.
+- `runtime switch` opens an existing branch workspace, or creates the computer if
+  the branch exists but the workspace does not yet.
+- `runtime switch -c` creates a new branch first, then opens that branch's
+  workspace.
+- Each `repo + branch` maps to one dedicated computer.
+- The repo is cloned into `/home/ubuntu/<repo>` and new shells in that computer
+  start there automatically.
+- `runtime checkout ...` is an alias for `runtime switch ...`.
+
 Run the SDK unit tests through the backend project environment:
 
 ```bash

{runtime_sdk-0.4.17 → runtime_sdk-0.4.19}/README.md

@@ -4,6 +4,10 @@ Python SDK and CLI for Runtime.
 
 ## Install
 
+Supported host OS for the CLI: **macOS and Linux only**.
+
+Windows is **not supported** at this time.
+
 ```bash
 uv tool install runtime-sdk
 ```
@@ -40,8 +44,12 @@ runtime login --api-key rt_live_...
 runtime api-keys list
 runtime api-keys create "my laptop"
 runtime api-keys revoke 123
+runtime integrations connect github
 
 # Computers
+runtime switch --repo owner/repo feature/login      # open or create the branch workspace computer
+runtime switch -c feature/login --repo owner/repo   # create a new branch workspace from the repo default branch
+runtime checkout --repo owner/repo feature/login    # alias for switch
 runtime create                       # creates a computer with the starter app already published
 runtime create myapp --command "python3 app.py" --cwd /home/ubuntu --port 3000
 runtime enter <name-or-id>         # accepts slug/name like test, or the computer id
@@ -131,6 +139,28 @@ show|clear` expose that same durable app state directly. The low-level
 `runtime run` stays one-shot: the filesystem is restored after going cold, but
 that ad-hoc process is not.
 
+## GitHub branch workspaces
+
+`runtime switch` gives a repo branch its own Runtime computer so you can jump
+between parallel tasks without local worktrees.
+
+```bash
+runtime integrations connect github
+runtime switch --repo owner/repo feature/login
+runtime switch -c feature/search --repo owner/repo --from main
+```
+
+Rules:
+- GitHub must already be connected with `runtime integrations connect github`.
+- `runtime switch` opens an existing branch workspace, or creates the computer if
+  the branch exists but the workspace does not yet.
+- `runtime switch -c` creates a new branch first, then opens that branch's
+  workspace.
+- Each `repo + branch` maps to one dedicated computer.
+- The repo is cloned into `/home/ubuntu/<repo>` and new shells in that computer
+  start there automatically.
+- `runtime checkout ...` is an alias for `runtime switch ...`.
+
 Run the SDK unit tests through the backend project environment:
 
 ```bash

{runtime_sdk-0.4.17 → runtime_sdk-0.4.19}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runtime-sdk"
-version = "0.4.17"
+version = "0.4.19"
 description = "Runtime Python SDK and CLI"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -17,6 +17,9 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3 :: Only",
     "Environment :: Console",
+    "Operating System :: MacOS :: MacOS X",
+    "Operating System :: POSIX",
+    "Operating System :: POSIX :: Linux",
 ]
 
 [project.urls]

{runtime_sdk-0.4.17 → runtime_sdk-0.4.19}/scripts/runtime_sdk/cli.py

@@ -5,6 +5,7 @@ import contextlib
 import importlib
 import json
 import os
+import re
 import select
 import shlex
 import shutil
@@ -195,6 +196,16 @@ def build_parser() -> argparse.ArgumentParser:
     integrations_connect.add_argument("--owner", default=None, help="GitHub username or org where the app is installed")
     integrations_connect.add_argument("--no-open", action="store_true", help="Print the install URL instead of opening a browser")
 
+    switch_cmd = subparsers.add_parser(
+        "switch",
+        aliases=["checkout"],
+        help="Open a GitHub branch workspace in its own computer",
+    )
+    switch_cmd.add_argument("branch", nargs="?", default=None, help="Git branch to open")
+    switch_cmd.add_argument("--repo", default=None, help="GitHub repository in owner/name format")
+    switch_cmd.add_argument("-c", "--create", action="store_true", help="Create a new branch before opening it")
+    switch_cmd.add_argument("--from", dest="base_branch", default=None, help="Base branch for -c (defaults to the repo default branch)")
+
     create_cmd = subparsers.add_parser("create", help="Create a new computer with the starter app published by default")
     create_cmd.add_argument(
         "name",
@@ -281,10 +292,18 @@ def build_parser() -> argparse.ArgumentParser:
     return parser
 
 
+def _windows_unsupported() -> bool:
+    return sys.platform == "win32"
+
+
+
 def main(argv: list[str] | None = None) -> int:
     parser = build_parser()
     args = parser.parse_args(argv)
 
+    if _windows_unsupported():
+        return report_error("runtime-sdk supports macOS and Linux only; Windows is not supported")
+
     try:
         config = load_config()
         if args.base_url:
@@ -335,6 +354,14 @@ def main(argv: list[str] | None = None) -> int:
             if args.integrations_action == "connect":
                 return handle_integrations_connect(config, args.provider, args.slug, args.owner, no_open=args.no_open)
             return report_error("unknown integrations command")
+        if args.command in ("switch", "checkout"):
+            return handle_switch(
+                config,
+                getattr(args, "repo", None),
+                getattr(args, "branch", None),
+                create_branch=getattr(args, "create", False),
+                base_branch=getattr(args, "base_branch", None),
+            )
         if args.command == "create":
             return handle_create(
                 config,
@@ -756,6 +783,48 @@ def _resolve_computer_ref(client: RuntimeClient, ref: str) -> str:
 
 
 
+def _coerce_github_repo(repo: str | None) -> str | None:
+    text = str(repo or "").strip()
+    if not text:
+        return None
+    if not re.fullmatch(r"[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+", text):
+        raise RuntimeAPIError("repo must be in owner/name format")
+    owner, name = text.split("/", 1)
+    return f"{owner}/{name}"
+
+
+
+def _coerce_git_branch(branch: str | None) -> str | None:
+    text = str(branch or "").strip()
+    if not text:
+        return None
+    if text == "@":
+        raise RuntimeAPIError("branch name is invalid")
+    if text.startswith("-") or text.endswith("/") or text.endswith(".") or text.endswith(".lock"):
+        raise RuntimeAPIError("branch name is invalid")
+    if ".." in text or "//" in text or "@{" in text:
+        raise RuntimeAPIError("branch name is invalid")
+    if any(ch in text for ch in (" ", "~", "^", ":", "?", "*", "[", "\\")):
+        raise RuntimeAPIError("branch name is invalid")
+    if any(ord(ch) < 32 or ord(ch) == 127 for ch in text):
+        raise RuntimeAPIError("branch name is invalid")
+    return text
+
+
+
+def _render_branch_workspace(payload: dict[str, Any]) -> None:
+    computer = payload.get("computer") or {}
+    repo = str(payload.get("repo") or "")
+    branch = str(payload.get("branch") or "")
+    action = "created branch" if payload.get("create_branch") else "opened branch"
+    _render_computer_panel(computer, title="workspace")
+    _UI.console().print(f"[green]✓[/green] {action} [bold]{repo}#{branch}[/bold]")
+    url = computer.get("public_url")
+    if url:
+        _UI.console().print(f"[bold green]→[/bold green] [cyan]{url}[/cyan]")
+
+
+
 def _computer_name(c: dict[str, Any]) -> str:
     return str(c.get("slug") or c.get("id") or "?")
 
@@ -1678,6 +1747,74 @@ def handle_integrations_connect(
 
 
 
+def handle_switch(
+    config: RuntimeConfig,
+    repo: str | None,
+    branch: str | None,
+    *,
+    create_branch: bool = False,
+    base_branch: str | None = None,
+) -> int:
+    if (err := _require_api_key(config)) is not None:
+        return err
+    if base_branch is not None and not create_branch:
+        return report_error("--from can only be used together with -c")
+
+    try:
+        resolved_repo = _coerce_github_repo(repo)
+        resolved_branch = _coerce_git_branch(branch)
+    except RuntimeAPIError as exc:
+        return report_error(str(exc), status_code=exc.status_code)
+
+    if resolved_repo is None:
+        if not _interactive():
+            return report_error("--repo is required")
+        resolved_repo = _prompt_text("GitHub repo (owner/name)")
+        try:
+            resolved_repo = _coerce_github_repo(resolved_repo)
+        except RuntimeAPIError as exc:
+            return report_error(str(exc), status_code=exc.status_code)
+        if resolved_repo is None:
+            return report_error("repo is required")
+
+    if resolved_branch is None:
+        if not _interactive():
+            return report_error("branch is required")
+        prompt = "New branch name" if create_branch else "Branch name"
+        resolved_branch = _prompt_text(prompt)
+        try:
+            resolved_branch = _coerce_git_branch(resolved_branch)
+        except RuntimeAPIError as exc:
+            return report_error(str(exc), status_code=exc.status_code)
+        if resolved_branch is None:
+            return report_error("branch is required")
+
+    client = RuntimeClient(base_url=config.base_url, api_key=config.api_key)
+    try:
+        payload = _with_spinner(
+            "opening branch workspace…",
+            lambda: client.switch_workspace(
+                repo=resolved_repo,
+                branch=resolved_branch,
+                create=create_branch,
+                base_branch=base_branch,
+            ),
+        )
+    except RuntimeAPIError as exc:
+        return report_error(str(exc), status_code=exc.status_code)
+
+    computer = payload.get("computer") or {}
+    computer_id = str(computer.get("id") or "").strip()
+    if not computer_id:
+        return report_error("server did not return a computer id")
+
+    code = report_success(payload, _render_branch_workspace)
+    if code != 0 or not _interactive():
+        return code
+    return _enter_computer(config, computer_id)
+
+
+
 def handle_onboarding(config: RuntimeConfig) -> int:
     code = handle_login(config, None, None, None)
     if code != 0:

{runtime_sdk-0.4.17 → runtime_sdk-0.4.19}/scripts/runtime_sdk/client.py

@@ -96,6 +96,25 @@ class RuntimeClient:
 
     # --- Computers ---
 
+    def switch_workspace(
+        self,
+        *,
+        repo: str,
+        branch: str,
+        create: bool = False,
+        base_branch: str | None = None,
+    ) -> dict[str, Any]:
+        body: dict[str, Any] = {"repo": repo, "branch": branch, "create": create}
+        if base_branch is not None:
+            body["from"] = base_branch
+        return self._request(
+            "POST",
+            "/api/workspaces/switch",
+            json=body,
+            auth_required=True,
+            timeout=max(self.timeout, DEFAULT_WARMUP_TIMEOUT),
+        )
+
     def create_computer(
         self,
         *,

{runtime_sdk-0.4.17 → runtime_sdk-0.4.19}/scripts/runtime_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtime-sdk
-Version: 0.4.17
+Version: 0.4.19
 Summary: Runtime Python SDK and CLI
 Project-URL: Repository, https://github.com/The-Money-Company-Limited/runtimevm
 Project-URL: Issues, https://github.com/The-Money-Company-Limited/runtimevm/issues
@@ -10,6 +10,9 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Environment :: Console
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: POSIX :: Linux
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 Requires-Dist: httpx>=0.28.1
@@ -23,6 +26,10 @@ Python SDK and CLI for Runtime.
 
 ## Install
 
+Supported host OS for the CLI: **macOS and Linux only**.
+
+Windows is **not supported** at this time.
+
 ```bash
 uv tool install runtime-sdk
 ```
@@ -59,8 +66,12 @@ runtime login --api-key rt_live_...
 runtime api-keys list
 runtime api-keys create "my laptop"
 runtime api-keys revoke 123
+runtime integrations connect github
 
 # Computers
+runtime switch --repo owner/repo feature/login      # open or create the branch workspace computer
+runtime switch -c feature/login --repo owner/repo   # create a new branch workspace from the repo default branch
+runtime checkout --repo owner/repo feature/login    # alias for switch
 runtime create                       # creates a computer with the starter app already published
 runtime create myapp --command "python3 app.py" --cwd /home/ubuntu --port 3000
 runtime enter <name-or-id>         # accepts slug/name like test, or the computer id
@@ -150,6 +161,28 @@ show|clear` expose that same durable app state directly. The low-level
 `runtime run` stays one-shot: the filesystem is restored after going cold, but
 that ad-hoc process is not.
 
+## GitHub branch workspaces
+
+`runtime switch` gives a repo branch its own Runtime computer so you can jump
+between parallel tasks without local worktrees.
+
+```bash
+runtime integrations connect github
+runtime switch --repo owner/repo feature/login
+runtime switch -c feature/search --repo owner/repo --from main
+```
+
+Rules:
+- GitHub must already be connected with `runtime integrations connect github`.
+- `runtime switch` opens an existing branch workspace, or creates the computer if
+  the branch exists but the workspace does not yet.
+- `runtime switch -c` creates a new branch first, then opens that branch's
+  workspace.
+- Each `repo + branch` maps to one dedicated computer.
+- The repo is cloned into `/home/ubuntu/<repo>` and new shells in that computer
+  start there automatically.
+- `runtime checkout ...` is an alias for `runtime switch ...`.
+
 Run the SDK unit tests through the backend project environment:
 
 ```bash