label-studio-sdk 2.0.12__tar.gz → 2.0.14__tar.gz

{label_studio_sdk-2.0.12 → label_studio_sdk-2.0.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: label-studio-sdk
-Version: 2.0.12
+Version: 2.0.14
 Summary: 
 Requires-Python: >=3.9,<4
 Classifier: Intended Audience :: Developers
@@ -29,7 +29,7 @@ Requires-Dist: jsonschema (>=4.23.0)
 Requires-Dist: lxml (>=4.2.5)
 Requires-Dist: nltk (>=3.9.1,<4.0.0)
 Requires-Dist: numpy (>=1.26.4,<3.0.0)
-Requires-Dist: opencv-python (>=4.12.0,<5.0.0)
+Requires-Dist: opencv-python-headless (>=4.12.0,<5.0.0)
 Requires-Dist: pandas (>=0.24.0)
 Requires-Dist: pydantic (>=1.9.2)
 Requires-Dist: pydantic-core (>=2.18.2,<3.0.0)

{label_studio_sdk-2.0.12 → label_studio_sdk-2.0.14}/pyproject.toml

@@ -3,7 +3,7 @@ name = "label-studio-sdk"
 
 [tool.poetry]
 name = "label-studio-sdk"
-version = "2.0.12"
+version = "2.0.14"
 description = ""
 readme = "README.md"
 authors = []
@@ -45,7 +45,7 @@ jsonschema = ">=4.23.0"
 lxml = ">=4.2.5"
 nltk = "^3.9.1"
 numpy = ">=1.26.4,<3.0.0"
-opencv-python = "^4.12.0"
+opencv-python-headless = "^4.12.0"
 pandas = ">=0.24.0"
 pydantic = ">= 1.9.2"
 pydantic-core = "^2.18.2"

{label_studio_sdk-2.0.12 → label_studio_sdk-2.0.14}/src/label_studio_sdk/__init__.py

@@ -46,14 +46,12 @@ from .types import (
     ConvertedFormat,
     ConvertedFormatRequest,
     CountLimit,
-    CustomScriptsEditableByEnum,
     DatabricksExportStorage,
     DatabricksExportStorageRequest,
     DatabricksImportStorage,
     DatabricksImportStorageRequest,
     Default165Enum,
     DefaultRole,
-    DefaultRoleCustomScriptsEditableBy,
     EditionEnum,
     Export,
     FileUpload,
@@ -83,7 +81,6 @@ from .types import (
     LseFieldsTrialRole,
     LseKeyIndicatorValue,
     LseOrganization,
-    LseOrganizationCustomScriptsEditableBy,
     LseOrganizationMemberList,
     LseProject,
     LseProjectCounts,
@@ -294,6 +291,7 @@ from .actions import (
     ActionsCreateRequestSelectedItemsIncluded,
     ActionsListResponseItem,
     ActionsListResponseItemDialog,
+    ActionsListResponseItemPermission,
 )
 from .activity_logs import ActivityLogsListRequestMethod
 from .annotation_history import AnnotationHistoryDeleteResponse
@@ -304,7 +302,6 @@ from .export_storage import ExportStorageListTypesResponseItem
 from .import_storage import ImportStorageListTypesResponseItem
 from .ml import MlCreateRequestAuthMethod, MlListModelVersionsResponse, MlUpdateRequestAuthMethod
 from .model_providers import ModelProvidersListModelProviderChoicesResponse
-from .organizations import PatchedDefaultRoleRequestCustomScriptsEditableBy
 from .projects import (
     LseProjectCreateRequestSampling,
     LseProjectCreateRequestSkipQueue,
@@ -371,6 +368,7 @@ __all__ = [
     "ActionsEnum",
     "ActionsListResponseItem",
     "ActionsListResponseItemDialog",
+    "ActionsListResponseItemPermission",
     "ActivityLog",
     "ActivityLogResponse",
     "ActivityLogsListRequestMethod",
@@ -421,14 +419,12 @@ __all__ = [
     "ConvertedFormat",
     "ConvertedFormatRequest",
     "CountLimit",
-    "CustomScriptsEditableByEnum",
     "DatabricksExportStorage",
     "DatabricksExportStorageRequest",
     "DatabricksImportStorage",
     "DatabricksImportStorageRequest",
     "Default165Enum",
     "DefaultRole",
-    "DefaultRoleCustomScriptsEditableBy",
     "EditionEnum",
     "Export",
     "ExportStorageListTypesResponseItem",
@@ -464,7 +460,6 @@ __all__ = [
     "LseFieldsTrialRole",
     "LseKeyIndicatorValue",
     "LseOrganization",
-    "LseOrganizationCustomScriptsEditableBy",
     "LseOrganizationMemberList",
     "LseProject",
     "LseProjectCounts",
@@ -547,7 +542,6 @@ __all__ = [
     "PaginatedProjectMember",
     "PaginatedProjectSubsetTasksResponseList",
     "PaginatedRoleBasedTaskList",
-    "PatchedDefaultRoleRequestCustomScriptsEditableBy",
     "PatchedLseProjectUpdateRequestSampling",
     "PatchedLseProjectUpdateRequestSkipQueue",
     "Pause",

{label_studio_sdk-2.0.12 → label_studio_sdk-2.0.14}/src/label_studio_sdk/_extensions/label_studio_tools/core/utils/io.py

@@ -7,6 +7,7 @@ import base64
 from contextlib import contextmanager
 from tempfile import mkdtemp
 from urllib.parse import urlparse
+import jwt
 
 import requests
 from appdirs import user_cache_dir, user_data_dir
@@ -49,6 +50,15 @@ def safe_build_path(base_dir: str, user_path: str) -> str:
     return absolute_path
 
 
+def is_jwt_well_formed(token: str) -> bool:
+    try:
+        jwt.get_unverified_header(token)
+        return True
+    except Exception:
+        return False
+
+
+
 def get_local_path(
     url,
     cache_dir=None,
@@ -230,7 +240,10 @@ def download_and_cache(
                 and hostname
                 and parsed_url.netloc == urlparse(hostname).netloc
             ):
-                headers["Authorization"] = "Token " + access_token
+                if is_jwt_well_formed(access_token):
+                    headers["Authorization"] = "Bearer " + access_token
+                else:
+                    headers["Authorization"] = "Token " + access_token
                 logger.debug("Authorization token is used for download_and_cache")
             try:
                 r = requests.get(url, stream=True, headers=headers, verify=VERIFY_SSL)
@@ -368,7 +381,10 @@ def get_base64_content(
     # check if url matches hostname - then uses access token to this Label Studio instance
     parsed_url = urlparse(url)
     if access_token and hostname and parsed_url.netloc == urlparse(hostname).netloc:
-        headers["Authorization"] = "Token " + access_token
+        if is_jwt_well_formed(access_token):
+            headers["Authorization"] = "Bearer " + access_token
+        else:
+            headers["Authorization"] = "Token " + access_token
         logger.debug("Authorization token is used for get_base64_content")
 
     try:

{label_studio_sdk-2.0.12 → label_studio_sdk-2.0.14}/src/label_studio_sdk/actions/__init__.py

@@ -14,6 +14,7 @@ from .types import (
     ActionsCreateRequestSelectedItemsIncluded,
     ActionsListResponseItem,
     ActionsListResponseItemDialog,
+    ActionsListResponseItemPermission,
 )
 
 __all__ = [
@@ -30,4 +31,5 @@ __all__ = [
     "ActionsCreateRequestSelectedItemsIncluded",
     "ActionsListResponseItem",
     "ActionsListResponseItemDialog",
+    "ActionsListResponseItemPermission",
 ]

{label_studio_sdk-2.0.12 → label_studio_sdk-2.0.14}/src/label_studio_sdk/actions/types/__init__.py

@@ -13,6 +13,7 @@ from .actions_create_request_selected_items_excluded import ActionsCreateRequest
 from .actions_create_request_selected_items_included import ActionsCreateRequestSelectedItemsIncluded
 from .actions_list_response_item import ActionsListResponseItem
 from .actions_list_response_item_dialog import ActionsListResponseItemDialog
+from .actions_list_response_item_permission import ActionsListResponseItemPermission
 
 __all__ = [
     "ActionsCreateRequestFilters",
@@ -28,4 +29,5 @@ __all__ = [
     "ActionsCreateRequestSelectedItemsIncluded",
     "ActionsListResponseItem",
     "ActionsListResponseItemDialog",
+    "ActionsListResponseItemPermission",
 ]

{label_studio_sdk-2.0.12 → label_studio_sdk-2.0.14}/src/label_studio_sdk/actions/types/actions_list_response_item.py

@@ -3,6 +3,7 @@
 from ...core.unchecked_base_model import UncheckedBaseModel
 import typing
 from .actions_list_response_item_dialog import ActionsListResponseItemDialog
+from .actions_list_response_item_permission import ActionsListResponseItemPermission
 from ...core.pydantic_utilities import IS_PYDANTIC_V2
 import pydantic
 
@@ -12,7 +13,7 @@ class ActionsListResponseItem(UncheckedBaseModel):
     experimental: typing.Optional[bool] = None
     id: typing.Optional[str] = None
     order: typing.Optional[int] = None
-    permission: typing.Optional[str] = None
+    permission: typing.Optional[ActionsListResponseItemPermission] = None
     title: typing.Optional[str] = None
 
     if IS_PYDANTIC_V2:

label_studio_sdk-2.0.14/src/label_studio_sdk/actions/types/actions_list_response_item_permission.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+ActionsListResponseItemPermission = typing.Union[str, typing.List[str]]

{label_studio_sdk-2.0.12 → label_studio_sdk-2.0.14}/src/label_studio_sdk/converter/README.md

@@ -13,6 +13,8 @@ https://github.com/HumanSignal/label-studio-sdk/tree/master/src/label_studio_sdk
 - [Examples](#examples)
     - [JSON](#json)
     - [CSV](#csv)
+    - [JSON-MIN](#json-min)
+    - [CSV Chat Transcript](#csv-chat-transcript)
     - [CoNLL 2003](#conll-2003)
     - [COCO](#coco)
     - [Pascal VOC XML](#pascal-voc-xml)
@@ -89,6 +91,58 @@ The goose neck needs a little coaxing	Neutral
 
 Use cases: any tasks
 
+#### JSON-MIN
+JSON-MIN exports now flatten `<Chat>` conversations into plain message objects while preserving metadata such as `createdAt` and `tool_calls`.
+
+**Input snippet:**
+```json
+{
+  "annotations": [
+    {
+      "result": [
+        {
+          "type": "chatmessage",
+          "from_name": "chat",
+          "to_name": "chat",
+          "value": {
+            "chatmessage": {
+              "role": "user",
+              "content": "hi",
+              "createdAt": 1761626717856
+            }
+          }
+        }
+      ]
+    }
+  ]
+}
+```
+
+**JSON-MIN output:**
+```json
+[
+  {
+    "chat": [
+      {"role": "user", "content": "hi", "createdAt": 1761626717856}
+    ]
+  }
+]
+```
+
+Message order is preserved and additional keys remain intact in the exported list.
+
+#### CSV Chat Transcript
+CSV exports keep the original Chat payload as JSON in the `{tag}` column and also add a human-readable `{tag}_transcript` column. The transcript joins each line as `role: content` separated by newline characters.
+
+Example row:
+
+```
+chat,"[{\"role\": \"user\", \"content\": \"hi\"},{\"role\": \"assistant\", \"content\": \"Hello! How can I assist you today?\"}]"
+chat_transcript,"user: hi\nassistant: Hello! How can I assist you today?"
+```
+
+Every Chat tag always generates a transcript column. When no responses exist yet, the transcript cell is empty.
+
 #### CoNLL 2003
 
 Running from the command line:

{label_studio_sdk-2.0.12 → label_studio_sdk-2.0.14}/src/label_studio_sdk/converter/converter.py

@@ -409,6 +409,10 @@ class Converter(object):
             all_formats.remove(Format.COCO_WITH_IMAGES.name)
             all_formats.remove(Format.YOLO.name)
             all_formats.remove(Format.YOLO_WITH_IMAGES.name)
+            if Format.YOLO_OBB.name in all_formats:
+                all_formats.remove(Format.YOLO_OBB.name)
+            if Format.YOLO_OBB_WITH_IMAGES.name in all_formats:
+                all_formats.remove(Format.YOLO_OBB_WITH_IMAGES.name)
         if not (
             "Image" in input_tag_types
             and (
@@ -427,8 +431,10 @@ class Converter(object):
         ):
             all_formats.remove(Format.ASR_MANIFEST.name)
         if is_mig or ('Video' in input_tag_types and 'TimelineLabels' in output_tag_types):
-            all_formats.remove(Format.YOLO_OBB.name)
-            all_formats.remove(Format.YOLO_OBB_WITH_IMAGES.name)
+            if Format.YOLO_OBB.name in all_formats:
+                all_formats.remove(Format.YOLO_OBB.name)
+            if Format.YOLO_OBB_WITH_IMAGES.name in all_formats:
+                all_formats.remove(Format.YOLO_OBB_WITH_IMAGES.name)
 
         return all_formats
 
@@ -536,24 +542,36 @@ class Converter(object):
         )
 
         for annotation in annotations:
-            result = annotation["result"]
+            result = annotation.get("result") or []
             outputs = defaultdict(list)
 
             # get results only as output
             for r in result:
-                if "from_name" in r and (
-                    tag_name := self._maybe_matching_tag_from_schema(r["from_name"])
-                ):
+                from_name = r.get("from_name")
+                tag_name = (
+                    self._maybe_matching_tag_from_schema(from_name)
+                    if from_name is not None
+                    else None
+                )
+                if from_name and tag_name:
                     v = deepcopy(r["value"])
                     v["type"] = self._schema[tag_name]["type"]
                     if "original_width" in r:
                         v["original_width"] = r["original_width"]
                     if "original_height" in r:
                         v["original_height"] = r["original_height"]
-                    outputs[r["from_name"]].append(v)
+                    outputs[from_name].append(v)
                     if self.is_keypoints:
                         v['id'] = r.get('id')
                         v['parentID'] = r.get('parentID')
+                    
+                elif from_name and r.get("type") == "chatmessage":
+                    v = deepcopy(r.get("value", {}))
+                    v["type"] = "chatmessage"
+                    outputs[from_name].append(v)
+                    
+                else:
+                    pass
 
             data = Converter.get_data(task, outputs, annotation)
             if "agreement" in task:

{label_studio_sdk-2.0.12 → label_studio_sdk-2.0.14}/src/label_studio_sdk/converter/exports/csv2.py

@@ -51,6 +51,31 @@ def convert(item_iterator, input_data, output_dir, **kwargs):
     logger.debug(f"CSV conversion finished in {time.time()-start_time:0.2f} sec")
 
 
+def generate_chat_transcript(pretty_value):
+    """Generate a human-readable transcript from Chat messages.
+    
+    Args:
+        pretty_value: List of message objects, each containing 'role' and 'content' keys.
+    
+    Returns:
+        str: Newline-separated transcript with format "role: content" for each message.
+    """
+    transcript_lines = []
+    if isinstance(pretty_value, list):
+        for message in pretty_value:
+            if not isinstance(message, dict):
+                continue
+            role = str(message.get("role", ""))
+            content = str(message.get("content", ""))
+            if role:
+                transcript_lines.append(
+                    f"{role}: {content}" if content else f"{role}:"
+                )
+            else:
+                transcript_lines.append(content)
+    return "\n".join(transcript_lines)
+
+
 def prepare_annotation(item):
     record = {}
     if item.get("id") is not None:
@@ -64,6 +89,13 @@ def prepare_annotation(item):
             else json.dumps(pretty_value, ensure_ascii=False)
         )
 
+        if any(
+            isinstance(result, dict)
+            and result.get("type") in ("Chat", "chatmessage")
+            for result in value
+        ):
+            record[f"{name}_transcript"] = generate_chat_transcript(pretty_value)
+
     for name, value in item["input"].items():
         if isinstance(value, dict) or isinstance(value, list):
             # flat dicts and arrays from task.data to json strings
@@ -93,6 +125,12 @@ def prepare_annotation_keys(item):
 
     for name, value in item["output"].items():
         record.add(name)
+        if any(
+            isinstance(result, dict)
+            and result.get("type") in ("Chat", "chatmessage")
+            for result in value
+        ):
+            record.add(f"{name}_transcript")
 
     if "agreement" in item:
         record.add("agreement")

{label_studio_sdk-2.0.12 → label_studio_sdk-2.0.14}/src/label_studio_sdk/converter/utils.py

@@ -388,6 +388,8 @@ def prettify_result(v):
             out.append(j["choices"][0])
         elif tag_type == "TextArea" and len(j["text"]) == 1:
             out.append(j["text"][0])
+        elif tag_type in ("Chat", "chatmessage"):
+            out.append(j.get("chatmessage", j))
         else:
             out.append(j)
     return out[0] if tag_type in ("Choices", "TextArea") and len(out) == 1 else out

{label_studio_sdk-2.0.12 → label_studio_sdk-2.0.14}/src/label_studio_sdk/core/client_wrapper.py

@@ -4,7 +4,12 @@ import httpx
 
 from .http_client import AsyncHttpClient, HttpClient
 
-VERSION = "2.0.9"
+import importlib.metadata
+
+try:
+    VERSION = importlib.metadata.version("label-studio-sdk")
+except importlib.metadata.PackageNotFoundError:
+    VERSION = "unknown"
 
 class BaseClientWrapper:
     def __init__(

{label_studio_sdk-2.0.12 → label_studio_sdk-2.0.14}/src/label_studio_sdk/export_storage/azure/client.py

@@ -21,8 +21,8 @@ class AzureClient:
     def list(
         self,
         *,
+        project: int,
         ordering: typing.Optional[str] = None,
-        project: typing.Optional[int] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[AzureBlobExportStorage]:
         """
@@ -30,12 +30,12 @@ class AzureClient:
 
         Parameters
         ----------
+        project : int
+            Project ID
+
         ordering : typing.Optional[str]
             Which field to use when ordering the results.
 
-        project : typing.Optional[int]
-            Project ID
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -51,7 +51,9 @@ class AzureClient:
         client = LabelStudio(
             api_key="YOUR_API_KEY",
         )
-        client.export_storage.azure.list()
+        client.export_storage.azure.list(
+            project=1,
+        )
         """
         _response = self._client_wrapper.httpx_client.request(
             "api/storages/export/azure",
@@ -494,8 +496,8 @@ class AsyncAzureClient:
     async def list(
         self,
         *,
+        project: int,
         ordering: typing.Optional[str] = None,
-        project: typing.Optional[int] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[AzureBlobExportStorage]:
         """
@@ -503,12 +505,12 @@ class AsyncAzureClient:
 
         Parameters
         ----------
+        project : int
+            Project ID
+
         ordering : typing.Optional[str]
             Which field to use when ordering the results.
 
-        project : typing.Optional[int]
-            Project ID
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -529,7 +531,9 @@ class AsyncAzureClient:
 
 
         async def main() -> None:
-            await client.export_storage.azure.list()
+            await client.export_storage.azure.list(
+                project=1,
+            )
 
 
         asyncio.run(main())

{label_studio_sdk-2.0.12 → label_studio_sdk-2.0.14}/src/label_studio_sdk/export_storage/azure_spi/client.py

@@ -23,8 +23,8 @@ class AzureSpiClient:
     def list(
         self,
         *,
+        project: int,
         ordering: typing.Optional[str] = None,
-        project: typing.Optional[int] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[AzureServicePrincipalExportStorage]:
         """
@@ -38,12 +38,12 @@ class AzureSpiClient:
 
         Parameters
         ----------
+        project : int
+            Project ID
+
         ordering : typing.Optional[str]
             Which field to use when ordering the results.
 
-        project : typing.Optional[int]
-            Project ID
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -59,7 +59,9 @@ class AzureSpiClient:
         client = LabelStudio(
             api_key="YOUR_API_KEY",
         )
-        client.export_storage.azure_spi.list()
+        client.export_storage.azure_spi.list(
+            project=1,
+        )
         """
         _response = self._client_wrapper.httpx_client.request(
             "api/storages/export/azure_spi",
@@ -706,8 +708,8 @@ class AsyncAzureSpiClient:
     async def list(
         self,
         *,
+        project: int,
         ordering: typing.Optional[str] = None,
-        project: typing.Optional[int] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[AzureServicePrincipalExportStorage]:
         """
@@ -721,12 +723,12 @@ class AsyncAzureSpiClient:
 
         Parameters
         ----------
+        project : int
+            Project ID
+
         ordering : typing.Optional[str]
             Which field to use when ordering the results.
 
-        project : typing.Optional[int]
-            Project ID
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -747,7 +749,9 @@ class AsyncAzureSpiClient:
 
 
         async def main() -> None:
-            await client.export_storage.azure_spi.list()
+            await client.export_storage.azure_spi.list(
+                project=1,
+            )
 
 
         asyncio.run(main())

{label_studio_sdk-2.0.12 → label_studio_sdk-2.0.14}/src/label_studio_sdk/export_storage/databricks/client.py

@@ -23,8 +23,8 @@ class DatabricksClient:
     def list(
         self,
         *,
+        project: int,
         ordering: typing.Optional[str] = None,
-        project: typing.Optional[int] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[DatabricksExportStorage]:
         """
@@ -38,12 +38,12 @@ class DatabricksClient:
 
         Parameters
         ----------
+        project : int
+            Project ID
+
         ordering : typing.Optional[str]
             Which field to use when ordering the results.
 
-        project : typing.Optional[int]
-            Project ID
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -59,7 +59,9 @@ class DatabricksClient:
         client = LabelStudio(
             api_key="YOUR_API_KEY",
         )
-        client.export_storage.databricks.list()
+        client.export_storage.databricks.list(
+            project=1,
+        )
         """
         _response = self._client_wrapper.httpx_client.request(
             "api/storages/export/databricks",
@@ -731,8 +733,8 @@ class AsyncDatabricksClient:
     async def list(
         self,
         *,
+        project: int,
         ordering: typing.Optional[str] = None,
-        project: typing.Optional[int] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[DatabricksExportStorage]:
         """
@@ -746,12 +748,12 @@ class AsyncDatabricksClient:
 
         Parameters
         ----------
+        project : int
+            Project ID
+
         ordering : typing.Optional[str]
             Which field to use when ordering the results.
 
-        project : typing.Optional[int]
-            Project ID
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -772,7 +774,9 @@ class AsyncDatabricksClient:
 
 
         async def main() -> None:
-            await client.export_storage.databricks.list()
+            await client.export_storage.databricks.list(
+                project=1,
+            )
 
 
         asyncio.run(main())