envloop-cli 1.27.0__tar.gz → 1.28.0__tar.gz

{envloop_cli-1.27.0 → envloop_cli-1.28.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: envloop-cli
-Version: 1.27.0
+Version: 1.28.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
@@ -226,8 +226,8 @@ Choose a published Runner readable in your project. Save this request as `gpu-ru
 {
   "request_id": "gpu-run-001",
   "trials": [
-    {"name": "first", "spec": {"runner": "envloop/bash@FULL_COMMIT", "resources": {"gpu_type": "H100", "gpus": 4}, "timeout_sec": 600}},
-    {"name": "second", "spec": {"runner": "envloop/bash@FULL_COMMIT", "resources": {"gpu_type": "H100", "gpus": 4}, "timeout_sec": 600}}
+    {"name": "first", "spec": {"runner": "envloop/bash@FULL_COMMIT", "resources": {"gpu_type": "H100", "gpus": 4}, "timeout_seconds": 600}},
+    {"name": "second", "spec": {"runner": "envloop/bash@FULL_COMMIT", "resources": {"gpu_type": "H100", "gpus": 4}, "timeout_seconds": 600}}
   ]
 }
 ```
@@ -272,7 +272,7 @@ with Client.remote() as client:
 ```
 
 Use the exact model returned by the Job. The SDK forwards the payload to the
-Job's `/Inference/decision` API; the approved plugin validates its business fields.
+Job's `/inference/decision` API; the approved plugin validates its business fields.
 Availability requires matching platform support and approved content in your project.
 
 ## ANS data and verified downloads

{envloop_cli-1.27.0 → envloop_cli-1.28.0}/README.pypi.md

@@ -209,8 +209,8 @@ Choose a published Runner readable in your project. Save this request as `gpu-ru
 {
   "request_id": "gpu-run-001",
   "trials": [
-    {"name": "first", "spec": {"runner": "envloop/bash@FULL_COMMIT", "resources": {"gpu_type": "H100", "gpus": 4}, "timeout_sec": 600}},
-    {"name": "second", "spec": {"runner": "envloop/bash@FULL_COMMIT", "resources": {"gpu_type": "H100", "gpus": 4}, "timeout_sec": 600}}
+    {"name": "first", "spec": {"runner": "envloop/bash@FULL_COMMIT", "resources": {"gpu_type": "H100", "gpus": 4}, "timeout_seconds": 600}},
+    {"name": "second", "spec": {"runner": "envloop/bash@FULL_COMMIT", "resources": {"gpu_type": "H100", "gpus": 4}, "timeout_seconds": 600}}
   ]
 }
 ```
@@ -255,7 +255,7 @@ with Client.remote() as client:
 ```
 
 Use the exact model returned by the Job. The SDK forwards the payload to the
-Job's `/Inference/decision` API; the approved plugin validates its business fields.
+Job's `/inference/decision` API; the approved plugin validates its business fields.
 Availability requires matching platform support and approved content in your project.
 
 ## ANS data and verified downloads

{envloop_cli-1.27.0 → envloop_cli-1.28.0}/envloop/_optional.py

@@ -16,11 +16,11 @@ from typing import Any, override
 FEATURES = {'data': 'envloop_data', 'experiment': 'envloop_experiment', 'rsi-loop': 'envloop_rsi_loop'}
 FEATURE_COMMANDS = {
     'data': {
-        'dataset': 'Discover datasets, revisions and tasks',
+        'dataset': 'Discover Datasets, revisions and tasks',
         'data': 'Manage versioned Data resources and verified file downloads',
         'runner': 'Discover available Runner revisions',
-        'checkpoint': 'List and download saved training checkpoints',
-        'profile': 'Manage platform runtime profiles',
+        'checkpoint': 'List and download saved training Checkpoints',
+        'profile': 'Manage platform runtime Profiles',
     },
     'experiment': {
         'job': 'Submit and manage Agent, Sandbox, Train and Inference Jobs',

{envloop_cli-1.27.0 → envloop_cli-1.28.0}/envloop/auth_cli.py

@@ -8,6 +8,8 @@ from typing import Any, cast
 from .config import ConfigError, ConfigStore, normalize_url, validate_key
 
 DEFAULT_BASE_URL = "https://api.envloop.ai"
+CONFIG_FIELDS = ["base-url", "api-key", "workspace-id", "project-id"]
+FIELD_HELP = "One of " + ", ".join(CONFIG_FIELDS)
 
 
 def add_auth_commands(groups: "argparse._SubParsersAction[argparse.ArgumentParser]") -> None:
@@ -23,29 +25,29 @@ def add_auth_commands(groups: "argparse._SubParsersAction[argparse.ArgumentParse
     actions = configure.add_subparsers(dest="config_action")
     init = actions.add_parser("init", help="Configure interactively with masked API key input")
     init.add_argument("--no-check", action="store_true", default=argparse.SUPPRESS, help="Save without API verification (offline)")
-    project = actions.add_parser("project", help="Select and verify a project with its own API key")
-    project.add_argument("project_id", nargs="?", help="Project ID; omit for an interactive list with names and IDs")
-    project.add_argument("--stdin", action="store_true", help="Read the selected project's API key from stdin")
+    project = actions.add_parser("project", help="Select and verify a Project with its own API key")
+    project.add_argument("project_id", metavar="PROJECT_ID", nargs="?", help="Project ID; omit for an interactive list with names and IDs")
+    project.add_argument("--stdin", action="store_true", help="Read the selected Project's API key from stdin")
     setting = actions.add_parser("set", help="Save one field (API key is masked or read from stdin)")
-    setting.add_argument("field", choices=["base-url", "api-key", "workspace-id", "project-id"])
-    setting.add_argument("value", nargs="?", help=f"Base URL (default: {DEFAULT_BASE_URL}) or workspace ID; API keys use masked input or --stdin")
+    setting.add_argument("field", metavar="FIELD", choices=CONFIG_FIELDS, help=FIELD_HELP)
+    setting.add_argument("value", metavar="VALUE", nargs="?", help=f"Base URL (default: {DEFAULT_BASE_URL}) or Workspace ID; API keys use masked input or --stdin")
     setting.add_argument("--stdin", action="store_true", help="Read a single API key from stdin")
     setting.add_argument("--no-check", action="store_true", default=argparse.SUPPRESS, help="Save API key without verification (offline)")
     getting = actions.add_parser("get", help="Read saved configuration; never export an API key")
-    getting.add_argument("field", choices=["base-url", "api-key", "workspace-id", "project-id"])
+    getting.add_argument("field", metavar="FIELD", choices=CONFIG_FIELDS, help=FIELD_HELP)
     actions.add_parser("path", help="Print configuration and credential file paths")
     show = actions.add_parser("show", help="Show saved and effective settings without revealing keys")
     show.add_argument("--json", action="store_true")
     remove = actions.add_parser("unset", help="Delete a saved field; does not revoke the server key")
-    remove.add_argument("field", choices=["base-url", "api-key", "workspace-id", "project-id"])
+    remove.add_argument("field", metavar="FIELD", choices=CONFIG_FIELDS, help=FIELD_HELP)
     status = commands.add_parser("status", help="Inspect local credentials; --check verifies read access")
     status.add_argument("--check", action="store_true", help="Make a read-only request to the effective Base URL")
     status.add_argument("--json", action="store_true")
     commands.add_parser("logout", help="Remove the saved key for the stored default Base URL (local only)")
-    workspace = commands.add_parser("workspace", help="Select and verify the active workspace")
-    workspace.add_argument("workspace_id", nargs="?", help="Workspace ID; omit for an interactive list")
-    workspace.add_argument("--project-id", help="Project within the workspace; its own API key is required")
-    workspace.add_argument("--stdin", action="store_true", help="Read the selected workspace's API key from stdin")
+    workspace = commands.add_parser("workspace", help="Select and verify the active Workspace")
+    workspace.add_argument("workspace_id", metavar="WORKSPACE_ID", nargs="?", help="Workspace ID; omit for an interactive list")
+    workspace.add_argument("--project-id", help="Project within the Workspace; its own API key is required")
+    workspace.add_argument("--stdin", action="store_true", help="Read the selected Workspace's API key from stdin")
 
 
 def _key_from_input(stdin: bool = False) -> str:

{envloop_cli-1.27.0 → envloop_cli-1.28.0}/envloop/lifecycle_cli.py

@@ -6,7 +6,7 @@ from typing import Any
 
 
 def wait_options(parser: argparse.ArgumentParser):
-    parser.add_argument('--wait', action='store_true', help='Wait for the persisted cleanup operation')
+    parser.add_argument('--wait', action='store_true', help='Wait for the persisted cleanup Operation')
     parser.add_argument('--timeout-seconds', type=float, default=600)
 
 
@@ -14,10 +14,10 @@ def add_management_commands(settings: "argparse._SubParsersAction[argparse.Argum
     operations = settings.add_parser('operation', help='Inspect or retry persisted cleanup').add_subparsers(dest='operation_action', required=True)
     for action in ('get', 'retry', 'wait'):
         command = operations.add_parser(action)
-        command.add_argument('identifier')
+        command.add_argument('identifier', metavar='OPERATION_ID')
         if action == 'wait':
             command.add_argument('--timeout-seconds', type=float, default=600)
-    cleanup = settings.add_parser('cleanup', help='Clean an explicit set of project resource IDs')
+    cleanup = settings.add_parser('cleanup', help='Clean an explicit set of Project resource IDs')
     cleanup.add_argument('--file', type=Path, required=True, help='JSON array of resource kind and ID objects')
     cleanup.add_argument('--request-id', required=True)
     wait_options(cleanup)
@@ -27,7 +27,7 @@ def add_management_commands(settings: "argparse._SubParsersAction[argparse.Argum
     create.add_argument('--request-id', required=True)
     for action in ('get', 'cleanup', 'retain'):
         command = scopes.add_parser(action)
-        command.add_argument('identifier')
+        command.add_argument('identifier', metavar='RESOURCE_SCOPE_ID')
         if action == 'cleanup':
             wait_options(command)
         if action == 'retain':

{envloop_cli-1.27.0 → envloop_cli-1.28.0}/envloop/resource_cli.py

@@ -17,10 +17,10 @@ def listing(commands: "argparse._SubParsersAction[argparse.ArgumentParser]", *,
 
 
 def add_resource_commands(groups: "argparse._SubParsersAction[argparse.ArgumentParser]") -> None:
-    dashboard = groups.add_parser('dashboard', help='Inspect the current project overview').add_subparsers(dest='action', required=True)
-    dashboard.add_parser('get', help='Show project details and recent experiment pages')
+    dashboard = groups.add_parser('dashboard', help='Inspect the current Project overview').add_subparsers(dest='action', required=True)
+    dashboard.add_parser('get', help='Show Project details and recent experiment pages')
 
-    billing = groups.add_parser('billing', help='Inspect project billing and recorded usage').add_subparsers(dest='resource', required=True)
+    billing = groups.add_parser('billing', help='Inspect Project billing and recorded usage').add_subparsers(dest='resource', required=True)
     for resource in ('account', 'usage', 'ledger', 'price'):
         commands = billing.add_parser(resource, help=f'Inspect billing {resource}').add_subparsers(dest='action', required=True)
         command = commands.add_parser('get', help='Show the billing account') if resource == 'account' else listing(commands, paged=False)
@@ -31,27 +31,27 @@ def add_resource_commands(groups: "argparse._SubParsersAction[argparse.ArgumentP
         if resource == 'ledger':
             command.add_argument('--limit', type=int, default=25)
 
-    limits = groups.add_parser('limit', help='Inspect project resource limits').add_subparsers(dest='action', required=True)
+    limits = groups.add_parser('limit', help='Inspect Project resource limits').add_subparsers(dest='action', required=True)
     limits.add_parser('get', help='Read effective execution limits, compose Runner state and the registry credential '
                       'count (read-only)')
-    members = groups.add_parser('member', help='Manage project members subject to server authorization').add_subparsers(dest='action', required=True)
+    members = groups.add_parser('member', help='Manage Project members subject to server authorization').add_subparsers(dest='action', required=True)
     listing(members, paged=False)
-    candidates = members.add_parser('candidate', help='Find eligible project members').add_subparsers(dest='candidate_action', required=True)
-    listing(candidates, paged=False, help='List eligible project members matching a query').add_argument('--query', required=True)
+    candidates = members.add_parser('candidate', help='Find eligible Project members').add_subparsers(dest='candidate_action', required=True)
+    listing(candidates, paged=False, help='List eligible Project members matching a query').add_argument('--query', required=True)
     for action in ('add', 'update', 'remove'):
-        command = members.add_parser(action, help=f'{action.capitalize()} a project membership (human-session authorization required)')
-        command.add_argument('user_id')
+        command = members.add_parser(action, help=f'{action.capitalize()} a Project membership (human-session authorization required)')
+        command.add_argument('user_id', metavar='USER_ID')
         if action != 'remove':
             command.add_argument('--role', choices=['viewer', 'developer', 'admin'], default='developer')
         command.add_argument('--expected-version', required=True, type=int, help='Current membership version; use 0 for a new grant')
 
-    settings = groups.add_parser('setting', help='Inspect and update the current project settings').add_subparsers(dest='action', required=True)
-    settings.add_parser('get', help='Show current project settings')
-    update = settings.add_parser('update', help='Change project fields (human-session authorization required)')
+    settings = groups.add_parser('setting', help='Inspect and update the current Project settings').add_subparsers(dest='action', required=True)
+    settings.add_parser('get', help='Show current Project settings')
+    update = settings.add_parser('update', help='Change Project fields (human-session authorization required)')
     for field in ('name', 'slug', 'region'):
         update.add_argument('--' + field)
     update.add_argument('--expected-version', required=True, type=int)
-    archive = settings.add_parser('archive', help='Archive the project (human-session authorization required)')
+    archive = settings.add_parser('archive', help='Archive the Project (human-session authorization required)')
     archive.add_argument('--expected-version', required=True, type=int)
     from .lifecycle_cli import add_management_commands
     add_management_commands(settings)
@@ -89,40 +89,40 @@ def _revision(value: str) -> str:
 
 def add_self_service_commands(settings: "argparse._SubParsersAction[argparse.ArgumentParser]") -> None:
     """Project Admin settings that also work with an API key whose ceiling includes them."""
-    registry = settings.add_parser('registry', help='Manage private registry credentials for this project\'s images'
+    registry = settings.add_parser('registry', help='Manage private registry credentials for this Project\'s images'
                                    ).add_subparsers(dest='registry_action', required=True)
     listing(registry, paged=False, help='List registry credentials (metadata only; secrets are write-only)')
-    add = registry.add_parser('add', help='Register a write-only registry credential (project Admin)')
+    add = registry.add_parser('add', help='Register a write-only registry credential (Project Admin)')
     add.add_argument('--registry', required=True, help='Registry host, for example ghcr.io')
     add.add_argument('--repository-prefix', required=True, help='Repository prefix the credential covers, for example my-org')
     add.add_argument('--username', required=True)
     add.add_argument('--password-stdin', action='store_true',
                      help='Read the token or password from stdin; without it you are prompted (no echo)')
     add.add_argument('--password', '--token', nargs='?', action=_RejectSecretArgument, help=argparse.SUPPRESS)
-    remove = registry.add_parser('remove', help='Remove a credential; later image pulls no longer receive it (project Admin)')
-    remove.add_argument('credential_id')
-    compose = settings.add_parser('compose', help='Compose Runner (multi-container Task) access for this project'
+    remove = registry.add_parser('remove', help='Remove a credential; later image pulls no longer receive it (Project Admin)')
+    remove.add_argument('credential_id', metavar='CREDENTIAL_ID')
+    compose = settings.add_parser('compose', help='Compose Runner (multi-container Task) access for this Project'
                                   ).add_subparsers(dest='compose_action', required=True)
     compose.add_parser('get', help='Show the effective state, the reason and the platform bounds')
-    compose.add_parser('enable', help='Request compose Runners; the platform policy may need operator approval (project Admin)')
-    compose.add_parser('disable', help='Withdraw this project\'s compose Runner request (project Admin)')
-    concurrency = settings.add_parser('concurrency', help='Concurrent Trial limit of this project'
+    compose.add_parser('enable', help='Request compose Runners; the platform policy may need operator approval (Project Admin)')
+    compose.add_parser('disable', help='Withdraw this Project\'s compose Runner request (Project Admin)')
+    concurrency = settings.add_parser('concurrency', help='Concurrent Trial limit of this Project'
                                       ).add_subparsers(dest='concurrency_action', required=True)
-    command = concurrency.add_parser('set', help='Lower the project limit below the operator ceiling, or none to clear it '
-                                     '(project Admin)')
+    command = concurrency.add_parser('set', help='Lower the Project limit below the operator ceiling, or none to clear it '
+                                     '(Project Admin)')
     command.add_argument('value', type=_concurrency, metavar='VALUE', help='1..10000 or none')
-    model = settings.add_parser('model-access', help='Metered model access for published Runners of this project'
+    model = settings.add_parser('model-access', help='Metered model access for published Runners of this Project'
                                 ).add_subparsers(dest='model_access_action', required=True)
     listing(model, paged=False, help='List grants and whether the platform can deliver them now')
-    grant = model.add_parser('grant', help='Let one published Runner receive the project\'s metered model key on Fly '
-                             'Trials (project Admin)')
+    grant = model.add_parser('grant', help='Let one published Runner receive the Project\'s metered model key on Fly '
+                             'Trials (Project Admin)')
     grant.add_argument('runner', type=_runner_name, metavar='NAMESPACE/NAME', help='Published Runner name')
     grant.add_argument('--protocol', dest='protocols', action='append', choices=['anthropic', 'openai'], required=True,
                        help='Model protocol to grant; repeat for both')
     grant.add_argument('--revision', type=_revision, help='Limit the grant to one full commit Revision')
     revoke = model.add_parser('revoke', help='Revoke a grant; Trials that have not started no longer get the key '
-                              '(project Admin)')
-    revoke.add_argument('grant_id')
+                              '(Project Admin)')
+    revoke.add_argument('grant_id', metavar='GRANT_ID')
 
 
 def _read_secret(args: argparse.Namespace) -> str:

{envloop_cli-1.27.0 → envloop_cli-1.28.0}/packages/data/envloop_data/cli.py

@@ -79,10 +79,10 @@ def secret_option(command: argparse.ArgumentParser) -> None:
 
 
 def add_commands(groups: "argparse._SubParsersAction[argparse.ArgumentParser]") -> None:
-    profiles = groups.add_parser("profile", help="Manage platform runtime profiles").add_subparsers(dest="action", required=True)
+    profiles = groups.add_parser("profile", help="Manage platform runtime Profiles").add_subparsers(dest="action", required=True)
     put = profiles.add_parser("create", help="Create an immutable Profile version from TOML or JSON")
-    put.add_argument("name")
-    put.add_argument("version")
+    put.add_argument("name", metavar="NAME")
+    put.add_argument("version", metavar="VERSION")
     put.add_argument("--file", type=Path, required=True, help="Profile TOML or JSON file")
     put.add_argument("--runner", metavar="RUNNER", help="Bind a Runner revision to this version")
     secret_input = put.add_mutually_exclusive_group()
@@ -90,8 +90,8 @@ def add_commands(groups: "argparse._SubParsersAction[argparse.ArgumentParser]")
     secret_input.add_argument("--model-api-key-stdin", action="store_true", help="Read the model API key from one line of standard input")
     secret_option(put)
     update = profiles.add_parser("update", help="Edit an existing Profile by publishing a new immutable version")
-    update.add_argument("name")
-    update.add_argument("version", help="New version; existing versions cannot be overwritten")
+    update.add_argument("name", metavar="NAME")
+    update.add_argument("version", metavar="VERSION", help="New version; existing versions cannot be overwritten")
     update.add_argument("--from-version", help="Source version; omit to use default, then newest unarchived creation")
     update.add_argument("--file", type=Path, required=True, help="TOML or JSON patch: merge params keys, replace supplied metadata; preserve omitted fields")
     update.add_argument("--runner", metavar="RUNNER", help="Bind a Runner revision; v1 requires a full commit; omit to preserve the source binding")
@@ -100,13 +100,13 @@ def add_commands(groups: "argparse._SubParsersAction[argparse.ArgumentParser]")
     update_secret.add_argument("--model-api-key-stdin", action="store_true", help="Read an encrypted model connection key from one line of standard input")
     secret_option(update)
     fork = profiles.add_parser('fork', help='Fork an existing Profile into a new immutable identity')
-    fork.add_argument('source_name')
-    fork.add_argument('source_version')
-    fork.add_argument('name')
-    fork.add_argument('version')
+    fork.add_argument('source_name', metavar='SOURCE_NAME')
+    fork.add_argument('source_version', metavar='SOURCE_VERSION')
+    fork.add_argument('name', metavar='NAME')
+    fork.add_argument('version', metavar='VERSION')
     secret_option(fork)
     get = profiles.add_parser("get")
-    get.add_argument("name")
+    get.add_argument("name", metavar="NAME")
     get.add_argument("--version")
     listing = profiles.add_parser("list")
     listing.add_argument("--name")
@@ -115,13 +115,13 @@ def add_commands(groups: "argparse._SubParsersAction[argparse.ArgumentParser]")
     listing.add_argument("--cursor")
     listing.add_argument("--json", action="store_true", help="Output the complete response as JSON (default: table)")
     default = profiles.add_parser("set-default")
-    default.add_argument("name")
-    default.add_argument("version")
+    default.add_argument("name", metavar="NAME")
+    default.add_argument("version", metavar="VERSION")
     default.add_argument("--expected-version", help="Omit only when no default exists")
     for command in ("archive", "export"):
         item = profiles.add_parser(command)
-        item.add_argument("name")
-        item.add_argument("version")
+        item.add_argument("name", metavar="NAME")
+        item.add_argument("version", metavar="VERSION")
     from envloop_data.resource_cli import add_resource_commands
     add_resource_commands(groups)
 

{envloop_cli-1.27.0 → envloop_cli-1.28.0}/packages/data/envloop_data/cli_output.py

@@ -38,9 +38,9 @@ def list_layout(items: list[dict[str, Any]], args: argparse.Namespace) -> tuple[
         render = dataset_row
         empty = 'No datasets found.'
     elif args.group == 'checkpoint':
-        headers = ('CHECKPOINT ID', 'TYPE', 'MODEL', 'TRAIN JOB ID', 'URI')
+        headers = ('CHECKPOINT ID', 'TYPE', 'MODEL', 'JOB ID', 'URI')
         render = lambda item: (item.get('checkpoint_id'), item.get('checkpoint_type'), item.get('base_model'),
-                               item.get('job_id') or item.get('train_job_id'), item.get('uri'))
+                               item.get('job_id'), item.get('uri'))
         empty = 'No checkpoints found.'
     elif args.group == "profile" and args.name is None:
         headers = ("NAME", "VERSIONS", "DEFAULT", "UPDATED AT")

{envloop_cli-1.27.0 → envloop_cli-1.28.0}/packages/data/envloop_data/data_cli.py

@@ -18,14 +18,14 @@ from envloop_data.data_publications import (
 
 
 def add_commands(groups: "argparse._SubParsersAction[argparse.ArgumentParser]", listing: Callable[[Any], argparse.ArgumentParser]):
-    data = groups.add_parser('data', help='Manage project ANS resources and verified downloads').add_subparsers(dest='action', required=True)
+    data = groups.add_parser('data', help='Manage Project ANS resources and verified downloads').add_subparsers(dest='action', required=True)
     command = listing(data)
     command.add_argument('--type', required=True, choices=[*KINDS, 'artifact'])
     for option in ('ref', 'job-id', 'trial-id'):
         command.add_argument('--' + option)
     for action in ('get', 'files'):
         command = data.add_parser(action, help='Read a resource and its files' if action == 'get' else 'List one page of files')
-        command.add_argument('data_id')
+        command.add_argument('data_id', metavar='DATA_ID')
         command.add_argument('--limit', type=int, default=25)
         command.add_argument('--cursor')
         command.add_argument('--json', action='store_true')
@@ -35,15 +35,15 @@ def add_commands(groups: "argparse._SubParsersAction[argparse.ArgumentParser]",
         command = data.add_parser(action, help='Register native content or HF metadata' if action == 'create' else 'Register a new immutable revision')
         command.add_argument('--type', required=action == 'create', choices=KINDS)
         if action == 'update':
-            command.add_argument('data_id')
+            command.add_argument('data_id', metavar='DATA_ID')
         publication_arguments(command, source=True)
         command.add_argument('--idempotency-key', help='Reuse for a resumable multipart retry of the same input')
-    command = data.add_parser('delete', help='Retire a project registration; retain immutable content')
-    command.add_argument('data_id')
+    command = data.add_parser('delete', help='Retire a Project registration; retain immutable content')
+    command.add_argument('data_id', metavar='DATA_ID')
     command.add_argument('--dry-run', action='store_true', help='Check authorization and preview without revoking')
     command.add_argument('--json', action='store_true')
     command = data.add_parser('download', help='Download and verify an ANS directory or one resource file')
-    command.add_argument('data_id')
+    command.add_argument('data_id', metavar='DATA_ID')
     command.add_argument('--file', dest='file_id', help='Select one file by its resource file ID')
     command.add_argument('--split', help='Select the complete Dataset split directory')
     command.add_argument('--output', required=True, type=Path)
@@ -57,7 +57,7 @@ def add_commands(groups: "argparse._SubParsersAction[argparse.ArgumentParser]",
     command.add_argument('--parent-id', help='Existing publication when creating a new revision')
     for action in ('get', 'part', 'complete', 'abort'):
         command = uploads.add_parser(action, help=f'{action.capitalize()} a multipart upload')
-        command.add_argument('upload_id')
+        command.add_argument('upload_id', metavar='UPLOAD_ID')
         command.add_argument('--json', action='store_true')
         if action == 'part':
             command.add_argument('--number', type=int, required=True)
@@ -65,7 +65,7 @@ def add_commands(groups: "argparse._SubParsersAction[argparse.ArgumentParser]",
 
 
     command = uploads.add_parser('harbor', help='Upload a private Harbor task directory or tar bundle; optionally register it for Jobs')
-    command.add_argument('source', type=Path)
+    command.add_argument('source', metavar='SOURCE', type=Path)
     command.add_argument('--name', required=True, help='Dataset name as NAMESPACE/NAME')
     command.add_argument('--version', required=True, help='Exact version from dataset.toml')
     command.add_argument('--register', action='store_true', help='Register the uploaded snapshot with the selected Runner')
@@ -74,12 +74,12 @@ def add_commands(groups: "argparse._SubParsersAction[argparse.ArgumentParser]",
     command.add_argument('--idempotency-key', help='Stable upload key; identical input resumes by default')
     command.add_argument('--json', action='store_true')
     command = data.add_parser('register', help='Register an uploaded Harbor Dataset snapshot for Jobs')
-    command.add_argument('data_id')
+    command.add_argument('data_id', metavar='DATA_ID')
     command.add_argument('--runner', required=True, help='Existing Runner NAME@REVISION')
     command.add_argument('--wait', action='store_true', help='Wait until registration finishes (default: return after it starts)')
     command.add_argument('--json', action='store_true')
     command = data.add_parser('registration', help='Read and advance Harbor Dataset registration')
-    command.add_argument('data_id')
+    command.add_argument('data_id', metavar='DATA_ID')
     command.add_argument('--json', action='store_true')
 
 

{envloop_cli-1.27.0 → envloop_cli-1.28.0}/packages/data/envloop_data/http.py

@@ -58,9 +58,9 @@ class Endpoints:
         return {"kind": "dataset", **{key: matches[0][key] for key in ("name", "version", "manifest_sha256")}}
 
 
-    def open_checkpoint_archive(self, train_job_id: str) -> Download:
+    def open_checkpoint_archive(self, job_id: str) -> Download:
         """Read a local mock checkpoint through its authenticated public API route."""
-        path = f"/v1/job/{quote(train_job_id, safe='')}/checkpoint/download"
+        path = f"/v1/jobs/{quote(job_id, safe='')}/checkpoint/download"
         try:
             return Download(self.opener.open(Request(self.base + path, headers=self.headers), timeout=self.timeout))
         except HTTPError as error:

{envloop_cli-1.27.0 → envloop_cli-1.28.0}/packages/data/envloop_data/navigation_resources.py

@@ -61,10 +61,10 @@ class Datasets:
         return self.transport.request('GET', query(path, limit=limit, cursor=cursor))
 
 
-def _checkpoint_matches(path: str, item: dict[str, Any]) -> bool:
-    if path in {item.get('checkpoint_id'), item.get('uri'), item.get('model_uri'), item.get('ans_uri')}:
+def _checkpoint_matches(checkpoint: str, item: dict[str, Any]) -> bool:
+    if checkpoint in {item.get('checkpoint_id'), item.get('uri'), item.get('model_uri')}:
         return True
-    parsed = urlsplit(path)
+    parsed = urlsplit(checkpoint)
     if parsed.scheme not in {'envloop', 'tinker'} or parsed.query or parsed.fragment:
         return False
     name = parsed.path.lstrip('/')
@@ -128,12 +128,12 @@ class Checkpoints:
     def list(self, **filters: Any) -> Any:
         if self.training is not None:
             return self.training.checkpoints(**filters)
-        return self.transport.request('GET', '/v1/job/checkpoints?' + urlencode({key: value for key, value in filters.items() if value is not None}))
+        return self.transport.request('GET', '/v1/checkpoints?' + urlencode({key: value for key, value in filters.items() if value is not None}))
 
     def delete(self, checkpoint_id: str) -> Any:
-        return self.transport.request('DELETE', f"/v1/job/checkpoints/{quote(checkpoint_id, safe='')}")
+        return self.transport.request('DELETE', f"/v1/checkpoints/{quote(checkpoint_id, safe='')}")
 
-    def download(self, path: str, directory: str | Path, *, job_id: str | None = None, run_id: str | None = None) -> dict[str, Any]:
+    def download(self, checkpoint: str, directory: str | Path, *, job_id: str | None = None, run_id: str | None = None) -> dict[str, Any]:
         from pathlib import Path
 
         directory = Path(directory)
@@ -141,7 +141,7 @@ class Checkpoints:
         while True:
             page = self.list(job_id=job_id, run_id=run_id, cursor=cursor, limit=100)
             for item in page['items']:
-                if _checkpoint_matches(path, item):
+                if _checkpoint_matches(checkpoint, item):
                     matches.append(item)
             cursor = page.get('next_cursor')
             if cursor is None:
@@ -172,7 +172,7 @@ class Checkpoints:
 
             def refresh(self) -> None:
                 # Keep the original authorized identity and file hashes across refreshes.
-                signed = transport.request('GET', query('/v1/job/checkpoints/download', path=path,
+                signed = transport.request('GET', query('/v1/checkpoints/download', uri=checkpoint,
                                                         job_id=item['job_id'], run_id=run_id))
                 urls = signed.get('urls', {})
                 if (set(names) != set(urls)
@@ -210,7 +210,7 @@ class Checkpoints:
         import tempfile
         import zipfile
 
-        job_id = item.get('train_job_id')
+        job_id = item.get('job_id')
         if not isinstance(job_id, str) or not job_id:
             raise RemoteError('CHECKPOINT_FILES_INVALID')
         # Bound the streamed archive by its declared payload plus ZIP metadata.

{envloop_cli-1.27.0 → envloop_cli-1.28.0}/packages/data/envloop_data/resource_cli.py

@@ -6,21 +6,21 @@ from envloop.resource_cli import listing
 
 
 def add_resource_commands(groups: "argparse._SubParsersAction[argparse.ArgumentParser]"):
-    datasets = groups.add_parser('dataset', help='Discover datasets, revisions and tasks').add_subparsers(dest='action', required=True)
+    datasets = groups.add_parser('dataset', help='Discover Datasets, revisions and tasks').add_subparsers(dest='action', required=True)
     command = listing(datasets)
-    command.add_argument('--type', choices=['environment', 'trajectory', 'record'], help='Filter by dataset content type')
+    command.add_argument('--type', choices=['environment', 'trajectory', 'record'], help='Filter by Dataset content type')
     command.add_argument('--query', help='Search Dataset names')
-    datasets.add_parser('get', help='Show a dataset and its pinned Runner reference').add_argument('name')
+    datasets.add_parser('get', help='Show a Dataset and its pinned Runner reference').add_argument('name', metavar='NAME')
     for resource in ('revision', 'task'):
-        commands = datasets.add_parser(resource, help=f'Inspect dataset {resource}').add_subparsers(dest='operation', required=True)
+        commands = datasets.add_parser(resource, help=f'Inspect Dataset {resource}').add_subparsers(dest='operation', required=True)
         command = listing(commands)
-        command.add_argument('name')
+        command.add_argument('name', metavar='NAME')
         if resource == 'task':
-            command.add_argument('revision')
+            command.add_argument('revision', metavar='REVISION')
         else:
-            command = commands.add_parser('get', help='Show an immutable dataset revision')
-            command.add_argument('name')
-            command.add_argument('revision')
+            command = commands.add_parser('get', help='Show an immutable Dataset revision')
+            command.add_argument('name', metavar='NAME')
+            command.add_argument('revision', metavar='REVISION')
 
     from envloop_data.data_cli import add_commands
     add_commands(groups, listing)
@@ -34,8 +34,8 @@ def add_resource_commands(groups: "argparse._SubParsersAction[argparse.ArgumentP
         'SHA-256, creates the Runner on first use and registers the revision; identical retries are idempotent and '
         'changed content for an existing revision is refused. This is el data create --type runner with the native '
         'manifest built for you; use that command to publish an existing manifest. The key needs envloop:data:write '
-        'and runners.write, and publish permission on a Runner owned by another project.')
-    register.add_argument('directory', type=Path, help='Runner package directory; every file in it is published')
+        'and runners.write, and publish permission on a Runner owned by another Project.')
+    register.add_argument('directory', metavar='DIRECTORY', type=Path, help='Runner package directory; every file in it is published')
     register.add_argument('--revision', required=True, help='Full 40- or 64-character source commit, for example $(git rev-parse HEAD)')
     register.add_argument('--name', help='NAMESPACE/NAME; must equal [runner] name in runner.toml (default: that name)')
     register.add_argument('--executable', action='append', dest='executables', metavar='PATH',
@@ -44,18 +44,18 @@ def add_resource_commands(groups: "argparse._SubParsersAction[argparse.ArgumentP
     register.add_argument('--source-ref-kind', choices=['branch', 'tag', 'commit'], default='branch', help='Kind of --source-ref (default: branch)')
     register.add_argument('--dry-run', action='store_true', help='Validate the package and authorization without publishing')
 
-    checkpoints = groups.add_parser('checkpoint', help='List and download saved training checkpoints').add_subparsers(dest='action', required=True)
+    checkpoints = groups.add_parser('checkpoint', help='List and download saved training Checkpoints').add_subparsers(dest='action', required=True)
     command = listing(checkpoints)
-    command.add_argument('--job-id', help='Only checkpoints of this Train Job')
-    command.add_argument('--run-id', help='Only checkpoints of this training run label')
+    command.add_argument('--job-id', help='Only Checkpoints of this Train Job')
+    command.add_argument('--run-id', help='Only Checkpoints of this training run label')
     download = checkpoints.add_parser('download', help='Download files and verify their sizes and SHA-256 hashes')
-    download.add_argument('checkpoint', metavar='CHECKPOINT', help='checkpoint ID or uri from `checkpoint list`')
-    download.add_argument('directory', type=Path)
+    download.add_argument('checkpoint', metavar='CHECKPOINT', help='Checkpoint ID or uri from `checkpoint list`')
+    download.add_argument('directory', metavar='DIRECTORY', type=Path)
     download.add_argument('--job-id')
     download.add_argument('--run-id')
     from envloop.lifecycle_cli import wait_options
-    delete = checkpoints.add_parser('delete', help='Remove an unreferenced checkpoint and stored files')
-    delete.add_argument('identifier')
+    delete = checkpoints.add_parser('delete', help='Remove an unreferenced Checkpoint and stored files')
+    delete.add_argument('identifier', metavar='CHECKPOINT_ID')
     wait_options(delete)