immichpy 1.6.5__py3-none-any.whl → 1.7.6__py3-none-any.whl

immichpy/cli/commands/search.py

@@ -48,15 +48,23 @@ def get_explore_data(
 @app.command("get-search-suggestions", deprecated=False, rich_help_panel="API commands")
 def get_search_suggestions(
     ctx: typer.Context,
-    country: str | None = typer.Option(None, "--country", help=""""""),
+    country: str | None = typer.Option(None, "--country", help="""Filter by country"""),
     include_null: Literal["true", "false"] | None = typer.Option(
-        None, "--include-null", help=""""""
+        None, "--include-null", help="""Include null values in suggestions"""
+    ),
+    lens_model: str | None = typer.Option(
+        None, "--lens-model", help="""Filter by lens model"""
+    ),
+    make: str | None = typer.Option(None, "--make", help="""Filter by camera make"""),
+    model: str | None = typer.Option(
+        None, "--model", help="""Filter by camera model"""
+    ),
+    state: str | None = typer.Option(
+        None, "--state", help="""Filter by state/province"""
+    ),
+    type: SearchSuggestionType = typer.Option(
+        ..., "--type", help="""Suggestion type"""
     ),
-    lens_model: str | None = typer.Option(None, "--lens-model", help=""""""),
-    make: str | None = typer.Option(None, "--make", help=""""""),
-    model: str | None = typer.Option(None, "--model", help=""""""),
-    state: str | None = typer.Option(None, "--state", help=""""""),
-    type: SearchSuggestionType = typer.Option(..., "--type", help=""""""),
 ) -> None:
     """Retrieve search suggestions
 
@@ -86,51 +94,87 @@ def get_search_suggestions(
 )
 def search_asset_statistics(
     ctx: typer.Context,
-    album_ids: list[str] | None = typer.Option(None, "--album-ids", help=""""""),
-    city: str | None = typer.Option(None, "--city", help=""""""),
-    country: str | None = typer.Option(None, "--country", help=""""""),
-    created_after: datetime | None = typer.Option(None, "--created-after", help=""""""),
+    album_ids: list[str] | None = typer.Option(
+        None, "--album-ids", help="""Filter by album IDs"""
+    ),
+    city: str | None = typer.Option(None, "--city", help="""Filter by city name"""),
+    country: str | None = typer.Option(
+        None, "--country", help="""Filter by country name"""
+    ),
+    created_after: datetime | None = typer.Option(
+        None, "--created-after", help="""Filter by creation date (after)"""
+    ),
     created_before: datetime | None = typer.Option(
-        None, "--created-before", help=""""""
+        None, "--created-before", help="""Filter by creation date (before)"""
+    ),
+    description: str | None = typer.Option(
+        None, "--description", help="""Filter by description text"""
+    ),
+    device_id: str | None = typer.Option(
+        None, "--device-id", help="""Device ID to filter by"""
     ),
-    description: str | None = typer.Option(None, "--description", help=""""""),
-    device_id: str | None = typer.Option(None, "--device-id", help=""""""),
     is_encoded: Literal["true", "false"] | None = typer.Option(
-        None, "--is-encoded", help=""""""
+        None, "--is-encoded", help="""Filter by encoded status"""
     ),
     is_favorite: Literal["true", "false"] | None = typer.Option(
-        None, "--is-favorite", help=""""""
+        None, "--is-favorite", help="""Filter by favorite status"""
     ),
     is_motion: Literal["true", "false"] | None = typer.Option(
-        None, "--is-motion", help=""""""
+        None, "--is-motion", help="""Filter by motion photo status"""
     ),
     is_not_in_album: Literal["true", "false"] | None = typer.Option(
-        None, "--is-not-in-album", help=""""""
+        None, "--is-not-in-album", help="""Filter assets not in any album"""
     ),
     is_offline: Literal["true", "false"] | None = typer.Option(
-        None, "--is-offline", help=""""""
-    ),
-    lens_model: str | None = typer.Option(None, "--lens-model", help=""""""),
-    library_id: str | None = typer.Option(None, "--library-id", help=""""""),
-    make: str | None = typer.Option(None, "--make", help=""""""),
-    model: str | None = typer.Option(None, "--model", help=""""""),
-    ocr: str | None = typer.Option(None, "--ocr", help=""""""),
-    person_ids: list[str] | None = typer.Option(None, "--person-ids", help=""""""),
-    rating: float | None = typer.Option(None, "--rating", help="""""", min=-1, max=5),
-    state: str | None = typer.Option(None, "--state", help=""""""),
-    tag_ids: list[str] | None = typer.Option(None, "--tag-ids", help=""""""),
-    taken_after: datetime | None = typer.Option(None, "--taken-after", help=""""""),
-    taken_before: datetime | None = typer.Option(None, "--taken-before", help=""""""),
-    trashed_after: datetime | None = typer.Option(None, "--trashed-after", help=""""""),
+        None, "--is-offline", help="""Filter by offline status"""
+    ),
+    lens_model: str | None = typer.Option(
+        None, "--lens-model", help="""Filter by lens model"""
+    ),
+    library_id: str | None = typer.Option(
+        None, "--library-id", help="""Library ID to filter by"""
+    ),
+    make: str | None = typer.Option(None, "--make", help="""Filter by camera make"""),
+    model: str | None = typer.Option(
+        None, "--model", help="""Filter by camera model"""
+    ),
+    ocr: str | None = typer.Option(
+        None, "--ocr", help="""Filter by OCR text content"""
+    ),
+    person_ids: list[str] | None = typer.Option(
+        None, "--person-ids", help="""Filter by person IDs"""
+    ),
+    rating: float | None = typer.Option(
+        None, "--rating", help="""Filter by rating""", min=-1, max=5
+    ),
+    state: str | None = typer.Option(
+        None, "--state", help="""Filter by state/province name"""
+    ),
+    tag_ids: list[str] | None = typer.Option(
+        None, "--tag-ids", help="""Filter by tag IDs"""
+    ),
+    taken_after: datetime | None = typer.Option(
+        None, "--taken-after", help="""Filter by taken date (after)"""
+    ),
+    taken_before: datetime | None = typer.Option(
+        None, "--taken-before", help="""Filter by taken date (before)"""
+    ),
+    trashed_after: datetime | None = typer.Option(
+        None, "--trashed-after", help="""Filter by trash date (after)"""
+    ),
     trashed_before: datetime | None = typer.Option(
-        None, "--trashed-before", help=""""""
+        None, "--trashed-before", help="""Filter by trash date (before)"""
+    ),
+    type: str | None = typer.Option(None, "--type", help="""Asset type"""),
+    updated_after: datetime | None = typer.Option(
+        None, "--updated-after", help="""Filter by update date (after)"""
     ),
-    type: str | None = typer.Option(None, "--type", help=""""""),
-    updated_after: datetime | None = typer.Option(None, "--updated-after", help=""""""),
     updated_before: datetime | None = typer.Option(
-        None, "--updated-before", help=""""""
+        None, "--updated-before", help="""Filter by update date (before)"""
+    ),
+    visibility: str | None = typer.Option(
+        None, "--visibility", help="""Asset visibility"""
     ),
-    visibility: str | None = typer.Option(None, "--visibility", help=""""""),
 ) -> None:
     """Search asset statistics
 
@@ -208,77 +252,125 @@ def search_asset_statistics(
 @app.command("search-assets", deprecated=False, rich_help_panel="API commands")
 def search_assets(
     ctx: typer.Context,
-    album_ids: list[str] | None = typer.Option(None, "--album-ids", help=""""""),
-    checksum: str | None = typer.Option(None, "--checksum", help=""""""),
-    city: str | None = typer.Option(None, "--city", help=""""""),
-    country: str | None = typer.Option(None, "--country", help=""""""),
-    created_after: datetime | None = typer.Option(None, "--created-after", help=""""""),
+    album_ids: list[str] | None = typer.Option(
+        None, "--album-ids", help="""Filter by album IDs"""
+    ),
+    checksum: str | None = typer.Option(
+        None, "--checksum", help="""Filter by file checksum"""
+    ),
+    city: str | None = typer.Option(None, "--city", help="""Filter by city name"""),
+    country: str | None = typer.Option(
+        None, "--country", help="""Filter by country name"""
+    ),
+    created_after: datetime | None = typer.Option(
+        None, "--created-after", help="""Filter by creation date (after)"""
+    ),
     created_before: datetime | None = typer.Option(
-        None, "--created-before", help=""""""
+        None, "--created-before", help="""Filter by creation date (before)"""
+    ),
+    description: str | None = typer.Option(
+        None, "--description", help="""Filter by description text"""
+    ),
+    device_asset_id: str | None = typer.Option(
+        None, "--device-asset-id", help="""Filter by device asset ID"""
+    ),
+    device_id: str | None = typer.Option(
+        None, "--device-id", help="""Device ID to filter by"""
     ),
-    description: str | None = typer.Option(None, "--description", help=""""""),
-    device_asset_id: str | None = typer.Option(None, "--device-asset-id", help=""""""),
-    device_id: str | None = typer.Option(None, "--device-id", help=""""""),
     encoded_video_path: str | None = typer.Option(
-        None, "--encoded-video-path", help=""""""
+        None, "--encoded-video-path", help="""Filter by encoded video file path"""
     ),
-    id: str | None = typer.Option(None, "--id", help=""""""),
+    id: str | None = typer.Option(None, "--id", help="""Filter by asset ID"""),
     is_encoded: Literal["true", "false"] | None = typer.Option(
-        None, "--is-encoded", help=""""""
+        None, "--is-encoded", help="""Filter by encoded status"""
     ),
     is_favorite: Literal["true", "false"] | None = typer.Option(
-        None, "--is-favorite", help=""""""
+        None, "--is-favorite", help="""Filter by favorite status"""
     ),
     is_motion: Literal["true", "false"] | None = typer.Option(
-        None, "--is-motion", help=""""""
+        None, "--is-motion", help="""Filter by motion photo status"""
     ),
     is_not_in_album: Literal["true", "false"] | None = typer.Option(
-        None, "--is-not-in-album", help=""""""
+        None, "--is-not-in-album", help="""Filter assets not in any album"""
     ),
     is_offline: Literal["true", "false"] | None = typer.Option(
-        None, "--is-offline", help=""""""
-    ),
-    lens_model: str | None = typer.Option(None, "--lens-model", help=""""""),
-    library_id: str | None = typer.Option(None, "--library-id", help=""""""),
-    make: str | None = typer.Option(None, "--make", help=""""""),
-    model: str | None = typer.Option(None, "--model", help=""""""),
-    ocr: str | None = typer.Option(None, "--ocr", help=""""""),
-    order: str | None = typer.Option(None, "--order", help=""""""),
+        None, "--is-offline", help="""Filter by offline status"""
+    ),
+    lens_model: str | None = typer.Option(
+        None, "--lens-model", help="""Filter by lens model"""
+    ),
+    library_id: str | None = typer.Option(
+        None, "--library-id", help="""Library ID to filter by"""
+    ),
+    make: str | None = typer.Option(None, "--make", help="""Filter by camera make"""),
+    model: str | None = typer.Option(
+        None, "--model", help="""Filter by camera model"""
+    ),
+    ocr: str | None = typer.Option(
+        None, "--ocr", help="""Filter by OCR text content"""
+    ),
+    order: str | None = typer.Option(None, "--order", help="""Asset sort order"""),
     original_file_name: str | None = typer.Option(
-        None, "--original-file-name", help=""""""
-    ),
-    original_path: str | None = typer.Option(None, "--original-path", help=""""""),
-    page: float | None = typer.Option(None, "--page", help="""""", min=1),
-    person_ids: list[str] | None = typer.Option(None, "--person-ids", help=""""""),
-    preview_path: str | None = typer.Option(None, "--preview-path", help=""""""),
-    rating: float | None = typer.Option(None, "--rating", help="""""", min=-1, max=5),
-    size: float | None = typer.Option(None, "--size", help="""""", min=1, max=1000),
-    state: str | None = typer.Option(None, "--state", help=""""""),
-    tag_ids: list[str] | None = typer.Option(None, "--tag-ids", help=""""""),
-    taken_after: datetime | None = typer.Option(None, "--taken-after", help=""""""),
-    taken_before: datetime | None = typer.Option(None, "--taken-before", help=""""""),
-    thumbnail_path: str | None = typer.Option(None, "--thumbnail-path", help=""""""),
-    trashed_after: datetime | None = typer.Option(None, "--trashed-after", help=""""""),
+        None, "--original-file-name", help="""Filter by original file name"""
+    ),
+    original_path: str | None = typer.Option(
+        None, "--original-path", help="""Filter by original file path"""
+    ),
+    page: float | None = typer.Option(None, "--page", help="""Page number""", min=1),
+    person_ids: list[str] | None = typer.Option(
+        None, "--person-ids", help="""Filter by person IDs"""
+    ),
+    preview_path: str | None = typer.Option(
+        None, "--preview-path", help="""Filter by preview file path"""
+    ),
+    rating: float | None = typer.Option(
+        None, "--rating", help="""Filter by rating""", min=-1, max=5
+    ),
+    size: float | None = typer.Option(
+        None, "--size", help="""Number of results to return""", min=1, max=1000
+    ),
+    state: str | None = typer.Option(
+        None, "--state", help="""Filter by state/province name"""
+    ),
+    tag_ids: list[str] | None = typer.Option(
+        None, "--tag-ids", help="""Filter by tag IDs"""
+    ),
+    taken_after: datetime | None = typer.Option(
+        None, "--taken-after", help="""Filter by taken date (after)"""
+    ),
+    taken_before: datetime | None = typer.Option(
+        None, "--taken-before", help="""Filter by taken date (before)"""
+    ),
+    thumbnail_path: str | None = typer.Option(
+        None, "--thumbnail-path", help="""Filter by thumbnail file path"""
+    ),
+    trashed_after: datetime | None = typer.Option(
+        None, "--trashed-after", help="""Filter by trash date (after)"""
+    ),
     trashed_before: datetime | None = typer.Option(
-        None, "--trashed-before", help=""""""
+        None, "--trashed-before", help="""Filter by trash date (before)"""
+    ),
+    type: str | None = typer.Option(None, "--type", help="""Asset type"""),
+    updated_after: datetime | None = typer.Option(
+        None, "--updated-after", help="""Filter by update date (after)"""
     ),
-    type: str | None = typer.Option(None, "--type", help=""""""),
-    updated_after: datetime | None = typer.Option(None, "--updated-after", help=""""""),
     updated_before: datetime | None = typer.Option(
-        None, "--updated-before", help=""""""
+        None, "--updated-before", help="""Filter by update date (before)"""
+    ),
+    visibility: str | None = typer.Option(
+        None, "--visibility", help="""Asset visibility"""
     ),
-    visibility: str | None = typer.Option(None, "--visibility", help=""""""),
     with_deleted: Literal["true", "false"] | None = typer.Option(
-        None, "--with-deleted", help=""""""
+        None, "--with-deleted", help="""Include deleted assets"""
     ),
     with_exif: Literal["true", "false"] | None = typer.Option(
-        None, "--with-exif", help=""""""
+        None, "--with-exif", help="""Include EXIF data in response"""
     ),
     with_people: Literal["true", "false"] | None = typer.Option(
-        None, "--with-people", help=""""""
+        None, "--with-people", help="""Include assets with people"""
     ),
     with_stacked: Literal["true", "false"] | None = typer.Option(
-        None, "--with-stacked", help=""""""
+        None, "--with-stacked", help="""Include stacked assets"""
     ),
 ) -> None:
     """Search assets by metadata
@@ -385,61 +477,97 @@ def search_assets(
 @app.command("search-large-assets", deprecated=False, rich_help_panel="API commands")
 def search_large_assets(
     ctx: typer.Context,
-    album_ids: list[str] | None = typer.Option(None, "--album-ids", help=""""""),
-    city: str | None = typer.Option(None, "--city", help=""""""),
-    country: str | None = typer.Option(None, "--country", help=""""""),
-    created_after: datetime | None = typer.Option(None, "--created-after", help=""""""),
+    album_ids: list[str] | None = typer.Option(
+        None, "--album-ids", help="""Filter by album IDs"""
+    ),
+    city: str | None = typer.Option(None, "--city", help="""Filter by city name"""),
+    country: str | None = typer.Option(
+        None, "--country", help="""Filter by country name"""
+    ),
+    created_after: datetime | None = typer.Option(
+        None, "--created-after", help="""Filter by creation date (after)"""
+    ),
     created_before: datetime | None = typer.Option(
-        None, "--created-before", help=""""""
+        None, "--created-before", help="""Filter by creation date (before)"""
+    ),
+    device_id: str | None = typer.Option(
+        None, "--device-id", help="""Device ID to filter by"""
     ),
-    device_id: str | None = typer.Option(None, "--device-id", help=""""""),
     is_encoded: Literal["true", "false"] | None = typer.Option(
-        None, "--is-encoded", help=""""""
+        None, "--is-encoded", help="""Filter by encoded status"""
     ),
     is_favorite: Literal["true", "false"] | None = typer.Option(
-        None, "--is-favorite", help=""""""
+        None, "--is-favorite", help="""Filter by favorite status"""
     ),
     is_motion: Literal["true", "false"] | None = typer.Option(
-        None, "--is-motion", help=""""""
+        None, "--is-motion", help="""Filter by motion photo status"""
     ),
     is_not_in_album: Literal["true", "false"] | None = typer.Option(
-        None, "--is-not-in-album", help=""""""
+        None, "--is-not-in-album", help="""Filter assets not in any album"""
     ),
     is_offline: Literal["true", "false"] | None = typer.Option(
-        None, "--is-offline", help=""""""
+        None, "--is-offline", help="""Filter by offline status"""
+    ),
+    lens_model: str | None = typer.Option(
+        None, "--lens-model", help="""Filter by lens model"""
+    ),
+    library_id: str | None = typer.Option(
+        None, "--library-id", help="""Library ID to filter by"""
     ),
-    lens_model: str | None = typer.Option(None, "--lens-model", help=""""""),
-    library_id: str | None = typer.Option(None, "--library-id", help=""""""),
-    make: str | None = typer.Option(None, "--make", help=""""""),
+    make: str | None = typer.Option(None, "--make", help="""Filter by camera make"""),
     min_file_size: int | None = typer.Option(
-        None, "--min-file-size", help="""""", min=0
-    ),
-    model: str | None = typer.Option(None, "--model", help=""""""),
-    ocr: str | None = typer.Option(None, "--ocr", help=""""""),
-    person_ids: list[str] | None = typer.Option(None, "--person-ids", help=""""""),
-    rating: float | None = typer.Option(None, "--rating", help="""""", min=-1, max=5),
-    size: float | None = typer.Option(None, "--size", help="""""", min=1, max=1000),
-    state: str | None = typer.Option(None, "--state", help=""""""),
-    tag_ids: list[str] | None = typer.Option(None, "--tag-ids", help=""""""),
-    taken_after: datetime | None = typer.Option(None, "--taken-after", help=""""""),
-    taken_before: datetime | None = typer.Option(None, "--taken-before", help=""""""),
-    trashed_after: datetime | None = typer.Option(None, "--trashed-after", help=""""""),
+        None, "--min-file-size", help="""Minimum file size in bytes""", min=0
+    ),
+    model: str | None = typer.Option(
+        None, "--model", help="""Filter by camera model"""
+    ),
+    ocr: str | None = typer.Option(
+        None, "--ocr", help="""Filter by OCR text content"""
+    ),
+    person_ids: list[str] | None = typer.Option(
+        None, "--person-ids", help="""Filter by person IDs"""
+    ),
+    rating: float | None = typer.Option(
+        None, "--rating", help="""Filter by rating""", min=-1, max=5
+    ),
+    size: float | None = typer.Option(
+        None, "--size", help="""Number of results to return""", min=1, max=1000
+    ),
+    state: str | None = typer.Option(
+        None, "--state", help="""Filter by state/province name"""
+    ),
+    tag_ids: list[str] | None = typer.Option(
+        None, "--tag-ids", help="""Filter by tag IDs"""
+    ),
+    taken_after: datetime | None = typer.Option(
+        None, "--taken-after", help="""Filter by taken date (after)"""
+    ),
+    taken_before: datetime | None = typer.Option(
+        None, "--taken-before", help="""Filter by taken date (before)"""
+    ),
+    trashed_after: datetime | None = typer.Option(
+        None, "--trashed-after", help="""Filter by trash date (after)"""
+    ),
     trashed_before: datetime | None = typer.Option(
-        None, "--trashed-before", help=""""""
+        None, "--trashed-before", help="""Filter by trash date (before)"""
+    ),
+    type: AssetTypeEnum | None = typer.Option(
+        None, "--type", help="""Asset type filter"""
+    ),
+    updated_after: datetime | None = typer.Option(
+        None, "--updated-after", help="""Filter by update date (after)"""
     ),
-    type: AssetTypeEnum | None = typer.Option(None, "--type", help=""""""),
-    updated_after: datetime | None = typer.Option(None, "--updated-after", help=""""""),
     updated_before: datetime | None = typer.Option(
-        None, "--updated-before", help=""""""
+        None, "--updated-before", help="""Filter by update date (before)"""
     ),
     visibility: AssetVisibility | None = typer.Option(
-        None, "--visibility", help=""""""
+        None, "--visibility", help="""Filter by visibility"""
     ),
     with_deleted: Literal["true", "false"] | None = typer.Option(
-        None, "--with-deleted", help=""""""
+        None, "--with-deleted", help="""Include deleted assets"""
     ),
     with_exif: Literal["true", "false"] | None = typer.Option(
-        None, "--with-exif", help=""""""
+        None, "--with-exif", help="""Include EXIF data in response"""
     ),
 ) -> None:
     """Search large assets
@@ -519,9 +647,9 @@ def search_large_assets(
 @app.command("search-person", deprecated=False, rich_help_panel="API commands")
 def search_person(
     ctx: typer.Context,
-    name: str = typer.Option(..., "--name", help=""""""),
+    name: str = typer.Option(..., "--name", help="""Person name to search for"""),
     with_hidden: Literal["true", "false"] | None = typer.Option(
-        None, "--with-hidden", help=""""""
+        None, "--with-hidden", help="""Include hidden people"""
     ),
 ) -> None:
     """Search people
@@ -540,7 +668,7 @@ def search_person(
 @app.command("search-places", deprecated=False, rich_help_panel="API commands")
 def search_places(
     ctx: typer.Context,
-    name: str = typer.Option(..., "--name", help=""""""),
+    name: str = typer.Option(..., "--name", help="""Place name to search for"""),
 ) -> None:
     """Search places
 
@@ -556,62 +684,98 @@ def search_places(
 @app.command("search-random", deprecated=False, rich_help_panel="API commands")
 def search_random(
     ctx: typer.Context,
-    album_ids: list[str] | None = typer.Option(None, "--album-ids", help=""""""),
-    city: str | None = typer.Option(None, "--city", help=""""""),
-    country: str | None = typer.Option(None, "--country", help=""""""),
-    created_after: datetime | None = typer.Option(None, "--created-after", help=""""""),
+    album_ids: list[str] | None = typer.Option(
+        None, "--album-ids", help="""Filter by album IDs"""
+    ),
+    city: str | None = typer.Option(None, "--city", help="""Filter by city name"""),
+    country: str | None = typer.Option(
+        None, "--country", help="""Filter by country name"""
+    ),
+    created_after: datetime | None = typer.Option(
+        None, "--created-after", help="""Filter by creation date (after)"""
+    ),
     created_before: datetime | None = typer.Option(
-        None, "--created-before", help=""""""
+        None, "--created-before", help="""Filter by creation date (before)"""
+    ),
+    device_id: str | None = typer.Option(
+        None, "--device-id", help="""Device ID to filter by"""
     ),
-    device_id: str | None = typer.Option(None, "--device-id", help=""""""),
     is_encoded: Literal["true", "false"] | None = typer.Option(
-        None, "--is-encoded", help=""""""
+        None, "--is-encoded", help="""Filter by encoded status"""
     ),
     is_favorite: Literal["true", "false"] | None = typer.Option(
-        None, "--is-favorite", help=""""""
+        None, "--is-favorite", help="""Filter by favorite status"""
     ),
     is_motion: Literal["true", "false"] | None = typer.Option(
-        None, "--is-motion", help=""""""
+        None, "--is-motion", help="""Filter by motion photo status"""
     ),
     is_not_in_album: Literal["true", "false"] | None = typer.Option(
-        None, "--is-not-in-album", help=""""""
+        None, "--is-not-in-album", help="""Filter assets not in any album"""
     ),
     is_offline: Literal["true", "false"] | None = typer.Option(
-        None, "--is-offline", help=""""""
-    ),
-    lens_model: str | None = typer.Option(None, "--lens-model", help=""""""),
-    library_id: str | None = typer.Option(None, "--library-id", help=""""""),
-    make: str | None = typer.Option(None, "--make", help=""""""),
-    model: str | None = typer.Option(None, "--model", help=""""""),
-    ocr: str | None = typer.Option(None, "--ocr", help=""""""),
-    person_ids: list[str] | None = typer.Option(None, "--person-ids", help=""""""),
-    rating: float | None = typer.Option(None, "--rating", help="""""", min=-1, max=5),
-    size: float | None = typer.Option(None, "--size", help="""""", min=1, max=1000),
-    state: str | None = typer.Option(None, "--state", help=""""""),
-    tag_ids: list[str] | None = typer.Option(None, "--tag-ids", help=""""""),
-    taken_after: datetime | None = typer.Option(None, "--taken-after", help=""""""),
-    taken_before: datetime | None = typer.Option(None, "--taken-before", help=""""""),
-    trashed_after: datetime | None = typer.Option(None, "--trashed-after", help=""""""),
+        None, "--is-offline", help="""Filter by offline status"""
+    ),
+    lens_model: str | None = typer.Option(
+        None, "--lens-model", help="""Filter by lens model"""
+    ),
+    library_id: str | None = typer.Option(
+        None, "--library-id", help="""Library ID to filter by"""
+    ),
+    make: str | None = typer.Option(None, "--make", help="""Filter by camera make"""),
+    model: str | None = typer.Option(
+        None, "--model", help="""Filter by camera model"""
+    ),
+    ocr: str | None = typer.Option(
+        None, "--ocr", help="""Filter by OCR text content"""
+    ),
+    person_ids: list[str] | None = typer.Option(
+        None, "--person-ids", help="""Filter by person IDs"""
+    ),
+    rating: float | None = typer.Option(
+        None, "--rating", help="""Filter by rating""", min=-1, max=5
+    ),
+    size: float | None = typer.Option(
+        None, "--size", help="""Number of results to return""", min=1, max=1000
+    ),
+    state: str | None = typer.Option(
+        None, "--state", help="""Filter by state/province name"""
+    ),
+    tag_ids: list[str] | None = typer.Option(
+        None, "--tag-ids", help="""Filter by tag IDs"""
+    ),
+    taken_after: datetime | None = typer.Option(
+        None, "--taken-after", help="""Filter by taken date (after)"""
+    ),
+    taken_before: datetime | None = typer.Option(
+        None, "--taken-before", help="""Filter by taken date (before)"""
+    ),
+    trashed_after: datetime | None = typer.Option(
+        None, "--trashed-after", help="""Filter by trash date (after)"""
+    ),
     trashed_before: datetime | None = typer.Option(
-        None, "--trashed-before", help=""""""
+        None, "--trashed-before", help="""Filter by trash date (before)"""
+    ),
+    type: str | None = typer.Option(None, "--type", help="""Asset type"""),
+    updated_after: datetime | None = typer.Option(
+        None, "--updated-after", help="""Filter by update date (after)"""
     ),
-    type: str | None = typer.Option(None, "--type", help=""""""),
-    updated_after: datetime | None = typer.Option(None, "--updated-after", help=""""""),
     updated_before: datetime | None = typer.Option(
-        None, "--updated-before", help=""""""
+        None, "--updated-before", help="""Filter by update date (before)"""
+    ),
+    visibility: str | None = typer.Option(
+        None, "--visibility", help="""Asset visibility"""
     ),
-    visibility: str | None = typer.Option(None, "--visibility", help=""""""),
     with_deleted: Literal["true", "false"] | None = typer.Option(
-        None, "--with-deleted", help=""""""
+        None, "--with-deleted", help="""Include deleted assets"""
     ),
     with_exif: Literal["true", "false"] | None = typer.Option(
-        None, "--with-exif", help=""""""
+        None, "--with-exif", help="""Include EXIF data in response"""
     ),
     with_people: Literal["true", "false"] | None = typer.Option(
-        None, "--with-people", help=""""""
+        None, "--with-people", help="""Include assets with people"""
     ),
     with_stacked: Literal["true", "false"] | None = typer.Option(
-        None, "--with-stacked", help=""""""
+        None, "--with-stacked", help="""Include stacked assets"""
     ),
 ) -> None:
     """Search random assets
@@ -696,60 +860,102 @@ def search_random(
 @app.command("search-smart", deprecated=False, rich_help_panel="API commands")
 def search_smart(
     ctx: typer.Context,
-    album_ids: list[str] | None = typer.Option(None, "--album-ids", help=""""""),
-    city: str | None = typer.Option(None, "--city", help=""""""),
-    country: str | None = typer.Option(None, "--country", help=""""""),
-    created_after: datetime | None = typer.Option(None, "--created-after", help=""""""),
+    album_ids: list[str] | None = typer.Option(
+        None, "--album-ids", help="""Filter by album IDs"""
+    ),
+    city: str | None = typer.Option(None, "--city", help="""Filter by city name"""),
+    country: str | None = typer.Option(
+        None, "--country", help="""Filter by country name"""
+    ),
+    created_after: datetime | None = typer.Option(
+        None, "--created-after", help="""Filter by creation date (after)"""
+    ),
     created_before: datetime | None = typer.Option(
-        None, "--created-before", help=""""""
+        None, "--created-before", help="""Filter by creation date (before)"""
+    ),
+    device_id: str | None = typer.Option(
+        None, "--device-id", help="""Device ID to filter by"""
     ),
-    device_id: str | None = typer.Option(None, "--device-id", help=""""""),
     is_encoded: Literal["true", "false"] | None = typer.Option(
-        None, "--is-encoded", help=""""""
+        None, "--is-encoded", help="""Filter by encoded status"""
     ),
     is_favorite: Literal["true", "false"] | None = typer.Option(
-        None, "--is-favorite", help=""""""
+        None, "--is-favorite", help="""Filter by favorite status"""
     ),
     is_motion: Literal["true", "false"] | None = typer.Option(
-        None, "--is-motion", help=""""""
+        None, "--is-motion", help="""Filter by motion photo status"""
     ),
     is_not_in_album: Literal["true", "false"] | None = typer.Option(
-        None, "--is-not-in-album", help=""""""
+        None, "--is-not-in-album", help="""Filter assets not in any album"""
     ),
     is_offline: Literal["true", "false"] | None = typer.Option(
-        None, "--is-offline", help=""""""
-    ),
-    language: str | None = typer.Option(None, "--language", help=""""""),
-    lens_model: str | None = typer.Option(None, "--lens-model", help=""""""),
-    library_id: str | None = typer.Option(None, "--library-id", help=""""""),
-    make: str | None = typer.Option(None, "--make", help=""""""),
-    model: str | None = typer.Option(None, "--model", help=""""""),
-    ocr: str | None = typer.Option(None, "--ocr", help=""""""),
-    page: float | None = typer.Option(None, "--page", help="""""", min=1),
-    person_ids: list[str] | None = typer.Option(None, "--person-ids", help=""""""),
-    query: str | None = typer.Option(None, "--query", help=""""""),
-    query_asset_id: str | None = typer.Option(None, "--query-asset-id", help=""""""),
-    rating: float | None = typer.Option(None, "--rating", help="""""", min=-1, max=5),
-    size: float | None = typer.Option(None, "--size", help="""""", min=1, max=1000),
-    state: str | None = typer.Option(None, "--state", help=""""""),
-    tag_ids: list[str] | None = typer.Option(None, "--tag-ids", help=""""""),
-    taken_after: datetime | None = typer.Option(None, "--taken-after", help=""""""),
-    taken_before: datetime | None = typer.Option(None, "--taken-before", help=""""""),
-    trashed_after: datetime | None = typer.Option(None, "--trashed-after", help=""""""),
+        None, "--is-offline", help="""Filter by offline status"""
+    ),
+    language: str | None = typer.Option(
+        None, "--language", help="""Search language code"""
+    ),
+    lens_model: str | None = typer.Option(
+        None, "--lens-model", help="""Filter by lens model"""
+    ),
+    library_id: str | None = typer.Option(
+        None, "--library-id", help="""Library ID to filter by"""
+    ),
+    make: str | None = typer.Option(None, "--make", help="""Filter by camera make"""),
+    model: str | None = typer.Option(
+        None, "--model", help="""Filter by camera model"""
+    ),
+    ocr: str | None = typer.Option(
+        None, "--ocr", help="""Filter by OCR text content"""
+    ),
+    page: float | None = typer.Option(None, "--page", help="""Page number""", min=1),
+    person_ids: list[str] | None = typer.Option(
+        None, "--person-ids", help="""Filter by person IDs"""
+    ),
+    query: str | None = typer.Option(
+        None, "--query", help="""Natural language search query"""
+    ),
+    query_asset_id: str | None = typer.Option(
+        None, "--query-asset-id", help="""Asset ID to use as search reference"""
+    ),
+    rating: float | None = typer.Option(
+        None, "--rating", help="""Filter by rating""", min=-1, max=5
+    ),
+    size: float | None = typer.Option(
+        None, "--size", help="""Number of results to return""", min=1, max=1000
+    ),
+    state: str | None = typer.Option(
+        None, "--state", help="""Filter by state/province name"""
+    ),
+    tag_ids: list[str] | None = typer.Option(
+        None, "--tag-ids", help="""Filter by tag IDs"""
+    ),
+    taken_after: datetime | None = typer.Option(
+        None, "--taken-after", help="""Filter by taken date (after)"""
+    ),
+    taken_before: datetime | None = typer.Option(
+        None, "--taken-before", help="""Filter by taken date (before)"""
+    ),
+    trashed_after: datetime | None = typer.Option(
+        None, "--trashed-after", help="""Filter by trash date (after)"""
+    ),
     trashed_before: datetime | None = typer.Option(
-        None, "--trashed-before", help=""""""
+        None, "--trashed-before", help="""Filter by trash date (before)"""
+    ),
+    type: str | None = typer.Option(None, "--type", help="""Asset type"""),
+    updated_after: datetime | None = typer.Option(
+        None, "--updated-after", help="""Filter by update date (after)"""
     ),
-    type: str | None = typer.Option(None, "--type", help=""""""),
-    updated_after: datetime | None = typer.Option(None, "--updated-after", help=""""""),
     updated_before: datetime | None = typer.Option(
-        None, "--updated-before", help=""""""
+        None, "--updated-before", help="""Filter by update date (before)"""
+    ),
+    visibility: str | None = typer.Option(
+        None, "--visibility", help="""Asset visibility"""
     ),
-    visibility: str | None = typer.Option(None, "--visibility", help=""""""),
     with_deleted: Literal["true", "false"] | None = typer.Option(
-        None, "--with-deleted", help=""""""
+        None, "--with-deleted", help="""Include deleted assets"""
     ),
     with_exif: Literal["true", "false"] | None = typer.Option(
-        None, "--with-exif", help=""""""
+        None, "--with-exif", help="""Include EXIF data in response"""
     ),
 ) -> None:
     """Smart asset search