runtime-sdk 0.4.18__tar.gz → 0.4.20__tar.gz

{runtime_sdk-0.4.18 → runtime_sdk-0.4.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtime-sdk
-Version: 0.4.18
+Version: 0.4.20
 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
@@ -66,8 +66,13 @@ runtime login --api-key rt_live_...
 runtime api-keys list
 runtime api-keys create "my laptop"
 runtime api-keys revoke 123
+runtime integrations list
+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
@@ -157,6 +162,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.18 → runtime_sdk-0.4.20}/README.md

@@ -44,8 +44,13 @@ runtime login --api-key rt_live_...
 runtime api-keys list
 runtime api-keys create "my laptop"
 runtime api-keys revoke 123
+runtime integrations list
+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
@@ -135,6 +140,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.18 → runtime_sdk-0.4.20}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runtime-sdk"
-version = "0.4.18"
+version = "0.4.20"
 description = "Runtime Python SDK and CLI"
 readme = "README.md"
 requires-python = ">=3.11"

{runtime_sdk-0.4.18 → runtime_sdk-0.4.20}/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
@@ -189,12 +190,23 @@ def build_parser() -> argparse.ArgumentParser:
 
     integrations_cmd = subparsers.add_parser("integrations", help="Connect account-level integrations")
     integrations_subparsers = integrations_cmd.add_subparsers(dest="integrations_action", required=True)
+    integrations_subparsers.add_parser("list", aliases=["ls"], help="List integrations")
     integrations_connect = integrations_subparsers.add_parser("connect", help="Connect an integration")
     integrations_connect.add_argument("provider", choices=["github"])
     integrations_connect.add_argument("--slug", default="github", help="Integration slug to create (default: github)")
     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",
@@ -340,9 +352,19 @@ def main(argv: list[str] | None = None) -> int:
                 return handle_secrets_delete(config, args.slug)
             return report_error("unknown secrets command")
         if args.command == "integrations":
+            if args.integrations_action in ("list", "ls"):
+                return handle_integrations_list(config)
             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,
@@ -764,6 +786,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 "?")
 
@@ -1492,6 +1556,35 @@ def handle_api_keys_revoke(config: RuntimeConfig, key_id: str | None) -> int:
 
 
 
+def _render_integrations_table(payload: dict[str, Any]) -> None:
+    mods = _UI.rich()
+    Table = mods["Table"]
+    integrations = payload.get("integrations") or []
+    if not isinstance(integrations, list) or not integrations:
+        _UI.console().print("[yellow]no integrations found[/yellow]")
+        return
+
+    table = Table(title="Integrations", expand=True, box=mods["box"].SIMPLE_HEAVY)
+    table.add_column("Slug", style="bold white")
+    table.add_column("Provider", style="white")
+    table.add_column("Owner", style="white")
+    table.add_column("Transport", style="white")
+    table.add_column("Backend", style="white")
+
+    for entry in integrations:
+        if not isinstance(entry, dict):
+            continue
+        table.add_row(
+            str(entry.get("slug") or "—"),
+            str(entry.get("provider") or "—"),
+            str(entry.get("credential_ref") or "—"),
+            str(entry.get("transport") or "—"),
+            str(entry.get("backend") or "—"),
+        )
+    _UI.console().print(table)
+
+
+
 def _coerce_secret_set_slug(slug: str | None) -> str | None:
     value = str(slug or "").strip()
     return value or None
@@ -1624,6 +1717,14 @@ def handle_secrets_delete(config: RuntimeConfig, slug: str | None) -> int:
 
 
 
+def handle_integrations_list(config: RuntimeConfig) -> int:
+    if (err := _require_api_key(config)) is not None:
+        return err
+    client = RuntimeClient(base_url=config.base_url, api_key=config.api_key)
+    return report_success(client.list_integrations(), _render_integrations_table)
+
+
+
 def handle_integrations_connect(
     config: RuntimeConfig,
     provider: str,
@@ -1686,6 +1787,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.18 → runtime_sdk-0.4.20}/scripts/runtime_sdk/client.py

@@ -54,6 +54,9 @@ class RuntimeClient:
 
     # --- Integrations ---
 
+    def list_integrations(self) -> dict[str, Any]:
+        return self._request("GET", "/api/integrations", auth_required=True)
+
     def start_github_connect(self, *, slug: str | None = None) -> dict[str, Any]:
         body: dict[str, Any] = {}
         if slug:
@@ -96,6 +99,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.18 → runtime_sdk-0.4.20}/scripts/runtime_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtime-sdk
-Version: 0.4.18
+Version: 0.4.20
 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
@@ -66,8 +66,13 @@ runtime login --api-key rt_live_...
 runtime api-keys list
 runtime api-keys create "my laptop"
 runtime api-keys revoke 123
+runtime integrations list
+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
@@ -157,6 +162,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