ellf-cli 20.0.0__tar.gz → 20.0.2__tar.gz

{ellf_cli-20.0.0/ellf_cli.egg-info → ellf_cli-20.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ellf-cli
-Version: 20.0.0
+Version: 20.0.2
 Summary: Ellf Command Line Interface
 Home-page: https://prodi.gy
 Author: ExplosionAI GmbH

{ellf_cli-20.0.0 → ellf_cli-20.0.2}/ellf_cli/commands/recipes.py

@@ -167,6 +167,7 @@ def export(
             "title": recipe_detail.title,
             "description": recipe_detail.description,
             "job_type": recipe_detail.job_type,
+            **({"category": recipe_detail.category} if recipe_detail.category else {}),
             "is_action": recipe_detail.is_action,
             "is_agent": recipe_detail.job_type == "agent",
             "is_service": recipe_detail.job_type == "service",

{ellf_cli-20.0.0 → ellf_cli-20.0.2}/ellf_cli/ellf.json

@@ -1,7 +1,7 @@
 {
   "prog": "ellf",
   "help": "Ellf Command Line Interface.",
-  "version": "20.0.0",
+  "version": "20.0.2",
   "extra_key": "_extra",
   "commands": {
     "actions": {
@@ -312,7 +312,7 @@
           "orig_type": "bool"
         }
       ],
-      "description": "\n    Log in to your Ellf account. You normally don't need to call this\n    manually. It will automatically authenticate when needed.\n    ",
+      "description": "\nLog in to your Ellf account. You normally don't need to call this\nmanually. It will automatically authenticate when needed.\n",
       "allow_extra": false,
       "parent": null,
       "is_placeholder": false
@@ -347,7 +347,7 @@
           "orig_type": "bool"
         }
       ],
-      "description": "\n    Log out by deleting locally-stored auth tokens.\n\n    PAM bearer tokens can't be revoked server-side, so this is a local\n    operation: subsequent commands will trigger a fresh device-flow\n    login. The cached tokens would have expired on their own within\n    roughly an hour. Use ``--all`` to also reset the saved defaults\n    (active org, cluster, project, etc.), e.g. when handing the\n    machine to a different user.\n    ",
+      "description": "\nLog out by deleting locally-stored auth tokens.\n\nPAM bearer tokens can't be revoked server-side, so this is a local\noperation: subsequent commands will trigger a fresh device-flow\nlogin. The cached tokens would have expired on their own within\nroughly an hour. Use ``--all`` to also reset the saved defaults\n(active org, cluster, project, etc.), e.g. when handing the\nmachine to a different user.\n",
       "allow_extra": false,
       "parent": null,
       "is_placeholder": false
@@ -401,7 +401,7 @@
           "orig_type": "Literal[api, cluster, id, ci, ellf-core]"
         }
       ],
-      "description": "\n    Return an auth token for the current user\n    ",
+      "description": "\nReturn an auth token for the current user\n",
       "allow_extra": false,
       "parent": null,
       "is_placeholder": false
@@ -479,7 +479,7 @@
           "orig_type": "list[Literal[tasks, actions, agents, services, assets, datasets, paths]]"
         }
       ],
-      "description": "\n    Save the state of the current app JSON file. If an assets directory is\n    provided, assets will be downloaded and referenced in the JSON accordingly.\n    ",
+      "description": "\nSave the state of the current app JSON file. If an assets directory is\nprovided, assets will be downloaded and referenced in the JSON accordingly.\n",
       "allow_extra": false,
       "parent": null,
       "is_placeholder": false
@@ -514,7 +514,7 @@
           "orig_type": "bool"
         }
       ],
-      "description": "\n    Populate Ellf with data for projects, tasks, actions, agents, services,\n    assets, datasets and paths.\n    ",
+      "description": "\nPopulate Ellf with data for projects, tasks, actions, agents, services,\nassets, datasets and paths.\n",
       "allow_extra": false,
       "parent": null,
       "is_placeholder": false
@@ -604,7 +604,7 @@
             "orig_type": "List[str]"
           }
         ],
-        "description": "\n    Create a new action. The available action recipes are fetched from your\n    cluster and are added as dynamic subcommands. You can see more details\n    and available arguments by calling the subcommand with --help, e.g. create\n    [name] --help\n    ",
+        "description": "\nCreate a new action. The available action recipes are fetched from your\ncluster and are added as dynamic subcommands. You can see more details\nand available arguments by calling the subcommand with --help, e.g. create\n[name] --help\n",
         "allow_extra": true,
         "parent": "actions",
         "is_placeholder": false
@@ -652,7 +652,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    List the actions in a project. Uses your default project unless --project\n    is given. By default, this includes their ID, name and current state,\n    e.g. created or completed\n    ",
+        "description": "\nList the actions in a project. Uses your default project unless --project\nis given. By default, this includes their ID, name and current state,\ne.g. created or completed\n",
         "allow_extra": false,
         "parent": "actions",
         "is_placeholder": false
@@ -1111,7 +1111,7 @@
             "orig_type": "List[str]"
           }
         ],
-        "description": "\n    Create a new agent. The available agent recipes are fetched from your\n    cluster and are added as dynamic subcommands. You can see more details\n    and available arguments by calling the subcommand with --help, e.g. create\n    [name] --help\n    ",
+        "description": "\nCreate a new agent. The available agent recipes are fetched from your\ncluster and are added as dynamic subcommands. You can see more details\nand available arguments by calling the subcommand with --help, e.g. create\n[name] --help\n",
         "allow_extra": true,
         "parent": "agents",
         "is_placeholder": false
@@ -1259,7 +1259,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    Remove an agent from a task. This will only remove the assignment and keep\n    all annotations the agent has created.\n    ",
+        "description": "\nRemove an agent from a task. This will only remove the assignment and keep\nall annotations the agent has created.\n",
         "allow_extra": false,
         "parent": "agents",
         "is_placeholder": false
@@ -1307,7 +1307,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    List the agents in a project. Uses your default project unless --project\n    is given. By default, this includes their ID, name and current state,\n    e.g. created or completed\n    ",
+        "description": "\nList the agents in a project. Uses your default project unless --project\nis given. By default, this includes their ID, name and current state,\ne.g. created or completed\n",
         "allow_extra": false,
         "parent": "agents",
         "is_placeholder": false
@@ -1801,7 +1801,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    Get detailed info for an asset uploaded to the cluster and registered\n    with Ellf\n    ",
+        "description": "\nGet detailed info for an asset uploaded to the cluster and registered\nwith Ellf\n",
         "allow_extra": false,
         "parent": "assets",
         "is_placeholder": false
@@ -1901,7 +1901,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    Create an asset on the cluster and register it with Ellf. Assets\n    point to files or directories you control. The Ellf server only has\n    a reference to them. This command doesn't transfer any data. See `ellf files`\n    for utilities to transfer files to and from your cluster\n    ",
+        "description": "\nCreate an asset on the cluster and register it with Ellf. Assets\npoint to files or directories you control. The Ellf server only has\na reference to them. This command doesn't transfer any data. See `ellf files`\nfor utilities to transfer files to and from your cluster\n",
         "allow_extra": false,
         "parent": "assets",
         "is_placeholder": false
@@ -1972,7 +1972,7 @@
       "import": {
         "name": "import",
         "args": [],
-        "description": "Read a serialised FileSecrets blob from stdin and write it to\n    the local secrets file.\n\n    Counterpart to ``ellf auth push``. Existing local auth state is\n    overwritten; the file is written 0600 by FileSecrets.save.\n    ",
+        "description": "Read a serialised FileSecrets blob from stdin and write it to\nthe local secrets file.\n\nCounterpart to ``ellf auth push``. Existing local auth state is\noverwritten; the file is written 0600 by FileSecrets.save.\n",
         "allow_extra": false,
         "parent": "auth",
         "is_placeholder": false
@@ -2007,7 +2007,7 @@
             "orig_type": "str"
           }
         ],
-        "description": "Push local auth state to a remote machine via SSH.\n\n    Reads the local FileSecrets, JSON-serialises it, and pipes it to\n    ``<remote_ellf> auth import`` over an SSH connection to *host*.\n    Authentication is delegated to ssh \u2014 anything in your ssh config\n    (host aliases, ProxyJump, key-based auth) just works.\n\n    The pushed blob includes id_token, api_token, and any cached\n    broker_tokens. id_token expiry is dictated by the issuer (typically\n    ~1h), so this is a \"give the remote a usable session\" operation,\n    not a permanent provisioning. Re-run when the token expires.\n    ",
+        "description": "Push local auth state to a remote machine via SSH.\n\nReads the local FileSecrets, JSON-serialises it, and pipes it to\n``<remote_ellf> auth import`` over an SSH connection to *host*.\nAuthentication is delegated to ssh \u2014 anything in your ssh config\n(host aliases, ProxyJump, key-based auth) just works.\n\nThe pushed blob includes id_token, api_token, and any cached\nbroker_tokens. id_token expiry is dictated by the issuer (typically\n~1h), so this is a \"give the remote a usable session\" operation,\nnot a permanent provisioning. Re-run when the token expires.\n",
         "allow_extra": false,
         "parent": "auth",
         "is_placeholder": false
@@ -2079,7 +2079,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Switch the active cluster.\n\n    Looks up the cluster by name or ID via PAM. With no argument and\n    multiple clusters available, prompts interactively in a TTY.\n    ",
+        "description": "Switch the active cluster.\n\nLooks up the cluster by name or ID via PAM. With no argument and\nmultiple clusters available, prompts interactively in a TTY.\n",
         "allow_extra": false,
         "parent": "clusters",
         "is_placeholder": false
@@ -2223,7 +2223,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    Delete a cluster from PAM. This only removes PAM's record\n    of it. The cluster itself will continue to exist - you need\n    to shut it down separately.\n    ",
+        "description": "\nDelete a cluster from PAM. This only removes PAM's record\nof it. The cluster itself will continue to exist - you need\nto shut it down separately.\n",
         "allow_extra": false,
         "parent": "clusters",
         "is_placeholder": false
@@ -2323,7 +2323,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Check the health of a cluster deployment.\n\n    Runs CLI-side connectivity checks against the cluster and PAM.\n    Use --deep (or supply --s3-bucket / --nfs-path / --recipe) to also\n    trigger cluster-side deployment checks via the broker's /v1/check\n    endpoints (K8s API, NFS, S3, recipe execution, DB).\n    ",
+        "description": "Check the health of a cluster deployment.\n\nRuns CLI-side connectivity checks against the cluster and PAM.\nUse --deep (or supply --s3-bucket / --nfs-path / --recipe) to also\ntrigger cluster-side deployment checks via the broker's /v1/check\nendpoints (K8s API, NFS, S3, recipe execution, DB).\n",
         "allow_extra": false,
         "parent": "clusters",
         "is_placeholder": false
@@ -2419,7 +2419,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Rotate the cluster RSA keypair.\n\n    Generates a new keypair, updates the cluster record in PAM with the\n    new public key, patches the K8s secret with the new private key,\n    and restarts the cluster deployment.\n    ",
+        "description": "Rotate the cluster RSA keypair.\n\nGenerates a new keypair, updates the cluster record in PAM with the\nnew public key, patches the K8s secret with the new private key,\nand restarts the cluster deployment.\n",
         "allow_extra": false,
         "parent": "clusters",
         "is_placeholder": false
@@ -3230,7 +3230,7 @@
             "orig_type": "str"
           }
         ],
-        "description": "Export all the examples from a dataset and save it in the designated file as\n    JSONL (newline-delimited JSON).\n    ",
+        "description": "Export all the examples from a dataset and save it in the designated file as\nJSONL (newline-delimited JSON).\n",
         "allow_extra": false,
         "parent": "datasets",
         "is_placeholder": false
@@ -3704,7 +3704,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Register a new cluster with PAM and write credentials to cluster-creds.json.\n\n    Pass --domain to use your own DNS, or omit it to be allocated a managed\n    subdomain (with base + wildcard A records) under an Explosion-controlled\n    zone.\n    ",
+        "description": "Register a new cluster with PAM and write credentials to cluster-creds.json.\n\nPass --domain to use your own DNS, or omit it to be allocated a managed\nsubdomain (with base + wildcard A records) under an Explosion-controlled\nzone.\n",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -3804,7 +3804,7 @@
             "orig_type": "str"
           }
         ],
-        "description": "Create a versioned bucket for terraform remote state and record it in\n    config.yaml (or print the block to add when no config file exists).\n\n    Remote state is the recommended setup: local state is owned by whichever\n    disk ran terraform, so it's easy to lose and impossible to share. The\n    bucket is managed outside the terraform on purpose \u2014 it must exist before\n    terraform runs and outlive the cluster so 'infra destroy' has state to\n    work against; nothing here (or in destroy) ever deletes it. Uses the\n    aws / gcloud CLI, which the terraform flow already relies on for\n    credentials.\n    ",
+        "description": "Create a versioned bucket for terraform remote state and record it in\nconfig.yaml (or print the block to add when no config file exists).\n\nRemote state is the recommended setup: local state is owned by whichever\ndisk ran terraform, so it's easy to lose and impossible to share. The\nbucket is managed outside the terraform on purpose \u2014 it must exist before\nterraform runs and outlive the cluster so 'infra destroy' has state to\nwork against; nothing here (or in destroy) ever deletes it. Uses the\naws / gcloud CLI, which the terraform flow already relies on for\ncredentials.\n",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -3926,7 +3926,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Apply terraform to create or update cluster infrastructure.\n\n    Returns True when an apply actually ran \u2014 'infra provision' wraps this\n    and only backfills config.yaml from outputs after a real apply.\n    ",
+        "description": "Apply terraform to create or update cluster infrastructure.\n\nReturns True when an apply actually ran \u2014 'infra provision' wraps this\nand only backfills config.yaml from outputs after a real apply.\n",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -4000,7 +4000,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Destroy the cluster infrastructure created by 'infra terraform',\n    including every annotation, file and dataset stored on it.\n\n    The database, data bucket and shared volume are deletion-protected, so\n    this refuses to run without --delete-data. To stop paying for compute\n    while keeping the data, use 'ellf infra pause' instead. With\n    --delete-data, a first apply lifts the protection, then the destroy runs.\n    On AWS the database still leaves a final snapshot behind.\n\n    Note this never touches the terraform state bucket: the bucket is managed\n    outside the terraform (see 'infra init --state-bucket') and outlives the\n    cluster so the destroy itself has state to work against.\n    ",
+        "description": "Destroy the cluster infrastructure created by 'infra terraform',\nincluding every annotation, file and dataset stored on it.\n\nThe database, data bucket and shared volume are deletion-protected, so\nthis refuses to run without --delete-data. To stop paying for compute\nwhile keeping the data, use 'ellf infra pause' instead. With\n--delete-data, a first apply lifts the protection, then the destroy runs.\nOn AWS the database still leaves a final snapshot behind.\n\nNote this never touches the terraform state bucket: the bucket is managed\noutside the terraform (see 'infra init --state-bucket') and outlives the\ncluster so the destroy itself has state to work against.\n",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -4269,7 +4269,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Initialize a cluster: register with PAM (allocating a managed domain\n    unless --domain is given), download the terraform files, and generate\n    config.yaml \u2014 the input every later phase (configure, provision, start)\n    reads. Idempotent and safe to re-run.\n\n    After init, the directory is a complete hand-off bundle (terraform files\n    + terraform.tfvars.json + config.yaml) for teams that apply terraform\n    through their own pipeline; they later sync outputs back with\n    'ellf infra configure --from-terraform' instead of 'ellf infra provision'.\n    ",
+        "description": "Initialize a cluster: register with PAM (allocating a managed domain\nunless --domain is given), download the terraform files, and generate\nconfig.yaml \u2014 the input every later phase (configure, provision, start)\nreads. Idempotent and safe to re-run.\n\nAfter init, the directory is a complete hand-off bundle (terraform files\n+ terraform.tfvars.json + config.yaml) for teams that apply terraform\nthrough their own pipeline; they later sync outputs back with\n'ellf infra configure --from-terraform' instead of 'ellf infra provision'.\n",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -4525,7 +4525,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Update the config.yaml written by 'ellf infra init' \u2014 repeatable, so no\n    decision made at init time is final. With no flags on a terminal, re-runs\n    the provider prompts with the current values as defaults.",
+        "description": "Update the config.yaml written by 'ellf infra init' \u2014 repeatable, so no\ndecision made at init time is final. With no flags on a terminal, re-runs\nthe provider prompts with the current values as defaults.",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -4586,7 +4586,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Deploy or upgrade the Ellf Helm chart.\n\n    Creates the namespace, image pull secret, cluster keypair secret,\n    then runs helm upgrade --install with the provided values. The broker\n    and cpl image versions come from PAM's cluster settings at deploy time\n    \u2014 the same targets the CPL sidecar auto-updates the running cluster to\n    \u2014 so a deploy can never roll an auto-updated cluster back.\n    ",
+        "description": "Deploy or upgrade the Ellf Helm chart.\n\nCreates the namespace, image pull secret, cluster keypair secret,\nthen runs helm upgrade --install with the provided values. The broker\nand cpl image versions come from PAM's cluster settings at deploy time\n\u2014 the same targets the CPL sidecar auto-updates the running cluster to\n\u2014 so a deploy can never roll an auto-updated cluster back.\n",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -4660,7 +4660,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Idle the cluster: scale every node pool to zero and stop the database.\n\n    Nothing is deleted. The database's disk and backups, the data bucket,\n    the shared volume, the container registry and the ingress load balancer\n    all stay, so 'ellf infra resume' brings the cluster back exactly as it\n    was. What keeps billing is that storage, the load balancer, and the\n    GKE/EKS control plane fee (AKS stops its control plane too). Refuses\n    while jobs are running unless --stop-jobs is given, since pausing would\n    kill them mid-run.\n\n    AWS and Azure automatically restart a stopped database after 7 days;\n    re-run this command to stop it again.\n    ",
+        "description": "Idle the cluster: scale every node pool to zero and stop the database.\n\nNothing is deleted. The database's disk and backups, the data bucket,\nthe shared volume, the container registry and the ingress load balancer\nall stay, so 'ellf infra resume' brings the cluster back exactly as it\nwas. What keeps billing is that storage, the load balancer, and the\nGKE/EKS control plane fee (AKS stops its control plane too). Refuses\nwhile jobs are running unless --stop-jobs is given, since pausing would\nkill them mid-run.\n\nAWS and Azure automatically restart a stopped database after 7 days;\nre-run this command to stop it again.\n",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -4708,7 +4708,7 @@
             "orig_type": "str"
           }
         ],
-        "description": "Bring a cluster paused with 'ellf infra pause' back up.\n\n    Starts the database first, then restores the node pools to the sizes in\n    config.yaml. The broker reconnects to Ellf on its own once its node is\n    up, usually within a few minutes.\n    ",
+        "description": "Bring a cluster paused with 'ellf infra pause' back up.\n\nStarts the database first, then restores the node pools to the sizes in\nconfig.yaml. The broker reconnects to Ellf on its own once its node is\nup, usually within a few minutes.\n",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -4795,7 +4795,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Delete the cluster's GKE cluster, keeping all of its data.\n\n    Goes further than 'ellf infra pause': the GKE cluster itself is deleted,\n    which also ends its management fee. The database (stopped), the data\n    bucket, the shared volume's Filestore instance, the container registry,\n    the ingress IP and the broker's keypair all stay, and 'ellf infra wake'\n    recreates the cluster around them. Only in-cluster objects are lost, and\n    wake recreates all of those (TLS certificates are re-issued).\n\n    The shared volume's Filestore instance is recorded in config.yaml\n    (deployment.existing_shared_volume) first, so the recreated cluster binds\n    to it instead of provisioning a new, empty one. GCP only.\n    ",
+        "description": "Delete the cluster's GKE cluster, keeping all of its data.\n\nGoes further than 'ellf infra pause': the GKE cluster itself is deleted,\nwhich also ends its management fee. The database (stopped), the data\nbucket, the shared volume's Filestore instance, the container registry,\nthe ingress IP and the broker's keypair all stay, and 'ellf infra wake'\nrecreates the cluster around them. Only in-cluster objects are lost, and\nwake recreates all of those (TLS certificates are re-issued).\n\nThe shared volume's Filestore instance is recorded in config.yaml\n(deployment.existing_shared_volume) first, so the recreated cluster binds\nto it instead of provisioning a new, empty one. GCP only.\n",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -4856,7 +4856,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Recreate a cluster hibernated with 'ellf infra hibernate'.\n\n    Starts the database, recreates the GKE cluster with terraform (binding\n    the shared volume to the Filestore instance it had before), then deploys\n    the cluster services as 'ellf infra start' does. Takes 15-20 minutes,\n    most of it GKE creating the cluster.\n    ",
+        "description": "Recreate a cluster hibernated with 'ellf infra hibernate'.\n\nStarts the database, recreates the GKE cluster with terraform (binding\nthe shared volume to the Filestore instance it had before), then deploys\nthe cluster services as 'ellf infra start' does. Takes 15-20 minutes,\nmost of it GKE creating the cluster.\n",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -5004,7 +5004,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Provision the cluster infrastructure: terraform init + plan + apply,\n    then backfill config.yaml from the outputs and point the managed domain\n    at the ingress IP (where the provider exposes one). Requires a terraform\n    state location \u2014 see 'ellf infra init --state-bucket' / 'ellf infra\n    configure --state-bucket'; the state bucket itself is managed outside\n    the terraform and is never touched here or by 'infra destroy'.",
+        "description": "Provision the cluster infrastructure: terraform init + plan + apply,\nthen backfill config.yaml from the outputs and point the managed domain\nat the ingress IP (where the provider exposes one). Requires a terraform\nstate location \u2014 see 'ellf infra init --state-bucket' / 'ellf infra\nconfigure --state-bucket'; the state bucket itself is managed outside\nthe terraform and is never touched here or by 'infra destroy'.",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -5065,7 +5065,7 @@
             "orig_type": "str"
           }
         ],
-        "description": "Install cluster infrastructure prerequisites (Traefik, cert-manager).\n\n    These operations are idempotent and safe to re-run.\n    ",
+        "description": "Install cluster infrastructure prerequisites (Traefik, cert-manager).\n\nThese operations are idempotent and safe to re-run.\n",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -5226,7 +5226,7 @@
             "orig_type": "str"
           }
         ],
-        "description": "Manage TLS certificates for local cluster access.\n\n    Use --self-signed when you have direct kubectl access to the cluster.\n    Use --setup HOST to do everything from your laptop over SSH.\n    Use --trust HOST to fetch and install an existing CA from a remote cluster.\n    ",
+        "description": "Manage TLS certificates for local cluster access.\n\nUse --self-signed when you have direct kubectl access to the cluster.\nUse --setup HOST to do everything from your laptop over SSH.\nUse --trust HOST to fetch and install an existing CA from a remote cluster.\n",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -5250,7 +5250,7 @@
             "orig_type": "str"
           }
         ],
-        "description": "\n    Run a job directly on the cluster from a YAML spec file, bypassing PAM.\n    ",
+        "description": "\nRun a job directly on the cluster from a YAML spec file, bypassing PAM.\n",
         "allow_extra": false,
         "parent": "jobs",
         "is_placeholder": false
@@ -5298,7 +5298,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    List the workloads running on your cluster. This reads the cluster directly,\n    so it also shows orphaned workloads that have no matching task, action,\n    agent or service in Ellf.\n    ",
+        "description": "\nList the workloads running on your cluster. This reads the cluster directly,\nso it also shows orphaned workloads that have no matching task, action,\nagent or service in Ellf.\n",
         "allow_extra": false,
         "parent": "jobs",
         "is_placeholder": false
@@ -5346,7 +5346,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    Stop a job on the cluster by its ID. Works for workloads that have no\n    matching job in Ellf, which the stop commands of tasks, actions, agents and\n    services cannot reach.\n    ",
+        "description": "\nStop a job on the cluster by its ID. Works for workloads that have no\nmatching job in Ellf, which the stop commands of tasks, actions, agents and\nservices cannot reach.\n",
         "allow_extra": false,
         "parent": "jobs",
         "is_placeholder": false
@@ -5356,7 +5356,7 @@
       "kb": {
         "name": "kb",
         "args": [],
-        "description": "\n    Run the Ellf knowledge base MCP server over stdio, using your ellf login.\n    Coding agents start this themselves once 'ellf login --agent' has set\n    them up.\n    ",
+        "description": "\nRun the Ellf knowledge base MCP server over stdio, using your ellf login.\nCoding agents start this themselves once 'ellf login --agent' has set\nthem up.\n",
         "allow_extra": false,
         "parent": "mcp",
         "is_placeholder": false
@@ -6473,7 +6473,7 @@
             "orig_type": "str"
           }
         ],
-        "description": "\n    Upload and advertise a recipes package from your Python environment.\n    ",
+        "description": "\nUpload and advertise a recipes package from your Python environment.\n",
         "allow_extra": false,
         "parent": "publish",
         "is_placeholder": false
@@ -6612,7 +6612,7 @@
             "orig_type": "str"
           }
         ],
-        "description": "\n    Transfer data to the cluster, and advertise it to Ellf.\n\n    These steps can also be done separately. See `ellf files` to transfer\n    data to the cluster without creating an Asset record for it, and\n    `ellf assets create` to create an Asset without transfer.\n    ",
+        "description": "\nTransfer data to the cluster, and advertise it to Ellf.\n\nThese steps can also be done separately. See `ellf files` to transfer\ndata to the cluster without creating an Asset record for it, and\n`ellf assets create` to create an Asset without transfer.\n",
         "allow_extra": false,
         "parent": "publish",
         "is_placeholder": false
@@ -6697,7 +6697,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Export recipes from the cluster to a local YAML or JSON file.\n\n    Exports every package by default. Use --packages to export only certain\n    ones, e.g. to keep ad-hoc packages published to the cluster out of the\n    docs.\n    ",
+        "description": "Export recipes from the cluster to a local YAML or JSON file.\n\nExports every package by default. Use --packages to export only certain\nones, e.g. to keep ad-hoc packages published to the cluster out of the\ndocs.\n",
         "allow_extra": false,
         "parent": "recipes",
         "is_placeholder": false
@@ -7180,7 +7180,7 @@
             "orig_type": "List[str]"
           }
         ],
-        "description": "\n    Create a new service. The available service recipes are fetched from your\n    cluster and are added as dynamic subcommands. You can see more details\n    and available arguments by calling the subcommand with --help, e.g. create\n    [name] --help\n    ",
+        "description": "\nCreate a new service. The available service recipes are fetched from your\ncluster and are added as dynamic subcommands. You can see more details\nand available arguments by calling the subcommand with --help, e.g. create\n[name] --help\n",
         "allow_extra": true,
         "parent": "services",
         "is_placeholder": false
@@ -7228,7 +7228,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    List the services in a project. Uses your default project unless\n    --project is given.\n    ",
+        "description": "\nList the services in a project. Uses your default project unless\n--project is given.\n",
         "allow_extra": false,
         "parent": "services",
         "is_placeholder": false
@@ -7659,7 +7659,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Print the bearer-token-authenticated URL for a service.\n\n    Mints a fresh 90-day token via ``POST /v1/service/issue-token`` and\n    formats it together with the service's public URL so the result can\n    be dropped into an MCP client config or curl invocation:\n\n        curl -H \"Authorization: Bearer <token>\" <url>\n\n    Use ``services rotate-token`` to mint a new token without printing\n    the URL again.\n    ",
+        "description": "Print the bearer-token-authenticated URL for a service.\n\nMints a fresh 90-day token via ``POST /v1/service/issue-token`` and\nformats it together with the service's public URL so the result can\nbe dropped into an MCP client config or curl invocation:\n\n    curl -H \"Authorization: Bearer <token>\" <url>\n\nUse ``services rotate-token`` to mint a new token without printing\nthe URL again.\n",
         "allow_extra": false,
         "parent": "services",
         "is_placeholder": false
@@ -7720,7 +7720,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Mint a fresh 90-day token for an existing service.\n\n    Issuing a new token does not invalidate previous ones -- they remain\n    valid until their own expiration. Use this when the previous token\n    is leaked, or when you want a longer remaining window for an MCP\n    client config.\n    ",
+        "description": "Mint a fresh 90-day token for an existing service.\n\nIssuing a new token does not invalidate previous ones -- they remain\nvalid until their own expiration. Use this when the previous token\nis leaked, or when you want a longer remaining window for an MCP\nclient config.\n",
         "allow_extra": false,
         "parent": "services",
         "is_placeholder": false
@@ -7796,7 +7796,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "List a task's annotation sessions, with how much each annotated, how\n    much of that the dataset still holds, and whether it was excluded",
+        "description": "List a task's annotation sessions, with how much each annotated, how\nmuch of that the dataset still holds, and whether it was excluded",
         "allow_extra": false,
         "parent": "sessions",
         "is_placeholder": false
@@ -7831,7 +7831,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Exclude an annotation session: take its examples out of the task's\n    dataset, so training and exports leave them out and their tasks are served\n    again. They still count as the annotator's work",
+        "description": "Exclude an annotation session: take its examples out of the task's\ndataset, so training and exports leave them out and their tasks are served\nagain. They still count as the annotator's work",
         "allow_extra": false,
         "parent": "sessions",
         "is_placeholder": false
@@ -7866,7 +7866,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Activate an excluded annotation session: put its examples back into\n    the task's dataset",
+        "description": "Activate an excluded annotation session: put its examples back into\nthe task's dataset",
         "allow_extra": false,
         "parent": "sessions",
         "is_placeholder": false
@@ -8086,7 +8086,7 @@
             "orig_type": "List[str]"
           }
         ],
-        "description": "\n    Create a new task. The available task recipes are fetched from your\n    cluster and are added as dynamic subcommands. You can see more details\n    and available arguments by calling the subcommand with --help, e.g. create\n    [name] --help\n    ",
+        "description": "\nCreate a new task. The available task recipes are fetched from your\ncluster and are added as dynamic subcommands. You can see more details\nand available arguments by calling the subcommand with --help, e.g. create\n[name] --help\n",
         "allow_extra": true,
         "parent": "tasks",
         "is_placeholder": false
@@ -8134,7 +8134,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    List the tasks in a project. Uses your default project unless --project\n    is given. By default, this includes their ID, name and current state,\n    e.g. created or completed\n    ",
+        "description": "\nList the tasks in a project. Uses your default project unless --project\nis given. By default, this includes their ID, name and current state,\ne.g. created or completed\n",
         "allow_extra": false,
         "parent": "tasks",
         "is_placeholder": false
@@ -8565,7 +8565,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Fetch a batch of questions from a running annotation task.\n\n    Mirrors the web app: asks the broker for a Prodigy login token, then talks\n    to the task pod directly via its public task_url. Note that requesting a\n    batch reserves those questions for this CLI's session \u2014 they will not be\n    handed to other annotators until they are answered or another session\n    runs out of work and steals them.\n    ",
+        "description": "Fetch a batch of questions from a running annotation task.\n\nMirrors the web app: asks the broker for a Prodigy login token, then talks\nto the task pod directly via its public task_url. Note that requesting a\nbatch reserves those questions for this CLI's session \u2014 they will not be\nhanded to other annotators until they are answered or another session\nruns out of work and steals them.\n",
         "allow_extra": false,
         "parent": "tasks",
         "is_placeholder": false
@@ -9122,7 +9122,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Update a user's role, name, locale, or tags.\n\n    Email can't be set here: it's the login identity, so it can only be\n    changed through the verified change-email flow (a confirmation link\n    sent to the new address) \u2014 see ellf_pam/api/user.py.\n    ",
+        "description": "Update a user's role, name, locale, or tags.\n\nEmail can't be set here: it's the login identity, so it can only be\nchanged through the verified change-email flow (a confirmation link\nsent to the new address) \u2014 see ellf_pam/api/user.py.\n",
         "allow_extra": false,
         "parent": "users",
         "is_placeholder": false
@@ -9170,7 +9170,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Remove a user from the organization. By default the user is\n    deactivated: they lose access and stop taking up a seat, but their\n    work stays in the organization and an admin can reactivate them.",
+        "description": "Remove a user from the organization. By default the user is\ndeactivated: they lose access and stop taking up a seat, but their\nwork stays in the organization and an admin can reactivate them.",
         "allow_extra": false,
         "parent": "users",
         "is_placeholder": false
@@ -9205,7 +9205,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Reactivate a user who was removed from the organization. They get\n    back the access they had, and take up a seat again.",
+        "description": "Reactivate a user who was removed from the organization. They get\nback the access they had, and take up a seat again.",
         "allow_extra": false,
         "parent": "users",
         "is_placeholder": false
@@ -9453,7 +9453,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    Assign an annotator to a task and email them an invitation to start\n    annotating.\n    ",
+        "description": "\nAssign an annotator to a task and email them an invitation to start\nannotating.\n",
         "allow_extra": false,
         "parent": "users",
         "is_placeholder": false
@@ -9527,7 +9527,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    Remove an annotator from a task. This only removes the assignment and\n    keeps all annotations the user has created.\n    ",
+        "description": "\nRemove an annotator from a task. This only removes the assignment and\nkeeps all annotations the user has created.\n",
         "allow_extra": false,
         "parent": "users",
         "is_placeholder": false

ellf_cli-20.0.2/ellf_cli/version/20.0.0_2026-10-10-09-36-17_patch_d2618f39-cdc9-4d3a-ba40-1a0ad6265f3b

@@ -0,0 +1,3 @@
+20.0.0
+patch
+d2618f39-cdc9-4d3a-ba40-1a0ad6265f3b

ellf_cli-20.0.2/ellf_cli/version/20.0.1_2026-10-11-10-24-33_patch_e29a8713-eecb-4eb1-9641-789d3cfab21a

@@ -0,0 +1,3 @@
+20.0.1
+patch
+e29a8713-eecb-4eb1-9641-789d3cfab21a

{ellf_cli-20.0.0 → ellf_cli-20.0.2/ellf_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ellf-cli
-Version: 20.0.0
+Version: 20.0.2
 Summary: Ellf Command Line Interface
 Home-page: https://prodi.gy
 Author: ExplosionAI GmbH

{ellf_cli-20.0.0 → ellf_cli-20.0.2}/ellf_cli.egg-info/SOURCES.txt

@@ -329,6 +329,8 @@ ellf_cli/version/19.0.6_2026-09-29-17-22-11_patch_3b1c79e9-9002-4e96-ba78-10668c
 ellf_cli/version/19.0.7_2026-09-30-07-50-58_patch_e8b1f046-d819-499c-9cd5-3e1a20fc9acf
 ellf_cli/version/19.0.8_2026-10-01-13-41-44_patch_7d63af18-e0af-4127-ab58-aede2407490f
 ellf_cli/version/19.0.9_2026-10-01-15-57-35_patch_143863cb-8f63-4ef7-bd78-c1114fc93a2d
+ellf_cli/version/20.0.0_2026-10-10-09-36-17_patch_d2618f39-cdc9-4d3a-ba40-1a0ad6265f3b
+ellf_cli/version/20.0.1_2026-10-11-10-24-33_patch_e29a8713-eecb-4eb1-9641-789d3cfab21a
 ellf_cli/version/__init__.py
 ellf_cli/version/read_version.py
 tests/test_agents.py

{ellf_cli-20.0.0 → ellf_cli-20.0.2}/tests/test_recipes.py

@@ -30,6 +30,7 @@ def _recipe_summary(
     job_type: str,
     is_action: bool,
     package_id: UUID | None = None,
+    category: str | None = None,
 ) -> RecipeSummary:
     now = datetime.now(timezone.utc)
     return RecipeSummary(
@@ -43,6 +44,7 @@ def _recipe_summary(
         description="",
         job_type=job_type,
         is_action=is_action,
+        category=category,
         is_latest=True,
         entry_point="pkg:recipe",
     )
@@ -230,6 +232,7 @@ def _recipe_detail(summary: RecipeSummary, package_name: str) -> Any:
         title=summary.title,
         description=summary.description,
         job_type=summary.job_type,
+        category=summary.category,
         is_action=summary.is_action,
         package=SimpleNamespace(name=package_name, container="image:tag"),
         form_schema=SimpleNamespace(cli_names={}, fields=[]),
@@ -240,6 +243,7 @@ def _setup_export(
     monkeypatch,
     packages: dict[str, list[str]],
     superseded: dict[str, list[str]] | None = None,
+    categories: dict[str, str] | None = None,
 ):
     """Build an export fixture from a {package name: [recipe names]} mapping.
 
@@ -259,6 +263,7 @@ def _setup_export(
                 job_type="task",
                 is_action=False,
                 package_id=package_id,
+                category=(categories or {}).get(recipe_name),
             )
             recipes.append(summary)
             package_of[summary.id] = package_name
@@ -398,3 +403,21 @@ def test_recipes_export_skips_recipes_dropped_from_the_package(monkeypatch, tmp_
     recipes_cmd.export(str(out), as_json=True)
 
     assert _exported_names(out) == ["ner.correct"]
+
+
+def test_recipes_export_includes_the_category_when_set(monkeypatch, tmp_path):
+    """The site's recipe directory groups recipes by category."""
+    _setup_export(
+        monkeypatch,
+        {"ellf-recipes": ["ner.correct", "custom.recipe"]},
+        categories={"ner.correct": "text"},
+    )
+    out = tmp_path / "recipes.json"
+
+    recipes_cmd.export(str(out), as_json=True)
+
+    data = srsly.read_json(out)
+    assert isinstance(data, dict)
+    by_name = {recipe["name"]: recipe for recipe in data["recipes"]}
+    assert by_name["ner.correct"]["category"] == "text"
+    assert "category" not in by_name["custom.recipe"]