runtime-sdk 0.4.35__tar.gz → 0.4.37__tar.gz

{runtime_sdk-0.4.35 → runtime_sdk-0.4.37}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtime-sdk
-Version: 0.4.35
+Version: 0.4.37
 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
@@ -76,7 +76,9 @@ runtime switch -c feature/login --repo owner/repo   # create a new branch worksp
 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
+runtime enter <name-or-id>         # open an interactive shell; accepts slug/name or computer id
+runtime enter <name-or-id> -- claude   # open a real TTY and run an interactive command
+runtime enter <name-or-id> -- python   # use enter for REPLs, agents, prompts, and full-screen apps
 runtime list
 runtime info <id>
 runtime share public <id>
@@ -86,6 +88,7 @@ runtime run <id> "echo hello"      # one-shot foreground command only
 runtime run <id> "apt install -y nodejs" --uid 0
 runtime exec <id> -- bash -lc 'for i in 1 2 3; do echo $i; sleep 1; done'
 printf 'hello' | runtime exec <id> --stdin -- cat
+# Use runtime exec for automation and exact exit codes; use runtime enter -- <cmd> for interactive TTY commands.
 runtime files ls <id> /home/ubuntu
 runtime files read <id> /home/ubuntu/app.py --output app.py
 runtime files write <id> /home/ubuntu/app.py --input app.py --mode 0644

{runtime_sdk-0.4.35 → runtime_sdk-0.4.37}/README.md

@@ -54,7 +54,9 @@ runtime switch -c feature/login --repo owner/repo   # create a new branch worksp
 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
+runtime enter <name-or-id>         # open an interactive shell; accepts slug/name or computer id
+runtime enter <name-or-id> -- claude   # open a real TTY and run an interactive command
+runtime enter <name-or-id> -- python   # use enter for REPLs, agents, prompts, and full-screen apps
 runtime list
 runtime info <id>
 runtime share public <id>
@@ -64,6 +66,7 @@ runtime run <id> "echo hello"      # one-shot foreground command only
 runtime run <id> "apt install -y nodejs" --uid 0
 runtime exec <id> -- bash -lc 'for i in 1 2 3; do echo $i; sleep 1; done'
 printf 'hello' | runtime exec <id> --stdin -- cat
+# Use runtime exec for automation and exact exit codes; use runtime enter -- <cmd> for interactive TTY commands.
 runtime files ls <id> /home/ubuntu
 runtime files read <id> /home/ubuntu/app.py --output app.py
 runtime files write <id> /home/ubuntu/app.py --input app.py --mode 0644

{runtime_sdk-0.4.35 → runtime_sdk-0.4.37}/pyproject.toml

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

{runtime_sdk-0.4.35 → runtime_sdk-0.4.37}/scripts/runtime_sdk/cli.py

@@ -189,9 +189,11 @@ def build_parser() -> argparse.ArgumentParser:
     secrets_set = secrets_subparsers.add_parser("set", help="Create or replace a secret set from KEY=VALUE pairs")
     secrets_set.add_argument("slug", nargs="?", default=None, help="Secret set slug")
     secrets_set.add_argument("pairs", nargs="*", help="KEY=VALUE pairs")
+    secrets_set.add_argument("--proxy", action="append", default=[], metavar="KEY=HOST", help="Deliver KEY through the egress proxy and inject it only for HOST")
     secrets_import = secrets_subparsers.add_parser("import", help="Create or replace a secret set from a .env file")
     secrets_import.add_argument("slug", nargs="?", default=None, help="Secret set slug")
     secrets_import.add_argument("--env-file", required=True, help="Path to .env file")
+    secrets_import.add_argument("--proxy", action="append", default=[], metavar="KEY=HOST", help="Deliver KEY through the egress proxy and inject it only for HOST")
     secrets_delete = secrets_subparsers.add_parser("delete", aliases=["rm"], help="Delete a secret set")
     secrets_delete.add_argument("slug", nargs="?", default=None, help="Secret set slug")
 
@@ -238,8 +240,13 @@ def build_parser() -> argparse.ArgumentParser:
         help="Re-render the table every N seconds (default 2)",
     )
 
-    enter_cmd = subparsers.add_parser("enter", help="Enter a computer's console")
+    enter_cmd = subparsers.add_parser(
+        "enter",
+        help="Enter a computer's console",
+        epilog="Use `runtime exec` for exact exit codes; use `runtime enter <id> -- <cmd>` for interactive TTY commands.",
+    )
     enter_cmd.add_argument("id", nargs="?", default=None, help="Computer ID (hostname)")
+    enter_cmd.add_argument("enter_command", nargs="*", help="Command to run in the interactive terminal")
 
     info_cmd = subparsers.add_parser("info", help="Get computer details")
     info_cmd.add_argument("id", nargs="?", default=None, help="Computer ID (hostname)")
@@ -408,7 +415,7 @@ _HELP_SECTIONS: tuple[tuple[str, tuple[tuple[str, str], ...]], ...] = (
             ("info [id]", "Show computer details"),
             ("url [id]", "Show a computer's public URL and live published port"),
             ("start [id]", "Wake a cold computer"),
-            ("enter [id]", "Enter a computer's console (TTY)"),
+            ("enter [id] [-- <cmd>]", "Enter a computer's console or interactive TTY command"),
             ("run [id] <cmd>", "Run a one-shot command"),
             ("exec [id] -- <cmd>", "Stream stdout/stderr and optionally pipe stdin"),
             ("publish [id] <port> -- <cmd>", "Run and publish a durable service command"),
@@ -529,13 +536,17 @@ def _windows_unsupported() -> bool:
 
 
 def main(argv: list[str] | None = None) -> int:
+    raw_argv = list(sys.argv[1:] if argv is None else argv)
     parser = build_parser()
-    args = parser.parse_args(argv)
+    args = parser.parse_args(raw_argv)
 
     if _windows_unsupported():
         return report_error("runtime-sdk supports macOS and Linux only; Windows is not supported")
 
     try:
+        if args.command == "enter" and args.enter_command and "--" not in raw_argv:
+            return report_error("enter command must be separated from the computer id with --")
+
         config = load_config()
         if args.base_url:
             config.base_url = args.base_url
@@ -580,9 +591,9 @@ def main(argv: list[str] | None = None) -> int:
             if args.secrets_action == "show":
                 return handle_secrets_show(config, args.slug)
             if args.secrets_action == "set":
-                return handle_secrets_set(config, args.slug, args.pairs)
+                return handle_secrets_set(config, args.slug, args.pairs, args.proxy)
             if args.secrets_action == "import":
-                return handle_secrets_import(config, args.slug, args.env_file)
+                return handle_secrets_import(config, args.slug, args.env_file, args.proxy)
             if args.secrets_action in ("delete", "rm"):
                 return handle_secrets_delete(config, args.slug)
             return report_error("unknown secrets command")
@@ -621,7 +632,7 @@ def main(argv: list[str] | None = None) -> int:
         if args.command == "start":
             return handle_start(config, args.id)
         if args.command == "enter":
-            return handle_enter(config, args.id)
+            return handle_enter(config, args.id, args.enter_command)
         if args.command in ("delete", "rm"):
             return handle_delete(config, args.id, force=getattr(args, "force", False))
         if args.command == "run":
@@ -1591,7 +1602,15 @@ def _render_secret_set_panel(payload: dict[str, Any]) -> None:
     body.append(f"{'slug':<12}", style="dim")
     body.append(f"{payload.get('slug') or '—'}\n")
     body.append(f"{'keys':<12}", style="dim")
-    body.append(", ".join(str(key) for key in (payload.get("keys") or [])) or "—")
+    deliveries = payload.get("deliveries") or {}
+    lines = []
+    for key in payload.get("keys") or []:
+        meta = deliveries.get(str(key)) if isinstance(deliveries, dict) else None
+        if isinstance(meta, dict) and meta.get("delivery") == "proxy":
+            lines.append(f"{key} proxy {meta.get('target_host') or '—'}")
+        else:
+            lines.append(f"{key} env")
+    body.append("\n".join(lines) or "—")
     _UI.console().print(Panel(body, title="secret set", border_style="cyan", expand=False))
 
 
@@ -1880,6 +1899,26 @@ def _parse_secret_pairs(pairs: list[str] | None) -> dict[str, str]:
 
 
 
+def _parse_secret_delivery(proxy_specs: list[str] | None, values: dict[str, str]) -> dict[str, dict[str, str]]:
+    delivery: dict[str, dict[str, str]] = {}
+    for spec in proxy_specs or []:
+        if "=" not in spec:
+            raise RuntimeConfigError(f"invalid proxy delivery: {spec}")
+        key, host = spec.split("=", 1)
+        key = key.strip()
+        host = host.strip()
+        if not key or not host or key not in values:
+            raise RuntimeConfigError(f"invalid proxy delivery: {spec}")
+        delivery[key] = {
+            "delivery": "proxy",
+            "target_host": host,
+            "header": "Authorization",
+            "scheme": "Bearer",
+        }
+    return delivery
+
+
+
 def _parse_env_file(path: str) -> dict[str, str]:
     try:
         lines = Path(path).read_text(encoding="utf-8").splitlines()
@@ -1929,7 +1968,7 @@ def handle_secrets_show(config: RuntimeConfig, slug: str | None) -> int:
 
 
 
-def handle_secrets_set(config: RuntimeConfig, slug: str | None, pairs: list[str] | None) -> int:
+def handle_secrets_set(config: RuntimeConfig, slug: str | None, pairs: list[str] | None, proxy_specs: list[str] | None) -> int:
     if (err := _require_api_key(config)) is not None:
         return err
     resolved_slug = _coerce_secret_set_slug(slug)
@@ -1942,8 +1981,9 @@ def handle_secrets_set(config: RuntimeConfig, slug: str | None, pairs: list[str]
     values = _parse_secret_pairs(pairs)
     if not values:
         return report_error("at least one KEY=VALUE pair is required")
+    delivery = _parse_secret_delivery(proxy_specs, values)
     client = RuntimeClient(base_url=config.base_url, api_key=config.api_key)
-    secret_set = client.put_secret_set(resolved_slug, values)
+    secret_set = client.put_secret_set(resolved_slug, values, delivery)
     return report_success(
         {"secret_set": secret_set},
         lambda payload: _UI.console().print(f"[green]✓[/green] saved [bold]{payload['secret_set'].get('slug', resolved_slug)}[/bold]"),
@@ -1951,7 +1991,7 @@ def handle_secrets_set(config: RuntimeConfig, slug: str | None, pairs: list[str]
 
 
 
-def handle_secrets_import(config: RuntimeConfig, slug: str | None, env_file: str) -> int:
+def handle_secrets_import(config: RuntimeConfig, slug: str | None, env_file: str, proxy_specs: list[str] | None) -> int:
     if (err := _require_api_key(config)) is not None:
         return err
     resolved_slug = _coerce_secret_set_slug(slug)
@@ -1964,8 +2004,9 @@ def handle_secrets_import(config: RuntimeConfig, slug: str | None, env_file: str
     values = _parse_env_file(env_file)
     if not values:
         return report_error("env file did not contain any secrets")
+    delivery = _parse_secret_delivery(proxy_specs, values)
     client = RuntimeClient(base_url=config.base_url, api_key=config.api_key)
-    secret_set = client.put_secret_set(resolved_slug, values)
+    secret_set = client.put_secret_set(resolved_slug, values, delivery)
     return report_success(
         {"secret_set": secret_set},
         lambda payload: _UI.console().print(f"[green]✓[/green] saved [bold]{payload['secret_set'].get('slug', resolved_slug)}[/bold] from [bold]{env_file}[/bold]"),
@@ -2585,12 +2626,14 @@ def handle_start(config: RuntimeConfig, computer_id: str | None) -> int:
     return report_success(result, render)
 
 
-def handle_enter(config: RuntimeConfig, computer_id: str | None) -> int:
+def handle_enter(config: RuntimeConfig, computer_id: str | None, command_parts: list[str] | None = None) -> int:
     if (err := _require_api_key(config)) is not None:
         return err
     if not _interactive():
         return report_error("enter requires an interactive terminal")
 
+    command = _command_from_remainder(command_parts)
+
     if computer_id is None:
         picked = _pick_computer(
             config,
@@ -2605,6 +2648,8 @@ def handle_enter(config: RuntimeConfig, computer_id: str | None) -> int:
 
     client = RuntimeClient(base_url=config.base_url, api_key=config.api_key)
     computer_id = _resolve_computer_ref(client, str(computer_id))
+    if command:
+        return _enter_computer(config, str(computer_id), command=command)
     return _enter_computer(config, str(computer_id))
 
 
@@ -3190,7 +3235,7 @@ def _handle_proxy_client(base_url: str, api_key: str, computer_id: str, remote_p
             conn.close()
 
 
-def _enter_computer(config: RuntimeConfig, computer_id: str) -> int:
+def _enter_computer(config: RuntimeConfig, computer_id: str, *, command: str | None = None) -> int:
     client = RuntimeClient(base_url=config.base_url, api_key=config.api_key)
     ticket_payload = _with_spinner(
         f"preparing console for {computer_id}…",
@@ -3203,7 +3248,7 @@ def _enter_computer(config: RuntimeConfig, computer_id: str) -> int:
     _UI.console().print("[cyan]●[/cyan] Connecting to console...")
 
     try:
-        return _run_terminal_session(ws_url)
+        return _run_terminal_session(ws_url, bootstrap_command=command)
     except RuntimeAPIError as exc:
         return report_error(str(exc), status_code=exc.status_code)
     except (InvalidHandshake, TimeoutError, OSError) as exc:
@@ -3242,7 +3287,7 @@ def _parse_terminal_frame(raw: bytes) -> tuple[int, bytes]:
     return raw[0], raw[TERMINAL_FRAME_HEADER_SIZE:]
 
 
-def _run_terminal_session(ws_url: str) -> int:
+def _run_terminal_session(ws_url: str, *, bootstrap_command: str | None = None) -> int:
     if not sys.stdin.isatty() or not sys.stdout.isatty():
         return report_error("enter requires an interactive terminal")
 
@@ -3251,10 +3296,12 @@ def _run_terminal_session(ws_url: str) -> int:
     old_settings = termios_mod.tcgetattr(fd)
     stop = threading.Event()
     result: dict[str, Any] = {"code": 0, "error": None}
-    output_state: dict[str, Any] = {"buffer": "", "suppressing_preamble": True}
+    bootstrap_echo = f"exec {bootstrap_command.strip()}" if bootstrap_command and bootstrap_command.strip() else ""
+    output_state: dict[str, Any] = {"buffer": "", "suppressing_preamble": True, "bootstrap_echo": bootstrap_echo}
 
     with websocket_connect(ws_url, open_timeout=DEFAULT_WARMUP_TIMEOUT, close_timeout=1) as ws:
         _send_terminal_resize(ws)
+        _send_terminal_bootstrap(ws, bootstrap_command)
 
         def recv_loop() -> None:
             try:
@@ -3332,7 +3379,7 @@ def _filter_terminal_output(chunk: str, state: dict[str, Any]) -> str:
     if not chunk:
         return ""
     if not state.get("suppressing_preamble", False):
-        return _strip_terminal_noise(chunk)
+        return _strip_terminal_noise(chunk, str(state.get("bootstrap_echo") or ""))
 
     buffer = str(state.get("buffer") or "") + chunk
     marker = "\x1b[1;34mruntime@"
@@ -3340,9 +3387,9 @@ def _filter_terminal_output(chunk: str, state: dict[str, Any]) -> str:
     if idx != -1:
         state["suppressing_preamble"] = False
         state["buffer"] = ""
-        return _strip_terminal_noise(buffer[idx:])
+        return _strip_terminal_noise(buffer[idx:], str(state.get("bootstrap_echo") or ""))
 
-    cleaned = _strip_terminal_noise(buffer)
+    cleaned = _strip_terminal_noise(buffer, str(state.get("bootstrap_echo") or ""))
     if cleaned and _should_release_terminal_output(cleaned):
         state["suppressing_preamble"] = False
         state["buffer"] = ""
@@ -3351,7 +3398,7 @@ def _filter_terminal_output(chunk: str, state: dict[str, Any]) -> str:
     if len(buffer) > 8192:
         state["suppressing_preamble"] = False
         state["buffer"] = ""
-        return _strip_terminal_noise(buffer)
+        return _strip_terminal_noise(buffer, str(state.get("bootstrap_echo") or ""))
 
     state["buffer"] = buffer
     return ""
@@ -3374,10 +3421,13 @@ def _should_release_terminal_output(text: str) -> bool:
 def _flush_terminal_output(state: dict[str, Any]) -> str:
     buffer = str(state.get("buffer") or "")
     state["buffer"] = ""
-    return _strip_terminal_noise(buffer)
+    return _strip_terminal_noise(buffer, str(state.get("bootstrap_echo") or ""))
+
 
+ANSI_ESCAPE_RE = re.compile(r"\x1b\[[0-?]*[ -/]*[@-~]")
 
-def _strip_terminal_noise(text: str) -> str:
+
+def _strip_terminal_noise(text: str, bootstrap_echo: str = "") -> str:
     if not text:
         return ""
 
@@ -3395,10 +3445,27 @@ def _strip_terminal_noise(text: str) -> str:
             continue
         if stripped == "* Docs: https://docs.slicervm.com":
             continue
+        if _is_terminal_bootstrap_echo(stripped, bootstrap_echo):
+            continue
         filtered.append(line)
     return "".join(filtered)
 
 
+def _is_terminal_bootstrap_echo(line: str, bootstrap_echo: str) -> bool:
+    bootstrap_echo = bootstrap_echo.strip()
+    if not bootstrap_echo:
+        return False
+    clean = ANSI_ESCAPE_RE.sub("", line).strip()
+    return clean == bootstrap_echo or clean.endswith(bootstrap_echo)
+
+
+def _send_terminal_bootstrap(ws: Any, command: str | None) -> None:
+    command = (command or "").strip()
+    if not command:
+        return
+    ws.send(_encode_terminal_frame(TERMINAL_FRAME_DATA, f"exec {command}\n".encode()))
+
+
 def _send_terminal_resize(ws: Any) -> None:
     size = shutil.get_terminal_size((100, 24))
     ws.send(_encode_terminal_frame(TERMINAL_FRAME_WINDOW_SIZE, struct.pack(">II", size.columns, size.lines)))

{runtime_sdk-0.4.35 → runtime_sdk-0.4.37}/scripts/runtime_sdk/client.py

@@ -75,8 +75,11 @@ class RuntimeClient:
     def get_secret_set(self, slug: str) -> dict[str, Any]:
         return self._request("GET", f"/api/secrets/{slug}", auth_required=True)
 
-    def put_secret_set(self, slug: str, values: dict[str, str]) -> dict[str, Any]:
-        return self._request("PUT", f"/api/secrets/{slug}", json={"values": values}, auth_required=True)
+    def put_secret_set(self, slug: str, values: dict[str, str], delivery: dict[str, Any] | None = None) -> dict[str, Any]:
+        payload: dict[str, Any] = {"values": values}
+        if delivery:
+            payload["deliveries"] = delivery
+        return self._request("PUT", f"/api/secrets/{slug}", json=payload, auth_required=True)
 
     def delete_secret_set(self, slug: str) -> dict[str, Any]:
         return self._request("DELETE", f"/api/secrets/{slug}", auth_required=True)

{runtime_sdk-0.4.35 → runtime_sdk-0.4.37}/scripts/runtime_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtime-sdk
-Version: 0.4.35
+Version: 0.4.37
 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
@@ -76,7 +76,9 @@ runtime switch -c feature/login --repo owner/repo   # create a new branch worksp
 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
+runtime enter <name-or-id>         # open an interactive shell; accepts slug/name or computer id
+runtime enter <name-or-id> -- claude   # open a real TTY and run an interactive command
+runtime enter <name-or-id> -- python   # use enter for REPLs, agents, prompts, and full-screen apps
 runtime list
 runtime info <id>
 runtime share public <id>
@@ -86,6 +88,7 @@ runtime run <id> "echo hello"      # one-shot foreground command only
 runtime run <id> "apt install -y nodejs" --uid 0
 runtime exec <id> -- bash -lc 'for i in 1 2 3; do echo $i; sleep 1; done'
 printf 'hello' | runtime exec <id> --stdin -- cat
+# Use runtime exec for automation and exact exit codes; use runtime enter -- <cmd> for interactive TTY commands.
 runtime files ls <id> /home/ubuntu
 runtime files read <id> /home/ubuntu/app.py --output app.py
 runtime files write <id> /home/ubuntu/app.py --input app.py --mode 0644