feat(model): Model.model_runs() — list a model's run ids

[luke-e-schaefer]

Summary

Adds Model.model_runs() — the model-scoped counterpart to Dataset.model_runs(), which only lists a single dataset's runs. Hits the new GET /nucleus/model/:modelId/modelRun route.

run_ids = model.model_runs()                       # runs whose model_id is this model
run_ids = model.model_runs(include_versions=True)  # union across the version lineage (?family=true)

• nucleus/model.py — new model_runs(include_versions=False) -> List[str], delegates to make_request({}, "model/{id}/modelRun", requests.get) (mirrors Dataset.model_runs).
• Results are scoped server-side to runs on datasets the caller can read.
• tests/test_model_runs_listing.py — mock unit tests: returns the ids / hits the right route, and include_versions=True appends ?family=true.
• CHANGELOG 0.21.3 + pyproject version bump.

Test Plan

• pytest tests/test_model_runs_listing.py → 2 passed. black/isort clean.
• Live call 404s until the server route (scaleapi#158386) deploys — noted in the CHANGELOG.

Server dependency

Pairs with scaleapi#158386 (GET /nucleus/model/:modelId/modelRun).

🤖 Generated with Claude Code

Greptile Summary

Adds a model-scoped API for listing run IDs, with optional inclusion of runs across the model’s version lineage. The change also adds focused route tests and releases the API as version 0.21.3.

• Adds Model.model_runs(include_versions=False).
• Sends family=true when version-lineage runs are requested.
• Adds unit tests for returned IDs and both route variants.
• Updates the package version and changelog.

Confidence Score: 5/5

The PR appears safe to merge, with no concrete client-side defects identified in the new model-run listing path.

The route construction, GET delegation, optional lineage query, return contract, tests, documentation, and package version are internally consistent.

Important Files Changed

Filename	Overview
nucleus/model.py	Adds the model-run listing method using the existing shared request transport; no actionable defect was identified.
tests/test_model_runs_listing.py	Covers the default route, lineage query parameter, HTTP verb, payload, and returned run IDs.
pyproject.toml	Advances the package version from 0.21.2 to 0.21.3.
CHANGELOG.md	Documents the new method, lineage option, access scoping, and acknowledged server deployment dependency.

_{Reviews (1): Last reviewed commit: "feat(model): add Model.model_runs() to l..." | Re-trigger Greptile}

Context used (3)

• Knowledge Base — Connection and request behavior
• Knowledge Base — Model workflows
• Knowledge Base — Model runs, weights, and predictions