feat(cli): Add deploy revisions list command (#7142)

### Summary ``` % langgraph deploy revisions list f5bb6e58-e2ab-40b9-9855-d6dd6d1051b6 No LangSmith API key found. Create one at Settings > API Keys in LangSmith. Enter LangSmith API key: Revision ID Status Created At ------------------------------------ -------- --------------------------- fe05f163-58cf-4783-a918-0c78a8fab0c7 BUILDING 2026-03-12T20:47:14.626436Z 03c32fcf-544f-4517-a016-c7a7243b898d DEPLOYED 2026-03-12T20:30:09.199275Z 29605810-29cc-4110-ac05-d43e564827d0 DEPLOYED 2026-03-12T19:56:36.232427Z ```
2026-09-22 17:45:09 +02:00 · 2026-03-19 16:55:19 -07:00
parent 54c92757f2
commit cc9acc1ba9
4 changed files with 283 additions and 22 deletions
@@ -297,6 +297,8 @@ def test_top_level_help_shows_deploy_subcommands() -> None:
    assert "deploy" in result.output
    assert "deploy list" in result.output
    assert "deploy delete" in result.output
+    assert "deploy revisions" in result.output
+    assert "deploy revisions list" in result.output
    assert "[Beta] List LangSmith Deployments." in result.output


@@ -402,6 +404,140 @@ def test_deploy_list_command_no_results(monkeypatch) -> None:
    assert result.output.strip() == "No deployments found."


+def test_deploy_revisions_list_command(monkeypatch) -> None:
+    runner = CliRunner()
+    captured: dict[str, str] = {}
+
+    class FakeClient:
+        def __init__(self, host_url: str, api_key: str, tenant_id: str | None = None):
+            captured["host_url"] = host_url
+            captured["api_key"] = api_key
+            captured["tenant_id"] = tenant_id or ""
+
+        def list_revisions(self, deployment_id: str, limit: int = 1):
+            captured["deployment_id"] = deployment_id
+            captured["limit"] = str(limit)
+            return {
+                "resources": [
+                    {
+                        "id": "rev-123",
+                        "status": "CREATING",
+                        "created_at": "2023-11-07T05:31:56Z",
+                    },
+                    {
+                        "id": "rev-456",
+                        "status": "DEPLOYED",
+                        "created_at": "2023-11-08T10:00:00Z",
+                    },
+                ]
+            }
+
+    monkeypatch.setattr(cli_module, "HostBackendClient", FakeClient)
+
+    result = runner.invoke(
+        cli,
+        [
+            "deploy",
+            "revisions",
+            "list",
+            "--api-key",
+            "test-key",
+            "--host-url",
+            "https://api.example.com",
+            "dep-123",
+        ],
+    )
+
+    assert result.exit_code == 0, result.output
+    assert captured == {
+        "host_url": "https://api.example.com",
+        "api_key": "test-key",
+        "tenant_id": "",
+        "deployment_id": "dep-123",
+        "limit": "10",
+    }
+    assert "Revision ID" in result.output
+    assert "Status" in result.output
+    assert "Created At" in result.output
+    assert "rev-123" in result.output
+    assert "2023-11-08T10:00:00Z" in result.output
+
+
+def test_deploy_revisions_list_command_no_results(monkeypatch) -> None:
+    runner = CliRunner()
+
+    class FakeClient:
+        def __init__(self, host_url: str, api_key: str, tenant_id: str | None = None):
+            pass
+
+        def list_revisions(self, deployment_id: str, limit: int = 1):
+            return {"resources": []}
+
+    monkeypatch.setattr(cli_module, "HostBackendClient", FakeClient)
+
+    result = runner.invoke(
+        cli,
+        [
+            "deploy",
+            "revisions",
+            "list",
+            "--api-key",
+            "test-key",
+            "--host-url",
+            "https://api.example.com",
+            "dep-123",
+        ],
+    )
+
+    assert result.exit_code == 0, result.output
+    assert result.output.strip() == "No revisions found for deployment dep-123."
+
+
+def test_deploy_revisions_list_command_with_explicit_limit(monkeypatch) -> None:
+    runner = CliRunner()
+    captured: dict[str, str] = {}
+
+    class FakeClient:
+        def __init__(self, host_url: str, api_key: str, tenant_id: str | None = None):
+            pass
+
+        def list_revisions(self, deployment_id: str, limit: int = 1):
+            captured["deployment_id"] = deployment_id
+            captured["limit"] = str(limit)
+            return {"resources": []}
+
+    monkeypatch.setattr(cli_module, "HostBackendClient", FakeClient)
+
+    result = runner.invoke(
+        cli,
+        [
+            "deploy",
+            "revisions",
+            "list",
+            "--api-key",
+            "test-key",
+            "--host-url",
+            "https://api.example.com",
+            "--limit",
+            "25",
+            "dep-123",
+        ],
+    )
+
+    assert result.exit_code == 0, result.output
+    assert captured == {"deployment_id": "dep-123", "limit": "25"}
+    assert result.output.strip() == "No revisions found for deployment dep-123."
+
+
+def test_deploy_revisions_list_missing_deployment_id_shows_usage() -> None:
+    runner = CliRunner()
+
+    result = runner.invoke(cli, ["deploy", "revisions", "list"])
+
+    assert result.exit_code == 2, result.output
+    assert "Missing argument 'DEPLOYMENT_ID'" in result.output
+
+
 def test_deploy_delete_command(monkeypatch) -> None:
    runner = CliRunner()
    captured: dict[str, str] = {}