lucen-cli 0.1.0__tar.gz → 0.1.2__tar.gz

{lucen_cli-0.1.0 → lucen_cli-0.1.2}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: lucen-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: MouseMouse CLI (`lucen`): push robot data, train and sim-test policies, hand them to a robot through a consent gate
 License-Expression: Apache-2.0
 License-File: LICENSE
 Requires-Dist: typer>=0.20
 Requires-Dist: rich>=14.0
 Requires-Dist: httpx>=0.28
-Requires-Dist: lucen-sdk>=0.1.0,<0.2
+Requires-Dist: lucen-sdk>=0.1.1,<0.2
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: huggingface-hub>=1.0,<2
 Requires-Dist: mujoco==3.12.0 ; extra == 'rl'
@@ -63,9 +63,10 @@ Extras bring the engines some commands need; everything else stays a few MB:
 | `uv tool install "lucen-cli[serve]"` | ONNX Runtime, websockets, msgpack | `lucen serve` (a hosted-endpoint server on your GPU box) |
 | `uv tool install "lucen-cli[vla]"` | LeRobot, torch, PEFT | the `smolvla_lora` template |
 
-A MouseMouse hub also serves its own copy of these wheels, built from the hub's
-own commit: `curl -fsSL <hub API>/install.sh | sh -s -- cli` installs from
-there and points the CLI at that hub.
+A MouseMouse hub built from its API image also serves its own copy of these
+wheels for machines that cannot reach PyPI, built from the hub's own commit:
+`curl -fsSL <hub API>/install.sh | sh -s -- cli` installs from there and points
+the CLI at that hub.
 
 ## First steps
 
@@ -110,4 +111,27 @@ The robot side of the consent gate is
 [`lucen-device`](https://pypi.org/project/lucen-device/); the hub's tools for an
 AI agent are [`lucen-mcp`](https://pypi.org/project/lucen-mcp/).
 
+## Changelog
+
+- **0.1.2** (2026-10-18): `lucen robot init` takes the URDFs people actually
+  have: COLLADA (`.dae`) meshes are converted to STL, `package://` paths deeper
+  than the uploaded folder resolve, a xacro file is refused with the command
+  that expands it, and a model file you shipped is never overwritten. A
+  floating robot gets a floor and its declared pose's height, a model with no
+  gains gets a starting kp/kd found in simulation, and each leg's grounded leaf
+  is proposed as its foot. `lucen push --kind dataset` writes a LeRobot
+  dataset's episode and frame counts, as `lucen datasets import` does, and the
+  import without a terminal names the line to run with `--yes`. `lucen runs
+  create --max-hours`; `lucen endpoints estimate --owner`; a long wait is told
+  as a UTC time. `smolvla_lora` trains on an `hf://` dataset, refuses a base
+  checkpoint of another family, and stamps a policy for its robot only when the
+  dataset matches it. `lucen serve` tells the hub why it stopped. Needs
+  `lucen-sdk` 0.1.1.
+- **0.1.1** (2026-10-13): the built-in `ppo_mujoco` trainer's `velocity` preset
+  trains under the sim tests' own conditions (the action delay, the rate limit
+  and the pushes), so a quick run on Laika stands at about 2° of tilt instead
+  of a crouch; ONNX Runtime's start-up messages stay out of a run's log; every
+  "install the extra" hint names the PyPI line.
+- **0.1.0**: the first release on PyPI.
+
 Apache-2.0. © 2026 Lucen Robotics.

{lucen_cli-0.1.0 → lucen_cli-0.1.2}/README.md

@@ -27,9 +27,10 @@ Extras bring the engines some commands need; everything else stays a few MB:
 | `uv tool install "lucen-cli[serve]"` | ONNX Runtime, websockets, msgpack | `lucen serve` (a hosted-endpoint server on your GPU box) |
 | `uv tool install "lucen-cli[vla]"` | LeRobot, torch, PEFT | the `smolvla_lora` template |
 
-A MouseMouse hub also serves its own copy of these wheels, built from the hub's
-own commit: `curl -fsSL <hub API>/install.sh | sh -s -- cli` installs from
-there and points the CLI at that hub.
+A MouseMouse hub built from its API image also serves its own copy of these
+wheels for machines that cannot reach PyPI, built from the hub's own commit:
+`curl -fsSL <hub API>/install.sh | sh -s -- cli` installs from there and points
+the CLI at that hub.
 
 ## First steps
 
@@ -74,4 +75,27 @@ The robot side of the consent gate is
 [`lucen-device`](https://pypi.org/project/lucen-device/); the hub's tools for an
 AI agent are [`lucen-mcp`](https://pypi.org/project/lucen-mcp/).
 
+## Changelog
+
+- **0.1.2** (2026-10-18): `lucen robot init` takes the URDFs people actually
+  have: COLLADA (`.dae`) meshes are converted to STL, `package://` paths deeper
+  than the uploaded folder resolve, a xacro file is refused with the command
+  that expands it, and a model file you shipped is never overwritten. A
+  floating robot gets a floor and its declared pose's height, a model with no
+  gains gets a starting kp/kd found in simulation, and each leg's grounded leaf
+  is proposed as its foot. `lucen push --kind dataset` writes a LeRobot
+  dataset's episode and frame counts, as `lucen datasets import` does, and the
+  import without a terminal names the line to run with `--yes`. `lucen runs
+  create --max-hours`; `lucen endpoints estimate --owner`; a long wait is told
+  as a UTC time. `smolvla_lora` trains on an `hf://` dataset, refuses a base
+  checkpoint of another family, and stamps a policy for its robot only when the
+  dataset matches it. `lucen serve` tells the hub why it stopped. Needs
+  `lucen-sdk` 0.1.1.
+- **0.1.1** (2026-10-13): the built-in `ppo_mujoco` trainer's `velocity` preset
+  trains under the sim tests' own conditions (the action delay, the rate limit
+  and the pushes), so a quick run on Laika stands at about 2° of tilt instead
+  of a crouch; ONNX Runtime's start-up messages stay out of a run's log; every
+  "install the extra" hint names the PyPI line.
+- **0.1.0**: the first release on PyPI.
+
 Apache-2.0. © 2026 Lucen Robotics.

{lucen_cli-0.1.0 → lucen_cli-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lucen-cli"
-version = "0.1.0"
+version = "0.1.2"
 description = "MouseMouse CLI (`lucen`): push robot data, train and sim-test policies, hand them to a robot through a consent gate"
 # R1: `readme`, `license`, `license-files` and `[project.urls]` are what PyPI
 # renders; the LICENSE beside this file is Apache-2.0 verbatim (docs/DECISIONS.md "R1").
@@ -18,7 +18,7 @@ dependencies = [
     # Requires-Dist, where `[tool.uv.sources]` below does not reach, and PyPI has
     # to resolve it. The generated client is 0.x, so a minor bump is its breaking
     # signal: the CLI follows the SDK within one minor.
-    "lucen-sdk>=0.1.0,<0.2",
+    "lucen-sdk>=0.1.1,<0.2",
     # M7-RL: `lucen runs create -f recipe.yaml`. The stub template stays stdlib
     # only and emits its own YAML; only the recipe *reader* needs a parser.
     "pyyaml>=6.0",

{lucen_cli-0.1.0 → lucen_cli-0.1.2}/src/lucen/hub.py

@@ -72,6 +72,7 @@ from lucen_cli.config import (
 )
 from lucen_cli.errors import CLIError
 from lucen_cli.errors import HubUnreachable as _CLIHubUnreachable
+from lucen_cli.extras import install_line, pip_line
 from lucen_cli.progress import Reporter
 from lucen_cli.pull import run_pull
 from lucen_cli.push import run_push
@@ -85,9 +86,8 @@ NO_HUB_URL_FIX_PYTHON = (
 
 #: The sentence `hub.robots` and a local rollout refuse with when MuJoCo is absent.
 ENGINE_FIX = (
-    "Install the rollout extra into this environment: "
-    'uv pip install --index lucen=<hub>/install/simple/ "lucen-cli[rollout]" '
-    '(or, from a checkout: uv pip install ./packages/sdk/py "./packages/cli[rollout]").'
+    f"Install the rollout extra into this environment: {pip_line('rollout')} "
+    f"(as a tool on the PATH: {install_line('rollout')})."
 )
 
 #: `recipe` as a script hands it over: a mapping, or the path of a YAML/JSON file.

{lucen_cli-0.1.0 → lucen_cli-0.1.2}/src/lucen_cli/__init__.py

@@ -1,3 +1,3 @@
 """MouseMouse CLI."""
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"

{lucen_cli-0.1.0 → lucen_cli-0.1.2}/src/lucen_cli/client.py

@@ -28,6 +28,7 @@ import re
 import time
 from collections.abc import Callable, Iterator, Sequence
 from dataclasses import dataclass
+from datetime import UTC, datetime, timedelta
 from http import HTTPStatus
 from types import TracebackType
 from typing import Any, Final
@@ -172,6 +173,7 @@ from lucen_sdk.models import (
     EndpointPage,
     EndpointReport,
     EndpointReportStatus,
+    EndpointServerStopReason,
     EndpointSession,
     EndpointSessionOpen,
     EndpointSessionOpened,
@@ -354,6 +356,18 @@ class RepoTarget:
         return cls(owner=owner, slug=slug)
 
 
+def _retry_hint(retry: str | None) -> str:
+    """When to try again after a 429. A spend cap's or an allowance's `Retry-After` runs to the
+    1st of next month, and "Wait 1189678 s" was the line a person read (T2)."""
+    seconds = int(retry) if retry and retry.strip().isdigit() else None
+    if seconds is None:
+        return "Wait a moment and run it again."
+    if seconds <= 3600:
+        return f"Wait {seconds} s and run it again."
+    when = datetime.now(UTC) + timedelta(seconds=seconds)
+    return f"Try again after {when:%Y-%m-%d %H:%M} UTC, or do what the hub's sentence above says."
+
+
 class HubClient:
     """Thin, typed, error-translating wrapper over the generated SDK."""
 
@@ -564,9 +578,7 @@ class HubClient:
         elif status == 429:
             retry = response.headers.get("retry-after")
             message = f"{action}: rate limited by the hub."
-            hint = (
-                f"Wait {retry} s and run it again." if retry else "Wait a moment and run it again."
-            )
+            hint = _retry_hint(retry)
         elif status == 503:
             # A deliberate refusal ("this deployment cannot serve that"), not
             # an outage: the detail is the answer, and retrying will not help.
@@ -1432,6 +1444,7 @@ class HubClient:
         sessions: Sequence[dict[str, Any]] = (),
         error: str | None = None,
         log_chunk: str | None = None,
+        stop_reason: str | None = None,
     ) -> Endpoint:
         states = []
         for item in sessions:
@@ -1453,6 +1466,7 @@ class HubClient:
             sessions=states if states else UNSET,
             error=error if error is not None else UNSET,
             log_chunk=log_chunk if log_chunk else UNSET,
+            stop_reason=EndpointServerStopReason(stop_reason) if stop_reason else UNSET,
         )
         action = f"Reporting on endpoint {endpoint_id}"
         # F1: one attempt, translated — a hub that does not answer is an `ApiError`
@@ -1589,13 +1603,19 @@ class HubClient:
         total_frames: int,
         fps: float | None = None,
         robot_type: str | None = None,
+        recorded_policy: str | None = None,
     ) -> DatasetMeta:
-        """`PUT /v1/datasets/{owner}/{repo}/meta` — the numbers `meta/info.json` declares."""
+        """`PUT /v1/datasets/{owner}/{repo}/meta` — the numbers `meta/info.json` declares.
+
+        V3: `recorded_policy` (`owner/slug`) names the policy the robot ran while
+        the data was recorded; left out, the hub records none.
+        """
         body = DatasetMetaPut(
             episode_count=episode_count,
             total_frames=total_frames,
             fps=fps,
             robot_type=robot_type,
+            recorded_policy=recorded_policy,
         )
         response = put_dataset_meta_api.sync_detailed(
             target.owner, target.slug, client=self._sdk, body=body

{lucen_cli-0.1.0 → lucen_cli-0.1.2}/src/lucen_cli/cmd_quickstart.py

@@ -135,7 +135,7 @@ def plan_robot_file(path: Path) -> list[Step]:
             Step(
                 f"lucen runs create --template ppo_mujoco --robot you/{slug} --executor worker",
                 "Queue a PPO run on it; `lucen worker run` in a second terminal trains it "
-                "here, free (needs the rl extra: install `cli[rl]`).",
+                "here, free (needs the rl extra: install `lucen-cli[rl]`).",
             )
         )
     return steps
@@ -151,7 +151,7 @@ def plan_robot_on_hub(robot: str) -> list[Step]:
         Step(
             "lucen worker run",
             "In a second terminal: claims the run, trains on this machine (free) and "
-            "publishes the policy as a model repo (needs the rl extra: install `cli[rl]`).",
+            "publishes the policy as a model repo (needs the rl extra: install `lucen-cli[rl]`).",
         ),
         Step(
             f"lucen rollout {MODEL_PLACEHOLDER} --robot {target.full_name} --battery smoke --local",
@@ -205,7 +205,7 @@ def plan_no_file() -> list[Step]:
         Step(
             "lucen worker run",
             "In a second terminal: claims it, trains here (free) and publishes the policy "
-            "(needs the rl extra: install `cli[rl]`).",
+            "(needs the rl extra: install `lucen-cli[rl]`).",
         ),
         Step(
             f"lucen rollout {MODEL_PLACEHOLDER} --robot lucen/laika --battery smoke --local",

{lucen_cli-0.1.0 → lucen_cli-0.1.2}/src/lucen_cli/cmd_robot.py

@@ -237,7 +237,7 @@ def run_init(
     from lucen_cli.robot import draft as drafting
     from lucen_cli.robot import pose as poses
     from lucen_cli.robot import urdf
-    from lucen_cli.robot.model import compile_file, facts_of
+    from lucen_cli.robot.model import compile_file, facts_of, rest_height
 
     if action not in _ACTIONS:
         raise RobotError("init.action", f"--action must be one of: {', '.join(_ACTIONS)}.")
@@ -306,6 +306,11 @@ def run_init(
         )
     if declared:
         _check_declared_pose(declared, facts)
+    base_height_m = conversion.base_height_m if conversion is not None else None
+    if declared and facts.floating and (conversion is not None or facts.default_source == "qpos0"):
+        # The height a converted model was lifted to is the straight-leg one (qpos0);
+        # the declared pose is what policies start from, so rest THAT on the floor.
+        base_height_m = rest_height(model, facts, declared) or base_height_m
     options = drafting.DraftOptions(
         control_hz=control_hz,
         action=action,
@@ -325,7 +330,7 @@ def run_init(
         mjcf_path=model_path.relative_to(root_dir).as_posix(),
         options=options,
         extra_limits=conversion.limits if conversion is not None else None,
-        base_height_m=conversion.base_height_m if conversion is not None else None,
+        base_height_m=base_height_m,
     )
     if conversion is not None:
         for warning in conversion.warnings:
@@ -338,6 +343,7 @@ def run_init(
                     "inferred_mass_kg": warning.get("inferred_mass_kg"),
                 }
             )
+    _propose_gains(built, root_dir, model, facts, declared)
     card_path.write_text(
         json.dumps(built.document(), indent=2, ensure_ascii=False) + "\n", encoding="utf-8"
     )
@@ -363,6 +369,65 @@ def run_init(
     }
 
 
+GAINS_FIELD = "interface.actuation[].kp / kd"
+
+
+def _propose_gains(
+    built: Any, root_dir: Path, model: Any, facts: ModelFacts, declared: dict[str, float] | None
+) -> None:
+    """T1: attach a searched starting gain to the blocking kp/kd entry, as a proposal.
+
+    The entry stays blocking: accepting the proposal is re-running init with its
+    flags (the web's "Use these gains" does exactly that), so nothing is decided
+    for the person. When no candidate passes, the entry says so instead.
+    """
+    from lucen_cli.robot import gains
+
+    need = next((n for n in built.needs_you if n.get("field") == GAINS_FIELD), None)
+    if need is None:
+        return
+    pose = None
+    if not declared:
+        pose_need = next(
+            (n for n in built.needs_you if n.get("field") == "interface.default_pose"), None
+        )
+        if pose_need and isinstance(pose_need.get("suggestion"), dict):
+            pose = {str(k): float(v) for k, v in pose_need["suggestion"].items()}
+    try:
+        proposal = gains.propose(root_dir, built.card, model, facts, pose=pose)
+    except Exception as exc:  # a proposal is help; it never fails init
+        need["why"] += f" (No starting gain was proposed: the search failed with {exc}.)"
+        return
+    if proposal is None:
+        need["why"] += (
+            " No uniform kp/kd up to 600 (with armature up to 0.1 kg·m²) held this model in "
+            "simulation, so there is no proposal: set gains per group."
+        )
+        return
+    line = gains.flags(proposal)
+    # `suggestion` is the flags (a string, as the hub's needs schema types it); `proposal`
+    # is the same values as numbers, for a page or an agent that fills them in.
+    need["suggestion"] = line
+    need["proposal"] = {
+        key: proposal[key] for key in ("kp", "kd", "armature") if proposal.get(key) is not None
+    }
+    if pose:
+        need["proposal"]["default_pose"] = pose
+    need["suggestion_source"] = (
+        "a PROPOSAL found by simulation, not read from the robot: the first uniform gain"
+        + (" (with armature, which a URDF cannot carry)" if proposal.get("armature") else "")
+        + " that passes `model.gains`, `stability.settle` and `stability.joint_response`"
+        + (" at the proposed default pose" if pose else "")
+        + f" ({proposal['candidates_tried']} candidate(s) simulated)"
+    )
+    need["settle"] = proposal.get("settle")
+    need["why"] += (
+        f" A starting point that held this model in simulation: {line}"
+        + (" (with the proposed default pose)" if pose else "")
+        + ". Check it against your motors, then pass it to `lucen robot init`."
+    )
+
+
 def _check_declared_pose(declared: dict[str, float], facts: ModelFacts) -> None:
     """`--default-pose` names only the model's 1-DoF joints, each inside its range."""
     known = {joint.name: joint for joint in facts.joints}

{lucen_cli-0.1.0 → lucen_cli-0.1.2}/src/lucen_cli/cmd_runs.py

@@ -192,6 +192,16 @@ ParentOpt = Annotated[
 OwnerOpt = Annotated[
     str | None, typer.Option("--owner", help="Org slug to bill it to; default: you.")
 ]
+MaxHoursOpt = Annotated[
+    float | None,
+    typer.Option(
+        "--max-hours",
+        min=0.01,
+        max=720,
+        help="With --template: the run's time limit. On Lucen cloud it is what the run "
+        "reserves against your free allowance (default 4 h).",
+    ),
+]
 JsonOpt = Annotated[bool, typer.Option("--json", help="Machine-readable output.")]
 IdempotencyOpt = Annotated[
     str | None,
@@ -266,15 +276,16 @@ def create_run(
     template: TemplateOpt = None,
     robot: RobotOpt = None,
     executor: ExecutorOpt = None,
+    max_hours: MaxHoursOpt = None,
     parent: ParentOpt = None,
     owner: OwnerOpt = None,
     idempotency_key: IdempotencyOpt = None,
     as_json: JsonOpt = False,
 ) -> None:
-    """Submit a training run. It executes when a `lucen worker run` claims it."""
+    """Submit a training run: on your machine (`lucen worker run`), or on Lucen cloud."""
     state = ctx.ensure_object(AppState)
     recipe, file_owner, file_parent = load_recipe(
-        file, template=template, robot=robot, executor=executor
+        file, template=template, robot=robot, executor=executor, max_hours=max_hours
     )
     try:
         client, run, created, web = _submit(
@@ -298,15 +309,18 @@ def load_recipe(
     template: str | None,
     robot: str | None,
     executor: str | None,
+    max_hours: float | None = None,
 ) -> tuple[dict[str, Any], str | None, str | None]:
     """A recipe from `-f FILE` or from `--template [--robot] [--executor]`, never both."""
     if file is not None and template is not None:
         raise CLIError("Give either -f RECIPE or --template, not both.")
     if file is not None:
-        if robot is not None or executor is not None:
+        if robot is not None or executor is not None or max_hours is not None:
             raise CLIError(
-                "--robot and --executor go with --template; a recipe file names its own.",
-                hint="Put `robot:` and `executor:` in the file, or drop -f and use --template.",
+                "--robot, --executor and --max-hours go with --template; a recipe file "
+                "names its own.",
+                hint="Put `robot:`, `executor:` and `max_hours:` in the file, or drop -f and "
+                "use --template.",
             )
         return load_recipe_file(file)
     if template is None:
@@ -319,6 +333,8 @@ def load_recipe(
         recipe["robot"] = robot
     if executor is not None:
         recipe["executor"] = executor
+    if max_hours is not None:
+        recipe["max_hours"] = max_hours
     return recipe, None, None
 
 

{lucen_cli-0.1.0 → lucen_cli-0.1.2}/src/lucen_cli/cmd_serve.py

@@ -19,6 +19,7 @@ import typer
 
 from lucen_cli.context import AppState
 from lucen_cli.errors import CLIError
+from lucen_cli.extras import install_line
 from lucen_cli.group import LucenGroup
 from lucen_cli.output import emit_json, stdout
 
@@ -38,9 +39,7 @@ def _need_serve_extra() -> None:
     except ImportError as exc:  # pragma: no cover - depends on the install
         raise CLIError(
             f"`lucen serve` needs the `serve` extra ({exc.name} is not installed).",
-            hint=(
-                'uv tool install --from "./packages/cli[serve]" --with ./packages/sdk/py lucen-cli'
-            ),
+            hint=install_line("serve"),
         ) from exc
 
 
@@ -160,6 +159,44 @@ def _is_directory(endpoint: Any) -> bool:
     return str(getattr(endpoint, "artifact", "onnx")) == "checkpoint_dir"
 
 
+def billing_rule(endpoint: Any) -> str:
+    """One line: what this endpoint costs and how the hub counts it (P2)."""
+    from lucen_cli.client import unset_to_none
+
+    if not getattr(endpoint, "priced", False):
+        return "free: it runs on your own machine"
+    rate = float(getattr(endpoint, "rate_usd_per_hour", 0) or 0)
+    if unset_to_none(getattr(endpoint, "cost_basis", None)) == "sessions":
+        return f"${rate:.4f}/h per session's GPU time (created before uptime billing began)"
+    return (
+        f"${rate:.4f}/h for its uptime, from the claim until it stops, "
+        "whether or not a robot is connected"
+    )
+
+
+def uptime(seconds: float) -> str:
+    """`41 s`, `12 min`, `3.5 h`: how long an endpoint has been billed for."""
+    if seconds < 90:
+        return f"{round(seconds)} s"
+    minutes = seconds / 60
+    if minutes < 90:
+        return f"{round(minutes)} min"
+    return f"{minutes / 60:.1f} h"
+
+
+def cost_line(endpoint: Any) -> str:
+    """`cost so far $0.0171 · up for 60 s` / `cost $0.0171 · up for 41 min` / `free`."""
+    from lucen_cli.client import unset_to_none
+
+    if not getattr(endpoint, "priced", False):
+        return "free"
+    cost = float(unset_to_none(getattr(endpoint, "cost_usd", None)) or 0)
+    word = "cost so far" if str(endpoint.status) == "running" else "cost"
+    seconds = unset_to_none(getattr(endpoint, "billed_seconds", None))
+    up = f" · up for {uptime(float(seconds))}" if seconds is not None else ""
+    return f"{word} ${cost:.4f}{up}"
+
+
 def idle_rule(endpoint: Any) -> str:
     """One line: when the hub stops this endpoint for being idle, and the session timeout."""
     from lucen_cli.client import unset_to_none
@@ -288,6 +325,7 @@ def create(
         markup=False,
     )
     _print_artifact(endpoint)
+    stdout.print(f"  {billing_rule(endpoint)}", markup=False)
     stdout.print(f"  {idle_rule(endpoint)}", markup=False)
     if str(endpoint.executor) == "worker":
         extra = "[vla,serve]" if _is_directory(endpoint) else "[serve]"
@@ -316,12 +354,22 @@ def estimate(
     policy_path: Annotated[
         str | None, typer.Option("--policy-path", help="The checkpoint directory it would serve.")
     ] = None,
+    owner: Annotated[
+        str | None, typer.Option("--owner", help="Price it for this handle (as `create` bills).")
+    ] = None,
     as_json: Annotated[bool, typer.Option("--json", help="Machine-readable output.")] = False,
 ) -> None:
     """Price an endpoint: the tier its size selects x hours. Creates nothing."""
     state = ctx.ensure_object(AppState)
     body: dict[str, Any] = {"model_repo": model, "executor": executor, "hours": hours}
-    for key, value in (("params", params), ("onnx_path", onnx_path), ("policy_path", policy_path)):
+    # T2: without `--owner` a member of a hosted organization was priced as themself and told
+    # hosted GPUs are not open to them, while `create --owner` would have been accepted.
+    for key, value in (
+        ("params", params),
+        ("onnx_path", onnx_path),
+        ("policy_path", policy_path),
+        ("owner", owner),
+    ):
         if value is not None:
             body[key] = value
     with state.client(require_auth=True) as client:
@@ -337,10 +385,16 @@ def estimate(
     stdout.print(
         f"{est.executor}: tier {est.tier} ({size}{est.vram_bytes / 2**30:.1f} GiB"
         + (f" from {basis}" if basis else "")
-        + f") · ${float(est.rate_usd_per_hour):.4f}/h x {float(est.hours):g} h = "
+        + f") · ${float(est.rate_usd_per_hour):.4f}/h x {float(est.hours):g} h up = "
         f"${float(est.cost_usd_max):.4f}" + ("" if est.priced else " (unpriced)"),
         markup=False,
     )
+    if est.priced:
+        stdout.print(
+            "  billed for its uptime, from the claim until it stops, whether or not a robot "
+            "is connected; sessions add nothing",
+            markup=False,
+        )
     notes = getattr(est, "notes", None)
     for note in notes if isinstance(notes, list) else []:
         stdout.print(f"  note: {note}", markup=False)
@@ -397,6 +451,7 @@ def show(
         markup=False,
     )
     _print_artifact(endpoint)
+    stdout.print(f"  {cost_line(endpoint)} · {billing_rule(endpoint)}", markup=False)
     stdout.print(f"  {idle_rule(endpoint)}", markup=False)
     from lucen_cli.client import unset_to_none
 

lucen_cli-0.1.2/src/lucen_cli/extras.py

@@ -0,0 +1,29 @@
+"""The install line for one of the CLI's extras, in one place (D1).
+
+Every refusal that names a missing engine prints the line the docs show, which
+since D1 is PyPI's: `uv tool install "lucen-cli[rollout]"`. Before this each
+site carried its own copy of the checkout line (`uv tool install --from
+"./packages/cli[rollout]" --with ./packages/sdk/py lucen-cli`), which a
+stranger with the package from PyPI cannot run. The extra is quoted because an
+unquoted `[…]` is a glob zsh refuses ("no matches found").
+"""
+
+from __future__ import annotations
+
+from typing import Final
+
+DISTRIBUTION: Final[str] = "lucen-cli"
+
+
+def _spec(extras: tuple[str, ...]) -> str:
+    return f'"{DISTRIBUTION}[{",".join(extras)}]"' if extras else DISTRIBUTION
+
+
+def install_line(*extras: str) -> str:
+    """`uv tool install "lucen-cli[rl]"`: the CLI as a tool on the PATH."""
+    return f"uv tool install {_spec(extras)}"
+
+
+def pip_line(*extras: str) -> str:
+    """`uv pip install "lucen-cli[rollout]"`: into the environment a script runs in."""
+    return f"uv pip install {_spec(extras)}"