runtime-sdk 0.4.12__tar.gz → 0.4.14__tar.gz

{runtime_sdk-0.4.12 → runtime_sdk-0.4.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtime-sdk
-Version: 0.4.12
+Version: 0.4.14
 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.
@@ -47,6 +49,8 @@ Or pass `--base-url` per command.
 
 ```bash
 # Auth
+runtime                          # first run in a real terminal prompts for email + verification code, then creates your first computer
+runtime login                    # interactive email + verification code flow
 runtime login you@example.com
 runtime verify 123456
 runtime whoami

{runtime_sdk-0.4.12 → runtime_sdk-0.4.14}/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.
@@ -28,6 +30,8 @@ Or pass `--base-url` per command.
 
 ```bash
 # Auth
+runtime                          # first run in a real terminal prompts for email + verification code, then creates your first computer
+runtime login                    # interactive email + verification code flow
 runtime login you@example.com
 runtime verify 123456
 runtime whoami

{runtime_sdk-0.4.12 → runtime_sdk-0.4.14}/pyproject.toml

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

{runtime_sdk-0.4.12 → runtime_sdk-0.4.14}/scripts/runtime_sdk/cli.py

@@ -132,7 +132,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`.
@@ -263,20 +263,21 @@ def main(argv: list[str] | None = None) -> int:
     parser = build_parser()
     args = parser.parse_args(argv)
 
-    # Bare `runtime` → create flow.
-    if args.command is None:
-        args.command = "create"
-        args.name = None
-
     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:
+            if _interactive() and not config.api_key:
+                return handle_onboarding(config)
+            args.command = "create"
+            args.name = None
 
         if args.command == "signup":
             return handle_signup(config, args.email, args.name)
@@ -1181,14 +1182,7 @@ def _looks_like_api_key(value: str | None) -> bool:
     return candidate.startswith("rt_live_")
 
 
-def _start_verification_flow(config: RuntimeConfig, email: str | None, name: str | None) -> int:
-    if email is None:
-        if not _interactive():
-            return report_error("email is required")
-        email = _prompt_text("Email")
-        if not email:
-            return report_error("email is required")
-
+def _begin_verification_flow(config: RuntimeConfig, email: str, name: str | None) -> dict[str, Any]:
     client = RuntimeClient(base_url=config.base_url)
     result = client.start_verification(email, name)
     config.pending_signup = PendingSignup(
@@ -1197,6 +1191,19 @@ def _start_verification_flow(config: RuntimeConfig, email: str | None, name: str
         expires_at=result.get("expires_at"),
     )
     save_config(config)
+    return result
+
+
+
+def _start_verification_flow(config: RuntimeConfig, email: str | None, name: str | None) -> int:
+    if email is None:
+        if not _interactive():
+            return report_error("email is required")
+        email = _prompt_text("Email")
+        if not email:
+            return report_error("email is required")
+
+    result = _begin_verification_flow(config, email, name)
 
     def render(payload: dict[str, Any]) -> None:
         _UI.console().print(
@@ -1209,6 +1216,33 @@ def _start_verification_flow(config: RuntimeConfig, email: str | None, name: str
     return report_success(result, render)
 
 
+
+def _interactive_email_auth_flow(config: RuntimeConfig, email: str | None, name: str | None) -> int:
+    pending = config.pending_signup
+    if email is None and pending is not None and pending.email:
+        _UI.console().print(
+            f"[green]✓[/green] verification code already sent to [bold]{pending.email}[/bold]"
+        )
+        code = _prompt_text("Verification code")
+        if not code:
+            return report_error("verification code is required")
+        return handle_verify(config, code, pending.flow_id)
+
+    if email is None:
+        email = _prompt_text("Email")
+        if not email:
+            return report_error("email is required")
+
+    _begin_verification_flow(config, email, name)
+    _UI.console().print(
+        f"[green]✓[/green] verification code sent to [bold]{email}[/bold]"
+    )
+    code = _prompt_text("Verification code")
+    if not code:
+        return report_error("verification code is required")
+    return handle_verify(config, code, None)
+
+
 def _login_with_api_key(config: RuntimeConfig, api_key: str | None) -> int:
     if api_key is None or api_key == "":
         if not _interactive():
@@ -1235,6 +1269,8 @@ def _login_with_api_key(config: RuntimeConfig, api_key: str | None) -> int:
 
 
 def handle_signup(config: RuntimeConfig, email: str | None, name: str | None) -> int:
+    if _interactive():
+        return _interactive_email_auth_flow(config, email, name)
     return _start_verification_flow(config, email, name)
 
 
@@ -1284,6 +1320,8 @@ def handle_login(
     if _looks_like_api_key(identifier):
         return _login_with_api_key(config, identifier)
 
+    if _interactive():
+        return _interactive_email_auth_flow(config, identifier, name)
     return _start_verification_flow(config, identifier, name)
 
 
@@ -1369,6 +1407,14 @@ def handle_api_keys_revoke(config: RuntimeConfig, key_id: str | None) -> int:
 
 
 
+def handle_onboarding(config: RuntimeConfig) -> int:
+    code = handle_login(config, None, None, None)
+    if code != 0:
+        return code
+    return handle_create(config, None, None, None, None)
+
+
+
 def handle_create(
     config: RuntimeConfig,
     name: str | None,
@@ -2141,7 +2187,7 @@ def _strip_terminal_noise(text: str) -> str:
     filtered: list[str] = []
     for line in lines:
         stripped = line.rstrip("\r\n")
-        if stripped == "Running bootstrap command: export PS1='\\[\\033[1;34m\\]runtime@\\h\\[\\033[0m\\]:\\w\\$ '":
+        if stripped.startswith("Running bootstrap command: export PS1='\\[\\033[1;34m\\]runtime@"):
             continue
         if stripped == "Connected! Press Ctrl+] to exit.":
             continue

{runtime_sdk-0.4.12 → runtime_sdk-0.4.14}/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.12 → runtime_sdk-0.4.14}/scripts/runtime_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtime-sdk
-Version: 0.4.12
+Version: 0.4.14
 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.
@@ -47,6 +49,8 @@ Or pass `--base-url` per command.
 
 ```bash
 # Auth
+runtime                          # first run in a real terminal prompts for email + verification code, then creates your first computer
+runtime login                    # interactive email + verification code flow
 runtime login you@example.com
 runtime verify 123456
 runtime whoami