envloop-cli 1.4.0__tar.gz → 1.7.0__tar.gz

envloop_cli-1.7.0/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.5
+Name: envloop-cli
+Version: 1.7.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
+Requires-Dist: tinker==0.34.0
+Description-Content-Type: text/markdown
+
+# 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`
+commands are equivalent. The Python import package is `envloop`.
+
+## Version 1.7
+
+- Use published Runner resource shortcuts for Train Jobs and fixed Checkpoint inputs for Inference Jobs.
+- Pass `--json` explicitly to `job submit`; failures retain safe error codes and recovery guidance.
+- Submit training through Train Jobs. The retired interactive `envloop.training` interface is removed.
+
+After upgrading, check `el --version` and `el job submit --help`. Execution also
+requires a matching platform, project permissions and published Runners; package
+installation alone does not establish those prerequisites. See the
+[PyPI release history](https://pypi.org/project/envloop-cli/#history) for published versions.
+
+## Install
+
+Use a Python virtual environment:
+
+```bash
+python -m pip install --upgrade envloop-cli
+el --help
+```
+
+The standard installation includes the client dependencies for managed training.
+Check that the SDK can be imported:
+
+```bash
+python -c 'from envloop import Client; print("EnvLoop SDK ready")'
+```
+
+When you see `EnvLoop SDK ready`, continue to Connect. This check imports the
+client without creating a Job. Submit training through `client.training_jobs`;
+follow the [managed training guide](https://docs.envloop.ai/training/cli-hello-world).
+
+Install the client in your Python environment; the platform provides the execution resources.
+
+## Connect
+
+Use an authorized EnvLoop account and project. Browser authorization:
+
+```bash
+el auth login
+el auth status --check
+```
+
+For an existing project API key, use the masked configuration wizard:
+
+```bash
+el auth config
+el auth status --check
+```
+
+CI can read credentials from `ENVLOOP_API_KEY` and connection settings from
+`ENVLOOP_BASE_URL`, `ENVLOOP_WORKSPACE_ID` and `ENVLOOP_PROJECT_ID`. Keep keys in
+your secret manager. Public API access is scoped to the authorized project.
+
+Credentials and settings live in `~/.envloop` (override with an absolute
+`ENVLOOP_HOME`). On POSIX the directory must be private and owned by you. Use the
+default path when the optional environment variable is unset:
+
+```bash
+mkdir -p "${ENVLOOP_HOME:-$HOME/.envloop}"
+chmod 700 "${ENVLOOP_HOME:-$HOME/.envloop}"
+```
+
+An insecure directory causes `el` to fail with `CONFIG_INSECURE_PATH`.
+
+## Explore your project
+
+```bash
+el job 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 job list --type inference
+```
+
+Query a returned Job ID with `el job get JOB_ID` and `el job result JOB_ID`.
+Trial commands use the spelling `trail`, for example
+`el trail artifact list TRIAL_ID`. Use each command's `--help` for options.
+
+For the Python SDK:
+
+```python
+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
+fresh environment if you previously installed the separate source distribution
+named `envloop`, so two distributions do not own the same Python module files.
+Existing client configuration is reused; installing a package does not change
+your account permissions or move remote resources. Check `el --help` when
+upgrading because command groups may differ from your earlier installation.
+
+## Documentation
+
+- [English documentation](https://docs.envloop.ai/)
+- [中文文档](https://docs.envloop.ai/zh-cn/)
+- [Installation](https://docs.envloop.ai/cli-install)
+- [CLI reference](https://docs.envloop.ai/reference/cli)
+- [Training and deployment](https://docs.envloop.ai/training/train-deploy)
+- [Agent entry: skill.md](https://docs.envloop.ai/skill.md)
+
+## Submit managed training
+
+Prepare a recipe-supported `REQUEST.json` using the [SFT quickstart](https://docs.envloop.ai/training/quickstart).
+Training uses billable resources. Check your project permissions, balance and data format, then submit once:
+
+```bash
+el job submit --type train --file REQUEST.json
+el job get JOB_ID
+el job log JOB_ID --follow
+el job result JOB_ID
+el checkpoint list --job-id JOB_ID
+```
+
+Replace `JOB_ID` with the receipt's value. Read the training status and logs, then find the registered checkpoint after success.
+Ctrl-C ends log reading; to stop training, use `el job stop JOB_ID` and check its state and resource cleanup.
+See [Checkpoints](https://docs.envloop.ai/training/checkpoints) to download or delete saved weights.
+
+The built-in SFT recipe does not support custom loss, RL or optimizer-state resume.
+For an older interactive training script, follow the [managed training migration](https://docs.envloop.ai/training/sdk-compatibility).
+
+## Run a GPU Runner
+
+Choose a published Runner readable in your project. Save this request as `gpu-run.json`, replacing `FULL_COMMIT` with the full Revision from `el runner list --json`:
+
+```json
+{
+  "request_id": "gpu-run-001",
+  "trials": [
+    {"name": "first", "spec": {"runner": "envhub/bash-runner@FULL_COMMIT", "resources": {"gpu_type": "H100", "gpus": 4}, "timeout_sec": 600}},
+    {"name": "second", "spec": {"runner": "envhub/bash-runner@FULL_COMMIT", "resources": {"gpu_type": "H100", "gpus": 4}, "timeout_sec": 600}}
+  ]
+}
+```
+
+```bash
+el job submit --type train --file gpu-run.json
+el job get JOB_ID
+el job log JOB_ID --follow
+el job result JOB_ID
+```
+
+Replace `JOB_ID` with the returned value. The example has two independent Trials, each requesting four H100 GPUs: concurrent execution needs eight GPUs. Capacity and budget determine actual concurrency. Startup and execution are billable; check the Runner requirements, project `training.run` permission and [training prices](https://docs.envloop.ai/pricing) first. Reduce the Trial or GPU count when your program supports a smaller first run.
+
+The request file does not depend on GPU shortcut flags. If `el job submit --help` lists both `--trails` and `--gput-type`, you can instead use the shortcuts in [GPU Runner training](https://docs.envloop.ai/training/runner). Choose one submission method to avoid duplicate runs. The SDK accepts the same dictionary through `client.training_jobs.submit(request)`.
+
+The platform starts the published Revision’s `main.sh` / `main.py` using the Runner image; it does not upload local code. An optional command can only supply a declared `run_command` parameter. If this mode or GPU type is unavailable, contact your project administrator. Use `el job stop JOB_ID` to stop every Trial, then inspect each Trial’s `cleanup_confirmed` and download the uploaded artifacts you need.

envloop_cli-1.7.0/README.pypi.md

@@ -0,0 +1,182 @@
+# 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`
+commands are equivalent. The Python import package is `envloop`.
+
+## Version 1.7
+
+- Use published Runner resource shortcuts for Train Jobs and fixed Checkpoint inputs for Inference Jobs.
+- Pass `--json` explicitly to `job submit`; failures retain safe error codes and recovery guidance.
+- Submit training through Train Jobs. The retired interactive `envloop.training` interface is removed.
+
+After upgrading, check `el --version` and `el job submit --help`. Execution also
+requires a matching platform, project permissions and published Runners; package
+installation alone does not establish those prerequisites. See the
+[PyPI release history](https://pypi.org/project/envloop-cli/#history) for published versions.
+
+## Install
+
+Use a Python virtual environment:
+
+```bash
+python -m pip install --upgrade envloop-cli
+el --help
+```
+
+The standard installation includes the client dependencies for managed training.
+Check that the SDK can be imported:
+
+```bash
+python -c 'from envloop import Client; print("EnvLoop SDK ready")'
+```
+
+When you see `EnvLoop SDK ready`, continue to Connect. This check imports the
+client without creating a Job. Submit training through `client.training_jobs`;
+follow the [managed training guide](https://docs.envloop.ai/training/cli-hello-world).
+
+Install the client in your Python environment; the platform provides the execution resources.
+
+## Connect
+
+Use an authorized EnvLoop account and project. Browser authorization:
+
+```bash
+el auth login
+el auth status --check
+```
+
+For an existing project API key, use the masked configuration wizard:
+
+```bash
+el auth config
+el auth status --check
+```
+
+CI can read credentials from `ENVLOOP_API_KEY` and connection settings from
+`ENVLOOP_BASE_URL`, `ENVLOOP_WORKSPACE_ID` and `ENVLOOP_PROJECT_ID`. Keep keys in
+your secret manager. Public API access is scoped to the authorized project.
+
+Credentials and settings live in `~/.envloop` (override with an absolute
+`ENVLOOP_HOME`). On POSIX the directory must be private and owned by you. Use the
+default path when the optional environment variable is unset:
+
+```bash
+mkdir -p "${ENVLOOP_HOME:-$HOME/.envloop}"
+chmod 700 "${ENVLOOP_HOME:-$HOME/.envloop}"
+```
+
+An insecure directory causes `el` to fail with `CONFIG_INSECURE_PATH`.
+
+## Explore your project
+
+```bash
+el job 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 job list --type inference
+```
+
+Query a returned Job ID with `el job get JOB_ID` and `el job result JOB_ID`.
+Trial commands use the spelling `trail`, for example
+`el trail artifact list TRIAL_ID`. Use each command's `--help` for options.
+
+For the Python SDK:
+
+```python
+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
+fresh environment if you previously installed the separate source distribution
+named `envloop`, so two distributions do not own the same Python module files.
+Existing client configuration is reused; installing a package does not change
+your account permissions or move remote resources. Check `el --help` when
+upgrading because command groups may differ from your earlier installation.
+
+## Documentation
+
+- [English documentation](https://docs.envloop.ai/)
+- [中文文档](https://docs.envloop.ai/zh-cn/)
+- [Installation](https://docs.envloop.ai/cli-install)
+- [CLI reference](https://docs.envloop.ai/reference/cli)
+- [Training and deployment](https://docs.envloop.ai/training/train-deploy)
+- [Agent entry: skill.md](https://docs.envloop.ai/skill.md)
+
+## Submit managed training
+
+Prepare a recipe-supported `REQUEST.json` using the [SFT quickstart](https://docs.envloop.ai/training/quickstart).
+Training uses billable resources. Check your project permissions, balance and data format, then submit once:
+
+```bash
+el job submit --type train --file REQUEST.json
+el job get JOB_ID
+el job log JOB_ID --follow
+el job result JOB_ID
+el checkpoint list --job-id JOB_ID
+```
+
+Replace `JOB_ID` with the receipt's value. Read the training status and logs, then find the registered checkpoint after success.
+Ctrl-C ends log reading; to stop training, use `el job stop JOB_ID` and check its state and resource cleanup.
+See [Checkpoints](https://docs.envloop.ai/training/checkpoints) to download or delete saved weights.
+
+The built-in SFT recipe does not support custom loss, RL or optimizer-state resume.
+For an older interactive training script, follow the [managed training migration](https://docs.envloop.ai/training/sdk-compatibility).
+
+## Run a GPU Runner
+
+Choose a published Runner readable in your project. Save this request as `gpu-run.json`, replacing `FULL_COMMIT` with the full Revision from `el runner list --json`:
+
+```json
+{
+  "request_id": "gpu-run-001",
+  "trials": [
+    {"name": "first", "spec": {"runner": "envhub/bash-runner@FULL_COMMIT", "resources": {"gpu_type": "H100", "gpus": 4}, "timeout_sec": 600}},
+    {"name": "second", "spec": {"runner": "envhub/bash-runner@FULL_COMMIT", "resources": {"gpu_type": "H100", "gpus": 4}, "timeout_sec": 600}}
+  ]
+}
+```
+
+```bash
+el job submit --type train --file gpu-run.json
+el job get JOB_ID
+el job log JOB_ID --follow
+el job result JOB_ID
+```
+
+Replace `JOB_ID` with the returned value. The example has two independent Trials, each requesting four H100 GPUs: concurrent execution needs eight GPUs. Capacity and budget determine actual concurrency. Startup and execution are billable; check the Runner requirements, project `training.run` permission and [training prices](https://docs.envloop.ai/pricing) first. Reduce the Trial or GPU count when your program supports a smaller first run.
+
+The request file does not depend on GPU shortcut flags. If `el job submit --help` lists both `--trails` and `--gput-type`, you can instead use the shortcuts in [GPU Runner training](https://docs.envloop.ai/training/runner). Choose one submission method to avoid duplicate runs. The SDK accepts the same dictionary through `client.training_jobs.submit(request)`.
+
+The platform starts the published Revision’s `main.sh` / `main.py` using the Runner image; it does not upload local code. An optional command can only supply a declared `run_command` parameter. If this mode or GPU type is unavailable, contact your project administrator. Use `el job stop JOB_ID` to stop every Trial, then inspect each Trial’s `cleanup_confirmed` and download the uploaded artifacts you need.

{envloop_cli-1.4.0 → envloop_cli-1.7.0}/envloop/cli.py

@@ -133,11 +133,11 @@ def log_page_size(value):
 
 def runner_arguments(submit):
     submit.add_argument("--runner", metavar="NAME[@REVISION]",
-                        help="Agent: override the Dataset runner with NAME@REVISION; Sandbox: registered Runner name (for example base)")
+                        help="Agent/Train: namespace/name@REVISION; Sandbox: registered Runner name (for example base)")
     submit.add_argument("--job-id", help="caller-selected Job ID")
     submit.add_argument("--tag", help="run label")
     submit.add_argument("--priority", type=int, help="waiting priority; larger values run first (default: 0)")
-    submit.add_argument("--command", help="shell script override executed in the runner directory; preserves multiline text")
+    submit.add_argument("--command", help="Agent/Sandbox: shell override; Train: declared run_command parameter passed to the published Runner entrypoint; preserves multiline text")
 
 
 def parser():
@@ -153,10 +153,20 @@ def parser():
     from .auth_cli import add_auth_commands
 
     jobs = groups.add_parser("job", help="Submit and manage Agent, Sandbox, Train and Inference Jobs").add_subparsers(dest="action", required=True)
-    job_submit = jobs.add_parser("submit", help="Submit an Agent, Sandbox, Train or Inference Job")
+    job_submit = jobs.add_parser("submit", help="Submit an Agent, Sandbox, Train or Inference Job", allow_abbrev=False)
     job_submit.add_argument("--type", choices=("agent", "sandbox", "train", "inference"), default="agent", help="Job type (default: agent)")
-    job_submit.add_argument("--image", metavar="IMAGE", help="Sandbox Docker image override (server default: python:3.11)")
-    job_submit.add_argument("--file", type=Path, help="Train or Inference Job request JSON (spec or Train trials array)")
+    job_submit.add_argument("--image", metavar="IMAGE", help="Sandbox image override (server default: python:3.11); Train Runner: public spelling of --docker")
+    from .train_runner_cli import memory_mebibytes, positive_integer
+
+    job_submit.add_argument("--docker", metavar="IMAGE", help="Train Runner Docker image override; omitted uses the Runner declaration")
+    job_submit.add_argument("--trails", type=positive_integer, metavar="COUNT", help="Train Runner: 1–16 independent Trials (default: 1)")
+    job_submit.add_argument("--gput-type", metavar="MODEL", help="Train Runner: GPU model for each Trial (for example H100)")
+    job_submit.add_argument("--gpu", type=positive_integer, metavar="COUNT", help="Train Runner: positive GPU count per Trial")
+    job_submit.add_argument("--cpu", type=positive_integer, metavar="COUNT", help="Train Runner: positive CPU count per Trial")
+    for option in ('memory', 'disk', 'shm-size'):
+        job_submit.add_argument('--' + option, type=memory_mebibytes, metavar="SIZE",
+                                help="Train Runner: per-Trial size in Mi/Gi/Ti (for example 64Gi)")
+    job_submit.add_argument("--file", type=Path, help="Managed Train or Inference Job JSON (spec or Train trials array; interactive training is unsupported)")
     job_submit.add_argument("--source", type=Path, help="two-file directory for a single-task Job")
     job_submit.add_argument("--task-id", help="select one task within the dataset")
     job_submit.add_argument(
@@ -175,10 +185,11 @@ def parser():
                             help="named runtime Profile; omitted version requires an explicit default")
     job_submit.add_argument("--seed", type=int)
     job_submit.add_argument("--timeout-sec", type=wait_seconds,
-                            help="Agent/Sandbox execution timeout (whole seconds); Train wait timeout (default: 600)")
+                            help="Agent/Sandbox or Train Runner execution timeout (whole seconds); Train --file wait timeout (default: 600)")
     job_submit.add_argument("--delete-delay", type=nonnegative_seconds, metavar="SECONDS",
                             help="keep each sandbox (E2B or Fly) after completion for SECONDS (default: 0); cancellation/timeout delete immediately")
     job_submit.add_argument("--wait", action="store_true")
+    job_submit.add_argument("--json", action="store_true", help="Output the complete response as JSON (the default for submit; accepted for consistency with list commands)")
     for action in ("get", "stop", "result", "pause", "resume", "wake", "event"):
         command = jobs.add_parser(action)
         command.add_argument("job_id")
@@ -394,16 +405,27 @@ def main(argv=None):
             print(format_error(exc, args=args, program=cli.prog), file=sys.stderr)
             return 1
     if args.group == "job" and args.action == "submit":
+        from .train_runner_cli import SHORTCUT_FIELDS, runner_request
+
+        runner_mode = args.type == 'train' and args.file is None
+        if not runner_mode and any(getattr(args, key) is not None for key in SHORTCUT_FIELDS):
+            cli.error('Train Runner shortcuts require --type train --runner and cannot be combined with --file')
         if args.type in {"train", "inference"}:
-            if args.file is None:
+            if args.file is None and not runner_mode:
                 cli.error(f"--type {args.type} requires --file REQUEST.json")
             if args.type == 'inference' and (args.wait or args.timeout_sec is not None):
                 cli.error('Inference is a continuous service; --wait and --timeout-sec do not apply')
             agent_fields = ("dataset", "dataset_option", "source", "task_id", "config", "split", "revision",
-                            "runner", "job_id", "tag", "priority", "command", "attempts", "request_id",
-                            "profile", "seed", "delete_delay", "image")
+                            "job_id", "tag", "priority", "attempts", "profile", "seed", "delete_delay")
+            if not runner_mode:
+                agent_fields += ('runner', 'command', 'request_id', 'image')
             if any(getattr(args, key) is not None for key in agent_fields):
-                cli.error(f"--type {args.type} accepts its request through --file; Agent submission options cannot be combined")
+                cli.error(f"--type {args.type} cannot be combined with Agent submission options or mixed --file/Runner input")
+            if runner_mode:
+                try:
+                    args.train_request = runner_request(args)
+                except ValueError as exc:
+                    cli.error(str(exc))
         elif args.type == 'sandbox':
             from .sandbox import sandbox_runner_selector, validate_image
 
@@ -506,14 +528,15 @@ def main(argv=None):
                     if args.type == 'inference':
                         result = client.jobs.submit_inference(json.loads(args.file.read_text(encoding='utf-8')))
                     elif args.type == "train":
-                        result = client.training_jobs.submit(json.loads(args.file.read_text(encoding="utf-8")))
+                        request = args.train_request if args.file is None else json.loads(args.file.read_text(encoding="utf-8"))
+                        result = client.training_jobs.submit(request)
                     else:
                         result = client.jobs.submit(args.dataset, type=args.type, source=args.source, task_id=args.task_id,
                                                     attempts=args.attempts if args.attempts is not None else 1,
                                                     request_id=args.request_id, config=args.config, split=args.split,
                                                     revision=args.revision, **submission_options(args))
                     if args.wait:
-                        wait_options = {"timeout": args.timeout_sec} if args.type == "train" and args.timeout_sec is not None else {}
+                        wait_options = {"timeout": args.timeout_sec} if args.type == "train" and args.file is not None and args.timeout_sec is not None else {}
                         result = client.jobs.wait(result["job_id"], **wait_options)
                 elif args.action == 'event':
                     result = client.jobs.events(args.job_id)

{envloop_cli-1.4.0 → envloop_cli-1.7.0}/envloop/cli_errors.py

@@ -90,6 +90,11 @@ _register("RSI_CONTROL_UNCONFIGURED RSI_CONTROL_UNAVAILABLE RSI_CONTROL_TIMEOUT"
 _register("JOB_ACTION_UNSUPPORTED", "This Job type does not support the requested action.", "Check the Job type with '{program} job get JOB_ID' and use its supported actions.")
 _register("INFERENCE_ROUTE_RETIRED", "The global inference route has been retired.", "Use the owning Job's base URL: API_BASE/v1/job/JOB_ID/Inference, and a model deployed by that Job.")
 
+_register("CHECKPOINT_UNAVAILABLE CHECKPOINT_NOT_DURABLE CHECKPOINT_FILES_MISSING", "The fixed inference input is unavailable or not durable.", "Inspect checkpoint publication, expiry, deletion and permissions. Do not retry with different weights under the same request ID.")
+_register("CHECKPOINT_INTEGRITY_FAILED CHECKPOINT_FORMAT_UNSUPPORTED CHECKPOINT_BASE_MISMATCH", "The fixed input failed integrity or compatibility validation.", "Use a verified durable checkpoint matching the serving profile. A different input requires a new Job and request ID.")
+_register("INFERENCE_AUTHORIZATION_DENIED INFERENCE_AUTHORIZATION_UNAVAILABLE", "The platform could not authorize a new inference worker.", "Check current project membership and Runner/input access before waking or resuming the Job.")
+_register("INFERENCE_PROFILE_UNSUPPORTED INFERENCE_RUNNER_INVALID INFERENCE_MODEL_UNPINNED INFERENCE_RUNNER_IMAGE_MISMATCH INFERENCE_RUNNER_IMAGE_UNAVAILABLE INFERENCE_RUNTIME_UNAVAILABLE", "The selected Runner or frozen inference configuration is unavailable or unsupported.", "Discover a published compatible Runner and serving profile. Submit a new Job for changes to weights, base model or Runner.")
+
 # Public service identifiers verified against EnvPlatform. Keep unexpected codes
 # private even when they look uppercase: a server can echo a submitted secret in
 # that field. HTTP status still supplies useful recovery for newer service codes.

{envloop_cli-1.4.0 → envloop_cli-1.7.0}/envloop/client.py

@@ -548,10 +548,8 @@ class Jobs:
 
     def submit_inference(self, body: dict):
         """Submit a continuous inference deployment, identified by its Job ID."""
-        if not isinstance(body, dict) or set(body) - {'type', 'request_id', 'spec'} or body.get('type', 'inference') != 'inference':
-            raise ValueError('inference submission requires spec and request_id')
-        if not isinstance(body.get('spec'), dict):
-            raise ValueError('inference submission requires a spec object')
+        from .inference import validate_submission
+        validate_submission(body)
         return self._server.submit_job({'request_id': str(uuid4()), **body, 'type': 'inference'})
 
     def pause(self, job_id):
@@ -646,36 +644,11 @@ class Client:
 
         return TemporaryResources(self, **options)
 
-    def training_service(self, *, temporary_scope_id=None, **options):
-        """Use this EnvLoop connection for training without Tinker credentials/env.
+    def training_service(self, *args, **options):
+        """Removed: raise a pointer to managed Jobs."""
+        from .train import INTERACTIVE_TRAINING_REMOVED
 
-        The platform exchanges its Key for the training protocol's short-lived
-        token. Upstream token refresh follows the same platform URL and the
-        gateway rechecks the underlying subject and credential on every request.
-        """
-        from .training import ServiceClient
-        from .training.credentials import TrainingHttpClient
-
-        if 'http_client' in options:
-            raise ValueError('Client.training_service manages its authenticated HTTP client')
-        if any(name in options for name in ('base_url', 'api_key', 'default_headers')):
-            raise ValueError('Client.training_service manages its connection and credential headers')
-        overrides = options.get('default_headers_overrides') or {}
-        protected_headers = {'authorization', 'x-api-key', 'cookie', 'x-workspace-id',
-                             'x-project-id', 'x-envloop-temporary-scope'}
-        if any(name.lower() in protected_headers for name in overrides):
-            raise ValueError('Client.training_service manages authentication, project and temporary scope headers')
-        transport = self._transport
-        project_id = transport.headers.get("X-Project-ID", "")
-        if 'project_id' in options and options.pop('project_id') != project_id:
-            raise ValueError('Select the training project through Client.remote(project_id=...)')
-        token = transport.request("POST", "/v1/job/tinker/api/v1/auth/token", {})["jwt"]
-        headers = {name: value for name, value in transport.headers.items() if name in {"X-Workspace-ID", "X-Project-ID"}}
-        if temporary_scope_id is not None:
-            headers["X-EnvLoop-Temporary-Scope"] = temporary_scope_id
-        base_url = transport.base + "/v1/job/tinker"
-        return ServiceClient(base_url=base_url, api_key=token, project_id=project_id, default_headers=headers,
-                             http_client=TrainingHttpClient(base_url, transport.headers["Authorization"]), **options)
+        raise RuntimeError(INTERACTIVE_TRAINING_REMOVED)
 
     @classmethod
     def remote(cls, api_url=None, *, timeout=30, api_key=None, workspace_id=None, project_id=None, config=True):

envloop_cli-1.7.0/envloop/inference.py

@@ -0,0 +1,35 @@
+"""Public inference intent validation; resolution and admission remain server owned."""
+import re
+
+_FIELDS = {'name', 'runner', 'inputs', 'serving_profile', 'hardware', 'weights_format',
+           'scaling', 'temporary_scope_id'}
+
+
+def validate_submission(body):
+    if (not isinstance(body, dict) or set(body) - {'type', 'request_id', 'spec'}
+            or body.get('type', 'inference') != 'inference'):
+        raise ValueError('inference submission requires spec and request_id')
+    spec = body.get('spec')
+    if not isinstance(spec, dict):
+        raise ValueError('inference submission requires a spec object')
+    if 'request_id' in body and (not isinstance(body['request_id'], str)
+            or not body['request_id'].strip() or len(body['request_id']) > 128):
+        raise ValueError('request_id must be a non-empty string of at most 128 characters')
+    if any(key in spec for key in ('provider', 'executor', 'resolved_runner', 'runtime')):
+        raise ValueError('execution configuration and Runner resolution are owned by the server')
+    if 'runner' not in spec:
+        return  # Explicit legacy compatibility: existing adapter specs still reach the API.
+    if set(spec) - _FIELDS:
+        raise ValueError('fixed-input inference cannot mix legacy or runtime fields')
+    runner = spec['runner']
+    if (not isinstance(runner, str)
+            or not re.fullmatch(r'[A-Za-z0-9][A-Za-z0-9._-]*/[A-Za-z0-9][A-Za-z0-9._-]*@[^\s@]+', runner)):
+        raise ValueError('runner requires namespace/name@revision')
+    if any(not isinstance(spec.get(key), str) or not spec[key].strip()
+           for key in ('name', 'serving_profile')):
+        raise ValueError('fixed-input inference requires name and serving_profile')
+    inputs = spec.get('inputs', {})
+    if (not isinstance(inputs, dict) or set(inputs) - {'checkpoint'}
+            or 'checkpoint' in inputs and (not isinstance(inputs['checkpoint'], str)
+            or not inputs['checkpoint'].startswith('envloop://') or not inputs['checkpoint'][10:])):
+        raise ValueError('inputs accepts one Checkpoint ANS URI')

{envloop_cli-1.4.0 → envloop_cli-1.7.0}/envloop/resources.py

@@ -183,10 +183,6 @@ class TemporaryResources:
     def get(self):
         return self.client._transport.request("GET", self.path)
 
-    def training_service(self, **options):
-        self.path  # Fail before any authentication/session if the scope was not entered.
-        return self.client.training_service(temporary_scope_id=self.scope_id, **options)
-
     def retain(self, resources):
         return self.client._transport.request("POST", self.path + "/retain", {"resources": resources})
 

{envloop_cli-1.4.0 → envloop_cli-1.7.0}/envloop/train.py

@@ -3,19 +3,42 @@ import math
 import time
 from urllib.parse import quote, urlencode
 
+from .http import RemoteError
+
+INTERACTIVE_TRAINING_REMOVED = (
+    "Interactive training (envloop.training, Client.training_service) was removed; training is "
+    "managed Jobs only. Submit with `el job submit --type train --file REQUEST.json` "
+    "(or client.training_jobs.submit(request)) and discover recipes with "
+    "client.training_jobs.models(). See docs/training.md."
+)
+
 
 class TrainJobs:
     def __init__(self, transport):
         self.transport = transport
 
+    def models(self) -> dict:
+        """Discover configured managed recipes; admission and GPU readiness remain separate."""
+        try:
+            return self.transport.request('GET', '/v1/job/training-models')
+        except RemoteError as error:
+            if error.status_code == 404:
+                raise RuntimeError(
+                    "This platform does not serve /v1/job/training-models; upgrade the platform to a "
+                    "version that matches this client (managed training discovery is unavailable).") from error
+            raise
+
     @staticmethod
     def _view(result):
         return {**(result.get('training') or {}), **result}
 
     def submit(self, request: dict) -> dict:
-        """Submit one legacy spec or ``{request_id, trials: [{name?, spec}, ...]}``.
+        """Submit one managed spec or ``{request_id, trials: [{name?, spec}, ...]}``.
 
-        Each Trial spec is independent; validation and execution selection belong
+        Each Trial spec is an independent managed recipe or published Runner
+        (``{runner: "namespace/name@REVISION", resources?: {...}, ...}``).
+        Runner ``command`` is the declared run_command parameter, never an
+        entrypoint override. Validation, defaults and execution selection belong
         to the platform. The training view retains the server's complete response.
         """
         if not isinstance(request, dict) or request.get("type", "train") != "train":