apheris-foundry-cli 0.2.0__tar.gz → 0.4.0__tar.gz

{apheris_foundry_cli-0.2.0 → apheris_foundry_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: apheris-foundry-cli
-Version: 0.2.0
+Version: 0.4.0
 Summary: Command-line interface for Apheris Foundry workflows.
 Author: Apheris
 License-Expression: LicenseRef-Apheris-Foundry-Software-License
@@ -39,37 +39,37 @@ Recommended if you already use conda for scientific Python work. A dedicated env
 #### Linux / macOS
 
 ```bash
-conda create -n apherisfold python=3.11 -y
-conda activate apherisfold
-pip install apherisfold-cli
+conda create -n apheris-foundry python=3.11 -y
+conda activate apheris-foundry
+pip install apheris-foundry-cli
 ```
 
 #### Windows (Anaconda Prompt or PowerShell)
 
 ```powershell
-conda create -n apherisfold python=3.11 -y
-conda activate apherisfold
-pip install apherisfold-cli
+conda create -n apheris-foundry python=3.11 -y
+conda activate apheris-foundry
+pip install apheris-foundry-cli
 ```
 
-Activate the environment at the start of each session with `conda activate apherisfold`.
+Activate the environment at the start of each session with `conda activate apheris-foundry`.
 
 ### venv (standard Python)
 
 #### Linux / macOS (venv)
 
 ```bash
-python3 -m venv ~/.venvs/apherisfold
-source ~/.venvs/apherisfold/bin/activate
-pip install apherisfold-cli
+python3 -m venv ~/.venvs/apheris-foundry
+source ~/.venvs/apheris-foundry/bin/activate
+pip install apheris-foundry-cli
 ```
 
 #### Windows (PowerShell, venv)
 
 ```powershell
-python -m venv $env:USERPROFILE\.venvs\apherisfold
-& $env:USERPROFILE\.venvs\apherisfold\Scripts\Activate.ps1
-pip install apherisfold-cli
+python -m venv $env:USERPROFILE\.venvs\apheris-foundry
+& $env:USERPROFILE\.venvs\apheris-foundry\Scripts\Activate.ps1
+pip install apheris-foundry-cli
 ```
 
 Activate the environment at the start of each session with the `activate` command above.
@@ -84,7 +84,7 @@ apheris-foundry --help
 ### Upgrade
 
 ```bash
-pip install --upgrade apherisfold-cli
+pip install --upgrade apheris-foundry-cli
 ```
 
 ## Quick start
@@ -99,6 +99,22 @@ apheris-foundry workflows list
 # Submit a run
 apheris-foundry workflows run --workflow predict --input ./request.json
 
+# Inspect the model IDs, weights, and default parameters advertised by Hub
+apheris-foundry workflows models --workflow predict
+
+# Override prediction parameters with a Hub-schema-validated JSON object
+apheris-foundry workflows run --workflow predict --input ./request.json \
+  --model-params '{"seeds":[7,9],"num_diffusion_samples":3}'
+
+# Or provide the same JSON object from a file
+apheris-foundry workflows run --workflow predict --input ./request.json \
+  --model-params @./model-params.json
+
+# Select a non-default model/weight advertised by the workflow
+apheris-foundry workflows run --workflow predict --input ./request.json \
+  --param model=<model-id> --weight <weight-version> \
+  --model-params @./model-params.json
+
 # List submitted runs
 apheris-foundry jobs list
 
@@ -132,9 +148,10 @@ apheris-foundry jobs error --id <job-id>
 | Command | Description |
 | ------- | ----------- |
 | `apheris-foundry workflows list` | List workflow definitions exposed by Hub |
-| `apheris-foundry workflows get --workflow <id>` | Inspect one workflow definition |
+| `apheris-foundry workflows get --workflow <id>` | Inspect one workflow definition and advertised model defaults |
+| `apheris-foundry workflows models --workflow <id>` | List models, weights, and default prediction parameters advertised by Hub (`--json` includes full metadata) |
 | `apheris-foundry workflows graph --workflow <id>` | Show the workflow DAG |
-| `apheris-foundry workflows run --workflow <id>` | Submit a workflow run |
+| `apheris-foundry workflows run --workflow <id> [--model-params <JSON\|@file>]` | Submit a workflow run with Hub-schema-validated model parameters |
 
 ### Run instances (`runs`)
 
@@ -153,6 +170,8 @@ apheris-foundry workflows run --help
 apheris-foundry jobs get --help
 ```
 
+`--model-params` accepts one JSON object. Use an inline object for short overrides, or prefix a JSON filename with `@` to load the object from that file. Before submitting the run, the CLI retrieves the selected model version, weight, and capability schema from Hub and validates the object. Use `workflows models` to discover available model IDs and weights.
+
 ## License
 
 This package is licensed under the [Apheris Foundry Software License](https://www.apheris.com/docs/hub/hub-license.html). The full license text is also included in every published wheel as `LICENSE`.

{apheris_foundry_cli-0.2.0 → apheris_foundry_cli-0.4.0}/README.md

@@ -16,37 +16,37 @@ Recommended if you already use conda for scientific Python work. A dedicated env
 #### Linux / macOS
 
 ```bash
-conda create -n apherisfold python=3.11 -y
-conda activate apherisfold
-pip install apherisfold-cli
+conda create -n apheris-foundry python=3.11 -y
+conda activate apheris-foundry
+pip install apheris-foundry-cli
 ```
 
 #### Windows (Anaconda Prompt or PowerShell)
 
 ```powershell
-conda create -n apherisfold python=3.11 -y
-conda activate apherisfold
-pip install apherisfold-cli
+conda create -n apheris-foundry python=3.11 -y
+conda activate apheris-foundry
+pip install apheris-foundry-cli
 ```
 
-Activate the environment at the start of each session with `conda activate apherisfold`.
+Activate the environment at the start of each session with `conda activate apheris-foundry`.
 
 ### venv (standard Python)
 
 #### Linux / macOS (venv)
 
 ```bash
-python3 -m venv ~/.venvs/apherisfold
-source ~/.venvs/apherisfold/bin/activate
-pip install apherisfold-cli
+python3 -m venv ~/.venvs/apheris-foundry
+source ~/.venvs/apheris-foundry/bin/activate
+pip install apheris-foundry-cli
 ```
 
 #### Windows (PowerShell, venv)
 
 ```powershell
-python -m venv $env:USERPROFILE\.venvs\apherisfold
-& $env:USERPROFILE\.venvs\apherisfold\Scripts\Activate.ps1
-pip install apherisfold-cli
+python -m venv $env:USERPROFILE\.venvs\apheris-foundry
+& $env:USERPROFILE\.venvs\apheris-foundry\Scripts\Activate.ps1
+pip install apheris-foundry-cli
 ```
 
 Activate the environment at the start of each session with the `activate` command above.
@@ -61,7 +61,7 @@ apheris-foundry --help
 ### Upgrade
 
 ```bash
-pip install --upgrade apherisfold-cli
+pip install --upgrade apheris-foundry-cli
 ```
 
 ## Quick start
@@ -76,6 +76,22 @@ apheris-foundry workflows list
 # Submit a run
 apheris-foundry workflows run --workflow predict --input ./request.json
 
+# Inspect the model IDs, weights, and default parameters advertised by Hub
+apheris-foundry workflows models --workflow predict
+
+# Override prediction parameters with a Hub-schema-validated JSON object
+apheris-foundry workflows run --workflow predict --input ./request.json \
+  --model-params '{"seeds":[7,9],"num_diffusion_samples":3}'
+
+# Or provide the same JSON object from a file
+apheris-foundry workflows run --workflow predict --input ./request.json \
+  --model-params @./model-params.json
+
+# Select a non-default model/weight advertised by the workflow
+apheris-foundry workflows run --workflow predict --input ./request.json \
+  --param model=<model-id> --weight <weight-version> \
+  --model-params @./model-params.json
+
 # List submitted runs
 apheris-foundry jobs list
 
@@ -109,9 +125,10 @@ apheris-foundry jobs error --id <job-id>
 | Command | Description |
 | ------- | ----------- |
 | `apheris-foundry workflows list` | List workflow definitions exposed by Hub |
-| `apheris-foundry workflows get --workflow <id>` | Inspect one workflow definition |
+| `apheris-foundry workflows get --workflow <id>` | Inspect one workflow definition and advertised model defaults |
+| `apheris-foundry workflows models --workflow <id>` | List models, weights, and default prediction parameters advertised by Hub (`--json` includes full metadata) |
 | `apheris-foundry workflows graph --workflow <id>` | Show the workflow DAG |
-| `apheris-foundry workflows run --workflow <id>` | Submit a workflow run |
+| `apheris-foundry workflows run --workflow <id> [--model-params <JSON\|@file>]` | Submit a workflow run with Hub-schema-validated model parameters |
 
 ### Run instances (`runs`)
 
@@ -130,6 +147,8 @@ apheris-foundry workflows run --help
 apheris-foundry jobs get --help
 ```
 
+`--model-params` accepts one JSON object. Use an inline object for short overrides, or prefix a JSON filename with `@` to load the object from that file. Before submitting the run, the CLI retrieves the selected model version, weight, and capability schema from Hub and validates the object. Use `workflows models` to discover available model IDs and weights.
+
 ## License
 
 This package is licensed under the [Apheris Foundry Software License](https://www.apheris.com/docs/hub/hub-license.html). The full license text is also included in every published wheel as `LICENSE`.

{apheris_foundry_cli-0.2.0 → apheris_foundry_cli-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "apheris-foundry-cli"
-version = "0.2.0"
+version = "0.4.0"
 description = "Command-line interface for Apheris Foundry workflows."
 readme = "README.md"
 requires-python = ">=3.10"

{apheris_foundry_cli-0.2.0 → apheris_foundry_cli-0.4.0}/src/apheris_foundry_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: apheris-foundry-cli
-Version: 0.2.0
+Version: 0.4.0
 Summary: Command-line interface for Apheris Foundry workflows.
 Author: Apheris
 License-Expression: LicenseRef-Apheris-Foundry-Software-License
@@ -39,37 +39,37 @@ Recommended if you already use conda for scientific Python work. A dedicated env
 #### Linux / macOS
 
 ```bash
-conda create -n apherisfold python=3.11 -y
-conda activate apherisfold
-pip install apherisfold-cli
+conda create -n apheris-foundry python=3.11 -y
+conda activate apheris-foundry
+pip install apheris-foundry-cli
 ```
 
 #### Windows (Anaconda Prompt or PowerShell)
 
 ```powershell
-conda create -n apherisfold python=3.11 -y
-conda activate apherisfold
-pip install apherisfold-cli
+conda create -n apheris-foundry python=3.11 -y
+conda activate apheris-foundry
+pip install apheris-foundry-cli
 ```
 
-Activate the environment at the start of each session with `conda activate apherisfold`.
+Activate the environment at the start of each session with `conda activate apheris-foundry`.
 
 ### venv (standard Python)
 
 #### Linux / macOS (venv)
 
 ```bash
-python3 -m venv ~/.venvs/apherisfold
-source ~/.venvs/apherisfold/bin/activate
-pip install apherisfold-cli
+python3 -m venv ~/.venvs/apheris-foundry
+source ~/.venvs/apheris-foundry/bin/activate
+pip install apheris-foundry-cli
 ```
 
 #### Windows (PowerShell, venv)
 
 ```powershell
-python -m venv $env:USERPROFILE\.venvs\apherisfold
-& $env:USERPROFILE\.venvs\apherisfold\Scripts\Activate.ps1
-pip install apherisfold-cli
+python -m venv $env:USERPROFILE\.venvs\apheris-foundry
+& $env:USERPROFILE\.venvs\apheris-foundry\Scripts\Activate.ps1
+pip install apheris-foundry-cli
 ```
 
 Activate the environment at the start of each session with the `activate` command above.
@@ -84,7 +84,7 @@ apheris-foundry --help
 ### Upgrade
 
 ```bash
-pip install --upgrade apherisfold-cli
+pip install --upgrade apheris-foundry-cli
 ```
 
 ## Quick start
@@ -99,6 +99,22 @@ apheris-foundry workflows list
 # Submit a run
 apheris-foundry workflows run --workflow predict --input ./request.json
 
+# Inspect the model IDs, weights, and default parameters advertised by Hub
+apheris-foundry workflows models --workflow predict
+
+# Override prediction parameters with a Hub-schema-validated JSON object
+apheris-foundry workflows run --workflow predict --input ./request.json \
+  --model-params '{"seeds":[7,9],"num_diffusion_samples":3}'
+
+# Or provide the same JSON object from a file
+apheris-foundry workflows run --workflow predict --input ./request.json \
+  --model-params @./model-params.json
+
+# Select a non-default model/weight advertised by the workflow
+apheris-foundry workflows run --workflow predict --input ./request.json \
+  --param model=<model-id> --weight <weight-version> \
+  --model-params @./model-params.json
+
 # List submitted runs
 apheris-foundry jobs list
 
@@ -132,9 +148,10 @@ apheris-foundry jobs error --id <job-id>
 | Command | Description |
 | ------- | ----------- |
 | `apheris-foundry workflows list` | List workflow definitions exposed by Hub |
-| `apheris-foundry workflows get --workflow <id>` | Inspect one workflow definition |
+| `apheris-foundry workflows get --workflow <id>` | Inspect one workflow definition and advertised model defaults |
+| `apheris-foundry workflows models --workflow <id>` | List models, weights, and default prediction parameters advertised by Hub (`--json` includes full metadata) |
 | `apheris-foundry workflows graph --workflow <id>` | Show the workflow DAG |
-| `apheris-foundry workflows run --workflow <id>` | Submit a workflow run |
+| `apheris-foundry workflows run --workflow <id> [--model-params <JSON\|@file>]` | Submit a workflow run with Hub-schema-validated model parameters |
 
 ### Run instances (`runs`)
 
@@ -153,6 +170,8 @@ apheris-foundry workflows run --help
 apheris-foundry jobs get --help
 ```
 
+`--model-params` accepts one JSON object. Use an inline object for short overrides, or prefix a JSON filename with `@` to load the object from that file. Before submitting the run, the CLI retrieves the selected model version, weight, and capability schema from Hub and validates the object. Use `workflows models` to discover available model IDs and weights.
+
 ## License
 
 This package is licensed under the [Apheris Foundry Software License](https://www.apheris.com/docs/hub/hub-license.html). The full license text is also included in every published wheel as `LICENSE`.

{apheris_foundry_cli-0.2.0 → apheris_foundry_cli-0.4.0}/src/apherisfold_cli/commands/foundry.py

@@ -9,6 +9,7 @@ from io import BytesIO
 from pathlib import Path
 from typing import Any
 
+import typer
 from rich import box
 from rich.console import Console, Group
 from rich.panel import Panel
@@ -16,9 +17,10 @@ from rich.table import Table
 from rich.text import Text
 from rich.tree import Tree
 
-from apherisfold_cli.core.errors import EXIT_PRECONDITION, EXIT_USAGE, CLIError
+from apherisfold_cli.core.errors import EXIT_INTERNAL, EXIT_PRECONDITION, EXIT_USAGE, CLIError
 from apherisfold_cli.core.hub_requests import (
     create_foundry_run,
+    download_foundry_run_archive,
     download_foundry_run_artifact,
     get_foundry_run,
     get_foundry_run_logs,
@@ -706,7 +708,7 @@ def foundry_run(
     final = _poll_until_terminal(run_id)
     if json_output:
         run_simple_listing(task_name="foundry.run", payload=final)
-
+        _exit_if_failed_run(final)
         return
 
     final_status = str(final.get("status", ""))
@@ -714,6 +716,7 @@ def foundry_run(
     _CONSOLE.print(f"[{style}]Job {run_id} finished: {final_status}[/{style}]")
     if final.get("error"):
         _CONSOLE.print(f"[red]Error: {final['error']}[/red]")
+    _exit_if_failed_run(final)
 
 
 _DEFAULT_LIST_LIMIT = 30
@@ -783,10 +786,14 @@ def foundry_models(workflow: str, *, json_output: bool) -> None:
     table.add_column("VERSION", overflow="fold")
     table.add_column("WEIGHT", no_wrap=True)
     table.add_column("CAPABILITIES", overflow="fold")
+    table.add_column("DEFAULT PARAMETERS", overflow="fold")
     table.add_column("DESCRIPTION", overflow="fold")
     for model in models:
         if not isinstance(model, dict):
             continue
+        wrapper = model.get("wrapper") if isinstance(model.get("wrapper"), dict) else {}
+        defaults = wrapper.get("predictParamsDefaults") if isinstance(wrapper, dict) else {}
+        defaults_text = json.dumps(defaults, sort_keys=True) if isinstance(defaults, dict) and defaults else ""
         weights = model.get("weights") if isinstance(model.get("weights"), list) else []
         if not weights:
             table.add_row(
@@ -794,6 +801,7 @@ def foundry_models(workflow: str, *, json_output: bool) -> None:
                 str(model.get("version", "")),
                 "",
                 ", ".join(str(item) for item in model.get("capabilities", []) if item),
+                defaults_text,
                 "",
             )
             continue
@@ -810,14 +818,20 @@ def foundry_models(workflow: str, *, json_output: bool) -> None:
                 str(model.get("version", "")),
                 f"{weight.get('version', '')}{marker}",
                 ", ".join(str(item) for item in capabilities if item),
+                defaults_text,
                 str(weight.get("description", "")),
             )
 
     examples = Table(box=box.SIMPLE_HEAD, show_header=False, padding=(0, 1), expand=False)
     examples.add_column("COMMAND", style="cyan", overflow="fold")
+    examples.add_row(f"apheris-foundry workflows run --workflow {workflow} --input request.json")
+    examples.add_row(
+        f"apheris-foundry workflows run --workflow {workflow} --weight <weight-version> --input request.json"
+    )
     examples.add_row(
-        f"apheris-foundry workflows run --workflow {workflow} --param model=mock --param weight=0.0.0 --input request.json"
+        f'apheris-foundry workflows run --workflow {workflow} --model-params \'{{"seeds":[42],"num_diffusion_samples":1}}\''
     )
+    examples.add_row(f"apheris-foundry workflows run --workflow {workflow} --model-params @model-params.json")
     examples.add_row(f"apheris-foundry workflows get --workflow {workflow}")
     run_simple_listing(
         task_name="foundry.models",
@@ -948,19 +962,9 @@ def foundry_download_result(
     task_name = "foundry.predict.download-result"
     selected_result_view = validate_result_view(result_view, task=task_name)
     run = get_foundry_run(run_id)
-    artifact = _resolve_download_artifact(run, artifact_id)
-    if artifact is None:
-        raise CLIError(
-            code=EXIT_PRECONDITION,
-            category="precondition",
-            message=(
-                f"No results.zip output is available for Foundry job {run_id}. "
-                f"Check files with: apheris-foundry jobs get --id {run_id}"
-            ),
-            task=task_name,
-        )
 
-    if not _is_results_archive_artifact(artifact):
+    if artifact_id:
+        artifact = _resolve_artifact(run, artifact_id)
         _download_selected_artifact(
             run_id=run_id,
             artifact=artifact,
@@ -970,10 +974,9 @@ def foundry_download_result(
         )
         return
 
-    archive_path = str(artifact.get("path", ""))
     destination = (output_dir or default_results_dir("foundry-predict", run_id)).expanduser().resolve()
     _ensure_download_dir(destination, task_name=task_name)
-    archive_bytes = download_foundry_run_artifact(run_id, archive_path)
+    archive_bytes = download_foundry_run_archive(run_id)
     results = extract_results_archive(
         archive_bytes=archive_bytes,
         output_dir=destination,
@@ -1077,13 +1080,6 @@ def foundry_error(run_id: str) -> None:
     _CONSOLE.print(Group(*panels))
 
 
-def _foundry_results_archive_path(run: dict[str, Any]) -> str:
-    artifact = _resolve_download_artifact(run, None)
-    if artifact is not None:
-        return str(artifact.get("path", ""))
-    return ""
-
-
 def _foundry_file_panels(run: dict[str, Any], *, result_preview: dict[str, Any] | None) -> list[Panel]:
     artifacts = _indexed_artifacts(run)
     workflow = str(run.get("workflow", ""))
@@ -1126,7 +1122,7 @@ def _foundry_commands_panel(run: dict[str, Any], *, result_preview: dict[str, An
     status = str(run.get("status", "")).lower()
     table = Table(box=box.SIMPLE_HEAD, show_header=False, padding=(0, 1), expand=False)
     table.add_column("command", style="cyan", overflow="fold")
-    has_results = _resolve_download_artifact(run, None) is not None
+    has_results = _has_downloadable_results(run)
     if has_results:
         table.add_row(f"{command_prefix} jobs download --id {run_id}")
     table.add_row(f"{command_prefix} jobs get --id {run_id} --artifact-id <id>")
@@ -1206,13 +1202,10 @@ def _slug(value: str) -> str:
     return slug or "artifact"
 
 
-def _resolve_download_artifact(run: dict[str, Any], artifact_id: str | None) -> dict[str, Any] | None:
-    if artifact_id:
-        return _resolve_artifact(run, artifact_id)
-    for artifact in _indexed_artifacts(run):
-        if _is_results_archive_artifact(artifact):
-            return artifact
-    return None
+def _has_downloadable_results(run: dict[str, Any]) -> bool:
+    observability = run.get("observability") if isinstance(run.get("observability"), dict) else {}
+    outputs = observability.get("outputs") if isinstance(observability.get("outputs"), list) else []
+    return any(isinstance(artifact, dict) and str(artifact.get("path", "")).strip() for artifact in outputs)
 
 
 def _resolve_artifact(run: dict[str, Any], artifact_id: str) -> dict[str, Any]:
@@ -1230,10 +1223,6 @@ def _resolve_artifact(run: dict[str, Any], artifact_id: str) -> dict[str, Any]:
     )
 
 
-def _is_results_archive_artifact(artifact: dict[str, Any]) -> bool:
-    return Path(str(artifact.get("path", ""))).name == "results.zip"
-
-
 def _download_selected_artifact(
     *,
     run_id: str,
@@ -1413,9 +1402,7 @@ def _artifact_action_panel(run: dict[str, Any], artifact: dict[str, Any]) -> Pan
     workflow = str(run.get("workflow", ""))
     command_prefix = _foundry_command_prefix(workflow)
     artifact_id = str(artifact.get("id", ""))
-    if _is_results_archive_artifact(artifact):
-        command = f"{command_prefix} jobs download --id {run_id}"
-    elif artifact_id:
+    if artifact_id:
         command = f"{command_prefix} jobs download --id {run_id} --artifact-id {artifact_id}"
     else:
         command = f"{command_prefix} jobs download --id {run_id}"
@@ -1478,26 +1465,22 @@ def _foundry_queries_panel(request_data: dict[str, Any] | None) -> Panel | None:
 
 def _load_foundry_result_preview(run: dict[str, Any]) -> dict[str, Any] | None:
     run_id = str(run.get("id", ""))
-    archive_path = _foundry_results_archive_path(run)
     archive_result: dict[str, Any] | None = None
-    if archive_path:
+    if _has_downloadable_results(run):
         try:
-            archive_bytes = download_foundry_run_artifact(run_id, archive_path)
+            archive_bytes = download_foundry_run_archive(run_id)
             archive_result = _inspect_foundry_results_archive(archive_bytes)
         except CLIError:
             pass
 
-    # The mock model (and Foundry's execution path) writes meta/*.json as
-    # separate filesystem artifacts rather than packing them into results.zip.
-    # Fall back to loading those individual metadata artifacts when the zip
-    # contains no meta/ entries.
+    # Fall back to individual metadata artifacts when the Hub archive endpoint
+    # is unavailable or contains no meta/ entries.
     if archive_result is not None and not archive_result.get("metadata"):
         metadata = _load_metadata_artifacts(run_id, run)
         if metadata:
             archive_result["metadata"] = metadata
 
     if archive_result is None:
-        # No results.zip at all — try to build a minimal preview from loose artifacts.
         metadata = _load_metadata_artifacts(run_id, run)
         if metadata:
             archive_result = {"predictions": [], "metadata": metadata, "other_files": []}
@@ -1673,12 +1656,10 @@ def _foundry_result_guidance_panel(run: dict[str, Any], *, result_preview: dict[
     run_id = str(run.get("id", "")).strip()
     if not run_id:
         return None
-    archive_path = _foundry_results_archive_path(run)
-    if archive_path:
+    if _has_downloadable_results(run):
         table = Table(box=box.SIMPLE_HEAD, show_header=True, padding=(0, 1), expand=True)
         table.add_column("FIELD", style="bold", no_wrap=True)
         table.add_column("VALUE", overflow="fold")
-        table.add_row("Archive", archive_path)
         table.add_row("Download", f"apheris-foundry jobs download --id {run_id}")
         if result_preview:
             predictions = result_preview.get("predictions", [])
@@ -1691,8 +1672,8 @@ def _foundry_result_guidance_panel(run: dict[str, Any], *, result_preview: dict[
 
     if str(run.get("status", "")).lower() == "succeeded":
         message = (
-            "No published output files are present in this Hub response yet. "
-            "After deploying the updated Hub, rerun the workflow or fetch this run again."
+            "No output artifacts are present in this Hub response. "
+            "Use the artifact IDs above to download individual files when available."
         )
         return Panel(Text(message, style="dim"), title="Results", border_style="dim")
     return None
@@ -1983,3 +1964,37 @@ def _poll_until_terminal(run_id: str) -> dict[str, Any]:
         if status in _TERMINAL_STATUSES:
             return run
         time.sleep(_POLL_INTERVAL)
+
+
+def _exit_if_failed_run(run: dict[str, Any]) -> None:
+    if str(run.get("status", "")).lower() != "failed":
+        return
+    raise typer.Exit(code=_failed_run_exit_code(run))
+
+
+def _failed_run_exit_code(run: dict[str, Any]) -> int:
+    for value in _run_exit_code_candidates(run):
+        try:
+            code = int(str(value).strip())
+        except (TypeError, ValueError):
+            continue
+        if 0 < code < 256:
+            return code
+    return EXIT_INTERNAL
+
+
+def _run_exit_code_candidates(run: dict[str, Any]) -> Iterable[Any]:
+    yield run.get("exitCode")
+    observability = run.get("observability")
+    if not isinstance(observability, dict):
+        return
+    steps = observability.get("steps")
+    if not isinstance(steps, list):
+        return
+    for step in steps:
+        if not isinstance(step, dict):
+            continue
+        status = str(step.get("status", "")).upper()
+        exit_code = str(step.get("exitCode", "")).strip()
+        if status in {"FAILED", "ERROR"} or exit_code not in {"", "0", "-"}:
+            yield step.get("exitCode")

{apheris_foundry_cli-0.2.0 → apheris_foundry_cli-0.4.0}/src/apherisfold_cli/commands/login.py

@@ -43,15 +43,15 @@ def _is_verbose() -> bool:
 def _build_examples_table() -> Table:
     table = Table(box=box.SIMPLE_HEAD, show_header=False, padding=(0, 1))
     table.add_column("command")
-    table.add_row(Text("apherisfold login --url https://hub.example.com", style="cyan"))
-    table.add_row(Text("apherisfold login --url https://hub.example.com --callback-host localhost", style="cyan"))
+    table.add_row(Text("apheris-foundry login --url https://hub.example.com", style="cyan"))
+    table.add_row(Text("apheris-foundry login --url https://hub.example.com --callback-host localhost", style="cyan"))
     table.add_row(
         Text(
-            "apherisfold login --url https://hub.example.com --issuer https://dex.example.com --client-id apheris-hub",
+            "apheris-foundry login --url https://hub.example.com --issuer https://dex.example.com --client-id apheris-hub",
             style="cyan",
         )
     )
-    table.add_row(Text("apherisfold login status", style="cyan"))
+    table.add_row(Text("apheris-foundry login status", style="cyan"))
     return table
 
 
@@ -70,7 +70,7 @@ def _render_login_overview() -> None:
 
     console.print(
         Group(
-            Text("Usage: apherisfold login --url HUB_URL [--callback-host HOST]", style="bold"),
+            Text("Usage: apheris-foundry login --url HUB_URL [--callback-host HOST]", style="bold"),
             Text(""),
             Panel(options_table, title="Login Options", border_style="dim"),
             Panel(_build_examples_table(), title="Examples", border_style="dim"),