envloop-cli 0.2.0__tar.gz → 0.3.0__tar.gz

{envloop_cli-0.2.0 → envloop_cli-0.3.0}/PKG-INFO

@@ -1,16 +1,17 @@
 Metadata-Version: 2.5
 Name: envloop-cli
-Version: 0.2.0
+Version: 0.3.0
 Summary: EnvLoop CLI and Python SDK for jobs, training, checkpoints and inference
 Project-URL: Homepage, https://envloop.ai
 Project-URL: Documentation, https://docs.envloop.ai
+Project-URL: Repository, https://github.com/EnvLoop/envloop-cli
+Project-URL: Issues, https://github.com/EnvLoop/envloop-cli/issues
 Project-URL: Agent instructions, https://docs.envloop.ai/skill.md
 Requires-Python: >=3.11
-Provides-Extra: train
-Requires-Dist: tinker==0.30.2; extra == 'train'
+Requires-Dist: tinker==0.30.2
 Description-Content-Type: text/markdown
 
-# EnvLoop CLI and Python SDK
+# envloop-cli: EnvLoop CLI and Python SDK
 
 Install the public client to run agent Jobs, inspect Trials, manage training and
 checkpoints, and deploy or call inference endpoints. The `el` and `envloop`
@@ -21,19 +22,17 @@ commands are equivalent. The Python import package is `envloop`.
 Use a Python virtual environment:
 
 ```bash
-python -m pip install envloop-cli
+python -m pip install --upgrade envloop-cli
 el --help
 ```
 
-For Python training workflows, install the optional training dependency:
+The standard installation includes training support:
 
 ```bash
-python -m pip install 'envloop-cli[train]'
 python -c 'from envloop import Client, training; print("EnvLoop SDK ready")'
 ```
 
-The base client uses Python's standard library. The training extra installs the
-training protocol client. You do not need a source checkout, GitHub account,
+The package installs the training protocol client by default. You do not need a source checkout, GitHub account,
 local execution backend, Docker, or a GPU to install the client.
 
 ## Connect
@@ -60,9 +59,11 @@ your secret manager. Public API access is scoped to the authorized project.
 
 ```bash
 el job list --limit 5
-el train list --limit 5
+el job list --type train --limit 5
+el trail list --limit 5
+el trail list --type train --job-id JOB_ID
 el checkpoint list --limit 5
-el inference endpoint list
+el job list --type inference
 ```
 
 Query a returned Job ID with `el job get JOB_ID` and `el job result JOB_ID`.
@@ -76,12 +77,32 @@ from envloop import Client
 
 with Client.remote() as client:
     print(client.jobs.list(limit=5))
+    print(client.trials.list(type="train", limit=5))
 ```
 
 Submitting work, training a model or starting inference can allocate billable
 resources. Follow the task-specific guide and retain the outputs you need before
 cleaning up temporary resources.
 
+## Sandbox jobs
+
+With a matching platform and a published `envhub/base` ANS Runner, submit a
+Sandbox Job without a Dataset:
+
+```bash
+el job submit --type sandbox --runner base --command 'python --version'
+el job submit --type sandbox --runner base --image python:3.11 --wait
+el job list --type sandbox
+el job log JOB_ID --follow
+```
+
+The platform resolves `base` to the registered `envhub/base@main` source ref and
+freezes its immutable Revision. The Sandbox image defaults to `python:3.11`;
+`--image` accepts an image name, tag or digest. The execution provider is configured
+by the server. Job logs retain the actual captured output and collection metadata.
+Failures include a code, readable explanation, HTTP status when available, and
+recovery guidance without echoing arbitrary response bodies or credentials.
+
 ## Existing installations
 
 This distribution provides both the CLI and the `envloop` import package. Use a

{envloop_cli-0.2.0 → envloop_cli-0.3.0}/README.pypi.md

@@ -1,4 +1,4 @@
-# EnvLoop CLI and Python SDK
+# envloop-cli: EnvLoop CLI and Python SDK
 
 Install the public client to run agent Jobs, inspect Trials, manage training and
 checkpoints, and deploy or call inference endpoints. The `el` and `envloop`
@@ -9,19 +9,17 @@ commands are equivalent. The Python import package is `envloop`.
 Use a Python virtual environment:
 
 ```bash
-python -m pip install envloop-cli
+python -m pip install --upgrade envloop-cli
 el --help
 ```
 
-For Python training workflows, install the optional training dependency:
+The standard installation includes training support:
 
 ```bash
-python -m pip install 'envloop-cli[train]'
 python -c 'from envloop import Client, training; print("EnvLoop SDK ready")'
 ```
 
-The base client uses Python's standard library. The training extra installs the
-training protocol client. You do not need a source checkout, GitHub account,
+The package installs the training protocol client by default. You do not need a source checkout, GitHub account,
 local execution backend, Docker, or a GPU to install the client.
 
 ## Connect
@@ -48,9 +46,11 @@ your secret manager. Public API access is scoped to the authorized project.
 
 ```bash
 el job list --limit 5
-el train list --limit 5
+el job list --type train --limit 5
+el trail list --limit 5
+el trail list --type train --job-id JOB_ID
 el checkpoint list --limit 5
-el inference endpoint list
+el job list --type inference
 ```
 
 Query a returned Job ID with `el job get JOB_ID` and `el job result JOB_ID`.
@@ -64,12 +64,32 @@ from envloop import Client
 
 with Client.remote() as client:
     print(client.jobs.list(limit=5))
+    print(client.trials.list(type="train", limit=5))
 ```
 
 Submitting work, training a model or starting inference can allocate billable
 resources. Follow the task-specific guide and retain the outputs you need before
 cleaning up temporary resources.
 
+## Sandbox jobs
+
+With a matching platform and a published `envhub/base` ANS Runner, submit a
+Sandbox Job without a Dataset:
+
+```bash
+el job submit --type sandbox --runner base --command 'python --version'
+el job submit --type sandbox --runner base --image python:3.11 --wait
+el job list --type sandbox
+el job log JOB_ID --follow
+```
+
+The platform resolves `base` to the registered `envhub/base@main` source ref and
+freezes its immutable Revision. The Sandbox image defaults to `python:3.11`;
+`--image` accepts an image name, tag or digest. The execution provider is configured
+by the server. Job logs retain the actual captured output and collection metadata.
+Failures include a code, readable explanation, HTTP status when available, and
+recovery guidance without echoing arbitrary response bodies or credentials.
+
 ## Existing installations
 
 This distribution provides both the CLI and the `envloop` import package. Use a

{envloop_cli-0.2.0 → envloop_cli-0.3.0}/envloop/agent_runs.py

@@ -2,7 +2,7 @@
 
 The platform stores no run object. Agents tag every Train Job they create with
 ``user_metadata`` (the RSI loop: ``rsi_run``, ``rsi_round``, ``rsi_checkpoint``...);
-this module pages through ``GET /v1/train/jobs`` and derives runs from those tags,
+this module pages through ``GET /v1/job`` and derives runs from those tags,
 using the same rules as the Console's agent runs page.
 """
 
@@ -19,8 +19,8 @@ KEYS = {
     "checkpoint": ("agent_checkpoint", "rsi_checkpoint"),
 }
 RUN_KEYS = KEYS["run"]  # first non-empty string wins
-ACTIVE_STATUSES = frozenset({"LAUNCHING", "STARTING", "RUNNING", "RECOVERING"})
-TERMINAL_STATUSES = frozenset({"SUCCEEDED", "FAILED", "CANCELLED"})
+ACTIVE_STATUSES = frozenset({"LAUNCHING", "STARTING", "RUNNING", "RECOVERING", "queued", "pending", "starting", "running", "recovering", "cancelling"})
+TERMINAL_STATUSES = frozenset({"SUCCEEDED", "FAILED", "CANCELLED", "completed", "failed", "cancelled"})
 PAGE_LIMIT = 100  # the platform's maximum page size
 
 
@@ -70,7 +70,7 @@ def _round(job) -> int | None:
 
 def _order(job):
     # Creation order, as the platform pages jobs (newest first, reversed here).
-    return (str(job.get("created_at") or ""), str(job.get("train_job_id") or ""))
+    return (str(job.get("created_at") or ""), str(job.get("job_id") or job.get("train_job_id") or ""))
 
 
 def _duration_sec(job) -> int | None:
@@ -97,7 +97,7 @@ def _checkpoint(job) -> dict | None:
 def _job_view(job) -> dict:
     metadata = _metadata(job)
     return {
-        "train_job_id": job.get("train_job_id"),
+        "train_job_id": job.get("job_id") or job.get("train_job_id"),
         "status": job.get("status"),
         "round": _round(job),
         "purpose": _field(job, "purpose"),
@@ -121,11 +121,11 @@ def _summary(run: str, jobs: list) -> dict:
         status = "running"
     else:
         status = str(latest.get("status") or "unknown").lower()
-    succeeded = [job for job in jobs if job.get("status") == "SUCCEEDED"]
+    succeeded = [job for job in jobs if job.get("status") in {"SUCCEEDED", "completed"}]
     latest_saved = next((job for job in reversed(jobs) if _checkpoint(job) is not None), None)
     latest_checkpoint = _checkpoint(latest_saved) if latest_saved is not None else None
     if latest_checkpoint is not None:
-        latest_checkpoint["train_job_id"] = latest_saved.get("train_job_id")
+        latest_checkpoint["train_job_id"] = latest_saved.get("job_id") or latest_saved.get("train_job_id")
     rounds = [number for number in map(_round, jobs) if number is not None]
     activity = [stamp for job in jobs if isinstance(stamp := job.get("updated_at") or job.get("created_at"), str)]
     return {
@@ -172,7 +172,7 @@ class AgentRuns:
             if observed_at is None:
                 observed_at = page.get("observed_at")
             for job in page.get("items") or []:
-                job_id = job.get("train_job_id") if isinstance(job, dict) else None
+                job_id = job.get("job_id") or job.get("train_job_id") if isinstance(job, dict) else None
                 if not isinstance(job, dict) or job_id in ids:
                     continue
                 if job_id is not None:

{envloop_cli-0.2.0 → envloop_cli-0.3.0}/envloop/auth_cli.py

@@ -277,9 +277,12 @@ def run_auth(args, parser):
                             config=False, environment=False).list_jobs(limit=1)
                 report["check"] = "access_confirmed" if connection.api_key else "reachable_anonymous"
             except (ConfigError, RemoteError) as error:
+                from .cli_errors import format_error, safe_error_code
+
                 report["check"] = {401: "authentication_rejected", 403: "authorization_denied"}.get(
-                    getattr(error, "status_code", None), error.code)
+                    getattr(error, "status_code", None), safe_error_code(error))
                 _print(report, args.json)
+                print(format_error(error, args=args, program=parser.prog), file=sys.stderr)
                 return 1
     _print(report, getattr(args, "json", False))
     return 0