feat: add -latest model aliases for server-side resolution

Add lucy-latest, lucy-vton-latest, lucy-restyle-latest, lucy-clip-latest,
lucy-motion-latest, and lucy-image-latest convenience aliases that always
point to the current latest version of each model family. These are resolved
server-side, so the SDK passes them through with no deprecation warnings.

Author: AdirAmsalem

decart/models.py

@@ -14,6 +14,10 @@
     "lucy-restyle",
     "lucy-restyle-2",
     "live-avatar",
+    # Latest aliases (server-side resolution)
+    "lucy-latest",
+    "lucy-vton-latest",
+    "lucy-restyle-latest",
     # Deprecated names
     "mirage",
     "mirage_v2",
@@ -28,6 +32,11 @@
     "lucy-2.1",
     "lucy-restyle-2",
     "lucy-motion",
+    # Latest aliases (server-side resolution)
+    "lucy-latest",
+    "lucy-restyle-latest",
+    "lucy-clip-latest",
+    "lucy-motion-latest",
     # Deprecated names
     "lucy-pro-v2v",
     "lucy-restyle-v2v",
@@ -36,6 +45,8 @@
 ImageModels = Literal[
     # Canonical names
     "lucy-image-2",
+    # Latest alias (server-side resolution)
+    "lucy-image-latest",
     # Deprecated names
     "lucy-pro-i2i",
 ]
@@ -236,6 +247,31 @@ class ImageToImageInput(DecartBaseModel):
             height=720,
             input_schema=BaseModel,
         ),
+        # Latest aliases (server-side resolution)
+        "lucy-latest": ModelDefinition(
+            name="lucy-latest",
+            url_path="/v1/stream",
+            fps=20,
+            width=1088,
+            height=624,
+            input_schema=BaseModel,
+        ),
+        "lucy-vton-latest": ModelDefinition(
+            name="lucy-vton-latest",
+            url_path="/v1/stream",
+            fps=20,
+            width=1088,
+            height=624,
+            input_schema=BaseModel,
+        ),
+        "lucy-restyle-latest": ModelDefinition(
+            name="lucy-restyle-latest",
+            url_path="/v1/stream",
+            fps=22,
+            width=1280,
+            height=704,
+            input_schema=BaseModel,
+        ),
         # Deprecated names
         "mirage": ModelDefinition(
             name="mirage",
@@ -320,6 +356,39 @@ class ImageToImageInput(DecartBaseModel):
             height=704,
             input_schema=ImageToMotionVideoInput,
         ),
+        # Latest aliases (server-side resolution)
+        "lucy-latest": ModelDefinition(
+            name="lucy-latest",
+            url_path="/v1/jobs/lucy-latest",
+            fps=20,
+            width=1088,
+            height=624,
+            input_schema=VideoEdit2Input,
+        ),
+        "lucy-restyle-latest": ModelDefinition(
+            name="lucy-restyle-latest",
+            url_path="/v1/jobs/lucy-restyle-latest",
+            fps=22,
+            width=1280,
+            height=704,
+            input_schema=VideoRestyleInput,
+        ),
+        "lucy-clip-latest": ModelDefinition(
+            name="lucy-clip-latest",
+            url_path="/v1/jobs/lucy-clip-latest",
+            fps=25,
+            width=1280,
+            height=704,
+            input_schema=VideoToVideoInput,
+        ),
+        "lucy-motion-latest": ModelDefinition(
+            name="lucy-motion-latest",
+            url_path="/v1/jobs/lucy-motion-latest",
+            fps=25,
+            width=1280,
+            height=704,
+            input_schema=ImageToMotionVideoInput,
+        ),
         # Deprecated names
         "lucy-pro-v2v": ModelDefinition(
             name="lucy-pro-v2v",
@@ -356,6 +425,15 @@ class ImageToImageInput(DecartBaseModel):
             height=704,
             input_schema=ImageToImageInput,
         ),
+        # Latest alias (server-side resolution)
+        "lucy-image-latest": ModelDefinition(
+            name="lucy-image-latest",
+            url_path="/v1/generate/lucy-image-latest",
+            fps=25,
+            width=1280,
+            height=704,
+            input_schema=ImageToImageInput,
+        ),
         # Deprecated names
         "lucy-pro-i2i": ModelDefinition(
             name="lucy-pro-i2i",

tests/test_models.py

@@ -164,6 +164,75 @@ def test_deprecation_warning_only_once() -> None:
         assert len(w) == 1
 
 
+def test_latest_realtime_models() -> None:
+    model = models.realtime("lucy-latest")
+    assert model.name == "lucy-latest"
+    assert model.url_path == "/v1/stream"
+    assert model.fps == 20
+    assert model.width == 1088
+    assert model.height == 624
+
+    model = models.realtime("lucy-vton-latest")
+    assert model.name == "lucy-vton-latest"
+    assert model.url_path == "/v1/stream"
+    assert model.fps == 20
+    assert model.width == 1088
+    assert model.height == 624
+
+    model = models.realtime("lucy-restyle-latest")
+    assert model.name == "lucy-restyle-latest"
+    assert model.url_path == "/v1/stream"
+    assert model.fps == 22
+    assert model.width == 1280
+    assert model.height == 704
+
+
+def test_latest_video_models() -> None:
+    model = models.video("lucy-latest")
+    assert model.name == "lucy-latest"
+    assert model.url_path == "/v1/jobs/lucy-latest"
+    assert model.fps == 20
+    assert model.width == 1088
+    assert model.height == 624
+
+    model = models.video("lucy-restyle-latest")
+    assert model.name == "lucy-restyle-latest"
+    assert model.url_path == "/v1/jobs/lucy-restyle-latest"
+    assert model.fps == 22
+
+    model = models.video("lucy-clip-latest")
+    assert model.name == "lucy-clip-latest"
+    assert model.url_path == "/v1/jobs/lucy-clip-latest"
+    assert model.fps == 25
+
+    model = models.video("lucy-motion-latest")
+    assert model.name == "lucy-motion-latest"
+    assert model.url_path == "/v1/jobs/lucy-motion-latest"
+    assert model.fps == 25
+
+
+def test_latest_image_models() -> None:
+    model = models.image("lucy-image-latest")
+    assert model.name == "lucy-image-latest"
+    assert model.url_path == "/v1/generate/lucy-image-latest"
+
+
+def test_latest_aliases_no_deprecation_warning() -> None:
+    _warned_aliases.clear()
+
+    with warnings.catch_warnings(record=True) as w:
+        warnings.simplefilter("always")
+        models.realtime("lucy-latest")
+        models.realtime("lucy-vton-latest")
+        models.realtime("lucy-restyle-latest")
+        models.video("lucy-latest")
+        models.video("lucy-restyle-latest")
+        models.video("lucy-clip-latest")
+        models.video("lucy-motion-latest")
+        models.image("lucy-image-latest")
+        assert len(w) == 0
+
+
 def test_invalid_model() -> None:
     with pytest.raises(DecartSDKError):
         models.video("invalid-model")