simulo 0.30.0__tar.gz → 0.31.1__tar.gz

{simulo-0.30.0/src/simulo.egg-info → simulo-0.31.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simulo
-Version: 0.30.0
+Version: 0.31.1
 Summary: Python SDK and CLI for cloud-native robotics simulation, reinforcement learning, and robot policy training on managed GPUs.
 Author-email: Simulo Team <team@simulo.ai>
 License: BSD-3-Clause
@@ -92,14 +92,17 @@ Simulo requires Python 3.11 or newer. One installation provides both the
 simulo create mybot
 simulo login
 cd mybot
+simulo run preview.py --frozen --strict-assets
 simulo run train.py --frozen --strict-assets
+simulo run play.py --policy policy_<job>:best --frozen --strict-assets
 ```
 
 `simulo create` writes a complete starter application to your machine without
-requiring a login or network connection. It creates `task.py`, `train.py`, and
-`.simuloignore`; the default application trains a PPO policy on a validated cartpole
-asset. `simulo run` packages the source, resolves
-and pins its assets, submits the job, and follows its cloud logs.
+requiring a login or network connection. It creates `task.py`, `preview.py`,
+`train.py`, `play.py`, and `.simuloignore`. Run `preview.py` first as a separate
+job to check the validated cartpole asset in its task, run `train.py` to train a
+PPO policy, then pass that policy to `play.py`. `simulo run` packages the source,
+resolves and pins its assets, submits the job, and follows its cloud logs.
 
 ## Explore robotics samples
 

{simulo-0.30.0 → simulo-0.31.1}/PYPI.md

@@ -36,14 +36,17 @@ Simulo requires Python 3.11 or newer. One installation provides both the
 simulo create mybot
 simulo login
 cd mybot
+simulo run preview.py --frozen --strict-assets
 simulo run train.py --frozen --strict-assets
+simulo run play.py --policy policy_<job>:best --frozen --strict-assets
 ```
 
 `simulo create` writes a complete starter application to your machine without
-requiring a login or network connection. It creates `task.py`, `train.py`, and
-`.simuloignore`; the default application trains a PPO policy on a validated cartpole
-asset. `simulo run` packages the source, resolves
-and pins its assets, submits the job, and follows its cloud logs.
+requiring a login or network connection. It creates `task.py`, `preview.py`,
+`train.py`, `play.py`, and `.simuloignore`. Run `preview.py` first as a separate
+job to check the validated cartpole asset in its task, run `train.py` to train a
+PPO policy, then pass that policy to `play.py`. `simulo run` packages the source,
+resolves and pins its assets, submits the job, and follows its cloud logs.
 
 ## Explore robotics samples
 

{simulo-0.30.0 → simulo-0.31.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "simulo"
-version = "0.30.0"
+version = "0.31.1"
 description = "Python SDK and CLI for cloud-native robotics simulation, reinforcement learning, and robot policy training on managed GPUs."
 readme = "PYPI.md"
 requires-python = ">=3.11"

{simulo-0.30.0 → simulo-0.31.1}/src/simulo/_client/cli.py

@@ -27,7 +27,8 @@ default stays out of submitted ``args`` and preserves the no-flags
 ``package_id``.
 
 ``simulo create <name> [--dir PATH] [--force]`` scaffolds a training app folder
-(``<name>/task.py``, ``<name>/train.py``, and ``<name>/.simuloignore``) from a
+(``<name>/task.py``, ``<name>/preview.py``, ``<name>/train.py``,
+``<name>/play.py``, and ``<name>/.simuloignore``) from a
 starter template bundled INSIDE this wheel as package data (loaded via
 ``importlib.resources``, not a path relative to this repo). This is the ONLY
 delivery vehicle for a starter app: the repo's ``demos/`` directory sits outside
@@ -672,6 +673,14 @@ def _resolve_client_context() -> tuple[str, Optional[str]]:
     return base_url, token
 
 
+def _client_with_fresh_token(client: JobsApiClient) -> JobsApiClient:
+    """Return a client with current stored credentials, preserving its target."""
+    creds = credentials.try_get_valid_credentials(base_url=client.base_url)
+    if creds is None:
+        return client
+    return JobsApiClient(client.base_url, token=str(creds["access_token"]))
+
+
 def _is_uuid_text(value: Any) -> bool:
     try:
         UUID(str(value))
@@ -1469,10 +1478,16 @@ def _follow_and_report(handle: JobHandle, app_path: str) -> int:
         job_ref = str(getattr(handle, "public_id", None) or handle.job_id)
         exit_code = _drain_logs(client, job_ref, follow=True, scope=JOB_SCOPE_MINE)
         if handle.job_type is JobType.PREVIEW:
+            client = _client_with_fresh_token(client)
             return _report_preview(client, job_ref, display_id, app_path, fallback_exit_code=exit_code)
         if exit_code == 0:
             if handle.job_type is JobType.TRAIN:
-                _print_training_next_steps(handle, app_path)
+                client = _client_with_fresh_token(client)
+                _print_training_next_steps(
+                    PoliciesApiClient(client.base_url, token=client._token),
+                    handle,
+                    app_path,
+                )
             elif handle.job_type is JobType.PLAY:
                 print(f"Next: simulo recordings {display_id}")
         return exit_code
@@ -1565,12 +1580,11 @@ def _checkpoint_iteration(handle: JobHandle, checkpoint_ref: str) -> Optional[in
     return None
 
 
-def _print_training_next_steps(handle: JobHandle, app_path: str) -> None:
+def _print_training_next_steps(client: PoliciesApiClient, handle: JobHandle, app_path: str) -> None:
     """Print the sealed policy's checkpoints and the three canonical next steps."""
-    assert handle.base_url is not None
     policy_id = str(policy_id_for_job(_handle_display_id(handle)))
     try:
-        record = PoliciesApiClient(handle.base_url, token=handle.token).get_policy(policy_id)
+        record = client.get_policy(policy_id)
     except http.HttpError:
         return
     rendered: list[str] = []
@@ -2385,6 +2399,7 @@ def _wait_for_job(client: JobsApiClient, job_id: str, *, scope: str = JOB_SCOPE_
     """Poll until ``job_id`` exists — lets a user arm the tail BEFORE the job is created."""
     waiting_announced = False
     while True:
+        client = _client_with_fresh_token(client)
         try:
             return client.get_job(job_id, scope=scope)
         except JobsApiHTTPError as exc:
@@ -2413,6 +2428,7 @@ def _wait_for_latest_job(client: JobsApiClient) -> dict[str, Any]:
     """
     waiting_announced = False
     while True:
+        client = _client_with_fresh_token(client)
         try:
             latest = client.get_latest_job()
         except JobsApiHTTPError as exc:
@@ -2607,6 +2623,8 @@ def _drain_logs(
     post-``simulo run`` default follow — one follow loop, one
     exit-code-mirrors-outcome rule.
     """
+    if follow:
+        client = _client_with_fresh_token(client)
     offset = 0
     if tail_lines is not None:
         try:
@@ -2632,6 +2650,8 @@ def _drain_logs(
         # Not honored (old server): the loop below simply continues the full
         # history from where the server's offset-0 answer left off.
     while True:
+        if follow:
+            client = _client_with_fresh_token(client)
         try:
             chunk, offset, status, _ = client.get_log_chunk(job_id, offset, scope=scope)
         except JobsApiHTTPError as exc:
@@ -2769,9 +2789,9 @@ def _cmd_result(args: argparse.Namespace) -> int:
     announced on stderr.
     A job whose run announced typed outputs gets a second
     stderr line, ``⚠ 1 anomaly (non_finite_reward)`` (:func:`_outputs_flag_summary`)
-    — the result JSON itself is untouched (``stats["anomaly_captures"]`` stays
-    byte-identical; a byte stream is an output, a JSON scalar is a metric,
-    surfaced together but never merged). Both lines print to
+    while built-in training results omit anomaly-capture paths. Those paths
+    are exposed through the recordings and outputs commands instead. Both
+    lines print to
     stderr so stdout stays pure result JSON for pipelines. Best-effort: for
     an explicit JOB_ID this needs one extra ``get_job`` call, and a failure
     there (e.g. an older control plane) skips both lines rather than failing a
@@ -5074,11 +5094,9 @@ def _validate_app_name(name: str) -> None:
         )
 
 
-#: The first ``simulo run`` a fresh scaffold user should type, printed as the
-#: "Next steps" line by ``_cmd_create``.
-#: Pinned end-to-end by ``test_create_next_step_command_actually_runs``, which
-#: executes each printed command verbatim against a fresh scaffold.
-_TEMPLATE_NEXT_RUN_COMMAND = "simulo run train.py"
+#: The ``simulo run`` commands a fresh scaffold user should type before policy
+#: playback, in order, printed as the "Next steps" lines by ``_cmd_create``.
+_TEMPLATE_NEXT_RUN_COMMANDS = ("simulo run preview.py", "simulo run train.py")
 
 
 def _cmd_create(args: argparse.Namespace) -> int:
@@ -5091,7 +5109,7 @@ def _cmd_create(args: argparse.Namespace) -> int:
     ``{{APP_NAME}}`` token. No network call, no auth.
 
     A pre-existing, non-empty target folder is refused unless ``--force`` (which
-    prints the two filenames it overwrote — a destructive action stays visible in
+    prints the filenames it overwrote — a destructive action stays visible in
     the output); an existing EMPTY folder (or no folder at all) needs no
     ``--force``. Every filesystem failure writing the scaffold — including a bad
     ``--dir`` that names an existing FILE rather than a directory (``mkdir``
@@ -5153,7 +5171,8 @@ def _cmd_create(args: argparse.Namespace) -> int:
     print(f"{verb} app in {target_dir}/ ({written}).")
     print("Next steps:")
     print(f"  cd {target_dir}")
-    print(f"  {_TEMPLATE_NEXT_RUN_COMMAND}")
+    for command in _TEMPLATE_NEXT_RUN_COMMANDS:
+        print(f"  {command}")
     print("  simulo run play.py --policy policy_<job>:best  # after training")
     return 0
 
@@ -8145,10 +8164,13 @@ def _build_parser() -> argparse.ArgumentParser:
 
     create = sub.add_parser(
         "create",
-        description="Scaffold task.py, train.py, play.py, and .simuloignore without network access or authentication.",
+        description=(
+            "Scaffold task.py, preview.py, train.py, play.py, and .simuloignore "
+            "without network access or authentication."
+        ),
         help=(
             "Scaffold a new Simulo app folder from a starter template shipped inside this wheel "
-            "(writes task.py, train.py, play.py, and .simuloignore; no network, no auth)."
+            "(writes task.py, preview.py, train.py, play.py, and .simuloignore; no network, no auth)."
         ),
     )
     create.add_argument(

{simulo-0.30.0 → simulo-0.31.1}/src/simulo/_client/templates/__init__.py

@@ -2,8 +2,9 @@
 
 The repo's ``demos/`` tree lives outside the packaged ``src/`` layout and never
 reaches a real ``pip install simulo`` user — this package is the fix. The
-``training/`` directory holds the three files created by ``simulo create``:
-``task.py.tmpl``, ``train.py.tmpl``, and ``simuloignore.tmpl``.
+``training/`` directory holds the five files created by ``simulo create``:
+``task.py.tmpl``, ``preview.py.tmpl``, ``train.py.tmpl``, ``play.py.tmpl``,
+and ``simuloignore.tmpl``.
 
 The ``.tmpl`` suffix is load-bearing, not cosmetic: these files contain
 ``import torch`` and other content that is not a valid, importable module on

simulo-0.31.1/src/simulo/_client/templates/training/preview.py.tmpl

@@ -0,0 +1,10 @@
+"""Check the robot inside the task before training; this preview makes no policy."""
+
+import simulo
+
+from task import StarterTask, app
+
+
+@app.job(type="preview", system=simulo.SystemType.TIER_1, timeout=15 * 60)
+def preview(num_envs: int = 16, checks: str = "all"):
+    return simulo.preview(StarterTask(), num_envs=num_envs, checks=checks, video=True)

{simulo-0.30.0 → simulo-0.31.1/src/simulo.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simulo
-Version: 0.30.0
+Version: 0.31.1
 Summary: Python SDK and CLI for cloud-native robotics simulation, reinforcement learning, and robot policy training on managed GPUs.
 Author-email: Simulo Team <team@simulo.ai>
 License: BSD-3-Clause
@@ -92,14 +92,17 @@ Simulo requires Python 3.11 or newer. One installation provides both the
 simulo create mybot
 simulo login
 cd mybot
+simulo run preview.py --frozen --strict-assets
 simulo run train.py --frozen --strict-assets
+simulo run play.py --policy policy_<job>:best --frozen --strict-assets
 ```
 
 `simulo create` writes a complete starter application to your machine without
-requiring a login or network connection. It creates `task.py`, `train.py`, and
-`.simuloignore`; the default application trains a PPO policy on a validated cartpole
-asset. `simulo run` packages the source, resolves
-and pins its assets, submits the job, and follows its cloud logs.
+requiring a login or network connection. It creates `task.py`, `preview.py`,
+`train.py`, `play.py`, and `.simuloignore`. Run `preview.py` first as a separate
+job to check the validated cartpole asset in its task, run `train.py` to train a
+PPO policy, then pass that policy to `play.py`. `simulo run` packages the source,
+resolves and pins its assets, submits the job, and follows its cloud logs.
 
 ## Explore robotics samples
 

{simulo-0.30.0 → simulo-0.31.1}/src/simulo.egg-info/SOURCES.txt

@@ -53,6 +53,7 @@ src/simulo/_client/view_session_api.py
 src/simulo/_client/volume.py
 src/simulo/_client/templates/__init__.py
 src/simulo/_client/templates/training/play.py.tmpl
+src/simulo/_client/templates/training/preview.py.tmpl
 src/simulo/_client/templates/training/simuloignore.tmpl
 src/simulo/_client/templates/training/task.py.tmpl
 src/simulo/_client/templates/training/train.py.tmpl