decision-toolkit 0.3.0__tar.gz → 0.3.1__tar.gz

{decision_toolkit-0.3.0 → decision_toolkit-0.3.1}/CHANGELOG.md

@@ -1,8 +1,15 @@
 # Changelog
 
-All notable changes to this project are documented here. Version `0.3.0` is
+All notable changes to this project are documented here. Version `0.3.1` is
 published on PyPI.
 
+## [0.3.1] — 2026-10-21
+
+Catalog UX patch: `dtk models list` now prints one row per variant, with
+`variant`, quantization, role, size, cache state and the exact download/select
+commands. `dtk models variants` prints both commands for every variant. No
+model, adapter or REST contract changes.
+
 ## [0.3.0] — 2026-10-21
 
 Catalog expansion: three verified ONNX decision models and eight variants.
@@ -185,6 +192,7 @@ README correction. No code or model behavior changed.
 - Typed `DecisionModel` API with lifecycle, batching, async, usage, warnings,
   normalized confidence, capabilities, structured events and atomic model store.
 
+[0.3.1]: https://pypi.org/project/decision-toolkit/0.3.1/
 [0.3.0]: https://pypi.org/project/decision-toolkit/0.3.0/
 [0.2.1]: https://pypi.org/project/decision-toolkit/0.2.1/
 [0.2.0]: https://pypi.org/project/decision-toolkit/0.2.0/

{decision_toolkit-0.3.0 → decision_toolkit-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: decision-toolkit
-Version: 0.3.0
+Version: 0.3.1
 Summary: Local-first toolkit for open-weights decision models: one ONNX engine, one adapter per model contract, typed choice/yes-no/score decisions with probabilities on CPU.
 Project-URL: Homepage, https://github.com/gia-uh/decision-toolkit
 Project-URL: Repository, https://github.com/gia-uh/decision-toolkit
@@ -59,7 +59,7 @@ and CLI. `dtk --help` and every subcommand help also include runnable examples.
 ## Installation
 
 ```bash
-uv pip install decision-toolkit              # library + CLI (0.3.0 on PyPI)
+uv pip install decision-toolkit              # library + CLI (0.3.1 on PyPI)
 uv pip install "decision-toolkit[onnx]"      # + onnxruntime, tokenizers (the model runtime)
 uv pip install "decision-toolkit[server]"    # + REST server (FastAPI)
 ```
@@ -67,7 +67,7 @@ uv pip install "decision-toolkit[server]"    # + REST server (FastAPI)
 The project is managed with [uv](https://docs.astral.sh/uv/) and ships a committed `uv.lock`. Published
 wheels remain compatible with `pip` for environments that do not use uv.
 
-PyPI: <https://pypi.org/project/decision-toolkit/0.3.0/>. See
+PyPI: <https://pypi.org/project/decision-toolkit/0.3.1/>. See
 [docs/RELEASE.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/RELEASE.md)
 for the Trusted Publishing flow and clean-install checks.
 
@@ -208,7 +208,7 @@ adapters (there is no generic "any ONNX" adapter).
 | `julia-1` | `julia` | **m0** — verified: 100/100 argmax parity, 329 ms | `fp32`* (618 MB) |
 | `opendecider-nano` | `opendecider` | **m0** — official build; prompt ported from pinned code (530 ms) | `q8f16`* (469 MB); `fp16` (792 MB) |
 | `laya-multilingual` | `laya` | **m0** — fused ONNX; upstream parity (37 ms) | `fp16`* (682 MB); `fp32` (1326 MB) |
-| `open-jev-deberta-v3-large` | `open-jev` | **m0** — open Jev repro; 0.854 in-domain (241 ms) | `fp16`* (884 MB); `fp32` (1758 MB); `q4` (487 MB); `q4f16` (357 MB) |
+| `open-jev-deberta-v3-large` | `open-jev` | **m0** — Open-Jev DeBERTa v3 large repro; 0.854 in-domain (241 ms) | `fp16`* (884 MB); `fp32` (1758 MB); `q4` (487 MB); `q4f16` (357 MB) |
 | `strands-decider-2b` | `strands-decider` | **m0** — reference fixture match (719 ms) | `q4f16`* (1114 MB); `q8` (1821 MB) |
 
 **Only `m0` models are in the catalog.** Researched-but-unavailable models
@@ -225,7 +225,7 @@ own repo files, size and role. A `*` in the table above marks the default.
 `dtk models list` always shows every catalogued variant and what is cached:
 
 ```bash
-dtk models list                      # all variants; * = default
+dtk models list                      # one row per variant; * = default
 dtk models list --quant              # add the quantization labels
 dtk models variants gliner2.5-multi  # full details for one model
 ```

{decision_toolkit-0.3.0 → decision_toolkit-0.3.1}/README.md

@@ -21,7 +21,7 @@ and CLI. `dtk --help` and every subcommand help also include runnable examples.
 ## Installation
 
 ```bash
-uv pip install decision-toolkit              # library + CLI (0.3.0 on PyPI)
+uv pip install decision-toolkit              # library + CLI (0.3.1 on PyPI)
 uv pip install "decision-toolkit[onnx]"      # + onnxruntime, tokenizers (the model runtime)
 uv pip install "decision-toolkit[server]"    # + REST server (FastAPI)
 ```
@@ -29,7 +29,7 @@ uv pip install "decision-toolkit[server]"    # + REST server (FastAPI)
 The project is managed with [uv](https://docs.astral.sh/uv/) and ships a committed `uv.lock`. Published
 wheels remain compatible with `pip` for environments that do not use uv.
 
-PyPI: <https://pypi.org/project/decision-toolkit/0.3.0/>. See
+PyPI: <https://pypi.org/project/decision-toolkit/0.3.1/>. See
 [docs/RELEASE.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/RELEASE.md)
 for the Trusted Publishing flow and clean-install checks.
 
@@ -170,7 +170,7 @@ adapters (there is no generic "any ONNX" adapter).
 | `julia-1` | `julia` | **m0** — verified: 100/100 argmax parity, 329 ms | `fp32`* (618 MB) |
 | `opendecider-nano` | `opendecider` | **m0** — official build; prompt ported from pinned code (530 ms) | `q8f16`* (469 MB); `fp16` (792 MB) |
 | `laya-multilingual` | `laya` | **m0** — fused ONNX; upstream parity (37 ms) | `fp16`* (682 MB); `fp32` (1326 MB) |
-| `open-jev-deberta-v3-large` | `open-jev` | **m0** — open Jev repro; 0.854 in-domain (241 ms) | `fp16`* (884 MB); `fp32` (1758 MB); `q4` (487 MB); `q4f16` (357 MB) |
+| `open-jev-deberta-v3-large` | `open-jev` | **m0** — Open-Jev DeBERTa v3 large repro; 0.854 in-domain (241 ms) | `fp16`* (884 MB); `fp32` (1758 MB); `q4` (487 MB); `q4f16` (357 MB) |
 | `strands-decider-2b` | `strands-decider` | **m0** — reference fixture match (719 ms) | `q4f16`* (1114 MB); `q8` (1821 MB) |
 
 **Only `m0` models are in the catalog.** Researched-but-unavailable models
@@ -187,7 +187,7 @@ own repo files, size and role. A `*` in the table above marks the default.
 `dtk models list` always shows every catalogued variant and what is cached:
 
 ```bash
-dtk models list                      # all variants; * = default
+dtk models list                      # one row per variant; * = default
 dtk models list --quant              # add the quantization labels
 dtk models variants gliner2.5-multi  # full details for one model
 ```

{decision_toolkit-0.3.0 → decision_toolkit-0.3.1}/docs/CATALOG_PROPOSAL.md

@@ -1,8 +1,9 @@
 # Catalog proposal: three ONNX decision models
 
 **Date:** 2026-10-21  
-**Status:** implemented and verified in the working tree  
-**Scope:** add Laya multilingual, Open-Jev DeBERTa v3 large and Strands Decider 2B
+**Status:** published in `0.3.0`  
+**Scope:** add Laya multilingual, Open-Jev DeBERTa v3 large and Strands Decider 2B  
+**Release:** <https://pypi.org/project/decision-toolkit/0.3.0/>
 
 ## Executive summary
 
@@ -57,14 +58,14 @@ ONNX Runtime 1.31.0, CPU):
 |---|---|---:|
 | Laya multilingual | fp16 | 37.4 ms |
 | Laya multilingual | fp32 | 34.1 ms |
-| Open-Jev | fp16 | 241.2 ms |
-| Open-Jev | fp32 | 78.2 ms |
-| Open-Jev | q4 | 56.0 ms |
-| Open-Jev | q4f16 | 219.4 ms |
+| Open-Jev DeBERTa v3 large | fp16 | 241.2 ms |
+| Open-Jev DeBERTa v3 large | fp32 | 78.2 ms |
+| Open-Jev DeBERTa v3 large | q4 | 56.0 ms |
+| Open-Jev DeBERTa v3 large | q4f16 | 219.4 ms |
 | Strands Decider 2B | q4f16 | 719.3 ms |
 | Strands Decider 2B | q8 | 1467.2 ms |
 
-The Open-Jev 4-bit paths are size/edge choices; they are not assumed to be
+The Open-Jev DeBERTa v3 large 4-bit paths are size/edge choices; they are not assumed to be
 faster or more accurate. Strands is a 2B model and is intentionally slower
 than the other catalog entries.
 
@@ -72,7 +73,7 @@ than the other catalog entries.
 
 - **Laya multilingual:** upstream conversion reports fp32 max |Δp| 1e-4 and
   fp16 0.035 against PyTorch; local fp16/fp32 agree on the audit answers.
-- **Open-Jev:** upstream reports 0.854 in-domain and 0.690 OOD accuracy, plus
+- **Open-Jev DeBERTa v3 large:** upstream reports 0.854 in-domain and 0.690 OOD accuracy, plus
   0.022 in-domain ECE. Local fp16/fp32 agree on the published example; q4
   variants are explicitly edge builds.
 - **Strands Decider 2B:** reference fixture matches within 0.018 max
@@ -84,7 +85,7 @@ independent reproduction of the full upstream training evaluation.
 ## Quantization policy
 
 - Default variants are chosen for a balance of quality, size and CPU latency:
-  Laya fp16, Open-Jev fp16, Strands q4f16.
+  Laya fp16, Open-Jev DeBERTa v3 large fp16, Strands q4f16.
 - `fp32` remains a quality variant where published.
 - `q4`/`q4f16`/`q8` are exposed, but their thresholds must be validated on the
   user's data; no silent fallback exists.
@@ -98,10 +99,11 @@ independent reproduction of the full upstream training evaluation.
    runtime checks. A larger acceptance run is still desirable.
 2. **Strands CPU cost.** q8 takes ~1.5 s per simple question; this is suitable
    for local/agentic workflows, not high-throughput serving.
-3. **Quantization drift.** Open-Jev q4 and Strands q4f16 can move near-ties;
+3. **Quantization drift.** Open-Jev DeBERTa v3 large q4 and Strands q4f16 can move near-ties;
    the model cards call this out.
-4. **Coverage.** Laya multilingual is weak on low-resource languages; Open-Jev
-   is English-only and weak on unseen score scales; Strands is a 2B model with
+4. **Coverage.** Laya multilingual is weak on low-resource languages;
+   Open-Jev DeBERTa v3 large is English-only and weak on unseen score scales;
+   Strands is a 2B model with
    its own upstream limitations.
 5. **No image/box support.** The catalog remains text-only.
 

{decision_toolkit-0.3.0 → decision_toolkit-0.3.1}/docs/CLI.md

@@ -184,10 +184,12 @@ classification or serve command overrides it for that command. If `--variant`
 is omitted, the catalog default is used unless `dtk models use` selected another
 one.
 
-`models list --json` always includes license, quant, adapter, capabilities, all
-variants, the default variant, cached variants, `current` and `current_variant`.
-The text table always shows variants and cached variants; `--license`, `--quant`
-and `--adapter` add their columns.
+`models list` text output has **one row per variant**, with `id`, `variant`,
+`quant`, `role`, `size` and `cached`, followed by the exact download/select
+commands. `--license` and `--adapter` add catalog columns; `--quant` is accepted
+for compatibility because quantization is always shown. `--json` returns the
+nested model tree: one object per model, each with its `variants` and
+`cached_variants`.
 
 See [Variants and quantization](VARIANTS.md) for the full table and cache
 layout.

{decision_toolkit-0.3.0 → decision_toolkit-0.3.1}/docs/RELEASE.md

@@ -10,7 +10,7 @@ and selection in the CLI and documentation; `0.1.7` aligned variant selection
 across the library, CLI and REST API; `0.2.0` corrected the REST conformance
 claims and wire shapes to the published TypeSafe and OpenAI schemas; `0.2.1`
 changed the public documentation URLs to this repository's Pages site; `0.3.0`
-added the Laya multilingual, Open-Jev and Strands Decider ONNX models.
+added the Laya multilingual, Open-Jev DeBERTa v3 large and Strands Decider ONNX models; `0.3.1` made the catalog list one row per variant with exact commands.
 
 ## Local build and verification
 
@@ -37,7 +37,7 @@ Clean install test (no `PYTHONPATH`):
 ```bash
 uv venv --python 3.12 /tmp/dtk-wheel
 uv pip install --python /tmp/dtk-wheel/bin/python \
-  dist/decision_toolkit-0.3.0-py3-none-any.whl
+  dist/decision_toolkit-0.3.1-py3-none-any.whl
 uv pip check --python /tmp/dtk-wheel/bin/python
 /tmp/dtk-wheel/bin/dtk --version
 /tmp/dtk-wheel/bin/dtk models list --json
@@ -48,7 +48,7 @@ With inference and server extras:
 
 ```bash
 uv pip install --python /tmp/dtk-wheel/bin/python \
-  "dist/decision_toolkit-0.3.0-py3-none-any.whl[onnx,server,tracing]"
+  "dist/decision_toolkit-0.3.1-py3-none-any.whl[onnx,server,tracing]"
 /tmp/dtk-wheel/bin/dtk decide --model gliner2.5-decide ...
 /tmp/dtk-wheel/bin/dtk serve --model gliner2.5-decide --warmup --port 8016
 curl -s http://127.0.0.1:8016/health
@@ -82,8 +82,8 @@ No long-lived PyPI token is needed; the workflow uses GitHub OIDC
 4. Create and push an annotated tag:
 
    ```bash
-   git tag -a v0.3.0 -m "decision-toolkit 0.3.0"
-   git push origin v0.3.0
+   git tag -a v0.3.1 -m "decision-toolkit 0.3.1"
+   git push origin v0.3.1
    ```
 
 5. `.github/workflows/release.yml` builds once, publishes to **TestPyPI**, then
@@ -132,9 +132,9 @@ to TestPyPI without publishing to PyPI or creating a GitHub release.
 
 ## Published release
 
-`0.3.0` is published through Trusted Publishing on 2026-10-21:
+`0.3.1` is published through Trusted Publishing on 2026-10-21:
 
-<https://pypi.org/project/decision-toolkit/0.3.0/>
+<https://pypi.org/project/decision-toolkit/0.3.1/>
 
 `0.1.0` was the first release; `0.1.1` refreshed the PyPI description; `0.1.2`
 validated the OIDC TestPyPI → PyPI flow; `0.1.3` added post-publish install
@@ -144,7 +144,7 @@ published to TestPyPI only; `0.1.5` fixed TestPyPI resolution; `0.1.6` added
 complete variant/quantization visibility and CLI selection; `0.1.7` aligned
 selection across library, CLI and REST; `0.2.0` corrected the REST conformance
 claims and wire shapes; `0.2.1` changed the public documentation URLs; `0.3.0`
-added the three new ONNX decision models.
+added the three new ONNX decision models; `0.3.1` made the catalog list one row per variant.
 
 The tag-triggered workflow remains the preferred path for future releases once
 the TestPyPI/PyPI trusted publishers and protected environments are configured.

{decision_toolkit-0.3.0 → decision_toolkit-0.3.1}/docs/VARIANTS.md

@@ -18,23 +18,23 @@ have not passed the catalog gates are not exposed as variants.
 A `*` marks the default variant. It is used when `--variant` is omitted and no
 other variant was selected with `dtk models use`.
 
-| Model | Variant | Quantization | Size | Role |
-| --- | --- | --- | ---: | --- |
-| `gliner2.5-multi` | `fp16` * | fp16 encoder + fp32 classifier | 577.1 MB | default |
-| `gliner2.5-multi` | `fp32` | fp32 encoder + fp32 classifier | 1131.9 MB | quality |
-| `gliner2.5-decide` | `q4f16` * | q4/fp16 | 523.5 MB | default |
-| `laya` | `q8` * | int8 | 527.9 MB | default |
-| `julia-1` | `fp32` * | fp32 | 618.2 MB | default |
-| `opendecider-nano` | `q8f16` * | int8/fp16 | 468.8 MB | default |
-| `opendecider-nano` | `fp16` | fp16 | 791.9 MB | quality |
-| `laya-multilingual` | `fp16` * | fp16 | 681.8 MB | default |
-| `laya-multilingual` | `fp32` | fp32 | 1325.6 MB | quality |
-| `open-jev-deberta-v3-large` | `fp16` * | fp16 | 883.5 MB | default |
-| `open-jev-deberta-v3-large` | `fp32` | fp32 | 1757.9 MB | quality |
-| `open-jev-deberta-v3-large` | `q4` | q4 | 486.7 MB | edge |
-| `open-jev-deberta-v3-large` | `q4f16` | q4/fp16 | 357.0 MB | edge |
-| `strands-decider-2b` | `q4f16` * | q4/fp16 | 1113.6 MB | default |
-| `strands-decider-2b` | `q8` | int8 | 1821.4 MB | quality |
+| Model | Variant | Quantization | Size | Role | Download |
+| --- | --- | --- | ---: | --- | --- |
+| `gliner2.5-multi` | `fp16` * | fp16 encoder + fp32 classifier | 577.1 MB | default | `dtk models download gliner2.5-multi --variant fp16` |
+| `gliner2.5-multi` | `fp32` | fp32 encoder + fp32 classifier | 1131.9 MB | quality | `dtk models download gliner2.5-multi --variant fp32` |
+| `gliner2.5-decide` | `q4f16` * | q4/fp16 | 523.5 MB | default | `dtk models download gliner2.5-decide --variant q4f16` |
+| `laya` | `q8` * | int8 | 527.9 MB | default | `dtk models download laya --variant q8` |
+| `julia-1` | `fp32` * | fp32 | 618.2 MB | default | `dtk models download julia-1 --variant fp32` |
+| `opendecider-nano` | `q8f16` * | int8/fp16 | 468.8 MB | default | `dtk models download opendecider-nano --variant q8f16` |
+| `opendecider-nano` | `fp16` | fp16 | 791.9 MB | quality | `dtk models download opendecider-nano --variant fp16` |
+| `laya-multilingual` | `fp16` * | fp16 | 681.8 MB | default | `dtk models download laya-multilingual --variant fp16` |
+| `laya-multilingual` | `fp32` | fp32 | 1325.6 MB | quality | `dtk models download laya-multilingual --variant fp32` |
+| `open-jev-deberta-v3-large` | `fp16` * | fp16 | 883.5 MB | default | `dtk models download open-jev-deberta-v3-large --variant fp16` |
+| `open-jev-deberta-v3-large` | `fp32` | fp32 | 1757.9 MB | quality | `dtk models download open-jev-deberta-v3-large --variant fp32` |
+| `open-jev-deberta-v3-large` | `q4` | q4 | 486.7 MB | edge | `dtk models download open-jev-deberta-v3-large --variant q4` |
+| `open-jev-deberta-v3-large` | `q4f16` | q4/fp16 | 357.0 MB | edge | `dtk models download open-jev-deberta-v3-large --variant q4f16` |
+| `strands-decider-2b` | `q4f16` * | q4/fp16 | 1113.6 MB | default | `dtk models download strands-decider-2b --variant q4f16` |
+| `strands-decider-2b` | `q8` | int8 | 1821.4 MB | quality | `dtk models download strands-decider-2b --variant q8` |
 
 Models with a single row have only one catalogued, verified build. That does
 not mean other conversions do not exist upstream; it means they have not passed
@@ -87,12 +87,15 @@ dtk models variants opendecider-nano --json
 Example:
 
 ```text
-id                 variants        cached
-gliner2.5-multi    fp16*, fp32     fp16
-gliner2.5-decide   q4f16*          q4f16
-opendecider-nano   q8f16*, fp16    q8f16
-
-* default variant. Use `dtk models variants <id>` for details and install commands.
+id                variant  quant    role     size       cached
+gliner2.5-multi   fp16*    fp16     default  577.1 MB   ✓
+gliner2.5-multi   fp32     fp32     quality  1131.9 MB  ✓
+gliner2.5-decide  q4f16*   q4/fp16  default  523.5 MB   ✓
+laya              q8*      int8     default  527.9 MB   ✓
+
+* default variant.
+download: dtk models download <id> --variant <name>
+select:   dtk models use <id> --variant <name>
 ```
 
 ## Download a different quantization

{decision_toolkit-0.3.0 → decision_toolkit-0.3.1}/docs/models/open-jev-deberta-v3-large.md

@@ -65,7 +65,7 @@ and re-check thresholds. See [Variants and quantization](../VARIANTS.md).
   (upstream in-domain 0.85 vs OOD 0.69).
 - Score on unseen level sets is weak in the upstream evaluation.
 - It chooses among supplied options; it cannot generate explanations.
-- This is an independent open-jev reproduction, not an official TypeSafe model.
+- This is an independent Open-Jev DeBERTa v3 large reproduction, not an official TypeSafe model.
 
 ## Usage
 

{decision_toolkit-0.3.0 → decision_toolkit-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "decision-toolkit"
-version = "0.3.0"
+version = "0.3.1"
 description = "Local-first toolkit for open-weights decision models: one ONNX engine, one adapter per model contract, typed choice/yes-no/score decisions with probabilities on CPU."
 readme = "README.md"
 requires-python = ">=3.12"

{decision_toolkit-0.3.0 → decision_toolkit-0.3.1}/src/decision_toolkit/__init__.py

@@ -7,7 +7,7 @@ questions with a calibrated probability for every option, on CPU.
 
 from __future__ import annotations
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"
 
 from .adapters import register_adapter
 from .calibration import brier_score, expected_calibration_error, threshold_sweep

{decision_toolkit-0.3.0 → decision_toolkit-0.3.1}/src/decision_toolkit/cli.py

@@ -709,35 +709,43 @@ def _cmd_models(args: argparse.Namespace) -> int:
         if as_json:
             _json_out(payloads)
             return EXIT_OK
-        headers = ["", "id", "variants"]
+        headers = ["", "id", "variant", "quant", "role", "size", "cached"]
         if args.show_adapter:
-            headers.append("adapter")
+            headers.insert(2, "adapter")
         if args.show_license:
-            headers.append("license")
-        if args.show_quant:
-            headers.append("quant")
-        headers.append("cached")
+            headers.insert(3, "license")
         rows = []
         for model, payload in zip(catalog.CATALOG, payloads):
             default = model.default_variant
-            variants = ", ".join(
-                f"{variant.name}*" if variant is default else variant.name
-                for variant in model.variants
-            ) or "—"
-            row: list[Any] = ["★" if model.id == current else " ", model.id, variants]
-            if args.show_adapter:
-                row.append(model.adapter)
-            if args.show_license:
-                row.append(model.license)
-            if args.show_quant:
-                row.append(
-                    ", ".join(variant.quant for variant in model.variants) or "—"
+            cached_variants = set(payload["cached_variants"])
+            if not model.variants:
+                rows.append(["", model.id, "—", "—", "—", "—", "—"])
+                continue
+            for variant in model.variants:
+                is_current = model.id == current and (
+                    current_variant == variant.name
+                    if current_variant is not None
+                    else variant is default
                 )
-            cached_label = ", ".join(payload["cached_variants"]) or "—"
-            row.append(cached_label)
-            rows.append(row)
+                label = f"{variant.name}*" if variant is default else variant.name
+                row: list[Any] = [
+                    "★" if is_current else "",
+                    model.id,
+                    label,
+                    variant.quant,
+                    variant.role,
+                    f"{variant.size_mb:.1f} MB",
+                    "✓" if variant.name in cached_variants else "",
+                ]
+                if args.show_adapter:
+                    row.insert(2, model.adapter)
+                if args.show_license:
+                    row.insert(3, model.license)
+                rows.append(row)
         _print_table(headers, rows)
-        print("\n* default variant. Use `dtk models variants <id>` for details and install commands.")
+        print("\n* default variant.")
+        print("download: dtk models download <id> --variant <name>")
+        print("select:   dtk models use <id> --variant <name>")
         return EXIT_OK
 
     if command == "variants":
@@ -777,6 +785,10 @@ def _cmd_models(args: argparse.Namespace) -> int:
                 f"           download: dtk models download {model.id} "
                 f"--variant {variant.name}"
             )
+            print(
+                f"           use:      dtk models use {model.id} "
+                f"--variant {variant.name}"
+            )
         if not model.variants:
             print("  (no downloadable ONNX variant yet)")
         else:

{decision_toolkit-0.3.0 → decision_toolkit-0.3.1}/tests/test_cli.py

@@ -192,9 +192,12 @@ def test_models_list_shows_all_cached_variants(home, fake_snapshot, capsys):
     store.download("gliner2.5-multi", variant="fp32")
     assert cli.main(["--home", str(home), "models", "list"]) == 0
     output = _out(capsys)
-    row = next(line for line in output.splitlines() if "gliner2.5-multi" in line)
-    assert "fp16*, fp32" in row
-    assert "fp16, fp32" in row
+    rows = [line for line in output.splitlines() if "gliner2.5-multi" in line]
+    assert len(rows) == 2
+    assert any("fp16*" in row and "✓" in row for row in rows)
+    assert any("fp32" in row and "✓" in row for row in rows)
+    assert "download: dtk models download <id> --variant <name>" in output
+    assert "select:   dtk models use <id> --variant <name>" in output
 
 
 def test_models_list_json_and_columns(home, capsys):
@@ -226,8 +229,10 @@ def test_models_list_json_and_columns(home, capsys):
     assert "license" in text
     assert "quant" in text
     assert "adapter" in text
-    assert "fp16*, fp32" in text
-    assert "fp16, fp32" in text
+    assert "fp16*" in text
+    assert "fp32" in text
+    assert "laya-multilingual" in text
+    assert "open-jev-deberta-v3-large" in text
 
 
 def test_models_variants_text_and_json(home, capsys):

{decision_toolkit-0.3.0 → decision_toolkit-0.3.1}/uv.lock

@@ -349,7 +349,7 @@ wheels = [
 
 [[package]]
 name = "decision-toolkit"
-version = "0.3.0"
+version = "0.3.1"
 source = { editable = "." }
 dependencies = [
     { name = "huggingface-hub" },