runtime-sdk 0.4.13__tar.gz → 0.4.15__tar.gz

{runtime_sdk-0.4.13 → runtime_sdk-0.4.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtime-sdk
-Version: 0.4.13
+Version: 0.4.15
 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
@@ -35,10 +35,12 @@ uv tool upgrade runtime-sdk
 
 ## Configure
 
-The CLI talks to `http://127.0.0.1:8080` by default. Override it with:
+The CLI talks to `https://api.runruntime.dev` by default.
+
+For local or self-hosted Runtime, override it with:
 
 ```bash
-export RUNTIME_BASE_URL=https://api.runruntime.dev
+export RUNTIME_BASE_URL=http://127.0.0.1:8080
 ```
 
 Or pass `--base-url` per command.

{runtime_sdk-0.4.13 → runtime_sdk-0.4.15}/README.md

@@ -16,10 +16,12 @@ uv tool upgrade runtime-sdk
 
 ## Configure
 
-The CLI talks to `http://127.0.0.1:8080` by default. Override it with:
+The CLI talks to `https://api.runruntime.dev` by default.
+
+For local or self-hosted Runtime, override it with:
 
 ```bash
-export RUNTIME_BASE_URL=https://api.runruntime.dev
+export RUNTIME_BASE_URL=http://127.0.0.1:8080
 ```
 
 Or pass `--base-url` per command.

{runtime_sdk-0.4.13 → runtime_sdk-0.4.15}/pyproject.toml

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

{runtime_sdk-0.4.13 → runtime_sdk-0.4.15}/scripts/runtime_sdk/cli.py

@@ -15,6 +15,7 @@ import termios
 import threading
 import time
 import tty
+import webbrowser
 from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any, Callable
@@ -132,7 +133,7 @@ class _UI:
 
 def build_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(prog="runtime")
-    parser.add_argument("--base-url", help="Runtime API base URL")
+    parser.add_argument("--base-url", help="Override the Runtime API base URL")
     parser.add_argument("--version", action="version", version=f"runtime-sdk {__version__}")
 
     # Subcommand is optional: bare `runtime` defaults to `create`.
@@ -173,6 +174,14 @@ def build_parser() -> argparse.ArgumentParser:
     api_keys_revoke = api_keys_subparsers.add_parser("revoke", help="Revoke an API key")
     api_keys_revoke.add_argument("id", nargs="?", default=None, help="API key id")
 
+    integrations_cmd = subparsers.add_parser("integrations", help="Connect account-level integrations")
+    integrations_subparsers = integrations_cmd.add_subparsers(dest="integrations_action", required=True)
+    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")
+
     create_cmd = subparsers.add_parser("create", help="Create a new computer with the starter app published by default")
     create_cmd.add_argument(
         "name",
@@ -265,13 +274,12 @@ def main(argv: list[str] | None = None) -> int:
 
     try:
         config = load_config()
-        base_url = (
-            args.base_url
-            or os.environ.get("RUNTIME_BASE_URL")
-            or config.base_url
-            or DEFAULT_BASE_URL
-        )
-        config.base_url = base_url
+        if args.base_url:
+            config.base_url = args.base_url
+        elif os.environ.get("RUNTIME_BASE_URL"):
+            config.base_url = str(os.environ.get("RUNTIME_BASE_URL"))
+        else:
+            config.base_url = config.configured_base_url or DEFAULT_BASE_URL
 
         # Bare `runtime` → first-run onboarding for interactive users, create otherwise.
         if args.command is None:
@@ -298,6 +306,10 @@ def main(argv: list[str] | None = None) -> int:
             if args.api_keys_action == "revoke":
                 return handle_api_keys_revoke(config, args.id)
             return report_error("unknown api-keys command")
+        if args.command == "integrations":
+            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 == "create":
             return handle_create(
                 config,
@@ -1408,6 +1420,68 @@ def handle_api_keys_revoke(config: RuntimeConfig, key_id: str | None) -> int:
 
 
 
+def handle_integrations_connect(
+    config: RuntimeConfig,
+    provider: str,
+    slug: str | None,
+    owner: str | None,
+    *,
+    no_open: bool = False,
+) -> int:
+    if (err := _require_api_key(config)) is not None:
+        return err
+    if provider != "github":
+        return report_error(f"unsupported integration provider: {provider}")
+
+    client = RuntimeClient(base_url=config.base_url, api_key=config.api_key)
+    payload = _with_spinner("getting GitHub install link…", lambda: client.start_github_connect(slug=slug))
+    install_url = str(payload.get("install_url") or "").strip()
+    resolved_slug = str(payload.get("slug") or slug or "github").strip() or "github"
+    if not install_url:
+        return report_error("server did not return a GitHub install URL")
+
+    opened = False
+    if not no_open:
+        with contextlib.suppress(Exception):
+            opened = bool(webbrowser.open(install_url))
+
+    if _interactive():
+        action = "opened in your browser" if opened else "copy this URL into your browser"
+        _UI.console().print(f"[cyan]→[/cyan] {action}: [link={install_url}]{install_url}[/link]")
+        _UI.console().print("[dim]Install the RuntimeVM GitHub App, then come back here.[/dim]")
+        input("Press Enter after the GitHub App is installed... ")
+        if not owner:
+            owner = _prompt_text("GitHub owner (username or org)")
+    elif not owner:
+        return report_error("--owner is required without a TTY")
+
+    resolved_owner = str(owner or "").strip()
+    if not resolved_owner:
+        return report_error("GitHub owner is required")
+
+    integration = _with_spinner(
+        "connecting GitHub…",
+        lambda: client.create_integration(
+            slug=resolved_slug,
+            provider="github",
+            transport="scoped_credential",
+            backend="native",
+            credential_source="external_account",
+            credential_ref=resolved_owner,
+            config={},
+        ),
+    )
+
+    def render(result: dict[str, Any]) -> None:
+        connected = result.get("integration") or {}
+        _UI.console().print(
+            f"[green]✓[/green] connected [bold]{connected.get('slug', resolved_slug)}[/bold] → [bold]{connected.get('credential_ref', resolved_owner)}[/bold]"
+        )
+
+    return report_success({"integration": integration, "install_url": install_url}, render)
+
+
+
 def handle_onboarding(config: RuntimeConfig) -> int:
     code = handle_login(config, None, None, None)
     if code != 0:

{runtime_sdk-0.4.13 → runtime_sdk-0.4.15}/scripts/runtime_sdk/client.py

@@ -52,6 +52,36 @@ class RuntimeClient:
     def revoke_api_key(self, key_id: int) -> dict[str, Any]:
         return self._request("POST", f"/api/api-keys/{key_id}/revoke", auth_required=True)
 
+    # --- Integrations ---
+
+    def start_github_connect(self, *, slug: str | None = None) -> dict[str, Any]:
+        body: dict[str, Any] = {}
+        if slug:
+            body["slug"] = slug
+        return self._request("POST", "/api/integrations/github/connect", json=body, auth_required=True)
+
+    def create_integration(
+        self,
+        *,
+        slug: str,
+        provider: str,
+        transport: str,
+        backend: str,
+        credential_source: str,
+        credential_ref: str,
+        config: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        body: dict[str, Any] = {
+            "slug": slug,
+            "provider": provider,
+            "transport": transport,
+            "backend": backend,
+            "credential_source": credential_source,
+            "credential_ref": credential_ref,
+            "config": config or {},
+        }
+        return self._request("POST", "/api/integrations", json=body, auth_required=True)
+
     # --- Computers ---
 
     def create_computer(

{runtime_sdk-0.4.13 → runtime_sdk-0.4.15}/scripts/runtime_sdk/config.py

@@ -6,7 +6,7 @@ from dataclasses import asdict, dataclass
 from pathlib import Path
 
 
-DEFAULT_BASE_URL = "http://127.0.0.1:8080"
+DEFAULT_BASE_URL = "https://api.runruntime.dev"
 
 
 class RuntimeConfigError(RuntimeError):
@@ -23,6 +23,7 @@ class PendingSignup:
 @dataclass(slots=True)
 class RuntimeConfig:
     base_url: str = DEFAULT_BASE_URL
+    configured_base_url: str | None = None
     api_key: str | None = None
     pending_signup: PendingSignup | None = None
 
@@ -37,7 +38,7 @@ def config_path() -> Path:
 def load_config() -> RuntimeConfig:
     path = config_path()
     if not path.exists():
-        return RuntimeConfig(base_url=os.environ.get("RUNTIME_BASE_URL", DEFAULT_BASE_URL))
+        return RuntimeConfig()
 
     try:
         data = json.loads(path.read_text())
@@ -48,9 +49,11 @@ def load_config() -> RuntimeConfig:
     if not isinstance(data, dict):
         raise RuntimeConfigError("config file must contain a JSON object")
     pending = data.get("pending_signup")
+    configured_base_url = data.get("base_url") or None
     try:
         return RuntimeConfig(
-            base_url=data.get("base_url") or os.environ.get("RUNTIME_BASE_URL", DEFAULT_BASE_URL),
+            base_url=configured_base_url or DEFAULT_BASE_URL,
+            configured_base_url=configured_base_url,
             api_key=data.get("api_key"),
             pending_signup=PendingSignup(**pending) if pending else None,
         )
@@ -60,7 +63,13 @@ def load_config() -> RuntimeConfig:
 
 def save_config(config: RuntimeConfig) -> None:
     path = config_path()
-    payload = asdict(config)
+    configured_base_url = config.configured_base_url
+    payload = {
+        "api_key": config.api_key,
+        "pending_signup": asdict(config.pending_signup) if config.pending_signup else None,
+    }
+    if configured_base_url is not None:
+        payload["base_url"] = configured_base_url
     try:
         path.parent.mkdir(parents=True, exist_ok=True, mode=0o700)
         path.write_text(json.dumps(payload, indent=2) + "\n")

{runtime_sdk-0.4.13 → runtime_sdk-0.4.15}/scripts/runtime_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtime-sdk
-Version: 0.4.13
+Version: 0.4.15
 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
@@ -35,10 +35,12 @@ uv tool upgrade runtime-sdk
 
 ## Configure
 
-The CLI talks to `http://127.0.0.1:8080` by default. Override it with:
+The CLI talks to `https://api.runruntime.dev` by default.
+
+For local or self-hosted Runtime, override it with:
 
 ```bash
-export RUNTIME_BASE_URL=https://api.runruntime.dev
+export RUNTIME_BASE_URL=http://127.0.0.1:8080
 ```
 
 Or pass `--base-url` per command.